@github/copilot-sdk 1.0.9-preview.2 → 1.0.9

package/dist/generated/rpc.d.ts

@@ -398,6 +398,32 @@ export type DebugCollectLogsResultKind =
 "archive"
 /** A directory containing redacted files was written. */
  | "directory";
+/**
+ * Persisted extension discovery source
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DiscoveredExtensionSource".
+ */
+/** @experimental */
+export type DiscoveredExtensionSource = 
+/** Extension discovered from the user's extensions directory. */
+"user"
+/** Extension contributed by an installed plugin. */
+ | "plugin";
+/**
+ * Effective extension loading and agent-management mode
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DiscoveredExtensionMode".
+ */
+/** @experimental */
+export type DiscoveredExtensionMode = 
+/** Extensions are not loaded. */
+"disabled"
+/** Extensions are loaded, but the agent cannot create, reload, or manage them. */
+ | "load_only"
+/** Extensions are loaded and the agent can create, reload, and manage them. */
+ | "load_and_augment";
 /**
  * Server transport type: stdio, http, sse (deprecated), or memory
  *
@@ -435,7 +461,19 @@ export type EventsAgentScope =
 /** Return events from all agents. */
  | "all";
 /**
- * Cursor status: 'ok' means the cursor was applied successfully; 'expired' means the cursor referred to an event that no longer exists in history (e.g. truncated or compacted away) and the read started from the beginning of the remaining history.
+ * Direction to page through the session's persisted event history. 'forward' pages from the cursor toward newer events; 'backward' returns the newest window first (tail-first) and pages toward older events. Events within a returned batch are always chronological (oldest-to-newest), even for a backward read.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "EventsReadDirection".
+ */
+/** @experimental */
+export type EventsReadDirection = 
+/** Page from the cursor toward newer events (default). */
+"forward"
+/** Tail-first: return the newest events and page toward older events. */
+ | "backward";
+/**
+ * Cursor status: 'ok' means the cursor was applied successfully; 'expired' means the cursor referred to an event that no longer exists in history (e.g. truncated or compacted away) and the read fell back to a boundary of the remaining history (the beginning for a forward read, the tail for a backward read). The fallback page is a fresh boundary snapshot, not a continuation of the requested cursor, so it may overlap already-rendered events; on 'expired' a consumer should reset/rebase its pagination state (or deduplicate by event id) before continuing from the returned cursor.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "EventsCursorStatus".
@@ -1447,7 +1485,7 @@ export type PermissionDecision = PermissionDecisionApproveOnce | PermissionDecis
  * via the `definition` "PermissionDecisionApproveForSessionApproval".
  */
 /** @experimental */
-export type PermissionDecisionApproveForSessionApproval = PermissionDecisionApproveForSessionApprovalCommands | PermissionDecisionApproveForSessionApprovalRead | PermissionDecisionApproveForSessionApprovalWrite | PermissionDecisionApproveForSessionApprovalMcp | PermissionDecisionApproveForSessionApprovalMcpSampling | PermissionDecisionApproveForSessionApprovalMemory | PermissionDecisionApproveForSessionApprovalCustomTool | PermissionDecisionApproveForSessionApprovalExtensionManagement | PermissionDecisionApproveForSessionApprovalExtensionPermissionAccess;
+export type PermissionDecisionApproveForSessionApproval = PermissionDecisionApproveForSessionApprovalCommands | PermissionDecisionApproveForSessionApprovalRead | PermissionDecisionApproveForSessionApprovalWrite | PermissionDecisionApproveForSessionApprovalMcp | PermissionDecisionApproveForSessionApprovalMcpSampling | PermissionDecisionApproveForSessionApprovalMemory | PermissionDecisionApproveForSessionApprovalCustomTool | PermissionDecisionApproveForSessionApprovalExtensionManagement | PermissionDecisionApproveForSessionApprovalFactory | PermissionDecisionApproveForSessionApprovalExtensionPermissionAccess;
 /**
  * Approval to persist for this location
  *
@@ -1455,7 +1493,7 @@ export type PermissionDecisionApproveForSessionApproval = PermissionDecisionAppr
  * via the `definition` "PermissionDecisionApproveForLocationApproval".
  */
 /** @experimental */
