taskflow-core 0.2.0 → 0.2.2
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 +247 -862
- package/dist/agents.d.ts +12 -0
- package/dist/agents.d.ts.map +1 -1
- package/dist/agents.js +29 -1
- package/dist/agents.js.map +1 -1
- package/dist/build-info.d.ts +48 -0
- package/dist/build-info.d.ts.map +1 -0
- package/dist/build-info.js +112 -0
- package/dist/build-info.js.map +1 -0
- package/dist/build-info.json +4 -0
- package/dist/cwd-bridge.d.ts +61 -0
- package/dist/cwd-bridge.d.ts.map +1 -0
- package/dist/cwd-bridge.js +136 -0
- package/dist/cwd-bridge.js.map +1 -0
- package/dist/detached-runner.js +31 -5
- package/dist/detached-runner.js.map +1 -1
- package/dist/exec/driver.d.ts +6 -0
- package/dist/exec/driver.d.ts.map +1 -1
- package/dist/exec/driver.js +40 -18
- package/dist/exec/driver.js.map +1 -1
- package/dist/exec/kernel-policy.d.ts.map +1 -1
- package/dist/exec/kernel-policy.js +10 -0
- package/dist/exec/kernel-policy.js.map +1 -1
- package/dist/exec/step-kinds.d.ts +14 -1
- package/dist/exec/step-kinds.d.ts.map +1 -1
- package/dist/exec/step-kinds.js +126 -6
- package/dist/exec/step-kinds.js.map +1 -1
- package/dist/exec/step.d.ts +22 -0
- package/dist/exec/step.d.ts.map +1 -1
- package/dist/exec/step.js +40 -5
- package/dist/exec/step.js.map +1 -1
- package/dist/final-output.d.ts +53 -0
- package/dist/final-output.d.ts.map +1 -0
- package/dist/final-output.js +65 -0
- package/dist/final-output.js.map +1 -0
- package/dist/flowir/canonical-hash.d.ts.map +1 -1
- package/dist/flowir/canonical-hash.js +2 -0
- package/dist/flowir/canonical-hash.js.map +1 -1
- package/dist/flowir/compile.d.ts.map +1 -1
- package/dist/flowir/compile.js +17 -0
- package/dist/flowir/compile.js.map +1 -1
- package/dist/flowir/meta.d.ts +3 -0
- package/dist/flowir/meta.d.ts.map +1 -1
- package/dist/flowir/schema.d.ts +3 -0
- package/dist/flowir/schema.d.ts.map +1 -1
- package/dist/flowir/schema.js.map +1 -1
- package/dist/flowir/translate.d.ts.map +1 -1
- package/dist/flowir/translate.js +4 -0
- package/dist/flowir/translate.js.map +1 -1
- package/dist/host/runner-types.d.ts +16 -0
- package/dist/host/runner-types.d.ts.map +1 -1
- package/dist/index.d.ts +5 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -0
- package/dist/index.js.map +1 -1
- package/dist/interpolate.d.ts +4 -0
- package/dist/interpolate.d.ts.map +1 -1
- package/dist/interpolate.js +14 -0
- package/dist/interpolate.js.map +1 -1
- package/dist/resources/authority.d.ts +35 -0
- package/dist/resources/authority.d.ts.map +1 -0
- package/dist/resources/authority.js +67 -0
- package/dist/resources/authority.js.map +1 -0
- package/dist/resources/backend.d.ts +302 -0
- package/dist/resources/backend.d.ts.map +1 -0
- package/dist/resources/backend.js +16 -0
- package/dist/resources/backend.js.map +1 -0
- package/dist/resources/baseline.d.ts +116 -0
- package/dist/resources/baseline.d.ts.map +1 -0
- package/dist/resources/baseline.js +447 -0
- package/dist/resources/baseline.js.map +1 -0
- package/dist/resources/canonical-json.d.ts +7 -0
- package/dist/resources/canonical-json.d.ts.map +1 -0
- package/dist/resources/canonical-json.js +75 -0
- package/dist/resources/canonical-json.js.map +1 -0
- package/dist/resources/errors.d.ts +23 -0
- package/dist/resources/errors.d.ts.map +1 -0
- package/dist/resources/errors.js +89 -0
- package/dist/resources/errors.js.map +1 -0
- package/dist/resources/execution.d.ts +90 -0
- package/dist/resources/execution.d.ts.map +1 -0
- package/dist/resources/execution.js +581 -0
- package/dist/resources/execution.js.map +1 -0
- package/dist/resources/index.d.ts +15 -0
- package/dist/resources/index.d.ts.map +1 -0
- package/dist/resources/index.js +15 -0
- package/dist/resources/index.js.map +1 -0
- package/dist/resources/journal.d.ts +138 -0
- package/dist/resources/journal.d.ts.map +1 -0
- package/dist/resources/journal.js +438 -0
- package/dist/resources/journal.js.map +1 -0
- package/dist/resources/leases.d.ts +51 -0
- package/dist/resources/leases.d.ts.map +1 -0
- package/dist/resources/leases.js +354 -0
- package/dist/resources/leases.js.map +1 -0
- package/dist/resources/permits.d.ts +52 -0
- package/dist/resources/permits.d.ts.map +1 -0
- package/dist/resources/permits.js +240 -0
- package/dist/resources/permits.js.map +1 -0
- package/dist/resources/persistence.d.ts +63 -0
- package/dist/resources/persistence.d.ts.map +1 -0
- package/dist/resources/persistence.js +522 -0
- package/dist/resources/persistence.js.map +1 -0
- package/dist/resources/registry.d.ts +56 -0
- package/dist/resources/registry.d.ts.map +1 -0
- package/dist/resources/registry.js +139 -0
- package/dist/resources/registry.js.map +1 -0
- package/dist/resources/resolve.d.ts +49 -0
- package/dist/resources/resolve.d.ts.map +1 -0
- package/dist/resources/resolve.js +309 -0
- package/dist/resources/resolve.js.map +1 -0
- package/dist/resources/sandbox.d.ts +72 -0
- package/dist/resources/sandbox.d.ts.map +1 -0
- package/dist/resources/sandbox.js +952 -0
- package/dist/resources/sandbox.js.map +1 -0
- package/dist/resources/schema.d.ts +195 -0
- package/dist/resources/schema.d.ts.map +1 -0
- package/dist/resources/schema.js +231 -0
- package/dist/resources/schema.js.map +1 -0
- package/dist/resources/types.d.ts +36 -0
- package/dist/resources/types.d.ts.map +1 -0
- package/dist/resources/types.js +75 -0
- package/dist/resources/types.js.map +1 -0
- package/dist/resume.d.ts +76 -0
- package/dist/resume.d.ts.map +1 -0
- package/dist/resume.js +190 -0
- package/dist/resume.js.map +1 -0
- package/dist/runner-core.d.ts +29 -0
- package/dist/runner-core.d.ts.map +1 -1
- package/dist/runner-core.js +311 -36
- package/dist/runner-core.js.map +1 -1
- package/dist/runtime/phases/parallel.d.ts +3 -0
- package/dist/runtime/phases/parallel.d.ts.map +1 -1
- package/dist/runtime/phases/parallel.js.map +1 -1
- package/dist/runtime/phases/reduce.d.ts +47 -0
- package/dist/runtime/phases/reduce.d.ts.map +1 -0
- package/dist/runtime/phases/reduce.js +195 -0
- package/dist/runtime/phases/reduce.js.map +1 -0
- package/dist/runtime/phases/script.d.ts.map +1 -1
- package/dist/runtime/phases/script.js +47 -9
- package/dist/runtime/phases/script.js.map +1 -1
- package/dist/runtime.d.ts +67 -1
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +904 -79
- package/dist/runtime.js.map +1 -1
- package/dist/schema.d.ts +135 -5
- package/dist/schema.d.ts.map +1 -1
- package/dist/schema.js +338 -21
- package/dist/schema.js.map +1 -1
- package/dist/store.d.ts +56 -0
- package/dist/store.d.ts.map +1 -1
- package/dist/store.js +5 -1
- package/dist/store.js.map +1 -1
- package/dist/trace.d.ts +3 -0
- package/dist/trace.d.ts.map +1 -1
- package/dist/trace.js.map +1 -1
- package/package.json +4 -3
package/dist/schema.d.ts
CHANGED
|
@@ -5,6 +5,9 @@
|
|
|
5
5
|
* to a subagent (an isolated `pi` process). Phases form a DAG via `dependsOn`.
|
|
6
6
|
*/
|
|
7
7
|
import { Type, type Static } from "typebox";
|
|
8
|
+
/** Hard cap on subagent calls made by one tree-reduce phase. This bounds
|
|
9
|
+
* author mistakes even when no run budget was declared. */
|
|
10
|
+
export declare const TREE_REDUCE_HARD_MAX_CALLS = 256;
|
|
8
11
|
/** Closed set of native phase kinds — single source of truth for DSL + FlowIR. */
|
|
9
12
|
export declare const PHASE_TYPES: readonly ["agent", "parallel", "map", "gate", "reduce", "approval", "flow", "loop", "tournament", "script",
|
|
10
13
|
/** First completed branch wins (Horizon B). */
|
|
@@ -12,6 +15,9 @@ export declare const PHASE_TYPES: readonly ["agent", "parallel", "map", "gate",
|
|
|
12
15
|
/** Dynamic sub-DAG: nested sub-flow or graft-promote into parent (Horizon B). */
|
|
13
16
|
"expand"];
|
|
14
17
|
export type PhaseType = (typeof PHASE_TYPES)[number];
|
|
18
|
+
/** Phase kinds that execute one or more subagents and therefore require an
|
|
19
|
+
* effective idle watchdog (or a finite wall timeout when the watchdog is off). */
|
|
20
|
+
export declare const AGENT_RUNNING_PHASE_TYPES: readonly ["agent", "gate", "reduce", "map", "parallel", "loop", "tournament", "race"];
|
|
15
21
|
/** Loop iteration bounds. Authors may lower the max; the hard cap is a runaway guard. */
|
|
16
22
|
export declare const LOOP_DEFAULT_MAX_ITERATIONS = 10;
|
|
17
23
|
export declare const LOOP_HARD_MAX_ITERATIONS = 100;
|
|
@@ -40,6 +46,7 @@ export type CacheScope = (typeof CACHE_SCOPES)[number];
|
|
|
40
46
|
declare const ParallelTaskSchema: Type.TObject<{
|
|
41
47
|
task: Type.TString;
|
|
42
48
|
agent: Type.TOptional<Type.TString>;
|
|
49
|
+
cwd: Type.TOptional<Type.TString>;
|
|
43
50
|
}>;
|
|
44
51
|
/** Declarative retry policy for a phase's subagent call(s). */
|
|
45
52
|
declare const RetrySchema: Type.TObject<{
|
|
@@ -72,6 +79,7 @@ declare const PhaseSchema: Type.TObject<{
|
|
|
72
79
|
branches: Type.TOptional<Type.TArray<Type.TObject<{
|
|
73
80
|
task: Type.TString;
|
|
74
81
|
agent: Type.TOptional<Type.TString>;
|
|
82
|
+
cwd: Type.TOptional<Type.TString>;
|
|
75
83
|
}>>>;
|
|
76
84
|
/**
|
|
77
85
|
* [race] When true (default), abort in-flight loser branches after the first branch
|
|
@@ -80,6 +88,21 @@ declare const PhaseSchema: Type.TObject<{
|
|
|
80
88
|
*/
|
|
81
89
|
cancelLosers: Type.TOptional<Type.TBoolean>;
|
|
82
90
|
from: Type.TOptional<Type.TArray<Type.TString>>;
|
|
91
|
+
/**
|
|
92
|
+
* [reduce] How the aggregated `from[]` inputs are reduced. `'one-shot'`
|
|
93
|
+
* (default) feeds all inputs to a single reducer call as `{previous.output}`.
|
|
94
|
+
* `'tree'` batches the inputs (see `batchSize`) and runs intermediate
|
|
95
|
+
* reducer calls over each batch, then reduces the round outputs until one
|
|
96
|
+
* remains — useful when the aggregated input would exceed a single prompt.
|
|
97
|
+
* Tree reduction uses the SAME agent/model/options/timeout/idleTimeout as
|
|
98
|
+
* the phase and forces the imperative runtime (the event kernel falls back).
|
|
99
|
+
* The corrected `{previous.output}` aggregation (all `from[]` sources) always
|
|
100
|
+
* applies regardless of strategy.
|
|
101
|
+
*/
|
|
102
|
+
reduceStrategy: Type.TOptional<Type.TUnsafe<"one-shot" | "tree">>;
|
|
103
|
+
/** [reduce] With `reduceStrategy:'tree'`, the max number of aggregated inputs
|
|
104
|
+
* fed to each intermediate reducer call (>= 2). Ignored for one-shot. */
|
|
105
|
+
batchSize: Type.TOptional<Type.TInteger>;
|
|
83
106
|
use: Type.TOptional<Type.TString>;
|
|
84
107
|
/** [expand] Fragment source — string interpolation or inline Taskflow / phases (same as flow.def). */
|
|
85
108
|
def: Type.TOptional<Type.TUnknown>;
|
|
@@ -91,6 +114,14 @@ declare const PhaseSchema: Type.TObject<{
|
|
|
91
114
|
run: Type.TOptional<Type.TUnion<[Type.TString, Type.TArray<Type.TString>]>>;
|
|
92
115
|
input: Type.TOptional<Type.TString>;
|
|
93
116
|
timeout: Type.TOptional<Type.TNumber>;
|
|
117
|
+
/**
|
|
118
|
+
* Idle watchdog override (ms) for agent-running phases. A positive value (>= 1000)
|
|
119
|
+
* replaces the host default (300000ms): if a subagent produces no output for this
|
|
120
|
+
* long it is killed as stalled. `0` DISABLES the watchdog — but then a finite
|
|
121
|
+
* wall `timeout` (>= 1000) is REQUIRED on this phase so it can never hang forever.
|
|
122
|
+
* Overrides the flow-level `idleTimeout`. Absent → flow-level or host default.
|
|
123
|
+
*/
|
|
124
|
+
idleTimeout: Type.TOptional<Type.TNumber>;
|
|
94
125
|
until: Type.TOptional<Type.TString>;
|
|
95
126
|
maxIterations: Type.TOptional<Type.TNumber>;
|
|
96
127
|
convergence: Type.TOptional<Type.TBoolean>;
|
|
@@ -129,20 +160,78 @@ declare const PhaseSchema: Type.TObject<{
|
|
|
129
160
|
}>>;
|
|
130
161
|
shareContext: Type.TOptional<Type.TBoolean>;
|
|
131
162
|
}>;
|
|
132
|
-
declare const ArgSpecSchema: Type.TObject<{
|
|
163
|
+
declare const ArgSpecSchema: Type.TUnion<[Type.TObject<{
|
|
164
|
+
type: Type.TOptional<Type.TNever>;
|
|
133
165
|
default: Type.TOptional<Type.TUnknown>;
|
|
134
166
|
description: Type.TOptional<Type.TString>;
|
|
135
167
|
required: Type.TOptional<Type.TBoolean>;
|
|
136
|
-
}
|
|
168
|
+
}>, Type.TObject<{
|
|
169
|
+
type: Type.TLiteral<"string">;
|
|
170
|
+
default: Type.TOptional<Type.TString>;
|
|
171
|
+
description: Type.TOptional<Type.TString>;
|
|
172
|
+
required: Type.TOptional<Type.TBoolean>;
|
|
173
|
+
}>, Type.TObject<{
|
|
174
|
+
type: Type.TLiteral<"relative-path">;
|
|
175
|
+
default: Type.TOptional<Type.TString>;
|
|
176
|
+
description: Type.TOptional<Type.TString>;
|
|
177
|
+
required: Type.TOptional<Type.TBoolean>;
|
|
178
|
+
}>, Type.TObject<{
|
|
179
|
+
type: Type.TLiteral<"number">;
|
|
180
|
+
default: Type.TOptional<Type.TNumber>;
|
|
181
|
+
minimum: Type.TOptional<Type.TNumber>;
|
|
182
|
+
maximum: Type.TOptional<Type.TNumber>;
|
|
183
|
+
description: Type.TOptional<Type.TString>;
|
|
184
|
+
required: Type.TOptional<Type.TBoolean>;
|
|
185
|
+
}>, Type.TObject<{
|
|
186
|
+
type: Type.TLiteral<"boolean">;
|
|
187
|
+
default: Type.TOptional<Type.TBoolean>;
|
|
188
|
+
description: Type.TOptional<Type.TString>;
|
|
189
|
+
required: Type.TOptional<Type.TBoolean>;
|
|
190
|
+
}>, Type.TObject<{
|
|
191
|
+
type: Type.TLiteral<"enum">;
|
|
192
|
+
values: Type.TArray<Type.TUnion<[Type.TString, Type.TNumber]>>;
|
|
193
|
+
default: Type.TOptional<Type.TUnion<[Type.TString, Type.TNumber]>>;
|
|
194
|
+
description: Type.TOptional<Type.TString>;
|
|
195
|
+
required: Type.TOptional<Type.TBoolean>;
|
|
196
|
+
}>]>;
|
|
137
197
|
export declare const TaskflowSchema: Type.TObject<{
|
|
138
198
|
name: Type.TString;
|
|
139
199
|
description: Type.TOptional<Type.TString>;
|
|
140
200
|
version: Type.TOptional<Type.TNumber>;
|
|
141
|
-
args: Type.TOptional<Type.TRecord<"^.*$", Type.TObject<{
|
|
201
|
+
args: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TObject<{
|
|
202
|
+
type: Type.TOptional<Type.TNever>;
|
|
142
203
|
default: Type.TOptional<Type.TUnknown>;
|
|
143
204
|
description: Type.TOptional<Type.TString>;
|
|
144
205
|
required: Type.TOptional<Type.TBoolean>;
|
|
145
|
-
}
|
|
206
|
+
}>, Type.TObject<{
|
|
207
|
+
type: Type.TLiteral<"string">;
|
|
208
|
+
default: Type.TOptional<Type.TString>;
|
|
209
|
+
description: Type.TOptional<Type.TString>;
|
|
210
|
+
required: Type.TOptional<Type.TBoolean>;
|
|
211
|
+
}>, Type.TObject<{
|
|
212
|
+
type: Type.TLiteral<"relative-path">;
|
|
213
|
+
default: Type.TOptional<Type.TString>;
|
|
214
|
+
description: Type.TOptional<Type.TString>;
|
|
215
|
+
required: Type.TOptional<Type.TBoolean>;
|
|
216
|
+
}>, Type.TObject<{
|
|
217
|
+
type: Type.TLiteral<"number">;
|
|
218
|
+
default: Type.TOptional<Type.TNumber>;
|
|
219
|
+
minimum: Type.TOptional<Type.TNumber>;
|
|
220
|
+
maximum: Type.TOptional<Type.TNumber>;
|
|
221
|
+
description: Type.TOptional<Type.TString>;
|
|
222
|
+
required: Type.TOptional<Type.TBoolean>;
|
|
223
|
+
}>, Type.TObject<{
|
|
224
|
+
type: Type.TLiteral<"boolean">;
|
|
225
|
+
default: Type.TOptional<Type.TBoolean>;
|
|
226
|
+
description: Type.TOptional<Type.TString>;
|
|
227
|
+
required: Type.TOptional<Type.TBoolean>;
|
|
228
|
+
}>, Type.TObject<{
|
|
229
|
+
type: Type.TLiteral<"enum">;
|
|
230
|
+
values: Type.TArray<Type.TUnion<[Type.TString, Type.TNumber]>>;
|
|
231
|
+
default: Type.TOptional<Type.TUnion<[Type.TString, Type.TNumber]>>;
|
|
232
|
+
description: Type.TOptional<Type.TString>;
|
|
233
|
+
required: Type.TOptional<Type.TBoolean>;
|
|
234
|
+
}>]>>>;
|
|
146
235
|
concurrency: Type.TOptional<Type.TNumber>;
|
|
147
236
|
budget: Type.TOptional<Type.TObject<{
|
|
148
237
|
maxUSD: Type.TOptional<Type.TNumber>;
|
|
@@ -152,6 +241,14 @@ export declare const TaskflowSchema: Type.TObject<{
|
|
|
152
241
|
strictInterpolation: Type.TOptional<Type.TBoolean>;
|
|
153
242
|
contextSharing: Type.TOptional<Type.TBoolean>;
|
|
154
243
|
incremental: Type.TOptional<Type.TBoolean>;
|
|
244
|
+
/**
|
|
245
|
+
* Flow-level idle watchdog (ms) for all agent-running phases that don't set
|
|
246
|
+
* their own `idleTimeout`. Positive (>= 1000) overrides the host default
|
|
247
|
+
* (300000ms); `0` disables the watchdog for those phases — but then every
|
|
248
|
+
* agent-running phase MUST declare a finite wall `timeout` (>= 1000) so the
|
|
249
|
+
* flow can never hang forever. A per-phase `idleTimeout` overrides this.
|
|
250
|
+
*/
|
|
251
|
+
idleTimeout: Type.TOptional<Type.TNumber>;
|
|
155
252
|
phases: Type.TArray<Type.TObject<{
|
|
156
253
|
id: Type.TString;
|
|
157
254
|
type: Type.TOptional<Type.TUnsafe<"agent" | "approval" | "expand" | "flow" | "gate" | "loop" | "map" | "parallel" | "race" | "reduce" | "script" | "tournament">>;
|
|
@@ -162,6 +259,7 @@ export declare const TaskflowSchema: Type.TObject<{
|
|
|
162
259
|
branches: Type.TOptional<Type.TArray<Type.TObject<{
|
|
163
260
|
task: Type.TString;
|
|
164
261
|
agent: Type.TOptional<Type.TString>;
|
|
262
|
+
cwd: Type.TOptional<Type.TString>;
|
|
165
263
|
}>>>;
|
|
166
264
|
/**
|
|
167
265
|
* [race] When true (default), abort in-flight loser branches after the first branch
|
|
@@ -170,6 +268,21 @@ export declare const TaskflowSchema: Type.TObject<{
|
|
|
170
268
|
*/
|
|
171
269
|
cancelLosers: Type.TOptional<Type.TBoolean>;
|
|
172
270
|
from: Type.TOptional<Type.TArray<Type.TString>>;
|
|
271
|
+
/**
|
|
272
|
+
* [reduce] How the aggregated `from[]` inputs are reduced. `'one-shot'`
|
|
273
|
+
* (default) feeds all inputs to a single reducer call as `{previous.output}`.
|
|
274
|
+
* `'tree'` batches the inputs (see `batchSize`) and runs intermediate
|
|
275
|
+
* reducer calls over each batch, then reduces the round outputs until one
|
|
276
|
+
* remains — useful when the aggregated input would exceed a single prompt.
|
|
277
|
+
* Tree reduction uses the SAME agent/model/options/timeout/idleTimeout as
|
|
278
|
+
* the phase and forces the imperative runtime (the event kernel falls back).
|
|
279
|
+
* The corrected `{previous.output}` aggregation (all `from[]` sources) always
|
|
280
|
+
* applies regardless of strategy.
|
|
281
|
+
*/
|
|
282
|
+
reduceStrategy: Type.TOptional<Type.TUnsafe<"one-shot" | "tree">>;
|
|
283
|
+
/** [reduce] With `reduceStrategy:'tree'`, the max number of aggregated inputs
|
|
284
|
+
* fed to each intermediate reducer call (>= 2). Ignored for one-shot. */
|
|
285
|
+
batchSize: Type.TOptional<Type.TInteger>;
|
|
173
286
|
use: Type.TOptional<Type.TString>;
|
|
174
287
|
/** [expand] Fragment source — string interpolation or inline Taskflow / phases (same as flow.def). */
|
|
175
288
|
def: Type.TOptional<Type.TUnknown>;
|
|
@@ -181,6 +294,14 @@ export declare const TaskflowSchema: Type.TObject<{
|
|
|
181
294
|
run: Type.TOptional<Type.TUnion<[Type.TString, Type.TArray<Type.TString>]>>;
|
|
182
295
|
input: Type.TOptional<Type.TString>;
|
|
183
296
|
timeout: Type.TOptional<Type.TNumber>;
|
|
297
|
+
/**
|
|
298
|
+
* Idle watchdog override (ms) for agent-running phases. A positive value (>= 1000)
|
|
299
|
+
* replaces the host default (300000ms): if a subagent produces no output for this
|
|
300
|
+
* long it is killed as stalled. `0` DISABLES the watchdog — but then a finite
|
|
301
|
+
* wall `timeout` (>= 1000) is REQUIRED on this phase so it can never hang forever.
|
|
302
|
+
* Overrides the flow-level `idleTimeout`. Absent → flow-level or host default.
|
|
303
|
+
*/
|
|
304
|
+
idleTimeout: Type.TOptional<Type.TNumber>;
|
|
184
305
|
until: Type.TOptional<Type.TString>;
|
|
185
306
|
maxIterations: Type.TOptional<Type.TNumber>;
|
|
186
307
|
convergence: Type.TOptional<Type.TBoolean>;
|
|
@@ -234,6 +355,10 @@ export interface ShorthandStep {
|
|
|
234
355
|
context?: string[];
|
|
235
356
|
/** Max characters per context file (pass-through to Phase.contextLimit). */
|
|
236
357
|
contextLimit?: number;
|
|
358
|
+
/** Working directory for this step's subagent (pass-through to Phase.cwd).
|
|
359
|
+
* A literal path or a reserved workspace keyword ('temp'/'dedicated'/
|
|
360
|
+
* 'worktree'). A top-level `cwd` is the default; a step cwd overrides it. */
|
|
361
|
+
cwd?: string;
|
|
237
362
|
}
|
|
238
363
|
/** True when `def` is a shorthand spec (no `phases`, but a task/tasks/chain field). */
|
|
239
364
|
export declare function isShorthand(def: unknown): boolean;
|
|
@@ -266,9 +391,14 @@ export interface ValidationOptions {
|
|
|
266
391
|
strict?: boolean;
|
|
267
392
|
/** When true, this flow is a runtime-generated (`flow { def }`) sub-flow whose
|
|
268
393
|
* content is LLM-authored / untrusted. Enables hardening checks: breadth caps
|
|
269
|
-
* (phase count, map items, concurrency) and
|
|
394
|
+
* (phase count, map items, concurrency) and denial of cwd/context/script
|
|
395
|
+
* resource capabilities until a FileBroker/sandbox exists. */
|
|
270
396
|
dynamic?: boolean;
|
|
271
397
|
}
|
|
398
|
+
/** Validate resolved invocation values independently of full flow structure.
|
|
399
|
+
* Runtime calls this at the Core boundary so direct, resume, and detached
|
|
400
|
+
* execution cannot bypass adapter-level typed-arg checks. */
|
|
401
|
+
export declare function validateInvocationArgs(def: Pick<Taskflow, "args">, args: Record<string, unknown>): string[];
|
|
272
402
|
export declare function validateTaskflow(def: unknown, opts?: ValidationOptions): ValidationResult;
|
|
273
403
|
export declare function collectRefs(phase: Phase): {
|
|
274
404
|
steps: string[];
|
package/dist/schema.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}
|