@github/copilot-sdk 1.0.10-preview.0 → 1.0.11-preview.2

package/dist/generated/rpc.d.ts

@@ -4,6 +4,10 @@
  */
 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, Verbosity } from "./session-events.js";
+/** A value that can be represented losslessly on the SDK JSON wire. */
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
 /**
  * Initial authentication info for the session.
  *
@@ -243,6 +247,22 @@ export type AuthInfoType =
  | "token"
 /** Authentication from a Copilot API token. */
  | "copilot-api-token";
+/**
+ * JSON Schema for canvas open input
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasJsonSchema".
+ */
+/** @experimental */
+export type CanvasJsonSchema = JsonValue;
+/**
+ * Provider-supplied action result.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasActionInvokeResult".
+ */
+/** @experimental */
+export type CanvasActionInvokeResult = JsonValue;
 /**
  * Coarse command category for grouping and behavior: runtime built-in, skill-backed command, or SDK/client-owned command
  *
@@ -653,6 +673,16 @@ export type FactoryRunFailure = {
      */
     runId: string;
     type: "factory_durable_failure";
+} | {
+    /**
+     * Factory run identifier.
+     */
+    runId: string;
+    /**
+     * Confirmed usage in nano-AIU, representing the floor of what the run spent.
+     */
+    drainedNanoAiu: number;
+    type: "factory_accounting_incomplete";
 };
 /**
  * Cumulative resource ceiling that stopped a factory run.
@@ -3377,7 +3407,7 @@ export interface AgentInfo {
      * @experimental
      */
     mcpServers?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
     /**
      * Skill names preloaded into this agent's context. Omitted means none.
@@ -3775,16 +3805,6 @@ export interface CanvasAction {
     description?: string;
     inputSchema?: CanvasJsonSchema;
 }
-/**
- * JSON Schema for canvas open input
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CanvasJsonSchema".
- */
-/** @experimental */
-export interface CanvasJsonSchema {
-    [k: string]: unknown | undefined;
-}
 /**
  * Canvas action invocation parameters.
  *
@@ -3804,19 +3824,7 @@ export interface CanvasActionInvokeRequest {
     /**
      * Action input
      */
-    input?: {
-        [k: string]: unknown | undefined;
-    };
-}
-/**
- * Provider-supplied action result.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CanvasActionInvokeResult".
- */
-/** @experimental */
-export interface CanvasActionInvokeResult {
-    [k: string]: unknown | undefined;
+    input?: JsonValue;
 }
 /**
  * Canvas close parameters.
@@ -3961,9 +3969,7 @@ export interface OpenCanvasInstance {
     /**
      * Input supplied when the instance was opened
      */
-    input?: {
-        [k: string]: unknown | undefined;
-    };
+    input?: JsonValue;
 }
 /**
  * Canvas open parameters.
@@ -3988,9 +3994,7 @@ export interface CanvasOpenRequest {
     /**
      * Canvas open input
      */
-    input?: {
-        [k: string]: unknown | undefined;
-    };
+    input?: JsonValue;
 }
 /**
  * Canvas close parameters sent to the provider.
@@ -4063,9 +4067,7 @@ export interface CanvasProviderInvokeActionRequest {
     /**
      * Action input
      */
-    input?: {
-        [k: string]: unknown | undefined;
-    };
+    input?: JsonValue;
     host?: CanvasHostContext;
     session?: CanvasSessionContext;
 }
@@ -4096,9 +4098,7 @@ export interface CanvasProviderOpenRequest {
     /**
      * Canvas open input
      */
-    input?: {
-        [k: string]: unknown | undefined;
-    };
+    input?: JsonValue;
     host?: CanvasHostContext;
     session?: CanvasSessionContext;
 }