-export type PermissionDecisionApproveForLocationApproval = PermissionDecisionApproveForLocationApprovalCommands | PermissionDecisionApproveForLocationApprovalRead | PermissionDecisionApproveForLocationApprovalWrite | PermissionDecisionApproveForLocationApprovalMcp | PermissionDecisionApproveForLocationApprovalMcpSampling | PermissionDecisionApproveForLocationApprovalMemory | PermissionDecisionApproveForLocationApprovalCustomTool | PermissionDecisionApproveForLocationApprovalExtensionManagement | PermissionDecisionApproveForLocationApprovalExtensionPermissionAccess;
+export type PermissionDecisionApproveForLocationApproval = PermissionDecisionApproveForLocationApprovalCommands | PermissionDecisionApproveForLocationApprovalRead | PermissionDecisionApproveForLocationApprovalWrite | PermissionDecisionApproveForLocationApprovalMcp | PermissionDecisionApproveForLocationApprovalMcpSampling | PermissionDecisionApproveForLocationApprovalMemory | PermissionDecisionApproveForLocationApprovalCustomTool | PermissionDecisionApproveForLocationApprovalExtensionManagement | PermissionDecisionApproveForLocationApprovalFactory | PermissionDecisionApproveForLocationApprovalExtensionPermissionAccess;
 /**
  * Tool approval to persist and apply
  *
@@ -1463,7 +1501,7 @@ export type PermissionDecisionApproveForLocationApproval = PermissionDecisionApp
  * via the `definition` "PermissionsLocationsAddToolApprovalDetails".
  */
 /** @experimental */
-export type PermissionsLocationsAddToolApprovalDetails = PermissionsLocationsAddToolApprovalDetailsCommands | PermissionsLocationsAddToolApprovalDetailsRead | PermissionsLocationsAddToolApprovalDetailsWrite | PermissionsLocationsAddToolApprovalDetailsMcp | PermissionsLocationsAddToolApprovalDetailsMcpSampling | PermissionsLocationsAddToolApprovalDetailsMemory | PermissionsLocationsAddToolApprovalDetailsCustomTool | PermissionsLocationsAddToolApprovalDetailsExtensionManagement | PermissionsLocationsAddToolApprovalDetailsExtensionPermissionAccess;
+export type PermissionsLocationsAddToolApprovalDetails = PermissionsLocationsAddToolApprovalDetailsCommands | PermissionsLocationsAddToolApprovalDetailsRead | PermissionsLocationsAddToolApprovalDetailsWrite | PermissionsLocationsAddToolApprovalDetailsMcp | PermissionsLocationsAddToolApprovalDetailsMcpSampling | PermissionsLocationsAddToolApprovalDetailsMemory | PermissionsLocationsAddToolApprovalDetailsCustomTool | PermissionsLocationsAddToolApprovalDetailsExtensionManagement | PermissionsLocationsAddToolApprovalDetailsFactory | PermissionsLocationsAddToolApprovalDetailsExtensionPermissionAccess;
 /**
  * Whether the location is a git repo or directory
  *
@@ -2666,6 +2704,7 @@ export interface CopilotUserResponseEndpoints {
     "origin-tracker"?: string;
     proxy?: string;
     telemetry?: string;
+    exp?: string;
 }
 /**
  * Quota snapshot map from the raw Copilot user-response passthrough, with chat, completions, premium-interactions, and other entries.
@@ -3508,6 +3547,23 @@ export interface AgentSelectRequest {
 export interface AgentSelectResult {
     agent: AgentInfo;
 }
+/**
+ * An in-memory authored prompt override for an available agent.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AgentSetPromptRequest".
+ */
+/** @experimental */
+export interface AgentSetPromptRequest {
+    /**
+     * Stable effective agent id. Plugin namespace separators are normalized.
+     */
+    id: string;
+    /**
+     * Replacement authored prompt. Empty text is valid.
+     */
+    prompt: string;
+}
 /**
  * Optional project paths to include when enumerating agent discovery directories.
  *
@@ -4588,6 +4644,86 @@ export interface DebugCollectLogsSkippedEntry {
      */
     reason: string;
 }
