@gigaflow/gmux 0.15.0

package/dist/services/semantic.js.map

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

package/dist/services/sensors.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Sensors: the two ways gmux learns what a pane is doing, unified behind one
+ * shape.
+ *
+ * `TerminalSensor` watches a plain shell (or any harness we can't identify a
+ * transcript for) via tmux `capture-pane`, and keeps a `pipe-pane` log running
+ * so a later "show me the raw tail" view has more than 200 lines to work with.
+ * `AgentSensor` watches a known harness's transcript file directly — richer
+ * and cheaper than scraping a terminal, but only available once the pane is
+ * linked to a session.
+ *
+ * Both report the same `Observation` shape (`gmux-types.ts`) so the daemon's
+ * state-derivation layer never needs to know which kind of pane it is looking
+ * at.
+ */
+import type { Observation, PaneIdentity } from "../core/gmux-types.js";
+import type { TmuxGateway } from "./tmux-gateway.js";
+export interface Sensor {
+    readonly kind: "agent" | "terminal";
+    observe(now: number): Promise<Observation>;
+    teardown(): Promise<void>;
+}
+/**
+ * Watches a pane via tmux capture, for shells and unidentified harnesses.
+ *
+ * `pipe-pane` is started lazily on first observe (not the constructor) so
+ * constructing a sensor is never itself a side effect — only observing one
+ * is.
+ */
+export declare class TerminalSensor implements Sensor {
+    private readonly identity;
+    private readonly gateway;
+    readonly kind: "terminal";
+    private lastHash;
+    private lastActivityTs;
+    private piping;
+    constructor(identity: PaneIdentity, gateway: TmuxGateway);
+    observe(now: number): Promise<Observation>;
+    teardown(): Promise<void>;
+}
+/** `timestamp` is the one field both `claude-code.ts` and `codex.ts` key on. */
+export declare function tsOf(row: Record<string, unknown> | undefined): number | null;
+/** Last known speaker was the assistant, with no human turn after it yet. */
+export declare function isAssistantWaiting(rows: Record<string, unknown>[]): boolean | undefined;
+/**
+ * A tool/command failure in the tail: Claude Code's `tool_result` blocks with
+ * `is_error: true` (see `hasToolError` in `adapters/claude-code.ts`), or a
+ * Codex `function_call_output` reporting a nonzero exit (see `exitFailure` in
+ * `adapters/codex.ts`).
+ */
+export declare function hasToolError(rows: Record<string, unknown>[]): boolean;
+/**
+ * A completion marker in the tail. Only Codex's `task_complete` event is a
+ * per-row signal we can trust here — Claude Code's transcripts carry no
+ * equivalent single-line marker (its own adapter infers `endedMidTask` from
+ * proximity to the end of the *whole* file, which a 40-row tail can't
+ * reproduce), so `ended` stays `false` for Claude Code panes at the sensor
+ * layer.
+ */
+export declare function isEnded(rows: Record<string, unknown>[]): boolean;
+/**
+ * Watches a known harness's transcript file.
+ *
+ * Takes only `identity` — never a `filePath` — so `makeSensor` stays
+ * synchronous: the file is resolved lazily, on first `observe()`, via the
+ * cached session index, and cached on the instance from then on. If no
+ * matching record (or file) is found, `observe` degrades gracefully to an
+ * empty observation rather than throwing.
+ */
+export declare class AgentSensor implements Sensor {
+    private readonly identity;
+    /** Test-only escape hatch: skip index lookup and read this file directly. */
+    private readonly filePathOverride?;
+    /** Test-only escape hatch: replace the cachedRecords()-based lookup. */
+    private readonly lookupOverride?;
+    readonly kind: "agent";
+    private resolvedPath;
+    constructor(identity: PaneIdentity, 
+    /** Test-only escape hatch: skip index lookup and read this file directly. */
+    filePathOverride?: string | undefined, 
+    /** Test-only escape hatch: replace the cachedRecords()-based lookup. */
+    lookupOverride?: (() => Promise<string | null>) | undefined);
+    private lookupFromIndex;
+    private resolvePath;
+    observe(now: number): Promise<Observation>;
+    teardown(): Promise<void>;
+}
+/**
+ * Picks the richer sensor whenever the pane is resolvable to a known
+ * harness session, else falls back to the terminal sensor.
+ */
+export declare function makeSensor(identity: PaneIdentity, gateway: TmuxGateway): Sensor;

