@lanefoundry/gatelane-sdk 0.0.0-canary-b3f6165

package/dist/gate.js

@@ -0,0 +1,82 @@
+/**
+ * Gate runner registry — the SDK defines the shape, the engine plugs in the impl.
+ *
+ * The default export is a stub that produces a deterministic mock. Production
+ * installs the engine package and calls {@link setGateRunner} once at process
+ * startup; subsequent {@link runGate} calls delegate to the engine.
+ *
+ * Decoupling: SDK doesn't depend on engine (engine depends on SDK). Test code
+ * can install a fake runner for deterministic gate outputs.
+ *
+ * @see docs/prd.md §5.1 — The gate
+ */
+import { shaOfCandidateRef } from './candidate.js';
+import { DEFAULT_POLICY, } from './promotion.js';
+let registeredRunner = null;
+/** Install the real engine runner. Idempotent; subsequent calls overwrite. */
+export function setGateRunner(runner) {
+    registeredRunner = runner;
+}
+/** Reset to the stub runner. Tests use this. */
+export function resetGateRunner() {
+    registeredRunner = null;
+}
+/**
+ * Run the gate. If an engine runner is installed, delegates to it.
+ * Otherwise produces a deterministic mock report (W1 behavior).
+ */
+export async function runGate(args) {
+    if (registeredRunner !== null) {
+        return registeredRunner(args);
+    }
+    return stubRunGate(args);
+}
+/** v0.0.0-dev stub — kept for SDK consumers that don't load the engine yet. */
+export async function stubRunGate(args) {
+    const policy = args.policy ?? DEFAULT_POLICY;
+    const baseline = args.baseline ?? 'model:baseline';
+    const runId = crypto.randomUUID();
+    const reportId = crypto.randomUUID();
+    const candidate_shas = {};
+    for (const ref of args.candidates) {
+        candidate_shas[ref] = await shaOfCandidateRef(ref);
+    }
+    const judge_shas = {};
+    for (const judge of args.judges) {
+        judge_shas[judge] = await shaOfCandidateRef(judge);
+    }
+    const report = {
+        id: reportId,
+        gate_run_id: runId,
+        dataset_content_hash: args.dataset.content_hash,
+        dataset_version: args.dataset.version,
+        candidate_shas,
+        judge_shas,
+        scorer_code_sha: await shaOfCandidateRef('gatelane-sdk:scorer:v0.0.0-dev'),
+        baseline_metrics: { primary_score: 0.7 },
+        candidate_metrics: Object.fromEntries(args.candidates.map((ref) => [
+            ref,
+            { aggregate_delta: 0.05, cost_delta: 0.02, latency_delta: 0.03 },
+        ])),
+        judge_matrix: {
+            candidates: args.candidates,
+            judges: args.judges,
+            winners_by_judge: Object.fromEntries(args.candidates.map((ref) => [ref, args.judges.length])),
+            consensus_winners: args.candidates,
+        },
+        policy,
+        ...(args.approver !== undefined ? { approver: args.approver } : {}),
+        timestamp: new Date().toISOString(),
+        signature: 'stub:unsigned',
+    };
+    const winner = args.candidates[0] ?? baseline;
+    const decision = policy.approval_required
+        ? { action: 'hold_for_review', reason: 'approval_required' }
+        : {
+            action: 'pass',
+            winner,
+            reason: `stub: all candidates passed policy (min_delta=${policy.min_delta})`,
+        };
+    return { report, decision, replay_rows: [], verdicts: [], candidate_metrics: {} };
+}
+//# sourceMappingURL=gate.js.map

