@getrift/rift 0.0.0 → 0.1.0-beta.0

package/dist/src/capture/batch-budget.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Per-batch cost ceiling and parallelism guard.
+ *
+ * Concurrency-safe by construction:
+ *   - the budget reserves an estimate up-front (acquire), so two parallel
+ *     callers can't both pass the cap by reading a stale "spent" total
+ *   - each call returns its actual cost to its own reservation token;
+ *     no shared mutable cost bucket on the provider
+ *   - failed/aborted calls refund the reservation
+ *
+ * Cost-cap policy: fail-closed. Once a reservation pushes the running
+ * total past the cap, the budget is marked exceeded and refuses every
+ * subsequent reservation, even if currently-in-flight calls would have
+ * trued-up to less than reserved. Already-running calls finish.
+ *
+ * Concurrency policy: at most `maxParallel` triage calls are in flight.
+ * Excess callers wait FIFO.
+ */
+import { type TriageInput, type TriageProvider, type TriageResult } from "./triage-provider.js";
+export interface TriageCost {
+    /** USD spent on this call. */
+    usd: number;
+}
+/**
+ * A provider that returns the cost of each call alongside the result.
+ *
+ * No shared mutable cost state between calls — this is the contract
+ * that makes concurrent budget enforcement correct.
+ */
+export interface CostReportingTriageProvider extends TriageProvider {
+    /**
+     * Worst-case USD cost for an upcoming call. Used at reservation
+     * time so the budget can fail-closed before any tokens are spent.
+     */
+    estimateMaxCostUsd(input: TriageInput): number;
+    /**
+     * Run triage and return the result + the actual USD this call cost.
+     * Implementations MUST NOT share cost state across concurrent calls.
+     */
+    triageWithCost(input: TriageInput): Promise<{
+        result: TriageResult;
+        cost: TriageCost;
+    }>;
+}
+/**
+ * Finalize an active reservation with the actual cost. Pass `0` to
+ * refund the full reservation (e.g. on a failed call, where no tokens
+ * were billed).
+ */
+export type ReservationToken = (actualUsd: number) => void;
+export declare class BatchBudget {
+    readonly capUsd: number;
+    /** Reserved + actually spent. Never negative. */
+    private accounted;
+    private exceeded;
+    constructor(capUsd: number);
+    /**
+     * Reserve `estimateUsd` against the cap and return a finalize token.
+     *
+     * Throws BatchCostExceededError if the budget is already busted, or if
+     * adding this estimate would exceed the cap. Subsequent reservations
+     * after a breach are also refused (fail-closed).
+     */
+    reserve(estimateUsd: number): ReservationToken;
+    get spent(): number;
+    get isExceeded(): boolean;
+}
+/**
+ * FIFO semaphore. acquire() resolves when a slot is free; release()
+ * hands the slot to the next waiter.
+ */
+export declare class Semaphore {
+    readonly maxParallel: number;
+    private inFlight;
+    private waiters;
+    /** Peak concurrent in-flight count, for test assertions. */
+    peakInFlight: number;
+    constructor(maxParallel: number);
+    acquire(): Promise<void>;
+    release(): void;
+    get current(): number;
+}
+/**
+ * Wrap a CostReportingTriageProvider with a per-batch budget and
+ * parallelism cap. Returns a TriageProvider that reserves budget
+ * up-front, true-ups to actual cost on completion, and refunds on
+ * failure.
+ */
+export declare function withBatchGuards(provider: CostReportingTriageProvider, budget: BatchBudget, semaphore: Semaphore): TriageProvider;
+//# sourceMappingURL=batch-budget.d.ts.map

package/dist/src/capture/batch-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-budget.d.ts","sourceRoot":"","sources":["../../../src/capture/batch-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc;IACjE;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC;IAE/C;;;OAGG;IACH,cAAc,CACZ,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AAE3D,qBAAa,WAAW;aAKM,MAAM,EAAE,MAAM;IAJ1C,iDAAiD;IACjD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAS;gBAEG,MAAM,EAAE,MAAM;IAM1C;;;;;;OAMG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB;IA6B9C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;CACF;AAED;;;GAGG;AACH,qBAAa,SAAS;aAMQ,WAAW,EAAE,MAAM;IAL/C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAAsB;IACrC,4DAA4D;IACrD,YAAY,SAAK;gBAEI,WAAW,EAAE,MAAM;IAMzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B,OAAO,IAAI,IAAI;IAMf,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,2BAA2B,EACrC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,SAAS,GACnB,cAAc,CA+BhB"}

