@github/copilot-sdk 1.0.13-preview.4 → 1.0.13

package/dist/generated/rpc.d.ts

@@ -3,7 +3,7 @@
  * Generated from: api.schema.json
  */
 import type { MessageConnection } from "vscode-jsonrpc/node.js";
-import type { AbortReason, Attachment, AutoTier, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, McpServerSource, McpServerStatus, ModelChangeSource, PermissionMode, PermissionPromptRequest, PermissionRule, ReasoningSummary, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskCompleteData, TaskCompletionOutcome, UserToolSessionApproval, Verbosity } from "./session-events.js";
+import type { AbortReason, AgentModelPolicy, Attachment, AutoTier, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, McpServerMetadata, McpServerSource, McpServerStatus, ModelChangeSource, PermissionMode, PermissionPromptRequest, PermissionRule, ReasoningSummary, RemediationAction, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskCompleteData, TaskCompletionOutcome, UserToolSessionApproval, Verbosity } from "./session-events.js";
 /** A value that can be represented losslessly on the SDK JSON wire. */
 export type JsonValue = null | boolean | number | string | JsonValue[] | {
     [key: string]: JsonValue;
@@ -253,6 +253,20 @@ export type AuthInfoType =
  */
 /** @experimental */
 export type AuthValidationErrors = AuthValidationError[];
+/**
+ * Current normalized autopilot objective lifecycle status.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AutopilotObjectiveStatus".
+ */
+/** @experimental */
+export type AutopilotObjectiveStatus = 
+/** The objective is actively running. */
+"active"
+/** The objective is paused and may be resumed. */
+ | "paused"
+/** The objective completed. */
+ | "completed";
 /**
  * Root JSON Schema type for a built-in tool input.
  *
@@ -529,7 +543,13 @@ export type CatalogNetworkFailureReason =
  | "tls"
 /** The connection was refused or reset. */
  | "connection-refused"
-/** The authority returned a status the runtime treats as a failure. */
+/** The configured proxy returned 407 and requires authentication. */
+ | "proxy-authentication-required"
+/** The authority rate-limited requests and supplied or implied a bounded cooldown. */
+ | "rate-limited"
+/** The authority returned a transient 5xx response. */
+ | "service-unavailable"
+/** The authority returned another status the runtime treats as a failure. */
  | "http-status"
 /** The response exceeded the permitted size. */
  | "response-too-large"
@@ -623,6 +643,18 @@ export type CatalogUnavailableTransportReason =
  | "transport-not-supported"
 /** Eligible remotes could not be enumerated, so no explicit choice can be offered. */
  | "remote-enumeration-unavailable";
+/**
+ * Why the runtime requests client-task cancellation.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ClientTaskCancelReason".
+ */
+/** @experimental */
+export type ClientTaskCancelReason = 
+/** A caller requested task cancellation. */
+"cancel_requested"
+/** The session is shutting down. */
+ | "session_shutdown";
 /**
  * Coarse command category for grouping and behavior: runtime built-in, skill-backed command, or SDK/client-owned command
  *
@@ -702,6 +734,20 @@ export type ConnectedRemoteSessionMetadataKind =
 "remote-session"
 /** GitHub Copilot coding agent session. */
  | "coding-agent";
+/**
+ * Closed set of public task kinds a connection can negotiate.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskKind".
+ */
+/** @experimental */
+export type TaskKind = 
+/** Runtime-owned background agent task. */
+"agent"
+/** Runtime-owned shell task. */
+ | "shell"
+/** Client-owned externally executed task. */
+ | "client";
 /**
  * Controls how MCP tool result content is filtered: none leaves content unchanged, markdown sanitizes HTML while preserving Markdown-friendly output, and hidden_characters removes characters that can hide directives.
  *
@@ -824,6 +870,64 @@ export type DiscoveredExtensionMode =
  | "load_only"
 /** Extensions are loaded and the agent can create, reload, and manage them. */
  | "load_and_augment";
+/**
+ * Hook event name. Discovery emits the file-configurable subset; SDK callbacks additionally support callback-only events.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HookType".
+ */
+/** @experimental */
+export type HookType = 
+/** Runs before a tool is invoked. */
+"preToolUse"
+/** Runs before an MCP tool is invoked. */
+ | "preMcpToolCall"
+/** Runs after a tool completes successfully. */
+ | "postToolUse"
+/** Runs after a tool fails. */
+ | "postToolUseFailure"
+/** Runs after the user submits a prompt. */
+ | "userPromptSubmitted"
+/** Runs after the runtime transforms the submitted prompt for the model, before it is added to session history. */
+ | "userPromptTransformed"
+/** Runs when a session starts. */
+ | "sessionStart"
+/** Runs when a session ends. */
+ | "sessionEnd"
+/** Runs after an agent result is produced. */
+ | "postResult"
+/** Runs before a pull request description is generated. */
+ | "prePRDescription"
+/** Runs when the agent encounters an error. */
+ | "errorOccurred"
+/** Runs when the agent stops. */
+ | "agentStop"
+/** Runs when a subagent starts. */
+ | "subagentStart"
+/** Runs when a subagent stops. */
+ | "subagentStop"
+/** Runs before conversation context is compacted. */
+ | "preCompact"
+/** Runs when the agent requests permission. */
+ | "permissionRequest"
+/** Runs when the agent emits a notification. */
+ | "notification";
+/**
+ * Configuration tier that contributed a discovered hook action.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HookOrigin".
+ */
+/** @experimental */
+export type HookOrigin = 
+/** Hook loaded from user settings or the user's hook directory. */
+"user"
+/** Hook loaded from repository settings or the repository hook directory. */
+ | "repository"
+/** Hook provided by an enabled installed or explicit plugin. Projectless rows omit projectPath and do not expand a project directory. */
+ | "plugin"
+/** Hook enforced by centrally managed policy. */
+ | "policy";
 /**
  * Server transport type: stdio, http, sse (deprecated), or memory
  *
@@ -1075,6 +1179,15 @@ export type FactoryRunFailure = {
      * Factory failure variant discriminator.
      */
     type: "factory_accounting_incomplete";
+} | {
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+    /**
+     * Factory failure variant discriminator.
+     */
+    type: "factory_provider_disconnected";
 };
 /**
  * Cumulative resource ceiling that stopped a factory run.
@@ -2205,6 +2318,18 @@ export type ModelListRequest = {
      */
     skipCache?: boolean;
 };
