@turingpulse/sdk 1.0.1

package/dist/attachments.js

@@ -0,0 +1,59 @@
+/**
+ * Document attachment support for the TuringPulse TypeScript SDK.
+ *
+ * Provides AttachmentManager for uploading documents to the ingestion service
+ * and injecting attachment metadata into the current span.
+ *
+ * Design principle: NEVER crash customer code. All upload failures are logged
+ * and silently ignored.
+ */
+export class AttachmentManager {
+    constructor(config, enabled = true) {
+        this.config = config;
+        this.baseUrl = config.endpoint;
+        this.enabled = enabled;
+    }
+    async attachBytes(data, filename, direction = 'input', mimeType) {
+        if (!this.enabled)
+            return undefined;
+        try {
+            const formData = new FormData();
+            const blob = new Blob([data], { type: mimeType ?? 'application/octet-stream' });
+            formData.append('file', blob, filename);
+            formData.append('direction', direction);
+            const fetchImpl = this.config.fetchImpl ?? globalThis.fetch;
+            const response = await fetchImpl(`${this.baseUrl}/api/v1/attachments`, {
+                method: 'POST',
+                headers: {
+                    'X-API-Key': this.config.apiKey,
+                },
+                body: formData,
+            });
+            if (!response.ok) {
+                // eslint-disable-next-line no-console
+                console.warn(`TuringPulse attachment upload failed: ${response.status}`);
+                return undefined;
+            }
+            const result = (await response.json());
+            return {
+                attachmentId: result.attachment_id,
+                filename: result.filename,
+                mimeType: result.mime_type,
+                sizeBytes: result.size_bytes,
+                storagePath: result.storage_path,
+                direction,
+                deduplicated: Boolean(result.deduplicated),
+            };
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn('TuringPulse attachment upload failed:', err instanceof Error ? err.message : String(err));
+            return undefined;
+        }
+    }
+    async attachText(text, filename = 'document.txt', direction = 'input') {
+        const encoder = new TextEncoder();
+        return this.attachBytes(encoder.encode(text), filename, direction, 'text/plain');
+    }
+}
+//# sourceMappingURL=attachments.js.map

