@tenova/swt3-ai 0.3.4 → 0.3.5

package/dist/adapters/bedrock.js

@@ -0,0 +1,267 @@
+/**
+ * SWT3 AI Witness SDK — AWS Bedrock Adapter (ES6 Proxy).
+ *
+ * Wraps the @aws-sdk/client-bedrock-runtime client so that
+ * `client.send(new ConverseCommand(...))` and
+ * `client.send(new InvokeModelCommand(...))` are intercepted.
+ *
+ * AWS Bedrock uses the Command pattern:
+ *   const response = await client.send(new ConverseCommand({ modelId, messages }));
+ *
+ * The adapter intercepts `send()` and checks if the command is a
+ * ConverseCommand or InvokeModelCommand to extract factors.
+ *
+ * Copyright (c) 2026 Tenable Nova LLC. Apache 2.0. Patent pending.
+ */
+import { sha256Truncated } from "../fingerprint.js";
+/**
+ * Wrap a BedrockRuntimeClient with transparent witnessing.
+ *
+ * Usage:
+ *   import { BedrockRuntimeClient, ConverseCommand } from "@aws-sdk/client-bedrock-runtime";
+ *   import { Witness } from "@tenova/swt3-ai";
+ *
+ *   const witness = new Witness({ endpoint, apiKey, tenantId });
+ *   const client = witness.wrap(new BedrockRuntimeClient({ region: "us-east-1" }));
+ *
+ *   const response = await client.send(new ConverseCommand({
+ *     modelId: "anthropic.claude-3-5-sonnet-20241022-v2:0",
+ *     messages: [{ role: "user", content: [{ text: "Hello" }] }],
+ *   }));
+ */
+export function wrapBedrock(client, witness) {
+    return new Proxy(client, {
+        get(target, prop) {
+            if (typeof prop === "symbol")
+                return Reflect.get(target, prop);
+            const real = Reflect.get(target, prop);
+            if (prop === "send" && typeof real === "function") {
+                return createSendInterceptor(real, witness, target);
+            }
+            return real;
+        },
+    });
+}
+function createSendInterceptor(realSend, witness, thisArg) {
+    return async function interceptedSend(...args) {
+        const command = args[0];
+        if (!command)
+            return realSend.call(thisArg, ...args);
+        // Detect command type by constructor name
+        const commandName = command.constructor?.name ?? "";
+        if (commandName === "ConverseCommand") {
+            return handleConverse(realSend, thisArg, command, witness, args);
+        }
+        if (commandName === "InvokeModelCommand") {
+            return handleInvokeModel(realSend, thisArg, command, witness, args);
+        }
+        // Not a command we intercept — pass through
+        return realSend.call(thisArg, ...args);
+    };
+}
+// ── Converse Command Handler ──────────────────────────────────────
+async function handleConverse(realSend, thisArg, command, witness, args) {
+    const input = command.input ?? command;
+    const modelId = input.modelId ?? "unknown";
+    const messages = input.messages ?? [];
+    const promptText = extractConversePrompt(messages);
+    const promptHash = sha256Truncated(promptText);
+    // Gatekeeper pre-call check (strict mode only)
+    if (witness.strict) {
+        witness.gateCheck(messages, modelId);
+    }
+    const start = performance.now();
+    const response = await realSend.call(thisArg, ...args);
+    const elapsedMs = Math.round(performance.now() - start);
+    const resp = response;
+    const record = extractConverseRecord(resp, modelId, promptHash, elapsedMs);
+    witness.record(record);
+    return response;
+}
+// ── InvokeModel Command Handler ──────────────────────────────────
+async function handleInvokeModel(realSend, thisArg, command, witness, args) {
+    const input = command.input ?? command;
+    const modelId = input.modelId ?? "unknown";
+    // Parse the body to get prompt
+    let body = {};
+    const rawBody = input.body;
+    if (typeof rawBody === "string") {
+        try {
+            body = JSON.parse(rawBody);
+        }
+        catch { /* empty */ }
+    }
+    else if (rawBody instanceof Uint8Array) {
+        try {
+            body = JSON.parse(new TextDecoder().decode(rawBody));
+        }
+        catch { /* empty */ }
+    }
+    const promptText = extractInvokePrompt(body, modelId);
+    const promptHash = sha256Truncated(promptText);
+    // Gatekeeper pre-call check (strict mode only)
+    if (witness.strict) {
+        witness.gateCheck(body, modelId);
+    }
+    const start = performance.now();
+    const response = await realSend.call(thisArg, ...args);
+    const elapsedMs = Math.round(performance.now() - start);
+    const resp = response;
+    const record = extractInvokeRecord(resp, modelId, promptHash, elapsedMs);
+    witness.record(record);
+    return response;
+}
+// ── Prompt Extraction ─────────────────────────────────────────────
+function extractConversePrompt(messages) {
+    const parts = [];
+    for (const msg of messages) {
+        const m = msg;
+        const content = m.content;
+        if (Array.isArray(content)) {
+            for (const block of content) {
+                const b = block;
+                if (b.text)
+                    parts.push(b.text);
+            }
+        }
+        else if (typeof content === "string") {
+            parts.push(content);
+        }
+    }
+    return parts.join("\n");
+}
+function extractInvokePrompt(body, modelId) {
+    // Anthropic on Bedrock
+    const messages = body.messages;
+    if (messages?.length) {
+        const parts = [];
+        for (const msg of messages) {
+            const m = msg;
+            const content = m.content;
+            if (typeof content === "string") {
+                parts.push(content);
+            }
+            else if (Array.isArray(content)) {
+                for (const block of content) {
+                    const b = block;
+                    if (b.type === "text" && b.text)
+                        parts.push(b.text);
+                }
+            }
+        }
+        if (parts.length)
+            return parts.join("\n");
+    }
+    // Amazon Titan
+    if (body.inputText)
+        return body.inputText;
+    // Meta Llama
+    if (body.prompt)
+        return body.prompt;
+    return JSON.stringify(body);
+}
+// ── Record Extraction ─────────────────────────────────────────────
+function extractConverseRecord(response, modelId, promptHash, elapsedMs) {
+    let responseText = "";
+    let hasRefusal = false;
+    const output = response.output;
+    const message = output?.message;
+    const content = message?.content;
+    if (content) {
+        for (const block of content) {
+            if (block.text)
+                responseText += block.text;
+        }
+    }
+    const stopReason = response.stopReason;
+    if (stopReason === "content_filtered")
+        hasRefusal = true;
+    const usage = response.usage;
+    const inputTokens = usage?.inputTokens;
+    const outputTokens = usage?.outputTokens;
+    return {
+        modelId: modelId,
+        modelHash: sha256Truncated(modelId),
+        promptHash: promptHash,
+        responseHash: sha256Truncated(responseText || ""),
+        latencyMs: elapsedMs,
+        inputTokens: inputTokens ?? undefined,
+        outputTokens: outputTokens ?? undefined,
+        hasRefusal: hasRefusal,
+        provider: "bedrock",
+        systemFingerprint: undefined,
+        guardrailsActive: 0,
+        guardrailsRequired: 0,
+        guardrailPassed: true,
+        guardrailNames: [],
+    };
+}
+function extractInvokeRecord(response, modelId, promptHash, elapsedMs) {
+    let responseText = "";
+    let hasRefusal = false;
+    let inputTokens = null;
+    let outputTokens = null;
+    try {
+        let body = {};
+        const rawBody = response.body;
+        if (rawBody instanceof Uint8Array) {
+            body = JSON.parse(new TextDecoder().decode(rawBody));
+        }
+        else if (typeof rawBody === "string") {
+            body = JSON.parse(rawBody);
+        }
+        // Anthropic on Bedrock
+        if (body.content) {
+            const content = body.content;
+            if (Array.isArray(content)) {
+                for (const block of content) {
+                    if (block.type === "text" && block.text)
+                        responseText += block.text;
+                }
+            }
+            else if (typeof content === "string") {
+                responseText = content;
+            }
+        }
+        // Amazon Titan
+        else if (body.results) {
+            const results = body.results;
+            if (results[0]?.outputText)
+                responseText = results[0].outputText;
+        }
+        // Meta Llama
+        else if (body.generation) {
+            responseText = body.generation;
+        }
+        // Usage
+        const usage = body.usage;
+        if (usage) {
+            inputTokens = (usage.input_tokens ?? usage.inputTokens ?? null);
+            outputTokens = (usage.output_tokens ?? usage.outputTokens ?? null);
+        }
+        // Refusal
+        const stopReason = (body.stop_reason ?? body.stopReason ?? "");
+        if (stopReason.toLowerCase().includes("content_filter"))
+            hasRefusal = true;
+    }
+    catch {
+        // Parse failure — still witness with what we have
+    }
+    return {
+        modelId: modelId,
+        modelHash: sha256Truncated(modelId),
+        promptHash: promptHash,
+        responseHash: sha256Truncated(responseText || ""),
+        latencyMs: elapsedMs,
+        inputTokens: inputTokens ?? undefined,
+        outputTokens: outputTokens ?? undefined,
+        hasRefusal: hasRefusal,
+        provider: "bedrock",
+        systemFingerprint: undefined,
+        guardrailsActive: 0,
+        guardrailsRequired: 0,
+        guardrailPassed: true,
+        guardrailNames: [],
+    };
+}
+//# sourceMappingURL=bedrock.js.map

