/**
 * 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**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Authentication-related capabilities supported by the agent.
 *
 * @experimental
 */
export type AgentAuthCapabilities = {
    /**
     * 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 agent supports the logout method.
     *
     * By supplying `{}` it means that the agent supports the logout method.
     */
    logout?: LogoutCapabilities | null;
};
/**
 * Capabilities supported by the agent.
 *
 * Advertised during initialization to inform the client about
 * available features and content types.
 *
 * See protocol docs: [Agent Capabilities](https://agentclientprotocol.com/protocol/initialization#agent-capabilities)
 */
export type AgentCapabilities = {
    /**
     * 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.
     *
     * Authentication-related capabilities supported by the agent.
     *
     * @experimental
     */
    auth?: AgentAuthCapabilities;
    /**
     * Whether the agent supports `session/load`.
     */
    loadSession?: boolean;
    /**
     * 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 | CompleteElicitationNotification | ExtNotification | null;
};
export type AgentRequest = {
    id: RequestId;
    method: string;
    params?: WriteTextFileRequest | ReadTextFileRequest | RequestPermissionRequest | CreateTerminalRequest | TerminalOutputRequest | ReleaseTerminalRequest | WaitForTerminalExitRequest | KillTerminalRequest | CreateElicitationRequest | ExtRequest | null;
};
export type AgentResponse = {
    id: RequestId;
    /**
     * All possible responses that an agent can send to a client.
     *
     * This enum is used internally for routing RPC responses. You typically won't need
     * to use this directly - the responses are handled automatically by the connection.
     *
     * These are responses to the corresponding `ClientRequest` variants.
     */
    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;
};
/**
 * Optional annotations for the client. The client can use annotations to inform how objects are used or displayed
 */
