memory_session

Shipped in v3-alpha (Beta). Interface may still change before 3.0 stable.

Description

Manage your working session. Pin important turns, add scratch notes, collapse when done.

Input schema

{
  action: "pin" | "scratch" | "collapse" | "discard",
  pin?:       { turnIndex: number; label?: string },
  scratch?:   { key: string; value: any },
  collapseHint?: string,
}

Example

// Pin a turn that contains an important user statement
await mcp.callTool("memory_session", {
  action: "pin",
  pin: { turnIndex: 7, label: "user-stated-budget" },
});
 
// Save a hypothesis to scratch
await mcp.callTool("memory_session", {
  action: "scratch",
  scratch: { key: "current_hypothesis", value: "DB connection pool exhausted" },
});
 
// End session — extract knowledge
await mcp.callTool("memory_session", {
  action: "collapse",
  collapseHint: "focus on what we learned about the incident timeline",
});

Backed by

Session memory + collapse — concept
POST /v1/session/:id/pin|scratch|collapse — REST surface

Overview (8 tools)memory_task