+/**
+ * Whether the requested preference was already effective or was accepted for later transactional activation.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ModelSwitchAutoTierStatus".
+ */
+/** @experimental */
+export type ModelSwitchAutoTierStatus = 
+/** The requested preference is already effective. No activation is pending for it, although this request may have cancelled an earlier unclaimed preference reported in `supersededAutoTier`. */
+"unchanged"
+/** The request was accepted but has not committed. A later user turn using the `auto` model must mint and validate the replacement before it becomes effective. */
+ | "pending";
 /**
  * Provider type. Defaults to "openai" for generic OpenAI-compatible APIs.
  *
@@ -2471,6 +2596,18 @@ export type PermissionsSetApproveAllSource =
  | "user_setting"
 /** Allow-all was enabled through an RPC caller. */
  | "rpc";
+/**
+ * Where completed plugin content was staged before atomic promotion.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PluginInstallStagingMode".
+ */
+/** @experimental */
+export type PluginInstallStagingMode = 
+/** A sibling of the installed-plugins root, outside the recursively watched tree. */
+"external"
+/** A sibling of the destination plugin directory, used when external staging is unavailable. */
+ | "destination_sibling";
 /**
  * Optional flags controlling which side effects the reload performs.
  *
@@ -3267,13 +3404,154 @@ export type TaskExecutionMode =
 /** The task is managed in the background. */
  | "background";
 /**
- * Tracked task union returned by task APIs, containing either an agent task or a shell task.
+ * Active status a client owner may publish with a progress update.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskClientActiveStatus".
+ */
+/** @experimental */
+export type TaskClientActiveStatus = 
+/** The external owner is actively working. */
+"running"
+/** The external owner is connected but waiting. */
+ | "idle";
+/**
+ * Client-owned tasks always execute outside the runtime in background mode.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskClientExecutionMode".
+ */
+/** @experimental */
+export type TaskClientExecutionMode = "background";
+/**
+ * Discriminator for a client-owned task.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskClientType".
+ */
+/** @experimental */
+export type TaskClientType = "client";
+/**
+ * Lifecycle status of a client-owned task.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskClientStatus".
+ */
+/** @experimental */
+export type TaskClientStatus = 
+/** The external owner is actively working. */
+"running"
+/** The external owner is connected but waiting. */
+ | "idle"
+/** The owner reported successful completion. */
+ | "completed"
+/** The owner reported failure. */
+ | "failed"
+/** The owner reported or confirmed cancellation. */
+ | "cancelled"
+/** The bound owner join disappeared; external executor state is unknown. */
+ | "orphaned";
+/**
+ * Connection class owning a client task.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskClientOwnerKind".
+ */
+/** @experimental */
+export type TaskClientOwnerKind = 
+/** A discovered extension connection owns the task. */
+"extension"
+/** A generic SDK connection owns the task. */
+ | "sdk";
+/**
+ * Presence of the task's bound join.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskClientOwnerPresence".
+ */
+/** @experimental */
+export type TaskClientOwnerPresence = 
+/** The bound session join is connected. */
+"connected"
+/** The bound session join is disconnected. */
+ | "disconnected";
+/**
+ * Progress or terminal update for a client-owned task.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskClientUpdate".
+ */
+/** @experimental */
+export type TaskClientUpdate = {
+    status?: TaskClientActiveStatus;
+    /**
+     * Optional progress message appended to recent activity when nonempty
+     */
+    message?: string;
+    /**
+     * Optional progress phase; null clears the current phase
+     */
+    phase?: string | null;
+    /**
+     * Optional completion percentage; null clears the current percentage
+     */
+    percentage?: number | null;
+    /**
+     * Client task update variant discriminator.
+     */
+    kind: "progress";
+} | {
+    /**
+     * Optional final progress message
+     */
+    message?: string;
+    /**
+     * Optional opaque successful terminal result
+     */
+    result?: JsonValue;
+    /**
+     * Client task update variant discriminator.
+     */
+    kind: "completed";
+} | {
+    /**
+     * Optional final progress message
+     */
+    message?: string;
+    /**
+     * Human-readable terminal failure message
+     */
+    error: string;
+    /**
+     * Optional owner-supplied terminal failure code
+     */
+    code?: string;
+    /**
+     * Client task update variant discriminator.
+     */
+    kind: "failed";
+} | {
+    /**
+     * Optional final progress message
+     */
+    message?: string;
+    /**
+     * Optional human-readable cancellation reason
+     */
+    reason?: string;
+    /**
+     * Client task update variant discriminator.
+     */
+    kind: "cancelled";
+};
+/**
+ * Tracked task union returned by task APIs, containing an agent, client, or shell task.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "TaskInfo".
  */
 /** @experimental */
-export type TaskInfo = TaskAgentInfo | TaskShellInfo;
+export type TaskInfo = TaskAgentInfo | TaskClientInfo | TaskShellInfo;
 /**
  * Whether the shell runs inside a managed PTY session or as an independent background process
  *
@@ -3293,7 +3571,7 @@ export type TaskShellInfoAttachmentMode =
  * via the `definition` "TaskProgress".
  */
 /** @experimental */
-export type TaskProgress = (TaskAgentProgress | TaskShellProgress) | null;
+export type TaskProgress = TaskAgentProgress | TaskClientProgress | TaskShellProgress | null;
 /**
  * Canonical result returned by a session tool.
  *
@@ -4272,7 +4550,7 @@ export interface AgentGetCurrentResult {
     agent?: AgentInfo | null;
 }
 /**
- * Agent metadata, including identifiers, display details, source, tools, model, MCP servers, skills, and file path.
+ * Agent metadata, including identifiers, display details, source, tools, model, models, MCP servers, skills, and file path.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AgentInfo".
@@ -4312,6 +4590,11 @@ export interface AgentInfo {
      * Authored preferred model id for this agent. Runtime model selection may choose a different model; omitted means no authored preference.
      */
     model?: string;
+    /**
+     * Authored preferred model ids for this agent, in priority order. Runtime model selection chooses the first available model; omitted means no authored preference.
+     */
+    models?: string[];
+    modelPolicy?: AgentModelPolicy;
     /**
      * MCP server configurations attached to this agent, keyed by server name. Server config shape mirrors the MCP `mcpServers` schema.
      *
@@ -4671,6 +4954,75 @@ export interface AuthValidationError {
      */
     githubMessage?: string;
 }
