@cogitator-ai/workflows 0.1.0

package/dist/nodes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nodes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC"}

package/dist/nodes/tool.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ToolNode - Run a single tool as a workflow node
+ */
+import type { WorkflowNode, WorkflowState, Tool } from '@cogitator-ai/types';
+export interface ToolNodeOptions<S = WorkflowState, TArgs = unknown> {
+    /**
+     * Map current state to tool arguments
+     */
+    argsMapper: (state: S, input?: unknown) => TArgs;
+    /**
+     * Map tool result to state updates
+     */
+    stateMapper?: (result: unknown) => Partial<S>;
+}
+/**
+ * Create a workflow node that runs a single tool
+ */
+export declare function toolNode<S extends WorkflowState = WorkflowState, TArgs = unknown>(tool: Tool<TArgs, unknown>, options: ToolNodeOptions<S, TArgs>): WorkflowNode<S>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/nodes/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/nodes/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAEb,IAAI,EAEL,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,aAAa,EAAE,KAAK,GAAG,OAAO;IACjE;;OAEG;IACH,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,KAAK,CAAC;IAEjD;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,CAAC,SAAS,aAAa,GAAG,aAAa,EACvC,KAAK,GAAG,OAAO,EACf,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAsBjF"}

package/dist/nodes/tool.js

