@github/copilot-sdk 1.0.1 → 1.0.2

package/dist/generated/rpc.d.ts

@@ -4,6 +4,18 @@
  */
 import type { MessageConnection } from "vscode-jsonrpc/node.js";
 import type { AbortReason, Attachment, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpServerSource, McpServerStatus, PermissionPromptRequest, PermissionRule, ReasoningSummary, SessionEvent, SessionMode, ShutdownType, SkillSource, UserToolSessionApproval } from "./session-events.js";
+/**
+ * Which tier this directory belongs to
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AgentDiscoveryPathScope".
+ */
+/** @experimental */
+export type AgentDiscoveryPathScope = 
+/** The user's personal agent configuration directory. */
+"user"
+/** A project's repository agent directory. */
+ | "project";
 /**
  * Where the agent definition was loaded from
  *
@@ -299,7 +311,7 @@ export type EventsCursorStatus =
 /** The cursor referred to history that is no longer available. */
  | "expired";
 /**
- * Discovery source: project (.github/extensions/) or user (~/.copilot/extensions/)
+ * Discovery source: project (.github/extensions/), user (~/.copilot/extensions/), plugin (installed plugin), or session (session-state/<id>/extensions/)
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ExtensionSource".
@@ -309,7 +321,11 @@ export type ExtensionSource =
 /** Extension discovered from the current project's .github/extensions directory. */
 "project"
 /** Extension discovered from the user's ~/.copilot/extensions directory. */
- | "user";
+ | "user"
+/** Extension contributed by an installed plugin. */
+ | "plugin"
+/** Extension discovered from the current session's state directory (loaded only for this session). */
+ | "session";
 /**
  * Current status: running, disabled, failed, or starting
  *
@@ -391,6 +407,34 @@ export type FilterMapping = {
  */
 /** @experimental */
 export type InstalledPluginSource = string | InstalledPluginSourceGitHub | InstalledPluginSourceUrl | InstalledPluginSourceLocal;
+/**
+ * Which tier this target belongs to
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "InstructionDiscoveryPathLocation".
+ */
+/** @experimental */
+export type InstructionDiscoveryPathLocation = 
+/** Instructions live in user-level configuration. */
+"user"
+/** Instructions live in repository-level configuration. */
+ | "repository"
+/** Instructions live under the current working directory. */
+ | "working-directory"
+/** Instructions live in plugin-provided configuration. */
+ | "plugin";
+/**
+ * Whether the target is a single file or a directory of instruction files
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "InstructionDiscoveryPathKind".
+ */
+/** @experimental */
+export type InstructionDiscoveryPathKind = 
+/** The target is a single instruction file. */
+"file"
+/** The target is a directory that holds instruction files. */
+ | "directory";
 /**
  * Category of instruction source — used for merge logic
  *
@@ -577,6 +621,17 @@ export type McpServerConfig = McpServerConfigStdio | McpServerConfigHttp;
  * via the `definition` "McpServerAuthConfig".
  */
 export type McpServerAuthConfig = boolean | McpServerAuthConfigRedirectPort;
+/**
+ * Controls if tools provided by this server can be loaded on demand via tool search (auto) or always included in the initial tool list (never)
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpServerConfigDeferTools".
+ */
+export type McpServerConfigDeferTools = 
+/** Tools may be deferred under certain conditions */
+"auto"
+/** Tools are always included in the initial tool list, even when tool search is enabled. */
+ | "never";
 /**
  * Remote transport type. Defaults to "http" when omitted.
  *
@@ -753,6 +808,32 @@ export type ModelPickerPriceCategory =
  | "high"
 /** Highest relative token cost tier. */
  | "very_high";
+/**
+ * Provider type. Defaults to "openai" for generic OpenAI-compatible APIs.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ProviderConfigType".
+ */
+/** @experimental */
+export type ProviderConfigType = 
+/** Generic OpenAI-compatible API. */
+"openai"
+/** Azure OpenAI Service endpoint. */
+ | "azure"
+/** Anthropic API endpoint. */
+ | "anthropic";
+/**
+ * Wire API format (openai/azure only). Defaults to "completions".
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ProviderConfigWireApi".
+ */
+/** @experimental */
+export type ProviderConfigWireApi = 
+/** OpenAI Chat Completions wire format. */
+"completions"
+/** OpenAI Responses API wire format. */
+ | "responses";
 /**
  * Allowed values for the `OptionsUpdateAdditionalContentExclusionPolicyScope` enumeration.
  *
@@ -916,30 +997,30 @@ export type PermissionsSetApproveAllSource =
 /** Allow-all was enabled through an RPC caller. */
  | "rpc";
 /**
- * Provider type. Defaults to "openai" for generic OpenAI-compatible APIs.
+ * Provider family. Matches the `type` field of a BYOK provider config.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ProviderConfigType".
+ * via the `definition` "ProviderEndpointType".
  */
 /** @experimental */
