@lanefoundry/gatelane-sdk 0.0.0-stage → 0.1.0

package/dist/candidate.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Candidate types — any component swap in the agent's context that can be attacked.
+ *
+ * gatelane's gate treats all 10 as first-class. The GateReport
+ * carries the SHA of every candidate.
+ *
+ * @see docs/prd.md §5.3 — Candidate types table
+ */
+export type CandidateRef = {
+    /** Discriminator + identifier. Format: `<type>:<id>[@<version>]`. */
+    readonly ref: string;
+    /** SHA captured in the GateReport. */
+    readonly sha: string;
+    /** Optional human-readable label for reports. */
+    readonly label?: string;
+};
+export type CandidateType = 'model' | 'prompt' | 'skill' | 'config' | 'tool' | 'eval' | 'kb' | 'memory' | 'dispatcher' | 'guardrail';
+/** Parse a candidate ref string like `tool:mcp-server-foo@1.2.0` into type + id + version. */
+export declare function parseCandidateRef(ref: string): {
+    type: CandidateType;
+    id: string;
+    version?: string;
+};
+/** Compute a placeholder SHA for a candidate ref. Stub: SHA-256 of the ref string. */
+export declare function shaOfCandidateRef(ref: string): Promise<string>;
+//# sourceMappingURL=candidate.d.ts.map

package/dist/candidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate.d.ts","sourceRoot":"","sources":["../src/candidate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,MAAM,GACN,MAAM,GACN,IAAI,GACJ,QAAQ,GACR,YAAY,GACZ,WAAW,CAAC;AAEhB,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CA6BA;AAED,sFAAsF;AACtF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASpE"}

package/dist/candidate.js

@@ -0,0 +1,41 @@
+/** Parse a candidate ref string like `tool:mcp-server-foo@1.2.0` into type + id + version. */
+export function parseCandidateRef(ref) {
+    const colonIdx = ref.indexOf(':');
+    if (colonIdx < 0) {
+        throw new Error(`invalid candidate ref: ${ref} (expected <type>:<id>[@<version>])`);
+    }
+    const type = ref.slice(0, colonIdx);
+    const rest = ref.slice(colonIdx + 1);
+    const valid = [
+        'model',
+        'prompt',
+        'skill',
+        'config',
+        'tool',
+        'eval',
+        'kb',
+        'memory',
+        'dispatcher',
+        'guardrail',
+    ];
+    if (!valid.includes(type)) {
+        throw new Error(`invalid candidate type: ${type} (expected one of ${valid.join(', ')})`);
+    }
+    const atIdx = rest.lastIndexOf('@');
+    if (atIdx < 0) {
+        return { type, id: rest };
+    }
+    return { type, id: rest.slice(0, atIdx), version: rest.slice(atIdx + 1) };
+}
+/** Compute a placeholder SHA for a candidate ref. Stub: SHA-256 of the ref string. */
+export async function shaOfCandidateRef(ref) {
+    // v0.0.0-dev stub: deterministic placeholder so reports are reproducible.
+    // Real implementation in W2 will hash the actual artifact content.
+    const data = new TextEncoder().encode(ref);
+    const digest = await crypto.subtle.digest('SHA-256', data);
+    const hex = Array.from(new Uint8Array(digest))
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+    return `sha256:${hex}`;
+}
+//# sourceMappingURL=candidate.js.map

package/dist/candidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate.js","sourceRoot":"","sources":["../src/candidate.ts"],"names":[],"mappings":"AA6BA,8FAA8F;AAC9F,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAK3C,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,qCAAqC,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAkB,CAAC;IACrD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,KAAK,GAAoB;QAC7B,OAAO;QACP,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,MAAM;QACN,MAAM;QACN,IAAI;QACJ,QAAQ;QACR,YAAY;QACZ,WAAW;KACZ,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,qBAAqB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACxE,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,0EAA0E;IAC1E,mEAAmE;IACnE,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,UAAU,GAAG,EAAE,CAAC;AACzB,CAAC"}

