@gravito/flux 1.0.0-beta.4 → 1.0.0-beta.6

package/dist/{chunk-J37UUMLM.js → chunk-CICUXW2L.js}

@@ -43,6 +43,7 @@ var WorkflowBuilder = class {
       retries: options?.retries,
       timeout: options?.timeout,
       when: options?.when,
+      compensate: options?.compensate,
       commit: false
     });
     return this;
@@ -195,8 +196,12 @@ var ContextManager = class {
 // src/core/StateMachine.ts
 var TRANSITIONS = {
   pending: ["running", "failed"],
-  running: ["paused", "completed", "failed"],
+  running: ["paused", "completed", "failed", "suspended", "rolling_back"],
   paused: ["running", "failed"],
+  suspended: ["running", "failed"],
+  rolling_back: ["rolled_back", "failed"],
+  rolled_back: ["pending"],
+  // allow retry from scratch
   completed: [],
   // terminal state
   failed: ["pending"]
@@ -243,7 +248,7 @@ var StateMachine = class extends EventTarget {
    * Check if workflow is in terminal state
    */
   isTerminal() {
-    return this._status === "completed" || this._status === "failed";
+    return this._status === "completed" || this._status === "failed" || this._status === "rolled_back";
   }
   /**
    * Check if workflow can be executed
@@ -283,7 +288,19 @@ var StepExecutor = class {
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
       execution.retries = attempt;
       try {
-        await this.executeWithTimeout(step.handler, ctx, timeout);
+        const result = await this.executeWithTimeout(step.handler, ctx, timeout);
+        if (result && typeof result === "object" && "__kind" in result && result.__kind === "flux_wait") {
+          execution.status = "suspended";
+          execution.waitingFor = result.signal;
+          execution.suspendedAt = /* @__PURE__ */ new Date();
+          execution.duration = Date.now() - startTime;
+          return {
+            success: true,
+            suspended: true,
+            waitingFor: result.signal,
+            duration: execution.duration
+          };
+        }
         execution.status = "completed";
         execution.completedAt = /* @__PURE__ */ new Date();
         execution.duration = Date.now() - startTime;
@@ -318,7 +335,7 @@ var StepExecutor = class {
       const timeoutPromise = new Promise((_, reject) => {
         timer = setTimeout(() => reject(new Error("Step timeout")), timeout);
       });
-      await Promise.race([Promise.resolve(handler(ctx)), timeoutPromise]);
+      return await Promise.race([Promise.resolve(handler(ctx)), timeoutPromise]);
     } finally {
       if (timer) {
         clearTimeout(timer);
@@ -461,6 +478,47 @@ var FluxEngine = class {
       fromStep: startIndex
     });
   }
+  /**
+   * Send a signal to a suspended workflow
+   */
+  async signal(workflow, workflowId, signalName, payload) {
+    const definition = this.resolveDefinition(workflow);
+    const state = await this.storage.load(workflowId);
+    if (!state) {
+      throw new Error("Workflow not found");
+    }
+    if (state.status !== "suspended") {
+      throw new Error(`Workflow is not suspended (status: ${state.status})`);
+    }
+    const ctx = this.contextManager.restore(state);
+    const currentStep = ctx.history[ctx.currentStep];
+    if (!currentStep || currentStep.status !== "suspended") {
+      throw new Error("Workflow state invalid: no suspended step found");
+    }
+    if (currentStep.waitingFor !== signalName) {
+      throw new Error(
+        `Workflow waiting for signal "${currentStep.waitingFor}", received "${signalName}"`
+      );
+    }
+    currentStep.status = "completed";
+    currentStep.completedAt = /* @__PURE__ */ new Date();
+    currentStep.output = payload;
+    const stateMachine = new StateMachine();
+    stateMachine.forceStatus("suspended");
+    await this.emitTrace({
+      type: "signal:received",
+      timestamp: Date.now(),
+      workflowId: ctx.id,
+      workflowName: ctx.name,
+      status: "suspended",
+      input: payload
+    });
+    const nextStepIndex = ctx.currentStep + 1;
+    return this.runFrom(definition, ctx, stateMachine, Date.now(), nextStepIndex, {
+      resume: true,
+      fromStep: nextStepIndex
+    });
+  }
   /**
    * Retry a specific step (replays from that step onward)
    */
@@ -551,19 +609,79 @@ var FluxEngine = class {
       entry.retries = 0;
     }
   }
+  /**
+   * Rollback workflow by executing compensation handlers in reverse order
+   */
+  async rollback(definition, ctx, failedAtIndex, originalError) {
+    Object.assign(ctx, { status: "rolling_back" });
+    await this.emitTrace({
+      type: "workflow:rollback_start",
+      timestamp: Date.now(),
+      workflowId: ctx.id,
+      workflowName: ctx.name,
+      status: "rolling_back",
+      error: originalError.message
+    });
+    for (let i = failedAtIndex - 1; i >= 0; i--) {
+      const step = definition.steps[i];
+      const execution = ctx.history[i];
+      if (!step || !step.compensate || !execution || execution.status !== "completed") {
+        continue;
+      }
+      try {
+        execution.status = "compensating";
+        await this.storage.save(this.contextManager.toState(ctx));
+        await step.compensate(ctx);
+        execution.status = "compensated";
+        execution.compensatedAt = /* @__PURE__ */ new Date();
+        await this.emitTrace({
+          type: "step:compensate",
+          timestamp: Date.now(),
+          workflowId: ctx.id,
+          workflowName: ctx.name,
+          stepName: step.name,
+          stepIndex: i,
+          status: "compensated"
+        });
+      } catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        Object.assign(ctx, { status: "failed" });
+        await this.emitTrace({
+          type: "workflow:error",
+          timestamp: Date.now(),
+          workflowId: ctx.id,
+          workflowName: ctx.name,
+          status: "failed",
+          error: `Compensation failed at step "${step.name}": ${error.message}`
+        });
+        return;
+      }
+      await this.storage.save(this.contextManager.toState(ctx));
+    }
+    Object.assign(ctx, { status: "rolled_back" });
+    await this.emitTrace({
+      type: "workflow:rollback_complete",
+      timestamp: Date.now(),
+      workflowId: ctx.id,
+      workflowName: ctx.name,
+      status: "rolled_back"
+    });
+  }
   async runFrom(definition, ctx, stateMachine, startTime, startIndex, meta) {
     try {
       stateMachine.transition("running");
       Object.assign(ctx, { status: "running" });
-      await this.emitTrace({
-        type: "workflow:start",
-        timestamp: Date.now(),
-        workflowId: ctx.id,
-        workflowName: ctx.name,
-        status: ctx.status,
-        input: ctx.input,
-        meta
-      });
+      if (!meta?.resume) {
+        await this.emitTrace({
+          type: "workflow:start",
+          timestamp: Date.now(),
+          workflowId: ctx.id,
+          workflowName: ctx.name,
+          status: ctx.status,
+          input: ctx.input,
+          meta
+        });
+      }
       for (let i = startIndex; i < definition.steps.length; i++) {
         const step = definition.steps[i];
         const execution = ctx.history[i];
@@ -584,6 +702,27 @@ var FluxEngine = class {
         });
         const result = await this.executor.execute(step, ctx, execution);
         if (result.success) {
+          if (result.suspended) {
+            stateMachine.transition("suspended");
+            Object.assign(ctx, { status: "suspended" });
+            await this.emitTrace({
+              type: "step:suspend",
+              timestamp: Date.now(),
+              workflowId: ctx.id,
+              workflowName: ctx.name,
+              stepName: step.name,
+              stepIndex: i,
+              meta: { signal: result.waitingFor }
+            });
+            await this.storage.save(this.contextManager.toState(ctx));
+            return {
+              id: ctx.id,
+              status: "suspended",
+              data: ctx.data,
+              history: ctx.history,
+              duration: Date.now() - startTime
+            };
+          }
           this.config.on?.stepComplete?.(step.name, ctx, result);
           if (execution.status === "skipped") {
             await this.emitTrace({
@@ -630,15 +769,16 @@ var FluxEngine = class {
             status: execution.status,
             meta
           });
-          stateMachine.transition("failed");
-          Object.assign(ctx, { status: "failed" });
+          await this.rollback(definition, ctx, i, result.error);
+          const finalStatus = ctx.status;
+          stateMachine.forceStatus(finalStatus);
           await this.storage.save({
             ...this.contextManager.toState(ctx),
             error: result.error?.message
           });
           return {
             id: ctx.id,
-            status: "failed",
+            status: finalStatus,
             data: ctx.data,
             history: ctx.history,
             duration: Date.now() - startTime,
@@ -855,4 +995,4 @@ export {
   FluxSilentLogger,
   OrbitFlux
 };
-//# sourceMappingURL=chunk-J37UUMLM.js.map
+//# sourceMappingURL=chunk-CICUXW2L.js.map

package/dist/chunk-CICUXW2L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/builder/WorkflowBuilder.ts","../src/core/ContextManager.ts","../src/core/StateMachine.ts","../src/core/StepExecutor.ts","../src/storage/MemoryStorage.ts","../src/engine/FluxEngine.ts","../src/trace/JsonFileTraceSink.ts","../src/logger/FluxLogger.ts","../src/orbit/OrbitFlux.ts"],"sourcesContent":["/**\n * @fileoverview Workflow Builder - Fluent API for defining workflows\n *\n * Type-safe, chainable workflow definition.\n *\n * @module @gravito/flux/builder\n */\n\nimport type {\n  FluxWaitResult,\n  StepDefinition,\n  StepDescriptor,\n  WorkflowContext,\n  WorkflowDefinition,\n  WorkflowDescriptor,\n} from '../types'\n\n/**\n * Step options\n */\ninterface StepOptions<TInput = any, TData = any> {\n  retries?: number\n  timeout?: number\n  when?: (ctx: WorkflowContext<TInput, TData>) => boolean\n  compensate?: (ctx: WorkflowContext<TInput, TData>) => Promise<void> | void\n}\n\n/**\n * Workflow Builder\n *\n * Provides fluent API for defining workflows with type inference.\n *\n * @example\n * ```typescript\n * const workflow = createWorkflow('order-process')\n *   .input<{ orderId: string }>()\n *   .step('validate', async (ctx) => {\n *     ctx.data.order = await fetchOrder(ctx.input.orderId)\n *   })\n *   .step('process', async (ctx) => {\n *     await processOrder(ctx.data.order)\n *   }, {\n *     compensate: async (ctx) => {\n *       await cancelOrder(ctx.data.order.id)\n *     }\n *   })\n *   .commit('notify', async (ctx) => {\n *     await sendEmail(ctx.data.order.email)\n *   })\n * ```\n */\nexport class WorkflowBuilder<TInput = unknown, TData = Record<string, unknown>> {\n  private _name: string\n  private _steps: StepDefinition[] = []\n  private _validateInput?: (input: unknown) => input is TInput\n\n  constructor(name: string) {\n    this._name = name\n  }\n\n  /**\n   * Define input type\n   *\n   * This method is used for TypeScript type inference.\n   */\n  input<T>(): WorkflowBuilder<T, TData> {\n    return this as unknown as WorkflowBuilder<T, TData>\n  }\n\n  /**\n   * Define workflow data (state) type\n   *\n   * This method is used for TypeScript type inference.\n   */\n  data<T>(): WorkflowBuilder<TInput, T> {\n    return this as unknown as WorkflowBuilder<TInput, T>\n  }\n\n  /**\n   * Add input validator\n   */\n  validate(validator: (input: unknown) => input is TInput): this {\n    this._validateInput = validator\n    return this\n  }\n\n  /**\n   * Add a step to the workflow\n   */\n  step(\n    name: string,\n    handler: (\n      ctx: WorkflowContext<TInput, TData>\n    ) => Promise<void | FluxWaitResult> | void | FluxWaitResult,\n    options?: StepOptions<TInput, TData>\n  ): this {\n    this._steps.push({\n      name,\n      handler: handler as (\n        ctx: WorkflowContext\n      ) => Promise<void | FluxWaitResult> | void | FluxWaitResult,\n      retries: options?.retries,\n      timeout: options?.timeout,\n      when: options?.when as ((ctx: WorkflowContext) => boolean) | undefined,\n      compensate: options?.compensate as\n        | ((ctx: WorkflowContext) => Promise<void> | void)\n        | undefined,\n      commit: false,\n    })\n    return this\n  }\n\n  /**\n   * Add a commit step (always executes, even on replay)\n   *\n   * Commit steps are for side effects that should not be skipped,\n   * such as database writes or external API calls.\n   */\n  commit(\n    name: string,\n    handler: (ctx: WorkflowContext<TInput, TData>) => Promise<void> | void,\n    options?: Omit<StepOptions<TInput, TData>, 'compensate'>\n  ): this {\n    this._steps.push({\n      name,\n      handler: handler as (ctx: WorkflowContext) => Promise<void> | void,\n      retries: options?.retries,\n      timeout: options?.timeout,\n      when: options?.when as ((ctx: WorkflowContext) => boolean) | undefined,\n      commit: true,\n    })\n    return this\n  }\n\n  /**\n   * Build the workflow definition\n   */\n  build(): WorkflowDefinition<TInput, TData> {\n    if (this._steps.length === 0) {\n      throw new Error(`Workflow \"${this._name}\" has no steps`)\n    }\n\n    return {\n      name: this._name,\n      steps: [...this._steps],\n      validateInput: this._validateInput,\n    }\n  }\n\n  /**\n   * Describe workflow (serializable metadata)\n   */\n  describe(): WorkflowDescriptor {\n    const steps: StepDescriptor[] = this._steps.map((step) => ({\n      name: step.name,\n      commit: Boolean(step.commit),\n      retries: step.retries,\n      timeout: step.timeout,\n      hasCondition: Boolean(step.when),\n    }))\n\n    return {\n      name: this._name,\n      steps,\n    }\n  }\n\n  /**\n   * Get workflow name\n   */\n  get name(): string {\n    return this._name\n  }\n\n  /**\n   * Get step count\n   */\n  get stepCount(): number {\n    return this._steps.length\n  }\n}\n\n/**\n * Create a new workflow builder\n *\n * @param name - Unique workflow name\n * @returns WorkflowBuilder instance\n *\n * @example\n * ```typescript\n * const uploadFlow = createWorkflow('image-upload')\n *   .input<{ file: Buffer }>()\n *   .step('resize', async (ctx) => {\n *     ctx.data.resized = await sharp(ctx.input.file).resize(200).toBuffer()\n *   })\n *   .commit('save', async (ctx) => {\n *     await storage.put(ctx.data.resized)\n *   })\n * ```\n */\nexport function createWorkflow(name: string): WorkflowBuilder {\n  return new WorkflowBuilder(name)\n}\n","/**\n * @fileoverview Context Manager for workflow execution\n *\n * Manages workflow context lifecycle and state snapshots.\n *\n * @module @gravito/flux/core\n */\n\nimport type { StepExecution, WorkflowContext, WorkflowState, WorkflowStatus } from '../types'\n\n/**\n * Generate unique ID using crypto.randomUUID (Web Standard)\n */\nfunction generateId(): string {\n  return crypto.randomUUID()\n}\n\n/**\n * Context Manager\n *\n * Creates and manages workflow execution contexts.\n */\nexport class ContextManager {\n  /**\n   * Create a new workflow context\n   */\n  create<TInput, TData = any>(\n    name: string,\n    input: TInput,\n    stepCount: number\n  ): WorkflowContext<TInput, TData> {\n    const history: StepExecution[] = Array.from({ length: stepCount }, (_, _i) => ({\n      name: '',\n      status: 'pending',\n      retries: 0,\n    }))\n\n    return {\n      id: generateId(),\n      name,\n      input,\n      data: {} as TData,\n      status: 'pending',\n      currentStep: 0,\n      history,\n    }\n  }\n\n  /**\n   * Restore context from saved state\n   */\n  restore<TInput, TData = any>(\n    state: WorkflowState<TInput, TData>\n  ): WorkflowContext<TInput, TData> {\n    return {\n      id: state.id,\n      name: state.name,\n      input: state.input as TInput,\n      data: { ...state.data } as unknown as TData,\n      status: state.status,\n      currentStep: state.currentStep,\n      history: state.history.map((h) => ({ ...h })),\n    }\n  }\n\n  /**\n   * Convert context to serializable state\n   */\n  toState<TInput, TData>(ctx: WorkflowContext<TInput, TData>): WorkflowState<TInput, TData> {\n    return {\n      id: ctx.id,\n      name: ctx.name,\n      status: ctx.status,\n      input: ctx.input,\n      data: { ...(ctx.data as any) },\n      currentStep: ctx.currentStep,\n      history: ctx.history.map((h) => ({ ...h })),\n      createdAt: new Date(),\n      updatedAt: new Date(),\n    }\n  }\n\n  /**\n   * Update context status (returns new context for immutability)\n   */\n  updateStatus<TInput, TData>(\n    ctx: WorkflowContext<TInput, TData>,\n    status: WorkflowStatus\n  ): WorkflowContext<TInput, TData> {\n    return {\n      ...ctx,\n      status,\n    }\n  }\n\n  /**\n   * Advance to next step\n   */\n  advanceStep<TInput, TData>(ctx: WorkflowContext<TInput, TData>): WorkflowContext<TInput, TData> {\n    return {\n      ...ctx,\n      currentStep: ctx.currentStep + 1,\n    }\n  }\n\n  /**\n   * Update step name in history\n   */\n  setStepName<TInput, TData>(\n    ctx: WorkflowContext<TInput, TData>,\n    index: number,\n    name: string\n  ): void {\n    if (ctx.history[index]) {\n      ctx.history[index].name = name\n    }\n  }\n}\n","/**\n * @fileoverview State Machine for workflow status transitions\n *\n * Pure state machine with no runtime dependencies.\n *\n * @module @gravito/flux/core\n */\n\nimport type { WorkflowStatus } from '../types'\n\n/**\n * Valid state transitions\n */\nconst TRANSITIONS: Record<WorkflowStatus, WorkflowStatus[]> = {\n  pending: ['running', 'failed'],\n  running: ['paused', 'completed', 'failed', 'suspended', 'rolling_back'],\n  paused: ['running', 'failed'],\n  suspended: ['running', 'failed'],\n  rolling_back: ['rolled_back', 'failed'],\n  rolled_back: ['pending'], // allow retry from scratch\n  completed: [], // terminal state\n  failed: ['pending'], // allow retry\n}\n\n/**\n * State Machine for workflow status management\n *\n * Provides validated state transitions using EventTarget for events.\n */\nexport class StateMachine extends EventTarget {\n  private _status: WorkflowStatus = 'pending'\n\n  /**\n   * Current status\n   */\n  get status(): WorkflowStatus {\n    return this._status\n  }\n\n  /**\n   * Check if transition to target status is allowed\n   */\n  canTransition(to: WorkflowStatus): boolean {\n    return TRANSITIONS[this._status].includes(to)\n  }\n\n  /**\n   * Transition to a new status\n   *\n   * @throws {Error} If transition is not allowed\n   */\n  transition(to: WorkflowStatus): void {\n    if (!this.canTransition(to)) {\n      throw new Error(`Invalid state transition: ${this._status} → ${to}`)\n    }\n\n    const from = this._status\n    this._status = to\n\n    // Emit transition event\n    this.dispatchEvent(\n      new CustomEvent('transition', {\n        detail: { from, to },\n      })\n    )\n  }\n\n  /**\n   * Force set status (for replay/restore)\n   */\n  forceStatus(status: WorkflowStatus): void {\n    this._status = status\n  }\n\n  /**\n   * Check if workflow is in terminal state\n   */\n  isTerminal(): boolean {\n    return (\n      this._status === 'completed' || this._status === 'failed' || this._status === 'rolled_back'\n    )\n  }\n\n  /**\n   * Check if workflow can be executed\n   */\n  canExecute(): boolean {\n    return this._status === 'pending' || this._status === 'paused'\n  }\n}\n","/**\n * @fileoverview Step Executor for workflow steps\n *\n * Handles step execution with retry and timeout support.\n *\n * @module @gravito/flux/core\n */\n\nimport type {\n  FluxWaitResult,\n  StepDefinition,\n  StepExecution,\n  StepResult,\n  WorkflowContext,\n} from '../types'\n\n/**\n * Step Executor\n *\n * Executes individual workflow steps with retry and timeout support.\n */\nexport class StepExecutor {\n  private defaultRetries: number\n  private defaultTimeout: number\n  private onRetry?: (\n    step: StepDefinition<any, any>,\n    ctx: WorkflowContext<any, any>,\n    error: Error,\n    attempt: number,\n    maxRetries: number\n  ) => void | Promise<void>\n\n  constructor(\n    options: {\n      defaultRetries?: number\n      defaultTimeout?: number\n      onRetry?: (\n        step: StepDefinition<any, any>,\n        ctx: WorkflowContext<any, any>,\n        error: Error,\n        attempt: number,\n        maxRetries: number\n      ) => void | Promise<void>\n    } = {}\n  ) {\n    this.defaultRetries = options.defaultRetries ?? 3\n    this.defaultTimeout = options.defaultTimeout ?? 30000\n    this.onRetry = options.onRetry\n  }\n\n  /**\n   * Execute a step with retry and timeout\n   */\n  async execute<TInput, TData>(\n    step: StepDefinition<TInput, TData>,\n    ctx: WorkflowContext<TInput, TData>,\n    execution: StepExecution\n  ): Promise<StepResult> {\n    const maxRetries = step.retries ?? this.defaultRetries\n    const timeout = step.timeout ?? this.defaultTimeout\n    const startTime = Date.now()\n\n    // Check condition\n    if (step.when && !step.when(ctx)) {\n      execution.status = 'skipped'\n      return {\n        success: true,\n        duration: 0,\n      }\n    }\n\n    execution.status = 'running'\n    execution.startedAt = new Date()\n\n    let lastError: Error | undefined\n\n    for (let attempt = 0; attempt <= maxRetries; attempt++) {\n      execution.retries = attempt\n\n      try {\n        // Execute with timeout\n        const result = await this.executeWithTimeout(step.handler, ctx, timeout)\n\n        if (\n          result &&\n          typeof result === 'object' &&\n          '__kind' in result &&\n          result.__kind === 'flux_wait'\n        ) {\n          execution.status = 'suspended'\n          execution.waitingFor = result.signal\n          execution.suspendedAt = new Date()\n          execution.duration = Date.now() - startTime\n\n          return {\n            success: true,\n            suspended: true,\n            waitingFor: result.signal,\n            duration: execution.duration,\n          }\n        }\n\n        execution.status = 'completed'\n        execution.completedAt = new Date()\n        execution.duration = Date.now() - startTime\n\n        return {\n          success: true,\n          duration: execution.duration,\n        }\n      } catch (error) {\n        lastError = error instanceof Error ? error : new Error(String(error))\n\n        // If not last retry, continue\n        if (attempt < maxRetries) {\n          await this.onRetry?.(step, ctx, lastError, attempt + 1, maxRetries)\n          // Exponential backoff\n          await this.sleep(Math.min(1000 * 2 ** attempt, 10000))\n        }\n      }\n    }\n\n    // All retries failed\n    execution.status = 'failed'\n    execution.completedAt = new Date()\n    execution.duration = Date.now() - startTime\n    execution.error = lastError?.message\n\n    return {\n      success: false,\n      error: lastError,\n      duration: execution.duration,\n    }\n  }\n\n  /**\n   * Execute handler with timeout\n   */\n  private async executeWithTimeout<TInput, TData>(\n    handler: (\n      ctx: WorkflowContext<TInput, TData>\n    ) => Promise<void | FluxWaitResult> | void | FluxWaitResult,\n    ctx: WorkflowContext<TInput, TData>,\n    timeout: number\n  ): Promise<void | FluxWaitResult> {\n    let timer: ReturnType<typeof setTimeout> | null = null\n    try {\n      const timeoutPromise = new Promise<never>((_, reject) => {\n        timer = setTimeout(() => reject(new Error('Step timeout')), timeout)\n      })\n\n      return await Promise.race([Promise.resolve(handler(ctx)), timeoutPromise])\n    } finally {\n      if (timer) {\n        clearTimeout(timer)\n      }\n    }\n  }\n\n  /**\n   * Sleep helper\n   */\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms))\n  }\n}\n","/**\n * @fileoverview In-memory storage adapter\n *\n * Simple storage for development and testing.\n *\n * @module @gravito/flux/storage\n */\n\nimport type { WorkflowFilter, WorkflowState, WorkflowStorage } from '../types'\n\n/**\n * Memory Storage\n *\n * In-memory storage adapter for development and testing.\n * Data is not persisted across restarts.\n */\nexport class MemoryStorage implements WorkflowStorage {\n  private store = new Map<string, WorkflowState>()\n\n  async save(state: WorkflowState): Promise<void> {\n    this.store.set(state.id, {\n      ...state,\n      updatedAt: new Date(),\n    })\n  }\n\n  async load(id: string): Promise<WorkflowState | null> {\n    return this.store.get(id) ?? null\n  }\n\n  async list(filter?: WorkflowFilter): Promise<WorkflowState[]> {\n    let results = Array.from(this.store.values())\n\n    if (filter?.name) {\n      results = results.filter((s) => s.name === filter.name)\n    }\n\n    if (filter?.status) {\n      const statuses = Array.isArray(filter.status) ? filter.status : [filter.status]\n      results = results.filter((s) => statuses.includes(s.status))\n    }\n\n    // Sort by createdAt desc\n    results.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())\n\n    // Apply pagination\n    if (filter?.offset) {\n      results = results.slice(filter.offset)\n    }\n    if (filter?.limit) {\n      results = results.slice(0, filter.limit)\n    }\n\n    return results\n  }\n\n  async delete(id: string): Promise<void> {\n    this.store.delete(id)\n  }\n\n  async init(): Promise<void> {\n    // No-op for memory storage\n  }\n\n  async close(): Promise<void> {\n    this.store.clear()\n  }\n\n  /**\n   * Get store size (for testing)\n   */\n  size(): number {\n    return this.store.size\n  }\n}\n","/**\n * @fileoverview Flux Engine - Main workflow execution engine\n *\n * Orchestrates workflow execution with storage and event handling.\n *\n * @module @gravito/flux\n */\n\nimport { WorkflowBuilder } from '../builder/WorkflowBuilder'\nimport { ContextManager } from '../core/ContextManager'\nimport { StateMachine } from '../core/StateMachine'\nimport { StepExecutor } from '../core/StepExecutor'\nimport { MemoryStorage } from '../storage/MemoryStorage'\nimport type {\n  FluxConfig,\n  FluxResult,\n  FluxTraceEvent,\n  WorkflowContext,\n  WorkflowDefinition,\n  WorkflowState,\n  WorkflowStorage,\n} from '../types'\n\n/**\n * Flux Engine\n *\n * Main workflow execution engine.\n *\n * @example\n * ```typescript\n * const engine = new FluxEngine({ storage: new MemoryStorage() })\n *\n * const workflow = createWorkflow('process-order')\n *   .input<{ orderId: string }>()\n *   .step('fetch', async (ctx) => { ... })\n *   .step('validate', async (ctx) => { ... })\n *   .commit('save', async (ctx) => { ... })\n *\n * const result = await engine.execute(workflow, { orderId: '123' })\n * ```\n */\nexport class FluxEngine {\n  private storage: WorkflowStorage\n  private executor: StepExecutor\n  private contextManager: ContextManager\n  private config: FluxConfig\n\n  constructor(config: FluxConfig = {}) {\n    this.config = config\n    this.storage = config.storage ?? new MemoryStorage()\n    this.executor = new StepExecutor({\n      defaultRetries: config.defaultRetries,\n      defaultTimeout: config.defaultTimeout,\n      onRetry: async (step, ctx, error, attempt, maxRetries) => {\n        await this.emitTrace({\n          type: 'step:retry',\n          timestamp: Date.now(),\n          workflowId: ctx.id,\n          workflowName: ctx.name,\n          stepName: step.name,\n          stepIndex: ctx.currentStep,\n          commit: Boolean(step.commit),\n          retries: attempt,\n          maxRetries,\n          error: error.message,\n          status: 'running',\n        })\n      },\n    })\n    this.contextManager = new ContextManager()\n  }\n\n  /**\n   * Execute a workflow with input data\n   *\n   * @param workflow - Workflow builder or definition\n   * @param input - Input data for the workflow\n   * @returns Execution result\n   */\n  async execute<TInput, TData = any>(\n    workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n    input: TInput\n  ): Promise<FluxResult<TData>> {\n    const startTime = Date.now()\n    const definition = this.resolveDefinition(workflow)\n\n    // Validate input if validator provided\n    if (definition.validateInput && !definition.validateInput(input)) {\n      throw new Error(`Invalid input for workflow \"${definition.name}\"`)\n    }\n\n    // Create context\n    const ctx = this.contextManager.create<TInput, TData>(\n      definition.name,\n      input,\n      definition.steps.length\n    ) as WorkflowContext<TInput, TData>\n\n    // Create state machine\n    const stateMachine = new StateMachine()\n\n    // Save initial state\n    await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n    return this.runFrom(definition, ctx, stateMachine, startTime, 0)\n  }\n\n  /**\n   * Resume a paused or failed workflow\n   *\n   * @param workflowId - Workflow instance ID\n   * @returns Execution result or null if not found\n   */\n  async resume<TInput, TData = any>(\n    workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n    workflowId: string,\n    options?: { fromStep?: number | string }\n  ): Promise<FluxResult<TData> | null> {\n    const definition = this.resolveDefinition(workflow)\n    const state = await this.storage.load(workflowId)\n    if (!state) {\n      return null\n    }\n    if (state.name !== definition.name) {\n      throw new Error(`Workflow name mismatch: ${state.name} !== ${definition.name}`)\n    }\n    if (state.history.length !== definition.steps.length) {\n      throw new Error('Workflow definition changed; resume is not safe')\n    }\n\n    const ctx = this.contextManager.restore<TInput, TData>(state)\n    const stateMachine = new StateMachine()\n    stateMachine.forceStatus('pending')\n\n    const startIndex = this.resolveStartIndex(definition, options?.fromStep, ctx.currentStep)\n    this.resetHistoryFrom(ctx, startIndex)\n    Object.assign(ctx, { status: 'pending', currentStep: startIndex })\n\n    await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n    return this.runFrom(definition, ctx, stateMachine, Date.now(), startIndex, {\n      resume: true,\n      fromStep: startIndex,\n    })\n  }\n\n  /**\n   * Send a signal to a suspended workflow\n   */\n  async signal<TInput, TData = any>(\n    workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n    workflowId: string,\n    signalName: string,\n    payload?: any\n  ): Promise<FluxResult<TData>> {\n    const definition = this.resolveDefinition(workflow)\n    const state = await this.storage.load(workflowId)\n    if (!state) {\n      throw new Error('Workflow not found')\n    }\n    if (state.status !== 'suspended') {\n      throw new Error(`Workflow is not suspended (status: ${state.status})`)\n    }\n\n    const ctx = this.contextManager.restore<TInput, TData>(state)\n    const currentStep = ctx.history[ctx.currentStep]\n\n    if (!currentStep || currentStep.status !== 'suspended') {\n      throw new Error('Workflow state invalid: no suspended step found')\n    }\n    if (currentStep.waitingFor !== signalName) {\n      throw new Error(\n        `Workflow waiting for signal \"${currentStep.waitingFor}\", received \"${signalName}\"`\n      )\n    }\n\n    // Complete the suspended step\n    currentStep.status = 'completed'\n    currentStep.completedAt = new Date()\n    currentStep.output = payload\n    // If payload contains data, we might want to merge it?\n    // For now, allow next step to access it via history or we need a cleaner way.\n    // Let's assume user grabs it from history for now or we build a helper later.\n\n    const stateMachine = new StateMachine()\n    stateMachine.forceStatus('suspended')\n    // ctx status will be updated to 'running' in runFrom\n\n    await this.emitTrace({\n      type: 'signal:received',\n      timestamp: Date.now(),\n      workflowId: ctx.id,\n      workflowName: ctx.name,\n      status: 'suspended',\n      input: payload,\n    })\n\n    // Resume from NEXT step\n    const nextStepIndex = ctx.currentStep + 1\n\n    return this.runFrom(definition, ctx, stateMachine, Date.now(), nextStepIndex, {\n      resume: true,\n      fromStep: nextStepIndex,\n    })\n  }\n\n  /**\n   * Retry a specific step (replays from that step onward)\n   */\n  async retryStep<TInput, TData = any>(\n    workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>,\n    workflowId: string,\n    stepName: string\n  ): Promise<FluxResult<TData> | null> {\n    const definition = this.resolveDefinition(workflow)\n    const state = await this.storage.load(workflowId)\n    if (!state) {\n      return null\n    }\n    if (state.name !== definition.name) {\n      throw new Error(`Workflow name mismatch: ${state.name} !== ${definition.name}`)\n    }\n    if (state.history.length !== definition.steps.length) {\n      throw new Error('Workflow definition changed; retry is not safe')\n    }\n\n    const ctx = this.contextManager.restore<TInput, TData>(state)\n    const stateMachine = new StateMachine()\n    stateMachine.forceStatus('pending')\n\n    const startIndex = this.resolveStartIndex(definition, stepName, ctx.currentStep)\n    this.resetHistoryFrom(ctx, startIndex)\n    Object.assign(ctx, { status: 'pending', currentStep: startIndex })\n\n    await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n    return this.runFrom(definition, ctx, stateMachine, Date.now(), startIndex, {\n      retry: true,\n      fromStep: startIndex,\n    })\n  }\n\n  /**\n   * Get workflow state by ID\n   */\n  async get<TInput = any, TData = any>(\n    workflowId: string\n  ): Promise<WorkflowState<TInput, TData> | null> {\n    return this.storage.load(workflowId) as Promise<WorkflowState<TInput, TData> | null>\n  }\n\n  /**\n   * Save workflow state manually (e.g., for external updates)\n   */\n  async saveState<TInput, TData>(state: WorkflowState<TInput, TData>): Promise<void> {\n    return this.storage.save(state)\n  }\n\n  /**\n   * List workflows\n   */\n  async list(filter?: Parameters<WorkflowStorage['list']>[0]) {\n    return this.storage.list(filter)\n  }\n\n  /**\n   * Initialize engine (init storage)\n   */\n  async init(): Promise<void> {\n    await this.storage.init?.()\n  }\n\n  /**\n   * Shutdown engine (cleanup)\n   */\n  async close(): Promise<void> {\n    await this.storage.close?.()\n  }\n\n  private resolveDefinition<TInput, TData>(\n    workflow: WorkflowBuilder<TInput, TData> | WorkflowDefinition<TInput, TData>\n  ): WorkflowDefinition<TInput, TData> {\n    return workflow instanceof WorkflowBuilder ? workflow.build() : workflow\n  }\n\n  private resolveStartIndex<TInput, TData>(\n    definition: WorkflowDefinition<TInput, TData>,\n    fromStep: number | string | undefined,\n    fallback: number\n  ): number {\n    if (typeof fromStep === 'number') {\n      if (fromStep < 0 || fromStep >= definition.steps.length) {\n        throw new Error(`Invalid step index: ${fromStep}`)\n      }\n      return fromStep\n    }\n    if (typeof fromStep === 'string') {\n      const index = definition.steps.findIndex((step) => step.name === fromStep)\n      if (index === -1) {\n        throw new Error(`Step not found: ${fromStep}`)\n      }\n      return index\n    }\n    return Math.max(0, Math.min(fallback, definition.steps.length - 1))\n  }\n\n  private resetHistoryFrom<TInput, TData>(\n    ctx: WorkflowContext<TInput, TData>,\n    startIndex: number\n  ): void {\n    for (let i = startIndex; i < ctx.history.length; i++) {\n      const entry = ctx.history[i]\n      if (!entry) {\n        continue\n      }\n      entry.status = 'pending'\n      entry.startedAt = undefined\n      entry.completedAt = undefined\n      entry.duration = undefined\n      entry.error = undefined\n      entry.retries = 0\n    }\n  }\n\n  /**\n   * Rollback workflow by executing compensation handlers in reverse order\n   */\n  private async rollback<TInput, TData>(\n    definition: WorkflowDefinition<TInput, TData>,\n    ctx: WorkflowContext<TInput, TData>,\n    failedAtIndex: number,\n    originalError: Error\n  ): Promise<void> {\n    Object.assign(ctx, { status: 'rolling_back' })\n\n    await this.emitTrace({\n      type: 'workflow:rollback_start',\n      timestamp: Date.now(),\n      workflowId: ctx.id,\n      workflowName: ctx.name,\n      status: 'rolling_back',\n      error: originalError.message,\n    })\n\n    // Iterate backwards from the step BEFORE the failed one\n    for (let i = failedAtIndex - 1; i >= 0; i--) {\n      const step = definition.steps[i]\n      const execution = ctx.history[i]\n\n      // Only compensate completed steps\n      if (!step || !step.compensate || !execution || execution.status !== 'completed') {\n        continue\n      }\n\n      try {\n        execution.status = 'compensating'\n        await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n        await step.compensate(ctx)\n\n        execution.status = 'compensated'\n        execution.compensatedAt = new Date()\n\n        await this.emitTrace({\n          type: 'step:compensate',\n          timestamp: Date.now(),\n          workflowId: ctx.id,\n          workflowName: ctx.name,\n          stepName: step.name,\n          stepIndex: i,\n          status: 'compensated',\n        })\n      } catch (err) {\n        const error = err instanceof Error ? err : new Error(String(err))\n        // Compensation failed - this is bad. Mark workflow as failed (not rolled_back)\n        Object.assign(ctx, { status: 'failed' })\n\n        await this.emitTrace({\n          type: 'workflow:error',\n          timestamp: Date.now(),\n          workflowId: ctx.id,\n          workflowName: ctx.name,\n          status: 'failed',\n          error: `Compensation failed at step \"${step.name}\": ${error.message}`,\n        })\n        return // Stop rollback\n      }\n\n      await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n    }\n\n    Object.assign(ctx, { status: 'rolled_back' })\n    await this.emitTrace({\n      type: 'workflow:rollback_complete',\n      timestamp: Date.now(),\n      workflowId: ctx.id,\n      workflowName: ctx.name,\n      status: 'rolled_back',\n    })\n  }\n\n  private async runFrom<TInput, TData = any>(\n    definition: WorkflowDefinition<TInput, TData>,\n    ctx: WorkflowContext<TInput, TData>,\n    stateMachine: StateMachine,\n    startTime: number,\n    startIndex: number,\n    meta?: { resume?: boolean; retry?: boolean; fromStep?: number }\n  ): Promise<FluxResult<TData>> {\n    try {\n      // Transition to running\n      stateMachine.transition('running')\n      Object.assign(ctx, { status: 'running' })\n      if (!meta?.resume) {\n        await this.emitTrace({\n          type: 'workflow:start',\n          timestamp: Date.now(),\n          workflowId: ctx.id,\n          workflowName: ctx.name,\n          status: ctx.status,\n          input: ctx.input,\n          meta,\n        })\n      }\n\n      // Execute steps\n      for (let i = startIndex; i < definition.steps.length; i++) {\n        const step = definition.steps[i]!\n        const execution = ctx.history[i]!\n\n        // Update step name\n        this.contextManager.setStepName(ctx, i, step.name)\n        Object.assign(ctx, { currentStep: i })\n\n        // Emit step start event\n        this.config.on?.stepStart?.(step.name, ctx as any)\n        await this.emitTrace({\n          type: 'step:start',\n          timestamp: Date.now(),\n          workflowId: ctx.id,\n          workflowName: ctx.name,\n          stepName: step.name,\n          stepIndex: i,\n          commit: Boolean(step.commit),\n          retries: execution.retries,\n          status: execution.status,\n          meta,\n        })\n\n        // Execute step\n        const result = await this.executor.execute(step, ctx, execution)\n\n        if (result.success) {\n          if (result.suspended) {\n            // Handle suspension\n            stateMachine.transition('suspended')\n            Object.assign(ctx, { status: 'suspended' })\n\n            await this.emitTrace({\n              type: 'step:suspend',\n              timestamp: Date.now(),\n              workflowId: ctx.id,\n              workflowName: ctx.name,\n              stepName: step.name,\n              stepIndex: i,\n              meta: { signal: result.waitingFor },\n            })\n\n            await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n\n            return {\n              id: ctx.id,\n              status: 'suspended',\n              data: ctx.data as TData,\n              history: ctx.history,\n              duration: Date.now() - startTime,\n            }\n          }\n\n          // Emit step complete event\n          this.config.on?.stepComplete?.(step.name, ctx as any, result)\n          if (execution.status === 'skipped') {\n            await this.emitTrace({\n              type: 'step:skipped',\n              timestamp: Date.now(),\n              workflowId: ctx.id,\n              workflowName: ctx.name,\n              stepName: step.name,\n              stepIndex: i,\n              commit: Boolean(step.commit),\n              retries: execution.retries,\n              duration: result.duration,\n              status: execution.status,\n              meta,\n            })\n          } else {\n            await this.emitTrace({\n              type: 'step:complete',\n              timestamp: Date.now(),\n              workflowId: ctx.id,\n              workflowName: ctx.name,\n              stepName: step.name,\n              stepIndex: i,\n              commit: Boolean(step.commit),\n              retries: execution.retries,\n              duration: result.duration,\n              status: execution.status,\n              meta,\n            })\n          }\n        } else {\n          // Emit step error event\n          this.config.on?.stepError?.(step.name, ctx as any, result.error!)\n          await this.emitTrace({\n            type: 'step:error',\n            timestamp: Date.now(),\n            workflowId: ctx.id,\n            workflowName: ctx.name,\n            stepName: step.name,\n            stepIndex: i,\n            commit: Boolean(step.commit),\n            retries: execution.retries,\n            duration: result.duration,\n            error: result.error?.message,\n            status: execution.status,\n            meta,\n          })\n\n          // Fail workflow with potential rollback\n          await this.rollback<TInput, TData>(definition, ctx, i, result.error!)\n\n          const finalStatus = ctx.status\n          stateMachine.forceStatus(finalStatus)\n\n          await this.storage.save({\n            ...this.contextManager.toState<TInput, TData>(ctx),\n            error: result.error?.message,\n          })\n\n          return {\n            id: ctx.id,\n            status: finalStatus,\n            data: ctx.data as TData,\n            history: ctx.history,\n            duration: Date.now() - startTime,\n            error: result.error,\n          }\n        }\n\n        // Save progress after each step\n        await this.storage.save(this.contextManager.toState<TInput, TData>(ctx))\n      }\n\n      // Complete workflow\n      stateMachine.transition('completed')\n      Object.assign(ctx, { status: 'completed' })\n\n      await this.storage.save({\n        ...this.contextManager.toState<TInput, TData>(ctx),\n        completedAt: new Date(),\n      })\n\n      // Emit workflow complete event\n      this.config.on?.workflowComplete?.(ctx as any)\n      await this.emitTrace({\n        type: 'workflow:complete',\n        timestamp: Date.now(),\n        workflowId: ctx.id,\n        workflowName: ctx.name,\n        status: ctx.status,\n        duration: Date.now() - startTime,\n        data: ctx.data as Record<string, unknown>,\n        meta,\n      })\n\n      return {\n        id: ctx.id,\n        status: 'completed',\n        data: ctx.data as TData,\n        history: ctx.history,\n        duration: Date.now() - startTime,\n      }\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error(String(error))\n\n      // Emit workflow error event\n      this.config.on?.workflowError?.(ctx as any, err)\n      await this.emitTrace({\n        type: 'workflow:error',\n        timestamp: Date.now(),\n        workflowId: ctx.id,\n        workflowName: ctx.name,\n        status: 'failed',\n        duration: Date.now() - startTime,\n        error: err.message,\n        meta,\n      })\n\n      stateMachine.forceStatus('failed')\n      Object.assign(ctx, { status: 'failed' })\n\n      await this.storage.save({\n        ...this.contextManager.toState<TInput, TData>(ctx),\n        error: err.message,\n      })\n\n      return {\n        id: ctx.id,\n        status: 'failed',\n        data: ctx.data as TData,\n        history: ctx.history,\n        duration: Date.now() - startTime,\n        error: err,\n      }\n    }\n  }\n\n  private async emitTrace(event: FluxTraceEvent): Promise<void> {\n    try {\n      await this.config.trace?.emit(event)\n    } catch {\n      // Ignore trace failures to avoid breaking workflow execution\n    }\n  }\n}\n","/**\n * @fileoverview JSON file trace sink (NDJSON)\n *\n * Writes trace events to a newline-delimited JSON file.\n */\n\nimport { appendFile, mkdir, writeFile } from 'node:fs/promises'\nimport { dirname } from 'node:path'\nimport type { FluxTraceEvent, FluxTraceSink } from '../types'\n\nexport interface JsonFileTraceSinkOptions {\n  path: string\n  reset?: boolean\n}\n\nexport class JsonFileTraceSink implements FluxTraceSink {\n  private path: string\n  private ready: Promise<void>\n\n  constructor(options: JsonFileTraceSinkOptions) {\n    this.path = options.path\n    this.ready = this.init(options.reset ?? true)\n  }\n\n  private async init(reset: boolean): Promise<void> {\n    await mkdir(dirname(this.path), { recursive: true })\n    if (reset) {\n      await writeFile(this.path, '', 'utf8')\n    }\n  }\n\n  async emit(event: FluxTraceEvent): Promise<void> {\n    await this.ready\n    await appendFile(this.path, `${JSON.stringify(event)}\\n`, 'utf8')\n  }\n}\n","/**\n * @fileoverview Console Logger for FluxEngine\n *\n * Default logger implementation using console.\n *\n * @module @gravito/flux\n */\n\nimport type { FluxLogger } from '../types'\n\n/**\n * Console Logger\n *\n * Default logger that outputs to console.\n *\n * @example\n * ```typescript\n * const engine = new FluxEngine({\n *   logger: new FluxConsoleLogger()\n * })\n * ```\n */\nexport class FluxConsoleLogger implements FluxLogger {\n  private prefix: string\n\n  constructor(prefix = '[Flux]') {\n    this.prefix = prefix\n  }\n\n  debug(message: string, ...args: unknown[]): void {\n    console.debug(`${this.prefix} ${message}`, ...args)\n  }\n\n  info(message: string, ...args: unknown[]): void {\n    console.info(`${this.prefix} ${message}`, ...args)\n  }\n\n  warn(message: string, ...args: unknown[]): void {\n    console.warn(`${this.prefix} ${message}`, ...args)\n  }\n\n  error(message: string, ...args: unknown[]): void {\n    console.error(`${this.prefix} ${message}`, ...args)\n  }\n}\n\n/**\n * Silent Logger\n *\n * Logger that outputs nothing (for testing or production).\n */\nexport class FluxSilentLogger implements FluxLogger {\n  debug(): void {}\n  info(): void {}\n  warn(): void {}\n  error(): void {}\n}\n","/**\n * @fileoverview OrbitFlux - Gravito PlanetCore Integration\n *\n * Integrates FluxEngine with Gravito's PlanetCore for seamless workflow management.\n *\n * @module @gravito/flux\n */\n\nimport { FluxEngine } from '../engine/FluxEngine'\nimport { BunSQLiteStorage } from '../storage/BunSQLiteStorage'\nimport { MemoryStorage } from '../storage/MemoryStorage'\nimport type { FluxConfig, FluxLogger, WorkflowStorage } from '../types'\n\n/**\n * Minimal PlanetCore interface for type compatibility\n * (Avoids importing @gravito/core sources which causes rootDir issues)\n */\ninterface PlanetCore {\n  logger: {\n    debug(message: string, ...args: unknown[]): void\n    info(message: string, ...args: unknown[]): void\n    warn(message: string, ...args: unknown[]): void\n    error(message: string, ...args: unknown[]): void\n  }\n  services: {\n    set(key: string, value: unknown): void\n    get<T>(key: string): T | undefined\n  }\n  hooks: {\n    doAction(name: string, payload?: unknown): void\n  }\n}\n\n/**\n * GravitoOrbit interface\n */\nexport interface GravitoOrbit {\n  install(core: PlanetCore): void | Promise<void>\n}\n\n/**\n * OrbitFlux configuration options\n */\nexport interface OrbitFluxOptions {\n  /**\n   * Storage driver: 'memory' | 'sqlite' | custom WorkflowStorage\n   * @default 'memory'\n   */\n  storage?: 'memory' | 'sqlite' | WorkflowStorage\n\n  /**\n   * SQLite database path (only used if storage is 'sqlite')\n   * @default ':memory:'\n   */\n  dbPath?: string\n\n  /**\n   * Service name in core.services\n   * @default 'flux'\n   */\n  exposeAs?: string\n\n  /**\n   * Custom logger\n   */\n  logger?: FluxLogger\n\n  /**\n   * Default retry count for steps\n   * @default 3\n   */\n  defaultRetries?: number\n\n  /**\n   * Default timeout for steps (ms)\n   * @default 30000\n   */\n  defaultTimeout?: number\n}\n\n/**\n * OrbitFlux - Gravito Workflow Integration\n *\n * @example\n * ```typescript\n * import { OrbitFlux } from '@gravito/flux'\n *\n * const core = await PlanetCore.boot({\n *   orbits: [\n *     new OrbitFlux({ storage: 'sqlite', dbPath: './data/workflows.db' })\n *   ]\n * })\n *\n * // Access via services\n * const flux = core.services.get<FluxEngine>('flux')\n * await flux.execute(myWorkflow, input)\n * ```\n */\nexport class OrbitFlux implements GravitoOrbit {\n  private options: OrbitFluxOptions\n  private engine?: FluxEngine\n\n  constructor(options: OrbitFluxOptions = {}) {\n    this.options = {\n      storage: 'memory',\n      exposeAs: 'flux',\n      defaultRetries: 3,\n      defaultTimeout: 30000,\n      ...options,\n    }\n  }\n\n  /**\n   * Create OrbitFlux with configuration\n   */\n  static configure(options: OrbitFluxOptions = {}): OrbitFlux {\n    return new OrbitFlux(options)\n  }\n\n  /**\n   * Install into PlanetCore\n   *\n   * @param core - The PlanetCore instance\n   */\n  async install(core: PlanetCore): Promise<void> {\n    const { storage, dbPath, exposeAs, defaultRetries, defaultTimeout, logger } = this.options\n\n    // Resolve storage adapter\n    let storageAdapter: WorkflowStorage\n\n    if (typeof storage === 'string') {\n      switch (storage) {\n        case 'sqlite':\n          storageAdapter = new BunSQLiteStorage({ path: dbPath })\n          break\n        default:\n          storageAdapter = new MemoryStorage()\n      }\n    } else {\n      storageAdapter = storage!\n    }\n\n    // Initialize storage\n    await storageAdapter.init?.()\n\n    // Create engine configuration\n    const engineConfig: FluxConfig = {\n      storage: storageAdapter,\n      defaultRetries,\n      defaultTimeout,\n      logger: logger ?? {\n        debug: (msg) => core.logger.debug(`[Flux] ${msg}`),\n        info: (msg) => core.logger.info(`[Flux] ${msg}`),\n        warn: (msg) => core.logger.warn(`[Flux] ${msg}`),\n        error: (msg) => core.logger.error(`[Flux] ${msg}`),\n      },\n      on: {\n        stepStart: (step) => {\n          core.hooks.doAction('flux:step:start', { step })\n        },\n        stepComplete: (step, ctx, result) => {\n          core.hooks.doAction('flux:step:complete', { step, ctx, result })\n        },\n        stepError: (step, ctx, error) => {\n          core.hooks.doAction('flux:step:error', { step, ctx, error })\n        },\n        workflowComplete: (ctx) => {\n          core.hooks.doAction('flux:workflow:complete', { ctx })\n        },\n        workflowError: (ctx, error) => {\n          core.hooks.doAction('flux:workflow:error', { ctx, error })\n        },\n      },\n    }\n\n    // Create engine\n    this.engine = new FluxEngine(engineConfig)\n\n    // Register in core services\n    core.services.set(exposeAs!, this.engine)\n\n    core.logger.info(\n      `[OrbitFlux] Initialized (Storage: ${typeof storage === 'string' ? storage : 'custom'})`\n    )\n  }\n\n  /**\n   * Get the FluxEngine instance\n   */\n  getEngine(): FluxEngine | undefined {\n    return this.engine\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -10,7 +10,7 @@
 
 
 
-var _chunkRPECIW7Ocjs = require('./chunk-RPECIW7O.cjs');
+var _chunkBGLG7HACcjs = require('./chunk-BGLG7HAC.cjs');
 
 
 var _chunkSJSPR4ZUcjs = require('./chunk-SJSPR4ZU.cjs');
@@ -21,8 +21,8 @@ var WorkflowProfiler = class {
   constructor(engine) {
     this.engine = engine;
     if (!this.engine) {
-      this.engine = new (0, _chunkRPECIW7Ocjs.FluxEngine)({
-        logger: new (0, _chunkRPECIW7Ocjs.FluxSilentLogger)()
+      this.engine = new (0, _chunkBGLG7HACcjs.FluxEngine)({
+        logger: new (0, _chunkBGLG7HACcjs.FluxSilentLogger)()
       });
     }
   }
@@ -104,6 +104,20 @@ var WorkflowProfiler = class {
   }
 };
 
+// src/index.ts
+var Flux = {
+  /**
+   * Suspend workflow execution and wait for a signal
+   *
+   * @param signal - Signal name to wait for
+   */
+  wait: (signal) => ({
+    __kind: "flux_wait",
+    signal
+  })
+};
+
+
 
 
 
@@ -117,5 +131,5 @@ var WorkflowProfiler = class {
 
 
 
-exports.BunSQLiteStorage = _chunkSJSPR4ZUcjs.BunSQLiteStorage; exports.ContextManager = _chunkRPECIW7Ocjs.ContextManager; exports.FluxConsoleLogger = _chunkRPECIW7Ocjs.FluxConsoleLogger; exports.FluxEngine = _chunkRPECIW7Ocjs.FluxEngine; exports.FluxSilentLogger = _chunkRPECIW7Ocjs.FluxSilentLogger; exports.JsonFileTraceSink = _chunkRPECIW7Ocjs.JsonFileTraceSink; exports.MemoryStorage = _chunkRPECIW7Ocjs.MemoryStorage; exports.OrbitFlux = _chunkRPECIW7Ocjs.OrbitFlux; exports.StateMachine = _chunkRPECIW7Ocjs.StateMachine; exports.StepExecutor = _chunkRPECIW7Ocjs.StepExecutor; exports.WorkflowBuilder = _chunkRPECIW7Ocjs.WorkflowBuilder; exports.WorkflowProfiler = WorkflowProfiler; exports.createWorkflow = _chunkRPECIW7Ocjs.createWorkflow;
+exports.BunSQLiteStorage = _chunkSJSPR4ZUcjs.BunSQLiteStorage; exports.ContextManager = _chunkBGLG7HACcjs.ContextManager; exports.Flux = Flux; exports.FluxConsoleLogger = _chunkBGLG7HACcjs.FluxConsoleLogger; exports.FluxEngine = _chunkBGLG7HACcjs.FluxEngine; exports.FluxSilentLogger = _chunkBGLG7HACcjs.FluxSilentLogger; exports.JsonFileTraceSink = _chunkBGLG7HACcjs.JsonFileTraceSink; exports.MemoryStorage = _chunkBGLG7HACcjs.MemoryStorage; exports.OrbitFlux = _chunkBGLG7HACcjs.OrbitFlux; exports.StateMachine = _chunkBGLG7HACcjs.StateMachine; exports.StepExecutor = _chunkBGLG7HACcjs.StepExecutor; exports.WorkflowBuilder = _chunkBGLG7HACcjs.WorkflowBuilder; exports.WorkflowProfiler = WorkflowProfiler; exports.createWorkflow = _chunkBGLG7HACcjs.createWorkflow;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/index.cjs","../src/profiler/WorkflowProfiler.ts"],"names":["cpus"],"mappings":"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","file":"/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/index.cjs","sourcesContent":[null,"import * as os from 'os'\nimport { FluxEngine } from '../engine/FluxEngine'\nimport { FluxSilentLogger } from '../logger/FluxLogger'\nimport type { WorkflowDefinition } from '../types'\n\nexport interface ProfileMetrics {\n  durationMs: number\n  cpuUserMs: number\n  cpuSysMs: number\n  memDeltaBytes: number\n  cpuRatio: number\n}\n\nexport interface ProfileRecommendation {\n  type: 'IO_BOUND' | 'CPU_BOUND' | 'MEMORY_BOUND'\n  safeConcurrency: number\n  efficientConcurrency: number\n  suggestedConcurrency: string\n  reason: string\n}\n\n/**\n * Workflow Profiler\n *\n * Analyzes workflow performance characteristics to recommend\n * optimal concurrency settings for Consumer workers.\n */\nexport class WorkflowProfiler {\n  constructor(private engine?: FluxEngine) {\n    if (!this.engine) {\n      // Default minimal engine for profiling (Silent)\n      this.engine = new FluxEngine({\n        logger: new FluxSilentLogger(),\n      })\n    }\n  }\n\n  /**\n   * Run a profile session for a specific workflow\n   */\n  async profile<TInput>(\n    workflow: WorkflowDefinition<TInput, any>,\n    input: TInput\n  ): Promise<ProfileMetrics> {\n    // 1. Warmup (JIT)\n    try {\n      await this.engine!.execute(workflow, input)\n    } catch {}\n\n    // 2. Measure\n    if (global.gc) {\n      global.gc()\n    }\n\n    const startCpu = process.cpuUsage()\n    const startMem = process.memoryUsage().heapUsed\n    const startTime = process.hrtime.bigint()\n\n    await this.engine!.execute(workflow, input)\n\n    const endTime = process.hrtime.bigint()\n    const endCpu = process.cpuUsage(startCpu)\n    const endMem = process.memoryUsage().heapUsed\n\n    // 3. Calculate\n    const durationNs = Number(endTime - startTime)\n    const durationMs = durationNs / 1_000_000\n    const cpuUserMs = endCpu.user / 1000\n    const cpuSysMs = endCpu.system / 1000\n    const totalCpuMs = cpuUserMs + cpuSysMs\n    const memDeltaBytes = Math.max(0, endMem - startMem) // Clamp to 0\n\n    // CPU Ratio: How much % of the time was spent on CPU vs Waiting\n    const cpuRatio = totalCpuMs / durationMs\n\n    return {\n      durationMs,\n      cpuUserMs,\n      cpuSysMs,\n      memDeltaBytes,\n      cpuRatio,\n    }\n  }\n\n  /**\n   * Generate recommendations based on metrics and current environment\n   */\n  recommend(\n    metrics: ProfileMetrics,\n    config?: { configuredConcurrency?: number }\n  ): ProfileRecommendation {\n    const totalMem = os.totalmem()\n    const cpus = os.cpus().length\n\n    // 1. Analyze Bottleneck Type\n    let type: ProfileRecommendation['type'] = 'IO_BOUND'\n    if (metrics.cpuRatio > 0.5) {\n      type = 'CPU_BOUND'\n    } else if (metrics.memDeltaBytes > 50 * 1024 * 1024) {\n      // > 50MB per run\n      type = 'MEMORY_BOUND'\n    }\n\n    // 2. Calculate Limits\n\n    // Memory Limit: Keep 30% buffer for system, divide rest by per-workflow memory\n    const safeMem = totalMem * 0.7\n    // Use at least 1MB as baseline to avoid division by zero or huge numbers\n    const perInstanceMem = Math.max(metrics.memDeltaBytes, 1024 * 1024)\n    const maxMemConcurrency = Math.floor(safeMem / perInstanceMem)\n\n    // CPU Limit:\n    // If IO Bound (0.2% cpu), we can run many. 100% / 0.2% = 500 tasks per core.\n    // We cap efficiency at a reasonable number to avoid Event Loop Lag density.\n    const cpuEfficiencyFactor = 1 / Math.max(metrics.cpuRatio, 0.001) // Avoid div by 0\n    const maxCpuConcurrency = Math.floor(cpus * cpuEfficiencyFactor)\n\n    // 3. Synthesize Recommendation\n    const safe = Math.min(maxMemConcurrency, 200) // Hard cap at 200 for sanity\n    let efficient = Math.min(maxCpuConcurrency, 200)\n\n    // If CPU bound, strict limit based on cores\n    if (type === 'CPU_BOUND') {\n      efficient = cpus // 1:1 mapping is best for CPU bound\n    }\n\n    const recommended = Math.min(safe, efficient)\n\n    let reason = ''\n    if (type === 'IO_BOUND') {\n      reason = `Workflow is I/O intensive (CPU usage ${(metrics.cpuRatio * 100).toFixed(1)}%). It is safe to run high concurrency up to ${recommended}.`\n    } else if (type === 'CPU_BOUND') {\n      reason = `Workflow is CPU intensive. Limiting concurrency to match CPU cores (${cpus}) is recommended to prevent blocking.`\n    } else {\n      reason = `Workflow consumes significant memory (${(metrics.memDeltaBytes / 1024 / 1024).toFixed(1)}MB). Concurrency limited by available RAM.`\n    }\n\n    if (config?.configuredConcurrency && config.configuredConcurrency > recommended) {\n      reason += ` \\n⚠️ Warning: Your current setting (${config.configuredConcurrency}) exceeds the recommended limit (${recommended}).`\n    }\n\n    return {\n      type,\n      safeConcurrency: safe,\n      efficientConcurrency: efficient,\n      suggestedConcurrency: `${Math.max(1, Math.floor(recommended * 0.5))} - ${recommended}`,\n      reason,\n    }\n  }\n}\n"]}
+{"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/index.cjs","../src/profiler/WorkflowProfiler.ts","../src/index.ts"],"names":["cpus"],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACjBA,+DAAoB;AA2Bb,IAAM,iBAAA,EAAN,MAAuB;AAAA,EAC5B,WAAA,CAAoB,MAAA,EAAqB;AAArB,IAAA,IAAA,CAAA,OAAA,EAAA,MAAA;AAClB,IAAA,GAAA,CAAI,CAAC,IAAA,CAAK,MAAA,EAAQ;AAEhB,MAAA,IAAA,CAAK,OAAA,EAAS,IAAI,iCAAA,CAAW;AAAA,QAC3B,MAAA,EAAQ,IAAI,uCAAA,CAAiB;AAAA,MAC/B,CAAC,CAAA;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAA,CACJ,QAAA,EACA,KAAA,EACyB;AAEzB,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,CAAK,MAAA,CAAQ,OAAA,CAAQ,QAAA,EAAU,KAAK,CAAA;AAAA,IAC5C,EAAA,UAAQ;AAAA,IAAC;AAGT,IAAA,GAAA,CAAI,MAAA,CAAO,EAAA,EAAI;AACb,MAAA,MAAA,CAAO,EAAA,CAAG,CAAA;AAAA,IACZ;AAEA,IAAA,MAAM,SAAA,EAAW,OAAA,CAAQ,QAAA,CAAS,CAAA;AAClC,IAAA,MAAM,SAAA,EAAW,OAAA,CAAQ,WAAA,CAAY,CAAA,CAAE,QAAA;AACvC,IAAA,MAAM,UAAA,EAAY,OAAA,CAAQ,MAAA,CAAO,MAAA,CAAO,CAAA;AAExC,IAAA,MAAM,IAAA,CAAK,MAAA,CAAQ,OAAA,CAAQ,QAAA,EAAU,KAAK,CAAA;AAE1C,IAAA,MAAM,QAAA,EAAU,OAAA,CAAQ,MAAA,CAAO,MAAA,CAAO,CAAA;AACtC,IAAA,MAAM,OAAA,EAAS,OAAA,CAAQ,QAAA,CAAS,QAAQ,CAAA;AACxC,IAAA,MAAM,OAAA,EAAS,OAAA,CAAQ,WAAA,CAAY,CAAA,CAAE,QAAA;AAGrC,IAAA,MAAM,WAAA,EAAa,MAAA,CAAO,QAAA,EAAU,SAAS,CAAA;AAC7C,IAAA,MAAM,WAAA,EAAa,WAAA,EAAa,GAAA;AAChC,IAAA,MAAM,UAAA,EAAY,MAAA,CAAO,KAAA,EAAO,GAAA;AAChC,IAAA,MAAM,SAAA,EAAW,MAAA,CAAO,OAAA,EAAS,GAAA;AACjC,IAAA,MAAM,WAAA,EAAa,UAAA,EAAY,QAAA;AAC/B,IAAA,MAAM,cAAA,EAAgB,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,OAAA,EAAS,QAAQ,CAAA;AAGnD,IAAA,MAAM,SAAA,EAAW,WAAA,EAAa,UAAA;AAE9B,IAAA,OAAO;AAAA,MACL,UAAA;AAAA,MACA,SAAA;AAAA,MACA,QAAA;AAAA,MACA,aAAA;AAAA,MACA;AAAA,IACF,CAAA;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,SAAA,CACE,OAAA,EACA,MAAA,EACuB;AACvB,IAAA,MAAM,SAAA,EAAc,EAAA,CAAA,QAAA,CAAS,CAAA;AAC7B,IAAA,MAAMA,MAAAA,EAAU,EAAA,CAAA,IAAA,CAAK,CAAA,CAAE,MAAA;AAGvB,IAAA,IAAI,KAAA,EAAsC,UAAA;AAC1C,IAAA,GAAA,CAAI,OAAA,CAAQ,SAAA,EAAW,GAAA,EAAK;AAC1B,MAAA,KAAA,EAAO,WAAA;AAAA,IACT,EAAA,KAAA,GAAA,CAAW,OAAA,CAAQ,cAAA,EAAgB,GAAA,EAAK,KAAA,EAAO,IAAA,EAAM;AAEnD,MAAA,KAAA,EAAO,cAAA;AAAA,IACT;AAKA,IAAA,MAAM,QAAA,EAAU,SAAA,EAAW,GAAA;AAE3B,IAAA,MAAM,eAAA,EAAiB,IAAA,CAAK,GAAA,CAAI,OAAA,CAAQ,aAAA,EAAe,KAAA,EAAO,IAAI,CAAA;AAClE,IAAA,MAAM,kBAAA,EAAoB,IAAA,CAAK,KAAA,CAAM,QAAA,EAAU,cAAc,CAAA;AAK7D,IAAA,MAAM,oBAAA,EAAsB,EAAA,EAAI,IAAA,CAAK,GAAA,CAAI,OAAA,CAAQ,QAAA,EAAU,IAAK,CAAA;AAChE,IAAA,MAAM,kBAAA,EAAoB,IAAA,CAAK,KAAA,CAAMA,MAAAA,EAAO,mBAAmB,CAAA;AAG/D,IAAA,MAAM,KAAA,EAAO,IAAA,CAAK,GAAA,CAAI,iBAAA,EAAmB,GAAG,CAAA;AAC5C,IAAA,IAAI,UAAA,EAAY,IAAA,CAAK,GAAA,CAAI,iBAAA,EAAmB,GAAG,CAAA;AAG/C,IAAA,GAAA,CAAI,KAAA,IAAS,WAAA,EAAa;AACxB,MAAA,UAAA,EAAYA,KAAAA;AAAA,IACd;AAEA,IAAA,MAAM,YAAA,EAAc,IAAA,CAAK,GAAA,CAAI,IAAA,EAAM,SAAS,CAAA;AAE5C,IAAA,IAAI,OAAA,EAAS,EAAA;AACb,IAAA,GAAA,CAAI,KAAA,IAAS,UAAA,EAAY;AACvB,MAAA,OAAA,EAAS,CAAA,qCAAA,EAAA,CAAyC,OAAA,CAAQ,SAAA,EAAW,GAAA,CAAA,CAAK,OAAA,CAAQ,CAAC,CAAC,CAAA,6CAAA,EAAgD,WAAW,CAAA,CAAA,CAAA;AAAA,IACjJ,EAAA,KAAA,GAAA,CAAW,KAAA,IAAS,WAAA,EAAa;AAC/B,MAAA,OAAA,EAAS,CAAA,oEAAA,EAAuEA,KAAI,CAAA,qCAAA,CAAA;AAAA,IACtF,EAAA,KAAO;AACL,MAAA,OAAA,EAAS,CAAA,sCAAA,EAAA,CAA0C,OAAA,CAAQ,cAAA,EAAgB,KAAA,EAAO,IAAA,CAAA,CAAM,OAAA,CAAQ,CAAC,CAAC,CAAA,0CAAA,CAAA;AAAA,IACpG;AAEA,IAAA,GAAA,iBAAI,MAAA,2BAAQ,wBAAA,GAAyB,MAAA,CAAO,sBAAA,EAAwB,WAAA,EAAa;AAC/E,MAAA,OAAA,GAAU,CAAA;AAAA,4CAAA,EAAwC,MAAA,CAAO,qBAAqB,CAAA,iCAAA,EAAoC,WAAW,CAAA,EAAA,CAAA;AAAA,IAC/H;AAEA,IAAA,OAAO;AAAA,MACL,IAAA;AAAA,MACA,eAAA,EAAiB,IAAA;AAAA,MACjB,oBAAA,EAAsB,SAAA;AAAA,MACtB,oBAAA,EAAsB,CAAA,EAAA;AACtB,MAAA;AACF,IAAA;AACF,EAAA;AACF;AD5C6B;AACA;AEtBT;AAAA;AAAA;AAAA;AAAA;AAAA;AAM2C,EAAA;AACnD,IAAA;AACR,IAAA;AACF,EAAA;AACF;AFwB6B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/Users/carl/Dev/Carl/gravito-core/packages/flux/dist/index.cjs","sourcesContent":[null,"import * as os from 'os'\nimport { FluxEngine } from '../engine/FluxEngine'\nimport { FluxSilentLogger } from '../logger/FluxLogger'\nimport type { WorkflowDefinition } from '../types'\n\nexport interface ProfileMetrics {\n  durationMs: number\n  cpuUserMs: number\n  cpuSysMs: number\n  memDeltaBytes: number\n  cpuRatio: number\n}\n\nexport interface ProfileRecommendation {\n  type: 'IO_BOUND' | 'CPU_BOUND' | 'MEMORY_BOUND'\n  safeConcurrency: number\n  efficientConcurrency: number\n  suggestedConcurrency: string\n  reason: string\n}\n\n/**\n * Workflow Profiler\n *\n * Analyzes workflow performance characteristics to recommend\n * optimal concurrency settings for Consumer workers.\n */\nexport class WorkflowProfiler {\n  constructor(private engine?: FluxEngine) {\n    if (!this.engine) {\n      // Default minimal engine for profiling (Silent)\n      this.engine = new FluxEngine({\n        logger: new FluxSilentLogger(),\n      })\n    }\n  }\n\n  /**\n   * Run a profile session for a specific workflow\n   */\n  async profile<TInput>(\n    workflow: WorkflowDefinition<TInput, any>,\n    input: TInput\n  ): Promise<ProfileMetrics> {\n    // 1. Warmup (JIT)\n    try {\n      await this.engine!.execute(workflow, input)\n    } catch {}\n\n    // 2. Measure\n    if (global.gc) {\n      global.gc()\n    }\n\n    const startCpu = process.cpuUsage()\n    const startMem = process.memoryUsage().heapUsed\n    const startTime = process.hrtime.bigint()\n\n    await this.engine!.execute(workflow, input)\n\n    const endTime = process.hrtime.bigint()\n    const endCpu = process.cpuUsage(startCpu)\n    const endMem = process.memoryUsage().heapUsed\n\n    // 3. Calculate\n    const durationNs = Number(endTime - startTime)\n    const durationMs = durationNs / 1_000_000\n    const cpuUserMs = endCpu.user / 1000\n    const cpuSysMs = endCpu.system / 1000\n    const totalCpuMs = cpuUserMs + cpuSysMs\n    const memDeltaBytes = Math.max(0, endMem - startMem) // Clamp to 0\n\n    // CPU Ratio: How much % of the time was spent on CPU vs Waiting\n    const cpuRatio = totalCpuMs / durationMs\n\n    return {\n      durationMs,\n      cpuUserMs,\n      cpuSysMs,\n      memDeltaBytes,\n      cpuRatio,\n    }\n  }\n\n  /**\n   * Generate recommendations based on metrics and current environment\n   */\n  recommend(\n    metrics: ProfileMetrics,\n    config?: { configuredConcurrency?: number }\n  ): ProfileRecommendation {\n    const totalMem = os.totalmem()\n    const cpus = os.cpus().length\n\n    // 1. Analyze Bottleneck Type\n    let type: ProfileRecommendation['type'] = 'IO_BOUND'\n    if (metrics.cpuRatio > 0.5) {\n      type = 'CPU_BOUND'\n    } else if (metrics.memDeltaBytes > 50 * 1024 * 1024) {\n      // > 50MB per run\n      type = 'MEMORY_BOUND'\n    }\n\n    // 2. Calculate Limits\n\n    // Memory Limit: Keep 30% buffer for system, divide rest by per-workflow memory\n    const safeMem = totalMem * 0.7\n    // Use at least 1MB as baseline to avoid division by zero or huge numbers\n    const perInstanceMem = Math.max(metrics.memDeltaBytes, 1024 * 1024)\n    const maxMemConcurrency = Math.floor(safeMem / perInstanceMem)\n\n    // CPU Limit:\n    // If IO Bound (0.2% cpu), we can run many. 100% / 0.2% = 500 tasks per core.\n    // We cap efficiency at a reasonable number to avoid Event Loop Lag density.\n    const cpuEfficiencyFactor = 1 / Math.max(metrics.cpuRatio, 0.001) // Avoid div by 0\n    const maxCpuConcurrency = Math.floor(cpus * cpuEfficiencyFactor)\n\n    // 3. Synthesize Recommendation\n    const safe = Math.min(maxMemConcurrency, 200) // Hard cap at 200 for sanity\n    let efficient = Math.min(maxCpuConcurrency, 200)\n\n    // If CPU bound, strict limit based on cores\n    if (type === 'CPU_BOUND') {\n      efficient = cpus // 1:1 mapping is best for CPU bound\n    }\n\n    const recommended = Math.min(safe, efficient)\n\n    let reason = ''\n    if (type === 'IO_BOUND') {\n      reason = `Workflow is I/O intensive (CPU usage ${(metrics.cpuRatio * 100).toFixed(1)}%). It is safe to run high concurrency up to ${recommended}.`\n    } else if (type === 'CPU_BOUND') {\n      reason = `Workflow is CPU intensive. Limiting concurrency to match CPU cores (${cpus}) is recommended to prevent blocking.`\n    } else {\n      reason = `Workflow consumes significant memory (${(metrics.memDeltaBytes / 1024 / 1024).toFixed(1)}MB). Concurrency limited by available RAM.`\n    }\n\n    if (config?.configuredConcurrency && config.configuredConcurrency > recommended) {\n      reason += ` \\n⚠️ Warning: Your current setting (${config.configuredConcurrency}) exceeds the recommended limit (${recommended}).`\n    }\n\n    return {\n      type,\n      safeConcurrency: safe,\n      efficientConcurrency: efficient,\n      suggestedConcurrency: `${Math.max(1, Math.floor(recommended * 0.5))} - ${recommended}`,\n      reason,\n    }\n  }\n}\n","/**\n * @fileoverview @gravito/flux - Platform-agnostic Workflow Engine\n *\n * High-performance, type-safe workflow engine with Bun optimizations.\n *\n * @example Basic Usage\n * ```typescript\n * import { FluxEngine, createWorkflow } from '@gravito/flux'\n *\n * const workflow = createWorkflow('order-process')\n *   .input<{ orderId: string }>()\n *   .step('validate', async (ctx) => {\n *     ctx.data.order = await fetchOrder(ctx.input.orderId)\n *   })\n *   .step('process', async (ctx) => {\n *     await processPayment(ctx.data.order)\n *   })\n *   .commit('notify', async (ctx) => {\n *     await sendEmail(ctx.data.order.email)\n *   })\n *\n * const engine = new FluxEngine()\n * const result = await engine.execute(workflow, { orderId: '123' })\n * ```\n *\n * @module @gravito/flux\n */\n\n// Builder\nexport { createWorkflow, WorkflowBuilder } from './builder/WorkflowBuilder'\nexport { ContextManager } from './core/ContextManager'\n// Core (for advanced usage)\nexport { StateMachine } from './core/StateMachine'\nexport { StepExecutor } from './core/StepExecutor'\n// Core\nexport { FluxEngine } from './engine/FluxEngine'\n// Logger\nexport { FluxConsoleLogger, FluxSilentLogger } from './logger/FluxLogger'\n// Gravito Integration\nexport { OrbitFlux, type OrbitFluxOptions } from './orbit/OrbitFlux'\n// Profiler\nexport {\n  type ProfileMetrics,\n  type ProfileRecommendation,\n  WorkflowProfiler,\n} from './profiler/WorkflowProfiler'\nexport { BunSQLiteStorage, type BunSQLiteStorageOptions } from './storage/BunSQLiteStorage'\n// Storage\nexport { MemoryStorage } from './storage/MemoryStorage'\n// Trace\nexport { JsonFileTraceSink } from './trace/JsonFileTraceSink'\n\n// Types\nexport type {\n  // Config\n  FluxConfig,\n  // Logger\n  FluxLogger,\n  FluxResult,\n  // Trace\n  FluxTraceEvent,\n  FluxTraceEventType,\n  FluxTraceSink,\n  // Helper\n  FluxWaitResult,\n  // Step types\n  StepDefinition,\n  StepDescriptor,\n  StepExecution,\n  StepResult,\n  WorkflowContext,\n  WorkflowDefinition,\n  WorkflowDescriptor,\n  WorkflowFilter,\n  WorkflowState,\n  // Core types\n  WorkflowStatus,\n  // Storage\n  WorkflowStorage,\n} from './types'\n\n/**\n * Flux helper utilities\n */\nexport const Flux = {\n  /**\n   * Suspend workflow execution and wait for a signal\n   *\n   * @param signal - Signal name to wait for\n   */\n  wait: (signal: string): import('./types').FluxWaitResult => ({\n    __kind: 'flux_wait',\n    signal,\n  }),\n}\n"]}

package/dist/index.d.cts

@@ -1,7 +1,7 @@
+import { W as WorkflowDefinition, F as FluxWaitResult } from './types-cnIU1O3n.cjs';
+export { a as FluxConfig, b as FluxLogger, c as FluxResult, d as FluxTraceEvent, e as FluxTraceEventType, f as FluxTraceSink, S as StepDefinition, g as StepDescriptor, h as StepExecution, i as StepResult, j as WorkflowContext, k as WorkflowDescriptor, l as WorkflowFilter, m as WorkflowState, n as WorkflowStatus, o as WorkflowStorage } from './types-cnIU1O3n.cjs';
 import { FluxEngine } from './index.node.cjs';
 export { ContextManager, FluxConsoleLogger, FluxSilentLogger, JsonFileTraceSink, MemoryStorage, OrbitFlux, OrbitFluxOptions, StateMachine, StepExecutor, WorkflowBuilder, createWorkflow } from './index.node.cjs';
-import { W as WorkflowDefinition } from './types-DvVHBmP6.cjs';
-export { F as FluxConfig, a as FluxLogger, b as FluxResult, c as FluxTraceEvent, d as FluxTraceEventType, e as FluxTraceSink, S as StepDefinition, f as StepDescriptor, g as StepExecution, h as StepResult, i as WorkflowContext, j as WorkflowDescriptor, k as WorkflowFilter, l as WorkflowState, m as WorkflowStatus, n as WorkflowStorage } from './types-DvVHBmP6.cjs';
 export { BunSQLiteStorage, BunSQLiteStorageOptions } from './bun.cjs';
 import 'bun:sqlite';
 
@@ -40,4 +40,16 @@ declare class WorkflowProfiler {
     }): ProfileRecommendation;
 }
 
-export { FluxEngine, type ProfileMetrics, type ProfileRecommendation, WorkflowDefinition, WorkflowProfiler };
+/**
+ * Flux helper utilities
+ */
+declare const Flux: {
+    /**
+     * Suspend workflow execution and wait for a signal
+     *
+     * @param signal - Signal name to wait for
+     */
+    wait: (signal: string) => FluxWaitResult;
+};
+
+export { Flux, FluxEngine, FluxWaitResult, type ProfileMetrics, type ProfileRecommendation, WorkflowDefinition, WorkflowProfiler };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
+import { W as WorkflowDefinition, F as FluxWaitResult } from './types-cnIU1O3n.js';
+export { a as FluxConfig, b as FluxLogger, c as FluxResult, d as FluxTraceEvent, e as FluxTraceEventType, f as FluxTraceSink, S as StepDefinition, g as StepDescriptor, h as StepExecution, i as StepResult, j as WorkflowContext, k as WorkflowDescriptor, l as WorkflowFilter, m as WorkflowState, n as WorkflowStatus, o as WorkflowStorage } from './types-cnIU1O3n.js';
 import { FluxEngine } from './index.node.js';
 export { ContextManager, FluxConsoleLogger, FluxSilentLogger, JsonFileTraceSink, MemoryStorage, OrbitFlux, OrbitFluxOptions, StateMachine, StepExecutor, WorkflowBuilder, createWorkflow } from './index.node.js';
-import { W as WorkflowDefinition } from './types-DvVHBmP6.js';
-export { F as FluxConfig, a as FluxLogger, b as FluxResult, c as FluxTraceEvent, d as FluxTraceEventType, e as FluxTraceSink, S as StepDefinition, f as StepDescriptor, g as StepExecution, h as StepResult, i as WorkflowContext, j as WorkflowDescriptor, k as WorkflowFilter, l as WorkflowState, m as WorkflowStatus, n as WorkflowStorage } from './types-DvVHBmP6.js';
 export { BunSQLiteStorage, BunSQLiteStorageOptions } from './bun.js';
 import 'bun:sqlite';
 
@@ -40,4 +40,16 @@ declare class WorkflowProfiler {
     }): ProfileRecommendation;
 }
 
-export { FluxEngine, type ProfileMetrics, type ProfileRecommendation, WorkflowDefinition, WorkflowProfiler };
+/**
+ * Flux helper utilities
+ */
+declare const Flux: {
+    /**
+     * Suspend workflow execution and wait for a signal
+     *
+     * @param signal - Signal name to wait for
+     */
+    wait: (signal: string) => FluxWaitResult;
+};
+
+export { Flux, FluxEngine, FluxWaitResult, type ProfileMetrics, type ProfileRecommendation, WorkflowDefinition, WorkflowProfiler };

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   StepExecutor,
   WorkflowBuilder,
   createWorkflow
-} from "./chunk-J37UUMLM.js";
+} from "./chunk-CICUXW2L.js";
 import {
   BunSQLiteStorage
 } from "./chunk-ZAMVC732.js";
@@ -103,9 +103,23 @@ var WorkflowProfiler = class {
     };
   }
 };
+
+// src/index.ts
+var Flux = {
+  /**
+   * Suspend workflow execution and wait for a signal
+   *
+   * @param signal - Signal name to wait for
+   */
+  wait: (signal) => ({
+    __kind: "flux_wait",
+    signal
+  })
+};
 export {
   BunSQLiteStorage,
   ContextManager,
+  Flux,
   FluxConsoleLogger,
   FluxEngine,
   FluxSilentLogger,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/profiler/WorkflowProfiler.ts"],"sourcesContent":["import * as os from 'os'\nimport { FluxEngine } from '../engine/FluxEngine'\nimport { FluxSilentLogger } from '../logger/FluxLogger'\nimport type { WorkflowDefinition } from '../types'\n\nexport interface ProfileMetrics {\n  durationMs: number\n  cpuUserMs: number\n  cpuSysMs: number\n  memDeltaBytes: number\n  cpuRatio: number\n}\n\nexport interface ProfileRecommendation {\n  type: 'IO_BOUND' | 'CPU_BOUND' | 'MEMORY_BOUND'\n  safeConcurrency: number\n  efficientConcurrency: number\n  suggestedConcurrency: string\n  reason: string\n}\n\n/**\n * Workflow Profiler\n *\n * Analyzes workflow performance characteristics to recommend\n * optimal concurrency settings for Consumer workers.\n */\nexport class WorkflowProfiler {\n  constructor(private engine?: FluxEngine) {\n    if (!this.engine) {\n      // Default minimal engine for profiling (Silent)\n      this.engine = new FluxEngine({\n        logger: new FluxSilentLogger(),\n      })\n    }\n  }\n\n  /**\n   * Run a profile session for a specific workflow\n   */\n  async profile<TInput>(\n    workflow: WorkflowDefinition<TInput, any>,\n    input: TInput\n  ): Promise<ProfileMetrics> {\n    // 1. Warmup (JIT)\n    try {\n      await this.engine!.execute(workflow, input)\n    } catch {}\n\n    // 2. Measure\n    if (global.gc) {\n      global.gc()\n    }\n\n    const startCpu = process.cpuUsage()\n    const startMem = process.memoryUsage().heapUsed\n    const startTime = process.hrtime.bigint()\n\n    await this.engine!.execute(workflow, input)\n\n    const endTime = process.hrtime.bigint()\n    const endCpu = process.cpuUsage(startCpu)\n    const endMem = process.memoryUsage().heapUsed\n\n    // 3. Calculate\n    const durationNs = Number(endTime - startTime)\n    const durationMs = durationNs / 1_000_000\n    const cpuUserMs = endCpu.user / 1000\n    const cpuSysMs = endCpu.system / 1000\n    const totalCpuMs = cpuUserMs + cpuSysMs\n    const memDeltaBytes = Math.max(0, endMem - startMem) // Clamp to 0\n\n    // CPU Ratio: How much % of the time was spent on CPU vs Waiting\n    const cpuRatio = totalCpuMs / durationMs\n\n    return {\n      durationMs,\n      cpuUserMs,\n      cpuSysMs,\n      memDeltaBytes,\n      cpuRatio,\n    }\n  }\n\n  /**\n   * Generate recommendations based on metrics and current environment\n   */\n  recommend(\n    metrics: ProfileMetrics,\n    config?: { configuredConcurrency?: number }\n  ): ProfileRecommendation {\n    const totalMem = os.totalmem()\n    const cpus = os.cpus().length\n\n    // 1. Analyze Bottleneck Type\n    let type: ProfileRecommendation['type'] = 'IO_BOUND'\n    if (metrics.cpuRatio > 0.5) {\n      type = 'CPU_BOUND'\n    } else if (metrics.memDeltaBytes > 50 * 1024 * 1024) {\n      // > 50MB per run\n      type = 'MEMORY_BOUND'\n    }\n\n    // 2. Calculate Limits\n\n    // Memory Limit: Keep 30% buffer for system, divide rest by per-workflow memory\n    const safeMem = totalMem * 0.7\n    // Use at least 1MB as baseline to avoid division by zero or huge numbers\n    const perInstanceMem = Math.max(metrics.memDeltaBytes, 1024 * 1024)\n    const maxMemConcurrency = Math.floor(safeMem / perInstanceMem)\n\n    // CPU Limit:\n    // If IO Bound (0.2% cpu), we can run many. 100% / 0.2% = 500 tasks per core.\n    // We cap efficiency at a reasonable number to avoid Event Loop Lag density.\n    const cpuEfficiencyFactor = 1 / Math.max(metrics.cpuRatio, 0.001) // Avoid div by 0\n    const maxCpuConcurrency = Math.floor(cpus * cpuEfficiencyFactor)\n\n    // 3. Synthesize Recommendation\n    const safe = Math.min(maxMemConcurrency, 200) // Hard cap at 200 for sanity\n    let efficient = Math.min(maxCpuConcurrency, 200)\n\n    // If CPU bound, strict limit based on cores\n    if (type === 'CPU_BOUND') {\n      efficient = cpus // 1:1 mapping is best for CPU bound\n    }\n\n    const recommended = Math.min(safe, efficient)\n\n    let reason = ''\n    if (type === 'IO_BOUND') {\n      reason = `Workflow is I/O intensive (CPU usage ${(metrics.cpuRatio * 100).toFixed(1)}%). It is safe to run high concurrency up to ${recommended}.`\n    } else if (type === 'CPU_BOUND') {\n      reason = `Workflow is CPU intensive. Limiting concurrency to match CPU cores (${cpus}) is recommended to prevent blocking.`\n    } else {\n      reason = `Workflow consumes significant memory (${(metrics.memDeltaBytes / 1024 / 1024).toFixed(1)}MB). Concurrency limited by available RAM.`\n    }\n\n    if (config?.configuredConcurrency && config.configuredConcurrency > recommended) {\n      reason += ` \\n⚠️ Warning: Your current setting (${config.configuredConcurrency}) exceeds the recommended limit (${recommended}).`\n    }\n\n    return {\n      type,\n      safeConcurrency: safe,\n      efficientConcurrency: efficient,\n      suggestedConcurrency: `${Math.max(1, Math.floor(recommended * 0.5))} - ${recommended}`,\n      reason,\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA,YAAY,QAAQ;AA2Bb,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,QAAqB;AAArB;AAClB,QAAI,CAAC,KAAK,QAAQ;AAEhB,WAAK,SAAS,IAAI,WAAW;AAAA,QAC3B,QAAQ,IAAI,iBAAiB;AAAA,MAC/B,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QACJ,UACA,OACyB;AAEzB,QAAI;AACF,YAAM,KAAK,OAAQ,QAAQ,UAAU,KAAK;AAAA,IAC5C,QAAQ;AAAA,IAAC;AAGT,QAAI,OAAO,IAAI;AACb,aAAO,GAAG;AAAA,IACZ;AAEA,UAAM,WAAW,QAAQ,SAAS;AAClC,UAAM,WAAW,QAAQ,YAAY,EAAE;AACvC,UAAM,YAAY,QAAQ,OAAO,OAAO;AAExC,UAAM,KAAK,OAAQ,QAAQ,UAAU,KAAK;AAE1C,UAAM,UAAU,QAAQ,OAAO,OAAO;AACtC,UAAM,SAAS,QAAQ,SAAS,QAAQ;AACxC,UAAM,SAAS,QAAQ,YAAY,EAAE;AAGrC,UAAM,aAAa,OAAO,UAAU,SAAS;AAC7C,UAAM,aAAa,aAAa;AAChC,UAAM,YAAY,OAAO,OAAO;AAChC,UAAM,WAAW,OAAO,SAAS;AACjC,UAAM,aAAa,YAAY;AAC/B,UAAM,gBAAgB,KAAK,IAAI,GAAG,SAAS,QAAQ;AAGnD,UAAM,WAAW,aAAa;AAE9B,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,UACE,SACA,QACuB;AACvB,UAAM,WAAc,YAAS;AAC7B,UAAMA,QAAU,QAAK,EAAE;AAGvB,QAAI,OAAsC;AAC1C,QAAI,QAAQ,WAAW,KAAK;AAC1B,aAAO;AAAA,IACT,WAAW,QAAQ,gBAAgB,KAAK,OAAO,MAAM;AAEnD,aAAO;AAAA,IACT;AAKA,UAAM,UAAU,WAAW;AAE3B,UAAM,iBAAiB,KAAK,IAAI,QAAQ,eAAe,OAAO,IAAI;AAClE,UAAM,oBAAoB,KAAK,MAAM,UAAU,cAAc;AAK7D,UAAM,sBAAsB,IAAI,KAAK,IAAI,QAAQ,UAAU,IAAK;AAChE,UAAM,oBAAoB,KAAK,MAAMA,QAAO,mBAAmB;AAG/D,UAAM,OAAO,KAAK,IAAI,mBAAmB,GAAG;AAC5C,QAAI,YAAY,KAAK,IAAI,mBAAmB,GAAG;AAG/C,QAAI,SAAS,aAAa;AACxB,kBAAYA;AAAA,IACd;AAEA,UAAM,cAAc,KAAK,IAAI,MAAM,SAAS;AAE5C,QAAI,SAAS;AACb,QAAI,SAAS,YAAY;AACvB,eAAS,yCAAyC,QAAQ,WAAW,KAAK,QAAQ,CAAC,CAAC,gDAAgD,WAAW;AAAA,IACjJ,WAAW,SAAS,aAAa;AAC/B,eAAS,uEAAuEA,KAAI;AAAA,IACtF,OAAO;AACL,eAAS,0CAA0C,QAAQ,gBAAgB,OAAO,MAAM,QAAQ,CAAC,CAAC;AAAA,IACpG;AAEA,QAAI,QAAQ,yBAAyB,OAAO,wBAAwB,aAAa;AAC/E,gBAAU;AAAA,8CAAwC,OAAO,qBAAqB,oCAAoC,WAAW;AAAA,IAC/H;AAEA,WAAO;AAAA,MACL;AAAA,MACA,iBAAiB;AAAA,MACjB,sBAAsB;AAAA,MACtB,sBAAsB,GAAG,KAAK,IAAI,GAAG,KAAK,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,WAAW;AAAA,MACpF;AAAA,IACF;AAAA,EACF;AACF;","names":["cpus"]}
+{"version":3,"sources":["../src/profiler/WorkflowProfiler.ts","../src/index.ts"],"sourcesContent":["import * as os from 'os'\nimport { FluxEngine } from '../engine/FluxEngine'\nimport { FluxSilentLogger } from '../logger/FluxLogger'\nimport type { WorkflowDefinition } from '../types'\n\nexport interface ProfileMetrics {\n  durationMs: number\n  cpuUserMs: number\n  cpuSysMs: number\n  memDeltaBytes: number\n  cpuRatio: number\n}\n\nexport interface ProfileRecommendation {\n  type: 'IO_BOUND' | 'CPU_BOUND' | 'MEMORY_BOUND'\n  safeConcurrency: number\n  efficientConcurrency: number\n  suggestedConcurrency: string\n  reason: string\n}\n\n/**\n * Workflow Profiler\n *\n * Analyzes workflow performance characteristics to recommend\n * optimal concurrency settings for Consumer workers.\n */\nexport class WorkflowProfiler {\n  constructor(private engine?: FluxEngine) {\n    if (!this.engine) {\n      // Default minimal engine for profiling (Silent)\n      this.engine = new FluxEngine({\n        logger: new FluxSilentLogger(),\n      })\n    }\n  }\n\n  /**\n   * Run a profile session for a specific workflow\n   */\n  async profile<TInput>(\n    workflow: WorkflowDefinition<TInput, any>,\n    input: TInput\n  ): Promise<ProfileMetrics> {\n    // 1. Warmup (JIT)\n    try {\n      await this.engine!.execute(workflow, input)\n    } catch {}\n\n    // 2. Measure\n    if (global.gc) {\n      global.gc()\n    }\n\n    const startCpu = process.cpuUsage()\n    const startMem = process.memoryUsage().heapUsed\n    const startTime = process.hrtime.bigint()\n\n    await this.engine!.execute(workflow, input)\n\n    const endTime = process.hrtime.bigint()\n    const endCpu = process.cpuUsage(startCpu)\n    const endMem = process.memoryUsage().heapUsed\n\n    // 3. Calculate\n    const durationNs = Number(endTime - startTime)\n    const durationMs = durationNs / 1_000_000\n    const cpuUserMs = endCpu.user / 1000\n    const cpuSysMs = endCpu.system / 1000\n    const totalCpuMs = cpuUserMs + cpuSysMs\n    const memDeltaBytes = Math.max(0, endMem - startMem) // Clamp to 0\n\n    // CPU Ratio: How much % of the time was spent on CPU vs Waiting\n    const cpuRatio = totalCpuMs / durationMs\n\n    return {\n      durationMs,\n      cpuUserMs,\n      cpuSysMs,\n      memDeltaBytes,\n      cpuRatio,\n    }\n  }\n\n  /**\n   * Generate recommendations based on metrics and current environment\n   */\n  recommend(\n    metrics: ProfileMetrics,\n    config?: { configuredConcurrency?: number }\n  ): ProfileRecommendation {\n    const totalMem = os.totalmem()\n    const cpus = os.cpus().length\n\n    // 1. Analyze Bottleneck Type\n    let type: ProfileRecommendation['type'] = 'IO_BOUND'\n    if (metrics.cpuRatio > 0.5) {\n      type = 'CPU_BOUND'\n    } else if (metrics.memDeltaBytes > 50 * 1024 * 1024) {\n      // > 50MB per run\n      type = 'MEMORY_BOUND'\n    }\n\n    // 2. Calculate Limits\n\n    // Memory Limit: Keep 30% buffer for system, divide rest by per-workflow memory\n    const safeMem = totalMem * 0.7\n    // Use at least 1MB as baseline to avoid division by zero or huge numbers\n    const perInstanceMem = Math.max(metrics.memDeltaBytes, 1024 * 1024)\n    const maxMemConcurrency = Math.floor(safeMem / perInstanceMem)\n\n    // CPU Limit:\n    // If IO Bound (0.2% cpu), we can run many. 100% / 0.2% = 500 tasks per core.\n    // We cap efficiency at a reasonable number to avoid Event Loop Lag density.\n    const cpuEfficiencyFactor = 1 / Math.max(metrics.cpuRatio, 0.001) // Avoid div by 0\n    const maxCpuConcurrency = Math.floor(cpus * cpuEfficiencyFactor)\n\n    // 3. Synthesize Recommendation\n    const safe = Math.min(maxMemConcurrency, 200) // Hard cap at 200 for sanity\n    let efficient = Math.min(maxCpuConcurrency, 200)\n\n    // If CPU bound, strict limit based on cores\n    if (type === 'CPU_BOUND') {\n      efficient = cpus // 1:1 mapping is best for CPU bound\n    }\n\n    const recommended = Math.min(safe, efficient)\n\n    let reason = ''\n    if (type === 'IO_BOUND') {\n      reason = `Workflow is I/O intensive (CPU usage ${(metrics.cpuRatio * 100).toFixed(1)}%). It is safe to run high concurrency up to ${recommended}.`\n    } else if (type === 'CPU_BOUND') {\n      reason = `Workflow is CPU intensive. Limiting concurrency to match CPU cores (${cpus}) is recommended to prevent blocking.`\n    } else {\n      reason = `Workflow consumes significant memory (${(metrics.memDeltaBytes / 1024 / 1024).toFixed(1)}MB). Concurrency limited by available RAM.`\n    }\n\n    if (config?.configuredConcurrency && config.configuredConcurrency > recommended) {\n      reason += ` \\n⚠️ Warning: Your current setting (${config.configuredConcurrency}) exceeds the recommended limit (${recommended}).`\n    }\n\n    return {\n      type,\n      safeConcurrency: safe,\n      efficientConcurrency: efficient,\n      suggestedConcurrency: `${Math.max(1, Math.floor(recommended * 0.5))} - ${recommended}`,\n      reason,\n    }\n  }\n}\n","/**\n * @fileoverview @gravito/flux - Platform-agnostic Workflow Engine\n *\n * High-performance, type-safe workflow engine with Bun optimizations.\n *\n * @example Basic Usage\n * ```typescript\n * import { FluxEngine, createWorkflow } from '@gravito/flux'\n *\n * const workflow = createWorkflow('order-process')\n *   .input<{ orderId: string }>()\n *   .step('validate', async (ctx) => {\n *     ctx.data.order = await fetchOrder(ctx.input.orderId)\n *   })\n *   .step('process', async (ctx) => {\n *     await processPayment(ctx.data.order)\n *   })\n *   .commit('notify', async (ctx) => {\n *     await sendEmail(ctx.data.order.email)\n *   })\n *\n * const engine = new FluxEngine()\n * const result = await engine.execute(workflow, { orderId: '123' })\n * ```\n *\n * @module @gravito/flux\n */\n\n// Builder\nexport { createWorkflow, WorkflowBuilder } from './builder/WorkflowBuilder'\nexport { ContextManager } from './core/ContextManager'\n// Core (for advanced usage)\nexport { StateMachine } from './core/StateMachine'\nexport { StepExecutor } from './core/StepExecutor'\n// Core\nexport { FluxEngine } from './engine/FluxEngine'\n// Logger\nexport { FluxConsoleLogger, FluxSilentLogger } from './logger/FluxLogger'\n// Gravito Integration\nexport { OrbitFlux, type OrbitFluxOptions } from './orbit/OrbitFlux'\n// Profiler\nexport {\n  type ProfileMetrics,\n  type ProfileRecommendation,\n  WorkflowProfiler,\n} from './profiler/WorkflowProfiler'\nexport { BunSQLiteStorage, type BunSQLiteStorageOptions } from './storage/BunSQLiteStorage'\n// Storage\nexport { MemoryStorage } from './storage/MemoryStorage'\n// Trace\nexport { JsonFileTraceSink } from './trace/JsonFileTraceSink'\n\n// Types\nexport type {\n  // Config\n  FluxConfig,\n  // Logger\n  FluxLogger,\n  FluxResult,\n  // Trace\n  FluxTraceEvent,\n  FluxTraceEventType,\n  FluxTraceSink,\n  // Helper\n  FluxWaitResult,\n  // Step types\n  StepDefinition,\n  StepDescriptor,\n  StepExecution,\n  StepResult,\n  WorkflowContext,\n  WorkflowDefinition,\n  WorkflowDescriptor,\n  WorkflowFilter,\n  WorkflowState,\n  // Core types\n  WorkflowStatus,\n  // Storage\n  WorkflowStorage,\n} from './types'\n\n/**\n * Flux helper utilities\n */\nexport const Flux = {\n  /**\n   * Suspend workflow execution and wait for a signal\n   *\n   * @param signal - Signal name to wait for\n   */\n  wait: (signal: string): import('./types').FluxWaitResult => ({\n    __kind: 'flux_wait',\n    signal,\n  }),\n}\n"],"mappings":"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","names":["cpus"]}