happy-imou-cloud 2.1.43 → 2.1.44

package/compat/acp-sdk-schema/types.gen.d.ts

@@ -1,3 +1,26 @@
+/**
+ * Notification sent when a suggestion is accepted.
+ */
+export type AcceptNesNotification = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The ID of the accepted suggestion.
+     */
+    id: string;
+    /**
+     * The session ID for this notification.
+     */
+    sessionId: SessionId;
+};
 /**
  * **UNSTABLE**
  *
@@ -62,20 +85,52 @@ export type AgentCapabilities = {
      * MCP capabilities supported by the agent.
      */
     mcpCapabilities?: McpCapabilities;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * NES (Next Edit Suggestions) capabilities supported by the agent.
+     *
+     * @experimental
+     */
+    nes?: NesCapabilities | null;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * The position encoding selected by the agent from the client's supported encodings.
+     *
+     * @experimental
+     */
+    positionEncoding?: PositionEncodingKind | null;
     /**
      * Prompt capabilities supported by the agent.
      */
     promptCapabilities?: PromptCapabilities;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * Provider configuration capabilities supported by the agent.
+     *
+     * By supplying `{}` it means that the agent supports provider configuration methods.
+     *
+     * @experimental
+     */
+    providers?: ProvidersCapabilities | null;
     sessionCapabilities?: SessionCapabilities;
 };
 export type AgentNotification = {
     method: string;
-    params?: SessionNotification | ElicitationCompleteNotification | ExtNotification | null;
+    params?: SessionNotification | CompleteElicitationNotification | ExtNotification | null;
 };
 export type AgentRequest = {
     id: RequestId;
     method: string;
-    params?: WriteTextFileRequest | ReadTextFileRequest | RequestPermissionRequest | CreateTerminalRequest | TerminalOutputRequest | ReleaseTerminalRequest | WaitForTerminalExitRequest | KillTerminalRequest | ElicitationRequest | ExtRequest | null;
+    params?: WriteTextFileRequest | ReadTextFileRequest | RequestPermissionRequest | CreateTerminalRequest | TerminalOutputRequest | ReleaseTerminalRequest | WaitForTerminalExitRequest | KillTerminalRequest | CreateElicitationRequest | ExtRequest | null;
 };
 export type AgentResponse = {
     id: RequestId;
@@ -87,7 +142,7 @@ export type AgentResponse = {
      *
      * These are responses to the corresponding `ClientRequest` variants.
      */
-    result: InitializeResponse | AuthenticateResponse | LogoutResponse | NewSessionResponse | LoadSessionResponse | ListSessionsResponse | ForkSessionResponse | ResumeSessionResponse | CloseSessionResponse | SetSessionModeResponse | SetSessionConfigOptionResponse | PromptResponse | SetSessionModelResponse | ExtResponse;
+    result: InitializeResponse | AuthenticateResponse | ListProvidersResponse | SetProvidersResponse | DisableProvidersResponse | LogoutResponse | NewSessionResponse | LoadSessionResponse | ListSessionsResponse | ForkSessionResponse | ResumeSessionResponse | CloseSessionResponse | SetSessionModeResponse | SetSessionConfigOptionResponse | PromptResponse | SetSessionModelResponse | StartNesResponse | SuggestNesResponse | CloseNesResponse | ExtResponse;
 } | {
     error: Error;
     id: RequestId;
@@ -548,19 +603,66 @@ export type ClientCapabilities = {
      * Determines which file operations the agent can request.
      */
     fs?: FileSystemCapabilities;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * NES (Next Edit Suggestions) capabilities supported by the client.
+     *
+     * @experimental
+     */
+    nes?: ClientNesCapabilities | null;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * The position encodings supported by the client, in order of preference.
+     *
+     * @experimental
+     */
+    positionEncodings?: Array<PositionEncodingKind>;
     /**
      * Whether the Client support all `terminal*` methods.
      */
     terminal?: boolean;
 };
+/**
+ * NES capabilities advertised by the client during initialization.
+ */
+export type ClientNesCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Whether the client supports the `jump` suggestion kind.
+     */
+    jump?: NesJumpCapabilities | null;
+    /**
+     * Whether the client supports the `rename` suggestion kind.
+     */
+    rename?: NesRenameCapabilities | null;
+    /**
+     * Whether the client supports the `searchAndReplace` suggestion kind.
+     */
+    searchAndReplace?: NesSearchAndReplaceCapabilities | null;
+};
 export type ClientNotification = {
     method: string;
-    params?: CancelNotification | ExtNotification | null;
+    params?: CancelNotification | DidOpenDocumentNotification | DidChangeDocumentNotification | DidCloseDocumentNotification | DidSaveDocumentNotification | DidFocusDocumentNotification | AcceptNesNotification | RejectNesNotification | ExtNotification | null;
 };
 export type ClientRequest = {
     id: RequestId;
     method: string;
-    params?: InitializeRequest | AuthenticateRequest | LogoutRequest | NewSessionRequest | LoadSessionRequest | ListSessionsRequest | ForkSessionRequest | ResumeSessionRequest | CloseSessionRequest | SetSessionModeRequest | SetSessionConfigOptionRequest | PromptRequest | SetSessionModelRequest | ExtRequest | null;
+    params?: InitializeRequest | AuthenticateRequest | ListProvidersRequest | SetProvidersRequest | DisableProvidersRequest | LogoutRequest | NewSessionRequest | LoadSessionRequest | ListSessionsRequest | ForkSessionRequest | ResumeSessionRequest | CloseSessionRequest | SetSessionModeRequest | SetSessionConfigOptionRequest | PromptRequest | SetSessionModelRequest | StartNesRequest | SuggestNesRequest | CloseNesRequest | ExtRequest | null;
 };
 export type ClientResponse = {
     id: RequestId;
@@ -572,25 +674,56 @@ export type ClientResponse = {
      *
      * These are responses to the corresponding `AgentRequest` variants.
      */
-    result: WriteTextFileResponse | ReadTextFileResponse | RequestPermissionResponse | CreateTerminalResponse | TerminalOutputResponse | ReleaseTerminalResponse | WaitForTerminalExitResponse | KillTerminalResponse | ElicitationResponse | ExtResponse;
+    result: WriteTextFileResponse | ReadTextFileResponse | RequestPermissionResponse | CreateTerminalResponse | TerminalOutputResponse | ReleaseTerminalResponse | WaitForTerminalExitResponse | KillTerminalResponse | CreateElicitationResponse | ExtResponse;
 } | {
     error: Error;
     id: RequestId;
 };
 /**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
+ * Request to close an NES session.
  *
+ * The agent **must** cancel any ongoing work related to the NES session
+ * and then free up any resources associated with the session.
+ */
+export type CloseNesRequest = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The ID of the NES session to close.
+     */
+    sessionId: SessionId;
+};
+/**
+ * Response from closing an NES session.
+ */
+export type CloseNesResponse = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
  * Request parameters for closing an active session.
  *
  * If supported, the agent **must** cancel any ongoing work related to the session
  * (treat it as if `session/cancel` was called) and then free up any resources
  * associated with the session.
  *
- * Only available if the Agent supports the `session.close` capability.
- *
- * @experimental
+ * Only available if the Agent supports the `sessionCapabilities.close` capability.
  */
 export type CloseSessionRequest = {
     /**
@@ -608,16 +741,31 @@ export type CloseSessionRequest = {
      */
     sessionId: SessionId;
 };
+/**
+ * Response from closing a session.
+ */
+export type CloseSessionResponse = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
 /**
  * **UNSTABLE**
  *
  * This capability is not part of the spec yet, and may be removed or changed at any point.
  *
- * Response from closing a session.
+ * Notification sent by the agent when a URL-based elicitation is complete.
  *
  * @experimental
  */
-export type CloseSessionResponse = {
+export type CompleteElicitationNotification = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -628,6 +776,10 @@ export type CloseSessionResponse = {
     _meta?: {
         [key: string]: unknown;
     } | null;
+    /**
+     * The ID of the elicitation that completed.
+     */
+    elicitationId: ElicitationId;
 };
 /**
  * Session configuration options have been updated.
@@ -746,6 +898,66 @@ export type Cost = {
      */
     currency: string;
 };
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Request from the agent to elicit structured user input.
+ *
+ * The agent sends this to the client to request information from the user,
+ * either via a form or by directing them to a URL.
+ * Elicitations are tied to a session (optionally a tool call) or a request.
+ *
+ * @experimental
+ */
+export type CreateElicitationRequest = ((ElicitationFormMode & {
+    mode: "form";
+}) | (ElicitationUrlMode & {
+    mode: "url";
+})) & {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * A human-readable message describing what input is needed.
+     */
+    message: string;
+};
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Response from the client to an elicitation request.
+ *
+ * @experimental
+ */
+export type CreateElicitationResponse = ((ElicitationAcceptAction & {
+    action: "accept";
+}) | {
+    action: "decline";
+} | {
+    action: "cancel";
+}) & {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
 /**
  * Request to create a new terminal and execute a command.
  */
@@ -833,13 +1045,9 @@ export type CurrentModeUpdate = {
     currentModeId: SessionModeId;
 };
 /**
- * A diff representing file modifications.
- *
- * Shows changes to files in a format suitable for display in the client UI.
- *
- * See protocol docs: [Content](https://agentclientprotocol.com/protocol/tool-calls#content)
+ * Notification sent when a file is edited.
  */
-export type Diff = {
+export type DidChangeDocumentNotification = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -851,61 +1059,26 @@ export type Diff = {
         [key: string]: unknown;
     } | null;
     /**
-     * The new content after modification.
+     * The content changes.
      */
-    newText: string;
+    contentChanges: Array<TextDocumentContentChangeEvent>;
     /**
-     * The original content (None for new files).
+     * The session ID for this notification.
      */
-    oldText?: string | null;
+    sessionId: SessionId;
     /**
-     * The file path being modified.
+     * The URI of the changed document.
      */
-    path: string;
-};
-/**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
- * The user accepted the elicitation and provided content.
- *
- * @experimental
- */
-export type ElicitationAcceptAction = {
+    uri: string;
     /**
-     * The user-provided content, if any, as an object matching the requested schema.
+     * The new version number of the document.
      */
-    content?: {
-        [key: string]: ElicitationContentValue;
-    } | null;
-};
-/**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
- * The user's action in response to an elicitation.
- *
- * @experimental
- */
-export type ElicitationAction = (ElicitationAcceptAction & {
-    action: "accept";
-}) | {
-    action: "decline";
-} | {
-    action: "cancel";
+    version: number;
 };
 /**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
- * Elicitation capabilities supported by the client.
- *
- * @experimental
+ * Notification sent when a file is closed.
  */
-export type ElicitationCapabilities = {
+export type DidCloseDocumentNotification = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -917,24 +1090,18 @@ export type ElicitationCapabilities = {
         [key: string]: unknown;
     } | null;
     /**
-     * Whether the client supports form-based elicitation.
+     * The session ID for this notification.
      */
-    form?: ElicitationFormCapabilities | null;
+    sessionId: SessionId;
     /**
-     * Whether the client supports URL-based elicitation.
+     * The URI of the closed document.
      */
-    url?: ElicitationUrlCapabilities | null;
+    uri: string;
 };
 /**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
- * Notification sent by the agent when a URL-based elicitation is complete.
- *
- * @experimental
+ * Notification sent when a file becomes the active editor tab.
  */
-export type ElicitationCompleteNotification = {
+export type DidFocusDocumentNotification = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -946,21 +1113,125 @@ export type ElicitationCompleteNotification = {
         [key: string]: unknown;
     } | null;
     /**
-     * The ID of the elicitation that completed.
+     * The current cursor position.
      */
-    elicitationId: ElicitationId;
-};
-export type ElicitationContentValue = string | number | number | boolean | Array<string>;
+    position: Position;
+    /**
+     * The session ID for this notification.
+     */
+    sessionId: SessionId;
+    /**
+     * The URI of the focused document.
+     */
+    uri: string;
+    /**
+     * The version number of the document.
+     */
+    version: number;
+    /**
+     * The portion of the file currently visible in the editor viewport.
+     */
+    visibleRange: Range;
+};
+/**
+ * Notification sent when a file is opened in the editor.
+ */
+export type DidOpenDocumentNotification = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The language identifier of the document (e.g., "rust", "python").
+     */
+    languageId: string;
+    /**
+     * The session ID for this notification.
+     */
+    sessionId: SessionId;
+    /**
+     * The full text content of the document.
+     */
+    text: string;
+    /**
+     * The URI of the opened document.
+     */
+    uri: string;
+    /**
+     * The version number of the document.
+     */
+    version: number;
+};
+/**
+ * Notification sent when a file is saved.
+ */
+export type DidSaveDocumentNotification = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The session ID for this notification.
+     */
+    sessionId: SessionId;
+    /**
+     * The URI of the saved document.
+     */
+    uri: string;
+};
+/**
+ * A diff representing file modifications.
+ *
+ * Shows changes to files in a format suitable for display in the client UI.
+ *
+ * See protocol docs: [Content](https://agentclientprotocol.com/protocol/tool-calls#content)
+ */
+export type Diff = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The new content after modification.
+     */
+    newText: string;
+    /**
+     * The original content (None for new files).
+     */
+    oldText?: string | null;
+    /**
+     * The file path being modified.
+     */
+    path: string;
+};
 /**
  * **UNSTABLE**
  *
  * This capability is not part of the spec yet, and may be removed or changed at any point.
  *
- * Form-based elicitation capabilities.
+ * Request parameters for `providers/disable`.
  *
  * @experimental
  */