package/dist/capture.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Capture SDK — one-line instrumentation for agent calls.
+ *
+ * Wraps an LLM/tool/judge call so gatelane can observe (and later replay) it.
+ * Records go through the active StorageAdapter (in-memory by default; HTTP via
+ * HttpStorage for production; filesystem via FilesystemStorage for local dev).
+ *
+ * @example
+ * ```ts
+ * import { capture, setStorage, HttpStorage } from "@lanefoundry/gatelane-sdk";
+ *
+ * // One-time setup: point capture at the production Worker.
+ * setStorage(new HttpStorage({
+ *   endpoint: process.env.GATELANE_ENDPOINT!,
+ *   token: process.env.GATELANE_CAPTURE_TOKEN!,
+ * }));
+ *
+ * // Now every call site uses the same wrapper.
+ * const response = await capture({
+ *   prompt: [{ role: "user", content: userInput }],
+ *   model: "gpt-4o",
+ *   metadata: { traceId: "...", agentVersion: "..." },
+ * }, async () => openai.chat.completions.create({ ... }));
+ * ```
+ *
+ * @see docs/prd.md §5.6 — SDK & API surface
+ */
+import type { DatasetSourceKind } from './dataset.js';
+export type CaptureMetadata = {
+    readonly traceId?: string;
+    readonly agentVersion?: string;
+    readonly dataset?: string;
+    readonly source_kind?: DatasetSourceKind;
+    /** Free-form metadata. */
+    readonly [key: string]: unknown;
+};
+export type CaptureInput = {
+    readonly prompt: ReadonlyArray<{
+        role: string;
+        content: string;
+    }>;
+    readonly model?: string;
+    readonly metadata?: CaptureMetadata;
+};
+/** What the capture SDK stores per call. */
+export type CapturedCall = {
+    readonly id: string;
+    readonly input: CaptureInput;
+    readonly output: unknown;
+    readonly started_at: string;
+    readonly completed_at: string;
+    readonly cost_usd: number;
+    readonly latency_ms: number;
+    /** Span kind: gate.replay, gate.compare, gate.promote, scan.attack, scan.judge. */
+    readonly span_kind?: string;
+};
+/** A single step in a multi-turn agent trace (user/assistant/tool). */
+export type Turn = {
+    readonly role: 'system' | 'user' | 'assistant' | 'tool';
+    readonly content: string | null;
+    readonly tool_call_id?: string;
+    readonly name?: string;
+    readonly tool_calls?: ReadonlyArray<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+    readonly status?: 'ok' | 'error' | 'timeout';
+    readonly error?: {
+        type: string;
+        message: string;
+        stack?: string;
+    };
+    readonly span_kind?: string;
+    readonly span_id?: string;
+    readonly parent_span_id?: string;
+    readonly model?: string;
+    readonly started_at?: string;
+    readonly completed_at?: string;
+    readonly cost_usd?: number;
+    readonly latency_ms?: number;
+    readonly tokens_in?: number;
+    readonly tokens_out?: number;
+};
+export type CaptureOptions = {
+    readonly span_kind?: string;
+    /** If true, observe without writing. Used for SDK validation in prod. */
+    readonly dry_run?: boolean;
+};
+/**
+ * Wrap an LLM/tool/judge call so gatelane captures it.
+ *
+ * Production behavior: writes the record to the active StorageAdapter (HTTP → Worker → R2/D1).
+ * Tests: in-memory adapter keeps everything in process.
+ * Local dev without Worker: filesystem adapter.
+ */
+export declare function capture<T>(input: CaptureInput, call: () => Promise<T>, options?: CaptureOptions): Promise<T>;
+/**
+ * Wrap an existing agent function so every call is captured.
+ * Sugar over {@link capture} for the common case.
+ */
+export declare function withCapture<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => Promise<TReturn>, options?: {
+    span_kind?: string;
+}): (...args: TArgs) => Promise<TReturn>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/capture.d.ts.map

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

package/dist/capture.js

