@sumicom/quicksave 0.8.11 → 0.8.12

package/dist/ai/artifactStore.d.ts

@@ -0,0 +1,12 @@
+import type { Artifact, ArtifactMetadata, MarkdownArtifactRef } from '@sumicom/quicksave-shared';
+export interface PublishMarkdownArtifactArgs {
+    sessionId: string;
+    cwd: string;
+    sourcePath: string;
+    title?: string;
+}
+export declare function publishMarkdownArtifact(args: PublishMarkdownArtifactArgs): Promise<MarkdownArtifactRef>;
+export declare function loadArtifactBySession(sessionId: string, artifactId: string): Promise<Artifact | null>;
+export declare function listSessionArtifacts(cwd: string, sessionId: string): Promise<ArtifactMetadata[]>;
+export declare function removeSessionArtifacts(cwd: string, sessionId: string): Promise<void>;
+//# sourceMappingURL=artifactStore.d.ts.map

package/dist/ai/artifactStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactStore.d.ts","sourceRoot":"","sources":["../../src/ai/artifactStore.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAuCjG,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuC7G;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA4B3G;AAED,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiBtG;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1F"}

package/dist/ai/artifactStore.js

@@ -0,0 +1,143 @@
+// SPDX-FileCopyrightText: 2026 King Young Technology
+// SPDX-License-Identifier: MIT
+// ============================================================================
+// Persistent artifact store on the agent.
+//
+// Generated reports live under:
+//
+//   <state>/artifacts/<encoded-project-path>/<sessionId>/<artifactId>/
+//     artifact.md
+//     meta.json
+//
+// Tool results and cards carry only ArtifactMetadata. The PWA fetches content
+// on demand through `artifact:fetch`, keeping large reports out of model
+// context and out of card snapshots.
+// ============================================================================
+import { copyFile, mkdir, readFile, readdir, realpath, rm, stat, writeFile } from 'fs/promises';
+import { basename, extname, isAbsolute, join, resolve, sep } from 'path';
+import { randomUUID } from 'crypto';
+import { getArtifactsDir } from '../service/singleton.js';
+const ARTIFACT_FILENAME = 'artifact.md';
+const META_FILENAME = 'meta.json';
+const MARKDOWN_ARTIFACT_MAX_BYTES = 10 * 1024 * 1024;
+const MARKDOWN_ARTIFACT_EXTENSIONS = ['.md', '.markdown'];
+function encodeProjectPath(cwd) {
+    return cwd.replace(/[\\/]/g, '-').replace(/:/g, '');
+}
+function dirFor(cwd, sessionId) {
+    return join(getArtifactsDir(), encodeProjectPath(cwd), sessionId);
+}
+function artifactDirFor(cwd, sessionId, artifactId) {
+    return join(dirFor(cwd, sessionId), artifactId);
+}
+function storedMarkdownPath(cwd, sessionId, artifactId) {
+    return join(artifactDirFor(cwd, sessionId, artifactId), ARTIFACT_FILENAME);
+}
+function metaPathFor(cwd, sessionId, artifactId) {
+    return join(artifactDirFor(cwd, sessionId, artifactId), META_FILENAME);
+}
+function isPathInside(child, parent) {
+    return child === parent || child.startsWith(parent.endsWith(sep) ? parent : parent + sep);
+}
+function assertMarkdownPath(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    if (!MARKDOWN_ARTIFACT_EXTENSIONS.includes(ext)) {
+        throw new Error('Only .md and .markdown artifacts are supported');
+    }
+}
+export async function publishMarkdownArtifact(args) {
+    const cwdReal = await realpath(args.cwd);
+    const requestedSource = isAbsolute(args.sourcePath)
+        ? args.sourcePath
+        : resolve(cwdReal, args.sourcePath);
+    assertMarkdownPath(requestedSource);
+    const sourceReal = await realpath(requestedSource);
+    if (!isPathInside(sourceReal, cwdReal)) {
+        throw new Error('Artifact source must be inside the project directory');
+    }
+    const st = await stat(sourceReal);
+    if (!st.isFile()) {
+        throw new Error('Artifact source must be a regular file');
+    }
+    if (st.size > MARKDOWN_ARTIFACT_MAX_BYTES) {
+        throw new Error(`Markdown artifact exceeds ${MARKDOWN_ARTIFACT_MAX_BYTES} byte limit`);
+    }
+    const artifactId = randomUUID();
+    const artifactDir = artifactDirFor(cwdReal, args.sessionId, artifactId);
+    await mkdir(artifactDir, { recursive: true });
+    await copyFile(sourceReal, storedMarkdownPath(cwdReal, args.sessionId, artifactId));
+    const meta = {
+        refKind: 'artifact',
+        artifactId,
+        sessionId: args.sessionId,
+        cwd: cwdReal,
+        kind: 'markdown',
+        title: args.title?.trim() || basename(sourceReal),
+        mimeType: 'text/markdown',
+        size: st.size,
+        createdAt: Date.now(),
+        sourcePath: sourceReal,
+    };
+    await writeFile(metaPathFor(cwdReal, args.sessionId, artifactId), JSON.stringify(meta, null, 2));
+    return meta;
+}
+export async function loadArtifactBySession(sessionId, artifactId) {
+    const base = getArtifactsDir();
+    let projectDirs;
+    try {
+        projectDirs = await readdir(base);
+    }
+    catch {
+        return null;
+    }
+    for (const projectDir of projectDirs) {
+        const artifactDir = join(base, projectDir, sessionId, artifactId);
+        try {
+            const [metaRaw, bytes] = await Promise.all([
+                readFile(join(artifactDir, META_FILENAME), 'utf8'),
+                readFile(join(artifactDir, ARTIFACT_FILENAME)),
+            ]);
+            const meta = JSON.parse(metaRaw);
+            if (meta.sessionId !== sessionId || meta.artifactId !== artifactId)
+                continue;
+            return {
+                ...meta,
+                contentBase64: bytes.toString('base64'),
+            };
+        }
+        catch {
+            // Keep scanning: sessions can share ids across different project dirs in
+            // malformed or hand-edited state, and missing files are local-only.
+        }
+    }
+    return null;
+}
+export async function listSessionArtifacts(cwd, sessionId) {
+    let artifactIds;
+    try {
+        artifactIds = await readdir(dirFor(cwd, sessionId));
+    }
+    catch {
+        return [];
+    }
+    const metas = [];
+    for (const artifactId of artifactIds) {
+        try {
+            const raw = await readFile(metaPathFor(cwd, sessionId, artifactId), 'utf8');
+            metas.push(JSON.parse(raw));
+        }
+        catch {
+            // skip unreadable metas
+        }
+    }
+    return metas.sort((a, b) => a.createdAt - b.createdAt);
+}
+export async function removeSessionArtifacts(cwd, sessionId) {
+    try {
+        await rm(dirFor(cwd, sessionId), { recursive: true, force: true });
+    }
+    catch {
+        // best effort
+    }
+}
+//# sourceMappingURL=artifactStore.js.map

