@github/copilot-sdk 1.0.6-preview.0 → 1.0.6

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, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpServerSource, McpServerStatus, PermissionPromptRequest, PermissionRule, ReasoningSummary, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, UserToolSessionApproval } from "./session-events.js";
+import type { AbortReason, Attachment, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpServerSource, McpServerStatus, PermissionPromptRequest, PermissionRule, ReasoningSummary, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, UserToolSessionApproval, Verbosity } from "./session-events.js";
 /**
  * Initial authentication info for the session.
  *
@@ -188,6 +188,20 @@ export type AgentRegistrySpawnValidationErrorField =
  | "model"
 /** The permissionMode parameter */
  | "permissionMode";
+/**
+ * Current or requested allow-all mode.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PermissionsAllowAllMode".
+ */
+/** @experimental */
+export type PermissionsAllowAllMode = 
+/** Permission requests follow the normal approval flow. */
+"off"
+/** Tool, path, and URL permission requests are automatically approved. */
+ | "on"
+/** Permission requests follow the normal approval flow with an LLM advisory recommendation attached; clients may choose to auto-approve requests the judge evaluated as acceptable. */
+ | "auto";
 /**
  * Authentication type
  *
@@ -266,6 +280,82 @@ export type ContentFilterMode =
  | "markdown"
 /** Remove characters that can hide directives. */
  | "hidden_characters";
+/**
+ * Source category for a collected debug bundle entry.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsSource".
+ */
+/** @experimental */
+export type DebugCollectLogsSource = 
+/** Session event log. */
+"events"
+/** Process log for the session. */
+ | "process-log"
+/** Interactive shell log for the session. */
+ | "shell-log"
+/** Caller-provided diagnostic entry. */
+ | "additional";
+/**
+ * Destination for the redacted debug bundle.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsDestination".
+ */
+/** @experimental */
+export type DebugCollectLogsDestination = {
+    /**
+     * Absolute or server-relative path for the .tgz archive to create.
+     */
+    outputPath: string;
+    /**
+     * When true, create the archive atomically without overwriting an existing file by appending ` (N)` before the extension as needed. Defaults to false.
+     */
+    noOverwrite?: boolean;
+    kind: "archive";
+} | {
+    /**
+     * Directory where redacted files should be staged. The directory is created if needed.
+     */
+    outputDirectory: string;
+    kind: "directory";
+};
+/**
+ * Kind of caller-provided debug log entry.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsEntryKind".
+ */
+/** @experimental */
+export type DebugCollectLogsEntryKind = 
+/** Include a single server-local file. */
+"file"
+/** Include files from a server-local directory recursively. */
+ | "directory";
+/**
+ * How a collected debug entry should be redacted before being staged.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsRedaction".
+ */
+/** @experimental */
+export type DebugCollectLogsRedaction = 
+/** Redact the file as plain UTF-8 log text. */
+"plain-text"
+/** Redact each non-empty line as a session event JSON object, falling back to plain-text redaction for malformed lines. */
+ | "events-jsonl";
+/**
+ * Destination kind that was written.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsResultKind".
+ */
+/** @experimental */
+export type DebugCollectLogsResultKind = 
+/** A .tgz archive was written. */
+"archive"
+/** A directory containing redacted files was written. */
+ | "directory";
 /**
  * Server transport type: stdio, http, sse (deprecated), or memory
  *
@@ -756,6 +846,59 @@ export type McpSetEnvValueModeDetails =
 "direct"
 /** Treat MCP server environment values as host-side references to resolve before launch. */
  | "indirect";
+/**
+ * Per-source context-window attribution, or null if the session has not yet been initialized (no system prompt or tool metadata cached).
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionContextAttribution".
+ */
+/** @experimental */
+export type SessionContextAttribution = {
+    /**
+     * Total token count of the current context window the entries are measured against (system message + conversation messages + tool definitions — the same total reported by /context). Divide an entry's `tokens` by this to derive its share.
+     */
+    totalTokens: number;
+    /**
+     * Flat list of per-source attribution entries. Group by `kind` and render unrecognized kinds generically. Nesting and rollups are expressed via `parentId`.
+     */
+    entries: {
+        /**
+         * Source category for this entry. Not a closed set — tolerate unknown values. Known values today: `skill`, `subagent`, `mcpServer`, `tool`, `system`, `toolDefinition`, `plugin`.
+         */
+        kind: string;
+        /**
+         * Identifier for this entry, formed by joining its `kind` and source name (e.g. `tool:bash`, `skill:tmux`, `toolDefinition:bash`); unique within the snapshot. Use it to match the same entry across snapshots, to correlate with other APIs (skill/agent/MCP registries), and as the `parentId` target for nesting. Distinct from the human-facing `label`.
+         */
+        id: string;
+        /**
+         * Human-readable display label, e.g. `bash` or `skill: tmux`. Presentation-only; may be localized/reformatted without notice — do not key off it.
+         */
+        label: string;
+        /**
+         * Token count currently in context attributable to this entry.
+         */
+        tokens: number;
+        /**
+         * Optional `id` of the parent entry: e.g. a `plugin` entry parenting its `skill`/`mcpServer` entries, or the `system` entry parenting `toolDefinition` entries. Omitted for top-level entries.
+         */
+        parentId?: string;
+        /**
+         * Supplementary per-entry metadata (e.g. `messageCount`, `role`, `evictable`, `pluginSource`). Values are stringified; parse as needed and ignore unrecognized keys.
+         */
+        attributes?: {
+            [k: string]: string | undefined;
+        };
+    }[];
+    /**
+     * Successful compaction history for the session.
+     */
+    compactions: {
+        /**
+         * Number of successful compactions in this session.
+         */
+        count: number;
+    };
+} | null;
 /**
  * Token breakdown for the current context window, or null if the session has not yet been initialized (no system prompt or tool metadata cached).
  *
@@ -1126,7 +1269,7 @@ export type ProviderEndpointTransport =
 /** WebSocket transport. */
  | "websockets";
 /**
- * Schema for the `PushAttachment` type.
+ * Attachment union accepted by push input, covering files, directories, GitHub objects, blobs, snippets, and extension context.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PushAttachment".
@@ -1483,6 +1626,52 @@ export type SessionsOpenProgressStatus =
 "in-progress"
 /** The step has completed successfully. */
  | "complete";
+/**
+ * Rust-owned settings predicates exposed across the SDK boundary. Raw feature-flag names are intentionally not part of the contract.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionSettingsPredicateName".
+ */
+/** @experimental */
+export type SessionSettingsPredicateName = 
+/** Whether the security-tools feature flag enables security tool wiring. */
+"securityToolsEnabled"
+/** Whether third-party security tools should receive the security prompt. */
+ | "thirdPartySecurityPromptEnabled"
+/** Whether validation may run in parallel. */
+ | "parallelValidationEnabled"
+/** Whether runtime timing telemetry is enabled. */
+ | "runtimeTimingTelemetryEnabled"
+/** Whether the co-author hook is enabled. */
+ | "coAuthorHookEnabled"
+/** Whether Chronicle integration is enabled. */
+ | "chronicleEnabled"
+/** Whether content-exclusion policy may self-fetch data. */
+ | "contentExclusionSelfFetchEnabled"
+/** Whether Claude Opus token-limit caps should be applied. */
+ | "capClaudeOpusTokenLimitsEnabled"
+/** Whether code-review behavior is enabled. */
+ | "codeReviewFeatureEnabled"
+/** Whether CCA should use the TypeScript autofind behavior. */
+ | "ccaUseTsAutofindEnabled"
+/** Whether the dependency checker is enabled. */
+ | "dependencyCheckerEnabled"
+/** Whether the Dependabot checker is enabled. */
+ | "dependabotCheckerEnabled"
+/** Whether the CodeQL checker is enabled. */
+ | "codeqlCheckerEnabled"
+/** Whether trivial-change handling is enabled. */
+ | "trivialChangeEnabled"
+/** Whether trivial-change skip behavior is enabled. */
+ | "trivialChangeSkipEnabled"
+/** Whether trivial-change handling is enabled for code review. */
+ | "trivialChangeEnabledForCodeReview"
+/** Whether trivial-change skip behavior is enabled for code review. */
+ | "trivialChangeSkipEnabledForCodeReview"
+/** Whether trivial-change handling is enabled for a specific tool. */
+ | "trivialChangeEnabledForTool"
+/** Whether trivial-change skip behavior is enabled for a specific tool. */
+ | "trivialChangeSkipEnabledForTool";
 /**
  * Which session sources to include. Defaults to `local` for backward compatibility.
  *
@@ -1619,7 +1808,7 @@ export type TaskExecutionMode =
 /** The task is managed in the background. */
  | "background";
 /**
- * Schema for the `TaskInfo` type.
+ * Tracked task union returned by task APIs, containing either an agent task or a shell task.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "TaskInfo".
@@ -1661,7 +1850,7 @@ export type UIAutoModeSwitchResponse =
 /** Decline the automatic mode switch. */
  | "no";
 /**
- * Schema for the `UIElicitationFieldValue` type.
+ * Submitted UI elicitation field value: string, number, boolean, or an array of strings.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "UIElicitationFieldValue".
@@ -1828,7 +2017,7 @@ export interface AbortResult {
     error?: string;
 }
 /**
- * Schema for the `AccountAllUsers` type.
+ * Authenticated account entry returned by `account.getAllUsers`, with auth info and an optional associated token.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountAllUsers".
@@ -1842,7 +2031,7 @@ export interface AccountAllUsers {
     token?: string;
 }
 /**
- * Schema for the `HMACAuthInfo` type.
+ * Authentication-info variant for GitHub-internal HMAC auth, carrying the public GitHub host and HMAC secret.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "HMACAuthInfo".
@@ -1871,18 +2060,48 @@ export interface HMACAuthInfo {
  */
 /** @experimental */
 export interface CopilotUserResponse {
+    /**
+     * GitHub login of the authenticated user.
+     */
     login?: string;
+    /**
+     * Copilot access SKU identifier (e.g. `free_limited_copilot`, `copilot_for_business_seat_quota`) used to gate model and feature access.
+     */
     access_type_sku?: string;
+    /**
+     * Opaque analytics tracking identifier for the user, forwarded from the Copilot API.
+     */
     analytics_tracking_id?: string;
+    /**
+     * Date the Copilot seat was assigned to the user, if applicable.
+     */
     assigned_date?: ({
         [k: string]: unknown | undefined;
     } | string) | null;
+    /**
+     * Whether the user is eligible to sign up for the free/limited Copilot tier.
+     */
     can_signup_for_limited?: boolean;
+    /**
+     * Whether Copilot chat is enabled for the user.
+     */
     chat_enabled?: boolean;
+    /**
+     * Copilot plan name for the user (e.g. `individual`, `business`, `enterprise`).
+     */
     copilot_plan?: string;
+    /**
+     * Whether `.copilotignore` content-exclusion support is enabled for the user.
+     */
     copilotignore_enabled?: boolean;
     endpoints?: CopilotUserResponseEndpoints;
+    /**
+     * Logins of the organizations the user belongs to.
+     */
     organization_login_list?: string[];
+    /**
+     * Organizations the user belongs to, each with an optional login and display name.
+     */
     organization_list?: ({
         [k: string]: unknown | undefined;
     } | ({
@@ -1893,30 +2112,72 @@ export interface CopilotUserResponse {
             [k: string]: unknown | undefined;
         } | string) | null;
     } | null)[]) | null;
