@turingpulse/sdk 1.0.1

package/dist/registry.d.ts

@@ -0,0 +1,13 @@
+export interface TriggerEntry {
+    key: string;
+    fn: (...args: unknown[]) => unknown;
+    description?: string;
+}
+export declare class TriggerRegistry {
+    private readonly entries;
+    register(key: string, fn: (...args: unknown[]) => unknown, description?: string): void;
+    unregister(key: string): void;
+    get(key: string): TriggerEntry | undefined;
+    list(): TriggerEntry[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAItF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI1C,IAAI,IAAI,YAAY,EAAE;CAGvB"}

package/dist/registry.js

@@ -0,0 +1,18 @@
+export class TriggerRegistry {
+    constructor() {
+        this.entries = new Map();
+    }
+    register(key, fn, description) {
+        this.entries.set(key, { key, fn, description });
+    }
+    unregister(key) {
+        this.entries.delete(key);
+    }
+    get(key) {
+        return this.entries.get(key);
+    }
+    list() {
+        return Array.from(this.entries.values());
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,eAAe;IAA5B;QACmB,YAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAiB7D,CAAC;IAfC,QAAQ,CAAC,GAAW,EAAE,EAAmC,EAAE,WAAoB;QAC7E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/tracing.d.ts

@@ -0,0 +1,10 @@
+import { TuringPulseConfig } from './config';
+type Attributes = Record<string, string>;
+export declare class TracingManager {
+    private readonly config;
+    private readonly tracer;
+    constructor(config: TuringPulseConfig);
+    withSpan<T>(name: string, attributes: Attributes, enabled: boolean, fn: () => T): T;
+}
+export {};
+//# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzC,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAEK,MAAM,EAAE,iBAAiB;IAItD,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;CAwBpF"}

package/dist/tracing.js

@@ -0,0 +1,30 @@
+import { trace, SpanStatusCode } from '@opentelemetry/api';
+import { isPromise } from './utils';
+export class TracingManager {
+    constructor(config) {
+        this.config = config;
+        this.tracer = trace.getTracer(config.traceServiceName);
+    }
+    withSpan(name, attributes, enabled, fn) {
+        if (!this.config.traceEnabled || !enabled) {
+            return fn();
+        }
+        return this.tracer.startActiveSpan(name, { attributes }, (span) => {
+            try {
+                const result = fn();
+                if (isPromise(result)) {
+                    return result.finally(() => span.end());
+                }
+                span.end();
+                return result;
+            }
+            catch (error) {
+                span.recordException(error);
+                span.setStatus({ code: SpanStatusCode.ERROR });
+                span.end();
+                throw error;
+            }
+        });
+    }
+}
+//# sourceMappingURL=tracing.js.map

package/dist/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIpC,MAAM,OAAO,cAAc;IAGzB,YAA6B,MAAyB;QAAzB,WAAM,GAAN,MAAM,CAAmB;QACpD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACzD,CAAC;IAED,QAAQ,CAAI,IAAY,EAAE,UAAsB,EAAE,OAAgB,EAAE,EAAW;QAC7E,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1C,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAChC,IAAI,EACJ,EAAE,UAAU,EAAE,EACd,CAAC,IAAI,EAAE,EAAE;YACP,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;gBACpB,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;oBACtB,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAM,CAAC;gBAC/C,CAAC;gBACD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACX,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,eAAe,CAAC,KAAc,CAAC,CAAC;gBACrC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACX,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/triggerState.d.ts

@@ -0,0 +1,5 @@
+export declare function queueTrigger(key: string, fn: (...args: unknown[]) => unknown, description?: string): void;
+export declare function flushPending(plugin: {
+    registerTrigger: (key: string, fn: (...args: unknown[]) => unknown, description?: string) => string;
+}): void;
+//# sourceMappingURL=triggerState.d.ts.map

package/dist/triggerState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggerState.d.ts","sourceRoot":"","sources":["../src/triggerState.ts"],"names":[],"mappings":"AAUA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,GAAG,IAAI,CAYlJ"}

package/dist/triggerState.js

@@ -0,0 +1,19 @@
+import { markTriggerRegistered } from './utils';
+const pending = [];
+export function queueTrigger(key, fn, description) {
+    pending.push({ key, fn, description });
+}
+export function flushPending(plugin) {
+    if (!pending.length) {
+        return;
+    }
+    while (pending.length) {
+        const item = pending.shift();
+        if (!item) {
+            continue;
+        }
+        plugin.registerTrigger(item.key, item.fn, item.description);
+        markTriggerRegistered(item.fn);
+    }
+}
+//# sourceMappingURL=triggerState.js.map

package/dist/triggerState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggerState.js","sourceRoot":"","sources":["../src/triggerState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAQhD,MAAM,OAAO,GAAqB,EAAE,CAAC;AAErC,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,EAAmC,EAAE,WAAoB;IACjG,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA+G;IAC1I,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QACD,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5D,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Convert a camelCase string to snake_case.
+ * e.g. "runId" → "run_id", "durationMs" → "duration_ms"
+ */
+export declare function toSnake(s: string): string;
+/** Type guard for thenables (Promises). Shared by plugin and tracing. */
+export declare function isPromise<T>(value: T | Promise<T>): value is Promise<T>;
+/** Type guard for async iterables (streaming responses). */
+export declare function isAsyncIterable(value: unknown): value is AsyncIterable<unknown>;
+/** Safe access to process.env — returns undefined in browser environments. */
+export declare function safeEnv(key: string): string | undefined;
+/** Keys that must never be assigned as own properties to prevent prototype pollution. */
+export declare const FORBIDDEN_KEYS: Set<string>;
+/** Extract only the safe message string from an unknown error. */
+export declare function safeErrorMessage(err: unknown): string;
+/** Mark a function as having its trigger registered. */
+export declare function markTriggerRegistered(fn: (...args: unknown[]) => unknown): void;
+/** Check whether a function's trigger has been registered. */
+export declare function isTriggerRegistered(fn: (...args: unknown[]) => unknown): boolean;
+/**
+ * Deep-convert all object keys from camelCase to snake_case.
+ * Arrays are recursed; primitives are returned as-is.
+ * This is necessary because the ingestion service (Python) expects
+ * snake_case keys while the TypeScript interfaces use camelCase.
+ */
+export declare function toSnakeCaseDeep(obj: unknown): unknown;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAEvE;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,CAM/E;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMvD;AAED,yFAAyF;AACzF,eAAO,MAAM,cAAc,aAAqD,CAAC;AAEjF,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAIrD;AAID,wDAAwD;AACxD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAM/E;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,OAAO,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAcrD"}

package/dist/utils.js

@@ -0,0 +1,72 @@
+/**
+ * Convert a camelCase string to snake_case.
+ * e.g. "runId" → "run_id", "durationMs" → "duration_ms"
+ */
+export function toSnake(s) {
+    return s.replace(/[A-Z]/g, (ch) => `_${ch.toLowerCase()}`);
+}
+/** Type guard for thenables (Promises). Shared by plugin and tracing. */
+export function isPromise(value) {
+    return typeof value?.then === 'function';
+}
+/** Type guard for async iterables (streaming responses). */
+export function isAsyncIterable(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        typeof value[Symbol.asyncIterator] === 'function');
+}
+/** Safe access to process.env — returns undefined in browser environments. */
+export function safeEnv(key) {
+    try {
+        return typeof process !== 'undefined' && process.env ? process.env[key] : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Keys that must never be assigned as own properties to prevent prototype pollution. */
+export const FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+/** Extract only the safe message string from an unknown error. */
+export function safeErrorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    return 'unknown error';
+}
+const TRIGGER_PROP = '__turingpulseTriggerRegistered';
+/** Mark a function as having its trigger registered. */
+export function markTriggerRegistered(fn) {
+    Object.defineProperty(fn, TRIGGER_PROP, {
+        value: true,
+        configurable: true,
+        writable: true,
+    });
+}
+/** Check whether a function's trigger has been registered. */
+export function isTriggerRegistered(fn) {
+    return Boolean(fn[TRIGGER_PROP]);
+}
+/**
+ * Deep-convert all object keys from camelCase to snake_case.
+ * Arrays are recursed; primitives are returned as-is.
+ * This is necessary because the ingestion service (Python) expects
+ * snake_case keys while the TypeScript interfaces use camelCase.
+ */
+export function toSnakeCaseDeep(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map(toSnakeCaseDeep);
+    }
+    if (obj !== null && typeof obj === 'object' && !(obj instanceof Date)) {
+        const out = Object.create(null);
+        for (const [k, v] of Object.entries(obj)) {
+            const snaked = toSnake(k);
+            if (FORBIDDEN_KEYS.has(k) || FORBIDDEN_KEYS.has(snaked))
+                continue;
+            out[snaked] = toSnakeCaseDeep(v);
+        }
+        return out;
+    }
+    return obj;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAI,KAAqB;IAChD,OAAO,OAAQ,KAAoB,EAAE,IAAI,KAAK,UAAU,CAAC;AAC3D,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAAgC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,UAAU,CAC9E,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAEjF,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAEtD,wDAAwD;AACxD,MAAM,UAAU,qBAAqB,CAAC,EAAmC;IACvE,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,YAAY,EAAE;QACtC,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;AACL,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,mBAAmB,CAAC,EAAmC;IACrE,OAAO,OAAO,CAAE,EAAyC,CAAC,YAAY,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,YAAY,IAAI,CAAC,EAAE,CAAC;QACtE,MAAM,GAAG,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;YACpE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,SAAS;YAClE,GAAG,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@turingpulse/sdk",
+  "version": "1.0.1",
+  "license": "SEE LICENSE IN LICENSE",
+  "description": "TypeScript decorators and helpers for TuringPulse observability, governance, and KPI mapping.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "workspaces": [
+    "packages/*"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@turingpulse/interfaces": ">=1.0.0",
+    "@opentelemetry/api": "^1.9.0",
+    "node-fetch": "^3.3.2",
+    "uuid": "^9.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.4",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  }
+}

package/packages/anthropic/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@turingpulse/sdk-anthropic",
+  "version": "1.0.1",
+  "license": "SEE LICENSE IN LICENSE",
+  "description": "TuringPulse SDK integration for Anthropic (TypeScript)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@turingpulse/sdk": ">=1.0.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.30.0",
+    "typescript": ">=5.0.0"
+  }
+}

