@turingpulse/sdk 1.0.1

package/dist/governance.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,62 @@
+/**
+ * HTTP client for TuringPulse SDK.
+ *
+ * All outbound HTTP flows through this class.  Authentication is done
+ * exclusively via the `X-API-Key` header — the backend resolves
+ * tenant_id and project_id from the key.
+ */
+import type { AgentEvent } from '@turingpulse/interfaces';
+import { TuringPulseConfig } from './config';
+export declare const SDK_VERSION = "0.1.0";
+interface JsonValue {
+    [key: string]: unknown;
+}
+/** Parameters for SDK policy_check() */
+export interface PolicyCheckParams {
+    agentId?: string;
+    workflowId?: string;
+    workflowName?: string;
+    runId?: string;
+    nodeName?: string;
+    modelName?: string;
+    confidenceScore?: number;
+    costUsd?: number;
+    latencyMs?: number;
+    outputText?: string;
+    inputText?: string;
+    outputLength?: number;
+    errorOccurred?: boolean;
+    category?: string;
+    metadata?: Record<string, unknown>;
+    spanId?: string;
+    nodeType?: string;
+}
+/** Result of a policy check */
+export interface PolicyCheckResult {
+    /** "allow", "block", or "flag" */
+    action: string;
+    /** Whether any policy was triggered */
+    triggered: boolean;
+    /** Human-readable reason */
+    reason?: string;
+    /** IDs of triggered policies */
+    policyIds: string[];
+}
+export declare class TuringPulseHttpClient {
+    private readonly config;
+    private readonly baseUrl;
+    constructor(config: TuringPulseConfig);
+    get maxSerializedFieldLength(): number;
+    private get fetchImpl();
+    emitEvents(events: AgentEvent[]): Promise<void>;
+    createTask(payload: JsonValue): Promise<string | undefined>;
+    addHitlAction(taskId: string, payload: JsonValue): Promise<void>;
+    postFingerprint(payload: JsonValue): Promise<unknown>;
+    postDeploy(payload: JsonValue): Promise<unknown>;
+    postCustomChange(payload: JsonValue): Promise<unknown>;
+    private post;
+    policyCheck(params: PolicyCheckParams): Promise<PolicyCheckResult>;
+    private buildHeaders;
+}
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAM7C,eAAO,MAAM,WAAW,UAAU,CAAC;AAMnC,UAAU,SAAS;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+BAA+B;AAC/B,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEJ,MAAM,EAAE,iBAAiB;IAItD,IAAI,wBAAwB,IAAI,MAAM,CAErC;IAED,OAAO,KAAK,SAAS,GAEpB;IAMK,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/C,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAY3D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAchE,eAAe,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrD,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAKhD,gBAAgB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;YAS9C,IAAI;IAkEZ,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2BxE,OAAO,CAAC,YAAY;CAQrB"}

package/dist/http.js