+    /**
+     * Whether the Codex agent is enabled for the user.
+     */
     codex_agent_enabled?: boolean;
+    /**
+     * Whether MCP (Model Context Protocol) support is enabled for the user.
+     */
     is_mcp_enabled?: ({
         [k: string]: unknown | undefined;
     } | boolean) | null;
+    /**
+     * Date the user's usage quota next resets, as a raw string from the Copilot API; see `quota_reset_date_utc` for the UTC-normalized value.
+     */
     quota_reset_date?: string;
     quota_snapshots?: CopilotUserResponseQuotaSnapshots;
+    /**
+     * Whether the user's telemetry is subject to restricted-data handling.
+     */
     restricted_telemetry?: boolean;
+    /**
+     * Whether the user is a GitHub/Microsoft staff member.
+     */
     is_staff?: boolean;
+    /**
+     * Raw passthrough of the Copilot API `te` flag for the user (an opaque server-side eligibility signal surfaced in telemetry); not otherwise interpreted by the runtime.
+     */
     te?: boolean;
+    /**
+     * Whether the account is on usage-based (token/AI-credit) billing rather than a fixed premium-request quota.
+     */
     token_based_billing?: boolean;
+    /**
+     * Whether the user is able to upgrade their Copilot plan.
+     */
     can_upgrade_plan?: boolean;
+    /**
+     * UTC-normalized form of `quota_reset_date` (the date the user's usage quota next resets).
+     */
     quota_reset_date_utc?: string;
+    /**
+     * Per-category quota allotments for free/limited-tier users, keyed by quota category.
+     */
     limited_user_quotas?: {
         [k: string]: number | undefined;
     };
+    /**
+     * Date the free/limited-tier user's quotas next reset, as a raw string from the Copilot API.
+     */
     limited_user_reset_date?: string;
+    /**
+     * Per-category monthly quota allotments, keyed by quota category.
+     */
     monthly_quotas?: {
         [k: string]: number | undefined;
     };
+    /**
+     * Whether cloud session storage is enabled for the user.
+     */
     cloud_session_storage_enabled?: boolean;
+    /**
+     * Whether CLI remote control is enabled for the user.
+     */
     cli_remote_control_enabled?: boolean;
 }
 /**
- * Schema for the `CopilotUserResponseEndpoints` type.
+ * Endpoint URLs from the raw Copilot `/copilot_internal/v2/token` user-response passthrough.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponseEndpoints".
@@ -1929,7 +2190,7 @@ export interface CopilotUserResponseEndpoints {
     telemetry?: string;
 }
 /**
- * Schema for the `CopilotUserResponseQuotaSnapshots` type.
+ * Quota snapshot map from the raw Copilot user-response passthrough, with chat, completions, premium-interactions, and other entries.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponseQuotaSnapshots".
@@ -1955,70 +2216,178 @@ export interface CopilotUserResponseQuotaSnapshots {
     } | null) | undefined;
 }
 /**
- * Schema for the `CopilotUserResponseQuotaSnapshotsChat` type.
+ * Chat quota snapshot from the raw Copilot user-response passthrough, with entitlement, overage, remaining quota, reset, and billing fields.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponseQuotaSnapshotsChat".
  */
 /** @experimental */
 export interface CopilotUserResponseQuotaSnapshotsChat {
+    /**
+     * Number of requests/units included in the entitlement for this period; `-1` denotes an unlimited entitlement.
+     */
     entitlement?: number;
+    /**
+     * Count of additional pay-per-request usage consumed this period beyond the entitlement.
+     */
     overage_count?: number;
+    /**
+     * Whether usage may continue at pay-per-request rates once the entitlement is exhausted.
+     */
     overage_permitted?: boolean;
+    /**
+     * Percentage of the entitlement remaining at the snapshot timestamp.
+     */
     percent_remaining?: number;
+    /**
+     * Identifier of the quota bucket this snapshot describes.
+     */
     quota_id?: string;
+    /**
+     * Amount of quota remaining at the snapshot timestamp.
+     */
     quota_remaining?: number;
+    /**
+     * Remaining entitlement/quota amount at the snapshot timestamp.
+     */
     remaining?: number;
+    /**
+     * Whether the entitlement for this category is unlimited.
+     */
     unlimited?: boolean;
+    /**
+     * UTC timestamp when this snapshot was captured.
+     */
     timestamp_utc?: string;
+    /**
+     * Whether the user currently has quota available; when `false` and not unlimited, further requests are blocked until the quota resets.
+     */
     has_quota?: boolean;
+    /**
+     * Unix epoch time, in seconds, when this quota next resets.
+     */
     quota_reset_at?: number;
+    /**
+     * Whether this category uses usage-based (token/AI-credit) billing rather than a fixed premium-request count.
+     */
     token_based_billing?: boolean;
 }
 /**
- * Schema for the `CopilotUserResponseQuotaSnapshotsCompletions` type.
+ * Completions quota snapshot from the raw Copilot user-response passthrough, with entitlement, overage, remaining quota, reset, and billing fields.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponseQuotaSnapshotsCompletions".
  */
 /** @experimental */
 export interface CopilotUserResponseQuotaSnapshotsCompletions {
+    /**
+     * Number of requests/units included in the entitlement for this period; `-1` denotes an unlimited entitlement.
+     */
     entitlement?: number;
+    /**
+     * Count of additional pay-per-request usage consumed this period beyond the entitlement.
+     */
     overage_count?: number;
+    /**
+     * Whether usage may continue at pay-per-request rates once the entitlement is exhausted.
+     */
     overage_permitted?: boolean;
+    /**
+     * Percentage of the entitlement remaining at the snapshot timestamp.
+     */
     percent_remaining?: number;
+    /**
+     * Identifier of the quota bucket this snapshot describes.
+     */
     quota_id?: string;
+    /**
+     * Amount of quota remaining at the snapshot timestamp.
+     */
     quota_remaining?: number;
+    /**
+     * Remaining entitlement/quota amount at the snapshot timestamp.
+     */
     remaining?: number;
+    /**
+     * Whether the entitlement for this category is unlimited.
+     */
     unlimited?: boolean;
+    /**
+     * UTC timestamp when this snapshot was captured.
+     */
     timestamp_utc?: string;
+    /**
+     * Whether the user currently has quota available; when `false` and not unlimited, further requests are blocked until the quota resets.
+     */
     has_quota?: boolean;
+    /**
+     * Unix epoch time, in seconds, when this quota next resets.
+     */
     quota_reset_at?: number;
+    /**
+     * Whether this category uses usage-based (token/AI-credit) billing rather than a fixed premium-request count.
+     */
     token_based_billing?: boolean;
 }
 /**
- * Schema for the `CopilotUserResponseQuotaSnapshotsPremiumInteractions` type.
+ * Premium-interactions quota snapshot from the raw Copilot user-response passthrough, with entitlement, overage, remaining quota, reset, and billing fields.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotUserResponseQuotaSnapshotsPremiumInteractions".
  */
 /** @experimental */
 export interface CopilotUserResponseQuotaSnapshotsPremiumInteractions {
+    /**
+     * Number of requests/units included in the entitlement for this period; `-1` denotes an unlimited entitlement.
+     */
     entitlement?: number;
+    /**
+     * Count of additional pay-per-request usage consumed this period beyond the entitlement.
+     */
     overage_count?: number;
+    /**
+     * Whether usage may continue at pay-per-request rates once the entitlement is exhausted.
+     */
     overage_permitted?: boolean;
+    /**
+     * Percentage of the entitlement remaining at the snapshot timestamp.
+     */
     percent_remaining?: number;
+    /**
+     * Identifier of the quota bucket this snapshot describes.
+     */
     quota_id?: string;
+    /**
+     * Amount of quota remaining at the snapshot timestamp.
+     */
     quota_remaining?: number;
+    /**
+     * Remaining entitlement/quota amount at the snapshot timestamp.
+     */
     remaining?: number;
+    /**
+     * Whether the entitlement for this category is unlimited.
+     */
     unlimited?: boolean;
+    /**
+     * UTC timestamp when this snapshot was captured.
+     */
     timestamp_utc?: string;
+    /**
+     * Whether the user currently has quota available; when `false` and not unlimited, further requests are blocked until the quota resets.
+     */
     has_quota?: boolean;
+    /**
+     * Unix epoch time, in seconds, when this quota next resets.
+     */
     quota_reset_at?: number;
+    /**
+     * Whether this category uses usage-based (token/AI-credit) billing rather than a fixed premium-request count.
+     */
     token_based_billing?: boolean;
 }
 /**
- * Schema for the `EnvAuthInfo` type.
+ * Authentication-info variant for a token sourced from an environment variable, with host, optional login, token, and env var name.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "EnvAuthInfo".
@@ -2048,7 +2417,7 @@ export interface EnvAuthInfo {
     copilotUser?: CopilotUserResponse;
 }
 /**
- * Schema for the `TokenAuthInfo` type.
+ * Authentication-info variant for SDK-configured token authentication, carrying host and the secret token value.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "TokenAuthInfo".
@@ -2070,7 +2439,7 @@ export interface TokenAuthInfo {
     copilotUser?: CopilotUserResponse;
 }
 /**
- * Schema for the `CopilotApiTokenAuthInfo` type.
+ * Authentication-info variant for direct Copilot API token auth sourced from environment variables, with public GitHub host.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CopilotApiTokenAuthInfo".
@@ -2088,7 +2457,7 @@ export interface CopilotApiTokenAuthInfo {
     copilotUser?: CopilotUserResponse;
 }
 /**
- * Schema for the `UserAuthInfo` type.
+ * Authentication-info variant for OAuth user auth, with host and login; the token remains in the runtime secret store.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "UserAuthInfo".
@@ -2110,7 +2479,7 @@ export interface UserAuthInfo {
     copilotUser?: CopilotUserResponse;
 }
 /**
- * Schema for the `GhCliAuthInfo` type.
+ * Authentication-info variant for GitHub CLI credentials, carrying host, login, and the `gh auth token` value.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "GhCliAuthInfo".
@@ -2136,7 +2505,7 @@ export interface GhCliAuthInfo {
     copilotUser?: CopilotUserResponse;
 }
 /**
- * Schema for the `ApiKeyAuthInfo` type.
+ * Authentication-info variant for API-key authentication to a non-GitHub LLM provider, carrying the secret `apiKey` and host.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ApiKeyAuthInfo".
@@ -2194,7 +2563,7 @@ export interface AccountGetQuotaResult {
     };
 }
 /**
- * Schema for the `AccountQuotaSnapshot` type.
+ * Quota usage snapshot for a Copilot quota type, including entitlement, used requests, overage, reset date, and remaining percentage.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AccountQuotaSnapshot".
@@ -2292,7 +2661,7 @@ export interface AccountLogoutResult {
     hasMoreUsers: boolean;
 }
 /**
- * Schema for the `AgentDiscoveryPath` type.
+ * Canonical directory where custom agents can be discovered or created, with scope, preference, and optional project path.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AgentDiscoveryPath".
@@ -2340,7 +2709,7 @@ export interface AgentGetCurrentResult {
     agent?: AgentInfo | null;
 }
 /**
- * Schema for the `AgentInfo` type.
+ * Custom agent metadata, including identifiers, display details, source, tools, model, MCP servers, skills, and file path.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AgentInfo".
@@ -2687,12 +3056,13 @@ export interface AllowAllPermissionSetResult {
      */
     success: boolean;
     /**
-     * Authoritative allow-all state after the mutation
+     * Authoritative full allow-all state after the mutation
      */
     enabled: boolean;