package/dist/gate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @lanefoundry/gatelane-sdk — promotion gate SDK.
+ *
+ * Public API for v0.0.1-dev. Engine wires up across W1–W6 per docs/roadmap.md.
+ *
+ * @see docs/prd.md §5.6 — SDK & API surface
+ */
+export * from './capture.js';
+export * from './candidate.js';
+export * from './dataset.js';
+export * from './gate.js';
+export * from './promotion.js';
+export * from './storage.js';
+export * from './storage-fs.js';
+export * from './storage-http.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @lanefoundry/gatelane-sdk — promotion gate SDK.
+ *
+ * Public API for v0.0.1-dev. Engine wires up across W1–W6 per docs/roadmap.md.
+ *
+ * @see docs/prd.md §5.6 — SDK & API surface
+ */
+export * from './capture.js';
+export * from './candidate.js';
+export * from './dataset.js';
+export * from './gate.js';
+export * from './promotion.js';
+export * from './storage.js';
+export * from './storage-fs.js';
+export * from './storage-http.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/promotion.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Gate policy, report, and decision — the signed artifacts produced by a gate run.
+ *
+ * @see docs/prd.md §5.1 — The gate
+ */
+export type GatePolicy = {
+    /** Minimum aggregate delta over baseline required to pass. */
+    readonly min_delta: number;
+    /** Minimum fraction of judges that must agree on the winning candidate (e.g., 0.67 = 2 of 3). */
+    readonly judge_stability_threshold: number;
+    /** Maximum cost increase over baseline permitted for a pass decision. */
+    readonly cost_ceiling: number;
+    /** Maximum latency increase over baseline permitted for a pass decision. */
+    readonly latency_ceiling: number;
+    /** Whether human approval is required before the gate decision is executed. */
+    readonly approval_required: boolean;
+    /** Trigger condition under which a deployed canary is automatically blocked. */
+    readonly auto_block_rule?: {
+        /** Metric drop threshold (e.g., 0.05 = 5% drop). */
+        readonly metric_drop: number;
+        /** Window to observe canary before passing to 100% (e.g., "24h"). */
+        readonly window: string;
+    };
+};
+/** @deprecated Use GatePolicy instead. */
+export type PromotionPolicy = GatePolicy;
+export type JudgeStabilityMatrix = {
+    readonly candidates: ReadonlyArray<string>;
+    readonly judges: ReadonlyArray<string>;
+    /** winners_by_judge[candidate] = count of judges that picked this candidate as winner. */
+    readonly winners_by_judge: Record<string, number>;
+    /** Candidates that won under at least judge_stability_threshold × judges.length judges. */
+    readonly consensus_winners: ReadonlyArray<string>;
+};
+export type GateReport = {
+    readonly id: string;
+    readonly gate_run_id: string;
+    readonly dataset_content_hash: string;
+    readonly dataset_version: string;
+    /** SHA per candidate, keyed by candidate ref. */
+    readonly candidate_shas: Record<string, string>;
+    /** SHA per judge, keyed by judge ref. */
+    readonly judge_shas: Record<string, string>;
+    /** SHA of the scorer / evaluator code. */
+    readonly scorer_code_sha: string;
+    /** Baseline metrics: per-metric. */
+    readonly baseline_metrics: Record<string, number>;
+    /** Per-candidate metrics: aggregate delta + cost + latency. */
+    readonly candidate_metrics: Record<string, {
+        aggregate_delta: number;
+        cost_delta: number;
+        latency_delta: number;
+    }>;
+    /** Which judge picked which candidate as winner. */
+    readonly judge_matrix: JudgeStabilityMatrix;
+    /** Policy that was applied to this gate run. */
+    readonly policy: GatePolicy;
+    /** Who approved the decision (when approval_required = true). */
+    readonly approver?: string;
+    /** ISO 8601 timestamp of report signing. */
+    readonly timestamp: string;
+    /** Signature. Stub in v0.0.0-dev. */
+    readonly signature: string;
+};
+/** @deprecated Use GateReport instead. */
+export type PromotionReport = GateReport;
+export type GateDecision = {
+    readonly action: 'pass';
+    readonly winner: string;
+    readonly reason: string;
+} | {
+    readonly action: 'block';
+    readonly reason: string;
+} | {
+    readonly action: 'hold_for_review';
+    readonly reason: string;
+};
+/** @deprecated Use GateDecision instead. */
+export type PromotionDecision = GateDecision;
+/** Default gate policy. */
+export declare const DEFAULT_POLICY: GatePolicy;
+//# sourceMappingURL=promotion.d.ts.map