+/**
+ * Discovered extension metadata and persistent enablement state.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DiscoveredExtension".
+ */
+/** @experimental */
+export interface DiscoveredExtension {
+    /**
+     * Source-qualified ID accepted by both server and session extension enablement methods
+     */
+    id: string;
+    /**
+     * Human-readable extension name
+     */
+    name: string;
+    /**
+     * Absolute path to the extension entry module, suitable for revealing it in a file manager
+     */
+    path: string;
+    source: DiscoveredExtensionSource;
+    /**
+     * Whether this extension's persistent per-ID preference is enabled
+     */
+    enabled: boolean;
+    plugin?: DiscoveredExtensionPlugin;
+}
+/**
+ * Installed plugin that contributes a discovered extension.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DiscoveredExtensionPlugin".
+ */
+/** @experimental */
+export interface DiscoveredExtensionPlugin {
+    /**
+     * Installed plugin name
+     */
+    name: string;
+}
+/**
+ * Extensions discovered from persisted Copilot home state and their effective loading mode. Launch-scoped additional plugins are not included.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DiscoveredExtensions".
+ */
+/** @experimental */
+export interface DiscoveredExtensions {
+    /**
+     * Discovered user and enabled installed-plugin extensions from persisted Copilot home state
+     */
+    extensions: DiscoveredExtension[];
+    mode: DiscoveredExtensionMode;
+}
+/**
+ * Source-qualified extension identifiers to persistently disable for future sessions.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DiscoveredExtensionsDisableRequest".
+ */
+/** @experimental */
+export interface DiscoveredExtensionsDisableRequest {
+    /**
+     * Source-qualified user or plugin extension IDs to disable
+     */
+    ids: string[];
+}
+/**
+ * Source-qualified extension identifiers to persistently enable for future sessions.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "DiscoveredExtensionsEnableRequest".
+ */
+/** @experimental */
+export interface DiscoveredExtensionsEnableRequest {
+    /**
+     * Source-qualified user or plugin extension IDs to enable
+     */
+    ids: string[];
+}
 /**
  * MCP server discovered by `mcp.discover`, with config source, optional plugin source, transport type, and enabled state.
  *
@@ -4658,13 +4794,20 @@ export interface EventLogReadRequest {
      */
     max?: number;
     /**
-     * Milliseconds to wait for new events when the cursor is at the tail of history. 0 (default) returns immediately even if no events are available. Capped at 30000ms. Ephemeral events that arrive during the wait are delivered in this batch but are NOT replayable on a subsequent read (use a non-zero waitMs in your next call to capture future ephemerals as they happen).
+     * Milliseconds to wait for new events when the cursor is at the tail of history. 0 (default) returns immediately even if no events are available. Capped at 30000ms. Ephemeral events that arrive during the wait are delivered in this batch but are NOT replayable on a subsequent read (use a non-zero waitMs in your next call to capture future ephemerals as they happen). This applies to forward reads only: a backward read always returns immediately and ignores `waitMs`, because backward paging covers persisted history only while new events append at the tail (the opposite end from a backward page), so no blocking or ephemeral delivery can occur.
      */
     waitMs?: number;
     types?: EventLogTypes;
     agentScope?: EventsAgentScope;
     /**
-     * When false, skip ephemeral events entirely and return only durable (persisted) events. History-backfill callers that discard ephemerals anyway should set this so the read is bounded by the durable log length instead of racing the ephemeral ring on a busy session. Defaults to true (ephemerals are interleaved with durable events in creation order).
+     * Optional non-empty list of subagent identifiers. When provided, only events owned by one of these agents are returned; ownership recognizes the event envelope's agentId plus legacy data.agentId and data.parentToolCallId markers. This filter takes precedence over agentScope.
+     *
+     * @minItems 1
+     */
+    agentIds?: [string, ...string[]];
+    direction?: EventsReadDirection;
+    /**
+     * When false, skip ephemeral events entirely and return only durable (persisted) events. History-backfill callers that discard ephemerals anyway should set this so the read is bounded by the durable log length instead of racing the ephemeral ring on a busy session. Defaults to true (ephemerals are interleaved with durable events in creation order). Ignored by backward reads, which always cover persisted history only.
      */
     includeEphemeral?: boolean;
 }
