@github/copilot-sdk 1.0.18-preview.3 → 1.0.18-preview.5

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, AgentModelPolicy, Attachment, AutoTier, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, IndexedSearchState, ManagedSettingsResolvedData, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, McpServerMetadata, McpServerSource, McpServerStatus, ModelChangeSource, PermissionDecisionSource, PermissionMode, PermissionPromptRequest, PermissionRule, ReasoningSummary, RemediationAction, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskCompleteData, TaskCompletionOutcome, UserToolSessionApproval, Verbosity } from "./session-events.js";
+import type { AbortReason, AgentModelPolicy, Attachment, AutoTier, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, IndexedSearchState, ManagedSettingsResolvedData, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, McpServerMetadata, McpServerSource, McpServerStatus, ModelChangeSource, ModelProviderKind, ModelProviderRef, PermissionDecisionSource, PermissionMode, PermissionPromptRequest, PermissionRule, ProviderQuotaState, ReasoningSummary, RemediationAction, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskCompleteData, TaskCompletionOutcome, UsageGetMetricsResult, 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;
@@ -3502,6 +3502,11 @@ export type SessionContextInfo = {
      * The model used for token counting
      */
     modelName: string;
+    provider?: ModelProviderRef;
+    /**
+     * Provider-owned model display label, or the Auto routing label. Presentation only; modelName remains the tokenization identity.
+     */
+    displayModelName?: string;
     /**
      * Tokens consumed by the system prompt
      */
@@ -3621,18 +3626,6 @@ export type ModelPickerPriceCategory =
  | "high"
 /** Highest relative token cost tier. */
  | "very_high";
-/**
- * The neutral kind of a model provider — the model analog of `AccountKind`. A model provider is the live, entitled source a model came from; central code never branches on this beyond a single dispatch.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ModelProviderKind".
- */
-/** @experimental */
-export type ModelProviderKind = 
-/** GitHub Copilot / CAPI models, spawned by a github-resolving account that holds a Copilot seat. */
-"copilot"
-/** Microsoft 365 Copilot (Loki) inference models, spawned by a resolvable Entra-derived Loki account. */
- | "loki";
 /**
  * Optional listing options.
  *
@@ -4180,6 +4173,14 @@ export type QueuePendingItemsKind =
 "message"
 /** A queued slash command or model-change command. */
  | "command";
+/**
+ * Pending warnings returned and cleared by session.quota.takeWarnings.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "QuotaTakeWarningsResult".
+ */
+/** @experimental */
+export type QuotaTakeWarningsResult = QuotaWarningProjection[];
 /**
  * State of the runtime-managed remote-control singleton.
  *
@@ -4700,6 +4701,30 @@ export type SessionsOpenProgressStatus =
 "in-progress"
 /** The step has completed successfully. */
  | "complete";
+/**
+ * Copilot plan tier used by the session quota projection.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionQuotaPlanTier".
+ */
+/** @experimental */
+export type SessionQuotaPlanTier = 
+/** Copilot Free. */
+"free"
+/** Copilot education entitlement. */
+ | "edu"
+/** Copilot Pro. */
+ | "pro"
+/** Copilot Pro+. */
+ | "pro_plus"
+/** Copilot Business. */
+ | "business"
+/** Copilot Enterprise. */
+ | "enterprise"
+/** Copilot Max. */
+ | "max"
+/** The account's plan tier is not known. */
+ | "unknown";
 /**
  * Client metadata outcome for one requested local session.
  *
@@ -5859,6 +5884,14 @@ export type SessionGitHubAuthLogoutResult = boolean;
  */
 /** @experimental */
 export type SessionGitHubAuthLogoutUserResult = boolean;
+/**
+ * Pending warnings returned and cleared by session.quota.takeWarnings.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionQuotaTakeWarningsResult".
+ */
+/** @experimental */
+export type SessionQuotaTakeWarningsResult = QuotaWarningProjection[];
 /**
  * Parameters for aborting the current turn
  *
@@ -9814,10 +9847,18 @@ export interface CurrentModel {
      * Currently active model identifier
      */
     modelId?: string;
+    /**
+     * Provider selected for this model. Together with modelId, identifies a catalog entry even when providers serve the same model. Omitted for unattributed legacy selections.
+     */
+    providerId?: string;
     /**
      * Captured base model to restore when leaving plan mode. Omitted outside plan mode or when no plan override has captured a base model. Persistent agent model requirements apply to this model rather than the temporary plan model.
      */
     planBaseModelId?: string;
+    /**
+     * Provider of planBaseModelId, when that saved selection is provider-qualified.
+     */
+    planBaseProviderId?: string;
     /**
      * Reasoning effort level currently applied to the active model, when one is set. Reads `Session.getReasoningEffort()` synchronously after `getSelectedModel()` resolves so the two values are reported as a snapshot.
      */
@@ -12092,6 +12133,10 @@ export interface HostGitHubEnvironmentOptions {
      * Stable application installation identity, reused across host restarts.
      */
     computeId: string;
+    /**
+     * Require sealed, connection-bound authentication (default true), independent of listener address. False permits unsealed direct credentials and unbound sealed relay credentials; use only when the caller fully controls and trusts the direct transport. Relay token encryption remains mandatory.
+     */
+    requireConnectionBinding?: boolean;
 }
 /**
  * Stops a connection-owned listener and joins its teardown.
@@ -12162,6 +12207,66 @@ export interface HostExitedNotification {
      */
     error?: string | null;
 }
+/**
+ * Reads a running host's catalog or the runtime's saved default catalog.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HostListSessionsRequest".
+ */
+/** @experimental */
+export interface HostListSessionsRequest {
+    /**
+     * Listener UUID returned by host.start; the caller must own it. Omit to read
+     * the saved default compute-identity catalog without starting a listener.
+     */
+    hostId?: string;
+}
+/**
+ * The complete live and dormant advertised catalog, without subscribing to sessions.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HostListSessionsResult".
+ */
+/** @experimental */
+export interface HostListSessionsResult {
+    /**
+     * Complete advertised session summaries, in the host's catalog order.
+     */
+    sessions: HostSessionSummary[];
+}
+/**
+ * Metadata advertised by the AHP host, not a guarantee that history can be resumed.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HostSessionSummary".
+ */
+/** @experimental */
+export interface HostSessionSummary {
+    /**
+     * Stable AHP resource URI identifying the session on this host.
+     */
+    resource: string;
+    /**
+     * Authoritative title advertised by the host.
+     */
+    title: string;
+    /**
+     * Session creation time as an ISO 8601 timestamp.
+     */
+    createdAt: string;
+    /**
+     * Last modification time as an ISO 8601 timestamp.
+     */
+    modifiedAt: string;
+    /**
+     * Unsigned 32-bit AHP session status bitset (0..=4294967295); unknown bits must be preserved.
+     */
+    status: number;
+    /**
+     * Optional activity description advertised by the host.
+     */
+    activity?: string;
+}
 /**
  * Local WebSocket transport options.
  *
@@ -12318,6 +12423,11 @@ export interface HostSessionCreateRequest {
      * Resume an app-owned durable session instead of creating a new session.
      */
     resume?: boolean;
+    /**
+     * For an explicit publication, borrow an existing owning-connection resident
+     * instead of invoking the resume factory. Cold sessions still use the factory.
+     */
+    preferResident?: boolean;
     /**
      * Host-selected SDK creation or resume settings, without executable callbacks or tools.
      */
@@ -12380,6 +12490,10 @@ export interface HostStartRequest {
      * Caller-generated UUID identifying this connection-owned listener.
      */
     hostId: string;
+    /**
+     * Stable application identity selecting its durable host catalog. Defaults to the persisted runtime compute GUID; must agree with githubEnvironment.computeId when both are supplied.
+     */
+    computeId?: string;
     localServer?: HostLocalServerOptions;
     githubEnvironment?: HostGitHubEnvironmentOptions;
     /**
@@ -14607,7 +14721,7 @@ export interface McpConfiguredServer {
      * Human-readable display name supplied by configuration.
      */
     displayName?: string;
-    live?: McpConfiguredServerState;
+    live: McpConfiguredServerState;
 }
 /**
  * Observational state for a matching already materialized MCP server.
@@ -16330,6 +16444,10 @@ export interface MetadataContextInfoRequest {
      * Model identifier used for tokenization. Omit to use the session default. Used both for token counting and to compute display values.
      */
     selectedModel?: string;
+    /**
+     * Provider owning selectedModel. Omit to use the current provider for the current model, or deterministic legacy lookup for a different model.
+     */
+    providerId?: string;
 }
 /**
  * Token breakdown for the session's current context window, or null if uninitialized.
@@ -16776,24 +16894,6 @@ export interface ModelMessage {
      */
     message: string;
 }
