@tenet-ai/sdk 0.1.0

package/dist/integrations/vercel-ai.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * Vercel AI SDK integration for Tenet AI.
+ *
+ * Provides wrappers for the Vercel AI SDK's `generateText` and `streamText`
+ * functions that automatically record prompts, responses, tool calls, and
+ * model metadata in the Tenet audit trail.
+ *
+ * This module has **no hard dependency** on the `ai` (Vercel AI SDK) package.
+ * All relevant types are defined inline and the wrappers accept generic
+ * function references.
+ *
+ * @example
+ * ```ts
+ * import { generateText, streamText } from 'ai';
+ * import { openai } from '@ai-sdk/openai';
+ * import { Tenet } from '@tenet-ai/sdk';
+ * import { TenetVercelAITracker } from '@tenet-ai/sdk/integrations/vercel-ai';
+ *
+ * const tenet = new Tenet({ apiKey: 'tenet_xxx' });
+ * const tracker = new TenetVercelAITracker(tenet, {
+ *   agentId: 'vercel-ai-agent',
+ * });
+ *
+ * // Wrap generateText for automatic tracking
+ * const trackedGenerate = tracker.wrapGenerateText(generateText);
+ * const result = await trackedGenerate({
+ *   model: openai('gpt-4o'),
+ *   prompt: 'What is the meaning of life?',
+ * });
+ *
+ * // Wrap streamText for automatic tracking
+ * const trackedStream = tracker.wrapStreamText(streamText);
+ * const stream = await trackedStream({
+ *   model: openai('gpt-4o'),
+ *   prompt: 'Tell me a story.',
+ * });
+ * ```
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TenetVercelAITracker = void 0;
+const crypto_1 = require("crypto");
+const types_1 = require("../types");
+// ---------------------------------------------------------------------------
+// Tracker
+// ---------------------------------------------------------------------------
+/**
+ * Wrapper for the Vercel AI SDK that records `generateText` and `streamText`
+ * calls in the Tenet audit trail.
+ *
+ * Each call records the full intent -> context -> decision -> execution
+ * chain including the prompt, model, tool calls, and token usage.
+ */
+class TenetVercelAITracker {
+    client;
+    agentId;
+    sessionId;
+    tags;
+    metadata;
+    /**
+     * @param client  - An initialised {@link Tenet} client instance.
+     * @param config  - Optional configuration overrides.
+     */
+    constructor(client, config = {}) {
+        this.client = client;
+        this.agentId = config.agentId ?? "vercel-ai-agent";
+        this.sessionId = config.sessionId ?? (0, crypto_1.randomUUID)();
+        this.tags = config.tags ?? [];
+        this.metadata = config.metadata ?? {};
+    }
+    /**
+     * Wrap the Vercel AI SDK `generateText` function with automatic Tenet
+     * tracking. Returns a new function with the same signature.
+     *
+     * @param generateText - The `generateText` function from the `ai` package.
+     * @returns A wrapped function that records calls in Tenet.
+     *
+     * @example
+     * ```ts
+     * import { generateText } from 'ai';
+     * const trackedGenerate = tracker.wrapGenerateText(generateText);
+     * const result = await trackedGenerate({ model, prompt: 'Hello' });
+     * ```
+     */
+    wrapGenerateText(generateText) {
+        const tracker = this;
+        return async (params) => {
+            let result;
+            let error;
+            try {
+                result = await generateText(params);
+            }
+            catch (e) {
+                error = e instanceof Error ? e : new Error(String(e));
+            }
+            await tracker.recordGenerateText(params, result, error);
+            if (error) {
+                throw error;
+            }
+            return result;
+        };
+    }
+    /**
+     * Wrap the Vercel AI SDK `streamText` function with automatic Tenet
+     * tracking. The tracking data is recorded after the stream completes
+     * (resolves its promises).
+     *
+     * @param streamText - The `streamText` function from the `ai` package.
+     * @returns A wrapped function that records calls in Tenet.
+     *
+     * @example
+     * ```ts
+     * import { streamText } from 'ai';
+     * const trackedStream = tracker.wrapStreamText(streamText);
+     * const result = await trackedStream({ model, prompt: 'Hello' });
+     * for await (const chunk of result.textStream) {
+     *   process.stdout.write(chunk);
+     * }
+     * ```
+     */
+    wrapStreamText(streamText) {
+        const tracker = this;
+        return async (params) => {
+            let result;
+            let error;
+            try {
+                result = await streamText(params);
+            }
+            catch (e) {
+                error = e instanceof Error ? e : new Error(String(e));
+                await tracker.recordGenerateText(params, undefined, error);
+                throw error;
+            }
+            // Record after the full text is available (non-blocking).
+            // We kick off a background task that awaits the resolved promises.
+            tracker.recordStreamResult(params, result).catch(() => {
+                // Swallow background tracking errors.
+            });
+            return result;
+        };
+    }
+    /**
+     * Manually record a `generateText` call. Useful when you want to call
+     * `generateText` yourself and record after the fact.
+     *
+     * @param params   - The parameters that were passed to `generateText`.
+     * @param result   - The result, if the call succeeded.
+     * @param error    - The error, if the call failed.
+     */
+    async recordGenerateText(params, result, error) {
+        const success = !error && !!result;
+        const text = result?.text ?? "";
+        const toolCalls = result?.toolCalls ?? [];
+        const toolResults = result?.toolResults ?? [];
+        const finishReason = result?.finishReason ?? "unknown";
+        const usage = result?.usage;
+        await this.record(params, {
+            success,
+            text,
+            toolCalls,
+            toolResults,
+            finishReason,
+            usage,
+            error,
+        });
+    }
+    // ----- Internal -----
+    /**
+     * Record a streaming result after its promises resolve.
+     */
+    async recordStreamResult(params, result) {
+        try {
+            const [text, toolCalls, toolResults, finishReason, usage] = await Promise.all([
+                result.text,
+                result.toolCalls ? result.toolCalls : Promise.resolve([]),
+                result.toolResults ? result.toolResults : Promise.resolve([]),
+                result.finishReason ? result.finishReason : Promise.resolve("unknown"),
+                result.usage ? result.usage : Promise.resolve(undefined),
+            ]);
+            await this.record(params, {
+                success: true,
+                text,
+                toolCalls,
+                toolResults,
+                finishReason,
+                usage,
+            });
+        }
+        catch {
+            // Swallow: don't break the stream consumer.
+        }
+    }
+    /**
+     * Core recording logic shared by generate and stream paths.
+     */
+    async record(params, data) {
+        const { success, text, toolCalls, toolResults, finishReason, usage, error } = data;
+        // Derive the goal from the prompt or first user message
+        let goal;
+        if (params.prompt) {
+            goal = params.prompt.slice(0, 200);
+        }
+        else if (params.messages?.length) {
+            const lastUser = [...params.messages].reverse().find((m) => m.role === "user");
+            goal = lastUser ? lastUser.content.slice(0, 200) : "vercel-ai-call";
+        }
+        else {
+            goal = "vercel-ai-call";
+        }
+        // Build options
+        const options = [];
+        if (toolCalls.length > 0) {
+            for (let i = 0; i < toolCalls.length; i++) {
+                options.push({
+                    action: toolCalls[i].toolName,
+                    score: 1.0 / (i + 1),
+                    reason: JSON.stringify(toolCalls[i].args).slice(0, 100),
+                });
+            }
+        }
+        else {
+            options.push({
+                action: "generate_response",
+                score: success ? 1.0 : 0.0,
+                reason: success ? "Text generation" : `error: ${error?.message}`,
+            });
+        }
+        const chosenAction = toolCalls.length > 0
+            ? toolCalls[0].toolName
+            : "generate_response";
+        // Model version: try to extract a string from the model param
+        const modelVersion = typeof params.model === "string"
+            ? params.model
+            : params.model?.modelId
+                ?? "unknown";
+        try {
+            // 1. Intent
+            const intent = await this.client.createIntent({
+                goal,
+                agentId: this.agentId,
+                sessionId: this.sessionId,
+                origin: types_1.OriginType.AGENT,
+            });
+            // 2. Context
+            await intent.snapshotContext({
+                prompt: params.prompt ?? null,
+                messages: params.messages ?? [],
+                system: params.system ?? null,
+                model: modelVersion,
+                temperature: params.temperature,
+                max_tokens: params.maxTokens,
+                tools: params.tools ? Object.keys(params.tools) : [],
+            });
+            // 3. Decision
+            await intent.decide({
+                options,
+                chosenAction,
+                confidence: success ? 0.95 : 0.0,
+                modelVersion,
+                reasoning: success
+                    ? `Finished with reason: ${finishReason}`
+                    : `Error: ${error?.message}`,
+                tags: this.tags,
+                metadata: {
+                    ...this.metadata,
+                    usage: usage ?? null,
+                    finish_reason: finishReason,
+                },
+            });
+            // 4. Execution
+            await intent.execute({
+                action: chosenAction,
+                target: {
+                    text: text.slice(0, 2000),
+                    tool_calls: toolCalls.map((tc) => ({
+                        name: tc.toolName,
+                        args: tc.args,
+                    })),
+                    tool_results: toolResults.map((tr) => ({
+                        name: tr.toolName,
+                        result: tr.result,
+                    })),
+                },
+                result: success ? types_1.ResultType.SUCCESS : types_1.ResultType.FAILURE,
+                sideEffects: toolCalls.map((tc) => `tool:${tc.toolName}`),
+                actor: types_1.ActorType.AGENT,
+            });
+        }
+        catch {
+            // Swallow tracking errors so the caller is not impacted.
+        }
+    }
+}
+exports.TenetVercelAITracker = TenetVercelAITracker;
+//# sourceMappingURL=vercel-ai.js.map

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

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