package/dist/ai/artifactStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactStore.js","sourceRoot":"","sources":["../../src/ai/artifactStore.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,+BAA+B;AAC/B,+EAA+E;AAC/E,0CAA0C;AAC1C,EAAE;AACF,gCAAgC;AAChC,EAAE;AACF,uEAAuE;AACvE,kBAAkB;AAClB,gBAAgB;AAChB,EAAE;AACF,8EAA8E;AAC9E,yEAAyE;AACzE,qCAAqC;AACrC,+EAA+E;AAE/E,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,iBAAiB,GAAG,aAAa,CAAC;AACxC,MAAM,aAAa,GAAG,WAAW,CAAC;AAClC,MAAM,2BAA2B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACrD,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,WAAW,CAAU,CAAC;AAEnE,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,MAAM,CAAC,GAAW,EAAE,SAAiB;IAC5C,OAAO,IAAI,CAAC,eAAe,EAAE,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,cAAc,CAAC,GAAW,EAAE,SAAiB,EAAE,UAAkB;IACxE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW,EAAE,SAAiB,EAAE,UAAkB;IAC5E,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,SAAiB,EAAE,UAAkB;IACrE,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,aAAa,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,MAAc;IACjD,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,GAA0B,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAiC;IAC7E,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;QACjD,CAAC,CAAC,IAAI,CAAC,UAAU;QACjB,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACtC,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAEpC,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,CAAC;IACnD,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,EAAE,CAAC,IAAI,GAAG,2BAA2B,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,6BAA6B,2BAA2B,aAAa,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;IAChC,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACxE,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IAEpF,MAAM,IAAI,GAAwB;QAChC,OAAO,EAAE,UAAU;QACnB,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,EAAE,OAAO;QACZ,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,UAAU,CAAC;QACjD,QAAQ,EAAE,eAAe;QACzB,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,UAAU,EAAE,UAAU;KACvB,CAAC;IACF,MAAM,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjG,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAiB,EAAE,UAAkB;IAC/E,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,WAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAClE,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACzC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC;gBAClD,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;aAC/C,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;YACrD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU;gBAAE,SAAS;YAC7E,OAAO;gBACL,GAAG,IAAI;gBACP,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACxC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;YACzE,oEAAoE;QACtE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW,EAAE,SAAiB;IACvE,IAAI,WAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAW,EAAE,SAAiB;IACzE,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;AACH,CAAC"}