package/dist/promotion.d.ts.map

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

package/dist/promotion.js

@@ -0,0 +1,14 @@
+/**
+ * Gate policy, report, and decision — the signed artifacts produced by a gate run.
+ *
+ * @see docs/prd.md §5.1 — The gate
+ */
+/** Default gate policy. */
+export const DEFAULT_POLICY = {
+    min_delta: 0.02,
+    judge_stability_threshold: 0.67,
+    cost_ceiling: 0.1,
+    latency_ceiling: 0.2,
+    approval_required: false,
+};
+//# sourceMappingURL=promotion.js.map

package/dist/promotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion.js","sourceRoot":"","sources":["../src/promotion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsFH,2BAA2B;AAC3B,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,SAAS,EAAE,IAAI;IACf,yBAAyB,EAAE,IAAI;IAC/B,YAAY,EAAE,GAAG;IACjB,eAAe,EAAE,GAAG;IACpB,iBAAiB,EAAE,KAAK;CACzB,CAAC"}

package/dist/storage-fs.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Filesystem storage adapter — writes capture records as JSONL files on disk.
+ *
+ * Use this in local dev when you don't want to spin up a Cloudflare Worker.
+ * Each record is one JSON line; the file name encodes the time so listing is cheap.
+ *
+ * Not for production: no concurrency control, no rotation, no replay-friendly
+ * content addressing. Use HttpStorage in production.
+ */
+import type { CaptureRecord, StorageAdapter, WriteResult } from './storage.js';
+export type FilesystemStorageOptions = {
+    /** Directory to write capture files. Created if missing. */
+    readonly dir: string;
+};
+export declare class FilesystemStorage implements StorageAdapter {
+    readonly name: string;
+    private readonly dir;
+    constructor(opts: FilesystemStorageOptions);
+    write(record: CaptureRecord): Promise<WriteResult>;
+    read(id: string): Promise<CaptureRecord | null>;
+    list(filter: {
+        source_kind?: string;
+        since?: string;
+        limit?: number;
+    }): Promise<ReadonlyArray<CaptureRecord>>;
+}
+//# sourceMappingURL=storage-fs.d.ts.map

package/dist/storage-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-fs.d.ts","sourceRoot":"","sources":["../src/storage-fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE/E,MAAM,MAAM,wBAAwB,GAAG;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,qBAAa,iBAAkB,YAAW,cAAc;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,IAAI,EAAE,wBAAwB;IAKpC,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAQlD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAe/C,IAAI,CAAC,MAAM,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;CAuBpH"}

package/dist/storage-fs.js