package/dist/src/capture/batch-budget.js

@@ -0,0 +1,148 @@
+/**
+ * Per-batch cost ceiling and parallelism guard.
+ *
+ * Concurrency-safe by construction:
+ *   - the budget reserves an estimate up-front (acquire), so two parallel
+ *     callers can't both pass the cap by reading a stale "spent" total
+ *   - each call returns its actual cost to its own reservation token;
+ *     no shared mutable cost bucket on the provider
+ *   - failed/aborted calls refund the reservation
+ *
+ * Cost-cap policy: fail-closed. Once a reservation pushes the running
+ * total past the cap, the budget is marked exceeded and refuses every
+ * subsequent reservation, even if currently-in-flight calls would have
+ * trued-up to less than reserved. Already-running calls finish.
+ *
+ * Concurrency policy: at most `maxParallel` triage calls are in flight.
+ * Excess callers wait FIFO.
+ */
+import { BatchCostExceededError, BilledOpenAIError, } from "./triage-provider.js";
+export class BatchBudget {
+    capUsd;
+    /** Reserved + actually spent. Never negative. */
+    accounted = 0;
+    exceeded = false;
+    constructor(capUsd) {
+        this.capUsd = capUsd;
+        if (capUsd <= 0) {
+            throw new Error("BatchBudget capUsd must be positive");
+        }
+    }
+    /**
+     * Reserve `estimateUsd` against the cap and return a finalize token.
+     *
+     * Throws BatchCostExceededError if the budget is already busted, or if
+     * adding this estimate would exceed the cap. Subsequent reservations
+     * after a breach are also refused (fail-closed).
+     */
+    reserve(estimateUsd) {
+        if (this.exceeded) {
+            throw new BatchCostExceededError(`Batch cost cap exceeded — no new triage admitted (accounted $${this.accounted.toFixed(4)}, cap $${this.capUsd.toFixed(2)})`, this.accounted, this.capUsd);
+        }
+        const requested = Math.max(0, estimateUsd);
+        if (this.accounted + requested > this.capUsd) {
+            this.exceeded = true;
+            throw new BatchCostExceededError(`Batch cost cap would be exceeded (accounted $${this.accounted.toFixed(4)} + estimate $${requested.toFixed(4)} > cap $${this.capUsd.toFixed(2)})`, this.accounted, this.capUsd);
+        }
+        this.accounted += requested;
+        let finalized = false;
+        return (actualUsd) => {
+            if (finalized)
+                return;
+            finalized = true;
+            const delta = Math.max(0, actualUsd) - requested;
+            this.accounted += delta;
+            if (this.accounted < 0)
+                this.accounted = 0;
+            if (this.accounted > this.capUsd)
+                this.exceeded = true;
+        };
+    }
+    get spent() {
+        return this.accounted;
+    }
+    get isExceeded() {
+        return this.exceeded;
+    }
+}
+/**
+ * FIFO semaphore. acquire() resolves when a slot is free; release()
+ * hands the slot to the next waiter.
+ */
+export class Semaphore {
+    maxParallel;
+    inFlight = 0;
+    waiters = [];
+    /** Peak concurrent in-flight count, for test assertions. */
+    peakInFlight = 0;
+    constructor(maxParallel) {
+        this.maxParallel = maxParallel;
+        if (maxParallel <= 0) {
+            throw new Error("Semaphore maxParallel must be positive");
+        }
+    }
+    async acquire() {
+        if (this.inFlight < this.maxParallel) {
+            this.inFlight++;
+            if (this.inFlight > this.peakInFlight)
+                this.peakInFlight = this.inFlight;
+            return;
+        }
+        await new Promise((resolve) => this.waiters.push(resolve));
+        this.inFlight++;
+        if (this.inFlight > this.peakInFlight)
+            this.peakInFlight = this.inFlight;
+    }
+    release() {
+        this.inFlight--;
+        const next = this.waiters.shift();
+        if (next)
+            next();
+    }
+    get current() {
+        return this.inFlight;
+    }
+}
+/**
+ * Wrap a CostReportingTriageProvider with a per-batch budget and
+ * parallelism cap. Returns a TriageProvider that reserves budget
+ * up-front, true-ups to actual cost on completion, and refunds on
+ * failure.
+ */
+export function withBatchGuards(provider, budget, semaphore) {
+    return {
+        async triage(input) {
+            // Reserve before launching: prevents over-admission under concurrency.
+            const finalize = budget.reserve(provider.estimateMaxCostUsd(input));
+            let actualUsd = 0;
+            try {
+                await semaphore.acquire();
+                try {
+                    const { result, cost } = await provider.triageWithCost(input);
+                    actualUsd = cost.usd;
+                    return result;
+                }
+                finally {
+                    semaphore.release();
+                }
+            }
+            catch (err) {
+                // BilledOpenAIError carries a cost the upstream API already
+                // charged us (200 + bad JSON). Retain that cost in the budget;
+                // refunding would silently let a malformed-response loop escape
+                // the cap. All other failures refund the full reservation.
+                if (err instanceof BilledOpenAIError) {
+                    actualUsd = err.costUsd;
+                }
+                else {
+                    actualUsd = 0;
+                }
+                throw err;
+            }
+            finally {
+                finalize(actualUsd);
+            }
+        },
+    };
+}
+//# sourceMappingURL=batch-budget.js.map