-/**
- * A neutral reference to the model provider that produced a model: an opaque id, a human-readable label, and the provider kind. Carried on each enumerated Model so consumers can group by provider without reaching into a provider-shaped internal type.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ModelProviderRef".
- */
-/** @experimental */
-export interface ModelProviderRef {
-    /**
-     * Opaque, stable id of the provider that produced this model. Matches the enumerated `ModelProviderDescriptor.id`.
-     */
-    id: string;
-    /**
-     * Human-readable provider label, owned by the runtime so every consumer renders identical text.
-     */
-    label: string;
-    kind: ModelProviderKind;
-}
 /**
  * Managed, repository, and CLI model overrides to overlay onto the session at startup.
  *
@@ -16819,6 +16919,10 @@ export interface ModelApplyStartupOverlayRequest {
      * Model selected by repository settings, when configured.
      */
     repoModel?: string;
+    /**
+     * Provider owning the repository-selected model. Omitted repository provider identity retains legacy bare-model behavior.
+     */
+    repoModelProviderId?: string;
     /**
      * Reasoning effort selected by repository settings, when configured.
      */
@@ -17530,9 +17634,13 @@ export interface ModelSwitchConfirmation {
 /** @experimental */
 export interface ModelSwitchToRequest {
     /**
-     * Model selection id to switch to, as returned by `list`. A bare id (e.g. `claude-sonnet-4.6`) names a Copilot (CAPI) model; a provider-qualified id (`provider/id`, e.g. `acme/claude-sonnet`) targets a registry BYOK model.
+     * Model id to switch to, as returned by `list`. Include providerId to select an exact catalog entry when providers share the id. Without providerId, a bare id retains incumbent selection behavior; a registry-qualified id (`provider/id`, e.g. `acme/claude-sonnet`) targets a BYOK model.
      */
     modelId: string;
+    /**
+     * Provider id from the selected list entry's provider reference. Selects this exact provider/model pair; an unavailable pair fails rather than using another provider. Omit for deterministic legacy bare-model selection.
+     */
+    providerId?: string;
     /**
      * Optional Auto routing preference to stage atomically with selecting `auto`. Pass null to return to provider-default Auto routing. This field is rejected when `modelId` is not `auto`.
      */
@@ -17637,6 +17745,10 @@ export interface ModeSetRequest {
      * Dedicated model to use in plan mode, when configured.
      */
     planModel?: string;
+    /**
+     * Provider owning planModel. Omit for legacy bare-model selection.
+     */
+    planModelProviderId?: string;
     /**
      * Reasoning effort to use with the dedicated plan model.
      */
@@ -17827,6 +17939,52 @@ export interface OptionsUpdateAdditionalContentExclusionPolicyRuleSource {
      */
     type: string;
 }
+/**
+ * External tool call of the session or one of its sub-agents that is still waiting for session.tools.handlePendingToolCall.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PendingExternalToolRequest".
+ */
+/** @experimental */
+export interface PendingExternalToolRequest {
+    /**
+     * Request ID to pass to session.tools.handlePendingToolCall
+     */
+    requestId: string;
+    /**
+     * Tool call ID assigned to this external tool invocation
+     */
+    toolCallId: string;
+    /**
+     * Name of the external tool to invoke
+     */
+    toolName: string;
+    /**
+     * Arguments to pass to the external tool
+     */
+    arguments?: JsonValue;
+    /**
+     * Stable identity of the provider that offered the tool, for hosts that route extension-owned tools by provider
+     */
+    providerId?: string;
+    /**
+     * Sub-agent instance identifier (the envelope agentId of its events) of the agent that issued the call; absent for calls issued by the root agent
+     */
+    agentId?: string;
+}
+/**
+ * External tool calls still waiting for a result.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PendingExternalToolRequestList".
+ */
+/** @experimental */
+export interface PendingExternalToolRequestList {
+    /**
+     * External tool calls of the session and its sub-agents that session.tools.handlePendingToolCall would still accept, in the order they were requested. Includes calls that were pending when the session was last suspended and resumed with pending work continued, so a host that did not observe the original external_tool.requested event can answer them.
+     */
+    items: PendingExternalToolRequest[];
+}
 /**
  * Pending permission prompt reconstructed from event history, with request ID and user-facing prompt details.
  *
@@ -21066,6 +21224,27 @@ export interface QueueWithdrawMessageResult {
      */
     interrupted: boolean;
 }
+/**
+ * A pending session quota warning, consumed once by takeWarnings.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "QuotaWarningProjection".
+ */
+/** @experimental */
+export interface QuotaWarningProjection {
+    /**
+     * Existing warning category.
+     */
+    warningType: string;
+    /**
+     * User-facing warning text.
+     */
+    message: string;
+    /**
+     * Related account or upgrade link.
+     */
+    url?: string;
+}
 /**
  * Event type to register consumer interest for, used by runtime gating logic.
  *
@@ -24079,6 +24258,137 @@ export interface SessionPruneResult {
      */
     dryRun: boolean;
 }
+/**
+ * Existing delegation guidance for an account without delegation access.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionQuotaDelegateWarning".
+ */
+/** @experimental */
+export interface SessionQuotaDelegateWarning {
+    /**
+     * User-facing guidance.
+     */
+    text: string;
+    /**
+     * Link to upgrade the account.
+     */
+    url: string;
+}
+/**
+ * The incumbent session-owned quota and account projection.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionQuotaProjection".
+ */
+/** @experimental */
+export interface SessionQuotaProjection {
+    /**
+     * Known quota snapshots, keyed by the provider's quota type.
+     */
+    snapshots: {
+        [k: string]: SessionQuotaSnapshot | undefined;
+    };
+    /**
+     * Provider-owned account quota state, including snapshots without numeric balances.
+     */
+    providerQuotas?: ProviderQuotaState[];
+    /**
+     * Whether the account uses the free limited Copilot plan.
+     */
+    isFreeUser: boolean;
+    /**
+     * Whether the account uses token-based billing.
+     */
+    isTbbUser: boolean;
+    planTier: SessionQuotaPlanTier;
+    /**
+     * Whether premium-request costs are billable.
+     */
+    premiumRequestsBillable: boolean;
+    /**
+     * Whether model cost columns should be shown.
+     */
+    modelCostColumnVisible: boolean;
+    /**
+     * Whether the account can delegate tasks to GitHub.
+     */
+    delegateAvailable: boolean;
+    /**
+     * Whether the account can sign up for Copilot Free.
+     */
+    canSignupForCopilotFree: boolean;
+    /**
+     * Whether dynamic workflows are enabled for the active account.
+     */
+    dynamicWorkflowsEnabled: boolean;
+    /**
+     * Whether dynamic workflows are visible under the session's feature flags.
+     */
+    dynamicWorkflowsUiVisible: boolean;
+    /**
+     * Upgrade link for a free account.
+     */
+    upgradeUrl?: string;
+    delegateWarning?: SessionQuotaDelegateWarning;
+}
+/**
+ * Session quota snapshot, preserving the incumbent numeric units and reset metadata.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionQuotaSnapshot".
+ */
+/** @experimental */
+export interface SessionQuotaSnapshot {
+    /**
+     * Whether the entitlement is unlimited.
+     */
+    isUnlimitedEntitlement: boolean;
+    /**
+     * Entitled quantity in this quota's units.
+     */
+    entitlementRequests: number;
+    /**
+     * Consumed quantity in this quota's units.
+     */
+    usedRequests: number;
+    /**
+     * Whether usage is allowed after quota exhaustion.
+     */
+    usageAllowedWithExhaustedQuota: boolean;
+    /**
+     * Additional usage in this quota's units.
+     */
+    overage: number;
+    /**
+     * Whether additional usage is allowed after quota exhaustion.
+     */
+    overageAllowedWithExhaustedQuota: boolean;
+    /**
+     * Percentage of the entitlement remaining.
+     */
+    remainingPercentage: number;
+    /**
+     * Quota reset time in milliseconds since the Unix epoch, when known.
+     */
+    resetDateEpochMs?: number;
+    /**
+     * Whether the reset time is estimated.
+     */
+    resetDateEstimated?: boolean;
+    /**
+     * Whether the provider reports available quota.
+     */
+    hasQuota?: boolean;
+    /**
+     * Whether this quota uses token-based billing.
+     */
+    tokenBasedBilling?: boolean;
+    /**
+     * Additional-usage budget cap, when provided.
+     */
+    overageEntitlement?: number;
+}
 /**
  * Session IDs to close, deactivate, and delete from disk.
  *
@@ -27164,6 +27474,15 @@ export interface ToolsGetCurrentMetadataResult {
 /** @experimental */
 export interface ToolsInitializeAndValidateResult {
 }
+/**
+ * No parameters; returns the external tool calls of the session and its sub-agents that are still waiting for a result.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ToolsListPendingRequestsRequest".
+ */
+/** @experimental */
+export interface ToolsListPendingRequestsRequest {
+}
 /**
  * Optional model identifier whose tool overrides should be applied to the listing.
  *
@@ -27838,219 +28157,6 @@ export interface UpdateSubagentSettingsRequest {
      */
     subagents?: SubagentSettings | null;
 }
