@zhivex-ai/core 1.4.0 → 1.6.0

package/dist/workflow-observability.js

@@ -0,0 +1,186 @@
+import { createOtelObserver } from "./observability.js";
+const OTEL_API_MODULE = "@opentelemetry/api";
+const WORKFLOW_DURATION_METRIC = "gen_ai.invoke_workflow.duration";
+const WORKFLOW_DURATION_BUCKETS = [1, 5, 10, 30, 60, 120, 300, 600, 1800, 3600, 7200];
+let optionalOtelApiPromise;
+const loadOptionalOtelApi = () => {
+    optionalOtelApiPromise ??= import(OTEL_API_MODULE).catch(() => undefined);
+    return optionalOtelApiPromise;
+};
+const errorType = (error) => error.name || error.constructor?.name || "_OTHER";
+const terminalError = (status, error, fallback) => {
+    if (status !== "failed") {
+        return undefined;
+    }
+    if (error) {
+        return error;
+    }
+    return new Error(fallback);
+};
+const durationSeconds = (startedAt, finishedAt) => Math.max(0, finishedAt - startedAt) / 1000;
+const settleSpanEnds = async (handles, attributes, endTime) => {
+    const results = await Promise.allSettled(Array.from(handles, (handle) => handle.end({ attributes, endTime })));
+    const rejection = results.find((result) => result.status === "rejected");
+    if (rejection) {
+        throw rejection.reason;
+    }
+};
+export const createOtelWorkflowObserver = async (options = {}) => {
+    const [observer, otel] = await Promise.all([
+        options.observer ? Promise.resolve(options.observer) : createOtelObserver(options),
+        options.meter ? Promise.resolve(undefined) : loadOptionalOtelApi()
+    ]);
+    const meter = options.meter ?? otel?.metrics?.getMeter(options.meterName ?? options.tracerName ?? "zhivex-ai", options.version);
+    const durationHistogram = meter?.createHistogram(WORKFLOW_DURATION_METRIC, {
+        description: "Duration of a workflow invocation.",
+        unit: "s",
+        advice: {
+            explicitBucketBoundaries: [...WORKFLOW_DURATION_BUCKETS]
+        }
+    });
+    const workflowSpans = new Map();
+    const stepSpans = new Map();
+    const queues = new Map();
+    const prefix = options.spanNamePrefix?.trim();
+    const workflowSpanName = (workflowName) => prefix
+        ? `${prefix}.workflow`
+        : `invoke_workflow${workflowName ? ` ${workflowName}` : ""}`;
+    const stepSpanName = (stepId) => prefix ? `${prefix}.step` : `workflow_step ${stepId}`;
+    const closeSteps = async (runId, status, endTime) => {
+        const spans = stepSpans.get(runId);
+        stepSpans.delete(runId);
+        if (spans) {
+            await settleSpanEnds(spans.values(), {
+                "zhivex.workflow.step.status": status
+            }, endTime);
+        }
+    };
+    const recordDuration = (active, event, error) => {
+        const attributes = {};
+        const workflowName = event.workflowName ?? active.workflowName;
+        if (workflowName) {
+            attributes["gen_ai.workflow.name"] = workflowName;
+        }
+        if (error) {
+            attributes["error.type"] = errorType(error);
+        }
+        durationHistogram?.record(durationSeconds(active.startedAt, event.finishedAt), attributes);
+    };
+    const closeWorkflow = async (event, error) => {
+        const active = workflowSpans.get(event.runId);
+        workflowSpans.delete(event.runId);
+        let stepError;
+        try {
+            await closeSteps(event.runId, "interrupted", event.finishedAt);
+        }
+        catch (caught) {
+            stepError = caught;
+        }
+        if (active) {
+            try {
+                await active.handle.end({
+                    attributes: {
+                        "zhivex.workflow.status": event.status,
+                        "zhivex.workflow.duration_ms": Math.max(0, event.finishedAt - active.startedAt)
+                    },
+                    error,
+                    endTime: event.finishedAt
+                });
+            }
+            finally {
+                recordDuration(active, event, error);
+            }
+        }
+        if (stepError) {
+            throw stepError;
+        }
+    };
+    const closeStep = async (event) => {
+        const spans = stepSpans.get(event.runId);
+        const handle = spans?.get(event.stepIndex);
+        spans?.delete(event.stepIndex);
+        if (spans && spans.size === 0) {
+            stepSpans.delete(event.runId);
+        }
+        const error = terminalError(event.status, event.error, "Workflow step failed.");
+        await handle?.end({
+            attributes: {
+                "zhivex.workflow.step.status": event.status,
+                "zhivex.workflow.step.duration_ms": Math.max(0, event.finishedAt - event.startedAt)
+            },
+            error,
+            endTime: event.finishedAt
+        });
+    };
+    const processEvent = async (event) => {
+        if (event.type === "workflow-start") {
+            const previous = workflowSpans.get(event.runId);
+            if (previous) {
+                await closeWorkflow({
+                    ...event,
+                    type: "workflow-finish",
+                    status: "failed",
+                    finishedAt: event.startedAt,
+                    error: new Error("Workflow invocation was replaced before it finished.")
+                }, new Error("Workflow invocation was replaced before it finished."));
+            }
+            workflowSpans.set(event.runId, {
+                startedAt: event.startedAt,
+                workflowName: event.workflowName,
+                handle: observer.startSpan(workflowSpanName(event.workflowName), {
+                    "gen_ai.operation.name": "invoke_workflow",
+                    "gen_ai.workflow.name": event.workflowName,
+                    "gen_ai.conversation.id": event.sessionId,
+                    "zhivex.workflow.id": event.workflowId,
+                    "zhivex.workflow.run_id": event.runId
+                }, { kind: "internal", startTime: event.startedAt })
+            });
+            return;
+        }
+        if (event.type === "workflow-step-start") {
+            const spans = stepSpans.get(event.runId) ?? new Map();
+            const previous = spans.get(event.stepIndex);
+            spans.delete(event.stepIndex);
+            await previous?.end({
+                attributes: { "zhivex.workflow.step.status": "replaced" },
+                endTime: event.startedAt
+            });
+            spans.set(event.stepIndex, observer.startSpan(stepSpanName(event.stepId), {
+                "gen_ai.workflow.name": event.workflowName,
+                "zhivex.workflow.id": event.workflowId,
+                "zhivex.workflow.run_id": event.runId,
+                "zhivex.workflow.step.id": event.stepId,
+                "zhivex.workflow.step.index": event.stepIndex,
+                "zhivex.workflow.step.kind": event.stepKind
+            }, {
+                kind: "internal",
+                parent: workflowSpans.get(event.runId)?.handle,
+                startTime: event.startedAt
+            }));
+            stepSpans.set(event.runId, spans);
+            return;
+        }
+        if (event.type === "workflow-step-finish") {
+            await closeStep(event);
+            return;
+        }
+        const error = terminalError(event.status, event.error, "Workflow execution failed.");
+        await closeWorkflow(event, error);
+    };
+    const workflowObserver = (event) => {
+        const previous = queues.get(event.runId) ?? Promise.resolve();
+        const task = previous.catch(() => undefined).then(() => processEvent(event));
+        queues.set(event.runId, task);
+        return task.finally(() => {
+            if (queues.get(event.runId) === task) {
+                queues.delete(event.runId);
+            }
+        });
+    };
+    workflowObserver.withStepContext = (runId, stepIndex, callback) => {
+        const handle = stepSpans.get(runId)?.get(stepIndex);
+        return handle ? observer.withSpan(handle, callback) : callback();
+    };
+    return workflowObserver;
+};
+//# sourceMappingURL=workflow-observability.js.map

