start_new_session
Begin a new conversation session by generating a unique session ID, discarding previous context to start a clean thread for unrelated topics or explicit reset requests.
Instructions
Mint a fresh conversation session id that starts a new ask_channel thread.
Call this to begin a clean conversation that carries no memory of prior
ask_channel turns — e.g. when the user switches to an unrelated topic
or explicitly asks to "start over" / "forget previous context". Pass the
returned id as the session_id argument on subsequent ask_channel
calls so they share one continuous thread; reuse the same id for
follow-ups, and mint a new one only when you want a clean break.
When NOT to use: do not call this before every question. ask_channel
auto-creates a session when session_id is omitted, so a new session
id is only needed to intentionally drop earlier conversation context.
Prerequisites: none. Requires an authenticated MCP principal (the caller's
connection token); no channel_id or other input is needed.
Returns: a dict {"session_id": "mcp:<principal>:<short>"} where the
value is a fresh opaque conversation handle scoped to the caller, e.g.
{"session_id": "mcp:conn_abc123:9f3c1a2b"}. On a missing or invalid
principal it returns {"error": "authentication_missing"} instead.
Side effects: none — this allocates a new conversation boundary marker and does not delete, persist, or mutate any stored data. Latency: instant (no network or LLM call); safe to call synchronously inline.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||