@qodo/sdk 0.7.0 → 0.8.0

package/dist/tracing/PipelineTracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineTracer.d.ts","sourceRoot":"","sources":["../../src/tracing/PipelineTracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAuC,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAyB,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC5D;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAChH,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,EACjC,YAAY,EAAE,KAAK,EACnB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAkDjC"}

package/dist/tracing/PipelineTracer.js

@@ -0,0 +1,64 @@
+/**
+ * Pipeline-level tracing adapter.
+ *
+ * Creates a parent span for the entire pipeline execution, with
+ * child spans for each step (sequential or parallel). Tool-level
+ * spans from SdkTracer nest inside the step spans automatically
+ * when using OTel context propagation.
+ *
+ * Usage:
+ *
+ *   import * as otel from '@opentelemetry/api';
+ *   import { createSdkTracer, tracePipeline } from '@qodo/sdk';
+ *
+ *   const result = await tracePipeline(otel, sdk, pipeline, initialState);
+ */
+/**
+ * Execute a pipeline with OTel tracing.
+ *
+ * Creates a root span for the pipeline, and child spans for each step.
+ * This is a convenience wrapper around runPipeline that adds tracing.
+ */
+export async function tracePipeline(otel, sdk, pipeline, initialState, options) {
+    // Lazy import to avoid circular dependency
+    const { runPipeline: runPipelineFn } = await import('../sdk/pipeline/PipelineRunner.js');
+    const { isParallelGroup, executeStepWithTracing, executeParallelGroupWithTracing } = await import('./pipelineHelpers.js');
+    const tracer = otel.trace.getTracer(options?.tracerName ?? '@qodo/sdk');
+    const rootSpan = tracer.startSpan('qodo.pipeline', {
+        attributes: {
+            'qodo.pipeline.step_count': pipeline.entries.length,
+            ...(options?.rootAttributes ?? {}),
+        },
+    });
+    const rootContext = otel.trace.setSpan(otel.context.active(), rootSpan);
+    try {
+        // State starts as TInit and accumulates step outputs to become TState at runtime
+        let state = { ...initialState };
+        const stepLogs = [];
+        for (const entry of pipeline.entries) {
+            if (isParallelGroup(entry)) {
+                const { newState, logs } = await executeParallelGroupWithTracing(otel, tracer, rootContext, sdk, entry, state);
+                state = { ...state, ...newState };
+                stepLogs.push(...logs);
+            }
+            else {
+                const { newState, log } = await executeStepWithTracing(otel, tracer, rootContext, sdk, entry, state);
+                state = { ...state, ...newState };
+                stepLogs.push(log);
+            }
+        }
+        rootSpan.setAttribute('qodo.pipeline.success', true);
+        rootSpan.setStatus({ code: otel.SpanStatusCode.OK });
+        rootSpan.end();
+        return { state, steps: stepLogs };
+    }
+    catch (err) {
+        rootSpan.setAttribute('qodo.pipeline.success', false);
+        const message = err instanceof Error ? err.message : String(err);
+        rootSpan.setStatus({ code: otel.SpanStatusCode.ERROR, message });
+        rootSpan.recordException(err instanceof Error ? err : new Error(message));
+        rootSpan.end();
+        throw err;
+    }
+}
+//# sourceMappingURL=PipelineTracer.js.map

package/dist/tracing/PipelineTracer.js.map

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

package/dist/tracing/SdkTracer.d.ts