export type Annotations = {
    /**
     * 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;
    audience?: Array<Role> | null;
    lastModified?: string | null;
    priority?: number | null;
};
/**
 * Audio provided to or from an LLM.
 */
export type AudioContent = {
    /**
     * 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;
    annotations?: Annotations | null;
    data: string;
    mimeType: string;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Authentication capabilities supported by the client.
 *
 * Advertised during initialization to inform the agent which authentication
 * method types the client can handle. This governs opt-in types that require
 * additional client-side support.
 *
 * @experimental
 */
export type AuthCapabilities = {
    /**
     * 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 `terminal` authentication methods.
     *
     * When `true`, the agent may include `terminal` entries in its authentication methods.
     */
    terminal?: boolean;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Describes a single environment variable for an [`AuthMethodEnvVar`] authentication method.
 *
 * @experimental
 */
export type AuthEnvVar = {
    /**
     * 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 label for this variable, displayed in client UI.
     */
    label?: string | null;
    /**
     * The environment variable name (e.g. `"OPENAI_API_KEY"`).
     */
    name: string;
    /**
     * Whether this variable is optional.
     *
     * Defaults to `false`.
     */
    optional?: boolean;
    /**
     * Whether this value is a secret (e.g. API key, token).
     * Clients should use a password-style input for secret vars.
     *
     * Defaults to `true`.
     */
    secret?: boolean;
};
/**
 * Describes an available authentication method.
 *
 * The `type` field acts as the discriminator in the serialized JSON form.
 * When no `type` is present, the method is treated as `agent`.
 */
export type AuthMethod = (AuthMethodEnvVar & {
    type: "env_var";
}) | (AuthMethodTerminal & {
    type: "terminal";
}) | AuthMethodAgent;
/**
 * Agent handles authentication itself.
 *
 * This is the default authentication method type.
 */
export type AuthMethodAgent = {
    /**
     * 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;
    /**
     * Optional description providing more details about this authentication method.
     */
    description?: string | null;
    /**
     * Unique identifier for this authentication method.
     */
    id: string;
    /**
     * Human-readable name of the authentication method.
     */
    name: string;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Environment variable authentication method.
 *
 * The user provides credentials that the client passes to the agent as environment variables.
 *
 * @experimental
 */
export type AuthMethodEnvVar = {
    /**
     * 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;
    /**
     * Optional description providing more details about this authentication method.
     */
    description?: string | null;
    /**
     * Unique identifier for this authentication method.
     */
    id: string;
    /**
     * Optional link to a page where the user can obtain their credentials.
     */
    link?: string | null;
    /**
     * Human-readable name of the authentication method.
     */
    name: string;
    /**
     * The environment variables the client should set.
     */
    vars: Array<AuthEnvVar>;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Terminal-based authentication method.
 *
 * The client runs an interactive terminal for the user to authenticate via a TUI.
 *
 * @experimental
 */
export type AuthMethodTerminal = {
    /**
     * 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;
    /**
     * Additional arguments to pass when running the agent binary for terminal auth.
     */
    args?: Array<string>;
    /**
     * Optional description providing more details about this authentication method.
     */
    description?: string | null;
    /**
     * Additional environment variables to set when running the agent binary for terminal auth.
     */
    env?: {
        [key: string]: string;
    };
    /**
     * Unique identifier for this authentication method.
     */
    id: string;
    /**
     * Human-readable name of the authentication method.
     */
    name: string;
};
/**
 * Request parameters for the authenticate method.
 *
 * Specifies which authentication method to use.
 */
export type AuthenticateRequest = {
    /**
     * 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 authentication method to use.
     * Must be one of the methods advertised in the initialize response.
     */
    methodId: string;
};
/**
 * Response to the `authenticate` method.
 */
export type AuthenticateResponse = {
    /**
     * 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;
};
/**
 * Information about a command.
 */
export type AvailableCommand = {
    /**
     * 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 the command does.
     */
    description: string;
    /**
     * Input for the command if required
     */
    input?: AvailableCommandInput | null;
    /**
     * Command name (e.g., `create_plan`, `research_codebase`).
     */
    name: string;
};
/**
 * unstructured
 *
 * All text that was typed after the command name is provided as input.
 */
export type AvailableCommandInput = UnstructuredCommandInput;
/**
 * Available commands are ready or have changed
 */
export type AvailableCommandsUpdate = {
    /**
     * 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;
    /**
     * Commands the agent can execute
     */
    availableCommands: Array<AvailableCommand>;
};
/**
 * Binary resource contents.
 */
export type BlobResourceContents = {
    /**
     * 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;
    blob: string;
    mimeType?: string | null;
    uri: string;
};
/**
 * Schema for boolean properties in an elicitation form.
 */
export type BooleanPropertySchema = {
    /**
     * Default value.
     */
    default?: boolean | null;
    /**
     * Human-readable description.
     */
    description?: string | null;
    /**
     * Optional title for the property.
     */
    title?: string | null;
};
/**
 * Notification to cancel ongoing operations for a session.
 *
 * See protocol docs: [Cancellation](https://agentclientprotocol.com/protocol/prompt-turn#cancellation)
 */
export type CancelNotification = {
    /**
     * 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 session to cancel operations for.
     */
    sessionId: SessionId;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Notification to cancel an ongoing request.
 *
 * See protocol docs: [Cancellation](https://agentclientprotocol.com/protocol/cancellation)
 *
 * @experimental
 */
export type CancelRequestNotification = {
    /**
     * 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 request to cancel.
     */
    requestId: RequestId;
};
/**
 * Capabilities supported by the client.
 *
 * Advertised during initialization to inform the agent about
 * available features and methods.
 *
 * See protocol docs: [Client Capabilities](https://agentclientprotocol.com/protocol/initialization#client-capabilities)
 */
export type ClientCapabilities = {
    /**
     * 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.
     *
     * Authentication capabilities supported by the client.
     * Determines which authentication method types the agent may include
     * in its `InitializeResponse`.
     *
     * @experimental
     */
    auth?: AuthCapabilities;
    /**
     * **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.
     * Determines which elicitation modes the agent may use.
     *
     * @experimental
     */
    elicitation?: ElicitationCapabilities | null;
    /**
     * File system capabilities supported by the client.
     * 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 | DidOpenDocumentNotification | DidChangeDocumentNotification | DidCloseDocumentNotification | DidSaveDocumentNotification | DidFocusDocumentNotification | AcceptNesNotification | RejectNesNotification | ExtNotification | null;
};
export type ClientRequest = {
    id: RequestId;
    method: string;
    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;
    /**
     * All possible responses that a client can send to an agent.
     *
     * This enum is used internally for routing RPC responses. You typically won't need
     * to use this directly - the responses are handled automatically by the connection.
     *
     * These are responses to the corresponding `AgentRequest` variants.
     */
    result: WriteTextFileResponse | ReadTextFileResponse | RequestPermissionResponse | CreateTerminalResponse | TerminalOutputResponse | ReleaseTerminalResponse | WaitForTerminalExitResponse | KillTerminalResponse | CreateElicitationResponse | ExtResponse;
} | {
    error: Error;
    id: RequestId;
};
/**
 * 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 `sessionCapabilities.close` capability.
 */
export type CloseSessionRequest = {
    /**
     * 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 session to close.
     */
    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.
 *
 * Notification sent by the agent when a URL-based elicitation is complete.
 *
 * @experimental
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
    /**
     * The ID of the elicitation that completed.
     */
    elicitationId: ElicitationId;
};
/**
 * Session configuration options have been updated.
 */
export type ConfigOptionUpdate = {
    /**
     * 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 full set of configuration options and their current values.
     */
    configOptions: Array<SessionConfigOption>;
};
/**
 * Standard content block (text, images, resources).
 */
export type Content = {
    /**
     * 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 actual content block.
     */
    content: ContentBlock;
};
/**
 * Content blocks represent displayable information in the Agent Client Protocol.
 *
 * They provide a structured way to handle various types of user-facing content—whether
 * it's text from language models, images for analysis, or embedded resources for context.
 *
 * Content blocks appear in:
 * - User prompts sent via `session/prompt`
 * - Language model output streamed through `session/update` notifications
 * - Progress updates and results from tool calls
 *
 * This structure is compatible with the Model Context Protocol (MCP), enabling
 * agents to seamlessly forward content from MCP tool outputs without transformation.
 *
 * See protocol docs: [Content](https://agentclientprotocol.com/protocol/content)
 */
export type ContentBlock = (TextContent & {
    type: "text";
}) | (ImageContent & {
    type: "image";
}) | (AudioContent & {
    type: "audio";
}) | (ResourceLink & {
    type: "resource_link";
}) | (EmbeddedResource & {
    type: "resource";
});
/**
 * A streamed item of content
 */
export type ContentChunk = {
    /**
     * 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 single item of content
     */
    content: ContentBlock;
    /**
     * **UNSTABLE**
     *
     * This capability is not part of the spec yet, and may be removed or changed at any point.
     *
     * A unique identifier for the message this chunk belongs to.
     *
     * All chunks belonging to the same message share the same `messageId`.
     * A change in `messageId` indicates a new message has started.
     * Both clients and agents MUST use UUID format for message IDs.
     *
     * @experimental
     */
    messageId?: string | null;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Cost information for a session.
 *
 * @experimental
 */
export type Cost = {
    /**
     * Total cumulative cost for session.
     */
    amount: number;
    /**
     * ISO 4217 currency code (e.g., "USD", "EUR").
     */
    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.
 */
export type CreateTerminalRequest = {
    /**
     * 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;
    /**
     * Array of command arguments.
     */
    args?: Array<string>;
    /**
     * The command to execute.
     */
    command: string;
    /**
     * Working directory for the command (absolute path).
     */
    cwd?: string | null;
    /**
     * Environment variables for the command.
     */
    env?: Array<EnvVariable>;
    /**
     * Maximum number of output bytes to retain.
     *
     * When the limit is exceeded, the Client truncates from the beginning of the output
     * to stay within the limit.
     *
     * The Client MUST ensure truncation happens at a character boundary to maintain valid
     * string output, even if this means the retained output is slightly less than the
     * specified limit.
     */
    outputByteLimit?: number | null;
    /**
     * The session ID for this request.
     */
    sessionId: SessionId;
};
/**
 * Response containing the ID of the created terminal.
 */
export type CreateTerminalResponse = {
    /**
     * 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 unique identifier for the created terminal.
     */
    terminalId: string;
};
/**
 * The current mode of the session has changed
 *
 * See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
 */
export type CurrentModeUpdate = {
    /**
     * 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 current mode
     */
    currentModeId: SessionModeId;
};
/**
 * Notification sent when a file is edited.
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
    /**
     * The content changes.
     */
    contentChanges: Array<TextDocumentContentChangeEvent>;
    /**
     * The session ID for this notification.
     */
    sessionId: SessionId;
    /**
     * The URI of the changed document.
     */
    uri: string;
    /**
     * The new version number of the document.
     */
    version: number;
};
/**
 * Notification sent when a file is closed.
 */
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
     * 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 closed document.
     */
    uri: string;
};
/**
 * Notification sent when a file becomes the active editor tab.
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
    /**
     * The current cursor position.
     */
    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.
 *
 * Request parameters for `providers/disable`.
 *
 * @experimental
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _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.
 *
 * Response to `providers/disable`.
 *
 * @experimental
 */
export type DisableProvidersResponse = {
    /**
     * 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.
 *
 * The user accepted the elicitation and provided content.
 *
 * @experimental
 */
export type ElicitationAcceptAction = {
    /**
     * The user-provided content, if any, as an object matching the requested schema.
     */
    content?: {
        [key: string]: ElicitationContentValue;
    } | null;
};
/**
 * **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
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
    /**
     * Whether the client supports form-based elicitation.
     */
    form?: ElicitationFormCapabilities | null;
    /**
     * Whether the client supports URL-based elicitation.
     */
    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.
 *
 * Form-based elicitation capabilities.
 *
 * @experimental
 */
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
     * 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.
 *
 * 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 request this elicitation is tied to.
     */
    requestId: RequestId;
};
/**
 * Type-safe elicitation schema for requesting structured user input.
 *
 * This represents a JSON Schema object with primitive-typed properties,
 * as required by the elicitation specification.
 */
export type ElicitationSchema = {
    /**
     * Optional description of what this schema represents.
     */
    description?: string | null;
    /**
     * Property definitions (must be primitive types).
     */
    properties?: {
        [key: string]: ElicitationPropertySchema;
    };
    /**
     * List of required property names.
     */
    required?: Array<string> | null;
    /**
     * Optional title for the schema.
     */
    title?: string | null;
    /**
     * Type discriminator. Always `"object"`.
     */
    type?: ElicitationSchemaType;
};
/**
 * 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.
 */
export type ElicitationStringType = "string";
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * URL-based elicitation capabilities.
 *
 * @experimental
 */
export type ElicitationUrlCapabilities = {
    /**
     * 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.
 *
 * URL-based elicitation mode where the client directs the user to a URL.
 *
 * @experimental
 */
export type ElicitationUrlMode = (ElicitationSessionScope | ElicitationRequestScope) & {
    /**
     * The unique identifier for this elicitation.
     */
    elicitationId: ElicitationId;
    /**
     * The URL to direct the user to.
     */
    url: string;
};
/**
 * The contents of a resource, embedded into a prompt or tool call result.
 */
export type EmbeddedResource = {
    /**
     * 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;
    annotations?: Annotations | null;
    resource: EmbeddedResourceResource;
};
/**
 * Resource content that can be embedded in a message.
 */
export type EmbeddedResourceResource = TextResourceContents | BlobResourceContents;
/**
 * A titled enum option with a const value and human-readable title.
 */
export type EnumOption = {
    /**
     * The constant value for this option.
     */
    const: string;
    /**
     * Human-readable title for this option.
     */
    title: string;
};
/**
 * An environment variable to set when launching an MCP server.
 */
export type EnvVariable = {
    /**
     * 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 name of the environment variable.
     */
    name: string;
    /**
     * The value to set for the environment variable.
     */
    value: string;
};
/**
 * JSON-RPC error object.
 *
 * Represents an error that occurred during method execution, following the
 * JSON-RPC 2.0 error object specification with optional additional data.
 *
 * See protocol docs: [JSON-RPC Error Object](https://www.jsonrpc.org/specification#error_object)
 */
export type Error = {
    /**
     * A number indicating the error type that occurred.
     * This must be an integer as defined in the JSON-RPC specification.
     */
    code: ErrorCode;
    /**
     * Optional primitive or structured value that contains additional information about the error.
     * This may include debugging information or context-specific details.
     */
    data?: unknown;
    /**
     * A string providing a short description of the error.
     * The message should be limited to a concise single sentence.
     */
    message: string;
};
/**
 * Predefined error codes for common JSON-RPC and ACP-specific errors.
 *
 * These codes follow the JSON-RPC 2.0 specification for standard errors
 * and use the reserved range (-32000 to -32099) for protocol-specific errors.
 */
export type ErrorCode = -32700 | -32600 | -32601 | -32602 | -32603 | -32800 | -32000 | -32002 | -32042 | number;
/**
 * Allows the Agent to send an arbitrary notification that is not part of the ACP spec.
 * Extension notifications provide a way to send one-way messages for custom functionality
 * while maintaining protocol compatibility.
 *
 * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
 */
export type ExtNotification = unknown;
/**
 * Allows for sending an arbitrary request that is not part of the ACP spec.
 * Extension methods provide a way to add custom functionality while maintaining
 * protocol compatibility.
 *
 * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
 */
export type ExtRequest = unknown;
/**
 * Allows for sending an arbitrary response to an [`ExtRequest`] that is not part of the ACP spec.
 * Extension methods provide a way to add custom functionality while maintaining
 * protocol compatibility.
 *
 * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
 */
export type ExtResponse = unknown;
/**
 * File system capabilities that a client may support.
 *
 * See protocol docs: [FileSystem](https://agentclientprotocol.com/protocol/initialization#filesystem)
 */
export type FileSystemCapabilities = {
    /**
     * 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 `fs/read_text_file` requests.
     */
    readTextFile?: boolean;
    /**
     * Whether the Client supports `fs/write_text_file` requests.
     */
    writeTextFile?: boolean;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Request parameters for forking an existing session.
 *
 * Creates a new session based on the context of an existing one, allowing
 * operations like generating summaries without affecting the original session's history.
 *
 * Only available if the Agent supports the `session.fork` capability.
 *
 * @experimental
 */
export type ForkSessionRequest = {
    /**
     * 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 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.
     */
    cwd: string;
    /**
     * List of MCP servers to connect to for this session.
     */
    mcpServers?: Array<McpServer>;
    /**
     * The ID of the session to fork.
     */
    sessionId: SessionId;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Response from forking an existing session.
 *
 * @experimental
 */
export type ForkSessionResponse = {
    /**
     * 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 newly created forked session.
     */
    sessionId: SessionId;
};
/**
 * An HTTP header to set when making requests to the MCP server.
 */
export type HttpHeader = {
    /**
     * 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 name of the HTTP header.
     */
    name: string;
    /**
     * The value to set for the HTTP header.
     */
    value: string;
};
/**
 * An image provided to or from an LLM.
 */
export type ImageContent = {
    /**
     * 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;
    annotations?: Annotations | null;
    data: string;
    mimeType: string;
    uri?: string | null;
};
/**
 * Metadata about the implementation of the client or agent.
 * Describes the name and version of an MCP implementation, with an optional
 * title for UI representation.
 */
export type Implementation = {
    /**
     * 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;
    /**
     * Intended for programmatic or logical use, but can be used as a display
     * name fallback if title isn’t present.
     */
    name: string;
    /**
     * Intended for UI and end-user contexts — optimized to be human-readable
     * and easily understood.
     *
     * If not provided, the name should be used for display.
     */
    title?: string | null;
    /**
     * Version of the implementation. Can be displayed to the user or used
     * for debugging or metrics purposes. (e.g. "1.0.0").
     */
    version: string;
};
/**
 * Request parameters for the initialize method.
 *
 * Sent by the client to establish connection and negotiate capabilities.
 *
 * See protocol docs: [Initialization](https://agentclientprotocol.com/protocol/initialization)
 */
export type InitializeRequest = {
    /**
     * 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;
    /**
     * Capabilities supported by the client.
     */
    clientCapabilities?: ClientCapabilities;
    /**
     * Information about the Client name and version sent to the Agent.
     *
     * Note: in future versions of the protocol, this will be required.
     */
    clientInfo?: Implementation | null;
    /**
     * The latest protocol version supported by the client.
     */
    protocolVersion: ProtocolVersion;
};
/**
 * Response to the `initialize` method.
 *
 * Contains the negotiated protocol version and agent capabilities.
 *
 * See protocol docs: [Initialization](https://agentclientprotocol.com/protocol/initialization)
 */
export type InitializeResponse = {
    /**
     * 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;
    /**
     * Capabilities supported by the agent.
     */
    agentCapabilities?: AgentCapabilities;
    /**
     * Information about the Agent name and version sent to the Client.
     *
     * Note: in future versions of the protocol, this will be required.
     */
    agentInfo?: Implementation | null;
    /**
     * Authentication methods supported by the agent.
     */
    authMethods?: Array<AuthMethod>;
    /**
     * The protocol version the client specified if supported by the agent,
     * or the latest protocol version supported by the agent.
     *
     * The client should disconnect, if it doesn't support this version.
     */
    protocolVersion: ProtocolVersion;
};
/**
 * Schema for integer properties in an elicitation form.
 */
export type IntegerPropertySchema = {
    /**
     * 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;
};
/**
 * Request to kill a terminal without releasing it.
 */
export type KillTerminalRequest = {
    /**
     * 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 request.
     */
    sessionId: SessionId;
    /**
     * The ID of the terminal to kill.
     */
    terminalId: string;
};
/**
 * Response to `terminal/kill` method
 */
export type KillTerminalResponse = {
    /**
     * 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.
 *
 * Request parameters for `providers/list`.
 *
 * @experimental
 */
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
     * 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 to `providers/list`.
 *
 * @experimental
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
    /**
     * Configurable providers with current routing info suitable for UI display.
     */
    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.
 *
 * Only available if the Agent supports the `loadSession` capability.
 *
 * See protocol docs: [Loading Sessions](https://agentclientprotocol.com/protocol/session-setup#loading-sessions)
 */
export type LoadSessionRequest = {
    /**
     * 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 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.
     */
    cwd: string;
    /**
     * List of MCP servers to connect to for this session.
     */
    mcpServers: Array<McpServer>;
    /**
     * The ID of the session to load.
     */
    sessionId: SessionId;
};
/**
 * Response from loading an existing session.
 */
export type LoadSessionResponse = {
    /**
     * 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;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Logout capabilities supported by the agent.
 *
 * By supplying `{}` it means that the agent supports the logout method.
 *
 * @experimental
 */
export type LogoutCapabilities = {
    /**
     * 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.
 *
 * Request parameters for the logout method.
 *
 * Terminates the current authenticated session.
 *
 * @experimental
 */
export type LogoutRequest = {
    /**
     * 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 to the `logout` method.
 *
 * @experimental
 */
export type LogoutResponse = {
    /**
     * 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;
};
/**
 * MCP capabilities supported by the agent
 */
export type McpCapabilities = {
    /**
     * 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 [`McpServer::Http`].
     */
    http?: boolean;
    /**
     * Agent supports [`McpServer::Sse`].
     */
    sse?: boolean;
};
/**
 * Configuration for connecting to an MCP (Model Context Protocol) server.
 *
 * MCP servers provide tools and context that the agent can use when
 * processing prompts.
 *
 * See protocol docs: [MCP Servers](https://agentclientprotocol.com/protocol/session-setup#mcp-servers)
 */
export type McpServer = (McpServerHttp & {
    type: "http";
}) | (McpServerSse & {
    type: "sse";
}) | McpServerStdio;
/**
 * HTTP transport configuration for MCP.
 */
export type McpServerHttp = {
    /**
     * 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;
    /**
     * HTTP headers to set when making requests to the MCP server.
     */
    headers: Array<HttpHeader>;
    /**
     * Human-readable name identifying this MCP server.
     */
    name: string;
    /**
     * URL to the MCP server.
     */
    url: string;
};
/**
 * SSE transport configuration for MCP.
 */
export type McpServerSse = {
    /**
     * 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;
    /**
     * HTTP headers to set when making requests to the MCP server.
     */
    headers: Array<HttpHeader>;
    /**
     * Human-readable name identifying this MCP server.
     */
    name: string;
    /**
     * URL to the MCP server.
     */
    url: string;
};
/**
 * Stdio transport configuration for MCP.
 */
export type McpServerStdio = {
    /**
     * 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;
    /**
     * Command-line arguments to pass to the MCP server.
     */
    args: Array<string>;
    /**
     * Path to the MCP server executable.
     */
    command: string;
    /**
     * Environment variables to set when launching the MCP server.
     */
    env: Array<EnvVariable>;
    /**
     * Human-readable name identifying this MCP server.
     */
    name: string;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * A unique identifier for a model.
 *
 * @experimental
 */
export type ModelId = string;
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Information about a selectable model.
 *
 * @experimental
 */
export type ModelInfo = {
    /**
     * 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;
    /**
     * Optional description of the model.
     */
    description?: string | null;
    /**
     * Unique identifier for the model.
     */
    modelId: ModelId;
    /**
     * Human-readable name of the model.
     */
    name: string;
};
/**
 * Items for a multi-select (array) property schema.
 */
export type MultiSelectItems = UntitledMultiSelectItems | TitledMultiSelectItems;
/**
 * Schema for multi-select (array) properties in an elicitation form.
 */
export type MultiSelectPropertySchema = {
    /**
     * Default selected values.
     */
    default?: Array<string> | null;
    /**
     * Human-readable description.
     */
    description?: string | null;
    /**
     * The items definition describing allowed values.
     */
    items: MultiSelectItems;
    /**
     * Maximum number of items to select.
     */
    maxItems?: number | null;
    /**
     * Minimum number of items to select.
     */
    minItems?: number | null;
    /**
     * Optional title for the property.
     */
    title?: string | null;
};
/**
 * NES capabilities advertised by the agent during initialization.
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
    /**
     * Context the agent wants attached to each suggestion request.
     */
    context?: NesContextCapabilities | null;
    /**
     * Events the agent wants to receive.
     */
    events?: NesEventCapabilities | null;
};
/**
 * Context capabilities the agent wants attached to each suggestion request.
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
    /**
     * Whether the agent wants diagnostics context.
     */
    diagnostics?: NesDiagnosticsCapabilities | null;
    /**
     * Whether the agent wants edit history context.
     */
    editHistory?: NesEditHistoryCapabilities | null;
    /**
     * Whether the agent wants open files context.
     */
    openFiles?: NesOpenFilesCapabilities | null;
    /**
     * Whether the agent wants recent files context.
     */
    recentFiles?: NesRecentFilesCapabilities | null;
    /**
     * Whether the agent wants related snippets context.
     */
    relatedSnippets?: NesRelatedSnippetsCapabilities | null;
    /**
     * Whether the agent wants user actions context.
     */
    userActions?: NesUserActionsCapabilities | null;
};
/**
 * A diagnostic (error, warning, etc.).
 */
export type NesDiagnostic = {
    /**
     * The diagnostic message.
     */
    message: string;
    /**
     * The range of the diagnostic.
     */
    range: Range;
    /**
     * The severity of the diagnostic.
     */
    severity: NesDiagnosticSeverity;
    /**
     * The URI of the file containing the diagnostic.
     */
    uri: string;
};
/**
 * Severity of a diagnostic.
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
};
/**
 * Capabilities for `document/didChange` events.
 */
export type NesDocumentDidChangeCapabilities = {
    /**
     * 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 sync kind the agent wants: `"full"` or `"incremental"`.
     */
    syncKind: TextDocumentSyncKind;
};
/**
 * Marker for `document/didClose` capability support.
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
};
/**
 * Marker for `document/didFocus` capability support.
 */
export type NesDocumentDidFocusCapabilities = {
    /**
     * 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 `document/didOpen` capability support.
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
};
/**
 * Marker for `document/didSave` capability support.
 */
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;
};
/**
 * Document event capabilities the agent wants to receive.
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
    /**
     * Whether the agent wants `document/didChange` events, and the sync kind.
     */
    didChange?: NesDocumentDidChangeCapabilities | null;
    /**
     * Whether the agent wants `document/didClose` events.
     */
    didClose?: NesDocumentDidCloseCapabilities | null;
    /**
     * Whether the agent wants `document/didFocus` events.
     */
    didFocus?: NesDocumentDidFocusCapabilities | null;
    /**
     * Whether the agent wants `document/didOpen` events.
     */
    didOpen?: NesDocumentDidOpenCapabilities | null;
    /**
     * Whether the agent wants `document/didSave` events.
     */
    didSave?: NesDocumentDidSaveCapabilities | null;
};
/**
 * Capabilities for edit history context.
 */
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
     * these keys.
     *
     * See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
     */
    _meta?: {
        [key: string]: unknown;
    } | null;
    /**
     * 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.
     *
     * If provided, the Agent SHOULD echo this value as `userMessageId` in the
     * [`PromptResponse`] to confirm it was recorded.
     * Both clients and agents MUST use UUID format for message IDs.
     *
     * @experimental
     */
    messageId?: string | null;
    /**
     * The blocks of content that compose the user's message.
     *
     * As a baseline, the Agent MUST support [`ContentBlock::Text`] and [`ContentBlock::ResourceLink`],
     * while other variants are optionally enabled via [`PromptCapabilities`].
     *
     * The Client MUST adapt its interface according to [`PromptCapabilities`].
     *
     * The client MAY include referenced pieces of context as either
     * [`ContentBlock::Resource`] or [`ContentBlock::ResourceLink`].
     *
     * When available, [`ContentBlock::Resource`] is preferred
     * as it avoids extra round-trips and allows the message to include
     * pieces of context from sources the agent may not have access to.
     */
    prompt: Array<ContentBlock>;
    /**
     * The ID of the session to send this user message to
     */
    sessionId: SessionId;
};
/**
 * Response from processing a user prompt.
 *
 * See protocol docs: [Check for Completion](https://agentclientprotocol.com/protocol/prompt-turn#4-check-for-completion)
 */
export type PromptResponse = {
    /**
     * 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;
    /**
     * Indicates why the agent stopped processing the turn.
     */
    stopReason: StopReason;
    /**
     * **UNSTABLE**
     *
     * This capability is not part of the spec yet, and may be removed or changed at any point.
     *
     * Token usage for this turn (optional).
     *
     * @experimental
     */
    usage?: Usage | null;
    /**
     * **UNSTABLE**
     *
     * This capability is not part of the spec yet, and may be removed or changed at any point.
     *
     * The acknowledged user message ID.
     *
     * If the client provided a `messageId` in the [`PromptRequest`], the agent echoes it here
     * to confirm it was recorded. If the client did not provide one, the agent MAY assign one
     * and return it here. Absence of this field indicates the agent did not record a message ID.
     *
     * @experimental
     */
    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;
};
/**
 * Request to read content from a text file.
 *
 * Only available if the client supports the `fs.readTextFile` capability.
 */
export type ReadTextFileRequest = {
    /**
     * 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 lines to read.
     */
    limit?: number | null;
    /**
     * Line number to start reading from (1-based).
     */
    line?: number | null;
    /**
     * Absolute path to the file to read.
     */
    path: string;
    /**
     * The session ID for this request.
     */
    sessionId: SessionId;
};
/**
 * Response containing the contents of a text file.
 */
export type ReadTextFileResponse = {
    /**
     * 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;
    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.
 */
export type ReleaseTerminalRequest = {
    /**
     * 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 request.
     */
    sessionId: SessionId;
    /**
     * The ID of the terminal to release.
     */
    terminalId: string;
};
/**
 * Response to terminal/release method
 */
export type ReleaseTerminalResponse = {
    /**
     * 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;
};
/**
 * JSON RPC Request Id
 *
 * An identifier established by the Client that MUST contain a String, Number, or NULL value if included. If it is not included it is assumed to be a notification. The value SHOULD normally not be Null [1] and Numbers SHOULD NOT contain fractional parts [2]
 *
 * The Server MUST reply with the same value in the Response object if included. This member is used to correlate the context between the two objects.
 *
 * [1] The use of Null as a value for the id member in a Request object is discouraged, because this specification uses a value of Null for Responses with an unknown id. Also, because JSON-RPC 1.0 uses an id value of Null for Notifications this could cause confusion in handling.
 *
 * [2] Fractional parts may be problematic, since many decimal fractions cannot be represented exactly as binary fractions.
 */
export type RequestId = null | number | string;
/**
 * The outcome of a permission request.
 */
export type RequestPermissionOutcome = {
    outcome: "cancelled";
} | (SelectedPermissionOutcome & {
    outcome: "selected";
});
/**
 * Request for user permission to execute a tool call.
 *
 * Sent when the agent needs authorization before performing a sensitive operation.
 *
 * See protocol docs: [Requesting Permission](https://agentclientprotocol.com/protocol/tool-calls#requesting-permission)
 */
export type RequestPermissionRequest = {
    /**
     * 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;
    /**
     * Available permission options for the user to choose from.
     */
    options: Array<PermissionOption>;
    /**
     * The session ID for this request.
     */
    sessionId: SessionId;
    /**
     * Details about the tool call requiring permission.
     */
    toolCall: ToolCallUpdate;
};
/**
 * Response to a permission request.
 */
export type RequestPermissionResponse = {
    /**
     * 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 user's decision on the permission request.
     */
    outcome: RequestPermissionOutcome;
};
/**
 * A resource that the server is capable of reading, included in a prompt or tool call result.
 */
export type ResourceLink = {
    /**
     * 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;
    annotations?: Annotations | null;
    description?: string | null;
    mimeType?: string | null;
    name: string;
    size?: number | null;
    title?: string | null;
    uri: string;
};
/**
 * 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 `sessionCapabilities.resume` capability.
 */
export type ResumeSessionRequest = {
    /**
     * 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 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.
     */
    cwd: string;
    /**
     * List of MCP servers to connect to for this session.
     */
    mcpServers?: Array<McpServer>;
    /**
     * The ID of the session to resume.
     */
    sessionId: SessionId;
};
/**
 * Response from resuming an existing session.
 */
export type ResumeSessionResponse = {
    /**
     * 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;
};
/**
 * The sender or recipient of messages and data in a conversation.
 */
export type Role = "assistant" | "user";
/**
 * The user selected one of the provided options.
 */
export type SelectedPermissionOutcome = {
    /**
     * 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 option the user selected.
     */
    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.
 *
 * As a baseline, all Agents **MUST** support `session/new`, `session/prompt`, `session/cancel`, and `session/update`.
 *
 * Optionally, they **MAY** support other session methods and notifications by specifying additional capabilities.
 *
 * Note: `session/load` is still handled by the top-level `load_session` capability. This will be unified in future versions of the protocol.
 *
 * See protocol docs: [Session Capabilities](https://agentclientprotocol.com/protocol/initialization#session-capabilities)
 */
export type SessionCapabilities = {
    /**
     * 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.
     *
     * 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**
     *
     * This capability is not part of the spec yet, and may be removed or changed at any point.
     *
     * Whether the agent supports `session/fork`.
     *
     * @experimental
     */
    fork?: SessionForkCapabilities | null;
    /**
     * Whether the agent supports `session/list`.
     */
    list?: SessionListCapabilities | null;
    /**
     * Whether the agent supports `session/resume`.
     */
    resume?: SessionResumeCapabilities | null;
};
/**
 * Capabilities for the `session/close` method.
 *
 * By supplying `{}` it means that the agent supports closing of sessions.
 */
export type SessionCloseCapabilities = {
    /**
     * 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 boolean on/off toggle session configuration option payload.
 *
 * @experimental
 */
export type SessionConfigBoolean = {
    /**
     * The current value of the boolean option.
     */
    currentValue: boolean;
};
/**
 * Unique identifier for a session configuration option value group.
 */
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 & {
    type: "boolean";
})) & {
    /**
     * 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;
    /**
     * Optional semantic category for this option (UX only).
     */
    category?: SessionConfigOptionCategory | null;
    /**
     * Optional description for the Client to display to the user.
     */
    description?: string | null;
    /**
     * Unique identifier for the configuration option.
     */
    id: SessionConfigId;
    /**
     * Human-readable label for the option.
     */
    name: string;
};
/**
 * Semantic category for a session configuration option.
 *
 * This is intended to help Clients distinguish broadly common selectors (e.g. model selector vs
 * session mode selector vs thought/reasoning level) for UX purposes (keyboard shortcuts, icons,
 * placement). It MUST NOT be required for correctness. Clients MUST handle missing or unknown
 * categories gracefully.
 *
 * Category names beginning with `_` are free for custom use, like other ACP extension methods.
 * Category names that do not begin with `_` are reserved for the ACP spec.
 */
export type SessionConfigOptionCategory = "mode" | "model" | "thought_level" | string;
/**
 * A single-value selector (dropdown) session configuration option payload.
 */
export type SessionConfigSelect = {
    /**
     * The currently selected value.
     */
    currentValue: SessionConfigValueId;
    /**
     * The set of selectable options.
     */
    options: SessionConfigSelectOptions;
};
/**
 * A group of possible values for a session configuration option.
 */
export type SessionConfigSelectGroup = {
    /**
     * 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;
    /**
     * Unique identifier for this group.
     */
    group: SessionConfigGroupId;
    /**
     * Human-readable label for this group.
     */
    name: string;
    /**
     * The set of option values in this group.
     */
    options: Array<SessionConfigSelectOption>;
};
/**
 * A possible value for a session configuration option.
 */
export type SessionConfigSelectOption = {
    /**
     * 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;
    /**
     * Optional description for this option value.
     */
    description?: string | null;
    /**
     * Human-readable label for this option value.
     */
    name: string;
    /**
     * Unique identifier for this option value.
     */
    value: SessionConfigValueId;
};
/**
 * Possible values for a session configuration option.
 */
export type SessionConfigSelectOptions = Array<SessionConfigSelectOption> | Array<SessionConfigSelectGroup>;
/**
 * Unique identifier for a session configuration option value.
 */
export type SessionConfigValueId = string;
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Capabilities for the `session/fork` method.
 *
 * By supplying `{}` it means that the agent supports forking of sessions.
 *
 * @experimental
 */
export type SessionForkCapabilities = {
    /**
     * 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 unique identifier for a conversation session between a client and agent.
 *
 * Sessions maintain their own context, conversation history, and state,
 * allowing multiple independent interactions with the same agent.
 *
 * See protocol docs: [Session ID](https://agentclientprotocol.com/protocol/session-setup#session-id)
 */
export type SessionId = string;
/**
 * Information about a session returned by session/list
 */
export type SessionInfo = {
    /**
     * 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.
     *
     * 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.
     */
    cwd: string;
    /**
     * Unique identifier for the session
     */
    sessionId: SessionId;
    /**
     * Human-readable title for the session
     */
    title?: string | null;
    /**
     * ISO 8601 timestamp of last activity
     */
    updatedAt?: string | null;
};
/**
 * Update to session metadata. All fields are optional to support partial updates.
 *
 * Agents send this notification to update session information like title or custom metadata.
 * This allows clients to display dynamic session names and track session state changes.
 */
export type SessionInfoUpdate = {
    /**
     * 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 title for the session. Set to null to clear.
     */
    title?: string | null;
    /**
     * ISO 8601 timestamp of last activity. Set to null to clear.
     */
    updatedAt?: string | null;
};
/**
 * Capabilities for the `session/list` method.
 *
 * By supplying `{}` it means that the agent supports listing of sessions.
 */
export type SessionListCapabilities = {
    /**
     * 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 mode the agent can operate in.
 *
 * See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
 */
export type SessionMode = {
    /**
     * 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;
    description?: string | null;
    id: SessionModeId;
    name: string;
};
/**
 * Unique identifier for a Session Mode.
 */
export type SessionModeId = string;
/**
 * The set of modes and the one currently active.
 */
export type SessionModeState = {
    /**
     * 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 set of modes that the Agent can operate in
     */
    availableModes: Array<SessionMode>;
    /**
     * The current mode the Agent is in.
     */
    currentModeId: SessionModeId;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * The set of models and the one currently active.
 *
 * @experimental
 */
export type SessionModelState = {
    /**
     * 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 set of models that the Agent can use
     */
    availableModels: Array<ModelInfo>;
    /**
     * The current model the Agent is in.
     */
    currentModelId: ModelId;
};
/**
 * Notification containing a session update from the agent.
 *
 * Used to stream real-time progress and results during prompt processing.
 *
 * See protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/prompt-turn#3-agent-reports-output)
 */
export type SessionNotification = {
    /**
     * 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 session this update pertains to.
     */
    sessionId: SessionId;
    /**
     * The actual update content.
     */
    update: SessionUpdate;
};
/**
 * Capabilities for the `session/resume` method.
 *
 * By supplying `{}` it means that the agent supports resuming of sessions.
 */
export type SessionResumeCapabilities = {
    /**
     * 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;
};
/**
 * Different types of updates that can be sent during session processing.
 *
 * These updates provide real-time feedback about the agent's progress.
 *
 * See protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/prompt-turn#3-agent-reports-output)
 */
export type SessionUpdate = (ContentChunk & {
    sessionUpdate: "user_message_chunk";
}) | (ContentChunk & {
    sessionUpdate: "agent_message_chunk";
}) | (ContentChunk & {
    sessionUpdate: "agent_thought_chunk";
}) | (ToolCall & {
    sessionUpdate: "tool_call";
}) | (ToolCallUpdate & {
    sessionUpdate: "tool_call_update";
}) | (Plan & {
    sessionUpdate: "plan";
}) | (AvailableCommandsUpdate & {
    sessionUpdate: "available_commands_update";
}) | (CurrentModeUpdate & {
    sessionUpdate: "current_mode_update";
}) | (ConfigOptionUpdate & {
    sessionUpdate: "config_option_update";
}) | (SessionInfoUpdate & {
    sessionUpdate: "session_info_update";
}) | (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";
    /**
     * The boolean value.
     */
    value: boolean;
} | {
    /**
     * The value ID.
     */
    value: SessionConfigValueId;
}) & {
    /**
     * 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 configuration option to set.
     */
    configId: SessionConfigId;
    /**
     * The ID of the session to set the configuration option for.
     */
    sessionId: SessionId;
};
/**
 * Response to `session/set_config_option` method.
 */
export type SetSessionConfigOptionResponse = {
    /**
     * 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 full set of configuration options and their current values.
     */
    configOptions: Array<SessionConfigOption>;
};
/**
 * Request parameters for setting a session mode.
 */
export type SetSessionModeRequest = {
    /**
     * 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 mode to set.
     */
    modeId: SessionModeId;
    /**
     * The ID of the session to set the mode for.
     */
    sessionId: SessionId;
};
/**
 * Response to `session/set_mode` method.
 */
export type SetSessionModeResponse = {
    /**
     * 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.
 *
 * Request parameters for setting a session model.
 *
 * @experimental
 */
export type SetSessionModelRequest = {
    /**
     * 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 model to set.
     */
    modelId: ModelId;
    /**
     * The ID of the session to set the model for.
     */
    sessionId: SessionId;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Response to `session/set_model` method.
 *
 * @experimental
 */
export type SetSessionModelResponse = {
    /**
     * 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 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.
 *
 * See protocol docs: [Stop Reasons](https://agentclientprotocol.com/protocol/prompt-turn#stop-reasons)
 */
export type StopReason = "end_turn" | "max_tokens" | "max_turn_requests" | "refusal" | "cancelled";
/**
 * String format types for string properties in elicitation schemas.
 */
export type StringFormat = "email" | "uri" | "date" | "date-time";
/**
 * Schema for string properties in an elicitation form.
 *
 * When `enum` or `oneOf` is set, this represents a single-select enum
 * with `"type": "string"`.
 */
export type StringPropertySchema = {
    /**
     * Default value.
     */
    default?: string | null;
    /**
     * Human-readable description.
     */
    description?: string | null;
    /**
     * Enum values for untitled single-select enums.
     */
    enum?: Array<string> | null;
    /**
     * String format.
     */
    format?: StringFormat | null;
    /**
     * Maximum string length.
     */
    maxLength?: number | null;
    /**
     * Minimum string length.
     */
    minLength?: number | null;
    /**
     * Titled enum options for titled single-select enums.
     */
    oneOf?: Array<EnumOption> | null;
    /**
     * Pattern the string must match.
     */
    pattern?: string | null;
    /**
     * Optional title for the property.
     */
    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.
 *
 * The terminal must be added before calling `terminal/release`.
 *
 * See protocol docs: [Terminal](https://agentclientprotocol.com/protocol/terminals)
 */
export type Terminal = {
    /**
     * 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;
    terminalId: string;
};
/**
 * Exit status of a terminal command.
 */
export type TerminalExitStatus = {
    /**
     * 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 process exit code (may be null if terminated by signal).
     */
    exitCode?: number | null;
    /**
     * The signal that terminated the process (may be null if exited normally).
     */
    signal?: string | null;
};
/**
 * Request to get the current output and status of a terminal.
 */
export type TerminalOutputRequest = {
    /**
     * 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 request.
     */
    sessionId: SessionId;
    /**
     * The ID of the terminal to get output from.
     */
    terminalId: string;
};
/**
 * Response containing the terminal output and exit status.
 */
export type TerminalOutputResponse = {
    /**
     * 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;
    /**
     * Exit status if the command has completed.
     */
    exitStatus?: TerminalExitStatus | null;
    /**
     * The terminal output captured so far.
     */
    output: string;
    /**
     * Whether the output was truncated due to byte limits.
     */
    truncated: boolean;
};
/**
 * Text provided to or from an LLM.
 */
export type TextContent = {
    /**
     * 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;
    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.
 */
export type TextResourceContents = {
    /**
     * 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;
    mimeType?: string | null;
    text: string;
    uri: string;
};
/**
 * Items definition for titled multi-select enum properties.
 */
export type TitledMultiSelectItems = {
    /**
     * Titled enum options.
     */
    anyOf: Array<EnumOption>;
};
/**
 * Represents a tool call that the language model has requested.
 *
 * Tool calls are actions that the agent executes on behalf of the language model,
 * such as reading files, executing code, or fetching data from external sources.
 *
 * See protocol docs: [Tool Calls](https://agentclientprotocol.com/protocol/tool-calls)
 */
export type ToolCall = {
    /**
     * 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;
    /**
     * Content produced by the tool call.
     */
    content?: Array<ToolCallContent>;
    /**
     * The category of tool being invoked.
     * Helps clients choose appropriate icons and UI treatment.
     */
    kind?: ToolKind;
    /**
     * File locations affected by this tool call.
     * Enables "follow-along" features in clients.
     */
    locations?: Array<ToolCallLocation>;
    /**
     * Raw input parameters sent to the tool.
     */
    rawInput?: unknown;
    /**
     * Raw output returned by the tool.
     */
    rawOutput?: unknown;
    /**
     * Current execution status of the tool call.
     */
    status?: ToolCallStatus;
    /**
     * Human-readable title describing what the tool is doing.
     */
    title: string;
    /**
     * Unique identifier for this tool call within the session.
     */
    toolCallId: ToolCallId;
};
/**
 * Content produced by a tool call.
 *
 * Tool calls can produce different types of content including
 * standard content blocks (text, images) or file diffs.
 *
 * See protocol docs: [Content](https://agentclientprotocol.com/protocol/tool-calls#content)
 */
export type ToolCallContent = (Content & {
    type: "content";
}) | (Diff & {
    type: "diff";
}) | (Terminal & {
    type: "terminal";
});
/**
 * Unique identifier for a tool call within a session.
 */
export type ToolCallId = string;
/**
 * A file location being accessed or modified by a tool.
 *
 * Enables clients to implement "follow-along" features that track
 * which files the agent is working with in real-time.
 *
 * See protocol docs: [Following the Agent](https://agentclientprotocol.com/protocol/tool-calls#following-the-agent)
 */
export type ToolCallLocation = {
    /**
     * 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;
    /**
     * Optional line number within the file.
     */
    line?: number | null;
    /**
     * The file path being accessed or modified.
     */
    path: string;
};
/**
 * Execution status of a tool call.
 *
 * Tool calls progress through different statuses during their lifecycle.
 *
 * See protocol docs: [Status](https://agentclientprotocol.com/protocol/tool-calls#status)
 */
export type ToolCallStatus = "pending" | "in_progress" | "completed" | "failed";
/**
 * An update to an existing tool call.
 *
 * Used to report progress and results as tools execute. All fields except
 * the tool call ID are optional - only changed fields need to be included.
 *
 * See protocol docs: [Updating](https://agentclientprotocol.com/protocol/tool-calls#updating)
 */
export type ToolCallUpdate = {
    /**
     * 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;
    /**
     * Replace the content collection.
     */
    content?: Array<ToolCallContent> | null;
    /**
     * Update the tool kind.
     */
    kind?: ToolKind | null;
    /**
     * Replace the locations collection.
     */
    locations?: Array<ToolCallLocation> | null;
    /**
     * Update the raw input.
     */
    rawInput?: unknown;
    /**
     * Update the raw output.
     */
    rawOutput?: unknown;
    /**
     * Update the execution status.
     */
    status?: ToolCallStatus | null;
    /**
     * Update the human-readable title.
     */
    title?: string | null;
    /**
     * The ID of the tool call being updated.
     */
    toolCallId: ToolCallId;
};
/**
 * Categories of tools that can be invoked.
 *
 * Tool kinds help clients choose appropriate icons and optimize how they
 * display tool execution progress.
 *
 * See protocol docs: [Creating](https://agentclientprotocol.com/protocol/tool-calls#creating)
 */
export type ToolKind = "read" | "edit" | "delete" | "move" | "search" | "execute" | "think" | "fetch" | "switch_mode" | "other";
/**
 * All text that was typed after the command name is provided as input.
 */
export type UnstructuredCommandInput = {
    /**
     * 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 hint to display when the input hasn't been provided yet
     */
    hint: string;
};
/**
 * Items definition for untitled multi-select enum properties.
 */
export type UntitledMultiSelectItems = {
    /**
     * Allowed enum values.
     */
    enum: Array<string>;
    /**
     * Item type discriminator. Must be `"string"`.
     */
    type: ElicitationStringType;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Token usage information for a prompt turn.
 *
 * @experimental
 */
export type Usage = {
    /**
     * Total cache read tokens.
     */
    cachedReadTokens?: number | null;
    /**
     * Total cache write tokens.
     */
    cachedWriteTokens?: number | null;
    /**
     * Total input tokens across all turns.
     */
    inputTokens: number;
    /**
     * Total output tokens across all turns.
     */
    outputTokens: number;
    /**
     * Total thought/reasoning tokens
     */
    thoughtTokens?: number | null;
    /**
     * Sum of all token types across session.
     */
    totalTokens: number;
};
/**
 * **UNSTABLE**
 *
 * This capability is not part of the spec yet, and may be removed or changed at any point.
 *
 * Context window and cost update for a session.
 *
 * @experimental
 */
export type UsageUpdate = {
    /**
     * 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;
    /**
     * Cumulative session cost (optional).
     */
    cost?: Cost | null;
    /**
     * Total context window size in tokens.
     */
    size: number;
    /**
     * Tokens currently in context.
     */
    used: number;
};
/**
 * Request to wait for a terminal command to exit.
 */
export type WaitForTerminalExitRequest = {
    /**
     * 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 request.
     */
    sessionId: SessionId;
    /**
     * The ID of the terminal to wait for.
     */
    terminalId: string;
};
/**
 * Response containing the exit status of a terminal command.
 */
export type WaitForTerminalExitResponse = {
    /**
     * 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 process exit code (may be null if terminated by signal).
     */
    exitCode?: number | null;
    /**
     * The signal that terminated the process (may be null if exited normally).
     */
    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.
 *
 * Only available if the client supports the `fs.writeTextFile` capability.
 */
export type WriteTextFileRequest = {
    /**
     * 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 text content to write to the file.
     */
    content: string;
    /**
     * Absolute path to the file to write.
     */
    path: string;
    /**
     * The session ID for this request.
     */
    sessionId: SessionId;
};
/**
 * Response to `fs/write_text_file`
 */
export type WriteTextFileResponse = {
    /**
     * 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;
};