@openclaw/acpx 2026.5.28-beta.3 → 2026.5.28

package/README.md

@@ -0,0 +1,33 @@
+# @openclaw/acpx
+
+Official ACP runtime backend for OpenClaw.
+
+ACPx lets OpenClaw run external coding harnesses through the Agent Client Protocol while OpenClaw still owns sessions, channels, delivery, permissions, and Gateway state.
+
+## Install
+
+```bash
+openclaw plugins install @openclaw/acpx
+```
+
+Restart the Gateway after installing or updating the plugin.
+
+## What it provides
+
+- ACP-backed agent runtime sessions.
+- Plugin-owned session and transport management.
+- MCP bridge helpers for OpenClaw tools and plugin tools.
+- Static runtime assets used by the ACP process bridge.
+
+## Configure
+
+Use the ACP docs for harness-specific setup, permission modes, and model/runtime selection:
+
+- https://docs.openclaw.ai/tools/acp-agents-setup
+- https://docs.openclaw.ai/tools/acp-agents
+
+## Package
+
+- Plugin id: `acpx`
+- Package: `@openclaw/acpx`
+- Minimum OpenClaw host: `2026.4.25`

package/dist/index.js

@@ -1,4 +1,4 @@
-import { t as createAcpxRuntimeService } from "./register.runtime-pBU18bwu.js";
+import { t as createAcpxRuntimeService } from "./register.runtime-D07L8fDT.js";
 import { tryDispatchAcpReplyHook } from "openclaw/plugin-sdk/acp-runtime-backend";
 //#region extensions/acpx/index.ts
 const plugin = {

package/dist/{register.runtime-pBU18bwu.js → register.runtime-D07L8fDT.js}

@@ -191,7 +191,7 @@ function createLazyAcpRuntimeProxy(resolveRuntime) {
 const ACPX_BACKEND_ID = "acpx";
 let serviceModulePromise = null;
 function loadServiceModule() {
-	serviceModulePromise ??= import("./service-Dqn4OqIc.js");
+	serviceModulePromise ??= import("./service-BrT7jug3.js");
 	return serviceModulePromise;
 }
 async function startRealService(state) {

package/dist/register.runtime.js

@@ -1,2 +1,2 @@
-import { t as createAcpxRuntimeService } from "./register.runtime-pBU18bwu.js";
+import { t as createAcpxRuntimeService } from "./register.runtime-D07L8fDT.js";
 export { createAcpxRuntimeService };

package/dist/{service-Dqn4OqIc.js → service-BrT7jug3.js}

@@ -1,9 +1,10 @@
-import { n as createLazyAcpRuntimeProxy } from "./register.runtime-pBU18bwu.js";
+import { n as createLazyAcpRuntimeProxy } from "./register.runtime-D07L8fDT.js";
 import { registerAcpRuntimeBackend, unregisterAcpRuntimeBackend } from "./runtime-api.js";
 import { a as resolveAcpxPluginRoot, c as OPENCLAW_ACPX_LEASE_ID_ENV, d as createAcpxProcessLeaseStore, h as splitCommandParts, i as resolveAcpxPluginConfig, l as OPENCLAW_GATEWAY_INSTANCE_ID_ARG, m as quoteCommandPart, o as toAcpMcpServers, r as reapStaleOpenClawOwnedAcpxOrphans, s as OPENCLAW_ACPX_LEASE_ID_ARG, t as cleanupOpenClawOwnedAcpxProcessTree } from "./process-reaper-CAUlLOkM.js";
 import { createRequire } from "node:module";
 import fs from "node:fs/promises";
 import path from "node:path";
+import { finiteSecondsToTimerSafeMilliseconds } from "openclaw/plugin-sdk/number-runtime";
 import { randomUUID } from "node:crypto";
 import { readJsonFileWithFallback } from "openclaw/plugin-sdk/json-store";
 import { inspect } from "node:util";
@@ -804,6 +805,10 @@ function loadRuntimeModule() {
 	runtimeModulePromise ??= import("./runtime-BaP1xg1D.js");
 	return runtimeModulePromise;
 }
+function resolveAcpxTimerTimeoutMs(timeoutSeconds) {
+	if (timeoutSeconds === void 0) return;
+	return finiteSecondsToTimerSafeMilliseconds(timeoutSeconds) ?? 1;
+}
 function createLazyDefaultRuntime(params) {
 	let runtime = null;
 	let runtimePromise = null;
@@ -821,7 +826,7 @@ function createLazyDefaultRuntime(params) {
 				mcpServers: toAcpMcpServers(params.pluginConfig.mcpServers),
 				permissionMode: params.pluginConfig.permissionMode,
 				nonInteractivePermissions: params.pluginConfig.nonInteractivePermissions,
-				timeoutMs: params.pluginConfig.timeoutSeconds != null ? params.pluginConfig.timeoutSeconds * 1e3 : void 0
+				timeoutMs: resolveAcpxTimerTimeoutMs(params.pluginConfig.timeoutSeconds)
 			});
 			return runtime;
 		});
@@ -893,7 +898,7 @@ function shouldProbeRuntimeAtStartup(env = process.env) {
 }
 async function withStartupProbeTimeout(params) {
 	let timeout;
-	const timeoutMs = Math.max(1, params.timeoutSeconds * 1e3);
+	const timeoutMs = resolveAcpxTimerTimeoutMs(params.timeoutSeconds) ?? 1;
 	try {
 		return await Promise.race([params.promise, new Promise((_, reject) => {
 			timeout = setTimeout(() => {
@@ -1052,4 +1057,4 @@ function createAcpxRuntimeService(params = {}) {
 	};
 }
 //#endregion
-export { createAcpxRuntimeService };
+export { createAcpxRuntimeService, resolveAcpxTimerTimeoutMs };

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@openclaw/acpx",
-  "version": "2026.5.28-beta.3",
+  "version": "2026.5.28",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/acpx",
-      "version": "2026.5.28-beta.3",
+      "version": "2026.5.28",
       "dependencies": {
         "@agentclientprotocol/claude-agent-acp": "0.37.0",
         "@zed-industries/codex-acp": "0.15.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/acpx",
-  "version": "2026.5.28-beta.3",
+  "version": "2026.5.28",
   "description": "OpenClaw ACP runtime backend with plugin-owned session and transport management.",
   "repository": {
     "type": "git",
@@ -26,10 +26,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.5.28-beta.3"
+      "pluginApi": ">=2026.5.28"
     },
     "build": {
-      "openclawVersion": "2026.5.28-beta.3",
+      "openclawVersion": "2026.5.28",
       "staticAssets": [
         {
           "source": "./src/runtime-internals/mcp-proxy.mjs",
@@ -54,10 +54,11 @@
     "dist/**",
     "openclaw.plugin.json",
     "npm-shrinkwrap.json",
+    "README.md",
     "skills/**"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.5.28-beta.3"
+    "openclaw": ">=2026.5.28"
   },
   "peerDependenciesMeta": {
     "openclaw": {