@@ -4606,7 +4606,7 @@ export interface CurrentToolMetadata {
      * JSON Schema for tool input
      */
     input_schema?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
     /**
      * Whether the tool is loaded on demand via tool search
@@ -5036,9 +5036,7 @@ export interface ExtensionContextPushInput {
     /**
      * Caller-supplied JSON payload (required, may be null but not undefined)
      */
-    payload: {
-        [k: string]: unknown | undefined;
-    };
+    payload: JsonValue;
 }
 /**
  * Opaque integrator-owned process launch profile for one extension entrypoint.
@@ -5162,7 +5160,7 @@ export interface ExternalToolTextResultForLlm {
      * Optional tool-specific telemetry
      */
     toolTelemetry?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
     /**
      * Base64-encoded binary results returned to the model
@@ -5202,7 +5200,7 @@ export interface ExternalToolTextResultForLlmBinaryResultsForLlm {
      * Optional metadata from the producing tool.
      */
     metadata?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
 }
 /**
@@ -5440,13 +5438,20 @@ export interface FactoryAgentOptions {
     /**
      * Optional JSON Schema for structured agent output.
      */
-    schema?: {
-        [k: string]: unknown | undefined;
-    };
+    schema?: JsonValue;
     /**
      * Optional model identifier for the subagent.
      */
     model?: string;
+    /**
+     * Optional reasoning effort for the subagent. This field is accepted but not yet honored.
+     */
+    reasoningEffort?: string;
+    contextTier?: ContextTier;
+    /**
+     * Optional custom agent name for the subagent. This field is accepted but not yet honored.
+     */
+    agent?: string;
 }
 /**
  * Parameters for one factory-scoped subagent call.
@@ -5481,9 +5486,7 @@ export interface FactoryAgentResult {
     /**
      * Agent result, omitted when the agent produced no result.
      */
-    result?: {
-        [k: string]: unknown | undefined;
-    };
+    result?: JsonValue;
 }
 /**
  * Prompt-safe durable identity and live status for a direct factory agent.
@@ -5571,9 +5574,7 @@ export interface FactoryExecuteRequest {
     /**
      * Factory input value.
      */
-    args: {
-        [k: string]: unknown | undefined;
-    };
+    args: JsonValue;
 }
 /**
  * Result returned by an extension factory closure.
@@ -5586,9 +5587,7 @@ export interface FactoryExecuteResult {
     /**
      * Factory result value.
      */
-    result?: {
-        [k: string]: unknown | undefined;
-    };
+    result?: JsonValue;
 }
 /**
  * Parameters for paging factory progress.
@@ -5668,9 +5667,7 @@ export interface FactoryJournalGetResult {
     /**
      * Cached JSON result. The hit field distinguishes a cached JSON null from a miss.
      */
-    resultJson?: {
-        [k: string]: unknown | undefined;
-    };
+    resultJson?: JsonValue;
 }
 /**
  * Parameters for storing a factory journal entry.
@@ -5695,21 +5692,31 @@ export interface FactoryJournalPutRequest {
     /**
      * JSON result to memoize.
      */
-    resultJson: {
-        [k: string]: unknown | undefined;
-    };
+    resultJson: JsonValue;
 }
 /**
- * Empty parameters for listing factory runs.
+ * Parameters for paging factory runs.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "FactoryListRunsRequest".
  */
 /** @experimental */
 export interface FactoryListRunsRequest {
+    /**
+     * Exclusive forward cursor.
+     */
+    afterSeq?: number;
+    /**
+     * Exclusive backward cursor.
+     */
+    beforeSeq?: number;
+    /**
+     * Maximum terminal runs to return. Defaults to 200 and is capped at 500.
+     */
+    limit?: number;
 }
 /**
- * Factory runs in durable creation order.
+ * A page of factory runs in durable creation order.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "FactoryListRunsResult".
@@ -5717,6 +5724,22 @@ export interface FactoryListRunsRequest {
 /** @experimental */
 export interface FactoryListRunsResult {
     runs: FactoryRunSummary[];
+    /**
+     * Oldest terminal-run cursor in this page, or null when the terminal window is empty.
+     */
+    oldestSeq?: number | null;
+    /**
+     * Newest terminal-run cursor in this page, or null when the terminal window is empty.
+     */
+    newestSeq?: number | null;
+    /**
+     * Whether terminal runs newer than this page exist.
+     */
+    hasMoreNewer?: boolean;
+    /**
+     * Number of terminal runs older than this page.
+     */
+    omittedOlder?: number;
 }
 /**
  * Durable factory run summary with read-time live overlays.
@@ -5949,9 +5972,7 @@ export interface FactoryRunResult {
     /**
      * Completed factory result.
      */