-export type ProviderConfigType = 
-/** Generic OpenAI-compatible API. */
+export type ProviderEndpointType = 
+/** OpenAI-compatible endpoint (use the OpenAI client library). */
 "openai"
-/** Azure OpenAI Service endpoint. */
+/** Azure OpenAI endpoint (use the OpenAI client library with the Azure base URL). */
  | "azure"
-/** Anthropic API endpoint. */
+/** Anthropic endpoint (use the Anthropic client library). */
  | "anthropic";
 /**
- * Wire API format (openai/azure only). Defaults to "completions".
+ * Wire API to be used, when required for the provider type.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ProviderConfigWireApi".
+ * via the `definition` "ProviderEndpointWireApi".
  */
 /** @experimental */
-export type ProviderConfigWireApi = 
-/** OpenAI Chat Completions wire format. */
+export type ProviderEndpointWireApi = 
+/** Classic chat-completions request shape. */
 "completions"
-/** OpenAI Responses API wire format. */
+/** Newer responses request shape. */
  | "responses";
 /**
  * Schema for the `PushAttachment` type.
@@ -1326,6 +1407,22 @@ export type ShellKillSignal =
  | "SIGKILL"
 /** Send an interrupt signal to the process. */
  | "SIGINT";
+/**
+ * Which tier this directory belongs to
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SkillDiscoveryScope".
+ */
+/** @experimental */
+export type SkillDiscoveryScope = 
+/** A project's repository skill directory. */
+"project"
+/** The user's personal Copilot skill directory. */
+ | "personal-copilot"
+/** The user's personal agents skill directory. */
+ | "personal-agents"
+/** A configured custom skill directory. */
+ | "custom";
 /**
  * Result of invoking the slash command (text output, prompt to send to the agent, or completion).
  *
@@ -1334,6 +1431,39 @@ export type ShellKillSignal =
  */
 /** @experimental */
 export type SlashCommandInvocationResult = SlashCommandTextResult | SlashCommandAgentPromptResult | SlashCommandCompletedResult | SlashCommandSelectSubcommandResult;
+/**
+ * Subagent settings to apply, or null to clear the live session override
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SubagentSettings".
+ */
+/** @experimental */
+export type SubagentSettings = {
+    /**
+     * Per-agent settings keyed by subagent agent_type
+     */
+    agents?: {
+        [k: string]: SubagentSettingsEntry | undefined;
+    };
+    /**
+     * Names of subagents the user has turned off; they cannot be dispatched
+     */
+    disabledSubagents?: string[];
+} | null;
+/**
+ * Context tier override for matching subagents
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SubagentSettingsEntryContextTier".
+ */
+/** @experimental */
+export type SubagentSettingsEntryContextTier = 
+/** Inherit the parent session's effective context tier at dispatch time. */
+"inherit"
+/** Use the model's default context window. */
+ | "default"
+/** Pin the subagent to the long-context tier when supported. */
+ | "long_context";
 /**
  * Current lifecycle status of the task
  *
@@ -1607,6 +1737,41 @@ export interface AccountQuotaSnapshot {
      */
     resetDate?: string;
 }