+    mode?: PermissionsAllowAllMode;
 }
 /**
- * Current full allow-all permission state.
+ * Current allow-all permission mode.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AllowAllPermissionState".
@@ -2703,6 +3073,7 @@ export interface AllowAllPermissionState {
      * Whether full allow-all permissions are currently active
      */
     enabled: boolean;
+    mode?: PermissionsAllowAllMode;
 }
 /**
  * Cancellation result for a user-requested shell command.
@@ -3102,7 +3473,7 @@ export interface CommandList {
     commands: SlashCommandInfo[];
 }
 /**
- * Schema for the `SlashCommandInfo` type.
+ * Slash-command metadata with name, aliases, description, kind, input hint, execution allowance, and schedulability.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SlashCommandInfo".
@@ -3148,6 +3519,10 @@ export interface SlashCommandInput {
      * Hint to display when command input has not been provided
      */
     hint: string;
+    /**
+     * Optional literal choices the input accepts, each with a human-facing description; clients may render these as selectable options
+     */
+    choices?: SlashCommandInputChoice[];
     /**
      * When true, the command requires non-empty input; clients should render the input hint as required
      */
@@ -3158,6 +3533,23 @@ export interface SlashCommandInput {
      */
     preserveMultilineInput?: boolean;
 }
+/**
+ * A literal choice the command input accepts, with a human-facing description
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SlashCommandInputChoice".
+ */
+/** @experimental */
+export interface SlashCommandInputChoice {
+    /**
+     * The literal choice value (e.g. 'on', 'off', 'show')
+     */
+    name: string;
+    /**
+     * Human-readable description shown alongside the choice
+     */
+    description: string;
+}
 /**
  * Pending command request ID and an optional error if the client handler failed.
  *
@@ -3241,7 +3633,7 @@ export interface CommandsRespondToQueuedCommandRequest {
     result: QueuedCommandResult;
 }
 /**
- * Schema for the `QueuedCommandHandled` type.
+ * Queued-command response indicating the host executed the command, with an optional flag to stop queue processing.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "QueuedCommandHandled".
@@ -3258,7 +3650,7 @@ export interface QueuedCommandHandled {
     stopProcessingQueue?: boolean;
 }
 /**
- * Schema for the `QueuedCommandNotHandled` type.
+ * Queued-command response indicating the host did not execute the command and the queue may continue.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "QueuedCommandNotHandled".
@@ -3436,6 +3828,31 @@ export interface ConnectRemoteSessionParams {
      */
     sessionId: string;
 }
+/**
+ * A single large message currently in context.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ContextHeaviestMessage".
+ */
+/** @experimental */
+export interface ContextHeaviestMessage {
+    /**
+     * Stable identifier for this message within the snapshot.
+     */
+    id: string;
+    /**
+     * Human-readable source label, e.g. `tool: bash` or `skill: tmux`. Presentation-only.
+     */
+    label: string;
+    /**
+     * Role of the chat message (`user`, `assistant`, or `tool`).
+     */
+    role: string;
+    /**
+     * Token count currently in context for this individual message.
+     */
+    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.
  *
@@ -3494,7 +3911,143 @@ export interface CurrentToolMetadata {
     deferLoading?: boolean;
 }
 /**
- * Schema for the `DiscoveredMcpServer` type.
+ * A file included in the redacted debug bundle.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsCollectedEntry".
+ */
+/** @experimental */
+export interface DebugCollectLogsCollectedEntry {
+    /**
+     * Relative path of the file in the staged bundle/archive.
+     */
+    bundlePath: string;
+    source: DebugCollectLogsSource;
+    /**
+     * Redacted output size in bytes.
+     */
+    sizeBytes: number;
+}
+/**
+ * A caller-provided server-local file or directory to include in the debug bundle.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsEntry".
+ */
+/** @experimental */
+export interface DebugCollectLogsEntry {
+    kind: DebugCollectLogsEntryKind;
+    /**
+     * Server-local source path to read.
+     */
+    path: string;
+    /**
+     * Relative path to use inside the staged bundle/archive.
+     */
+    bundlePath: string;
+    redaction?: DebugCollectLogsRedaction;
+    /**
+     * When true, collection fails if this entry cannot be read. Defaults to false, which records the entry in `skippedEntries`.
+     */
+    required?: boolean;
+}
+/**
+ * Built-in session diagnostics to include in the bundle. Omitted fields default to true.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsInclude".
+ */
+/** @experimental */
+export interface DebugCollectLogsInclude {
+    /**
+     * Include the session event log (`events.jsonl`). Defaults to true.
+     */
+    events?: boolean;
+    /**
+     * Include process logs for the session. Defaults to true.
+     */
+    processLogs?: boolean;
+    /**
+     * Include interactive shell logs written under the session's `shell-logs` directory. Defaults to true.
+     */
+    shellLogs?: boolean;
+    /**
+     * Server-local path to the session's events.jsonl file. Internal callers normally omit this and let the runtime derive it from the session.
+     */
+    eventsPath?: string;
+    /**
+     * Server-local path to the current process log. When set, it is included as `process.log` and its directory is searched for prior logs from the same session.
+     */
+    currentProcessLogPath?: string;
+    /**
+     * Server-local process log directory to search when `currentProcessLogPath` is unavailable, useful for collecting logs for inactive sessions.
+     */
+    processLogDirectory?: string;
+    /**
+     * Maximum number of previous process logs to include. Defaults to 5.
+     */
+    previousProcessLogLimit?: number;
+}
+/**
+ * Options for collecting a redacted session debug bundle.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsRequest".
+ */
+/** @experimental */
+export interface DebugCollectLogsRequest {
+    destination: DebugCollectLogsDestination;
+    include?: DebugCollectLogsInclude;
+    /**
+     * Caller-provided server-local files or directories to include in addition to the runtime's built-in session diagnostics. This lets host applications add their own diagnostics without changing the API shape.
+     */
+    additionalEntries?: DebugCollectLogsEntry[];
+}
+/**
+ * Result of collecting a redacted debug bundle.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsResult".
+ */
+/** @experimental */
+export interface DebugCollectLogsResult {
+    kind: DebugCollectLogsResultKind;
+    /**
+     * Actual archive path or staging directory path written. This may differ from the requested path when no-overwrite suffixing or fallback-to-temp-directory was needed.
+     */
+    path: string;
+    /**
+     * Files included in the redacted bundle.
+     */
+    entries: DebugCollectLogsCollectedEntry[];
+    /**
+     * Optional files or directories that could not be included.
+     */
+    skippedEntries?: DebugCollectLogsSkippedEntry[];
+}
+/**
+ * An optional debug bundle entry that could not be included.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DebugCollectLogsSkippedEntry".
+ */
+/** @experimental */
+export interface DebugCollectLogsSkippedEntry {
+    /**
+     * Relative path requested for this bundle entry.
+     */
+    bundlePath: string;
+    /**
+     * Server-local source path that could not be read.
+     */
+    path?: string;
+    /**
+     * Reason the entry was skipped.
+     */
+    reason: string;
+}
+/**
+ * MCP server discovered by `mcp.discover`, with config source, optional plugin source, transport type, and enabled state.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "DiscoveredMcpServer".
@@ -3648,7 +4201,7 @@ export interface ExecuteCommandResult {
     error?: string;
 }
 /**
- * Schema for the `Extension` type.
+ * Discovered extension metadata, including source-qualified ID, name, discovery source, status, and optional process ID.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "Extension".
@@ -3770,6 +4323,10 @@ export interface ExternalToolTextResultForLlm {
      * Structured content blocks from the tool
      */
     contents?: ExternalToolTextResultForLlmContent[];
+    /**
+     * Tool references returned by a tool-search override: names of deferred tools to surface to the model. When set, the tool result is materialized as `tool_reference` content blocks (rather than plain text) so the model knows which deferred tools are now available.
+     */
+    toolReferences?: string[];
 }
 /**
  * Binary result returned by a tool for the model
@@ -4160,7 +4717,7 @@ export interface GitHubTelemetryEvent {
     client?: GitHubTelemetryClientInfo;
 }
 /**
- * Payload for a `gitHubTelemetry.event` notification: a single GitHub telemetry event the runtime forwards to a host connection that opted into telemetry forwarding for the session.
+ * Payload for a `gitHubTelemetry.event` notification: a single GitHub telemetry event the runtime forwards to a host connection that opted into telemetry forwarding during the `server.connect` handshake.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "GitHubTelemetryNotification".
@@ -4168,9 +4725,9 @@ export interface GitHubTelemetryEvent {
 /** @experimental */
 export interface GitHubTelemetryNotification {
     /**
-     * Session the telemetry event belongs to.
+     * Session the telemetry event belongs to, when it is session-scoped. Omitted for sessionless events (for example, `server.sendTelemetry` calls with no session id), which are still forwarded to opted-in connections.
      */
-    sessionId: string;
+    sessionId?: string;
     /**
      * Whether this is a restricted telemetry event (cli.restricted_telemetry). Hosts must route restricted events to first-party Microsoft stores only.
      */
@@ -4346,7 +4903,7 @@ export interface HistoryTruncateResult {
     eventsRemoved: number;
 }
 /**
- * Schema for the `InstalledPlugin` type.
+ * Installed plugin record from global state, with marketplace, version, install time, enabled state, cache path, and source.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "InstalledPlugin".
@@ -4380,7 +4937,7 @@ export interface InstalledPlugin {
     source?: InstalledPluginSource;
 }
 /**
- * Schema for the `InstalledPluginSourceGitHub` type.
+ * Source descriptor for a direct GitHub plugin install, with `owner/repo`, optional ref, and optional subpath.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "InstalledPluginSourceGitHub".
@@ -4396,7 +4953,7 @@ export interface InstalledPluginSourceGitHub {
     path?: string;
 }
 /**
- * Schema for the `InstalledPluginSourceUrl` type.
+ * Source descriptor for a direct URL plugin install, with URL, optional ref, and optional subpath.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "InstalledPluginSourceUrl".
@@ -4412,7 +4969,7 @@ export interface InstalledPluginSourceUrl {
     path?: string;
 }
 /**
- * Schema for the `InstalledPluginSourceLocal` type.
+ * Source descriptor for a direct local plugin install, with a local filesystem path.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "InstalledPluginSourceLocal".
@@ -4455,7 +5012,7 @@ export interface InstalledPluginInfo {
     enabled: boolean;
 }
 /**
- * Schema for the `InstructionDiscoveryPath` type.
+ * Canonical file or directory where custom instructions can be discovered or created, with location, kind, preference, and project path.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "InstructionDiscoveryPath".
@@ -4538,7 +5095,7 @@ export interface InstructionsGetSourcesResult {
     sources: InstructionSource[];
 }
 /**
- * Schema for the `InstructionSource` type.
+ * Loaded instruction source for a session, including path, content, category, location, applicability, and optional description.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "InstructionSource".
@@ -4658,6 +5215,18 @@ export interface LlmInferenceHttpRequestStartRequest {
     url: string;
     headers: LlmInferenceHeaders;
     transport?: LlmInferenceHttpRequestStartTransport;
+    /**
+     * Stable per-agent-instance id attributing this request to a specific agent trajectory. Present when the request originates from an agent turn; absent for requests issued outside any agent context (e.g. some SDK callers). A request with an `agentId` but no `parentAgentId` is a root-agent request; one carrying both is a subagent request. Sourced from the runtime's per-request agent context and surfaced on the envelope independently of transport, so it is available for both first-party (CAPI) and BYOK/custom-provider requests; on the CAPI transport the runtime derives the upstream `X-Agent-Task-Id` header from this same context. Consumers routing each provider call to a training trajectory should key on this rather than on lifecycle events, since it is available on the request path before sampling.
+     */
+    agentId?: string;
+    /**
+     * Id of the parent agent that spawned the agent issuing this request. Present only for subagent requests; absent for root-agent requests and non-agent requests. Combined with `agentId`, this lets consumers attribute a call to a child trajectory versus the root. Like `agentId`, it comes from the runtime's per-request agent context independently of transport; on the CAPI transport the runtime derives the upstream `X-Parent-Agent-Id` header from this same context.
+     */
+    parentAgentId?: string;
+    /**
+     * Coarse classification of the interaction that produced this request. Open string for forward-compatibility; known values include `conversation-agent`, `conversation-subagent`, `conversation-sampling`, `conversation-background`, `conversation-compaction`, and `conversation-user`. Absent when the runtime did not classify the request. Comes from the runtime's per-request agent context independently of transport; on the CAPI transport the runtime derives the upstream `X-Interaction-Type` header from this same context.
+     */
+    interactionType?: string;
 }
 /**
  * Acknowledgement. Returning successfully simply means the SDK accepted the start frame; it does not imply the request will succeed.
@@ -4773,7 +5342,7 @@ export interface LlmInferenceSetProviderResult {
     success: boolean;
 }
 /**
- * Schema for the `LocalSessionMetadataValue` type.
+ * Persisted local session metadata, including identifiers, timestamps, summary/name, client, context, detached state, and task ID.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "LocalSessionMetadataValue".
@@ -4986,7 +5555,7 @@ export interface MarketplaceListResult {
     marketplaces: MarketplaceInfo[];
 }
 /**
- * Schema for the `MarketplaceRefreshEntry` type.
+ * Per-marketplace refresh result, including marketplace name, success flag, and optional failure error.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "MarketplaceRefreshEntry".
@@ -5037,7 +5606,7 @@ export interface MarketplaceRemoveResult {
     dependentPlugins?: string[];
 }
 /**
- * Schema for the `McpAllowedServer` type.
+ * MCP server allowed by policy, with server name and optional PII-free explanatory note.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpAllowedServer".
@@ -5252,7 +5821,7 @@ export interface McpAppsReadResourceResult {
     contents: McpAppsResourceContent[];
 }
 /**
- * Schema for the `McpAppsResourceContent` type.
+ * MCP Apps resource content with URI, optional MIME type, text or base64 blob, and resource metadata.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpAppsResourceContent".
@@ -5640,7 +6209,7 @@ export interface McpExecuteSamplingResult {
     [k: string]: unknown | undefined;
 }
 /**
- * Schema for the `McpFilteredServer` type.
+ * MCP server filtered by policy, with name, reason, optional redacted reason, and enterprise login.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpFilteredServer".
@@ -5815,7 +6384,7 @@ export interface McpListToolsResult {
     tools: McpTools[];
 }
 /**
- * Schema for the `McpTools` type.
+ * MCP tool metadata with tool name and optional description.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpTools".
@@ -5909,15 +6478,6 @@ export interface McpOauthLoginResult {
      */
     authorizationUrl?: string;
 }