package/dist/adapters/bedrock.js.map

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

package/dist/adapters/openai.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 type { Witness } from "../witness.js";
+/**
+ * Wrap an OpenAI client with an ES6 Proxy for transparent witnessing.
+ */
+export declare function wrapOpenAI(client: unknown, witness: Witness): unknown;
+//# sourceMappingURL=openai.d.ts.map

package/dist/adapters/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/adapters/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAU7C;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAErE"}

package/dist/adapters/openai.js

@@ -0,0 +1,288 @@
+/**
+ * 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);
+        // Hash system prompt separately (instruction drift detection)
+        const systemPromptText = extractSystemPrompt(messages);
+        const systemPromptHash = systemPromptText ? sha256Truncated(systemPromptText) : undefined;
+        // Gatekeeper pre-call check (strict mode only)
+        if (witness.strict) {
+            witness.gateCheck(messages, model);
+        }
+        // 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, systemPromptHash);
+        }
+        // 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, systemPromptHash);
+            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, systemPromptHash) {
+    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,
+        systemPromptHash,
+        guardrailNames: [],
+    };
+    witness.record(record);
+}
+function handleStreaming(streamResult, witness, model, promptHash, startTime, systemPromptHash) {
+    // 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, systemPromptHash);
+        });
+    }
+    // Direct stream object (shouldn't happen but handle gracefully)
+    return wrapStream(streamResult, witness, model, promptHash, startTime, systemPromptHash);
+}
+function wrapStream(stream, witness, model, promptHash, startTime, systemPromptHash) {
+    const s = stream;
+    // Create the accumulating async generator
+    const gen = streamAccumulator(s, witness, model, promptHash, startTime, systemPromptHash);
+    // 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 extractSystemPrompt(messages) {
+    if (!Array.isArray(messages))
+        return undefined;
+    const parts = [];
+    for (const msg of messages) {
+        if (typeof msg === "object" && msg !== null) {
+            const m = msg;
+            if (m.role !== "system")
+                continue;
+            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.length > 0 ? parts.join("\n") : undefined;
+}
+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, systemPromptHash) {
+    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,
+        systemPromptHash,
+        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