-    result?: {
-        [k: string]: unknown | undefined;
-    };
+    result?: JsonValue;
     /**
      * Error message for an errored run.
      */
@@ -5964,9 +5985,7 @@ export interface FactoryRunResult {
     /**
      * Partial journal and progress snapshot for a halted, cancelled, or errored run.
      */
-    snapshot?: {
-        [k: string]: unknown | undefined;
-    };
+    snapshot?: JsonValue;
 }
 /**
  * Full factory run observability detail.
@@ -6014,9 +6033,7 @@ export interface FactoryRunRequest {
     /**
      * Factory input value.
      */
-    args: {
-        [k: string]: unknown | undefined;
-    };
+    args: JsonValue;
     options?: RunOptions;
 }
 /**
@@ -7212,9 +7229,7 @@ export interface ManagedSettingsReadResult {
     /**
      * Validated, canonical managed-settings JSON. Omitted when no managed settings were discovered or when discovered settings failed validation.
      */
-    settingsJson?: {
-        [k: string]: unknown | undefined;
-    };
+    settingsJson?: JsonValue;
     /**
      * Discovery or validation error text when managed settings could not be read safely.
      */
@@ -7385,7 +7400,7 @@ export interface McpAppsCallToolRequest {
      * Tool arguments
      */
     arguments?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
     /**
      * **Required.** Server whose ui:// view issued the request. Per SEP-1865 ('callable by the app from this server only'), the call is rejected when this differs from `serverName`, and rejected outright when missing.
@@ -7530,7 +7545,7 @@ export interface McpAppsListToolsResult {
      * App-callable tools from the server
      */
     tools: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     }[];
 }
 /**
@@ -7591,7 +7606,7 @@ export interface McpAppsResourceContent {
      * Resource-level metadata (CSP, permissions, etc.)
      */
     _meta?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
 }
 /**
@@ -7934,9 +7949,7 @@ export interface McpExecuteSamplingParams {
     /**
      * The original MCP JSON-RPC request ID (string or number). Used by the runtime to correlate the inference with the originating MCP request for telemetry; this is distinct from `requestId` (which is the schema-level cancellation handle).
      */
-    mcpRequestId: {
-        [k: string]: unknown | undefined;
-    };
+    mcpRequestId: JsonValue;
     request: McpExecuteSamplingRequest;
 }
 /**
@@ -8345,13 +8358,13 @@ export interface McpResource {
      * Resource-level metadata
      */
     _meta?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
     /**
      * Server-provided non-standard descriptor fields preserved from the MCP response
      */
     additionalProperties?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
 }
 /**
@@ -8382,7 +8395,7 @@ export interface McpResourceIcon {
      * Server-provided non-standard icon fields preserved from the MCP response
      */
     additionalProperties?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
 }
 /**
@@ -8409,7 +8422,7 @@ export interface McpResourceAnnotations {
      * Server-provided non-standard annotation fields preserved from the MCP response
      */
     additionalProperties?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
 }
 /**
@@ -8440,7 +8453,7 @@ export interface McpResourceContent {
      * Resource-level metadata (CSP, permissions, etc.)
      */
     _meta?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
 }
 /**
@@ -8548,13 +8561,13 @@ export interface McpResourceTemplate {
      * Resource-template-level metadata
      */
     _meta?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
     /**
      * Server-provided non-standard descriptor fields preserved from the MCP response
      */
     additionalProperties?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
 }
 /**
@@ -9503,7 +9516,7 @@ export interface NameSetRequest {
 /** @experimental */
 export interface OptionsUpdateAdditionalContentExclusionPolicy {
     rules: OptionsUpdateAdditionalContentExclusionPolicyRule[];
-    last_updated_at: unknown;
+    last_updated_at: JsonValue;
     scope: OptionsUpdateAdditionalContentExclusionPolicyScope;
 }
 /**
@@ -10581,7 +10594,7 @@ export interface PermissionRulesSet {
 /** @experimental */
 export interface PermissionsConfigureAdditionalContentExclusionPolicy {
     rules: PermissionsConfigureAdditionalContentExclusionPolicyRule[];
-    last_updated_at: unknown;
+    last_updated_at: JsonValue;
     scope: PermissionsConfigureAdditionalContentExclusionPolicyScope;
 }
 /**
@@ -11394,7 +11407,7 @@ export interface ProviderAddResult {
     /**
      * Synthesized selectable model entries for the newly added BYOK models, each under its provider-qualified selection id (`provider/id`). Empty when only providers were added.
      */
