@nyssance/codex-acp-v2 0.7.1 → 0.7.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.7.2 — 2026-09-29
+
+### Added
+
+- Turn correlation v2 (`capabilities._meta.alwith.turns = {version: 2}`): `session/prompt`
+  accepts a host-named receipt in `_meta.alwith.messageId`, and every `state_update` of a
+  prompted turn carries `_meta.alwith.messageId`. A stale `idle` of an older turn is dropped
+  once a newer prompt owns the session.
+
 ## 0.7.1 — 2026-09-29
 
 ### Changed

package/dist/index.js

@@ -21844,7 +21844,7 @@ var package_default = {
   publishConfig: {
     access: "public"
   },
-  version: "0.7.1",
+  version: "0.7.2",
   description: "Native ACP v2 agent for the OpenAI Codex app-server",
   packageManager: "bun@1.4.0",
   engines: {
@@ -25963,6 +25963,7 @@ class ClientSession {
   disposed = false;
   output = new AbortController;
   terminalAttempted = false;
+  messageId;
   get signal() {
     return this.output.signal;
   }
@@ -26006,26 +26007,36 @@ class ClientSession {
       return;
     await abortable(this.link.notify(methods.client.elicitation.complete, { elicitationId }), this.output.signal);
   }
-  reportRunning() {
+  reportRunning(messageId) {
+    this.messageId = messageId;
     this.terminalAttempted = false;
     this.turnGeneration += 1;
     this.turnActive = true;
     this.waiting = 0;
     this.state({ sessionUpdate: "state_update", state: "running" });
   }
-  async reportIdle(stopReason, extra) {
+  async reportIdle(stopReason, extra, messageId = this.messageId) {
+    if (messageId !== this.messageId)
+      return;
     if (this.terminalAttempted)
       return;
     this.terminalAttempted = true;
     this.turnActive = false;
     this.waiting = 0;
-    await this.update({
+    await this.update(this.correlated({
       sessionUpdate: "state_update",
       state: "idle",
       stopReason,
       ...extra?.usage === undefined ? {} : { usage: extra.usage },
       ...extra?._meta === undefined ? {} : { _meta: extra._meta }
-    });
+    }));
+  }
+  correlated(update) {
+    if (this.messageId === undefined)
+      return update;
+    const meta = update._meta;
+    const alwith = meta?.["alwith"];
+    return { ...update, _meta: { ...meta, alwith: { ...alwith, messageId: this.messageId } } };
   }
   async waitingOnClient(operation, signal) {
     if (this.disposed)
@@ -26046,7 +26057,7 @@ class ClientSession {
   }
   async state(update) {
     try {
-      await this.update(update);
+      await this.update(this.correlated(update));
     } catch (error40) {
       logger.error("Failed to publish session state", error40, { sessionId: this.sessionId });
     }
@@ -26776,7 +26787,7 @@ class CodexAgent {
           additionalDirectories: {}
         },
         providers: {},
-        _meta: { alwith: { tools: { version: 1 } }, codex: { archive: true, seedHistory: true, skills: true, plugins: true, providerCatalog: true, rename: true, account: true, fuzzyFileSearch: true } }
+        _meta: { alwith: { tools: { version: 1 }, turns: { version: 2 } }, codex: { archive: true, seedHistory: true, skills: true, plugins: true, providerCatalog: true, rename: true, account: true, fuzzyFileSearch: true } }
       },
       authMethods: authMethods(this.capabilities, this.env)
     };
@@ -27533,7 +27544,7 @@ class CodexAgent {
     return runtime;
   }
   async prompt(params) {
-    return await this.promptInternal(params, false, crypto.randomUUID());
+    return await this.promptInternal(params, false, requestedMessageId(params) ?? crypto.randomUUID());
   }
   async promptInternal(params, allowReentry, messageId) {
     this.assertRoutingAvailable();
@@ -27557,7 +27568,7 @@ class CodexAgent {
     }
     const turn = createActiveTurn(session.id, messageId);
     session.activeTurn = turn;
-    runtime.client.reportRunning();
+    runtime.client.reportRunning(messageId);
     this.runPrompt(runtime, turn, params);
     return { messageId };
   }
@@ -27781,7 +27792,7 @@ class CodexAgent {
     await runtime.bridge.finishOpenToolCalls(reason === "cancelled" ? "cancelled" : reason === "end_turn" ? "completed" : "failed");
     if (runtime.session.activeTurn === turn)
       runtime.session.activeTurn = null;
-    await runtime.client.reportIdle(reason, extra);
+    await runtime.client.reportIdle(reason, extra, turn.clientUserMessageId ?? undefined);
   }
   async reportTurnFailure(runtime, turn, error40) {
     const { stopReason, ...classification } = classifyTurnError(error40.codexErrorInfo);
@@ -27966,6 +27977,15 @@ ${stderr}` : ""}`);
 function mcpServerNames(servers) {
   return servers.flatMap((server) => typeof server.name === "string" ? [sanitizeMcpServerName(server.name)] : []);
 }
+function requestedMessageId(params) {
+  const alwith = params._meta?.["alwith"];
+  if (alwith?.messageId === undefined)
+    return;
+  if (typeof alwith.messageId !== "string" || alwith.messageId.length === 0) {
+    throw RequestError.invalidParams(undefined, "_meta.alwith.messageId must be a non-empty string");
+  }
+  return alwith.messageId;
+}
 function agentMessage(messageId, text2) {
   return { sessionUpdate: "agent_message_chunk", messageId, content: { type: "text", text: text2 } };
 }

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Native ACP v2 agent for the OpenAI Codex app-server",
   "packageManager": "bun@1.4.0",
   "engines": {