@backendkit-labs/agent-core 0.43.0 → 0.45.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/README.md +59 -0
  2. package/dist/flow/adapter.d.ts +4 -1
  3. package/dist/flow/adapter.d.ts.map +1 -1
  4. package/dist/flow/adapter.js +14 -1
  5. package/dist/flow/adapter.js.map +1 -1
  6. package/dist/flow/condition.d.ts +6 -0
  7. package/dist/flow/condition.d.ts.map +1 -0
  8. package/dist/flow/condition.js +30 -0
  9. package/dist/flow/condition.js.map +1 -0
  10. package/dist/flow/file-journal.d.ts +12 -0
  11. package/dist/flow/file-journal.d.ts.map +1 -1
  12. package/dist/flow/file-journal.js +52 -15
  13. package/dist/flow/file-journal.js.map +1 -1
  14. package/dist/flow/host.d.ts +13 -0
  15. package/dist/flow/host.d.ts.map +1 -1
  16. package/dist/flow/host.js +56 -6
  17. package/dist/flow/host.js.map +1 -1
  18. package/dist/flow/index.d.ts +5 -3
  19. package/dist/flow/index.d.ts.map +1 -1
  20. package/dist/flow/index.js +6 -1
  21. package/dist/flow/index.js.map +1 -1
  22. package/dist/flow/journal.d.ts +13 -0
  23. package/dist/flow/journal.d.ts.map +1 -1
  24. package/dist/flow/journal.js +24 -1
  25. package/dist/flow/journal.js.map +1 -1
  26. package/dist/flow/loader.d.ts.map +1 -1
  27. package/dist/flow/loader.js +13 -0
  28. package/dist/flow/loader.js.map +1 -1
  29. package/dist/flow/ndjson-journal.d.ts +46 -0
  30. package/dist/flow/ndjson-journal.d.ts.map +1 -0
  31. package/dist/flow/ndjson-journal.js +311 -0
  32. package/dist/flow/ndjson-journal.js.map +1 -0
  33. package/dist/flow/run.d.ts +9 -0
  34. package/dist/flow/run.d.ts.map +1 -1
  35. package/dist/flow/run.js +107 -13
  36. package/dist/flow/run.js.map +1 -1
  37. package/dist/flow/tools.d.ts +4 -0
  38. package/dist/flow/tools.d.ts.map +1 -1
  39. package/dist/flow/tools.js +25 -0
  40. package/dist/flow/tools.js.map +1 -1
  41. package/dist/flow/types.d.ts +27 -0
  42. package/dist/flow/types.d.ts.map +1 -1
  43. package/dist/flow/types.js +18 -1
  44. package/dist/flow/types.js.map +1 -1
  45. package/dist/index.d.ts +3 -2
  46. package/dist/index.d.ts.map +1 -1
  47. package/dist/index.js +5 -2
  48. package/dist/index.js.map +1 -1
  49. package/package.json +1 -1