-/**
- * Empty result after recording the MCP OAuth response.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "McpOauthRespondResult".
- */
-/** @experimental */
-export interface McpOauthRespondResult {
-}
 /**
  * Indicates whether the auto-managed `github` MCP server was removed (false when nothing to remove).
  *
@@ -5947,7 +6507,7 @@ export interface McpSamplingExecutionResult {
     error?: string;
 }
 /**
- * Schema for the `McpServer` type.
+ * MCP server status entry, including config source/plugin source and any connection error.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "McpServer".
@@ -6050,6 +6610,49 @@ export interface MemoryConfiguration {
      */
     enabled: boolean;
 }
+/**
+ * Per-source attribution breakdown for the session's current context window, or null if uninitialized.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "MetadataContextAttributionResult".
+ */
+/** @experimental */
+export interface MetadataContextAttributionResult {
+    /**
+     * Per-source context-window attribution, or null if the session has not yet been initialized (no system prompt or tool metadata cached).
+     */
+    contextAttribution?: SessionContextAttribution | null;
+}
+/**
+ * Parameters for the heaviest-messages query.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "MetadataContextHeaviestMessagesRequest".
+ */
+/** @experimental */
+export interface MetadataContextHeaviestMessagesRequest {
+    /**
+     * Maximum number of messages to return, most-expensive first. Omit for the server default.
+     */
+    limit?: number;
+}
+/**
+ * The heaviest individual messages in the session's context window, most-expensive first.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "MetadataContextHeaviestMessagesResult".
+ */
+/** @experimental */
+export interface MetadataContextHeaviestMessagesResult {
+    /**
+     * Total token count of the current context window, so callers can compute each message's share without a second call.
+     */
+    totalTokens: number;
+    /**
+     * Heaviest messages, most-expensive first.
+     */
+    messages: ContextHeaviestMessage[];
+}
 /**
  * Model identifier and token limits used to compute the context-info breakdown.
  *
@@ -6255,7 +6858,7 @@ export interface MetadataSnapshotRemoteMetadataRepository {
     branch: string;
 }
 /**
- * Schema for the `Model` type.
+ * Copilot model metadata, including identifier, display name, capabilities, policy, billing, reasoning efforts, and picker categories.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "Model".
@@ -6619,6 +7222,7 @@ export interface ModelSwitchToRequest {
      */
     reasoningEffort?: string;
     reasoningSummary?: ReasoningSummary;
+    verbosity?: Verbosity;
     modelCapabilities?: ModelCapabilitiesOverride;
     contextTier?: ContextTier;
 }
