@openclaw/acpx 2026.10.5-beta.4 → 2026.10.10-beta.1

package/dist/.setup/{session-owner-migration-DECUY80a.mjs → session-owner-migration-duvwZfxk.mjs}

@@ -276,11 +276,11 @@ async function migrateRecord(input, directory, oldId, claims, changes, warnings)
 	const { resolveAcpxSessionResource } = await import("./session-resource-DKJsUJPu.mjs").then((n) => n.n);
 	const { createFileSessionStore, decodeAcpxRuntimeHandleState, encodeAcpxRuntimeHandleState } = await import("acpx/runtime");
 	const candidates = claims.filter((claim) => matchesClaimRecord(claim, raw, oldId, resolveAcpxSessionResource(claim), decodeAcpxRuntimeHandleState));
-	if (candidates.length !== 1) throw new Error("exactly one current canonical owner claim is required");
+	if (candidates.length !== 1) throw new Error("exactly one current owner claim is required");
 	const claim = candidates[0];
 	const resource = resolveAcpxSessionResource(claim);
 	const oneshot = claim.meta.mode === "oneshot";
-	if (oneshot !== (raw.name !== oldId)) throw new Error("canonical claim and backend record mode disagree");
+	if (oneshot !== (raw.name !== oldId)) throw new Error("current claim and backend record mode disagree");
 	if (!oneshot && oldId === resource) return;
 	const recordId = oneshot ? oldId : resource;
 	const leaseStore = openAcpxProcessLeaseStateStore(input.context.openPluginStateKeyedStore);
@@ -357,7 +357,7 @@ async function migrateRecord(input, directory, oldId, claims, changes, warnings)
 			acpxRecordId: recordId
 		});
 		const verified = await input.context.inspectAcpSessionClaims();
