Interface SessionNotification

Type Declaration

• { content: ContentBlock; sessionUpdate: "user_message_chunk" }
• { content: ContentBlock; sessionUpdate: "agent_message_chunk" }
• { content: ContentBlock; sessionUpdate: "agent_thought_chunk" }
• {
      _meta?: { [k: string]: unknown };
      content?: ToolCallContent[];
      kind?:
          | "read"
          | "edit"
          | "delete"
          | "move"
          | "search"
          | "execute"
          | "think"
          | "fetch"
          | "switch_mode"
          | "other";
      locations?: ToolCallLocation[];
      rawInput?: { [k: string]: unknown };
      rawOutput?: { [k: string]: unknown };
      sessionUpdate: "tool_call";
      status?: "pending" | "in_progress" | "completed" | "failed";
      title: string;
      toolCallId: string;
  }

  • Optional_meta?: { [k: string]: unknown }

    Extension point for implementations

  • Optionalcontent?: ToolCallContent[]

    Content produced by the tool call.

  • Optionalkind?:
        | "read"
        | "edit"
        | "delete"
        | "move"
        | "search"
        | "execute"
        | "think"
        | "fetch"
        | "switch_mode"
        | "other"

    The category of tool being invoked. Helps clients choose appropriate icons and UI treatment.

  • Optionallocations?: ToolCallLocation[]

    File locations affected by this tool call. Enables "follow-along" features in clients.

  • OptionalrawInput?: { [k: string]: unknown }

    Raw input parameters sent to the tool.

  • OptionalrawOutput?: { [k: string]: unknown }

    Raw output returned by the tool.

  • sessionUpdate: "tool_call"

  • Optionalstatus?: "pending" | "in_progress" | "completed" | "failed"

    Current execution status of the tool call.

  • title: string

    Human-readable title describing what the tool is doing.

  • toolCallId: string

    Unique identifier for this tool call within the session.

• {
      _meta?: { [k: string]: unknown };
      content?: null | ToolCallContent[];
      kind?: null | ToolKind;
      locations?: null | ToolCallLocation[];
      rawInput?: { [k: string]: unknown };
      rawOutput?: { [k: string]: unknown };
      sessionUpdate: "tool_call_update";
      status?: null | ToolCallStatus;
      title?: null | string;
      toolCallId: string;
  }

  • Optional_meta?: { [k: string]: unknown }

    Extension point for implementations

  • Optionalcontent?: null | ToolCallContent[]

    Replace the content collection.

  • Optionalkind?: null | ToolKind

    Update the tool kind.

  • Optionallocations?: null | ToolCallLocation[]

    Replace the locations collection.

  • OptionalrawInput?: { [k: string]: unknown }

    Update the raw input.

  • OptionalrawOutput?: { [k: string]: unknown }

    Update the raw output.

  • sessionUpdate: "tool_call_update"

  • Optionalstatus?: null | ToolCallStatus

    Update the execution status.

  • Optionaltitle?: null | string

    Update the human-readable title.

  • toolCallId: string

    The ID of the tool call being updated.

• {
      _meta?: { [k: string]: unknown };
      entries: PlanEntry[];
      sessionUpdate: "plan";
  }

  • Optional_meta?: { [k: string]: unknown }

    Extension point for implementations

  • entries: PlanEntry[]

    The list of tasks to be accomplished.

    When updating a plan, the agent must send a complete list of all entries with their current status. The client replaces the entire plan with each update.

  • sessionUpdate: "plan"

• {
      availableCommands: AvailableCommand[];
      sessionUpdate: "available_commands_update";
  }
• { currentModeId: string; sessionUpdate: "current_mode_update" }