package/dist/services/sensors.js

@@ -0,0 +1,246 @@
+/**
+ * Sensors: the two ways gmux learns what a pane is doing, unified behind one
+ * shape.
+ *
+ * `TerminalSensor` watches a plain shell (or any harness we can't identify a
+ * transcript for) via tmux `capture-pane`, and keeps a `pipe-pane` log running
+ * so a later "show me the raw tail" view has more than 200 lines to work with.
+ * `AgentSensor` watches a known harness's transcript file directly — richer
+ * and cheaper than scraping a terminal, but only available once the pane is
+ * linked to a session.
+ *
+ * Both report the same `Observation` shape (`gmux-types.ts`) so the daemon's
+ * state-derivation layer never needs to know which kind of pane it is looking
+ * at.
+ */
+import { createHash } from "node:crypto";
+import { paneLogPath } from "../core/paths.js";
+import { readJsonl, RingBuffer } from "../adapters/jsonl.js";
+import { cachedRecords } from "./index-store.js";
+import { rotateIfLarge, pruneLog, MAX_PANE_LOG_BYTES } from "./log-rotation.js";
+/** How many transcript rows AgentSensor keeps in view per observe(). */
+const AGENT_TAIL_CAPACITY = 40;
+const hash = (s) => createHash("sha1").update(s).digest("hex");
+/**
+ * Watches a pane via tmux capture, for shells and unidentified harnesses.
+ *
+ * `pipe-pane` is started lazily on first observe (not the constructor) so
+ * constructing a sensor is never itself a side effect — only observing one
+ * is.
+ */
+export class TerminalSensor {
+    identity;
+    gateway;
+    kind = "terminal";
+    lastHash = "";
+    lastActivityTs = 0;
+    piping = false;
+    constructor(identity, gateway) {
+        this.identity = identity;
+        this.gateway = gateway;
+    }
+    async observe(now) {
+        if (!this.piping) {
+            await this.gateway.startPipe(this.identity.paneId, paneLogPath(this.identity.paneId)).catch(() => { });
+            this.piping = true;
+        }
+        const text = await this.gateway.capture(this.identity.paneId, 200);
+        const h = hash(text);
+        if (h !== this.lastHash) {
+            this.lastActivityTs = now;
+            this.lastHash = h;
+        }
+        await rotateIfLarge(paneLogPath(this.identity.paneId), MAX_PANE_LOG_BYTES).catch(() => { });
+        const tailLines = text.split("\n").filter((l) => l.length > 0);
+        return {
+            paneId: this.identity.paneId,
+            kind: "terminal",
+            ts: now,
+            tailLines,
+            lastActivityTs: this.lastActivityTs,
+        };
+    }
+    async teardown() {
+        if (this.piping)
+            await this.gateway.stopPipe(this.identity.paneId).catch(() => { });
+        await pruneLog(paneLogPath(this.identity.paneId)).catch(() => { });
+    }
+}
+// --- Agent-signal derivation -----------------------------------------------
+//
+// These read the two shapes gmux already knows how to parse in full
+// (`adapters/claude-code.ts`, `adapters/codex.ts`), but here we only ever see
+// the last ~40 rows of a possibly-still-growing file, so each helper looks
+// for one narrow, well-grounded marker rather than replaying the adapter's
+// whole-file logic. Any row shape we don't recognize is simply not a match —
+// never a throw.
+function record(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function blocks(value) {
+    return Array.isArray(value) ? value.filter((b) => record(b) !== null) : [];
+}
+/** `timestamp` is the one field both `claude-code.ts` and `codex.ts` key on. */
+export function tsOf(row) {
+    if (!row)
+        return null;
+    const ts = row["timestamp"];
+    if (typeof ts !== "string")
+        return null;
+    const ms = Date.parse(ts);
+    return Number.isFinite(ms) ? ms : null;
+}
+/**
+ * Which side spoke, for the two shapes we recognize: Claude Code's
+ * `type: "user" | "assistant"` rows, and Codex's `event_msg` rows tagged
+ * `user_message` / `agent_message` in `payload.type`.
+ */
+function roleOf(row) {
+    const type = row["type"];
+    if (type === "user")
+        return "user";
+    if (type === "assistant")
+        return "assistant";
+    if (type === "event_msg") {
+        const payload = record(row["payload"]);
+        const kind = payload?.["type"];
+        if (kind === "user_message")
+            return "user";
+        if (kind === "agent_message")
+            return "assistant";
+    }
+    return null;
+}
+/** Last known speaker was the assistant, with no human turn after it yet. */
+export function isAssistantWaiting(rows) {
+    for (let i = rows.length - 1; i >= 0; i--) {
+        const role = roleOf(rows[i]);
+        if (role === "assistant")
+            return true;
+        if (role === "user")
+            return false;
+    }
+    return undefined;
+}
+/**
+ * A tool/command failure in the tail: Claude Code's `tool_result` blocks with
+ * `is_error: true` (see `hasToolError` in `adapters/claude-code.ts`), or a
+ * Codex `function_call_output` reporting a nonzero exit (see `exitFailure` in
+ * `adapters/codex.ts`).
+ */
+export function hasToolError(rows) {
+    return rows.some((row) => {
+        if (row["type"] === "user") {
+            const message = record(row["message"]);
+            const content = message?.["content"];
+            return blocks(content).some((b) => b["type"] === "tool_result" && b["is_error"] === true);
+        }
+        if (row["type"] === "response_item") {
+            const payload = record(row["payload"]);
+            if (payload?.["type"] === "function_call_output" && typeof payload["output"] === "string") {
+                const match = /Process exited with code (\d+)/.exec(payload["output"]);
+                return match !== null && match[1] !== "0";
+            }
+        }
+        return false;
+    });
+}
+/**
+ * A completion marker in the tail. Only Codex's `task_complete` event is a
+ * per-row signal we can trust here — Claude Code's transcripts carry no
+ * equivalent single-line marker (its own adapter infers `endedMidTask` from
+ * proximity to the end of the *whole* file, which a 40-row tail can't
+ * reproduce), so `ended` stays `false` for Claude Code panes at the sensor
+ * layer.
+ */
+export function isEnded(rows) {
+    return rows.some((row) => {
+        if (row["type"] !== "event_msg")
+            return false;
+        const payload = record(row["payload"]);
+        return payload?.["type"] === "task_complete";
+    });
+}
+/**
+ * Watches a known harness's transcript file.
+ *
+ * Takes only `identity` — never a `filePath` — so `makeSensor` stays
+ * synchronous: the file is resolved lazily, on first `observe()`, via the
+ * cached session index, and cached on the instance from then on. If no
+ * matching record (or file) is found, `observe` degrades gracefully to an
+ * empty observation rather than throwing.
+ */
+export class AgentSensor {
+    identity;
+    filePathOverride;
+    lookupOverride;
+    kind = "agent";
+    resolvedPath;
+    constructor(identity, 
+    /** Test-only escape hatch: skip index lookup and read this file directly. */
+    filePathOverride, 
+    /** Test-only escape hatch: replace the cachedRecords()-based lookup. */
+    lookupOverride) {
+        this.identity = identity;
+        this.filePathOverride = filePathOverride;
+        this.lookupOverride = lookupOverride;
+    }
+    async lookupFromIndex() {
+        const records = await cachedRecords().catch(() => []);
+        const match = records.find((r) => r.harness === this.identity.harness && r.sessionId === this.identity.sessionId);
+        return match?.filePath ?? null;
+    }
+    async resolvePath() {
+        if (this.filePathOverride)
+            return this.filePathOverride;
+        if (this.resolvedPath !== undefined)
+            return this.resolvedPath;
+        const filePath = this.lookupOverride ? await this.lookupOverride() : await this.lookupFromIndex();
+        // Only memoize a HIT. The daemon keeps one AgentSensor alive for a pane's
+        // whole lifetime, so caching a miss would degrade to empty observations
+        // forever, even after the index later picks up the transcript. A miss is
+        // cheap to retry: cachedRecords() is an in-memory cache read, not a rescan.
+        if (filePath)
+            this.resolvedPath = filePath;
+        return filePath;
+    }
+    async observe(now) {
+        const filePath = await this.resolvePath();
+        if (!filePath) {
+            return { paneId: this.identity.paneId, kind: "agent", ts: now, tailLines: [], lastActivityTs: now };
+        }
+        const tail = new RingBuffer(AGENT_TAIL_CAPACITY);
+        try {
+            for await (const row of readJsonl(filePath))
+                tail.push(row);
+        }
+        catch {
+            // File vanished or became unreadable mid-tick; degrade rather than throw.
+            return { paneId: this.identity.paneId, kind: "agent", ts: now, tailLines: [], lastActivityTs: now };
+        }
+        const rows = tail.toArray();
+        const tailLines = rows.map((r) => JSON.stringify(r));
+        const lastActivityTs = tsOf(rows[rows.length - 1]) ?? now;
+        return {
+            paneId: this.identity.paneId,
+            kind: "agent",
+            ts: now,
+            tailLines,
+            lastActivityTs,
+            awaitingInput: isAssistantWaiting(rows),
+            sawError: hasToolError(rows),
+            ended: isEnded(rows),
+        };
+    }
+    async teardown() { }
+}
+/**
+ * Picks the richer sensor whenever the pane is resolvable to a known
+ * harness session, else falls back to the terminal sensor.
+ */
+export function makeSensor(identity, gateway) {
+    if (identity.harness && identity.sessionId)
+        return new AgentSensor(identity);
+    return new TerminalSensor(identity, gateway);
+}
+//# sourceMappingURL=sensors.js.map

package/dist/services/sensors.js.map

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

package/dist/services/summarize.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Summaries: the layer that answers "where did this land, and what's next?".
+ *
+ * The provider is a plain CLI invoked with the distilled prompt on stdin. That
+ * keeps gmux harness-agnostic — it ships pointing at `claude -p`, but
+ * GMUX_SUMMARY_CMD can point it at `codex exec` or anything else that
+ * reads a prompt and writes text.
+ *
+ * Summaries are cached by content hash and regenerated only when the session
+ * itself changes, so each one is written once and re-read forever.
+ */
+import type { SessionRecord, SessionSummary, SummaryFields, SummaryInput, SummaryProvider } from "../core/types.js";
+/**
+ * Default provider command, ignoring config.
+ *
+ * Kept for the synchronous callers that predate config and for tests. Prefer
+ * `defaultSummaryProvider()`, which honors what the user chose in `gmux setup`.
+ */
+export declare function defaultProviderCommand(): string[];
+export declare class CliSummaryProvider implements SummaryProvider {
+    readonly name: string;
+    private readonly argv;
+    constructor(argv?: string[]);
+    isAvailable(): Promise<boolean>;
+    generate(input: SummaryInput): Promise<SummaryFields>;
+}
+/**
+ * The summary provider for the current config, or null when the user has
+ * configured gmux to make no model calls.
+ *
+ * Null is a choice being honored, not a failure. Callers render it as such.
+ */
+export declare function defaultSummaryProvider(): Promise<CliSummaryProvider | null>;
+/**
+ * Pull the JSON object out of a model's reply.
+ *
+ * Models fence their JSON, or preface it, more often than they should — so we
+ * take the outermost brace pair rather than trusting the whole reply to parse.
+ */
+export declare function parseSummaryFields(raw: string, provider: string): SummaryFields;
+export declare function readSummary(record: SessionRecord): Promise<SessionSummary | null>;
+/** A cached summary is stale once the session it describes has moved on. */
+export declare function isStale(summary: SessionSummary | null, record: SessionRecord): boolean;
+/**
+ * How many of the 64 SimHash bits must differ before a session is worth
+ * re-summarising. Tunable via `GMUX_REFRESH_DISTANCE`; the default is
+ * conservative — refresh on real progress, not on chatter.
+ */
+export declare const REFRESH_DISTANCE: number;
+export declare function contentFingerprint(input: SummaryInput): string;
+/** The low-churn significant signals — any change here always forces a refresh. */
+export declare function signalHash(input: SummaryInput): string;
+/**
+ * Should this session's summary be re-generated? The divergence-gated successor
+ * to `isStale`, for the background/watch path:
+ *
+ * - no summary → yes;
+ * - a pre-0.9.0 summary with no fingerprint → fall back to the exact hash, so
+ *   there is no forced re-summarise burst on upgrade;
+ * - a significant signal changed (prompt version, a new tool failure, the
+ *   mid-task flag, the files touched) → yes, even at SimHash distance 0;
+ * - otherwise → only when the narrative SimHash has diverged by ≥ REFRESH_DISTANCE.
+ */
+export declare function shouldRefresh(summary: SessionSummary | null, record: SessionRecord): boolean;
+export declare function writeSummary(summary: SessionSummary): Promise<void>;
+/** Generate a summary for one session and cache it. */
+export declare function summarizeSession(record: SessionRecord, provider: SummaryProvider, now?: () => Date): Promise<SessionSummary>;
+export interface SummarizeBatchResult {
+    generated: number;
+    skipped: number;
+    failed: {
+        sessionId: string;
+        reason: string;
+    }[];
+}
+/**
+ * Summarize many sessions, skipping those whose cached summary is still fresh.
+ * Failures are collected rather than thrown: one bad session must not abort a
+ * batch of fifty.
+ */
+export declare function summarizeBatch(records: readonly SessionRecord[], provider: SummaryProvider, options?: {
+    force?: boolean;
+    onProgress?: (done: number, total: number) => void;
+}): Promise<SummarizeBatchResult>;

package/dist/services/summarize.js

@@ -0,0 +1,230 @@
+/**
+ * Summaries: the layer that answers "where did this land, and what's next?".
+ *
+ * The provider is a plain CLI invoked with the distilled prompt on stdin. That
+ * keeps gmux harness-agnostic — it ships pointing at `claude -p`, but
+ * GMUX_SUMMARY_CMD can point it at `codex exec` or anything else that
+ * reads a prompt and writes text.
+ *
+ * Summaries are cached by content hash and regenerated only when the session
+ * itself changes, so each one is written once and re-read forever.
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { SummaryProviderError } from "../core/errors.js";
+import { hammingDistance, simhash64 } from "../core/fingerprint.js";
+import { summaryPath } from "../core/paths.js";
+import { hash } from "../core/text.js";
+import { FALLBACK_COMMAND, readConfig, resolveSummaryCommand } from "./config.js";
+import { buildPrompt, distill } from "./distill.js";
+import { mapLimit } from "./concurrency.js";
+import { runProviderCommand } from "./provider-process.js";
+import { onPath } from "./providers.js";
+/**
+ * How many summaries are written at once.
+ *
+ * Each is an independent `claude -p`; they do not contend. Eight keeps a
+ * twenty-session backfill down to a few wall-clock minutes instead of twenty.
+ */
+const SUMMARY_CONCURRENCY = Number(process.env["GMUX_SUMMARY_CONCURRENCY"]) || 8;
+const PROVIDER_TIMEOUT_MS = 120_000;
+/**
+ * Default provider command, ignoring config.
+ *
+ * Kept for the synchronous callers that predate config and for tests. Prefer
+ * `defaultSummaryProvider()`, which honors what the user chose in `gmux setup`.
+ */
+export function defaultProviderCommand() {
+    const override = process.env.GMUX_SUMMARY_CMD;
+    if (override && override.trim() !== "")
+        return override.trim().split(/\s+/);
+    return [...FALLBACK_COMMAND];
+}
+export class CliSummaryProvider {
+    name;
+    argv;
+    constructor(argv = defaultProviderCommand()) {
+        this.argv = argv;
+        this.name = argv.join(" ");
+    }
+    async isAvailable() {
+        const binary = this.argv[0];
+        if (!binary)
+            return false;
+        return onPath(binary);
+    }
+    async generate(input) {
+        const prompt = buildPrompt(input);
+        try {
+            const output = await runProviderCommand(this.argv, prompt, {
+                timeoutMs: PROVIDER_TIMEOUT_MS,
+            });
+            return parseSummaryFields(output, this.name);
+        }
+        catch (error) {
+            if (error instanceof SummaryProviderError)
+                throw error;
+            throw new SummaryProviderError(this.name, error.message);
+        }
+    }
+}
+/**
+ * The summary provider for the current config, or null when the user has
+ * configured gmux to make no model calls.
+ *
+ * Null is a choice being honored, not a failure. Callers render it as such.
+ */
+export async function defaultSummaryProvider() {
+    const command = resolveSummaryCommand(await readConfig());
+    return command ? new CliSummaryProvider(command) : null;
+}
+/**
+ * Pull the JSON object out of a model's reply.
+ *
+ * Models fence their JSON, or preface it, more often than they should — so we
+ * take the outermost brace pair rather than trusting the whole reply to parse.
+ */
+export function parseSummaryFields(raw, provider) {
+    const start = raw.indexOf("{");
+    const end = raw.lastIndexOf("}");
+    if (start === -1 || end === -1 || end <= start) {
+        throw new SummaryProviderError(provider, "reply contained no JSON object");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw.slice(start, end + 1));
+    }
+    catch (error) {
+        throw new SummaryProviderError(provider, `reply was not valid JSON: ${error.message}`);
+    }
+    const object = parsed;
+    const field = (key) => {
+        const value = object[key];
+        return typeof value === "string" ? value.trim() : "";
+    };
+    const headline = field("headline");
+    if (headline === "")
+        throw new SummaryProviderError(provider, "reply had no `headline`");
+    return {
+        headline,
+        overview: field("overview"),
+        summary: field("summary"),
+        landed: field("landed"),
+        open: field("open"),
+        nextStep: field("nextStep"),
+    };
+}
+export async function readSummary(record) {
+    try {
+        const raw = await readFile(summaryPath(record.harness, record.sessionId), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** A cached summary is stale once the session it describes has moved on. */
+export function isStale(summary, record) {
+    if (!summary)
+        return true;
+    return summary.sourceHash !== distill(record).hash;
+}
+/**
+ * How many of the 64 SimHash bits must differ before a session is worth
+ * re-summarising. Tunable via `GMUX_REFRESH_DISTANCE`; the default is
+ * conservative — refresh on real progress, not on chatter.
+ */
+export const REFRESH_DISTANCE = (() => {
+    const raw = Number(process.env.GMUX_REFRESH_DISTANCE);
+    return Number.isFinite(raw) && raw > 0 ? Math.floor(raw) : 8;
+})();
+/** The narrative fields — what the SimHash tracks for gradual divergence. */
+function narrativeText(input) {
+    return [...input.arcPrompts, ...input.recentUserPrompts, input.lastAssistantText ?? ""].join("\n");
+}
+export function contentFingerprint(input) {
+    return simhash64(narrativeText(input));
+}
+/** The low-churn significant signals — any change here always forces a refresh. */
+export function signalHash(input) {
+    return hash(JSON.stringify({
+        promptVersion: input.promptVersion,
+        lastToolFailure: input.lastToolFailure,
+        endedMidTask: input.endedMidTask,
+        files: [...input.filesTouched].sort(),
+    }));
+}
+/**
+ * Should this session's summary be re-generated? The divergence-gated successor
+ * to `isStale`, for the background/watch path:
+ *
+ * - no summary → yes;
+ * - a pre-0.9.0 summary with no fingerprint → fall back to the exact hash, so
+ *   there is no forced re-summarise burst on upgrade;
+ * - a significant signal changed (prompt version, a new tool failure, the
+ *   mid-task flag, the files touched) → yes, even at SimHash distance 0;
+ * - otherwise → only when the narrative SimHash has diverged by ≥ REFRESH_DISTANCE.
+ */
+export function shouldRefresh(summary, record) {
+    if (!summary)
+        return true;
+    const input = distill(record);
+    if (!summary.fingerprint)
+        return summary.sourceHash !== input.hash;
+    if (summary.signalHash !== signalHash(input))
+        return true;
+    return hammingDistance(summary.fingerprint, contentFingerprint(input)) >= REFRESH_DISTANCE;
+}
+export async function writeSummary(summary) {
+    const path = summaryPath(summary.harness, summary.sessionId);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(summary, null, 2), "utf8");
+}
+/** Generate a summary for one session and cache it. */
+export async function summarizeSession(record, provider, now = () => new Date()) {
+    const input = distill(record);
+    const fields = await provider.generate(input);
+    const summary = {
+        harness: record.harness,
+        sessionId: record.sessionId,
+        sourceHash: input.hash,
+        fingerprint: contentFingerprint(input),
+        signalHash: signalHash(input),
+        generatedAt: now().toISOString(),
+        provider: provider.name,
+        ...fields,
+    };
+    await writeSummary(summary);
+    return summary;
+}
+/**
+ * Summarize many sessions, skipping those whose cached summary is still fresh.
+ * Failures are collected rather than thrown: one bad session must not abort a
+ * batch of fifty.
+ */
+export async function summarizeBatch(records, provider, options = {}) {
+    const result = { generated: 0, skipped: 0, failed: [] };
+    let done = 0;
+    await mapLimit(records, SUMMARY_CONCURRENCY, async (record) => {
+        try {
+            if (!options.force) {
+                const existing = await readSummary(record);
+                if (!isStale(existing, record)) {
+                    result.skipped += 1;
+                    return;
+                }
+            }
+            await summarizeSession(record, provider);
+            result.generated += 1;
+        }
+        catch (error) {
+            result.failed.push({ sessionId: record.sessionId, reason: error.message });
+        }
+        finally {
+            done += 1;
+            options.onProgress?.(done, records.length);
+        }
+    });
+    return result;
+}
+//# sourceMappingURL=summarize.js.map