@@ -0,0 +1,68 @@
+/**
+ * Filesystem storage adapter — writes capture records as JSONL files on disk.
+ *
+ * Use this in local dev when you don't want to spin up a Cloudflare Worker.
+ * Each record is one JSON line; the file name encodes the time so listing is cheap.
+ *
+ * Not for production: no concurrency control, no rotation, no replay-friendly
+ * content addressing. Use HttpStorage in production.
+ */
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export class FilesystemStorage {
+    name;
+    dir;
+    constructor(opts) {
+        this.dir = opts.dir;
+        this.name = `fs(${opts.dir})`;
+    }
+    async write(record) {
+        await mkdir(this.dir, { recursive: true });
+        const stored_at = new Date().toISOString();
+        const file = join(this.dir, `${record.started_at.replace(/[:.]/g, '-')}-${record.id}.jsonl`);
+        await writeFile(file, JSON.stringify(record), 'utf-8');
+        return { id: record.id, stored_at, backend: this.name };
+    }
+    async read(id) {
+        const files = await readdir(this.dir);
+        for (const f of files) {
+            if (!f.endsWith('.jsonl'))
+                continue;
+            const text = await readFile(join(this.dir, f), 'utf-8');
+            try {
+                const record = JSON.parse(text);
+                if (record.id === id)
+                    return record;
+            }
+            catch {
+                // skip malformed
+            }
+        }
+        return null;
+    }
+    async list(filter) {
+        const files = (await readdir(this.dir)).filter((f) => f.endsWith('.jsonl')).sort();
+        let out = [];
+        for (const f of files) {
+            const text = await readFile(join(this.dir, f), 'utf-8');
+            try {
+                out.push(JSON.parse(text));
+            }
+            catch {
+                // skip
+            }
+        }
+        if (filter.source_kind !== undefined) {
+            out = out.filter((r) => r.input.metadata?.['source_kind'] === filter.source_kind);
+        }
+        if (filter.since !== undefined) {
+            const since = Date.parse(filter.since);
+            out = out.filter((r) => Date.parse(r.started_at) >= since);
+        }
+        if (filter.limit !== undefined) {
+            out = out.slice(0, filter.limit);
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=storage-fs.js.map

package/dist/storage-fs.js.map

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

package/dist/storage-http.d.ts

@@ -0,0 +1,43 @@
+/**
+ * HTTP storage adapter — sends capture records to a gatelane Worker endpoint.
+ *
+ * Production: `https://<your-worker>.workers.dev/v1/capture`
+ * Local dev:  `http://localhost:8787/v1/capture`
+ *
+ * The Worker writes the record body to R2 (raw blob) and the metadata to D1.
+ * This adapter only handles transport; the storage / persistence happens server-side.
+ *
+ * Retries: 3 attempts with exponential backoff on 5xx / network errors.
+ *
+ * @see docs/prd.md §6.1 — Cloudflare-first deployment
+ */
+import type { CaptureRecord, StorageAdapter, WriteResult } from './storage.js';
+export type HttpStorageOptions = {
+    /** Base URL of the gatelane Worker, no trailing slash. */
+    readonly endpoint: string;
+    /** Bearer token for the `/v1/capture` route. */
+    readonly token: string;
+    /** Max retry attempts on transient failures. Defaults to 3. */
+    readonly maxRetries?: number;
+    /** Initial backoff in ms. Doubles each retry. Defaults to 200. */
+    readonly initialBackoffMs?: number;
+    /** Override fetch for testing. Defaults to global fetch. */
+    readonly fetchImpl?: typeof fetch;
+};
+export declare class HttpStorage implements StorageAdapter {
+    readonly name: string;
+    private readonly endpoint;
+    private readonly token;
+    private readonly maxRetries;
+    private readonly initialBackoffMs;
+    private readonly fetchImpl;
+    constructor(opts: HttpStorageOptions);
+    write(record: CaptureRecord): Promise<WriteResult>;
+    read(_id: string): Promise<CaptureRecord | null>;
+    list(filter?: {
+        source_kind?: string;
+        since?: string;
+        limit?: number;
+    }): Promise<ReadonlyArray<CaptureRecord>>;
+}
+//# sourceMappingURL=storage-http.d.ts.map

package/dist/storage-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-http.d.ts","sourceRoot":"","sources":["../src/storage-http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE/E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACnC,CAAC;AAEF,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,IAAI,EAAE,kBAAkB;IAS9B,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAyClD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAMhD,IAAI,CAAC,MAAM,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;CAkBzH"}

package/dist/storage-http.js

@@ -0,0 +1,112 @@
+/**
+ * HTTP storage adapter — sends capture records to a gatelane Worker endpoint.
+ *
+ * Production: `https://<your-worker>.workers.dev/v1/capture`
+ * Local dev:  `http://localhost:8787/v1/capture`
+ *
+ * The Worker writes the record body to R2 (raw blob) and the metadata to D1.
+ * This adapter only handles transport; the storage / persistence happens server-side.
+ *
+ * Retries: 3 attempts with exponential backoff on 5xx / network errors.
+ *
+ * @see docs/prd.md §6.1 — Cloudflare-first deployment
+ */
+export class HttpStorage {
+    name;
+    endpoint;
+    token;
+    maxRetries;
+    initialBackoffMs;
+    fetchImpl;
+    constructor(opts) {
+        this.endpoint = opts.endpoint.replace(/\/$/, '');
+        this.token = opts.token;
+        this.maxRetries = opts.maxRetries ?? 3;
+        this.initialBackoffMs = opts.initialBackoffMs ?? 200;
+        this.fetchImpl = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+        this.name = `http(${new URL(this.endpoint).host})`;
+    }
+    async write(record) {
+        const url = `${this.endpoint}/v1/capture`;
+        let lastErr = null;
+        for (let attempt = 0; attempt < this.maxRetries; attempt++) {
+            try {
+                const response = await this.fetchImpl(url, {
+                    method: 'POST',
+                    headers: {
+                        'content-type': 'application/json',
+                        authorization: `Bearer ${this.token}`,
+                        'x-gatelane-span-kind': record.span_kind ?? 'gate.replay',
+                    },
+                    body: JSON.stringify(record),
+                });
+                if (response.ok) {
+                    const body = (await response.json());
+                    return { id: body.id, stored_at: body.stored_at, backend: this.name };
+                }
+                // 4xx is fatal — don't retry. 5xx is transient — retry.
+                if (response.status >= 400 && response.status < 500) {
+                    throw new Error(`capture write rejected: ${response.status} ${response.statusText}`);
+                }
+                lastErr = new Error(`capture write failed: ${response.status} ${response.statusText}`);
+            }
+            catch (err) {
+                // Re-throw 4xx immediately so the caller sees the rejection; only network / 5xx retries.
+                if (err instanceof Error && err.message.startsWith('capture write rejected')) {
+                    throw err;
+                }
+                lastErr = err;
+            }
+            // Backoff before next attempt (5xx / network path).
+            if (attempt < this.maxRetries - 1) {
+                const delay = this.initialBackoffMs * Math.pow(2, attempt);
+                const { promise, resolve } = Promise.withResolvers();
+                setTimeout(resolve, delay);
+                await promise;
+            }
+        }
+        throw new Error(`capture write failed after ${this.maxRetries} attempts: ${String(lastErr)}`);
+    }
+    async read(_id) {
+        // Worker exposes GET /v1/capture/:id in v0.2. Stub: return null.
+        // Returning null means "not in local cache; ask the Worker". Tests don't depend on read.
+        return null;
+    }
+    async list(filter = {}) {
+        const params = new URLSearchParams();
+        if (filter.since !== undefined)
+            params.set('since', filter.since);
+        if (filter.limit !== undefined)
+            params.set('limit', String(filter.limit));
+        const url = `${this.endpoint}/v1/captures${params.size > 0 ? '?' + params.toString() : ''}`;
+        const response = await this.fetchImpl(url, {
+            headers: { authorization: `Bearer ${this.token}` },
+        });
+        if (!response.ok) {
+            throw new Error(`capture list failed: ${response.status} ${response.statusText}`);
+        }
+        const body = (await response.json());
+        let out = body.captures.map(wireToLocal);
+        if (filter.source_kind !== undefined) {
+            out = out.filter((r) => r.input.metadata?.['source_kind'] === filter.source_kind);
+        }
+        return out;
+    }
+}
+/** Convert a wire capture row back into the SDK's CapturedCall shape. */
+function wireToLocal(row) {
+    return {
+        id: row.id,
+        input: {
+            prompt: row.prompt,
+            model: row.model,
+            metadata: row.metadata,
+        },
+        output: row.response,
+        started_at: row.createdAt,
+        completed_at: row.createdAt,
+        cost_usd: row.costCents / 100,
+        latency_ms: row.latencyMs,
+    };
+}
+//# sourceMappingURL=storage-http.js.map

package/dist/storage-http.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Storage adapter — pluggable back-end for capture records.
+ *
+ * gatelane's capture SDK is host-agnostic: the same SDK can write to in-memory
+ * (tests), filesystem (local dev), or HTTP (production, talking to a Cloudflare
+ * Worker that writes to R2/D1).
+ *
+ * @see docs/prd.md §5.4 — Shared engine
+ */
+export type D1DatabaseLike = {
+    prepare(query: string): D1PreparedStatementLike;
+};
+export type D1PreparedStatementLike = {
+    bind(...values: unknown[]): D1PreparedStatementLike;
+    first<T = unknown>(column?: string): Promise<T | null>;
+    run(): Promise<{
+        success: boolean;
+    }>;
+    all<T = unknown>(): Promise<{
+        results: T[];
+    }>;
+};
+export type R2BucketLike = {
+    put(key: string, value: ReadableStream | ArrayBuffer | string, options?: {
+        httpMetadata?: {
+            contentType?: string;
+        };
+    }): Promise<unknown>;
+    get(key: string): Promise<{
+        body: ReadableStream;
+        httpMetadata?: {
+            contentType?: string;
+        };
+    } | null>;
+    delete(key: string): Promise<void>;
+};
+import type { CapturedCall } from './capture.js';
+export type CaptureRecord = CapturedCall;
+/** Result of a successful write. */
+export type WriteResult = {
+    readonly id: string;
+    readonly stored_at: string;
+    readonly backend: string;
+};
+/** Storage back-end interface. All implementations must be safe to call concurrently. */
+export interface StorageAdapter {
+    /** Persist a capture record. Returns the canonical id + storage timestamp. */
+    write(record: CaptureRecord): Promise<WriteResult>;
+    /** Read back a record by id. Returns null if not found. */
+    read(id: string): Promise<CaptureRecord | null>;
+    /** List records matching a filter. Used by the freeze-slice tool. */
+    list(filter: {
+        source_kind?: string;
+        since?: string;
+        limit?: number;
+    }): Promise<ReadonlyArray<CaptureRecord>>;
+    /** Identity of the backend (for debugging + audit). */
+    readonly name: string;
+}
+/** In-memory adapter. Default for tests; never persisted across restarts. */
+export declare class InMemoryStorage implements StorageAdapter {
+    readonly name = "memory";
+    private readonly records;
+    write(record: CaptureRecord): Promise<WriteResult>;
+    read(id: string): Promise<CaptureRecord | null>;
+    list(filter: {
+        source_kind?: string;
+        since?: string;
+        limit?: number;
+    }): Promise<ReadonlyArray<CaptureRecord>>;
+}
+/** Replace the active storage backend. Returns the previous backend for restoration in tests. */
+export declare function setStorage(adapter: StorageAdapter): StorageAdapter;
+/** Get the active storage backend. */
+export declare function getStorage(): StorageAdapter;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -0,0 +1,52 @@
+/**
+ * Storage adapter — pluggable back-end for capture records.
+ *
+ * gatelane's capture SDK is host-agnostic: the same SDK can write to in-memory
+ * (tests), filesystem (local dev), or HTTP (production, talking to a Cloudflare
+ * Worker that writes to R2/D1).
+ *
+ * @see docs/prd.md §5.4 — Shared engine
+ */
+/** In-memory adapter. Default for tests; never persisted across restarts. */
+export class InMemoryStorage {
+    name = 'memory';
+    records = new Map();
+    async write(record) {
+        this.records.set(record.id, record);
+        return {
+            id: record.id,
+            stored_at: new Date().toISOString(),
+            backend: this.name,
+        };
+    }
+    async read(id) {
+        return this.records.get(id) ?? null;
+    }
+    async list(filter) {
+        let out = Array.from(this.records.values());
+        if (filter.source_kind !== undefined) {
+            out = out.filter((r) => r.input.metadata?.['source_kind'] === filter.source_kind);
+        }
+        if (filter.since !== undefined) {
+            const since = Date.parse(filter.since);
+            out = out.filter((r) => Date.parse(r.started_at) >= since);
+        }
+        if (filter.limit !== undefined) {
+            out = out.slice(0, filter.limit);
+        }
+        return out;
+    }
+}
+/** Active storage. Module-level mutable singleton — initialized once. */
+let activeStorage = new InMemoryStorage();
+/** Replace the active storage backend. Returns the previous backend for restoration in tests. */
+export function setStorage(adapter) {
+    const previous = activeStorage;
+    activeStorage = adapter;
+    return previous;
+}
+/** Get the active storage backend. */
+export function getStorage() {
+    return activeStorage;
+}
+//# sourceMappingURL=storage.js.map