@tylerl0706/ahpx 0.2.10 → 0.2.13

package/dist/index.d.ts

@@ -111,7 +111,7 @@ interface IProtectedResourceMetadata {
  *
  * @category Root State
  */
-declare enum PolicyState {
+declare const enum PolicyState {
     Enabled = "enabled",
     Disabled = "disabled",
     Unconfigured = "unconfigured"
@@ -126,6 +126,8 @@ interface IRootState {
     agents: IAgentInfo[];
     /** Number of active (non-disposed) sessions on the server */
     activeSessions?: number;
+    /** Known terminals on the server. Subscribe to individual terminal URIs for full state. */
+    terminals?: ITerminalInfo[];
 }
 /**
  * @category Root State
@@ -181,7 +183,7 @@ interface ISessionModelInfo {
  *
  * @category Pending Message Types
  */
-declare enum PendingMessageKind {
+declare const enum PendingMessageKind {
     /** Injected into the current turn at a convenient point */
     Steering = "steering",
     /** Sent automatically as a new turn after the current turn finishes */
@@ -207,20 +209,25 @@ interface IPendingMessage {
  *
  * @category Session State
  */
-declare enum SessionLifecycle {
+declare const enum SessionLifecycle {
     Creating = "creating",
     Ready = "ready",
     CreationFailed = "creationFailed"
 }
 /**
- * Current session status.
+ * Bitset of summary-level session status flags.
+ *
+ * Use bitwise checks instead of equality for non-terminal activity. For example,
+ * `status & SessionStatus.InProgress` matches both ordinary in-progress turns
+ * and turns that are paused waiting for input.
  *
  * @category Session State
  */
-declare enum SessionStatus {
-    Idle = "idle",
-    InProgress = "in-progress",
-    Error = "error"
+declare const enum SessionStatus {
+    Idle = 1,
+    Error = 2,
+    InProgress = 8,
+    InputNeeded = 24
 }
 /**
  * Full state for a single session, loaded when a client subscribes to the session's URI.
@@ -248,6 +255,8 @@ interface ISessionState {
     steeringMessage?: IPendingMessage;
     /** Messages to send automatically as new turns after the current turn finishes */
     queuedMessages?: IPendingMessage[];
+    /** Requests for user input that are currently blocking or informing session progress */
+    inputRequests?: ISessionInputRequest[];
     /**
      * Server-provided customizations active in this session.
      *
@@ -274,6 +283,30 @@ interface ISessionActiveClient {
     /** Customizations this client contributes to the session */
     customizations?: ICustomizationRef[];
 }
+/**
+ * A summary of changes to a single file within a session.
+ *
+ * @category Session State
+ */
+interface ISessionFileDiff {
+    /** URI of the affected file */
+    uri: URI;
+    /** Number of items added (e.g., lines for text files, cells for notebooks) */
+    added?: number;
+    /** Number of items removed (e.g., lines for text files, cells for notebooks) */
+    removed?: number;
+}
+/**
+ * Server-owned project metadata for a session.
+ *
+ * @category Session State
+ */
+interface IProjectInfo {
+    /** Project URI */
+    uri: URI;
+    /** Human-readable project name */
+    displayName: string;
+}
 /**
  * @category Session State
  */
@@ -290,17 +323,218 @@ interface ISessionSummary {
     createdAt: number;
     /** Last modification timestamp */
     modifiedAt: number;
+    /** Server-owned project for this session */
+    project?: IProjectInfo;
     /** Currently selected model */
     model?: string;
     /** The working directory URI for this session */
     workingDirectory?: URI;
+    /** Whether the client has viewed this session since its last modification */
+    isRead?: boolean;
+    /** Whether the session has been marked as done by the client */
+    isDone?: boolean;
+    /** Files changed during this session with diff statistics */
+    diffs?: ISessionFileDiff[];
+}
+/**
+ * How a client completed an input request.
+ *
+ * @category Session Input Types
+ */
+declare const enum SessionInputResponseKind {
+    Accept = "accept",
+    Decline = "decline",
+    Cancel = "cancel"
+}
+/**
+ * Question/input control kind.
+ *
+ * @category Session Input Types
+ */
+declare const enum SessionInputQuestionKind {
+    Text = "text",
+    Number = "number",
+    Integer = "integer",
+    Boolean = "boolean",
+    SingleSelect = "single-select",
+    MultiSelect = "multi-select"
+}
+/**
+ * A choice in a select-style question.
+ *
+ * @category Session Input Types
+ */
+interface ISessionInputOption {
+    /** Stable option identifier; for MCP enum values this is the enum string */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Optional secondary text */
+    description?: string;
+    /** Whether this option is the recommended/default choice */
+    recommended?: boolean;
+}
+interface ISessionInputQuestionBase {
+    /** Stable question identifier used as the key in `answers` */
+    id: string;
+    /** Short display title */
+    title?: string;
+    /** Prompt shown to the user */
+    message: string;
+    /** Whether the user must answer this question to accept the request */
+    required?: boolean;
+}
+/** Text question within a session input request. */
+interface ISessionInputTextQuestion extends ISessionInputQuestionBase {
+    kind: SessionInputQuestionKind.Text;
+    /** Format hint for text questions, such as `email`, `uri`, `date`, or `date-time` */
+    format?: string;
+    /** Minimum string length */
+    min?: number;
+    /** Maximum string length */
+    max?: number;
+    /** Default text */
+    defaultValue?: string;
+}
+/** Numeric question within a session input request. */
+interface ISessionInputNumberQuestion extends ISessionInputQuestionBase {
+    kind: SessionInputQuestionKind.Number | SessionInputQuestionKind.Integer;
+    /** Minimum value */
+    min?: number;
+    /** Maximum value */
+    max?: number;
+    /** Default numeric value */
+    defaultValue?: number;
+}
+/** Boolean question within a session input request. */
+interface ISessionInputBooleanQuestion extends ISessionInputQuestionBase {
+    kind: SessionInputQuestionKind.Boolean;
+    /** Default boolean value */
+    defaultValue?: boolean;
+}
+/** Single-select question within a session input request. */
+interface ISessionInputSingleSelectQuestion extends ISessionInputQuestionBase {
+    kind: SessionInputQuestionKind.SingleSelect;
+    /** Options the user may select from */
+    options: ISessionInputOption[];
+    /** Whether the user may enter text instead of selecting an option */
+    allowFreeformInput?: boolean;
+}
+/** Multi-select question within a session input request. */
+interface ISessionInputMultiSelectQuestion extends ISessionInputQuestionBase {
+    kind: SessionInputQuestionKind.MultiSelect;
+    /** Options the user may select from */
+    options: ISessionInputOption[];
+    /** Whether the user may enter text in addition to selecting options */
+    allowFreeformInput?: boolean;
+    /** Minimum selected item count */
+    min?: number;
+    /** Maximum selected item count */
+    max?: number;
+}
+/**
+ * One question within a session input request.
+ *
+ * @category Session Input Types
+ */
+type ISessionInputQuestion = ISessionInputTextQuestion | ISessionInputNumberQuestion | ISessionInputBooleanQuestion | ISessionInputSingleSelectQuestion | ISessionInputMultiSelectQuestion;
+/**
+ * A live request for user input.
+ *
+ * The server creates or replaces requests with `session/inputRequested`.
+ * Clients sync drafts with `session/inputAnswerChanged` and complete requests
+ * with `session/inputCompleted`.
+ *
+ * @category Session Input Types
+ */
+interface ISessionInputRequest {
+    /** Stable request identifier */
+    id: string;
+    /** Display message for the request as a whole */
+    message: string;
+    /** URL the user should review or open, for URL-style elicitations */
+    url?: URI;
+    /** Ordered questions to ask the user */
+    questions?: ISessionInputQuestion[];
+    /** Current draft or submitted answers, keyed by question ID */
+    answers?: Record<string, ISessionInputAnswer>;
 }
+/**
+ * Answer value kind.
+ *
+ * @category Session Input Types
+ */
+declare const enum SessionInputAnswerValueKind {
+    Text = "text",
+    Number = "number",
+    Boolean = "boolean",
+    Selected = "selected",
+    SelectedMany = "selected-many"
+}
+/**
+ * Value captured for one answer.
+ *
+ * @category Session Input Types
+ */
+interface ISessionInputTextAnswerValue {
+    kind: SessionInputAnswerValueKind.Text;
+    value: string;
+}
+interface ISessionInputNumberAnswerValue {
+    kind: SessionInputAnswerValueKind.Number;
+    value: number;
+}
+interface ISessionInputBooleanAnswerValue {
+    kind: SessionInputAnswerValueKind.Boolean;
+    value: boolean;
+}
+interface ISessionInputSelectedAnswerValue {
+    kind: SessionInputAnswerValueKind.Selected;
+    value: string;
+    /** Free-form text entered instead of selecting an option */
+    freeformValues?: string[];
+}
+interface ISessionInputSelectedManyAnswerValue {
+    kind: SessionInputAnswerValueKind.SelectedMany;
+    value: string[];
+    /** Free-form text entered in addition to selected options */
+    freeformValues?: string[];
+}
+type ISessionInputAnswerValue = ISessionInputTextAnswerValue | ISessionInputNumberAnswerValue | ISessionInputBooleanAnswerValue | ISessionInputSelectedAnswerValue | ISessionInputSelectedManyAnswerValue;
+interface ISessionInputAnswered {
+    /** Answer state */
+    state: SessionInputAnswerState.Draft | SessionInputAnswerState.Submitted;
+    /** Answer value */
+    value: ISessionInputAnswerValue;
+}
+interface ISessionInputSkipped {
+    /** Answer state */
+    state: SessionInputAnswerState.Skipped;
+    /** Free-form reason or value captured while skipping, if any */
+    freeformValues?: string[];
+}
+/**
+ * Answer lifecycle state.
+ *
+ * @category Session Input Types
+ */
+declare const enum SessionInputAnswerState {
+    Draft = "draft",
+    Submitted = "submitted",
+    Skipped = "skipped"
+}
+/**
+ * Draft, submitted, or skipped answer for one question.
+ *
+ * @category Session Input Types
+ */
+type ISessionInputAnswer = ISessionInputAnswered | ISessionInputSkipped;
 /**
  * How a turn ended.
  *
  * @category Turn Types
  */
-declare enum TurnState {
+declare const enum TurnState {
     Complete = "complete",
     Cancelled = "cancelled",
     Error = "error"
@@ -310,7 +544,7 @@ declare enum TurnState {
  *
  * @category Turn Types
  */
-declare enum AttachmentType {
+declare const enum AttachmentType {
     File = "file",
     Directory = "directory",
     Selection = "selection"
@@ -383,7 +617,7 @@ interface IMessageAttachment {
  *
  * @category Response Parts
  */
-declare enum ResponsePartKind {
+declare const enum ResponsePartKind {
     Markdown = "markdown",
     ContentRef = "contentRef",
     ToolCall = "toolCall",
@@ -457,7 +691,7 @@ type IResponsePart = IMarkdownResponsePart | IResourceReponsePart | IToolCallRes
  *
  * @category Tool Call Types
  */
-declare enum ToolCallStatus {
+declare const enum ToolCallStatus {
     Streaming = "streaming",
     PendingConfirmation = "pending-confirmation",
     Running = "running",
@@ -474,7 +708,7 @@ declare enum ToolCallStatus {
  *
  * @category Tool Call Types
  */
-declare enum ToolCallConfirmationReason {
+declare const enum ToolCallConfirmationReason {
     NotNeeded = "not-needed",
     UserAction = "user-action",
     Setting = "setting"
@@ -484,7 +718,7 @@ declare enum ToolCallConfirmationReason {
  *
  * @category Tool Call Types
  */
-declare enum ToolCallCancellationReason {
+declare const enum ToolCallCancellationReason {
     Denied = "denied",
     Skipped = "skipped",
     ResultDenied = "result-denied"
@@ -595,6 +829,13 @@ interface IToolCallRunningState extends IToolCallBase, IToolCallParameterFields
     status: ToolCallStatus.Running;
     /** How the tool was confirmed for execution */
     confirmed: ToolCallConfirmationReason;
+    /**
+     * Partial content produced while the tool is still executing.
+     *
+     * For example, a terminal content block lets clients subscribe to live
+     * output before the tool completes.
+     */
+    content?: IToolResultContent[];
 }
 /**
  * Tool finished executing, waiting for client to approve the result.
@@ -709,11 +950,13 @@ interface IToolAnnotations {
  *
  * @category Tool Result Content
  */
-declare enum ToolResultContentType {
+declare const enum ToolResultContentType {
     Text = "text",
     EmbeddedResource = "embeddedResource",
     Resource = "resource",
-    FileEdit = "fileEdit"
+    FileEdit = "fileEdit",
+    Terminal = "terminal",
+    Subagent = "subagent"
 }
 /**
  * Text content in a tool result.
@@ -783,16 +1026,52 @@ interface IToolResultFileEditContent {
         removed?: number;
     };
 }
+/**
+ * A reference to a terminal whose output is relevant to this tool result.
+ *
+ * Clients can subscribe to the terminal's URI to stream its output in real
+ * time, providing live feedback while a tool is executing.
+ *
+ * @category Tool Result Content
+ */
+interface IToolResultTerminalContent {
+    type: ToolResultContentType.Terminal;
+    /** Terminal URI (subscribable for full terminal state) */
+    resource: URI;
+    /** Display title for the terminal content */
+    title: string;
+}
+/**
+ * A reference to a subagent session spawned by a tool.
+ *
+ * Clients can subscribe to the subagent's session URI to stream its
+ * progress in real time, including inner tool calls and responses.
+ *
+ * @category Tool Result Content
+ */
+interface IToolResultSubagentContent {
+    type: ToolResultContentType.Subagent;
+    /** Subagent session URI (subscribable for full session state) */
+    resource: URI;
+    /** Display title for the subagent */
+    title: string;
+    /** Internal agent name */
+    agentName?: string;
+    /** Human-readable description of the subagent's task */
+    description?: string;
+}
 /**
  * Content block in a tool result.
  *
  * Mirrors the content blocks in MCP `CallToolResult.content`, plus
- * `IToolResultResourceContent` for lazy-loading large results and
- * `IToolResultFileEditContent` for file edit diffs (AHP extensions).
+ * `IToolResultResourceContent` for lazy-loading large results,
+ * `IToolResultFileEditContent` for file edit diffs,
+ * `IToolResultTerminalContent` for live terminal output, and
+ * `IToolResultSubagentContent` for subagent sessions (AHP extensions).
  *
  * @category Tool Result Content
  */
-type IToolResultContent = IToolResultTextContent | IToolResultEmbeddedResourceContent | IToolResultResourceContent | IToolResultFileEditContent;
+type IToolResultContent = IToolResultTextContent | IToolResultEmbeddedResourceContent | IToolResultResourceContent | IToolResultFileEditContent | IToolResultTerminalContent | IToolResultSubagentContent;
 /**
  * A reference to an [Open Plugins](https://open-plugins.com/) plugin.
  *
@@ -824,7 +1103,7 @@ interface ICustomizationRef {
  *
  * @category Customization Types
  */
-declare enum CustomizationStatus {
+declare const enum CustomizationStatus {
     /** Plugin is being loaded */
     Loading = "loading",
     /** Plugin is fully operational */
@@ -854,6 +1133,87 @@ interface ISessionCustomization {
      */
     statusMessage?: string;
 }
+/**
+ * Lightweight terminal metadata exposed on the root state.
+ *
+ * @category Terminal Types
+ */
+interface ITerminalInfo {
+    /** Terminal URI (subscribable for full terminal state) */
+    resource: URI;
+    /** Human-readable terminal title */
+    title: string;
+    /** Who currently holds this terminal */
+    claim: ITerminalClaim;
+    /** Process exit code, if the terminal process has exited */
+    exitCode?: number;
+}
+/**
+ * Discriminant for terminal claim kinds.
+ *
+ * @category Terminal Types
+ */
+declare const enum TerminalClaimKind {
+    Client = "client",
+    Session = "session"
+}
+/**
+ * A terminal claimed by a connected client.
+ *
+ * @category Terminal Types
+ */
+interface ITerminalClientClaim {
+    /** Discriminant */
+    kind: TerminalClaimKind.Client;
+    /** The `clientId` of the claiming client */
+    clientId: string;
+}
+/**
+ * A terminal claimed by a session, optionally scoped to a specific turn or tool call.
+ *
+ * @category Terminal Types
+ */
+interface ITerminalSessionClaim {
+    /** Discriminant */
+    kind: TerminalClaimKind.Session;
+    /** Session URI that claimed the terminal */
+    session: URI;
+    /** Optional turn identifier within the session */
+    turnId?: string;
+    /** Optional tool call identifier within the turn */
+    toolCallId?: string;
+}
+/**
+ * Describes who currently holds a terminal. A terminal may be claimed by
+ * either a connected client or a session (e.g. during a tool call).
+ *
+ * @category Terminal Types
+ */
+type ITerminalClaim = ITerminalClientClaim | ITerminalSessionClaim;
+/**
+ * Full state for a single terminal, loaded when a client subscribes to the terminal's URI.
+ *
+ * @category Terminal Types
+ */
+interface ITerminalState {
+    /** Human-readable terminal title */
+    title: string;
+    /** Current working directory of the terminal process */
+    cwd?: URI;
+    /** Terminal width in columns */
+    cols?: number;
+    /** Terminal height in rows */
+    rows?: number;
+    /**
+     * Accumulated terminal output. May contain ANSI escape sequences.
+     * The scrollback length is implementation-defined.
+     */
+    content: string;
+    /** Process exit code, set when the terminal process exits */
+    exitCode?: number;
+    /** Who currently holds this terminal */
+    claim: ITerminalClaim;
+}
 /**
  * @category Common Types
  */
@@ -888,7 +1248,7 @@ interface ISnapshot {
     /** The subscribed resource URI (e.g. `agenthost:/root` or `copilot:/<uuid>`) */
     resource: URI;
     /** The current state of the resource */
-    state: IRootState | ISessionState;
+    state: IRootState | ISessionState | ITerminalState;
     /** The `serverSeq` at which this snapshot was taken. Subsequent actions will have `serverSeq > fromSeq`. */
     fromSeq: number;
 }
@@ -906,7 +1266,7 @@ interface ISnapshot {
  *
  * @category Actions
  */
-declare enum ActionType {
+declare const enum ActionType {
     RootAgentsChanged = "root/agentsChanged",
     RootActiveSessionsChanged = "root/activeSessionsChanged",
     SessionReady = "session/ready",
@@ -920,6 +1280,7 @@ declare enum ActionType {
     SessionToolCallConfirmed = "session/toolCallConfirmed",
     SessionToolCallComplete = "session/toolCallComplete",
     SessionToolCallResultConfirmed = "session/toolCallResultConfirmed",
+    SessionToolCallContentChanged = "session/toolCallContentChanged",
     SessionTurnComplete = "session/turnComplete",
     SessionTurnCancelled = "session/turnCancelled",
     SessionError = "session/error",
@@ -933,9 +1294,24 @@ declare enum ActionType {
     SessionPendingMessageSet = "session/pendingMessageSet",
     SessionPendingMessageRemoved = "session/pendingMessageRemoved",
     SessionQueuedMessagesReordered = "session/queuedMessagesReordered",
+    SessionInputRequested = "session/inputRequested",
+    SessionInputAnswerChanged = "session/inputAnswerChanged",
+    SessionInputCompleted = "session/inputCompleted",
     SessionCustomizationsChanged = "session/customizationsChanged",
     SessionCustomizationToggled = "session/customizationToggled",
-    SessionTruncated = "session/truncated"
+    SessionTruncated = "session/truncated",
+    SessionIsReadChanged = "session/isReadChanged",
+    SessionIsDoneChanged = "session/isDoneChanged",
+    SessionDiffsChanged = "session/diffsChanged",
+    RootTerminalsChanged = "root/terminalsChanged",
+    TerminalData = "terminal/data",
+    TerminalInput = "terminal/input",
+    TerminalResized = "terminal/resized",
+    TerminalClaimed = "terminal/claimed",
+    TerminalTitleChanged = "terminal/titleChanged",
+    TerminalCwdChanged = "terminal/cwdChanged",
+    TerminalExited = "terminal/exited",
+    TerminalCleared = "terminal/cleared"
 }
 /**
  * Identifies the client that originally dispatched an action.
@@ -998,6 +1374,20 @@ interface IRootActiveSessionsChangedAction {
     /** Current count of active sessions */
     activeSessions: number;
 }
+/**
+ * Fired when the list of known terminals changes.
+ *
+ * Full-replacement semantics: the `terminals` array replaces the previous
+ * `terminals` entirely.
+ *
+ * @category Root Actions
+ * @version 1
+ */
+interface IRootTerminalsChangedAction {
+    type: ActionType.RootTerminalsChanged;
+    /** Updated terminal list (full replacement) */
+    terminals: ITerminalInfo[];
+}
 /**
  * Session backend initialized successfully.
  *
@@ -1219,6 +1609,21 @@ interface ISessionToolCallResultConfirmedAction extends IToolCallActionBase {
     /** Whether the result was approved */
     approved: boolean;
 }
+/**
+ * Partial content produced while a tool is still executing.
+ *
+ * Replaces the `content` array on the running tool call state. Clients can
+ * use this to display live feedback (e.g. a terminal reference) before the
+ * tool completes.
+ *
+ * @category Session Actions
+ * @version 1
+ */
+interface ISessionToolCallContentChangedAction extends IToolCallActionBase {
+    type: ActionType.SessionToolCallContentChanged;
+    /** The current partial content for the running tool call */
+    content: IToolResultContent[];
+}
 /**
  * Turn finished — the assistant is idle.
  *
@@ -1325,6 +1730,56 @@ interface ISessionModelChangedAction {
     /** New model ID */
     model: string;
 }
+/**
+ * The read state of the session changed.
+ *
+ * Dispatched by a client to mark a session as read (e.g. after viewing it)
+ * or unread (e.g. after new activity since the client last looked at it).
+ *
+ * @category Session Actions
+ * @version 1
+ * @clientDispatchable
+ */
+interface ISessionIsReadChangedAction {
+    type: ActionType.SessionIsReadChanged;
+    /** Session URI */
+    session: URI;
+    /** Whether the session has been read */
+    isRead: boolean;
+}
+/**
+ * The done state of the session changed.
+ *
+ * Dispatched by a client to mark a session as done (e.g. the task is
+ * complete) or to reopen it.
+ *
+ * @category Session Actions
+ * @version 1
+ * @clientDispatchable
+ */
+interface ISessionIsDoneChangedAction {
+    type: ActionType.SessionIsDoneChanged;
+    /** Session URI */
+    session: URI;
+    /** Whether the session is done */
+    isDone: boolean;
+}
+/**
+ * The file diffs for the session changed.
+ *
+ * Full-replacement semantics: the `diffs` array replaces the previous
+ * `summary.diffs` entirely.
+ *
+ * @category Session Actions
+ * @version 1
+ */
+interface ISessionDiffsChangedAction {
+    type: ActionType.SessionDiffsChanged;
+    /** Session URI */
+    session: URI;
+    /** Updated file diffs for the session */
+    diffs: ISessionFileDiff[];
+}
 /**
  * Server tools for this session have changed.
  *
@@ -1498,10 +1953,201 @@ interface ISessionQueuedMessagesReorderedAction {
     /** Queued message IDs in the desired order */
     order: string[];
 }
+/**
+ * A session requested input from the user.
+ *
+ * Full-request upsert semantics: the `request` replaces any existing request
+ * with the same `id`, or is appended if it is new. Answer drafts are preserved
+ * unless `request.answers` is provided.
+ *
+ * @category Session Actions
+ * @version 1
+ */
+interface ISessionInputRequestedAction {
+    type: ActionType.SessionInputRequested;
+    /** Session URI */
+    session: URI;
+    /** Input request to create or replace */
+    request: ISessionInputRequest;
+}
+/**
+ * A client updated, submitted, skipped, or removed a single in-progress answer.
+ *
+ * Dispatching with `answer: undefined` removes that question's answer draft.
+ *
+ * @category Session Actions
+ * @version 1
+ * @clientDispatchable
+ */
+interface ISessionInputAnswerChangedAction {
+    type: ActionType.SessionInputAnswerChanged;
+    /** Session URI */
+    session: URI;
+    /** Input request identifier */
+    requestId: string;
+    /** Question identifier within the input request */
+    questionId: string;
+    /** Updated answer, or `undefined` to clear an answer draft */
+    answer?: ISessionInputAnswer;
+}
+/**
+ * A client accepted, declined, or cancelled a session input request.
+ *
+ * If accepted, the server uses `answers` (when provided) plus the request's
+ * synced answer state to resume the blocked operation.
+ *
+ * @category Session Actions
+ * @version 1
+ * @clientDispatchable
+ */
+interface ISessionInputCompletedAction {
+    type: ActionType.SessionInputCompleted;
+    /** Session URI */
+    session: URI;
+    /** Input request identifier */
+    requestId: string;
+    /** Completion outcome */
+    response: SessionInputResponseKind;
+    /** Optional final answer replacement, keyed by question ID */
+    answers?: Record<string, ISessionInputAnswer>;
+}
+/**
+ * Terminal output data (pty → client direction).
+ *
+ * Appends `data` to the terminal's `content` in the reducer.
+ *
+ * `terminal/data` and `terminal/input` are intentionally separate actions
+ * because standard write-ahead reconciliation is not safe for terminal I/O.
+ * A pty is a stateful, mutable process — optimistically applying input or
+ * predicting output would produce incorrect state. Instead, `terminal/input`
+ * is a side-effect-only action (client → server → pty), and `terminal/data`
+ * is server-authoritative output (pty → server → client).
+ *
+ * @category Terminal Actions
+ * @version 1
+ */
+interface ITerminalDataAction {
+    type: ActionType.TerminalData;
+    /** Terminal URI */
+    terminal: URI;
+    /** Output data (may contain ANSI escape sequences) */
+    data: string;
+}
+/**
+ * Keyboard input sent to the terminal process (client → pty direction).
+ *
+ * This is a side-effect-only action: the server forwards the data to the
+ * terminal's pty. The reducer treats this as a no-op since `terminal/data`
+ * actions will reflect any resulting output.
+ *
+ * See `terminal/data` for why these two actions are kept separate.
+ *
+ * @category Terminal Actions
+ * @version 1
+ * @clientDispatchable
+ */
+interface ITerminalInputAction {
+    type: ActionType.TerminalInput;
+    /** Terminal URI */
+    terminal: URI;
+    /** Input data to send to the pty */
+    data: string;
+}
+/**
+ * Terminal dimensions changed.
+ *
+ * Dispatchable by clients to request a resize, or by the server to inform
+ * clients of the actual terminal dimensions.
+ *
+ * @category Terminal Actions
+ * @version 1
+ * @clientDispatchable
+ */
+interface ITerminalResizedAction {
+    type: ActionType.TerminalResized;
+    /** Terminal URI */
+    terminal: URI;
+    /** Terminal width in columns */
+    cols: number;
+    /** Terminal height in rows */
+    rows: number;
+}
+/**
+ * Terminal claim changed. A client or session transfers ownership of the terminal.
+ *
+ * The server SHOULD reject if the dispatching client does not currently hold
+ * the claim.
+ *
+ * @category Terminal Actions
+ * @version 1
+ * @clientDispatchable
+ */
+interface ITerminalClaimedAction {
+    type: ActionType.TerminalClaimed;
+    /** Terminal URI */
+    terminal: URI;
+    /** The new claim */
+    claim: ITerminalClaim;
+}
+/**
+ * Terminal title changed.
+ *
+ * Fired by the server when the terminal process updates its title (e.g. via
+ * escape sequences), or dispatched by a client to rename a terminal.
+ *
+ * @category Terminal Actions
+ * @version 1
+ * @clientDispatchable
+ */
+interface ITerminalTitleChangedAction {
+    type: ActionType.TerminalTitleChanged;
+    /** Terminal URI */
+    terminal: URI;
+    /** New terminal title */
+    title: string;
+}
+/**
+ * Terminal working directory changed.
+ *
+ * @category Terminal Actions
+ * @version 1
+ */
+interface ITerminalCwdChangedAction {
+    type: ActionType.TerminalCwdChanged;
+    /** Terminal URI */
+    terminal: URI;
+    /** New working directory */
+    cwd: URI;
+}
+/**
+ * Terminal process exited.
+ *
+ * @category Terminal Actions
+ * @version 1
+ */
+interface ITerminalExitedAction {
+    type: ActionType.TerminalExited;
+    /** Terminal URI */
+    terminal: URI;
+    /** Process exit code. `undefined` if the process was killed without an exit code. */
+    exitCode?: number;
+}
+/**
+ * Terminal scrollback buffer cleared.
+ *
+ * @category Terminal Actions
+ * @version 1
+ * @clientDispatchable
+ */
+interface ITerminalClearedAction {
+    type: ActionType.TerminalCleared;
+    /** Terminal URI */
+    terminal: URI;
+}
 /**
  * Discriminated union of all state actions.
  */
-type IStateAction = IRootAgentsChangedAction | IRootActiveSessionsChangedAction | ISessionReadyAction | ISessionCreationFailedAction | ISessionTurnStartedAction | ISessionDeltaAction | ISessionResponsePartAction | ISessionToolCallStartAction | ISessionToolCallDeltaAction | ISessionToolCallReadyAction | ISessionToolCallConfirmedAction | ISessionToolCallCompleteAction | ISessionToolCallResultConfirmedAction | ISessionTurnCompleteAction | ISessionTurnCancelledAction | ISessionErrorAction | ISessionTitleChangedAction | ISessionUsageAction | ISessionReasoningAction | ISessionModelChangedAction | ISessionServerToolsChangedAction | ISessionActiveClientChangedAction | ISessionActiveClientToolsChangedAction | ISessionPendingMessageSetAction | ISessionPendingMessageRemovedAction | ISessionQueuedMessagesReorderedAction | ISessionCustomizationsChangedAction | ISessionCustomizationToggledAction | ISessionTruncatedAction;
+type IStateAction = IRootAgentsChangedAction | IRootActiveSessionsChangedAction | IRootTerminalsChangedAction | ISessionReadyAction | ISessionCreationFailedAction | ISessionTurnStartedAction | ISessionDeltaAction | ISessionResponsePartAction | ISessionToolCallStartAction | ISessionToolCallDeltaAction | ISessionToolCallReadyAction | ISessionToolCallConfirmedAction | ISessionToolCallCompleteAction | ISessionToolCallResultConfirmedAction | ISessionToolCallContentChangedAction | ISessionTurnCompleteAction | ISessionTurnCancelledAction | ISessionErrorAction | ISessionTitleChangedAction | ISessionUsageAction | ISessionReasoningAction | ISessionModelChangedAction | ISessionServerToolsChangedAction | ISessionActiveClientChangedAction | ISessionActiveClientToolsChangedAction | ISessionPendingMessageSetAction | ISessionPendingMessageRemovedAction | ISessionQueuedMessagesReorderedAction | ISessionInputRequestedAction | ISessionInputAnswerChangedAction | ISessionInputCompletedAction | ISessionCustomizationsChangedAction | ISessionCustomizationToggledAction | ISessionTruncatedAction | ISessionIsReadChangedAction | ISessionIsDoneChangedAction | ISessionDiffsChangedAction | ITerminalDataAction | ITerminalInputAction | ITerminalResizedAction | ITerminalClaimedAction | ITerminalTitleChangedAction | ITerminalCwdChangedAction | ITerminalExitedAction | ITerminalClearedAction;
 
 /**
  * Command Types — Source of truth for all AHP command (JSON-RPC request) definitions.
@@ -1551,7 +2197,7 @@ interface IInitializeResult {
  *
  * @category Commands
  */
-declare enum ReconnectResultType {
+declare const enum ReconnectResultType {
     Replay = "replay",
     Snapshot = "snapshot"
 }
@@ -1691,6 +2337,49 @@ interface IDisposeSessionParams {
     /** Session URI to dispose */
     session: URI;
 }
+/**
+ * Creates a new terminal on the server.
+ *
+ * After creation, the client should subscribe to the terminal URI to receive
+ * state updates. The server dispatches `root/terminalsChanged` to update the
+ * root terminal list.
+ *
+ * @category Commands
+ * @method createTerminal
+ * @direction Client → Server
+ * @messageType Request
+ * @version 1
+ */
+interface ICreateTerminalParams {
+    /** Terminal URI (client-chosen) */
+    terminal: URI;
+    /** Initial owner of the terminal */
+    claim: ITerminalClaim;
+    /** Human-readable terminal name */
+    name?: string;
+    /** Initial working directory URI */
+    cwd?: URI;
+    /** Initial terminal width in columns */
+    cols?: number;
+    /** Initial terminal height in rows */
+    rows?: number;
+}
+/**
+ * Disposes a terminal and kills its process if still running.
+ *
+ * The server dispatches `root/terminalsChanged` to remove the terminal from
+ * the root terminal list.
+ *
+ * @category Commands
+ * @method disposeTerminal
+ * @direction Client → Server
+ * @messageType Request
+ * @version 1
+ */
+interface IDisposeTerminalParams {
+    /** Terminal URI to dispose */
+    terminal: URI;
+}
 /**
  * Returns a list of session summaries. Used to populate session lists and sidebars.
  *
@@ -1718,7 +2407,7 @@ interface IListSessionsResult {
  *
  * @category Commands
  */
-declare enum ContentEncoding {
+declare const enum ContentEncoding {
     Base64 = "base64",
     Utf8 = "utf-8"
 }
@@ -2058,7 +2747,7 @@ interface IAuthenticateResult {
  *
  * @category Protocol Notifications
  */
-declare enum AuthRequiredReason {
+declare const enum AuthRequiredReason {
     /** The client has not yet authenticated for the resource */
     Required = "required",
     /** A previously valid token has expired or been revoked */
@@ -2069,9 +2758,10 @@ declare enum AuthRequiredReason {
  *
  * @category Protocol Notifications
  */
-declare enum NotificationType {
+declare const enum NotificationType {
     SessionAdded = "notify/sessionAdded",
     SessionRemoved = "notify/sessionRemoved",
+    SessionSummaryChanged = "notify/sessionSummaryChanged",
     AuthRequired = "notify/authRequired"
 }
 /**
@@ -2091,7 +2781,7 @@ declare enum NotificationType {
  *         "resource": "copilot:/<uuid>",
  *         "provider": "copilot",
  *         "title": "New Session",
- *         "status": "idle",
+ *         "status": 1,
  *         "createdAt": 1710000000000,
  *         "modifiedAt": 1710000000000
  *       }
@@ -2129,6 +2819,70 @@ interface ISessionRemovedNotification {
     /** URI of the removed session */
     session: URI;
 }
+/**
+ * Broadcast to all connected clients when an existing session's summary
+ * changes (title, status, `modifiedAt`, model, working directory, read/done
+ * state, or diff statistics).
+ *
+ * This notification lets clients that maintain a cached session list — for
+ * example, the result of a previous `listSessions()` call — stay in sync with
+ * in-flight sessions without having to subscribe to every session URI
+ * individually. It is complementary to, not a replacement for,
+ * `notify/sessionAdded` and `notify/sessionRemoved`: those signal lifecycle
+ * (creation/disposal), while this signals summary-level mutations on an
+ * already-known session.
+ *
+ * Semantics:
+ *
+ * - Only fields present in `changes` have new values; omitted fields are
+ *   unchanged on the client's cached summary.
+ * - Identity fields (`resource`, `provider`, `createdAt`) never change and
+ *   are not carried.
+ * - Like all protocol notifications, this is ephemeral: it is **not**
+ *   replayed on reconnect. On reconnect, clients should re-fetch the full
+ *   catalog via `listSessions()` as usual.
+ * - The server SHOULD emit this notification whenever any mutable field on
+ *   {@link ISessionSummary | `ISessionSummary`} changes for a session the
+ *   server has surfaced via `listSessions()` or `notify/sessionAdded`.
+ *   Servers MAY coalesce or debounce updates for noisy fields (for example,
+ *   `modifiedAt` bumps while a turn is streaming, or rapidly changing
+ *   `diffs`) at their discretion.
+ * - Clients that have no cached entry for `session` MAY ignore the
+ *   notification; it is not a substitute for `notify/sessionAdded`.
+ *
+ * @category Protocol Notifications
+ * @version 1
+ * @example
+ * ```json
+ * {
+ *   "jsonrpc": "2.0",
+ *   "method": "notification",
+ *   "params": {
+ *     "notification": {
+ *       "type": "notify/sessionSummaryChanged",
+ *       "session": "copilot:/<uuid>",
+ *       "changes": {
+ *         "title": "Refactor auth middleware",
+ *         "status": 8,
+ *         "modifiedAt": 1710000123456
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+interface ISessionSummaryChangedNotification {
+    type: NotificationType.SessionSummaryChanged;
+    /** URI of the session whose summary changed */
+    session: URI;
+    /**
+     * Mutable summary fields that changed; omitted fields are unchanged.
+     *
+     * Identity fields (`resource`, `provider`, `createdAt`) never change and
+     * MUST be omitted by senders; receivers SHOULD ignore them if present.
+     */
+    changes: Partial<ISessionSummary>;
+}
 /**
  * Sent by the server when a protected resource requires (re-)authentication.
  *
@@ -2165,7 +2919,7 @@ interface IAuthRequiredNotification {
 /**
  * Discriminated union of all protocol notifications.
  */
-type IProtocolNotification = ISessionAddedNotification | ISessionRemovedNotification | IAuthRequiredNotification;
+type IProtocolNotification = ISessionAddedNotification | ISessionRemovedNotification | ISessionSummaryChangedNotification | IAuthRequiredNotification;
 
 /**
  * Message Types — Fully typed JSON-RPC message definitions for the AHP wire protocol.
@@ -2202,6 +2956,14 @@ interface ICommandMap {
         params: IDisposeSessionParams;
         result: null;
     };
+    'createTerminal': {
+        params: ICreateTerminalParams;
+        result: null;
+    };
+    'disposeTerminal': {
+        params: IDisposeTerminalParams;
+        result: null;
+    };
     'listSessions': {
         params: IListSessionsParams;
         result: IListSessionsResult;
@@ -2449,6 +3211,7 @@ declare class SessionHandle extends EventEmitter<SessionHandleEvents> {
 declare class StateMirror {
     private rootState;
     private sessions;
+    private terminals;
     private serverSeq;
     private pendingActions;
     /** Current root state (agents, active session count). */
@@ -2459,6 +3222,12 @@ declare class StateMirror {
     getSession(uri: URI): ISessionState | undefined;
     /** All tracked session URIs. */
     get sessionUris(): URI[];
+    /** Get a terminal state by URI. */
+    getTerminal(uri: URI): ITerminalState | undefined;
+    /** All tracked terminal URIs. */
+    get terminalUris(): URI[];
+    /** Remove a terminal from tracking. */
+    removeTerminal(uri: URI): void;
     /**
      * Load a snapshot (from initialize, reconnect, or subscribe).
      * After registering a session, replays any actions that arrived before the snapshot.
@@ -2668,6 +3437,19 @@ declare class AhpClient extends EventEmitter<AhpClientEvents> {
      * Dispose a session and clean up server-side resources.
      */
     disposeSession(sessionUri: URI): Promise<null>;
+    /**
+     * Create a new terminal on the server.
+     */
+    createTerminal(terminalUri: string, claim: ITerminalClaim, options?: {
+        name?: string;
+        cwd?: string;
+        cols?: number;
+        rows?: number;
+    }): Promise<null>;
+    /**
+     * Dispose a terminal and kill its process if still running.
+     */
+    disposeTerminal(terminalUri: string): Promise<null>;
     /**
      * List all sessions on the server.
      */
@@ -3396,4 +4178,22 @@ declare function ensureFileUri(pathOrUri: string): string;
  */
 declare function fileUriToDisplayPath(uri: string): string;
 
-export { ActionType, ActiveClientManager, AhpClient, type AhpClientEvents, type AhpClientOptions, type AhpxEvent, AttachmentType, AuthHandler, type AuthHandlerOptions, AuthRequiredReason, ConnectionPool, type ConnectionPoolOptions, type ConnectionProfile, ContentEncoding, CustomizationStatus, type EventForwarder, FleetManager, type FleetManagerOptions, ForwardingFormatter, type ForwardingFormatterOptions, HealthChecker, type IActionEnvelope, type IActiveTurn, type IAgentInfo, type ICreateSessionParams, type ICustomizationRef, type IErrorInfo, type IFetchTurnsResult, type IInitializeResult, type IListSessionsResult, type IMarkdownResponsePart, type IPendingMessage, type IProtocolNotification, type IReasoningResponsePart, type IResourceCopyParams, type IResourceCopyResult, type IResourceDeleteParams, type IResourceDeleteResult, type IResourceListResult, type IResourceMoveParams, type IResourceMoveResult, type IResourceReadResult, type IResourceWriteParams, type IResourceWriteResult, type IResponsePart, type IRootState, type ISessionCustomization, type ISessionForkSource, type ISessionState, type ISessionSummary, type ISnapshot, type IStateAction, type ISubscribeResult, type IToolAnnotations, type IToolCallResponsePart, type IToolCallState, type IToolDefinition, type ITurn, type IUsageInfo, type IUserMessage, type Icon, NotificationType, type OpenSessionOptions, PendingMessageKind, PolicyState, type PromptOptions, ProtocolLayer, type ProtocolLayerOptions, ReconnectManager, type ReconnectOptions, type ReconnectOutcome, ReconnectResultType, ResponsePartKind, type ResumeOutcome, type RoutingStrategy, RpcError, RpcTimeoutError, type ServerHealth, type ServerRequirements, type SessionFilter, SessionHandle, type SessionHandleEvents, SessionLifecycle, SessionPersistence, type SessionRecord, SessionStatus, SessionStore, type TurnResult as SessionTurnResult, StateMirror, type SyncResult, ToolCallCancellationReason, ToolCallConfirmationReason, ToolCallStatus, ToolResultContentType, Transport, type TransportOptions, TurnState, type TurnSummary, type URI, WebSocketForwarder, type WebSocketForwarderOptions, WebhookForwarder, type WebhookForwarderOptions, buildTurnSummary, ensureFileUri, fileUriToDisplayPath, truncatePreview };
+/** Union of all terminal-scoped actions. */
+type ITerminalAction = ITerminalDataAction | ITerminalInputAction | ITerminalResizedAction | ITerminalClaimedAction | ITerminalTitleChangedAction | ITerminalCwdChangedAction | ITerminalExitedAction | ITerminalClearedAction;
+/** Union of terminal actions that clients may dispatch. */
+type IClientTerminalAction = ITerminalInputAction | ITerminalResizedAction | ITerminalClaimedAction | ITerminalTitleChangedAction | ITerminalClearedAction;
+/** Union of terminal actions that only the server may produce. */
+type IServerTerminalAction = ITerminalDataAction | ITerminalCwdChangedAction | ITerminalExitedAction;
+
+/**
+ * Reducer Functions — Pure state reducers for AHP root, session, and terminal state.
+ *
+ * @module reducers
+ */
+
+/**
+ * Pure reducer for terminal state. Handles all {@link ITerminalAction} variants.
+ */
+declare function terminalReducer(state: ITerminalState, action: ITerminalAction, log?: (msg: string) => void): ITerminalState;
+
+export { ActionType, ActiveClientManager, AhpClient, type AhpClientEvents, type AhpClientOptions, type AhpxEvent, AttachmentType, AuthHandler, type AuthHandlerOptions, AuthRequiredReason, ConnectionPool, type ConnectionPoolOptions, type ConnectionProfile, ContentEncoding, type EventForwarder, FleetManager, type FleetManagerOptions, ForwardingFormatter, type ForwardingFormatterOptions, HealthChecker, type IActionEnvelope, type IActiveTurn, type IAgentInfo, type IClientTerminalAction, type ICreateSessionParams, type ICreateTerminalParams, type ICustomizationRef, type IDisposeTerminalParams, type IErrorInfo, type IFetchTurnsResult, type IInitializeResult, type IListSessionsResult, type IMarkdownResponsePart, type IPendingMessage, type IProjectInfo, type IProtocolNotification, type IReasoningResponsePart, type IResourceCopyParams, type IResourceCopyResult, type IResourceDeleteParams, type IResourceDeleteResult, type IResourceListResult, type IResourceMoveParams, type IResourceMoveResult, type IResourceReadResult, type IResourceWriteParams, type IResourceWriteResult, type IResponsePart, type IRootState, type IRootTerminalsChangedAction, type IServerTerminalAction, type ISessionCustomization, type ISessionDiffsChangedAction, type ISessionFileDiff, type ISessionForkSource, type ISessionInputAnswer, type ISessionInputAnswerChangedAction, type ISessionInputAnswerValue, type ISessionInputAnswered, type ISessionInputBooleanQuestion, type ISessionInputCompletedAction, type ISessionInputMultiSelectQuestion, type ISessionInputNumberQuestion, type ISessionInputOption, type ISessionInputQuestion, type ISessionInputRequest, type ISessionInputRequestedAction, type ISessionInputSingleSelectQuestion, type ISessionInputSkipped, type ISessionInputTextQuestion, type ISessionIsDoneChangedAction, type ISessionIsReadChangedAction, type ISessionState, type ISessionSummary, type ISessionSummaryChangedNotification, type ISessionToolCallContentChangedAction, type ISnapshot, type IStateAction, type ISubscribeResult, type ITerminalAction, type ITerminalClaim, type ITerminalClaimedAction, type ITerminalClearedAction, type ITerminalClientClaim, type ITerminalCwdChangedAction, type ITerminalDataAction, type ITerminalExitedAction, type ITerminalInfo, type ITerminalInputAction, type ITerminalResizedAction, type ITerminalSessionClaim, type ITerminalState, type ITerminalTitleChangedAction, type IToolAnnotations, type IToolCallResponsePart, type IToolCallState, type IToolDefinition, type IToolResultSubagentContent, type IToolResultTerminalContent, type ITurn, type IUsageInfo, type IUserMessage, type Icon, NotificationType, type OpenSessionOptions, PendingMessageKind, PolicyState, type PromptOptions, ProtocolLayer, type ProtocolLayerOptions, ReconnectManager, type ReconnectOptions, type ReconnectOutcome, ReconnectResultType, ResponsePartKind, type ResumeOutcome, type RoutingStrategy, RpcError, RpcTimeoutError, type ServerHealth, type ServerRequirements, type SessionFilter, SessionHandle, type SessionHandleEvents, SessionInputAnswerState, SessionInputAnswerValueKind, SessionInputQuestionKind, SessionInputResponseKind, SessionLifecycle, SessionPersistence, type SessionRecord, SessionStatus, SessionStore, type TurnResult as SessionTurnResult, StateMirror, type SyncResult, TerminalClaimKind, ToolCallCancellationReason, ToolCallConfirmationReason, ToolCallStatus, ToolResultContentType, Transport, type TransportOptions, TurnState, type TurnSummary, type URI, WebSocketForwarder, type WebSocketForwarderOptions, WebhookForwarder, type WebhookForwarderOptions, buildTurnSummary, ensureFileUri, fileUriToDisplayPath, terminalReducer, truncatePreview };