-		if (verified.incomplete.length || !verified.claims.some((item) => item.agentId === claim.agentId && item.sessionKey === claim.sessionKey && item.meta.identity?.acpxRecordId === recordId && isDeepStrictEqual(item.binding, claim.binding))) throw new Error("canonical metadata verification failed; source retained for rerun");
+		if (verified.incomplete.length || !verified.claims.some((item) => item.agentId === claim.agentId && item.sessionKey === claim.sessionKey && item.meta.identity?.acpxRecordId === recordId && isDeepStrictEqual(item.binding, claim.binding))) throw new Error("stored metadata verification failed; source retained for rerun");
 		changes.push(`Migrated ACP backend history for ${claim.agentId}/${claim.sessionKey} to its owner-qualified resource.`);
 		if (!oneshot) await (0, runtime_doctor_migrations_exports.archiveLegacyStateSource)({
 			filePath: sourcePath,
@@ -416,7 +416,7 @@ const acpxSessionOwnerMigration = {
 		};
 		for (const oldId of ids) try {
 			const current = await input.context.inspectAcpSessionClaims();
-			if (current.incomplete.length) throw new Error("canonical ownership evidence became incomplete");
+			if (current.incomplete.length) throw new Error("current ownership evidence became incomplete");
 			await migrateRecord(input, directory, oldId, current.claims, changes, warnings);
 		} catch (error) {
 			warnings.push(`ACP record ${oldId} retained: ${String(error)}`);

package/dist/doctor-contract-api.js

@@ -40,13 +40,13 @@ const stateMigrations = [{
 	doctorOnly: true,
 	phase: "after-session-repair",
 	async collectBackupResources(input) {
-		return (await import("./.setup/session-owner-migration-DECUY80a.mjs")).acpxSessionOwnerMigration.collectBackupResources(input);
+		return (await import("./.setup/session-owner-migration-duvwZfxk.mjs")).acpxSessionOwnerMigration.collectBackupResources(input);
 	},
 	async detectLegacyState(input) {
-		return (await import("./.setup/session-owner-migration-DECUY80a.mjs")).acpxSessionOwnerMigration.detectLegacyState(input);
+		return (await import("./.setup/session-owner-migration-duvwZfxk.mjs")).acpxSessionOwnerMigration.detectLegacyState(input);
 	},
 	async migrateLegacyState(input) {
-		return (await import("./.setup/session-owner-migration-DECUY80a.mjs")).acpxSessionOwnerMigration.migrateLegacyState(input);
+		return (await import("./.setup/session-owner-migration-duvwZfxk.mjs")).acpxSessionOwnerMigration.migrateLegacyState(input);
 	}
 }];
 //#endregion

package/dist/index.js

@@ -1,11 +1,9 @@
-import { t as createAcpxRuntimeService } from "./.setup/register.runtime-DfAHoa8o.mjs";
+import { t as createAcpxRuntimeService } from "./.setup/register.runtime-CdG6bROH.mjs";
 import { g as AcpxNativeAgentsSchema, h as ACPX_NATIVE_AGENT_IDS, t as resolveAcpxPluginConfig } from "./.setup/config-D0ATuiVJ.mjs";
 import { a as PI_SESSIONS_CAPABILITY, c as PI_SESSION_READ_COMMAND, l as PI_TERMINAL_RESUME_COMMAND, o as PI_SESSIONS_LIST_COMMAND, r as piSessionStoreAvailable, s as PI_SESSION_ID_PATTERN } from "./.setup/pi-session-paths-CIvyk6KB.mjs";
 import { createAgentRegistry } from "acpx/agent-registry";
 import { tryDispatchAcpReplyHook } from "openclaw/plugin-sdk/acp-runtime-backend";
 import { createLazyRuntimeModule, createLazyRuntimeSurface } from "openclaw/plugin-sdk/lazy-runtime";
-import { inspectAgentModels } from "acpx/runtime";
-import { createNativeSessionCommitFinalizer } from "openclaw/plugin-sdk/agent-harness-session-runtime";
 import { finiteSecondsToTimerSafeMilliseconds } from "openclaw/plugin-sdk/number-runtime";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveNodeHostExecutable } from "openclaw/plugin-sdk/node-host";
@@ -166,6 +164,7 @@ function createAcpAgentHarness(params) {
 				workspaceDir: input.workspaceDir
 			});
 			try {
+				const { inspectAgentModels } = await import("acpx/runtime");
 				const models = await inspectAgentModels({
 					agentCommand: inspection.launch.argv,
 					cwd: input.workspaceDir ?? config.cwd,
@@ -173,7 +172,6 @@ function createAcpAgentHarness(params) {
 					timeoutMs: config.timeoutSeconds === void 0 ? void 0 : finiteSecondsToTimerSafeMilliseconds(config.timeoutSeconds) ?? 1
 				});
 				generation.signal.throwIfAborted();
-				if (!params.isEnabled()) return { entries: [] };
 				return {
 					entries: (models?.availableModels ?? []).map((model) => ({
 						provider: id,
@@ -188,7 +186,6 @@ function createAcpAgentHarness(params) {
 				};
 			} catch (error) {
 				generation.signal.throwIfAborted();
-				if (!params.isEnabled()) return { entries: [] };
 				const authRequired = error instanceof Error && error.name === "RequestError" && "code" in error && error.code === -32e3 && (error.message === "Authentication required" || error.message.startsWith("Authentication required: "));
 				return {
 					entries: [],
@@ -207,7 +204,7 @@ function createAcpAgentHarness(params) {
 			if (inspection?.launch.kind !== "installed") throw new Error(`${params.label} is not installed; refresh the model catalog`);
 			const runtime = await runtimeFor(input.workspaceDir);
 			generation.signal.throwIfAborted();
-			const { runAcpHarnessAttempt } = await import("./.setup/harness-attempt-CRe4WIFt.mjs");
+			const { runAcpHarnessAttempt } = await import("./.setup/harness-attempt-lu4_bMfd.mjs");
 			return await runAcpHarnessAttempt({
 				input,
 				runtime,
@@ -226,6 +223,7 @@ function createAcpAgentHarness(params) {
 			}, () => generation.signal.throwIfAborted());
 		},
 		async withSessionDeletion(input, run) {
+			const { createNativeSessionCommitFinalizer } = await import("openclaw/plugin-sdk/agent-harness-session-runtime");
 			let committed = false;
 			try {
 				return await run(createNativeSessionCommitFinalizer({
@@ -248,7 +246,7 @@ function createAcpAgentHarness(params) {
 }
 //#endregion
 //#region extensions/acpx/src/pi-session-catalog-plugin.ts
-const loadPiSessionCatalogModule = createLazyRuntimeModule(() => import("./.setup/pi-session-catalog-runtime-7jc50ZJ4.mjs"));
+const loadPiSessionCatalogModule = createLazyRuntimeModule(() => import("./.setup/pi-session-catalog-runtime-BAM1pEMw.mjs"));
 function fullConfigCatalogEnabled(config) {
 	if (!isRecord(config) || !isRecord(config.plugins) || !isRecord(config.plugins.entries)) return true;
 	const entry = config.plugins.entries.acpx;
@@ -325,7 +323,7 @@ const plugin = {
 		const service = createAcpxRuntimeService({
 			pluginConfig: api.pluginConfig,
 			getAllowedAgents: () => api.runtime.config.current().acp?.allowedAgents,
-			openKeyedStore: (options) => api.runtime.state.openKeyedStore(options)
+			openKeyedStore: (options) => api.runtime.state.openKeyedStoreV2(options)
 		});
 		api.registerService(service);
 		const currentConfig = () => api.runtime.config.current().plugins?.entries?.acpx?.config;

package/dist/register.runtime.js

@@ -1,2 +1 @@
-import { t as createAcpxRuntimeService } from "./.setup/register.runtime-DfAHoa8o.mjs";
-export { createAcpxRuntimeService };
+export { t as createAcpxRuntimeService } from "./.setup/register.runtime-CdG6bROH.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/acpx",
-  "version": "2026.10.5-beta.4",
+  "version": "2026.10.10-beta.1",
   "description": "OpenClaw ACP runtime backend with plugin-owned session and transport management.",
   "repository": {
     "type": "git",
@@ -8,9 +8,9 @@
   },
   "type": "module",
   "dependencies": {
-    "@agentclientprotocol/claude-agent-acp": "0.85.1",
+    "@agentclientprotocol/claude-agent-acp": "0.86.0",
     "@agentclientprotocol/codex-acp": "2.1.1",
-    "@openclaw/fs-safe": "0.25.0",
+    "@openclaw/fs-safe": "0.26.5",
     "acpx": "0.19.4",
     "smol-toml": "1.9.0",
     "zod": "4.6.5"
@@ -45,10 +45,10 @@
       ]
     },
     "compat": {
-      "pluginApi": ">=2026.10.5-beta.4"
+      "pluginApi": ">=2026.10.10-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.10.5-beta.4"
+      "openclawVersion": "2026.10.10-beta.1"
     },
     "release": {
       "publishToClawHub": true,
@@ -68,7 +68,7 @@
     "skills/**"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.10.5-beta.4"
+    "openclaw": ">=2026.10.10-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/skills/acp-router/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: acp-router
-description: Route plain-language requests for Claude Code, Cursor, Copilot, OpenClaw ACP, OpenCode, Gemini CLI, Qwen, Kiro, Kimi, iFlow, Factory Droid, Kilocode, or explicit ACP harness work into either OpenClaw ACP runtime sessions or direct acpx-driven sessions ("telephone game" flow). For coding-agent thread requests, read this skill first, then use only `sessions_spawn` for thread creation. Codex chat binding defaults to the native Codex app-server plugin unless ACP is explicit or background spawn needs ACP.
+description: Route plain-language requests for Claude Code, Cursor, Copilot, OpenClaw ACP, OpenCode, Gemini CLI, Grok Build, Qwen, Kiro, Kimi, iFlow, Factory Droid, Kilocode, or explicit ACP harness work into either OpenClaw ACP runtime sessions or direct acpx-driven sessions ("telephone game" flow). For coding-agent thread requests, read this skill first, then use only `sessions_spawn` for thread creation. Codex chat binding defaults to the native Codex app-server plugin unless ACP is explicit or background spawn needs ACP.
 user-invocable: false
 ---
 
 # ACP Harness Router
 
-When user intent is "run this in Claude Code/Cursor/Copilot/OpenClaw/OpenCode/Gemini/Qwen/Kiro/Kimi/iFlow/Droid/Kilocode (ACP harness)", do not use subagent runtime or PTY scraping. Route through ACP-aware flows.
+When user intent is "run this in Claude Code/Cursor/Copilot/OpenClaw/OpenCode/Gemini/Grok Build/Qwen/Kiro/Kimi/iFlow/Droid/Kilocode (ACP harness)", do not use subagent runtime or PTY scraping. Route through ACP-aware flows.
 
 Codex is special: plain chat/conversation binding and control should use the native Codex app-server plugin (`/codex bind`, `/codex threads`, `/codex resume`) instead of the default ACP path. Use ACP for Codex only when the user explicitly names ACP/`/acp`/acpx, or when spawning background child sessions through `sessions_spawn` where a native Codex runtime spawn is not available yet.
 
@@ -14,7 +14,7 @@ Codex is special: plain chat/conversation binding and control should use the nat
 
 Trigger this skill when the user asks OpenClaw to:
 
-- run something in Claude Code / Cursor / Copilot / OpenClaw / OpenCode / Gemini / Qwen / Kiro / Kimi / iFlow / Droid / Kilocode
+- run something in Claude Code / Cursor / Copilot / OpenClaw / OpenCode / Gemini / Grok Build / Qwen / Kiro / Kimi / iFlow / Droid / Kilocode
 - run Codex explicitly through ACP, `/acp`, or acpx
 - continue existing harness work
 - relay instructions to an external coding harness
@@ -56,6 +56,7 @@ Use these defaults when user names a harness directly:
 - "droid" or "factory droid" -> `agentId: "droid"`
 - "opencode" -> `agentId: "opencode"`
 - "gemini" or "gemini cli" -> `agentId: "gemini"`
+- "grok build" or "grok-build" -> `agentId: "grok-build"`
 - "iflow" -> `agentId: "iflow"`
 - "kilocode" -> `agentId: "kilocode"`
 - "kimi" or "kimi cli" -> `agentId: "kimi"`
@@ -64,6 +65,10 @@ Use these defaults when user names a harness directly:
 
 These defaults match current acpx built-in aliases.
 
+`grok-build` is an ACPX agent target, not the xAI model id
+`xai/grok-build-0.1`. Route `grok-build` through `agentId`; use the fully
+qualified xAI ref only in an OpenClaw `model` field.
+
 If policy rejects the chosen id, report the policy error clearly and ask for the allowed ACP agent id.
 
 ## OpenClaw ACP runtime path
@@ -104,7 +109,7 @@ Required behavior when ACP backend is unavailable:
 
 1. Do not immediately ask the user to pick an alternate path.
 2. First attempt automatic local repair:
-   - ensure plugin-local pinned acpx is installed in the ACPX plugin package
+   - check that plugin-local pinned acpx is installed in the ACPX plugin package
    - verify `${ACPX_CMD} --version`
 3. After reinstall/repair, restart the gateway and explicitly offer to run that restart for the user.
 4. Retry ACP thread spawn once after repair.
@@ -153,7 +158,7 @@ Use this path to drive harness sessions without `/acp` or subagent runtime.
 
 ### Session naming
 
-Use a deterministic name, for example:
+Use a stable name, for example:
 
 - `oc-<harness>-<conversationId>`
 
@@ -196,6 +201,7 @@ ${ACPX_CMD} codex sessions close oc-codex-<conversationId>
 - `cursor`
 - `droid`
 - `gemini`
+- `grok-build`
 - `iflow`
 - `kilocode`
 - `kimi`
@@ -215,6 +221,7 @@ Defaults are:
 - `cursor -> cursor-agent acp`
 - `droid -> droid exec --output-format acp`
 - `gemini -> gemini --acp`
+- `grok-build -> grok agent stdio`
 - `iflow -> iflow --experimental-acp`
 - `kilocode -> npx -y @kilocode/cli acp`
 - `kimi -> kimi acp`