package/dist/attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,MAAM,OAAO,iBAAiB;IAK5B,YAAY,MAAyB,EAAE,OAAO,GAAG,IAAI;QACnD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,WAAW,CACf,IAAyB,EACzB,QAAgB,EAChB,YAAgC,OAAO,EACvC,QAAiB;QAEjB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAEpC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,IAAI,0BAA0B,EAAE,CAAC,CAAC;YAC5F,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YACxC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAExC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC;YAC5D,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,qBAAqB,EAAE;gBACrE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;iBAChC;gBACD,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,sCAAsC;gBACtC,OAAO,CAAC,IAAI,CAAC,yCAAyC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBACzE,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;YAClE,OAAO;gBACL,YAAY,EAAE,MAAM,CAAC,aAAuB;gBAC5C,QAAQ,EAAE,MAAM,CAAC,QAAkB;gBACnC,QAAQ,EAAE,MAAM,CAAC,SAAmB;gBACpC,SAAS,EAAE,MAAM,CAAC,UAAoB;gBACtC,WAAW,EAAE,MAAM,CAAC,YAAsB;gBAC1C,SAAS;gBACT,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;aAC3C,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,sCAAsC;YACtC,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACxG,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CACd,IAAY,EACZ,QAAQ,GAAG,cAAc,EACzB,YAAgC,OAAO;QAEvC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACnF,CAAC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,72 @@
+import { FingerprintConfig } from './fingerprint';
+export type FetchLike = (url: string | URL, init?: RequestInit) => Promise<Response>;
+export interface GovernanceDefaults {
+    hitl?: boolean;
+    reviewers?: string[];
+    escalationChannels?: string[];
+    metadata?: Record<string, string>;
+    severity?: string;
+    autoEscalateAfterSeconds?: number;
+}
+/**
+ * Configuration options for the TuringPulse SDK.
+ *
+ * Required:
+ *   apiKey       - SDK API key. The backend resolves tenant and project from it.
+ *   workflowName - Display name for this workflow.
+ *
+ * Optional:
+ *   endpoint     - Base URL for the TuringPulse API (default: https://api.turingpulse.ai).
+ */
+export interface TuringPulseConfigOptions {
+    /** SDK API key (required). */
+    apiKey: string;
+    /** Workflow display name (required). */
+    workflowName: string;
+    /** Base URL for the TuringPulse API. Override for self-hosted or staging. */
+    endpoint?: string;
+    defaultLabels?: Record<string, string>;
+    traceEnabled?: boolean;
+    traceServiceName?: string;
+    triggerNamespace?: string;
+    timeoutMs?: number;
+    maxRetries?: number;
+    fetchImpl?: FetchLike;
+    governanceDefaults?: GovernanceDefaults;
+    fingerprint?: FingerprintConfig;
+    captureArguments?: boolean;
+    captureReturnValue?: boolean;
+    maxSerializedFieldLength?: number;
+    redactFields?: string[];
+}
+export declare const DEFAULT_ENDPOINT = "https://api.turingpulse.ai";
+interface ResolvedGovernanceDefaults {
+    hitl: boolean;
+    reviewers: string[];
+    escalationChannels: string[];
+    metadata: Record<string, string>;
+    severity: string;
+    autoEscalateAfterSeconds: number | undefined;
+}
+export declare class TuringPulseConfig {
+    readonly apiKey: string;
+    readonly workflowName: string;
+    readonly endpoint: string;
+    readonly defaultLabels: Record<string, string>;
+    readonly traceEnabled: boolean;
+    readonly traceServiceName: string;
+    readonly triggerNamespace: string;
+    readonly timeoutMs: number;
+    readonly maxRetries: number;
+    readonly fetchImpl?: FetchLike;
+    readonly governanceDefaults: ResolvedGovernanceDefaults;
+    readonly fingerprint: Required<FingerprintConfig>;
+    readonly captureArguments: boolean;
+    readonly captureReturnValue: boolean;
+    readonly maxSerializedFieldLength: number;
+    readonly redactFields: string[];
+    constructor(options: TuringPulseConfigOptions);
+    mergedLabels(labels?: Record<string, string>): Record<string, string>;
+}
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -0,0 +1,78 @@
+import { DEFAULT_FINGERPRINT_CONFIG } from './fingerprint';
+const CRLF_RE = /[\r\n\x00]/g;
+function stripControlChars(value) {
+    return value.replace(CRLF_RE, '');
+}
+const BLOCKED_HOSTS = /^(127\.\d{1,3}\.\d{1,3}\.\d{1,3}|10\.\d{1,3}\.\d{1,3}\.\d{1,3}|172\.(1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3}|169\.254\.\d{1,3}\.\d{1,3}|0\.0\.0\.0|localhost|\[::1\]|\[fd[0-9a-f]{2}:|\[fe80:)$/i;
+function checkEndpointSsrf(endpoint) {
+    try {
+        const parsed = new URL(endpoint);
+        if (BLOCKED_HOSTS.test(parsed.hostname)) {
+            throw new Error('TuringPulse endpoint must not point to private/internal networks.');
+        }
+    }
+    catch (e) {
+        if (e instanceof Error && e.message.includes('private/internal'))
+            throw e;
+    }
+}
+export const DEFAULT_ENDPOINT = 'https://api.turingpulse.ai';
+const DEFAULT_GOVERNANCE = {
+    hitl: false,
+    reviewers: [],
+    escalationChannels: [],
+    metadata: {},
+    severity: 'medium',
+    autoEscalateAfterSeconds: undefined,
+};
+export class TuringPulseConfig {
+    constructor(options) {
+        if (!options.apiKey || !options.apiKey.trim()) {
+            throw new Error('TuringPulse apiKey is required and cannot be empty. ' +
+                'Set the TP_API_KEY environment variable or pass apiKey to init().');
+        }
+        this.apiKey = stripControlChars(options.apiKey.trim());
+        if (!options.workflowName || !options.workflowName.trim()) {
+            throw new Error('TuringPulse workflowName is required and cannot be empty. ' +
+                'Pass workflowName to init(). Example: init({ apiKey: "...", workflowName: "My Agent" })');
+        }
+        this.workflowName = options.workflowName.trim();
+        const raw = stripControlChars(options.endpoint ?? DEFAULT_ENDPOINT);
+        this.endpoint = raw.replace(/\/$/, '');
+        if (this.endpoint && !/^https?:\/\//.test(this.endpoint)) {
+            throw new Error('TuringPulse endpoint must start with https:// or http://');
+        }
+        checkEndpointSsrf(this.endpoint);
+        if (this.endpoint.startsWith('http://')) {
+            // eslint-disable-next-line no-console
+            console.warn('TuringPulse endpoint uses http:// \u2014 API key will be sent in cleartext. Use https:// in production.');
+        }
+        this.defaultLabels = { ...(options.defaultLabels ?? {}) };
+        this.traceEnabled = options.traceEnabled ?? true;
+        this.traceServiceName = options.traceServiceName ?? 'turingpulse.sdk';
+        this.triggerNamespace = options.triggerNamespace ?? 'default';
+        this.timeoutMs = Math.min(options.timeoutMs ?? 10000, 120000);
+        this.maxRetries = options.maxRetries ?? 3;
+        this.fetchImpl = options.fetchImpl;
+        this.governanceDefaults = {
+            hitl: options.governanceDefaults?.hitl ?? DEFAULT_GOVERNANCE.hitl,
+            reviewers: options.governanceDefaults?.reviewers ?? DEFAULT_GOVERNANCE.reviewers,
+            escalationChannels: options.governanceDefaults?.escalationChannels ?? DEFAULT_GOVERNANCE.escalationChannels,
+            metadata: { ...DEFAULT_GOVERNANCE.metadata, ...(options.governanceDefaults?.metadata ?? {}) },
+            severity: options.governanceDefaults?.severity ?? DEFAULT_GOVERNANCE.severity,
+            autoEscalateAfterSeconds: options.governanceDefaults?.autoEscalateAfterSeconds ?? DEFAULT_GOVERNANCE.autoEscalateAfterSeconds,
+        };
+        this.fingerprint = {
+            ...DEFAULT_FINGERPRINT_CONFIG,
+            ...(options.fingerprint ?? {}),
+        };
+        this.captureArguments = options.captureArguments ?? false;
+        this.captureReturnValue = options.captureReturnValue ?? false;
+        this.maxSerializedFieldLength = options.maxSerializedFieldLength ?? 50000;
+        this.redactFields = options.redactFields ?? [];
+    }
+    mergedLabels(labels) {
+        return { ...this.defaultLabels, ...(labels ?? {}) };
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,126 @@
+import type { FingerprintBuilder } from './fingerprint';
+export declare function generateUUID(): string;
+/** Structured tool call record matching the shared ToolCallInfo model. */
+export interface ToolCallRecord {
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    toolResult?: string;
+    toolId?: string;
+    success: boolean;
+    errorMessage?: string;
+}
+/**
+ * Initialization options for ExecutionContext.
+ *
+ * REFACTORED:
+ * - Added workflowName for display name (from @instrument(name="..."))
+ * - agentId is kept for backward compatibility
+ * - Backend auto-registers workflows based on workflowName
+ */
+export interface ExecutionContextInit {
+    runId: string;
+    /** @deprecated Use workflowName instead */
+    agentId?: string;
+    operation: string;
+    triggerKey?: string;
+    hiddenEntrypoint?: boolean;
+    labels: Record<string, string>;
+    metadata: Record<string, string>;
+    args: unknown[];
+    fingerprintBuilder?: FingerprintBuilder;
+    /** @deprecated Backend assigns UUID */
+    workflowId?: string;
+    /** Display name from @instrument(name="...") */
+    workflowName?: string;
+    /** Unique identifier for this span (auto-generated if not provided). */
+    spanId?: string;
+    /** Parent span ID for trace hierarchy (root spans have no parent). */
+    parentSpanId?: string;
+    /** Nesting depth: 0 for root, parent.depth + 1 for children. */
+    depth?: number;
+}
+/**
+ * Execution context for instrumented functions.
+ *
+ * REFACTORED:
+ * - workflowName: Display name from @instrument(name="...") - sent to backend
+ * - agentId: DEPRECATED - kept for backward compatibility
+ * - Backend auto-registers workflows based on workflowName and assigns UUID
+ */
+export declare class ExecutionContext {
+    readonly runId: string;
+    /** @deprecated Use workflowName instead */
+    readonly agentId: string;
+    readonly operation: string;
+    readonly triggerKey?: string;
+    readonly hiddenEntrypoint: boolean;
+    readonly labels: Record<string, string>;
+    readonly metadata: Record<string, string>;
+    readonly args: unknown[];
+    readonly startedAt: Date;
+    readonly fingerprintBuilder?: FingerprintBuilder;
+    /** @deprecated Backend assigns UUID */
+    readonly workflowId?: string;
+    /** Display name from @instrument(name="...") - sent to backend */
+    readonly workflowName?: string;
+    completedAt?: Date;
+    error?: unknown;
+    result?: unknown;
+    status: 'pending' | 'success' | 'error' | 'blocked';
+    readonly spanId: string;
+    readonly parentSpanId?: string;
+    readonly depth: number;
+    tokensInput: number;
+    tokensOutput: number;
+    costUsd: number;
+    model?: string;
+    provider?: string;
+    nodeType?: string;
+    framework?: string;
+    promptText?: string;
+    systemPrompt?: string;
+    inputData?: string;
+    outputData?: string;
+    availableTools?: string[];
+    toolCalls: ToolCallRecord[];
+    attachments: Record<string, unknown>[];
+    inputContext?: string;
+    constructor(init: ExecutionContextInit);
+    finish(result?: unknown, error?: unknown): void;
+    get durationMs(): number | undefined;
+    /** Record token counts for this span. */
+    setTokens(input: number, output: number): void;
+    /** Record LLM cost in USD. */
+    setCost(cost: number): void;
+    /** Record the LLM model and provider used. */
+    setModel(model: string, provider?: string): void;
+    /** Record prompt and optional system prompt. */
+    setPrompt(prompt: string, systemPrompt?: string): void;
+    /** Record input/output data for this span. */
+    setIO(inputData?: string, outputData?: string): void;
+    /** Record RAG retrieval context for faithfulness evaluation. */
+    setInputContext(context: string): void;
+    /** Add a structured tool call record (capped at 200 per span). */
+    addToolCall(record: ToolCallRecord): void;
+    /**
+     * Record a node in the fingerprint.
+     *
+     * Called automatically during instrumentation to track workflow structure.
+     *
+     * @param name - Node name (typically the function name)
+     * @param nodeType - Type of node (llm, tool, function, retriever, etc.)
+     * @param config - Configuration dict for the node
+     * @param prompt - System prompt for LLM nodes
+     */
+    recordNode(name: string, nodeType: string, config?: unknown, prompt?: string): void;
+}
+declare class ContextStorage {
+    private readonly storage;
+    private fallback?;
+    run<T>(context: ExecutionContext, fn: () => T): T;
+    get(): ExecutionContext | undefined;
+}
+export declare const contextStorage: ContextStorage;
+export declare function currentContext(): ExecutionContext | undefined;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

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

package/dist/context.js

@@ -0,0 +1,163 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomUUID } from 'node:crypto';
+import { GovernanceBlockedError } from './errors';
+export function generateUUID() {
+    if (typeof globalThis.crypto?.randomUUID === 'function') {
+        return globalThis.crypto.randomUUID();
+    }
+    try {
+        return randomUUID();
+    }
+    catch {
+        if (typeof globalThis.crypto?.getRandomValues === 'function') {
+            const bytes = new Uint8Array(16);
+            globalThis.crypto.getRandomValues(bytes);
+            bytes[6] = (bytes[6] & 0x0f) | 0x40;
+            bytes[8] = (bytes[8] & 0x3f) | 0x80;
+            const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
+            return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+        }
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+            const r = (Math.random() * 16) | 0;
+            return (c === 'x' ? r : (r & 0x3) | 0x8).toString(16);
+        });
+    }
+}
+const AsyncLocalStorageCtor = AsyncLocalStorage;
+/**
+ * Execution context for instrumented functions.
+ *
+ * REFACTORED:
+ * - workflowName: Display name from @instrument(name="...") - sent to backend
+ * - agentId: DEPRECATED - kept for backward compatibility
+ * - Backend auto-registers workflows based on workflowName and assigns UUID
+ */
+export class ExecutionContext {
+    constructor(init) {
+        this.status = 'pending';
+        // ── Telemetry fields (parity with Python SDK) ──
+        this.tokensInput = 0;
+        this.tokensOutput = 0;
+        this.costUsd = 0;
+        this.toolCalls = [];
+        this.attachments = [];
+        this.runId = init.runId;
+        this.agentId = init.agentId ?? init.workflowName ?? '';
+        this.operation = init.operation;
+        this.triggerKey = init.triggerKey;
+        this.hiddenEntrypoint = Boolean(init.hiddenEntrypoint);
+        this.labels = init.labels;
+        this.metadata = init.metadata;
+        this.args = init.args;
+        this.startedAt = new Date();
+        this.fingerprintBuilder = init.fingerprintBuilder;
+        this.workflowId = init.workflowId ?? init.agentId;
+        this.workflowName = init.workflowName ?? init.agentId;
+        // Structural fields
+        this.spanId = init.spanId ?? generateUUID();
+        this.parentSpanId = init.parentSpanId;
+        this.depth = init.depth ?? 0;
+    }
+    finish(result, error) {
+        this.completedAt = new Date();
+        this.result = result;
+        this.error = error;
+        if (error) {
+            this.status = error instanceof GovernanceBlockedError ? 'blocked' : 'error';
+        }
+        else {
+            this.status = 'success';
+        }
+    }
+    get durationMs() {
+        if (!this.completedAt) {
+            return undefined;
+        }
+        return this.completedAt.getTime() - this.startedAt.getTime();
+    }
+    // ── Telemetry setters (matching Python SDK API) ──
+    /** Record token counts for this span. */
+    setTokens(input, output) {
+        this.tokensInput = input;
+        this.tokensOutput = output;
+    }
+    /** Record LLM cost in USD. */
+    setCost(cost) {
+        this.costUsd = cost;
+    }
+    /** Record the LLM model and provider used. */
+    setModel(model, provider) {
+        this.model = model;
+        if (provider)
+            this.provider = provider;
+    }
+    /** Record prompt and optional system prompt. */
+    setPrompt(prompt, systemPrompt) {
+        this.promptText = prompt;
+        if (systemPrompt)
+            this.systemPrompt = systemPrompt;
+    }
+    /** Record input/output data for this span. */
+    setIO(inputData, outputData) {
+        if (inputData !== undefined)
+            this.inputData = inputData;
+        if (outputData !== undefined)
+            this.outputData = outputData;
+    }
+    /** Record RAG retrieval context for faithfulness evaluation. */
+    setInputContext(context) {
+        this.inputContext = context.slice(0, 500000);
+    }
+    /** Add a structured tool call record (capped at 200 per span). */
+    addToolCall(record) {
+        if (this.toolCalls.length >= 200)
+            return;
+        this.toolCalls.push(record);
+    }
+    /**
+     * Record a node in the fingerprint.
+     *
+     * Called automatically during instrumentation to track workflow structure.
+     *
+     * @param name - Node name (typically the function name)
+     * @param nodeType - Type of node (llm, tool, function, retriever, etc.)
+     * @param config - Configuration dict for the node
+     * @param prompt - System prompt for LLM nodes
+     */
+    recordNode(name, nodeType, config, prompt) {
+        if (this.fingerprintBuilder) {
+            this.fingerprintBuilder.recordNode(name, nodeType, config, prompt);
+        }
+    }
+}
+class ContextStorage {
+    constructor() {
+        this.storage = AsyncLocalStorageCtor ? new AsyncLocalStorageCtor() : undefined;
+    }
+    run(context, fn) {
+        if (this.storage) {
+            return this.storage.run(context, fn);
+        }
+        const previous = this.fallback;
+        this.fallback = context;
+        const result = fn();
+        if (typeof result?.then === 'function') {
+            return result.finally(() => {
+                this.fallback = previous;
+            });
+        }
+        this.fallback = previous;
+        return result;
+    }
+    get() {
+        if (this.storage) {
+            return this.storage.getStore() ?? undefined;
+        }
+        return this.fallback;
+    }
+}
+export const contextStorage = new ContextStorage();
+export function currentContext() {
+    return contextStorage.get();
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/decorators.d.ts

@@ -0,0 +1,6 @@
+import { InstrumentationOptions } from './instrumentation';
+type Method = (...args: unknown[]) => unknown;
+export declare function instrument(options: InstrumentationOptions): (_target: unknown, _propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
+export declare function withInstrumentation<T extends Method>(fn: T, options: InstrumentationOptions): T;
+export {};
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAmB,MAAM,mBAAmB,CAAC;AAK5E,KAAK,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAE9C,wBAAgB,UAAU,CAAC,OAAO,EAAE,sBAAsB,IAEtD,SAAS,OAAO,EAChB,cAAc,MAAM,GAAG,MAAM,EAC7B,YAAY,kBAAkB,KAC7B,IAAI,CAMR;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,sBAAsB,GAAG,CAAC,CAE/F"}

package/dist/decorators.js

@@ -0,0 +1,52 @@
+import { PluginNotInitializedError } from './errors';
+import { validateOptions } from './instrumentation';
+import { getInstance } from './plugin';
+import { queueTrigger } from './triggerState';
+import { isTriggerRegistered, markTriggerRegistered } from './utils';
+export function instrument(options) {
+    return function instrumentDecorator(_target, _propertyKey, descriptor) {
+        if (!descriptor || typeof descriptor.value !== 'function') {
+            throw new Error('@instrument can only be applied to methods');
+        }
+        descriptor.value = createInstrumentedFunction(descriptor.value, options);
+    };
+}
+export function withInstrumentation(fn, options) {
+    return createInstrumentedFunction(fn, options);
+}
+function createInstrumentedFunction(fn, options) {
+    validateOptions(options);
+    const wrapper = function instrumented(...args) {
+        const plugin = getInstance();
+        ensureTriggerRegistration(plugin, options, wrapper);
+        return plugin.execute(fn, this, args, options);
+    };
+    maybeRegisterTrigger(options, wrapper);
+    return wrapper;
+}
+function maybeRegisterTrigger(options, wrapper) {
+    if (!options.triggerKey) {
+        return;
+    }
+    try {
+        const plugin = getInstance();
+        plugin.registerTrigger(options.triggerKey, wrapper, options.triggerDescription);
+        markTriggerRegistered(wrapper);
+    }
+    catch (error) {
+        if (error instanceof PluginNotInitializedError) {
+            queueTrigger(options.triggerKey, wrapper, options.triggerDescription);
+        }
+        else {
+            throw error;
+        }
+    }
+}
+function ensureTriggerRegistration(plugin, options, wrapper) {
+    if (!options.triggerKey || isTriggerRegistered(wrapper)) {
+        return;
+    }
+    plugin.registerTrigger(options.triggerKey, wrapper, options.triggerDescription);
+    markTriggerRegistered(wrapper);
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAA0B,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAqB,WAAW,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAIrE,MAAM,UAAU,UAAU,CAAC,OAA+B;IACxD,OAAO,SAAS,mBAAmB,CACjC,OAAgB,EAChB,YAA6B,EAC7B,UAA8B;QAE9B,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,UAAU,CAAC,KAAK,GAAG,0BAA0B,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAmB,EAAK,EAAE,OAA+B;IAC1F,OAAO,0BAA0B,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,0BAA0B,CAAmB,EAAK,EAAE,OAA+B;IAC1F,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,OAAO,GAAG,SAAS,YAAY,CAAgB,GAAG,IAAe;QACrE,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;QAC7B,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,OAAY,CAAC;AACtB,CAAC;AAED,SAAS,oBAAoB,CAAC,OAA+B,EAAE,OAAe;IAC5E,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAChF,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,yBAAyB,EAAE,CAAC;YAC/C,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAyB,EAAE,OAA+B,EAAE,OAAe;IAC5G,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO;IACT,CAAC;IACD,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChF,qBAAqB,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}