-    models: unknown[];
+    models: JsonValue[];
 }
 /**
  * Custom model-provider configuration (BYOK).
@@ -12029,9 +12042,7 @@ export interface QueueConsumeSystemNotificationsRequest {
     /**
      * Opaque runtime-owned filter object.
      */
-    filter: {
-        [k: string]: unknown | undefined;
-    };
+    filter: JsonValue;
 }
 /**
  * Inputs for marking session.idle deferred in native state.
@@ -12781,14 +12792,7 @@ export interface SandboxConfig {
      * Whether to auto-add the current working directory to readwritePaths. Default: true.
      */
     addCurrentWorkingDirectory?: boolean;
-    /**
-     * Whether to inject the Copilot GitHub token as an `http.<host>.extraheader` so authenticated HTTPS git works inside the sandbox without the shell-based credential helper the sandbox blocks. Default: false (opt-in).
-     */
-    gitAuth?: boolean;
-    /**
-     * Whether to export `GH_TOKEN` so the `gh` CLI authenticates inside the sandbox without the OS keyring the sandbox blocks. Default: false (opt-in).
-     */
-    ghAuth?: boolean;
+    auth?: SandboxConfigAuth;
     /**
      * Whether to auto-grant read access to common developer-tool caches, registries, and toolchains in their default home locations (cargo, go, npm, Maven, and more), plus read-write access to (and, on Unix, up-front creation of) the scratch caches builds write on every run (go-build, ccache, sccache, Gradle caches, Cargo lock/tracker files), so builds work without extra configuration; a relocated CARGO_HOME additionally gets its Cargo lock files granted read-write. Default: true (enabled by default; set to false to opt out).
      */
@@ -12907,6 +12911,23 @@ export interface SandboxConfigUserPolicyExperimentalSeatbelt {
      */
     keychainAccess?: boolean;
 }
+/**
+ * Credential-injection capability flags applied while the sandbox is enabled.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SandboxConfigAuth".
+ */
+/** @experimental */
+export interface SandboxConfigAuth {
+    /**
+     * Whether to inject git credentials as an `http.<url>.extraheader` so authenticated HTTPS git works inside the sandbox without the shell-based credential helper the sandbox blocks. github.com is served by the Copilot token; every other forge (Azure DevOps, GitHub Enterprise Server, GitLab, ...) by a credential the host resolves from the user's own helper before the sandbox is applied. Default: false (opt-in).
+     */
+    git?: boolean;
+    /**
+     * Whether to export `GH_TOKEN` so the `gh` CLI authenticates inside the sandbox without the OS keyring the sandbox blocks. Default: false (opt-in).
+     */
+    gh?: boolean;
+}
 /**
  * Register an absolute-time scheduled prompt.
  *
@@ -13331,15 +13352,11 @@ export interface SendSystemNotificationRequest {
     /**
      * Optional structured notification kind.
      */
-    kind?: {
-        [k: string]: unknown | undefined;
-    };
+    kind?: JsonValue;
     /**
      * Internal delivery options, including passive policy.
      */
-    options?: {
-        [k: string]: unknown | undefined;
-    };
+    options?: JsonValue;
 }
 /**
  * Agents discovered across user, project, plugin, and remote sources.
@@ -13827,7 +13844,7 @@ export interface SessionFsSqliteQueryRequest {
      * Optional named bind parameters
      */
     params?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
 }
 /**
@@ -13842,7 +13859,7 @@ export interface SessionFsSqliteQueryResult {
      * For SELECT: array of row objects. For others: empty array.
      */
     rows: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     }[];
     /**
      * Column names from the result set
@@ -13900,7 +13917,7 @@ export interface SessionFsSqliteTransactionStatement {
      * Optional named bind parameters.
      */
     params?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
 }
 /**
@@ -14303,7 +14320,7 @@ export interface SessionModelList {
     /**
      * 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[];
+    list: JsonValue[];
     /**
      * Cost categories for the full CAPI catalog, including picker-disabled models that Auto may select. Metadata only; entries absent from `list` are not manually selectable.
      */
