@openclaw/copilot 2026.5.28

package/dist/runtime-C2rPhifm.js

@@ -0,0 +1,341 @@
+import { createRequire } from "node:module";
+import path, { normalize, resolve, sep } from "node:path";
+import { existsSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+import { resolveStateDir } from "openclaw/plugin-sdk/state-paths";
+//#region extensions/copilot/src/sdk-loader.ts
+function resolveCopilotSdkFallbackDir(env = process.env) {
+	return path.join(resolveStateDir(env), "npm-runtime", "copilot");
+}
+resolveCopilotSdkFallbackDir();
+const COPILOT_SDK_SPEC = "@github/copilot-sdk@1.0.0-beta.4";
+let cached;
+async function loadCopilotSdk(options = {}) {
+	const useCache = options.cache !== false;
+	if (useCache && cached) return cached;
+	const promise = doLoad(options);
+	if (useCache) {
+		cached = promise.catch((err) => {
+			cached = void 0;
+			throw err;
+		});
+		return cached;
+	}
+	return promise;
+}
+async function doLoad(options) {
+	const fallbackDir = options.fallbackDir ?? resolveCopilotSdkFallbackDir();
+	const primaryImport = options.primaryImport ?? (async () => await import("@github/copilot-sdk"));
+	let primaryErr;
+	try {
+		return await primaryImport();
+	} catch (err) {
+		primaryErr = err;
+	}
+	const fallbackPath = path.join(fallbackDir, "node_modules", "@github", "copilot-sdk");
+	if (!existsSync(fallbackPath)) throw createMissingSdkError(primaryErr, void 0, fallbackPath);
+	const fallbackImport = options.fallbackImport ?? (async () => {
+		return await import(pathToFileURL(createRequire(path.join(fallbackDir, "package.json")).resolve("@github/copilot-sdk")).href);
+	});
+	try {
+		return await fallbackImport(fallbackPath);
+	} catch (fallbackErr) {
+		throw createMissingSdkError(primaryErr, fallbackErr, fallbackPath);
+	}
+}
+function createMissingSdkError(primaryErr, fallbackErr, fallbackPath) {
+	const lines = [
+		"[copilot] @github/copilot-sdk is not installed.",
+		"",
+		"The external @openclaw/copilot plugin depends on @github/copilot-sdk",
+		"(~260 MB after pulling its platform-specific @github/copilot CLI binary).",
+		"Reinstall the plugin once with:",
+		"",
+		"  openclaw plugins install @openclaw/copilot",
+		"",
+		"For source checkouts or offline repair, install the SDK directly:",
+		"",
+		`  npm install ${COPILOT_SDK_SPEC}`,
+		"",
+		`The legacy fallback location is still probed at\n  ${fallbackPath}`,
+		"",
+		"Primary resolution error:",
+		`  ${summarizeError(primaryErr)}`
+	];
+	if (fallbackErr !== void 0) lines.push("", "Fallback resolution error:", `  ${summarizeError(fallbackErr)}`);
+	const err = new Error(lines.join("\n"));
+	err.code = "COPILOT_SDK_MISSING";
+	return err;
+}
+function summarizeError(value) {
+	if (value === void 0 || value === null) return "(none)";
+	if (value instanceof Error) return value.message || String(value);
+	if (typeof value === "string") return value;
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return Object.prototype.toString.call(value);
+	}
+}
+//#endregion
+//#region extensions/copilot/src/runtime.ts
+const DEFAULT_IDLE_TTL_MS = 300 * 1e3;
+const POOL_DISPOSED_MESSAGE = "[copilot-pool] pool disposed";
+function createCopilotClientPool(options = {}) {
+	const sdkFactory = options.sdkFactory ?? (async (clientOptions) => {
+		return new (await (loadCopilotSdk())).CopilotClient(clientOptions);
+	});
+	const idleTtlMs = options.idleTtlMs ?? DEFAULT_IDLE_TTL_MS;
+	const now = options.now ?? Date.now;
+	const entries = /* @__PURE__ */ new Map();
+	const releasedHandles = /* @__PURE__ */ new WeakSet();
+	let disposed = false;
+	let disposePromise;
+	let disposeCompleted = false;
+	const createDisposedError = () => new Error(POOL_DISPOSED_MESSAGE);
+	const maybeDeleteEntry = (entry) => {
+		if (entries.get(entry.cacheKey) === entry) entries.delete(entry.cacheKey);
+	};
+	const stopReadyOrIdleEntry = (entry, client, idleTimer) => {
+		if (idleTimer) clearTimeout(idleTimer);
+		if (entry.stopRan) {
+			if (entry.state.kind === "stopping") return entry.state.promise;
+			if (entry.state.kind === "stopped") return Promise.resolve([]);
+		}
+		entry.stopRan = true;
+		const stopPromise = (async () => {
+			try {
+				return await client.stop();
+			} catch (error) {
+				return [toError(error)];
+			} finally {
+				entry.state = { kind: "stopped" };
+				maybeDeleteEntry(entry);
+			}
+		})();
+		entry.state = {
+			kind: "stopping",
+			client,
+			promise: stopPromise
+		};
+		return stopPromise;
+	};
+	const stopEntry = async (entry) => {
+		switch (entry.state.kind) {
+			case "creating":
+				try {
+					await entry.state.promise;
+				} catch (error) {
+					maybeDeleteEntry(entry);
+					return [toError(error)];
+				}
+				return stopEntry(entry);
+			case "ready": return stopReadyOrIdleEntry(entry, entry.state.client);
+			case "idle": return stopReadyOrIdleEntry(entry, entry.state.client, entry.state.idleTimer);
+			case "stopping": return entry.state.promise;
+			case "stopped": return [];
+			default: return entry.state;
+		}
+	};
+	const scheduleIdleStop = (entry, client) => {
+		entry.state = {
+			kind: "idle",
+			client,
+			idleTimer: setTimeout(() => {
+				stopEntry(entry);
+			}, idleTtlMs),
+			idleSinceMs: now()
+		};
+	};
+	const createEntry = (key, cacheKey, clientOptions) => {
+		const entry = {
+			key,
+			cacheKey,
+			refCount: 1,
+			stopRan: false,
+			state: {
+				kind: "creating",
+				promise: Promise.resolve(void 0)
+			}
+		};
+		const createPromise = (async () => {
+			try {
+				const client = await sdkFactory(clientOptions);
+				entry.state = {
+					kind: "ready",
+					client
+				};
+				return client;
+			} catch (error) {
+				entry.state = { kind: "stopped" };
+				maybeDeleteEntry(entry);
+				throw toError(error);
+			}
+		})();
+		entry.state = {
+			kind: "creating",
+			promise: createPromise
+		};
+		entries.set(cacheKey, entry);
+		return {
+			entry,
+			createPromise
+		};
+	};
+	const acquire = async (inputKey, optionsForCreate) => {
+		const key = normalizePoolKey(inputKey, optionsForCreate.copilotHome);
+		const cacheKey = JSON.stringify(key);
+		const clientOptions = normalizeClientCreateOptions(optionsForCreate, key.copilotHome);
+		while (true) {
+			if (disposed) throw createDisposedError();
+			const existing = entries.get(cacheKey);
+			if (!existing) {
+				const created = createEntry(key, cacheKey, clientOptions);
+				try {
+					const client = await created.createPromise;
+					if (disposed) {
+						await stopEntry(created.entry);
+						throw createDisposedError();
+					}
+					return {
+						key: created.entry.key,
+						client
+					};
+				} catch (error) {
+					throw toError(error);
+				}
+			}
+			switch (existing.state.kind) {
+				case "creating":
+					existing.refCount += 1;
+					try {
+						const client = await existing.state.promise;
+						if (disposed) {
+							await stopEntry(existing);
+							throw createDisposedError();
+						}
+						return {
+							key: existing.key,
+							client
+						};
+					} catch (error) {
+						throw toError(error);
+					}
+				case "ready":
+					existing.refCount += 1;
+					return {
+						key: existing.key,
+						client: existing.state.client
+					};
+				case "idle": {
+					const client = existing.state.client;
+					clearTimeout(existing.state.idleTimer);
+					existing.refCount += 1;
+					existing.state = {
+						kind: "ready",
+						client
+					};
+					return {
+						key: existing.key,
+						client
+					};
+				}
+				case "stopping":
+					await existing.state.promise;
+					continue;
+				case "stopped":
+					maybeDeleteEntry(existing);
+					continue;
+			}
+		}
+	};
+	const release = async (handle) => {
+		if (releasedHandles.has(handle)) return;
+		releasedHandles.add(handle);
+		const entry = entries.get(JSON.stringify(handle.key));
+		if (!entry) return;
+		switch (entry.state.kind) {
+			case "creating":
+			case "stopping":
+			case "stopped": return;
+			case "ready":
+			case "idle":
+				if (entry.state.client !== handle.client) return;
+				break;
+		}
+		if (entry.refCount <= 0) return;
+		entry.refCount -= 1;
+		if (entry.refCount > 0) return;
+		if (disposed) {
+			await stopEntry(entry);
+			return;
+		}
+		if (entry.state.kind === "ready") {
+			scheduleIdleStop(entry, entry.state.client);
+			return;
+		}
+		if (entry.state.kind === "idle") {
+			clearTimeout(entry.state.idleTimer);
+			scheduleIdleStop(entry, entry.state.client);
+		}
+	};
+	const dispose = async () => {
+		if (disposeCompleted) return [];
+		if (disposePromise) {
+			await disposePromise;
+			return [];
+		}
+		disposed = true;
+		const snapshot = [...entries.values()];
+		for (const entry of snapshot) if (entry.state.kind === "idle") clearTimeout(entry.state.idleTimer);
+		disposePromise = (async () => {
+			const errors = [];
+			for (const entry of snapshot) {
+				const stopErrors = await stopEntry(entry);
+				errors.push(...stopErrors);
+			}
+			entries.clear();
+			disposeCompleted = true;
+			return errors;
+		})();
+		try {
+			return await disposePromise;
+		} finally {
+			disposePromise = void 0;
+		}
+	};
+	return {
+		acquire,
+		release,
+		dispose,
+		size: () => entries.size
+	};
+}
+function normalizePoolKey(key, rawCopilotHome) {
+	return {
+		agentId: key.agentId,
+		copilotHome: normalizeCopilotHome(rawCopilotHome),
+		authMode: key.authMode,
+		authProfileId: key.authProfileId,
+		authProfileVersion: key.authProfileVersion
+	};
+}
+function normalizeClientCreateOptions(options, normalizedCopilotHome) {
+	return {
+		...options,
+		copilotHome: normalizedCopilotHome
+	};
+}
+function normalizeCopilotHome(copilotHome) {
+	let normalizedHome = resolve(copilotHome);
+	normalizedHome = normalize(normalizedHome);
+	if (normalizedHome.endsWith(sep) && normalizedHome.length > 1) normalizedHome = normalizedHome.slice(0, -1);
+	if (process.platform === "win32") normalizedHome = normalizedHome.toLowerCase();
+	return normalizedHome;
+}
+function toError(error) {
+	if (error instanceof Error) return error;
+	return new Error(String(error));
+}
+//#endregion
+export { createCopilotClientPool };