-export type ElicitationFormCapabilities = {
+export type DisableProvidersRequest = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -971,55 +1242,59 @@ export type ElicitationFormCapabilities = {
     _meta?: {
         [key: string]: unknown;
     } | null;
+    /**
+     * Provider id to disable.
+     */
+    id: string;
 };
 /**
  * **UNSTABLE**
  *
  * This capability is not part of the spec yet, and may be removed or changed at any point.
  *
- * Form-based elicitation mode where the client renders a form from the provided schema.
+ * Response to `providers/disable`.
  *
  * @experimental
  */
-export type ElicitationFormMode = {
+export type DisableProvidersResponse = {
     /**
-     * A JSON Schema describing the form fields to present to the user.
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
      */
-    requestedSchema: ElicitationSchema;
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
 };
 /**
  * **UNSTABLE**
  *
  * This capability is not part of the spec yet, and may be removed or changed at any point.
  *
- * Unique identifier for an elicitation.
+ * The user accepted the elicitation and provided content.
  *
  * @experimental
  */
-export type ElicitationId = string;
+export type ElicitationAcceptAction = {
+    /**
+     * The user-provided content, if any, as an object matching the requested schema.
+     */
+    content?: {
+        [key: string]: ElicitationContentValue;
+    } | null;
+};
 /**
- * Property schema for elicitation form fields.
+ * **UNSTABLE**
  *
- * Each variant corresponds to a JSON Schema `"type"` value.
- * Single-select enums use the `String` variant with `enum` or `oneOf` set.
- * Multi-select enums use the `Array` variant.
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Elicitation capabilities supported by the client.
+ *
+ * @experimental
  */
-export type ElicitationPropertySchema = (StringPropertySchema & {
-    type: "string";
-}) | (NumberPropertySchema & {
-    type: "number";
-}) | (IntegerPropertySchema & {
-    type: "integer";
-}) | (BooleanPropertySchema & {
-    type: "boolean";
-}) | (MultiSelectPropertySchema & {
-    type: "array";
-});
-export type ElicitationRequest = ((ElicitationFormMode & {
-    mode: "form";
-}) | (ElicitationUrlMode & {
-    mode: "url";
-})) & {
+export type ElicitationCapabilities = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -1031,24 +1306,25 @@ export type ElicitationRequest = ((ElicitationFormMode & {
         [key: string]: unknown;
     } | null;
     /**
-     * A human-readable message describing what input is needed.
+     * Whether the client supports form-based elicitation.
      */
-    message: string;
+    form?: ElicitationFormCapabilities | null;
     /**
-     * The session ID for this request.
+     * Whether the client supports URL-based elicitation.
      */
-    sessionId: SessionId;
+    url?: ElicitationUrlCapabilities | null;
 };
+export type ElicitationContentValue = string | number | number | boolean | Array<string>;
 /**
  * **UNSTABLE**
  *
  * This capability is not part of the spec yet, and may be removed or changed at any point.
  *
- * Response from the client to an elicitation request.
+ * Form-based elicitation capabilities.
  *
  * @experimental
  */
-export type ElicitationResponse = {
+export type ElicitationFormCapabilities = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -1059,10 +1335,65 @@ export type ElicitationResponse = {
     _meta?: {
         [key: string]: unknown;
     } | null;
+};
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Form-based elicitation mode where the client renders a form from the provided schema.
+ *
+ * @experimental
+ */
+export type ElicitationFormMode = (ElicitationSessionScope | ElicitationRequestScope) & {
+    /**
+     * A JSON Schema describing the form fields to present to the user.
+     */
+    requestedSchema: ElicitationSchema;
+};
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Unique identifier for an elicitation.
+ *
+ * @experimental
+ */
+export type ElicitationId = string;
+/**
+ * Property schema for elicitation form fields.
+ *
+ * Each variant corresponds to a JSON Schema `"type"` value.
+ * Single-select enums use the `String` variant with `enum` or `oneOf` set.
+ * Multi-select enums use the `Array` variant.
+ */
+export type ElicitationPropertySchema = (StringPropertySchema & {
+    type: "string";
+}) | (NumberPropertySchema & {
+    type: "number";
+}) | (IntegerPropertySchema & {
+    type: "integer";
+}) | (BooleanPropertySchema & {
+    type: "boolean";
+}) | (MultiSelectPropertySchema & {
+    type: "array";
+});
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Request-scoped elicitation, tied to a specific JSON-RPC request outside of a session
+ * (e.g., during auth/configuration phases before any session is started).
+ *
+ * @experimental
+ */
+export type ElicitationRequestScope = {
     /**
-     * The user's action in response to the elicitation.
+     * The request this elicitation is tied to.
      */
-    action: ElicitationAction;
+    requestId: RequestId;
 };
 /**
  * Type-safe elicitation schema for requesting structured user input.
@@ -1098,6 +1429,29 @@ export type ElicitationSchema = {
  * Object schema type.
  */
 export type ElicitationSchemaType = "object";
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Session-scoped elicitation, optionally tied to a specific tool call.
+ *
+ * When `tool_call_id` is set, the elicitation is tied to a specific tool call.
+ * This is useful when an agent receives an elicitation from an MCP server
+ * during a tool call and needs to redirect it to the user.
+ *
+ * @experimental
+ */
+export type ElicitationSessionScope = {
+    /**
+     * The session this elicitation is tied to.
+     */
+    sessionId: SessionId;
+    /**
+     * Optional tool call within the session.
+     */
+    toolCallId?: ToolCallId | null;
+};
 /**
  * String schema type.
  */
@@ -1132,7 +1486,7 @@ export type ElicitationUrlCapabilities = {
  *
  * @experimental
  */
-export type ElicitationUrlMode = {
+export type ElicitationUrlMode = (ElicitationSessionScope | ElicitationRequestScope) & {
     /**
      * The unique identifier for this elicitation.
      */
@@ -1305,6 +1659,20 @@ export type ForkSessionRequest = {
     _meta?: {
         [key: string]: unknown;
     } | null;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * Additional workspace roots to activate for this session. Each path must be absolute.
+     *
+     * When omitted or empty, no additional roots are activated. When non-empty,
+     * this is the complete resulting additional-root list for the forked
+     * session.
+     *
+     * @experimental
+     */
+    additionalDirectories?: Array<string>;
     /**
      * The working directory for this session.
      */
@@ -1576,11 +1944,15 @@ export type KillTerminalResponse = {
     } | null;
 };
 /**
- * Request parameters for listing existing sessions.
+ * **UNSTABLE**
  *
- * Only available if the Agent supports the `sessionCapabilities.list` capability.
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Request parameters for `providers/list`.
+ *
+ * @experimental
  */
-export type ListSessionsRequest = {
+export type ListProvidersRequest = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -1591,19 +1963,17 @@ export type ListSessionsRequest = {
     _meta?: {
         [key: string]: unknown;
     } | null;
-    /**
-     * Opaque cursor token from a previous response's nextCursor field for cursor-based pagination
-     */
-    cursor?: string | null;
-    /**
-     * Filter sessions by working directory. Must be an absolute path.
-     */
-    cwd?: string | null;
 };
 /**
- * Response from listing sessions.
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Response to `providers/list`.
+ *
+ * @experimental
  */
-export type ListSessionsResponse = {
+export type ListProvidersResponse = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -1615,15 +1985,87 @@ export type ListSessionsResponse = {
         [key: string]: unknown;
     } | null;
     /**
-     * Opaque cursor token. If present, pass this in the next request's cursor parameter
-     * to fetch the next page. If absent, there are no more results.
+     * Configurable providers with current routing info suitable for UI display.
      */
-    nextCursor?: string | null;
+    providers: Array<ProviderInfo>;
+};
+/**
+ * Request parameters for listing existing sessions.
+ *
+ * Only available if the Agent supports the `sessionCapabilities.list` capability.
+ */
+export type ListSessionsRequest = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * Filter sessions by the exact ordered additional workspace roots. Each path must be absolute.
+     *
+     * This filter applies only when the field is present and non-empty. When
+     * omitted or empty, no additional-root filter is applied.
+     *
+     * @experimental
+     */
+    additionalDirectories?: Array<string>;
+    /**
+     * Opaque cursor token from a previous response's nextCursor field for cursor-based pagination
+     */
+    cursor?: string | null;
+    /**
+     * Filter sessions by working directory. Must be an absolute path.
+     */
+    cwd?: string | null;
+};
+/**
+ * Response from listing sessions.
+ */
+export type ListSessionsResponse = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Opaque cursor token. If present, pass this in the next request's cursor parameter
+     * to fetch the next page. If absent, there are no more results.
+     */
+    nextCursor?: string | null;
     /**
      * Array of session information objects
      */
     sessions: Array<SessionInfo>;
 };
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Well-known API protocol identifiers for LLM providers.
+ *
+ * Agents and clients MUST handle unknown protocol identifiers gracefully.
+ *
+ * Protocol names beginning with `_` are free for custom use, like other ACP extension methods.
+ * Protocol names that do not begin with `_` are reserved for the ACP spec.
+ *
+ * @experimental
+ */
+export type LlmProtocol = "anthropic" | "openai" | "azure" | "vertex" | "bedrock" | string;
 /**
  * Request parameters for loading an existing session.
  *
@@ -1642,6 +2084,20 @@ export type LoadSessionRequest = {
     _meta?: {
         [key: string]: unknown;
     } | null;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * Additional workspace roots to activate for this session. Each path must be absolute.
+     *
+     * When omitted or empty, no additional roots are activated. When non-empty,
+     * this is the complete resulting additional-root list for the loaded
+     * session.
+     *
+     * @experimental
+     */
+    additionalDirectories?: Array<string>;
     /**
      * The working directory for this session.
      */
@@ -1955,11 +2411,9 @@ export type MultiSelectPropertySchema = {
     title?: string | null;
 };
 /**
- * Request parameters for creating a new session.
- *
- * See protocol docs: [Creating a Session](https://agentclientprotocol.com/protocol/session-setup#creating-a-session)
+ * NES capabilities advertised by the agent during initialization.
  */
-export type NewSessionRequest = {
+export type NesCapabilities = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -1971,20 +2425,18 @@ export type NewSessionRequest = {
         [key: string]: unknown;
     } | null;
     /**
-     * The working directory for this session. Must be an absolute path.
+     * Context the agent wants attached to each suggestion request.
      */
-    cwd: string;
+    context?: NesContextCapabilities | null;
     /**
-     * List of MCP (Model Context Protocol) servers the agent should connect to.
+     * Events the agent wants to receive.
      */
-    mcpServers: Array<McpServer>;
+    events?: NesEventCapabilities | null;
 };
 /**
- * Response from creating a new session.
- *
- * See protocol docs: [Creating a Session](https://agentclientprotocol.com/protocol/session-setup#creating-a-session)
+ * Context capabilities the agent wants attached to each suggestion request.
  */
-export type NewSessionResponse = {
+export type NesContextCapabilities = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -1996,61 +2448,59 @@ export type NewSessionResponse = {
         [key: string]: unknown;
     } | null;
     /**
-     * Initial session configuration options if supported by the Agent.
+     * Whether the agent wants diagnostics context.
      */
-    configOptions?: Array<SessionConfigOption> | null;
+    diagnostics?: NesDiagnosticsCapabilities | null;
     /**
-     * **UNSTABLE**
-     *
-     * This capability is not part of the spec yet, and may be removed or changed at any point.
-     *
-     * Initial model state if supported by the Agent
-     *
-     * @experimental
+     * Whether the agent wants edit history context.
      */
-    models?: SessionModelState | null;
+    editHistory?: NesEditHistoryCapabilities | null;
     /**
-     * Initial mode state if supported by the Agent
-     *
-     * See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
+     * Whether the agent wants open files context.
      */
-    modes?: SessionModeState | null;
+    openFiles?: NesOpenFilesCapabilities | null;
     /**
-     * Unique identifier for the created session.
-     *
-     * Used in all subsequent requests for this conversation.
+     * Whether the agent wants recent files context.
      */
-    sessionId: SessionId;
+    recentFiles?: NesRecentFilesCapabilities | null;
+    /**
+     * Whether the agent wants related snippets context.
+     */
+    relatedSnippets?: NesRelatedSnippetsCapabilities | null;
+    /**
+     * Whether the agent wants user actions context.
+     */
+    userActions?: NesUserActionsCapabilities | null;
 };
 /**
- * Schema for number (floating-point) properties in an elicitation form.
+ * A diagnostic (error, warning, etc.).
  */
-export type NumberPropertySchema = {
-    /**
-     * Default value.
-     */
-    default?: number | null;
+export type NesDiagnostic = {
     /**
-     * Human-readable description.
+     * The diagnostic message.
      */
-    description?: string | null;
+    message: string;
     /**
-     * Maximum value (inclusive).
+     * The range of the diagnostic.
      */
-    maximum?: number | null;
+    range: Range;
     /**
-     * Minimum value (inclusive).
+     * The severity of the diagnostic.
      */
-    minimum?: number | null;
+    severity: NesDiagnosticSeverity;
     /**
-     * Optional title for the property.
+     * The URI of the file containing the diagnostic.
      */
-    title?: string | null;
+    uri: string;
 };
 /**
- * An option presented to the user when requesting permission.
+ * Severity of a diagnostic.
  */
-export type PermissionOption = {
+export type NesDiagnosticSeverity = "error" | "warning" | "information" | "hint";
+/**
+ * Capabilities for diagnostics context.
+ */
+export type NesDiagnosticsCapabilities = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -2061,39 +2511,30 @@ export type PermissionOption = {
     _meta?: {
         [key: string]: unknown;
     } | null;
+};
+/**
+ * Capabilities for `document/didChange` events.
+ */
+export type NesDocumentDidChangeCapabilities = {
     /**
-     * Hint about the nature of this permission option.
-     */
-    kind: PermissionOptionKind;
-    /**
-     * Human-readable label to display to the user.
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
      */
-    name: string;
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
     /**
-     * Unique identifier for this permission option.
+     * The sync kind the agent wants: `"full"` or `"incremental"`.
      */
-    optionId: PermissionOptionId;
+    syncKind: TextDocumentSyncKind;
 };
 /**
- * Unique identifier for a permission option.
- */
-export type PermissionOptionId = string;
-/**
- * The type of permission option being presented to the user.
- *
- * Helps clients choose appropriate icons and UI treatment.
- */
-export type PermissionOptionKind = "allow_once" | "allow_always" | "reject_once" | "reject_always";
-/**
- * An execution plan for accomplishing complex tasks.
- *
- * Plans consist of multiple entries representing individual tasks or goals.
- * Agents report plans to clients to provide visibility into their execution strategy.
- * Plans can evolve during execution as the agent discovers new requirements or completes tasks.
- *
- * See protocol docs: [Agent Plan](https://agentclientprotocol.com/protocol/agent-plan)
+ * Marker for `document/didClose` capability support.
  */
-export type Plan = {
+export type NesDocumentDidCloseCapabilities = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -2104,22 +2545,26 @@ export type Plan = {
     _meta?: {
         [key: string]: unknown;
     } | null;
+};
+/**
+ * Marker for `document/didFocus` capability support.
+ */
+export type NesDocumentDidFocusCapabilities = {
     /**
-     * The list of tasks to be accomplished.
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
      *
-     * 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.
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
      */
-    entries: Array<PlanEntry>;
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
 };
 /**
- * A single entry in the execution plan.
- *
- * Represents a task or goal that the assistant intends to accomplish
- * as part of fulfilling the user's request.
- * See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)
+ * Marker for `document/didOpen` capability support.
  */
-export type PlanEntry = {
+export type NesDocumentDidOpenCapabilities = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -2130,50 +2575,26 @@ export type PlanEntry = {
     _meta?: {
         [key: string]: unknown;
     } | null;
-    /**
-     * Human-readable description of what this task aims to accomplish.
-     */
-    content: string;
-    /**
-     * The relative importance of this task.
-     * Used to indicate which tasks are most critical to the overall goal.
-     */
-    priority: PlanEntryPriority;
-    /**
-     * Current execution status of this task.
-     */
-    status: PlanEntryStatus;
 };
 /**
- * Priority levels for plan entries.
- *
- * Used to indicate the relative importance or urgency of different
- * tasks in the execution plan.
- * See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)
- */
-export type PlanEntryPriority = "high" | "medium" | "low";
-/**
- * Status of a plan entry in the execution flow.
- *
- * Tracks the lifecycle of each task from planning through completion.
- * See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)
+ * Marker for `document/didSave` capability support.
  */
-export type PlanEntryStatus = "pending" | "in_progress" | "completed";
+export type NesDocumentDidSaveCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
 /**
- * Prompt capabilities supported by the agent in `session/prompt` requests.
- *
- * Baseline agent functionality requires support for [`ContentBlock::Text`]
- * and [`ContentBlock::ResourceLink`] in prompt requests.
- *
- * Other variants must be explicitly opted in to.
- * Capabilities for different types of content in prompt requests.
- *
- * Indicates which content types beyond the baseline (text and resource links)
- * the agent can process.
- *
- * See protocol docs: [Prompt Capabilities](https://agentclientprotocol.com/protocol/initialization#prompt-capabilities)
+ * Document event capabilities the agent wants to receive.
  */
-export type PromptCapabilities = {
+export type NesDocumentEventCapabilities = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -2185,29 +2606,30 @@ export type PromptCapabilities = {
         [key: string]: unknown;
     } | null;
     /**
-     * Agent supports [`ContentBlock::Audio`].
+     * Whether the agent wants `document/didChange` events, and the sync kind.
      */
-    audio?: boolean;
+    didChange?: NesDocumentDidChangeCapabilities | null;
     /**
-     * Agent supports embedded context in `session/prompt` requests.
-     *
-     * When enabled, the Client is allowed to include [`ContentBlock::Resource`]
-     * in prompt requests for pieces of context that are referenced in the message.
+     * Whether the agent wants `document/didClose` events.
      */
-    embeddedContext?: boolean;
+    didClose?: NesDocumentDidCloseCapabilities | null;
     /**
-     * Agent supports [`ContentBlock::Image`].
+     * Whether the agent wants `document/didFocus` events.
      */
-    image?: boolean;
+    didFocus?: NesDocumentDidFocusCapabilities | null;
+    /**
+     * Whether the agent wants `document/didOpen` events.
+     */
+    didOpen?: NesDocumentDidOpenCapabilities | null;
+    /**
+     * Whether the agent wants `document/didSave` events.
+     */
+    didSave?: NesDocumentDidSaveCapabilities | null;
 };
 /**
- * Request parameters for sending a user prompt to the agent.
- *
- * Contains the user's message and any additional context.
- *
- * See protocol docs: [User Message](https://agentclientprotocol.com/protocol/prompt-turn#1-user-message)
+ * Capabilities for edit history context.
  */
-export type PromptRequest = {
+export type NesEditHistoryCapabilities = {
     /**
      * The _meta property is reserved by ACP to allow clients and agents to attach additional
      * metadata to their interactions. Implementations MUST NOT make assumptions about values at
@@ -2219,9 +2641,720 @@ export type PromptRequest = {
         [key: string]: unknown;
     } | null;
     /**
-     * **UNSTABLE**
-     *
-     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     * Maximum number of edit history entries the agent can use.
+     */
+    maxCount?: number | null;
+};
+/**
+ * An entry in the edit history.
+ */
+export type NesEditHistoryEntry = {
+    /**
+     * A diff representing the edit.
+     */
+    diff: string;
+    /**
+     * The URI of the edited file.
+     */
+    uri: string;
+};
+/**
+ * A text edit suggestion.
+ */
+export type NesEditSuggestion = {
+    /**
+     * Optional suggested cursor position after applying edits.
+     */
+    cursorPosition?: Position | null;
+    /**
+     * The text edits to apply.
+     */
+    edits: Array<NesTextEdit>;
+    /**
+     * Unique identifier for accept/reject tracking.
+     */
+    id: string;
+    /**
+     * The URI of the file to edit.
+     */
+    uri: string;
+};
+/**
+ * Event capabilities the agent can consume.
+ */
+export type NesEventCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Document event capabilities.
+     */
+    document?: NesDocumentEventCapabilities | null;
+};
+/**
+ * A code excerpt from a file.
+ */
+export type NesExcerpt = {
+    /**
+     * The end line of the excerpt (zero-based).
+     */
+    endLine: number;
+    /**
+     * The start line of the excerpt (zero-based).
+     */
+    startLine: number;
+    /**
+     * The text content of the excerpt.
+     */
+    text: string;
+};
+/**
+ * Marker for jump suggestion support.
+ */
+export type NesJumpCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
+ * A jump-to-location suggestion.
+ */
+export type NesJumpSuggestion = {
+    /**
+     * Unique identifier for accept/reject tracking.
+     */
+    id: string;
+    /**
+     * The target position within the file.
+     */
+    position: Position;
+    /**
+     * The file to navigate to.
+     */
+    uri: string;
+};
+/**
+ * An open file in the editor.
+ */
+export type NesOpenFile = {
+    /**
+     * The language identifier.
+     */
+    languageId: string;
+    /**
+     * Timestamp in milliseconds since epoch of when the file was last focused.
+     */
+    lastFocusedMs?: number | null;
+    /**
+     * The URI of the file.
+     */
+    uri: string;
+    /**
+     * The visible range in the editor, if any.
+     */
+    visibleRange?: Range | null;
+};
+/**
+ * Capabilities for open files context.
+ */
+export type NesOpenFilesCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
+ * A recently accessed file.
+ */
+export type NesRecentFile = {
+    /**
+     * The language identifier.
+     */
+    languageId: string;
+    /**
+     * The full text content of the file.
+     */
+    text: string;
+    /**
+     * The URI of the file.
+     */
+    uri: string;
+};
+/**
+ * Capabilities for recent files context.
+ */
+export type NesRecentFilesCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Maximum number of recent files the agent can use.
+     */
+    maxCount?: number | null;
+};
+/**
+ * The reason a suggestion was rejected.
+ */
+export type NesRejectReason = "rejected" | "ignored" | "replaced" | "cancelled";
+/**
+ * A related code snippet from a file.
+ */
+export type NesRelatedSnippet = {
+    /**
+     * The code excerpts.
+     */
+    excerpts: Array<NesExcerpt>;
+    /**
+     * The URI of the file containing the snippets.
+     */
+    uri: string;
+};
+/**
+ * Capabilities for related snippets context.
+ */
+export type NesRelatedSnippetsCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
+ * Marker for rename suggestion support.
+ */
+export type NesRenameCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
+ * A rename symbol suggestion.
+ */
+export type NesRenameSuggestion = {
+    /**
+     * Unique identifier for accept/reject tracking.
+     */
+    id: string;
+    /**
+     * The new name for the symbol.
+     */
+    newName: string;
+    /**
+     * The position of the symbol to rename.
+     */
+    position: Position;
+    /**
+     * The file URI containing the symbol.
+     */
+    uri: string;
+};
+/**
+ * Repository metadata for an NES session.
+ */
+export type NesRepository = {
+    /**
+     * The repository name.
+     */
+    name: string;
+    /**
+     * The repository owner.
+     */
+    owner: string;
+    /**
+     * The remote URL of the repository.
+     */
+    remoteUrl: string;
+};
+/**
+ * Marker for search and replace suggestion support.
+ */
+export type NesSearchAndReplaceCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
+ * A search-and-replace suggestion.
+ */
+export type NesSearchAndReplaceSuggestion = {
+    /**
+     * Unique identifier for accept/reject tracking.
+     */
+    id: string;
+    /**
+     * Whether `search` is a regular expression. Defaults to `false`.
+     */
+    isRegex?: boolean | null;
+    /**
+     * The replacement text.
+     */
+    replace: string;
+    /**
+     * The text or pattern to find.
+     */
+    search: string;
+    /**
+     * The file URI to search within.
+     */
+    uri: string;
+};
+/**
+ * Context attached to a suggestion request.
+ */
+export type NesSuggestContext = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Current diagnostics (errors, warnings).
+     */
+    diagnostics?: Array<NesDiagnostic> | null;
+    /**
+     * Recent edit history.
+     */
+    editHistory?: Array<NesEditHistoryEntry> | null;
+    /**
+     * Currently open files in the editor.
+     */
+    openFiles?: Array<NesOpenFile> | null;
+    /**
+     * Recently accessed files.
+     */
+    recentFiles?: Array<NesRecentFile> | null;
+    /**
+     * Related code snippets.
+     */
+    relatedSnippets?: Array<NesRelatedSnippet> | null;
+    /**
+     * Recent user actions (typing, navigation, etc.).
+     */
+    userActions?: Array<NesUserAction> | null;
+};
+/**
+ * A suggestion returned by the agent.
+ */
+export type NesSuggestion = (NesEditSuggestion & {
+    kind: "edit";
+}) | (NesJumpSuggestion & {
+    kind: "jump";
+}) | (NesRenameSuggestion & {
+    kind: "rename";
+}) | (NesSearchAndReplaceSuggestion & {
+    kind: "searchAndReplace";
+});
+/**
+ * A text edit within a suggestion.
+ */
+export type NesTextEdit = {
+    /**
+     * The replacement text.
+     */
+    newText: string;
+    /**
+     * The range to replace.
+     */
+    range: Range;
+};
+/**
+ * What triggered the suggestion request.
+ */
+export type NesTriggerKind = "automatic" | "diagnostic" | "manual";
+/**
+ * A user action (typing, cursor movement, etc.).
+ */
+export type NesUserAction = {
+    /**
+     * The kind of action (e.g., "insertChar", "cursorMovement").
+     */
+    action: string;
+    /**
+     * The position where the action occurred.
+     */
+    position: Position;
+    /**
+     * Timestamp in milliseconds since epoch.
+     */
+    timestampMs: number;
+    /**
+     * The URI of the file where the action occurred.
+     */
+    uri: string;
+};
+/**
+ * Capabilities for user actions context.
+ */
+export type NesUserActionsCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Maximum number of user actions the agent can use.
+     */
+    maxCount?: number | null;
+};
+/**
+ * Request parameters for creating a new session.
+ *
+ * See protocol docs: [Creating a Session](https://agentclientprotocol.com/protocol/session-setup#creating-a-session)
+ */
+export type NewSessionRequest = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * Additional workspace roots for this session. Each path must be absolute.
+     *
+     * These expand the session's filesystem scope without changing `cwd`, which
+     * remains the base for relative paths. When omitted or empty, no
+     * additional roots are activated for the new session.
+     *
+     * @experimental
+     */
+    additionalDirectories?: Array<string>;
+    /**
+     * The working directory for this session. Must be an absolute path.
+     */
+    cwd: string;
+    /**
+     * List of MCP (Model Context Protocol) servers the agent should connect to.
+     */
+    mcpServers: Array<McpServer>;
+};
+/**
+ * Response from creating a new session.
+ *
+ * See protocol docs: [Creating a Session](https://agentclientprotocol.com/protocol/session-setup#creating-a-session)
+ */
+export type NewSessionResponse = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Initial session configuration options if supported by the Agent.
+     */
+    configOptions?: Array<SessionConfigOption> | null;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * Initial model state if supported by the Agent
+     *
+     * @experimental
+     */
+    models?: SessionModelState | null;
+    /**
+     * Initial mode state if supported by the Agent
+     *
+     * See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
+     */
+    modes?: SessionModeState | null;
+    /**
+     * Unique identifier for the created session.
+     *
+     * Used in all subsequent requests for this conversation.
+     */
+    sessionId: SessionId;
+};
+/**
+ * Schema for number (floating-point) properties in an elicitation form.
+ */
+export type NumberPropertySchema = {
+    /**
+     * Default value.
+     */
+    default?: number | null;
+    /**
+     * Human-readable description.
+     */
+    description?: string | null;
+    /**
+     * Maximum value (inclusive).
+     */
+    maximum?: number | null;
+    /**
+     * Minimum value (inclusive).
+     */
+    minimum?: number | null;
+    /**
+     * Optional title for the property.
+     */
+    title?: string | null;
+};
+/**
+ * An option presented to the user when requesting permission.
+ */
+export type PermissionOption = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Hint about the nature of this permission option.
+     */
+    kind: PermissionOptionKind;
+    /**
+     * Human-readable label to display to the user.
+     */
+    name: string;
+    /**
+     * Unique identifier for this permission option.
+     */
+    optionId: PermissionOptionId;
+};
+/**
+ * Unique identifier for a permission option.
+ */
+export type PermissionOptionId = string;
+/**
+ * The type of permission option being presented to the user.
+ *
+ * Helps clients choose appropriate icons and UI treatment.
+ */
+export type PermissionOptionKind = "allow_once" | "allow_always" | "reject_once" | "reject_always";
+/**
+ * An execution plan for accomplishing complex tasks.
+ *
+ * Plans consist of multiple entries representing individual tasks or goals.
+ * Agents report plans to clients to provide visibility into their execution strategy.
+ * Plans can evolve during execution as the agent discovers new requirements or completes tasks.
+ *
+ * See protocol docs: [Agent Plan](https://agentclientprotocol.com/protocol/agent-plan)
+ */
+export type Plan = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * 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.
+     */
+    entries: Array<PlanEntry>;
+};
+/**
+ * A single entry in the execution plan.
+ *
+ * Represents a task or goal that the assistant intends to accomplish
+ * as part of fulfilling the user's request.
+ * See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)
+ */
+export type PlanEntry = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Human-readable description of what this task aims to accomplish.
+     */
+    content: string;
+    /**
+     * The relative importance of this task.
+     * Used to indicate which tasks are most critical to the overall goal.
+     */
+    priority: PlanEntryPriority;
+    /**
+     * Current execution status of this task.
+     */
+    status: PlanEntryStatus;
+};
+/**
+ * Priority levels for plan entries.
+ *
+ * Used to indicate the relative importance or urgency of different
+ * tasks in the execution plan.
+ * See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)
+ */
+export type PlanEntryPriority = "high" | "medium" | "low";
+/**
+ * Status of a plan entry in the execution flow.
+ *
+ * Tracks the lifecycle of each task from planning through completion.
+ * See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)
+ */
+export type PlanEntryStatus = "pending" | "in_progress" | "completed";
+/**
+ * A zero-based position in a text document.
+ *
+ * The meaning of `character` depends on the negotiated position encoding.
+ */
+export type Position = {
+    /**
+     * Zero-based character offset (encoding-dependent).
+     */
+    character: number;
+    /**
+     * Zero-based line number.
+     */
+    line: number;
+};
+/**
+ * The encoding used for character offsets in positions.
+ *
+ * Follows the same conventions as LSP 3.17. The default is UTF-16.
+ */
+export type PositionEncodingKind = "utf-16" | "utf-32" | "utf-8";
+/**
+ * Prompt capabilities supported by the agent in `session/prompt` requests.
+ *
+ * Baseline agent functionality requires support for [`ContentBlock::Text`]
+ * and [`ContentBlock::ResourceLink`] in prompt requests.
+ *
+ * Other variants must be explicitly opted in to.
+ * Capabilities for different types of content in prompt requests.
+ *
+ * Indicates which content types beyond the baseline (text and resource links)
+ * the agent can process.
+ *
+ * See protocol docs: [Prompt Capabilities](https://agentclientprotocol.com/protocol/initialization#prompt-capabilities)
+ */
+export type PromptCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Agent supports [`ContentBlock::Audio`].
+     */
+    audio?: boolean;
+    /**
+     * Agent supports embedded context in `session/prompt` requests.
+     *
+     * When enabled, the Client is allowed to include [`ContentBlock::Resource`]
+     * in prompt requests for pieces of context that are referenced in the message.
+     */
+    embeddedContext?: boolean;
+    /**
+     * Agent supports [`ContentBlock::Image`].
+     */
+    image?: boolean;
+};
+/**
+ * Request parameters for sending a user prompt to the agent.
+ *
+ * Contains the user's message and any additional context.
+ *
+ * See protocol docs: [User Message](https://agentclientprotocol.com/protocol/prompt-turn#1-user-message)
+ */
+export type PromptRequest = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
      *
      * A client-generated unique identifier for this user message.
      *
@@ -2296,15 +3429,109 @@ export type PromptResponse = {
      *
      * @experimental
      */
-    userMessageId?: string | null;
+    userMessageId?: string | null;
+};
+/**
+ * Protocol version identifier.
+ *
+ * This version is only bumped for breaking changes.
+ * Non-breaking changes should be introduced via capabilities.
+ */
+export type ProtocolVersion = number;
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Current effective non-secret routing configuration for a provider.
+ *
+ * @experimental
+ */
+export type ProviderCurrentConfig = {
+    /**
+     * Protocol currently used by this provider.
+     */
+    apiType: LlmProtocol;
+    /**
+     * Base URL currently used by this provider.
+     */
+    baseUrl: string;
+};
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Information about a configurable LLM provider.
+ *
+ * @experimental
+ */
+export type ProviderInfo = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Current effective non-secret routing config.
+     * Null or omitted means provider is disabled.
+     */
+    current?: ProviderCurrentConfig | null;
+    /**
+     * Provider identifier, for example "main" or "openai".
+     */
+    id: string;
+    /**
+     * Whether this provider is mandatory and cannot be disabled via `providers/disable`.
+     * If true, clients must not call `providers/disable` for this id.
+     */
+    required: boolean;
+    /**
+     * Supported protocol types for this provider.
+     */
+    supported: Array<LlmProtocol>;
+};
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Provider configuration capabilities supported by the agent.
+ *
+ * By supplying `{}` it means that the agent supports provider configuration methods.
+ *
+ * @experimental
+ */
+export type ProvidersCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
+ * A range in a text document, expressed as start and end positions.
+ */
+export type Range = {
+    /**
+     * The end position (exclusive).
+     */
+    end: Position;
+    /**
+     * The start position (inclusive).
+     */
+    start: Position;
 };
-/**
- * Protocol version identifier.
- *
- * This version is only bumped for breaking changes.
- * Non-breaking changes should be introduced via capabilities.
- */
-export type ProtocolVersion = number;
 /**
  * Request to read content from a text file.
  *
@@ -2354,6 +3581,33 @@ export type ReadTextFileResponse = {
     } | null;
     content: string;
 };
+/**
+ * Notification sent when a suggestion is rejected.
+ */
+export type RejectNesNotification = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The ID of the rejected suggestion.
+     */
+    id: string;
+    /**
+     * The reason for rejection.
+     */
+    reason?: NesRejectReason | null;
+    /**
+     * The session ID for this notification.
+     */
+    sessionId: SessionId;
+};
 /**
  * Request to release a terminal and free its resources.
  */
