@openclaw/acpx 2026.9.3 → 2026.9.5

package/dist/{service-BAf6nuci.js → .setup/service-DZYyo6-7.mjs}

@@ -1,10 +1,8 @@
-import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { n as createLazyAcpRuntimeProxy } from "./register.runtime-CksaMeEx.js";
-import "./config-schema-DN_uAi4R.js";
-import { _ as splitCommandParts, c as openAcpxProcessLeaseStateStore, d as ACPX_GATEWAY_INSTANCE_KEY, f as ACPX_GATEWAY_INSTANCE_NAMESPACE, h as normalizeAcpxGatewayInstanceRecord, i as createAcpxProcessLeaseStore, l as readAcpxProcessLeaseIdentity, n as OPENCLAW_ACPX_LEASE_ID_ARG, r as OPENCLAW_GATEWAY_INSTANCE_ID_ARG } from "./process-lease-B83BGiLj.js";
-import { i as toAcpMcpServers, n as resolveAcpxPluginRoot, r as resolveOpenClawRoot, t as resolveAcpxPluginConfig } from "./config-D2FTk0K7.js";
+import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
+import { n as createLazyAcpRuntimeProxy } from "./register.runtime-CTfxhkFm.mjs";
+import { _ as splitCommandParts, c as openAcpxProcessLeaseStateStore, d as ACPX_GATEWAY_INSTANCE_KEY, f as ACPX_GATEWAY_INSTANCE_NAMESPACE, h as normalizeAcpxGatewayInstanceRecord, i as createAcpxProcessLeaseStore, l as readAcpxProcessLeaseIdentity, n as OPENCLAW_ACPX_LEASE_ID_ARG, r as OPENCLAW_GATEWAY_INSTANCE_ID_ARG } from "./process-lease-B83BGiLj.mjs";
+import { i as toAcpMcpServers, n as resolveAcpxPluginRoot, r as resolveOpenClawRoot, t as resolveAcpxPluginConfig } from "./config-DvCm0_Dp.mjs";
 import { createRequire } from "node:module";
