@weaveaijs/mcp-observatory 0.3.0

package/dist/core/wrapper.d.ts

@@ -0,0 +1,34 @@
+import { TraceContext } from './context.js';
+export interface WrapperDecision {
+    action: 'allow' | 'review' | 'block';
+    reason?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface WrapperPolicy {
+    maxCostUsd?: number;
+    maxLatencyMs?: number;
+}
+export interface WrapperResult {
+    output: unknown;
+    span: TraceContext;
+    decision: WrapperDecision;
+    shadowOutput?: unknown;
+    shadowSpan?: TraceContext;
+}
+export declare class InvocationWrapper {
+    private tracer;
+    private policy;
+    constructor(service: string, policy?: WrapperPolicy);
+    invoke(options: {
+        source: 'agent' | 'model';
+        model?: string;
+        prompt: string;
+        inputPayload?: Record<string, unknown>;
+        call: () => Promise<unknown> | unknown;
+        dualInvoke?: boolean;
+        shadowCall?: () => Promise<unknown> | unknown;
+    }): Promise<WrapperResult>;
+    private decide;
+    private toText;
+}
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/core/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/core/wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAA0B;gBAE5B,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa;IAQ7C,MAAM,CAAC,OAAO,EAAE;QACpB,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;QACvC,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;KAC/C,GAAG,OAAO,CAAC,aAAa,CAAC;IA0D1B,OAAO,CAAC,MAAM;IA+Bd,OAAO,CAAC,MAAM;CAKf"}

package/dist/core/wrapper.js

@@ -0,0 +1,93 @@
+import { estimateTokens } from '../cost/tokenizer.js';
+import { estimateCost } from '../cost/pricing.js';
+import { hashText } from '../utils/hashing.js';
+import { Tracer } from './tracer.js';
+export class InvocationWrapper {
+    constructor(service, policy) {
+        this.tracer = new Tracer(service);
+        this.policy = {
+            maxCostUsd: policy?.maxCostUsd ?? 0.25,
+            maxLatencyMs: policy?.maxLatencyMs ?? 8000,
+        };
+    }
+    async invoke(options) {
+        const span = this.tracer.startSpan({
+            model: options.model,
+        });
+        const inputText = options.prompt + JSON.stringify(options.inputPayload || {});
+        span.inputHash = hashText(inputText);
+        const tokens = estimateTokens(inputText, options.model);
+        span.inputTokens = tokens;
+        const startTime = Date.now();
+        let output;
+        let shadowOutput;
+        try {
+            output = await Promise.resolve(options.call());
+            if (options.dualInvoke && options.shadowCall) {
+                shadowOutput = await Promise.resolve(options.shadowCall());
+            }
+        }
+        catch (error) {
+            span.statusCode = 500;
+            throw error;
+        }
+        finally {
+            const outputText = JSON.stringify(output);
+            span.outputHash = hashText(outputText);
+            const outputTokens = estimateTokens(outputText, options.model);
+            span.outputTokens = outputTokens;
+            span.totalTokens = (span.inputTokens || 0) + outputTokens;
+            span.costUsd = estimateCost(span.totalTokens, options.model || 'gpt-4', options.source);
+            span.finish();
+        }
+        const decision = this.decide(span, output);
+        const result = {
+            output,
+            span,
+            decision,
+        };
+        if (options.dualInvoke && shadowOutput !== undefined) {
+            const shadowSpan = this.tracer.startSpan({ model: options.model });
+            const shadowText = JSON.stringify(shadowOutput);
+            shadowSpan.outputHash = hashText(shadowText);
+            shadowSpan.outputTokens = estimateTokens(shadowText, options.model);
+            shadowSpan.finish();
+            result.shadowOutput = shadowOutput;
+            result.shadowSpan = shadowSpan;
+        }
+        return result;
+    }
+    decide(span, output) {
+        if (!span.endTime) {
+            throw new Error('Span must be completed before decisioning');
+        }
+        const latencyMs = span.endTime.getTime() - span.startTime.getTime();
+        const outputText = this.toText(output);
+        if (!outputText.trim()) {
+            return { action: 'block', reason: 'empty_output' };
+        }
+        if (span.costUsd > this.policy.maxCostUsd) {
+            return {
+                action: 'review',
+                reason: 'cost_budget_exceeded',
+                metadata: { costUsd: span.costUsd, maxCostUsd: this.policy.maxCostUsd },
+            };
+        }
+        if (latencyMs > this.policy.maxLatencyMs) {
+            return {
+                action: 'review',
+                reason: 'latency_budget_exceeded',
+                metadata: { latencyMs: Math.round(latencyMs), maxLatencyMs: this.policy.maxLatencyMs },
+            };
+        }
+        return { action: 'allow', reason: 'within_budget' };
+    }
+    toText(output) {
+        if (typeof output === 'string')
+            return output;
+        if (output === null || output === undefined)
+            return '';
+        return JSON.stringify(output);
+    }
+}
+//# sourceMappingURL=wrapper.js.map

package/dist/core/wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../../src/core/wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAqBrC,MAAM,OAAO,iBAAiB;IAI5B,YAAY,OAAe,EAAE,MAAsB;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG;YACZ,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,IAAI;YACtC,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,IAAI;SAC3C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAQZ;QACC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,MAAe,CAAC;QACpB,IAAI,YAAqB,CAAC;QAE1B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAE/C,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC7C,YAAY,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;YACtB,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YACvC,MAAM,YAAY,GAAG,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAC/D,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;YACjC,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,YAAY,CAAC;YAC1D,IAAI,CAAC,OAAO,GAAG,YAAY,CACzB,IAAI,CAAC,WAAW,EAChB,OAAO,CAAC,KAAK,IAAI,OAAO,EACxB,OAAO,CAAC,MAAM,CACf,CAAC;YACF,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAkB;YAC5B,MAAM;YACN,IAAI;YACJ,QAAQ;SACT,CAAC;QAEF,IAAI,OAAO,CAAC,UAAU,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YACnE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAChD,UAAU,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC7C,UAAU,CAAC,YAAY,GAAG,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACpE,UAAU,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC;YACnC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,MAAM,CAAC,IAAkB,EAAE,MAAe;QAChD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEvC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;YACvB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QACrD,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1C,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,sBAAsB;gBAC9B,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE;aACxE,CAAC;QACJ,CAAC;QAED,IAAI,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzC,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,yBAAyB;gBACjC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE;aACvF,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACtD,CAAC;IAEO,MAAM,CAAC,MAAe;QAC5B,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;QAC9C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/cost/pricing.d.ts

@@ -0,0 +1,6 @@
+export declare function estimateCost(totalTokens: number, model?: string, source?: 'agent' | 'model'): number;
+export declare function getPricing(model: string): {
+    input: number;
+    output: number;
+};
+//# sourceMappingURL=pricing.d.ts.map

package/dist/cost/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/cost/pricing.ts"],"names":[],"mappings":"AAUA,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,MAAgB,EACvB,MAAM,GAAE,OAAO,GAAG,OAAiB,GAClC,MAAM,CAUR;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAE3E"}

package/dist/cost/pricing.js

@@ -0,0 +1,21 @@
+const PRICING = {
+    'gpt-4': { input: 0.03, output: 0.06 },
+    'gpt-4-turbo': { input: 0.01, output: 0.03 },
+    'gpt-4o': { input: 0.005, output: 0.015 },
+    'gpt-4o-mini': { input: 0.00015, output: 0.0006 },
+    'claude-3-opus': { input: 0.015, output: 0.075 },
+    'claude-3-sonnet': { input: 0.003, output: 0.015 },
+    'claude-3-haiku': { input: 0.00025, output: 0.00125 },
+};
+export function estimateCost(totalTokens, model = 'gpt-4', source = 'model') {
+    const pricing = PRICING[model] || PRICING['gpt-4'];
+    const inputTokens = Math.ceil(totalTokens * 0.5);
+    const outputTokens = totalTokens - inputTokens;
+    const inputCost = (inputTokens / 1000) * pricing.input;
+    const outputCost = (outputTokens / 1000) * pricing.output;
+    return inputCost + outputCost;
+}
+export function getPricing(model) {
+    return PRICING[model] || PRICING['gpt-4'];
+}
+//# sourceMappingURL=pricing.js.map

package/dist/cost/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/cost/pricing.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAsD;IACjE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACtC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAC5C,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;IACzC,aAAa,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;IACjD,eAAe,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;IAChD,iBAAiB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;IAClD,gBAAgB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;CACtD,CAAC;AAEF,MAAM,UAAU,YAAY,CAC1B,WAAmB,EACnB,QAAgB,OAAO,EACvB,SAA4B,OAAO;IAEnC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,WAAW,GAAG,WAAW,CAAC;IAE/C,MAAM,SAAS,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IACvD,MAAM,UAAU,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAE1D,OAAO,SAAS,GAAG,UAAU,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/cost/tokenizer.d.ts

@@ -0,0 +1,7 @@
+export declare function estimateTokens(text: string, model?: string): number;
+export declare function getTokenLimits(model: string): {
+    input: number;
+    output: number;
+};
+export declare function estimateCompletionTokens(input: string, estimatedOutputLength: number): number;
+//# sourceMappingURL=tokenizer.d.ts.map

package/dist/cost/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../src/cost/tokenizer.ts"],"names":[],"mappings":"AAaA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAQnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAE/E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,MAAM,CAE7F"}

package/dist/cost/tokenizer.js

@@ -0,0 +1,25 @@
+const TOKENS_PER_WORD = 1.3;
+const TOKENS_PER_CHAR = 0.25;
+const MODEL_TOKEN_LIMITS = {
+    'gpt-4': { input: 8191, output: 8191 },
+    'gpt-4-turbo': { input: 128000, output: 4096 },
+    'gpt-4o': { input: 128000, output: 4096 },
+    'gpt-4o-mini': { input: 128000, output: 4096 },
+    'claude-3-opus': { input: 200000, output: 4096 },
+    'claude-3-sonnet': { input: 200000, output: 4096 },
+    'claude-3-haiku': { input: 200000, output: 1024 },
+};
+export function estimateTokens(text, model) {
+    const wordCount = text.split(/\s+/).length;
+    const charCount = text.length;
+    const fromWords = Math.ceil(wordCount * TOKENS_PER_WORD);
+    const fromChars = Math.ceil(charCount * TOKENS_PER_CHAR);
+    return Math.max(fromWords, fromChars);
+}
+export function getTokenLimits(model) {
+    return MODEL_TOKEN_LIMITS[model] || { input: 4096, output: 2048 };
+}
+export function estimateCompletionTokens(input, estimatedOutputLength) {
+    return estimateTokens(input) + Math.ceil(estimatedOutputLength * TOKENS_PER_CHAR);
+}
+//# sourceMappingURL=tokenizer.js.map

package/dist/cost/tokenizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.js","sourceRoot":"","sources":["../../src/cost/tokenizer.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B,MAAM,kBAAkB,GAAsD;IAC5E,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACtC,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IAC9C,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IACzC,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IAC9C,eAAe,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IAChD,iBAAiB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IAClD,gBAAgB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;CAClD,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAc;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;IAEzD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAa,EAAE,qBAA6B;IACnF,OAAO,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,qBAAqB,GAAG,eAAe,CAAC,CAAC;AACpF,CAAC"}

package/dist/demo/client.d.ts

@@ -0,0 +1,18 @@
+export declare class MCPClient {
+    private tracer;
+    private wrapper;
+    constructor();
+    invokeWithMetrics(options: {
+        model: string;
+        prompt: string;
+        call: () => Promise<unknown>;
+    }): Promise<unknown>;
+    dualMeasure(options: {
+        model: string;
+        prompt: string;
+        primaryCall: () => Promise<unknown>;
+        shadowCall: () => Promise<unknown>;
+    }): Promise<unknown>;
+}
+export declare function runClientDemo(): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/demo/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/demo/client.ts"],"names":[],"mappings":"AAGA,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAoB;;IAU7B,iBAAiB,CAAC,OAAO,EAAE;QAC/B,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;KAC9B,GAAG,OAAO,CAAC,OAAO,CAAC;IAed,WAAW,CAAC,OAAO,EAAE;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,OAAO,CAAC;CAmBrB;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBnD"}

package/dist/demo/client.js

@@ -0,0 +1,57 @@
+import { Tracer } from '../core/tracer.js';
+import { InvocationWrapper } from '../core/wrapper.js';
+export class MCPClient {
+    constructor() {
+        this.tracer = new Tracer('mcp-client');
+        this.wrapper = new InvocationWrapper('mcp-client', {
+            maxCostUsd: 0.5,
+            maxLatencyMs: 10000,
+        });
+    }
+    async invokeWithMetrics(options) {
+        const result = await this.wrapper.invoke({
+            source: 'agent',
+            model: options.model,
+            prompt: options.prompt,
+            call: options.call,
+        });
+        console.log(`Decision: ${result.decision.action} (${result.decision.reason})`);
+        console.log(`Cost: $${result.span.costUsd?.toFixed(4)}`);
+        console.log(`Tokens: ${result.span.totalTokens}`);
+        return result;
+    }
+    async dualMeasure(options) {
+        const result = await this.wrapper.invoke({
+            source: 'agent',
+            model: options.model,
+            prompt: options.prompt,
+            call: options.primaryCall,
+            dualInvoke: true,
+            shadowCall: options.shadowCall,
+        });
+        console.log('Dual Measurement:');
+        console.log(`Primary Decision: ${result.decision.action}`);
+        console.log(`Primary Cost: $${result.span.costUsd?.toFixed(4)}`);
+        if (result.shadowSpan) {
+            console.log(`Shadow Cost: $${result.shadowSpan.costUsd?.toFixed(4)}`);
+        }
+        return result;
+    }
+}
+export async function runClientDemo() {
+    const client = new MCPClient();
+    console.log('=== MCP Client Demo ===\n');
+    await client.invokeWithMetrics({
+        model: 'gpt-4o-mini',
+        prompt: 'Generate a deployment plan for a microservices application',
+        call: async () => ({
+            plan: 'blue-green rollout with canary validation',
+            steps: [
+                'Deploy to staging',
+                'Run smoke tests',
+                'Deploy to production',
+            ],
+        }),
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/demo/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/demo/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,OAAO,SAAS;IAIpB;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAiB,CAAC,YAAY,EAAE;YACjD,UAAU,EAAE,GAAG;YACf,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAIvB;QACC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACvC,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAElD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAKjB;QACC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACvC,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,WAAW;YACzB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;IAE/B,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAEzC,MAAM,MAAM,CAAC,iBAAiB,CAAC;QAC7B,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,4DAA4D;QACpE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACjB,IAAI,EAAE,2CAA2C;YACjD,KAAK,EAAE;gBACL,mBAAmB;gBACnB,iBAAiB;gBACjB,sBAAsB;aACvB;SACF,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/demo/runDemo.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runDemo.d.ts.map

package/dist/demo/runDemo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runDemo.d.ts","sourceRoot":"","sources":["../../src/demo/runDemo.ts"],"names":[],"mappings":""}

package/dist/demo/runDemo.js

@@ -0,0 +1,15 @@
+import { runServerDemo } from './server.js';
+import { runClientDemo } from './client.js';
+async function main() {
+    try {
+        await runServerDemo();
+        console.log('\n' + '='.repeat(50) + '\n');
+        await runClientDemo();
+    }
+    catch (error) {
+        console.error('Demo error:', error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=runDemo.js.map

package/dist/demo/runDemo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runDemo.js","sourceRoot":"","sources":["../../src/demo/runDemo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,aAAa,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,aAAa,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/demo/server.d.ts

@@ -0,0 +1,19 @@
+interface ToolCall {
+    toolName: string;
+    proposalId?: string;
+    commitToken?: string;
+    args: Record<string, unknown>;
+}
+export declare class MCPServer {
+    private proposer;
+    private verifier;
+    private tracer;
+    constructor();
+    handleToolCall(call: ToolCall): Promise<unknown>;
+    private handleProposal;
+    private handleCommit;
+    private executeTool;
+}
+export declare function runServerDemo(): Promise<void>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/demo/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/demo/server.ts"],"names":[],"mappings":"AAIA,UAAU,QAAQ;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAAS;;IAQjB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;YAcxC,cAAc;YAsBd,YAAY;YAkCZ,WAAW;CAyB1B;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAwBnD"}

package/dist/demo/server.js

@@ -0,0 +1,100 @@
+import { ToolProposer } from '../proposal/proposer.js';
+import { CommitVerifier } from '../proposal/verifier.js';
+import { Tracer } from '../core/tracer.js';
+export class MCPServer {
+    constructor() {
+        this.proposer = new ToolProposer();
+        this.verifier = new CommitVerifier();
+        this.tracer = new Tracer('mcp-server');
+    }
+    async handleToolCall(call) {
+        return await this.tracer.withSpan(async (span) => {
+            if (call.toolName.includes('propose')) {
+                return await this.handleProposal(call, span);
+            }
+            if (call.toolName.includes('commit')) {
+                return await this.handleCommit(call, span);
+            }
+            return await this.executeTool(call, span);
+        });
+    }
+    async handleProposal(call, span) {
+        const baseName = call.toolName.replace('_propose', '');
+        const result = await this.proposer.propose({
+            toolName: baseName,
+            toolArgs: call.args,
+            outputInstability: Math.random() * 0.5,
+        });
+        span.tags['proposal_id'] = result.proposalId;
+        span.tags['proposal_status'] = result.status;
+        return {
+            proposalId: result.proposalId,
+            status: result.status,
+            commitToken: result.commitToken,
+            fallbackResponse: result.fallbackResponse,
+        };
+    }
+    async handleCommit(call, span) {
+        if (!call.proposalId || !call.commitToken) {
+            return {
+                success: false,
+                reason: 'missing_proposal_or_token',
+            };
+        }
+        const baseName = call.toolName.replace('_commit', '');
+        const verification = this.verifier.verify({
+            token: call.commitToken,
+            proposalId: call.proposalId,
+            toolName: baseName,
+            toolArgs: call.args,
+        });
+        span.tags['verification_valid'] = verification.valid;
+        if (!verification.canExecute) {
+            return {
+                success: false,
+                reason: verification.reason,
+            };
+        }
+        return await this.executeTool({ ...call, toolName: baseName }, span);
+    }
+    async executeTool(call, span) {
+        span.toolName = call.toolName;
+        const amount = call.args.amount;
+        const to = call.args.to;
+        if (call.toolName === 'transfer_funds') {
+            return {
+                success: true,
+                transactionId: Math.random().toString(36).slice(2),
+                from: 'acct_main',
+                to,
+                amount,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        return {
+            success: true,
+            result: `Executed ${call.toolName}`,
+        };
+    }
+}
+export async function runServerDemo() {
+    const server = new MCPServer();
+    console.log('=== MCP Server Demo ===\n');
+    const proposalResult = await server.handleToolCall({
+        toolName: 'transfer_funds_propose',
+        args: { amount: 1000, to: 'acct_bob' },
+    });
+    console.log('1. Proposal Phase:');
+    console.log(JSON.stringify(proposalResult, null, 2));
+    if (proposalResult.status === 'allowed' || proposalResult.status === 'review') {
+        const commitResult = await server.handleToolCall({
+            toolName: 'transfer_funds_commit',
+            proposalId: proposalResult.proposalId,
+            commitToken: proposalResult.commitToken,
+            args: { amount: 1000, to: 'acct_bob' },
+        });
+        console.log('\n2. Commit Phase:');
+        console.log(JSON.stringify(commitResult, null, 2));
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/demo/server.js.map

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

package/dist/hallucination/scoring.d.ts

@@ -0,0 +1,14 @@
+export interface HallucinationSignals {
+    outputInstability: number;
+    groundingScore: number;
+    numericVarianceScore: number;
+    selfConsistencyScore: number;
+    toolClaimMismatch: boolean;
+}
+export declare function computeHallucinationRiskScore(signals: HallucinationSignals): number;
+export declare function riskLevelForScore(score: number): 'low' | 'medium' | 'high';
+export declare function computeGroundingScore(output: string, context: string): number;
+export declare function computeNumericVarianceScore(values: number[]): number;
+export declare function computeSelfConsistencyScore(responses: string[]): number;
+export declare function detectToolClaimMismatch(toolName: string, output: string): boolean;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/hallucination/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/hallucination/scoring.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAoBnF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAI1E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAU7E;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAUpE;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EAAE,GAClB,MAAM,CAcR;AAYD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAKT"}

package/dist/hallucination/scoring.js

@@ -0,0 +1,67 @@
+export function computeHallucinationRiskScore(signals) {
+    const weights = {
+        outputInstability: 0.3,
+        groundingScore: 0.25,
+        numericVariance: 0.2,
+        selfConsistency: 0.15,
+        toolMismatch: 0.1,
+    };
+    let score = signals.outputInstability * weights.outputInstability +
+        (1 - signals.groundingScore) * weights.groundingScore +
+        signals.numericVarianceScore * weights.numericVariance +
+        (1 - signals.selfConsistencyScore) * weights.selfConsistency;
+    if (signals.toolClaimMismatch) {
+        score += weights.toolMismatch;
+    }
+    return Math.min(1, Math.max(0, score));
+}
+export function riskLevelForScore(score) {
+    if (score < 0.33)
+        return 'low';
+    if (score < 0.67)
+        return 'medium';
+    return 'high';
+}
+export function computeGroundingScore(output, context) {
+    const outputTokens = new Set(output.toLowerCase().split(/\s+/));
+    const contextTokens = new Set(context.toLowerCase().split(/\s+/));
+    const overlap = Array.from(outputTokens).filter((token) => contextTokens.has(token)).length;
+    const maxTokens = Math.max(outputTokens.size, 1);
+    return overlap / maxTokens;
+}
+export function computeNumericVarianceScore(values) {
+    if (values.length < 2)
+        return 0;
+    const mean = values.reduce((a, b) => a + b, 0) / values.length;
+    const variance = values.reduce((sum, val) => sum + Math.pow(val - mean, 2), 0) / values.length;
+    const stdDev = Math.sqrt(variance);
+    const coefficientOfVariation = mean !== 0 ? stdDev / mean : 0;
+    return Math.min(1, coefficientOfVariation);
+}
+export function computeSelfConsistencyScore(responses) {
+    if (responses.length < 2)
+        return 1;
+    let totalSimilarity = 0;
+    let comparisons = 0;
+    for (let i = 0; i < responses.length; i++) {
+        for (let j = i + 1; j < responses.length; j++) {
+            totalSimilarity += jaccardSimilarity(responses[i], responses[j]);
+            comparisons++;
+        }
+    }
+    return comparisons > 0 ? totalSimilarity / comparisons : 0;
+}
+function jaccardSimilarity(str1, str2) {
+    const tokens1 = new Set(str1.toLowerCase().split(/\s+/));
+    const tokens2 = new Set(str2.toLowerCase().split(/\s+/));
+    const intersection = new Set([...tokens1].filter((x) => tokens2.has(x)));
+    const union = new Set([...tokens1, ...tokens2]);
+    return union.size > 0 ? intersection.size / union.size : 1;
+}
+export function detectToolClaimMismatch(toolName, output) {
+    const keywords = toolName.toLowerCase().split('_');
+    const outputLower = output.toLowerCase();
+    const matches = keywords.filter((kw) => outputLower.includes(kw));
+    return matches.length === 0;
+}
+//# sourceMappingURL=scoring.js.map

package/dist/hallucination/scoring.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { Tracer } from './core/tracer.js';
+export { TraceContext } from './core/context.js';
+export { InvocationWrapper } from './core/wrapper.js';
+export type { WrapperDecision, WrapperPolicy, WrapperResult } from './core/wrapper.js';
+export { TokenManager } from './proposal/token.js';
+export { ToolProposer } from './proposal/proposer.js';
+export { CommitVerifier } from './proposal/verifier.js';
+export { InMemoryProposalStorage, PostgresProposalStorage, } from './proposal/storage.js';
+export type { ProposalOptions, ProposalResult, } from './proposal/proposer.js';
+export { hashText, hashJson, normalizePrompt, computePromptHash, } from './utils/hashing.js';
+export { getCurrentTimeMs, getCurrentTimeIso, addMs, diffMs, formatDuration, } from './utils/time.js';
+export { estimateTokens, getTokenLimits } from './cost/tokenizer.js';
+export { estimateCost, getPricing } from './cost/pricing.js';
+export { computeHallucinationRiskScore, riskLevelForScore, computeGroundingScore, computeNumericVarianceScore, computeSelfConsistencyScore, detectToolClaimMismatch, } from './hallucination/scoring.js';
+export type { HallucinationSignals } from './hallucination/scoring.js';
+export { computeRiskScore, categorizeRisk, } from './risk/scoring.js';
+export type { RiskSignals } from './risk/scoring.js';
+export { MCPServer } from './demo/server.js';
+export { MCPClient } from './demo/client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,eAAe,EACf,cAAc,GACf,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,EACL,MAAM,EACN,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,EACL,6BAA6B,EAC7B,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGvE,OAAO,EACL,gBAAgB,EAChB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+// Core
+export { Tracer } from './core/tracer.js';
+export { TraceContext } from './core/context.js';
+export { InvocationWrapper } from './core/wrapper.js';
+// Proposal/Commit
+export { TokenManager } from './proposal/token.js';
+export { ToolProposer } from './proposal/proposer.js';
+export { CommitVerifier } from './proposal/verifier.js';
+export { InMemoryProposalStorage, PostgresProposalStorage, } from './proposal/storage.js';
+// Utils
+export { hashText, hashJson, normalizePrompt, computePromptHash, } from './utils/hashing.js';
+export { getCurrentTimeMs, getCurrentTimeIso, addMs, diffMs, formatDuration, } from './utils/time.js';
+// Cost
+export { estimateTokens, getTokenLimits } from './cost/tokenizer.js';
+export { estimateCost, getPricing } from './cost/pricing.js';
+// Hallucination
+export { computeHallucinationRiskScore, riskLevelForScore, computeGroundingScore, computeNumericVarianceScore, computeSelfConsistencyScore, detectToolClaimMismatch, } from './hallucination/scoring.js';
+// Risk
+export { computeRiskScore, categorizeRisk, } from './risk/scoring.js';
+// Demo
+export { MCPServer } from './demo/server.js';
+export { MCPClient } from './demo/client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAM/B,QAAQ;AACR,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,EACL,MAAM,EACN,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACP,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7D,gBAAgB;AAChB,OAAO,EACL,6BAA6B,EAC7B,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAGpC,OAAO;AACP,OAAO,EACL,gBAAgB,EAChB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO;AACP,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}