+/**
+ * Current per-window credit limit and consumption for an autopilot objective.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AutopilotObjectiveCreditLimit".
+ */
+/** @experimental */
+export interface AutopilotObjectiveCreditLimit {
+    /**
+     * Configured AI-credit cap, when one is set.
+     */
+    credits?: number;
+    /**
+     * Window consumption in fractional AI credits, for display.
+     */
+    creditsUsed: number;
+    /**
+     * Exact window consumption in non-negative integer nano-AIU, encoded as a decimal string.
+     */
+    creditsUsedNanoAiu: string;
+}
+/**
+ * Canonical runtime state for the session's current autopilot objective.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AutopilotObjectiveGetStateResult".
+ */
+/** @experimental */
+export interface AutopilotObjectiveGetStateResult {
+    /**
+     * Current objective state, or `null` when the session has no objective.
+     */
+    state: AutopilotObjectiveState | null;
+}
+/**
+ * Public, persistence-independent projection of an autopilot objective.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AutopilotObjectiveState".
+ */
+/** @experimental */
+export interface AutopilotObjectiveState {
+    /**
+     * Session-local objective identifier.
+     */
+    id: number;
+    /**
+     * User-provided objective text.
+     */
+    objective: string;
+    status: AutopilotObjectiveStatus;
+    /**
+     * Number of objective turns started.
+     */
+    turnCount: number;
+    /**
+     * Optional reason the objective is paused.
+     */
+    pauseReason?: string;
+    /**
+     * Optional summary recorded when the objective completed.
+     */
+    completionSummary?: string;
+    /**
+     * Exact lifetime AI-credit consumption in non-negative integer nano-AIU, encoded as a decimal string.
+     */
+    creditCountNanoAiu: string;
+    creditLimit?: AutopilotObjectiveCreditLimit;
+}
 /**
  * The running runtime's complete catalog of well-known built-in model IDs, including supported models and additional IDs with built-in metadata.
  *
@@ -5527,6 +5879,10 @@ export interface CatalogNetworkFailureError {
      * HTTP status code, when the failure was a rejected response.
      */
     statusCode?: number;
+    /**
+     * Bounded cooldown in seconds before another catalog request should be attempted, when the authority supplied a numeric Retry-After value or the runtime applied its documented fallback.
+     */
+    retryAfterSeconds?: number;
     /**
      * Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret.
      */
@@ -5578,7 +5934,7 @@ export interface CatalogPolicyRejectedError {
 export interface CatalogSearchRequest {
     contract: CatalogClientContract;
     /**
-     * Free-text search query. Never written to logs or telemetry.
+     * Free-text search query. Persisted as tool input for session continuity, but omitted from telemetry.
      */
     query: string;
     /**
@@ -5700,6 +6056,45 @@ export interface CatalogUnavailableTransportError {
      */
     message: string;
 }
+/**
+ * Runtime-to-owner cancellation request for a client-owned task.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ClientTaskCancelRequest".
+ */
+/** @experimental */
+export interface ClientTaskCancelRequest {
+    /**
+     * Session that owns the client task
+     */
+    sessionId: string;
+    /**
+     * Canonical runtime-generated task identifier
+     */
+    id: string;
+    /**
+     * Owner-scoped task key included for correlation
+     */
+    clientTaskId: string;
+    /**
+     * Opaque identifier shared by coalesced cancellation callers
+     */
+    cancellationId: string;
+    reason: ClientTaskCancelReason;
+}
+/**
+ * Whether the client authoritatively confirmed its external work stopped.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ClientTaskCancelResult".
+ */
+/** @experimental */
+export interface ClientTaskCancelResult {
+    /**
+     * True only when the owner confirms that external work stopped before responding
+     */
+    cancelled: boolean;
+}
 /**
  * Slash commands available in the session, after applying any include/exclude filters.
  *
@@ -6153,7 +6548,7 @@ export interface ContextHeaviestMessage {
     tokens: number;
 }
 /**
- * The currently selected model, reasoning effort, and context tier for the session. The context tier reflects `Session.getContextTier()`, restored from the session journal on resume.
+ * The session's authoritative model snapshot. Auto preference fields are configuration for the virtual `auto` model and do not change the selected model identifier. The context tier reflects `Session.getContextTier()`, restored from the session journal on resume.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CurrentModel".
@@ -6169,6 +6564,15 @@ export interface CurrentModel {
      */
     reasoningEffort?: string;
     contextTier?: ContextTier;
+    autoTier?: AutoTier;
+    /**
+     * Latest unclaimed Auto preference waiting for a future user turn. Null means the pending request is returning to provider-default routing.
+     */
+    pendingAutoTier?: AutoTier | null;
+    /**
+     * Auto preference currently claimed by an in-progress activation. Null means the activation is returning to provider-default routing.
+     */
+    activatingAutoTier?: AutoTier | null;
 }
 /**
  * Lightweight metadata for a currently initialized session tool
@@ -6425,6 +6829,37 @@ export interface DiscoveredExtensionsEnableRequest {
      */
     ids: string[];
 }
+/**
+ * One server-discovered hook action from user, repository, plugin, or managed-policy configuration.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DiscoveredHook".
+ */
+/** @experimental */
+export interface DiscoveredHook {
+    /**
+     * Deterministic identifier for this server-discovered action row. It remains stable while the project, origin, source, event, action content, and duplicate ordinal are unchanged. This is row identity, not the key persisted in disabledHooks.
+     */
+    id: string;
+    hookType: HookType;
+    origin: HookOrigin;
+    /**
+     * Human-readable source label, such as a hook file path, settings source, or plugin name.
+     */
+    source?: string;
+    /**
+     * Input project path for which this server-side action was resolved. Set on every row returned for project-scoped discovery, including repeated user and policy actions.
+     */
+    projectPath?: string;
+    /**
+     * Whether this action is enabled under the server-side discovery settings. Concrete sessions may differ because they can add session-specific directories, plugins, or trust. False when its disable key is present in the user's disabled-hooks setting or disable-all settings suppress the action.
+     */
+    enabled: boolean;
+    /**
+     * Durable content hash used by hook enablement. Identical actions may intentionally share this key. Omitted when changing the user's disabled-hooks setting cannot change the action's current server-discovered state, including managed-policy hooks, session-start prompt actions, actions suppressed by disable-all settings, and projectless plugin actions that require project-directory expansion.
+     */
+    disableKey?: string;
+}
 /**
  * MCP server discovered by `mcp.discover`, with config source, optional plugin source, transport type, and enabled state.
  *
@@ -7761,6 +8196,10 @@ export interface FactoryRunResult {
      * Factory run identifier.
      */
     runId: string;
