@github/copilot-sdk 1.0.28 → 1.0.29-preview.0

package/docs/extensions.md

@@ -16,7 +16,7 @@ Extensions add custom tools, hooks, and behaviors to the Copilot CLI. They run a
 └─────────────────────┘                                      └──────────────────────┘
 ```
 
-1. **Discovery**: The CLI scans `.github/extensions/` (project) and the user's copilot config extensions directory for subdirectories containing `extension.mjs`.
+1. **Discovery**: The CLI scans `.github/extensions/` (project) and the user's copilot config extensions directory for subdirectories containing an `extension.mjs`, `extension.cjs` or `extension.js` entry file.
 2. **Launch**: Each extension is forked as a child process with `@github/copilot-sdk` available via an automatic module resolver.
 3. **Connection**: The extension calls `joinSession()` which establishes a JSON-RPC connection over stdio to the CLI and attaches to the user's current foreground session.
 4. **Registration**: Tools and hooks declared in the session options are registered with the CLI and become available to the agent.
@@ -27,10 +27,11 @@ Extensions add custom tools, hooks, and behaviors to the Copilot CLI. They run a
 ```
 .github/extensions/
   my-extension/
-    extension.mjs      ← Entry point (required, must be .mjs)
+    extension.mjs      ← Entry point (required)
 ```
 
-- Only `.mjs` files are supported (ES modules). The file must be named `extension.mjs`.
+- The entry file must be named `extension.mjs`, `extension.cjs` or `extension.js`. If a directory holds more than one, the first in that order is used.
+- `.mjs` (ES modules) is the recommended form and is what the scaffold generates. `.cjs` is CommonJS, and `.js` is loaded under Node's usual module-type rules. TypeScript (`.ts`) is not supported.
 - Each extension lives in its own subdirectory.
 - The `@github/copilot-sdk` import is resolved automatically — you don't install it.
 

package/docs/workflows.md

@@ -194,6 +194,8 @@ Set `notifyOnComplete` to `true` for workflows that are likely to be invoked by
 
 Both resolve with the run envelope (`WorkflowRunResult`) for **every** outcome—`completed`, `error`, `halted`, `paused`, and `cancelled` alike. Inspect `status` and read `result` only when the run completed; a limit breach carries a typed `failure`. A `paused` envelope means that the current attempt settled, not that the durable run is permanently finished. Resume the same run ID to start another attempt with its journal and accounting intact. SDK-initiated `run` and `resume` do not request permission, so they have no declined outcome. They still enforce execution eligibility, input validation, and active-run limits. Recognized pre-execution resume failures throw `WorkflowResumeError`, whose `code` is one of `not_found`, `non_resumable`, `workflow_run_not_resumable`, `already_active`, `workflow_already_running`, `workflow_limits_invalid`, `workflow_session_disposed`, `workflow_storage_unavailable`, or `workflow_storage_corrupt`.
 
+If the runtime that owns a started run disappears, the run remains active until its existing lease expires. The next observation reconciles it to `halted`, after which it can be resumed through the same API. Resume reuses durable journal entries and durable AI credit spend; spend that was not durably stored before the runtime disappeared is not reconstructed.
+
 Pause a running attempt from outside its workflow body:
 
 ```ts
