@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.
Files changed (65) hide show
  1. package/dist/approval-manager.d.ts +1 -0
  2. package/dist/approval-manager.d.ts.map +1 -1
  3. package/dist/approval-manager.js +7 -9
  4. package/dist/approval-manager.js.map +1 -1
  5. package/dist/index.d.ts +12 -0
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +9 -0
  8. package/dist/index.js.map +1 -1
  9. package/dist/loop/contract.test.d.ts +2 -0
  10. package/dist/loop/contract.test.d.ts.map +1 -0
  11. package/dist/loop/contract.test.js +106 -0
  12. package/dist/loop/contract.test.js.map +1 -0
  13. package/dist/loop/expression.d.ts +29 -0
  14. package/dist/loop/expression.d.ts.map +1 -0
  15. package/dist/loop/expression.js +215 -0
  16. package/dist/loop/expression.js.map +1 -0
  17. package/dist/loop/expression.test.d.ts +2 -0
  18. package/dist/loop/expression.test.d.ts.map +1 -0
  19. package/dist/loop/expression.test.js +55 -0
  20. package/dist/loop/expression.test.js.map +1 -0
  21. package/dist/loop/hooks.d.ts +132 -0
  22. package/dist/loop/hooks.d.ts.map +1 -0
  23. package/dist/loop/hooks.js +85 -0
  24. package/dist/loop/hooks.js.map +1 -0
  25. package/dist/loop/normalize.d.ts +4 -0
  26. package/dist/loop/normalize.d.ts.map +1 -0
  27. package/dist/loop/normalize.js +88 -0
  28. package/dist/loop/normalize.js.map +1 -0
  29. package/dist/loop/pipeline.d.ts +45 -0
  30. package/dist/loop/pipeline.d.ts.map +1 -0
  31. package/dist/loop/pipeline.js +128 -0
  32. package/dist/loop/pipeline.js.map +1 -0
  33. package/dist/loop/pipeline.test.d.ts +2 -0
  34. package/dist/loop/pipeline.test.d.ts.map +1 -0
  35. package/dist/loop/pipeline.test.js +127 -0
  36. package/dist/loop/pipeline.test.js.map +1 -0
  37. package/dist/loop/runner.d.ts +44 -0
  38. package/dist/loop/runner.d.ts.map +1 -0
  39. package/dist/loop/runner.js +215 -0
  40. package/dist/loop/runner.js.map +1 -0
  41. package/dist/loop/runner.test.d.ts +2 -0
  42. package/dist/loop/runner.test.d.ts.map +1 -0
  43. package/dist/loop/runner.test.js +124 -0
  44. package/dist/loop/runner.test.js.map +1 -0
  45. package/dist/loop/selector.d.ts +13 -0
  46. package/dist/loop/selector.d.ts.map +1 -0
  47. package/dist/loop/selector.js +65 -0
  48. package/dist/loop/selector.js.map +1 -0
  49. package/dist/loop/selector.test.d.ts +2 -0
  50. package/dist/loop/selector.test.d.ts.map +1 -0
  51. package/dist/loop/selector.test.js +70 -0
  52. package/dist/loop/selector.test.js.map +1 -0
  53. package/dist/loop/types.d.ts +163 -0
  54. package/dist/loop/types.d.ts.map +1 -0
  55. package/dist/loop/types.js +14 -0
  56. package/dist/loop/types.js.map +1 -0
  57. package/dist/schemas.d.ts +204 -0
  58. package/dist/schemas.d.ts.map +1 -1
  59. package/dist/schemas.js +220 -0
  60. package/dist/schemas.js.map +1 -1
  61. package/dist/types.d.ts +13 -0
  62. package/dist/types.d.ts.map +1 -1
  63. package/dist/types.js +0 -1
  64. package/dist/types.js.map +1 -1
  65. 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":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAA8D,MAAM,YAAY,CAAC;AAuC3J,MAAM,OAAO,gBAAgB;IACV,SAAS,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAE3D,KAAK,CAAC,OAAO,CAAC,OAAgC;QAC5C,MAAM,OAAO,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAyB,EAAE,CAAC;QACvC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,KAAa,EACb,OAAmB,EACnB,KAA2B,EAC3B,OAAgC,EAChC,YAAqB;QAErB,IAAI,QAAQ,GAAG,YAAY,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC9D,SAAS;YACX,CAAC;YAED,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtC,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;gBAC9E,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBACpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC9E,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9E,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,IAAI,2BAA2B,CAAC,CAAC;gBACnG,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBACpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC1F,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9E,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,IAAI,OAAO,GAAG,KAAK,CAAC;gBACpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBACvC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;wBAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;wBACjE,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;wBACpF,OAAO,GAAG,IAAI,CAAC;wBACf,MAAM;oBACR,CAAC;gBACH,CAAC;gBACD,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC/C,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACnG,CAAC;gBACD,SAAS;YACX,CAAC;YAED,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;gBACxC,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;oBACxE,MAAM,aAAa,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;oBACtC,MAAM,WAAW,GAAyB,EAAE,CAAC;oBAC7C,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;oBACtE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;gBACxC,CAAC,CAAC,CAAC,CAAC;gBACJ,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;oBACnC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;oBAC7C,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;gBACpC,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChD,SAAS;YACX,CAAC;YAED,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,OAAO,CAAC,WAAW;oBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,KAAK,4BAA4B,CAAC,CAAC;gBAC1G,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBACrE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;gBACnF,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChF,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;YACxB,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,WAAW,CAAC,UAA8B,EAAE,OAAmB;QACrE,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,IAAwB,EACxB,EAAU,EACV,OAAmB,EACnB,OAAgC;QAEhC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,OAAO;QACpC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,EAAE;YAC9D,IAAI;YACJ,EAAE;YACF,OAAO;SACR,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,SAAS,EAAE,cAAc,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjI,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,SAAS,aAAa,CAAC,OAAmB;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,cAAc,CAAC,OAAmB,EAAE,IAAY,EAAE,KAAc;IACvE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,IAAI,MAAM,GAA4B,OAAO,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,IAAI,CAA4B,CAAC;IACnD,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,KAAK,CAAC;AAC3C,CAAC;AAED,SAAS,eAAe,CAAC,OAAmB,EAAE,IAAY,EAAE,MAAqE;IAC/H,IAAI,MAAM,CAAC,OAAO;QAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,eAAe,CAAC,OAAmB,EAAE,IAAY,EAAE,MAAgD;IAC1G,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=pipeline.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline.test.d.ts","sourceRoot":"","sources":["../../src/loop/pipeline.test.ts"],"names":[],"mappings":""}