@tenova/swt3-ai 0.3.4 → 0.4.1

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,43 @@
+/**
+ * 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;
+    private ctaShown;
+    private onFlush?;
+    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;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAC,CAAmE;gBAEvE,MAAM,EAAE,aAAa,EAAE,cAAc,SAA2B;IAO5E,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;CAiGxB"}

package/dist/buffer.js

@@ -0,0 +1,172 @@
+/**
+ * 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;
+    ctaShown = false;
+    onFlush;
+    constructor(config, maxRetryBuffer = DEFAULT_MAX_RETRY_BUFFER) {
+        this.config = config;
+        this.maxRetryBuffer = maxRetryBuffer;
+        this.onFlush = config.onFlush;
+        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`);
+                }
+                if (!this.ctaShown && (result.accepted ?? 0) > 0) {
+                    this.ctaShown = true;
+                    console.info(`\n  [SWT3] ${result.accepted} anchors delivered to ${this.config.endpoint}` +
+                        `\n  [SWT3] Dashboard & audit reports \u2192 https://sovereign.tenova.io/signup?ref=sdk` +
+                        `\n  [SWT3] EU AI Act high-risk deadline: Dec 2, 2027. GPAI obligations enforceable now.\n`);
+                }
+                // Invoke on_flush callback (never let callback errors break the pipeline)
+                if (this.onFlush && receipts.length > 0) {
+                    try {
+                        this.onFlush(payloads, receipts);
+                    }
+                    catch (cbErr) {
+                        console.warn(`[swt3-ai] onFlush callback error (non-fatal):`, cbErr);
+                    }
+                }
+                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,39 @@
+/**
+ * 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[], agentId?: string, signingKey?: string, cycleId?: string, policyVersionHash?: string, jurisdiction?: string, legalBasis?: string, purposeClass?: string, authorizationId?: string): WitnessPayload[];
+/**
+ * Mint an AI-GRD.3 (Gatekeeper Gate) payload.
+ *
+ * factor_a = required guardrail count
+ * factor_b = actual guardrail count at call time
+ * factor_c = 1 if gate passed, 0 if blocked
+ * Verdict: PASS if b >= a AND c == 1
+ */
+export declare function extractGatekeeperPayload(tenantId: string, required: number, active: number, gatePassed: boolean, clearingLevel: 0 | 1 | 2 | 3, agentId?: string, signingKey?: string, cycleId?: string, policyVersionHash?: string, jurisdiction?: string, legalBasis?: string, purposeClass?: string): WitnessPayload;
+/** Revocation reason code mapping. */
+export declare const REVOCATION_REASONS: Record<string, number>;
+/**
+ * Mint an AI-REV.1 (Anchor Revocation) payload.
+ *
+ * factor_a = 1 (revocation event occurred)
+ * factor_b = 1 (target declared valid by caller)
+ * factor_c = reason code (integer from REVOCATION_REASONS)
+ */
+export declare function extractRevocationPayload(tenantId: string, targetFingerprint: string, reason: string, clearingLevel: 0 | 1 | 2 | 3, agentId?: string, signingKey?: string, cycleId?: string, policyVersionHash?: string, jurisdiction?: string, legalBasis?: string, purposeClass?: 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;AAIH,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,EACrB,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,cAAc,EAAE,CA8MlB;AAoFD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,OAAO,EACnB,aAAa,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAC5B,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CAqBhB;AAED,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQrD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAC5B,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CAwBhB"}