+/**
+ * Schema for the `AgentDiscoveryPath` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AgentDiscoveryPath".
+ */
+/** @experimental */
+export interface AgentDiscoveryPath {
+    /**
+     * Absolute path of the search/create directory (may not exist on disk yet)
+     */
+    path: string;
+    scope: AgentDiscoveryPathScope;
+    /**
+     * Whether this is the canonical directory to create a new agent in its tier. At most one entry per tier is preferred.
+     */
+    preferredForCreation: boolean;
+    /**
+     * The input project path this directory was derived from (only for project scope)
+     */
+    projectPath?: string;
+}
+/**
+ * Canonical locations where custom agents can be created so the runtime will recognize them.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AgentDiscoveryPathList".
+ */
+/** @experimental */
+export interface AgentDiscoveryPathList {
+    /**
+     * Canonical agent create/discovery directories, in priority order
+     */
+    paths: AgentDiscoveryPath[];
+}
 /**
  * The currently selected custom agent, or null when using the default agent.
  *
@@ -1911,7 +2076,7 @@ export interface AgentsDiscoverRequest {
      */
     projectPaths?: string[];
     /**
-     * When true, omit the host's agents (the `<COPILOT_HOME>/agents` directory and all plugin agents), leaving only project and remote agents. For multitenant deployments.
+     * When true, omit the host's agents (the user-level agent directory and all plugin agents), leaving only project and remote agents. For multitenant deployments.
      */
     excludeHostAgents?: boolean;
 }
@@ -1938,6 +2103,23 @@ export interface AgentSelectRequest {
 export interface AgentSelectResult {
     agent: AgentInfo;
 }
+/**
+ * Optional project paths to include when enumerating agent discovery directories.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AgentsGetDiscoveryPathsRequest".
+ */
+/** @experimental */
+export interface AgentsGetDiscoveryPathsRequest {
+    /**
+     * Optional list of project directory paths. When omitted or empty, only the user-level directory is returned.
+     */
+    projectPaths?: string[];
+    /**
+     * When true, omit the host's user-level agent directory, leaving only project directories. For multitenant deployments (mirrors `discover`'s `excludeHostAgents`).
+     */
+    excludeHostAgents?: boolean;
+}
 /**
  * Indicates whether the operation succeeded and reports the post-mutation state.
  *
@@ -2027,7 +2209,9 @@ export interface CopilotUserResponse {
     quota_reset_date?: string;
     quota_snapshots?: CopilotUserResponseQuotaSnapshots;
     restricted_telemetry?: boolean;
+    is_staff?: boolean;
     token_based_billing?: boolean;
+    can_upgrade_plan?: boolean;
     quota_reset_date_utc?: string;
     limited_user_quotas?: {
         [k: string]: number | undefined;
@@ -2700,6 +2884,10 @@ export interface SlashCommandInfo {
      * Whether the command is experimental
      */
     experimental?: boolean;
+    /**
+     * Whether the command may be the target of `/every` / `/after` schedules. Resolution happens at every tick, so only set this when the command is safe to re-invoke and produces an agent prompt.
+     */
+    schedulable?: boolean;
 }
 /**
  * Optional unstructured input hint
@@ -2999,6 +3187,14 @@ export interface DiscoveredMcpServer {
     name: string;
     type?: DiscoveredMcpServerType;
     source: McpServerSource;
+    /**
+     * Plugin name that provided this server, when source is plugin.
+     */
+    sourcePlugin?: string;
+    /**
+     * Plugin version that provided this server, when source is plugin.
+     */
+    sourcePluginVersion?: string;
     /**
      * Whether the server is enabled (not in the disabled list)
      */
@@ -3140,7 +3336,7 @@ export interface ExecuteCommandResult {
 /** @experimental */
 export interface Extension {
     /**
-     * Source-qualified ID (e.g., 'project:my-ext', 'user:auth-helper')
+     * Source-qualified ID (e.g., 'project:my-ext', 'user:auth-helper', 'plugin:my-plugin:my-ext')
      */
     id: string;
     /**
@@ -3783,6 +3979,42 @@ export interface InstalledPluginInfo {
      */
     enabled: boolean;
 }
+/**
+ * Schema for the `InstructionDiscoveryPath` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "InstructionDiscoveryPath".
+ */
+/** @experimental */
+export interface InstructionDiscoveryPath {
+    /**
+     * Absolute path of the file or directory (may not exist on disk yet)
+     */
+    path: string;
+    location: InstructionDiscoveryPathLocation;
+    kind: InstructionDiscoveryPathKind;
+    /**
+     * Whether this is the canonical target to create new instructions in its tier. At most one entry per tier is preferred.
+     */
+    preferredForCreation: boolean;
+    /**
+     * The input project path this target was derived from (only for repository targets)
+     */
+    projectPath?: string;
+}
+/**
+ * Canonical files and directories where custom instructions can be created so the runtime will recognize them.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "InstructionDiscoveryPathList".
+ */
+/** @experimental */
+export interface InstructionDiscoveryPathList {
+    /**
+     * Canonical instruction create/discovery files and directories, in priority order
+     */
+    paths: InstructionDiscoveryPath[];
+}
 /**
  * Optional project paths to include in instruction discovery.
  *
@@ -3800,6 +4032,23 @@ export interface InstructionsDiscoverRequest {
      */
     excludeHostInstructions?: boolean;
 }