package/dist/types.d.ts

@@ -0,0 +1,258 @@
+export declare enum OriginType {
+    HUMAN = "human",
+    AGENT = "agent",
+    SCHEDULER = "scheduler"
+}
+export declare enum ResultType {
+    SUCCESS = "success",
+    FAILURE = "failure",
+    PENDING = "pending"
+}
+export declare enum ActorType {
+    AGENT = "agent",
+    HUMAN = "human"
+}
+export interface TenetConfig {
+    apiKey: string;
+    endpoint?: string;
+    environment?: string;
+    timeout?: number;
+}
+export interface ActionOption {
+    action: string;
+    target?: Record<string, unknown>;
+    score: number;
+    reason?: string;
+}
+export interface ReplayConfig {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    apiBase?: string;
+}
+export interface IntentCreateParams {
+    goal: string;
+    agentId?: string;
+    sessionId?: string;
+    origin?: OriginType;
+    constraints?: string[];
+    parentIntentId?: string;
+    mcpServer?: string;
+    toolName?: string;
+    environment?: string;
+}
+export interface IntentResponse {
+    id: string;
+    goal: string;
+    origin: string;
+    constraints: string[];
+    agent_id: string;
+    session_id: string;
+    parent_intent_id?: string;
+    mcp_server?: string;
+    tool_name?: string;
+    environment?: string;
+    created_at: string;
+}
+export interface ContextCreateParams {
+    intentId: string;
+    inputs: Record<string, unknown>;
+    externalVersions?: Record<string, string>;
+}
+export interface ContextResponse {
+    id: string;
+    intent_id: string;
+    inputs: Record<string, unknown>;
+    external_versions: Record<string, string>;
+    snapshot_hash: string;
+    created_at: string;
+}
+export interface DecisionCreateParams {
+    intentId: string;
+    contextId: string;
+    options: ActionOption[];
+    chosenAction: string;
+    confidence: number;
+    modelVersion: string;
+    rulesEvaluated?: string[];
+    reasoning?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    replayPrompt?: string;
+    replayConfig?: ReplayConfig;
+}
+export interface DecisionResponse {
+    id: string;
+    intent_id: string;
+    context_id: string;
+    options: Record<string, unknown>[];
+    chosen_action: string;
+    confidence: number;
+    model_version: string;
+    rules_evaluated: string[];
+    reasoning?: string;
+    tags: string[];
+    metadata: Record<string, unknown>;
+    replay_prompt?: string;
+    replay_config?: Record<string, unknown>;
+    created_at: string;
+}
+export interface ExecutionCreateParams {
+    decisionId: string;
+    action: string;
+    target: Record<string, unknown>;
+    result?: ResultType;
+    sideEffects?: string[];
+    revertAction?: Record<string, unknown>;
+    actor?: ActorType;
+    overrideReason?: string;
+    overriddenBy?: string;
+}
+export interface ExecutionResponse {
+    id: string;
+    decision_id: string;
+    action: string;
+    target: Record<string, unknown>;
+    result: string;
+    side_effects: string[];
+    revert_action?: Record<string, unknown>;
+    actor: string;
+    override_reason?: string;
+    overridden_by?: string;
+    created_at: string;
+    session_id?: string;
+}
+export interface TraceParams<T = unknown> {
+    agentId: string;
+    fn: () => T | Promise<T>;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+    sessionId?: string;
+    modelVersion?: string;
+}
+export interface TraceResult<T = unknown> {
+    id: string;
+    output: T;
+    intentId: string;
+    contextId: string;
+    decisionId: string;
+    executionId: string;
+}
+export interface ReplayParams {
+    executionId?: string;
+    decisionId?: string;
+    compare?: boolean;
+    withContextId?: string;
+    forceLlmCall?: boolean;
+}
+export interface ReplayResult {
+    original_decision: DecisionResponse;
+    replayed_decision?: {
+        chosen_action: string;
+        confidence?: number;
+        reasoning?: string;
+        raw_response?: string;
+    };
+    diverged: boolean;
+    divergence_reason?: string;
+    replay_executed: boolean;
+    replay_error?: string;
+    diffs: Array<{
+        field: string;
+        original?: string;
+        replayed?: string;
+        changed: boolean;
+    }>;
+    drift_score: number;
+    diff: Record<string, unknown>;
+}
+export interface RevertParams {
+    executionId: string;
+    reason: string;
+    force?: boolean;
+}
+export interface RevertResponse {
+    execution_id: string;
+    revert_action: Record<string, unknown>;
+    status: string;
+    new_execution_id?: string;
+}
+export interface TimelineEntry {
+    type: string;
+    id: string;
+    timestamp: string;
+    summary: string;
+    data: Record<string, unknown>;
+}
+export interface SessionTimeline {
+    session_id: string;
+    entries: TimelineEntry[];
+}
+export interface ListDecisionsParams {
+    workspaceId?: string;
+    agentId?: string;
+    sessionId?: string;
+    environment?: string;
+    tags?: string[];
+    metadataKey?: string;
+    metadataValue?: string;
+    startTime?: Date;
+    endTime?: Date;
+    minConfidence?: number;
+    maxConfidence?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface DriftCheckParams {
+    workspaceId?: string;
+    agentId?: string;
+    environment?: string;
+    sampleSize?: number;
+    timeWindowHours?: number;
+}
+export interface DriftCheckResult {
+    workspace_id: string;
+    agent_id?: string;
+    sample_size: number;
+    checked_count: number;
+    overall_drift_score: number;
+    diverged_count: number;
+    results: Array<{
+        decision_id: string;
+        execution_id: string;
+        original_action: string;
+        replayed_action?: string;
+        drift_score: number;
+        diverged: boolean;
+        divergence_reason?: string;
+        error?: string;
+    }>;
+    checked_at: string;
+}
+export interface ComplianceReportParams {
+    workspaceId?: string;
+    startDate?: Date;
+    endDate?: Date;
+    regulation?: "eu_ai_act" | "hipaa" | "soc2" | "all";
+    agentId?: string;
+}
+export interface ComplianceReport {
+    workspace_id: string;
+    generated_at: string;
+    period_start?: string;
+    period_end?: string;
+    regulation: string;
+    summary: {
+        total_decisions: number;
+        total_executions: number;
+        total_agents: number;
+        total_sessions: number;
+        success_rate: number;
+        human_override_count: number;
+        avg_confidence: number;
+        decisions_with_replay: number;
+        drift_events: number;
+    };
+    agents: Record<string, unknown>[];
+    audit_entries: Record<string, unknown>[];
+}

package/dist/types.js

@@ -0,0 +1,22 @@
+"use strict";
+// --- Enums ---
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActorType = exports.ResultType = exports.OriginType = void 0;
+var OriginType;
+(function (OriginType) {
+    OriginType["HUMAN"] = "human";
+    OriginType["AGENT"] = "agent";
+    OriginType["SCHEDULER"] = "scheduler";
+})(OriginType || (exports.OriginType = OriginType = {}));
+var ResultType;
+(function (ResultType) {
+    ResultType["SUCCESS"] = "success";
+    ResultType["FAILURE"] = "failure";
+    ResultType["PENDING"] = "pending";
+})(ResultType || (exports.ResultType = ResultType = {}));
+var ActorType;
+(function (ActorType) {
+    ActorType["AGENT"] = "agent";
+    ActorType["HUMAN"] = "human";
+})(ActorType || (exports.ActorType = ActorType = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,gBAAgB;;;AAEhB,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,6BAAe,CAAA;IACf,6BAAe,CAAA;IACf,qCAAuB,CAAA;AACzB,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB;AAED,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;AACrB,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB;AAED,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,4BAAe,CAAA;AACjB,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@tenet-ai/sdk",
+  "version": "0.1.0",
+  "description": "Node.js SDK for Tenet AI - Audit trail and replay for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "audit",
+    "logging",
+    "llm",
+    "observability",
+    "replay",
+    "drift-detection"
+  ],
+  "author": "Vinay Badhan <vinay.badhan21.work@gmail.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}