@@ -6750,7 +7354,7 @@ export interface NameSetRequest {
     name: string;
 }
 /**
- * Schema for the `OptionsUpdateAdditionalContentExclusionPolicy` type.
+ * Content-exclusion policy supplied to `session.options.update`, with rules, last-updated data, and scope.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "OptionsUpdateAdditionalContentExclusionPolicy".
@@ -6762,7 +7366,7 @@ export interface OptionsUpdateAdditionalContentExclusionPolicy {
     scope: OptionsUpdateAdditionalContentExclusionPolicyScope;
 }
 /**
- * Schema for the `OptionsUpdateAdditionalContentExclusionPolicyRule` type.
+ * Single content-exclusion rule supplied to `session.options.update`, with paths, match conditions, and source.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "OptionsUpdateAdditionalContentExclusionPolicyRule".
@@ -6775,7 +7379,7 @@ export interface OptionsUpdateAdditionalContentExclusionPolicyRule {
     source: OptionsUpdateAdditionalContentExclusionPolicyRuleSource;
 }
 /**
- * Schema for the `OptionsUpdateAdditionalContentExclusionPolicyRuleSource` type.
+ * Source descriptor for a `session.options.update` content-exclusion rule, with source name and type.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "OptionsUpdateAdditionalContentExclusionPolicyRuleSource".
@@ -6786,7 +7390,7 @@ export interface OptionsUpdateAdditionalContentExclusionPolicyRuleSource {
     type: string;
 }
 /**
- * Schema for the `PendingPermissionRequest` type.
+ * Pending permission prompt reconstructed from event history, with request ID and user-facing prompt details.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PendingPermissionRequest".
@@ -6813,7 +7417,7 @@ export interface PendingPermissionRequestList {
     items: PendingPermissionRequest[];
 }
 /**
- * Schema for the `PermissionDecisionApproveOnce` type.
+ * Permission-decision request variant to approve only the current permission request.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveOnce".
@@ -6826,7 +7430,7 @@ export interface PermissionDecisionApproveOnce {
     kind: "approve-once";
 }
 /**
- * Schema for the `PermissionDecisionApproveForSession` type.
+ * Permission-decision request variant to approve for the rest of the session, with optional tool approval or URL domain.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForSession".
@@ -6844,7 +7448,7 @@ export interface PermissionDecisionApproveForSession {
     domain?: string;
 }
 /**
- * Schema for the `PermissionDecisionApproveForSessionApprovalCommands` type.
+ * Session-scoped approval details for specific command identifiers.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForSessionApprovalCommands".
@@ -6861,7 +7465,7 @@ export interface PermissionDecisionApproveForSessionApprovalCommands {
     commandIdentifiers: string[];
 }
 /**
- * Schema for the `PermissionDecisionApproveForSessionApprovalRead` type.
+ * Session-scoped approval details for read-only filesystem operations.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForSessionApprovalRead".
@@ -6874,7 +7478,7 @@ export interface PermissionDecisionApproveForSessionApprovalRead {
     kind: "read";
 }
 /**
- * Schema for the `PermissionDecisionApproveForSessionApprovalWrite` type.
+ * Session-scoped approval details for filesystem write operations.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForSessionApprovalWrite".
@@ -6887,7 +7491,7 @@ export interface PermissionDecisionApproveForSessionApprovalWrite {
     kind: "write";
 }
 /**
- * Schema for the `PermissionDecisionApproveForSessionApprovalMcp` type.
+ * Session-scoped approval details for an MCP server tool, or all tools on the server when `toolName` is null.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForSessionApprovalMcp".
@@ -6908,7 +7512,7 @@ export interface PermissionDecisionApproveForSessionApprovalMcp {
     toolName: string | null;
 }
 /**
- * Schema for the `PermissionDecisionApproveForSessionApprovalMcpSampling` type.
+ * Session-scoped approval details for MCP sampling requests from a server.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForSessionApprovalMcpSampling".
@@ -6925,7 +7529,7 @@ export interface PermissionDecisionApproveForSessionApprovalMcpSampling {
     serverName: string;
 }
 /**
- * Schema for the `PermissionDecisionApproveForSessionApprovalMemory` type.
+ * Session-scoped approval details for writes to long-term memory.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForSessionApprovalMemory".
@@ -6938,7 +7542,7 @@ export interface PermissionDecisionApproveForSessionApprovalMemory {
     kind: "memory";
 }
 /**
- * Schema for the `PermissionDecisionApproveForSessionApprovalCustomTool` type.
+ * Session-scoped approval details for a custom tool, keyed by tool name.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForSessionApprovalCustomTool".
@@ -6955,7 +7559,7 @@ export interface PermissionDecisionApproveForSessionApprovalCustomTool {
     toolName: string;
 }
 /**
- * Schema for the `PermissionDecisionApproveForSessionApprovalExtensionManagement` type.
+ * Session-scoped approval details for extension-management operations, optionally narrowed by operation.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForSessionApprovalExtensionManagement".
@@ -6972,7 +7576,7 @@ export interface PermissionDecisionApproveForSessionApprovalExtensionManagement
     operation?: string;
 }
 /**
- * Schema for the `PermissionDecisionApproveForSessionApprovalExtensionPermissionAccess` type.
+ * Session-scoped approval details for an extension's permission-gated capability access, keyed by extension name.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForSessionApprovalExtensionPermissionAccess".
@@ -6989,7 +7593,7 @@ export interface PermissionDecisionApproveForSessionApprovalExtensionPermissionA
     extensionName: string;
 }
 /**
- * Schema for the `PermissionDecisionApproveForLocation` type.
+ * Permission-decision request variant to approve and persist a permission for a project location, with approval details and location key.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForLocation".
@@ -7007,7 +7611,7 @@ export interface PermissionDecisionApproveForLocation {
     locationKey: string;
 }
 /**
- * Schema for the `PermissionDecisionApproveForLocationApprovalCommands` type.
+ * Location-scoped approval details for specific command identifiers.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForLocationApprovalCommands".
@@ -7024,7 +7628,7 @@ export interface PermissionDecisionApproveForLocationApprovalCommands {
     commandIdentifiers: string[];
 }
 /**
- * Schema for the `PermissionDecisionApproveForLocationApprovalRead` type.
+ * Location-scoped approval details for read-only filesystem operations.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForLocationApprovalRead".
@@ -7037,7 +7641,7 @@ export interface PermissionDecisionApproveForLocationApprovalRead {
     kind: "read";
 }
 /**
- * Schema for the `PermissionDecisionApproveForLocationApprovalWrite` type.
+ * Location-scoped approval details for filesystem write operations.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForLocationApprovalWrite".
@@ -7050,7 +7654,7 @@ export interface PermissionDecisionApproveForLocationApprovalWrite {
     kind: "write";
 }
 /**
- * Schema for the `PermissionDecisionApproveForLocationApprovalMcp` type.
+ * Location-scoped approval details for an MCP server tool, or all tools on the server when `toolName` is null.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForLocationApprovalMcp".
@@ -7071,7 +7675,7 @@ export interface PermissionDecisionApproveForLocationApprovalMcp {
     toolName: string | null;
 }
 /**
- * Schema for the `PermissionDecisionApproveForLocationApprovalMcpSampling` type.
+ * Location-scoped approval details for MCP sampling requests from a server.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForLocationApprovalMcpSampling".
@@ -7088,7 +7692,7 @@ export interface PermissionDecisionApproveForLocationApprovalMcpSampling {
     serverName: string;
 }
 /**
- * Schema for the `PermissionDecisionApproveForLocationApprovalMemory` type.
+ * Location-scoped approval details for writes to long-term memory.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForLocationApprovalMemory".
@@ -7101,7 +7705,7 @@ export interface PermissionDecisionApproveForLocationApprovalMemory {
     kind: "memory";
 }
 /**
- * Schema for the `PermissionDecisionApproveForLocationApprovalCustomTool` type.
+ * Location-scoped approval details for a custom tool, keyed by tool name.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForLocationApprovalCustomTool".
@@ -7118,7 +7722,7 @@ export interface PermissionDecisionApproveForLocationApprovalCustomTool {
     toolName: string;
 }
 /**
- * Schema for the `PermissionDecisionApproveForLocationApprovalExtensionManagement` type.
+ * Location-scoped approval details for extension-management operations, optionally narrowed by operation.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForLocationApprovalExtensionManagement".
@@ -7135,7 +7739,7 @@ export interface PermissionDecisionApproveForLocationApprovalExtensionManagement
     operation?: string;
 }
 /**
- * Schema for the `PermissionDecisionApproveForLocationApprovalExtensionPermissionAccess` type.
+ * Location-scoped approval details for an extension's permission-gated capability access, keyed by extension name.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproveForLocationApprovalExtensionPermissionAccess".
@@ -7152,7 +7756,7 @@ export interface PermissionDecisionApproveForLocationApprovalExtensionPermission
     extensionName: string;
 }
 /**
- * Schema for the `PermissionDecisionApprovePermanently` type.
+ * Permission-decision request variant to permanently approve a URL domain across sessions.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApprovePermanently".
@@ -7169,7 +7773,7 @@ export interface PermissionDecisionApprovePermanently {
     domain: string;
 }
 /**
- * Schema for the `PermissionDecisionReject` type.
+ * Permission-decision request variant to reject a pending permission request, with optional feedback.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionReject".
@@ -7186,7 +7790,7 @@ export interface PermissionDecisionReject {
     feedback?: string;
 }
 /**
- * Schema for the `PermissionDecisionUserNotAvailable` type.
+ * Permission-decision variant indicating no user was available to confirm the request.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionUserNotAvailable".
@@ -7199,7 +7803,7 @@ export interface PermissionDecisionUserNotAvailable {
     kind: "user-not-available";
 }
 /**
- * Schema for the `PermissionDecisionApproved` type.
+ * Permission-decision variant indicating the request was approved.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApproved".
@@ -7212,7 +7816,7 @@ export interface PermissionDecisionApproved {
     kind: "approved";
 }
 /**
- * Schema for the `PermissionDecisionApprovedForSession` type.
+ * Permission-decision variant indicating approval was remembered for the session, with approval details.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApprovedForSession".
@@ -7226,7 +7830,7 @@ export interface PermissionDecisionApprovedForSession {
     approval: UserToolSessionApproval;
 }
 /**
- * Schema for the `PermissionDecisionApprovedForLocation` type.
+ * Permission-decision variant indicating approval was persisted for a project location, with approval details and location key.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionApprovedForLocation".
@@ -7244,7 +7848,7 @@ export interface PermissionDecisionApprovedForLocation {
     locationKey: string;
 }
 /**
- * Schema for the `PermissionDecisionCancelled` type.
+ * Permission-decision variant indicating the request was cancelled before use, with an optional reason.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionCancelled".
@@ -7261,7 +7865,7 @@ export interface PermissionDecisionCancelled {
     reason?: string;
 }
 /**
- * Schema for the `PermissionDecisionDeniedByRules` type.
+ * Permission-decision variant indicating explicit denial by permission rules, with the matching rules.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionDeniedByRules".
@@ -7278,7 +7882,7 @@ export interface PermissionDecisionDeniedByRules {
     rules: PermissionRule[];
 }
 /**
- * Schema for the `PermissionDecisionDeniedNoApprovalRuleAndCouldNotRequestFromUser` type.
+ * Permission-decision variant indicating no approval rule matched and user confirmation was unavailable.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionDeniedNoApprovalRuleAndCouldNotRequestFromUser".
@@ -7291,7 +7895,7 @@ export interface PermissionDecisionDeniedNoApprovalRuleAndCouldNotRequestFromUse
     kind: "denied-no-approval-rule-and-could-not-request-from-user";
 }
 /**
- * Schema for the `PermissionDecisionDeniedInteractivelyByUser` type.
+ * Permission-decision variant indicating the user denied an interactive prompt, with optional feedback and force-reject flag.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionDeniedInteractivelyByUser".
@@ -7312,7 +7916,7 @@ export interface PermissionDecisionDeniedInteractivelyByUser {
     forceReject?: boolean;
 }
 /**
- * Schema for the `PermissionDecisionDeniedByContentExclusionPolicy` type.
+ * Permission-decision variant indicating denial by content-exclusion policy, with path and message.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionDeniedByContentExclusionPolicy".
@@ -7333,7 +7937,7 @@ export interface PermissionDecisionDeniedByContentExclusionPolicy {
     message: string;
 }
 /**
- * Schema for the `PermissionDecisionDeniedByPermissionRequestHook` type.
+ * Permission-decision variant indicating denial by a permission request hook, with optional message and interrupt flag.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionDecisionDeniedByPermissionRequestHook".
@@ -7382,7 +7986,7 @@ export interface PermissionLocationAddToolApprovalParams {
     approval: PermissionsLocationsAddToolApprovalDetails;
 }
 /**
- * Schema for the `PermissionsLocationsAddToolApprovalDetailsCommands` type.
+ * Location-persisted tool approval details for specific command identifiers.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsLocationsAddToolApprovalDetailsCommands".
@@ -7399,7 +8003,7 @@ export interface PermissionsLocationsAddToolApprovalDetailsCommands {
     commandIdentifiers: string[];
 }
 /**
- * Schema for the `PermissionsLocationsAddToolApprovalDetailsRead` type.
+ * Location-persisted tool approval details for read-only filesystem operations.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsLocationsAddToolApprovalDetailsRead".
@@ -7412,7 +8016,7 @@ export interface PermissionsLocationsAddToolApprovalDetailsRead {
     kind: "read";
 }
 /**
- * Schema for the `PermissionsLocationsAddToolApprovalDetailsWrite` type.
+ * Location-persisted tool approval details for filesystem write operations.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsLocationsAddToolApprovalDetailsWrite".
@@ -7425,7 +8029,7 @@ export interface PermissionsLocationsAddToolApprovalDetailsWrite {
     kind: "write";
 }
 /**
- * Schema for the `PermissionsLocationsAddToolApprovalDetailsMcp` type.
+ * Location-persisted tool approval details for an MCP server tool, or all tools when `toolName` is null.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsLocationsAddToolApprovalDetailsMcp".
@@ -7446,7 +8050,7 @@ export interface PermissionsLocationsAddToolApprovalDetailsMcp {
     toolName: string | null;
 }
 /**
- * Schema for the `PermissionsLocationsAddToolApprovalDetailsMcpSampling` type.
+ * Location-persisted tool approval details for MCP sampling requests from a server.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsLocationsAddToolApprovalDetailsMcpSampling".
@@ -7463,7 +8067,7 @@ export interface PermissionsLocationsAddToolApprovalDetailsMcpSampling {
     serverName: string;
 }
 /**
- * Schema for the `PermissionsLocationsAddToolApprovalDetailsMemory` type.
+ * Location-persisted tool approval details for writes to long-term memory.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsLocationsAddToolApprovalDetailsMemory".
@@ -7476,7 +8080,7 @@ export interface PermissionsLocationsAddToolApprovalDetailsMemory {
     kind: "memory";
 }
 /**
- * Schema for the `PermissionsLocationsAddToolApprovalDetailsCustomTool` type.
+ * Location-persisted tool approval details for a custom tool, keyed by tool name.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsLocationsAddToolApprovalDetailsCustomTool".
@@ -7493,7 +8097,7 @@ export interface PermissionsLocationsAddToolApprovalDetailsCustomTool {
     toolName: string;
 }
 /**
- * Schema for the `PermissionsLocationsAddToolApprovalDetailsExtensionManagement` type.
+ * Location-persisted tool approval details for extension-management operations, optionally narrowed by operation.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsLocationsAddToolApprovalDetailsExtensionManagement".
@@ -7510,7 +8114,7 @@ export interface PermissionsLocationsAddToolApprovalDetailsExtensionManagement {
     operation?: string;
 }
 /**
- * Schema for the `PermissionsLocationsAddToolApprovalDetailsExtensionPermissionAccess` type.
+ * Location-persisted tool approval details for an extension's permission-gated capability access, keyed by extension name.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsLocationsAddToolApprovalDetailsExtensionPermissionAccess".
@@ -7760,7 +8364,7 @@ export interface PermissionRulesSet {
     denied: PermissionRule[];
 }
 /**
- * Schema for the `PermissionsConfigureAdditionalContentExclusionPolicy` type.
+ * Content-exclusion policy supplied to `session.permissions.configure`, with rules, last-updated data, and scope.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsConfigureAdditionalContentExclusionPolicy".
@@ -7772,7 +8376,7 @@ export interface PermissionsConfigureAdditionalContentExclusionPolicy {
     scope: PermissionsConfigureAdditionalContentExclusionPolicyScope;
 }
 /**
- * Schema for the `PermissionsConfigureAdditionalContentExclusionPolicyRule` type.
+ * Single content-exclusion rule supplied to `session.permissions.configure`, with paths, match conditions, and source.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsConfigureAdditionalContentExclusionPolicyRule".
@@ -7785,7 +8389,7 @@ export interface PermissionsConfigureAdditionalContentExclusionPolicyRule {
     source: PermissionsConfigureAdditionalContentExclusionPolicyRuleSource;
 }
 /**
- * Schema for the `PermissionsConfigureAdditionalContentExclusionPolicyRuleSource` type.
+ * Source descriptor for a `session.permissions.configure` content-exclusion rule, with source name and type.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsConfigureAdditionalContentExclusionPolicyRuleSource".
@@ -7999,17 +8603,22 @@ export interface PermissionsResetSessionApprovalsResult {
     success: boolean;
 }
 /**
- * Whether to enable full allow-all permissions for the session.
+ * Allow-all mode to apply for the session.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PermissionsSetAllowAllRequest".
  */
 /** @experimental */
 export interface PermissionsSetAllowAllRequest {
+    mode?: PermissionsAllowAllMode;
     /**
-     * Whether to enable full allow-all permissions
+     * Legacy full allow-all toggle. Prefer `mode`; when `mode` is omitted, `enabled: true` is treated as `mode: "on"` and any other value is treated as `mode: "off"`.
      */
-    enabled: boolean;
+    enabled?: boolean;
+    /**
+     * Optional model id for the `auto` mode auto-approval LLM judging. Only meaningful when `mode` is `auto`; ignored otherwise. When omitted, the session's active model is used.
+     */
+    model?: string;
     source?: PermissionsSetAllowAllSource;
 }
 /**
@@ -8232,7 +8841,7 @@ export interface PlanUpdateRequest {
     content: string;
 }
 /**
- * Schema for the `Plugin` type.
+ * Session plugin metadata, with name, marketplace, optional version, and enabled state.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "Plugin".
@@ -8417,6 +9026,10 @@ export interface PluginsReloadRequest {
      * Re-load user, plugin, and (subject to `deferRepoHooks`) repo hooks. Defaults to true. Has no effect when the host has not registered a hook reloader (e.g. remote sessions).
      */
     reloadHooks?: boolean;
