@qodo/sdk 0.7.0 → 0.8.0

package/dist/sdk/pipeline/PipelineBuilder.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Fluent builder for constructing typed pipelines.
+ *
+ * Usage:
+ *   const pipeline = sdkPipeline<{ repo: string }>()
+ *     .step('lint', async ({ state, run }) => {
+ *       const result = await run('lint', { args: { path: state.repo } });
+ *       return { lintOutput: result.result.final_output };
+ *     })
+ *     .step('review', async ({ state, run }) => {
+ *       const result = await run('review', { extraInstructions: state.lintOutput });
+ *       return { reviewOutput: result.result.final_output };
+ *     })
+ *     .build();
+ */
+import type { PipelineEntry, StepFn, GateFn, ErrorStrategy } from './types.js';
+export interface StepOptions<TState, TOut> {
+    /** Skip this step when the gate returns false. */
+    gate?: GateFn<TState>;
+    /** Error recovery strategy (default: 'throw'). */
+    onError?: ErrorStrategy<TState, TOut>;
+}
+/**
+ * Immutable pipeline builder that tracks accumulated state type TState.
+ *
+ * Each .step() call produces a new builder whose TState is the intersection
+ * of the previous state and the step's output type. This gives full type
+ * inference through the chain without explicit generics at each step.
+ */
+export declare class PipelineBuilder<TState extends Record<string, any>, TInit extends Record<string, any> = TState> {
+    constructor(entries?: PipelineEntry<TState>[]);
+    /**
+     * Add a sequential step to the pipeline.
+     *
+     * The step function receives the accumulated state and must return an
+     * object whose keys are merged into the state for subsequent steps.
+     */
+    step<TOut extends Record<string, any>>(name: string, fn: StepFn<TState, TOut>, options?: StepOptions<TState, TOut>): PipelineBuilder<TState & TOut, TInit>;
+    /**
+     * Add a group of steps that execute in parallel.
+     *
+     * All steps in the group receive the same snapshot of state. Their
+     * outputs are merged (Object.assign order matches declaration order).
+     */
+    parallel<TOut extends Record<string, any>>(steps: Array<{
+        name: string;
+        fn: StepFn<TState, TOut>;
+        gate?: GateFn<TState>;
+        onError?: ErrorStrategy<TState, TOut>;
+    }>): PipelineBuilder<TState & TOut, TInit>;
+    /**
+     * Finalize the pipeline definition.
+     *
+     * Returns the frozen list of entries for the runner to execute.
+     */
+    build(): Pipeline<TState, TInit>;
+}
+export declare class Pipeline<TState extends Record<string, any>, TInit extends Record<string, any> = TState> {
+    constructor(entries: readonly PipelineEntry<TState>[]);
+}
+//# sourceMappingURL=PipelineBuilder.d.ts.map

package/dist/sdk/pipeline/PipelineBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineBuilder.d.ts","sourceRoot":"","sources":["../../../src/sdk/pipeline/PipelineBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAGV,aAAa,EACb,MAAM,EACN,MAAM,EACN,aAAa,EACd,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,WAAW,CAAC,MAAM,EAAE,IAAI;IACvC,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAEtB,kDAAkD;IAClD,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACvC;AAMD;;;;;;GAMG;AACH,qBAAa,eAAe,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;gBAI7F,OAAO,GAAE,aAAa,CAAC,MAAM,CAAC,EAAO;IAIjD;;;;;OAKG;IACH,IAAI,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EACxB,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAClC,eAAe,CAAC,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC;IAcxC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACvC,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;KACvC,CAAC,GACD,eAAe,CAAC,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC;IAgBxC;;;;OAIG;IACH,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;CAGjC;AAMD,qBAAa,QAAQ,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;gBAItF,OAAO,EAAE,SAAS,aAAa,CAAC,MAAM,CAAC,EAAE;CAGtD"}

package/dist/sdk/pipeline/PipelineBuilder.js

