@backendkit-labs/agent-core 0.41.0 → 0.43.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 +27 -0
- package/dist/engine/AgentEngine.d.ts +22 -2
- package/dist/engine/AgentEngine.d.ts.map +1 -1
- package/dist/engine/AgentEngine.js +92 -48
- package/dist/engine/AgentEngine.js.map +1 -1
- package/dist/engine/createBaseEngine.d.ts +2 -0
- package/dist/engine/createBaseEngine.d.ts.map +1 -1
- package/dist/engine/createBaseEngine.js +21 -4
- package/dist/engine/createBaseEngine.js.map +1 -1
- package/dist/engine/error-code.d.ts +7 -0
- package/dist/engine/error-code.d.ts.map +1 -0
- package/dist/engine/error-code.js +23 -0
- package/dist/engine/error-code.js.map +1 -0
- package/dist/engine/run-recorder.d.ts +13 -0
- package/dist/engine/run-recorder.d.ts.map +1 -0
- package/dist/engine/run-recorder.js +49 -0
- package/dist/engine/run-recorder.js.map +1 -0
- package/dist/flow/adapter.d.ts +20 -0
- package/dist/flow/adapter.d.ts.map +1 -0
- package/dist/flow/adapter.js +81 -0
- package/dist/flow/adapter.js.map +1 -0
- package/dist/flow/approval-handler.d.ts +59 -0
- package/dist/flow/approval-handler.d.ts.map +1 -0
- package/dist/flow/approval-handler.js +79 -0
- package/dist/flow/approval-handler.js.map +1 -0
- package/dist/flow/approval.d.ts +39 -0
- package/dist/flow/approval.d.ts.map +1 -0
- package/dist/flow/approval.js +58 -0
- package/dist/flow/approval.js.map +1 -0
- package/dist/flow/convert.d.ts +44 -0
- package/dist/flow/convert.d.ts.map +1 -0
- package/dist/flow/convert.js +34 -0
- package/dist/flow/convert.js.map +1 -0
- package/dist/flow/file-journal.d.ts +34 -0
- package/dist/flow/file-journal.d.ts.map +1 -0
- package/dist/flow/file-journal.js +176 -0
- package/dist/flow/file-journal.js.map +1 -0
- package/dist/flow/handler.d.ts +35 -0
- package/dist/flow/handler.d.ts.map +1 -0
- package/dist/flow/handler.js +51 -0
- package/dist/flow/handler.js.map +1 -0
- package/dist/flow/host.d.ts +79 -0
- package/dist/flow/host.d.ts.map +1 -0
- package/dist/flow/host.js +148 -0
- package/dist/flow/host.js.map +1 -0
- package/dist/flow/index.d.ts +27 -0
- package/dist/flow/index.d.ts.map +1 -0
- package/dist/flow/index.js +55 -0
- package/dist/flow/index.js.map +1 -0
- package/dist/flow/interpolate.d.ts +6 -0
- package/dist/flow/interpolate.d.ts.map +1 -0
- package/dist/flow/interpolate.js +18 -0
- package/dist/flow/interpolate.js.map +1 -0
- package/dist/flow/journal.d.ts +105 -0
- package/dist/flow/journal.d.ts.map +1 -0
- package/dist/flow/journal.js +89 -0
- package/dist/flow/journal.js.map +1 -0
- package/dist/flow/limiter.d.ts +21 -0
- package/dist/flow/limiter.d.ts.map +1 -0
- package/dist/flow/limiter.js +45 -0
- package/dist/flow/limiter.js.map +1 -0
- package/dist/flow/loader.d.ts +24 -0
- package/dist/flow/loader.d.ts.map +1 -0
- package/dist/flow/loader.js +172 -0
- package/dist/flow/loader.js.map +1 -0
- package/dist/flow/planner.d.ts +50 -0
- package/dist/flow/planner.d.ts.map +1 -0
- package/dist/flow/planner.js +131 -0
- package/dist/flow/planner.js.map +1 -0
- package/dist/flow/run.d.ts +106 -0
- package/dist/flow/run.d.ts.map +1 -0
- package/dist/flow/run.js +354 -0
- package/dist/flow/run.js.map +1 -0
- package/dist/flow/tools.d.ts +27 -0
- package/dist/flow/tools.d.ts.map +1 -0
- package/dist/flow/tools.js +71 -0
- package/dist/flow/tools.js.map +1 -0
- package/dist/flow/types.d.ts +112 -0
- package/dist/flow/types.d.ts.map +1 -0
- package/dist/flow/types.js +63 -0
- package/dist/flow/types.js.map +1 -0
- package/dist/governance/types.d.ts +6 -0
- package/dist/governance/types.d.ts.map +1 -1
- package/dist/index.d.ts +21 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +53 -3
- package/dist/index.js.map +1 -1
- package/dist/learning/index.d.ts +2 -1
- package/dist/learning/index.d.ts.map +1 -1
- package/dist/learning/index.js +339 -63
- package/dist/learning/index.js.map +1 -1
- package/dist/learning/signal.d.ts +69 -0
- package/dist/learning/signal.d.ts.map +1 -0
- package/dist/learning/signal.js +201 -0
- package/dist/learning/signal.js.map +1 -0
- package/dist/learning/types.d.ts +203 -1
- package/dist/learning/types.d.ts.map +1 -1
- package/dist/learning/units.d.ts +46 -0
- package/dist/learning/units.d.ts.map +1 -0
- package/dist/learning/units.js +137 -0
- package/dist/learning/units.js.map +1 -0
- package/dist/tools/defineTool.d.ts +4 -1
- package/dist/tools/defineTool.d.ts.map +1 -1
- package/dist/tools/defineTool.js +5 -2
- package/dist/tools/defineTool.js.map +1 -1
- package/dist/tools/services.d.ts +13 -0
- package/dist/tools/services.d.ts.map +1 -1
- package/dist/tools/services.js +12 -0
- package/dist/tools/services.js.map +1 -1
- package/dist/tools/tool-error.d.ts +19 -0
- package/dist/tools/tool-error.d.ts.map +1 -0
- package/dist/tools/tool-error.js +33 -0
- package/dist/tools/tool-error.js.map +1 -0
- package/dist/types/index.d.ts +39 -0
- package/dist/types/index.d.ts.map +1 -1
- package/package.json +94 -89
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { FlowDefinition } from './types';
|
|
2
|
+
import type { InProcessFlow, FlowRunView } from './host';
|
|
3
|
+
import type { JournalRun } from './journal';
|
|
4
|
+
import type { RunFlowOptions } from './run';
|
|
5
|
+
/**
|
|
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
|
|
8
|
+
* holds the steps not yet started; cancelling aborts the ones running and starts no more.
|
|
9
|
+
*/
|
|
10
|
+
export declare function flowFromDefinition(def: FlowDefinition, opts: Omit<RunFlowOptions, 'payload' | 'signal' | 'checkpoint' | 'onTransition'>): InProcessFlow;
|
|
11
|
+
/**
|
|
12
|
+
* Projects a journal record to the `FlowRunState` vocabulary of the protocol (SPEC-0023 §4.1). For a supervisor that speaks 1.1
|
|
13
|
+
* (`protocolMinor` below 2, the default) `awaiting_approval` shows as `paused` and `lost` as `failed`, with the reason in
|
|
14
|
+
* `detail`/`error`; from 1.2 on they are sent as they are, and so are the step states `awaiting_approval` and `interrupted`.
|
|
15
|
+
* `stepOrder` (the flow's step ids) gives the steps their declared order.
|
|
16
|
+
*/
|
|
17
|
+
export declare function flowRunView(run: JournalRun, stepOrder?: string[], options?: {
|
|
18
|
+
protocolMinor?: number;
|
|
19
|
+
}): FlowRunView;
|
|
20
|
+
//# sourceMappingURL=adapter.d.ts.map
|
|
@@ -0,0 +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"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.flowFromDefinition = flowFromDefinition;
|
|
4
|
+
exports.flowRunView = flowRunView;
|
|
5
|
+
const run_1 = require("./run");
|
|
6
|
+
/**
|
|
7
|
+
* 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
|
|
9
|
+
* holds the steps not yet started; cancelling aborts the ones running and starts no more.
|
|
10
|
+
*/
|
|
11
|
+
function flowFromDefinition(def, opts) {
|
|
12
|
+
return {
|
|
13
|
+
steps: def.steps.map(s => s.id),
|
|
14
|
+
run: async (input, control) => {
|
|
15
|
+
const result = await (0, run_1.runFlow)(def, {
|
|
16
|
+
...opts,
|
|
17
|
+
payload: input,
|
|
18
|
+
signal: control.signal,
|
|
19
|
+
checkpoint: control.checkpoint,
|
|
20
|
+
onTransition: t => {
|
|
21
|
+
if (t.stepId.includes(':compensation'))
|
|
22
|
+
return;
|
|
23
|
+
if (t.event === 'started')
|
|
24
|
+
control.mark(t.stepId, 'running');
|
|
25
|
+
else if (t.event === 'completed')
|
|
26
|
+
control.mark(t.stepId, 'done');
|
|
27
|
+
else if (t.event === 'failed')
|
|
28
|
+
control.mark(t.stepId, 'failed', t.detail);
|
|
29
|
+
else if (t.event === 'skipped')
|
|
30
|
+
control.mark(t.stepId, 'skipped');
|
|
31
|
+
else if (t.event === 'rejected')
|
|
32
|
+
control.mark(t.stepId, 'failed', 'rejected');
|
|
33
|
+
},
|
|
34
|
+
});
|
|
35
|
+
if (result.status === 'cancelled')
|
|
36
|
+
return undefined; // the host already reports it as cancelled
|
|
37
|
+
if (result.status !== 'completed') {
|
|
38
|
+
const bad = Object.values(result.steps).find(s => s.status === 'failed' || s.status === 'rejected');
|
|
39
|
+
throw new Error(bad ? `step "${bad.stepId}" ${bad.status}${bad.error ? `: ${bad.error}` : ''}` : `flow ${result.status}`);
|
|
40
|
+
}
|
|
41
|
+
const last = def.steps[def.steps.length - 1];
|
|
42
|
+
return result.steps[last.id]?.content ?? '';
|
|
43
|
+
},
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Projects a journal record to the `FlowRunState` vocabulary of the protocol (SPEC-0023 §4.1). For a supervisor that speaks 1.1
|
|
48
|
+
* (`protocolMinor` below 2, the default) `awaiting_approval` shows as `paused` and `lost` as `failed`, with the reason in
|
|
49
|
+
* `detail`/`error`; from 1.2 on they are sent as they are, and so are the step states `awaiting_approval` and `interrupted`.
|
|
50
|
+
* `stepOrder` (the flow's step ids) gives the steps their declared order.
|
|
51
|
+
*/
|
|
52
|
+
function flowRunView(run, stepOrder, options = {}) {
|
|
53
|
+
const native = (options.protocolMinor ?? 1) >= 2;
|
|
54
|
+
const status = native ? run.status
|
|
55
|
+
: run.status === 'awaiting_approval' ? 'paused' : run.status === 'lost' ? 'failed' : run.status;
|
|
56
|
+
const ids = [...new Set([...(stepOrder ?? []), ...Object.keys(run.steps)])];
|
|
57
|
+
const steps = ids.map((name) => {
|
|
58
|
+
const j = run.steps[name];
|
|
59
|
+
if (!j)
|
|
60
|
+
return { name, status: 'pending' };
|
|
61
|
+
if (!native && j.status === 'awaiting_approval')
|
|
62
|
+
return { name, status: 'running', detail: 'awaiting approval' };
|
|
63
|
+
if (!native && j.status === 'interrupted')
|
|
64
|
+
return { name, status: 'failed', detail: j.error ?? 'interrupted' };
|
|
65
|
+
return { name, status: j.status, ...(j.error ? { detail: j.error } : {}) };
|
|
66
|
+
});
|
|
67
|
+
const current = run.waiting?.stepId ?? steps.find(s => s.status === 'running')?.name;
|
|
68
|
+
const last = stepOrder?.length ? run.steps[stepOrder[stepOrder.length - 1]] : undefined;
|
|
69
|
+
return {
|
|
70
|
+
flowRunId: run.runId,
|
|
71
|
+
flow: run.flow,
|
|
72
|
+
status,
|
|
73
|
+
...(current ? { currentStep: current } : {}),
|
|
74
|
+
steps,
|
|
75
|
+
startedAt: run.startedAt,
|
|
76
|
+
...(run.finishedAt ? { finishedAt: run.finishedAt } : {}),
|
|
77
|
+
...(status === 'done' && last?.output !== undefined ? { output: last.output } : {}),
|
|
78
|
+
...(run.status === 'lost' && !native ? { error: 'lost' } : run.error ? { error: run.error } : {}),
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
//# sourceMappingURL=adapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/flow/adapter.ts"],"names":[],"mappings":";;AAWA,gDA2BC;AAQD,kCAyBC;AApED,+BAAgC;AAGhC;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,GAAmB,EAAE,IAAgF;IACpI,OAAO;QACH,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAA,aAAO,EAAC,GAAG,EAAE;gBAC9B,GAAG,IAAI;gBACP,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,YAAY,EAAE,CAAC,CAAC,EAAE;oBACd,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC;wBAAE,OAAO;oBAC/C,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;wBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;yBACxD,IAAI,CAAC,CAAC,KAAK,KAAK,WAAW;wBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;yBAC5D,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ;wBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;yBACrE,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;wBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;yBAC7D,IAAI,CAAC,CAAC,KAAK,KAAK,UAAU;wBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAClF,CAAC;aACJ,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;gBAAE,OAAO,SAAS,CAAC,CAAC,2CAA2C;YAChG,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAChC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;gBACpG,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9H,CAAC;YACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC7C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;QAChD,CAAC;KACJ,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,GAAe,EAAE,SAAoB,EAAE,UAAsC,EAAE;IACvG,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,MAAM,GAAe,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM;QAC1C,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;IACpG,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAmB,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAgB,EAAE;QACzD,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,mBAAmB;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QACjH,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,aAAa,EAAE,CAAC;QAC/G,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/E,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,IAAI,CAAC;IACrF,MAAM,IAAI,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,OAAO;QACH,SAAS,EAAE,GAAG,CAAC,KAAK;QACpB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM;QACN,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,KAAK;QACL,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpG,CAAC;AACN,CAAC"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import type { ApprovalStatus, ApprovalStore, ApproverKind, ApproverRef, StoredApproval } from '../governance/types';
|
|
2
|
+
/**
|
|
3
|
+
* The approvals of an agent as the `approvalHandler` an `AgentServer` takes (`ApprovalHandler` of `@backendkit-labs/agent-protocol`,
|
|
4
|
+
* protocol 1.2), declared here with the same shape so that core depends on no transport (SPEC-0023 F6c). A supervisor, a console or an
|
|
5
|
+
* MCP client then sees what waits for a person and decides it.
|
|
6
|
+
*/
|
|
7
|
+
export interface ApprovalSummaryView {
|
|
8
|
+
id: string;
|
|
9
|
+
status: ApprovalStatus;
|
|
10
|
+
subject: {
|
|
11
|
+
kind: string;
|
|
12
|
+
[key: string]: unknown;
|
|
13
|
+
};
|
|
14
|
+
reason: string;
|
|
15
|
+
approver?: string;
|
|
16
|
+
accepts?: ApproverKind[];
|
|
17
|
+
requestedBy: {
|
|
18
|
+
agentId: string;
|
|
19
|
+
sessionId?: string;
|
|
20
|
+
tenantId?: string;
|
|
21
|
+
};
|
|
22
|
+
createdAt: string;
|
|
23
|
+
outcome?: {
|
|
24
|
+
decision: 'approve' | 'reject';
|
|
25
|
+
by: ApproverRef;
|
|
26
|
+
reason?: string;
|
|
27
|
+
at: string;
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
export interface ApprovalDecisionInput {
|
|
31
|
+
decision: 'approve' | 'reject';
|
|
32
|
+
reason?: string;
|
|
33
|
+
by: ApproverRef;
|
|
34
|
+
}
|
|
35
|
+
export interface ApprovalHandlerPort {
|
|
36
|
+
list(filter: {
|
|
37
|
+
status?: ApprovalStatus;
|
|
38
|
+
}): Promise<ApprovalSummaryView[]>;
|
|
39
|
+
get(id: string): Promise<ApprovalSummaryView>;
|
|
40
|
+
decide(id: string, decision: ApprovalDecisionInput, context?: unknown): Promise<ApprovalSummaryView>;
|
|
41
|
+
}
|
|
42
|
+
/** A refusal with a protocol code. `AgentServer` recognises it by `name` and `code`. */
|
|
43
|
+
export declare class ApprovalControlError extends Error {
|
|
44
|
+
readonly code: 'TASK_NOT_FOUND' | 'CONFLICT' | 'FORBIDDEN';
|
|
45
|
+
constructor(code: 'TASK_NOT_FOUND' | 'CONFLICT' | 'FORBIDDEN', message: string);
|
|
46
|
+
}
|
|
47
|
+
export interface ApprovalHandlerOptions {
|
|
48
|
+
/** Can this agent approver do the action itself? Default: no (SPEC-0014 §6.2 rule 3), so only humans and services decide. */
|
|
49
|
+
canAgentAct?: (by: ApproverRef, request: StoredApproval) => Promise<boolean>;
|
|
50
|
+
/**
|
|
51
|
+
* Called after a decision is recorded, for the host to continue what waited for it: for a flow step, run the flow again with the
|
|
52
|
+
* same `runId`. A throw here does not undo the decision.
|
|
53
|
+
*/
|
|
54
|
+
onDecided?: (approval: StoredApproval) => void | Promise<void>;
|
|
55
|
+
}
|
|
56
|
+
/** What a reviewer sees. A tool call shows the tool and its arguments, not the whole definition. */
|
|
57
|
+
export declare function summarizeApproval(a: StoredApproval): ApprovalSummaryView;
|
|
58
|
+
export declare function createApprovalHandler(store: ApprovalStore, options?: ApprovalHandlerOptions): ApprovalHandlerPort;
|
|
59
|
+
//# sourceMappingURL=approval-handler.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"approval-handler.d.ts","sourceRoot":"","sources":["../../src/flow/approval-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrI;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;QAAC,EAAE,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9F;AAED,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACxG;AAED,wFAAwF;AACxF,qBAAa,oBAAqB,SAAQ,KAAK;IAC/B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,UAAU,GAAG,WAAW;gBAAjD,IAAI,EAAE,gBAAgB,GAAG,UAAU,GAAG,WAAW,EAAE,OAAO,EAAE,MAAM;CAI1F;AAED,MAAM,WAAW,sBAAsB;IACnC,6HAA6H;IAC7H,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,oGAAoG;AACpG,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,cAAc,GAAG,mBAAmB,CAkBxE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,sBAA2B,GAAG,mBAAmB,CA+BrH"}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ApprovalControlError = void 0;
|
|
4
|
+
exports.summarizeApproval = summarizeApproval;
|
|
5
|
+
exports.createApprovalHandler = createApprovalHandler;
|
|
6
|
+
const approval_1 = require("../governance/approval");
|
|
7
|
+
/** A refusal with a protocol code. `AgentServer` recognises it by `name` and `code`. */
|
|
8
|
+
class ApprovalControlError extends Error {
|
|
9
|
+
code;
|
|
10
|
+
constructor(code, message) {
|
|
11
|
+
super(message);
|
|
12
|
+
this.code = code;
|
|
13
|
+
this.name = 'ControlError';
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
exports.ApprovalControlError = ApprovalControlError;
|
|
17
|
+
/** What a reviewer sees. A tool call shows the tool and its arguments, not the whole definition. */
|
|
18
|
+
function summarizeApproval(a) {
|
|
19
|
+
const s = a.subject;
|
|
20
|
+
const subject = s.kind === 'tool_call' && 'call' in s
|
|
21
|
+
? { kind: 'tool_call', tool: s.call.tool.name, args: s.call.args }
|
|
22
|
+
: { ...s };
|
|
23
|
+
return {
|
|
24
|
+
id: a.id,
|
|
25
|
+
status: a.status,
|
|
26
|
+
subject,
|
|
27
|
+
reason: a.reason,
|
|
28
|
+
...(a.approver ? { approver: a.approver } : {}),
|
|
29
|
+
...(a.accepts ? { accepts: a.accepts } : {}),
|
|
30
|
+
requestedBy: {
|
|
31
|
+
agentId: a.principal.agentId, sessionId: a.principal.sessionId, ...(a.principal.tenantId ? { tenantId: a.principal.tenantId } : {}),
|
|
32
|
+
},
|
|
33
|
+
createdAt: a.createdAt,
|
|
34
|
+
...(a.outcome ? { outcome: { decision: a.outcome.decision, by: a.outcome.by, ...(a.outcome.reason ? { reason: a.outcome.reason } : {}), at: a.outcome.at } } : {}),
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
function createApprovalHandler(store, options = {}) {
|
|
38
|
+
const find = async (id) => {
|
|
39
|
+
let found;
|
|
40
|
+
try {
|
|
41
|
+
found = await store.get(id);
|
|
42
|
+
}
|
|
43
|
+
catch { /* an id the store refuses is an id it does not have */ }
|
|
44
|
+
if (!found)
|
|
45
|
+
throw new ApprovalControlError('TASK_NOT_FOUND', `approval ${id} not found`);
|
|
46
|
+
return found;
|
|
47
|
+
};
|
|
48
|
+
return {
|
|
49
|
+
list: async (filter) => (await store.list(filter.status ? { status: filter.status } : {})).map(summarizeApproval),
|
|
50
|
+
get: async (id) => summarizeApproval(await find(id)),
|
|
51
|
+
decide: async (id, d) => {
|
|
52
|
+
const request = await find(id);
|
|
53
|
+
if (request.status !== 'pending')
|
|
54
|
+
throw new ApprovalControlError('CONFLICT', `approval ${id} was already decided (${request.status})`);
|
|
55
|
+
const outcome = {
|
|
56
|
+
decision: d.decision, by: d.by, ...(d.reason ? { reason: d.reason } : {}), at: new Date().toISOString(),
|
|
57
|
+
};
|
|
58
|
+
// An answer that breaks the rules (wrong kind of approver, one's own request) is refused, not recorded as a rejection:
|
|
59
|
+
// the approver is told, and the request stays open for someone who may decide it.
|
|
60
|
+
const problem = await (0, approval_1.approvalProblem)(outcome, request, async (by) => options.canAgentAct?.(by, request) ?? false);
|
|
61
|
+
if (problem)
|
|
62
|
+
throw new ApprovalControlError('FORBIDDEN', problem);
|
|
63
|
+
let stored;
|
|
64
|
+
try {
|
|
65
|
+
stored = await store.resolve(id, outcome);
|
|
66
|
+
}
|
|
67
|
+
catch (err) {
|
|
68
|
+
// Another decision won the race: the store accepts one per id.
|
|
69
|
+
throw new ApprovalControlError('CONFLICT', err.message);
|
|
70
|
+
}
|
|
71
|
+
try {
|
|
72
|
+
await options.onDecided?.(stored);
|
|
73
|
+
}
|
|
74
|
+
catch { /* the decision stands */ }
|
|
75
|
+
return summarizeApproval(stored);
|
|
76
|
+
},
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
//# sourceMappingURL=approval-handler.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"approval-handler.js","sourceRoot":"","sources":["../../src/flow/approval-handler.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import type { ApprovalStore, Approver, ApproverRef, Identity, ToolPolicy } from '../governance/types';
|
|
2
|
+
import type { FlowStep } from './types';
|
|
3
|
+
/**
|
|
4
|
+
* Approval of a flow step through the `ApprovalStore` of SPEC-0014 (SPEC-0023 F5). A step needs approval when its gate says
|
|
5
|
+
* `approval: human`, or when the `policy` decides `ask` for the pseudo tool `flow.step:<stepId>` (which is how a learned rule
|
|
6
|
+
* can put a step behind a person). The request is stored with a deterministic id, so resuming the run finds the answer.
|
|
7
|
+
*/
|
|
8
|
+
export interface FlowApprovals {
|
|
9
|
+
store: ApprovalStore;
|
|
10
|
+
/** Who the flow acts for. The agent is the step's agent and the session is the run. */
|
|
11
|
+
identity?: Identity;
|
|
12
|
+
chain?: string[];
|
|
13
|
+
/** Decides per step; `ask` stops it for approval, `deny` fails it. No policy: only `gate.approval: human` asks. */
|
|
14
|
+
policy?: ToolPolicy;
|
|
15
|
+
/** Answers in process (a CLI, a connected UI). Without one the run stops with `awaiting_approval` until someone resolves the store. */
|
|
16
|
+
approver?: Approver;
|
|
17
|
+
/**
|
|
18
|
+
* `before` (default): the person approves the ACTION and the step runs after. `after`: the step runs, its output is shown to
|
|
19
|
+
* the approver (it is in the request) and the steps that follow wait for the decision; a rejection fails the step.
|
|
20
|
+
*/
|
|
21
|
+
when?: 'before' | 'after';
|
|
22
|
+
/** Can this agent approver do the step itself? Default: no (SPEC-0014 §6.2 rule 3). */
|
|
23
|
+
canAgentAct?: (by: ApproverRef, step: FlowStep) => Promise<boolean>;
|
|
24
|
+
}
|
|
25
|
+
export type StepApproval = {
|
|
26
|
+
kind: 'proceed';
|
|
27
|
+
} | {
|
|
28
|
+
kind: 'rejected';
|
|
29
|
+
reason: string;
|
|
30
|
+
} | {
|
|
31
|
+
kind: 'denied';
|
|
32
|
+
reason: string;
|
|
33
|
+
} | {
|
|
34
|
+
kind: 'pending';
|
|
35
|
+
approvalId: string;
|
|
36
|
+
};
|
|
37
|
+
export declare function stepApprovalId(runId: string, stepId: string): string;
|
|
38
|
+
export declare function decideStepApproval(a: FlowApprovals, flow: string, runId: string, step: FlowStep, previous: Record<string, string>, output?: string): Promise<StepApproval>;
|
|
39
|
+
//# sourceMappingURL=approval.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/flow/approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAC0B,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAa,UAAU,EAC1G,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,mHAAmH;IACnH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,uIAAuI;IACvI,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B,uFAAuF;IACvF,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvE;AAED,MAAM,MAAM,YAAY,GAClB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAsB,kBAAkB,CACpC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GACjH,OAAO,CAAC,YAAY,CAAC,CA4CvB"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.stepApprovalId = stepApprovalId;
|
|
4
|
+
exports.decideStepApproval = decideStepApproval;
|
|
5
|
+
const approval_1 = require("../governance/approval");
|
|
6
|
+
function stepApprovalId(runId, stepId) {
|
|
7
|
+
return `${runId}-${stepId}`.replace(/[^A-Za-z0-9_-]/g, '_').slice(0, 128);
|
|
8
|
+
}
|
|
9
|
+
async function decideStepApproval(a, flow, runId, step, previous, output) {
|
|
10
|
+
const principal = { agentId: step.agent, sessionId: runId, chain: a.chain ?? [], ...(a.identity ?? {}) };
|
|
11
|
+
const human = step.gate?.approval === 'human';
|
|
12
|
+
let reason = human ? `step "${step.id}" of flow "${flow}" requires human approval` : '';
|
|
13
|
+
let approver;
|
|
14
|
+
let accepts = human ? ['human'] : undefined;
|
|
15
|
+
if (a.policy) {
|
|
16
|
+
const d = await a.policy.decide(principal, {
|
|
17
|
+
tool: { name: `flow.step:${step.id}`, description: `step "${step.id}" of flow "${flow}"`, parameters: { type: 'object', properties: {} }, execute: async () => '' },
|
|
18
|
+
args: { input: previous, ...(output !== undefined ? { output } : {}) },
|
|
19
|
+
});
|
|
20
|
+
if (d.effect === 'deny')
|
|
21
|
+
return { kind: 'denied', reason: d.reason };
|
|
22
|
+
if (d.effect === 'ask') {
|
|
23
|
+
reason = d.reason;
|
|
24
|
+
approver = d.approver;
|
|
25
|
+
if (d.accepts)
|
|
26
|
+
accepts = human && !d.accepts.includes('human') ? ['human'] : d.accepts;
|
|
27
|
+
}
|
|
28
|
+
else if (!human) {
|
|
29
|
+
return { kind: 'proceed' };
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
else if (!human) {
|
|
33
|
+
return { kind: 'proceed' };
|
|
34
|
+
}
|
|
35
|
+
const id = stepApprovalId(runId, step.id);
|
|
36
|
+
let stored = await a.store.get(id);
|
|
37
|
+
if (!stored) {
|
|
38
|
+
const req = {
|
|
39
|
+
id, principal, subject: { kind: 'workflow_step', workflow: flow, step: step.id, input: output !== undefined ? { previous, output } : previous },
|
|
40
|
+
reason, ...(approver ? { approver } : {}), ...(accepts ? { accepts } : {}), createdAt: new Date().toISOString(),
|
|
41
|
+
};
|
|
42
|
+
await a.store.put(req);
|
|
43
|
+
stored = await a.store.get(id);
|
|
44
|
+
}
|
|
45
|
+
if (stored && stored.status === 'pending' && a.approver) {
|
|
46
|
+
const outcome = await a.approver.request(stored);
|
|
47
|
+
const problem = await (0, approval_1.approvalProblem)(outcome, stored, async (by) => a.canAgentAct?.(by, step) ?? false);
|
|
48
|
+
stored = await a.store.resolve(id, problem
|
|
49
|
+
? { decision: 'reject', by: outcome.by ?? { kind: 'service', id: 'engine' }, reason: problem, at: new Date().toISOString() }
|
|
50
|
+
: outcome);
|
|
51
|
+
}
|
|
52
|
+
if (!stored || stored.status === 'pending')
|
|
53
|
+
return { kind: 'pending', approvalId: id };
|
|
54
|
+
if (stored.status === 'rejected')
|
|
55
|
+
return { kind: 'rejected', reason: stored.outcome?.reason ?? 'rejected' };
|
|
56
|
+
return { kind: 'proceed' }; // approved, or executed on a previous attempt
|
|
57
|
+
}
|
|
58
|
+
//# sourceMappingURL=approval.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../src/flow/approval.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { FlowDefinition } from './types';
|
|
2
|
+
/**
|
|
3
|
+
* Plans and static flows as `FlowDefinition` (SPEC-0023 F6a). A plan a planner generates and a flow written in YAML are the same
|
|
4
|
+
* object once converted: both run on `runFlow`. The inputs are structural types, so core needs no planner or orchestrator package.
|
|
5
|
+
*
|
|
6
|
+
* `gate: true` is a person reviewing the step's OUTPUT (`gate.approval: 'human'`); run it with `approvals.when: 'after'`.
|
|
7
|
+
* `gate_criteria` only count when the step is gated, as before.
|
|
8
|
+
*/
|
|
9
|
+
export interface PlanStepLike {
|
|
10
|
+
id: string;
|
|
11
|
+
agent_id: string;
|
|
12
|
+
task: string;
|
|
13
|
+
depends_on?: string[];
|
|
14
|
+
gate?: boolean;
|
|
15
|
+
gate_criteria?: string[];
|
|
16
|
+
timeout_ms?: number;
|
|
17
|
+
}
|
|
18
|
+
export interface TaskPlanLike {
|
|
19
|
+
summary: string;
|
|
20
|
+
subtasks: PlanStepLike[];
|
|
21
|
+
}
|
|
22
|
+
export interface StaticFlowLike {
|
|
23
|
+
id: string;
|
|
24
|
+
name?: string;
|
|
25
|
+
version?: number;
|
|
26
|
+
steps: Array<{
|
|
27
|
+
id: string;
|
|
28
|
+
agent: string;
|
|
29
|
+
task: string;
|
|
30
|
+
depends_on?: string[];
|
|
31
|
+
gate?: boolean;
|
|
32
|
+
gate_criteria?: string[];
|
|
33
|
+
}>;
|
|
34
|
+
}
|
|
35
|
+
/** A plan generated for one task: an ephemeral flow with a manual trigger. */
|
|
36
|
+
export declare function flowFromTaskPlan(plan: TaskPlanLike, opts?: {
|
|
37
|
+
flow?: string;
|
|
38
|
+
version?: number;
|
|
39
|
+
}): FlowDefinition;
|
|
40
|
+
/** A flow file of the orchestrator (`flows/*.yaml`, already parsed). `{{payload.key}}` placeholders pass through unchanged. */
|
|
41
|
+
export declare function flowFromStaticFlow(f: StaticFlowLike, opts?: {
|
|
42
|
+
trigger?: FlowDefinition['trigger'];
|
|
43
|
+
}): FlowDefinition;
|
|
44
|
+
//# sourceMappingURL=convert.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/flow/convert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QACT,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC,CAAC;CACN;AAMD,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,cAAc,CAWnH;AAED,+HAA+H;AAC/H,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;CAAO,GAAG,cAAc,CAUxH"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.flowFromTaskPlan = flowFromTaskPlan;
|
|
4
|
+
exports.flowFromStaticFlow = flowFromStaticFlow;
|
|
5
|
+
const types_1 = require("./types");
|
|
6
|
+
function gateOf(gate, criteria) {
|
|
7
|
+
return gate ? { gate: { criteria: criteria ?? [], evidence: 'optional', approval: 'human' } } : {};
|
|
8
|
+
}
|
|
9
|
+
/** A plan generated for one task: an ephemeral flow with a manual trigger. */
|
|
10
|
+
function flowFromTaskPlan(plan, opts = {}) {
|
|
11
|
+
return types_1.FlowDefinitionSchema.parse({
|
|
12
|
+
flow: opts.flow ?? (plan.summary.trim() || 'plan'),
|
|
13
|
+
version: opts.version ?? 1,
|
|
14
|
+
trigger: { type: 'manual' },
|
|
15
|
+
steps: plan.subtasks.map(s => ({
|
|
16
|
+
id: s.id, agent: s.agent_id, prompt: s.task, after: s.depends_on ?? [],
|
|
17
|
+
...gateOf(s.gate, s.gate_criteria),
|
|
18
|
+
...(s.timeout_ms !== undefined ? { timeoutMs: s.timeout_ms } : {}),
|
|
19
|
+
})),
|
|
20
|
+
});
|
|
21
|
+
}
|
|
22
|
+
/** A flow file of the orchestrator (`flows/*.yaml`, already parsed). `{{payload.key}}` placeholders pass through unchanged. */
|
|
23
|
+
function flowFromStaticFlow(f, opts = {}) {
|
|
24
|
+
return types_1.FlowDefinitionSchema.parse({
|
|
25
|
+
flow: f.id,
|
|
26
|
+
version: f.version ?? 1,
|
|
27
|
+
trigger: opts.trigger ?? { type: 'manual' },
|
|
28
|
+
steps: f.steps.map(s => ({
|
|
29
|
+
id: s.id, agent: s.agent, prompt: s.task, after: s.depends_on ?? [],
|
|
30
|
+
...gateOf(s.gate, s.gate_criteria),
|
|
31
|
+
})),
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=convert.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../src/flow/convert.ts"],"names":[],"mappings":";;AA6CA,4CAWC;AAGD,gDAUC;AArED,mCAA+C;AAwC/C,SAAS,MAAM,CAAC,IAAyB,EAAE,QAA8B;IACrE,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvG,CAAC;AAED,8EAA8E;AAC9E,SAAgB,gBAAgB,CAAC,IAAkB,EAAE,OAA4C,EAAE;IAC/F,OAAO,4BAAoB,CAAC,KAAK,CAAC;QAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC;QAClD,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,CAAC;QAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3B,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;YACtE,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC;YAClC,GAAG,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC,CAAC;KACN,CAAC,CAAC;AACP,CAAC;AAED,+HAA+H;AAC/H,SAAgB,kBAAkB,CAAC,CAAiB,EAAE,OAAgD,EAAE;IACpG,OAAO,4BAAoB,CAAC,KAAK,CAAC;QAC9B,IAAI,EAAE,CAAC,CAAC,EAAE;QACV,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrB,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;YACnE,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC;SACrC,CAAC,CAAC;KACN,CAAC,CAAC;AACP,CAAC"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import type { JournalRun, JournalRunStatus, NewJournalRun, RunJournal, RunPatch, StepPatch } from './journal';
|
|
2
|
+
/**
|
|
3
|
+
* A run journal in a directory, with the technique of `FileApprovalStore`: every file is written under a temporary name and
|
|
4
|
+
* published with a hard link, which fails if the target exists. So each write is atomic and exclusive across processes sharing
|
|
5
|
+
* the directory, and a crash never leaves a half-written file under a final name.
|
|
6
|
+
*
|
|
7
|
+
* - `<runId>.ev.<seq>.json`: the events of the run, append-only; the run is rebuilt by folding them in order.
|
|
8
|
+
* - `<runId>.claim.<n>.json`: the claims. The current one is the highest `n`; taking over an expired one means publishing
|
|
9
|
+
* `n+1`, which only one contender can do. Nothing is ever deleted or overwritten, so no lock is needed.
|
|
10
|
+
*/
|
|
11
|
+
export declare class FileRunJournal implements RunJournal {
|
|
12
|
+
private readonly dir;
|
|
13
|
+
private ready?;
|
|
14
|
+
constructor(dir: string);
|
|
15
|
+
begin(run: NewJournalRun): Promise<void>;
|
|
16
|
+
step(runId: string, stepId: string, patch: StepPatch): Promise<void>;
|
|
17
|
+
update(runId: string, patch: RunPatch): Promise<void>;
|
|
18
|
+
claim(runId: string, owner: string, ttlMs: number): Promise<(() => Promise<void>) | null>;
|
|
19
|
+
get(runId: string): Promise<JournalRun | undefined>;
|
|
20
|
+
list(filter?: {
|
|
21
|
+
status?: JournalRunStatus[];
|
|
22
|
+
flow?: string;
|
|
23
|
+
tenantId?: string;
|
|
24
|
+
}): Promise<JournalRun[]>;
|
|
25
|
+
private checkId;
|
|
26
|
+
private file;
|
|
27
|
+
private names;
|
|
28
|
+
private seqs;
|
|
29
|
+
private append;
|
|
30
|
+
private readJson;
|
|
31
|
+
/** Write to a unique temporary file, then hard-link it under the final name (fails if it exists). */
|
|
32
|
+
private publish;
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=file-journal.d.ts.map
|
|
@@ -0,0 +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"}
|