+    /**
+     * Re-discover and relaunch subprocess extensions (including plugin-shipped extensions) after refreshing plugins. Defaults to true. Has no effect when the session has no active extension controller (e.g. extensions were not requested for the session).
+     */
+    reloadExtensions?: boolean;
     /**
      * When true, skip repo-level hooks during the hook reload. Use before folder trust is confirmed; load them post-trust via `sessions.loadDeferredRepoHooks`.
      */
@@ -8453,7 +9066,7 @@ export interface PluginsUpdateRequest {
     name: string;
 }
 /**
- * Schema for the `PluginUpdateAllEntry` type.
+ * Per-plugin result from updating all plugins, with versions, skills installed, success flag, and optional error.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PluginUpdateAllEntry".
@@ -8523,36 +9136,6 @@ export interface PluginUpdateResult {
      */
     skillsInstalled: number;
 }
-/**
- * Batch of spawn events plus a cursor for follow-up polls.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "PollSpawnedSessionsResult".
- */
-/** @experimental */
-export interface PollSpawnedSessionsResult {
-    /**
-     * Spawn events emitted since the supplied cursor.
-     */
-    events: SessionsPollSpawnedSessionsEvent[];
-    /**
-     * Opaque cursor to pass back to receive only events after this batch.
-     */
-    cursor: string;
-}
-/**
- * Schema for the `SessionsPollSpawnedSessionsEvent` type.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SessionsPollSpawnedSessionsEvent".
- */
-/** @experimental */
-export interface SessionsPollSpawnedSessionsEvent {
-    /**
-     * Session id of the newly-spawned session.
-     */
-    sessionId: string;
-}
 /**
  * BYOK providers and/or models to add to the session's registry at runtime. Both fields are optional; provide providers, models, or both.
  *
@@ -9235,7 +9818,7 @@ export interface PushAttachmentBlob {
     displayName?: string;
 }
 /**
- * Schema for the `QueuePendingItems` type.
+ * User-facing pending queue entry, with kind and display text for a queued message, slash command, or model change.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "QueuePendingItems".
@@ -9287,7 +9870,7 @@ export interface QueueRemoveMostRecentResult {
 /** @experimental */
 export interface RegisterEventInterestParams {
     /**
-     * The event type the consumer wants the runtime to treat as 'observed' for behavior-switching gating. Some runtime code paths inspect whether any consumer is interested in a specific event type and choose a different implementation accordingly (e.g. `mcp.oauth_required`: when interest is registered the runtime delegates the full interactive OAuth flow to the consumer; when no interest is registered the runtime installs a browserless fallback that silently reuses cached tokens). SDK clients that long-poll events do NOT automatically appear as listeners to these gating checks — they must explicitly call `registerInterest` for each event type they want the runtime to count as having a consumer. Multiple registrations for the same event type from the same or different consumers are tracked independently and must each be released. See: `mcp.oauth_required`, `sampling.requested`, `auto_mode_switch.requested`, `session_limits_exhausted.requested`, `user_input.requested`, `elicitation.requested`, `command.queued`, `exit_plan_mode.requested`.
+     * The event type the consumer wants the runtime to treat as 'observed' for behavior-switching gating. Some runtime code paths inspect whether any consumer is interested in a specific event type and choose a different implementation accordingly (e.g. `mcp.oauth_required`: when interest is registered the runtime delegates OAuth token acquisition to the consumer; when no interest is registered OAuth-required servers become needs-auth). SDK clients that long-poll events do NOT automatically appear as listeners to these gating checks — they must explicitly call `registerInterest` for each event type they want the runtime to count as having a consumer. Multiple registrations for the same event type from the same or different consumers are tracked independently and must each be released. See: `mcp.oauth_required`, `sampling.requested`, `auto_mode_switch.requested`, `session_limits_exhausted.requested`, `user_input.requested`, `elicitation.requested`, `command.queued`, `exit_plan_mode.requested`.
      */
     eventType: string;
 }