@@ -0,0 +1,78 @@
+/**
+ * Capture SDK — one-line instrumentation for agent calls.
+ *
+ * Wraps an LLM/tool/judge call so gatelane can observe (and later replay) it.
+ * Records go through the active StorageAdapter (in-memory by default; HTTP via
+ * HttpStorage for production; filesystem via FilesystemStorage for local dev).
+ *
+ * @example
+ * ```ts
+ * import { capture, setStorage, HttpStorage } from "@lanefoundry/gatelane-sdk";
+ *
+ * // One-time setup: point capture at the production Worker.
+ * setStorage(new HttpStorage({
+ *   endpoint: process.env.GATELANE_ENDPOINT!,
+ *   token: process.env.GATELANE_CAPTURE_TOKEN!,
+ * }));
+ *
+ * // Now every call site uses the same wrapper.
+ * const response = await capture({
+ *   prompt: [{ role: "user", content: userInput }],
+ *   model: "gpt-4o",
+ *   metadata: { traceId: "...", agentVersion: "..." },
+ * }, async () => openai.chat.completions.create({ ... }));
+ * ```
+ *
+ * @see docs/prd.md §5.6 — SDK & API surface
+ */
+import { getStorage } from './storage.js';
+/**
+ * Wrap an LLM/tool/judge call so gatelane captures it.
+ *
+ * Production behavior: writes the record to the active StorageAdapter (HTTP → Worker → R2/D1).
+ * Tests: in-memory adapter keeps everything in process.
+ * Local dev without Worker: filesystem adapter.
+ */
+export async function capture(input, call, options = {}) {
+    const started_at = new Date().toISOString();
+    const start = performance.now();
+    const output = await call();
+    const latency_ms = performance.now() - start;
+    const completed_at = new Date().toISOString();
+    if (options.dry_run) {
+        return output;
+    }
+    const record = {
+        id: crypto.randomUUID(),
+        input,
+        output,
+        started_at,
+        completed_at,
+        cost_usd: 0, // placeholder; real impl reads from model registry
+        latency_ms,
+        ...(options.span_kind !== undefined ? { span_kind: options.span_kind } : {}),
+    };
+    // Fire-and-await: a capture write failure must not break the user's call.
+    // The Worker is the source of truth; SDK surfaces the error to stderr but
+    // does NOT throw, so a flaky network does not turn into a broken agent.
+    try {
+        await getStorage().write(record);
+    }
+    catch (err) {
+        process.stderr.write(`[gatelane] capture write failed (record id=${record.id}): ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+    return output;
+}
+/**
+ * Wrap an existing agent function so every call is captured.
+ * Sugar over {@link capture} for the common case.
+ */
+export function withCapture(fn, options = {}) {
+    return async (...args) => {
+        return capture({
+            prompt: [],
+            metadata: { args: args.length },
+        }, () => fn(...args), options);
+    };
+}
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA2D1C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,KAAmB,EACnB,IAAsB,EACtB,UAA0B,EAAE;IAE5B,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE9C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAiB;QAC3B,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,KAAK;QACL,MAAM;QACN,UAAU;QACV,YAAY;QACZ,QAAQ,EAAE,CAAC,EAAE,mDAAmD;QAChE,UAAU;QACV,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC;IAEF,0EAA0E;IAC1E,0EAA0E;IAC1E,wEAAwE;IACxE,IAAI,CAAC;QACH,MAAM,UAAU,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8CAA8C,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAClH,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,EAAwC,EACxC,UAAkC,EAAE;IAEpC,OAAO,KAAK,EAAE,GAAG,IAAW,EAAoB,EAAE;QAChD,OAAO,OAAO,CACZ;YACE,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;SAChC,EACD,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EACjB,OAAO,CACR,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/dataset.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Frozen dataset — content-addressed, immutable, versioned.
+ *
+ * A dataset is the input to a gate run. Three sources:
+ * - `scan` — curated attacks from garak / PyRIT / Promptfoo / DeepTeam
+ * - `prod` — frozen production slice from capture SDK
+ * - `compliance` — curated cases mapped to NIST / AI Basic Act / EU AI Act
+ *
+ * @see docs/prd.md §5.2 — Three dataset sources
+ */
+export type DatasetSourceKind = 'scan' | 'prod' | 'compliance';
+export type FrozenDataset = {
+    /** Content hash of the dataset. */
+    readonly content_hash: string;
+    /** Schema version. */
+    readonly version: string;
+    /** Where this dataset came from. */
+    readonly source_kind: DatasetSourceKind;
+    /** Free-form reference to the upstream source (e.g. "garak@0.14.0+owasp-agentic-v1"). */
+    readonly source_ref: string;
+    /** Optional slice filter (time range, user cohort, etc.). */
+    readonly slice_filter?: Record<string, unknown>;
+    /** When the dataset was frozen. ISO 8601 timestamp. */
+    readonly frozen_at: string;
+    /** Number of items in the dataset. */
+    readonly item_count: number;
+    /** Items themselves (lazy-loaded). */
+    readonly items?: ReadonlyArray<DatasetItem>;
+};
+import type { Turn } from './capture.js';
+export type DatasetItem = {
+    readonly id: string;
+    /** For red-team: the attack payload. For prod: the captured user input. For compliance: the test case. */
+    readonly input: unknown;
+    /** Optional expected outcome (for compliance / eval datasets). */
+    readonly expected?: unknown;
+    /** Full multi-turn agent trace from the original capture, when available.
+     *  Includes tool calls, tool results, and intermediate assistant turns. */
+    readonly turns?: ReadonlyArray<Turn>;
+    /** Metadata from the original capture (model, cost, latency, etc.). */
+    readonly metadata?: Record<string, unknown>;
+    /** OWASP Agentic Top 10 mapping, if known. */
+    readonly mapped_asi?: 'ASI01' | 'ASI02' | 'ASI03' | 'ASI04' | 'ASI05' | 'ASI06' | 'ASI07' | 'ASI08' | 'ASI09' | 'ASI10';
+    /** MITRE ATLAS technique ID, if known. */
+    readonly mapped_atlas?: string;
+};
+/** Compute a placeholder content hash from item count + source ref. Stub. */
+export declare function hashDataset(source_kind: DatasetSourceKind, source_ref: string, item_count: number): Promise<string>;
+/** Build a stub FrozenDataset. Items optional. */
+export declare function freezeDataset(args: {
+    source_kind: DatasetSourceKind;
+    source_ref: string;
+    slice_filter?: Record<string, unknown>;
+    items?: ReadonlyArray<DatasetItem>;
+}): Promise<FrozenDataset>;
+//# sourceMappingURL=dataset.d.ts.map

package/dist/dataset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset.d.ts","sourceRoot":"","sources":["../src/dataset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;AAE/D,MAAM,MAAM,aAAa,GAAG;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,yFAAyF;IACzF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CAC7C,CAAC;AAEF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0GAA0G;IAC1G,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;+EAC2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACxH,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,6EAA6E;AAC7E,wBAAsB,WAAW,CAC/B,WAAW,EAAE,iBAAiB,EAC9B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,kDAAkD;AAClD,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CACpC,GAAG,OAAO,CAAC,aAAa,CAAC,CAazB"}

package/dist/dataset.js

@@ -0,0 +1,35 @@
+/**
+ * Frozen dataset — content-addressed, immutable, versioned.
+ *
+ * A dataset is the input to a gate run. Three sources:
+ * - `scan` — curated attacks from garak / PyRIT / Promptfoo / DeepTeam
+ * - `prod` — frozen production slice from capture SDK
+ * - `compliance` — curated cases mapped to NIST / AI Basic Act / EU AI Act
+ *
+ * @see docs/prd.md §5.2 — Three dataset sources
+ */
+/** Compute a placeholder content hash from item count + source ref. Stub. */
+export async function hashDataset(source_kind, source_ref, item_count) {
+    const data = new TextEncoder().encode(`${source_kind}|${source_ref}|${item_count}`);
+    const digest = await crypto.subtle.digest('SHA-256', data);
+    const hex = Array.from(new Uint8Array(digest))
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+    return `sha256:${hex}`;
+}
+/** Build a stub FrozenDataset. Items optional. */
+export async function freezeDataset(args) {
+    const item_count = args.items?.length ?? 0;
+    const content_hash = await hashDataset(args.source_kind, args.source_ref, item_count);
+    return {
+        content_hash,
+        version: '0.0.0-dev',
+        source_kind: args.source_kind,
+        source_ref: args.source_ref,
+        ...(args.slice_filter !== undefined ? { slice_filter: args.slice_filter } : {}),
+        frozen_at: new Date().toISOString(),
+        item_count,
+        ...(args.items !== undefined ? { items: args.items } : {}),
+    };
+}
+//# sourceMappingURL=dataset.js.map

package/dist/dataset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset.js","sourceRoot":"","sources":["../src/dataset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0CH,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAA8B,EAC9B,UAAkB,EAClB,UAAkB;IAElB,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,WAAW,IAAI,UAAU,IAAI,UAAU,EAAE,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;SAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,UAAU,GAAG,EAAE,CAAC;AACzB,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAKnC;IACC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACtF,OAAO;QACL,YAAY;QACZ,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU;QACV,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/gate.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 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 type { FrozenDataset } from './dataset.js';
+import { type GateDecision, type GatePolicy, type GateReport } from './promotion.js';
+export type GateRunArgs = {
+    readonly candidates: ReadonlyArray<string>;
+    readonly dataset: FrozenDataset;
+    readonly judges: ReadonlyArray<string>;
+    readonly baseline?: string;
+    readonly policy?: GatePolicy;
+    readonly approver?: string;
+};
+/** Lightweight replay row shape (mirrors engine's ReplayRow without importing it). */
+export type GateReplayRow = {
+    readonly item_id: string;
+    readonly candidate_ref: string;
+    readonly response: {
+        readonly content: string;
+        readonly cost_usd: number;
+        readonly latency_ms: number;
+        readonly tokens_in?: number;
+        readonly tokens_out?: number;
+        readonly finish_reason?: string;
+    };
+};
+/** Lightweight judge verdict shape (mirrors engine's JudgeVerdict). */
+export type GateJudgeVerdict = {
+    readonly candidate_ref: string;
+    readonly judge_ref: string;
+    readonly item_id: string;
+    readonly outcome: 'pass' | 'fail';
+    readonly score: number;
+    readonly reasoning?: string;
+    readonly cost_usd: number;
+    readonly latency_ms: number;
+};
+/** Lightweight per-candidate metric shape (mirrors engine's CandidateMetric). */
+export type GateCandidateMetric = {
+    readonly mean_score: number;
+    readonly pass_rate: number;
+    readonly n_items: number;
+    readonly total_cost_usd: number;
+    readonly mean_latency_ms: number;
+    readonly aggregate_delta: number;
+    readonly cost_delta: number;
+    readonly latency_delta: number;
+};
+export type GateRunResult = {
+    readonly report: GateReport;
+    readonly decision: GateDecision;
+    /** Per-item replay outputs for every (candidate, item) pair. */
+    readonly replay_rows?: ReadonlyArray<GateReplayRow>;
+    /** Per-item judge verdicts with scores and reasoning. */
+    readonly verdicts?: ReadonlyArray<GateJudgeVerdict>;
+    /** Per-candidate aggregate metrics (mean_score, pass_rate, cost, latency, deltas). */
+    readonly candidate_metrics?: Readonly<Record<string, GateCandidateMetric>>;
+};
+/** Runner interface. The engine implements this and registers it. */
+export type GateRunner = (args: GateRunArgs) => Promise<GateRunResult>;
+/** Install the real engine runner. Idempotent; subsequent calls overwrite. */
+export declare function setGateRunner(runner: GateRunner): void;
+/** Reset to the stub runner. Tests use this. */
+export declare function resetGateRunner(): void;
+/**
+ * Run the gate. If an engine runner is installed, delegates to it.
+ * Otherwise produces a deterministic mock report (W1 behavior).
+ */
+export declare function runGate(args: GateRunArgs): Promise<GateRunResult>;
+/** v0.0.0-dev stub — kept for SDK consumers that don't load the engine yet. */
+export declare function stubRunGate(args: GateRunArgs): Promise<GateRunResult>;
+//# sourceMappingURL=gate.d.ts.map

package/dist/gate.d.ts.map

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

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"}