package/dist/workflow-observability.js.map

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

package/dist/workflow.d.ts

@@ -57,9 +57,12 @@ export interface WorkflowLoopStep<TModel extends LanguageModel = LanguageModel>
 export type WorkflowStep<TModel extends LanguageModel = LanguageModel> = WorkflowTaskStep<TModel> | WorkflowParallelStep | WorkflowLoopStep<TModel>;
 export interface WorkflowDefinition {
     id?: string;
+    name?: string;
     steps: WorkflowStep[];
     metadata?: Record<string, JsonValue>;
     persistence?: WorkflowPersistenceOptions;
+    /** Best-effort operational telemetry. Observer failures never fail workflow execution. */
+    onTelemetryEvent?: WorkflowTelemetryObserver;
 }
 export interface WorkflowPersistenceOptions {
     appName: string;
@@ -71,6 +74,7 @@ export interface WorkflowPersistenceOptions {
 export interface WorkflowRunInput {
     userId: string;
     sessionId?: string;
+    abortSignal?: AbortSignal;
     input?: JsonValue;
     state?: WorkflowRunState;
     approvals?: AgentApprovalResponse[];
@@ -78,6 +82,8 @@ export interface WorkflowRunInput {
     eventMetadata?: Record<string, JsonValue>;
     metadata?: Record<string, JsonValue>;
     resumeFromPersistedState?: boolean;
+    /** Overrides the definition observer for this invocation. Fail-open by contract. */
+    onTelemetryEvent?: WorkflowTelemetryObserver;
 }
 export interface WorkflowStepResult {
     id: string;
@@ -125,6 +131,49 @@ export interface WorkflowRunOutput {
     steps: WorkflowStepResult[];
     session?: AgentSession;
 }
+export type WorkflowTelemetryTerminalStatus = "completed" | "waiting_approval" | "failed" | "cancelled";
+export type WorkflowTelemetryStepKind = "task" | "parallel" | "loop";
+export interface WorkflowTelemetryContext {
+    runId: string;
+    workflowId?: string;
+    workflowName?: string;
+    userId: string;
+    sessionId?: string;
+}
+export interface WorkflowTelemetryStartEvent extends WorkflowTelemetryContext {
+    type: "workflow-start";
+    startedAt: number;
+}
+export interface WorkflowTelemetryStepStartEvent extends WorkflowTelemetryContext {
+    type: "workflow-step-start";
+    stepId: string;
+    stepIndex: number;
+    stepKind: WorkflowTelemetryStepKind;
+    startedAt: number;
+}
+export interface WorkflowTelemetryStepFinishEvent extends WorkflowTelemetryContext {
+    type: "workflow-step-finish";
+    stepId: string;
+    stepIndex: number;
+    stepKind: WorkflowTelemetryStepKind;
+    status: WorkflowTelemetryTerminalStatus;
+    startedAt: number;
+    finishedAt: number;
+    error?: Error;
+}
+export interface WorkflowTelemetryFinishEvent extends WorkflowTelemetryContext {
+    type: "workflow-finish";
+    status: WorkflowTelemetryTerminalStatus;
+    startedAt: number;
+    finishedAt: number;
+    error?: Error;
+}
+export type WorkflowTelemetryEvent = WorkflowTelemetryStartEvent | WorkflowTelemetryStepStartEvent | WorkflowTelemetryStepFinishEvent | WorkflowTelemetryFinishEvent;
+export interface WorkflowTelemetryObserver {
+    (event: WorkflowTelemetryEvent): void | Promise<void>;
+    /** Runs a step while an observer-specific context is active. Implementations must invoke callback once. */
+    withStepContext?<T>(runId: string, stepIndex: number, callback: () => Promise<T>): Promise<T>;
+}
 export type WorkflowReplayTimelineEvent = {
     type: "workflow-start";
     runId: string;

package/dist/workflow.d.ts.map

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