@@ -9720,14 +10303,6 @@ export interface SandboxConfigUserPolicyNetwork {
      * Whether traffic to local/loopback addresses is allowed.
      */
     allowLocalNetwork?: boolean;
-    /**
-     * Hosts allowed in addition to the base policy.
-     */
-    allowedHosts?: string[];
-    /**
-     * Hosts explicitly blocked.
-     */
-    blockedHosts?: string[];
 }
 /**
  * macOS seatbelt-specific options.
@@ -9766,7 +10341,7 @@ export interface SandboxConfigUserPolicyExperimentalSeatbelt {
     keychainAccess?: boolean;
 }
 /**
- * Schema for the `ScheduleEntry` type.
+ * Scheduled prompt entry with ID, timing (`intervalMs`, `cron`, or `at`), prompt text, recurrence, and next run time.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ScheduleEntry".
@@ -9986,7 +10561,7 @@ export interface ServerInstructionSourceList {
     sources: InstructionSource[];
 }
 /**
- * Schema for the `ServerSkill` type.
+ * Server-side skill metadata, including name, description, source, enabled/invocable state, path, project path, and argument hint.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ServerSkill".
@@ -10237,7 +10812,7 @@ export interface SessionFsReaddirResult {
     error?: SessionFsError;
 }
 /**
- * Schema for the `SessionFsReaddirWithTypesEntry` type.
+ * Directory entry returned by session filesystem `readdirWithTypes`, with name and entry type.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsReaddirWithTypesEntry".
@@ -10541,7 +11116,7 @@ export interface SessionFsWriteFileRequest {
     mode?: number;
 }
 /**
- * Schema for the `SessionInstalledPlugin` type.
+ * Installed plugin record for a session, with marketplace, version, install time, enabled state, cache path, and source.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionInstalledPlugin".
@@ -10575,7 +11150,7 @@ export interface SessionInstalledPlugin {
     source?: SessionInstalledPluginSource;
 }
 /**
- * Schema for the `SessionInstalledPluginSourceGitHub` type.
+ * Source descriptor for a direct GitHub plugin install, with `owner/repo`, optional ref, and optional subpath.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionInstalledPluginSourceGitHub".
@@ -10591,7 +11166,7 @@ export interface SessionInstalledPluginSourceGitHub {
     path?: string;
 }
 /**
- * Schema for the `SessionInstalledPluginSourceUrl` type.
+ * Source descriptor for a direct URL plugin install, with URL, optional ref, and optional subpath.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionInstalledPluginSourceUrl".
@@ -10607,7 +11182,7 @@ export interface SessionInstalledPluginSourceUrl {
     path?: string;
 }
 /**
- * Schema for the `SessionInstalledPluginSourceLocal` type.
+ * Source descriptor for a direct local plugin install, with a local filesystem path.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionInstalledPluginSourceLocal".
@@ -10782,6 +11357,7 @@ export interface SessionOpenOptions {
      */
     reasoningEffort?: string;
     reasoningSummary?: SessionOpenOptionsReasoningSummary;
+    verbosity?: Verbosity;
     /**
      * Identifier of the client driving the session.
      */
@@ -10798,6 +11374,10 @@ export interface SessionOpenOptions {
      * Stable integration identifier for analytics.
      */
     integrationId?: string;
+    /**
+     * Opt-in: self-fetch and enforce enterprise managed settings at session bootstrap.
+     */
+    enableManagedSettings?: boolean;
     /**
      * Feature-flag values resolved by the host.
      */
@@ -10975,7 +11555,7 @@ export interface SessionOpenOptions {
     sessionCapabilities?: SessionCapability[];
 }
 /**
- * Schema for the `SessionOpenOptionsAdditionalContentExclusionPolicy` type.
+ * Content-exclusion policy supplied to `sessions.open` options, with rules, last-updated data, and scope.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionOpenOptionsAdditionalContentExclusionPolicy".
@@ -10987,7 +11567,7 @@ export interface SessionOpenOptionsAdditionalContentExclusionPolicy {
     scope: SessionOpenOptionsAdditionalContentExclusionPolicyScope;
 }
 /**
- * Schema for the `SessionOpenOptionsAdditionalContentExclusionPolicyRule` type.
+ * Single content-exclusion rule supplied to `sessions.open` options, with paths, match conditions, and source.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionOpenOptionsAdditionalContentExclusionPolicyRule".
@@ -11000,7 +11580,7 @@ export interface SessionOpenOptionsAdditionalContentExclusionPolicyRule {
     source: SessionOpenOptionsAdditionalContentExclusionPolicyRuleSource;
 }
 /**
- * Schema for the `SessionOpenOptionsAdditionalContentExclusionPolicyRuleSource` type.
+ * Source descriptor for a `sessions.open` content-exclusion rule, with source name and type.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionOpenOptionsAdditionalContentExclusionPolicyRuleSource".
@@ -11172,7 +11752,7 @@ export interface SessionOpenResult {
     progress?: SessionsOpenProgress[];
 }
 /**
- * Schema for the `SessionsOpenProgress` type.
+ * `sessions.open` handoff progress update with step, status, and optional message.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionsOpenProgress".
@@ -11316,6 +11896,134 @@ export interface SessionSetCredentialsResult {
      */
     copilotUserResolved?: boolean;
 }
+/**
+ * Availability of built-in job tools surfaced to boundary consumers.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionSettingsBuiltInToolAvailabilitySnapshot".
+ */
+/** @experimental */
+export interface SessionSettingsBuiltInToolAvailabilitySnapshot {
+    reportProgress?: boolean;
+    createPullRequest?: boolean;
+}
+/**
+ * Named Rust-owned settings predicate to evaluate for this session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionSettingsEvaluatePredicateRequest".
+ */
+/** @experimental */
+export interface SessionSettingsEvaluatePredicateRequest {
+    name: SessionSettingsPredicateName;
+    /**
+     * Tool name for tool-scoped predicates such as trivial-change handling.
+     */
+    toolName?: string;
+}
+/**
+ * Result of evaluating a Rust-owned settings predicate.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionSettingsEvaluatePredicateResult".
+ */
+/** @experimental */
+export interface SessionSettingsEvaluatePredicateResult {
+    enabled: boolean;
+}
+/**
+ * Redacted job settings for a session. The job nonce is excluded.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionSettingsJobSnapshot".
+ */
+/** @experimental */
+export interface SessionSettingsJobSnapshot {
+    eventType?: string;
+    isTriggerJob?: boolean;
+    builtInToolAvailability?: SessionSettingsBuiltInToolAvailabilitySnapshot;
+}
+/**
+ * Redacted model routing settings for a session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionSettingsModelSnapshot".
+ */
+/** @experimental */
+export interface SessionSettingsModelSnapshot {
+    model?: string;
+    defaultReasoningEffort?: string;
+    instanceId?: string;
+    callbackUrl?: string;
+}
+/**
+ * Online-evaluation settings safe to expose across the SDK boundary.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionSettingsOnlineEvaluationSnapshot".
+ */
+/** @experimental */
+export interface SessionSettingsOnlineEvaluationSnapshot {
+    disableOnlineEvaluation?: boolean;
+    enableOnlineEvaluationOutputFile?: boolean;
+}
+/**
+ * Redacted repository and GitHub host settings for a session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionSettingsRepoSnapshot".
+ */
+/** @experimental */
+export interface SessionSettingsRepoSnapshot {
+    name?: string;
+    id?: number;
+    branch?: string;
+    commit?: string;
+    readWrite?: boolean;
+    ownerName?: string;
+    ownerId?: number;
+    serverUrl?: string;
+    host?: string;
+    hostProtocol?: string;
+    secretScanningUrl?: string;
+    prCommitCount?: number;
+}
+/**
+ * Redacted, serializable view of session runtime settings for SDK boundary consumers. Secrets and raw feature flags are intentionally excluded.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionSettingsSnapshot".
+ */
+/** @experimental */
+export interface SessionSettingsSnapshot {
+    version?: string;
+    clientName?: string;
+    timeoutMs?: number;
+    startTimeMs?: number;
+    repo: SessionSettingsRepoSnapshot;
+    model: SessionSettingsModelSnapshot;
+    validation: SessionSettingsValidationSnapshot;
+    job: SessionSettingsJobSnapshot;
+    onlineEvaluation: SessionSettingsOnlineEvaluationSnapshot;
+}
+/**
+ * Redacted validation and memory-tool settings for a session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionSettingsValidationSnapshot".
+ */
+/** @experimental */
+export interface SessionSettingsValidationSnapshot {
+    timeout?: number;
+    dependabotTimeout?: number;
+    codeqlEnabled?: boolean;
+    codeReviewEnabled?: boolean;
+    codeReviewModel?: string;
+    advisoryEnabled?: boolean;
+    secretScanningEnabled?: boolean;
+    memoryStoreEnabled?: boolean;
+    memoryVoteEnabled?: boolean;
+}
 /**
  * UUID prefix to resolve to a unique session ID.
  *
@@ -11558,17 +12266,6 @@ export interface SessionsLoadDeferredRepoHooksRequest {
      */
     sessionId: string;
 }
-/** @experimental */
-export interface SessionsPollSpawnedSessionsRequest {
-    /**
-     * Opaque cursor returned by a previous poll. Omit on the first call to receive any spawn events buffered since the runtime started.
-     */
-    cursor?: string;
-    /**
-     * Milliseconds to wait for new spawn events when the cursor is at the tail. 0 (default) returns immediately even if no events are buffered. Capped at 60000ms.
-     */
-    waitMs?: number;
-}
 /**
  * Age threshold and optional flags controlling which old sessions are pruned (or simulated when dryRun is true).
  *
@@ -11772,6 +12469,7 @@ export interface SessionUpdateOptionsParams {
      */
     reasoningEffort?: string;
     reasoningSummary?: OptionsUpdateReasoningSummary;
+    verbosity?: Verbosity;
     /**
      * Identifier of the client driving the session.
      */
