@juspay/neurolink 9.23.0 → 9.25.0

package/dist/lib/workflow/config.d.ts

@@ -39,11 +39,11 @@ export declare const ModelConfigSchema: z.ZodObject<{
     maxTokens?: number | undefined;
     metadata?: Record<string, JsonValue> | undefined;
     systemPrompt?: string | undefined;
+    weight?: number | undefined;
     topK?: number | undefined;
     topP?: number | undefined;
     presencePenalty?: number | undefined;
     frequencyPenalty?: number | undefined;
-    weight?: number | undefined;
     label?: string | undefined;
 }, {
     provider: string;
@@ -53,11 +53,11 @@ export declare const ModelConfigSchema: z.ZodObject<{
     maxTokens?: number | undefined;
     metadata?: Record<string, JsonValue> | undefined;
     systemPrompt?: string | undefined;
+    weight?: number | undefined;
     topK?: number | undefined;
     topP?: number | undefined;
     presencePenalty?: number | undefined;
     frequencyPenalty?: number | undefined;
-    weight?: number | undefined;
     label?: string | undefined;
 }>;
 /**
@@ -208,11 +208,11 @@ export declare const ModelGroupSchema: z.ZodObject<{
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }, {
         provider: string;
@@ -222,11 +222,11 @@ export declare const ModelGroupSchema: z.ZodObject<{
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }>, "many">;
     executionStrategy: z.ZodEnum<["parallel", "sequential"]>;
@@ -244,11 +244,11 @@ export declare const ModelGroupSchema: z.ZodObject<{
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }[];
     id: string;
@@ -269,11 +269,11 @@ export declare const ModelGroupSchema: z.ZodObject<{
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }[];
     id: string;
@@ -363,11 +363,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }, {
         provider: string;
@@ -377,11 +377,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }>, "many">;
     modelGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -410,11 +410,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             maxTokens?: number | undefined;
             metadata?: Record<string, JsonValue> | undefined;
             systemPrompt?: string | undefined;
+            weight?: number | undefined;
             topK?: number | undefined;
             topP?: number | undefined;
             presencePenalty?: number | undefined;
             frequencyPenalty?: number | undefined;
-            weight?: number | undefined;
             label?: string | undefined;
         }, {
             provider: string;
@@ -424,11 +424,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             maxTokens?: number | undefined;
             metadata?: Record<string, JsonValue> | undefined;
             systemPrompt?: string | undefined;
+            weight?: number | undefined;
             topK?: number | undefined;
             topP?: number | undefined;
             presencePenalty?: number | undefined;
             frequencyPenalty?: number | undefined;
-            weight?: number | undefined;
             label?: string | undefined;
         }>, "many">;
         executionStrategy: z.ZodEnum<["parallel", "sequential"]>;
@@ -446,11 +446,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             maxTokens?: number | undefined;
             metadata?: Record<string, JsonValue> | undefined;
             systemPrompt?: string | undefined;
+            weight?: number | undefined;
             topK?: number | undefined;
             topP?: number | undefined;
             presencePenalty?: number | undefined;
             frequencyPenalty?: number | undefined;
-            weight?: number | undefined;
             label?: string | undefined;
         }[];
         id: string;
@@ -471,11 +471,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             maxTokens?: number | undefined;
             metadata?: Record<string, JsonValue> | undefined;
             systemPrompt?: string | undefined;
+            weight?: number | undefined;
             topK?: number | undefined;
             topP?: number | undefined;
             presencePenalty?: number | undefined;
             frequencyPenalty?: number | undefined;
-            weight?: number | undefined;
             label?: string | undefined;
         }[];
         id: string;
@@ -714,7 +714,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     createdAt: z.ZodOptional<z.ZodString>;
     updatedAt: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: "custom" | "ensemble" | "chain" | "adaptive";
+    type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
     models: {
         provider: AIProviderName;
@@ -724,11 +724,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }[];
     id: string;
@@ -751,6 +751,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     version?: string | undefined;
     tags?: string[] | undefined;
     metadata?: Record<string, JsonValue> | undefined;
+    description?: string | undefined;
     judge?: {
         provider: AIProviderName;
         model: string;
@@ -785,7 +786,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         addModelAttribution?: boolean | undefined;
         addExecutionTime?: boolean | undefined;
     } | undefined;
-    description?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
@@ -797,11 +797,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             maxTokens?: number | undefined;
             metadata?: Record<string, JsonValue> | undefined;
             systemPrompt?: string | undefined;
+            weight?: number | undefined;
             topK?: number | undefined;
             topP?: number | undefined;
             presencePenalty?: number | undefined;
             frequencyPenalty?: number | undefined;
-            weight?: number | undefined;
             label?: string | undefined;
         }[];
         id: string;
@@ -836,7 +836,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         blindEvaluation?: boolean | undefined;
     }[] | undefined;
 }, {
-    type: "custom" | "ensemble" | "chain" | "adaptive";
+    type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
     models: {
         provider: string;
@@ -846,11 +846,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }[];
     id: string;
@@ -873,6 +873,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     version?: string | undefined;
     tags?: string[] | undefined;
     metadata?: Record<string, JsonValue> | undefined;
+    description?: string | undefined;
     judge?: {
         provider: string;
         model: string;
@@ -907,7 +908,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         addModelAttribution?: boolean | undefined;
         addExecutionTime?: boolean | undefined;
     } | undefined;
-    description?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
@@ -919,11 +919,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             maxTokens?: number | undefined;
             metadata?: Record<string, JsonValue> | undefined;
             systemPrompt?: string | undefined;
+            weight?: number | undefined;
             topK?: number | undefined;
             topP?: number | undefined;
             presencePenalty?: number | undefined;
             frequencyPenalty?: number | undefined;
-            weight?: number | undefined;
             label?: string | undefined;
         }[];
         id: string;
@@ -958,7 +958,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         blindEvaluation?: boolean | undefined;
     }[] | undefined;
 }>, {
-    type: "custom" | "ensemble" | "chain" | "adaptive";
+    type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
     models: {
         provider: AIProviderName;
@@ -968,11 +968,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }[];
     id: string;
@@ -995,6 +995,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     version?: string | undefined;
     tags?: string[] | undefined;
     metadata?: Record<string, JsonValue> | undefined;
+    description?: string | undefined;
     judge?: {
         provider: AIProviderName;
         model: string;
@@ -1029,7 +1030,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         addModelAttribution?: boolean | undefined;
         addExecutionTime?: boolean | undefined;
     } | undefined;
-    description?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
@@ -1041,11 +1041,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             maxTokens?: number | undefined;
             metadata?: Record<string, JsonValue> | undefined;
             systemPrompt?: string | undefined;
+            weight?: number | undefined;
             topK?: number | undefined;
             topP?: number | undefined;
             presencePenalty?: number | undefined;
             frequencyPenalty?: number | undefined;
-            weight?: number | undefined;
             label?: string | undefined;
         }[];
         id: string;
@@ -1080,7 +1080,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         blindEvaluation?: boolean | undefined;
     }[] | undefined;
 }, {
-    type: "custom" | "ensemble" | "chain" | "adaptive";
+    type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
     models: {
         provider: string;
@@ -1090,11 +1090,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }[];
     id: string;
@@ -1117,6 +1117,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     version?: string | undefined;
     tags?: string[] | undefined;
     metadata?: Record<string, JsonValue> | undefined;
+    description?: string | undefined;
     judge?: {
         provider: string;
         model: string;
@@ -1151,7 +1152,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         addModelAttribution?: boolean | undefined;
         addExecutionTime?: boolean | undefined;
     } | undefined;
-    description?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
@@ -1163,11 +1163,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             maxTokens?: number | undefined;
             metadata?: Record<string, JsonValue> | undefined;
             systemPrompt?: string | undefined;
+            weight?: number | undefined;
             topK?: number | undefined;
             topP?: number | undefined;
             presencePenalty?: number | undefined;
             frequencyPenalty?: number | undefined;
-            weight?: number | undefined;
             label?: string | undefined;
         }[];
         id: string;
@@ -1202,7 +1202,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         blindEvaluation?: boolean | undefined;
     }[] | undefined;
 }>, {
-    type: "custom" | "ensemble" | "chain" | "adaptive";
+    type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
     models: {
         provider: AIProviderName;
@@ -1212,11 +1212,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }[];
     id: string;
@@ -1239,6 +1239,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     version?: string | undefined;
     tags?: string[] | undefined;
     metadata?: Record<string, JsonValue> | undefined;
+    description?: string | undefined;
     judge?: {
         provider: AIProviderName;
         model: string;
@@ -1273,7 +1274,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         addModelAttribution?: boolean | undefined;
         addExecutionTime?: boolean | undefined;
     } | undefined;
-    description?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
@@ -1285,11 +1285,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             maxTokens?: number | undefined;
             metadata?: Record<string, JsonValue> | undefined;
             systemPrompt?: string | undefined;
+            weight?: number | undefined;
             topK?: number | undefined;
             topP?: number | undefined;
             presencePenalty?: number | undefined;
             frequencyPenalty?: number | undefined;
-            weight?: number | undefined;
             label?: string | undefined;
         }[];
         id: string;
@@ -1324,7 +1324,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         blindEvaluation?: boolean | undefined;
     }[] | undefined;
 }, {
-    type: "custom" | "ensemble" | "chain" | "adaptive";
+    type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
     models: {
         provider: string;
@@ -1334,11 +1334,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         maxTokens?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
         systemPrompt?: string | undefined;
+        weight?: number | undefined;
         topK?: number | undefined;
         topP?: number | undefined;
         presencePenalty?: number | undefined;
         frequencyPenalty?: number | undefined;
-        weight?: number | undefined;
         label?: string | undefined;
     }[];
     id: string;
@@ -1361,6 +1361,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     version?: string | undefined;
     tags?: string[] | undefined;
     metadata?: Record<string, JsonValue> | undefined;
+    description?: string | undefined;
     judge?: {
         provider: string;
         model: string;
@@ -1395,7 +1396,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         addModelAttribution?: boolean | undefined;
         addExecutionTime?: boolean | undefined;
     } | undefined;
-    description?: string | undefined;
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
@@ -1407,11 +1407,11 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             maxTokens?: number | undefined;
             metadata?: Record<string, JsonValue> | undefined;
             systemPrompt?: string | undefined;
+            weight?: number | undefined;
             topK?: number | undefined;
             topP?: number | undefined;
             presencePenalty?: number | undefined;
             frequencyPenalty?: number | undefined;
-            weight?: number | undefined;
             label?: string | undefined;
         }[];
         id: string;

package/dist/lib/workflow/core/ensembleExecutor.js

@@ -5,6 +5,7 @@
 import pLimit from "p-limit";
 import { AIProviderFactory } from "../../core/factory.js";
 import { logger } from "../../utils/logger.js";
+import { SpanSerializer, SpanType, SpanStatus, getMetricsAggregator, } from "../../observability/index.js";
 import { WorkflowError } from "../types.js";
 const functionTag = "EnsembleExecutor";
 // ============================================================================
@@ -18,6 +19,11 @@ const functionTag = "EnsembleExecutor";
 export async function executeEnsemble(options) {
     const startTime = Date.now();
     const { prompt, models, executionConfig, systemPrompt, workflowDefaults } = options;
+    const span = SpanSerializer.createSpan(SpanType.WORKFLOW, "workflow.ensemble", {
+        "workflow.operation": "ensemble",
+        "workflow.model_count": models.length,
+        "workflow.parallelism": executionConfig?.parallelism || 10,
+    });
     logger.info(`[${functionTag}] Starting ensemble execution`, {
         modelCount: models.length,
         parallelism: executionConfig?.parallelism || 10,
@@ -65,6 +71,10 @@ export async function executeEnsemble(options) {
         failureCount,
         totalResponses: responses.length,
     });
+    span.durationMs = totalTime;
+    const spanStatus = successCount > 0 ? SpanStatus.OK : SpanStatus.ERROR;
+    const endedSpan = SpanSerializer.endSpan(span, spanStatus, successCount === 0 ? "No successful model responses" : undefined);
+    getMetricsAggregator().recordSpan(endedSpan);
     return {
         responses,
         totalTime,

package/dist/lib/workflow/core/judgeScorer.js

@@ -4,6 +4,7 @@
  */
 import { AIProviderFactory } from "../../core/factory.js";
 import { logger } from "../../utils/logger.js";
+import { SpanSerializer, SpanType, SpanStatus, getMetricsAggregator, } from "../../observability/index.js";
 import { MAX_REASONING_LENGTH } from "../config.js";
 import { WorkflowError } from "../types.js";
 const functionTag = "JudgeScorer";
@@ -18,6 +19,12 @@ const functionTag = "JudgeScorer";
 export async function scoreEnsemble(options) {
     const startTime = Date.now();
     const { judges, responses, originalPrompt, systemPrompt, timeout, workflowDefaults, } = options;
+    const span = SpanSerializer.createSpan(SpanType.WORKFLOW, "workflow.judge", {
+        "workflow.operation": "judge",
+        "workflow.judge_count": judges.length,
+        "workflow.response_count": responses.length,
+        "workflow.pattern": judges.length > 1 ? "multi-judge" : "single-judge",
+    });
     logger.info(`[${functionTag}] Starting judge scoring`, {
         judgeCount: judges.length,
         responseCount: responses.length,
@@ -36,17 +43,25 @@ export async function scoreEnsemble(options) {
         if (judges.length === 1) {
             // Single judge scoring
             const judgeResult = await executeSingleJudge(judges[0], successfulResponses, originalPrompt, systemPrompt, timeout, workflowDefaults?.judgePrompt);
+            const judgeTime = Date.now() - startTime;
+            span.durationMs = judgeTime;
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+            getMetricsAggregator().recordSpan(endedSpan);
             return {
                 scores: judgeResult,
-                judgeTime: Date.now() - startTime,
+                judgeTime,
             };
         }
         else {
             // Multi-judge voting
             const multiJudgeResult = await executeMultiJudge(judges, successfulResponses, originalPrompt, systemPrompt, timeout, workflowDefaults?.judgePrompt);
+            const judgeTime = Date.now() - startTime;
+            span.durationMs = judgeTime;
+            const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+            getMetricsAggregator().recordSpan(endedSpan);
             return {
                 scores: multiJudgeResult,
-                judgeTime: Date.now() - startTime,
+                judgeTime,
             };
         }
     }
@@ -55,6 +70,9 @@ export async function scoreEnsemble(options) {
         logger.error(`[${functionTag}] Judge scoring failed`, {
             error: err.message,
         });
+        span.durationMs = Date.now() - startTime;
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR, err.message);
+        getMetricsAggregator().recordSpan(endedSpan);
         const workflowError = error instanceof WorkflowError
             ? error
             : new WorkflowError(err.message, {

package/dist/lib/workflow/core/workflowRunner.js

@@ -12,6 +12,7 @@
  * @module workflow/core/workflowRunner
  */
 import { logger } from "../../utils/logger.js";
+import { SpanSerializer, SpanType, SpanStatus, getMetricsAggregator, } from "../../observability/index.js";
 import { getModelGroups, PLACEHOLDER_MODEL, PLACEHOLDER_PROVIDER, usesModelGroups, } from "../config.js";
 import { validateWorkflow } from "../utils/workflowValidation.js";
 import { executeEnsemble, executeModelGroups } from "./ensembleExecutor.js";
@@ -45,9 +46,18 @@ import { conditionResponse } from "./responseConditioner.js";
  */
 export async function runWorkflow(config, options) {
     const startTime = Date.now();
+    const span = SpanSerializer.createSpan(SpanType.WORKFLOW, "workflow.run", {
+        "workflow.operation": "run",
+        "workflow.name": config.name,
+        "workflow.type": config.type,
+        "workflow.id": config.id,
+    });
     // Validate configuration
     const validation = validateWorkflow(config);
     if (!validation.valid) {
+        span.durationMs = Date.now() - startTime;
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR, `Invalid workflow configuration: ${validation.errors.map((err) => err.message).join(", ")}`);
+        getMetricsAggregator().recordSpan(endedSpan);
         throw new Error(`Invalid workflow configuration: ${validation.errors.map((err) => err.message).join(", ")}`);
     }
     if (options.verbose) {
@@ -146,6 +156,9 @@ export async function runWorkflow(config, options) {
             logger.debug(`[WorkflowRunner] Workflow complete in ${executionTime}ms`);
             logger.debug(`[WorkflowRunner] Total tokens: ${result.usage?.totalTokens || 0}`);
         }
+        span.durationMs = executionTime;
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+        getMetricsAggregator().recordSpan(endedSpan);
         return result;
     }
     catch (error) {
@@ -154,6 +167,9 @@ export async function runWorkflow(config, options) {
         if (options.verbose) {
             logger.error(`[WorkflowRunner] Workflow failed:`, errorMessage);
         }
+        span.durationMs = executionTime;
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR, errorMessage);
+        getMetricsAggregator().recordSpan(endedSpan);
         // Return error result with dummy data
         const dummyResponse = {
             provider: PLACEHOLDER_PROVIDER,
@@ -444,9 +460,18 @@ function calculateTotalTokens(responses) {
  */
 export async function* runWorkflowWithStreaming(config, options) {
     const startTime = Date.now();
+    const span = SpanSerializer.createSpan(SpanType.WORKFLOW, "workflow.run.streaming", {
+        "workflow.operation": "run.streaming",
+        "workflow.name": config.name,
+        "workflow.type": config.type,
+        "workflow.id": config.id,
+    });
     // Validate configuration
     const validation = validateWorkflow(config);
     if (!validation.valid) {
+        span.durationMs = Date.now() - startTime;
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR, `Invalid workflow configuration: ${validation.errors.map((err) => err.message).join(", ")}`);
+        getMetricsAggregator().recordSpan(endedSpan);
         throw new Error(`Invalid workflow configuration: ${validation.errors.map((err) => err.message).join(", ")}`);
     }
     if (options.verbose) {
@@ -543,10 +568,18 @@ export async function* runWorkflowWithStreaming(config, options) {
                 timestamp: new Date().toISOString(),
             },
         };
+        span.durationMs = executionTime;
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.OK);
+        getMetricsAggregator().recordSpan(endedSpan);
     }
     catch (error) {
+        const executionTime = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        span.durationMs = executionTime;
+        const endedSpan = SpanSerializer.endSpan(span, SpanStatus.ERROR, errorMessage);
+        getMetricsAggregator().recordSpan(endedSpan);
         logger.error(`[WorkflowRunner] Streaming workflow failed`, {
-            error: error instanceof Error ? error.message : String(error),
+            error: errorMessage,
         });
         throw error;
     }