package/packages/anthropic/src/index.ts

@@ -0,0 +1,5 @@
+/**
+ * TuringPulse SDK integration for Anthropic (TypeScript).
+ */
+
+export { patchAnthropic, unpatchAnthropic } from './wrapper';

package/packages/anthropic/src/wrapper.ts

@@ -0,0 +1,102 @@
+import { withInstrumentation, GovernanceDirective, ConfigurationError, currentContext } from '@turingpulse/sdk';
+
+let _originalCreate: unknown = null;
+let _patchedProto: Record<string, unknown> | null = null;
+
+interface PatchAnthropicOptions {
+  name?: string;
+  governance?: GovernanceDirective;
+  /**
+   * Pass your own imported Anthropic module to avoid module resolution mismatches.
+   * Accepts the default export class from `import Anthropic from '@anthropic-ai/sdk'`
+   * or the full module namespace.
+   */
+  anthropicModule?: unknown;
+}
+
+function resolveMessagesProto(mod: unknown): Record<string, unknown> | undefined {
+  const cls = (mod as Record<string, unknown>)?.default ?? mod;
+  const messages = (cls as Record<string, unknown>)?.Messages as Record<string, unknown> | undefined;
+  return messages?.prototype as Record<string, unknown> | undefined;
+}
+
+/**
+ * Monkey-patch Anthropic messages.create for TuringPulse instrumentation.
+ */
+export async function patchAnthropic(options: PatchAnthropicOptions = {}): Promise<void> {
+  const effectiveName = options.name || (typeof process !== 'undefined' ? process.env?.TP_WORKFLOW_NAME : undefined) || '';
+  if (!effectiveName) {
+    throw new ConfigurationError('patchAnthropic() requires name or TP_WORKFLOW_NAME env var.');
+  }
+
+  let messagesProto: Record<string, unknown> | undefined;
+
+  if (options.anthropicModule) {
+    messagesProto = resolveMessagesProto(options.anthropicModule);
+  } else {
+    try {
+      const mod = await import('@anthropic-ai/sdk');
+      messagesProto = resolveMessagesProto(mod);
+    } catch {
+      throw new Error('@anthropic-ai/sdk package is required: npm install @anthropic-ai/sdk');
+    }
+  }
+
+  if (!messagesProto) {
+    console.warn('Cannot locate Anthropic.Messages.prototype — skipping patch');
+    return;
+  }
+
+  if (_originalCreate !== null) {
+    console.warn('Anthropic is already patched — skipping');
+    return;
+  }
+
+  _originalCreate = messagesProto.create;
+  _patchedProto = messagesProto;
+
+  const wrappedCreate = withInstrumentation(
+    async function anthropicCreate(this: unknown, ...args: unknown[]): Promise<unknown> {
+      const original = _originalCreate as (...args: unknown[]) => Promise<unknown>;
+      const response = await original.apply(this, args);
+
+      const ctx = currentContext();
+      if (ctx) {
+        ctx.framework = 'anthropic';
+        ctx.nodeType = 'llm';
+
+        const resp = response as Record<string, unknown>;
+        const usage = resp?.usage as { input_tokens?: number; output_tokens?: number } | undefined;
+        if (usage) {
+          ctx.setTokens(usage.input_tokens ?? 0, usage.output_tokens ?? 0);
+        }
+        const modelName = (resp?.model as string) ?? 'unknown';
+        ctx.setModel(modelName, 'anthropic');
+
+        const firstArg = args[0] as Record<string, unknown> | undefined;
+        if (firstArg?.messages) {
+          ctx.setIO(JSON.stringify(firstArg.messages), JSON.stringify(resp?.content));
+        }
+      }
+
+      return response;
+    },
+    { name: effectiveName, governance: options.governance },
+  );
+
+  messagesProto.create = wrappedCreate;
+}
+
+/**
+ * Restore original Anthropic methods.
+ */
+export async function unpatchAnthropic(): Promise<void> {
+  if (_originalCreate === null) return;
+
+  if (_patchedProto) {
+    _patchedProto.create = _originalCreate;
+    _patchedProto = null;
+  }
+
+  _originalCreate = null;
+}