@@ -12074,7 +12772,7 @@ export interface ShutdownRequest {
     reason?: string;
 }
 /**
- * Schema for the `Skill` type.
+ * Skill metadata available to a session, with name, description, source, enabled/invocable state, path, plugin, and argument hint.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "Skill".
@@ -12112,7 +12810,7 @@ export interface Skill {
     argumentHint?: string;
 }
 /**
- * Schema for the `SkillDiscoveryPath` type.
+ * Canonical directory where skills can be discovered or created, with scope, preference, and optional project path.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SkillDiscoveryPath".
@@ -12250,7 +12948,7 @@ export interface SkillsGetInvokedResult {
     skills: SkillsInvokedSkill[];
 }
 /**
- * Schema for the `SkillsInvokedSkill` type.
+ * Skill invocation record with name, path, content, allowed tools, and turn number.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SkillsInvokedSkill".
@@ -12296,7 +12994,7 @@ export interface SkillsLoadDiagnostics {
     errors: string[];
 }
 /**
- * Schema for the `SlashCommandAgentPromptResult` type.
+ * Slash-command invocation result that submits an agent prompt, with display prompt, optional mode, and settings-change flag.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SlashCommandAgentPromptResult".
@@ -12322,7 +13020,7 @@ export interface SlashCommandAgentPromptResult {
     runtimeSettingsChanged?: boolean;
 }
 /**
- * Schema for the `SlashCommandCompletedResult` type.
+ * Slash-command invocation result indicating completion, with optional message and settings-change flag.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SlashCommandCompletedResult".
@@ -12343,7 +13041,7 @@ export interface SlashCommandCompletedResult {
     runtimeSettingsChanged?: boolean;
 }
 /**
- * Schema for the `SlashCommandTextResult` type.
+ * Slash-command invocation result containing text output plus Markdown/ANSI rendering flags.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SlashCommandTextResult".
@@ -12372,7 +13070,7 @@ export interface SlashCommandTextResult {
     runtimeSettingsChanged?: boolean;
 }
 /**
- * Schema for the `SlashCommandSelectSubcommandResult` type.
+ * Slash-command invocation result asking the client to present subcommand options for a parent command.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SlashCommandSelectSubcommandResult".
@@ -12401,7 +13099,7 @@ export interface SlashCommandSelectSubcommandResult {
     runtimeSettingsChanged?: boolean;
 }
 /**
- * Schema for the `SlashCommandSelectSubcommandOption` type.
+ * Selectable slash-command subcommand option with name, description, and optional group label.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SlashCommandSelectSubcommandOption".
@@ -12440,7 +13138,7 @@ export interface SubagentSettingsEntry {
     contextTier?: SubagentSettingsEntryContextTier;
 }
 /**
- * Schema for the `TaskAgentInfo` type.
+ * Tracked background agent task metadata, including IDs, status, timing, agent type, prompt, model, result, and latest response.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "TaskAgentInfo".
@@ -12519,7 +13217,7 @@ export interface TaskAgentInfo {
     idleSince?: string;
 }
 /**
- * Schema for the `TaskAgentProgress` type.
+ * Progress snapshot for an agent task, with recent activity lines and optional latest intent.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "TaskAgentProgress".
@@ -12540,7 +13238,7 @@ export interface TaskAgentProgress {
     latestIntent?: string;
 }
 /**
- * Schema for the `TaskProgressLine` type.
+ * Timestamped display line for task progress output or recent agent activity.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "TaskProgressLine".
@@ -12557,7 +13255,7 @@ export interface TaskProgressLine {
     timestamp: string;
 }
 /**
- * Schema for the `TaskShellInfo` type.
+ * Tracked shell task metadata, including ID, command, status, timing, attachment/execution mode, log path, and PID.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "TaskShellInfo".
@@ -12618,7 +13316,7 @@ export interface TaskList {
     tasks: TaskInfo[];
 }
 /**
- * Schema for the `TaskShellProgress` type.
+ * Progress snapshot for a shell task, with recent stdout/stderr output and optional process ID.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "TaskShellProgress".
@@ -12876,7 +13574,7 @@ export interface TelemetrySetFeatureOverridesRequest {
     };
 }
 /**
- * Schema for the `Tool` type.
+ * Built-in tool metadata with identifier, optional namespaced name, description, input-parameter schema, and usage instructions.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "Tool".
@@ -13011,7 +13709,7 @@ export interface UIElicitationArrayAnyOfFieldItems {
     anyOf: UIElicitationArrayAnyOfFieldItemsAnyOf[];
 }
 /**
- * Schema for the `UIElicitationArrayAnyOfFieldItemsAnyOf` type.
+ * Selectable option for a UI elicitation multi-select array item, with submitted value and display label.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "UIElicitationArrayAnyOfFieldItemsAnyOf".
@@ -13178,7 +13876,7 @@ export interface UIElicitationStringOneOfField {
     default?: string;
 }
 /**
- * Schema for the `UIElicitationStringOneOfFieldOneOf` type.
+ * Selectable option for a UI elicitation single-select string field, with submitted value and display label.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "UIElicitationStringOneOfFieldOneOf".
@@ -13344,7 +14042,7 @@ export interface UIEphemeralQueryResult {
     answer: string;
 }
 /**
- * Schema for the `UIExitPlanModeResponse` type.
+ * User response for a pending exit-plan-mode request, with approval state, selected action, auto-approve flag, and feedback.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "UIExitPlanModeResponse".
@@ -13491,7 +14189,7 @@ export interface UIHandlePendingUserInputRequest {
     response: UIUserInputResponse;
 }
 /**
- * Schema for the `UIUserInputResponse` type.
+ * User response for a pending user-input request, with answer text and whether it was typed freeform.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "UIUserInputResponse".
@@ -13614,7 +14312,7 @@ export interface UsageGetMetricsResult {
     lastCallOutputTokens: number;
 }
 /**
- * Schema for the `UsageMetricsTokenDetail` type.
+ * Session-wide token-detail entry containing the accumulated token count for one token type.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "UsageMetricsTokenDetail".
@@ -13652,7 +14350,7 @@ export interface UsageMetricsCodeChanges {
     filesModified: string[];
 }
 /**
- * Schema for the `UsageMetricsModelMetric` type.
+ * Per-model usage metrics, including request counts/costs, token usage, nano-AI units, and per-token-type details.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "UsageMetricsModelMetric".
@@ -13719,7 +14417,7 @@ export interface UsageMetricsModelMetricUsage {
     reasoningTokens?: number;
 }
 /**
- * Schema for the `UsageMetricsModelMetricTokenDetail` type.
+ * Per-model token-detail entry containing the accumulated token count for one token type.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "UsageMetricsModelMetricTokenDetail".
@@ -13924,7 +14622,7 @@ export interface WorkspaceDiffResult {
     isFallback: boolean;
 }
 /**
- * Schema for the `WorkspacesCheckpoints` type.
+ * Workspace checkpoint metadata with assigned number, human-readable title, and checkpoint filename.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "WorkspacesCheckpoints".
@@ -14760,6 +15458,17 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         setCredentials: (params: SessionSetCredentialsParams) => Promise<SessionSetCredentialsResult>;
     };
     /** @experimental */
+    debug: {
+        /**
+         * Collects a redacted session debug log bundle into a local archive or staging directory. The runtime includes session-owned logs by default and accepts caller-provided diagnostic entries so host applications can add their own files without changing this API shape.
+         *
+         * @param params Options for collecting a redacted session debug bundle.
+         *
+         * @returns Result of collecting a redacted debug bundle.
+         */
+        collectLogs: (params: DebugCollectLogsRequest) => Promise<DebugCollectLogsResult>;
+    };
+    /** @experimental */
     canvas: {
         /**
          * Lists canvases declared for the session.
@@ -15598,17 +16307,17 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          */
         setApproveAll: (params: PermissionsSetApproveAllRequest) => Promise<PermissionsSetApproveAllResult>;
         /**
-         * Enables or disables full allow-all permissions (tools, paths, and URLs) for the session. Used by attach-mode clients (e.g. LocalRpcSession's `/allow-all` forwarder) to flip the target session's permission state. Unlike `setApproveAll`, this swaps in the unrestricted path and URL managers and emits `session.permissions_changed` on transition. The result returns the authoritative post-mutation state so callers can update their local mirrors without racing the `session.permissions_changed` notification on the same wire.
+         * Sets the allow-all permission mode for the session. Used by attach-mode clients (e.g. LocalRpcSession's `/allow-all` forwarder) to flip the target session's permission state. The `on` mode swaps in unrestricted path and URL managers and emits `session.permissions_changed` on transition; the `auto` mode keeps normal prompt paths active while attaching LLM safety recommendations. The result returns the authoritative post-mutation state so callers can update their local mirrors without racing the `session.permissions_changed` notification on the same wire.
          *
-         * @param params Whether to enable full allow-all permissions for the session.
+         * @param params Allow-all mode to apply for the session.
          *
          * @returns Indicates whether the operation succeeded and reports the post-mutation state.
          */
         setAllowAll: (params: PermissionsSetAllowAllRequest) => Promise<AllowAllPermissionSetResult>;
         /**
-         * Returns whether full allow-all permissions are currently active for the session.
+         * Returns the current allow-all permission mode for the session.
          *
-         * @returns Current full allow-all permission state.
+         * @returns Current allow-all permission mode.
          */
         getAllowAll: () => Promise<AllowAllPermissionState>;
         /**
@@ -15778,6 +16487,20 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Token breakdown for the session's current context window, or null if uninitialized.
          */
         contextInfo: (params: MetadataContextInfoRequest) => Promise<MetadataContextInfoResult>;
+        /**
+         * Returns the experimental per-source attribution breakdown of the session's current context window as a flat list of entries (skills, subagents, MCP servers, built-in tools, plugin rollups, system/tool-definition costs, with nesting via parentId), plus the successful compaction count. The heaviest individual messages are available separately via `metadata.getContextHeaviestMessages`. Returns null until the session has initialized its system prompt and tool metadata.
+         *
+         * @returns Per-source attribution breakdown for the session's current context window, or null if uninitialized.
+         */
+        getContextAttribution: () => Promise<MetadataContextAttributionResult>;
+        /**
+         * Returns the largest individual messages currently in the session's context window, most-expensive first. Companion to `metadata.getContextAttribution`. Returns an empty list until the session has initialized.
+         *
+         * @param params Parameters for the heaviest-messages query.
+         *
+         * @returns The heaviest individual messages in the session's context window, most-expensive first.
+         */
+        getContextHeaviestMessages: (params: MetadataContextHeaviestMessagesRequest) => Promise<MetadataContextHeaviestMessagesResult>;
         /**
          * Records a working-directory/git context change and emits a `session.context_changed` event.
          *
@@ -16169,9 +16892,9 @@ export interface LlmInferenceHandler {
 /** @experimental */
 export interface GitHubTelemetryHandler {
     /**
-     * Forwards a single GitHub telemetry event to a host connection that opted into telemetry forwarding for the session.
+     * Forwards a single GitHub telemetry event to a host connection that opted into telemetry forwarding during the `server.connect` handshake. Opted-in connections receive every event the runtime emits after the handshake — across all sessions, plus sessionless events (for example, `server.sendTelemetry` calls with no session id).
      *
-     * @param params Payload for a `gitHubTelemetry.event` notification: a single GitHub telemetry event the runtime forwards to a host connection that opted into telemetry forwarding for the session.
+     * @param params Payload for a `gitHubTelemetry.event` notification: a single GitHub telemetry event the runtime forwards to a host connection that opted into telemetry forwarding during the `server.connect` handshake.
      */
     event(params: GitHubTelemetryNotification): Promise<void>;
 }