@@ -0,0 +1,91 @@
+/**
+ * OpenTelemetry tracing adapter for @qodo/sdk.
+ *
+ * Consumes the SDK event stream and produces OTel spans:
+ *
+ *   - One root span per sdk.run() / pipeline execution
+ *   - Child spans per tool call (ToolRequested -> ToolExecuted)
+ *   - Error recording on sdk.error and tool failures
+ *   - Span attributes: tool_name, server_name, approved, dry_run, model, etc.
+ *
+ * Usage:
+ *
+ *   import * as otel from '@opentelemetry/api';
+ *   import { createSdkTracer } from '@qodo/sdk';
+ *
+ *   const tracer = createSdkTracer(otel);
+ *
+ *   for await (const ev of sdk.stream('review')) {
+ *     tracer.onEvent(ev);
+ *   }
+ *   // Or use the stream wrapper:
+ *   for await (const ev of tracer.wrapStream(sdk.stream('review'))) {
+ *     // events pass through unchanged
+ *   }
+ */
+import type { QodoSdkEvent } from '../sdk/events.js';
+import type { OTelAPI } from './types.js';
+export interface SdkTracerOptions {
+    /**
+     * Custom tracer name (default: '@qodo/sdk').
+     */
+    tracerName?: string;
+    /**
+     * Tracer version (default: SDK version from events).
+     */
+    tracerVersion?: string;
+    /**
+     * Additional attributes to add to every root span.
+     */
+    rootAttributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Stateful tracing adapter. Tracks in-flight spans by run_id and tool_call_id.
+ */
+export declare class SdkTracer {
+    private readonly otel;
+    private readonly tracer;
+    private readonly rootAttributes;
+    private readonly runSpans;
+    private readonly toolSpans;
+    constructor(otel: OTelAPI, options?: SdkTracerOptions);
+    /**
+     * Process a single SDK event and update tracing state.
+     *
+     * Call this for each event from sdk.stream() or as an event handler.
+     */
+    onEvent(ev: QodoSdkEvent): void;
+    /**
+     * Wrap an async generator, processing each event for tracing and yielding it unchanged.
+     *
+     * This is the recommended way to integrate tracing with sdk.stream():
+     *
+     *   for await (const ev of tracer.wrapStream(sdk.stream('cmd'))) {
+     *     // process events as usual
+     *   }
+     */
+    wrapStream(stream: AsyncGenerator<QodoSdkEvent, void, unknown>): AsyncGenerator<QodoSdkEvent, void, unknown>;
+    /**
+     * End all in-flight spans. Call this if you need to force-close tracing
+     * (e.g., on process exit or error recovery).
+     */
+    flush(): void;
+    private onRunStarted;
+    private onToolRequested;
+    private onToolApproved;
+    private onToolExecuted;
+    private onError;
+    private onFinal;
+}
+/**
+ * Factory function to create an SdkTracer.
+ *
+ * Usage:
+ *   import * as otel from '@opentelemetry/api';
+ *   import { createSdkTracer } from '@qodo/sdk';
+ *
+ *   const tracer = createSdkTracer(otel);
+ *   for await (const ev of tracer.wrapStream(sdk.stream('review'))) { ... }
+ */
+export declare function createSdkTracer(otel: OTelAPI, options?: SdkTracerOptions): SdkTracer;
+//# sourceMappingURL=SdkTracer.d.ts.map

package/dist/tracing/SdkTracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkTracer.d.ts","sourceRoot":"","sources":["../../src/tracing/SdkTracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAqC,MAAM,YAAY,CAAC;AAI7E,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4C;IAG3E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+D;IAGxF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;gBAE7C,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB;IASrD;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAwB/B;;;;;;;;OAQG;IACI,UAAU,CACf,MAAM,EAAE,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,GAClD,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC;IAY9C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAkBb,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,OAAO;CAgChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAEpF"}

package/dist/tracing/SdkTracer.js

@@ -0,0 +1,243 @@
+/**
+ * OpenTelemetry tracing adapter for @qodo/sdk.
+ *
+ * Consumes the SDK event stream and produces OTel spans:
+ *
+ *   - One root span per sdk.run() / pipeline execution
+ *   - Child spans per tool call (ToolRequested -> ToolExecuted)
+ *   - Error recording on sdk.error and tool failures
+ *   - Span attributes: tool_name, server_name, approved, dry_run, model, etc.
+ *
+ * Usage:
+ *
+ *   import * as otel from '@opentelemetry/api';
+ *   import { createSdkTracer } from '@qodo/sdk';
+ *
+ *   const tracer = createSdkTracer(otel);
+ *
+ *   for await (const ev of sdk.stream('review')) {
+ *     tracer.onEvent(ev);
+ *   }
+ *   // Or use the stream wrapper:
+ *   for await (const ev of tracer.wrapStream(sdk.stream('review'))) {
+ *     // events pass through unchanged
+ *   }
+ */
+import { SdkEventType } from '../sdk/events.js';
+const TRACER_NAME = '@qodo/sdk';
+/**
+ * Stateful tracing adapter. Tracks in-flight spans by run_id and tool_call_id.
+ */
+export class SdkTracer {
+    otel;
+    tracer;
+    rootAttributes;
+    // Active root spans keyed by run_id
+    runSpans = new Map();
+    // Active tool spans keyed by `${run_id}:${tool_call_id}`
+    toolSpans = new Map();
+    constructor(otel, options) {
+        this.otel = otel;
+        this.tracer = otel.trace.getTracer(options?.tracerName ?? TRACER_NAME, options?.tracerVersion);
+        this.rootAttributes = options?.rootAttributes ?? {};
+    }
+    /**
+     * Process a single SDK event and update tracing state.
+     *
+     * Call this for each event from sdk.stream() or as an event handler.
+     */
+    onEvent(ev) {
+        switch (ev.type) {
+            case SdkEventType.RunStarted:
+                this.onRunStarted(ev);
+                break;
+            case SdkEventType.ToolRequested:
+                this.onToolRequested(ev);
+                break;
+            case SdkEventType.ToolApproved:
+                this.onToolApproved(ev);
+                break;
+            case SdkEventType.ToolExecuted:
+                this.onToolExecuted(ev);
+                break;
+            case SdkEventType.Error:
+                this.onError(ev);
+                break;
+            case SdkEventType.Final:
+                this.onFinal(ev);
+                break;
+            // Init, MessageDelta, MessageFull, Progress: no tracing action needed
+        }
+    }
+    /**
+     * Wrap an async generator, processing each event for tracing and yielding it unchanged.
+     *
+     * This is the recommended way to integrate tracing with sdk.stream():
+     *
+     *   for await (const ev of tracer.wrapStream(sdk.stream('cmd'))) {
+     *     // process events as usual
+     *   }
+     */
+    async *wrapStream(stream) {
+        try {
+            for await (const ev of stream) {
+                this.onEvent(ev);
+                yield ev;
+            }
+        }
+        finally {
+            // Ensure any orphaned spans are cleaned up
+            this.flush();
+        }
+    }
+    /**
+     * End all in-flight spans. Call this if you need to force-close tracing
+     * (e.g., on process exit or error recovery).
+     */
+    flush() {
+        for (const span of this.toolSpans.values()) {
+            span.setStatus({ code: this.otel.SpanStatusCode.ERROR, message: 'orphaned' });
+            span.end();
+        }
+        this.toolSpans.clear();
+        for (const { span } of this.runSpans.values()) {
+            span.setStatus({ code: this.otel.SpanStatusCode.ERROR, message: 'orphaned' });
+            span.end();
+        }
+        this.runSpans.clear();
+    }
+    // ---------------------------------------------------------------------------
+    // Event handlers
+    // ---------------------------------------------------------------------------
+    onRunStarted(ev) {
+        const attrs = {
+            'qodo.run_id': ev.run_id,
+            'qodo.session_id': ev.session_id,
+            'qodo.command': ev.data.command || '(prompt)',
+            'qodo.prompt_mode': ev.data.prompt_mode,
+            'qodo.tools_auto_approved': ev.data.tools_auto_approved,
+            'qodo.cwd': ev.data.cwd,
+            'qodo.agent.source': ev.data.agent.source,
+            ...this.rootAttributes,
+        };
+        if (ev.data.agent.path) {
+            attrs['qodo.agent.path'] = ev.data.agent.path;
+        }
+        if (ev.data.dry_run) {
+            attrs['qodo.dry_run'] = true;
+        }
+        const span = this.tracer.startSpan(`qodo.run ${ev.data.command || 'prompt'}`, {
+            attributes: attrs,
+            startTime: ev.timestamp,
+        });
+        const context = this.otel.trace.setSpan(this.otel.context.active(), span);
+        this.runSpans.set(ev.run_id, { span, context });
+    }
+    onToolRequested(ev) {
+        const parentCtx = this.runSpans.get(ev.run_id);
+        const toolKey = `${ev.run_id}:${ev.data.tool_call_id}`;
+        const attrs = {
+            'qodo.tool.call_id': ev.data.tool_call_id,
+            'qodo.tool.server_name': ev.data.server_name,
+            'qodo.tool.name': ev.data.tool_name,
+            'qodo.tool.pending_approval': ev.data.pending_approval,
+        };
+        if (ev.data.reasoning) {
+            // Truncate reasoning to avoid huge span attributes
+            attrs['qodo.tool.reasoning'] = ev.data.reasoning.slice(0, 500);
+        }
+        const span = this.tracer.startSpan(`tool ${ev.data.server_name}/${ev.data.tool_name}`, { attributes: attrs, startTime: ev.timestamp }, parentCtx?.context);
+        this.toolSpans.set(toolKey, span);
+    }
+    onToolApproved(ev) {
+        const toolKey = `${ev.run_id}:${ev.data.tool_call_id}`;
+        const span = this.toolSpans.get(toolKey);
+        if (!span)
+            return;
+        span.setAttribute('qodo.tool.approved', ev.data.approved);
+        if (ev.data.reason) {
+            span.setAttribute('qodo.tool.approval_reason', ev.data.reason);
+        }
+        // If not approved, end the span immediately
+        if (!ev.data.approved) {
+            span.setStatus({ code: this.otel.SpanStatusCode.OK, message: 'declined' });
+            span.end(ev.timestamp);
+            this.toolSpans.delete(toolKey);
+        }
+    }
+    onToolExecuted(ev) {
+        const toolKey = `${ev.run_id}:${ev.data.tool_call_id}`;
+        const span = this.toolSpans.get(toolKey);
+        if (!span)
+            return;
+        span.setAttribute('qodo.tool.is_error', ev.data.result.isError);
+        if (ev.data.dry_run) {
+            span.setAttribute('qodo.tool.dry_run', true);
+        }
+        if (ev.data.result.isError) {
+            const errorContent = typeof ev.data.result.content === 'string'
+                ? ev.data.result.content
+                : JSON.stringify(ev.data.result.content);
+            span.setStatus({ code: this.otel.SpanStatusCode.ERROR, message: errorContent.slice(0, 500) });
+            span.recordException(errorContent.slice(0, 1000));
+        }
+        else {
+            span.setStatus({ code: this.otel.SpanStatusCode.OK });
+        }
+        span.end(ev.timestamp);
+        this.toolSpans.delete(toolKey);
+    }
+    onError(ev) {
+        const runEntry = this.runSpans.get(ev.run_id);
+        if (!runEntry)
+            return;
+        runEntry.span.recordException(ev.data.message);
+        runEntry.span.addEvent('sdk.error', {
+            'error.message': ev.data.message,
+        });
+    }
+    onFinal(ev) {
+        const runEntry = this.runSpans.get(ev.run_id);
+        if (!runEntry)
+            return;
+        const { span } = runEntry;
+        span.setAttribute('qodo.success', ev.data.success);
+        if (ev.data.model) {
+            span.setAttribute('qodo.model', ev.data.model);
+        }
+        if (ev.data.meta?.timed_out) {
+            span.setAttribute('qodo.timed_out', true);
+        }
+        if (ev.data.meta?.dry_run) {
+            span.setAttribute('qodo.dry_run', true);
+        }
+        if (ev.data.success) {
+            span.setStatus({ code: this.otel.SpanStatusCode.OK });
+        }
+        else {
+            span.setStatus({
+                code: this.otel.SpanStatusCode.ERROR,
+                message: ev.data.error || 'run failed',
+            });
+            if (ev.data.error) {
+                span.recordException(ev.data.error);
+            }
+        }
+        span.end(ev.timestamp);
+        this.runSpans.delete(ev.run_id);
+    }
+}
+/**
+ * Factory function to create an SdkTracer.
+ *
+ * Usage:
+ *   import * as otel from '@opentelemetry/api';
+ *   import { createSdkTracer } from '@qodo/sdk';
+ *
+ *   const tracer = createSdkTracer(otel);
+ *   for await (const ev of tracer.wrapStream(sdk.stream('review'))) { ... }
+ */
+export function createSdkTracer(otel, options) {
+    return new SdkTracer(otel, options);
+}
+//# sourceMappingURL=SdkTracer.js.map

package/dist/tracing/SdkTracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkTracer.js","sourceRoot":"","sources":["../../src/tracing/SdkTracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIhD,MAAM,WAAW,GAAG,WAAW,CAAC;AAmBhC;;GAEG;AACH,MAAM,OAAO,SAAS;IACH,IAAI,CAAU;IACd,MAAM,CAAa;IACnB,cAAc,CAA4C;IAE3E,oCAAoC;IACnB,QAAQ,GAAG,IAAI,GAAG,EAAoD,CAAC;IAExF,yDAAyD;IACxC,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEzD,YAAY,IAAa,EAAE,OAA0B;QACnD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAChC,OAAO,EAAE,UAAU,IAAI,WAAW,EAClC,OAAO,EAAE,aAAa,CACvB,CAAC;QACF,IAAI,CAAC,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,EAAE,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,EAAgB;QACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,YAAY,CAAC,UAAU;gBAC1B,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;gBACtB,MAAM;YACR,KAAK,YAAY,CAAC,aAAa;gBAC7B,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;gBACzB,MAAM;YACR,KAAK,YAAY,CAAC,YAAY;gBAC5B,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,YAAY,CAAC,YAAY;gBAC5B,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,YAAY,CAAC,KAAK;gBACrB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACjB,MAAM;YACR,KAAK,YAAY,CAAC,KAAK;gBACrB,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACjB,MAAM;YACR,sEAAsE;QACxE,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,UAAU,CACf,MAAmD;QAEnD,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;gBAC9B,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACjB,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,2CAA2C;YAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YAC9E,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAEvB,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YAC9E,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,8EAA8E;IAC9E,iBAAiB;IACjB,8EAA8E;IAEtE,YAAY,CAAC,EAAmE;QACtF,MAAM,KAAK,GAA8C;YACvD,aAAa,EAAE,EAAE,CAAC,MAAM;YACxB,iBAAiB,EAAE,EAAE,CAAC,UAAU;YAChC,cAAc,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,UAAU;YAC7C,kBAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW;YACvC,0BAA0B,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB;YACvD,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG;YACvB,mBAAmB,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YACzC,GAAG,IAAI,CAAC,cAAc;SACvB,CAAC;QAEF,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACvB,KAAK,CAAC,iBAAiB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAChD,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,KAAK,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;QAC/B,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,EAAE,EAAE;YAC5E,UAAU,EAAE,KAAK;YACjB,SAAS,EAAE,EAAE,CAAC,SAAS;SACxB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QAC1E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAEO,eAAe,CAAC,EAAsE;QAC5F,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAEvD,MAAM,KAAK,GAA8C;YACvD,mBAAmB,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY;YACzC,uBAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW;YAC5C,gBAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS;YACnC,4BAA4B,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB;SACvD,CAAC;QAEF,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACtB,mDAAmD;YACnD,KAAK,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAChC,QAAQ,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAClD,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,EAC9C,SAAS,EAAE,OAAO,CACnB,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAEO,cAAc,CAAC,EAAqE;QAC1F,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,YAAY,CAAC,2BAA2B,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjE,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YAC3E,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YACvB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,EAAqE;QAC1F,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChE,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,YAAY,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,YAAY,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ;gBAC7D,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;gBACxB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3C,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9F,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QACvB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAEO,OAAO,CAAC,EAA8D;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE;YAClC,eAAe,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO;SACjC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO,CAAC,EAA8D;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;QAE1B,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK;gBACpC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,YAAY;aACvC,CAAC,CAAC;YACH,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAClB,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa,EAAE,OAA0B;IACvE,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/tracing/index.d.ts

@@ -0,0 +1,6 @@
+export { SdkTracer, createSdkTracer } from './SdkTracer.js';
+export type { SdkTracerOptions } from './SdkTracer.js';
+export { tracePipeline } from './PipelineTracer.js';
+export type { TracePipelineOptions } from './PipelineTracer.js';
+export type { OTelAPI, OTelSpan, OTelTracer, OTelContext, OTelContextAPI, OTelTraceAPI } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/tracing/index.js

@@ -0,0 +1,3 @@
+export { SdkTracer, createSdkTracer } from './SdkTracer.js';
+export { tracePipeline } from './PipelineTracer.js';
+//# sourceMappingURL=index.js.map

package/dist/tracing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tracing/pipelineHelpers.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Internal helpers for pipeline tracing.
+ *
+ * Separated from PipelineTracer to keep the main file focused on the
+ * public API and to allow independent testing.
+ */
+import type { QodoSDK } from '../sdk/QodoSDK.js';
+import type { PipelineStep, ParallelGroup, StepLog } from '../sdk/pipeline/types.js';
+import type { PipelineEntry } from '../sdk/pipeline/types.js';
+import type { OTelAPI, OTelTracer, OTelContext } from './types.js';
+export declare function isParallelGroup<T>(entry: PipelineEntry<T>): entry is ParallelGroup<T>;
+export declare function executeStepWithTracing<TState extends Record<string, any>>(otel: OTelAPI, tracer: OTelTracer, parentContext: OTelContext, sdk: QodoSDK, step: PipelineStep<TState>, state: TState): Promise<{
+    newState: Record<string, any>;
+    log: StepLog;
+}>;
+export declare function executeParallelGroupWithTracing<TState extends Record<string, any>>(otel: OTelAPI, tracer: OTelTracer, parentContext: OTelContext, sdk: QodoSDK, group: ParallelGroup<TState>, state: TState): Promise<{
+    newState: Record<string, any>;
+    logs: StepLog[];
+}>;
+//# sourceMappingURL=pipelineHelpers.d.ts.map

package/dist/tracing/pipelineHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineHelpers.d.ts","sourceRoot":"","sources":["../../src/tracing/pipelineHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAuC,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAe,MAAM,0BAA0B,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAY,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7E,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,CAErF;AAED,wBAAsB,sBAAsB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7E,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,WAAW,EAC1B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAC1B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC,CAsG1D;AAED,wBAAsB,+BAA+B,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtF,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,WAAW,EAC1B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,EAC5B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAiD7D"}

package/dist/tracing/pipelineHelpers.js

@@ -0,0 +1,140 @@
+/**
+ * Internal helpers for pipeline tracing.
+ *
+ * Separated from PipelineTracer to keep the main file focused on the
+ * public API and to allow independent testing.
+ */
+export function isParallelGroup(entry) {
+    return entry.kind === 'parallel';
+}
+export async function executeStepWithTracing(otel, tracer, parentContext, sdk, step, state) {
+    const stepSpan = tracer.startSpan(`qodo.pipeline.step ${step.name}`, {
+        attributes: {
+            'qodo.pipeline.step.name': step.name,
+            'qodo.pipeline.step.has_gate': !!step.gate,
+        },
+    }, parentContext);
+    const start = Date.now();
+    // Evaluate gate
+    if (step.gate) {
+        let pass;
+        try {
+            pass = await step.gate(state);
+        }
+        catch {
+            pass = false;
+        }
+        if (!pass) {
+            stepSpan.setAttribute('qodo.pipeline.step.status', 'skipped');
+            stepSpan.setAttribute('qodo.pipeline.step.skip_reason', 'gate');
+            stepSpan.setStatus({ code: otel.SpanStatusCode.OK, message: 'skipped by gate' });
+            stepSpan.end();
+            return {
+                newState: {},
+                log: { name: step.name, status: 'skipped', durationMs: Date.now() - start },
+            };
+        }
+    }
+    const ctx = {
+        state,
+        run: (commandOrPrompt, options) => {
+            return sdk.run(commandOrPrompt, options);
+        },
+        stepName: step.name,
+    };
+    try {
+        const output = await step.fn(ctx);
+        const durationMs = Date.now() - start;
+        stepSpan.setAttribute('qodo.pipeline.step.status', 'completed');
+        stepSpan.setAttribute('qodo.pipeline.step.duration_ms', durationMs);
+        stepSpan.setStatus({ code: otel.SpanStatusCode.OK });
+        stepSpan.end();
+        return {
+            newState: output ?? {},
+            log: { name: step.name, status: 'completed', durationMs },
+        };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        const durationMs = Date.now() - start;
+        if (step.onError === 'skip') {
+            stepSpan.setAttribute('qodo.pipeline.step.status', 'skipped');
+            stepSpan.setAttribute('qodo.pipeline.step.skip_reason', 'error');
+            stepSpan.addEvent('step.error.skipped', { 'error.message': error.message });
+            stepSpan.setStatus({ code: otel.SpanStatusCode.OK, message: 'error skipped' });
+            stepSpan.end();
+            return {
+                newState: {},
+                log: { name: step.name, status: 'skipped', durationMs, error: error.message },
+            };
+        }
+        if (typeof step.onError === 'function') {
+            try {
+                const recovered = await step.onError(error, state);
+                stepSpan.setAttribute('qodo.pipeline.step.status', 'recovered');
+                stepSpan.addEvent('step.error.recovered', { 'error.message': error.message });
+                stepSpan.setStatus({ code: otel.SpanStatusCode.OK });
+                stepSpan.end();
+                return {
+                    newState: recovered ?? {},
+                    log: { name: step.name, status: 'completed', durationMs: Date.now() - start },
+                };
+            }
+            catch (recoveryErr) {
+                stepSpan.setAttribute('qodo.pipeline.step.status', 'error');
+                stepSpan.recordException(recoveryErr instanceof Error ? recoveryErr : new Error(String(recoveryErr)));
+                stepSpan.setStatus({ code: otel.SpanStatusCode.ERROR, message: 'recovery failed' });
+                stepSpan.end();
+                const { PipelineExecutionError } = await import('../sdk/pipeline/PipelineRunner.js');
+                throw new PipelineExecutionError(`Step "${step.name}" recovery failed: ${recoveryErr?.message || recoveryErr}`, step.name, recoveryErr instanceof Error ? recoveryErr : undefined);
+            }
+        }
+        // 'throw' (default)
+        stepSpan.setAttribute('qodo.pipeline.step.status', 'error');
+        stepSpan.recordException(error);
+        stepSpan.setStatus({ code: otel.SpanStatusCode.ERROR, message: error.message });
+        stepSpan.end();
+        const { PipelineExecutionError } = await import('../sdk/pipeline/PipelineRunner.js');
+        throw new PipelineExecutionError(`Step "${step.name}" failed: ${error.message}`, step.name, error);
+    }
+}
+export async function executeParallelGroupWithTracing(otel, tracer, parentContext, sdk, group, state) {
+    const groupSpan = tracer.startSpan('qodo.pipeline.parallel', {
+        attributes: {
+            'qodo.pipeline.parallel.step_count': group.steps.length,
+            'qodo.pipeline.parallel.step_names': group.steps.map((s) => s.name).join(','),
+        },
+    }, parentContext);
+    const groupContext = otel.trace.setSpan(parentContext, groupSpan);
+    try {
+        const results = await Promise.allSettled(group.steps.map((step) => executeStepWithTracing(otel, tracer, groupContext, sdk, step, state)));
+        let merged = {};
+        const logs = [];
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            if (result.status === 'fulfilled') {
+                merged = { ...merged, ...result.value.newState };
+                logs.push(result.value.log);
+            }
+            else {
+                const stepName = group.steps[i].name;
+                groupSpan.setAttribute('qodo.pipeline.parallel.status', 'error');
+                groupSpan.recordException(result.reason instanceof Error ? result.reason : new Error(String(result.reason)));
+                groupSpan.setStatus({ code: otel.SpanStatusCode.ERROR, message: `step "${stepName}" failed` });
+                groupSpan.end();
+                const { PipelineExecutionError } = await import('../sdk/pipeline/PipelineRunner.js');
+                throw new PipelineExecutionError(`Parallel step "${stepName}" failed: ${result.reason?.message || result.reason}`, stepName, result.reason instanceof Error ? result.reason : undefined);
+            }
+        }
+        groupSpan.setAttribute('qodo.pipeline.parallel.status', 'completed');
+        groupSpan.setStatus({ code: otel.SpanStatusCode.OK });
+        groupSpan.end();
+        return { newState: merged, logs };
+    }
+    catch (err) {
+        // If the span is already ended by the loop above, this is a no-op
+        // but we still need to rethrow
+        throw err;
+    }
+}
+//# sourceMappingURL=pipelineHelpers.js.map

package/dist/tracing/pipelineHelpers.js.map

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