@github/copilot-sdk 1.0.22-preview.0 → 1.0.22-preview.2

package/README.md

@@ -381,6 +381,7 @@ Create a new conversation session.
 - `onPermissionRequest?: PermissionHandler` - Optional handler called before each tool execution to approve or deny it. When omitted, permission requests are emitted as events and left pending for manual resolution. `approveAll` approves requests when managed settings are disabled and throws when `enableManagedSettings` is true. Custom handlers can inspect `managedApprovalRequired` for human-facing confirmation logic. See [Permission Handling](#permission-handling) section.
 - `onUserInputRequest?: UserInputHandler` - Handler for legacy question-and-answer requests from the agent. Enables the legacy `ask_user` tool. See [User Input Requests](#user-input-requests) section.
 - `askUserVariant?: "legacy" | "elicitation"` - Selects the model-facing `ask_user` tool shape when creating or cold-resuming a session. Defaults to `"legacy"`; use `"elicitation"` with `onElicitationRequest`.
+- `interactiveUser?: boolean` - Declares that a person types this session's messages, as in an editor chat panel. Enables the runtime's user-message analysis telemetry for user-authored messages; automated messages stay excluded. Defaults to `false`. Ignored for cloud sessions. Re-supply it when cold-resuming a session; it is ignored when resuming a session that is already active.
 - `onElicitationRequest?: ElicitationHandler` - Handler for elicitation requests dispatched by the server. Enables this client to present form-based UI dialogs on behalf of the agent or other session participants. See [Elicitation Requests](#elicitation-requests) section.
 - `hooks?: SessionHooks` - Hook handlers for session lifecycle events. See [Session Hooks](#session-hooks) section.
 - `skillProvider?: SkillProvider` - **Experimental.** Serves skills from host storage instead of skill directories. Not persisted; pass it again on resume. See [Skill providers](#skill-providers-experimental).

package/dist/cjs/cliVersion.js

@@ -22,7 +22,7 @@ __export(cliVersion_exports, {
   COPILOT_CLI_VERSION: () => COPILOT_CLI_VERSION
 });
 module.exports = __toCommonJS(cliVersion_exports);
-const COPILOT_CLI_VERSION = "1.0.98-0";
+const COPILOT_CLI_VERSION = "1.0.98-2";
 const COPILOT_CLI_USE_NPM_PACKAGE = false;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/client.js

@@ -1395,6 +1395,7 @@ class CopilotClient {
         expAssignments: config.expAssignments,
         enableManagedSettings: config.enableManagedSettings,
         enforceManagedModelDefaults: config.enforceManagedModelDefaults,
+        interactiveUser: config.interactiveUser,
         managedSettings: config.managedSettings
       });
       const {
@@ -1668,6 +1669,7 @@ class CopilotClient {
         expAssignments: config.expAssignments,
         enableManagedSettings: config.enableManagedSettings,
         enforceManagedModelDefaults: config.enforceManagedModelDefaults,
+        interactiveUser: config.interactiveUser,
         managedSettings: config.managedSettings,
         ...extensionOptions?.requestedEnvironmentVariables ? {
           requestedEnvironmentVariables: extensionOptions.requestedEnvironmentVariables

package/dist/cjs/generated/rpc.js

@@ -515,6 +515,14 @@ function createServerRpc(connection) {
        * @returns Skill installation management result with the honoured contract, or a typed refusal.
        */
       planInstall: async (params) => connection.sendRequest("skills.planInstall", params),
+      /**
+       * Plans installation of the Skill pinned by an Agent Finder materialisation reference without writing files. The runtime retrieves the descriptor only from its fixed Agent Finder authority and applies the same verification as skills.planInstall; the review shows only verified data. Apply the returned plan with skills.applyInstall.
+       *
+       * @param params Side-effect-free planning of one Skill from a materialisation reference rather than a search candidate.
+       *
+       * @returns Skill installation management result with the honoured contract, or a typed refusal.
+       */
+      planInstallFromReference: async (params) => connection.sendRequest("skills.planInstallFromReference", params),
       /**
        * Consumes one verified Skill installation plan, requests explicit human consent through installations.confirm on the original connection, then revalidates and installs the Skill disabled.
        *

package/dist/cliVersion.d.ts

@@ -1,2 +1,2 @@
-export declare const COPILOT_CLI_VERSION = "1.0.98-0";
+export declare const COPILOT_CLI_VERSION = "1.0.98-2";
 export declare const COPILOT_CLI_USE_NPM_PACKAGE = false;

package/dist/cliVersion.js

@@ -1,4 +1,4 @@
-const COPILOT_CLI_VERSION = "1.0.98-0";
+const COPILOT_CLI_VERSION = "1.0.98-2";
 const COPILOT_CLI_USE_NPM_PACKAGE = false;
 export {
   COPILOT_CLI_USE_NPM_PACKAGE,

package/dist/client.js

@@ -1375,6 +1375,7 @@ class CopilotClient {
         expAssignments: config.expAssignments,
         enableManagedSettings: config.enableManagedSettings,
         enforceManagedModelDefaults: config.enforceManagedModelDefaults,
+        interactiveUser: config.interactiveUser,
         managedSettings: config.managedSettings
       });
       const {
@@ -1648,6 +1649,7 @@ class CopilotClient {
         expAssignments: config.expAssignments,
         enableManagedSettings: config.enableManagedSettings,
         enforceManagedModelDefaults: config.enforceManagedModelDefaults,
+        interactiveUser: config.interactiveUser,
         managedSettings: config.managedSettings,
         ...extensionOptions?.requestedEnvironmentVariables ? {
           requestedEnvironmentVariables: extensionOptions.requestedEnvironmentVariables

package/dist/generated/rpc.d.ts

@@ -963,7 +963,9 @@ export type CatalogCapability =
 /** Understands verified Agent Finder Skill install, uninstall, recovery and installation-scoped enablement APIs. Advertised only by runtimes with the Skill installation engine linked; acquisition may still be refused as feature-disabled per selected session. */
  | "skill-confirmed-installation"
 /** Understands `installability` and the reviewable `installPlan` on Agent Plugin candidates. Requires agent-plugin-discovery; without it, plugin candidates are unchanged. A plugin is installable only with complete, verified catalogue install data, and may still be reported as feature-disabled per selected session. */
- | "agent-plugin-confirmed-installation";
+ | "agent-plugin-confirmed-installation"
+/** Extends skill-confirmed-installation to planning from an Agent Finder materialisation reference through skills.planInstallFromReference, and to its distinct reference failure reasons. Requires skill-confirmed-installation. Advertised only by runtimes with the Skill installation engine linked. */
+ | "skill-reference-installation";
 /**
  * Bounded extensible wire-feature identifier. Known values are described by `CatalogCapability`; newer callers may send future identifiers so an older runtime can return a typed negotiation refusal instead of failing schema validation. Capability negotiation establishes contract understanding, while each operation's result separately reports runtime availability.
  *
@@ -5107,7 +5109,17 @@ export type SkillInstallationFailureReason =
 /** Installed Skill files no longer match ownership evidence. */
  | "configuration-modified"
 /** A storage operation failed; inspect durable state before retrying. */
- | "write-failed";
+ | "write-failed"
+/** The materialisation reference is malformed or uses an unsupported schema version. Returned only to callers that require skill-reference-installation. */
+ | "invalid-reference"
+/** Agent Finder has no materialisation for the referenced resource revision (HTTP 404). Returned only to callers that require skill-reference-installation. */
+ | "descriptor-not-found"
+/** Agent Finder withdrew the referenced resource revision (HTTP 410). Returned only to callers that require skill-reference-installation. */
+ | "descriptor-withdrawn"
+/** The retrieved descriptor does not match the referenced descriptor or bundle digest. Returned only to callers that require skill-reference-installation. */
+ | "digest-mismatch"
+/** The referenced resource is not a Skill. Returned only to callers that require skill-reference-installation. */
+ | "unsupported-resource";
 /**
  * Management outcome for verified Skill inventory, planning and removal.
  *
@@ -8778,6 +8790,39 @@ export interface CatalogMalformedCardError {
      */
     message: string;
 }
+/**
+ * An Agent Finder materialisation reference pinning one exact resource revision.
+ *
+ * It carries no origin or URL: the runtime always builds the descriptor URL on its fixed Agent
+ * Finder authority. It carries no display data either; every reviewed field comes from the
+ * verified descriptor and Skill files.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CatalogMaterializationReference".
+ */
+/** @experimental */
+export interface CatalogMaterializationReference {
+    /**
+     * Agent Finder resource identifier, a positive decimal integer.
+     */
+    resourceId: string;
+    /**
+     * Agent Finder materialisation revision identifier, a positive decimal integer. This is not a Git commit.
+     */
+    revisionId: string;
+    /**
+     * Materialisation descriptor schema version, currently `1.0.0`.
+     */
+    schemaVersion: string;
+    /**
+     * Expected `sha256:<lowercase hex>` digest of the canonical descriptor.
+     */
+    descriptorDigest: string;
+    /**
+     * Expected `sha256:<lowercase hex>` digest of the descriptor's bundle manifest.
+     */
+    bundleDigest: string;
+}
 /**
  * The protocol version and capability set the runtime actually honoured for a successful catalog operation.
  *
@@ -24312,6 +24357,10 @@ export interface SessionOpenOptions {
      */
     enforceManagedModelDefaults?: boolean;
     managedSettings?: SessionManagedSettings;
+    /**
+     * Declares that a human drives this session's conversation, enabling user-message analysis (sentiment, task completion criteria, and task analytics) for user-authored messages. Automated messages remain excluded. Defaults to false for SDK sessions. Applied when the session is created or loaded from storage; ignored when resuming a session that is already active, and for cloud sessions.
+     */
+    interactiveUser?: boolean;
     /**
      * Opt in to capturing file changes for session rewind and session diff. Capture cannot reconstruct changes made before it was enabled. On create it starts capture from the first turn. It is also honored on resume: for a session that already has tracked prior turns, tracking continues automatically even if this is omitted; passing it on resume additionally enables tracking for an eligible session that has no prior root turn yet. Resuming a session whose prior root turns were never tracked has no restorable baseline, so tracking stays disabled for it and rewind reports file change tracking as unavailable; the resume itself still succeeds, so sessions that predate tracking remain loadable. The opt-in is only rejected when the session can never track (a subagent session, or one without local session storage). It is intentionally absent from the mutable options update because enabling it after edits have occurred would create an incomplete, misleading baseline. Subagents share the parent session's capture store and are not tracked as separate rewind points: a file a subagent writes is attributed to whichever root user turn was open when the capture was staged, just before the tool body ran. A turn cannot open while a staged capture is still in flight, so a subagent tool that staged under the spawning turn stays attributed to it however late the write lands, while a capture it stages after the user's next message belongs to that later turn. Attribution decides which turn's rewind point counts and file preview include that write; it does not narrow which rewinds revert it, because a rewind restores every capture from the selected turn onward, so the earlier spawning turn reverts it as well.
      */
@@ -26694,6 +26743,21 @@ export interface SkillList {
      */
     skills: Skill[];
 }
+/**
+ * Side-effect-free planning of one Skill from a materialisation reference rather than a search candidate.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SkillPlanInstallFromReferenceRequest".
+ */
+/** @experimental */
+export interface SkillPlanInstallFromReferenceRequest {
+    contract: CatalogClientContract;
+    reference: CatalogMaterializationReference;
+    /**
+     * Existing local session attached to this connection.
+     */
+    policySessionId: string;
+}
 /**
  * Side-effect-free planning of one verified Agent Finder Skill candidate.
  *
@@ -32184,6 +32248,14 @@ export declare function createServerRpc(connection: MessageConnection): {
          * @returns Skill installation management result with the honoured contract, or a typed refusal.
          */
         planInstall: (params: SkillPlanInstallRequest) => Promise<SkillInstallationManagementResult>;
+        /**
+         * Plans installation of the Skill pinned by an Agent Finder materialisation reference without writing files. The runtime retrieves the descriptor only from its fixed Agent Finder authority and applies the same verification as skills.planInstall; the review shows only verified data. Apply the returned plan with skills.applyInstall.
+         *
+         * @param params Side-effect-free planning of one Skill from a materialisation reference rather than a search candidate.
+         *
+         * @returns Skill installation management result with the honoured contract, or a typed refusal.
+         */
+        planInstallFromReference: (params: SkillPlanInstallFromReferenceRequest) => Promise<SkillInstallationManagementResult>;
         /**
          * Consumes one verified Skill installation plan, requests explicit human consent through installations.confirm on the original connection, then revalidates and installs the Skill disabled.
          *

package/dist/generated/rpc.js

@@ -487,6 +487,14 @@ function createServerRpc(connection) {
        * @returns Skill installation management result with the honoured contract, or a typed refusal.
        */
       planInstall: async (params) => connection.sendRequest("skills.planInstall", params),
+      /**
+       * Plans installation of the Skill pinned by an Agent Finder materialisation reference without writing files. The runtime retrieves the descriptor only from its fixed Agent Finder authority and applies the same verification as skills.planInstall; the review shows only verified data. Apply the returned plan with skills.applyInstall.
+       *
+       * @param params Side-effect-free planning of one Skill from a materialisation reference rather than a search candidate.
+       *
+       * @returns Skill installation management result with the honoured contract, or a typed refusal.
+       */
+      planInstallFromReference: async (params) => connection.sendRequest("skills.planInstallFromReference", params),
       /**
        * Consumes one verified Skill installation plan, requests explicit human consent through installations.confirm on the original connection, then revalidates and installs the Skill disabled.
        *

package/dist/types.d.ts

@@ -1135,6 +1135,12 @@ export type AutoModeSwitchHandler = (request: AutoModeSwitchRequest, invocation:
  * Base interface for all hook inputs
  */
 export interface BaseHookInput {
+    /** Subagent actor ID, absent for root hooks and older runtimes. */
+    agentId?: string;
+    /** Subagent type, when known by the runtime. */
+    agentType?: string;
+    /** Immediate parent actor ID, when available. */
+    parentAgentId?: string;
     /** The runtime session ID associated with the hook. Child tool hooks use
      * the child session ID; sub-agent lifecycle hooks use the parent session ID,
      * matching `invocation.sessionId`. */
@@ -2531,6 +2537,13 @@ export interface SessionConfigBase {
      * conflicting session options. Overridable managed defaults remain mutable.
      */
     enforceManagedModelDefaults?: boolean;
+    /**
+     * Declares that a human drives this session's conversation, enabling
+     * user-message analysis telemetry for user-authored messages. Automated
+     * messages remain excluded. Defaults to false for SDK sessions; ignored
+     * for cloud sessions and when resuming a session that is already active.
+     */
+    interactiveUser?: boolean;
     /**
      * Host-injected enterprise managed settings for this session.
      *

package/package.json

@@ -5,8 +5,8 @@
         "url": "https://github.com/github/copilot-agent-runtime.git",
         "directory": "src/sdk/nodejs"
     },
-    "version": "1.0.22-preview.0",
-    "copilotCliVersion": "1.0.98-0",
+    "version": "1.0.22-preview.2",
+    "copilotCliVersion": "1.0.98-2",
     "description": "TypeScript SDK for programmatic control of GitHub Copilot CLI via JSON-RPC",
     "main": "./dist/cjs/index.js",
     "types": "./dist/index.d.ts",
@@ -103,18 +103,18 @@
         "README.md"
     ],
     "copilotRuntime": {
-        "sourceSha": "8f6dbb8fcdc7c2f25291088a43d0755763269588",
-        "version": "1.0.98-0",
+        "sourceSha": "45ef16251c84707ee25a5bfe5a445a22aafb2878",
+        "version": "1.0.98-2",
         "visibility": "public"
     },
     "optionalDependencies": {
-        "@github/copilot-sdk-darwin-arm64": "1.0.22-preview.0",
-        "@github/copilot-sdk-darwin-x64": "1.0.22-preview.0",
-        "@github/copilot-sdk-linux-arm64": "1.0.22-preview.0",
-        "@github/copilot-sdk-linux-x64": "1.0.22-preview.0",
-        "@github/copilot-sdk-linuxmusl-arm64": "1.0.22-preview.0",
-        "@github/copilot-sdk-linuxmusl-x64": "1.0.22-preview.0",
-        "@github/copilot-sdk-win32-arm64": "1.0.22-preview.0",
-        "@github/copilot-sdk-win32-x64": "1.0.22-preview.0"
+        "@github/copilot-sdk-darwin-arm64": "1.0.22-preview.2",
+        "@github/copilot-sdk-darwin-x64": "1.0.22-preview.2",
+        "@github/copilot-sdk-linux-arm64": "1.0.22-preview.2",
+        "@github/copilot-sdk-linux-x64": "1.0.22-preview.2",
+        "@github/copilot-sdk-linuxmusl-arm64": "1.0.22-preview.2",
+        "@github/copilot-sdk-linuxmusl-x64": "1.0.22-preview.2",
+        "@github/copilot-sdk-win32-arm64": "1.0.22-preview.2",
+        "@github/copilot-sdk-win32-x64": "1.0.22-preview.2"
     }
 }