+    /**
+     * One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime.
+     */
+    attempt?: number;
     status: FactoryRunStatus;
     /**
      * Completed factory result.
@@ -8482,6 +8921,44 @@ export interface HistoryTruncateResult {
      */
     checkpointCleanupError?: string;
 }
+/**
+ * Optional project paths and host-exclusion behavior for server-scoped hook discovery.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HooksDiscoverRequest".
+ */
+/** @experimental */
+export interface HooksDiscoverRequest {
+    /**
+     * Optional project directory paths whose trusted repository and project-expanded plugin hooks should be discovered. When omitted or empty, user, managed-policy, and globally enabled installed or explicit plugin hooks are returned without project expansion.
+     */
+    projectPaths?: string[];
+    /**
+     * When true, omit host-owned user and plugin hook rows and their diagnostics. Managed-policy hooks and trusted repository hooks remain visible, and host disabledHooks still contribute to each remaining row's effective enabled state. This filters sources rather than simulating a host with no settings.
+     */
+    excludeHostHooks?: boolean;
+}
+/**
+ * Server-discovered hook actions and partial-load diagnostics from user, repository, plugin, and managed-policy sources. Concrete sessions may include additional session-specific hook sources.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HooksDiscoverResult".
+ */
+/** @experimental */
+export interface HooksDiscoverResult {
+    /**
+     * All discovered hook actions. Byte-identical actions remain separate rows even when they share a disable key.
+     */
+    hooks: DiscoveredHook[];
+    /**
+     * Non-fatal source-loading warnings. Discovery remains complete for the affected source, although the source had a recoverable issue. Repository-settings warnings are prefixed with their project path when attribution is available.
+     */
+    warnings: string[];
+    /**
+     * Errors for hook sources or actions that could not be loaded, making the result partially incomplete. Other valid actions are still returned. Project-resolution and repository-settings errors are prefixed with their project path.
+     */
+    errors: string[];
+}
 /**
  * Installed plugin record from global state, with marketplace, version, install time, enabled state, cache path, and source.
  *
@@ -9870,6 +10347,10 @@ export interface McpConfigRemoveRequest {
      * Name of the MCP server to remove
      */
     name: string;
+    /**
+     * OAuth Client ID Metadata Document URL whose persisted credentials should also be removed.
+     */
+    authClientIdMetadataUrl?: string;
 }
 /**
  * MCP server name and replacement configuration to write to user configuration.
@@ -11085,6 +11566,7 @@ export interface McpServer {
      * Error message if the server failed to connect
      */
     error?: string;
+    serverMetadata?: McpServerMetadata;
 }
 /**
  * MCP servers configured for the session, with their connection status and host-level state.
@@ -11458,6 +11940,12 @@ export interface Model {
      */
     name: string;
     capabilities: ModelCapabilities;
+    /**
+     * Provider-supplied model metadata. Keys and JSON-compatible values are preserved unchanged. This is factual metadata published by the model provider; it carries no picker or UX semantics.
+     */
+    metadata?: {
+        [k: string]: JsonValue | undefined;
+    };
     policy?: ModelPolicy;
     billing?: ModelBilling;
     /**
@@ -11704,6 +12192,10 @@ export interface ModelBillingPromo {
      * Human-readable promotion message. Does not include the expiry timestamp; consumers may format endsAt and append it when present.
      */
     message?: string;
+    /**
+     * Whether the service asked hosts to give this promotion a prominent surface, such as a dedicated banner, in addition to listing it with the model. `true` requests that surface and `false` asks for the model list only. Absent means the service expressed no preference — for example a response that predates the field — so hosts should apply their own default rather than read it as `false`.
+     */
+    showBanner?: boolean;
 }
 /**
  * Service-published warning text that hosts should display when presenting a model.
@@ -11751,6 +12243,10 @@ export interface ModelApplyStartupOverlayRequest {
      * Model required by server-managed policy, when configured.
      */
     serverManagedModel?: string;
+    /**
+     * Startup default model from the enterprise policy helper, when configured. Weakest of the managed sources: it applies only when neither device nor server policy names a model, and an explicit user selection still wins.
+     */
+    policyHelperModel?: string;
     /**
      * Model selected by repository settings, when configured.
      */