@@ -0,0 +1,91 @@
+/**
+ * Fluent builder for constructing typed pipelines.
+ *
+ * Usage:
+ *   const pipeline = sdkPipeline<{ repo: string }>()
+ *     .step('lint', async ({ state, run }) => {
+ *       const result = await run('lint', { args: { path: state.repo } });
+ *       return { lintOutput: result.result.final_output };
+ *     })
+ *     .step('review', async ({ state, run }) => {
+ *       const result = await run('review', { extraInstructions: state.lintOutput });
+ *       return { reviewOutput: result.result.final_output };
+ *     })
+ *     .build();
+ */
+// ---------------------------------------------------------------------------
+// Builder
+// ---------------------------------------------------------------------------
+/**
+ * Immutable pipeline builder that tracks accumulated state type TState.
+ *
+ * Each .step() call produces a new builder whose TState is the intersection
+ * of the previous state and the step's output type. This gives full type
+ * inference through the chain without explicit generics at each step.
+ */
+export class PipelineBuilder {
+    /** @internal */
+    _entries;
+    constructor(entries = []) {
+        this._entries = entries;
+    }
+    /**
+     * Add a sequential step to the pipeline.
+     *
+     * The step function receives the accumulated state and must return an
+     * object whose keys are merged into the state for subsequent steps.
+     */
+    step(name, fn, options) {
+        const entry = {
+            name,
+            fn,
+            gate: options?.gate,
+            onError: options?.onError ?? 'throw',
+        };
+        // Cast is safe: we widen TState to TState & TOut going forward
+        return new PipelineBuilder([
+            ...this._entries,
+            entry,
+        ]);
+    }
+    /**
+     * Add a group of steps that execute in parallel.
+     *
+     * All steps in the group receive the same snapshot of state. Their
+     * outputs are merged (Object.assign order matches declaration order).
+     */
+    parallel(steps) {
+        const group = {
+            kind: 'parallel',
+            steps: steps.map((s) => ({
+                name: s.name,
+                fn: s.fn,
+                gate: s.gate,
+                onError: s.onError ?? 'throw',
+            })),
+        };
+        return new PipelineBuilder([
+            ...this._entries,
+            group,
+        ]);
+    }
+    /**
+     * Finalize the pipeline definition.
+     *
+     * Returns the frozen list of entries for the runner to execute.
+     */
+    build() {
+        return new Pipeline(Object.freeze([...this._entries]));
+    }
+}
+// ---------------------------------------------------------------------------
+// Pipeline (frozen, executable definition)
+// ---------------------------------------------------------------------------
+export class Pipeline {
+    /** @internal */
+    entries;
+    constructor(entries) {
+        this.entries = entries;
+    }
+}
+//# sourceMappingURL=PipelineBuilder.js.map

package/dist/sdk/pipeline/PipelineBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineBuilder.js","sourceRoot":"","sources":["../../../src/sdk/pipeline/PipelineBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAuBH,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAC1B,gBAAgB;IACP,QAAQ,CAA0B;IAE3C,YAAY,UAAmC,EAAE;QAC/C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,IAAY,EACZ,EAAwB,EACxB,OAAmC;QAEnC,MAAM,KAAK,GAA+B;YACxC,IAAI;YACJ,EAAE;YACF,IAAI,EAAE,OAAO,EAAE,IAAI;YACnB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO;SACrC,CAAC;QACF,+DAA+D;QAC/D,OAAO,IAAI,eAAe,CAAuB;YAC/C,GAAG,IAAI,CAAC,QAAiB;YACzB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CACN,KAKE;QAEF,MAAM,KAAK,GAA0B;YACnC,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,EAAE,EAAE,CAAC,CAAC,EAAyB;gBAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,OAAO;aAC9B,CAAC,CAAC;SACJ,CAAC;QACF,OAAO,IAAI,eAAe,CAAuB;YAC/C,GAAG,IAAI,CAAC,QAAiB;YACzB,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,OAAO,IAAI,QAAQ,CAAgB,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAA4B,CAAC,CAAC;IACnG,CAAC;CACF;AAED,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAE9E,MAAM,OAAO,QAAQ;IACnB,gBAAgB;IACP,OAAO,CAAmC;IAEnD,YAAY,OAAyC;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/sdk/pipeline/PipelineRunner.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Executes a Pipeline definition against a QodoSDK instance.
+ *
+ * The runner is intentionally decoupled from the builder so that a single
+ * pipeline definition can be executed multiple times with different SDK
+ * instances and initial states.
+ */
+import type { QodoSDK } from '../QodoSDK.js';
+import type { Pipeline } from './PipelineBuilder.js';
+import type { PipelineResult } from './types.js';
+import type { QodoSdkEvent } from '../events.js';
+export declare class PipelineExecutionError extends Error {
+    readonly stepName: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, stepName: string, cause?: Error | undefined);
+}
+/**
+ * Callback type for pipeline event notifications.
+ */
+export interface PipelineEventCallback {
+    (event: QodoSdkEvent): void;
+}
+/**
+ * Execute a pipeline with the given SDK instance and initial state.
+ * Optionally accepts an event callback to receive pipeline execution events.
+ */
+export declare function runPipeline<TState extends Record<string, any>, TInit extends Record<string, any> = TState>(sdk: QodoSDK, pipeline: Pipeline<TState, TInit>, initialState: TInit, onEvent?: PipelineEventCallback): Promise<PipelineResult<TState>>;
+//# sourceMappingURL=PipelineRunner.d.ts.map