@@ -0,0 +1,26 @@
+/**
+ * ToolNode - Run a single tool as a workflow node
+ */
+/**
+ * Create a workflow node that runs a single tool
+ */
+export function toolNode(tool, options) {
+    return {
+        name: tool.name,
+        fn: async (ctx) => {
+            const args = options.argsMapper(ctx.state, ctx.input);
+            const toolContext = {
+                agentId: 'workflow',
+                runId: ctx.workflowId,
+                signal: new AbortController().signal,
+            };
+            const result = await tool.execute(args, toolContext);
+            const stateUpdate = options.stateMapper?.(result);
+            return {
+                state: stateUpdate,
+                output: result,
+            };
+        },
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/nodes/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/nodes/tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsBH;;GAEG;AACH,MAAM,UAAU,QAAQ,CAGtB,IAA0B,EAAE,OAAkC;IAC9D,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,EAAE,EAAE,KAAK,EAAE,GAAG,EAA0B,EAAE;YACxC,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YAEtD,MAAM,WAAW,GAAgB;gBAC/B,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE,GAAG,CAAC,UAAU;gBACrB,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;aACrC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAErD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC;YAElD,OAAO;gBACL,KAAK,EAAE,WAAW;gBAClB,MAAM,EAAE,MAAM;aACf,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/observability/exporters.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Span exporters for workflow tracing
+ *
+ * Supports:
+ * - Console (for development/debugging)
+ * - OTLP HTTP (OpenTelemetry Protocol)
+ * - Jaeger (via OTLP or native)
+ * - Zipkin
+ */
+import type { WorkflowSpan, SpanExporter } from '@cogitator-ai/types';
+export interface SpanExporterInstance {
+    export(spans: WorkflowSpan[]): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export interface ExporterConfig {
+    type: SpanExporter;
+    endpoint?: string;
+    headers?: Record<string, string>;
+    batchSize?: number;
+    flushInterval?: number;
+}
+/**
+ * Console exporter for development/debugging
+ */
+export declare class ConsoleSpanExporter implements SpanExporterInstance {
+    private verbose;
+    constructor(verbose?: boolean);
+    export(spans: WorkflowSpan[]): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * OTLP HTTP exporter for OpenTelemetry-compatible backends
+ * (Jaeger, Tempo, Honeycomb, Datadog, etc.)
+ */
+export declare class OTLPSpanExporter implements SpanExporterInstance {
+    private endpoint;
+    private headers;
+    private batchSize;
+    private flushInterval;
+    private pendingSpans;
+    private flushTimer;
+    constructor(config: {
+        endpoint?: string;
+        headers?: Record<string, string>;
+        batchSize?: number;
+        flushInterval?: number;
+    });
+    export(spans: WorkflowSpan[]): Promise<void>;
+    private flush;
+    private toOTLPFormat;
+    private spanToOTLP;
+    private kindToOTLP;
+    private valueToOTLP;
+    shutdown(): Promise<void>;
+}
+/**
+ * Zipkin exporter
+ */
+export declare class ZipkinSpanExporter implements SpanExporterInstance {
+    private endpoint;
+    private headers;
+    private serviceName;
+    constructor(config: {
+        endpoint?: string;
+        headers?: Record<string, string>;
+        serviceName?: string;
+    });
+    export(spans: WorkflowSpan[]): Promise<void>;
+    private toZipkinFormat;
+    private kindToZipkin;
+    shutdown(): Promise<void>;
+}
+/**
+ * Composite exporter that sends to multiple backends
+ */
+export declare class CompositeSpanExporter implements SpanExporterInstance {
+    private exporters;
+    constructor(exporters: SpanExporterInstance[]);
+    export(spans: WorkflowSpan[]): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * No-op exporter for when tracing is disabled
+ */
+export declare class NoopSpanExporter implements SpanExporterInstance {
+    export(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Factory function to create an exporter from config
+ */
+export declare function createSpanExporter(config: ExporterConfig): SpanExporterInstance;
+//# sourceMappingURL=exporters.d.ts.map

package/dist/observability/exporters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporters.d.ts","sourceRoot":"","sources":["../../src/observability/exporters.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,UAAQ;IAIrB,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAEhC;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,oBAAoB;IAC3D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,UAAU,CAA+C;gBAErD,MAAM,EAAE;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IAeK,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAQpC,KAAK;IAyBnB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,UAAU;IA6ClB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,WAAW;IAuBb,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IAUK,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBlD,OAAO,CAAC,cAAc;IA+CtB,OAAO,CAAC,YAAY;IAgBd,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAEhC;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,OAAO,CAAC,SAAS,CAAyB;gBAE9B,SAAS,EAAE,oBAAoB,EAAE;IAIvC,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,oBAAoB;IACrD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAGvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAEhC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,oBAAoB,CA8B/E"}

package/dist/observability/exporters.js

@@ -0,0 +1,330 @@
+/**
+ * Span exporters for workflow tracing
+ *
+ * Supports:
+ * - Console (for development/debugging)
+ * - OTLP HTTP (OpenTelemetry Protocol)
+ * - Jaeger (via OTLP or native)
+ * - Zipkin
+ */
+/**
+ * Console exporter for development/debugging
+ */
+export class ConsoleSpanExporter {
+    verbose;
+    constructor(verbose = false) {
+        this.verbose = verbose;
+    }
+    async export(spans) {
+        for (const span of spans) {
+            const duration = span.endTime
+                ? `${(span.endTime - span.startTime).toString()}ms`
+                : 'ongoing';
+            const statusIcon = span.status === 'ok' ? '✓' : span.status === 'error' ? '✗' : '○';
+            const indent = span.parentSpanId ? '  └─' : '';
+            console.log(`${indent}[${span.traceId.slice(0, 8)}] ${statusIcon} ${span.name} (${duration})`);
+            if (this.verbose) {
+                console.log('  Attributes:', JSON.stringify(span.attributes, null, 2));
+                if (span.events.length > 0) {
+                    console.log('  Events:', span.events.map((e) => e.name).join(', '));
+                }
+                if (span.statusMessage) {
+                    console.log('  Message:', span.statusMessage);
+                }
+            }
+        }
+    }
+    async shutdown() {
+    }
+}
+/**
+ * OTLP HTTP exporter for OpenTelemetry-compatible backends
+ * (Jaeger, Tempo, Honeycomb, Datadog, etc.)
+ */
+export class OTLPSpanExporter {
+    endpoint;
+    headers;
+    batchSize;
+    flushInterval;
+    pendingSpans = [];
+    flushTimer = null;
+    constructor(config) {
+        this.endpoint =
+            config.endpoint ?? 'http://localhost:4318/v1/traces';
+        this.headers = {
+            'Content-Type': 'application/json',
+            ...config.headers,
+        };
+        this.batchSize = config.batchSize ?? 512;
+        this.flushInterval = config.flushInterval ?? 5000;
+        this.flushTimer = setInterval(() => {
+            void this.flush();
+        }, this.flushInterval);
+    }
+    async export(spans) {
+        this.pendingSpans.push(...spans);
+        if (this.pendingSpans.length >= this.batchSize) {
+            await this.flush();
+        }
+    }
+    async flush() {
+        if (this.pendingSpans.length === 0)
+            return;
+        const spansToExport = this.pendingSpans.splice(0, this.batchSize);
+        const payload = this.toOTLPFormat(spansToExport);
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: this.headers,
+                body: JSON.stringify(payload),
+            });
+            if (!response.ok) {
+                console.error(`OTLP export failed: ${response.status.toString()} ${response.statusText}`);
+                this.pendingSpans.unshift(...spansToExport);
+            }
+        }
+        catch (error) {
+            console.error('OTLP export error:', error);
+            this.pendingSpans.unshift(...spansToExport);
+        }
+    }
+    toOTLPFormat(spans) {
+        const resourceSpans = [
+            {
+                resource: {
+                    attributes: [],
+                },
+                scopeSpans: [
+                    {
+                        scope: {
+                            name: '@cogitator-ai/workflows',
+                            version: '1.0.0',
+                        },
+                        spans: spans.map((span) => this.spanToOTLP(span)),
+                    },
+                ],
+            },
+        ];
+        return { resourceSpans };
+    }
+    spanToOTLP(span) {
+        const statusCode = span.status === 'ok' ? 1 : span.status === 'error' ? 2 : 0;
+        return {
+            traceId: span.traceId,
+            spanId: span.spanId,
+            parentSpanId: span.parentSpanId,
+            name: span.name,
+            kind: this.kindToOTLP(span.kind),
+            startTimeUnixNano: (span.startTime * 1_000_000).toString(),
+            endTimeUnixNano: span.endTime
+                ? (span.endTime * 1_000_000).toString()
+                : undefined,
+            attributes: Object.entries(span.attributes).map(([key, value]) => ({
+                key,
+                value: this.valueToOTLP(value),
+            })),
+            events: span.events.map((event) => ({
+                name: event.name,
+                timeUnixNano: (event.timestamp * 1_000_000).toString(),
+                attributes: event.attributes
+                    ? Object.entries(event.attributes).map(([key, value]) => ({
+                        key,
+                        value: this.valueToOTLP(value),
+                    }))
+                    : [],
+            })),
+            links: span.links.map((link) => ({
+                traceId: link.traceId,
+                spanId: link.spanId,
+                attributes: link.attributes
+                    ? Object.entries(link.attributes).map(([key, value]) => ({
+                        key,
+                        value: this.valueToOTLP(value),
+                    }))
+                    : [],
+            })),
+            status: {
+                code: statusCode,
+                message: span.statusMessage,
+            },
+        };
+    }
+    kindToOTLP(kind) {
+        const kindMap = {
+            internal: 1,
+            server: 2,
+            client: 3,
+            producer: 4,
+            consumer: 5,
+        };
+        return kindMap[kind] ?? 0;
+    }
+    valueToOTLP(value) {
+        if (typeof value === 'string') {
+            return { stringValue: value };
+        }
+        if (typeof value === 'number') {
+            if (Number.isInteger(value)) {
+                return { intValue: value.toString() };
+            }
+            return { doubleValue: value };
+        }
+        if (typeof value === 'boolean') {
+            return { boolValue: value };
+        }
+        if (Array.isArray(value)) {
+            return {
+                arrayValue: {
+                    values: value.map((v) => this.valueToOTLP(v)),
+                },
+            };
+        }
+        return { stringValue: JSON.stringify(value) };
+    }
+    async shutdown() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush();
+    }
+}
+/**
+ * Zipkin exporter
+ */
+export class ZipkinSpanExporter {
+    endpoint;
+    headers;
+    serviceName;
+    constructor(config) {
+        this.endpoint =
+            config.endpoint ?? 'http://localhost:9411/api/v2/spans';
+        this.headers = {
+            'Content-Type': 'application/json',
+            ...config.headers,
+        };
+        this.serviceName = config.serviceName ?? 'cogitator-workflow';
+    }
+    async export(spans) {
+        const zipkinSpans = spans.map((span) => this.toZipkinFormat(span));
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: this.headers,
+                body: JSON.stringify(zipkinSpans),
+            });
+            if (!response.ok) {
+                console.error(`Zipkin export failed: ${response.status.toString()} ${response.statusText}`);
+            }
+        }
+        catch (error) {
+            console.error('Zipkin export error:', error);
+        }
+    }
+    toZipkinFormat(span) {
+        const kind = this.kindToZipkin(span.kind);
+        const result = {
+            traceId: span.traceId,
+            id: span.spanId,
+            name: span.name,
+            timestamp: span.startTime * 1000,
+            duration: span.endTime
+                ? (span.endTime - span.startTime) * 1000
+                : undefined,
+            localEndpoint: {
+                serviceName: this.serviceName,
+            },
+            tags: {},
+            annotations: [],
+        };
+        if (span.parentSpanId) {
+            result.parentId = span.parentSpanId;
+        }
+        if (kind) {
+            result.kind = kind;
+        }
+        for (const [key, value] of Object.entries(span.attributes)) {
+            result.tags[key] = String(value);
+        }
+        if (span.status === 'error') {
+            result.tags.error = 'true';
+            if (span.statusMessage) {
+                result.tags['error.message'] = span.statusMessage;
+            }
+        }
+        for (const event of span.events) {
+            result.annotations.push({
+                timestamp: event.timestamp * 1000,
+                value: event.name,
+            });
+        }
+        return result;
+    }
+    kindToZipkin(kind) {
+        const kindMap = {
+            client: 'CLIENT',
+            server: 'SERVER',
+            producer: 'PRODUCER',
+            consumer: 'CONSUMER',
+            internal: undefined,
+        };
+        return kindMap[kind];
+    }
+    async shutdown() {
+    }
+}
+/**
+ * Composite exporter that sends to multiple backends
+ */
+export class CompositeSpanExporter {
+    exporters;
+    constructor(exporters) {
+        this.exporters = exporters;
+    }
+    async export(spans) {
+        await Promise.allSettled(this.exporters.map((exporter) => exporter.export(spans)));
+    }
+    async shutdown() {
+        await Promise.allSettled(this.exporters.map((exporter) => exporter.shutdown()));
+    }
+}
+/**
+ * No-op exporter for when tracing is disabled
+ */
+export class NoopSpanExporter {
+    async export() {
+    }
+    async shutdown() {
+    }
+}
+/**
+ * Factory function to create an exporter from config
+ */
+export function createSpanExporter(config) {
+    switch (config.type) {
+        case 'console':
+            return new ConsoleSpanExporter(true);
+        case 'otlp':
+            return new OTLPSpanExporter({
+                endpoint: config.endpoint,
+                headers: config.headers,
+                batchSize: config.batchSize,
+                flushInterval: config.flushInterval,
+            });
+        case 'jaeger':
+            return new OTLPSpanExporter({
+                endpoint: config.endpoint ?? 'http://localhost:4318/v1/traces',
+                headers: config.headers,
+                batchSize: config.batchSize,
+                flushInterval: config.flushInterval,
+            });
+        case 'zipkin':
+            return new ZipkinSpanExporter({
+                endpoint: config.endpoint,
+                headers: config.headers,
+            });
+        default:
+            return new NoopSpanExporter();
+    }
+}
+//# sourceMappingURL=exporters.js.map

