@tenova/swt3-ai 0.1.0

package/dist/adapters/openai.js

@@ -0,0 +1,252 @@
+/**
+ * SWT3 AI Witness SDK — OpenAI Adapter (ES6 Proxy).
+ *
+ * Uses JavaScript's native Proxy to intercept property access on the
+ * OpenAI client, following the chain: client.chat.completions.create()
+ *
+ * Handles both:
+ *   - Non-streaming: ChatCompletion response object
+ *   - Streaming: AsyncIterable<ChatCompletionChunk> — accumulates chunks
+ *     for hashing, then witnesses after stream completes
+ *
+ * The developer's code sees zero difference from using the raw client.
+ */
+import { sha256Truncated } from "../fingerprint.js";
+/**
+ * Methods to intercept at each path level.
+ * "chat.completions" → intercept "create"
+ */
+const INTERCEPT_PATHS = {
+    "chat.completions": new Set(["create"]),
+};
+/**
+ * Wrap an OpenAI client with an ES6 Proxy for transparent witnessing.
+ */
+export function wrapOpenAI(client, witness) {
+    return createProxy(client, witness, "");
+}
+function createProxy(target, witness, path) {
+    return new Proxy(target, {
+        get(obj, prop) {
+            if (typeof prop === "symbol")
+                return Reflect.get(obj, prop);
+            const realValue = Reflect.get(obj, prop);
+            const currentPath = path ? `${path}.${prop}` : prop;
+            // Check if this property is an interceptable method
+            if (path in INTERCEPT_PATHS && INTERCEPT_PATHS[path].has(prop)) {
+                // This IS the method to intercept
+                return createInterceptor(realValue, witness);
+            }
+            // Check if this path could lead to interceptable methods
+            const hasChildren = Object.keys(INTERCEPT_PATHS).some((p) => p === currentPath || p.startsWith(currentPath + "."));
+            if (hasChildren && typeof realValue === "object" && realValue !== null) {
+                return createProxy(realValue, witness, currentPath);
+            }
+            // Pass through
+            return realValue;
+        },
+    });
+}
+function createInterceptor(realMethod, witness) {
+    return function interceptedCreate(...args) {
+        const kwargs = (args[0] ?? {});
+        const messages = kwargs.messages;
+        const model = kwargs.model ?? "unknown";
+        const isStreaming = kwargs.stream === true;
+        // Hash prompt before the call
+        const promptText = extractPromptText(messages);
+        const promptHash = sha256Truncated(promptText);
+        // Start latency timer
+        const start = performance.now();
+        // Call the real method (bound to its original this)
+        const result = realMethod.call(this, ...args);
+        if (isStreaming) {
+            // Streaming: wrap the async iterable to accumulate chunks
+            return handleStreaming(result, witness, model, promptHash, start);
+        }
+        // Non-streaming: result is a Promise<ChatCompletion>
+        return result.then((response) => {
+            const elapsedMs = Math.round(performance.now() - start);
+            const record = extractRecord(response, model, promptHash, elapsedMs);
+            witness.record(record);
+            return response; // Return UNTOUCHED
+        });
+    };
+}
+// ── Streaming Handler ──────────────────────────────────────────────
+//
+// OpenAI's streaming returns an object with:
+//   - Symbol.asyncIterator (for `for await...of`)
+//   - .controller for abort
+//   - .toReadableStream() for web streams
+//
+// We wrap the async iterator to accumulate content chunks, then
+// witness after the stream completes. The developer's stream
+// behavior is completely unchanged.
+async function* streamAccumulator(stream, witness, model, promptHash, startTime) {
+    const textParts = [];
+    let actualModel = model;
+    let systemFingerprint;
+    let hasRefusal = false;
+    let finishReason = "";
+    let inputTokens;
+    let outputTokens;
+    for await (const chunk of stream) {
+        // Yield chunk to the developer immediately (untouched)
+        yield chunk;
+        // Extract data from chunk for witnessing
+        const c = chunk;
+        if (c.model)
+            actualModel = c.model;
+        if (c.system_fingerprint)
+            systemFingerprint = c.system_fingerprint;
+        const choices = c.choices;
+        if (choices?.[0]) {
+            const delta = choices[0].delta;
+            if (delta?.content) {
+                textParts.push(delta.content);
+            }
+            if (delta?.refusal) {
+                hasRefusal = true;
+            }
+            if (choices[0].finish_reason) {
+                finishReason = choices[0].finish_reason;
+            }
+        }
+        // Usage info comes in the final chunk (stream_options: {include_usage: true})
+        const usage = c.usage;
+        if (usage) {
+            inputTokens = usage.prompt_tokens;
+            outputTokens = usage.completion_tokens;
+        }
+    }
+    // Stream complete — witness the full inference
+    const elapsedMs = Math.round(performance.now() - startTime);
+    const responseText = textParts.join("");
+    if (finishReason === "content_filter")
+        hasRefusal = true;
+    const modelHashInput = systemFingerprint
+        ? `${actualModel}:${systemFingerprint}`
+        : actualModel;
+    const record = {
+        modelId: actualModel,
+        modelHash: sha256Truncated(modelHashInput),
+        promptHash,
+        responseHash: sha256Truncated(responseText),
+        latencyMs: elapsedMs,
+        inputTokens,
+        outputTokens,
+        guardrailsActive: 0,
+        guardrailsRequired: 0,
+        guardrailPassed: true,
+        hasRefusal,
+        provider: "openai",
+        systemFingerprint,
+        guardrailNames: [],
+    };
+    witness.record(record);
+}
+function handleStreaming(streamResult, witness, model, promptHash, startTime) {
+    // The stream result is a Promise that resolves to the stream object
+    // (OpenAI SDK returns Promise<Stream<ChatCompletionChunk>>)
+    if (streamResult && typeof streamResult.then === "function") {
+        return streamResult.then((stream) => {
+            return wrapStream(stream, witness, model, promptHash, startTime);
+        });
+    }
+    // Direct stream object (shouldn't happen but handle gracefully)
+    return wrapStream(streamResult, witness, model, promptHash, startTime);
+}
+function wrapStream(stream, witness, model, promptHash, startTime) {
+    const s = stream;
+    // Create the accumulating async generator
+    const gen = streamAccumulator(s, witness, model, promptHash, startTime);
+    // Return a proxy that preserves all stream methods but overrides the iterator
+    return new Proxy(s, {
+        get(target, prop) {
+            // Override the async iterator
+            if (prop === Symbol.asyncIterator) {
+                return () => gen;
+            }
+            // Preserve other methods (controller, toReadableStream, etc.)
+            const value = Reflect.get(target, prop);
+            if (typeof value === "function") {
+                return value.bind(target);
+            }
+            return value;
+        },
+    });
+}
+// ── Factor Extraction ──────────────────────────────────────────────
+function extractPromptText(messages) {
+    if (typeof messages === "string")
+        return messages;
+    if (!Array.isArray(messages))
+        return "";
+    const parts = [];
+    for (const msg of messages) {
+        if (typeof msg === "object" && msg !== null) {
+            const m = msg;
+            const content = m.content;
+            if (typeof content === "string") {
+                parts.push(content);
+            }
+            else if (Array.isArray(content)) {
+                for (const part of content) {
+                    if (typeof part === "object" && part !== null) {
+                        const p = part;
+                        if (p.type === "text" && typeof p.text === "string") {
+                            parts.push(p.text);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return parts.join("\n");
+}
+function extractRecord(response, model, promptHash, elapsedMs) {
+    const r = response;
+    let responseText = "";
+    let hasRefusal = false;
+    const choices = r.choices;
+    if (choices?.[0]) {
+        const message = choices[0].message;
+        if (message) {
+            responseText = message.content ?? "";
+            if (message.refusal)
+                hasRefusal = true;
+        }
+        if (choices[0].finish_reason === "content_filter")
+            hasRefusal = true;
+    }
+    let inputTokens;
+    let outputTokens;
+    const usage = r.usage;
+    if (usage) {
+        inputTokens = usage.prompt_tokens;
+        outputTokens = usage.completion_tokens;
+    }
+    const actualModel = r.model ?? model;
+    const systemFingerprint = r.system_fingerprint;
+    const modelHashInput = systemFingerprint
+        ? `${actualModel}:${systemFingerprint}`
+        : actualModel;
+    return {
+        modelId: actualModel,
+        modelHash: sha256Truncated(modelHashInput),
+        promptHash,
+        responseHash: sha256Truncated(responseText),
+        latencyMs: elapsedMs,
+        inputTokens,
+        outputTokens,
+        guardrailsActive: 0,
+        guardrailsRequired: 0,
+        guardrailPassed: true,
+        hasRefusal,
+        provider: "openai",
+        systemFingerprint,
+        guardrailNames: [],
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/adapters/openai.js.map

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

package/dist/adapters/vercel-ai.d.ts

@@ -0,0 +1,64 @@
+/**
+ * SWT3 AI Witness SDK — Vercel AI SDK Integration.
+ *
+ * Provides an `onFinish` callback factory for the Vercel AI SDK's
+ * `streamText()` and `generateText()` functions. This is the most
+ * idiomatic integration for Next.js / React developers.
+ *
+ * Usage:
+ *   import { streamText } from "ai";
+ *   import { openai } from "@ai-sdk/openai";
+ *
+ *   const result = await streamText({
+ *     model: openai("gpt-4o"),
+ *     prompt: "Summarize this contract...",
+ *     onFinish: witness.vercelOnFinish(),
+ *   });
+ *
+ * The `onFinish` callback receives a normalized result regardless of
+ * provider (OpenAI, Anthropic, Google, custom), so this single hook
+ * works with any Vercel AI SDK provider — no per-provider adapters needed.
+ *
+ * Vercel AI SDK onFinish payload:
+ *   {
+ *     text: string,                    // Complete response text
+ *     usage: { promptTokens, completionTokens },
+ *     finishReason: "stop" | "length" | "content-filter" | "tool-calls" | ...,
+ *     response: { id, model, timestamp, headers },
+ *     experimental_providerMetadata?: { ... },
+ *   }
+ */
+import type { Witness } from "../witness.js";
+/**
+ * Vercel AI SDK onFinish callback shape.
+ * We define this locally to avoid requiring `ai` as a dependency.
+ */
+interface VercelOnFinishResult {
+    text: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+    };
+    finishReason: string;
+    response: {
+        id?: string;
+        model?: string;
+        timestamp?: Date;
+        headers?: Record<string, string>;
+    };
+    experimental_providerMetadata?: Record<string, unknown>;
+}
+export interface VercelOnFinishOptions {
+    /** Override the prompt text for hashing (if not using the `prompt` param). */
+    promptText?: string;
+    /** Model name override (if response.model is missing). */
+    modelId?: string;
+}
+/**
+ * Create a Vercel AI SDK `onFinish` callback that witnesses the inference.
+ *
+ * Works with both `streamText()` and `generateText()`.
+ */
+export declare function createVercelOnFinish(witness: Witness, options?: VercelOnFinishOptions): (result: VercelOnFinishResult) => void;
+export {};
+//# sourceMappingURL=vercel-ai.d.ts.map

package/dist/adapters/vercel-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../src/adapters/vercel-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;;GAGG;AACH,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE;QACR,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;IACF,6BAA6B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,qBAA0B,GAClC,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAoCxC"}

package/dist/adapters/vercel-ai.js

@@ -0,0 +1,68 @@
+/**
+ * SWT3 AI Witness SDK — Vercel AI SDK Integration.
+ *
+ * Provides an `onFinish` callback factory for the Vercel AI SDK's
+ * `streamText()` and `generateText()` functions. This is the most
+ * idiomatic integration for Next.js / React developers.
+ *
+ * Usage:
+ *   import { streamText } from "ai";
+ *   import { openai } from "@ai-sdk/openai";
+ *
+ *   const result = await streamText({
+ *     model: openai("gpt-4o"),
+ *     prompt: "Summarize this contract...",
+ *     onFinish: witness.vercelOnFinish(),
+ *   });
+ *
+ * The `onFinish` callback receives a normalized result regardless of
+ * provider (OpenAI, Anthropic, Google, custom), so this single hook
+ * works with any Vercel AI SDK provider — no per-provider adapters needed.
+ *
+ * Vercel AI SDK onFinish payload:
+ *   {
+ *     text: string,                    // Complete response text
+ *     usage: { promptTokens, completionTokens },
+ *     finishReason: "stop" | "length" | "content-filter" | "tool-calls" | ...,
+ *     response: { id, model, timestamp, headers },
+ *     experimental_providerMetadata?: { ... },
+ *   }
+ */
+import { sha256Truncated } from "../fingerprint.js";
+/**
+ * Create a Vercel AI SDK `onFinish` callback that witnesses the inference.
+ *
+ * Works with both `streamText()` and `generateText()`.
+ */
+export function createVercelOnFinish(witness, options = {}) {
+    const capturedStart = performance.now();
+    return (result) => {
+        const elapsedMs = Math.round(performance.now() - capturedStart);
+        const model = result.response?.model ?? options.modelId ?? "unknown";
+        const responseText = result.text ?? "";
+        // Prompt text: caller can provide it, or we hash empty
+        // (The Vercel AI SDK doesn't expose the prompt in onFinish,
+        //  so the caller should pass it via options for full provenance)
+        const promptText = options.promptText ?? "";
+        // Detect content filtering / refusal
+        const hasRefusal = result.finishReason === "content-filter" ||
+            result.finishReason === "error";
+        const record = {
+            modelId: model,
+            modelHash: sha256Truncated(model),
+            promptHash: sha256Truncated(promptText),
+            responseHash: sha256Truncated(responseText),
+            latencyMs: elapsedMs,
+            inputTokens: result.usage?.promptTokens,
+            outputTokens: result.usage?.completionTokens,
+            guardrailsActive: 0,
+            guardrailsRequired: 0,
+            guardrailPassed: true,
+            hasRefusal,
+            provider: "vercel-ai",
+            guardrailNames: [],
+        };
+        witness.record(record);
+    };
+}
+//# sourceMappingURL=vercel-ai.js.map

package/dist/adapters/vercel-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.js","sourceRoot":"","sources":["../../src/adapters/vercel-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA+BpD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,UAAiC,EAAE;IAEnC,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAExC,OAAO,CAAC,MAA4B,EAAE,EAAE;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,KAAK,IAAI,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;QACrE,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAEvC,uDAAuD;QACvD,4DAA4D;QAC5D,iEAAiE;QACjE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;QAE5C,qCAAqC;QACrC,MAAM,UAAU,GACd,MAAM,CAAC,YAAY,KAAK,gBAAgB;YACxC,MAAM,CAAC,YAAY,KAAK,OAAO,CAAC;QAElC,MAAM,MAAM,GAAoB;YAC9B,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,eAAe,CAAC,KAAK,CAAC;YACjC,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC;YACvC,YAAY,EAAE,eAAe,CAAC,YAAY,CAAC;YAC3C,SAAS,EAAE,SAAS;YACpB,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY;YACvC,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,gBAAgB;YAC5C,gBAAgB,EAAE,CAAC;YACnB,kBAAkB,EAAE,CAAC;YACrB,eAAe,EAAE,IAAI;YACrB,UAAU;YACV,QAAQ,EAAE,WAAW;YACrB,cAAc,EAAE,EAAE;SACnB,CAAC;QAEF,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC;AACJ,CAAC"}

package/dist/buffer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SWT3 AI Witness SDK — Flush Buffer.
+ *
+ * Non-blocking buffer that collects witness payloads and flushes them
+ * to the /api/v1/witness/batch endpoint. Uses setTimeout for periodic
+ * flushing and a dead-letter array for resilience.
+ *
+ * Flight Recorder: When the endpoint is unreachable, payloads move to
+ * a dead-letter array and retry on the next cycle. Configurable cap
+ * prevents unbounded memory growth.
+ */
+import type { WitnessConfig, WitnessPayload, WitnessReceipt } from "./types.js";
+export declare class WitnessBuffer {
+    private config;
+    private queue;
+    private deadLetter;
+    private maxRetryBuffer;
+    private allReceipts;
+    private timer;
+    private stopped;
+    private consecutiveFailures;
+    constructor(config: WitnessConfig, maxRetryBuffer?: number);
+    /** Add a single payload to the buffer. */
+    enqueue(payload: WitnessPayload): void;
+    /** Add multiple payloads. */
+    enqueueMany(payloads: WitnessPayload[]): void;
+    /** Force-flush all buffered payloads. */
+    flush(): Promise<WitnessReceipt[]>;
+    /** Stop the buffer and flush remaining payloads. */
+    stop(): Promise<WitnessReceipt[]>;
+    /** Number of payloads waiting (includes dead-letter). */
+    get pending(): number;
+    /** Payloads in dead-letter queue awaiting retry. */
+    get deadLetterCount(): number;
+    /** All receipts from completed flushes. */
+    get receipts(): WitnessReceipt[];
+    private startTimer;
+    private flushInternal;
+    private sendBatch;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAI/F,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,mBAAmB,CAAK;gBAEpB,MAAM,EAAE,aAAa,EAAE,cAAc,SAA2B;IAM5E,0CAA0C;IAC1C,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAQtC,6BAA6B;IAC7B,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI;IAI7C,yCAAyC;IACnC,KAAK,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIxC,oDAAoD;IAC9C,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAgBvC,yDAAyD;IACzD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,oDAAoD;IACpD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,2CAA2C;IAC3C,IAAI,QAAQ,IAAI,cAAc,EAAE,CAE/B;IAED,OAAO,CAAC,UAAU;YAYJ,aAAa;YAWb,SAAS;CA+ExB"}

package/dist/buffer.js

@@ -0,0 +1,154 @@
+/**
+ * SWT3 AI Witness SDK — Flush Buffer.
+ *
+ * Non-blocking buffer that collects witness payloads and flushes them
+ * to the /api/v1/witness/batch endpoint. Uses setTimeout for periodic
+ * flushing and a dead-letter array for resilience.
+ *
+ * Flight Recorder: When the endpoint is unreachable, payloads move to
+ * a dead-letter array and retry on the next cycle. Configurable cap
+ * prevents unbounded memory growth.
+ */
+const DEFAULT_MAX_RETRY_BUFFER = 5000;
+export class WitnessBuffer {
+    config;
+    queue = [];
+    deadLetter = [];
+    maxRetryBuffer;
+    allReceipts = [];
+    timer = null;
+    stopped = false;
+    consecutiveFailures = 0;
+    constructor(config, maxRetryBuffer = DEFAULT_MAX_RETRY_BUFFER) {
+        this.config = config;
+        this.maxRetryBuffer = maxRetryBuffer;
+        this.startTimer();
+    }
+    /** Add a single payload to the buffer. */
+    enqueue(payload) {
+        if (this.stopped)
+            return;
+        this.queue.push(payload);
+        if (this.queue.length >= this.config.bufferSize) {
+            this.flushInternal();
+        }
+    }
+    /** Add multiple payloads. */
+    enqueueMany(payloads) {
+        for (const p of payloads)
+            this.enqueue(p);
+    }
+    /** Force-flush all buffered payloads. */
+    async flush() {
+        return this.flushInternal();
+    }
+    /** Stop the buffer and flush remaining payloads. */
+    async stop() {
+        if (this.stopped)
+            return [];
+        this.stopped = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        const receipts = await this.flushInternal();
+        if (this.deadLetter.length > 0) {
+            console.warn(`[swt3-ai] Buffer stopped with ${this.deadLetter.length} payloads in dead-letter queue`);
+        }
+        return receipts;
+    }
+    /** Number of payloads waiting (includes dead-letter). */
+    get pending() {
+        return this.queue.length + this.deadLetter.length;
+    }
+    /** Payloads in dead-letter queue awaiting retry. */
+    get deadLetterCount() {
+        return this.deadLetter.length;
+    }
+    /** All receipts from completed flushes. */
+    get receipts() {
+        return [...this.allReceipts];
+    }
+    startTimer() {
+        if (this.stopped)
+            return;
+        this.timer = setTimeout(() => {
+            this.flushInternal().catch(() => { });
+            this.startTimer();
+        }, this.config.flushInterval * 1000);
+        // Unref so the timer doesn't keep the process alive
+        if (typeof this.timer === "object" && "unref" in this.timer) {
+            this.timer.unref();
+        }
+    }
+    async flushInternal() {
+        // Drain queue
+        const payloads = [...this.deadLetter, ...this.queue];
+        this.deadLetter = [];
+        this.queue = [];
+        if (payloads.length === 0)
+            return [];
+        return this.sendBatch(payloads);
+    }
+    async sendBatch(payloads) {
+        if (payloads.length === 0)
+            return [];
+        const url = `${this.config.endpoint}/api/v1/witness/batch`;
+        const body = JSON.stringify({ witnesses: payloads });
+        const headers = {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.config.apiKey}`,
+        };
+        let lastError = null;
+        for (let attempt = 0; attempt < this.config.maxRetries; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+                const resp = await fetch(url, {
+                    method: "POST",
+                    headers,
+                    body,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (resp.status >= 400 && resp.status < 500) {
+                    // Client error — don't retry, don't dead-letter
+                    const text = await resp.text();
+                    console.error(`[swt3-ai] Batch flush failed (${resp.status}): ${text.slice(0, 200)}`);
+                    return [];
+                }
+                const result = (await resp.json());
+                const receipts = result.receipts ?? [];
+                this.allReceipts.push(...receipts);
+                this.consecutiveFailures = 0;
+                if (result.rejected > 0) {
+                    console.warn(`[swt3-ai] Batch flush: ${result.accepted} accepted, ${result.rejected} rejected`);
+                }
+                return receipts;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err.message : String(err);
+                console.warn(`[swt3-ai] Batch flush attempt ${attempt + 1} failed: ${lastError}`);
+                // Exponential backoff: 1s, 2s, 4s
+                if (attempt < this.config.maxRetries - 1) {
+                    await new Promise((r) => setTimeout(r, 2 ** attempt * 1000));
+                }
+            }
+        }
+        // All retries exhausted — move to dead-letter queue
+        this.consecutiveFailures++;
+        const before = this.deadLetter.length;
+        this.deadLetter.push(...payloads);
+        // Cap the dead-letter queue
+        if (this.deadLetter.length > this.maxRetryBuffer) {
+            const dropped = this.deadLetter.length - this.maxRetryBuffer;
+            this.deadLetter = this.deadLetter.slice(dropped);
+            console.error(`[swt3-ai] Dead-letter queue full: ${dropped} oldest payloads dropped (cap: ${this.maxRetryBuffer})`);
+        }
+        else {
+            console.warn(`[swt3-ai] Endpoint unreachable — ${payloads.length} payloads moved to dead-letter (total: ${this.deadLetter.length}). Error: ${lastError}`);
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=buffer.js.map

package/dist/buffer.js.map

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

package/dist/clearing.d.ts

@@ -0,0 +1,20 @@
+/**
+ * SWT3 AI Witness SDK — Clearing Engine (Levels 0-3).
+ *
+ * The "Sovereign Wire" protocol: controls what leaves the developer's
+ * infrastructure. Raw prompts/responses NEVER appear in payloads.
+ * Clearing operates on the wire payload, not the developer's response.
+ *
+ * Level 0 — Analytics:   All metadata
+ * Level 1 — Standard:    Hashes + model_id + ai_context
+ * Level 2 — Sensitive:   Hashes + model_id only. ai_context DELETED.
+ * Level 3 — Classified:  Factors only. model_id hashed. Everything else DELETED.
+ */
+import type { InferenceRecord, WitnessPayload } from "./types.js";
+/**
+ * Extract witness payloads from an inference record.
+ * Applies clearing level to each payload via object destructuring (Level 2+
+ * fields are simply never assigned, guaranteeing they don't exist on the wire).
+ */
+export declare function extractPayloads(record: InferenceRecord, tenantId: string, clearingLevel: 0 | 1 | 2 | 3, latencyThresholdMs?: number, guardrailsRequired?: number, procedures?: string[]): WitnessPayload[];
+//# sourceMappingURL=clearing.d.ts.map

package/dist/clearing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clearing.d.ts","sourceRoot":"","sources":["../src/clearing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAC5B,kBAAkB,GAAE,MAAc,EAClC,kBAAkB,GAAE,MAAU,EAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,cAAc,EAAE,CA6FlB"}