package/README.md CHANGED
@@ -19,6 +19,7 @@ The foundation engine for the BackendKit Labs agent framework. Provides everythi
19
19
  - [MCP client](#mcp-client)
20
20
  - [MCP tool server (tools without a model)](#mcp-tool-server-tools-without-a-model)
21
21
  - [Workflow engine](#workflow-engine)
22
+ - [Flows — declarative and durable](#flows--declarative-and-durable)
22
23
  - [Advanced memory system](#advanced-memory-system)
23
24
  - [Observability](#observability)
24
25
  - [Skills and slash commands](#skills-and-slash-commands)
@@ -775,6 +776,64 @@ const result = await runner.run(myWorkflow, {
775
776
 
776
777
  ---
777
778
 
779
+ ## Flows — declarative and durable
780
+
781
+ A business flow is data: a YAML file with steps, dependencies, approvals and compensations. `runFlow` executes it; **how** a step runs is the `StepExecutor` you pass (one agent, a remote worker, a queue). Adding a flow for a company means writing YAML, not platform code. A runnable example lives in [`examples/flows`](../../examples/flows).
782
+
783
+ ```yaml
784
+ flow: close-month
785
+ trigger: { type: manual }
786
+ steps:
787
+ - id: collect-sales # no `after`: runs in parallel with collect-costs
788
+ agent: sales
789
+ prompt: "Collect the sales of {{payload.month}}"
790
+ - id: collect-costs
791
+ agent: finance
792
+ prompt: "Collect the costs of {{payload.month}}"
793
+ timeoutMs: 60000
794
+ - id: report
795
+ agent: analyst
796
+ prompt: "Write the month report"
797
+ after: [collect-sales, collect-costs]
798
+ gate: { approval: human } # stops until a person decides
799
+ - id: publish
800
+ agent: comms
801
+ prompt: "Send the report to the board"
802
+ after: [report]
803
+ when: { step: report, contains: "APPROVED" } # runs only if the report says so; otherwise skipped
804
+ compensation:
805
+ - on: report.failed
806
+ agent: comms
807
+ prompt: "Tell the board the report is delayed"
808
+ ```
809
+
810
+ ```typescript
811
+ import { loadFlow, runFlow, NdjsonRunJournal, MemoryApprovalStore } from '@backendkit-labs/agent-core';
812
+
813
+ const flow = await loadFlow('flows/close-month.yaml'); // parseFlow(yaml), loadFlowsFromDir(dir), validateFlow(def)
814
+ const result = await runFlow(flow, {
815
+ executor: { run: async (step, input) => ({ content: await myAgent(step.agent).run(input.prompt) }) },
816
+ payload: { month: '2026-10' }, // {{payload.x}} in prompts
817
+ journal: new NdjsonRunJournal('.flows'), // durable: survives the process (one file per run)
818
+ approvals: { store: new MemoryApprovalStore() }, // gate.approval: human (or a policy `ask`)
819
+ runId: 'close-2026-10',
820
+ maxConcurrency: 8, // per wave; `limiter` caps per agent/tenant across flows
821
+ });
822
+ result.status; // 'completed' | 'failed' | 'rejected' | 'cancelled' | 'awaiting_approval'
823
+ result.costUsd; // sum of the costUsd the steps reported (absent if none did)
824
+ ```
825
+
826
+ - **Conditional steps (0.44.0):** `when: { step, contains | equals | matches, not? }` runs a step only if the output of a step it waits for says so (`step` must be in `after`; `equals` ignores surrounding whitespace). A step whose condition does not hold, or cannot be evaluated because that step produced no output, is `skipped` before anything else: it does not run, **no approval is asked**, what waits for it is skipped too, and the flow does **not** fail. The skip is in `transitions` with the reason (`condition not met: report contains "APPROVED"`).
827
+ - **Waves and failure:** steps whose `after` are done run together. A failed step skips what depends on it (`onStepFailure: 'continue'` runs them without its output), then the `compensation` entries run. `timeoutMs` per step, `stepTimeoutMs` as a default.
828
+ - **Durable and resumable:** with a `journal` each step is written before and after it runs, one process holds the run (`claim`), and calling `runFlow` again with the same `runId` **resumes**: `done` steps are not run again. The claim is **renewed while the run lives** (every `claimRenewMs`, a third of `claimTtlMs` by default), so a run longer than the TTL is not taken over by another process; it expires only when this process stops. If a renewal finds the claim taken, the run stops and `runFlow` throws `FlowClaimError` without writing over the new owner (`claimRenewMs: 0` turns renewal off). A step the journal shows as `running` (the process died) runs again by default — at least once; `input.idempotencyKey` (`runId:stepId:attempt`) lets a step with an external effect be safe. `MemoryRunJournal`, `NdjsonRunJournal` (one `<runId>.ndjson` per run on one host, see below), `FileRunJournal` (one file per event; superseded by the ndjson one) and `RedisRunJournal` (in [`agent-flow-queue`](../flow-queue)) share one contract. The payload is not stored: pass it again when resuming.
829
+ - **`NdjsonRunJournal` (0.45.0, [SPEC-0024](../../docs/specs/SPEC-0024-journal-de-corridas-ndjson.md)):** the journal for runs that live on one host. One line per event, **chained** (each line carries a MAC of the one before, HMAC with `key` if you give one: a line removed, changed or added makes the run `JournalCorrupt` and the other runs are still served; `problems` says which), `fsync` after every event, and a write cut in the middle is ignored and cut off. It has **one writer per run**: if someone else writes to the file, this writer gets `JournalConflict`, and `runFlow` stops without writing more and throws `FlowClaimError`. The claim is a lock file with the pid of the process: a holder that **died** is relieved at once (no TTL to wait for, so no renewal either), one that is alive is respected however long it takes. Files are created readable by their owner only, and still hold step outputs as they are. It is about 3x faster to write and ~58x faster to read than `FileRunJournal`. It needs the processes to share a host: for several machines use `RedisRunJournal`. Limit: removing the *last* lines of a file leaves a valid chain.
830
+ - **Approval:** `gate.approval: human` or a `policy` that answers `ask` for `flow.step:<id>` stops the run as `awaiting_approval`; decide it and run again with the same `runId`. `when: 'after'` runs the step first and shows its output to the approver.
831
+ - **Plan with a model:** `planFlow(task, { agents, provider })` turns a task into a validated `FlowDefinition` (unknown agents, cycles and duplicate ids are rejected and the model is asked again); steps no agent covers come back in `unresolved`. A plan a model writes and a YAML file are the same object. `flowFromTaskPlan` and `flowFromStaticFlow` convert older shapes.
832
+ - **Serve and steer it:** `flowFromDefinition(def, opts)` + `createFlowHandler({ name: flow })` give the `flowHandler` an `AgentServer` takes (start, status, pause, resume, cancel). `createApprovalHandler(store)` gives the `approvalHandler` (list, get, decide). `createFlowTools({ flows, approvals, approver })` exposes both as tools for a model or an MCP server; `flow_cancel` and `approval_decide` are `destructive`, so the tool server needs an `authorize` or a `policy`, and a model-driven server should use `approver: { kind: 'service', id }` (it cannot satisfy an approval that needs a human).
833
+ - **Across processes:** [`@backendkit-labs/agent-flow-queue`](../flow-queue) provides a BullMQ `StepExecutor` (each step runs on a worker) and a Redis journal.
834
+
835
+ ---
836
+
778
837
  ## Advanced memory system
779
838
 
780
839
  Beyond session history, agents can use a three-layer persistent memory. Each layer is independently configurable and backed by a pluggable store.
@@ -4,7 +4,10 @@ import type { JournalRun } from './journal';
4
4
  import type { RunFlowOptions } from './run';
5
5
  /**
6
6
  * Hosts a `FlowDefinition` in a `FlowHost` (SPEC-0023 F4): a supervisor (Hermes) then starts, watches, pauses, resumes and
7
- * cancels it through the protocol without knowing it is a core flow. The input of `start` is the flow payload. Pausing
7
+ * cancels it through the protocol without knowing it is a core flow. The input of `start` is the flow payload. The run is keyed by the
8
+ * host's `flowRunId` (journal, approvals), so the id a supervisor sees is the id of the journal and of the approval of a gated step
9
+ * (`stepApprovalId(flowRunId, stepId)`). A step that waits for a person leaves the run `awaiting_approval` (not failed); once it is decided,
10
+ * `resume` goes on from the journal. This needs a `journal` in `opts`: without one there is nothing to go on from. Pausing
8
11
  * holds the steps not yet started; cancelling aborts the ones running and starts no more.
9
12
  */
10
13
  export declare function flowFromDefinition(def: FlowDefinition, opts: Omit<RunFlowOptions, 'payload' | 'signal' | 'checkpoint' | 'onTransition'>): InProcessFlow;
@@ -1 +1 @@
1
- {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/flow/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAA4B,MAAM,QAAQ,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,cAAc,CAAC,GAAG,aAAa,CA2BvJ;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,CAyBxH"}
1
+ {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/flow/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAA4B,MAAM,QAAQ,CAAC;AAEnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,cAAc,CAAC,GAAG,aAAa,CAiCvJ;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,CAyBxH"}
@@ -2,10 +2,15 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.flowFromDefinition = flowFromDefinition;
4
4
  exports.flowRunView = flowRunView;
5
+ const host_1 = require("./host");
6
+ const approval_1 = require("./approval");
5
7
  const run_1 = require("./run");
6
8
  /**
7
9
  * Hosts a `FlowDefinition` in a `FlowHost` (SPEC-0023 F4): a supervisor (Hermes) then starts, watches, pauses, resumes and
8
- * cancels it through the protocol without knowing it is a core flow. The input of `start` is the flow payload. Pausing
10
+ * cancels it through the protocol without knowing it is a core flow. The input of `start` is the flow payload. The run is keyed by the
11
+ * host's `flowRunId` (journal, approvals), so the id a supervisor sees is the id of the journal and of the approval of a gated step
12
+ * (`stepApprovalId(flowRunId, stepId)`). A step that waits for a person leaves the run `awaiting_approval` (not failed); once it is decided,
13
+ * `resume` goes on from the journal. This needs a `journal` in `opts`: without one there is nothing to go on from. Pausing
9
14
  * holds the steps not yet started; cancelling aborts the ones running and starts no more.
10
15
  */
11
16
  function flowFromDefinition(def, opts) {
@@ -14,6 +19,7 @@ function flowFromDefinition(def, opts) {
14
19
  run: async (input, control) => {
15
20
  const result = await (0, run_1.runFlow)(def, {
16
21
  ...opts,
22
+ runId: control.runId,
17
23
  payload: input,
18
24
  signal: control.signal,
19
25
  checkpoint: control.checkpoint,
@@ -28,12 +34,19 @@ function flowFromDefinition(def, opts) {
28
34
  control.mark(t.stepId, 'failed', t.detail);
29
35
  else if (t.event === 'skipped')
30
36
  control.mark(t.stepId, 'skipped');
37
+ else if (t.event === 'approval_requested')
38
+ control.mark(t.stepId, 'awaiting_approval');
31
39
  else if (t.event === 'rejected')
32
40
  control.mark(t.stepId, 'failed', 'rejected');
33
41
  },
34
42
  });
35
43
  if (result.status === 'cancelled')
36
44
  return undefined; // the host already reports it as cancelled
45
+ if (result.status === 'awaiting_approval') {
46
+ const asked = [...result.transitions].reverse().find(t => t.event === 'approval_requested');
47
+ if (asked)
48
+ throw new host_1.FlowAwaitingApproval(asked.stepId, (0, approval_1.stepApprovalId)(result.runId, asked.stepId));
49
+ }
37
50
  if (result.status !== 'completed') {
38
51
  const bad = Object.values(result.steps).find(s => s.status === 'failed' || s.status === 'rejected');
39
52
  throw new Error(bad ? `step "${bad.stepId}" ${bad.status}${bad.error ? `: ${bad.error}` : ''}` : `flow ${result.status}`);
@@ -1 +1 @@
1
- {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/flow/adapter.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/flow/adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { FlowCondition } from './types';
2
+ /** Text of a condition for the log: `decision contains "ENTER"`. */
3
+ export declare function describeCondition(c: FlowCondition): string;
4
+ /** Whether `output` (of the step the condition looks at) satisfies it. An invalid regular expression is never satisfied: `validateFlow` reports it. */
5
+ export declare function evaluateCondition(c: FlowCondition, output: string): boolean;
6
+ //# sourceMappingURL=condition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../src/flow/condition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,oEAAoE;AACpE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAI1D;AAED,uJAAuJ;AACvJ,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQ3E"}
@@ -0,0 +1,30 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.describeCondition = describeCondition;
4
+ exports.evaluateCondition = evaluateCondition;
5
+ /** Text of a condition for the log: `decision contains "ENTER"`. */
6
+ function describeCondition(c) {
7
+ if (c.contains !== undefined)
8
+ return `${c.step} ${c.not ? 'does not contain' : 'contains'} "${c.contains}"`;
9
+ if (c.equals !== undefined)
10
+ return `${c.step} ${c.not ? 'does not equal' : 'equals'} "${c.equals}"`;
11
+ return `${c.step} ${c.not ? 'does not match' : 'matches'} /${c.matches}/`;
12
+ }
13
+ /** Whether `output` (of the step the condition looks at) satisfies it. An invalid regular expression is never satisfied: `validateFlow` reports it. */
14
+ function evaluateCondition(c, output) {
15
+ let ok;
16
+ if (c.contains !== undefined)
17
+ ok = output.includes(c.contains);
18
+ else if (c.equals !== undefined)
19
+ ok = output.trim() === c.equals.trim();
20
+ else {
21
+ try {
22
+ ok = new RegExp(c.matches ?? '').test(output);
23
+ }
24
+ catch {
25
+ return false;
26
+ }
27
+ }
28
+ return c.not ? !ok : ok;
29
+ }
30
+ //# sourceMappingURL=condition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"condition.js","sourceRoot":"","sources":["../../src/flow/condition.ts"],"names":[],"mappings":";;AAGA,8CAIC;AAGD,8CAQC;AAhBD,oEAAoE;AACpE,SAAgB,iBAAiB,CAAC,CAAgB;IAC9C,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC;IAC5G,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;IACpG,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC;AAC9E,CAAC;AAED,uJAAuJ;AACvJ,SAAgB,iBAAiB,CAAC,CAAgB,EAAE,MAAc;IAC9D,IAAI,EAAW,CAAC;IAChB,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;QAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;SAC1D,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;SACnE,CAAC;QACF,IAAI,CAAC;YAAC,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;IAClF,CAAC;IACD,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC"}
@@ -11,6 +11,10 @@ import type { JournalRun, JournalRunStatus, NewJournalRun, RunJournal, RunPatch,
11
11
  export declare class FileRunJournal implements RunJournal {
12
12
  private readonly dir;
13
13
  private ready?;
14
+ /** The last append of each run in this process, for serialising them. */
15
+ private readonly tails;
16
+ /** Retries the race for the next number with a small jittered wait; only a lost race is retried, not a missing run or a disk error. */
17
+ private readonly retrier;
14
18
  constructor(dir: string);
15
19
  begin(run: NewJournalRun): Promise<void>;
16
20
  step(runId: string, stepId: string, patch: StepPatch): Promise<void>;
@@ -26,7 +30,15 @@ export declare class FileRunJournal implements RunJournal {
26
30
  private file;
27
31
  private names;
28
32
  private seqs;
33
+ /**
34
+ * The appends of one run go one after another within this process: a flow with a wide fan-out (dozens of steps finishing at
35
+ * once) would otherwise have them all racing for the same next number and run out of attempts. Between processes the race
36
+ * stays, and is settled by retrying with a little jitter.
37
+ */
29
38
  private append;
39
+ /** One try: find the next number and publish under it. Losing the race to another process is `AppendContended`, which is retried. */
40
+ private appendOnce;
41
+ private appendNow;
30
42
  private readJson;
31
43
  /** Write to a unique temporary file, then hard-link it under the final name (fails if it exists). */
32
44
  private publish;
@@ -1 +1 @@
1
- {"version":3,"file":"file-journal.d.ts","sourceRoot":"","sources":["../../src/flow/file-journal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAK5H;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,UAAU;IAGjC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,KAAK,CAAC,CAAmB;gBAEJ,GAAG,EAAE,MAAM;IAElC,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAwBzF,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAUnD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkB7G,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,IAAI;YAIE,KAAK;YAOL,IAAI;YAQJ,MAAM;YAgBN,QAAQ;IAItB,qGAAqG;YACvF,OAAO;CAcxB"}
1
+ {"version":3,"file":"file-journal.d.ts","sourceRoot":"","sources":["../../src/flow/file-journal.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAgB,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAU5H;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,UAAU;IAcjC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAbhC,OAAO,CAAC,KAAK,CAAC,CAAmB;IACjC,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,uIAAuI;IACvI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAOrB;gBAE0B,GAAG,EAAE,MAAM;IAElC,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAwBzF,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAUnD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkB7G,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,IAAI;YAIE,KAAK;YAOL,IAAI;IAQlB;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAUd,qIAAqI;YACvH,UAAU;YAWV,SAAS;YAOT,QAAQ;IAItB,qGAAqG;YACvF,OAAO;CAcxB"}
@@ -2,11 +2,18 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.FileRunJournal = void 0;
4
4
  const node_crypto_1 = require("node:crypto");
5
+ const retry_1 = require("@backendkit-labs/retry");
5
6
  const promises_1 = require("node:fs/promises");
6
7
  const node_path_1 = require("node:path");
7
8
  const journal_1 = require("./journal");
8
9
  const ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
9
10
  const SEQ_WIDTH = 8;
11
+ /** Attempts to take the next event number against other processes before giving up. */
12
+ const APPEND_ATTEMPTS = 100;
13
+ /** Another process published the number we were about to take. */
14
+ class AppendContended extends Error {
15
+ constructor() { super('contended'); this.name = 'AppendContended'; }
16
+ }
10
17
  /**
11
18
  * A run journal in a directory, with the technique of `FileApprovalStore`: every file is written under a temporary name and
12
19
  * published with a hard link, which fails if the target exists. So each write is atomic and exclusive across processes sharing
@@ -19,6 +26,17 @@ const SEQ_WIDTH = 8;
19
26
  class FileRunJournal {
20
27
  dir;
21
28
  ready;
29
+ /** The last append of each run in this process, for serialising them. */
30
+ tails = new Map();
31
+ /** Retries the race for the next number with a small jittered wait; only a lost race is retried, not a missing run or a disk error. */
32
+ retrier = new retry_1.RetryEngine({
33
+ name: 'file-journal:append',
34
+ defaultConfig: {
35
+ maxAttempts: APPEND_ATTEMPTS,
36
+ backoff: { type: 'exponential', baseDelay: 1, multiplier: 1.4, maxDelay: 25, jitter: 'full' },
37
+ retryIf: (p) => p.cause instanceof AppendContended,
38
+ },
39
+ });
22
40
  constructor(dir) {
23
41
  this.dir = dir;
24
42
  }
@@ -127,23 +145,42 @@ class FileRunJournal {
127
145
  .filter(n => Number.isInteger(n))
128
146
  .sort((a, b) => a - b);
129
147
  }
130
- async append(runId, ev) {
148
+ /**
149
+ * The appends of one run go one after another within this process: a flow with a wide fan-out (dozens of steps finishing at
150
+ * once) would otherwise have them all racing for the same next number and run out of attempts. Between processes the race
151
+ * stays, and is settled by retrying with a little jitter.
152
+ */
153
+ append(runId, ev) {
131
154
  this.checkId(runId);
132
- for (let attempt = 0; attempt < 20; attempt++) {
133
- const seqs = await this.seqs(runId, 'ev');
134
- if (seqs.length === 0)
135
- throw new Error(`run "${runId}" does not exist`);
136
- try {
137
- await this.publish(this.file(runId, 'ev', seqs[seqs.length - 1] + 1), JSON.stringify(ev));
138
- return;
139
- }
140
- catch (err) {
141
- if (err.alreadyExists)
142
- continue; // another writer took that number
143
- throw err;
144
- }
155
+ const previous = this.tails.get(runId) ?? Promise.resolve();
156
+ const result = previous.then(() => this.appendNow(runId, ev));
157
+ const tail = result.catch(() => undefined);
158
+ this.tails.set(runId, tail);
159
+ void tail.then(() => { if (this.tails.get(runId) === tail)
160
+ this.tails.delete(runId); });
161
+ return result;
162
+ }
163
+ /** One try: find the next number and publish under it. Losing the race to another process is `AppendContended`, which is retried. */
164
+ async appendOnce(runId, ev) {
165
+ const seqs = await this.seqs(runId, 'ev');
166
+ if (seqs.length === 0)
167
+ throw new Error(`run "${runId}" does not exist`);
168
+ try {
169
+ await this.publish(this.file(runId, 'ev', seqs[seqs.length - 1] + 1), JSON.stringify(ev));
145
170
  }
146
- throw new Error(`could not append to run "${runId}": too much contention`);
171
+ catch (err) {
172
+ if (err.alreadyExists)
173
+ throw new AppendContended(); // another process took that number
174
+ throw err;
175
+ }
176
+ }
177
+ async appendNow(runId, ev) {
178
+ const result = await this.retrier.execute(() => this.appendOnce(runId, ev));
179
+ if (result.ok)
180
+ return;
181
+ if (result.error.cause instanceof AppendContended)
182
+ throw new Error(`could not append to run "${runId}": too much contention`);
183
+ throw result.error.cause ?? new Error(result.error.message);
147
184
  }
148
185
  async readJson(path) {
149
186
  try {
@@ -1 +1 @@
1
- {"version":3,"file":"file-journal.js","sourceRoot":"","sources":["../../src/flow/file-journal.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"file-journal.js","sourceRoot":"","sources":["../../src/flow/file-journal.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAC1C,kDAAqD;AACrD,+CAAqF;AACrF,yCAAiC;AACjC,uCAAgD;AAGhD,MAAM,EAAE,GAAG,mCAAmC,CAAC;AAC/C,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,uFAAuF;AACvF,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,kEAAkE;AAClE,MAAM,eAAgB,SAAQ,KAAK;IAAG,gBAAgB,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC;CAAE;AAE5G;;;;;;;;GAQG;AACH,MAAa,cAAc;IAcM;IAbrB,KAAK,CAAoB;IACjC,yEAAyE;IACxD,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC1D,uIAAuI;IACtH,OAAO,GAAG,IAAI,mBAAW,CAAC;QACvC,IAAI,EAAE,qBAAqB;QAC3B,aAAa,EAAE;YACX,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;YAC7F,OAAO,EAAE,CAAC,CAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,YAAY,eAAe;SAC1E;KACJ,CAAC,CAAC;IAEH,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAE5C,KAAK,CAAC,KAAK,CAAC,GAAkB;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,KAAK,kBAAkB,CAAC,CAAC;QAC9E,MAAM,EAAE,GAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC;QAC9E,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAK,GAAmC,CAAC,aAAa;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,KAAK,kBAAkB,CAAC,CAAC;YAC7G,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,MAAc,EAAE,KAAgB;QACtD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAe;QACvC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,KAAa,EAAE,KAAa;QACnD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACT,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAA8C,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC3G,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK;oBAAE,OAAO,IAAI,CAAC;YACpG,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;YAClH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,IAAK,GAAmC,CAAC,aAAa;oBAAE,SAAS,CAAC,qCAAqC;gBACvG,MAAM,GAAG,CAAC;YACd,CAAC;YACD,OAAO,KAAK,IAAI,EAAE;gBACd,+GAA+G;gBAC/G,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAClI,CAAC,CAAC;QACN,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAa;QACnB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAe,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YAC1E,IAAI,EAAE;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAA,oBAAU,EAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAA0E;QACjF,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YAAC,KAAK,GAAG,MAAM,IAAA,kBAAO,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,GAAG,GAAiB,EAAE,CAAC;QAC7B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,IAAA,iBAAO,EAAC,CAAC,EAAE,MAAM,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,4EAA4E;IAEpE,OAAO,CAAC,EAAU;QACtB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IAChE,CAAC;IAEO,IAAI,CAAC,KAAa,EAAE,IAAoB,EAAE,GAAW;QACzD,OAAO,IAAA,gBAAI,EAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3F,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,IAAoB;QACnD,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YAAC,KAAK,GAAG,MAAM,IAAA,kBAAO,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC;QACnC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,IAAoB;QAClD,MAAM,MAAM,GAAG,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC;QACnC,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;aACzD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;aAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,KAAa,EAAE,EAAgB;QAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC5B,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxF,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,qIAAqI;IAC7H,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,EAAgB;QACpD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,kBAAkB,CAAC,CAAC;QACxE,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAK,GAAmC,CAAC,aAAa;gBAAE,MAAM,IAAI,eAAe,EAAE,CAAC,CAAC,mCAAmC;YACxH,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,EAAgB;QACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5E,IAAI,MAAM,CAAC,EAAE;YAAE,OAAO;QACtB,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,YAAY,eAAe;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,wBAAwB,CAAC,CAAC;QAC9H,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAI,IAAY;QAClC,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,mBAAQ,EAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,SAAS,CAAC;QAAC,CAAC;IAC7F,CAAC;IAED,qGAAqG;IAC7F,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,OAAe;QACjD,IAAI,CAAC,KAAK,KAAK,IAAA,gBAAK,EAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,KAAK,CAAC;QACjB,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,GAAG,IAAI,IAAA,yBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpF,MAAM,IAAA,oBAAS,EAAC,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC;YACD,MAAM,IAAA,eAAI,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACxH,MAAM,GAAG,CAAC;QACd,CAAC;gBAAS,CAAC;YACP,MAAM,IAAA,iBAAM,EAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;IACL,CAAC;CACJ;AArKD,wCAqKC"}
@@ -29,6 +29,8 @@ export interface FlowInfo {
29
29
  }
30
30
  /** What a flow gets to cooperate with its supervisor: stop when cancelled, wait while paused, and say which step it is on. */
31
31
  export interface FlowControl {
32
+ /** The id the host gave this run (the `flowRunId` a supervisor sees). A flow that keeps its own record (a journal, an approval) keys it by this id, so everyone talks about the same run. */
33
+ readonly runId: string;
32
34
  /** Aborted when the flow is cancelled. */
33
35
  readonly signal: AbortSignal;
34
36
  /** Starts a step: waits here while the flow is paused and throws if it was cancelled. The previous step is marked done. */
@@ -45,6 +47,16 @@ export interface InProcessFlow {
45
47
  /** Does the work. Return its result; a throw is a failed flow (unless it was cancelled). */
46
48
  run(input: Record<string, unknown>, control: FlowControl): Promise<unknown>;
47
49
  }
50
+ /**
51
+ * What `run` throws when the flow stopped because a person has to decide (not a failure): the run shows as `awaiting_approval` with the step
52
+ * and the approval in its view. `resume` runs the flow again with the same `flowRunId`: a flow that keeps its progress (`runFlow` with a journal)
53
+ * goes on where it stopped, and stops here again if the decision is still missing.
54
+ */
55
+ export declare class FlowAwaitingApproval extends Error {
56
+ readonly stepId: string;
57
+ readonly approvalId: string;
58
+ constructor(stepId: string, approvalId: string);
59
+ }
48
60
  export declare class FlowCancelled extends Error {
49
61
  constructor();
50
62
  }
@@ -67,6 +79,7 @@ export declare class FlowHost {
67
79
  start(flow: string, input: Record<string, unknown>): Promise<{
68
80
  flowRunId: string;
69
81
  }>;
82
+ private launch;
70
83
  private finish;
71
84
  private live;
72
85
  status(flowRunId: string): Promise<FlowRunView>;
@@ -1 +1 @@
1
- {"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/flow/host.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/flow/host.ts"],"names":[],"mappings":"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"}
package/dist/flow/host.js CHANGED
@@ -1,7 +1,23 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.FlowHost = exports.FlowHostError = exports.FlowCancelled = void 0;
3
+ exports.FlowHost = exports.FlowHostError = exports.FlowCancelled = exports.FlowAwaitingApproval = void 0;
4
4
  const node_crypto_1 = require("node:crypto");
5
+ /**
6
+ * What `run` throws when the flow stopped because a person has to decide (not a failure): the run shows as `awaiting_approval` with the step
7
+ * and the approval in its view. `resume` runs the flow again with the same `flowRunId`: a flow that keeps its progress (`runFlow` with a journal)
8
+ * goes on where it stopped, and stops here again if the decision is still missing.
9
+ */
10
+ class FlowAwaitingApproval extends Error {
11
+ stepId;
12
+ approvalId;
13
+ constructor(stepId, approvalId) {
14
+ super(`step "${stepId}" awaits approval ${approvalId}`);
15
+ this.stepId = stepId;
16
+ this.approvalId = approvalId;
17
+ this.name = 'FlowAwaitingApproval';
18
+ }
19
+ }
20
+ exports.FlowAwaitingApproval = FlowAwaitingApproval;
5
21
  class FlowCancelled extends Error {
6
22
  constructor() { super('flow cancelled'); this.name = 'FlowCancelled'; }
7
23
  }
@@ -41,7 +57,7 @@ class FlowHost {
41
57
  flowRunId: (0, node_crypto_1.randomUUID)(), flow, status: 'running', startedAt: new Date().toISOString(),
42
58
  steps: (def.steps ?? []).map((name) => ({ name, status: 'pending' })),
43
59
  };
44
- const live = { state, controller, paused: false, settled: Promise.resolve() };
60
+ const live = { def, input, state, controller, paused: false, settled: Promise.resolve() };
45
61
  const checkpoint = async () => {
46
62
  while (live.paused && !controller.signal.aborted) {
47
63
  await new Promise(resolve => { live.resume = resolve; });
@@ -50,6 +66,7 @@ class FlowHost {
50
66
  throw new FlowCancelled();
51
67
  };
52
68
  const control = {
69
+ runId: state.flowRunId,
53
70
  signal: controller.signal,
54
71
  checkpoint,
55
72
  mark: (name, status, detail) => {
@@ -83,12 +100,33 @@ class FlowHost {
83
100
  state.currentStep = name;
84
101
  },
85
102
  };
86
- live.settled = Promise.resolve()
87
- .then(() => def.run(input, control))
88
- .then(output => controller.signal.aborted ? this.finish(live, 'cancelled', {}) : this.finish(live, 'done', { output: typeof output === 'string' ? output : JSON.stringify(output) ?? '' }), err => this.finish(live, controller.signal.aborted ? 'cancelled' : 'failed', controller.signal.aborted ? {} : { error: err instanceof Error ? err.message : String(err) }));
103
+ live.control = control;
104
+ this.launch(live);
89
105
  this.runs.set(state.flowRunId, live);
90
106
  return { flowRunId: state.flowRunId };
91
107
  }
108
+ launch(live) {
109
+ const { controller, state } = live;
110
+ live.settled = Promise.resolve()
111
+ .then(() => live.def.run(live.input, live.control))
112
+ .then(output => controller.signal.aborted ? this.finish(live, 'cancelled', {}) : this.finish(live, 'done', { output: typeof output === 'string' ? output : JSON.stringify(output) ?? '' }), err => {
113
+ if (controller.signal.aborted)
114
+ return this.finish(live, 'cancelled', {});
115
+ if (err instanceof FlowAwaitingApproval) {
116
+ const step = state.steps.find(s => s.name === err.stepId);
117
+ if (step) {
118
+ step.status = 'awaiting_approval';
119
+ step.detail = `approval ${err.approvalId}`;
120
+ }
121
+ else
122
+ state.steps.push({ name: err.stepId, status: 'awaiting_approval', detail: `approval ${err.approvalId}` });
123
+ state.status = 'awaiting_approval';
124
+ state.currentStep = err.stepId;
125
+ return;
126
+ }
127
+ this.finish(live, 'failed', { error: err instanceof Error ? err.message : String(err) });
128
+ });
129
+ }
92
130
  finish(live, status, extra) {
93
131
  const { state } = live;
94
132
  if (state.status === 'cancelled' || state.status === 'done' || state.status === 'failed')
@@ -122,13 +160,25 @@ class FlowHost {
122
160
  }
123
161
  async resume(flowRunId) {
124
162
  const live = this.live(flowRunId);
163
+ if (live.state.status === 'awaiting_approval') {
164
+ // the flow runs again with the same run id; whatever it kept (a journal) tells it where to go on
165
+ live.state.status = 'running';
166
+ for (const s of live.state.steps)
167
+ if (s.status === 'awaiting_approval') {
168
+ s.status = 'pending';
169
+ delete s.detail;
170
+ }
171
+ delete live.state.currentStep;
172
+ this.launch(live);
173
+ return this.status(flowRunId);
174
+ }
125
175
  live.paused = false;
126
176
  live.resume?.();
127
177
  return this.status(flowRunId);
128
178
  }
129
179
  async cancel(flowRunId) {
130
180
  const live = this.live(flowRunId);
131
- if (live.state.status === 'running') {
181
+ if (live.state.status === 'running' || live.state.status === 'awaiting_approval') {
132
182
  live.controller.abort();
133
183
  live.paused = false;
134
184
  live.resume?.();
@@ -1 +1 @@
1
- {"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/flow/host.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/flow/host.ts"],"names":[],"mappings":"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"}
@@ -1,7 +1,7 @@
1
1
  export { FlowTriggerSchema, FlowGateSchema, FlowStepSchema, FlowCompensationSchema, FlowDefinitionSchema, } from './types';
2
- export type { FlowTrigger, FlowGate, FlowStep, FlowCompensation, FlowDefinition, FlowTransition, FlowTransitionEvent } from './types';
2
+ export type { FlowTrigger, FlowGate, FlowCondition, FlowStep, FlowCompensation, FlowDefinition, FlowTransition, FlowTransitionEvent } from './types';
3
3
  export { parseFlow, loadFlow, loadFlowsFromDir, validateFlow, FlowLoadError } from './loader';
4
- export { FlowHost, FlowCancelled, FlowHostError } from './host';
4
+ export { FlowHost, FlowCancelled, FlowHostError, FlowAwaitingApproval } from './host';
5
5
  export type { FlowControl, FlowInfo, FlowRunView, FlowStatus, FlowStepView, InProcessFlow } from './host';
6
6
  export { createFlowHandler, FlowControlError } from './handler';
7
7
  export type { FlowHandlerPort } from './handler';
@@ -10,7 +10,9 @@ export type { StepExecutor, StepInput, StepOutput, FlowResult, FlowStepResult, F
10
10
  export { KeyedConcurrencyLimiter } from './limiter';
11
11
  export type { ConcurrencyLimiter, KeyedLimiterOptions } from './limiter';
12
12
  export { interpolate } from './interpolate';
13
- export { MemoryRunJournal, foldEvents, matches as journalMatches } from './journal';
13
+ export { MemoryRunJournal, foldEvents, matches as journalMatches, JournalCorrupt, JournalConflict } from './journal';
14
+ export { NdjsonRunJournal } from './ndjson-journal';
15
+ export type { NdjsonRunJournalOptions } from './ndjson-journal';
14
16
  export type { JournalEvent, RunJournal, JournalRun, JournalStep, JournalStepStatus, JournalRunStatus, NewJournalRun, StepPatch, RunPatch, } from './journal';
15
17
  export { FileRunJournal } from './file-journal';
16
18
  export { flowFromDefinition, flowRunView } from './adapter';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,GAClG,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACtI,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAChD,YAAY,EACR,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,GACtI,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AACpF,YAAY,EACR,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,GAC7H,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACpG,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAClI,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,GAClG,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACrJ,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACtF,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAChD,YAAY,EACR,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,GACtI,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,OAAO,IAAI,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACrH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EACR,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,GAC7H,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACpG,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAClI,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}