truthguard-ai 0.1.0

package/dist-npm/SDK/anthropic.js

@@ -0,0 +1,425 @@
+"use strict";
+/**
+ * ai-rcp Anthropic SDK Wrapper
+ *
+ * Wraps an Anthropic client to automatically capture tool-calling traces
+ * and run them through the grounding pipeline.
+ *
+ * @example
+ * ```ts
+ * import Anthropic from '@anthropic-ai/sdk';
+ * import { wrapAnthropic } from 'ai-rcp';
+ *
+ * const client = wrapAnthropic(new Anthropic(), {
+ *   mode: 'warn',
+ *   threshold: 0.8,
+ *   onEvaluate: (report) => console.log('Score:', report.groundingScore),
+ * });
+ *
+ * // Use exactly like the normal Anthropic client
+ * const response = await client.messages.create({
+ *   model: 'claude-sonnet-4-20250514',
+ *   max_tokens: 1024,
+ *   messages: [{ role: 'user', content: 'What appointments do I have?' }],
+ *   tools: [...],
+ * });
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroundingError = void 0;
+exports.buildTraceFromAnthropic = buildTraceFromAnthropic;
+exports.buildErrorTrace = buildErrorTrace;
+exports.wrapAnthropic = wrapAnthropic;
+const openai_1 = require("./openai");
+Object.defineProperty(exports, "GroundingError", { enumerable: true, get: function () { return openai_1.GroundingError; } });
+// ---------------------------------------------------------------------------
+// Trace builder
+// ---------------------------------------------------------------------------
+let traceCounter = 0;
+function extractTextContent(content) {
+    if (!content)
+        return '';
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .filter((b) => b.type === 'text' && b.text)
+        .map((b) => b.text)
+        .join('\n');
+}
+/**
+ * Build a TruthGuard Trace from Anthropic messages and response.
+ */
+function buildTraceFromAnthropic(messages, systemPrompt, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+response) {
+    const traceId = `anthropic-${Date.now()}-${++traceCounter}`;
+    try {
+        return _buildTraceInner(traceId, messages, systemPrompt, response);
+    }
+    catch (e) {
+        return {
+            traceId,
+            steps: [{
+                    stepId: 'step-error',
+                    role: 'final_response',
+                    content: `[TruthGuard Trace Error] ${e instanceof Error ? e.message : String(e)}`,
+                    metadata: { traceError: true },
+                }],
+            startedAt: new Date().toISOString(),
+            metadata: { provider: 'anthropic', traceError: true },
+        };
+    }
+}
+function _buildTraceInner(traceId, messages, systemPrompt, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+response) {
+    const steps = [];
+    let stepCounter = 0;
+    // Build tool_use_id → name map
+    const toolUseIdToName = new Map();
+    for (const msg of messages) {
+        if (msg.role === 'assistant' && Array.isArray(msg.content)) {
+            for (const block of msg.content) {
+                if (block.type === 'tool_use' && block.id && block.name) {
+                    toolUseIdToName.set(block.id, block.name);
+                }
+            }
+        }
+    }
+    // System prompt
+    if (systemPrompt) {
+        const text = typeof systemPrompt === 'string'
+            ? systemPrompt
+            : systemPrompt.map(s => s.text).join('\n');
+        if (text.trim()) {
+            steps.push({ stepId: `step-${++stepCounter}`, role: 'system_prompt', content: text });
+        }
+    }
+    // Parse messages
+    for (const msg of messages) {
+        if (msg.role === 'user') {
+            if (typeof msg.content === 'string') {
+                steps.push({ stepId: `step-${++stepCounter}`, role: 'user_input', content: msg.content });
+            }
+            else if (Array.isArray(msg.content)) {
+                // User message may contain text blocks and tool_result blocks
+                for (const block of msg.content) {
+                    if (block.type === 'text' && block.text) {
+                        steps.push({ stepId: `step-${++stepCounter}`, role: 'user_input', content: block.text });
+                    }
+                    else if (block.type === 'tool_result') {
+                        const toolName = block.tool_use_id ? (toolUseIdToName.get(block.tool_use_id) ?? 'unknown') : 'unknown';
+                        const outputText = extractTextContent(block.content);
+                        let output = outputText;
+                        try {
+                            output = JSON.parse(outputText);
+                        }
+                        catch { /* keep string */ }
+                        steps.push({
+                            stepId: `step-${++stepCounter}`,
+                            role: 'tool_output',
+                            content: outputText,
+                            toolOutputs: [{ toolName, output }],
+                        });
+                    }
+                }
+            }
+        }
+        else if (msg.role === 'assistant') {
+            if (typeof msg.content === 'string') {
+                steps.push({ stepId: `step-${++stepCounter}`, role: 'final_response', content: msg.content });
+            }
+            else if (Array.isArray(msg.content)) {
+                for (const block of msg.content) {
+                    if (block.type === 'tool_use') {
+                        steps.push({
+                            stepId: `step-${++stepCounter}`,
+                            role: 'tool_call',
+                            content: '',
+                            toolCalls: [{ toolName: block.name ?? 'unknown', parameters: block.input ?? {} }],
+                        });
+                        // Track ID→name for tool_result resolution
+                        if (block.id && block.name) {
+                            toolUseIdToName.set(block.id, block.name);
+                        }
+                    }
+                    else if (block.type === 'text' && block.text) {
+                        steps.push({ stepId: `step-${++stepCounter}`, role: 'final_response', content: block.text });
+                    }
+                }
+            }
+        }
+    }
+    // Add response content
+    if (response?.content) {
+        const content = response.content;
+        for (const block of content) {
+            if (block.type === 'tool_use') {
+                steps.push({
+                    stepId: `step-${++stepCounter}`,
+                    role: 'tool_call',
+                    content: '',
+                    toolCalls: [{ toolName: block.name ?? 'unknown', parameters: block.input ?? {} }],
+                });
+            }
+            else if (block.type === 'text' && block.text) {
+                steps.push({
+                    stepId: `step-${++stepCounter}`,
+                    role: 'final_response',
+                    content: block.text,
+                    ...(response.usage ? {
+                        tokens: {
+                            prompt: response.usage.input_tokens,
+                            completion: response.usage.output_tokens,
+                            total: (response.usage.input_tokens ?? 0) + (response.usage.output_tokens ?? 0),
+                            ...(response.stop_reason ? { finishReason: response.stop_reason } : {}),
+                        },
+                    } : {}),
+                });
+            }
+        }
+    }
+    return {
+        traceId,
+        steps,
+        startedAt: new Date().toISOString(),
+        metadata: {
+            provider: 'anthropic',
+            model: response?.model,
+        },
+    };
+}
+/**
+ * Build an error trace from Anthropic messages when the API call fails.
+ */
+function buildErrorTrace(messages, systemPrompt, error) {
+    const traceId = `anthropic-err-${Date.now()}-${++traceCounter}`;
+    const steps = [];
+    let stepCounter = 0;
+    // System prompt
+    if (systemPrompt) {
+        const text = typeof systemPrompt === 'string'
+            ? systemPrompt
+            : systemPrompt.map(s => s.text).join('\n');
+        if (text.trim()) {
+            steps.push({ stepId: `step-${++stepCounter}`, role: 'system_prompt', content: text });
+        }
+    }
+    // User input
+    if (Array.isArray(messages)) {
+        for (const msg of messages) {
+            if (msg.role === 'user') {
+                const text = extractTextContent(typeof msg.content === 'string' ? msg.content : msg.content);
+                if (text.trim()) {
+                    steps.push({ stepId: `step-${++stepCounter}`, role: 'user_input', content: text });
+                    break;
+                }
+            }
+        }
+    }
+    // Error as final response
+    const errMsg = error instanceof Error ? error.message : String(error);
+    const errName = error instanceof Error ? error.name : 'UnknownError';
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const statusCode = error?.status ?? error?.statusCode;
+    steps.push({
+        stepId: `step-${++stepCounter}`,
+        role: 'final_response',
+        content: `[API Error] ${errName}: ${errMsg}`,
+        metadata: {
+            apiError: true,
+            errorType: errName,
+            errorMessage: errMsg,
+            ...(statusCode ? { statusCode } : {}),
+        },
+    });
+    return {
+        traceId,
+        steps,
+        startedAt: new Date().toISOString(),
+        metadata: {
+            provider: 'anthropic',
+            apiError: true,
+        },
+    };
+}
+function buildEvaluator(options, mode) {
+    if (options.client) {
+        const client = options.client;
+        const threshold = options.threshold;
+        return async (trace) => {
+            const result = await client.evaluate(trace, { mode, threshold });
+            options.onEvaluate?.(result.report, trace);
+            return result;
+        };
+    }
+    if (options._pipeline) {
+        const pipeline = options._pipeline;
+        return async (trace) => {
+            const result = await pipeline.evaluate(trace);
+            options.onEvaluate?.(result.report, trace);
+            return result;
+        };
+    }
+    let lazyPipeline = null;
+    return async (trace) => {
+        if (!lazyPipeline) {
+            try {
+                const { Pipeline } = await Promise.resolve().then(() => __importStar(require('../Mode')));
+                lazyPipeline = new Pipeline({ ...options, mode });
+            }
+            catch {
+                throw new Error('TruthGuard: No evaluation backend available. ' +
+                    'Provide a `client` option (TruthGuardClient) for remote evaluation, ' +
+                    'or install the full engine for local evaluation.');
+            }
+        }
+        const result = await lazyPipeline.evaluate(trace);
+        options.onEvaluate?.(result.report, trace);
+        return result;
+    };
+}
+// ---------------------------------------------------------------------------
+// SDK Wrapper
+// ---------------------------------------------------------------------------
+/**
+ * Wraps an Anthropic client instance to auto-capture traces and evaluate grounding.
+ *
+ * Returns a proxy that intercepts `client.messages.create()`.
+ * All other methods pass through unchanged.
+ *
+ * @example
+ * ```ts
+ * import Anthropic from '@anthropic-ai/sdk';
+ * import { wrapAnthropic } from 'ai-rcp';
+ *
+ * const client = wrapAnthropic(new Anthropic(), { mode: 'observe' });
+ *
+ * const response = await client.messages.create({
+ *   model: 'claude-sonnet-4-20250514',
+ *   max_tokens: 1024,
+ *   messages,
+ *   tools,
+ * });
+ * ```
+ */
+function wrapAnthropic(client, options = {}) {
+    const mode = options.mode ?? 'observe';
+    const shouldBlock = mode === 'block';
+    const awaitEval = options.awaitEvaluation ?? shouldBlock;
+    const evaluator = buildEvaluator(options, mode);
+    // Intercept: client.messages.create()
+    return new Proxy(client, {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        get(target, prop) {
+            if (prop === 'messages') {
+                return new Proxy(target.messages, {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    get(messagesTarget, messagesProp) {
+                        if (messagesProp === 'create') {
+                            return async function wrappedCreate(
+                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                            params, 
+                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                            ...rest) {
+                                let response;
+                                let apiError;
+                                try {
+                                    response = await messagesTarget.create.call(messagesTarget, params, ...rest);
+                                }
+                                catch (err) {
+                                    apiError = err;
+                                }
+                                const messages = params.messages ?? [];
+                                const systemPrompt = params.system;
+                                // Check if the conversation involves tool usage
+                                const hasToolContext = messages.some((m) => {
+                                    if (m.role === 'assistant' && Array.isArray(m.content)) {
+                                        return m.content.some(b => b.type === 'tool_use');
+                                    }
+                                    if (m.role === 'user' && Array.isArray(m.content)) {
+                                        return m.content.some(b => b.type === 'tool_result');
+                                    }
+                                    return false;
+                                });
+                                if (apiError) {
+                                    if (hasToolContext) {
+                                        const trace = buildErrorTrace(messages, systemPrompt, apiError);
+                                        if (awaitEval) {
+                                            const result = await evaluator(trace);
+                                            options.onResult?.(result, trace);
+                                        }
+                                        else {
+                                            evaluator(trace).then((result) => options.onResult?.(result, trace), () => { });
+                                        }
+                                    }
+                                    throw apiError;
+                                }
+                                // Detect final response: no tool_use blocks in response
+                                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                                const resp = response;
+                                const responseContent = resp?.content;
+                                const responseHasToolUse = Array.isArray(responseContent)
+                                    && responseContent.some(b => b.type === 'tool_use');
+                                const isFinalResponse = resp && !responseHasToolUse
+                                    && (resp.stop_reason === 'end_turn' || resp.stop_reason === 'max_tokens');
+                                if (hasToolContext && isFinalResponse) {
+                                    const trace = buildTraceFromAnthropic(messages, systemPrompt, response);
+                                    if (awaitEval) {
+                                        const result = await evaluator(trace);
+                                        options.onResult?.(result, trace);
+                                        if (shouldBlock && !result.allowed) {
+                                            throw new openai_1.GroundingError(result.fallbackResponse ?? 'Response blocked due to low grounding score', result.report, trace);
+                                        }
+                                    }
+                                    else {
+                                        evaluator(trace).then((result) => options.onResult?.(result, trace), () => { });
+                                    }
+                                }
+                                return response;
+                            };
+                        }
+                        return messagesTarget[messagesProp];
+                    },
+                });
+            }
+            return target[prop];
+        },
+    });
+}
+//# sourceMappingURL=anthropic.js.map