@@ -14312,7 +14329,7 @@ export interface SessionModelList {
      * Per-quota snapshots returned alongside the model list, keyed by quota type.
      */
     quotaSnapshots?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
 }
 /**
@@ -14622,7 +14639,7 @@ export interface ShellInitScript {
 /** @experimental */
 export interface SessionOpenOptionsAdditionalContentExclusionPolicy {
     rules: SessionOpenOptionsAdditionalContentExclusionPolicyRule[];
-    last_updated_at: unknown;
+    last_updated_at: JsonValue;
     scope: SessionOpenOptionsAdditionalContentExclusionPolicyScope;
 }
 /**
@@ -16744,7 +16761,7 @@ export interface Tool {
      * JSON Schema for the tool's input parameters
      */
     parameters?: {
-        [k: string]: unknown | undefined;
+        [k: string]: JsonValue | undefined;
     };
     /**
      * Optional instructions for how to use this tool effectively
@@ -17624,15 +17641,11 @@ export interface UserSettingMetadata {
     /**
      * The effective value: the user's value if set, otherwise the default.
      */
-    value: {
-        [k: string]: unknown | undefined;
-    };
+    value: JsonValue;
     /**
      * The centrally-known default for this setting (null when no default is registered).
      */
-    default: {
-        [k: string]: unknown | undefined;
-    };
+    default: JsonValue;
     /**
      * True when the user has not set an explicit value for this setting (i.e. it is left at its default). Reflects whether the user has overridden the key, not whether the effective value happens to equal the default — a key explicitly set to a value identical to the default still reports false.
      */
@@ -17664,9 +17677,7 @@ export interface UserSettingsSetRequest {
     /**
      * Partial user settings to write, as a free-form object keyed by setting name
      */
-    settings: {
-        [k: string]: unknown | undefined;
-    };
+    settings: JsonValue;
 }
 /**
  * Outcome of writing user settings.
@@ -17895,9 +17906,7 @@ export interface WorkspacesEnsureRequest {
     /**
      * Opaque workspace context supplied by the session host.
      */
-    context?: {
-        [k: string]: unknown | undefined;
-    };
+    context?: JsonValue;
 }
 /**
  * Current workspace metadata for the session, including its absolute filesystem path when available.
@@ -18088,9 +18097,7 @@ export interface WorkspacesUpdateMetadataRequest {
     /**
      * Opaque workspace context supplied by the session host.
      */
-    context?: {
-        [k: string]: unknown | undefined;
-    };
+    context?: JsonValue;
     /**
      * Optional workspace display name override.
      */
@@ -18148,7 +18155,7 @@ export interface SessionAgentListRequest {
  */
 /** @experimental */
 export interface SessionMcpAppsCallToolResult {
-    [k: string]: unknown | undefined;
+    [k: string]: JsonValue | undefined;
 }
 /** @experimental */
 export interface SessionPluginsReloadRequest {
@@ -19001,9 +19008,11 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         /**
          * Lists durable factory runs for this session in creation order.
          *
-         * @returns Factory runs in durable creation order.
+         * @param params Parameters for paging factory runs.
+         *
+         * @returns A page of factory runs in durable creation order.
          */
-        listRuns: () => Promise<FactoryListRunsResult>;
+        listRuns: (params: FactoryListRunsRequest) => Promise<FactoryListRunsResult>;
         /**
          * Gets durable and live observability detail for one factory run.
          *

package/dist/generated/rpc.js

@@ -844,9 +844,11 @@ function createSessionRpc(connection, sessionId) {
       /**
        * Lists durable factory runs for this session in creation order.
        *
-       * @returns Factory runs in durable creation order.
+       * @param params Parameters for paging factory runs.
+       *
+       * @returns A page of factory runs in durable creation order.
        */
-      listRuns: async () => connection.sendRequest("session.factory.listRuns", { sessionId }),
+      listRuns: async (params) => connection.sendRequest("session.factory.listRuns", { sessionId, ...params }),
       /**
        * Gets durable and live observability detail for one factory run.
        *