-/**
- * Accumulated session usage metrics, including premium request cost, token counts, model breakdown, and code-change totals.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "UsageGetMetricsResult".
- */
-/** @experimental */
-export interface UsageGetMetricsResult {
-    /**
-     * Total user-initiated premium request cost across all models (may be fractional due to multipliers)
-     */
-    totalPremiumRequestCost: number;
-    /**
-     * Raw count of user-initiated API requests
-     */
-    totalUserRequests: number;
-    /**
-     * Session-wide accumulated nano-AI units cost
-     */
-    totalNanoAiu?: number;
-    /**
-     * Session-wide per-token-type accumulated token counts
-     */
-    tokenDetails?: {
-        [k: string]: UsageMetricsTokenDetail | undefined;
-    };
-    /**
-     * Total time spent in model API calls (milliseconds)
-     */
-    totalApiDurationMs: number;
-    /**
-     * ISO 8601 timestamp when the session started
-     */
-    sessionStartTime: string;
-    codeChanges: UsageMetricsCodeChanges;
-    /**
-     * Per-model token and request metrics, keyed by model identifier
-     */
-    modelMetrics: {
-        [k: string]: UsageMetricsModelMetric | undefined;
-    };
-    /**
-     * Per-agent usage metrics, keyed by agent instance identifier. The main conversation uses the stable key `main`.
-     */
-    agentMetrics?: {
-        [k: string]: UsageMetricsAgentMetric | undefined;
-    };
-    /**
-     * Currently active model identifier
-     */
-    currentModel?: string;
-    /**
-     * Input tokens from the most recent main-agent API call
-     */
-    lastCallInputTokens: number;
-    /**
-     * Output tokens from the most recent main-agent API call
-     */
-    lastCallOutputTokens: number;
-}
-/**
- * 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".
- */
-/** @experimental */
-export interface UsageMetricsTokenDetail {
-    /**
-     * Accumulated token count for this token type
-     */
-    tokenCount: number;
-}
-/**
- * Aggregated code change metrics
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "UsageMetricsCodeChanges".
- */
-/** @experimental */
-export interface UsageMetricsCodeChanges {
-    /**
-     * Total lines of code added
-     */
-    linesAdded: number;
-    /**
-     * Total lines of code removed
-     */
-    linesRemoved: number;
-    /**
-     * Number of distinct files modified
-     */
-    filesModifiedCount: number;
-    /**
-     * Distinct file paths modified during the session
-     */
-    filesModified: string[];
-}
-/**
- * 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".
- */
-/** @experimental */
-export interface UsageMetricsModelMetric {
-    requests: UsageMetricsModelMetricRequests;
-    usage: UsageMetricsModelMetricUsage;
-    /**
-     * Latest known prompt-cache expiration for this model. A timestamp in the past indicates that the observed cache has expired.
-     */
-    cacheExpiresAt?: string;
-    /**
-     * Accumulated nano-AI units cost for this model
-     */
-    totalNanoAiu?: number;
-    /**
-     * Token count details per type
-     */
-    tokenDetails?: {
-        [k: string]: UsageMetricsModelMetricTokenDetail | undefined;
-    };
-}
-/**
- * Request count and cost metrics for this model
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "UsageMetricsModelMetricRequests".
- */
-/** @experimental */
-export interface UsageMetricsModelMetricRequests {
-    /**
-     * Number of API requests made with this model
-     */
-    count: number;
-    /**
-     * User-initiated premium request cost (with multiplier applied)
-     */
-    cost: number;
-}
-/**
- * Token usage metrics for this model
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "UsageMetricsModelMetricUsage".
- */
-/** @experimental */
-export interface UsageMetricsModelMetricUsage {
-    /**
-     * Total input tokens consumed
-     */
-    inputTokens: number;
-    /**
-     * Total output tokens produced
-     */
-    outputTokens: number;
-    /**
-     * Total tokens read from prompt cache
-     */
-    cacheReadTokens: number;
-    /**
-     * Total tokens written to prompt cache
-     */
-    cacheWriteTokens: number;
-    /**
-     * Total output tokens used for reasoning
-     */
-    reasoningTokens?: number;
-}
-/**
- * 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".
- */
-/** @experimental */
-export interface UsageMetricsModelMetricTokenDetail {
-    /**
-     * Accumulated token count for this token type
-     */
-    tokenCount: number;
-}
-/**
- * Usage attributed to one agent instance, including its identity, API duration, AI units, and per-model breakdown.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "UsageMetricsAgentMetric".
- */
-/** @experimental */
-export interface UsageMetricsAgentMetric {
-    /**
-     * Configured agent name, when this is a subagent
-     */
-    agentName?: string;
-    /**
-     * Human-readable label for this subagent invocation, copied from the originating `subagent.started` event. For task-tool subagents this is the invocation's task description rather than the agent's configured display name, so group by `agentName` for stable per-agent labels.
-     */
-    agentDisplayName?: string;
-    /**
-     * Time spent in model API calls by this agent, in milliseconds
-     */
-    totalApiDurationMs: number;
-    /**
-     * Accumulated nano-AI units cost for this agent
-     */
-    totalNanoAiu: number;
-    /**
-     * Per-model usage for this agent, keyed by model identifier
-     */
-    modelMetrics: {
-        [k: string]: UsageMetricsModelMetric | undefined;
-    };
-}
 /**
  * Result of a user-requested shell command.
  *
@@ -29731,6 +29837,11 @@ export interface HostCreateSessionRequest {
      * Resume an app-owned durable session instead of creating a new session.
      */
     resume?: boolean;
