shield360 1.0.0

package/dist/llm/anthropic.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.llmResponseAnthropic = llmResponseAnthropic;
+async function llmResponseAnthropic({ prompt, model, apiKey }) {
+    let Anthropic;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        Anthropic = require('@anthropic-ai/sdk').default;
+    }
+    catch {
+        throw new Error("shield360 guard/eval features require the '@anthropic-ai/sdk' package. Install it with: npm install @anthropic-ai/sdk");
+    }
+    const client = new Anthropic({ apiKey });
+    const usedModel = model || 'claude-3-opus-20240229';
+    const response = await client.messages.create({
+        model: usedModel,
+        max_tokens: 2000,
+        messages: [
+            { role: 'user', content: prompt }
+        ],
+        temperature: 0.0,
+        // Anthropic does not support response_format, so we expect JSON in text
+    });
+    if (typeof response.content === 'string')
+        return response.content;
+    if (Array.isArray(response.content)) {
+        for (const part of response.content) {
+            if (part.type === 'text' && typeof part.text === 'string' && part.text.trim().startsWith('{')) {
+                return part.text;
+            }
+        }
+        return response.content
+            .filter((p) => p.type === 'text' && typeof p.text === 'string')
+            .map((p) => p.text)
+            .join(' ');
+    }
+    return '';
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/llm/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/llm/anthropic.ts"],"names":[],"mappings":";;AAAA,oDA0CC;AA1CM,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EACN,KAAK,EACL,MAAM,EAKP;IACC,IAAI,SAAc,CAAC;IACnB,IAAI,CAAC;QACH,8DAA8D;QAC9D,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,uHAAuH,CACxH,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,IAAI,wBAAwB,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC5C,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;SAClC;QACD,WAAW,EAAE,GAAG;QAChB,wEAAwE;KACzE,CAAC,CAAC;IACH,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;IAClE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9F,OAAO,IAAI,CAAC,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO;aACpB,MAAM,CAAC,CAAC,CAAmC,EAAwC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;aACtI,GAAG,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aACpC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/llm/index.d.ts

@@ -0,0 +1,10 @@
+interface LegacyGuardResult {
+    score: number;
+    verdict: 'yes' | 'no' | 'none';
+    guard: string;
+    classification: string;
+    explanation: string;
+}
+export declare function llmResponse(provider: string, prompt: string, model?: string, baseUrl?: string, apiKey?: string): Promise<string>;
+export declare function parseLlmResponse(response: string | object): LegacyGuardResult;
+export {};

package/dist/llm/index.js