@@ -4703,15 +4846,15 @@ export interface EventLogTailResult {
 /** @experimental */
 export interface EventsReadResult {
     /**
-     * Session events for this batch, merged into a single stream in creation order: durable (persisted) events and ephemeral events interleave exactly as they were emitted. Set `includeEphemeral: false` to receive only durable events. Ephemeral events are never replayable once pruned from the in-memory ring, so a consumer that needs them should keep reading with a non-zero `waitMs`.
+     * Session events for this batch, merged into a single stream in creation order: durable (persisted) events and ephemeral events interleave exactly as they were emitted. Set `includeEphemeral: false` to receive only durable events. Ephemeral events are never replayable once pruned from the in-memory ring, so a consumer that needs them should keep reading with a non-zero `waitMs`. For a backward (tail-first) read, the returned window contains persisted events only, still in chronological (oldest-to-newest) append order.
      */
     events: SessionEvent[];
     /**
-     * Opaque cursor for the next read. Pass back unchanged in the next read.cursor to continue from where this read left off. Always present, even when no events were returned.
+     * Opaque cursor for the next read. Pass back unchanged in the next read.cursor to continue from where this read left off. Always present, even when no events were returned. For a backward read this cursor pages toward OLDER events; keep passing `direction: backward` with it (the cursor is also self-describing, so backward paging continues correctly).
      */
     cursor: string;
     /**
-     * True when the read returned `max` events and more events are available immediately. When false, the next read with a non-zero `waitMs` will block until a new event arrives or the wait expires.
+     * True when more events are available in the read's direction. For a forward read, true means the batch returned `max` events and more are available immediately. For a backward read, true means older persisted events remain before the returned window.
      */
     hasMore: boolean;
     cursorStatus: EventsCursorStatus;
@@ -5971,6 +6114,32 @@ export interface HistoryCancelBackgroundCompactionResult {
      */
     cancelled: boolean;
 }
+/**
+ * Parameters for clearing the conversation and seeding the window that replaces it.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HistoryClearContextRequest".
+ */
+/** @experimental */
+export interface HistoryClearContextRequest {
+    /**
+     * First user message of the fresh context window. Required: a cleared window holding only system and developer messages is not a conversation a model can answer, so every clear seeds the window it creates. Delivered by the enclosing turn driver once the agentic loop exits, which is why the call must be made from inside a tool handler.
+     */
+    prompt: string;
+}
+/**
+ * What a successful clear removed. A clear that could not be applied rejects instead of reporting a count.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "HistoryClearContextResult".
+ */
+/** @experimental */
+export interface HistoryClearContextResult {
+    /**
+     * Number of non-system, non-developer messages that were removed from the conversation. Zero only when the window already held no conversation.
+     */
+    messagesCleared: number;
+}
 /**
  * Post-compaction context window usage breakdown
  *
@@ -6284,6 +6453,10 @@ export interface InstalledPlugin {
      */
     cache_path?: string;
     source?: InstalledPluginSource;
+    /**
+     * Per-plugin source fingerprint (a SHA-256 hash of the plugin's catalog source spec plus its resolved source subtree — NOT a Git commit SHA) captured at marketplace install/update time. Auto-update compares it against the freshly recomputed fingerprint to detect a content change that does not bump the version. Absent for pre-existing installs and for direct (non-marketplace) installs.
+     */
+    source_sha?: string;
 }
 /**
  * Source descriptor for a direct GitHub plugin install, with `owner/repo`, optional ref or full commit SHA, and optional subpath.
@@ -7818,6 +7991,23 @@ export interface McpToolUi {
      */
     visibility?: McpToolUiVisibility[];
 }
+/**
+ * Identifies the MCP server whose persisted OAuth credentials were updated.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpOauthAuthenticationStateChangedRequest".
+ */
+/** @experimental */
+export interface McpOauthAuthenticationStateChangedRequest {
+    /**
+     * Name of the MCP server whose OAuth credentials were updated. Omit only when the host cannot identify the server.
+     */
+    serverName?: string;
+    /**
+     * Whether the target session must mint a session-scoped access token instead of reusing a shared access token persisted by another session.
+     */
+    refreshSessionToken?: boolean;
+}
 /**
  * Pending MCP OAuth request ID and host-provided token or cancellation response.
  *
@@ -8635,10 +8825,6 @@ export interface Model {
      * Supported reasoning effort levels (only present if model supports reasoning effort)
      */
     supportedReasoningEfforts?: string[];
-    /**
-     * Default reasoning effort level (only present if model supports reasoning effort)
-     */
-    defaultReasoningEffort?: string;
     modelPickerCategory?: ModelPickerCategory;
     modelPickerPriceCategory?: ModelPickerPriceCategory;
 }
