@yitom/agy-acp-map 0.1.13 → 0.1.14

package/README.md

@@ -64,6 +64,21 @@ bun run smoke:all                 # units + full live matrix
 
 **Windows:** install [Bun](https://bun.sh), put `agy` on `PATH`, then the same commands.
 
+## Run via bunx / npx (no install, codex-style)
+
+The npm tarball is thin (~5MB: `dist/bin.js` + `dist/agy-headless.exe`, no runtime
+needed beyond node/bun). First run downloads `@latest` into the runner cache,
+later runs reuse it:
+
+```powershell
+bunx @yitom/agy-acp-map@latest        # bun users (preferred: no prompt, no shim flash)
+npx -y @yitom/agy-acp-map@latest      # node users
+```
+
+Requirements are the same as source runs: a logged-in `agy` on `PATH`. The
+optional 95MB single-file `agy-acp-win-x64.exe` is **not** in the npm package —
+grab it from GitHub Releases if you want zero-runtime distribution.
+
 
 ## Launch flags / 启动参数 (v0.1.2)
 

package/dist/bin.js

@@ -12463,7 +12463,7 @@ class SessionHistoryStore {
   filePath(sessionId) {
     return path8.join(this.directory, historyFileName(sessionId));
   }
-  appendTurn(sessionId, userText, assistantText) {
+  appendTurn(sessionId, userText, assistantText, opts) {
     const records = [];
     const now = new Date().toISOString();
     if (userText) {
@@ -12483,7 +12483,8 @@ class SessionHistoryStore {
         messageId: `history_agent_${randomUUID2()}`,
         role: "assistant",
         text: assistantText,
-        createdAt: new Date().toISOString()
+        createdAt: new Date().toISOString(),
+        ...opts?.partial ? { partial: true } : {}
       });
     }
     if (!records.length)
@@ -12543,7 +12544,7 @@ class SessionHistoryStore {
 var AGENT_INFO = {
   name: "agy-acp",
   title: "agy ACP (stream-json)",
-  version: "0.1.13"
+  version: "0.1.14"
 };
 var BRIDGE_CAPABILITIES = {
   prompt: true,
@@ -12792,7 +12793,8 @@ class AgySessionCore {
   }
   persistTurnHistory(sessionId, userText, assistantText, stopReason, eligible = true) {
     try {
-      this.historyStore.appendTurn(sessionId, userText, eligible && stopReason !== "cancelled" ? assistantText : undefined);
+      const partial = stopReason === "cancelled" || !eligible;
+      this.historyStore.appendTurn(sessionId, userText, assistantText, partial ? { partial: true } : undefined);
     } catch (err) {
       console.warn(`[ACP-HISTORY] Warning: failed to persist turn ${sessionId}:`, err);
     }

package/dist/index.js

@@ -12250,7 +12250,7 @@ class SessionHistoryStore {
   filePath(sessionId) {
     return path8.join(this.directory, historyFileName(sessionId));
   }
-  appendTurn(sessionId, userText, assistantText) {
+  appendTurn(sessionId, userText, assistantText, opts) {
     const records = [];
     const now = new Date().toISOString();
     if (userText) {
@@ -12270,7 +12270,8 @@ class SessionHistoryStore {
         messageId: `history_agent_${randomUUID2()}`,
         role: "assistant",
         text: assistantText,
-        createdAt: new Date().toISOString()
+        createdAt: new Date().toISOString(),
+        ...opts?.partial ? { partial: true } : {}
       });
     }
     if (!records.length)
@@ -12330,7 +12331,7 @@ class SessionHistoryStore {
 var AGENT_INFO = {
   name: "agy-acp",
   title: "agy ACP (stream-json)",
-  version: "0.1.13"
+  version: "0.1.14"
 };
 var BRIDGE_CAPABILITIES = {
   prompt: true,
@@ -12592,7 +12593,8 @@ class AgySessionCore {
   }
   persistTurnHistory(sessionId, userText, assistantText, stopReason, eligible = true) {
     try {
-      this.historyStore.appendTurn(sessionId, userText, eligible && stopReason !== "cancelled" ? assistantText : undefined);
+      const partial = stopReason === "cancelled" || !eligible;
+      this.historyStore.appendTurn(sessionId, userText, assistantText, partial ? { partial: true } : undefined);
     } catch (err) {
       console.warn(`[ACP-HISTORY] Warning: failed to persist turn ${sessionId}:`, err);
     }

package/dist/lib/session-history.d.ts

@@ -5,6 +5,11 @@
  * only stores the text that an ACP client can display: user prompts and final
  * assistant text. Tool calls, tool output, thoughts, and internal events are
  * deliberately excluded.
+ *
+ * Display/persist parity: whatever text the client actually saw must be
+ * reloadable. Interrupted turns (cancelled / failed) still persist their
+ * partial text, marked with `partial: true`, so `session/load` replay shows
+ * exactly what was on screen instead of dropping the turn entirely.
  */
 export type SessionHistoryRole = 'user' | 'assistant';
 export type SessionHistoryRecord = {
@@ -14,6 +19,12 @@ export type SessionHistoryRecord = {
     role: SessionHistoryRole;
     text: string;
     createdAt: string;
+    /**
+     * True when the turn did not complete (cancelled / failed) and `text` is
+     * only the partial output the client saw. Replay ignores the flag and
+     * returns the text; readers must tolerate its absence (old journals).
+     */
+    partial?: boolean;
 };
 export declare function resolveHistoryDir(sessionStorePath?: string, env?: NodeJS.ProcessEnv, homedir?: () => string): string;
 export declare class SessionHistoryStore {
@@ -21,12 +32,16 @@ export declare class SessionHistoryStore {
     constructor(directory?: string);
     filePath(sessionId: string): string;
     /**
-     * Append one completed turn as two JSONL records.
+     * Append one completed (or interrupted) turn as JSONL records.
      *
-     * The assistant record is omitted when the turn produced no visible final
-     * text. This keeps cancelled/error-only turns from becoming fake answers.
+     * The assistant record is written whenever the turn produced visible text —
+     * including cancelled/failed turns (`partial: true`). Only a truly empty
+     * assistant answer is omitted, so cancelled/error-only turns never become
+     * fake answers, while partial output stays reloadable.
      */
-    appendTurn(sessionId: string, userText: string, assistantText?: string): void;
+    appendTurn(sessionId: string, userText: string, assistantText?: string, opts?: {
+        partial?: boolean;
+    }): void;
     /** Read valid records and ignore incomplete/corrupt trailing lines. */
     read(sessionId: string): SessionHistoryRecord[];
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yitom/agy-acp-map",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "publishConfig": {
     "access": "public"
   },