@@ -0,0 +1,181 @@
+/**
+ * HTTP client for TuringPulse SDK.
+ *
+ * All outbound HTTP flows through this class.  Authentication is done
+ * exclusively via the `X-API-Key` header — the backend resolves
+ * tenant_id and project_id from the key.
+ */
+import { safeErrorMessage } from './utils';
+import { toSnakeCaseDeep } from './utils';
+const _fetch = globalThis.fetch;
+const _Headers = globalThis.Headers;
+export const SDK_VERSION = '0.1.0';
+const SDK_LANGUAGE = 'typescript';
+const MAX_PAYLOAD_BYTES = 5 * 1024 * 1024; // 5 MB
+const SAFE_PATH_SEGMENT = /^[a-zA-Z0-9_-]+$/;
+const TERMINAL_STATUS_CODES = new Set([401, 402, 403, 404]);
+export class TuringPulseHttpClient {
+    constructor(config) {
+        this.config = config;
+        this.baseUrl = config.endpoint;
+    }
+    get maxSerializedFieldLength() {
+        return this.config.maxSerializedFieldLength;
+    }
+    get fetchImpl() {
+        return this.config.fetchImpl ?? _fetch;
+    }
+    // ------------------------------------------------------------------
+    // Event emission
+    // ------------------------------------------------------------------
+    async emitEvents(events) {
+        if (!events.length)
+            return;
+        const snakeEvents = toSnakeCaseDeep(events);
+        const url = `${this.baseUrl}/api/v1/sdk/events`;
+        await this.post(url, { events: snakeEvents });
+    }
+    // ------------------------------------------------------------------
+    // Task / HITL helpers
+    // ------------------------------------------------------------------
+    async createTask(payload) {
+        const url = `${this.baseUrl}/api/v1/tasks`;
+        const response = await this.post(url, payload);
+        if (response && typeof response === 'object' && 'taskId' in response && typeof response.taskId === 'string') {
+            return response.taskId;
+        }
+        if (typeof payload.taskId === 'string') {
+            return payload.taskId;
+        }
+        return undefined;
+    }
+    async addHitlAction(taskId, payload) {
+        if (!SAFE_PATH_SEGMENT.test(taskId)) {
+            // eslint-disable-next-line no-console
+            console.warn('TuringPulse: invalid taskId rejected (possible path traversal)');
+            return;
+        }
+        const url = `${this.baseUrl}/api/v1/tasks/${taskId}/hitl`;
+        await this.post(url, payload);
+    }
+    // ------------------------------------------------------------------
+    // Fingerprint / deploy / custom-change helpers
+    // ------------------------------------------------------------------
+    async postFingerprint(payload) {
+        const url = `${this.baseUrl}/api/v1/fingerprints`;
+        return this.post(url, payload);
+    }
+    async postDeploy(payload) {
+        const url = `${this.baseUrl}/api/v1/deploys`;
+        return this.post(url, payload);
+    }
+    async postCustomChange(payload) {
+        const url = `${this.baseUrl}/api/v1/changes`;
+        return this.post(url, payload);
+    }
+    // ------------------------------------------------------------------
+    // Core POST with retries + timeout + payload limit
+    // ------------------------------------------------------------------
+    async post(url, body) {
+        let serialized = JSON.stringify(body);
+        if (serialized.length > MAX_PAYLOAD_BYTES) {
+            // eslint-disable-next-line no-console
+            console.warn(`TuringPulse payload exceeds ${MAX_PAYLOAD_BYTES} bytes, truncating`);
+            const events = body.events;
+            if (Array.isArray(events) && events.length > 1) {
+                const overhead = serialized.length - JSON.stringify(events).length;
+                const avgPerEvent = Math.ceil((serialized.length - overhead) / events.length);
+                const targetCount = Math.max(1, Math.floor((MAX_PAYLOAD_BYTES - overhead) / avgPerEvent));
+                if (targetCount < events.length) {
+                    body = { ...body, events: events.slice(0, targetCount) };
+                }
+            }
+            serialized = JSON.stringify(body);
+        }
+        const headers = this.buildHeaders();
+        let lastError;
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt += 1) {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.config.timeoutMs);
+            try {
+                const response = await this.fetchImpl(url, {
+                    method: 'POST',
+                    headers,
+                    body: serialized,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                if (!response.ok) {
+                    const err = new Error(`TuringPulse request failed with ${response.status}`);
+                    const retryAfterHeader = response.headers.get('retry-after');
+                    if (retryAfterHeader) {
+                        err.retryAfter = parseFloat(retryAfterHeader) || undefined;
+                    }
+                    throw err;
+                }
+                if (response.headers.get('content-type')?.includes('application/json')) {
+                    return await response.json();
+                }
+                return undefined;
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                lastError = error;
+                const statusMatch = error instanceof Error && error.message.match(/failed with (\d+)/);
+                if (statusMatch && TERMINAL_STATUS_CODES.has(Number(statusMatch[1]))) {
+                    break;
+                }
+                if (attempt === this.config.maxRetries)
+                    break;
+                const retryAfter = error?.retryAfter;
+                const delay = retryAfter && retryAfter > 0
+                    ? Math.min(retryAfter * 1000, 2000)
+                    : Math.min(500 * (attempt + 1), 2000);
+                await sleep(delay);
+            }
+        }
+        // eslint-disable-next-line no-console
+        console.warn(`TuringPulse request to ${url} failed: ${safeErrorMessage(lastError)}`);
+        return undefined;
+    }
+    // ------------------------------------------------------------------
+    // Policy check — uses the same centralized post() with retries
+    // ------------------------------------------------------------------
+    async policyCheck(params) {
+        const url = `${this.baseUrl}/api/v1/hitl/policy/check`;
+        const body = toSnakeCaseDeep(params);
+        try {
+            const data = (await this.post(url, body));
+            if (!data) {
+                return { action: 'flag', triggered: true, reason: 'check_error: no response', policyIds: [] };
+            }
+            return {
+                action: data.action || 'allow',
+                triggered: Boolean(data.triggered),
+                reason: data.reason || undefined,
+                policyIds: data.policy_ids || [],
+            };
+        }
+        catch (err) {
+            const safeMessage = err instanceof Error ? err.message : 'unknown error';
+            // eslint-disable-next-line no-console
+            console.warn('TuringPulse policy check failed (fail-open):', safeMessage);
+            return { action: 'flag', triggered: true, reason: `check_error: ${safeMessage}`, policyIds: [] };
+        }
+    }
+    // ------------------------------------------------------------------
+    // Headers — only X-API-Key, never tenant/project/roles
+    // ------------------------------------------------------------------
+    buildHeaders() {
+        return new _Headers({
+            'Content-Type': 'application/json',
+            'X-API-Key': this.config.apiKey,
+            'X-SDK-Version': SDK_VERSION,
+            'X-SDK-Language': SDK_LANGUAGE,
+        });
+    }
+}
+async function sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { TuringPulseConfig, type TuringPulseConfigOptions, type GovernanceDefaults, DEFAULT_ENDPOINT } from './config';
+export { TuringPulsePlugin, init, getInstance } from './plugin';
+export { instrument, withInstrumentation } from './decorators';
+export { GovernanceDirective, type GovernanceDirectiveOptions, type GovernanceTaskResult } from './governance';
+export { type InstrumentationOptions } from './instrumentation';
+export { type KPIConfig, type KPIResult, type KPIComparator } from './kpi';
+export { currentContext, ExecutionContext, type ToolCallRecord, generateUUID } from './context';
+export { TriggerNotFoundError, PluginNotInitializedError, GovernanceBlockedError, ConfigurationError, } from './errors';
+export { type FingerprintConfig, type FingerprintData, } from './fingerprint';
+export { registerDeploy, type DeployInfo, type RegisterDeployOptions, } from './deploy';
+export { type PolicyCheckParams, type PolicyCheckResult, TuringPulseHttpClient, SDK_VERSION } from './http';
+export { AttachmentManager, type AttachmentResult } from './attachments';
+export { safeEnv, safeErrorMessage, toSnakeCaseDeep } from './utils';
+export { instrumentMastra, type MastraInstrumentOptions, type MastraToolCallRecord, } from './integrations/mastra';
+//# 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,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,KAAK,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGvH,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGhE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAG/G,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGhG,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,KAAK,UAAU,EACf,KAAK,qBAAqB,GAC3B,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG5G,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGzE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGrE,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+// Config
+export { TuringPulseConfig, DEFAULT_ENDPOINT } from './config';
+// Plugin
+export { TuringPulsePlugin, init, getInstance } from './plugin';
+// Decorators
+export { instrument, withInstrumentation } from './decorators';
+// Governance
+export { GovernanceDirective } from './governance';
+// Context
+export { currentContext, ExecutionContext, generateUUID } from './context';
+// Errors
+export { TriggerNotFoundError, PluginNotInitializedError, GovernanceBlockedError, ConfigurationError, } from './errors';
+// Deploy Tracking
+export { registerDeploy, } from './deploy';
+// Policy Check & HTTP Client
+export { TuringPulseHttpClient, SDK_VERSION } from './http';
+// Attachments
+export { AttachmentManager } from './attachments';
+// Utils
+export { safeEnv, safeErrorMessage, toSnakeCaseDeep } from './utils';
+// Framework Integrations
+export { instrumentMastra, } from './integrations/mastra';
+//# 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,SAAS;AACT,OAAO,EAAE,iBAAiB,EAA0D,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEvH,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEhE,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE/D,aAAa;AACb,OAAO,EAAE,mBAAmB,EAA8D,MAAM,cAAc,CAAC;AAQ/G,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAuB,YAAY,EAAE,MAAM,WAAW,CAAC;AAEhG,SAAS;AACT,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAQlB,kBAAkB;AAClB,OAAO,EACL,cAAc,GAGf,MAAM,UAAU,CAAC;AAElB,6BAA6B;AAC7B,OAAO,EAAkD,qBAAqB,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE5G,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAyB,MAAM,eAAe,CAAC;AAEzE,QAAQ;AACR,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAErE,yBAAyB;AACzB,OAAO,EACL,gBAAgB,GAGjB,MAAM,uBAAuB,CAAC"}

