@proagentstore/cli 0.4.65 → 0.4.66

package/dist/browser-runner/coding/headless.js

@@ -428,7 +428,26 @@ export class HeadlessSession {
             }
         });
     }
-    /** Send a user turn. `author` names who wrote it, because `role` cannot — see turn-author.ts (#505). */
+    /**
+     * Does the engine carry its own conversation into THIS turn (#693 slice 2)?
+     *
+     * The boundary ADR 0005 draws, stated where the runner applies it: the platform's record is the
+     * source of truth and the engine's own memory is an optimisation preferred when it is there. It is
+     * there for a PERSISTENT process (Claude's stream-json session, a persistent REPL), which holds
+     * every turn since it started, and for a structured Codex turn that will resume its explicit
+     * thread (#848). A one-shot raw process has nothing: each turn is a new process.
+     */
+    get holdsConversationThisTurn() {
+        return this.adapter.persistent || this.codexResumeThreadId !== null;
+    }
+    /**
+     * Send a user turn. `author` names who wrote it, because `role` cannot — see turn-author.ts (#505).
+     *
+     * `replay` is the cloud's per-turn composition of the platform's record (#693 slice 2). It is spent
+     * only when {@link holdsConversationThisTurn} is false, so an engine with its own memory is never
+     * handed a summary of the conversation it is already in; when spent it replaces the one-shot
+     * session-start brief, being the same record composed later.
+     */
     input(text, opts = {}) {
         // The Engine reads the preamble, the pane the short marker; the instruction stays evidence.
         const sent = authoredTurn(text, opts.author);
@@ -437,11 +456,14 @@ export class HeadlessSession {
         // Pilot re-read through `/coding/capture` and twelve thousand characters of reconstructed
         // history would evict the live output they are looking at — the same budget argument
         // `turn-author.ts` makes for its two-word marker.
-        const seed = this.pendingSeed;
+        const replay = this.holdsConversationThisTurn ? null : opts.replay?.trim() || null;
+        const seed = replay ?? this.pendingSeed;
         this.pendingSeed = null;
         if (!this.alive)
             this.start();
-        if (seed)
+        if (replay)
+            this.push("[pags] this engine keeps no memory between turns, so ProAgentStore's record of the conversation so far was delivered with this turn — a reconstruction, not the engine's own memory");
+        else if (seed)
             this.push("[pags] a context brief from ProAgentStore's record was delivered with this turn — a reconstruction, not the previous conversation");
         this.push(`\n❯ [${stamp()}] ${authorTag(opts.author)}${text}`); // ❯ — your turn, timestamped
         this.run = "thinking";

package/dist/browser-runner/coding/runtime.js

@@ -216,7 +216,7 @@ export class CodingRuntime {
             case "message":
                 // Narrowed rather than trusted: this runner is a published package any caller can
                 // POST to, and an unrecognised author must read as "unstated", not become a label.
-                session.input(action.text, { author: asTurnAuthor(action.author) });
+                session.input(action.text, { author: asTurnAuthor(action.author), replay: typeof action.replay === "string" ? action.replay : undefined });
                 break;
             case "keys": {
                 // A snapshot is no longer the whole answer (#448). `key()` records the attempt and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proagentstore/cli",
-  "version": "0.4.65",
+  "version": "0.4.66",
   "description": "CLI for creating, publishing, and running ProAgentStore agents",
   "license": "MIT",
   "type": "module",