@@ -8986,7 +9172,7 @@ export interface ModelSwitchToRequest {
      */
     modelId: string;
     /**
-     * Reasoning effort level to use for the model. "none" disables reasoning.
+     * Reasoning effort level to use for the model. CAPI values are model-defined and validated against the selected model; BYOK providers may define additional values. "none" disables reasoning. When omitted, no effort override is applied.
      */
     reasoningEffort?: string;
     reasoningSummary?: ReasoningSummary;
@@ -9355,6 +9541,23 @@ export interface PermissionDecisionApproveForSessionApprovalExtensionManagement
      */
     operation?: string;
 }
+/**
+ * Session-scoped factory approval, optionally narrowed by approval key.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PermissionDecisionApproveForSessionApprovalFactory".
+ */
+/** @experimental */
+export interface PermissionDecisionApproveForSessionApprovalFactory {
+    /**
+     * Approval covering factory operations.
+     */
+    kind: "factory";
+    /**
+     * Optional factory operation name or canonical approval key; when omitted, the approval covers all factory operations.
+     */
+    approvalKey?: string;
+}
 /**
  * Session-scoped approval details for an extension's permission-gated capability access, keyed by extension name.
  *
@@ -9518,6 +9721,23 @@ export interface PermissionDecisionApproveForLocationApprovalExtensionManagement
      */
     operation?: string;
 }
+/**
+ * Location-scoped factory approval, optionally narrowed by approval key.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PermissionDecisionApproveForLocationApprovalFactory".
+ */
+/** @experimental */
+export interface PermissionDecisionApproveForLocationApprovalFactory {
+    /**
+     * Approval covering factory operations.
+     */
+    kind: "factory";
+    /**
+     * Optional factory operation name or canonical approval key; when omitted, the approval covers all factory operations.
+     */
+    approvalKey?: string;
+}
 /**
  * Location-scoped approval details for an extension's permission-gated capability access, keyed by extension name.
  *
@@ -9893,6 +10113,23 @@ export interface PermissionsLocationsAddToolApprovalDetailsExtensionManagement {
      */
     operation?: string;
 }
+/**
+ * Location-persisted factory approval, optionally narrowed by approval key.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "PermissionsLocationsAddToolApprovalDetailsFactory".
+ */
+/** @experimental */
+export interface PermissionsLocationsAddToolApprovalDetailsFactory {
+    /**
+     * Approval covering factory operations.
+     */
+    kind: "factory";
+    /**
+     * Optional factory operation name or canonical approval key; when omitted, the approval covers all factory operations.
+     */
+    approvalKey?: string;
+}
 /**
  * Location-persisted tool approval details for an extension's permission-gated capability access, keyed by extension name.
  *
@@ -10400,7 +10637,7 @@ export interface PermissionsSetAllowAllRequest {
      */
     enabled?: boolean;
     /**
-     * Optional model id for the `auto` mode auto-approval LLM judging. Only meaningful when `mode` is `auto`; ignored otherwise. When omitted, the session's active model is used.
+     * Optional model id for the `auto` mode auto-approval LLM judging. Only meaningful when `mode` is `auto`; ignored otherwise. When omitted, the session resolves a default judge model: `gpt-5.5` for CAPI sessions and the session's active model for BYOK sessions.
      */
     model?: string;
     source?: PermissionsSetAllowAllSource;
@@ -12360,6 +12597,10 @@ export interface SandboxConfig {
      * 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;
+    /**
+     * 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 exporting CARGO_HOME/GOPATH/etc. Default: true (enabled by default; set to false to opt out).
+     */
+    allowDevToolCaches?: boolean;
 }
 /**
  * User-managed sandbox policy fragment merged into the auto-discovered base policy.
@@ -13582,6 +13823,10 @@ export interface SessionInstalledPlugin {
      */
     cache_path?: string;
     source?: SessionInstalledPluginSource;
+    /**
+     * Per-plugin source fingerprint (a SHA-256 hash of the plugin's catalog source spec plus its resolved source subtree — NOT a Git commit SHA) captured at marketplace install/update time. Auto-update compares it against the freshly recomputed fingerprint to detect a content change that does not bump the version. Absent for pre-existing installs and for direct (non-marketplace) installs.
+     */
+    source_sha?: string;
 }
 /**
  * Source descriptor for a direct GitHub plugin install, with `owner/repo`, optional ref or full commit SHA, and optional subpath.
@@ -13874,7 +14119,7 @@ export interface SessionOpenOptions {
      */
     model?: string;
     /**
-     * Initial reasoning effort level.
+     * Initial reasoning effort level. CAPI values are model-defined and validated against the selected model; BYOK providers may define additional values. When omitted, no effort override is applied.
      */
     reasoningEffort?: string;
     reasoningSummary?: SessionOpenOptionsReasoningSummary;
