Troubleshooting

No Agent Handle Found

Set agent in code or CONFIGURE_AGENT in the environment.

new Configure({ apiKey, agent: "your-agent" });

For MCP, npx -y @configure-ai/mcp login can save the agent handle to ~/.configure/config when the login session returns one.

Tool Not Enabled

Connector and action tools must be enabled before profile.executeTool() can run them.

profile.tools({ actions: ["email.send"] });

Connector Not Connected

If Gmail, Calendar, Drive, or Notion is not connected, connector-backed tools return a connector error. Ask the user to connect that account before retrying.

Legacy Routes

Legacy memory route aliases are not active. Use the SDK runtime or canonical /v1/profile/* routes.

Python Examples

Python examples are intentionally out of scope for PR1. Use the TypeScript quickstart for the current runtime shape.