@@ -11899,33 +12395,70 @@ export interface ModelPickerSettingsContext {
 /** @experimental */
 export interface ModelSetReasoningEffortRequest {
     /**
-     * Reasoning effort level to apply to the currently selected model. The host is responsible for validating the value against the model's supported levels before calling.
+     * Reasoning effort level to apply to the currently selected model. The host is responsible for validating the value against the model's supported levels before calling.
+     */
+    reasoningEffort: string;
+}
+/**
+ * Update the session's reasoning effort without changing the selected model. Use `switchTo` instead when you also need to change the model. The runtime stores the effort on the session and applies it to subsequent turns.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ModelSetReasoningEffortResult".
+ */
+/** @experimental */
+export interface ModelSetReasoningEffortResult {
+    /**
+     * Reasoning effort level recorded on the session after the update
+     */
+    reasoningEffort: string;
+}
+/** @experimental */
+export interface ModelsListRequest {
+    /**
+     * Opaque account identifier returned by `account.getAllUsers`. When omitted, the current account is used.
+     */
+    selectionId?: string;
+    /**
+     * GitHub token accepted for compatibility with existing SDK clients. When provided, resolves this token instead of using the current account.
+     */
+    gitHubToken?: string;
+}
+/**
+ * An Auto preference request for the session. This updates Auto configuration only; it does not change the selected model to `auto`.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ModelSwitchAutoTierRequest".
+ */
+/** @experimental */
+export interface ModelSwitchAutoTierRequest {
+    /**
+     * Auto preference to activate when a future user turn using the `auto` model safely mints a replacement model and token pair. Pass null to return to provider-default Auto routing.
      */
-    reasoningEffort: string;
+    autoTier: AutoTier | null;
+    source?: ModelChangeSource;
 }
 /**
- * Update the session's reasoning effort without changing the selected model. Use `switchTo` instead when you also need to change the model. The runtime stores the effort on the session and applies it to subsequent turns.
+ * Immediate acknowledgement and Auto preference snapshot after a switch request. This result never implies that a pending preference committed.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ModelSetReasoningEffortResult".
+ * via the `definition` "ModelSwitchAutoTierResult".
  */
 /** @experimental */
-export interface ModelSetReasoningEffortResult {
+export interface ModelSwitchAutoTierResult {
+    status: ModelSwitchAutoTierStatus;
+    effectiveAutoTier?: AutoTier;
     /**
-     * Reasoning effort level recorded on the session after the update
+     * Latest unclaimed Auto preference waiting for a future user turn.
      */
-    reasoningEffort: string;
-}
-/** @experimental */
-export interface ModelsListRequest {
+    pendingAutoTier?: AutoTier | null;
     /**
-     * Opaque account identifier returned by `account.getAllUsers`. When omitted, the current account is used.
+     * Auto preference currently claimed by an in-progress activation. Null means the activation is returning to provider-default routing.
      */
-    selectionId?: string;
+    activatingAutoTier?: AutoTier | null;
     /**
-     * GitHub token accepted for compatibility with existing SDK clients. When provided, resolves this token instead of using the current account.
+     * Earlier unclaimed preference replaced by this request. This can be present with either status, including when selecting the effective preference cancels pending work.
      */
-    gitHubToken?: string;
+    supersededAutoTier?: AutoTier | null;
 }
 /** @experimental */
 export interface ModelSwitchConfirmation {
@@ -11954,6 +12487,10 @@ export interface ModelSwitchToRequest {
      * Model selection id to switch to, as returned by `list`. A bare id (e.g. `claude-sonnet-4.6`) names a Copilot (CAPI) model; a provider-qualified id (`provider/id`, e.g. `acme/claude-sonnet`) targets a registry BYOK model.
      */
     modelId: string;
+    /**
+     * Optional Auto routing preference to stage atomically with selecting `auto`. Pass null to return to provider-default Auto routing. This field is rejected when `modelId` is not `auto`.
+     */
+    autoTier?: AutoTier | null;
     /**
      * Reasoning effort level to use for the model. CAPI values are model-defined and validated against the selected model; BYOK providers may define additional values. "none" disables reasoning. When omitted, no effort override is applied.
      */
@@ -12026,6 +12563,7 @@ export interface ModelSwitchToResult {
      * Deprecation warnings associated with the selected model or options.
      */
     deprecationWarnings?: string[];
+    modelState?: CurrentModel;
 }
 /**
  * Agent interaction mode to apply to the session.
@@ -13962,6 +14500,7 @@ export interface PluginInstallResult {
      * Number of skills discovered and installed from the plugin
      */
     skillsInstalled: number;
+    stagingMode?: PluginInstallStagingMode;
     /**
      * Optional post-install message provided by the plugin (e.g. setup instructions)
      */
@@ -15189,6 +15728,10 @@ export interface QueuePendingItems {
      * Stable opaque id for the canonical queued item. Batch rows share one id.
      */
     id: string;
+    /**
+     * Stable identity of the queued user message. Present for message rows and absent for slash commands and model changes.
+     */
+    messageId?: string;
     kind: QueuePendingItemsKind;
     /**
      * Human-readable text to display for this queue entry in the UI
@@ -15746,6 +16289,18 @@ export interface SandboxConfig {
      * Whether to auto-add the current working directory to readwritePaths. Default: true.
      */
     addCurrentWorkingDirectory?: boolean;
+    /**
+     * Whether MCP servers the session launches are confined by the sandbox. Only an explicit `false` opts out; doing so also lets remote-MCP egress leave the sandbox, so the flag and `enabled` are always read together. Ignored while `enabled` is false. Default: true (enabled by default; set to false to opt out).
+     */
+    sandboxMcpServers?: boolean;
+    /**
+     * Whether language servers the session launches are confined by the sandbox. Only an explicit `false` opts out. Ignored while `enabled` is false. Default: true (enabled by default; set to false to opt out).
+     */
+    sandboxLspServers?: boolean;
+    /**
+     * Whether the agent may request that an individual command run outside the sandbox, which the host then approves or denies through the usual permission flow. A host capability flag rather than part of the policy: it is stripped from the effective spawn policy and only has an effect while `enabled` is true. Fail-closed, unlike the opt-out flags on this object: omitting it offers no bypass. Default: false (opt-in).
+     */
+    allowBypass?: boolean;
     auth?: SandboxConfigAuth;
     /**
      * Whether to auto-grant read access to tool directories discovered on PATH and in toolchain environment variables (GOROOT, JAVA_HOME, VIRTUAL_ENV, and similar), and to common developer-tool caches, config, and toolchains. Writable grants cover scratch caches, the Unix GitHub CLI cache, and Cargo's registry, git store, and lock/tracker files. A relocated CARGO_HOME gets the same narrow split: registry and git are read-write; bin is read-only; the home root, config.toml, and credentials.toml stay ungranted. Set to false to disable every grant listed above; user-installed toolchains and caches then need explicit userPolicy.filesystem readonlyPaths and readwritePaths entries. The working directory (see addCurrentWorkingDirectory), temporary storage, session log paths, and system locations follow their own rules and stay granted. Default: true (enabled by default; set to false to opt out).
@@ -15817,7 +16372,7 @@ export interface SandboxConfigUserPolicyNetwork {
 /** @experimental */
 export interface SandboxConfigUserPolicyNetworkProxy {
     /**
-     * Proxy URL (e.g. http://proxy.example.com:8080). The port is optional and defaults to the scheme's standard port when omitted. Credentials must not be embedded here — a `user:pass@` authority is rejected; put them in the separate `username`/`password` fields. A credential-free http:// loopback URL is routed through the localhost proxy automatically; loopback covers localhost and any *.localhost subdomain, the whole 127.0.0.0/8 range, ::1, and IPv4-mapped loopback (::ffff:127.0.0.1). An https:// URL, or one with a username/password set, is used as-is.
+     * Proxy URL (e.g. http://proxy.example.com:8080). The port is optional and defaults to the scheme's standard port when omitted; an explicit port must be between 1 and 65535. Credentials must not be embedded here — a `user:pass@` authority is rejected; put them in the separate `username`/`password` fields. A credential-free http:// loopback proxy URL is routed through the localhost proxy automatically; loopback covers localhost and any *.localhost subdomain, the whole 127.0.0.0/8 range, ::1, and IPv4-mapped loopback (::ffff:127.0.0.1). An https:// URL, or one with a username/password set, is used as-is.
      */
     url: string;
     /**
@@ -17437,6 +17992,10 @@ export interface SessionOpenOptions {
      * Identifier of the client driving the session.
      */
     clientName?: string;
+    /**
+     * OAuth Client ID Metadata Document URL used by this host for MCP authorization.
+     */
+    authClientIdMetadataUrl?: string;
     /**
      * Structured client kind used for runtime behavior gates.
      */
@@ -17560,6 +18119,10 @@ export interface SessionOpenOptions {
      * Additional directories to search for skills.
      */
     skillDirectories?: string[];
+    /**
+     * Whether skill loading is enabled. When omitted, an SDK skill provider enables skills by default.
+     */
+    enableSkills?: boolean;
     /**
      * Built-in skill names to include in this session. When specified, only these runtime-bundled skills are available. Skills from other sources with the same name remain available.
      */
@@ -18698,6 +19261,28 @@ export interface SessionsPruneOldRequest {
      */
     excludeSessionIds?: string[];
 }
+/**
+ * Pagination options for reading an inactive or active local session's persisted event journal.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionsReadPersistedEventsRequest".
+ */
+/** @experimental */
+export interface SessionsReadPersistedEventsRequest {
+    /**
+     * Session ID whose persisted event journal should be read.
+     */
+    sessionId: string;
+    /**
+     * Opaque cursor returned by a previous persisted-event read. Omit on the first call.
+     */
+    cursor?: string;
+    /**
+     * Maximum number of events to return in this batch (1–1000, default 200).
+     */
+    max?: number;
+    direction?: EventsReadDirection;
+}
 /**
  * Session ID whose in-use lock should be released.
  *
@@ -19065,7 +19650,7 @@ export interface SessionUpdateOptionsParams {
      */
     enableSessionStore?: boolean;
     /**
-     * Whether to enable skill directory scanning and loading. Falls back to enableConfigDiscovery when unset.
+     * Whether skill loading is enabled. Explicit false disables every source, including a bound SDK provider; changing the value invalidates the loaded skill snapshot. When omitted, creation falls back to enableConfigDiscovery unless an SDK skill provider is registered.
      */
     enableSkills?: boolean;
     contextTier?: OptionsUpdateContextTier;
@@ -19286,6 +19871,35 @@ export interface SkillList {
      */
     skills: Skill[];
 }
+/**
+ * Catalog-only metadata for one SDK-provided skill. The complete SKILL.md is fetched separately and lazily.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SkillProviderDescriptor".
+ */
+/** @experimental */
+export interface SkillProviderDescriptor {
+    /**
+     * Invocation and display name.
+     */
+    name: string;
+    /**
+     * Description used in skill catalogs without fetching content.
+     */
+    description: string;
+    /**
+     * Whether users may invoke the skill directly. Defaults to true.
+     */
+    userInvocable?: boolean;
+    /**
+     * Whether model invocation is disabled. Defaults to false.
+     */
+    disableModelInvocation?: boolean;
+    /**
+     * Optional freeform argument hint used by slash-command catalogs.
+     */
+    argumentHint?: string;
+}
 /**
  * Skill names to mark as disabled in global configuration, replacing any previous list.
  *
@@ -19406,7 +20020,7 @@ export interface SkillsInvokedSkill {
      */
     name: string;
     /**
-     * Path to the SKILL.md file
+     * Path to the SKILL.md file, or an empty string for an SDK-provided skill without a filesystem identity
      */
     path: string;
     /**
@@ -19417,6 +20031,10 @@ export interface SkillsInvokedSkill {
      * Tools that should be auto-approved when this skill is active, captured at invocation time
      */
     allowedTools?: string[];
+    /**
+     * Whether model invocation was disabled when this skill was invoked
+     */
+    disableModelInvocation?: boolean;
     /**
      * Turn number when the skill was invoked
      */
@@ -19469,6 +20087,7 @@ export interface SlashCommandTimelineEntry {
      * Optional URL associated with the timeline entry.
      */
     url?: string;
+    remediation?: RemediationAction;
 }
 /**
  * Slash-command invocation result that submits an agent prompt, with display prompt, optional mode, optional user-facing notice, and settings-change flag.
@@ -19516,6 +20135,7 @@ export interface SlashCommandCompletedResult {
      * Optional user-facing message describing the completed command
      */
     message?: string;
+    mode?: SessionMode;
     /**
      * True when the invocation mutated user runtime settings; consumers caching settings should refresh
      */
@@ -19697,6 +20317,7 @@ export interface SubagentSettingsEntry {
      * Model override for matching subagents
      */
     model?: string;
+    modelPolicy?: AgentModelPolicy;
     /**
      * Reasoning effort override for matching subagents
      */
@@ -19824,6 +20445,157 @@ export interface TaskProgressLine {
      */
     timestamp: string;
 }
+/**
+ * Tracked client-owned task metadata.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskClientInfo".
+ */
+/** @experimental */
+export interface TaskClientInfo {
+    type: TaskClientType;
+    /**
+     * Canonical runtime-generated task identifier
+     */
+    id: string;
+    /**
+     * Owner-scoped registration and reclaim key
+     */
+    clientTaskId: string;
+    /**
+     * Optional task display name
+     */
+    displayName?: string;
+    /**
+     * Task description
+     */
+    description: string;
+    status: TaskClientStatus;
+    owner: TaskClientOwner;
+    /**
+     * ISO 8601 timestamp when the task started
+     */
+    startedAt: string;
+    /**
+     * ISO 8601 timestamp of the latest accepted lifecycle change
+     */
+    updatedAt: string;
+    /**
+     * ISO 8601 timestamp when the task reached a terminal status
+     */
+    completedAt?: string;
+    /**
+     * Accumulated active execution time in milliseconds
+     */
+    activeTimeMs: number;
+    /**
+     * ISO 8601 timestamp when the current active segment started
+     */
+    activeStartedAt?: string;
+    /**
+     * ISO 8601 timestamp when the connected owner entered idle status
+     */
+    idleSince?: string;
+    /**
+     * ISO 8601 timestamp of the most recent orphan transition
+     */
+    orphanedAt?: string;
+    /**
+     * ISO 8601 timestamp of the most recent successful reclaim
+     */
+    reclaimedAt?: string;
+    executionMode: TaskClientExecutionMode;
+    /**
+     * Whether the currently bound owner can receive a cancellation request
+     */
+    canCancel: boolean;
+    /**
+     * Sequence number of the latest accepted owner update
+     */
+    sequence: number;
+    /**
+     * Opaque successful terminal result supplied by the task owner
+     */
+    result?: JsonValue;
+    /**
+     * Human-readable terminal failure message
+     */
+    error?: string;
+    /**
+     * Optional owner-supplied terminal failure code
+     */
+    errorCode?: string;
+    /**
+     * Human-readable reason for terminal cancellation
+     */
+    cancellationReason?: string;
+}
+/**
+ * Public owner attribution for a client-owned task. Identifiers are opaque and never authorize requests.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskClientOwner".
+ */
+/** @experimental */
+export interface TaskClientOwner {
+    /**
+     * Opaque session-scoped participant identity
+     */
+    participantId: string;
+    /**
+     * Opaque identity of the currently or most recently bound session join
+     */
+    joinId: string;
+    kind: TaskClientOwnerKind;
+    /**
+     * Display-only owner name
+     */
+    displayName?: string;
+    /**
+     * Display-only owner source
+     */
+    source?: string;
+    presence: TaskClientOwnerPresence;
+    /**
+     * ISO 8601 timestamp when the bound join disconnected
+     */
+    disconnectedAt?: string;
+}
+/**
+ * Generic progress for a client-owned task.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TaskClientProgress".
+ */
+/** @experimental */
+export interface TaskClientProgress {
+    type: TaskClientType;
+    status: TaskClientStatus;
+    /**
+     * Sequence number of the latest accepted owner update
+     */
+    sequence: number;
+    /**
+     * ISO 8601 timestamp of the latest accepted lifecycle change
+     */
+    updatedAt: string;
+    /**
+     * Current owner-defined progress phase
+     */
+    phase?: string;
+    /**
+     * Current completion percentage from zero through one hundred
+     */
+    percentage?: number;
+    /**
+     * Most recent nonempty progress message
+     */
+    lastMessage?: string;
+    /**
+     * Recent server-timestamped progress messages
+     */
+    recentActivity: TaskProgressLine[];
+}
 /** @experimental */
 export interface TaskCompletionDecision {
     outcome: TaskCompletionOutcome;
@@ -20041,6 +20813,54 @@ export interface TasksPromoteToBackgroundResult {
 /** @experimental */
 export interface TasksRefreshResult {
 }
+/**
+ * Registers or reclaims a client-owned task.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TasksRegisterRequest".
+ */
+/** @experimental */
+export interface TasksRegisterRequest {
+    type: TaskClientType;
+    /**
+     * Owner-scoped idempotency key used for registration and reclaim
+     */
+    clientTaskId: string;
+    /**
+     * Human-readable description of the external work
+     */
+    description: string;
+    /**
+     * Optional short display name for the external work
+     */
+    displayName?: string;
+    /**
+     * Whether the owner supports runtime cancellation requests
+     */
+    cancellable: boolean;
+    /**
+     * Expected current sequence for idempotent registration or orphan reclaim
+     */
+    expectedSequence?: number;
+}
+/**
+ * Result of registering or reclaiming a client-owned task.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TasksRegisterResult".
+ */
+/** @experimental */
+export interface TasksRegisterResult {
+    task: TaskClientInfo;
+    /**
+     * True only when this invocation created a new task
+     */
+    created: boolean;
+    /**
+     * True only when this invocation reclaimed an orphaned task
+     */
+    reclaimed: boolean;
+}
 /**
  * Identifier of the completed or cancelled task to remove from tracking.
  *
@@ -20147,6 +20967,42 @@ export interface TasksStartAgentResult {
      */
     agentId: string;
 }
+/**
+ * Updates a client-owned task.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TasksUpdateRequest".
+ */
+/** @experimental */
+export interface TasksUpdateRequest {
+    /**
+     * Canonical runtime-generated task identifier
+     */
+    id: string;
+    /**
+     * Owner update sequence to apply
+     */
+    sequence: number;
+    update: TaskClientUpdate;
+}
+/**
+ * Result of publishing a client-owned task update.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "TasksUpdateResult".
+ */
+/** @experimental */
+export interface TasksUpdateResult {
+    task: TaskClientInfo;
+    /**
+     * Whether this invocation changed task state
+     */
+    applied: boolean;
+    /**
+     * Whether this invocation repeated the latest accepted update
+     */
+    duplicate: boolean;
+}
 /**
  * Wait until all in-flight background tasks (agents + shells) and any follow-up turns scheduled by their completions have settled. Returns when the runtime is fully drained or after an internal timeout (default 10 minutes; configurable via COPILOT_TASK_WAIT_TIMEOUT_SECONDS).
  *
@@ -21999,6 +22855,19 @@ export interface SessionLimitPredictionPredictRequest {
     modelId?: string;
     clientType?: SessionLimitPredictionClientType;
 }
+/**
+ * Identifies the target session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SkillProviderListRequest".
+ */
+/** @experimental */
+export interface SkillProviderListRequest {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+}
 /**
  * Identifies the target session.
  *
@@ -22025,6 +22894,17 @@ export declare function createServerRpc(connection: MessageConnection): {
      */
     ping: (params: PingRequest) => Promise<PingResult>;
     /** @experimental */
+    hooks: {
+        /**
+         * Discovers hook actions enabled under server-side discovery settings from user, repository, plugin, and managed-policy sources.
+         *
+         * @param params Optional project paths and host-exclusion behavior for server-scoped hook discovery.
+         *
+         * @returns Server-discovered hook actions and partial-load diagnostics from user, repository, plugin, and managed-policy sources. Concrete sessions may include additional session-specific hook sources.
+         */
+        discover: (params: HooksDiscoverRequest) => Promise<HooksDiscoverResult>;
+    };
+    /** @experimental */
     models: {
         /**
          * Lists Copilot models available to the authenticated user.
@@ -22414,6 +23294,10 @@ export declare function createServerRpc(connection: MessageConnection): {
          * @returns Validated device-managed settings discovered before a session exists.
          */
         read: () => Promise<ManagedSettingsReadResult>;
+        /**
+         * Force-refreshes enterprise managed settings for every account: wipes the persistent server-policy cache (the whole `<cacheHome>/managed-settings` directory) and drops this runtime process's in-memory retained server policy. It does not itself fetch policy — the effect is that the next time a session resolves managed settings for an account, that resolution re-fetches the account's org policy from the network instead of serving a cached response. Note that `managedSettings.read` returns only device/MDM settings and never triggers the account server-policy fetch, so a host implementing "sync account policy" should start a fresh session resolution rather than treat a subsequent `managedSettings.read` as the refreshed org policy. Mirrors the invalidation a sign-out performs, broadened from the one signing-out account to all of them; device/MDM layers describe the machine, not the account, and are left untouched. Rejects if the on-disk cache cannot be removed.
+         */
+        clearCache: () => Promise<void>;
     };
     /** @experimental */
     runtime: {
@@ -22492,6 +23376,14 @@ export declare function createServerRpc(connection: MessageConnection): {
          * @returns Sessions matching the filter, ordered most-recently-modified first.
          */
         list: (params: SessionsListRequest) => Promise<SessionList>;
+        /**
+         * Reads a page of durable events directly from a local session's persisted journal without creating, resuming, or activating the session. The initial backward read uses a bounded tail scan for fast first paint; cursor continuations preserve the session event-log paging semantics. Persisted events may omit payloads that are reconstructed only for an active session.
+         *
+         * @param params Pagination options for reading an inactive or active local session's persisted event journal.
+         *
+         * @returns Batch of session events returned by a read, with cursor and continuation metadata.
+         */
+        readPersistedEvents: (params: SessionsReadPersistedEventsRequest) => Promise<EventsReadResult>;
         /**
          * Finds the local session bound to a GitHub task ID, if any.
          *
@@ -22891,9 +23783,9 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
     /** @experimental */
     model: {
         /**
-         * Gets the currently selected model for the session.
+         * Gets the session's authoritative model snapshot, including the committed Auto preference and any newer unclaimed Auto preference waiting for a future user turn.
          *
-         * @returns The currently selected model, reasoning effort, and context tier for the session. The context tier reflects `Session.getContextTier()`, restored from the session journal on resume.
+         * @returns The session's authoritative model snapshot. Auto preference fields are configuration for the virtual `auto` model and do not change the selected model identifier. The context tier reflects `Session.getContextTier()`, restored from the session journal on resume.
          */
         getCurrent: () => Promise<CurrentModel>;
         /**
@@ -22904,6 +23796,14 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns The model identifier active on the session after the switch.
          */
         switchTo: (params: ModelSwitchToRequest) => Promise<ModelSwitchToResult>;
+        /**
+         * Requests an Auto preference change without changing the session's selected model. The latest unclaimed request wins; the runtime commits it only after a later prompt using the `auto` model mints a usable model and token pair. A `pending` response confirms that the request was accepted, not that it committed. Observe eventual success through `session.model_change`, failure through the ephemeral `session.auto_tier_switch_failed` event, or current unclaimed state through `session.model.getCurrent`.
+         *
+         * @param params An Auto preference request for the session. This updates Auto configuration only; it does not change the selected model to `auto`.
+         *
+         * @returns Immediate acknowledgement and Auto preference snapshot after a switch request. This result never implies that a pending preference committed.
+         */
+        switchAutoTier: (params: ModelSwitchAutoTierRequest) => Promise<ModelSwitchAutoTierResult>;
         /**
          * Updates the session's reasoning effort without changing the selected model.
          *
@@ -23110,6 +24010,15 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         diff: (params: WorkspacesDiffRequest) => Promise<WorkspaceDiffResult>;
     };
     /** @experimental */
+    autopilotObjective: {
+        /**
+         * Reads the current canonical autopilot objective state for this session.
+         *
+         * @returns Canonical runtime state for the session's current autopilot objective.
+         */
+        getState: () => Promise<AutopilotObjectiveGetStateResult>;
+    };
+    /** @experimental */
     completions: {
         /**
          * Gets the characters that should trigger host-driven completions for the session. Empty disables host-driven completions (e.g. local sessions, or a relay host that does not advertise them).
@@ -23203,6 +24112,22 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Background tasks currently tracked by the session.
          */
         list: () => Promise<TaskList>;
+        /**
+         * Registers a client-owned task, or reclaims an orphaned task belonging to the same extension principal.
+         *
+         * @param params Registers or reclaims a client-owned task.
+         *
+         * @returns Result of registering or reclaiming a client-owned task.
+         */
+        register: (params: TasksRegisterRequest) => Promise<TasksRegisterResult>;
+        /**
+         * Publishes generic progress or a terminal outcome for a client-owned task.
+         *
+         * @param params Updates a client-owned task.
+         *
+         * @returns Result of publishing a client-owned task update.
+         */
+        update: (params: TasksUpdateRequest) => Promise<TasksUpdateResult>;
         /**
          * Refreshes metadata for any detached background shells the runtime knows about.
          *
@@ -24404,6 +25329,18 @@ export interface FactoryHandler {
      */
     abort(params: FactoryAbortRequest): Promise<FactoryAckResult>;
 }
+/** Handler for `tasks` client session API methods. */
+/** @experimental */
+export interface TasksHandler {
+    /**
+     * Asks the client currently bound to a client-owned session task to confirm that its external work stopped.
+     *
+     * @param params Runtime-to-owner cancellation request for a client-owned task.
+     *
+     * @returns Whether the client authoritatively confirmed its external work stopped.
+     */
+    cancel(params: ClientTaskCancelRequest): Promise<ClientTaskCancelResult>;
+}
 /** Handler for `sessionFs` client session API methods. */
 /** @experimental */
 export interface SessionFsHandler {
@@ -24542,6 +25479,7 @@ export interface CanvasHandler {
 export interface ClientSessionApiHandlers {
     providerToken?: ProviderTokenHandler;
     factory?: FactoryHandler;
+    tasks?: TasksHandler;
     sessionFs?: SessionFsHandler;
     canvas?: CanvasHandler;
 }