package/dist/ai/cardBuilder.d.ts

@@ -1,4 +1,4 @@
-import type { Attachment, Card, CardId, CardEvent, CardHistoryResponse, PendingInputAttachment, GeneratedImageCard, SystemCard } from '@sumicom/quicksave-shared';
+import type { Attachment, Card, CardId, CardEvent, CardHistoryResponse, PendingInputAttachment, GeneratedImageCard, SystemCard, MarkdownArtifactRef } from '@sumicom/quicksave-shared';
 /**
  * Load persisted card history for a memory-mode session.
  * Returns cards in insertion order, or empty array if none exist.
@@ -33,6 +33,8 @@ export declare class StreamCardBuilder {
     private cards;
     /** tool_use_id → CardId, for pairing tool_result to ToolCallCard */
     private toolUseIdToCardId;
+    /** artifactId → CardId, for de-duping generated display artifact cards. */
+    private artifactIdToCardId;
     /** agentId (task_id) → CardId, for matching subagent updates */
     private agentIdToCardId;
     /** Cards created for subagent permissions — removed after resolution. */
@@ -52,8 +54,11 @@ export declare class StreamCardBuilder {
     /** Token identifying an in-flight deferred clear. A later call (new turn, cancel)
      * replaces this token, causing the pending polling task to bail out. */
     private _pendingClearToken;
+    private persistMemoryCards;
+    private cardHistoryWriteQueue;
     constructor(sessionId: string, cwd: string);
     updateSessionId(sessionId: string): void;
+    enableMemoryPersistence(enabled?: boolean): void;
     /** Continue the local card id counter after persisted memory-mode history.
      * Used on cold resume after daemon restart so new Codex/OpenCode cards
      * append after existing cards instead of reusing `sessionId:1`, `:2`, ...
@@ -73,6 +78,7 @@ export declare class StreamCardBuilder {
      * injects a user prompt into an already-running turn; the card must survive
      * refresh before the turn's normal end-of-turn persist runs. */
     persistCard(card: Card): Promise<void>;
+    flushCardHistoryWrites(): Promise<void>;
     private persistCardBatch;
     /** Snapshot current JSONL byte size so history reads stop before the active turn. */
     snapshotCutoff(): Promise<void>;
@@ -102,6 +108,7 @@ export declare class StreamCardBuilder {
     cancelDeferredClear(): void;
     get jsonlCutoff(): number | null;
     set jsonlCutoff(value: number | null);
+    private enqueueCardHistoryEntry;
     private nextId;
     private addEvent;
     private updateEvent;
@@ -172,6 +179,7 @@ export declare class StreamCardBuilder {
         stopReason?: unknown;
     }): CardEvent;
     generatedImage(prompt: string, status: GeneratedImageCard['status'], savedPath?: string): CardEvent;
+    artifact(ref: MarkdownArtifactRef, afterToolUseId?: string): CardEvent;
     recoverySuggested(reason: string, action: 'compact', label: string): CardEvent;
     errorMessage(text: string): CardEvent;
 }