@@ -2485,18 +3739,12 @@ export type ResourceLink = {
     uri: string;
 };
 /**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
  * Request parameters for resuming an existing session.
  *
  * Resumes an existing session without returning previous messages (unlike `session/load`).
  * This is useful for agents that can resume sessions but don't implement full session loading.
  *
- * Only available if the Agent supports the `session.resume` capability.
- *
- * @experimental
+ * Only available if the Agent supports the `sessionCapabilities.resume` capability.
  */
 export type ResumeSessionRequest = {
     /**
@@ -2509,6 +3757,20 @@ export type ResumeSessionRequest = {
     _meta?: {
         [key: string]: unknown;
     } | null;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * Additional workspace roots to activate for this session. Each path must be absolute.
+     *
+     * When omitted or empty, no additional roots are activated. When non-empty,
+     * this is the complete resulting additional-root list for the resumed
+     * session.
+     *
+     * @experimental
+     */
+    additionalDirectories?: Array<string>;
     /**
      * The working directory for this session.
      */
@@ -2523,13 +3785,7 @@ export type ResumeSessionRequest = {
     sessionId: SessionId;
 };
 /**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
  * Response from resuming an existing session.
- *
- * @experimental
  */
 export type ResumeSessionResponse = {
     /**
@@ -2586,6 +3842,30 @@ export type SelectedPermissionOutcome = {
      */
     optionId: PermissionOptionId;
 };
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Capabilities for additional session directories support.
+ *
+ * By supplying `{}` it means that the agent supports the `additionalDirectories` field on
+ * supported session lifecycle requests and `session/list`.
+ *
+ * @experimental
+ */
+export type SessionAdditionalDirectoriesCapabilities = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
 /**
  * Session capabilities supported by the agent.
  *
@@ -2613,10 +3893,14 @@ export type SessionCapabilities = {
      *
      * This capability is not part of the spec yet, and may be removed or changed at any point.
      *
-     * Whether the agent supports `session/close`.
+     * Whether the agent supports `additionalDirectories` on supported session lifecycle requests and `session/list`.
      *
      * @experimental
      */
+    additionalDirectories?: SessionAdditionalDirectoriesCapabilities | null;
+    /**
+     * Whether the agent supports `session/close`.
+     */
     close?: SessionCloseCapabilities | null;
     /**
      * **UNSTABLE**
@@ -2633,26 +3917,14 @@ export type SessionCapabilities = {
      */
     list?: SessionListCapabilities | null;
     /**
-     * **UNSTABLE**
-     *
-     * This capability is not part of the spec yet, and may be removed or changed at any point.
-     *
      * Whether the agent supports `session/resume`.
-     *
-     * @experimental
      */
     resume?: SessionResumeCapabilities | null;
 };
 /**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
  * Capabilities for the `session/close` method.
  *
  * By supplying `{}` it means that the agent supports closing of sessions.
- *
- * @experimental
  */
 export type SessionCloseCapabilities = {
     /**
@@ -2689,6 +3961,9 @@ export type SessionConfigGroupId = string;
  * Unique identifier for a session configuration option.
  */
 export type SessionConfigId = string;
+/**
+ * A session configuration option selector and its current state.
+ */
 export type SessionConfigOption = ((SessionConfigSelect & {
     type: "select";
 }) | (SessionConfigBoolean & {
@@ -2854,6 +4129,18 @@ export type SessionInfo = {
     _meta?: {
         [key: string]: unknown;
     } | null;
+    /**
+     * **UNSTABLE**
+     *
+     * This capability is not part of the spec yet, and may be removed or changed at any point.
+     *
+     * Authoritative ordered additional workspace roots for this session. Each path must be absolute.
+     *
+     * When omitted or empty, there are no additional roots for the session.
+     *
+     * @experimental
+     */
+    additionalDirectories?: Array<string>;
     /**
      * The working directory for this session. Must be an absolute path.
      */
@@ -3018,15 +4305,9 @@ export type SessionNotification = {
     update: SessionUpdate;
 };
 /**
- * **UNSTABLE**
- *
- * This capability is not part of the spec yet, and may be removed or changed at any point.
- *
  * Capabilities for the `session/resume` method.
  *
  * By supplying `{}` it means that the agent supports resuming of sessions.
- *
- * @experimental
  */
 export type SessionResumeCapabilities = {
     /**
@@ -3070,6 +4351,72 @@ export type SessionUpdate = (ContentChunk & {
 }) | (UsageUpdate & {
     sessionUpdate: "usage_update";
 });
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Request parameters for `providers/set`.
+ *
+ * Replaces the full configuration for one provider id.
+ *
+ * @experimental
+ */
+export type SetProvidersRequest = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Protocol type for this provider.
+     */
+    apiType: LlmProtocol;
+    /**
+     * Base URL for requests sent through this provider.
+     */
+    baseUrl: string;
+    /**
+     * Full headers map for this provider.
+     * May include authorization, routing, or other integration-specific headers.
+     */
+    headers?: {
+        [key: string]: string;
+    };
+    /**
+     * Provider id to configure.
+     */
+    id: string;
+};
+/**
+ * **UNSTABLE**
+ *
+ * This capability is not part of the spec yet, and may be removed or changed at any point.
+ *
+ * Response to `providers/set`.
+ *
+ * @experimental
+ */
+export type SetProvidersResponse = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
+ * Request parameters for setting a session configuration option.
+ */
 export type SetSessionConfigOptionRequest = ({
     type: "boolean";
     /**
@@ -3208,6 +4555,52 @@ export type SetSessionModelResponse = {
         [key: string]: unknown;
     } | null;
 };
+/**
+ * Request to start an NES session.
+ */
+export type StartNesRequest = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Repository metadata, if the workspace is a git repository.
+     */
+    repository?: NesRepository | null;
+    /**
+     * The workspace folders.
+     */
+    workspaceFolders?: Array<WorkspaceFolder> | null;
+    /**
+     * The root URI of the workspace.
+     */
+    workspaceUri?: string | null;
+};
+/**
+ * Response to `nes/start`.
+ */
+export type StartNesResponse = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The session ID for the newly started NES session.
+     */
+    sessionId: SessionId;
+};
 /**
  * Reasons why an agent stops processing a prompt turn.
  *
@@ -3262,6 +4655,68 @@ export type StringPropertySchema = {
      */
     title?: string | null;
 };
+/**
+ * Request for a code suggestion.
+ */
+export type SuggestNesRequest = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Context for the suggestion, included based on agent capabilities.
+     */
+    context?: NesSuggestContext | null;
+    /**
+     * The current cursor position.
+     */
+    position: Position;
+    /**
+     * The current text selection range, if any.
+     */
+    selection?: Range | null;
+    /**
+     * The session ID for this request.
+     */
+    sessionId: SessionId;
+    /**
+     * What triggered this suggestion request.
+     */
+    triggerKind: NesTriggerKind;
+    /**
+     * The URI of the document to suggest for.
+     */
+    uri: string;
+    /**
+     * The version number of the document.
+     */
+    version: number;
+};
+/**
+ * Response to `nes/suggest`.
+ */
+export type SuggestNesResponse = {
+    /**
+     * The _meta property is reserved by ACP to allow clients and agents to attach additional
+     * metadata to their interactions. Implementations MUST NOT make assumptions about values at
+     * these keys.
+     *
+     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+     */
+    _meta?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The list of suggestions.
+     */
+    suggestions: Array<NesSuggestion>;
+};
 /**
  * Embed a terminal created with `terminal/create` by its id.
  *
@@ -3372,6 +4827,26 @@ export type TextContent = {
     annotations?: Annotations | null;
     text: string;
 };
+/**
+ * A content change event for a document.
+ *
+ * When `range` is `None`, `text` is the full content of the document.
+ * When `range` is `Some`, `text` replaces the given range.
+ */
+export type TextDocumentContentChangeEvent = {
+    /**
+     * The range of the document that changed. If `None`, the entire content is replaced.
+     */
+    range?: Range | null;
+    /**
+     * The new text for the range, or the full document content if `range` is `None`.
+     */
+    text: string;
+};
+/**
+ * How the agent wants document changes delivered.
+ */
+export type TextDocumentSyncKind = "full" | "incremental";
 /**
  * Text-based resource contents.
  */
@@ -3715,6 +5190,19 @@ export type WaitForTerminalExitResponse = {
      */
     signal?: string | null;
 };
+/**
+ * A workspace folder.
+ */
+export type WorkspaceFolder = {
+    /**
+     * The display name of the folder.
+     */
+    name: string;
+    /**
+     * The URI of the folder.
+     */
+    uri: string;
+};
 /**
  * Request to write content to a text file.
  *