+    /**
+     * For an explicit publication, borrow an existing owning-connection resident
+     * instead of invoking the resume factory. Cold sessions still use the factory.
+     */
+    preferResident?: boolean;
     /**
      * Host-selected SDK creation or resume settings, without executable callbacks or tools.
      */
@@ -29827,6 +29938,18 @@ export interface SessionWorkflowPauseAtCheckpointResult {
     action: WorkflowPauseCheckpointAction;
 }
 /** @experimental */
+export interface SessionModelClearStartupSeedResult {
+    cleared: boolean;
+}
+/** @experimental */
+export interface SessionModelClearStartupSeedRequest {
+    expectedModel: string;
+    /**
+     * Provider captured with the startup seed; omission matches only an unqualified seed.
+     */
+    expectedProviderId?: string;
+}
+/** @experimental */
 export interface SessionModelListRequest {
     /**
      * If true, bypasses the per-session model list cache and re-fetches from CAPI.
@@ -29999,6 +30122,141 @@ export interface SessionHistoryCompactRequest {
      */
     tokenLimit?: number;
 }
+/**
+ * Internal absolute code-change totals reported by the owning host.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionUsageSetCodeChangesRequest".
+ */
+/** @experimental */
+export interface SessionUsageSetCodeChangesRequest {
+    /**
+     * Absolute added-line total, replacing the previous reading.
+     */
+    linesAdded: number;
+    /**
+     * Absolute removed-line total, replacing the previous reading.
+     */
+    linesRemoved: number;
+    /**
+     * Absolute changed-file count; omission preserves the previous count.
+     */
+    filesCount?: number;
+}
+/**
+ * The incumbent session-owned quota and account projection.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionQuotaGetResult".
+ */
+/** @experimental */
+export interface SessionQuotaGetResult {
+    /**
+     * Known quota snapshots, keyed by the provider's quota type.
+     */
+    snapshots: {
+        [k: string]: SessionQuotaSnapshot | undefined;
+    };
+    /**
+     * Provider-owned account quota state, including snapshots without numeric balances.
+     */
+    providerQuotas?: ProviderQuotaState[];
+    /**
+     * Whether the account uses the free limited Copilot plan.
+     */
+    isFreeUser: boolean;
+    /**
+     * Whether the account uses token-based billing.
+     */
+    isTbbUser: boolean;
+    planTier: SessionQuotaPlanTier;
+    /**
+     * Whether premium-request costs are billable.
+     */
+    premiumRequestsBillable: boolean;
+    /**
+     * Whether model cost columns should be shown.
+     */
+    modelCostColumnVisible: boolean;
+    /**
+     * Whether the account can delegate tasks to GitHub.
+     */
+    delegateAvailable: boolean;
+    /**
+     * Whether the account can sign up for Copilot Free.
+     */
+    canSignupForCopilotFree: boolean;
+    /**
+     * Whether dynamic workflows are enabled for the active account.
+     */
+    dynamicWorkflowsEnabled: boolean;
+    /**
+     * Whether dynamic workflows are visible under the session's feature flags.
+     */
+    dynamicWorkflowsUiVisible: boolean;
+    /**
+     * Upgrade link for a free account.
+     */
+    upgradeUrl?: string;
+    delegateWarning?: SessionQuotaDelegateWarning;
+}
+/**
+ * The incumbent session-owned quota and account projection.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionQuotaRefreshResult".
+ */
+/** @experimental */
+export interface SessionQuotaRefreshResult {
+    /**
+     * Known quota snapshots, keyed by the provider's quota type.
+     */
+    snapshots: {
+        [k: string]: SessionQuotaSnapshot | undefined;
+    };
+    /**
+     * Provider-owned account quota state, including snapshots without numeric balances.
+     */
+    providerQuotas?: ProviderQuotaState[];
+    /**
+     * Whether the account uses the free limited Copilot plan.
+     */
+    isFreeUser: boolean;
+    /**
+     * Whether the account uses token-based billing.
+     */
+    isTbbUser: boolean;
+    planTier: SessionQuotaPlanTier;
+    /**
+     * Whether premium-request costs are billable.
+     */
+    premiumRequestsBillable: boolean;
+    /**
+     * Whether model cost columns should be shown.
+     */
+    modelCostColumnVisible: boolean;
+    /**
+     * Whether the account can delegate tasks to GitHub.
+     */
+    delegateAvailable: boolean;
+    /**
+     * Whether the account can sign up for Copilot Free.
+     */
+    canSignupForCopilotFree: boolean;
+    /**
+     * Whether dynamic workflows are enabled for the active account.
+     */
+    dynamicWorkflowsEnabled: boolean;
+    /**
+     * Whether dynamic workflows are visible under the session's feature flags.
+     */
+    dynamicWorkflowsUiVisible: boolean;
+    /**
+     * Upgrade link for a free account.
+     */
+    upgradeUrl?: string;
+    delegateWarning?: SessionQuotaDelegateWarning;
+}
 /** @experimental */
 export interface SessionLimitPredictionPredictRequest {
     /**
@@ -30226,6 +30484,14 @@ export declare function createServerRpc(connection: MessageConnection): {
          * @returns The existing runtime identity and its resource on the listener.
          */
         publishSession: (params: HostPublishSessionRequest) => Promise<HostPublishSessionResult>;
+        /**
+         * Reads the complete advertised live and dormant session catalog of an existing host owned by this connection. Does not start hosting, subscribe to sessions, or guarantee resumability.
+         *
+         * @param params Reads a running host's catalog or the runtime's saved default catalog.
+         *
+         * @returns The complete live and dormant advertised catalog, without subscribing to sessions.
+         */
+        listSessions: (params: HostListSessionsRequest) => Promise<HostListSessionsResult>;
         /**
          * Starts a connection-owned AHP host with explicit localServer and/or githubEnvironment transports as a supervised SDK participant.
          *
@@ -32611,6 +32877,12 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Indicates whether the external tool call result was handled successfully.
          */
         handlePendingToolCall: (params: HandlePendingToolCallRequest) => Promise<HandlePendingToolCallResult>;
+        /**
+         * Lists the external tool calls of the session and its sub-agents that are still waiting for session.tools.handlePendingToolCall.
+         *
+         * @returns External tool calls still waiting for a result.
+         */
+        listPendingRequests: () => Promise<PendingExternalToolRequestList>;
         /**
          * Resolves, builds, and validates the runtime tool list for the session.
          *
@@ -33300,6 +33572,27 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         getMetrics: () => Promise<UsageGetMetricsResult>;
     };
     /** @experimental */
+    quota: {
+        /**
+         * Gets the session's current quota and account projection without making a network request.
+         *
+         * @returns The incumbent session-owned quota and account projection.
+         */
+        get: () => Promise<SessionQuotaGetResult>;
+        /**
+         * Refreshes the session's provider model catalog bypassing its cache, folds quota snapshots into session state, and returns the updated projection. Failures leave the last known quota intact.
+         *
+         * @returns The incumbent session-owned quota and account projection.
+         */
+        refresh: () => Promise<SessionQuotaRefreshResult>;
+        /**
+         * Returns and clears the session's pending quota warnings. Reading or refreshing quota does not drain warnings.
+         *
+         * @returns Pending warnings returned and cleared by session.quota.takeWarnings.
+         */
+        takeWarnings: () => Promise<SessionQuotaTakeWarningsResult>;
+    };
+    /** @experimental */
     limitPrediction: {
         /**
          * Predicts an AI-credit session limit for the session's resolved model. Returns an unavailable result instead of falling back when the current model is unresolved auto.