@graphrefly/graphrefly 0.40.0 → 0.41.0

package/dist/{index-IUCY0OFN.d.ts → index-CG33HeBW.d.ts}

@@ -112,16 +112,31 @@ type StageDef<T> = string | {
         id: string;
         version: string | number;
     };
+    /**
+     * Per-stage cap on `claim → work → ack` cycles per pump tick.
+     * Overrides {@link JobFlowOptions.maxPerPump} for this stage. Useful
+     * when stages have asymmetric cost (e.g. an LLM-execute stage capped
+     * at 4 concurrent calls while a cheap verify stage runs unbounded).
+     *
+     * Falls back to the top-level `JobFlowOptions.maxPerPump`, which in
+     * turn falls back to `DEFAULT_MAX_PER_PUMP` (256).
+     */
+    maxPerPump?: number;
 };
 type JobFlowOptions<T = unknown> = {
     graph?: GraphOptions;
     /**
      * Stage definitions. Each stage is either a bare name string (pure
-     * pass-through) or a `{ name, work?, handlerVersion? }` object.
+     * pass-through) or a `{ name, work?, handlerVersion?, maxPerPump? }` object.
      *
      * For back-compat, `string[]` values behave as stages with no work hook.
      */
     stages?: readonly StageDef<T>[];
+    /**
+     * Default cap on claims per pump tick across all stages. Per-stage
+     * overrides can be set on each {@link StageDef.maxPerPump}; if neither is
+     * set, falls back to `DEFAULT_MAX_PER_PUMP` (256).
+     */
     maxPerPump?: number;
 };
 declare class JobFlowGraph<T> extends Graph {
@@ -168,4 +183,4 @@ declare namespace index {
   export { type index_JobEnvelope as JobEnvelope, type index_JobEvent as JobEvent, type index_JobEventAction as JobEventAction, index_JobFlowGraph as JobFlowGraph, type index_JobFlowOptions as JobFlowOptions, index_JobQueueGraph as JobQueueGraph, type index_JobQueueOptions as JobQueueOptions, type index_JobState as JobState, type index_StageDef as StageDef, type index_WorkFn as WorkFn, index_jobEventKeyOf as jobEventKeyOf, index_jobFlow as jobFlow, index_jobQueue as jobQueue };
 }
 
-export { JobQueueGraph as J, type StageDef as S, type WorkFn as W, type JobEnvelope as a, type JobEvent as b, type JobEventAction as c, JobFlowGraph as d, type JobFlowOptions as e, type JobQueueOptions as f, type JobState as g, jobFlow as h, index as i, jobEventKeyOf as j, jobQueue as k };
+export { type JobEnvelope as J, type StageDef as S, type WorkFn as W, JobFlowGraph as a, JobQueueGraph as b, type JobEvent as c, type JobEventAction as d, type JobFlowOptions as e, type JobQueueOptions as f, type JobState as g, jobFlow as h, index as i, jobEventKeyOf as j, jobQueue as k };

package/dist/{index-BTHOTC0Q.d.cts → index-DGD4_fj6.d.cts}

@@ -112,16 +112,31 @@ type StageDef<T> = string | {
         id: string;
         version: string | number;
     };
+    /**
+     * Per-stage cap on `claim → work → ack` cycles per pump tick.
+     * Overrides {@link JobFlowOptions.maxPerPump} for this stage. Useful
+     * when stages have asymmetric cost (e.g. an LLM-execute stage capped
+     * at 4 concurrent calls while a cheap verify stage runs unbounded).
+     *
+     * Falls back to the top-level `JobFlowOptions.maxPerPump`, which in
+     * turn falls back to `DEFAULT_MAX_PER_PUMP` (256).
+     */
+    maxPerPump?: number;
 };
 type JobFlowOptions<T = unknown> = {
     graph?: GraphOptions;
     /**
      * Stage definitions. Each stage is either a bare name string (pure
-     * pass-through) or a `{ name, work?, handlerVersion? }` object.
+     * pass-through) or a `{ name, work?, handlerVersion?, maxPerPump? }` object.
      *
      * For back-compat, `string[]` values behave as stages with no work hook.
      */
     stages?: readonly StageDef<T>[];
+    /**
+     * Default cap on claims per pump tick across all stages. Per-stage
+     * overrides can be set on each {@link StageDef.maxPerPump}; if neither is
+     * set, falls back to `DEFAULT_MAX_PER_PUMP` (256).
+     */
     maxPerPump?: number;
 };
 declare class JobFlowGraph<T> extends Graph {
@@ -168,4 +183,4 @@ declare namespace index {
   export { type index_JobEnvelope as JobEnvelope, type index_JobEvent as JobEvent, type index_JobEventAction as JobEventAction, index_JobFlowGraph as JobFlowGraph, type index_JobFlowOptions as JobFlowOptions, index_JobQueueGraph as JobQueueGraph, type index_JobQueueOptions as JobQueueOptions, type index_JobState as JobState, type index_StageDef as StageDef, type index_WorkFn as WorkFn, index_jobEventKeyOf as jobEventKeyOf, index_jobFlow as jobFlow, index_jobQueue as jobQueue };
 }
 
-export { JobQueueGraph as J, type StageDef as S, type WorkFn as W, type JobEnvelope as a, type JobEvent as b, type JobEventAction as c, JobFlowGraph as d, type JobFlowOptions as e, type JobQueueOptions as f, type JobState as g, jobFlow as h, index as i, jobEventKeyOf as j, jobQueue as k };
+export { type JobEnvelope as J, type StageDef as S, type WorkFn as W, JobFlowGraph as a, JobQueueGraph as b, type JobEvent as c, type JobEventAction as d, type JobFlowOptions as e, type JobQueueOptions as f, type JobState as g, jobFlow as h, index as i, jobEventKeyOf as j, jobQueue as k };