package/dist/observability/exporters.js.map

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

package/dist/observability/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @cogitator-ai/workflows - Observability module
+ *
+ * Provides distributed tracing and metrics collection for workflow execution.
+ *
+ * Features:
+ * - W3C Trace Context propagation
+ * - OpenTelemetry-compatible span export (OTLP, Jaeger, Zipkin)
+ * - Prometheus-compatible metrics export
+ * - Per-workflow and per-node metrics
+ * - Token usage and cost tracking
+ */
+export { WorkflowTracer, createTracer, getGlobalTracer, setGlobalTracer, } from './tracer';
+export { WorkflowMetricsCollector, createMetricsCollector, getGlobalMetrics, setGlobalMetrics, } from './metrics';
+export { type SpanExporterInstance, type ExporterConfig, ConsoleSpanExporter, OTLPSpanExporter, ZipkinSpanExporter, CompositeSpanExporter, NoopSpanExporter, createSpanExporter, } from './exporters';
+export { TRACE_PARENT_HEADER, TRACE_STATE_HEADER, BAGGAGE_HEADER, SERVICE_NAME, SERVICE_VERSION, SERVICE_INSTANCE_ID, WORKFLOW_NAME, WORKFLOW_ID, WORKFLOW_RUN_ID, WORKFLOW_VERSION, WORKFLOW_ENTRY_POINT, WORKFLOW_NODE_COUNT, WORKFLOW_STATUS, NODE_NAME, NODE_TYPE, NODE_INDEX, NODE_RETRY_COUNT, NODE_TIMEOUT, NODE_DURATION, NODE_STATUS, LLM_SYSTEM, LLM_REQUEST_MODEL, LLM_RESPONSE_MODEL, LLM_REQUEST_MAX_TOKENS, LLM_REQUEST_TEMPERATURE, LLM_REQUEST_TOP_P, LLM_USAGE_INPUT_TOKENS, LLM_USAGE_OUTPUT_TOKENS, LLM_USAGE_TOTAL_TOKENS, LLM_USAGE_COST, TOOL_NAME, TOOL_PARAMETERS, TOOL_RESULT, TOOL_DURATION, TOOL_SUCCESS, ERROR_TYPE, ERROR_MESSAGE, ERROR_STACK, ERROR_CODE, RETRY_ATTEMPT, RETRY_MAX, RETRY_DELAY, CIRCUIT_BREAKER_STATE, COMPENSATION_TRIGGERED, COMPENSATION_NODE, DEAD_LETTER_QUEUE, APPROVAL_ID, APPROVAL_TYPE, APPROVAL_STATUS, APPROVAL_TIMEOUT, APPROVAL_ASSIGNEE, TIMER_TYPE, TIMER_DELAY, TIMER_CRON, TIMER_SCHEDULED_AT, TIMER_FIRED_AT, SUBWORKFLOW_NAME, SUBWORKFLOW_DEPTH, SUBWORKFLOW_PARENT_ID, TRIGGER_TYPE, TRIGGER_ID, TRIGGER_SOURCE, WEBHOOK_PATH, WEBHOOK_METHOD, CRON_EXPRESSION, CRON_NEXT_RUN, workflowSpanAttributes, nodeSpanAttributes, llmSpanAttributes, toolSpanAttributes, errorSpanAttributes, retrySpanAttributes, } from './span-attributes';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EAEd,YAAY,EACZ,eAAe,EACf,mBAAmB,EAEnB,aAAa,EACb,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EAEf,SAAS,EACT,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EAEX,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EAEd,SAAS,EACT,eAAe,EACf,WAAW,EACX,aAAa,EACb,YAAY,EAEZ,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EAEV,aAAa,EACb,SAAS,EACT,WAAW,EACX,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EAEjB,WAAW,EACX,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAEjB,UAAU,EACV,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,cAAc,EAEd,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EAErB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EAEb,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,17 @@
+/**
+ * @cogitator-ai/workflows - Observability module
+ *
+ * Provides distributed tracing and metrics collection for workflow execution.
+ *
+ * Features:
+ * - W3C Trace Context propagation
+ * - OpenTelemetry-compatible span export (OTLP, Jaeger, Zipkin)
+ * - Prometheus-compatible metrics export
+ * - Per-workflow and per-node metrics
+ * - Token usage and cost tracking
+ */
+export { WorkflowTracer, createTracer, getGlobalTracer, setGlobalTracer, } from './tracer';
+export { WorkflowMetricsCollector, createMetricsCollector, getGlobalMetrics, setGlobalMetrics, } from './metrics';
+export { ConsoleSpanExporter, OTLPSpanExporter, ZipkinSpanExporter, CompositeSpanExporter, NoopSpanExporter, createSpanExporter, } from './exporters';
+export { TRACE_PARENT_HEADER, TRACE_STATE_HEADER, BAGGAGE_HEADER, SERVICE_NAME, SERVICE_VERSION, SERVICE_INSTANCE_ID, WORKFLOW_NAME, WORKFLOW_ID, WORKFLOW_RUN_ID, WORKFLOW_VERSION, WORKFLOW_ENTRY_POINT, WORKFLOW_NODE_COUNT, WORKFLOW_STATUS, NODE_NAME, NODE_TYPE, NODE_INDEX, NODE_RETRY_COUNT, NODE_TIMEOUT, NODE_DURATION, NODE_STATUS, LLM_SYSTEM, LLM_REQUEST_MODEL, LLM_RESPONSE_MODEL, LLM_REQUEST_MAX_TOKENS, LLM_REQUEST_TEMPERATURE, LLM_REQUEST_TOP_P, LLM_USAGE_INPUT_TOKENS, LLM_USAGE_OUTPUT_TOKENS, LLM_USAGE_TOTAL_TOKENS, LLM_USAGE_COST, TOOL_NAME, TOOL_PARAMETERS, TOOL_RESULT, TOOL_DURATION, TOOL_SUCCESS, ERROR_TYPE, ERROR_MESSAGE, ERROR_STACK, ERROR_CODE, RETRY_ATTEMPT, RETRY_MAX, RETRY_DELAY, CIRCUIT_BREAKER_STATE, COMPENSATION_TRIGGERED, COMPENSATION_NODE, DEAD_LETTER_QUEUE, APPROVAL_ID, APPROVAL_TYPE, APPROVAL_STATUS, APPROVAL_TIMEOUT, APPROVAL_ASSIGNEE, TIMER_TYPE, TIMER_DELAY, TIMER_CRON, TIMER_SCHEDULED_AT, TIMER_FIRED_AT, SUBWORKFLOW_NAME, SUBWORKFLOW_DEPTH, SUBWORKFLOW_PARENT_ID, TRIGGER_TYPE, TRIGGER_ID, TRIGGER_SOURCE, WEBHOOK_PATH, WEBHOOK_METHOD, CRON_EXPRESSION, CRON_NEXT_RUN, workflowSpanAttributes, nodeSpanAttributes, llmSpanAttributes, toolSpanAttributes, errorSpanAttributes, retrySpanAttributes, } from './span-attributes';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAGL,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EAEd,YAAY,EACZ,eAAe,EACf,mBAAmB,EAEnB,aAAa,EACb,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EAEf,SAAS,EACT,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EAEX,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EAEd,SAAS,EACT,eAAe,EACf,WAAW,EACX,aAAa,EACb,YAAY,EAEZ,UAAU,EACV,aAAa,EACb,WAAW,EACX,UAAU,EAEV,aAAa,EACb,SAAS,EACT,WAAW,EACX,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EAEjB,WAAW,EACX,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAEjB,UAAU,EACV,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,cAAc,EAEd,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EAErB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EAEb,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC"}

