@relayflows/surface 2.0.8 → 2.0.9
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/context.d.ts +4 -0
- package/dist/context.d.ts.map +1 -1
- package/dist/flow.d.ts +12 -0
- package/dist/flow.d.ts.map +1 -1
- package/dist/flow.js +65 -1
- package/dist/flow.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/src/context.ts +4 -0
- package/src/flow.ts +92 -1
- package/src/index.ts +1 -0
package/dist/context.d.ts
CHANGED
|
@@ -8,6 +8,10 @@ export interface AgentResult {
|
|
|
8
8
|
export interface AgentOptions {
|
|
9
9
|
task: string;
|
|
10
10
|
workspace?: string;
|
|
11
|
+
/** Overrides a named declaration's (or the flow/project default's) CLI for this step only. */
|
|
12
|
+
cli?: string;
|
|
13
|
+
/** Overrides a named declaration's model for this step only. No flow/project default exists for model. */
|
|
14
|
+
model?: string;
|
|
11
15
|
}
|
|
12
16
|
/**
|
|
13
17
|
* The context a journal-backed runtime injects into a flow body.
|
package/dist/context.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,GAAG;IAClB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,GAAG,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,KAAK,EAAE,WAAW,CAAC;CACpB"}
|
package/dist/flow.d.ts
CHANGED
|
@@ -1,4 +1,14 @@
|
|
|
1
1
|
import type { Ctx } from "./context.js";
|
|
2
|
+
/**
|
|
3
|
+
* A reusable agent CLI/model pair, selectable by name from `f.agent(name, ...)`.
|
|
4
|
+
* Both fields are required so selecting a named agent can never inherit a
|
|
5
|
+
* host model — mirrors the kernel-spec dialect's `NamedAgentSpec`
|
|
6
|
+
* (`packages/sdk/src/spec.ts`), which this compiles into.
|
|
7
|
+
*/
|
|
8
|
+
export interface NamedAgentDeclaration {
|
|
9
|
+
cli: string;
|
|
10
|
+
model: string;
|
|
11
|
+
}
|
|
2
12
|
/** Optional escalation header; the empty header is the common case. */
|
|
3
13
|
export interface FlowHeader {
|
|
4
14
|
identity?: string;
|
|
@@ -12,6 +22,7 @@ export interface FlowHeader {
|
|
|
12
22
|
mcp?: string[];
|
|
13
23
|
};
|
|
14
24
|
workspace?: string;
|
|
25
|
+
agents?: Record<string, NamedAgentDeclaration>;
|
|
15
26
|
}
|
|
16
27
|
export type FlowBody<Input = unknown> = (f: Ctx, input: Input) => Promise<void>;
|
|
17
28
|
export interface ReadonlyFlowHeader {
|
|
@@ -26,6 +37,7 @@ export interface ReadonlyFlowHeader {
|
|
|
26
37
|
mcp?: readonly string[];
|
|
27
38
|
}>;
|
|
28
39
|
readonly workspace?: string;
|
|
40
|
+
readonly agents?: Readonly<Record<string, Readonly<NamedAgentDeclaration>>>;
|
|
29
41
|
}
|
|
30
42
|
/** Immutable definition retained for the SDK's journal-backed runtime. */
|
|
31
43
|
export interface AuthoredFlowDefinition<Input = unknown> {
|
package/dist/flow.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../src/flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../src/flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAChD;AAED,MAAM,MAAM,QAAQ,CAAC,KAAK,GAAG,OAAO,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;QACxB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC9B,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACzB,CAAC,CAAC;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;CAC7E;AAED,0EAA0E;AAC1E,MAAM,WAAW,sBAAsB,CAAC,KAAK,GAAG,OAAO;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;CAChC;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAID,wBAAgB,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;AACvF,wBAAgB,IAAI,CAAC,KAAK,GAAG,OAAO,EAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GACpB,UAAU,CAAC;AAkCd;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAapG"}
|
package/dist/flow.js
CHANGED
|
@@ -62,6 +62,7 @@ function freezeHeader(header) {
|
|
|
62
62
|
"budget",
|
|
63
63
|
"tools",
|
|
64
64
|
"workspace",
|
|
65
|
+
"agents",
|
|
65
66
|
].includes(field));
|
|
66
67
|
if (unknownFields.length > 0) {
|
|
67
68
|
throw new TypeError(`flow header has unknown fields: ${unknownFields.join(", ")}`);
|
|
@@ -79,18 +80,28 @@ function freezeHeader(header) {
|
|
|
79
80
|
? {}
|
|
80
81
|
: { mcp: Object.freeze([...header.tools.mcp]) }),
|
|
81
82
|
});
|
|
83
|
+
const agents = header.agents === undefined
|
|
84
|
+
? undefined
|
|
85
|
+
: Object.freeze(Object.fromEntries(ownDataEntries(header.agents, "header.agents").map(([name, declaration]) => {
|
|
86
|
+
// Validated by assertFlowHeader's own ownDataEntries pass before
|
|
87
|
+
// this ever runs: exactly {cli, model}, both non-empty trimmed
|
|
88
|
+
// strings, read as data properties (never through a getter).
|
|
89
|
+
const record = declaration;
|
|
90
|
+
return [name, Object.freeze({ cli: record.cli, model: record.model })];
|
|
91
|
+
})));
|
|
82
92
|
return Object.freeze({
|
|
83
93
|
...(header.identity === undefined ? {} : { identity: header.identity }),
|
|
84
94
|
...(memory === undefined ? {} : { memory }),
|
|
85
95
|
...(header.budget === undefined ? {} : { budget: header.budget }),
|
|
86
96
|
...(tools === undefined ? {} : { tools }),
|
|
87
97
|
...(header.workspace === undefined ? {} : { workspace: header.workspace }),
|
|
98
|
+
...(agents === undefined ? {} : { agents }),
|
|
88
99
|
});
|
|
89
100
|
}
|
|
90
101
|
function assertFlowHeader(value, flowName) {
|
|
91
102
|
const at = `unsupported_header: flow "${flowName}" header`;
|
|
92
103
|
assertHeaderObject(value, at);
|
|
93
|
-
assertKnownKeys(value, ["identity", "memory", "budget", "tools", "workspace"], at);
|
|
104
|
+
assertKnownKeys(value, ["identity", "memory", "budget", "tools", "workspace", "agents"], at);
|
|
94
105
|
assertOptionalString(value, "identity", at);
|
|
95
106
|
assertOptionalString(value, "budget", at);
|
|
96
107
|
assertOptionalString(value, "workspace", at);
|
|
@@ -106,6 +117,43 @@ function assertFlowHeader(value, flowName) {
|
|
|
106
117
|
assertOptionalStringArray(value.tools, "relayfile", `${at}.tools`);
|
|
107
118
|
assertOptionalStringArray(value.tools, "mcp", `${at}.tools`);
|
|
108
119
|
}
|
|
120
|
+
if (value.agents !== undefined) {
|
|
121
|
+
assertHeaderObject(value.agents, `${at}.agents`);
|
|
122
|
+
for (const [name, declaration] of ownDataEntries(value.agents, `${at}.agents`)) {
|
|
123
|
+
if (name !== name.trim() || name.length === 0) {
|
|
124
|
+
throw new TypeError(`${at}.agents: agent name ${JSON.stringify(name)} must be a non-empty, trimmed string`);
|
|
125
|
+
}
|
|
126
|
+
const declarationAt = `${at}.agents.${name}`;
|
|
127
|
+
assertHeaderObject(declaration, declarationAt);
|
|
128
|
+
assertKnownKeys(declaration, ["cli", "model"], declarationAt);
|
|
129
|
+
assertRequiredTrimmedString(declaration, "cli", declarationAt);
|
|
130
|
+
assertRequiredTrimmedString(declaration, "model", declarationAt);
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* Reads every own property of `value` via its descriptor rather than
|
|
136
|
+
* `Object.entries`/property access, so an accessor (getter) property is
|
|
137
|
+
* REJECTED — never invoked — instead of being enumerated as if it were
|
|
138
|
+
* ordinary data. `Object.entries` would call the getter, and a stateful
|
|
139
|
+
* getter can legally answer validation with one value and a second,
|
|
140
|
+
* unvalidated read (e.g. during freezing) with a different one — the closed
|
|
141
|
+
* declaration contract must not depend on a property being well-behaved
|
|
142
|
+
* across two separate reads.
|
|
143
|
+
*/
|
|
144
|
+
function ownDataEntries(value, at) {
|
|
145
|
+
const entries = [];
|
|
146
|
+
for (const key of Reflect.ownKeys(value)) {
|
|
147
|
+
if (typeof key !== "string") {
|
|
148
|
+
throw new TypeError(`${at}: unknown field ${JSON.stringify(String(key))}`);
|
|
149
|
+
}
|
|
150
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, key);
|
|
151
|
+
if (descriptor === undefined || !("value" in descriptor)) {
|
|
152
|
+
throw new TypeError(`${at}.${key}: expected a data property`);
|
|
153
|
+
}
|
|
154
|
+
entries.push([key, descriptor.value]);
|
|
155
|
+
}
|
|
156
|
+
return entries;
|
|
109
157
|
}
|
|
110
158
|
function assertHeaderObject(value, at) {
|
|
111
159
|
if (typeof value !== "object" || value === null || Array.isArray(value)) {
|
|
@@ -133,6 +181,22 @@ function assertOptionalString(value, key, at) {
|
|
|
133
181
|
throw new TypeError(`${at}.${key}: expected a string`);
|
|
134
182
|
}
|
|
135
183
|
}
|
|
184
|
+
/**
|
|
185
|
+
* Requires a trimmed, non-empty string — not merely non-empty-after-trim.
|
|
186
|
+
* The SDK's own project-config schema only accepts already-trimmed model/cli
|
|
187
|
+
* strings (`readProjectConfig`, cli/check.ts); accepting untrimmed values
|
|
188
|
+
* here would let a flow author declare " claude " and have it validate at
|
|
189
|
+
* authoring time but fail later at f.agent preflight, moving a defect from
|
|
190
|
+
* authoring to execution instead of catching it up front.
|
|
191
|
+
*/
|
|
192
|
+
function assertRequiredTrimmedString(value, key, at) {
|
|
193
|
+
if (typeof value[key] !== "string" || value[key].length === 0) {
|
|
194
|
+
throw new TypeError(`${at}.${key}: expected a non-empty string`);
|
|
195
|
+
}
|
|
196
|
+
if (value[key] !== value[key].trim()) {
|
|
197
|
+
throw new TypeError(`${at}.${key}: must not have leading or trailing whitespace`);
|
|
198
|
+
}
|
|
199
|
+
}
|
|
136
200
|
function assertOptionalBoolean(value, key, at) {
|
|
137
201
|
if (value[key] !== undefined && typeof value[key] !== "boolean") {
|
|
138
202
|
throw new TypeError(`${at}.${key}: expected a boolean`);
|
package/dist/flow.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"flow.js","sourceRoot":"","sources":["../src/flow.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"flow.js","sourceRoot":"","sources":["../src/flow.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -2,5 +2,5 @@ export type { EnrollmentReceipt, Heartbeat, JournalStep, RunJournal, ScheduleSta
|
|
|
2
2
|
export type { AgentOptions, AgentResult, Ctx } from "./context.js";
|
|
3
3
|
export { COMPLETION_REASONS, RUN_COMPLETION_REASONS, type CompletionReason, type RunCompletionReason, } from "./completion.js";
|
|
4
4
|
export type { Step } from "./step.js";
|
|
5
|
-
export { flow, type FlowHandle, type FlowHeader, } from "./flow.js";
|
|
5
|
+
export { flow, type FlowHandle, type FlowHeader, type NamedAgentDeclaration, } from "./flow.js";
|
|
6
6
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,UAAU,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC"}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,GAGvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,IAAI,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,GAGvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,IAAI,GAIL,MAAM,WAAW,CAAC"}
|
package/package.json
CHANGED
package/src/context.ts
CHANGED
|
@@ -10,6 +10,10 @@ export interface AgentResult {
|
|
|
10
10
|
export interface AgentOptions {
|
|
11
11
|
task: string;
|
|
12
12
|
workspace?: string;
|
|
13
|
+
/** Overrides a named declaration's (or the flow/project default's) CLI for this step only. */
|
|
14
|
+
cli?: string;
|
|
15
|
+
/** Overrides a named declaration's model for this step only. No flow/project default exists for model. */
|
|
16
|
+
model?: string;
|
|
13
17
|
}
|
|
14
18
|
|
|
15
19
|
/**
|
package/src/flow.ts
CHANGED
|
@@ -1,5 +1,16 @@
|
|
|
1
1
|
import type { Ctx } from "./context.js";
|
|
2
2
|
|
|
3
|
+
/**
|
|
4
|
+
* A reusable agent CLI/model pair, selectable by name from `f.agent(name, ...)`.
|
|
5
|
+
* Both fields are required so selecting a named agent can never inherit a
|
|
6
|
+
* host model — mirrors the kernel-spec dialect's `NamedAgentSpec`
|
|
7
|
+
* (`packages/sdk/src/spec.ts`), which this compiles into.
|
|
8
|
+
*/
|
|
9
|
+
export interface NamedAgentDeclaration {
|
|
10
|
+
cli: string;
|
|
11
|
+
model: string;
|
|
12
|
+
}
|
|
13
|
+
|
|
3
14
|
/** Optional escalation header; the empty header is the common case. */
|
|
4
15
|
export interface FlowHeader {
|
|
5
16
|
identity?: string;
|
|
@@ -7,6 +18,7 @@ export interface FlowHeader {
|
|
|
7
18
|
budget?: string;
|
|
8
19
|
tools?: { relayfile?: string[]; mcp?: string[] };
|
|
9
20
|
workspace?: string;
|
|
21
|
+
agents?: Record<string, NamedAgentDeclaration>;
|
|
10
22
|
}
|
|
11
23
|
|
|
12
24
|
export type FlowBody<Input = unknown> = (f: Ctx, input: Input) => Promise<void>;
|
|
@@ -20,6 +32,7 @@ export interface ReadonlyFlowHeader {
|
|
|
20
32
|
mcp?: readonly string[];
|
|
21
33
|
}>;
|
|
22
34
|
readonly workspace?: string;
|
|
35
|
+
readonly agents?: Readonly<Record<string, Readonly<NamedAgentDeclaration>>>;
|
|
23
36
|
}
|
|
24
37
|
|
|
25
38
|
/** Immutable definition retained for the SDK's journal-backed runtime. */
|
|
@@ -119,6 +132,7 @@ function freezeHeader(header: FlowHeader): ReadonlyFlowHeader {
|
|
|
119
132
|
"budget",
|
|
120
133
|
"tools",
|
|
121
134
|
"workspace",
|
|
135
|
+
"agents",
|
|
122
136
|
].includes(field));
|
|
123
137
|
if (unknownFields.length > 0) {
|
|
124
138
|
throw new TypeError(`flow header has unknown fields: ${unknownFields.join(", ")}`);
|
|
@@ -136,12 +150,26 @@ function freezeHeader(header: FlowHeader): ReadonlyFlowHeader {
|
|
|
136
150
|
? {}
|
|
137
151
|
: { mcp: Object.freeze([...header.tools.mcp]) }),
|
|
138
152
|
});
|
|
153
|
+
const agents = header.agents === undefined
|
|
154
|
+
? undefined
|
|
155
|
+
: Object.freeze(
|
|
156
|
+
Object.fromEntries(
|
|
157
|
+
ownDataEntries(header.agents, "header.agents").map(([name, declaration]) => {
|
|
158
|
+
// Validated by assertFlowHeader's own ownDataEntries pass before
|
|
159
|
+
// this ever runs: exactly {cli, model}, both non-empty trimmed
|
|
160
|
+
// strings, read as data properties (never through a getter).
|
|
161
|
+
const record = declaration as NamedAgentDeclaration;
|
|
162
|
+
return [name, Object.freeze({ cli: record.cli, model: record.model })];
|
|
163
|
+
}),
|
|
164
|
+
),
|
|
165
|
+
);
|
|
139
166
|
return Object.freeze({
|
|
140
167
|
...(header.identity === undefined ? {} : { identity: header.identity }),
|
|
141
168
|
...(memory === undefined ? {} : { memory }),
|
|
142
169
|
...(header.budget === undefined ? {} : { budget: header.budget }),
|
|
143
170
|
...(tools === undefined ? {} : { tools }),
|
|
144
171
|
...(header.workspace === undefined ? {} : { workspace: header.workspace }),
|
|
172
|
+
...(agents === undefined ? {} : { agents }),
|
|
145
173
|
});
|
|
146
174
|
}
|
|
147
175
|
|
|
@@ -150,7 +178,7 @@ function assertFlowHeader(value: unknown, flowName: string): asserts value is Fl
|
|
|
150
178
|
assertHeaderObject(value, at);
|
|
151
179
|
assertKnownKeys(
|
|
152
180
|
value,
|
|
153
|
-
["identity", "memory", "budget", "tools", "workspace"],
|
|
181
|
+
["identity", "memory", "budget", "tools", "workspace", "agents"],
|
|
154
182
|
at,
|
|
155
183
|
);
|
|
156
184
|
assertOptionalString(value, "identity", at);
|
|
@@ -178,6 +206,48 @@ function assertFlowHeader(value: unknown, flowName: string): asserts value is Fl
|
|
|
178
206
|
assertOptionalStringArray(value.tools, "relayfile", `${at}.tools`);
|
|
179
207
|
assertOptionalStringArray(value.tools, "mcp", `${at}.tools`);
|
|
180
208
|
}
|
|
209
|
+
|
|
210
|
+
if (value.agents !== undefined) {
|
|
211
|
+
assertHeaderObject(value.agents, `${at}.agents`);
|
|
212
|
+
for (const [name, declaration] of ownDataEntries(value.agents, `${at}.agents`)) {
|
|
213
|
+
if (name !== name.trim() || name.length === 0) {
|
|
214
|
+
throw new TypeError(`${at}.agents: agent name ${JSON.stringify(name)} must be a non-empty, trimmed string`);
|
|
215
|
+
}
|
|
216
|
+
const declarationAt = `${at}.agents.${name}`;
|
|
217
|
+
assertHeaderObject(declaration, declarationAt);
|
|
218
|
+
assertKnownKeys(declaration, ["cli", "model"], declarationAt);
|
|
219
|
+
assertRequiredTrimmedString(declaration, "cli", declarationAt);
|
|
220
|
+
assertRequiredTrimmedString(declaration, "model", declarationAt);
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
/**
|
|
226
|
+
* Reads every own property of `value` via its descriptor rather than
|
|
227
|
+
* `Object.entries`/property access, so an accessor (getter) property is
|
|
228
|
+
* REJECTED — never invoked — instead of being enumerated as if it were
|
|
229
|
+
* ordinary data. `Object.entries` would call the getter, and a stateful
|
|
230
|
+
* getter can legally answer validation with one value and a second,
|
|
231
|
+
* unvalidated read (e.g. during freezing) with a different one — the closed
|
|
232
|
+
* declaration contract must not depend on a property being well-behaved
|
|
233
|
+
* across two separate reads.
|
|
234
|
+
*/
|
|
235
|
+
function ownDataEntries(
|
|
236
|
+
value: Record<string, unknown>,
|
|
237
|
+
at: string,
|
|
238
|
+
): [string, unknown][] {
|
|
239
|
+
const entries: [string, unknown][] = [];
|
|
240
|
+
for (const key of Reflect.ownKeys(value)) {
|
|
241
|
+
if (typeof key !== "string") {
|
|
242
|
+
throw new TypeError(`${at}: unknown field ${JSON.stringify(String(key))}`);
|
|
243
|
+
}
|
|
244
|
+
const descriptor = Object.getOwnPropertyDescriptor(value, key);
|
|
245
|
+
if (descriptor === undefined || !("value" in descriptor)) {
|
|
246
|
+
throw new TypeError(`${at}.${key}: expected a data property`);
|
|
247
|
+
}
|
|
248
|
+
entries.push([key, descriptor.value]);
|
|
249
|
+
}
|
|
250
|
+
return entries;
|
|
181
251
|
}
|
|
182
252
|
|
|
183
253
|
function assertHeaderObject(
|
|
@@ -220,6 +290,27 @@ function assertOptionalString(
|
|
|
220
290
|
}
|
|
221
291
|
}
|
|
222
292
|
|
|
293
|
+
/**
|
|
294
|
+
* Requires a trimmed, non-empty string — not merely non-empty-after-trim.
|
|
295
|
+
* The SDK's own project-config schema only accepts already-trimmed model/cli
|
|
296
|
+
* strings (`readProjectConfig`, cli/check.ts); accepting untrimmed values
|
|
297
|
+
* here would let a flow author declare " claude " and have it validate at
|
|
298
|
+
* authoring time but fail later at f.agent preflight, moving a defect from
|
|
299
|
+
* authoring to execution instead of catching it up front.
|
|
300
|
+
*/
|
|
301
|
+
function assertRequiredTrimmedString(
|
|
302
|
+
value: Record<string, unknown>,
|
|
303
|
+
key: string,
|
|
304
|
+
at: string,
|
|
305
|
+
): void {
|
|
306
|
+
if (typeof value[key] !== "string" || value[key].length === 0) {
|
|
307
|
+
throw new TypeError(`${at}.${key}: expected a non-empty string`);
|
|
308
|
+
}
|
|
309
|
+
if (value[key] !== value[key].trim()) {
|
|
310
|
+
throw new TypeError(`${at}.${key}: must not have leading or trailing whitespace`);
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
|
|
223
314
|
function assertOptionalBoolean(
|
|
224
315
|
value: Record<string, unknown>,
|
|
225
316
|
key: string,
|