@grimoirelabs/core 0.1.0

package/dist/builders/step-builder.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Step builders - fluent API for creating execution steps
+ */
+import type { Action, ActionConstraints, ActionStep, AdvisoryStep, ComputeStep, ConditionalStep, EmitStep, ErrorType, Expression, HaltStep, LoopStep, ParallelStep, PipelineStep, Step, TryStep, WaitStep } from "../types/index.js";
+/** Base step builder */
+export declare abstract class StepBuilder<T extends Step> {
+    protected _id: string;
+    protected _dependsOn: string[];
+    constructor(id: string);
+    /** Set dependencies on other steps */
+    dependsOn(...stepIds: string[]): this;
+    /** Build the step */
+    abstract build(): T;
+}
+export declare class ComputeBuilder extends StepBuilder<ComputeStep> {
+    private _assignments;
+    /** Add an assignment */
+    assign(variable: string, expression: Expression): this;
+    /** Build the compute step */
+    build(): ComputeStep;
+}
+/** Create a compute step builder */
+export declare function compute(id: string): ComputeBuilder;
+export declare class ActionBuilder extends StepBuilder<ActionStep> {
+    private _skill?;
+    private _action;
+    private _constraints;
+    private _outputBinding?;
+    constructor(act: Action);
+    /** Set the skill name */
+    skill(name: string): this;
+    /** Set action constraints */
+    constraints(constraints: ActionConstraints): this;
+    /** Set output binding */
+    outputBinding(name: string): this;
+    /** Build the action step */
+    build(): ActionStep;
+}
+/** Create an action step builder */
+export declare function action(act: Action): ActionBuilder;
+export declare class ConditionalBuilder extends StepBuilder<ConditionalStep> {
+    private _condition;
+    private _thenSteps;
+    private _elseSteps;
+    constructor(condition: Expression);
+    /** Add a then step */
+    then(stepId: string): this;
+    /** Add an else step */
+    else(stepId: string): this;
+    /** Build the conditional step */
+    build(): ConditionalStep;
+}
+/** Create a conditional step builder */
+export declare function conditional(condition: Expression): ConditionalBuilder;
+export declare class LoopBuilder extends StepBuilder<LoopStep> {
+    private _loopType;
+    private _bodySteps;
+    private _maxIterations;
+    private _parallel?;
+    private _outputBinding?;
+    constructor(loopType: LoopStep["loopType"], maxIterations: number);
+    /** Add a body step */
+    body(stepId: string): this;
+    /** Set parallel execution */
+    parallel(): this;
+    /** Set output binding */
+    outputBinding(name: string): this;
+    /** Build the loop step */
+    build(): LoopStep;
+}
+/** Create a repeat loop builder */
+export declare function repeat(count: number, maxIterations: number): LoopBuilder;
+/** Create a for loop builder */
+export declare function forLoop(variable: string, source: Expression, maxIterations: number): LoopBuilder;
+/** Create an until loop builder */
+export declare function until(condition: Expression, maxIterations: number): LoopBuilder;
+export declare class ParallelBuilder extends StepBuilder<ParallelStep> {
+    private _branches;
+    private _join;
+    private _onFail;
+    private _timeout?;
+    private _outputBinding?;
+    /** Add a branch */
+    branch(name: string, steps: string[]): this;
+    /** Set join strategy */
+    join(strategy: ParallelStep["join"]): this;
+    /** Set on fail behavior */
+    onFail(behavior: "abort" | "continue"): this;
+    /** Set timeout */
+    timeout(seconds: number): this;
+    /** Set output binding */
+    outputBinding(name: string): this;
+    /** Build the parallel step */
+    build(): ParallelStep;
+}
+/** Create a parallel step builder */
+export declare function parallel(id: string): ParallelBuilder;
+export declare class PipelineBuilder extends StepBuilder<PipelineStep> {
+    private _source;
+    private _stages;
+    private _parallel?;
+    private _parallelConfig?;
+    private _outputBinding?;
+    constructor(source: Expression);
+    /** Add a where stage */
+    where(predicate: Expression): this;
+    /** Add a map stage */
+    map(stepId: string): this;
+    /** Add a filter stage */
+    filter(stepId: string): this;
+    /** Add a reduce stage */
+    reduce(stepId: string, initial: Expression): this;
+    /** Add a take stage */
+    take(count: number): this;
+    /** Add a skip stage */
+    skip(count: number): this;
+    /** Add a sort stage */
+    sort(by: Expression, order: "asc" | "desc"): this;
+    /** Set parallel execution */
+    parallel(maxConcurrency?: number, onFail?: "abort" | "continue"): this;
+    /** Set output binding */
+    outputBinding(name: string): this;
+    /** Build the pipeline step */
+    build(): PipelineStep;
+}
+/** Create a pipeline step builder */
+export declare function pipeline(source: Expression): PipelineBuilder;
+export declare class TryBuilder extends StepBuilder<TryStep> {
+    private _trySteps;
+    private _catchBlocks;
+    private _finallySteps?;
+    /** Add a try step */
+    tryStep(stepId: string): this;
+    /** Add a catch block */
+    catchBlock(config: {
+        errorType: ErrorType | "*";
+        steps?: string[];
+        retry?: {
+            maxAttempts: number;
+            backoff: "none" | "linear" | "exponential";
+            backoffBase?: number;
+            maxBackoff?: number;
+            modifyOnRetry?: {
+                slippage?: {
+                    increase: number;
+                };
+                venue?: string;
+            };
+        };
+        action?: "skip" | "rollback" | "halt";
+        alert?: {
+            channels: string[];
+            severity: "info" | "warn" | "critical";
+        };
+    }): this;
+    /** Add a finally step */
+    finallyStep(stepId: string): this;
+    /** Build the try step */
+    build(): TryStep;
+}
+/** Create a try block builder */
+export declare function tryBlock(id: string): TryBuilder;
+export declare class AdvisoryBuilder extends StepBuilder<AdvisoryStep> {
+    private _advisor;
+    private _prompt;
+    private _context?;
+    private _outputSchema;
+    private _outputBinding;
+    private _timeout;
+    private _fallback;
+    constructor(advisor: string, prompt: string, outputBinding: string);
+    /** Set context variables */
+    context(key: string, value: Expression): this;
+    /** Set output schema */
+    outputSchema(schema: AdvisoryStep["outputSchema"]): this;
+    /** Set timeout */
+    timeout(seconds: number): this;
+    /** Set fallback value */
+    fallback(value: Expression): this;
+    /** Build the advisory step */
+    build(): AdvisoryStep;
+}
+/** Create an advisory step builder */
+export declare function advisory(advisor: string, prompt: string, outputBinding: string): AdvisoryBuilder;
+export declare class WaitBuilder extends StepBuilder<WaitStep> {
+    private _duration;
+    constructor(duration: number);
+    /** Build the wait step */
+    build(): WaitStep;
+}
+/** Create a wait step builder */
+export declare function wait(seconds: number): WaitBuilder;
+export declare class EmitBuilder extends StepBuilder<EmitStep> {
+    private _event;
+    private _data;
+    constructor(event: string);
+    /** Add an event data field */
+    data(key: string, value: Expression): this;
+    /** Build the emit step */
+    build(): EmitStep;
+}
+/** Create an emit step builder */
+export declare function emit(event: string): EmitBuilder;
+export declare class HaltBuilder extends StepBuilder<HaltStep> {
+    private _reason;
+    constructor(reason: string);
+    /** Build the halt step */
+    build(): HaltStep;
+}
+/** Create a halt step builder */
+export declare function halt(reason: string): HaltBuilder;
+//# sourceMappingURL=step-builder.d.ts.map

