@tagma/sdk 0.6.12 → 0.7.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 (110) hide show
  1. package/README.md +56 -15
  2. package/dist/bootstrap.d.ts +6 -6
  3. package/dist/bootstrap.d.ts.map +1 -1
  4. package/dist/bootstrap.js +5 -6
  5. package/dist/bootstrap.js.map +1 -1
  6. package/dist/config.d.ts +8 -0
  7. package/dist/config.d.ts.map +1 -0
  8. package/dist/config.js +5 -0
  9. package/dist/config.js.map +1 -0
  10. package/dist/core/dataflow.d.ts +23 -0
  11. package/dist/core/dataflow.d.ts.map +1 -0
  12. package/dist/core/dataflow.js +63 -0
  13. package/dist/core/dataflow.js.map +1 -0
  14. package/dist/core/log-prune.d.ts +16 -0
  15. package/dist/core/log-prune.d.ts.map +1 -0
  16. package/dist/core/log-prune.js +34 -0
  17. package/dist/core/log-prune.js.map +1 -0
  18. package/dist/core/preflight.d.ts +13 -0
  19. package/dist/core/preflight.d.ts.map +1 -0
  20. package/dist/core/preflight.js +61 -0
  21. package/dist/core/preflight.js.map +1 -0
  22. package/dist/core/run-context.d.ts +52 -0
  23. package/dist/core/run-context.d.ts.map +1 -0
  24. package/dist/core/run-context.js +156 -0
  25. package/dist/core/run-context.js.map +1 -0
  26. package/dist/core/run-state.d.ts +25 -0
  27. package/dist/core/run-state.d.ts.map +1 -0
  28. package/dist/core/run-state.js +93 -0
  29. package/dist/core/run-state.js.map +1 -0
  30. package/dist/core/scheduler.d.ts +13 -0
  31. package/dist/core/scheduler.d.ts.map +1 -0
  32. package/dist/core/scheduler.js +35 -0
  33. package/dist/core/scheduler.js.map +1 -0
  34. package/dist/core/task-executor.d.ts +13 -0
  35. package/dist/core/task-executor.d.ts.map +1 -0
  36. package/dist/core/task-executor.js +639 -0
  37. package/dist/core/task-executor.js.map +1 -0
  38. package/dist/core/trigger-errors.d.ts +9 -0
  39. package/dist/core/trigger-errors.d.ts.map +1 -0
  40. package/dist/core/trigger-errors.js +15 -0
  41. package/dist/core/trigger-errors.js.map +1 -0
  42. package/dist/engine.d.ts +6 -14
  43. package/dist/engine.d.ts.map +1 -1
  44. package/dist/engine.js +68 -1035
  45. package/dist/engine.js.map +1 -1
  46. package/dist/index.d.ts +9 -0
  47. package/dist/index.d.ts.map +1 -0
  48. package/dist/index.js +6 -0
  49. package/dist/index.js.map +1 -0
  50. package/dist/pipeline-definition.d.ts +3 -0
  51. package/dist/pipeline-definition.d.ts.map +1 -0
  52. package/dist/pipeline-definition.js +4 -0
  53. package/dist/pipeline-definition.js.map +1 -0
  54. package/dist/pipeline-runner.d.ts +2 -1
  55. package/dist/pipeline-runner.d.ts.map +1 -1
  56. package/dist/pipeline-runner.js +2 -2
  57. package/dist/pipeline-runner.js.map +1 -1
  58. package/dist/plugins.d.ts +5 -0
  59. package/dist/plugins.d.ts.map +1 -0
  60. package/dist/plugins.js +3 -0
  61. package/dist/plugins.js.map +1 -0
  62. package/dist/registry.d.ts +3 -19
  63. package/dist/registry.d.ts.map +1 -1
  64. package/dist/registry.js +7 -35
  65. package/dist/registry.js.map +1 -1
  66. package/dist/tagma.d.ts +24 -0
  67. package/dist/tagma.d.ts.map +1 -0
  68. package/dist/tagma.js +23 -0
  69. package/dist/tagma.js.map +1 -0
  70. package/dist/utils-api.d.ts +2 -0
  71. package/dist/utils-api.d.ts.map +1 -0
  72. package/dist/utils-api.js +2 -0
  73. package/dist/utils-api.js.map +1 -0
  74. package/dist/yaml.d.ts +4 -0
  75. package/dist/yaml.d.ts.map +1 -0
  76. package/dist/yaml.js +3 -0
  77. package/dist/yaml.js.map +1 -0
  78. package/package.json +52 -7
  79. package/src/bootstrap.ts +6 -6
  80. package/src/config.ts +26 -0
  81. package/src/core/dataflow.test.ts +167 -0
  82. package/src/core/dataflow.ts +118 -0
  83. package/src/core/log-prune.test.ts +58 -0
  84. package/src/core/log-prune.ts +43 -0
  85. package/src/core/preflight.test.ts +49 -0
  86. package/src/core/preflight.ts +89 -0
  87. package/src/core/run-context.test.ts +244 -0
  88. package/src/core/run-context.ts +207 -0
  89. package/src/core/run-state.test.ts +98 -0
  90. package/src/core/run-state.ts +122 -0
  91. package/src/core/scheduler.test.ts +83 -0
  92. package/src/core/scheduler.ts +42 -0
  93. package/src/core/task-executor.ts +803 -0
  94. package/src/core/trigger-errors.ts +15 -0
  95. package/src/engine.ts +80 -1248
  96. package/src/index.ts +28 -0
  97. package/src/pipeline-definition.ts +5 -0
  98. package/src/pipeline-runner.ts +3 -2
  99. package/src/plugin-registry.test.ts +7 -10
  100. package/src/plugins.ts +18 -0
  101. package/src/registry.ts +7 -49
  102. package/src/tagma.test.ts +84 -0
  103. package/src/tagma.ts +47 -0
  104. package/src/utils-api.ts +8 -0
  105. package/src/yaml.ts +11 -0
  106. package/dist/sdk.d.ts +0 -32
  107. package/dist/sdk.d.ts.map +0 -1
  108. package/dist/sdk.js +0 -41
  109. package/dist/sdk.js.map +0 -1
  110. package/src/sdk.ts +0 -151