package/dist/src/capture/batch-budget.js.map

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

package/dist/src/capture/codex-cli-triage-provider.d.ts

@@ -0,0 +1,17 @@
+import { type TriageInput, type TriageResult } from "./triage-provider.js";
+import type { CostReportingTriageProvider, TriageCost } from "./batch-budget.js";
+export declare class CodexCliTriageProvider implements CostReportingTriageProvider {
+    private readonly options;
+    constructor(options?: {
+        cwd?: string;
+        timeoutMs?: number;
+    });
+    estimateMaxCostUsd(_input: TriageInput): number;
+    triage(input: TriageInput): Promise<TriageResult>;
+    triageWithCost(input: TriageInput): Promise<{
+        result: TriageResult;
+        cost: TriageCost;
+    }>;
+    private runPrompt;
+}
+//# sourceMappingURL=codex-cli-triage-provider.d.ts.map

package/dist/src/capture/codex-cli-triage-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-cli-triage-provider.d.ts","sourceRoot":"","sources":["../../../src/capture/codex-cli-triage-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,KAAK,EACV,2BAA2B,EAC3B,UAAU,EACX,MAAM,mBAAmB,CAAC;AAkD3B,qBAAa,sBAAuB,YAAW,2BAA2B;IAEtE,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE;QACxB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACf;IAGR,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM;IAIzC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAKjD,cAAc,CAClB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC;YA+BxC,SAAS;CAmCxB"}

package/dist/src/capture/codex-cli-triage-provider.js