package/dist/builders/step-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-builder.d.ts","sourceRoot":"","sources":["../../src/builders/step-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,QAAQ,EACR,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAG3B,wBAAwB;AACxB,8BAAsB,WAAW,CAAC,CAAC,SAAS,IAAI;IAC9C,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,CAAM;gBAExB,EAAE,EAAE,MAAM;IAItB,sCAAsC;IACtC,SAAS,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAKrC,qBAAqB;IACrB,QAAQ,CAAC,KAAK,IAAI,CAAC;CACpB;AAMD,qBAAa,cAAe,SAAQ,WAAW,CAAC,WAAW,CAAC;IAC1D,OAAO,CAAC,YAAY,CAGZ;IAER,wBAAwB;IACxB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAKtD,6BAA6B;IAC7B,KAAK,IAAI,WAAW;CAQrB;AAED,oCAAoC;AACpC,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAElD;AAMD,qBAAa,aAAc,SAAQ,WAAW,CAAC,UAAU,CAAC;IACxD,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,cAAc,CAAC,CAAS;gBAEpB,GAAG,EAAE,MAAM;IAKvB,yBAAyB;IACzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKzB,6BAA6B;IAC7B,WAAW,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI;IAKjD,yBAAyB;IACzB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,4BAA4B;IAC5B,KAAK,IAAI,UAAU;CAYpB;AAED,oCAAoC;AACpC,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAEjD;AAMD,qBAAa,kBAAmB,SAAQ,WAAW,CAAC,eAAe,CAAC;IAClE,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAgB;gBAEtB,SAAS,EAAE,UAAU;IAKjC,sBAAsB;IACtB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK1B,uBAAuB;IACvB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK1B,iCAAiC;IACjC,KAAK,IAAI,eAAe;CAUzB;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,SAAS,EAAE,UAAU,GAAG,kBAAkB,CAErE;AAMD,qBAAa,WAAY,SAAQ,WAAW,CAAC,QAAQ,CAAC;IACpD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAU;IAC5B,OAAO,CAAC,cAAc,CAAC,CAAS;gBAEpB,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,MAAM;IAMjE,sBAAsB;IACtB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK1B,6BAA6B;IAC7B,QAAQ,IAAI,IAAI;IAKhB,yBAAyB;IACzB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,0BAA0B;IAC1B,KAAK,IAAI,QAAQ;CAYlB;AAED,mCAAmC;AACnC,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,WAAW,CAExE;AAED,gCAAgC;AAChC,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,WAAW,CAEhG;AAED,mCAAmC;AACnC,wBAAgB,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,WAAW,CAE/E;AAMD,qBAAa,eAAgB,SAAQ,WAAW,CAAC,YAAY,CAAC;IAC5D,OAAO,CAAC,SAAS,CAA4D;IAC7E,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAC,CAAS;IAEhC,mBAAmB;IACnB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAS3C,wBAAwB;IACxB,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI;IAK1C,2BAA2B;IAC3B,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI;IAK5C,kBAAkB;IAClB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,yBAAyB;IACzB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,8BAA8B;IAC9B,KAAK,IAAI,YAAY;CAYtB;AAED,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,CAEpD;AAMD,qBAAa,eAAgB,SAAQ,WAAW,CAAC,YAAY,CAAC;IAC5D,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAU;IAC5B,OAAO,CAAC,eAAe,CAAC,CAAiC;IACzD,OAAO,CAAC,cAAc,CAAC,CAAS;gBAEpB,MAAM,EAAE,UAAU;IAK9B,wBAAwB;IACxB,KAAK,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAKlC,sBAAsB;IACtB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKzB,yBAAyB;IACzB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,yBAAyB;IACzB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAKjD,uBAAuB;IACvB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzB,uBAAuB;IACvB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzB,uBAAuB;IACvB,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI;IAKjD,6BAA6B;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,GAAG,UAAoB,GAAG,IAAI;IAS/E,yBAAyB;IACzB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC,8BAA8B;IAC9B,KAAK,IAAI,YAAY;CAYtB;AAED,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAE5D;AAMD,qBAAa,UAAW,SAAQ,WAAW,CAAC,OAAO,CAAC;IAClD,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,aAAa,CAAC,CAAW;IAEjC,qBAAqB;IACrB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK7B,wBAAwB;IACxB,UAAU,CAAC,MAAM,EAAE;QACjB,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,EAAE;YACN,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;YAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,aAAa,CAAC,EAAE;gBACd,QAAQ,CAAC,EAAE;oBAAE,QAAQ,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAChC,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC;SACH,CAAC;QACF,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;QACtC,KAAK,CAAC,EAAE;YACN,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;SACxC,CAAC;KACH,GAAG,IAAI;IAWR,yBAAyB;IACzB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMjC,yBAAyB;IACzB,KAAK,IAAI,OAAO;CAUjB;AAED,iCAAiC;AACjC,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAE/C;AAMD,qBAAa,eAAgB,SAAQ,WAAW,CAAC,YAAY,CAAC;IAC5D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,CAA6B;IAC9C,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAa;gBAElB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;IAYlE,4BAA4B;IAC5B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAM7C,wBAAwB;IACxB,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,cAAc,CAAC,GAAG,IAAI;IAKxD,kBAAkB;IAClB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKjC,8BAA8B;IAC9B,KAAK,IAAI,YAAY;CActB;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,eAAe,CAEhG;AAMD,qBAAa,WAAY,SAAQ,WAAW,CAAC,QAAQ,CAAC;IACpD,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,EAAE,MAAM;IAK5B,0BAA0B;IAC1B,KAAK,IAAI,QAAQ;CAQlB;AAED,iCAAiC;AACjC,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAEjD;AAMD,qBAAa,WAAY,SAAQ,WAAW,CAAC,QAAQ,CAAC;IACpD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAkC;gBAEnC,KAAK,EAAE,MAAM;IAKzB,8BAA8B;IAC9B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAK1C,0BAA0B;IAC1B,KAAK,IAAI,QAAQ;CASlB;AAED,kCAAkC;AAClC,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAE/C;AAMD,qBAAa,WAAY,SAAQ,WAAW,CAAC,QAAQ,CAAC;IACpD,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM;IAK1B,0BAA0B;IAC1B,KAAK,IAAI,QAAQ;CAQlB;AAED,iCAAiC;AACjC,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAEhD"}