package/dist/instrumentation.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Instrumentation options for @instrument decorator.
+ *
+ * REFACTORED:
+ * - Added `name` parameter for workflow display name
+ * - `agentId` is DEPRECATED - use `name` instead
+ * - Backend auto-registers workflows based on `name` and assigns UUID
+ */
+import { GovernanceDirective } from './governance';
+import { KPIConfig } from './kpi';
+export interface InstrumentationOptions {
+    /**
+     * Display name for the workflow (e.g., "Order Processing Agent").
+     * This is the preferred parameter. The backend will auto-register
+     * workflows based on this name and assign a UUID.
+     */
+    name?: string;
+    /**
+     * @deprecated Use `name` instead.
+     * Kept for backward compatibility.
+     */
+    agentId?: string;
+    operation?: string;
+    labels?: Record<string, string>;
+    trace?: boolean;
+    governance?: GovernanceDirective;
+    kpis?: KPIConfig[];
+    triggerKey?: string;
+    triggerDescription?: string;
+    hiddenEntrypoint?: boolean;
+    metadata?: Record<string, string>;
+}
+export declare function resolveOperation(options: InstrumentationOptions, fallback: string): string;
+export declare function tracingEnabled(options: InstrumentationOptions, defaultEnabled: boolean): boolean;
+/**
+ * Validate instrumentation options.
+ * @throws Error if neither name nor agentId is provided.
+ */
+export declare function validateOptions(options: InstrumentationOptions): void;
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,OAAO,GAAG,OAAO,CAEhG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAgBrE"}