package/dist/ai/cardBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cardBuilder.d.ts","sourceRoot":"","sources":["../../src/ai/cardBuilder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cardBuilder.d.ts","sourceRoot":"","sources":["../../src/ai/cardBuilder.ts"],"names":[],"mappings":"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"}

package/dist/ai/cardBuilder.js

@@ -1,4 +1,4 @@
-import { readFile, readdir, writeFile, mkdir, stat, open } from 'fs/promises';
+import { appendFile, readFile, readdir, writeFile, mkdir, stat, open, rename } from 'fs/promises';
 import { join } from 'path';
 import { createReadStream, existsSync } from 'fs';
 import { createInterface } from 'readline';
@@ -46,6 +46,9 @@ const TOOL_RESULT_TRUNCATE_LENGTH = 500;
 function cardHistoryPath(sessionId) {
     return join(getCardHistoryDir(), `${sessionId}.json`);
 }
+function cardHistoryLogPath(sessionId) {
+    return join(getCardHistoryDir(), `${sessionId}.jsonl`);
+}
 function cleanPersistedCard(card) {
     const { pendingInput, ...rest } = card;
     void pendingInput;
@@ -92,18 +95,100 @@ function maxCardSequenceForSession(cards, sessionId) {
  * Returns cards in insertion order, or empty array if none exist.
  */
 export async function loadPersistedCards(sessionId) {
-    const p = cardHistoryPath(sessionId);
+    const migratedCards = await migrateLegacyCardHistory(sessionId);
+    const p = cardHistoryLogPath(sessionId);
     if (!existsSync(p))
-        return [];
+        return migratedCards ?? [];
     try {
         const raw = await readFile(p, 'utf-8');
+        const replayed = replayCardHistoryLog(raw);
+        return migratedCards ? mergeCardsById(migratedCards, replayed) : replayed;
+    }
+    catch {
+        return migratedCards ?? [];
+    }
+}
+async function migrateLegacyCardHistory(sessionId) {
+    const legacyPath = cardHistoryPath(sessionId);
+    if (!existsSync(legacyPath))
+        return null;
+    try {
+        const raw = await readFile(legacyPath, 'utf-8');
         const data = JSON.parse(raw);
-        return Array.isArray(data) ? sortCardsChronologically(data) : [];
+        if (!Array.isArray(data) || data.length === 0)
+            return null;
+        const cards = sortCardsChronologically(data).map(cleanPersistedCard);
+        try {
+            await mkdir(getCardHistoryDir(), { recursive: true });
+            await appendFile(cardHistoryLogPath(sessionId), JSON.stringify({ op: 'seed', cards }) + '\n');
+            await rename(legacyPath, `${legacyPath}.migrated-${Date.now()}`);
+        }
+        catch {
+            // Keep the legacy file as fallback; the next read can retry migration.
+        }
+        return cards;
     }
     catch {
-        return [];
+        return null;
     }
 }
+function replayCardHistoryLog(raw) {
+    const cardsById = new Map();
+    for (const line of raw.split('\n')) {
+        if (!line.trim())
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        switch (entry.op) {
+            case 'seed':
+                for (const card of entry.cards ?? []) {
+                    if (!card?.id || cardsById.has(card.id))
+                        continue;
+                    cardsById.set(card.id, cleanPersistedCard(card));
+                }
+                break;
+            case 'upsert':
+                if (entry.card?.id)
+                    cardsById.set(entry.card.id, cleanPersistedCard(entry.card));
+                break;
+            case 'patch': {
+                const existing = cardsById.get(entry.cardId);
+                if (!existing)
+                    break;
+                const bag = existing;
+                for (const [key, value] of Object.entries(entry.patch ?? {})) {
+                    if (value === null)
+                        delete bag[key];
+                    else
+                        bag[key] = value;
+                }
+                cardsById.set(entry.cardId, cleanPersistedCard(existing));
+                break;
+            }
+            case 'append_text': {
+                const existing = cardsById.get(entry.cardId);
+                if (existing && 'text' in existing) {
+                    existing.text += entry.text;
+                    cardsById.set(entry.cardId, cleanPersistedCard(existing));
+                }
+                break;
+            }
+            case 'remove':
+                cardsById.delete(entry.cardId);
+                break;
+        }
+    }
+    return sortCardsChronologically(Array.from(cardsById.values()));
+}
+async function appendCardHistoryEntry(sessionId, entry) {
+    await mkdir(getCardHistoryDir(), { recursive: true });
+    await appendFile(cardHistoryLogPath(sessionId), JSON.stringify(entry) + '\n');
+}
 // ── Direct JSONL file reading (replaces SDK getSessionMessages/listSubagents) ──
 export function encodeCwdPath(cwd) {
     return cwd.replace(/\//g, '-');
@@ -323,6 +408,8 @@ export class StreamCardBuilder {
     cards = new Map();
     /** tool_use_id → CardId, for pairing tool_result to ToolCallCard */
     toolUseIdToCardId = new Map();
+    /** artifactId → CardId, for de-duping generated display artifact cards. */
+    artifactIdToCardId = new Map();
     /** agentId (task_id) → CardId, for matching subagent updates */
     agentIdToCardId = new Map();
     /** Cards created for subagent permissions — removed after resolution. */
@@ -342,6 +429,8 @@ export class StreamCardBuilder {
     /** Token identifying an in-flight deferred clear. A later call (new turn, cancel)
      * replaces this token, causing the pending polling task to bail out. */
     _pendingClearToken = null;
+    persistMemoryCards = false;
+    cardHistoryWriteQueue = Promise.resolve();
     constructor(sessionId, cwd) {
         this.sessionId = sessionId;
         this.cwd = cwd;
@@ -349,6 +438,9 @@ export class StreamCardBuilder {
     updateSessionId(sessionId) {
         this.sessionId = sessionId;
     }
+    enableMemoryPersistence(enabled = true) {
+        this.persistMemoryCards = enabled;
+    }
     /** Continue the local card id counter after persisted memory-mode history.
      * Used on cold resume after daemon restart so new Codex/OpenCode cards
      * append after existing cards instead of reusing `sessionId:1`, `:2`, ...
@@ -364,6 +456,7 @@ export class StreamCardBuilder {
     clearCards() {
         this.cards.clear();
         this.toolUseIdToCardId.clear();
+        this.artifactIdToCardId.clear();
         this.agentIdToCardId.clear();
         this.ephemeralCards.clear();
         this.agentToolUseStash.clear();
@@ -380,14 +473,34 @@ export class StreamCardBuilder {
         const cards = this.getCards();
         if (cards.length === 0)
             return;
+        if (this.persistMemoryCards) {
+            for (const card of cards) {
+                this.enqueueCardHistoryEntry({ op: 'upsert', card: cleanPersistedCard(card) });
+            }
+            await this.flushCardHistoryWrites();
+            return;
+        }
         await this.persistCardBatch(cards);
     }
     /** Persist a single card immediately. Used when a memory-mode provider
      * injects a user prompt into an already-running turn; the card must survive
      * refresh before the turn's normal end-of-turn persist runs. */
     async persistCard(card) {
+        if (this.persistMemoryCards) {
+            this.enqueueCardHistoryEntry({ op: 'upsert', card: cleanPersistedCard(card) });
+            await this.flushCardHistoryWrites();
+            return;
+        }
         await this.persistCardBatch([card]);
     }
+    async flushCardHistoryWrites() {
+        try {
+            await this.cardHistoryWriteQueue;
+        }
+        catch {
+            // Individual write failures are intentionally swallowed in the queue.
+        }
+    }
     async persistCardBatch(cards) {
         if (cards.length === 0)
             return;
@@ -476,6 +589,7 @@ export class StreamCardBuilder {
         this._jsonlCutoff = lastSize >= 0 ? lastSize : null;
         this.cards.clear();
         this.toolUseIdToCardId.clear();
+        this.artifactIdToCardId.clear();
         this.agentIdToCardId.clear();
         this.ephemeralCards.clear();
         this.agentToolUseStash.clear();
@@ -494,11 +608,23 @@ export class StreamCardBuilder {
     set jsonlCutoff(value) {
         this._jsonlCutoff = value;
     }
+    enqueueCardHistoryEntry(entry) {
+        if (!this.persistMemoryCards || this.sessionId === 'pending')
+            return;
+        const sessionId = this.sessionId;
+        this.cardHistoryWriteQueue = this.cardHistoryWriteQueue
+            .catch(() => undefined)
+            .then(() => appendCardHistoryEntry(sessionId, entry))
+            .catch((err) => {
+            console.warn(`[card-history] append failed for session=${sessionId}: ${err instanceof Error ? err.message : String(err)}`);
+        });
+    }
     nextId() {
         return `${this.sessionId}:${++this.seq}`;
     }
     addEvent(card, afterCardId) {
         this.cards.set(card.id, card);
+        this.enqueueCardHistoryEntry({ op: 'upsert', card: cleanPersistedCard(card) });
         return { type: 'add', sessionId: this.sessionId, card, afterCardId };
     }
     updateEvent(cardId, patch) {
@@ -515,6 +641,7 @@ export class StreamCardBuilder {
                 else
                     bag[key] = value;
             }
+            this.enqueueCardHistoryEntry({ op: 'patch', cardId, patch });
         }
         return { type: 'update', sessionId: this.sessionId, cardId, patch };
     }
@@ -522,11 +649,13 @@ export class StreamCardBuilder {
         const existing = this.cards.get(cardId);
         if (existing && 'text' in existing) {
             existing.text += text;
+            this.enqueueCardHistoryEntry({ op: 'append_text', cardId, text });
         }
         return { type: 'append_text', sessionId: this.sessionId, cardId, text };
     }
     removeEvent(cardId) {
         this.cards.delete(cardId);
+        this.enqueueCardHistoryEntry({ op: 'remove', cardId });
         return { type: 'remove', sessionId: this.sessionId, cardId };
     }
     // ── Public: produce CardEvents from SDK data ────────────────────────────
@@ -780,6 +909,23 @@ export class StreamCardBuilder {
         };
         return this.addEvent(card);
     }
+    artifact(ref, afterToolUseId) {
+        this.currentTextCardId = null;
+        const existingCardId = this.artifactIdToCardId.get(ref.artifactId);
+        if (existingCardId) {
+            return this.updateEvent(existingCardId, { artifact: ref });
+        }
+        const id = `${this.sessionId}:artifact:${ref.artifactId}`;
+        this.artifactIdToCardId.set(ref.artifactId, id);
+        const card = {
+            type: 'artifact',
+            id,
+            timestamp: Date.now(),
+            artifact: ref,
+        };
+        const afterCardId = afterToolUseId ? this.toolUseIdToCardId.get(afterToolUseId) : undefined;
+        return this.addEvent(card, afterCardId);
+    }
     recoverySuggested(reason, action, label) {
         const card = {
             type: 'recovery_suggested',