session-create
Create a new session for managing AI agent workflows, returning a session object with unique ID for tracking and organization.
Instructions
Create a new session. Returns the created session object with its ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metadata | No | Optional session metadata (e.g. agentType, source) |
Implementation Reference
- src/tools/sessions.ts:6-22 (handler)The registration and handler implementation for the 'session-create' tool.
server.tool( "session-create", "Create a new session. Returns the created session object with its ID.", { metadata: z.record(z.unknown()).optional().describe("Optional session metadata (e.g. agentType, source)"), }, async (params) => { try { const result = await client.sessions.create({ metadata: params.metadata, } as any); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; } catch (err) { const message = err instanceof Error ? err.message : String(err); return { content: [{ type: "text", text: `Error: ${message}` }], isError: true }; } },