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

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
  *
@@ -1179,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".
@@ -1536,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.
  *
@@ -1672,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".
@@ -1714,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".
@@ -1881,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".
@@ -1895,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".
@@ -1924,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;
     } | ({
@@ -1946,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".
@@ -1982,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".
@@ -2008,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".
@@ -2101,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".
@@ -2123,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".
@@ -2141,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".
@@ -2163,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".
@@ -2189,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".
@@ -2247,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".
@@ -2345,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".
@@ -2393,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".
@@ -2740,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".
@@ -2756,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.
@@ -3155,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".
@@ -3315,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".
@@ -3332,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".
@@ -3593,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".
@@ -3747,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".
@@ -4263,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".
@@ -4271,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.
      */
@@ -4449,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".
@@ -4483,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".
@@ -4499,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".
@@ -4515,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".
@@ -4558,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".
@@ -4641,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".
@@ -4761,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.
@@ -4876,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".
@@ -5089,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".
@@ -5140,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".
@@ -5355,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".
@@ -5743,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".
@@ -5918,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".
@@ -6013,26 +6479,31 @@ export interface McpOauthLoginResult {
     authorizationUrl?: string;
 }
 /**
- * Empty result after recording the MCP OAuth response.
+ * Indicates whether the auto-managed `github` MCP server was removed (false when nothing to remove).
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "McpOauthRespondResult".
+ * via the `definition` "McpRemoveGitHubResult".
  */
 /** @experimental */
-export interface McpOauthRespondResult {
+export interface McpRemoveGitHubResult {
+    /**
+     * True when the auto-managed `github` MCP server was removed; false when no removal happened (e.g. user has explicitly configured a `github` server, or the server was not registered).
+     */
+    removed: boolean;
 }
 /**
- * Indicates whether the auto-managed `github` MCP server was removed (false when nothing to remove).
+ * Server name and optional replacement configuration for an individual MCP server restart. Omit `config` for a config-free restart-by-name of an already-configured server.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "McpRemoveGitHubResult".
+ * via the `definition` "McpRestartServerRequest".
  */
 /** @experimental */
-export interface McpRemoveGitHubResult {
+export interface McpRestartServerRequest {
     /**
-     * True when the auto-managed `github` MCP server was removed; false when no removal happened (e.g. user has explicitly configured a `github` server, or the server was not registered).
+     * Name of the MCP server to restart
      */
-    removed: boolean;
+    serverName: string;
+    config?: McpServerConfig;
 }
 /**
  * Outcome of an MCP sampling execution: success result, failure error, or cancellation.
@@ -6050,7 +6521,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".
@@ -6110,6 +6581,20 @@ export interface McpSetEnvValueModeParams {
 export interface McpSetEnvValueModeResult {
     mode: McpSetEnvValueModeDetails;
 }
+/**
+ * Server name and configuration for an individual MCP server start.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpStartServerRequest".
+ */
+/** @experimental */
+export interface McpStartServerRequest {
+    /**
+     * Name of the MCP server to start
+     */
+    serverName: string;
+    config: McpServerConfig;
+}
 /**
  * MCP server startup filtering result.
  *
@@ -6401,7 +6886,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".
@@ -6765,6 +7250,7 @@ export interface ModelSwitchToRequest {
      */
     reasoningEffort?: string;
     reasoningSummary?: ReasoningSummary;
+    verbosity?: Verbosity;
     modelCapabilities?: ModelCapabilitiesOverride;
     contextTier?: ContextTier;
 }
@@ -6896,7 +7382,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".
@@ -6908,7 +7394,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".
@@ -6921,7 +7407,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".
@@ -6932,7 +7418,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".
@@ -6959,7 +7445,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".
@@ -6972,7 +7458,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".
@@ -6990,7 +7476,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".
@@ -7007,7 +7493,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".
@@ -7020,7 +7506,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".
@@ -7033,7 +7519,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".
@@ -7054,7 +7540,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".
@@ -7071,7 +7557,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".
@@ -7084,7 +7570,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".
@@ -7101,7 +7587,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".
@@ -7118,7 +7604,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".
@@ -7135,7 +7621,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".
@@ -7153,7 +7639,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".
@@ -7170,7 +7656,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".
@@ -7183,7 +7669,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".
@@ -7196,7 +7682,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".
@@ -7217,7 +7703,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".
@@ -7234,7 +7720,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".
@@ -7247,7 +7733,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".
@@ -7264,7 +7750,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".
@@ -7281,7 +7767,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".
@@ -7298,7 +7784,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".
@@ -7315,7 +7801,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".
@@ -7332,7 +7818,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".
@@ -7345,7 +7831,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".
@@ -7358,7 +7844,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".
@@ -7372,7 +7858,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".
@@ -7390,7 +7876,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".
@@ -7407,7 +7893,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".
@@ -7424,7 +7910,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".
@@ -7437,7 +7923,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".
@@ -7458,7 +7944,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".
@@ -7479,7 +7965,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".
@@ -7528,7 +8014,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".
@@ -7545,7 +8031,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".
@@ -7558,7 +8044,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".
@@ -7571,7 +8057,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".
@@ -7592,7 +8078,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".
@@ -7609,7 +8095,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".
@@ -7622,7 +8108,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".
@@ -7639,7 +8125,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".
@@ -7656,7 +8142,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".
@@ -7906,7 +8392,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".
@@ -7918,7 +8404,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".
@@ -7931,7 +8417,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".
@@ -8145,17 +8631,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;
 }
 /**
@@ -8378,7 +8869,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".
@@ -8563,6 +9054,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`.
      */
@@ -8599,7 +9094,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".
@@ -9351,7 +9846,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".
@@ -9403,7 +9898,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;
 }
@@ -9836,14 +10331,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.
@@ -9882,7 +10369,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".
@@ -10009,6 +10496,81 @@ export interface SendAttachmentsToMessageParams {
      */
     attachments: PushAttachment[];
 }
+/**
+ * A single user message to append to the session as part of a `session.sendMessages` turn
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SendMessageItem".
+ */
+/** @experimental */
+export interface SendMessageItem {
+    /**
+     * The user message text
+     */
+    prompt: string;
+    /**
+     * If provided, this is shown in the timeline instead of `prompt`
+     */
+    displayPrompt?: string;
+    /**
+     * Optional attachments (files, directories, selections, blobs, GitHub references) to include with this message
+     */
+    attachments?: Attachment[];
+    /**
+     * If set, the request will fail if the named tool is not available when this message is among the user messages at the start of the current exchange
+     */
+    requiredTool?: string;
+}
+/**
+ * Parameters for sending zero or more user messages to the session in a single turn. Remote-backed (Mission Control) sessions do not support this method and will return an error.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SendMessagesRequest".
+ */
+/** @experimental */
+export interface SendMessagesRequest {
+    /**
+     * The user messages to append to the conversation, in order. May be empty, in which case a single turn runs over the existing history with no new user message.
+     */
+    messages: SendMessageItem[];
+    mode?: SendMode;
+    /**
+     * If true, adds the messages to the front of the queue instead of the end
+     */
+    prepend?: boolean;
+    agentMode?: SendAgentMode;
+    /**
+     * Custom HTTP headers to include in outbound model requests for this turn. Merged with session-level provider headers; per-turn headers augment and overwrite session-level headers with the same key.
+     */
+    requestHeaders?: {
+        [k: string]: string | undefined;
+    };
+    /**
+     * W3C Trace Context traceparent header for distributed tracing of this agent turn
+     */
+    traceparent?: string;
+    /**
+     * W3C Trace Context tracestate header for distributed tracing
+     */
+    tracestate?: string;
+    /**
+     * If true, await completion of the agentic loop for this turn before returning. Defaults to false (fire-and-forget). When true, the result still contains the same `messageIds`; the caller can rely on the agent having processed the messages before the call resolves.
+     */
+    wait?: boolean;
+}
+/**
+ * Result of sending zero or more user messages
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SendMessagesResult".
+ */
+/** @experimental */
+export interface SendMessagesResult {
+    /**
+     * Unique identifiers assigned to the messages, one per provided message in order. Empty when no messages were provided.
+     */
+    messageIds: string[];
+}
 /**
  * Parameters for sending a user message to the session
  *
@@ -10102,7 +10664,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".
@@ -10353,7 +10915,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".
@@ -10657,7 +11219,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".
@@ -10691,7 +11253,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".
@@ -10707,7 +11269,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".
@@ -10723,7 +11285,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".
@@ -10898,6 +11460,7 @@ export interface SessionOpenOptions {
      */
     reasoningEffort?: string;
     reasoningSummary?: SessionOpenOptionsReasoningSummary;
+    verbosity?: Verbosity;
     /**
      * Identifier of the client driving the session.
      */
@@ -10914,6 +11477,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.
      */
@@ -11091,7 +11658,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".
@@ -11103,7 +11670,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".
@@ -11116,7 +11683,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".
@@ -11288,7 +11855,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".
@@ -11432,6 +11999,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.
  *
@@ -11877,6 +12572,7 @@ export interface SessionUpdateOptionsParams {
      */
     reasoningEffort?: string;
     reasoningSummary?: OptionsUpdateReasoningSummary;
+    verbosity?: Verbosity;
     /**
      * Identifier of the client driving the session.
      */
@@ -12179,7 +12875,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".
@@ -12217,7 +12913,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".
@@ -12355,7 +13051,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".
@@ -12401,7 +13097,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".
@@ -12427,7 +13123,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".
@@ -12448,7 +13144,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".
@@ -12477,7 +13173,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".
@@ -12506,7 +13202,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".
@@ -12545,7 +13241,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".
@@ -12624,7 +13320,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".
@@ -12645,7 +13341,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".
@@ -12662,7 +13358,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".
@@ -12723,7 +13419,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".
@@ -12981,7 +13677,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".
@@ -13116,7 +13812,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".
@@ -13283,7 +13979,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".
@@ -13449,7 +14145,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".
@@ -13596,7 +14292,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".
@@ -13719,7 +14415,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".
@@ -13757,7 +14453,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".
@@ -13824,7 +14520,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".
@@ -14029,7 +14725,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".
@@ -14550,6 +15246,15 @@ export declare function createServerRpc(connection: MessageConnection): {
         getDiscoveryPaths: (params: InstructionsGetDiscoveryPathsRequest) => Promise<InstructionDiscoveryPathList>;
     };
     /** @experimental */
+    commands: {
+        /**
+         * Lists the well-known built-in slash commands that work as the first message in a new session (e.g. /plan, /env), without requiring an active session. Commands that depend on session state, authentication, or a synced session are omitted.
+         *
+         * @returns Slash commands available in the session, after applying any include/exclude filters.
+         */
+        list: () => Promise<CommandList>;
+    };
+    /** @experimental */
     user: {
         /** @experimental */
         settings: {
@@ -14829,6 +15534,16 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
      * @experimental
      */
     send: (params: SendRequest) => Promise<SendResult>;
+    /**
+     * Sends zero or more user messages to the session in a single turn and returns their message IDs. All provided messages are appended to the conversation in order, then exactly one agent turn runs over the resulting history. When the list is empty, one turn runs over the existing history with no new user message. Remote-backed (Mission Control) sessions do not support this method and will return an error.
+     *
+     * @param params Parameters for sending zero or more user messages to the session in a single turn. Remote-backed (Mission Control) sessions do not support this method and will return an error.
+     *
+     * @returns Result of sending zero or more user messages
+     *
+     * @experimental
+     */
+    sendMessages: (params: SendMessagesRequest) => Promise<SendMessagesResult>;
     /**
      * Aborts the current agent turn.
      *
@@ -14865,6 +15580,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.
@@ -15315,6 +16041,18 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Indicates whether the auto-managed `github` MCP server was removed (false when nothing to remove).
          */
         removeGitHub: () => Promise<McpRemoveGitHubResult>;
+        /**
+         * Starts an individual MCP server on the live session from a caller-supplied config. Session-scoped and ephemeral: the server is added to this session's running set only and is reaped when the session ends. Does NOT modify persistent user configuration (`mcp.config.*`), so it does not affect future sessions. The server surfaces through `session.mcp.list` and the `session.mcp_servers_loaded` / `session.mcp_server_status_changed` events like any other server.
+         *
+         * @param params Server name and configuration for an individual MCP server start.
+         */
+        startServer: (params: McpStartServerRequest) => Promise<void>;
+        /**
+         * Restarts an individual MCP server on the live session (stops then starts). Omit `config` for a config-free restart-by-name of an already-configured server; supply `config` to restart with a replacement configuration. Session-scoped and ephemeral: does NOT modify persistent user configuration (`mcp.config.*`).
+         *
+         * @param params Server name and optional replacement configuration for an individual MCP server restart. Omit `config` for a config-free restart-by-name of an already-configured server.
+         */
+        restartServer: (params: McpRestartServerRequest) => Promise<void>;
         /**
          * Stops an individual MCP server on the session's host.
          *
@@ -15703,17 +16441,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>;
         /**
@@ -16288,9 +17026,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>;
 }