@@ -15112,7 +15357,7 @@ export interface SessionUpdateOptionsParams {
     model?: string;
     modelCapabilitiesOverrides?: ModelCapabilitiesOverride;
     /**
-     * Reasoning effort for the selected model (model-defined enum).
+     * Reasoning effort for the selected model. CAPI values are model-defined and validated against the selected model; BYOK providers may define additional values. When omitted, no effort override is applied.
      */
     reasoningEffort?: string;
     reasoningSummary?: OptionsUpdateReasoningSummary;
@@ -17896,6 +18141,27 @@ export declare function createServerRpc(connection: MessageConnection): {
         discover: (params: McpDiscoverRequest) => Promise<McpDiscoverResult>;
     };
     /** @experimental */
+    extensions: {
+        /**
+         * Discovers user and enabled installed-plugin extensions from persisted Copilot home state, including enablement preferences. Launch-scoped additional plugins are not included.
+         *
+         * @returns Extensions discovered from persisted Copilot home state and their effective loading mode. Launch-scoped additional plugins are not included.
+         */
+        discover: () => Promise<DiscoveredExtensions>;
+        /**
+         * Persistently enables extension IDs for future sessions. Active sessions are unchanged; use session.extensions.enable to update them.
+         *
+         * @param params Source-qualified extension identifiers to persistently enable for future sessions.
+         */
+        enable: (params: DiscoveredExtensionsEnableRequest) => Promise<void>;
+        /**
+         * Persistently disables extension IDs for future sessions. Active sessions are unchanged; use session.extensions.disable to update them.
+         *
+         * @param params Source-qualified extension identifiers to persistently disable for future sessions.
+         */
+        disable: (params: DiscoveredExtensionsDisableRequest) => Promise<void>;
+    };
+    /** @experimental */
     plugins: {
         /**
          * Lists plugins installed in user/global state.
@@ -18812,6 +19078,12 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Agents available to the session.
          */
         list: (params?: SessionAgentListRequest) => Promise<AgentList>;
+        /**
+         * Sets an in-memory authored prompt override for an available agent. For built-in agents, this replaces only the static base prompt while preserving runtime-owned dynamic prompt composition and behavior. The special `general-purpose` agent is not overrideable. Overrides are not persisted; resumed and forked sessions start without them, so the host must re-apply them.
+         *
+         * @param params An in-memory authored prompt override for an available agent.
+         */
+        setPrompt: (params: AgentSetPromptRequest) => Promise<void>;
         /**
          * Gets the currently selected custom agent for the session.
          *
@@ -19053,6 +19325,12 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
              * @returns Indicates whether the pending MCP OAuth response was accepted.
              */
             handlePendingRequest: (params: McpOauthHandlePendingRequest) => Promise<McpOauthHandlePendingResult>;
+            /**
+             * Notifies the session that MCP OAuth authentication succeeded and updated credentials were persisted, so cached tool definitions can be refreshed.
+             *
+             * @param params Identifies the MCP server whose persisted OAuth credentials were updated.
+             */
+            authenticationStateChanged: (params: McpOauthAuthenticationStateChangedRequest) => Promise<void>;
             /**
              * Starts OAuth authentication for a remote MCP server.
              *
@@ -19777,6 +20055,14 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Markdown summary of the conversation context (empty when not available).
          */
         summarizeForHandoff: () => Promise<HistorySummarizeForHandoffResult>;
+        /**
+         * Clears the session's conversation history, keeping only system and developer messages, and seeds the fresh context window with a first user message. Must be called from inside a tool handler: the clear has to drop the results of the tool calls its wipe orphans, and it rejects when no tool call is in flight.
+         *
+         * @param params Parameters for clearing the conversation and seeding the window that replaces it.
+         *
+         * @returns What a successful clear removed. A clear that could not be applied rejects instead of reporting a count.
+         */
+        clearContext: (params: HistoryClearContextRequest) => Promise<HistoryClearContextResult>;
     };
     /** @experimental */
     queue: {
@@ -19854,7 +20140,7 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
     /** @experimental */
     eventLog: {
         /**
-         * Reads a batch of session events from a cursor, optionally waiting for new events.
+         * Reads a batch of session events from a cursor, optionally waiting for new events. Supports tail-first reads via `direction: backward`.
          *
          * @param params Cursor, batch size, and optional long-poll/filter parameters for reading session events.
          *

package/dist/generated/rpc.js

@@ -143,6 +143,27 @@ function createServerRpc(connection) {
       discover: async (params) => connection.sendRequest("mcp.discover", params)
     },
     /** @experimental */
+    extensions: {
+      /**
+       * Discovers user and enabled installed-plugin extensions from persisted Copilot home state, including enablement preferences. Launch-scoped additional plugins are not included.
+       *
+       * @returns Extensions discovered from persisted Copilot home state and their effective loading mode. Launch-scoped additional plugins are not included.
+       */
+      discover: async () => connection.sendRequest("extensions.discover", {}),
+      /**
+       * Persistently enables extension IDs for future sessions. Active sessions are unchanged; use session.extensions.enable to update them.
+       *
+       * @param params Source-qualified extension identifiers to persistently enable for future sessions.
+       */
+      enable: async (params) => connection.sendRequest("extensions.enable", params),
+      /**
+       * Persistently disables extension IDs for future sessions. Active sessions are unchanged; use session.extensions.disable to update them.
+       *
+       * @param params Source-qualified extension identifiers to persistently disable for future sessions.
+       */
+      disable: async (params) => connection.sendRequest("extensions.disable", params)
+    },
+    /** @experimental */
     plugins: {
       /**
        * Lists plugins installed in user/global state.
@@ -1137,6 +1158,12 @@ function createSessionRpc(connection, sessionId) {
        * @returns Agents available to the session.
        */
       list: async (params) => connection.sendRequest("session.agent.list", { sessionId, ...params }),
+      /**
+       * Sets an in-memory authored prompt override for an available agent. For built-in agents, this replaces only the static base prompt while preserving runtime-owned dynamic prompt composition and behavior. The special `general-purpose` agent is not overrideable. Overrides are not persisted; resumed and forked sessions start without them, so the host must re-apply them.
+       *
+       * @param params An in-memory authored prompt override for an available agent.
+       */
+      setPrompt: async (params) => connection.sendRequest("session.agent.setPrompt", { sessionId, ...params }),
       /**
        * Gets the currently selected custom agent for the session.
        *
@@ -1378,6 +1405,12 @@ function createSessionRpc(connection, sessionId) {
          * @returns Indicates whether the pending MCP OAuth response was accepted.
          */
         handlePendingRequest: async (params) => connection.sendRequest("session.mcp.oauth.handlePendingRequest", { sessionId, ...params }),
+        /**
+         * Notifies the session that MCP OAuth authentication succeeded and updated credentials were persisted, so cached tool definitions can be refreshed.
+         *
+         * @param params Identifies the MCP server whose persisted OAuth credentials were updated.
+         */
+        authenticationStateChanged: async (params) => connection.sendRequest("session.mcp.oauth.authenticationStateChanged", { sessionId, ...params }),
         /**
          * Starts OAuth authentication for a remote MCP server.
          *
@@ -2101,7 +2134,15 @@ function createSessionRpc(connection, sessionId) {
        *
        * @returns Markdown summary of the conversation context (empty when not available).
        */
-      summarizeForHandoff: async () => connection.sendRequest("session.history.summarizeForHandoff", { sessionId })
+      summarizeForHandoff: async () => connection.sendRequest("session.history.summarizeForHandoff", { sessionId }),
+      /**
+       * Clears the session's conversation history, keeping only system and developer messages, and seeds the fresh context window with a first user message. Must be called from inside a tool handler: the clear has to drop the results of the tool calls its wipe orphans, and it rejects when no tool call is in flight.
+       *
+       * @param params Parameters for clearing the conversation and seeding the window that replaces it.
+       *
+       * @returns What a successful clear removed. A clear that could not be applied rejects instead of reporting a count.
+       */
+      clearContext: async (params) => connection.sendRequest("session.history.clearContext", { sessionId, ...params })
     },
     /** @experimental */
     queue: {
@@ -2179,7 +2220,7 @@ function createSessionRpc(connection, sessionId) {
     /** @experimental */
     eventLog: {
       /**
-       * Reads a batch of session events from a cursor, optionally waiting for new events.
+       * Reads a batch of session events from a cursor, optionally waiting for new events. Supports tail-first reads via `direction: backward`.
        *
        * @param params Cursor, batch size, and optional long-poll/filter parameters for reading session events.
        *