package/dist/sdk/pipeline/PipelineRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineRunner.d.ts","sourceRoot":"","sources":["../../../src/sdk/pipeline/PipelineRunner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAuC,MAAM,eAAe,CAAC;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAIV,cAAc,EAGf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,qBAAa,sBAAuB,SAAQ,KAAK;aAG7B,QAAQ,EAAE,MAAM;aAChB,KAAK,CAAC,EAAE,KAAK;gBAF7B,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAC9G,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,EACjC,YAAY,EAAE,KAAK,EACnB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAyDjC"}

package/dist/sdk/pipeline/PipelineRunner.js

@@ -0,0 +1,210 @@
+/**
+ * Executes a Pipeline definition against a QodoSDK instance.
+ *
+ * The runner is intentionally decoupled from the builder so that a single
+ * pipeline definition can be executed multiple times with different SDK
+ * instances and initial states.
+ */
+import { SdkEventType, SDK_PROTOCOL_V2 } from '../events.js';
+export class PipelineExecutionError extends Error {
+    stepName;
+    cause;
+    constructor(message, stepName, cause) {
+        super(message);
+        this.stepName = stepName;
+        this.cause = cause;
+        this.name = 'PipelineExecutionError';
+    }
+}
+/**
+ * Execute a pipeline with the given SDK instance and initial state.
+ * Optionally accepts an event callback to receive pipeline execution events.
+ */
+export async function runPipeline(sdk, pipeline, initialState, onEvent) {
+    const pipelineStart = Date.now();
+    // State starts as TInit and accumulates step outputs to become TState at runtime
+    let state = { ...initialState };
+    const stepLogs = [];
+    let seq = 0;
+    const runId = `pipeline-${Date.now()}`;
+    // Collect all step names for the started event.
+    const allStepNames = collectStepNames(pipeline);
+    emitEvent(onEvent, runId, seq++, SdkEventType.PipelineStarted, {
+        entry_count: pipeline.entries.length,
+        step_names: allStepNames,
+    });
+    try {
+        for (const entry of pipeline.entries) {
+            if (isParallelGroup(entry)) {
+                const { newState, logs, nextSeq } = await executeParallelGroup(sdk, entry, state, onEvent, runId, seq);
+                seq = nextSeq;
+                state = { ...state, ...newState };
+                stepLogs.push(...logs);
+            }
+            else {
+                const { newState, log, nextSeq } = await executeStep(sdk, entry, state, false, onEvent, runId, seq);
+                seq = nextSeq;
+                state = { ...state, ...newState };
+                stepLogs.push(log);
+            }
+        }
+        const completed = stepLogs.filter((s) => s.status === 'completed').length;
+        const skipped = stepLogs.filter((s) => s.status === 'skipped').length;
+        emitEvent(onEvent, runId, seq++, SdkEventType.PipelineCompleted, {
+            duration_ms: Date.now() - pipelineStart,
+            steps_completed: completed,
+            steps_skipped: skipped,
+        });
+        return { state, steps: stepLogs };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        const stepName = err instanceof PipelineExecutionError ? err.stepName : 'unknown';
+        emitEvent(onEvent, runId, seq++, SdkEventType.PipelineError, {
+            step_name: stepName,
+            message: error.message,
+            cause: err instanceof PipelineExecutionError ? err.cause : undefined,
+        });
+        throw err;
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function isParallelGroup(entry) {
+    return entry.kind === 'parallel';
+}
+function collectStepNames(pipeline) {
+    const names = [];
+    for (const entry of pipeline.entries) {
+        if (isParallelGroup(entry)) {
+            for (const step of entry.steps) {
+                names.push(step.name);
+            }
+        }
+        else {
+            names.push(entry.name);
+        }
+    }
+    return names;
+}
+function emitEvent(onEvent, runId, seq, type, data) {
+    if (!onEvent)
+        return;
+    onEvent({
+        protocol: SDK_PROTOCOL_V2,
+        type,
+        timestamp: Date.now(),
+        seq,
+        run_id: runId,
+        session_id: '',
+        data,
+    });
+}
+async function executeStep(sdk, step, state, parallel, onEvent, runId, seq) {
+    const start = Date.now();
+    // Evaluate gate
+    if (step.gate) {
+        let pass;
+        try {
+            pass = await step.gate(state);
+        }
+        catch {
+            pass = false;
+        }
+        emitEvent(onEvent, runId, seq++, SdkEventType.PipelineGateEvaluated, {
+            step_name: step.name,
+            passed: pass,
+        });
+        if (!pass) {
+            const log = { name: step.name, status: 'skipped', durationMs: Date.now() - start };
+            emitEvent(onEvent, runId, seq++, SdkEventType.PipelineStepCompleted, {
+                step_name: step.name,
+                status: 'skipped',
+                duration_ms: log.durationMs,
+            });
+            return { newState: {}, log, nextSeq: seq };
+        }
+    }
+    emitEvent(onEvent, runId, seq++, SdkEventType.PipelineStepStarted, {
+        step_name: step.name,
+        parallel,
+    });
+    // Build step context
+    const ctx = {
+        state,
+        run: (commandOrPrompt, options) => {
+            return sdk.run(commandOrPrompt, options);
+        },
+        stepName: step.name,
+    };
+    try {
+        const output = await step.fn(ctx);
+        const log = { name: step.name, status: 'completed', durationMs: Date.now() - start };
+        emitEvent(onEvent, runId, seq++, SdkEventType.PipelineStepCompleted, {
+            step_name: step.name,
+            status: 'completed',
+            duration_ms: log.durationMs,
+        });
+        return { newState: output ?? {}, log, nextSeq: seq };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        if (step.onError === 'skip') {
+            const log = {
+                name: step.name,
+                status: 'skipped',
+                durationMs: Date.now() - start,
+                error: error.message,
+            };
+            emitEvent(onEvent, runId, seq++, SdkEventType.PipelineStepCompleted, {
+                step_name: step.name,
+                status: 'skipped',
+                duration_ms: log.durationMs,
+                error: error.message,
+            });
+            return { newState: {}, log, nextSeq: seq };
+        }
+        if (typeof step.onError === 'function') {
+            try {
+                const recovered = await step.onError(error, state);
+                const log = { name: step.name, status: 'completed', durationMs: Date.now() - start };
+                emitEvent(onEvent, runId, seq++, SdkEventType.PipelineStepCompleted, {
+                    step_name: step.name,
+                    status: 'completed',
+                    duration_ms: log.durationMs,
+                });
+                return { newState: recovered ?? {}, log, nextSeq: seq };
+            }
+            catch (recoveryErr) {
+                throw new PipelineExecutionError(`Step "${step.name}" recovery failed: ${recoveryErr?.message || recoveryErr}`, step.name, recoveryErr instanceof Error ? recoveryErr : undefined);
+            }
+        }
+        // 'throw' (default)
+        throw new PipelineExecutionError(`Step "${step.name}" failed: ${error.message}`, step.name, error);
+    }
+}
+async function executeParallelGroup(sdk, group, state, onEvent, runId, seq) {
+    // Each parallel step gets its own starting seq to avoid conflicts.
+    // We'll collect events and replay them after all settle.
+    const results = await Promise.allSettled(group.steps.map((step, i) => executeStep(sdk, step, state, true, onEvent, runId, seq + (i * 10))));
+    // Advance seq past all parallel steps.
+    seq += group.steps.length * 10;
+    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 {
+            // If any parallel step throws (after its own onError handling),
+            // the entire parallel group fails.
+            const stepName = group.steps[i].name;
+            throw new PipelineExecutionError(`Parallel step "${stepName}" failed: ${result.reason?.message || result.reason}`, stepName, result.reason instanceof Error ? result.reason : undefined);
+        }
+    }
+    return { newState: merged, logs, nextSeq: seq };
+}
+//# sourceMappingURL=PipelineRunner.js.map

package/dist/sdk/pipeline/PipelineRunner.js.map

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

package/dist/sdk/pipeline/compiler.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Compiles a DeclarativePipeline definition into an executable Pipeline.
+ *
+ * This bridges the JSON-serializable visual builder format and the typed
+ * Pipeline runtime.
+ */
+import { Pipeline } from './PipelineBuilder.js';
+import type { DeclarativePipeline } from './declarative.js';
+export declare class DeclarativePipelineValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Compile a DeclarativePipeline into a Pipeline<TState>.
+ *
+ * Validates the definition for:
+ * - No duplicate step names
+ * - Parallel group step names must exist in the steps array
+ * - No step appearing in multiple parallel groups
+ *
+ * Sequential steps not in any parallel group are added via builder.step().
+ * Steps referenced in parallelGroups are collected and added via builder.parallel().
+ */
+export declare function compileDeclarativePipeline<TState extends Record<string, any>>(definition: DeclarativePipeline): Pipeline<TState>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/sdk/pipeline/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/sdk/pipeline/compiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAA2B,MAAM,kBAAkB,CAAC;AAMrF,qBAAa,kCAAmC,SAAQ,KAAK;gBAC/C,OAAO,EAAE,MAAM;CAI5B;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3E,UAAU,EAAE,mBAAmB,GAC9B,QAAQ,CAAC,MAAM,CAAC,CAuElB"}

package/dist/sdk/pipeline/compiler.js

@@ -0,0 +1,197 @@
+/**
+ * Compiles a DeclarativePipeline definition into an executable Pipeline.
+ *
+ * This bridges the JSON-serializable visual builder format and the typed
+ * Pipeline runtime.
+ */
+import { PipelineBuilder } from './PipelineBuilder.js';
+// ---------------------------------------------------------------------------
+// Validation error
+// ---------------------------------------------------------------------------
+export class DeclarativePipelineValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DeclarativePipelineValidationError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Compiler
+// ---------------------------------------------------------------------------
+/**
+ * Compile a DeclarativePipeline into a Pipeline<TState>.
+ *
+ * Validates the definition for:
+ * - No duplicate step names
+ * - Parallel group step names must exist in the steps array
+ * - No step appearing in multiple parallel groups
+ *
+ * Sequential steps not in any parallel group are added via builder.step().
+ * Steps referenced in parallelGroups are collected and added via builder.parallel().
+ */
+export function compileDeclarativePipeline(definition) {
+    validate(definition);
+    // Build a set of step names that belong to parallel groups so we know
+    // which steps to skip when iterating sequentially.
+    const parallelStepNames = new Set();
+    const parallelGroupsByFirstStep = new Map();
+    if (definition.parallelGroups) {
+        for (const group of definition.parallelGroups) {
+            for (const name of group) {
+                parallelStepNames.add(name);
+            }
+            // Index by the first step name in the group so we can emit the
+            // parallel() call when we encounter the first step of the group
+            // during the sequential walk.
+            parallelGroupsByFirstStep.set(group[0], group);
+        }
+    }
+    // Index steps by name for fast lookup.
+    const stepsByName = new Map();
+    for (const step of definition.steps) {
+        stepsByName.set(step.name, step);
+    }
+    let builder = new PipelineBuilder();
+    // Walk the steps array in order. When we encounter the first step of a
+    // parallel group, emit a builder.parallel() call. Otherwise emit a
+    // sequential builder.step() call.
+    const emittedParallelGroups = new Set();
+    for (const step of definition.steps) {
+        if (parallelStepNames.has(step.name)) {
+            // Find the parallel group this step belongs to.
+            const group = findGroupForStep(step.name, definition.parallelGroups);
+            const groupKey = group.join(',');
+            if (emittedParallelGroups.has(groupKey)) {
+                // Already emitted this group when we encountered its first step.
+                continue;
+            }
+            emittedParallelGroups.add(groupKey);
+            // Emit parallel group.
+            const parallelSteps = group.map((name) => {
+                const s = stepsByName.get(name);
+                return {
+                    name: s.name,
+                    fn: buildStepFn(s),
+                    gate: s.gate ? buildGateFn(s.gate) : undefined,
+                    onError: (s.errorStrategy ?? 'throw'),
+                };
+            });
+            builder = builder.parallel(parallelSteps);
+        }
+        else {
+            // Sequential step.
+            builder = builder.step(step.name, buildStepFn(step), {
+                gate: step.gate ? buildGateFn(step.gate) : undefined,
+                onError: step.errorStrategy ?? 'throw',
+            });
+        }
+    }
+    return builder.build();
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function buildStepFn(step) {
+    return async (ctx) => {
+        // Build extraInstructions from inputMapping if present.
+        let extraInstructions;
+        if (step.inputMapping && Object.keys(step.inputMapping).length > 0) {
+            const mappedParts = [];
+            for (const [key, expression] of Object.entries(step.inputMapping)) {
+                // Resolve the expression against pipeline state.
+                const value = resolveExpression(ctx.state, expression);
+                mappedParts.push(`${key}: ${typeof value === 'string' ? value : JSON.stringify(value)}`);
+            }
+            extraInstructions = mappedParts.join('\n');
+        }
+        const result = await ctx.run(step.commandKey, {
+            ...(extraInstructions ? { extraInstructions } : {}),
+        });
+        return { [`${step.name}_result`]: result.result.final_output };
+    };
+}
+/**
+ * Resolve a simple expression against pipeline state.
+ *
+ * Supports dot-notation paths like "state.foo.bar" or just "foo.bar".
+ * The leading "state." prefix is optional.
+ */
+function resolveExpression(state, expression) {
+    let path = expression;
+    // Strip optional "state." prefix.
+    if (path.startsWith('state.')) {
+        path = path.slice(6);
+    }
+    const parts = path.split('.');
+    let current = state;
+    for (const part of parts) {
+        if (current == null || typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * @security Gate expressions are compiled via `new Function()` which executes
+ * arbitrary JavaScript. Only use declarative pipelines with trusted
+ * configuration sources. **Never** pass user-provided strings as gate
+ * expressions.
+ */
+function buildGateFn(expression) {
+    // Use Function constructor for simple expression evaluation.
+    // The expression has access to the state object.
+    const fn = new Function('state', 'return ' + expression);
+    return (state) => fn(state);
+}
+function findGroupForStep(stepName, groups) {
+    for (const group of groups) {
+        if (group.includes(stepName))
+            return group;
+    }
+    // Should not happen after validation, but defensive.
+    return [stepName];
+}
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+function validate(definition) {
+    if (!definition.name || typeof definition.name !== 'string') {
+        throw new DeclarativePipelineValidationError('Pipeline must have a non-empty name.');
+    }
+    if (!Array.isArray(definition.steps) || definition.steps.length === 0) {
+        throw new DeclarativePipelineValidationError('Pipeline must have at least one step.');
+    }
+    // Check for duplicate step names.
+    const names = new Set();
+    for (const step of definition.steps) {
+        if (!step.name || typeof step.name !== 'string') {
+            throw new DeclarativePipelineValidationError('Every step must have a non-empty name.');
+        }
+        if (!step.commandKey || typeof step.commandKey !== 'string') {
+            throw new DeclarativePipelineValidationError(`Step "${step.name}" must have a non-empty commandKey.`);
+        }
+        if (names.has(step.name)) {
+            throw new DeclarativePipelineValidationError(`Duplicate step name: "${step.name}".`);
+        }
+        names.add(step.name);
+    }
+    // Validate parallel groups.
+    if (definition.parallelGroups) {
+        const assignedToGroup = new Set();
+        for (let i = 0; i < definition.parallelGroups.length; i++) {
+            const group = definition.parallelGroups[i];
+            if (!Array.isArray(group) || group.length < 2) {
+                throw new DeclarativePipelineValidationError(`Parallel group at index ${i} must have at least 2 step names.`);
+            }
+            for (const stepName of group) {
+                if (!names.has(stepName)) {
+                    throw new DeclarativePipelineValidationError(`Parallel group references unknown step: "${stepName}".`);
+                }
+                if (assignedToGroup.has(stepName)) {
+                    throw new DeclarativePipelineValidationError(`Step "${stepName}" appears in multiple parallel groups.`);
+                }
+                assignedToGroup.add(stepName);
+            }
+        }
+    }
+}
+//# sourceMappingURL=compiler.js.map

package/dist/sdk/pipeline/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../../../src/sdk/pipeline/compiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAY,MAAM,sBAAsB,CAAC;AAIjE,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,OAAO,kCAAmC,SAAQ,KAAK;IAC3D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oCAAoC,CAAC;IACnD,CAAC;CACF;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAA+B;IAE/B,QAAQ,CAAC,UAAU,CAAC,CAAC;IAErB,sEAAsE;IACtE,mDAAmD;IACnD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,MAAM,yBAAyB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE9D,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;YACD,+DAA+D;YAC/D,gEAAgE;YAChE,8BAA8B;YAC9B,yBAAyB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmC,CAAC;IAC/D,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,OAAO,GAAG,IAAI,eAAe,EAAU,CAAC;IAE5C,uEAAuE;IACvE,mEAAmE;IACnE,kCAAkC;IAClC,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhD,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,gDAAgD;YAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,cAAe,CAAC,CAAC;YACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEjC,IAAI,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxC,iEAAiE;gBACjE,SAAS;YACX,CAAC;YACD,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAEpC,uBAAuB;YACvB,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACvC,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;gBACjC,OAAO;oBACL,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,EAAE,EAAE,WAAW,CAAS,CAAC,CAAC;oBAC1B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;oBACtD,OAAO,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,OAAO,CAA+B;iBACpE,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,mBAAmB;YACnB,OAAO,GAAG,OAAO,CAAC,IAAI,CACpB,IAAI,CAAC,IAAI,EACT,WAAW,CAAS,IAAI,CAAC,EACzB;gBACE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAS,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC5D,OAAO,EAAE,IAAI,CAAC,aAAa,IAAI,OAAO;aACvC,CACK,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,EAAsB,CAAC;AAC7C,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,WAAW,CAAS,IAA6B;IACxD,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,wDAAwD;QACxD,IAAI,iBAAqC,CAAC;QAC1C,IAAI,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnE,MAAM,WAAW,GAAa,EAAE,CAAC;YACjC,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClE,iDAAiD;gBACjD,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;gBACvD,WAAW,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC3F,CAAC;YACD,iBAAiB,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE;YAC5C,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC,CAAC;QAEH,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IACjE,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,KAA0B,EAAE,UAAkB;IACvE,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,kCAAkC;IAClC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAQ,KAAK,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACrE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAS,UAAkB;IAC7C,6DAA6D;IAC7D,iDAAiD;IACjD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,UAAU,CAAyC,CAAC;IACjG,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB,EAAE,MAAkB;IAC5D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;IAC7C,CAAC;IACD,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAC;AACpB,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,SAAS,QAAQ,CAAC,UAA+B;IAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,kCAAkC,CAAC,sCAAsC,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,kCAAkC,CAAC,uCAAuC,CAAC,CAAC;IACxF,CAAC;IAED,kCAAkC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChD,MAAM,IAAI,kCAAkC,CAAC,wCAAwC,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC5D,MAAM,IAAI,kCAAkC,CAC1C,SAAS,IAAI,CAAC,IAAI,qCAAqC,CACxD,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,kCAAkC,CAC1C,yBAAyB,IAAI,CAAC,IAAI,IAAI,CACvC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,4BAA4B;IAC5B,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;QAC9B,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;QAE1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAE3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAI,kCAAkC,CAC1C,2BAA2B,CAAC,mCAAmC,CAChE,CAAC;YACJ,CAAC;YAED,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;gBAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACzB,MAAM,IAAI,kCAAkC,CAC1C,4CAA4C,QAAQ,IAAI,CACzD,CAAC;gBACJ,CAAC;gBACD,IAAI,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAClC,MAAM,IAAI,kCAAkC,CAC1C,SAAS,QAAQ,wCAAwC,CAC1D,CAAC;gBACJ,CAAC;gBACD,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}