package/dist/observability/metrics.d.ts

@@ -0,0 +1,114 @@
+/**
+ * WorkflowMetricsCollector - Metrics collection for workflow execution
+ *
+ * Features:
+ * - Counters for executions, successes, failures
+ * - Histograms for latency distribution
+ * - Gauges for active workflows, queue depth
+ * - Per-node and per-workflow metrics
+ * - Token and cost tracking
+ * - Prometheus-compatible output
+ */
+import type { MetricsConfig, WorkflowMetrics } from '@cogitator-ai/types';
+/**
+ * WorkflowMetricsCollector - Main metrics collection class
+ */
+export declare class WorkflowMetricsCollector {
+    private config;
+    private counters;
+    private gauges;
+    private histograms;
+    private latencySamples;
+    private nodeMetrics;
+    private tokenUsage;
+    private costTracking;
+    private lastUpdated;
+    constructor(config?: Partial<MetricsConfig>);
+    /**
+     * Get prefixed metric name
+     */
+    private metricName;
+    /**
+     * Record workflow start
+     */
+    recordWorkflowStart(workflowName: string, labels?: Record<string, string>): void;
+    /**
+     * Record workflow completion
+     */
+    recordWorkflowComplete(workflowName: string, durationMs: number, status: 'success' | 'failure' | 'cancelled', labels?: Record<string, string>): void;
+    /**
+     * Record node execution
+     */
+    recordNodeExecution(workflowName: string, nodeName: string, nodeType: string, durationMs: number, success: boolean, retries?: number): void;
+    /**
+     * Record token usage
+     */
+    recordTokenUsage(workflowName: string, inputTokens: number, outputTokens: number): void;
+    /**
+     * Record cost
+     */
+    recordCost(workflowName: string, cost: number): void;
+    /**
+     * Get workflow metrics summary
+     */
+    getWorkflowMetrics(workflowName: string): WorkflowMetrics | null;
+    /**
+     * Increment counter
+     */
+    private incrementCounter;
+    /**
+     * Set gauge value
+     */
+    private setGauge;
+    /**
+     * Increment gauge
+     */
+    private incrementGauge;
+    /**
+     * Decrement gauge
+     */
+    private decrementGauge;
+    /**
+     * Record histogram value
+     */
+    private recordHistogram;
+    /**
+     * Record latency sample for percentile calculations
+     */
+    private recordLatencySample;
+    /**
+     * Get appropriate buckets for a metric
+     */
+    private getBucketsForMetric;
+    /**
+     * Build labeled key for maps
+     */
+    private labeledKey;
+    /**
+     * Export metrics in Prometheus text format
+     */
+    toPrometheusFormat(): string;
+    /**
+     * Format labels for Prometheus
+     */
+    private formatPrometheusLabels;
+    /**
+     * Parse labels from key
+     */
+    private parseLabels;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Get all workflow names with metrics
+     */
+    getWorkflowNames(): string[];
+}
+/**
+ * Create a metrics collector instance
+ */
+export declare function createMetricsCollector(config?: Partial<MetricsConfig>): WorkflowMetricsCollector;
+export declare function getGlobalMetrics(): WorkflowMetricsCollector;
+export declare function setGlobalMetrics(metrics: WorkflowMetricsCollector): void;
+//# sourceMappingURL=metrics.d.ts.map