Skip to content

Tool Definitions

Configure exposes canonical configure_* tool names to models.

Default Profile Tools

These are returned by profile.tools() with no options.

NameMetering classDescription
configure_profile_readreadRead compact approved profile context; sections is optional and is not a path selector.
configure_profile_searchreadSearch or list permitted attributed profile data; omit query or use query: "*" to list bounded permitted compact results. Compact results include source and omit raw CFS paths; pass detail: "full" for inspectable path/provenance metadata.
configure_profile_rememberwriteStore one explicit durable user memory under the acting agent namespace; not for raw transcripts.

Connector Tools

Connector tools appear only when the runtime enables the connector.

ts
profile.tools({ connectors: ["gmail", "calendar", "drive", "notion"] });
NameEnable withMetering class
configure_gmail_searchgmailtool search
configure_calendar_getcalendartool search
configure_drive_searchdrivetool search
configure_notion_searchnotiontool search

Action Tools

Action tools appear only when enabled explicitly.

ts
profile.tools({ actions: ["email.send", "calendar.create_event"] });
NameEnable withMetering class
configure_email_sendemail.sendwrite
configure_calendar_create_eventcalendar.create_eventwrite

Native backend MCP in PR1 exposes only the default profile tools. The package MCP server supports opt-in connector and action tools because it has runtime configuration.

Personalization infrastructure for agents