@@ -0,0 +1,93 @@
+"use strict";
+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.llmResponse = llmResponse;
+exports.parseLlmResponse = parseLlmResponse;
+async function llmResponse(provider, prompt, model, baseUrl, apiKey) {
+    if (provider.toLowerCase() === 'openai') {
+        const { llmResponseOpenAI } = await Promise.resolve().then(() => __importStar(require('./openai')));
+        return llmResponseOpenAI({ prompt, model, baseUrl, apiKey });
+    }
+    else if (provider.toLowerCase() === 'anthropic') {
+        const { llmResponseAnthropic } = await Promise.resolve().then(() => __importStar(require('./anthropic')));
+        return llmResponseAnthropic({ prompt, model, apiKey });
+    }
+    else {
+        throw new Error(`Unsupported provider: ${provider}`);
+    }
+}
+function parseLlmResponse(response) {
+    try {
+        let data;
+        if (typeof response === 'string') {
+            data = JSON.parse(response);
+        }
+        else if (typeof response === 'object') {
+            data = response;
+        }
+        else {
+            throw new Error('Response must be a JSON string or an object.');
+        }
+        let verdict = 'none';
+        if (typeof data.verdict === 'string') {
+            if (data.verdict === 'yes' || data.verdict === 'no') {
+                verdict = data.verdict;
+            }
+            else {
+                // eslint-disable-next-line no-console
+                console.warn(`Unexpected verdict value in LLM response: "${data.verdict}". Coercing to 'none'.`);
+            }
+        }
+        return {
+            score: typeof data.score === 'number' ? data.score : 0,
+            verdict,
+            guard: typeof data.guard === 'string' ? data.guard : 'none',
+            classification: typeof data.classification === 'string' ? data.classification : 'none',
+            explanation: typeof data.explanation === 'string' ? data.explanation : 'none',
+        };
+    }
+    catch (e) {
+        // eslint-disable-next-line no-console
+        console.error('Error parsing LLM response:', e);
+        return {
+            score: 0,
+            verdict: 'none',
+            guard: 'none',
+            classification: 'none',
+            explanation: 'none'
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,kCAUC;AAED,4CAuCC;AAnDM,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,MAAc,EAAE,KAAc,EAAE,OAAgB,EAAE,MAAe;IACnH,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,EAAE,iBAAiB,EAAE,GAAG,wDAAa,UAAU,GAAC,CAAC;QACvD,OAAO,iBAAiB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;SAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;QAClD,MAAM,EAAE,oBAAoB,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;QAC7D,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAAyB;IACxD,IAAI,CAAC;QACH,IAAI,IAA6B,CAAC;QAClC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACxC,IAAI,GAAG,QAAmC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,OAAO,GAA0B,MAAM,CAAC;QAC5C,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBACpD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,sCAAsC;gBACtC,OAAO,CAAC,IAAI,CACV,8CAA8C,IAAI,CAAC,OAAO,wBAAwB,CACnF,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO;YACL,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACtD,OAAO;YACP,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,KAAgB,CAAC,CAAC,CAAC,MAAM;YACvE,cAAc,EAAE,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,cAAyB,CAAC,CAAC,CAAC,MAAM;YAClG,WAAW,EAAE,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,WAAsB,CAAC,CAAC,CAAC,MAAM;SAC1F,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC;QAChD,OAAO;YACL,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,MAAM;YACb,cAAc,EAAE,MAAM;YACtB,WAAW,EAAE,MAAM;SACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/llm/openai.d.ts

@@ -0,0 +1,6 @@
+export declare function llmResponseOpenAI({ prompt, model, apiKey, baseUrl }: {
+    prompt: string;
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+}): Promise<string>;

package/dist/llm/openai.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.llmResponseOpenAI = llmResponseOpenAI;
+async function llmResponseOpenAI({ prompt, model, apiKey, baseUrl }) {
+    let OpenAI;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        OpenAI = require('openai').default;
+    }
+    catch {
+        throw new Error("shield360 guard/eval features require the 'openai' package. Install it with: npm install openai");
+    }
+    const client = new OpenAI({
+        apiKey,
+        baseURL: baseUrl || 'https://api.openai.com/v1',
+    });
+    const usedModel = model || 'gpt-4o';
+    const response = await client.chat.completions.create({
+        model: usedModel,
+        messages: [
+            { role: 'user', content: prompt }
+        ],
+        temperature: 0.0,
+        response_format: { type: 'json_object' }
+    });
+    if (!response) {
+        console.error('OpenAI API did not return a response object:', response);
+        throw new Error('OpenAI API did not return a response object.');
+    }
+    if (!response.choices) {
+        console.error('OpenAI API response missing "choices":', response);
+        throw new Error('OpenAI API response missing "choices".');
+    }
+    if (!Array.isArray(response.choices) || response.choices.length === 0) {
+        console.error('OpenAI API response "choices" is empty or not an array:', response.choices);
+        throw new Error('OpenAI API response "choices" is empty or not an array.');
+    }
+    if (!response.choices[0]) {
+        console.error('OpenAI API response "choices[0]" is missing:', response.choices);
+        throw new Error('OpenAI API response "choices[0]" is missing.');
+    }
+    if (!response.choices[0].message) {
+        console.error('OpenAI API response "choices[0].message" is missing:', response.choices[0]);
+        throw new Error('OpenAI API response "choices[0].message" is missing.');
+    }
+    if (typeof response.choices[0].message.content !== 'string') {
+        console.error('OpenAI API response "choices[0].message.content" is missing or not a string:', response.choices[0].message);
+        throw new Error('OpenAI API response "choices[0].message.content" is missing or not a string.');
+    }
+    return response.choices[0].message.content || '';
+}
+//# sourceMappingURL=openai.js.map

package/dist/llm/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/llm/openai.ts"],"names":[],"mappings":";;AAAA,8CA0DC;AA1DM,KAAK,UAAU,iBAAiB,CAAC,EACtC,MAAM,EACN,KAAK,EACL,MAAM,EACN,OAAO,EAMR;IACC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,iGAAiG,CAClG,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACxB,MAAM;QACN,OAAO,EAAE,OAAO,IAAI,2BAA2B;KAChD,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,KAAK,IAAI,QAAQ,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACpD,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;SAClC;QACD,WAAW,EAAE,GAAG;QAChB,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;KACzC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,8CAA8C,EAAE,QAAQ,CAAC,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,QAAQ,CAAC,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,OAAO,CAAC,KAAK,CAAC,yDAAyD,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3F,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,8CAA8C,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,sDAAsD,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5D,OAAO,CAAC,KAAK,CAAC,8EAA8E,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC3H,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;AACnD,CAAC"}

package/dist/llm/providers.d.ts

@@ -0,0 +1,7 @@
+export type LlmResponseFn = (args: {
+    prompt: string;
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+}) => Promise<string>;
+export declare const llmProviders: Record<string, LlmResponseFn>;

package/dist/llm/providers.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.llmProviders = void 0;
+const openai_1 = require("./openai");
+const anthropic_1 = require("./anthropic");
+exports.llmProviders = {
+    openai: openai_1.llmResponseOpenAI,
+    anthropic: anthropic_1.llmResponseAnthropic,
+};
+//# sourceMappingURL=providers.js.map

package/dist/llm/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/llm/providers.ts"],"names":[],"mappings":";;;AAAA,qCAA6C;AAC7C,2CAAmD;AAStC,QAAA,YAAY,GAAkC;IACzD,MAAM,EAAE,0BAAiB;IACzB,SAAS,EAAE,gCAAoB;CAChC,CAAC"}

package/dist/manual-trace.d.ts

@@ -0,0 +1,40 @@
+import { Span } from '@opentelemetry/api';
+/**
+ * Wrapper for an OpenTelemetry span with helpers to set result and metadata.
+ * Mirrors Python's TracedSpan — the span lifecycle is managed by startTrace() /
+ * trace(), so you do not call end() yourself (like Python's `with` block).
+ */
+export declare class TracedSpan {
+    private readonly _span;
+    constructor(span: Span);
+    /** Record the AI output or function return value on the span. */
+    setResult(result: string): void;
+    /** Stamp arbitrary key/value attributes onto the span. */
+    setMetadata(metadata: Record<string, string | number | boolean>): void;
+}
+/**
+ * Start a named CLIENT span scoped to a callback — the TypeScript equivalent of
+ * Python's `with start_trace(name) as span:`.
+ *
+ * The span is active for the duration of `fn`, so child LLM spans nest correctly.
+ *
+ * @example
+ *   const answer = await shield360.startTrace('my-operation', async (span) => {
+ *     const result = await doWork();
+ *     span.setResult(String(result));
+ *     return result;
+ *   });
+ */
+export declare function startTrace<T>(name: string, fn: (span: TracedSpan) => T | Promise<T>): T | Promise<T>;
+/**
+ * Wrap a function call in a CLIENT span — the TypeScript equivalent of
+ * Python's `@shield360.trace` decorator.
+ *
+ * @example
+ *   const answer = await shield360.trace('my-chain', async (span) => {
+ *     const result = await chain.invoke({ question });
+ *     span.setResult(result.content);
+ *     return result;
+ *   });
+ */
+export declare function trace<T>(name: string, fn: (span: TracedSpan) => T | Promise<T>): T | Promise<T>;

package/dist/manual-trace.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracedSpan = void 0;
+exports.startTrace = startTrace;
+exports.trace = trace;
+const api_1 = require("@opentelemetry/api");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const config_1 = __importDefault(require("./config"));
+const semantic_convention_1 = __importDefault(require("./semantic-convention"));
+function getTracer() {
+    const provider = config_1.default.tracer;
+    return provider?.getTracer?.('shield360') ?? api_1.trace.getTracer('shield360');
+}
+function attachAppAttrs(span) {
+    span.setAttribute(semantic_conventions_1.ATTR_SERVICE_NAME, config_1.default.applicationName ?? 'default');
+    span.setAttribute(semantic_convention_1.default.ATTR_DEPLOYMENT_ENVIRONMENT, config_1.default.environment ?? 'default');
+}
+/**
+ * Wrapper for an OpenTelemetry span with helpers to set result and metadata.
+ * Mirrors Python's TracedSpan — the span lifecycle is managed by startTrace() /
+ * trace(), so you do not call end() yourself (like Python's `with` block).
+ */
+class TracedSpan {
+    constructor(span) {
+        this._span = span;
+    }
+    /** Record the AI output or function return value on the span. */
+    setResult(result) {
+        this._span.setAttribute(semantic_convention_1.default.GEN_AI_OUTPUT_MESSAGES, result);
+    }
+    /** Stamp arbitrary key/value attributes onto the span. */
+    setMetadata(metadata) {
+        this._span.setAttributes(metadata);
+    }
+}
+exports.TracedSpan = TracedSpan;
+function runInActiveSpan(name, fn) {
+    return getTracer().startActiveSpan(name, { kind: api_1.SpanKind.CLIENT }, (rawSpan) => {
+        attachAppAttrs(rawSpan);
+        const handle = new TracedSpan(rawSpan);
+        const endOk = () => {
+            rawSpan.setStatus({ code: api_1.SpanStatusCode.OK });
+            rawSpan.end();
+        };
+        const endError = (err) => {
+            rawSpan.recordException(err);
+            rawSpan.setStatus({
+                code: api_1.SpanStatusCode.ERROR,
+                message: String(err),
+            });
+            rawSpan.end();
+            throw err;
+        };
+        try {
+            const result = fn(handle);
+            if (result !== null && typeof result?.then === 'function') {
+                return result.then((val) => {
+                    endOk();
+                    return val;
+                }, (err) => endError(err));
+            }
+            endOk();
+            return result;
+        }
+        catch (err) {
+            return endError(err);
+        }
+    });
+}
+/**
+ * Start a named CLIENT span scoped to a callback — the TypeScript equivalent of
+ * Python's `with start_trace(name) as span:`.
+ *
+ * The span is active for the duration of `fn`, so child LLM spans nest correctly.
+ *
+ * @example
+ *   const answer = await shield360.startTrace('my-operation', async (span) => {
+ *     const result = await doWork();
+ *     span.setResult(String(result));
+ *     return result;
+ *   });
+ */
+function startTrace(name, fn) {
+    return runInActiveSpan(name, fn);
+}
+/**
+ * Wrap a function call in a CLIENT span — the TypeScript equivalent of
+ * Python's `@shield360.trace` decorator.
+ *
+ * @example
+ *   const answer = await shield360.trace('my-chain', async (span) => {
+ *     const result = await chain.invoke({ question });
+ *     span.setResult(result.content);
+ *     return result;
+ *   });
+ */
+function trace(name, fn) {
+    return runInActiveSpan(name, fn);
+}
+//# sourceMappingURL=manual-trace.js.map

package/dist/manual-trace.js.map

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

package/dist/otel/__tests__/metrics.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/otel/__tests__/metrics.test.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const metrics_1 = __importDefault(require("../metrics"));
+const semantic_convention_1 = __importDefault(require("../../semantic-convention"));
+const resources_1 = require("@opentelemetry/resources");
+const setupOpts = {
+    resource: (0, resources_1.defaultResource)(),
+    otlpEndpoint: 'http://localhost:4318',
+    environment: 'default',
+    applicationName: 'default',
+    disableBatch: false,
+    captureMessageContent: true,
+    disableMetrics: false,
+    disableEvents: false,
+};
+describe('Metrics creation', () => {
+    beforeEach(() => {
+        metrics_1.default.resetForTesting();
+        metrics_1.default.setup(setupOpts);
+    });
+    it('should create genaiClientUsageTokens histogram and allow record', () => {
+        expect(metrics_1.default.genaiClientUsageTokens).toBeDefined();
+        expect(typeof metrics_1.default.genaiClientUsageTokens.record).toBe('function');
+        expect(() => metrics_1.default.genaiClientUsageTokens.record(42, { [semantic_convention_1.default.GEN_AI_PROVIDER_NAME]: 'openai' })).not.toThrow();
+    });
+    it('should create genaiClientOperationDuration histogram and allow record', () => {
+        expect(metrics_1.default.genaiClientOperationDuration).toBeDefined();
+        expect(typeof metrics_1.default.genaiClientOperationDuration.record).toBe('function');
+        expect(() => metrics_1.default.genaiClientOperationDuration.record(1.23, { [semantic_convention_1.default.GEN_AI_PROVIDER_NAME]: 'openai' })).not.toThrow();
+    });
+    it('should create genaiCost histogram and allow record', () => {
+        expect(metrics_1.default.genaiCost).toBeDefined();
+        expect(typeof metrics_1.default.genaiCost.record).toBe('function');
+        expect(() => metrics_1.default.genaiCost.record(0.99, { [semantic_convention_1.default.GEN_AI_PROVIDER_NAME]: 'openai' })).not.toThrow();
+    });
+});
+//# sourceMappingURL=metrics.test.js.map

package/dist/otel/__tests__/metrics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.test.js","sourceRoot":"","sources":["../../../src/otel/__tests__/metrics.test.ts"],"names":[],"mappings":";;;;;AAAA,yDAAiC;AACjC,oFAA2D;AAC3D,wDAA2D;AAE3D,MAAM,SAAS,GAAG;IAChB,QAAQ,EAAE,IAAA,2BAAe,GAAE;IAC3B,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,SAAS;IACtB,eAAe,EAAE,SAAS;IAC1B,YAAY,EAAE,KAAK;IACnB,qBAAqB,EAAE,IAAI;IAC3B,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,KAAK;CACrB,CAAC;AAEF,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,UAAU,CAAC,GAAG,EAAE;QACd,iBAAO,CAAC,eAAe,EAAE,CAAC;QAC1B,iBAAO,CAAC,KAAK,CAAC,SAAgB,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,iBAAO,CAAC,sBAAsB,CAAC,CAAC,WAAW,EAAE,CAAC;QACrD,MAAM,CAAC,OAAO,iBAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,6BAAkB,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACjI,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,CAAC,iBAAO,CAAC,4BAA4B,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,CAAC,OAAO,iBAAO,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5E,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAO,CAAC,4BAA4B,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,6BAAkB,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACzI,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,iBAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,iBAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,6BAAkB,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACtH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/otel/events.d.ts

@@ -0,0 +1,11 @@
+import { logs } from '@opentelemetry/api-logs';
+import { LoggerProvider } from '@opentelemetry/sdk-logs';
+import { SetupEventsOptions } from '../types';
+export default class Events {
+    static loggerProvider: LoggerProvider;
+    static logger: ReturnType<typeof logs.getLogger>;
+    static setup(options: SetupEventsOptions): import("@opentelemetry/api-logs").Logger | null;
+    private static buildLoggerProvider;
+    private static createOTLPProcessor;
+    static resetForTesting(): void;
+}

package/dist/otel/events.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const api_logs_1 = require("@opentelemetry/api-logs");
+const sdk_logs_1 = require("@opentelemetry/sdk-logs");
+const exporter_logs_otlp_http_1 = require("@opentelemetry/exporter-logs-otlp-http");
+const utils_1 = require("./utils");
+let EVENTS_SET = false;
+class Events {
+    static setup(options) {
+        try {
+            if (!EVENTS_SET) {
+                const existingProvider = api_logs_1.logs.getLoggerProvider();
+                const isSDKProvider = existingProvider &&
+                    typeof existingProvider.forceFlush === 'function' &&
+                    existingProvider.constructor.name !== 'NoopLoggerProvider';
+                if (isSDKProvider) {
+                    this.loggerProvider = existingProvider;
+                }
+                else {
+                    this.loggerProvider = Events.buildLoggerProvider(options);
+                    api_logs_1.logs.setGlobalLoggerProvider(this.loggerProvider);
+                }
+                this.logger = this.loggerProvider.getLogger('shield360');
+                EVENTS_SET = true;
+            }
+            return this.logger;
+        }
+        catch (e) {
+            console.error('[Events] Failed to initialize events:', e);
+            return null;
+        }
+    }
+    static buildLoggerProvider(options) {
+        const exporterList = (0, utils_1.parseExporters)('OTEL_LOGS_EXPORTER');
+        const processors = [];
+        if (exporterList) {
+            for (const name of exporterList) {
+                if (name === 'otlp') {
+                    processors.push(Events.createOTLPProcessor(options));
+                }
+                else if (name === 'console') {
+                    processors.push(new sdk_logs_1.SimpleLogRecordProcessor({ exporter: new sdk_logs_1.ConsoleLogRecordExporter() }));
+                }
+            }
+        }
+        else {
+            if (options.otlpEndpoint) {
+                processors.push(Events.createOTLPProcessor(options));
+            }
+            else {
+                processors.push(new sdk_logs_1.SimpleLogRecordProcessor({ exporter: new sdk_logs_1.ConsoleLogRecordExporter() }));
+            }
+        }
+        return new sdk_logs_1.LoggerProvider({
+            resource: options.resource,
+            processors,
+        });
+    }
+    static createOTLPProcessor(options) {
+        const url = (options.otlpEndpoint || '') + '/v1/logs';
+        const exporter = new exporter_logs_otlp_http_1.OTLPLogExporter({
+            url,
+            headers: options.otlpHeaders,
+        });
+        return options.disableBatch
+            ? new sdk_logs_1.SimpleLogRecordProcessor({ exporter })
+            : new sdk_logs_1.BatchLogRecordProcessor({ exporter });
+    }
+    static resetForTesting() {
+        EVENTS_SET = false;
+    }
+}
+exports.default = Events;
+//# sourceMappingURL=events.js.map

package/dist/otel/events.js.map

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

package/dist/otel/metrics.d.ts

@@ -0,0 +1,35 @@
+import { MeterProvider, PeriodicExportingMetricReader } from '@opentelemetry/sdk-metrics';
+import { metrics } from '@opentelemetry/api';
+import { SetupMetricsOptions } from '../types';
+export default class Metrics {
+    static meterProvider: MeterProvider;
+    static meter: ReturnType<typeof metrics.getMeter>;
+    static metricReaders: PeriodicExportingMetricReader[];
+    static genaiClientUsageTokens: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static genaiClientOperationDuration: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static genaiServerTbt: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static genaiServerTtft: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static genaiClientTimeToFirstChunk: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static genaiClientTimePerOutputChunk: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static genaiServerRequestDuration: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static dbClientOperationDuration: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static genaiCost: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static dbRequests: ReturnType<ReturnType<typeof metrics.getMeter>['createCounter']>;
+    static guardRequests: ReturnType<ReturnType<typeof metrics.getMeter>['createCounter']>;
+    static mcpRequests: ReturnType<ReturnType<typeof metrics.getMeter>['createCounter']>;
+    static mcpClientOperationDuration: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static mcpRequestSize: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static mcpResponseSize: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static mcpToolCalls: ReturnType<ReturnType<typeof metrics.getMeter>['createCounter']>;
+    static mcpResourceReads: ReturnType<ReturnType<typeof metrics.getMeter>['createCounter']>;
+    static mcpPromptGets: ReturnType<ReturnType<typeof metrics.getMeter>['createCounter']>;
+    static mcpTransportUsage: ReturnType<ReturnType<typeof metrics.getMeter>['createCounter']>;
+    static mcpErrors: ReturnType<ReturnType<typeof metrics.getMeter>['createCounter']>;
+    static mcpOperationSuccessRate: ReturnType<ReturnType<typeof metrics.getMeter>['createHistogram']>;
+    static initializeMetrics(): void;
+    static setup(options: SetupMetricsOptions): import("@opentelemetry/api").Meter | null;
+    private static buildMetricReaders;
+    private static createOTLPReader;
+    private static createConsoleReader;
+    static resetForTesting(): void;
+}