package/npm-shrinkwrap.json

@@ -0,0 +1,160 @@
+{
+  "name": "@openclaw/copilot",
+  "version": "2026.5.28",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@openclaw/copilot",
+      "version": "2026.5.28",
+      "dependencies": {
+        "@github/copilot-sdk": "1.0.0-beta.4"
+      }
+    },
+    "node_modules/@github/copilot": {
+      "version": "1.0.48",
+      "resolved": "https://registry.npmjs.org/@github/copilot/-/copilot-1.0.48.tgz",
+      "integrity": "sha512-U5SzyTEq376UU9A4Sd3TEKz+Y2nRUd90cLO4Hc1otaB8yFSy9Ur2UVGcI2/wCoodL3a39k6WbdgNzFxr0gWFRQ==",
+      "license": "SEE LICENSE IN LICENSE.md",
+      "bin": {
+        "copilot": "npm-loader.js"
+      },
+      "optionalDependencies": {
+        "@github/copilot-darwin-arm64": "1.0.48",
+        "@github/copilot-darwin-x64": "1.0.48",
+        "@github/copilot-linux-arm64": "1.0.48",
+        "@github/copilot-linux-x64": "1.0.48",
+        "@github/copilot-win32-arm64": "1.0.48",
+        "@github/copilot-win32-x64": "1.0.48"
+      }
+    },
+    "node_modules/@github/copilot-darwin-arm64": {
+      "version": "1.0.48",
+      "resolved": "https://registry.npmjs.org/@github/copilot-darwin-arm64/-/copilot-darwin-arm64-1.0.48.tgz",
+      "integrity": "sha512-82MLoMQwPVVFM8EYssihFxSEPUYtZADE8rMzQ3jG9HgRg2qjQSfnHQS1mKe64dlXswZUK/onw6/8kjnW5I4pPg==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "SEE LICENSE IN LICENSE.md",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "bin": {
+        "copilot-darwin-arm64": "copilot"
+      }
+    },
+    "node_modules/@github/copilot-darwin-x64": {
+      "version": "1.0.48",
+      "resolved": "https://registry.npmjs.org/@github/copilot-darwin-x64/-/copilot-darwin-x64-1.0.48.tgz",
+      "integrity": "sha512-1VQ5r5F0h8GwboXmZTcutqcJT+iCpPXAF27QqodmpKEvW9aYfG8g9X2kFJOzDZoX+SA3Uaka9qXdYKF2xT6Uog==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "SEE LICENSE IN LICENSE.md",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "bin": {
+        "copilot-darwin-x64": "copilot"
+      }
+    },
+    "node_modules/@github/copilot-linux-arm64": {
+      "version": "1.0.48",
+      "resolved": "https://registry.npmjs.org/@github/copilot-linux-arm64/-/copilot-linux-arm64-1.0.48.tgz",
+      "integrity": "sha512-PmsGnb0DZlI+Bf53l9HM1PAHHkUcMyB4y8v/7tnC/jDOV5dGF124n0HnDNfJLOLiJGiQGodthIif6QtPaAxpeA==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "SEE LICENSE IN LICENSE.md",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "bin": {
+        "copilot-linux-arm64": "copilot"
+      }
+    },
+    "node_modules/@github/copilot-linux-x64": {
+      "version": "1.0.48",
+      "resolved": "https://registry.npmjs.org/@github/copilot-linux-x64/-/copilot-linux-x64-1.0.48.tgz",
+      "integrity": "sha512-b2cc4euSlke9fYHXXsS2EL9UYbctN0h4lZvtAcKUDY+RCnpYAQOVBZK+c1R9dQrtsT6Z/yUv7PuFPSs8qdtc2Q==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "SEE LICENSE IN LICENSE.md",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "bin": {
+        "copilot-linux-x64": "copilot"
+      }
+    },
+    "node_modules/@github/copilot-sdk": {
+      "version": "1.0.0-beta.4",
+      "resolved": "https://registry.npmjs.org/@github/copilot-sdk/-/copilot-sdk-1.0.0-beta.4.tgz",
+      "integrity": "sha512-DcVMN2FWODxamFS9nTls8AW3QsyMnj6JDVBNRVBXaTY9kEhGHCjt8lp7sJp95/vyl52hvEb4/68Oh6SdFU9O/Q==",
+      "license": "MIT",
+      "dependencies": {
+        "@github/copilot": "^1.0.46",
+        "vscode-jsonrpc": "^8.2.1",
+        "zod": "^4.3.6"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@github/copilot-win32-arm64": {
+      "version": "1.0.48",
+      "resolved": "https://registry.npmjs.org/@github/copilot-win32-arm64/-/copilot-win32-arm64-1.0.48.tgz",
+      "integrity": "sha512-VEEOwddtpJ3DTbXGhnK6K8im4ofl9m08q1m/K++sNvWV8wkkOSOQBTiPdyUsuU/TXAoFhb8tZMIJv+6NnMBtMw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "SEE LICENSE IN LICENSE.md",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "bin": {
+        "copilot-win32-arm64": "copilot.exe"
+      }
+    },
+    "node_modules/@github/copilot-win32-x64": {
+      "version": "1.0.48",
+      "resolved": "https://registry.npmjs.org/@github/copilot-win32-x64/-/copilot-win32-x64-1.0.48.tgz",
+      "integrity": "sha512-93BzvXLPHTyy1gWBXQY/IWIHor4IAwZuuo7/obG80/Qa6U0WeaN9slz/FBJvrsgVNrrRfEID5Xm3At+S6Kj67Q==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "SEE LICENSE IN LICENSE.md",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "bin": {
+        "copilot-win32-x64": "copilot.exe"
+      }
+    },
+    "node_modules/vscode-jsonrpc": {
+      "version": "8.2.1",
+      "resolved": "https://registry.npmjs.org/vscode-jsonrpc/-/vscode-jsonrpc-8.2.1.tgz",
+      "integrity": "sha512-kdjOSJ2lLIn7r1rtrMbbNCHjyMPfRnowdKjBQ+mGq6NAW5QY2bEZC/khaC5OR8svbbjvLEaIXkOq45e2X9BIbQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/zod": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-4.4.3.tgz",
+      "integrity": "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    }
+  }
+}

