@backendkit-labs/agent-core 0.44.0 → 0.46.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.
- package/README.md +5 -3
- package/dist/engine/AgentEngine.d.ts +5 -0
- package/dist/engine/AgentEngine.d.ts.map +1 -1
- package/dist/engine/AgentEngine.js +56 -3
- package/dist/engine/AgentEngine.js.map +1 -1
- package/dist/engine/toolSearch.d.ts +18 -0
- package/dist/engine/toolSearch.d.ts.map +1 -0
- package/dist/engine/toolSearch.js +72 -0
- package/dist/engine/toolSearch.js.map +1 -0
- package/dist/flow/adapter.d.ts +4 -1
- package/dist/flow/adapter.d.ts.map +1 -1
- package/dist/flow/adapter.js +14 -1
- package/dist/flow/adapter.js.map +1 -1
- package/dist/flow/file-journal.d.ts +12 -0
- package/dist/flow/file-journal.d.ts.map +1 -1
- package/dist/flow/file-journal.js +52 -15
- package/dist/flow/file-journal.js.map +1 -1
- package/dist/flow/host.d.ts +13 -0
- package/dist/flow/host.d.ts.map +1 -1
- package/dist/flow/host.js +56 -6
- package/dist/flow/host.js.map +1 -1
- package/dist/flow/index.d.ts +4 -2
- package/dist/flow/index.d.ts.map +1 -1
- package/dist/flow/index.js +6 -1
- package/dist/flow/index.js.map +1 -1
- package/dist/flow/journal.d.ts +13 -0
- package/dist/flow/journal.d.ts.map +1 -1
- package/dist/flow/journal.js +24 -1
- package/dist/flow/journal.js.map +1 -1
- package/dist/flow/ndjson-journal.d.ts +46 -0
- package/dist/flow/ndjson-journal.d.ts.map +1 -0
- package/dist/flow/ndjson-journal.js +311 -0
- package/dist/flow/ndjson-journal.js.map +1 -0
- package/dist/flow/run.d.ts.map +1 -1
- package/dist/flow/run.js +53 -5
- package/dist/flow/run.js.map +1 -1
- package/dist/flow/tools.d.ts +4 -0
- package/dist/flow/tools.d.ts.map +1 -1
- package/dist/flow/tools.js +25 -0
- package/dist/flow/tools.js.map +1 -1
- package/dist/index.d.ts +2 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -2
- package/dist/index.js.map +1 -1
- package/dist/testing/index.d.ts +3 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +7 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/testing/journalConformance.d.ts +39 -0
- package/dist/testing/journalConformance.d.ts.map +1 -0
- package/dist/testing/journalConformance.js +286 -0
- package/dist/testing/journalConformance.js.map +1 -0
- package/dist/tools/defineTool.d.ts +2 -0
- package/dist/tools/defineTool.d.ts.map +1 -1
- package/dist/tools/defineTool.js +1 -0
- package/dist/tools/defineTool.js.map +1 -1
- package/dist/types/index.d.ts +11 -0
- package/dist/types/index.d.ts.map +1 -1
- package/package.json +103 -94
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.TOOL_SEARCH_DEFAULT_RESULTS = exports.TOOL_SEARCH_NAME = void 0;
|
|
4
|
+
exports.matchesDeferPattern = matchesDeferPattern;
|
|
5
|
+
exports.isDeferred = isDeferred;
|
|
6
|
+
exports.toolSearchDefinition = toolSearchDefinition;
|
|
7
|
+
exports.scoreTool = scoreTool;
|
|
8
|
+
exports.rankTools = rankTools;
|
|
9
|
+
exports.describeFound = describeFound;
|
|
10
|
+
/**
|
|
11
|
+
* Deferred tools and `tool_search` (SPEC-0030). A deferred tool is left out of the model's tool list until the model finds it by
|
|
12
|
+
* name or description. Searching only looks among tools the agent may already call: finding a tool authorizes nothing.
|
|
13
|
+
*/
|
|
14
|
+
exports.TOOL_SEARCH_NAME = 'tool_search';
|
|
15
|
+
exports.TOOL_SEARCH_DEFAULT_RESULTS = 5;
|
|
16
|
+
/** `crm_find` matches `crm_find` and `crm_*`; a lone `*` matches every tool. */
|
|
17
|
+
function matchesDeferPattern(name, patterns) {
|
|
18
|
+
return patterns.some(p => (p.endsWith('*') ? name.startsWith(p.slice(0, -1)) : name === p));
|
|
19
|
+
}
|
|
20
|
+
function isDeferred(tool, profile) {
|
|
21
|
+
return tool.defer === true || (profile.deferTools !== undefined && matchesDeferPattern(tool.name, profile.deferTools));
|
|
22
|
+
}
|
|
23
|
+
/** The tool the engine offers to an agent that has deferred tools. The engine fills in `execute` with the agent's own context. */
|
|
24
|
+
function toolSearchDefinition(execute) {
|
|
25
|
+
return {
|
|
26
|
+
name: exports.TOOL_SEARCH_NAME,
|
|
27
|
+
description: 'Finds tools that are not listed yet. Describe what you need to do in a few words; the tools that match are returned ' +
|
|
28
|
+
'and become available to call from your next step.',
|
|
29
|
+
parameters: {
|
|
30
|
+
type: 'object',
|
|
31
|
+
properties: { query: { type: 'string', description: 'What you need to do, or part of a tool name' } },
|
|
32
|
+
required: ['query'],
|
|
33
|
+
},
|
|
34
|
+
// Searching changes nothing: the default policy lets it through, an explicit one still sees it.
|
|
35
|
+
readOnly: true,
|
|
36
|
+
execute,
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
const words = (text) => text.toLowerCase().split(/[^a-z0-9]+/).filter(w => w.length > 1);
|
|
40
|
+
/** Word score over name and description: a word in the name weighs more than one in the description. Zero means no match. */
|
|
41
|
+
function scoreTool(queryWords, tool) {
|
|
42
|
+
const nameWords = words(tool.name);
|
|
43
|
+
const name = tool.name.toLowerCase();
|
|
44
|
+
const description = tool.description.toLowerCase();
|
|
45
|
+
let score = 0;
|
|
46
|
+
for (const w of queryWords) {
|
|
47
|
+
if (nameWords.includes(w))
|
|
48
|
+
score += 4;
|
|
49
|
+
else if (name.includes(w))
|
|
50
|
+
score += 2;
|
|
51
|
+
if (description.includes(w))
|
|
52
|
+
score += 1;
|
|
53
|
+
}
|
|
54
|
+
return score;
|
|
55
|
+
}
|
|
56
|
+
/** The best matches, best first; ties keep the order of `candidates`. */
|
|
57
|
+
function rankTools(query, candidates, max) {
|
|
58
|
+
const q = words(query);
|
|
59
|
+
return candidates
|
|
60
|
+
.map((tool, i) => ({ tool, i, score: scoreTool(q, tool) }))
|
|
61
|
+
.filter(r => r.score > 0)
|
|
62
|
+
.sort((a, b) => b.score - a.score || a.i - b.i)
|
|
63
|
+
.slice(0, Math.max(1, max))
|
|
64
|
+
.map(r => r.tool);
|
|
65
|
+
}
|
|
66
|
+
function describeFound(found) {
|
|
67
|
+
if (found.length === 0)
|
|
68
|
+
return 'No tool matches. Try other words, or a part of the tool name.';
|
|
69
|
+
const lines = found.map(t => `- ${t.name}: ${t.description.replace(/\s+/g, ' ').slice(0, 200)}`);
|
|
70
|
+
return `${found.length === 1 ? '1 tool is' : `${found.length} tools are`} now available to call:\n${lines.join('\n')}`;
|
|
71
|
+
}
|
|
72
|
+
//# sourceMappingURL=toolSearch.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"toolSearch.js","sourceRoot":"","sources":["../../src/engine/toolSearch.ts"],"names":[],"mappings":"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"}
|
package/dist/flow/adapter.d.ts
CHANGED
|
@@ -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.
|
|
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;
|
|
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"}
|
package/dist/flow/adapter.js
CHANGED
|
@@ -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.
|
|
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}`);
|
package/dist/flow/adapter.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/flow/adapter.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/flow/adapter.ts"],"names":[],"mappings":"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"}
|
|
@@ -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":"
|
|
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
|
-
|
|
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
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
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
|
-
|
|
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":";;;AAAA,6CAA0C;AAC1C,+CAAqF;AACrF,yCAAiC;AACjC,uCAAgD;AAGhD,MAAM,EAAE,GAAG,mCAAmC,CAAC;AAC/C,MAAM,SAAS,GAAG,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"file-journal.js","sourceRoot":"","sources":["../../src/flow/file-journal.ts"],"names":[],"mappings":"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"}
|
package/dist/flow/host.d.ts
CHANGED
|
@@ -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>;
|
package/dist/flow/host.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/flow/host.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,8GAA8G;AAC9G,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAE/G,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,mBAAmB,GAAG,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAEpK,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;AAElF,8HAA8H;AAC9H,MAAM,WAAW,WAAW;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,2HAA2H;IAC3H,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,yFAAyF;IACzF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,4GAA4G;IAC5G,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7E;AAED,MAAM,WAAW,aAAa;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uGAAuG;IACvG,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,4FAA4F;IAC5F,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E;AAED,qBAAa,aAAc,SAAQ,KAAK;;CAEvC;AAED,kIAAkI;AAClI,qBAAa,aAAc,SAAQ,KAAK;IACxB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,sBAAsB;gBAA9C,IAAI,EAAE,eAAe,GAAG,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAIvF;
|
|
1
|
+
{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/flow/host.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,8GAA8G;AAC9G,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAE/G,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,mBAAmB,GAAG,aAAa,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAEpK,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;AAElF,8HAA8H;AAC9H,MAAM,WAAW,WAAW;IACxB,6LAA6L;IAC7L,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,2HAA2H;IAC3H,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,yFAAyF;IACzF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,4GAA4G;IAC5G,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7E;AAED,MAAM,WAAW,aAAa;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uGAAuG;IACvG,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,4FAA4F;IAC5F,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAA3C,MAAM,EAAE,MAAM,EAAW,UAAU,EAAE,MAAM;CAInE;AAED,qBAAa,aAAc,SAAQ,KAAK;;CAEvC;AAED,kIAAkI;AAClI,qBAAa,aAAc,SAAQ,KAAK;IACxB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,sBAAsB;gBAA9C,IAAI,EAAE,eAAe,GAAG,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAIvF;AAaD;;;;GAIG;AACH,qBAAa,QAAQ;IAGL,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAiC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAFjG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;gBAEnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAAmB,aAAa,SAAO;IAElG,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI3B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IA6CzF,OAAO,CAAC,MAAM;IAqBd,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,IAAI;IAMN,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAK/C,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAM9C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAe/C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAcrD,iEAAiE;IAC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}
|
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.
|
|
87
|
-
|
|
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?.();
|
package/dist/flow/host.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/flow/host.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;
|
|
1
|
+
{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/flow/host.ts"],"names":[],"mappings":"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"}
|
package/dist/flow/index.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
export { FlowTriggerSchema, FlowGateSchema, FlowStepSchema, FlowCompensationSchema, FlowDefinitionSchema, } from './types';
|
|
2
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';
|
package/dist/flow/index.d.ts.map
CHANGED
|
@@ -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,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,MAAM,QAAQ,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"}
|
package/dist/flow/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.UNRESOLVED_AGENT = exports.PLANNER_SYSTEM = exports.planFlow = exports.createFlowTools = exports.ApprovalControlError = exports.summarizeApproval = exports.createApprovalHandler = exports.flowFromStaticFlow = exports.flowFromTaskPlan = exports.stepApprovalId = exports.decideStepApproval = exports.flowRunView = exports.flowFromDefinition = exports.FileRunJournal = exports.journalMatches = exports.foldEvents = exports.MemoryRunJournal = exports.interpolate = exports.KeyedConcurrencyLimiter = exports.FlowClaimError = exports.runFlow = exports.FlowControlError = exports.createFlowHandler = exports.FlowHostError = exports.FlowCancelled = exports.FlowHost = exports.FlowLoadError = exports.validateFlow = exports.loadFlowsFromDir = exports.loadFlow = exports.parseFlow = exports.FlowDefinitionSchema = exports.FlowCompensationSchema = exports.FlowStepSchema = exports.FlowGateSchema = exports.FlowTriggerSchema = void 0;
|
|
3
|
+
exports.UNRESOLVED_AGENT = exports.PLANNER_SYSTEM = exports.planFlow = exports.createFlowTools = exports.ApprovalControlError = exports.summarizeApproval = exports.createApprovalHandler = exports.flowFromStaticFlow = exports.flowFromTaskPlan = exports.stepApprovalId = exports.decideStepApproval = exports.flowRunView = exports.flowFromDefinition = exports.FileRunJournal = exports.NdjsonRunJournal = exports.JournalConflict = exports.JournalCorrupt = exports.journalMatches = exports.foldEvents = exports.MemoryRunJournal = exports.interpolate = exports.KeyedConcurrencyLimiter = exports.FlowClaimError = exports.runFlow = exports.FlowControlError = exports.createFlowHandler = exports.FlowAwaitingApproval = exports.FlowHostError = exports.FlowCancelled = exports.FlowHost = exports.FlowLoadError = exports.validateFlow = exports.loadFlowsFromDir = exports.loadFlow = exports.parseFlow = exports.FlowDefinitionSchema = exports.FlowCompensationSchema = exports.FlowStepSchema = exports.FlowGateSchema = exports.FlowTriggerSchema = void 0;
|
|
4
4
|
var types_1 = require("./types");
|
|
5
5
|
Object.defineProperty(exports, "FlowTriggerSchema", { enumerable: true, get: function () { return types_1.FlowTriggerSchema; } });
|
|
6
6
|
Object.defineProperty(exports, "FlowGateSchema", { enumerable: true, get: function () { return types_1.FlowGateSchema; } });
|
|
@@ -17,6 +17,7 @@ var host_1 = require("./host");
|
|
|
17
17
|
Object.defineProperty(exports, "FlowHost", { enumerable: true, get: function () { return host_1.FlowHost; } });
|
|
18
18
|
Object.defineProperty(exports, "FlowCancelled", { enumerable: true, get: function () { return host_1.FlowCancelled; } });
|
|
19
19
|
Object.defineProperty(exports, "FlowHostError", { enumerable: true, get: function () { return host_1.FlowHostError; } });
|
|
20
|
+
Object.defineProperty(exports, "FlowAwaitingApproval", { enumerable: true, get: function () { return host_1.FlowAwaitingApproval; } });
|
|
20
21
|
var handler_1 = require("./handler");
|
|
21
22
|
Object.defineProperty(exports, "createFlowHandler", { enumerable: true, get: function () { return handler_1.createFlowHandler; } });
|
|
22
23
|
Object.defineProperty(exports, "FlowControlError", { enumerable: true, get: function () { return handler_1.FlowControlError; } });
|
|
@@ -31,6 +32,10 @@ var journal_1 = require("./journal");
|
|
|
31
32
|
Object.defineProperty(exports, "MemoryRunJournal", { enumerable: true, get: function () { return journal_1.MemoryRunJournal; } });
|
|
32
33
|
Object.defineProperty(exports, "foldEvents", { enumerable: true, get: function () { return journal_1.foldEvents; } });
|
|
33
34
|
Object.defineProperty(exports, "journalMatches", { enumerable: true, get: function () { return journal_1.matches; } });
|
|
35
|
+
Object.defineProperty(exports, "JournalCorrupt", { enumerable: true, get: function () { return journal_1.JournalCorrupt; } });
|
|
36
|
+
Object.defineProperty(exports, "JournalConflict", { enumerable: true, get: function () { return journal_1.JournalConflict; } });
|
|
37
|
+
var ndjson_journal_1 = require("./ndjson-journal");
|
|
38
|
+
Object.defineProperty(exports, "NdjsonRunJournal", { enumerable: true, get: function () { return ndjson_journal_1.NdjsonRunJournal; } });
|
|
34
39
|
var file_journal_1 = require("./file-journal");
|
|
35
40
|
Object.defineProperty(exports, "FileRunJournal", { enumerable: true, get: function () { return file_journal_1.FileRunJournal; } });
|
|
36
41
|
var adapter_1 = require("./adapter");
|
package/dist/flow/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":";;;AAAA,iCAEiB;AADb,0GAAA,iBAAiB,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,+GAAA,sBAAsB,OAAA;AAAE,6GAAA,oBAAoB,OAAA;AAGnG,mCAA8F;AAArF,mGAAA,SAAS,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,uGAAA,aAAa,OAAA;AAC3E,+
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":";;;AAAA,iCAEiB;AADb,0GAAA,iBAAiB,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,+GAAA,sBAAsB,OAAA;AAAE,6GAAA,oBAAoB,OAAA;AAGnG,mCAA8F;AAArF,mGAAA,SAAS,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,uGAAA,aAAa,OAAA;AAC3E,+BAAsF;AAA7E,gGAAA,QAAQ,OAAA;AAAE,qGAAA,aAAa,OAAA;AAAE,qGAAA,aAAa,OAAA;AAAE,4GAAA,oBAAoB,OAAA;AAErE,qCAAgE;AAAvD,4GAAA,iBAAiB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAE5C,6BAAgD;AAAvC,8FAAA,OAAO,OAAA;AAAE,qGAAA,cAAc,OAAA;AAIhC,qCAAoD;AAA3C,kHAAA,uBAAuB,OAAA;AAEhC,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,qCAAqH;AAA5G,2GAAA,gBAAgB,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,yGAAA,OAAO,OAAkB;AAAE,yGAAA,cAAc,OAAA;AAAE,0GAAA,eAAe,OAAA;AACjG,mDAAoD;AAA3C,kHAAA,gBAAgB,OAAA;AAKzB,+CAAgD;AAAvC,8GAAA,cAAc,OAAA;AACvB,qCAA4D;AAAnD,6GAAA,kBAAkB,OAAA;AAAE,sGAAA,WAAW,OAAA;AACxC,uCAAgE;AAAvD,8GAAA,kBAAkB,OAAA;AAAE,0GAAA,cAAc,OAAA;AAE3C,qCAAiE;AAAxD,2GAAA,gBAAgB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAE7C,uDAAoG;AAA3F,yHAAA,qBAAqB,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAAE,wHAAA,oBAAoB,OAAA;AAEvE,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AAExB,qCAAuE;AAA9D,mGAAA,QAAQ,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,2GAAA,gBAAgB,OAAA"}
|