@@ -0,0 +1,109 @@
+import { TRIAGE_VERSION, } from "./triage-provider.js";
+import { scoreHistoricalTriage, } from "./triage-lane.js";
+import { CODEX_CLI_OVERRIDE_MODEL, CODEX_CLI_OVERRIDE_PROVIDER, } from "../providers/operator-overrides.js";
+import { runCodexCliJson } from "../providers/codex-cli-runner.js";
+const TRIAGE_PROMPT = `You are a triage classifier for a personal knowledge base. Given a conversation between a user and an AI assistant, decide whether it should be saved to long-term memory.
+
+Classify as one of:
+- "save": Contains valuable decisions, technical knowledge, project context, personal insights, client work details, or reference-worthy information the user would want to recall later.
+- "discard": Trivial, purely mechanical, repetitive, or contains no lasting value.
+- "review": Borderline — might be valuable but you're not sure.
+
+Return ONLY a JSON object matching the provided schema.
+
+CONVERSATION:
+`;
+const TRIAGE_OUTPUT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    required: ["decision", "confidence", "summary", "topics", "rationale"],
+    properties: {
+        decision: {
+            type: "string",
+            enum: ["save", "discard", "review"],
+        },
+        confidence: {
+            type: "number",
+            minimum: 0,
+            maximum: 1,
+        },
+        summary: { type: "string" },
+        topics: {
+            type: "array",
+            items: { type: "string" },
+        },
+        rationale: { type: "string" },
+    },
+};
+export class CodexCliTriageProvider {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    estimateMaxCostUsd(_input) {
+        return 0;
+    }
+    async triage(input) {
+        const { result } = await this.triageWithCost(input);
+        return result;
+    }
+    async triageWithCost(input) {
+        const parsed = await this.runPrompt(input);
+        const scoring = scoreHistoricalTriage({
+            content: input.content,
+            decision: parsed.decision,
+            confidence: parsed.confidence,
+            summary: parsed.summary,
+            rationale: parsed.rationale,
+            topics: parsed.topics,
+            ...(input.source ? { source: input.source } : {}),
+        });
+        return {
+            result: {
+                decision: parsed.decision,
+                lane: scoring.lane,
+                confidence: parsed.confidence,
+                score: scoring.score,
+                summary: parsed.summary,
+                topics: parsed.topics,
+                rationale: parsed.rationale,
+                model: CODEX_CLI_OVERRIDE_MODEL,
+                provider: CODEX_CLI_OVERRIDE_PROVIDER,
+                version: TRIAGE_VERSION,
+                score_breakdown: scoring.debug.score_breakdown,
+                debug: scoring.debug,
+            },
+            cost: { usd: 0 },
+        };
+    }
+    async runPrompt(input) {
+        const prompt = `${TRIAGE_PROMPT}${input.content}`;
+        const { output } = await runCodexCliJson({
+            prompt,
+            schema: TRIAGE_OUTPUT_SCHEMA,
+            ...(this.options.cwd ? { cwd: this.options.cwd } : {}),
+            ...(this.options.timeoutMs
+                ? { timeoutMs: this.options.timeoutMs }
+                : {}),
+        });
+        if (output.decision !== "save" &&
+            output.decision !== "discard" &&
+            output.decision !== "review") {
+            throw new Error(`Codex CLI returned invalid triage decision: ${String(output.decision)}`);
+        }
+        if (typeof output.confidence !== "number" ||
+            Number.isNaN(output.confidence) ||
+            output.confidence < 0 ||
+            output.confidence > 1) {
+            throw new Error(`Codex CLI returned invalid triage confidence: ${String(output.confidence)}`);
+        }
+        return {
+            decision: output.decision,
+            confidence: output.confidence,
+            summary: String(output.summary ?? ""),
+            topics: Array.isArray(output.topics) ? output.topics.map(String) : [],
+            rationale: String(output.rationale ?? ""),
+        };
+    }
+}
+//# sourceMappingURL=codex-cli-triage-provider.js.map

package/dist/src/capture/codex-cli-triage-provider.js.map

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

package/dist/src/capture/observability.d.ts

@@ -0,0 +1,42 @@
+import type { AutoCaptureSource, CaptureReport, CaptureSourceCounts } from "./auto-capture.js";
+export declare const AUTO_CAPTURE_RUNS_FILE = "auto-capture-runs.jsonl";
+export declare const AUTO_CAPTURE_RUNS_MAX_LINES = 1000;
+export interface AutoCaptureRunError {
+    sessionId: string;
+    source?: AutoCaptureSource;
+    error: string;
+}
+export interface AutoCaptureRunRecord {
+    timestamp: string;
+    enabled_sources: AutoCaptureSource[];
+    run_ok: boolean;
+    preflight_ok: boolean;
+    duration_ms: number;
+    counts_by_source: Partial<Record<AutoCaptureSource, CaptureSourceCounts>>;
+    errors: AutoCaptureRunError[];
+    run_error?: string;
+}
+export interface AutoCaptureSourceSuccess {
+    timestamp: string;
+    saved: number;
+    review: number;
+    discarded: number;
+    new: number;
+}
+export interface AutoCaptureRunSummary {
+    last_run: AutoCaptureRunRecord | null;
+    last_success_by_source: Partial<Record<AutoCaptureSource, AutoCaptureSourceSuccess | null>>;
+}
+export declare function autoCaptureRunsPath(dataDir: string): string;
+export declare function buildAutoCaptureRunRecord(opts: {
+    timestamp: string;
+    enabledSources: AutoCaptureSource[];
+    durationMs: number;
+    report: CaptureReport;
+}): AutoCaptureRunRecord;
+export declare function appendAutoCaptureRunRecord(dataDir: string, record: AutoCaptureRunRecord, maxLines?: number): Promise<void>;
+export declare function readAutoCaptureRunRecords(dataDir: string): AutoCaptureRunRecord[];
+export declare function summarizeAutoCaptureRuns(records: AutoCaptureRunRecord[], sources?: AutoCaptureSource[]): AutoCaptureRunSummary;
+export declare function readAutoCaptureRunSummary(dataDir: string, sources?: AutoCaptureSource[]): AutoCaptureRunSummary;
+export declare function formatAutoCaptureSummary(summary: AutoCaptureRunSummary): string;
+//# sourceMappingURL=observability.d.ts.map