+/**
+ * Optional project paths to include when enumerating instruction discovery targets.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "InstructionsGetDiscoveryPathsRequest".
+ */
+/** @experimental */
+export interface InstructionsGetDiscoveryPathsRequest {
+    /**
+     * Optional list of project directory paths. When omitted or empty, only the user-level targets are returned.
+     */
+    projectPaths?: string[];
+    /**
+     * When true, omit the host's user-level instruction targets, leaving only repository targets. For multitenant deployments (mirrors `discover`'s `excludeHostInstructions`).
+     */
+    excludeHostInstructions?: boolean;
+}
 /**
  * Instruction sources loaded for the session, in merge order.
  *
@@ -4466,6 +4715,7 @@ export interface McpServerConfigStdio {
     timeout?: number;
     oidc?: McpServerAuthConfig;
     auth?: McpServerAuthConfig;
+    deferTools?: McpServerConfigDeferTools;
     /**
      * Executable command used to start the Stdio MCP server process.
      */
@@ -4521,6 +4771,7 @@ export interface McpServerConfigHttp {
     timeout?: number;
     oidc?: McpServerAuthConfig;
     auth?: McpServerAuthConfig;
+    deferTools?: McpServerConfigDeferTools;
     /**
      * URL of the remote MCP server endpoint.
      */
@@ -4963,6 +5214,14 @@ export interface McpServer {
     name: string;
     status: McpServerStatus;
     source?: McpServerSource;
+    /**
+     * Plugin name that provided this server, when source is plugin.
+     */
+    sourcePlugin?: string;
+    /**
+     * Plugin version that provided this server, when source is plugin.
+     */
+    sourcePluginVersion?: string;
     /**
      * Error message if the server failed to connect
      */
@@ -5032,6 +5291,19 @@ export interface McpStopServerRequest {
      */
     serverName: string;
 }
+/**
+ * Memory configuration for this session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "MemoryConfiguration".
+ */
+/** @experimental */
+export interface MemoryConfiguration {
+    /**
+     * Whether memory is enabled for the session.
+     */
+    enabled: boolean;
+}
 /**
  * Model identifier and token limits used to compute the context-info breakdown.
  *
@@ -5412,7 +5684,7 @@ export interface ModelBillingTokenPricesLongContext {
     contextMax?: number;
 }
 /**
- * Initial model capability overrides.
+ * Optional capability overrides (vision, tool_calls, reasoning, etc.).
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "ModelCapabilitiesOverride".
@@ -5548,7 +5820,7 @@ export interface ModelsListRequest {
 /** @experimental */
 export interface ModelSwitchToRequest {
     /**
-     * Model identifier to switch to
+     * Model selection id to switch to, as returned by `list`. A bare id (e.g. `claude-sonnet-4.6`) names a Copilot (CAPI) model; a provider-qualified id (`provider/id`, e.g. `acme/claude-sonnet`) targets a registry BYOK model.
      */
     modelId: string;
     /**
@@ -5582,6 +5854,53 @@ export interface ModelSwitchToResult {
 export interface ModeSetRequest {
     mode: SessionMode;
 }
+/**
+ * A named BYOK provider connection (transport + credentials).
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "NamedProviderConfig".
+ */
+/** @experimental */
+export interface NamedProviderConfig {
+    /**
+     * Stable identifier referenced by BYOK model definitions. Must not contain '/'.
+     */
+    name: string;
+    type?: ProviderConfigType;
+    wireApi?: ProviderConfigWireApi;
+    /**
+     * API endpoint URL.
+     */
+    baseUrl: string;
+    /**
+     * API key. Optional for local providers like Ollama.
+     */
+    apiKey?: string;
+    /**
+     * Bearer token for authentication. Sets the Authorization header directly. Takes precedence over apiKey when both are set.
+     */
+    bearerToken?: string;
+    azure?: ProviderConfigAzure;
+    /**
+     * Custom HTTP headers to include in all outbound requests to the provider.
+     */
+    headers?: {
+        [k: string]: string | undefined;
+    };
+}
+/**
+ * Azure-specific provider options.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ProviderConfigAzure".
+ */
+/** @experimental */
+export interface ProviderConfigAzure {
+    /**
+     * API version. When set, uses the versioned deployment route. When omitted, uses the GA versionless v1 route.
+     */
+    apiVersion?: string;
+}
 /**
  * The session's friendly name, or null when not yet set.
  *
@@ -7043,7 +7362,7 @@ export interface PlanReadSqlTodosResult {
     rows: PlanSqlTodosRow[];
 }
 /**
- * Schema for the `PlanSqlTodosRow` type.
+ * A single todo row read from the session SQL `todos` table. All fields are optional because the SQL schema is best-effort and the agent may not have populated every column.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "PlanSqlTodosRow".
@@ -7067,6 +7386,40 @@ export interface PlanSqlTodosRow {
      */
     status?: string;
 }
+/**
+ * Todo rows + dependency edges read from the session SQL database.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PlanReadSqlTodosWithDependenciesResult".
+ */
+/** @experimental */
+export interface PlanReadSqlTodosWithDependenciesResult {
+    /**
+     * Rows from the session SQL todos table, ordered by creation time and id. Empty when no database, no todos table, or the SELECT failed.
+     */
+    rows: PlanSqlTodosRow[];
+    /**
+     * Edges from the session SQL todo_deps table. Empty when no database, no todo_deps table, or the SELECT failed. Read independently from `rows`, so a broken todo_deps table does not affect the rows result and vice versa.
+     */
+    dependencies: PlanSqlTodoDependency[];
+}
+/**
+ * A single dependency edge read from the session SQL `todo_deps` table, indicating that one todo must complete before another.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PlanSqlTodoDependency".
+ */
+/** @experimental */
+export interface PlanSqlTodoDependency {
+    /**
+     * ID of the todo that has the dependency.
+     */
+    todoId: string;
+    /**
+     * ID of the todo it depends on.
+     */
+    dependsOn: string;
+}
 /**
  * Replacement contents to write to the session plan file.
  *
@@ -7449,17 +7802,110 @@ export interface ProviderConfig {
     };
 }
 /**
- * Azure-specific provider options.
+ * A snapshot of the provider endpoint the session is currently configured to talk to.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ProviderConfigAzure".
+ * via the `definition` "ProviderEndpoint".
  */
 /** @experimental */
-export interface ProviderConfigAzure {
+export interface ProviderEndpoint {
+    type: ProviderEndpointType;
+    wireApi?: ProviderEndpointWireApi;
     /**
-     * API version. When set, uses the versioned deployment route. When omitted, uses the GA versionless v1 route.
+     * Base URL to pass to the LLM client library.
      */
-    apiVersion?: string;
+    baseUrl: string;
+    /**
+     * A credential the caller should use with this endpoint. Omitted only when the endpoint accepts unauthenticated requests.
+     */
+    apiKey?: string;
+    /**
+     * HTTP headers the caller must include on every outbound request.
+     */
+    headers: {
+        [k: string]: string | undefined;
+    };
+    sessionToken?: ProviderSessionToken;
+}
+/**
+ * Short-lived, rotating credential the caller must send on every request, in addition to `apiKey` if one is present. Omitted when the endpoint does not require one.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ProviderSessionToken".
+ */
+/** @experimental */
+export interface ProviderSessionToken {
+    /**
+     * The short-lived token value.
+     */
+    token: string;
+    /**
+     * HTTP header name the token must be sent under.
+     */
+    header: string;
+    /**
+     * The model the token is bound to, when applicable. When set, the token is only valid for requests against this model.
+     */
+    model?: string;
+    /**
+     * When the token expires, if known. Callers should refresh by calling `getEndpoint` again before this time, or reactively on any 401/403 response from `baseUrl`.
+     */
+    expiresAt?: string;
+}
+/**
+ * Optional model identifier to scope the endpoint snapshot to.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ProviderGetEndpointRequest".
+ */
+/** @experimental */
+export interface ProviderGetEndpointRequest {
+    /**
+     * Model identifier the caller intends to use against the returned endpoint. Used to pick the correct wire shape. Omit to use whichever model the session is currently using.
+     */
+    modelId?: string;
+}
+/**
+ * A BYOK model definition referencing a named provider.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ProviderModelConfig".
+ */
+/** @experimental */
+export interface ProviderModelConfig {
+    /**
+     * Provider-local model id, unique within its provider. The session-wide selection id (shown in the model list and passed to switchTo) is the provider-qualified `provider/id`.
+     */
+    id: string;
+    /**
+     * Name of the NamedProviderConfig that serves this model.
+     */
+    provider: string;
+    /**
+     * The model name sent to the provider API for inference. Defaults to `id`.
+     */
+    wireModel?: string;
+    /**
+     * Well-known base model id used for behavior/capability/config lookup. Defaults to `id`.
+     */
+    modelId?: string;
+    /**
+     * Display name for model pickers. Defaults to the provider-qualified selection id (`provider/id`).
+     */
+    name?: string;
+    /**
+     * Maximum prompt/input tokens for the model.
+     */
+    maxPromptTokens?: number;
+    /**
+     * Maximum context window tokens for the model.
+     */
+    maxContextWindowTokens?: number;
+    /**
+     * Maximum output tokens for the model.
+     */
+    maxOutputTokens?: number;
+    capabilities?: ModelCapabilitiesOverride;
 }
 /**
  * File attachment
@@ -9133,7 +9579,7 @@ export interface SessionMetadataSnapshot {
 /** @experimental */
 export interface SessionModelList {
     /**
-     * Available models, ordered with the most preferred default first.
+     * Available models, ordered with the most preferred default first. Includes both Copilot (CAPI) models and any registry BYOK models; a BYOK model appears under its provider-qualified selection id (`provider/id`).
      */
     list: unknown[];
     /**
@@ -9196,6 +9642,18 @@ export interface SessionOpenOptions {
     isExperimentalMode?: boolean;
     authInfo?: AuthInfo;
     provider?: ProviderConfig;
+    /**
+     * Named BYOK provider connections, additive to CAPI auth. Combining with `provider` is rejected.
+     *
+     * @experimental
+     */
+    providers?: NamedProviderConfig[];
+    /**
+     * BYOK model definitions added to the selectable model list, each referencing a provider name.
+     *
+     * @experimental
+     */
+    models?: ProviderModelConfig[];
     /**
      * Working directory to anchor the session.
      */
@@ -9303,6 +9761,10 @@ export interface SessionOpenOptions {
      * Whether on-demand custom instruction discovery is enabled.
      */
     enableOnDemandInstructionDiscovery?: boolean;
+    /**
+     * Maximum decoded byte size of a single inline model-facing binary tool result persisted in session events (default 10 MB).
+     */
+    maxInlineBinaryBytes?: number;
     modelCapabilitiesOverrides?: ModelCapabilitiesOverride;
     /**
      * Runtime context discriminator for agent filtering.
@@ -9322,6 +9784,7 @@ export interface SessionOpenOptions {
      * @experimental
      */
     additionalContentExclusionPolicies?: SessionOpenOptionsAdditionalContentExclusionPolicy[];
+    memory?: MemoryConfiguration;
     /**
      * Capabilities enabled for this session.
      */
@@ -10189,6 +10652,10 @@ export interface SessionUpdateOptionsParams {
      * Whether to discover custom instructions on demand after successful file views (AGENTS.md / CLAUDE.md / .github/copilot-instructions.md surfacing). Combined with `skipCustomInstructions` and the runtime-side `ON_DEMAND_INSTRUCTIONS` feature flag.
      */
     enableOnDemandInstructionDiscovery?: boolean;
+    /**
+     * Maximum decoded byte size of a single model-facing binary tool result (e.g. an image) persisted inline in session events and re-presented to the model on later turns / resume. Larger results are persisted as a metadata-only marker and shown to the model as a short text note. Defaults to 10 MB.
+     */
+    maxInlineBinaryBytes?: number;
     /**
      * Full set of installed plugins for the session. Replaces the existing list; the runtime invalidates the skills cache only when the list materially changes.
      */
@@ -10441,6 +10908,41 @@ export interface Skill {
      */
     pluginName?: string;
 }
+/**
+ * Schema for the `SkillDiscoveryPath` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SkillDiscoveryPath".
+ */
+/** @experimental */
+export interface SkillDiscoveryPath {
+    /**
+     * Absolute path of the create/discovery target (may not exist on disk yet)
+     */
+    path: string;
+    scope: SkillDiscoveryScope;
+    /**
+     * Whether this is the canonical directory to create a new skill in its tier. At most one entry per tier is preferred; the `personal-agents` and `custom` scopes are never preferred.
+     */
+    preferredForCreation: boolean;
+    /**
+     * The input project path this directory was derived from (only for project scope)
+     */
+    projectPath?: string;
+}
+/**
+ * Canonical locations where skills can be created so the runtime will recognize them.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SkillDiscoveryPathList".
+ */
+/** @experimental */
+export interface SkillDiscoveryPathList {
+    /**
+     * Canonical skill create/discovery directories, in priority order
+     */
+    paths: SkillDiscoveryPath[];
+}
 /**
  * Skills available to the session, with their enabled state.
  *
@@ -10494,6 +10996,10 @@ export interface SkillsDiscoverRequest {
      * Optional list of additional skill directory paths to include
      */
     skillDirectories?: string[];
+    /**
+     * When true, omit skills from the host's global sources (personal, custom, plugin, and built-in), returning only project-scoped skills. For multitenant deployments.
+     */
+    excludeHostSkills?: boolean;
 }
 /**
  * Name of the skill to enable for the session.
@@ -10508,6 +11014,23 @@ export interface SkillsEnableRequest {
      */
     name: string;
 }
+/**
+ * Optional project paths to enumerate.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SkillsGetDiscoveryPathsRequest".
+ */
+/** @experimental */
+export interface SkillsGetDiscoveryPathsRequest {
+    /**
+     * Optional list of project directory paths. When omitted or empty, only personal and custom directories are returned.
+     */
+    projectPaths?: string[];
+    /**
+     * When true, omit the host's personal and custom skill directories, leaving only project directories. For multitenant deployments.
+     */
+    excludeHostSkills?: boolean;
+}
 /**
  * Skills invoked during this session, ordered by invocation time (most recent last).
  *
@@ -10693,6 +11216,24 @@ export interface SlashCommandSelectSubcommandOption {
      */
     group?: string;
 }
+/**
+ * Subagent model, reasoning effort, and context tier settings
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SubagentSettingsEntry".
+ */
+/** @experimental */
+export interface SubagentSettingsEntry {
+    /**
+     * Model override for matching subagents
+     */
+    model?: string;
+    /**
+     * Reasoning effort override for matching subagents
+     */
+    effortLevel?: string;
+    contextTier?: SubagentSettingsEntryContextTier;
+}
 /**
  * Schema for the `TaskAgentInfo` type.
  *
@@ -11205,6 +11746,15 @@ export interface ToolsListRequest {
      */
     model?: string;
 }
+/**
+ * Empty result after applying subagent settings
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ToolsUpdateSubagentSettingsResult".
+ */
+/** @experimental */
+export interface ToolsUpdateSubagentSettingsResult {
+}
 /**
  * Multi-select string field where each option pairs a value with a display label.
  *
@@ -11756,6 +12306,19 @@ export interface UIUnregisterDirectAutoModeSwitchHandlerResult {
      */
     unregistered: boolean;
 }
+/**
+ * Subagent settings to apply to the current session
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UpdateSubagentSettingsRequest".
+ */
+/** @experimental */
+export interface UpdateSubagentSettingsRequest {
+    /**
+     * Subagent settings to apply, or null to clear the live session override
+     */
+    subagents?: SubagentSettings | null;
+}
 /**
  * Accumulated session usage metrics, including premium request cost, token counts, model breakdown, and code-change totals.
  *
@@ -12053,6 +12616,10 @@ export interface WorkspacesCreateFileRequest {
 /** @experimental */
 export interface WorkspacesDiffRequest {
     mode: WorkspaceDiffMode;
+    /**
+     * When true, ignore whitespace-only changes (git `--ignore-all-space`). Defaults to false.
+     */
+    ignoreWhitespace?: boolean;
 }
 /**
  * Current workspace metadata for the session, including its absolute filesystem path when available.
@@ -12438,6 +13005,16 @@ export declare function createServerRpc(connection: MessageConnection): {
          * @returns Skills discovered across global and project sources.
          */
         discover: (params: SkillsDiscoverRequest) => Promise<ServerSkillList>;
+        /**
+         * Returns the canonical directories where a client may create skills that the runtime will recognize, including ones that do not exist yet. Project directories become active once created.
+         *
+         * @param params Optional project paths to enumerate.
+         *
+         * @returns Canonical locations where skills can be created so the runtime will recognize them.
+         *
+         * @experimental
+         */
+        getDiscoveryPaths: (params: SkillsGetDiscoveryPathsRequest) => Promise<SkillDiscoveryPathList>;
     };
     /** @experimental */
     agents: {
@@ -12449,6 +13026,14 @@ export declare function createServerRpc(connection: MessageConnection): {
          * @returns Agents discovered across user, project, plugin, and remote sources.
          */
         discover: (params: AgentsDiscoverRequest) => Promise<ServerAgentList>;
+        /**
+         * Returns the canonical directories where a client may create custom agents that the runtime will recognize, including ones that do not exist yet. Project directories become active once created.
+         *
+         * @param params Optional project paths to include when enumerating agent discovery directories.
+         *
+         * @returns Canonical locations where custom agents can be created so the runtime will recognize them.
+         */
+        getDiscoveryPaths: (params: AgentsGetDiscoveryPathsRequest) => Promise<AgentDiscoveryPathList>;
     };
     /** @experimental */
     instructions: {
@@ -12460,6 +13045,14 @@ export declare function createServerRpc(connection: MessageConnection): {
          * @returns Instruction sources discovered across user, repository, and plugin sources.
          */
         discover: (params: InstructionsDiscoverRequest) => Promise<ServerInstructionSourceList>;
+        /**
+         * Returns the canonical files and directories where a client may create custom instructions that the runtime will recognize, including ones that do not exist yet. Repository targets become active once created.
+         *
+         * @param params Optional project paths to include when enumerating instruction discovery targets.
+         *
+         * @returns Canonical files and directories where custom instructions can be created so the runtime will recognize them.
+         */
+        getDiscoveryPaths: (params: InstructionsGetDiscoveryPathsRequest) => Promise<InstructionDiscoveryPathList>;
     };
     user: {
         settings: {
@@ -12868,6 +13461,12 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Todo rows read from the session SQL database. Empty when no session database is available.
          */
         readSqlTodos: () => Promise<PlanReadSqlTodosResult>;
+        /**
+         * Reads todo rows AND dependency edges from the session SQL database for structured progress UI. Same defensive behavior as readSqlTodos — returns empty arrays when the database, tables, or columns aren't available. Clients should call this on session start and after every `session.todos_changed` event to refresh structured-UI rendering.
+         *
+         * @returns Todo rows + dependency edges read from the session SQL database.
+         */
+        readSqlTodosWithDependencies: () => Promise<PlanReadSqlTodosWithDependenciesResult>;
     };
     /** @experimental */
     workspaces: {
@@ -13250,6 +13849,17 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         reload: (params?: PluginsReloadRequest) => Promise<void>;
     };
     /** @experimental */
+    provider: {
+        /**
+         * Returns the provider endpoint and credentials the session is currently configured to talk to, so the caller can make inference calls directly against the same backend the session uses.
+         *
+         * @param params Optional model identifier to scope the endpoint snapshot to.
+         *
+         * @returns A snapshot of the provider endpoint the session is currently configured to talk to.
+         */
+        getEndpoint: (params?: ProviderGetEndpointRequest) => Promise<ProviderEndpoint>;
+    };
+    /** @experimental */
     options: {
         /**
          * Patches the genuinely-mutable subset of session options.
@@ -13322,6 +13932,14 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Current lightweight tool metadata snapshot for the session.
          */
         getCurrentMetadata: () => Promise<ToolsGetCurrentMetadataResult>;
+        /**
+         * Updates the current session's live subagent settings after user settings change. The persisted user settings remain the source of truth for future sessions.
+         *
+         * @param params Subagent settings to apply to the current session
+         *
+         * @returns Empty result after applying subagent settings
+         */
+        updateSubagentSettings: (params: UpdateSubagentSettingsRequest) => Promise<ToolsUpdateSubagentSettingsResult>;
     };
     /** @experimental */
     commands: {