@@ -0,0 +1,156 @@
1
+ import { executeHook, buildTaskContext, } from '../hooks';
2
+ import { isTerminal } from './run-state';
3
+ import { nowISO } from '../utils';
4
+ function isPromptTaskConfig(task) {
5
+ return task.prompt !== undefined && task.command === undefined;
6
+ }
7
+ /**
8
+ * Per-run state container. Owns the maps and abort tracking that
9
+ * `runPipeline` previously held as closure locals, plus the small
10
+ * methods that read/write that state. Scheduler, dataflow, and
11
+ * task-executor extractions in later phases pass `ctx` instead of
12
+ * relying on closure capture.
13
+ */
14
+ export class RunContext {
15
+ runId;
16
+ dag;
17
+ config;
18
+ workDir;
19
+ pipelineInfo;
20
+ onEvent;
21
+ states = new Map();
22
+ sessionMap = new Map();
23
+ normalizedMap = new Map();
24
+ outputValuesMap = new Map();
25
+ bindingDataMap = new Map();
26
+ resolvedInputsMap = new Map();
27
+ directDownstreams;
28
+ abortController = new AbortController();
29
+ abortReason = null;
30
+ constructor(options) {
31
+ this.runId = options.runId;
32
+ this.dag = options.dag;
33
+ this.config = options.config;
34
+ this.workDir = options.workDir;
35
+ this.pipelineInfo = options.pipelineInfo;
36
+ this.onEvent = options.onEvent;
37
+ for (const [id, node] of this.dag.nodes) {
38
+ this.states.set(id, {
39
+ config: node.task,
40
+ trackConfig: node.track,
41
+ status: 'idle',
42
+ result: null,
43
+ startedAt: null,
44
+ finishedAt: null,
45
+ });
46
+ }
47
+ this.directDownstreams = new Map();
48
+ for (const [id] of this.dag.nodes)
49
+ this.directDownstreams.set(id, []);
50
+ for (const [id, node] of this.dag.nodes) {
51
+ for (const upstream of node.dependsOn) {
52
+ const list = this.directDownstreams.get(upstream);
53
+ if (list)
54
+ list.push(id);
55
+ }
56
+ }
57
+ }
58
+ emit(event) {
59
+ this.onEvent?.(event);
60
+ }
61
+ setTaskStatus(taskId, newStatus) {
62
+ const state = this.states.get(taskId);
63
+ // Terminal lock: once a task reaches a terminal state it must not be
64
+ // re-transitioned. This prevents stop_all from marking running tasks as
65
+ // skipped and then having their in-flight processTask promise overwrite
66
+ // that with success/failed, producing an invalid double transition.
67
+ if (isTerminal(state.status))
68
+ return;
69
+ state.status = newStatus;
70
+ const result = state.result;
71
+ const cfg = state.config;
72
+ this.emit({
73
+ type: 'task_update',
74
+ runId: this.runId,
75
+ taskId,
76
+ status: newStatus,
77
+ startedAt: state.startedAt ?? undefined,
78
+ finishedAt: state.finishedAt ?? undefined,
79
+ durationMs: result?.durationMs,
80
+ exitCode: result?.exitCode,
81
+ stdout: result?.stdout,
82
+ stderr: result?.stderr,
83
+ stdoutPath: result?.stdoutPath ?? null,
84
+ stderrPath: result?.stderrPath ?? null,
85
+ stdoutBytes: result?.stdoutBytes ?? null,
86
+ stderrBytes: result?.stderrBytes ?? null,
87
+ sessionId: result?.sessionId ?? null,
88
+ normalizedOutput: result?.normalizedOutput ?? null,
89
+ inputs: this.resolvedInputsMap.get(taskId) ?? null,
90
+ outputs: this.outputValuesMap.get(taskId) ?? null,
91
+ resolvedDriver: cfg.driver ?? null,
92
+ resolvedModel: cfg.model ?? null,
93
+ resolvedPermissions: cfg.permissions ?? null,
94
+ });
95
+ }
96
+ getOnFailure(taskId) {
97
+ return this.dag.nodes.get(taskId)?.track.on_failure ?? 'skip_downstream';
98
+ }
99
+ isDependencySatisfied(depId) {
100
+ const depState = this.states.get(depId);
101
+ if (!depState)
102
+ return 'skip';
103
+ switch (depState.status) {
104
+ case 'success':
105
+ return 'satisfied';
106
+ case 'skipped':
107
+ return 'skip';
108
+ case 'failed':
109
+ case 'timeout':
110
+ case 'blocked':
111
+ return this.getOnFailure(depId) === 'ignore' ? 'satisfied' : 'skip';
112
+ default:
113
+ return 'unsatisfied';
114
+ }
115
+ }
116
+ /**
117
+ * H3: stop_all marks every still-waiting task across every track as
118
+ * skipped and aborts in-flight tasks via the shared signal. The
119
+ * terminal lock in setTaskStatus prevents any later re-transition
120
+ * should a completed running task try to overwrite the skipped state.
121
+ */
122
+ applyStopAll() {
123
+ if (this.abortReason === null)
124
+ this.abortReason = 'stop_all';
125
+ this.abortController.abort();
126
+ for (const [id, state] of this.states) {
127
+ if (state.status === 'waiting') {
128
+ state.finishedAt = nowISO();
129
+ this.setTaskStatus(id, 'skipped');
130
+ }
131
+ }
132
+ }
133
+ buildTaskInfoObj(taskId) {
134
+ const state = this.states.get(taskId);
135
+ return {
136
+ id: taskId,
137
+ name: state.config.name,
138
+ type: isPromptTaskConfig(state.config) ? 'ai' : 'command',
139
+ status: state.status,
140
+ exit_code: state.result?.exitCode ?? null,
141
+ duration_ms: state.result?.durationMs ?? null,
142
+ stderr_path: state.result?.stderrPath ?? null,
143
+ session_id: state.result?.sessionId ?? null,
144
+ started_at: state.startedAt,
145
+ finished_at: state.finishedAt,
146
+ };
147
+ }
148
+ trackInfoOf(taskId) {
149
+ const node = this.dag.nodes.get(taskId);
150
+ return { id: node.track.id, name: node.track.name };
151
+ }
152
+ async fireHook(taskId, event) {
153
+ await executeHook(this.config.hooks, event, buildTaskContext(event, this.pipelineInfo, this.trackInfoOf(taskId), this.buildTaskInfoObj(taskId)), this.workDir, this.abortController.signal);
154
+ }
155
+ }
156
+ //# sourceMappingURL=run-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-context.js","sourceRoot":"","sources":["../../src/core/run-context.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import type { TaskState, TaskStatus, RunTaskState } from '../types';
2
+ export declare function isTerminal(status: TaskStatus): boolean;
3
+ /** Return a deep-copied, caller-safe snapshot of the states map. */
4
+ export declare function freezeStates(states: Map<string, TaskState>): ReadonlyMap<string, TaskState>;
5
+ export interface RunSummary {
6
+ total: number;
7
+ success: number;
8
+ failed: number;
9
+ skipped: number;
10
+ timeout: number;
11
+ blocked: number;
12
+ }
13
+ /**
14
+ * Tally terminal task counts. Idle/waiting/running tasks are counted in
15
+ * `total` but not in any per-status bucket — same semantics as the
16
+ * original engine.ts summary loop.
17
+ */
18
+ export declare function summarizeStates(states: ReadonlyMap<string, TaskState>): RunSummary;
19
+ /**
20
+ * Project the engine's internal TaskState onto the wire RunTaskState
21
+ * shape. `logs` / `totalLogCount` default to empty — they are populated
22
+ * on the server side from streamed `task_log` events, not from state.
23
+ */
24
+ export declare function toRunTaskState(taskId: string, trackId: string, taskName: string, state: TaskState): RunTaskState;
25
+ //# sourceMappingURL=run-state.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../src/core/run-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAEb,MAAM,UAAU,CAAC;AAElB,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAQtD;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7B,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAahC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GACrC,UAAU,CA8BZ;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,GACf,YAAY,CA4Bd"}
@@ -0,0 +1,93 @@
1
+ export function isTerminal(status) {
2
+ return (status === 'success' ||
3
+ status === 'failed' ||
4
+ status === 'timeout' ||
5
+ status === 'skipped' ||
6
+ status === 'blocked');
7
+ }
8
+ /** Return a deep-copied, caller-safe snapshot of the states map. */
9
+ export function freezeStates(states) {
10
+ const copy = new Map();
11
+ for (const [id, s] of states) {
12
+ copy.set(id, {
13
+ config: { ...s.config },
14
+ trackConfig: { ...s.trackConfig },
15
+ status: s.status,
16
+ result: s.result ? { ...s.result } : null,
17
+ startedAt: s.startedAt,
18
+ finishedAt: s.finishedAt,
19
+ });
20
+ }
21
+ return copy;
22
+ }
23
+ /**
24
+ * Tally terminal task counts. Idle/waiting/running tasks are counted in
25
+ * `total` but not in any per-status bucket — same semantics as the
26
+ * original engine.ts summary loop.
27
+ */
28
+ export function summarizeStates(states) {
29
+ const summary = {
30
+ total: 0,
31
+ success: 0,
32
+ failed: 0,
33
+ skipped: 0,
34
+ timeout: 0,
35
+ blocked: 0,
36
+ };
37
+ for (const [, state] of states) {
38
+ summary.total++;
39
+ switch (state.status) {
40
+ case 'success':
41
+ summary.success++;
42
+ break;
43
+ case 'failed':
44
+ summary.failed++;
45
+ break;
46
+ case 'skipped':
47
+ summary.skipped++;
48
+ break;
49
+ case 'timeout':
50
+ summary.timeout++;
51
+ break;
52
+ case 'blocked':
53
+ summary.blocked++;
54
+ break;
55
+ }
56
+ }
57
+ return summary;
58
+ }
59
+ /**
60
+ * Project the engine's internal TaskState onto the wire RunTaskState
61
+ * shape. `logs` / `totalLogCount` default to empty — they are populated
62
+ * on the server side from streamed `task_log` events, not from state.
63
+ */
64
+ export function toRunTaskState(taskId, trackId, taskName, state) {
65
+ const result = state.result;
66
+ const cfg = state.config;
67
+ return {
68
+ taskId,
69
+ trackId,
70
+ taskName,
71
+ status: state.status,
72
+ startedAt: state.startedAt,
73
+ finishedAt: state.finishedAt,
74
+ durationMs: result?.durationMs ?? null,
75
+ exitCode: result?.exitCode ?? null,
76
+ stdout: result?.stdout ?? '',
77
+ stderr: result?.stderr ?? '',
78
+ stdoutPath: result?.stdoutPath ?? null,
79
+ stderrPath: result?.stderrPath ?? null,
80
+ stdoutBytes: result?.stdoutBytes ?? null,
81
+ stderrBytes: result?.stderrBytes ?? null,
82
+ sessionId: result?.sessionId ?? null,
83
+ normalizedOutput: result?.normalizedOutput ?? null,
84
+ resolvedDriver: cfg.driver ?? null,
85
+ resolvedModel: cfg.model ?? null,
86
+ resolvedPermissions: cfg.permissions ?? null,
87
+ outputs: result?.outputs ?? null,
88
+ inputs: null,
89
+ logs: [],
90
+ totalLogCount: 0,
91
+ };
92
+ }
93
+ //# sourceMappingURL=run-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-state.js","sourceRoot":"","sources":["../../src/core/run-state.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { RunContext } from './run-context';
2
+ /**
3
+ * Return waiting tasks whose dependency states are terminal and which are not
4
+ * already in flight. The caller owns actually launching them.
5
+ */
6
+ export declare function findLaunchableTasks(ctx: RunContext, runningTaskIds: ReadonlySet<string>): string[];
7
+ export declare function allTasksTerminal(ctx: RunContext): boolean;
8
+ /**
9
+ * Abort cleanup helper: after in-flight tasks settle, any remaining
10
+ * non-terminal tasks are waiting/idle tasks that were never started.
11
+ */
12
+ export declare function skipNonTerminalTasks(ctx: RunContext, finishedAt?: string): void;
13
+ //# sourceMappingURL=scheduler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/core/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,UAAU,EACf,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAClC,MAAM,EAAE,CAWV;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,UAAU,EACf,UAAU,SAAW,GACpB,IAAI,CAMN"}
@@ -0,0 +1,35 @@
1
+ import { isTerminal } from './run-state';
2
+ import { nowISO } from '../utils';
3
+ /**
4
+ * Return waiting tasks whose dependency states are terminal and which are not
5
+ * already in flight. The caller owns actually launching them.
6
+ */
7
+ export function findLaunchableTasks(ctx, runningTaskIds) {
8
+ const launchable = [];
9
+ for (const [id, state] of ctx.states) {
10
+ if (state.status !== 'waiting' || runningTaskIds.has(id))
11
+ continue;
12
+ const node = ctx.dag.nodes.get(id);
13
+ const allDepsTerminal = node.dependsOn.length === 0 ||
14
+ node.dependsOn.every((depId) => isTerminal(ctx.states.get(depId).status));
15
+ if (allDepsTerminal)
16
+ launchable.push(id);
17
+ }
18
+ return launchable;
19
+ }
20
+ export function allTasksTerminal(ctx) {
21
+ return [...ctx.states.values()].every((state) => isTerminal(state.status));
22
+ }
23
+ /**
24
+ * Abort cleanup helper: after in-flight tasks settle, any remaining
25
+ * non-terminal tasks are waiting/idle tasks that were never started.
26
+ */
27
+ export function skipNonTerminalTasks(ctx, finishedAt = nowISO()) {
28
+ for (const [id, state] of ctx.states) {
29
+ if (isTerminal(state.status))
30
+ continue;
31
+ state.finishedAt = finishedAt;
32
+ ctx.setTaskStatus(id, 'skipped');
33
+ }
34
+ }
35
+ //# sourceMappingURL=scheduler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/core/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAe,EACf,cAAmC;IAEnC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QACnE,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;QACpC,MAAM,eAAe,GACnB,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAC3B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7E,IAAI,eAAe;YAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAe;IAC9C,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAe,EACf,UAAU,GAAG,MAAM,EAAE;IAErB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,SAAS;QACvC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;QAC9B,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}
@@ -0,0 +1,13 @@
1
+ import type { PluginRegistry } from '../registry';
2
+ import { type Logger } from '../logger';
3
+ import type { ApprovalGateway } from '../approval';
4
+ import type { RunContext } from './run-context';
5
+ export interface ExecuteTaskOptions {
6
+ readonly taskId: string;
7
+ readonly ctx: RunContext;
8
+ readonly registry: PluginRegistry;
9
+ readonly log: Logger;
10
+ readonly approvalGateway: ApprovalGateway;
11
+ }
12
+ export declare function executeTask(options: ExecuteTaskOptions): Promise<void>;
13
+ //# sourceMappingURL=task-executor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../src/core/task-executor.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgBlD,OAAO,EAAmB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAkBhD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC3C;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyuB5E"}