package/packages/anthropic/tsconfig.build.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "sourceMap": true,
+    "paths": {
+      "@turingpulse/sdk": ["../../src/index.ts"]
+    }
+  },
+  "include": ["src"]
+}

package/packages/langchain/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@turingpulse/sdk-langchain",
+  "version": "1.0.1",
+  "license": "SEE LICENSE IN LICENSE",
+  "description": "TuringPulse SDK integration for LangChain.js",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@turingpulse/sdk": ">=1.0.0",
+    "@langchain/core": ">=1.1.24"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  }
+}

package/packages/langchain/src/index.ts

@@ -0,0 +1,7 @@
+/**
+ * TuringPulse SDK integration for LangChain.js.
+ *
+ * Wraps LangChain Runnables and Chains for observability.
+ */
+
+export { instrumentLangchain } from './wrapper';

package/packages/langchain/src/wrapper.ts

@@ -0,0 +1,51 @@
+import { withInstrumentation, GovernanceDirective, currentContext } from '@turingpulse/sdk';
+
+interface LangchainInstrumentOptions {
+  name: string;
+  governance?: GovernanceDirective;
+  model?: string;
+  provider?: string;
+}
+
+/**
+ * Wrap a LangChain Runnable for TuringPulse observability.
+ */
+export function instrumentLangchain(
+  runnable: { invoke: (input: unknown, config?: unknown) => Promise<unknown> },
+  options: LangchainInstrumentOptions,
+): (input: unknown, config?: unknown) => Promise<unknown> {
+  const { name, governance, model, provider = 'openai' } = options;
+
+  const wrappedFn = withInstrumentation(
+    async function langchainInvoke(input: unknown, config?: unknown): Promise<unknown> {
+      const result = await runnable.invoke(input, config);
+
+      const ctx = currentContext();
+      if (ctx) {
+        ctx.framework = 'langchain';
+        ctx.nodeType = 'llm';
+        if (model) ctx.setModel(model, provider);
+
+        const resp = result as Record<string, unknown> | null;
+        const content = typeof resp?.content === 'string' ? resp.content : '';
+
+        const responseMeta = resp?.response_metadata as Record<string, unknown> | undefined;
+        const tokenUsage = responseMeta?.tokenUsage as { promptTokens?: number; completionTokens?: number } | undefined;
+        if (tokenUsage) {
+          ctx.setTokens(tokenUsage.promptTokens ?? 0, tokenUsage.completionTokens ?? 0);
+        }
+
+        const detectedModel = (responseMeta?.model_name as string) ?? model;
+        if (detectedModel) ctx.setModel(detectedModel, provider);
+
+        const inputStr = typeof input === 'string' ? input : JSON.stringify(input);
+        ctx.setIO(inputStr, content || JSON.stringify(result));
+      }
+
+      return result;
+    },
+    { name, governance },
+  );
+
+  return wrappedFn as (input: unknown, config?: unknown) => Promise<unknown>;
+}

package/packages/mastra/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@turingpulse/sdk-mastra",
+  "version": "1.0.1",
+  "license": "SEE LICENSE IN LICENSE",
+  "description": "TuringPulse SDK integration for Mastra",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@turingpulse/sdk": ">=1.0.0",
+    "@turingpulse/interfaces": ">=1.0.0"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=1.4.0",
+    "typescript": ">=5.0.0"
+  }
+}

package/packages/mastra/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * TuringPulse SDK integration for Mastra.
+ *
+ * Re-exports the existing Mastra instrumentation from the core SDK.
+ */
+
+export { instrumentMastra } from './wrapper';
+export type { MastraInstrumentOptions, MastraToolCallRecord } from './wrapper';