package/dist-npm/SDK/anthropic.js.map

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

package/dist-npm/SDK/openai.d.ts

@@ -0,0 +1,164 @@
+/**
+ * ai-rcp OpenAI SDK Wrapper
+ *
+ * Wraps an OpenAI client to automatically capture tool-calling traces
+ * and run them through the grounding pipeline.
+ *
+ * This is the "zero-config" integration: import, wrap, and you get
+ * grounding evaluation on every tool-calling conversation.
+ *
+ * @example
+ * ```ts
+ * import OpenAI from 'openai';
+ * import { wrapOpenAI } from 'ai-rcp';
+ *
+ * const openai = wrapOpenAI(new OpenAI(), {
+ *   mode: 'warn',
+ *   threshold: 0.8,
+ *   onEvaluate: (report) => console.log('Score:', report.groundingScore),
+ * });
+ *
+ * // Use exactly like the normal OpenAI client
+ * const response = await openai.chat.completions.create({
+ *   model: 'gpt-4',
+ *   messages: [{ role: 'user', content: 'What appointments do I have?' }],
+ *   tools: [...],
+ * });
+ *
+ * // ai-rcp has already evaluated the trace in the background.
+ * // In 'block' mode, a GroundingError is thrown if the score is too low.
+ * ```
+ */
+import type { Trace, GroundingReport } from '../types';
+import type { TruthGuardClient } from '../Client';
+/** Operating mode. */
+export type WrapMode = 'observe' | 'warn' | 'block' | 'debug' | 'ci';
+/** Result returned after evaluation (thin-client compatible). */
+export interface WrapPipelineResult {
+    report: GroundingReport;
+    allowed: boolean;
+    fallbackResponse?: string;
+}
+export interface WrapOpenAIOptions {
+    /** Operating mode. Default: 'observe'. */
+    mode?: WrapMode;
+    /** Score threshold for block/warn decisions. Default: 0.75. */
+    threshold?: number;
+    /**
+     * TruthGuard client for remote evaluation (thin-client mode).
+     * When provided, traces are sent to the server for evaluation.
+     * When omitted, falls back to local Pipeline evaluation (server-side only).
+     */
+    client?: TruthGuardClient;
+    /**
+     * Local Pipeline instance for server-side evaluation.
+     * Only used when `client` is not provided. Set internally by the full engine.
+     * @internal
+     */
+    _pipeline?: {
+        evaluate(trace: Trace): Promise<WrapPipelineResult>;
+    };
+    /**
+     * When true, blocks the response until grounding evaluation completes.
+     * When false (default), evaluation runs async and doesn't delay the response.
+     * Automatically set to true for 'block' mode.
+     */
+    awaitEvaluation?: boolean;
+    /**
+     * Called with the evaluation result after each tool-calling conversation.
+     * Useful for logging or metrics.
+     */
+    onResult?: (result: WrapPipelineResult, trace: Trace) => void;
+    /**
+     * Callback when a response is blocked (block mode only).
+     * Return a fallback response string, or null to use the default.
+     */
+    onBlock?: (report: GroundingReport) => string | null;
+    /**
+     * Callback fired after every evaluation (all modes).
+     */
+    onEvaluate?: (report: GroundingReport, trace: Trace) => void;
+}
+/**
+ * Error thrown in block mode when a response fails grounding.
+ */
+export declare class GroundingError extends Error {
+    readonly report: GroundingReport;
+    readonly trace: Trace;
+    constructor(message: string, report: GroundingReport, trace: Trace);
+}
+interface ChatMessage {
+    role: string;
+    content?: string | null;
+    tool_calls?: Array<{
+        id: string;
+        type: string;
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    tool_call_id?: string;
+    name?: string;
+}
+/**
+ * Build an ai-rcp Trace from the OpenAI messages array and the final response.
+ */
+export declare function buildTraceFromOpenAI(messages: ChatMessage[], response: any): Trace;
+/**
+ * Build an ai-rcp Trace when the OpenAI API call fails (rate limit, timeout, etc.).
+ * Records the conversation context + the error so TruthGuard can still evaluate
+ * whatever fallback response the caller surfaces to the user.
+ */
+export declare function buildErrorTrace(messages: ChatMessage[], error: unknown): Trace;
+export interface ReportUnavailableOptions {
+    /** The user's question that was not answered. */
+    userMessage: string;
+    /** The error message shown to the user (e.g. "AI server unavailable"). */
+    errorMessage: string;
+    /** Reason category: 'timeout', 'overloaded', 'rate_limit', 'quota', 'network', 'unknown'. */
+    reason?: string;
+    /** HTTP status code from the AI provider, if available. */
+    statusCode?: number;
+    /** AI provider name (e.g. 'openai', 'anthropic'). */
+    provider?: string;
+    /** System prompt, if available. */
+    systemPrompt?: string;
+}
+/**
+ * Build a trace for scenarios where the AI service was unavailable.
+ *
+ * Use this when your application catches an error **before or instead of**
+ * calling the AI API, and shows an error message to the user. This ensures
+ * the event appears in TruthGuard's Live Observe dashboard.
+ *
+ * @example
+ * ```ts
+ * import { reportUnavailable } from 'ai-rcp';
+ *
+ * try {
+ *   const response = await callAI(userMessage);
+ * } catch (err) {
+ *   const trace = reportUnavailable({
+ *     userMessage: 'Daj mi izveštaj za mart',
+ *     errorMessage: 'AI server trenutno nije dostupan',
+ *     reason: 'timeout',
+ *     provider: 'anthropic',
+ *   });
+ *   // Send to TruthGuard: await fetch('/api/ingest', { body: JSON.stringify({ trace }) });
+ * }
+ * ```
+ */
+export declare function reportUnavailable(options: ReportUnavailableOptions): Trace;
+/**
+ * Wraps an OpenAI client instance to auto-capture traces and evaluate grounding.
+ *
+ * Returns a proxy that intercepts `client.chat.completions.create()`.
+ * All other methods pass through unchanged.
+ *
+ * In thin-client mode (when `client` option is provided), traces are sent to
+ * the TruthGuard server for evaluation — no engine code runs locally.
+ */
+export declare function wrapOpenAI<T extends object>(client: T, options?: WrapOpenAIOptions): T;
+export {};
+//# sourceMappingURL=openai.d.ts.map

package/dist-npm/SDK/openai.d.ts.map

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