package/openclaw.plugin.json

@@ -0,0 +1,39 @@
+{
+  "id": "copilot",
+  "name": "GitHub Copilot agent runtime",
+  "description": "Registers the GitHub Copilot agent runtime.",
+  "version": "2026.5.28",
+  "activation": {
+    "onStartup": false,
+    "onAgentHarnesses": ["copilot"]
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "pool": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "idleTtlMs": {
+            "type": "number",
+            "minimum": 1,
+            "default": 300000
+          }
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "pool": {
+      "label": "Client Pool",
+      "help": "Advanced GitHub Copilot agent runtime client pooling controls.",
+      "advanced": true
+    },
+    "pool.idleTtlMs": {
+      "label": "Idle Client TTL",
+      "help": "Milliseconds to keep an idle GitHub Copilot agent runtime client alive before disposal.",
+      "advanced": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@openclaw/copilot",
+  "version": "2026.5.28",
+  "description": "OpenClaw GitHub Copilot agent runtime plugin (registers a `github-copilot` AgentHarness backed by @github/copilot-sdk over JSON-RPC to the GitHub Copilot CLI)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openclaw/openclaw"
+  },
+  "type": "module",
+  "dependencies": {
+    "@github/copilot-sdk": "1.0.0-beta.4"
+  },
+  "devDependencies": {
+    "@github/copilot": "1.0.48",
+    "@openclaw/plugin-sdk": "workspace:*"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "clawhubSpec": "clawhub:@openclaw/copilot",
+      "npmSpec": "@openclaw/copilot",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.5.28"
+    },
+    "compat": {
+      "pluginApi": ">=2026.5.28"
+    },
+    "build": {
+      "openclawVersion": "2026.5.28",
+      "bundledDist": false
+    },
+    "release": {
+      "bundleRuntimeDependencies": false,
+      "publishToClawHub": true,
+      "publishToNpm": true
+    },
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ]
+  },
+  "files": [
+    "dist/**",
+    "openclaw.plugin.json",
+    "npm-shrinkwrap.json",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "openclaw": ">=2026.5.28"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  }
+}