package/dist/src/capture/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../../src/capture/observability.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAG3B,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAChE,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,iBAAiB,EAAE,CAAC;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC1E,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACtC,sBAAsB,EAAE,OAAO,CAC7B,MAAM,CAAC,iBAAiB,EAAE,wBAAwB,GAAG,IAAI,CAAC,CAC3D,CAAC;CACH;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,oBAAoB,CAgBvB;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,SAA8B,GACrC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,GACd,oBAAoB,EAAE,CAQxB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,OAAO,GAAE,iBAAiB,EAAiC,GAC1D,qBAAqB,CAyBvB;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAiB,EAAiC,GAC1D,qBAAqB,CAEvB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAW/E"}

package/dist/src/capture/observability.js

@@ -0,0 +1,87 @@
+import fs from "node:fs";
+import path from "node:path";
+import { atomicWrite } from "../storage/atomic.js";
+import { DEFAULT_AUTO_CAPTURE_SOURCES } from "./sources.js";
+export const AUTO_CAPTURE_RUNS_FILE = "auto-capture-runs.jsonl";
+export const AUTO_CAPTURE_RUNS_MAX_LINES = 1000;
+export function autoCaptureRunsPath(dataDir) {
+    return path.join(dataDir, "observability", AUTO_CAPTURE_RUNS_FILE);
+}
+export function buildAutoCaptureRunRecord(opts) {
+    return {
+        timestamp: opts.timestamp,
+        enabled_sources: opts.enabledSources,
+        // If runAutoCapture returned a report, the run completed. The daemon's
+        // catch-all path is the only place that writes run_ok: false.
+        run_ok: true,
+        preflight_ok: opts.report.preflight_ok,
+        duration_ms: opts.durationMs,
+        counts_by_source: opts.report.counts_by_source,
+        errors: opts.report.error_details.map((err) => ({
+            sessionId: err.sessionId,
+            ...(err.source ? { source: err.source } : {}),
+            error: err.error,
+        })),
+    };
+}
+export async function appendAutoCaptureRunRecord(dataDir, record, maxLines = AUTO_CAPTURE_RUNS_MAX_LINES) {
+    const filePath = autoCaptureRunsPath(dataDir);
+    // Invariant: daemon capture is the only writer today. Keep the capped
+    // read/modify/write path simple until another writer is introduced.
+    const lines = fs.existsSync(filePath)
+        ? fs.readFileSync(filePath, "utf-8").split("\n").filter(Boolean)
+        : [];
+    lines.push(JSON.stringify(record));
+    const capped = lines.slice(-maxLines);
+    await atomicWrite(filePath, `${capped.join("\n")}\n`);
+}
+export function readAutoCaptureRunRecords(dataDir) {
+    const filePath = autoCaptureRunsPath(dataDir);
+    if (!fs.existsSync(filePath))
+        return [];
+    return fs
+        .readFileSync(filePath, "utf-8")
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => JSON.parse(line));
+}
+export function summarizeAutoCaptureRuns(records, sources = DEFAULT_AUTO_CAPTURE_SOURCES) {
+    const lastSuccess = {};
+    for (const source of sources) {
+        lastSuccess[source] = null;
+    }
+    for (const record of records) {
+        if (record.run_ok === false)
+            continue;
+        for (const source of sources) {
+            const counts = record.counts_by_source[source];
+            if (!counts || counts.saved <= 0)
+                continue;
+            lastSuccess[source] = {
+                timestamp: record.timestamp,
+                saved: counts.saved,
+                review: counts.review,
+                discarded: counts.discarded,
+                new: counts.new,
+            };
+        }
+    }
+    return {
+        last_run: records.at(-1) ?? null,
+        last_success_by_source: lastSuccess,
+    };
+}
+export function readAutoCaptureRunSummary(dataDir, sources = DEFAULT_AUTO_CAPTURE_SOURCES) {
+    return summarizeAutoCaptureRuns(readAutoCaptureRunRecords(dataDir), sources);
+}
+export function formatAutoCaptureSummary(summary) {
+    const lines = ["", "## Auto-capture"];
+    lines.push(`- last run: ${summary.last_run?.timestamp ?? "none"}`);
+    for (const [source, success] of Object.entries(summary.last_success_by_source)) {
+        lines.push(success
+            ? `- ${source}: last successful save ${success.timestamp} (${success.saved} saved, ${success.new} new)`
+            : `- ${source}: no successful saves recorded`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=observability.js.map

package/dist/src/capture/observability.js.map

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

package/dist/src/capture/openai-triage-provider.d.ts

@@ -0,0 +1,92 @@
+/**
+ * OpenAI-backed triage provider.
+ *
+ * Locked model family:
+ *   - cheap (default):  gpt-5.4-nano
+ *   - escalation:       gpt-5.4-mini
+ *
+ * Two-tier strategy:
+ *   1. Always call cheap first.
+ *   2. Escalate to mini when:
+ *        - cheap result confidence < 0.7, OR
+ *        - input length > 8000 chars
+ *   3. If escalation fails, fall back to the cheap result so the batch
+ *      doesn't lose work over a single transient API blip.
+ *
+ * The provider implements CostReportingTriageProvider so a BatchBudget
+ * can true-up spend after each call.
+ */
+import { type TriageInput, type TriageResult } from "./triage-provider.js";
+import type { CostReportingTriageProvider, TriageCost } from "./batch-budget.js";
+/** Confidence threshold below which the cheap model escalates. */
+export declare const ESCALATION_CONFIDENCE = 0.7;
+/** Input length above which the cheap model always escalates. */
+export declare const HIGH_VALUE_LENGTH = 8000;
+/** Locked default models for the OpenAI runtime. */
+export declare const DEFAULT_CHEAP_MODEL = "gpt-5.4-nano";
+export declare const DEFAULT_ESCALATION_MODEL = "gpt-5.4-mini";
+/**
+ * Per-1k-token USD pricing. Values are best-effort defaults; can be
+ * overridden via `pricing` for tests or future re-pricing.
+ */
+export interface ModelPricing {
+    inputPer1k: number;
+    outputPer1k: number;
+}
+export declare const DEFAULT_PRICING: Record<string, ModelPricing>;
+/**
+ * Fetch dependency, broken out so tests can swap in a mock without
+ * monkey-patching the global. Matches the standard `fetch` signature.
+ */
+export type FetchFn = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+export interface OpenAIProviderOptions {
+    /** Resolves the API key — typically a Keychain read. Called lazily, once. */
+    apiKey: () => Promise<string>;
+    cheapModel?: string;
+    escalationModel?: string;
+    baseUrl?: string;
+    requestTimeoutMs?: number;
+    pricing?: Record<string, ModelPricing>;
+    fetchImpl?: FetchFn;
+}
+export declare class OpenAITriageProvider implements CostReportingTriageProvider {
+    private readonly cheapModel;
+    private readonly escalationModel;
+    private readonly baseUrl;
+    private readonly requestTimeoutMs;
+    private readonly pricing;
+    private readonly fetchImpl;
+    private readonly apiKeyResolver;
+    private keyPromise;
+    constructor(opts: OpenAIProviderOptions);
+    /** Pre-flight max-cost estimate. Uses the escalation model upper bound. */
+    estimateMaxCostUsd(input: TriageInput): number;
+    /** Convenience wrapper for callers that don't need cost reporting. */
+    triage(input: TriageInput): Promise<TriageResult>;
+    /**
+     * Run triage and return the result + actual cost incurred. All cost
+     * accounting is local to this call; concurrent invocations don't share
+     * any mutable state.
+     */
+    triageWithCost(input: TriageInput): Promise<{
+        result: TriageResult;
+        cost: TriageCost;
+    }>;
+    private callOnce;
+    /**
+     * Resolve the API key once and share the in-flight promise across
+     * concurrent callers, so the Keychain isn't hit N times under load.
+     */
+    private resolveKey;
+}
+//# sourceMappingURL=openai-triage-provider.d.ts.map

package/dist/src/capture/openai-triage-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-triage-provider.d.ts","sourceRoot":"","sources":["../../../src/capture/openai-triage-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,KAAK,EACV,2BAA2B,EAC3B,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAClD,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAKvD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAGxD,CAAC;AAwCF;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CACpB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAC9F,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AAEjG,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,oBAAqB,YAAW,2BAA2B;IACtE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,UAAU,CAAgC;gBAEtC,IAAI,EAAE,qBAAqB;IAUvC,2EAA2E;IAC3E,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAsB9C,sEAAsE;IAChE,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAKvD;;;;OAIG;IACG,cAAc,CAClB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC;YAiDxC,QAAQ;IA2FtB;;;OAGG;IACH,OAAO,CAAC,UAAU;CAUnB"}