package/dist/instrumentation.js

@@ -0,0 +1,31 @@
+/**
+ * Instrumentation options for @instrument decorator.
+ *
+ * REFACTORED:
+ * - Added `name` parameter for workflow display name
+ * - `agentId` is DEPRECATED - use `name` instead
+ * - Backend auto-registers workflows based on `name` and assigns UUID
+ */
+export function resolveOperation(options, fallback) {
+    return options.operation ?? fallback;
+}
+export function tracingEnabled(options, defaultEnabled) {
+    return options.trace ?? defaultEnabled;
+}
+/**
+ * Validate instrumentation options.
+ * @throws Error if neither name nor agentId is provided.
+ */
+export function validateOptions(options) {
+    if (!options.name && !options.agentId) {
+        throw new Error("Either 'name' or 'agentId' must be provided to @instrument. " +
+            "Example: @instrument({ name: 'My Workflow' })");
+    }
+    // Emit console warning for deprecated agentId usage
+    if (options.agentId && !options.name) {
+        // eslint-disable-next-line no-console
+        console.warn("The 'agentId' parameter is deprecated. Use 'name' instead. " +
+            "Example: @instrument({ name: 'Order Processing Agent' })");
+    }
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8BH,MAAM,UAAU,gBAAgB,CAAC,OAA+B,EAAE,QAAgB;IAChF,OAAO,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAA+B,EAAE,cAAuB;IACrF,OAAO,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,8DAA8D;YAC9D,+CAA+C,CAChD,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACrC,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,6DAA6D;YAC7D,0DAA0D,CAC3D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/integrations/mastra.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Mastra 1.2.x instrumentation for TuringPulse SDK (TypeScript).
+ *
+ * Wraps `agent.generate()` to capture:
+ * - Token counts from `response.usage` (ai-sdk format: promptTokens / completionTokens).
+ * - Per-tool-call child spans.
+ * - Agent instructions as system prompt.
+ *
+ * This integration uses the centralized TuringPulseHttpClient when a plugin
+ * instance is available (preferred), or falls back to standalone HTTP when
+ * used without the full SDK.
+ */
+import type { ToolCallRecord } from '../context';
+import type { TuringPulseHttpClient } from '../http';
+/** Mastra tool call with required result/id fields. */
+interface MastraToolCallRecord extends ToolCallRecord {
+    toolResult: string;
+    toolId: string;
+}
+interface MastraInstrumentOptions {
+    /** Workflow display name for TuringPulse. */
+    name: string;
+    /** LLM model name (default: gpt-4o-mini). */
+    model?: string;
+    /** LLM provider (default: openai). */
+    provider?: string;
+    /**
+     * Preferred: pass the plugin's HTTP client for centralized retries, timeouts, headers.
+     * If not provided, falls back to standalone fetch using apiKey + endpoint.
+     */
+    httpClient?: TuringPulseHttpClient;
+    /** TuringPulse API endpoint — only needed if httpClient is not provided. */
+    endpoint?: string;
+    /** TuringPulse API key — only needed if httpClient is not provided. */
+    apiKey?: string;
+    /** Tool names available to the agent. */
+    toolNames?: string[];
+    /**
+     * A reference to the mutable tool-call log array. Tool execute()
+     * callbacks push records here during agent.generate(). The integration
+     * reads from this array after execution completes.
+     */
+    toolCallLog?: MastraToolCallRecord[];
+    kpis?: Array<{
+        kpiId: string;
+        value: number | (() => number);
+        alertThreshold?: number;
+        comparator?: string;
+        description?: string;
+    }>;
+    metadata?: Record<string, string>;
+}
+/**
+ * Instrument a Mastra Agent for TuringPulse observability.
+ *
+ * Returns an async function that runs `agent.generate()` and emits
+ * a root workflow span plus per-tool/LLM child spans.
+ */
+export declare function instrumentMastra(agent: {
+    generate: (prompt: string) => Promise<unknown>;
+    [key: string]: unknown;
+}, options: MastraInstrumentOptions): (prompt: string) => Promise<unknown>;
+export type { MastraInstrumentOptions, MastraToolCallRecord };
+//# sourceMappingURL=mastra.d.ts.map

package/dist/integrations/mastra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mastra.d.ts","sourceRoot":"","sources":["../../src/integrations/mastra.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAOrD,uDAAuD;AACvD,UAAU,oBAAqB,SAAQ,cAAc;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,uBAAuB;IAC/B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACrC,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpI,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE;IAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EACjF,OAAO,EAAE,uBAAuB,GAC/B,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAuLtC;AAkDD,YAAY,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,CAAC"}