@@ -238,7 +240,7 @@ const progressPage = await session.workflow.getRunProgress(runId, {
 
 - `listRuns()` returns only the runs array from the newest default page of this session's durable workflow runs. This overload preserves the original convenience API.
 - `listRuns({ afterSeq, beforeSeq, limit })` returns the full page. Its `oldestSeq`, `newestSeq`, `hasMoreNewer`, and `omittedOlder` fields let callers continue paging without raw RPC calls.
-- `getRunDetail(runId)` returns phases, prompt-safe agent summaries, and the latest progress page.
+- `getRunDetail(runId)` returns phases, prompt-safe agent summaries, and the latest progress page. Each current-runtime agent summary includes `consumedNanoAiu`, the known spend from that direct agent and its descendants. Older runtimes omit the field, and historical agents without attributable charge rows also omit it when the run contains unattributed spend.
 - `getRunProgress(runId, options?)` pages progress forward, backward, by phase, or from the latest tail.
 
 `getRun(runId)` reads the latest run envelope. `pause(runId)` pauses a running attempt and returns its `paused` envelope. `cancel(runId)` cancels a run and returns its terminal envelope.

package/package.json

@@ -5,8 +5,8 @@
         "url": "https://github.com/github/copilot-agent-runtime.git",
         "directory": "src/sdk/nodejs"
     },
-    "version": "1.0.28",
-    "copilotCliVersion": "1.0.105",
+    "version": "1.0.29-preview.0",
+    "copilotCliVersion": "1.0.106-1",
     "description": "TypeScript SDK for programmatic control of GitHub Copilot CLI via JSON-RPC",
     "main": "./dist/cjs/index.js",
     "types": "./dist/index.d.ts",
@@ -36,7 +36,7 @@
     "scripts": {
         "auth:refresh": "node ../scripts/npm-auth-refresh.mjs --run",
         "clean": "rimraf --glob dist *.tgz",
-        "build": "tsx esbuild-copilotsdk-nodejs.ts",
+        "build": "node --import tsx esbuild-copilotsdk-nodejs.ts",
         "pack:release": "npm run verify:dependency-policy && tsx scripts/package-sdk.ts",
         "verify:dependency-policy": "tsx scripts/verify-dependency-policy.ts",
         "verify:release-packages": "tsx scripts/verify-release-packages.ts",
@@ -68,25 +68,25 @@
     "author": "GitHub",
     "license": "MIT",
     "dependencies": {
-        "koffi": "3.2.1",
-        "vscode-jsonrpc": "8.2.1",
-        "zod": "4.3.6"
+        "koffi": "3.3.3",
+        "vscode-jsonrpc": "10.0.0",
+        "zod": "4.6.7"
     },
     "devDependencies": {
         "@hpke/core": "^1.9.0",
         "@microsoft/agent-host-protocol-v09": "npm:@microsoft/agent-host-protocol@0.9.0",
-        "@platformatic/vfs": "^0.3.0",
-        "@types/node": "^25.2.0",
+        "@platformatic/vfs": "^0.5.0",
+        "@types/node": "^26.6.5",
         "@types/semver": "7.8.0",
         "@types/ws": "^8.18.1",
-        "@typescript-eslint/eslint-plugin": "^8.54.0",
-        "@typescript-eslint/parser": "^8.54.0",
+        "@typescript-eslint/eslint-plugin": "^8.72.1",
+        "@typescript-eslint/parser": "^8.72.1",
         "esbuild": "^0.28.1",
-        "eslint": "^9.0.0",
+        "eslint": "^10.13.0",
         "file-entry-cache": "file:./scripts/eslint-file-cache",
         "glob": "^13.0.1",
         "json-schema": "^0.4.0",
-        "json-schema-to-typescript": "^15.0.4",
+        "json-schema-to-typescript": "^16.0.0",
         "jsonc-parser": "^3.3.1",
         "prettier": "file:../../../third_party/build-tools/prettier-3.8.1",
         "rimraf": "^6.1.2",
@@ -95,7 +95,7 @@
         "tsx": "file:../../../third_party/build-tools/tsx-4.23.13",
         "typescript": "^5.0.0",
         "vite": "file:../../../third_party/build-tools/vite-8.3.4",
-        "vitest": "^4.1.11",
+        "vitest": "^5.0.5",
         "ws": "^8.21.0",
         "yaml": "^2.8.3"
     },
@@ -114,18 +114,18 @@
         "README.md"
     ],
     "copilotRuntime": {
-        "sourceSha": "845c22879d426535d97901908014b807e0b68d0f",
-        "version": "1.0.105",
+        "sourceSha": "1fb35cfaf220f19b8983d5cbd2f7aa2128e58b3c",
+        "version": "1.0.106-1",
         "visibility": "public"
     },
     "optionalDependencies": {
-        "@github/copilot-sdk-darwin-arm64": "1.0.28",
-        "@github/copilot-sdk-darwin-x64": "1.0.28",
-        "@github/copilot-sdk-linux-arm64": "1.0.28",
-        "@github/copilot-sdk-linux-x64": "1.0.28",
-        "@github/copilot-sdk-linuxmusl-arm64": "1.0.28",
-        "@github/copilot-sdk-linuxmusl-x64": "1.0.28",
-        "@github/copilot-sdk-win32-arm64": "1.0.28",
-        "@github/copilot-sdk-win32-x64": "1.0.28"
+        "@github/copilot-sdk-darwin-arm64": "1.0.29-preview.0",
+        "@github/copilot-sdk-darwin-x64": "1.0.29-preview.0",
+        "@github/copilot-sdk-linux-arm64": "1.0.29-preview.0",
+        "@github/copilot-sdk-linux-x64": "1.0.29-preview.0",
+        "@github/copilot-sdk-linuxmusl-arm64": "1.0.29-preview.0",
+        "@github/copilot-sdk-linuxmusl-x64": "1.0.29-preview.0",
+        "@github/copilot-sdk-win32-arm64": "1.0.29-preview.0",
+        "@github/copilot-sdk-win32-x64": "1.0.29-preview.0"
     }
 }