-import { finiteSecondsToTimerSafeMilliseconds } from "openclaw/plugin-sdk/number-runtime";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { isRecord, normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import fs from "node:fs";
@@ -13,6 +11,7 @@ import path from "node:path";
 import fs$1 from "node:fs/promises";
 import { randomUUID } from "node:crypto";
 import { escapeRegExp } from "openclaw/plugin-sdk/text-utility-runtime";
+import { finiteSecondsToTimerSafeMilliseconds } from "openclaw/plugin-sdk/number-runtime";
 import { inspect } from "node:util";
 import { isPidAlive, runExec } from "openclaw/plugin-sdk/process-runtime";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
@@ -1298,7 +1297,7 @@ var service_exports = /* @__PURE__ */ __exportAll({
 });
 const ENABLE_STARTUP_PROBE_ENV = "OPENCLAW_ACPX_RUNTIME_STARTUP_PROBE";
 const SKIP_RUNTIME_PROBE_ENV = "OPENCLAW_SKIP_ACPX_RUNTIME_PROBE";
-const loadRuntimeModule = createLazyRuntimeModule(() => import("./runtime-CSNBTQIs.js"));
+const loadRuntimeModule = createLazyRuntimeModule(() => import("./runtime-Du-YvDnr.mjs"));
 /** Convert ACPX timeout seconds into timer-safe milliseconds. */
 function resolveAcpxTimerTimeoutMs(timeoutSeconds) {
 	if (timeoutSeconds === void 0) return;
@@ -1343,6 +1342,10 @@ function createLazyDefaultRuntime(params) {
 	}
 	return {
 		...createLazyAcpRuntimeProxy(resolveRuntime),
+		async shutdown() {
+			await runtimePromise;
+			await runtime?.shutdown();
+		},
 		isHealthy() {
 			return runtime?.isHealthy() ?? false;
 		}
@@ -1556,7 +1559,10 @@ function createAcpxRuntimeService(params) {
 		},
 		async stop(_ctx) {
 			lifecycleRevision += 1;
-			if (runtime) params.backendLifecycle.retract(runtime);
+			if (runtime) {
+				params.backendLifecycle.retract(runtime);
+				await runtime.shutdown();
+			}
 			runtime = null;
 		}
 	};

package/dist/{session-owner-migration-D36AH9RC.js → .setup/session-owner-migration-BuKHYP6F.mjs}

@@ -1,5 +1,5 @@
-import { a as hashAcpxProcessCommand, c as openAcpxProcessLeaseStateStore, l as readAcpxProcessLeaseIdentity, o as normalizeAcpxProcessLease } from "./process-lease-B83BGiLj.js";
-import { t as resolveAcpxPluginConfig } from "./config-D2FTk0K7.js";
+import { a as hashAcpxProcessCommand, c as openAcpxProcessLeaseStateStore, l as readAcpxProcessLeaseIdentity, o as normalizeAcpxProcessLease } from "./process-lease-B83BGiLj.mjs";
+import { t as resolveAcpxPluginConfig } from "./config-DvCm0_Dp.mjs";
 import path from "node:path";
 import fs from "node:fs/promises";
 import { archiveLegacyStateSource, asObjectRecord } from "openclaw/plugin-sdk/runtime-doctor-migrations";
@@ -23,7 +23,7 @@ async function legacyRecords(input) {
 		directory,
 		ids
 	};
-	const { resolveAcpxSessionResource } = await import("./session-resource-UWe7qD3m.js").then((n) => n.n);
+	const { resolveAcpxSessionResource } = await import("./session-resource-Dzl0U7kK.mjs").then((n) => n.n);
 	const evidence = await input.context.inspectAcpSessionClaims?.();
 	const { decodeAcpxRuntimeHandleState } = await import("acpx/runtime");
 	return {
@@ -66,7 +66,7 @@ async function migrateRecord(input, directory, oldId, claims, changes, warnings)
 	const raw = asObjectRecord(JSON.parse(sourceBytes));
 	if (!raw || raw.acpx_record_id !== oldId || typeof raw.name !== "string" || !raw.name.trim() || raw.name !== oldId && !oldId.startsWith(`${raw.name}:oneshot:`)) throw new Error("record ID/name is not a recognized ACPX locator");
 	requireStoppedPid(raw.pid);
-	const { resolveAcpxSessionResource } = await import("./session-resource-UWe7qD3m.js").then((n) => n.n);
+	const { resolveAcpxSessionResource } = await import("./session-resource-Dzl0U7kK.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");

package/dist/{session-resource-UWe7qD3m.js → .setup/session-resource-Dzl0U7kK.mjs}

@@ -1,5 +1,5 @@
-import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { AcpRuntimeError } from "./runtime-api.js";
+import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.mjs";
+import { AcpRuntimeError } from "../runtime-api.js";
 import { createHash } from "node:crypto";
 import { normalizeAgentId, parseAgentSessionKey } from "openclaw/plugin-sdk/routing";
 //#region extensions/acpx/src/session-resource.ts

package/dist/doctor-contract-api.js

@@ -1,4 +1,4 @@
-import { c as openAcpxProcessLeaseStateStore, d as ACPX_GATEWAY_INSTANCE_KEY, f as ACPX_GATEWAY_INSTANCE_NAMESPACE, h as normalizeAcpxGatewayInstanceRecord, m as ACPX_LEGACY_PROCESS_LEASE_FILE, o as normalizeAcpxProcessLease, p as ACPX_LEGACY_GATEWAY_INSTANCE_FILE, s as normalizeAcpxProcessLeaseFile } from "./process-lease-B83BGiLj.js";
+import { c as openAcpxProcessLeaseStateStore, d as ACPX_GATEWAY_INSTANCE_KEY, f as ACPX_GATEWAY_INSTANCE_NAMESPACE, h as normalizeAcpxGatewayInstanceRecord, m as ACPX_LEGACY_PROCESS_LEASE_FILE, o as normalizeAcpxProcessLease, p as ACPX_LEGACY_GATEWAY_INSTANCE_FILE, s as normalizeAcpxProcessLeaseFile } from "./.setup/process-lease-B83BGiLj.mjs";
 import path from "node:path";
 import fs from "node:fs/promises";
 import { archiveLegacyStateSource, asObjectRecord } from "openclaw/plugin-sdk/runtime-doctor-migrations";
@@ -137,10 +137,10 @@ const stateMigrations = [{
 	doctorOnly: true,
 	phase: "after-session-repair",
 	async detectLegacyState(input) {
-		return (await import("./session-owner-migration-D36AH9RC.js")).acpxSessionOwnerMigration.detectLegacyState(input);
+		return (await import("./.setup/session-owner-migration-BuKHYP6F.mjs")).acpxSessionOwnerMigration.detectLegacyState(input);
 	},
 	async migrateLegacyState(input) {
-		return (await import("./session-owner-migration-D36AH9RC.js")).acpxSessionOwnerMigration.migrateLegacyState(input);
+		return (await import("./.setup/session-owner-migration-BuKHYP6F.mjs")).acpxSessionOwnerMigration.migrateLegacyState(input);
 	}
 }];
 //#endregion

package/dist/index.js

@@ -1,14 +1,12 @@
-import { t as createAcpxRuntimeService } from "./register.runtime-CksaMeEx.js";
-import "./config-schema-DN_uAi4R.js";
-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 "./pi-session-paths-EMbd4Hkz.js";
+import { t as createAcpxRuntimeService } from "./.setup/register.runtime-CTfxhkFm.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-EMbd4Hkz.mjs";
 import { tryDispatchAcpReplyHook } from "openclaw/plugin-sdk/acp-runtime-backend";
-import { finiteSecondsToTimerSafeMilliseconds } from "openclaw/plugin-sdk/number-runtime";
 import { createLazyRuntimeModule, createLazyRuntimeSurface } from "openclaw/plugin-sdk/lazy-runtime";
 import { resolveNodeHostExecutable } from "openclaw/plugin-sdk/node-host";
 import { createSessionCatalogNodeHostBindings } from "openclaw/plugin-sdk/session-catalog";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/acpx/src/pi-session-catalog-plugin.ts
-const loadPiSessionCatalogModule = createLazyRuntimeModule(() => import("./pi-session-catalog-runtime-BIieInfo.js"));
+const loadPiSessionCatalogModule = createLazyRuntimeModule(() => import("./.setup/pi-session-catalog-runtime-CbLyvshh.mjs"));
 function fullConfigCatalogEnabled(config) {
 	if (!isRecord(config) || !isRecord(config.plugins) || !isRecord(config.plugins.entries)) return true;
 	const entry = config.plugins.entries.acpx;
@@ -76,39 +74,17 @@ function registerPiSessionCatalog(api) {
 * ACPX runtime plugin entry. It registers the embedded ACP backend service and
 * wires reply-dispatch hooks into the plugin SDK runtime.
 */
-function resolveReplyDispatchTimeoutMs(pluginConfig) {
-	const timeoutSeconds = pluginConfig?.timeoutSeconds;
-	return finiteSecondsToTimerSafeMilliseconds(typeof timeoutSeconds === "number" && Number.isFinite(timeoutSeconds) && timeoutSeconds > 0 ? timeoutSeconds : 120) ?? 1;
-}
-async function tryDispatchAcpReplyHookWithTimeout(event, ctx, timeoutMs) {
-	const timeoutController = new AbortController();
-	const timeout = setTimeout(() => timeoutController.abort(), timeoutMs);
-	timeout.unref?.();
-	const abortSignal = ctx.abortSignal ? AbortSignal.any([ctx.abortSignal, timeoutController.signal]) : timeoutController.signal;
-	try {
-		return await tryDispatchAcpReplyHook(event, {
-			...ctx,
-			abortSignal
-		});
-	} finally {
-		clearTimeout(timeout);
-	}
-}
 const plugin = {
 	id: "acpx",
 	name: "ACPX Runtime",
 	description: "Embedded ACP runtime backend with plugin-owned session and transport management.",
 	register(api) {
-		const replyDispatchTimeoutMs = resolveReplyDispatchTimeoutMs(api.pluginConfig);
 		registerPiSessionCatalog(api);
 		api.registerService(createAcpxRuntimeService({
 			pluginConfig: api.pluginConfig,
 			openKeyedStore: (options) => api.runtime.state.openKeyedStore(options)
 		}));
-		api.on("reply_dispatch", (event, ctx) => tryDispatchAcpReplyHookWithTimeout(event, ctx, replyDispatchTimeoutMs), {
-			timeoutMs: replyDispatchTimeoutMs,
-			eligibleDispatchKinds: ["acp"]
-		});
+		api.on("reply_dispatch", tryDispatchAcpReplyHook, { eligibleDispatchKinds: ["acp"] });
 	}
 };
 //#endregion

package/dist/register.runtime.js

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

package/openclaw.plugin.json

@@ -1,5 +1,6 @@
 {
   "id": "acpx",
+  "categories": ["agent-runtimes"],
   "backupResources": [
     {
       "disposition": "regenerable",
@@ -30,6 +31,32 @@
   "name": "ACPX Runtime",
   "description": "OpenClaw ACP runtime backend with plugin-owned session and transport management.",
   "skills": ["./skills"],
+  "configGroups": [
+    {
+      "id": "agent-runtime",
+      "title": "Agent runtime",
+      "order": 10,
+      "properties": ["cwd", "stateDir", "probeAgent", "agents", "timeoutSeconds"]
+    },
+    {
+      "id": "permissions",
+      "title": "Permissions",
+      "order": 20,
+      "properties": ["permissionMode", "nonInteractivePermissions"]
+    },
+    {
+      "id": "tools-and-mcp-servers",
+      "title": "Tools and MCP servers",
+      "order": 30,
+      "properties": ["pluginToolsMcpBridge", "openClawToolsMcpBridge", "mcpServers"]
+    },
+    {
+      "id": "pi-sessions",
+      "title": "Pi sessions",
+      "order": 40,
+      "properties": ["piSessionCatalog"]
+    }
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/acpx",
-  "version": "2026.9.3",
+  "version": "2026.9.5",
   "description": "OpenClaw ACP runtime backend with plugin-owned session and transport management.",
   "repository": {
     "type": "git",
@@ -8,11 +8,11 @@
   },
   "type": "module",
   "dependencies": {
-    "@agentclientprotocol/claude-agent-acp": "0.70.0",
-    "@agentclientprotocol/codex-acp": "1.6.2",
-    "acpx": "0.13.2",
+    "@agentclientprotocol/claude-agent-acp": "0.75.1",
+    "@agentclientprotocol/codex-acp": "1.10.0",
+    "acpx": "0.16.0",
     "smol-toml": "1.8.0",
-    "zod": "4.4.3"
+    "zod": "4.5.4"
   },
   "devDependencies": {
     "@openclaw/plugin-sdk": "workspace:*"
@@ -22,6 +22,7 @@
       "./index.ts"
     ],
     "install": {
+      "clawhubSpec": "clawhub:@openclaw/acpx",
       "npmSpec": "@openclaw/acpx",
       "defaultChoice": "npm",
       "minHostVersion": ">=2026.4.25",
@@ -43,10 +44,10 @@
       ]
     },
     "compat": {
-      "pluginApi": ">=2026.9.3"
+      "pluginApi": ">=2026.9.5"
     },
     "build": {
-      "openclawVersion": "2026.9.3",
+      "openclawVersion": "2026.9.5",
       "staticAssets": [
         {
           "source": "./src/runtime-internals/mcp-proxy.mjs",
@@ -71,10 +72,12 @@
     "dist/**",
     "openclaw.plugin.json",
     "README.md",
+    "assets/icon.png",
+    "assets/activity.svg",
     "skills/**"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.9.3"
+    "openclaw": ">=2026.9.5"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/skills/acp-router/SKILL.md

@@ -209,8 +209,8 @@ ${ACPX_CMD} codex sessions close oc-codex-<conversationId>
 Defaults are:
 
 - `openclaw -> openclaw acp`
-- `claude -> bundled @agentclientprotocol/claude-agent-acp@0.70.0`
-- `codex -> bundled @agentclientprotocol/codex-acp@1.6.2 through OpenClaw's isolated CODEX_HOME wrapper`
+- `claude -> bundled @agentclientprotocol/claude-agent-acp@0.75.1`
+- `codex -> bundled @agentclientprotocol/codex-acp@1.10.0 through OpenClaw's isolated CODEX_HOME wrapper`
 - `copilot -> copilot --acp --stdio`
 - `cursor -> cursor-agent acp`
 - `droid -> droid exec --output-format acp`

package/dist/config-schema-DN_uAi4R.js

@@ -1,37 +0,0 @@
-import { z } from "zod";
-//#region extensions/acpx/src/config-schema.ts
-/**
-* ACPX plugin configuration schema and public config types. Runtime setup uses
-* this file as the single source of truth for validation and defaulting.
-*/
-const ACPX_PERMISSION_MODES = [
-	"approve-all",
-	"approve-reads",
-	"deny-all"
-];
-const ACPX_NON_INTERACTIVE_POLICIES = ["deny", "fail"];
-const nonEmptyTrimmedString = (message) => z.string({ error: message }).trim().min(1, { error: message });
-const McpServerConfigSchema = z.object({
-	command: nonEmptyTrimmedString("command must be a non-empty string").describe("Command to run the MCP server"),
-	args: z.array(z.string({ error: "args must be an array of strings" }), { error: "args must be an array of strings" }).optional().describe("Arguments to pass to the command"),
-	env: z.record(z.string(), z.string({ error: "env values must be strings" }), { error: "env must be an object of strings" }).optional().describe("Environment variables for the MCP server")
-});
-/** Zod schema for validating raw ACPX plugin config from OpenClaw config. */
-const AcpxPluginConfigSchema = z.strictObject({
-	cwd: nonEmptyTrimmedString("cwd must be a non-empty string").optional(),
-	stateDir: nonEmptyTrimmedString("stateDir must be a non-empty string").optional(),
-	probeAgent: nonEmptyTrimmedString("probeAgent must be a non-empty string").optional(),
-	permissionMode: z.enum(ACPX_PERMISSION_MODES, { error: `permissionMode must be one of: ${ACPX_PERMISSION_MODES.join(", ")}` }).optional(),
-	nonInteractivePermissions: z.enum(ACPX_NON_INTERACTIVE_POLICIES, { error: `nonInteractivePermissions must be one of: ${ACPX_NON_INTERACTIVE_POLICIES.join(", ")}` }).optional(),
-	pluginToolsMcpBridge: z.boolean({ error: "pluginToolsMcpBridge must be a boolean" }).optional(),
-	openClawToolsMcpBridge: z.boolean({ error: "openClawToolsMcpBridge must be a boolean" }).optional(),
-	timeoutSeconds: z.number({ error: "timeoutSeconds must be a number >= 0.001" }).min(.001, { error: "timeoutSeconds must be a number >= 0.001" }).default(120),
-	piSessionCatalog: z.strictObject({ enabled: z.boolean({ error: "piSessionCatalog.enabled must be a boolean" }).default(true) }).optional(),
-	mcpServers: z.record(z.string(), McpServerConfigSchema).optional(),
-	agents: z.record(z.string(), z.strictObject({
-		command: nonEmptyTrimmedString("agents.<id>.command must be a non-empty string"),
-		args: z.array(z.string({ error: "args must be an array of strings" })).optional()
-	})).optional()
-});
-//#endregion
-export { AcpxPluginConfigSchema as t };