@polpo-ai/core 0.8.1 → 0.10.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/dist/approval-manager.d.ts +1 -0
- package/dist/approval-manager.d.ts.map +1 -1
- package/dist/approval-manager.js +7 -9
- package/dist/approval-manager.js.map +1 -1
- package/dist/index.d.ts +12 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -0
- package/dist/index.js.map +1 -1
- package/dist/loop/contract.test.d.ts +2 -0
- package/dist/loop/contract.test.d.ts.map +1 -0
- package/dist/loop/contract.test.js +106 -0
- package/dist/loop/contract.test.js.map +1 -0
- package/dist/loop/expression.d.ts +29 -0
- package/dist/loop/expression.d.ts.map +1 -0
- package/dist/loop/expression.js +215 -0
- package/dist/loop/expression.js.map +1 -0
- package/dist/loop/expression.test.d.ts +2 -0
- package/dist/loop/expression.test.d.ts.map +1 -0
- package/dist/loop/expression.test.js +55 -0
- package/dist/loop/expression.test.js.map +1 -0
- package/dist/loop/hooks.d.ts +132 -0
- package/dist/loop/hooks.d.ts.map +1 -0
- package/dist/loop/hooks.js +85 -0
- package/dist/loop/hooks.js.map +1 -0
- package/dist/loop/normalize.d.ts +4 -0
- package/dist/loop/normalize.d.ts.map +1 -0
- package/dist/loop/normalize.js +88 -0
- package/dist/loop/normalize.js.map +1 -0
- package/dist/loop/pipeline.d.ts +45 -0
- package/dist/loop/pipeline.d.ts.map +1 -0
- package/dist/loop/pipeline.js +128 -0
- package/dist/loop/pipeline.js.map +1 -0
- package/dist/loop/pipeline.test.d.ts +2 -0
- package/dist/loop/pipeline.test.d.ts.map +1 -0
- package/dist/loop/pipeline.test.js +127 -0
- package/dist/loop/pipeline.test.js.map +1 -0
- package/dist/loop/runner.d.ts +44 -0
- package/dist/loop/runner.d.ts.map +1 -0
- package/dist/loop/runner.js +215 -0
- package/dist/loop/runner.js.map +1 -0
- package/dist/loop/runner.test.d.ts +2 -0
- package/dist/loop/runner.test.d.ts.map +1 -0
- package/dist/loop/runner.test.js +124 -0
- package/dist/loop/runner.test.js.map +1 -0
- package/dist/loop/selector.d.ts +13 -0
- package/dist/loop/selector.d.ts.map +1 -0
- package/dist/loop/selector.js +65 -0
- package/dist/loop/selector.js.map +1 -0
- package/dist/loop/selector.test.d.ts +2 -0
- package/dist/loop/selector.test.d.ts.map +1 -0
- package/dist/loop/selector.test.js +70 -0
- package/dist/loop/selector.test.js.map +1 -0
- package/dist/loop/types.d.ts +163 -0
- package/dist/loop/types.d.ts.map +1 -0
- package/dist/loop/types.js +14 -0
- package/dist/loop/types.js.map +1 -0
- package/dist/schemas.d.ts +204 -0
- package/dist/schemas.d.ts.map +1 -1
- package/dist/schemas.js +220 -0
- package/dist/schemas.js.map +1 -1
- package/dist/types.d.ts +13 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +0 -1
- package/dist/types.js.map +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
import type { AgentConfig } from "../types.js";
|
|
2
|
+
import type { ContextBag, LoopConfig } from "./types.js";
|
|
3
|
+
export type LoopHook = "loop:start" | "step:before" | "model:before" | "tool:before" | "tool:after" | "step:after" | "loop:stop" | "loop:transition" | "loop:end";
|
|
4
|
+
export type LoopHookPhase = "before" | "after";
|
|
5
|
+
export interface LoopRuntimeConfig extends LoopConfig {
|
|
6
|
+
name: string;
|
|
7
|
+
}
|
|
8
|
+
export interface LoopToolCall {
|
|
9
|
+
id: string;
|
|
10
|
+
name: string;
|
|
11
|
+
args: Record<string, unknown>;
|
|
12
|
+
}
|
|
13
|
+
export interface LoopHookPayloads {
|
|
14
|
+
"loop:start": {
|
|
15
|
+
agent?: AgentConfig;
|
|
16
|
+
loop: LoopRuntimeConfig;
|
|
17
|
+
context: ContextBag;
|
|
18
|
+
input?: unknown;
|
|
19
|
+
};
|
|
20
|
+
"step:before": {
|
|
21
|
+
agent?: AgentConfig;
|
|
22
|
+
loop: LoopRuntimeConfig;
|
|
23
|
+
turn: number;
|
|
24
|
+
context: ContextBag;
|
|
25
|
+
activeTools?: string[];
|
|
26
|
+
toolChoice?: unknown;
|
|
27
|
+
};
|
|
28
|
+
"model:before": {
|
|
29
|
+
agent?: AgentConfig;
|
|
30
|
+
loop: LoopRuntimeConfig;
|
|
31
|
+
turn: number;
|
|
32
|
+
context: ContextBag;
|
|
33
|
+
activeTools?: string[];
|
|
34
|
+
toolChoice?: unknown;
|
|
35
|
+
};
|
|
36
|
+
"tool:before": {
|
|
37
|
+
agent?: AgentConfig;
|
|
38
|
+
loop: LoopRuntimeConfig;
|
|
39
|
+
turn: number;
|
|
40
|
+
context: ContextBag;
|
|
41
|
+
toolCall: LoopToolCall;
|
|
42
|
+
result?: string;
|
|
43
|
+
};
|
|
44
|
+
"tool:after": {
|
|
45
|
+
agent?: AgentConfig;
|
|
46
|
+
loop: LoopRuntimeConfig;
|
|
47
|
+
turn: number;
|
|
48
|
+
context: ContextBag;
|
|
49
|
+
toolCall: LoopToolCall;
|
|
50
|
+
result: string;
|
|
51
|
+
isError: boolean;
|
|
52
|
+
skipped: boolean;
|
|
53
|
+
};
|
|
54
|
+
"step:after": {
|
|
55
|
+
agent?: AgentConfig;
|
|
56
|
+
loop: LoopRuntimeConfig;
|
|
57
|
+
turn: number;
|
|
58
|
+
context: ContextBag;
|
|
59
|
+
text: string;
|
|
60
|
+
toolCalls: LoopToolCall[];
|
|
61
|
+
toolResults: LoopToolResult[];
|
|
62
|
+
usage?: unknown;
|
|
63
|
+
};
|
|
64
|
+
"loop:stop": {
|
|
65
|
+
agent?: AgentConfig;
|
|
66
|
+
loop: LoopRuntimeConfig;
|
|
67
|
+
turn: number;
|
|
68
|
+
context: ContextBag;
|
|
69
|
+
reason: LoopStopReason;
|
|
70
|
+
shouldStop: boolean;
|
|
71
|
+
};
|
|
72
|
+
"loop:transition": {
|
|
73
|
+
agent?: AgentConfig;
|
|
74
|
+
from: string;
|
|
75
|
+
to: string;
|
|
76
|
+
context: ContextBag;
|
|
77
|
+
};
|
|
78
|
+
"loop:end": {
|
|
79
|
+
agent?: AgentConfig;
|
|
80
|
+
loop: LoopRuntimeConfig;
|
|
81
|
+
context: ContextBag;
|
|
82
|
+
status: LoopRunStatus;
|
|
83
|
+
reason: LoopStopReason;
|
|
84
|
+
turns: number;
|
|
85
|
+
text: string;
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
export type LoopStopReason = "completed" | "max_turns" | "cancelled";
|
|
89
|
+
export type LoopRunStatus = "completed" | "cancelled";
|
|
90
|
+
export interface LoopToolResult {
|
|
91
|
+
toolCall: LoopToolCall;
|
|
92
|
+
result: string;
|
|
93
|
+
isError: boolean;
|
|
94
|
+
skipped: boolean;
|
|
95
|
+
}
|
|
96
|
+
export interface LoopHookContext<T = unknown> {
|
|
97
|
+
readonly hook: LoopHook;
|
|
98
|
+
readonly phase: LoopHookPhase;
|
|
99
|
+
data: T;
|
|
100
|
+
cancel(reason?: string): void;
|
|
101
|
+
readonly cancelled: boolean;
|
|
102
|
+
readonly cancelReason?: string;
|
|
103
|
+
readonly timestamp: string;
|
|
104
|
+
}
|
|
105
|
+
export type LoopHookHandler<T = unknown> = (ctx: LoopHookContext<T>) => void | Promise<void>;
|
|
106
|
+
export interface LoopHookRegistration<K extends LoopHook = LoopHook> {
|
|
107
|
+
hook: K;
|
|
108
|
+
phase: LoopHookPhase;
|
|
109
|
+
handler: LoopHookHandler<LoopHookPayloads[K]>;
|
|
110
|
+
priority?: number;
|
|
111
|
+
name?: string;
|
|
112
|
+
}
|
|
113
|
+
export interface LoopBeforeHookResult<T> {
|
|
114
|
+
cancelled: boolean;
|
|
115
|
+
cancelReason?: string;
|
|
116
|
+
data: T;
|
|
117
|
+
}
|
|
118
|
+
export declare class LoopHookRegistry {
|
|
119
|
+
private registrations;
|
|
120
|
+
register<K extends LoopHook>(reg: LoopHookRegistration<K>): () => void;
|
|
121
|
+
runBefore<K extends LoopHook>(hook: K, data: LoopHookPayloads[K]): Promise<LoopBeforeHookResult<LoopHookPayloads[K]>>;
|
|
122
|
+
runAfter<K extends LoopHook>(hook: K, data: LoopHookPayloads[K]): Promise<void>;
|
|
123
|
+
get size(): number;
|
|
124
|
+
list(): Array<{
|
|
125
|
+
hook: LoopHook;
|
|
126
|
+
phase: LoopHookPhase;
|
|
127
|
+
priority: number;
|
|
128
|
+
name?: string;
|
|
129
|
+
}>;
|
|
130
|
+
clear(): void;
|
|
131
|
+
}
|
|
132
|
+
//# sourceMappingURL=hooks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/loop/hooks.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
export class LoopHookRegistry {
|
|
2
|
+
registrations = [];
|
|
3
|
+
register(reg) {
|
|
4
|
+
const stored = {
|
|
5
|
+
hook: reg.hook,
|
|
6
|
+
phase: reg.phase,
|
|
7
|
+
handler: reg.handler,
|
|
8
|
+
priority: reg.priority ?? 100,
|
|
9
|
+
name: reg.name,
|
|
10
|
+
};
|
|
11
|
+
this.registrations.push(stored);
|
|
12
|
+
this.registrations.sort((a, b) => a.priority - b.priority);
|
|
13
|
+
return () => {
|
|
14
|
+
const idx = this.registrations.indexOf(stored);
|
|
15
|
+
if (idx >= 0)
|
|
16
|
+
this.registrations.splice(idx, 1);
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
async runBefore(hook, data) {
|
|
20
|
+
const handlers = this.registrations.filter(r => r.hook === hook && r.phase === "before");
|
|
21
|
+
if (handlers.length === 0)
|
|
22
|
+
return { cancelled: false, data };
|
|
23
|
+
let cancelled = false;
|
|
24
|
+
let cancelReason;
|
|
25
|
+
const ctx = {
|
|
26
|
+
hook,
|
|
27
|
+
phase: "before",
|
|
28
|
+
data,
|
|
29
|
+
cancel(reason) {
|
|
30
|
+
cancelled = true;
|
|
31
|
+
cancelReason = reason;
|
|
32
|
+
},
|
|
33
|
+
get cancelled() { return cancelled; },
|
|
34
|
+
get cancelReason() { return cancelReason; },
|
|
35
|
+
timestamp: new Date().toISOString(),
|
|
36
|
+
};
|
|
37
|
+
for (const reg of handlers) {
|
|
38
|
+
try {
|
|
39
|
+
await reg.handler(ctx);
|
|
40
|
+
}
|
|
41
|
+
catch (err) {
|
|
42
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
43
|
+
console.error(`[LoopHookRegistry] Error in before:${hook} handler "${reg.name ?? "anonymous"}": ${msg}`);
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
return { cancelled, cancelReason, data: ctx.data };
|
|
47
|
+
}
|
|
48
|
+
async runAfter(hook, data) {
|
|
49
|
+
const handlers = this.registrations.filter(r => r.hook === hook && r.phase === "after");
|
|
50
|
+
if (handlers.length === 0)
|
|
51
|
+
return;
|
|
52
|
+
const ctx = {
|
|
53
|
+
hook,
|
|
54
|
+
phase: "after",
|
|
55
|
+
data,
|
|
56
|
+
cancel() { },
|
|
57
|
+
get cancelled() { return false; },
|
|
58
|
+
timestamp: new Date().toISOString(),
|
|
59
|
+
};
|
|
60
|
+
for (const reg of handlers) {
|
|
61
|
+
try {
|
|
62
|
+
await reg.handler(ctx);
|
|
63
|
+
}
|
|
64
|
+
catch (err) {
|
|
65
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
66
|
+
console.error(`[LoopHookRegistry] Error in after:${hook} handler "${reg.name ?? "anonymous"}": ${msg}`);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
get size() {
|
|
71
|
+
return this.registrations.length;
|
|
72
|
+
}
|
|
73
|
+
list() {
|
|
74
|
+
return this.registrations.map(r => ({
|
|
75
|
+
hook: r.hook,
|
|
76
|
+
phase: r.phase,
|
|
77
|
+
priority: r.priority,
|
|
78
|
+
name: r.name,
|
|
79
|
+
}));
|
|
80
|
+
}
|
|
81
|
+
clear() {
|
|
82
|
+
this.registrations.length = 0;
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
//# sourceMappingURL=hooks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/loop/hooks.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { AgentLoopConfig, ProjectLoopConfig } from "./types.js";
|
|
2
|
+
/** Convert the canonical project-level loop graph to the legacy executor shape. */
|
|
3
|
+
export declare function normalizeProjectLoop(loop: ProjectLoopConfig): AgentLoopConfig;
|
|
4
|
+
//# sourceMappingURL=normalize.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/loop/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAsB,iBAAiB,EAAQ,MAAM,YAAY,CAAC;AA4E/F,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,eAAe,CAkB7E"}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
function transitionSteps(next, loop, seen) {
|
|
2
|
+
if (!next || next === "end")
|
|
3
|
+
return [];
|
|
4
|
+
if (typeof next === "string")
|
|
5
|
+
return stepFor(next, loop, new Set(seen));
|
|
6
|
+
const cases = next
|
|
7
|
+
.filter((t) => t.to !== "end" && t.when)
|
|
8
|
+
.map((t) => ({ when: t.when, steps: stepFor(t.to, loop, new Set(seen)) }));
|
|
9
|
+
const fallback = next.find((t) => !t.when);
|
|
10
|
+
if (cases.length === 0) {
|
|
11
|
+
return fallback && fallback.to !== "end" ? stepFor(fallback.to, loop, new Set(seen)) : [];
|
|
12
|
+
}
|
|
13
|
+
return [
|
|
14
|
+
{
|
|
15
|
+
switch: {
|
|
16
|
+
cases,
|
|
17
|
+
...(fallback && fallback.to !== "end" ? { default: { steps: stepFor(fallback.to, loop, new Set(seen)) } } : {}),
|
|
18
|
+
},
|
|
19
|
+
},
|
|
20
|
+
];
|
|
21
|
+
}
|
|
22
|
+
function stepFor(id, loop, seen = new Set()) {
|
|
23
|
+
if (id === "end" || seen.has(id))
|
|
24
|
+
return [];
|
|
25
|
+
seen.add(id);
|
|
26
|
+
const node = loop.steps[id];
|
|
27
|
+
if (!node)
|
|
28
|
+
return [];
|
|
29
|
+
if (node.type === "human") {
|
|
30
|
+
return [
|
|
31
|
+
{
|
|
32
|
+
human: id,
|
|
33
|
+
when: node.when,
|
|
34
|
+
output: node.output,
|
|
35
|
+
notify: node.notify,
|
|
36
|
+
},
|
|
37
|
+
...transitionSteps(node.next, loop, seen),
|
|
38
|
+
];
|
|
39
|
+
}
|
|
40
|
+
if (node.type === "parallel") {
|
|
41
|
+
return [
|
|
42
|
+
{
|
|
43
|
+
parallel: node.branches.map((branch) => {
|
|
44
|
+
const nested = stepFor(branch, loop, new Set(seen));
|
|
45
|
+
return nested[0] ?? { loop: branch };
|
|
46
|
+
}),
|
|
47
|
+
join: node.join,
|
|
48
|
+
when: node.when,
|
|
49
|
+
},
|
|
50
|
+
...transitionSteps(node.next, loop, seen),
|
|
51
|
+
];
|
|
52
|
+
}
|
|
53
|
+
if (node.type === "tool") {
|
|
54
|
+
return [
|
|
55
|
+
{
|
|
56
|
+
tool: node.tool,
|
|
57
|
+
input: node.input,
|
|
58
|
+
saveAs: node.saveAs,
|
|
59
|
+
when: node.when,
|
|
60
|
+
},
|
|
61
|
+
...transitionSteps(node.next, loop, seen),
|
|
62
|
+
];
|
|
63
|
+
}
|
|
64
|
+
return [
|
|
65
|
+
{ loop: id, when: node.when },
|
|
66
|
+
...transitionSteps(node.next, loop, seen),
|
|
67
|
+
];
|
|
68
|
+
}
|
|
69
|
+
/** Convert the canonical project-level loop graph to the legacy executor shape. */
|
|
70
|
+
export function normalizeProjectLoop(loop) {
|
|
71
|
+
const loops = {};
|
|
72
|
+
for (const [id, step] of Object.entries(loop.steps)) {
|
|
73
|
+
if (step.type === "human" || step.type === "parallel" || step.type === "tool")
|
|
74
|
+
continue;
|
|
75
|
+
const { type: _type, when: _when, next: _next, ...config } = step;
|
|
76
|
+
loops[id] = config;
|
|
77
|
+
}
|
|
78
|
+
const pipeline = {
|
|
79
|
+
context: loop.context ?? "shared",
|
|
80
|
+
steps: stepFor(loop.start, loop),
|
|
81
|
+
};
|
|
82
|
+
return {
|
|
83
|
+
name: loop.name,
|
|
84
|
+
loops,
|
|
85
|
+
pipeline,
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
//# sourceMappingURL=normalize.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/loop/normalize.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { LoopHookRegistry } from "./hooks.js";
|
|
2
|
+
import { type ContextBag, type LoopConfig, type Pipeline, type Step } from "./types.js";
|
|
3
|
+
export interface PipelineLoopResult {
|
|
4
|
+
output?: unknown;
|
|
5
|
+
context?: ContextBag;
|
|
6
|
+
}
|
|
7
|
+
export interface PipelineHumanResult {
|
|
8
|
+
output?: unknown;
|
|
9
|
+
context?: ContextBag;
|
|
10
|
+
}
|
|
11
|
+
export interface PipelineToolResult {
|
|
12
|
+
output?: unknown;
|
|
13
|
+
context?: ContextBag;
|
|
14
|
+
}
|
|
15
|
+
export interface PipelineTraceEvent {
|
|
16
|
+
type: "loop" | "tool" | "human" | "switch" | "parallel" | "skip";
|
|
17
|
+
name?: string;
|
|
18
|
+
when?: string;
|
|
19
|
+
matched?: boolean;
|
|
20
|
+
}
|
|
21
|
+
export interface PipelineExecutionResult {
|
|
22
|
+
context: ContextBag;
|
|
23
|
+
trace: PipelineTraceEvent[];
|
|
24
|
+
}
|
|
25
|
+
export interface PipelineExecutorOptions {
|
|
26
|
+
pipeline: Pipeline;
|
|
27
|
+
loops: Record<string, LoopConfig>;
|
|
28
|
+
context?: ContextBag;
|
|
29
|
+
hooks?: LoopHookRegistry;
|
|
30
|
+
runLoop: (name: string, loop: LoopConfig, context: Readonly<ContextBag>) => Promise<PipelineLoopResult>;
|
|
31
|
+
runTool?: (name: string, input: unknown, context: Readonly<ContextBag>, step: Extract<Step, {
|
|
32
|
+
tool: string;
|
|
33
|
+
}>) => Promise<PipelineToolResult>;
|
|
34
|
+
handleHuman?: (name: string, step: Extract<Step, {
|
|
35
|
+
human: string;
|
|
36
|
+
}>, context: Readonly<ContextBag>) => Promise<PipelineHumanResult>;
|
|
37
|
+
}
|
|
38
|
+
export declare class PipelineExecutor {
|
|
39
|
+
private readonly evaluator;
|
|
40
|
+
execute(options: PipelineExecutorOptions): Promise<PipelineExecutionResult>;
|
|
41
|
+
private executeSteps;
|
|
42
|
+
private matchesWhen;
|
|
43
|
+
private runTransitionHook;
|
|
44
|
+
}
|
|
45
|
+
//# sourceMappingURL=pipeline.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/loop/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAqE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAE3J,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxG,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9I,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACrI;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAErD,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;YAOnE,YAAY;IAgF1B,OAAO,CAAC,WAAW;YAKL,iBAAiB;CAkBhC"}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { SafeExpressionEvaluator } from "./expression.js";
|
|
2
|
+
import { isHumanStep, isLoopStep, isParallelStep, isSwitchStep, isToolStep } from "./types.js";
|
|
3
|
+
export class PipelineExecutor {
|
|
4
|
+
evaluator = new SafeExpressionEvaluator();
|
|
5
|
+
async execute(options) {
|
|
6
|
+
const context = { ...(options.context ?? {}) };
|
|
7
|
+
const trace = [];
|
|
8
|
+
await this.executeSteps(options.pipeline.steps, context, trace, options);
|
|
9
|
+
return { context, trace };
|
|
10
|
+
}
|
|
11
|
+
async executeSteps(steps, context, trace, options, previousNode) {
|
|
12
|
+
let lastNode = previousNode;
|
|
13
|
+
for (const step of steps) {
|
|
14
|
+
if (!this.matchesWhen(step.when, context)) {
|
|
15
|
+
trace.push({ type: "skip", when: step.when, matched: false });
|
|
16
|
+
continue;
|
|
17
|
+
}
|
|
18
|
+
if (isLoopStep(step)) {
|
|
19
|
+
const loop = options.loops[step.loop];
|
|
20
|
+
if (!loop)
|
|
21
|
+
throw new Error(`Pipeline references unknown loop "${step.loop}"`);
|
|
22
|
+
await this.runTransitionHook(lastNode, step.loop, context, options);
|
|
23
|
+
const result = await options.runLoop(step.loop, loop, freezeContext(context));
|
|
24
|
+
mergeLoopResult(context, step.loop, result);
|
|
25
|
+
trace.push({ type: "loop", name: step.loop, when: step.when, matched: true });
|
|
26
|
+
lastNode = step.loop;
|
|
27
|
+
continue;
|
|
28
|
+
}
|
|
29
|
+
if (isToolStep(step)) {
|
|
30
|
+
if (!options.runTool)
|
|
31
|
+
throw new Error(`Pipeline tool step "${step.tool}" requires a tool handler`);
|
|
32
|
+
await this.runTransitionHook(lastNode, step.tool, context, options);
|
|
33
|
+
const result = await options.runTool(step.tool, step.input, freezeContext(context), step);
|
|
34
|
+
mergeStepResult(context, step.saveAs ?? step.tool, result);
|
|
35
|
+
trace.push({ type: "tool", name: step.tool, when: step.when, matched: true });
|
|
36
|
+
lastNode = step.tool;
|
|
37
|
+
continue;
|
|
38
|
+
}
|
|
39
|
+
if (isSwitchStep(step)) {
|
|
40
|
+
let matched = false;
|
|
41
|
+
for (const branch of step.switch.cases) {
|
|
42
|
+
if (this.matchesWhen(branch.when, context)) {
|
|
43
|
+
trace.push({ type: "switch", when: branch.when, matched: true });
|
|
44
|
+
lastNode = await this.executeSteps(branch.steps, context, trace, options, lastNode);
|
|
45
|
+
matched = true;
|
|
46
|
+
break;
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
if (!matched && step.switch.default) {
|
|
50
|
+
trace.push({ type: "switch", matched: false });
|
|
51
|
+
lastNode = await this.executeSteps(step.switch.default.steps, context, trace, options, lastNode);
|
|
52
|
+
}
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
if (isParallelStep(step)) {
|
|
56
|
+
const snapshot = freezeContext(context);
|
|
57
|
+
const branchResults = await Promise.all(step.parallel.map(async (child) => {
|
|
58
|
+
const branchContext = { ...snapshot };
|
|
59
|
+
const branchTrace = [];
|
|
60
|
+
await this.executeSteps([child], branchContext, branchTrace, options);
|
|
61
|
+
return { branchContext, branchTrace };
|
|
62
|
+
}));
|
|
63
|
+
for (const result of branchResults) {
|
|
64
|
+
Object.assign(context, result.branchContext);
|
|
65
|
+
trace.push(...result.branchTrace);
|
|
66
|
+
}
|
|
67
|
+
trace.push({ type: "parallel", matched: true });
|
|
68
|
+
continue;
|
|
69
|
+
}
|
|
70
|
+
if (isHumanStep(step)) {
|
|
71
|
+
if (!options.handleHuman)
|
|
72
|
+
throw new Error(`Pipeline human step "${step.human}" requires a human handler`);
|
|
73
|
+
await this.runTransitionHook(lastNode, step.human, context, options);
|
|
74
|
+
const result = await options.handleHuman(step.human, step, freezeContext(context));
|
|
75
|
+
mergeLoopResult(context, step.human, result);
|
|
76
|
+
trace.push({ type: "human", name: step.human, when: step.when, matched: true });
|
|
77
|
+
lastNode = step.human;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
return lastNode;
|
|
81
|
+
}
|
|
82
|
+
matchesWhen(expression, context) {
|
|
83
|
+
if (!expression)
|
|
84
|
+
return true;
|
|
85
|
+
return this.evaluator.evaluate(expression, context);
|
|
86
|
+
}
|
|
87
|
+
async runTransitionHook(from, to, context, options) {
|
|
88
|
+
if (!from || !options.hooks)
|
|
89
|
+
return;
|
|
90
|
+
const result = await options.hooks.runBefore("loop:transition", {
|
|
91
|
+
from,
|
|
92
|
+
to,
|
|
93
|
+
context,
|
|
94
|
+
});
|
|
95
|
+
if (result.cancelled) {
|
|
96
|
+
throw new Error(`Loop transition from "${from}" to "${to}" cancelled${result.cancelReason ? `: ${result.cancelReason}` : ""}`);
|
|
97
|
+
}
|
|
98
|
+
Object.assign(context, result.data.context);
|
|
99
|
+
await options.hooks.runAfter("loop:transition", result.data);
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
function freezeContext(context) {
|
|
103
|
+
return Object.freeze({ ...context });
|
|
104
|
+
}
|
|
105
|
+
function setContextPath(context, path, value) {
|
|
106
|
+
const parts = path.split(".").filter(Boolean);
|
|
107
|
+
if (parts.length === 0)
|
|
108
|
+
return;
|
|
109
|
+
let cursor = context;
|
|
110
|
+
for (const part of parts.slice(0, -1)) {
|
|
111
|
+
const current = cursor[part];
|
|
112
|
+
if (!current || typeof current !== "object" || Array.isArray(current)) {
|
|
113
|
+
cursor[part] = {};
|
|
114
|
+
}
|
|
115
|
+
cursor = cursor[part];
|
|
116
|
+
}
|
|
117
|
+
cursor[parts[parts.length - 1]] = value;
|
|
118
|
+
}
|
|
119
|
+
function mergeStepResult(context, name, result) {
|
|
120
|
+
if (result.context)
|
|
121
|
+
Object.assign(context, result.context);
|
|
122
|
+
if (result.output !== undefined)
|
|
123
|
+
setContextPath(context, name, result.output);
|
|
124
|
+
}
|
|
125
|
+
function mergeLoopResult(context, name, result) {
|
|
126
|
+
mergeStepResult(context, name, result);
|
|
127
|
+
}
|
|
128
|
+
//# sourceMappingURL=pipeline.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/loop/pipeline.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pipeline.test.d.ts","sourceRoot":"","sources":["../../src/loop/pipeline.test.ts"],"names":[],"mappings":""}
|