@openclaw/acpx 2026.10.5-beta.4 → 2026.10.6

package/README.md

@@ -25,6 +25,10 @@ to regenerate wrappers written by an older plugin version.
 - MCP bridge helpers for OpenClaw tools and plugin tools.
 - Static runtime assets used by the ACP process bridge.
 
+If the Gateway restarts before a one-shot session receives its first prompt, ACPX
+reuses the initialized conversation when the agent supports loading or resuming
+sessions. Completed one-shot runs still start a fresh conversation.
+
 ## Native agents in the model picker
 
 Install GitHub Copilot CLI, Kilo Code, OpenCode, Pi ACP, or Qwen Code and complete its login on the Gateway host,

package/dist/.setup/{register.runtime-DfAHoa8o.mjs → register.runtime-Cm9fd3R2.mjs}

@@ -53,7 +53,7 @@ function createLazyAcpRuntimeProxy(resolveRuntime) {
 * immediately, then imports the heavier service only when a session needs it.
 */
 const ACPX_BACKEND_ID = "acpx";
-const loadServiceModule = createLazyRuntimeModule(() => import("./service-De_oVTL3.mjs"));
+const loadServiceModule = createLazyRuntimeModule(() => import("./service-42j3ASsm.mjs"));
 function unregisterOwnedRuntime(runtime) {
 	if (runtime && getAcpRuntimeBackend(ACPX_BACKEND_ID)?.runtime === runtime) unregisterAcpRuntimeBackend(ACPX_BACKEND_ID);
 }

package/dist/.setup/{service-De_oVTL3.mjs → service-42j3ASsm.mjs}

@@ -6,7 +6,7 @@ import { createRequire } from "node:module";
 import { AcpxRuntime, createAgentRegistry, createFileSessionStore, decodeAcpxRuntimeHandleState, isRequestedModelUnsupportedError } from "acpx/runtime";
 import { finiteSecondsToTimerSafeMilliseconds, parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
 import fs from "node:fs";
-import path, { resolve } from "node:path";
+import path from "node:path";
 import { asOptionalObjectRecord, isRecord, normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString, normalizeOptionalString, normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import os, { availableParallelism } from "node:os";
 import { randomUUID } from "node:crypto";
@@ -1892,9 +1892,9 @@ var AcpxRuntime$1 = class {
 			},
 			list: () => this.agentRegistry.list()
 		};
-		const createDelegate = (probeAgent = options.probeAgent) => new AcpxRuntime({
+		const createBase = (overrides = {}) => new AcpxRuntime({
 			...options,
-			probeAgent,
+			...overrides,
 			sessionStore: this.sessionStore,
 			agentRegistry: this.scopedAgentRegistry,
 			sessionPermissions: (context) => {
@@ -1933,11 +1933,14 @@ var AcpxRuntime$1 = class {
 				onExit: options.processLifecycle?.onExit
 			}
 		}, testOptions);
-		this.delegate = createDelegate();
-		this.generationRegistry = new AcpxGenerationRegistry(this.sessionStore, this.delegate, createDelegate);
+		this.delegate = createBase();
+		this.generationRegistry = new AcpxGenerationRegistry(this.sessionStore, this.delegate, createBase);
 		this.probe = new AcpxRuntimeProbe({
 			getAgent: () => normalizeOptionalLowercaseString(options.getProbeAgent?.() ?? options.probeAgent) ?? "codex",
-			createRuntime: createDelegate,
+			createRuntime: (probeAgent) => createBase({
+				probeAgent,
+				cwd: this.wrapperRoot ?? this.cwd
+			}),
 			assertRunning: () => this.generationRegistry.assertRunning(),
 			runWithLease: (agent, run) => this.runWithLaunchLease({
 				agent,
@@ -2008,23 +2011,32 @@ var AcpxRuntime$1 = class {
 	resolveDelegateForOperationSnapshot(handle, snapshot) {
 		return this.generationRegistry.resolveDelegate(snapshot.generation, snapshot.generation.nativeTools ?? resolveBridgeSession(handle)?.native === true);
 	}
-	async readReusablePersistentSessionCommand(params) {
-		if (params.mode !== "persistent" || !params.command) return;
-		const existing = await this.sessionStore.load(params.sessionKey);
-		if (!existing || readRecordResetOnNextEnsure(existing)) return;
-		const recordCwd = readRecordCwd(existing);
-		if (!recordCwd || resolve(recordCwd) !== resolve(params.cwd?.trim() || this.cwd)) return;
-		const recordCommand = readRecordAgentCommand(existing);
-		if (!recordCommand) return;
-		const leaseIdentity = readAcpxProcessLeaseIdentity(recordCommand);
-		if (leaseIdentity && leaseIdentity.gatewayInstanceId !== this.gatewayInstanceId) return;
-		const stableRecordCommand = leaseIdentity ? withAcpxLeaseArgs({
-			command: params.command,
-			leaseId: leaseIdentity.leaseId,
-			gatewayInstanceId: leaseIdentity.gatewayInstanceId
-		}) : params.command;
-		if (!isDeepStrictEqual(splitCommandParts(recordCommand), splitCommandParts(stableRecordCommand))) return;
-		return !params.resumeSessionId || existing.acpSessionId === params.resumeSessionId ? recordCommand : void 0;
+	async readReusableSession(input, command) {
+		const { persistedHandle, sessionKey, resumeSessionId } = input;
+		const oneShot = input.mode === "oneshot";
+		const decoded = persistedHandle && decodeAcpxRuntimeHandleState(persistedHandle.runtimeSessionName);
+		if (!command || oneShot && (resumeSessionId || persistedHandle?.backend !== "acpx" || !persistedHandle.acpxRecordId || decoded?.mode !== "oneshot" || decoded.name !== sessionKey || decoded.acpxRecordId !== persistedHandle.acpxRecordId || decoded.agent !== normalizeOptionalLowercaseString(input.agent))) return;
+		const recordId = oneShot ? persistedHandle?.acpxRecordId : sessionKey;
+		if (!recordId) return;
+		const record = await this.sessionStore.load(recordId);
+		if (!record || readRecordResetOnNextEnsure(record)) return;
+		if (oneShot && (record.acpxRecordId !== recordId || readSessionRecordName(record) !== sessionKey || record.acpSessionId !== (persistedHandle?.backendSessionId ?? decoded?.backendSessionId) || !record.agentCapabilities?.loadSession && !record.agentCapabilities?.sessionCapabilities?.resume || record.lastPromptAt !== void 0 || record.messages.some((message) => typeof message !== "string" && "User" in message))) return;
+		const recordCwd = readRecordCwd(record);
+		const recordCommand = readRecordAgentCommand(record);
+		if (!recordCwd || !recordCommand || path.resolve(recordCwd) !== path.resolve(input.cwd?.trim() || this.cwd) || !oneShot && resumeSessionId && record.acpSessionId !== resumeSessionId) return;
+		const lease = readAcpxProcessLeaseIdentity(recordCommand);
+		const ownLease = !lease || lease.gatewayInstanceId === this.gatewayInstanceId;
+		if (!oneShot && !ownLease) return;
+		const expectedCommand = lease ? withAcpxLeaseArgs({
+			command,
+			leaseId: lease.leaseId,
+			gatewayInstanceId: lease.gatewayInstanceId
+		}) : command;
+		if (!isDeepStrictEqual(splitCommandParts(recordCommand), splitCommandParts(expectedCommand))) return;
+		return {
+			reusableCommand: ownLease ? recordCommand : void 0,
+			resumeSessionId: oneShot ? record.acpSessionId : void 0
+		};
 	}
 	async runWithLaunchLease(params) {
 		if (!params.command || !this.wrapperRoot || !this.gatewayInstanceId || !this.processLeaseStore || !isOpenClawLeaseAwareAcpxProcessCommand({
@@ -2183,26 +2195,28 @@ var AcpxRuntime$1 = class {
 			model: claudeModelOverride
 		} : effectiveInput;
 		const stableLaunchCommand = codexModelOverride && command ? appendCodexAcpConfigOverrides(command, codexModelOverride) : command;
-		const reusableCommand = await this.readReusablePersistentSessionCommand({
-			sessionKey: input.sessionKey,
-			mode: input.mode,
-			cwd: input.cwd,
-			command: stableLaunchCommand,
-			resumeSessionId: input.resumeSessionId
-		});
+		const restoration = await this.readReusableSession(input, stableLaunchCommand);
+		this.generationRegistry.assertCurrentGeneration(generation);
+		const restoredInput = restoration?.resumeSessionId ? {
+			...ensureInput,
+			resumeSessionId: restoration.resumeSessionId
+		} : ensureInput;
 		return {
 			...await this.runWithLaunchLease({
-				agent: ensureInput.agent,
+				agent: restoredInput.agent,
 				sessionKey: ensureInput.sessionKey,
 				command: stableLaunchCommand,
-				reusableCommand,
+				reusableCommand: restoration?.reusableCommand,
 				run: () => this.withCodexWrapperDiagnostics({
 					command: stableLaunchCommand,
 					fallbackCode: "ACP_SESSION_INIT_FAILED",
-					run: () => codexModelOverride ? delegate.ensureSession(withAcpxSessionOptions(ensureInput)) : ensureSessionWithModelRef((request) => {
+					run: () => {
 						this.generationRegistry.assertCurrentGeneration(generation);
-						return delegate.ensureSession(request);
-					}, ensureInput)
+						return codexModelOverride ? delegate.ensureSession(withAcpxSessionOptions(restoredInput)) : ensureSessionWithModelRef((request) => {
+							this.generationRegistry.assertCurrentGeneration(generation);
+							return delegate.ensureSession(request);
+						}, restoredInput);
+					}
 				})
 			}),
 			...logicalTarget,

package/dist/index.js

@@ -1,4 +1,4 @@
-import { t as createAcpxRuntimeService } from "./.setup/register.runtime-DfAHoa8o.mjs";
+import { t as createAcpxRuntimeService } from "./.setup/register.runtime-Cm9fd3R2.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";

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-Cm9fd3R2.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/acpx",
-  "version": "2026.10.5-beta.4",
+  "version": "2026.10.6",
   "description": "OpenClaw ACP runtime backend with plugin-owned session and transport management.",
   "repository": {
     "type": "git",
@@ -45,10 +45,10 @@
       ]
     },
     "compat": {
-      "pluginApi": ">=2026.10.5-beta.4"
+      "pluginApi": ">=2026.10.6"
     },
     "build": {
-      "openclawVersion": "2026.10.5-beta.4"
+      "openclawVersion": "2026.10.6"
     },
     "release": {
       "publishToClawHub": true,
@@ -68,7 +68,7 @@
     "skills/**"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.10.5-beta.4"
+    "openclaw": ">=2026.10.6"
   },
   "peerDependenciesMeta": {
     "openclaw": {