@theokit/agents 16.0.0 → 16.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +26 -0
- package/README.md +47 -1
- package/dist/{agent-compiler-BMpuJFAI.d.ts → agent-compiler-JSYkHpa7.d.ts} +2 -2
- package/dist/{delegation-scoring-CURe4oSL.d.ts → agent-orchestrator-BFWg2URC.d.ts} +11 -426
- package/dist/agent-runner-BUJKNNuI.d.ts +364 -0
- package/dist/agent-sse-handler-BRp9vHrb.d.ts +348 -0
- package/dist/{bridge-entry-BxJWDpQP.d.ts → bridge-entry-BNWDrPzg.d.ts} +8 -422
- package/dist/bridge.d.ts +8 -5
- package/dist/bridge.js +19 -15
- package/dist/{chunk-4PHZ25JN.js → chunk-3TE4PJZL.js} +62 -1137
- package/dist/chunk-3TE4PJZL.js.map +1 -0
- package/dist/{chunk-FIGLHWR2.js → chunk-4SXVNI5O.js} +7 -7
- package/dist/chunk-A2UVVEB3.js +799 -0
- package/dist/chunk-A2UVVEB3.js.map +1 -0
- package/dist/chunk-Z5SYU6Z6.js +353 -0
- package/dist/chunk-Z5SYU6Z6.js.map +1 -0
- package/dist/delegation-scoring-Cn5eM4lQ.d.ts +79 -0
- package/dist/evals.d.ts +84 -0
- package/dist/evals.js +191 -0
- package/dist/evals.js.map +1 -0
- package/dist/handoff.d.ts +91 -0
- package/dist/handoff.js +268 -0
- package/dist/handoff.js.map +1 -0
- package/dist/index.d.ts +19 -369
- package/dist/index.js +36 -32
- package/dist/index.js.map +1 -1
- package/dist/mcp-health.d.ts +1 -1
- package/dist/sdk-adapter-DQnKx7bA.d.ts +435 -0
- package/dist/testing.d.ts +2 -2
- package/dist/tools.d.ts +5 -3
- package/dist/tools.js +10 -6
- package/dist/tools.js.map +1 -1
- package/dist/{types-DdltPCj2.d.ts → types-D5cHmSLi.d.ts} +1 -1
- package/docs/capability-map.md +31 -1
- package/package.json +12 -2
- package/dist/chunk-4PHZ25JN.js.map +0 -1
- /package/dist/{chunk-FIGLHWR2.js.map → chunk-4SXVNI5O.js.map} +0 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/loop/compaction-strategy.ts","../src/loop/loop-strategy.ts","../src/loop/reflection-strategy.ts","../src/bridge/delegation-types.ts","../src/guardrails/terminal-frame.ts","../src/loop/run-budget.ts","../src/loop/round-usage.ts","../src/loop/run-reflective-loop.ts","../src/loop/agent-runner.ts"],"mappings":"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","names":["compactTranscript","z","DEFAULT_KEEP_TOKENS","compactionStrategyConfigSchema","z","object","name","literal","keepTokens","number","int","positive","resolveCompactionStrategy","config","cfg","parse","compact","messages","options","compactTranscript","summarize","marker","summaryTemplate","failSafe","tokenBudgetCompactionStrategy","z","DEFAULT_MAX_ITERATIONS","maxIterationsSchema","z","number","int","min","loopStrategyConfigSchema","object","name","enum","maxIterations","assertValidCustomLoopStrategy","strategy","result","safeParse","success","Error","String","resolveLoopStrategy","cfg","parse","shouldContinue","outcome","round","finishReason","z","reflectionStrategyConfigSchema","object","name","string","min","ladderReflectionStrategy","reflect","outcome","finishReason","feedback","round","continue","noopReflectionStrategy","TheokitAgentError","budgetMessage","agentName","actualCost","budgetLimit","refusal","limit","toFixed","undefined","projectedRoundCost","DelegationBudgetExceededError","TheokitAgentError","name","code","isRetryable","DelegationBudgetCostUnknownError","knownSpend","costUnknown","BudgetExceededError","DelegationError","cause","Error","message","String","mirrorModeratedText","inner","round","sawText","step","next","done","event","value","type","content","result","refuseNextRound","spent","lastRound","ceiling","agentName","Number","isFinite","undefined","costKnown","DelegationBudgetCostUnknownError","cost","DelegationBudgetExceededError","projectedRoundCost","throwIfNextRoundRefused","signal","aborted","refusal","resolveRunBudget","budget","name","field","window","DelegationError","Error","maxCostUsd","isNaN","String","nothingToSpend","TOKEN_BUCKETS","DONE_USAGE_FIELDS","applyDone","event","r","costKnown","cost","Number","isFinite","usage","field","key","accumulateUsage","acc","costUnknown","tokens","bucket","asString","value","fallback","NO_PROGRESS_THRESHOLD","MAINLOOP_METRIC","TOOL_CALLS","STEP_LIMIT_HINT","stableStringify","undefined","JSON","stringify","Array","isArray","map","join","obj","entries","Object","keys","sort","a","b","localeCompare","k","roundSignature","toolCalls","tc","name","input","terminalReason","reflectionContinue","roundReason","round","maxIterations","CONTINUE_PROMPT","buildPrompt","message","feedback","hint","continuation","body","consumeRoundOrThrow","inputs","agentName","consumeOneRound","factory","prompt","sessionId","signal","retry","err","DelegationBudgetExceededError","DelegationError","GuardrailError","finalize","acc","reason","strategyName","rounds","finishReason","debugLog","strategy","terminal","deriveFinishReason","signals","sawError","sawDone","doneFinishReason","sawToolResult","pushToolResult","event","r","callInputs","id","callId","call","get","push","toolName","output","accumulateEvent","type","content","responseText","set","applyDone","errorMessage","startRound","open","it","Symbol","asyncIterator","first","next","return","Retry","run","cost","costKnown","tokens","tokensInput","tokensOutput","reasoningTokens","cacheReadTokens","cacheWriteTokens","Map","done","aborted","ceilingRoundFactory","m","s","disableTools","runReflectiveLoopStream","config","loop","reflection","budget","Number","POSITIVE_INFINITY","response","reflectionContext","prevSig","stuck","roundFactory","accumulateUsage","isFinite","length","sig","outcome","reflectionResult","reflect","continue","shouldContinue","throwIfNextRoundRefused","runReflectiveLoop","gen","res","AgentRunner","compiled","agentName","loopStrategy","loopStrategyIsCustom","reflectionStrategy","streamEnabled","compaction","state","fromSpec","spec","AgentRunnerBuilder","stream","message","opts","runOpts","budget","resolveRunBudget","guardrails","length","runUnguarded","m","streamUnguarded","guarded","safe","runInputGuards","mirrorModeratedText","moderateOutputStream","textPayloadExtractor","e","content","type","result","response","_content","text","_text","tools","loop","resolvePerRunLoop","maxIterations","streamFactory","createSdkAgentStream","apiKey","model","reasoningEffort","parseThinkTags","stripToolDialect","recoverLeakedToolCalls","cwd","baseDir","plugins","providers","agents","budgetTracker","sdkTools","sessionId","crypto","randomUUID","runReflectiveLoopStream","reflection","signal","retry","base","Object","assign","create","getPrototypeOf","resolveLoopStrategy","name","run","gen","res","next","done","value","reflectionOverride","compactionOverride","loopStrategyOverride","strategy","custom","assertValidCustomLoopStrategy","enabled","options","keepTokens","build","undefined","ladderReflectionStrategy","noopReflectionStrategy","compactionDecl","resolveCompactionStrategy"]}
|
|
@@ -0,0 +1,353 @@
|
|
|
1
|
+
import {
|
|
2
|
+
hooksPlugin,
|
|
3
|
+
inheritHooks
|
|
4
|
+
} from "./chunk-MJ6FRILJ.js";
|
|
5
|
+
import {
|
|
6
|
+
DelegationError,
|
|
7
|
+
ladderReflectionStrategy,
|
|
8
|
+
noopReflectionStrategy,
|
|
9
|
+
resolveLoopStrategy,
|
|
10
|
+
resolveRunBudget,
|
|
11
|
+
runReflectiveLoop
|
|
12
|
+
} from "./chunk-A2UVVEB3.js";
|
|
13
|
+
import {
|
|
14
|
+
createSdkAgentStream,
|
|
15
|
+
runInputGuards,
|
|
16
|
+
runOutputGuards
|
|
17
|
+
} from "./chunk-3TE4PJZL.js";
|
|
18
|
+
import {
|
|
19
|
+
__name
|
|
20
|
+
} from "./chunk-Z4QWC7IK.js";
|
|
21
|
+
|
|
22
|
+
// src/loop/goal-runner.ts
|
|
23
|
+
import { runGoalLoop } from "@theokit/sdk";
|
|
24
|
+
import { JudgeCredentialError } from "@theokit/sdk";
|
|
25
|
+
var GoalRunner = class {
|
|
26
|
+
static {
|
|
27
|
+
__name(this, "GoalRunner");
|
|
28
|
+
}
|
|
29
|
+
agent;
|
|
30
|
+
constructor(agent) {
|
|
31
|
+
this.agent = agent;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Drive `goal` to completion against the bound agent. Returns the SAME async generator `runGoalLoop`
|
|
35
|
+
* returns — yielding `GoalEvent`s, resolving a `GoalResult`. `deps` (judge/clock overrides) threads
|
|
36
|
+
* straight through; a test seam for the judge lives there, exactly as on the free function.
|
|
37
|
+
*/
|
|
38
|
+
run(goal, options, deps) {
|
|
39
|
+
return runGoalLoop(this.agent, goal, options, deps);
|
|
40
|
+
}
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
// src/loop/format-goal-event.ts
|
|
44
|
+
function formatGoalEvent(event) {
|
|
45
|
+
const candidate = event;
|
|
46
|
+
if (candidate === null || typeof candidate !== "object" || typeof candidate.type !== "string") {
|
|
47
|
+
return "[goal] unrecognised event (malformed)";
|
|
48
|
+
}
|
|
49
|
+
switch (event.type) {
|
|
50
|
+
case "turn_start":
|
|
51
|
+
return `[goal] turn ${event.turn} started \u2014 ${event.goal}`;
|
|
52
|
+
case "agent_response":
|
|
53
|
+
return `[goal] turn ${event.turn} response: ${event.content}`;
|
|
54
|
+
case "judge_verdict":
|
|
55
|
+
return `[goal] turn ${event.turn} judged ${event.verdict}: ${event.reason}` + // Surfaced rather than hidden: a verdict the judge could not parse reached a decision by
|
|
56
|
+
// fallback, and an operator reading the log needs to know which of the two happened.
|
|
57
|
+
(event.parseFailed ? " (verdict could not be parsed)" : "");
|
|
58
|
+
case "continuation":
|
|
59
|
+
return `[goal] turn ${event.turn} continuing: ${event.prompt}`;
|
|
60
|
+
case "status_change":
|
|
61
|
+
return `[goal] status ${event.status}: ${event.reason}`;
|
|
62
|
+
default:
|
|
63
|
+
return formatUnrecognised(event);
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
__name(formatGoalEvent, "formatGoalEvent");
|
|
67
|
+
function formatUnrecognised(event) {
|
|
68
|
+
const { type } = event;
|
|
69
|
+
return `[goal] unrecognised event: ${String(type)}`;
|
|
70
|
+
}
|
|
71
|
+
__name(formatUnrecognised, "formatUnrecognised");
|
|
72
|
+
|
|
73
|
+
// src/loop/pre-compaction.ts
|
|
74
|
+
import { TheokitAgentError } from "@theokit/sdk/errors";
|
|
75
|
+
var DEFAULT_HANDLER_TIMEOUT_MS = 3e4;
|
|
76
|
+
var PreCompactionHandlerError = class extends TheokitAgentError {
|
|
77
|
+
static {
|
|
78
|
+
__name(this, "PreCompactionHandlerError");
|
|
79
|
+
}
|
|
80
|
+
name = "PreCompactionHandlerError";
|
|
81
|
+
/** `'timeout'` when the bound was exceeded, `'threw'` when the handler failed on its own. */
|
|
82
|
+
reason;
|
|
83
|
+
constructor(message, reason, options) {
|
|
84
|
+
super(message, {
|
|
85
|
+
code: "PRE_COMPACTION_HANDLER_FAILED",
|
|
86
|
+
...options ?? {}
|
|
87
|
+
});
|
|
88
|
+
this.reason = reason;
|
|
89
|
+
}
|
|
90
|
+
};
|
|
91
|
+
function assertUsableTimeout(timeoutMs) {
|
|
92
|
+
if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
|
|
93
|
+
throw new TypeError(`withPreCompaction: timeoutMs must be a finite number greater than 0, received ${String(timeoutMs)}`);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
__name(assertUsableTimeout, "assertUsableTimeout");
|
|
97
|
+
async function runHandlerBounded(handler, messages, timeoutMs, onError) {
|
|
98
|
+
let timer;
|
|
99
|
+
const controller = new AbortController();
|
|
100
|
+
try {
|
|
101
|
+
await Promise.race([
|
|
102
|
+
Promise.resolve(handler(messages, controller.signal)),
|
|
103
|
+
new Promise((_resolve, reject) => {
|
|
104
|
+
timer = setTimeout(() => {
|
|
105
|
+
controller.abort();
|
|
106
|
+
reject(new PreCompactionHandlerError(`pre-compaction handler exceeded its ${String(timeoutMs)}ms bound; compaction proceeded without it`, "timeout"));
|
|
107
|
+
}, timeoutMs);
|
|
108
|
+
})
|
|
109
|
+
]);
|
|
110
|
+
} catch (cause) {
|
|
111
|
+
const detail = cause instanceof Error ? cause.message : String(cause);
|
|
112
|
+
const reported = cause instanceof PreCompactionHandlerError ? cause : new PreCompactionHandlerError(`pre-compaction handler failed: ${detail}`, "threw", {
|
|
113
|
+
cause
|
|
114
|
+
});
|
|
115
|
+
onError?.(reported);
|
|
116
|
+
} finally {
|
|
117
|
+
if (timer !== void 0) clearTimeout(timer);
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
__name(runHandlerBounded, "runHandlerBounded");
|
|
121
|
+
function withPreCompaction(strategy, handler, options) {
|
|
122
|
+
const timeoutMs = options?.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS;
|
|
123
|
+
assertUsableTimeout(timeoutMs);
|
|
124
|
+
const onError = options?.onError;
|
|
125
|
+
return {
|
|
126
|
+
name: strategy.name,
|
|
127
|
+
keepTokens: strategy.keepTokens,
|
|
128
|
+
compact: /* @__PURE__ */ __name(async (messages, callOptions) => {
|
|
129
|
+
await runHandlerBounded(handler, [
|
|
130
|
+
...messages
|
|
131
|
+
], timeoutMs, onError);
|
|
132
|
+
return strategy.compact(messages, callOptions);
|
|
133
|
+
}, "compact")
|
|
134
|
+
};
|
|
135
|
+
}
|
|
136
|
+
__name(withPreCompaction, "withPreCompaction");
|
|
137
|
+
|
|
138
|
+
// src/loop/decomposition.ts
|
|
139
|
+
function resolveDecomposition(callerSubgoals, declared) {
|
|
140
|
+
if (declared.length > 0) return declared;
|
|
141
|
+
return callerSubgoals;
|
|
142
|
+
}
|
|
143
|
+
__name(resolveDecomposition, "resolveDecomposition");
|
|
144
|
+
|
|
145
|
+
// src/bridge/agent-orchestrator.ts
|
|
146
|
+
function requireApiKey(opts, agentName) {
|
|
147
|
+
if (opts.apiKey === null) return "";
|
|
148
|
+
const apiKey = opts.apiKey ?? "";
|
|
149
|
+
if (!apiKey) {
|
|
150
|
+
throw new DelegationError(agentName, "No API key provided. Pass apiKey in DelegateOptions, or `apiKey: null` when the provider takes no credential (a local model).");
|
|
151
|
+
}
|
|
152
|
+
return apiKey;
|
|
153
|
+
}
|
|
154
|
+
__name(requireApiKey, "requireApiKey");
|
|
155
|
+
function withInheritedHooks(compiled, parentHooks) {
|
|
156
|
+
const plugin = hooksPlugin(inheritHooks(parentHooks, void 0));
|
|
157
|
+
if (plugin === void 0) return compiled;
|
|
158
|
+
return {
|
|
159
|
+
...compiled,
|
|
160
|
+
plugins: [
|
|
161
|
+
...compiled.plugins ?? [],
|
|
162
|
+
plugin
|
|
163
|
+
]
|
|
164
|
+
};
|
|
165
|
+
}
|
|
166
|
+
__name(withInheritedHooks, "withInheritedHooks");
|
|
167
|
+
function mergeTools(parentTools, subTools) {
|
|
168
|
+
const subToolNames = new Set(subTools.map((t) => t.name));
|
|
169
|
+
const inherited = parentTools.filter((t) => !subToolNames.has(t.name));
|
|
170
|
+
return [
|
|
171
|
+
...inherited,
|
|
172
|
+
...subTools
|
|
173
|
+
];
|
|
174
|
+
}
|
|
175
|
+
__name(mergeTools, "mergeTools");
|
|
176
|
+
async function delegate(spec, message, opts = {}) {
|
|
177
|
+
const apiKey = requireApiKey(opts, spec.name);
|
|
178
|
+
const budget = Math.min(resolveRunBudget(opts.budget, spec.name) ?? Infinity, resolveRunBudget(opts.parentBudgetRemaining, spec.name, "parentBudgetRemaining") ?? Infinity);
|
|
179
|
+
const rewritten = opts.onDelegationStart ? await opts.onDelegationStart({
|
|
180
|
+
subAgent: spec.name,
|
|
181
|
+
input: message
|
|
182
|
+
}) : message;
|
|
183
|
+
const { compiled } = spec;
|
|
184
|
+
const guardrails = compiled.guardrails ?? [];
|
|
185
|
+
const effectiveMessage = await runInputGuards(rewritten, guardrails);
|
|
186
|
+
const allTools = mergeTools(opts.parentTools ?? [], compiled.tools);
|
|
187
|
+
const compiledForMember = withInheritedHooks(compiled, opts.parentHooks);
|
|
188
|
+
const streamFactory = opts.streamFactory ?? createSdkAgentStream(compiledForMember, allTools, apiKey, {
|
|
189
|
+
model: opts.model ?? compiled.model,
|
|
190
|
+
cwd: opts.cwd,
|
|
191
|
+
plugins: opts.plugins,
|
|
192
|
+
providers: opts.providers,
|
|
193
|
+
agents: opts.agents,
|
|
194
|
+
budgetTracker: opts.budgetTracker,
|
|
195
|
+
sdkTools: opts.sdkTools
|
|
196
|
+
});
|
|
197
|
+
const sessionId = opts.sessionId ?? `sub-${crypto.randomUUID()}`;
|
|
198
|
+
const loopStrategy = resolveLoopStrategy(spec.strategy ?? "simple-chat", opts.maxIterations ?? spec.maxIterations);
|
|
199
|
+
const reflection = opts.reflection ?? (loopStrategy.name === "plan-act-reflect" ? ladderReflectionStrategy : noopReflectionStrategy);
|
|
200
|
+
const result = await runReflectiveLoop(streamFactory, effectiveMessage, sessionId, {
|
|
201
|
+
loop: loopStrategy,
|
|
202
|
+
reflection,
|
|
203
|
+
budget,
|
|
204
|
+
agentName: spec.name,
|
|
205
|
+
signal: opts.signal,
|
|
206
|
+
retry: opts.retry
|
|
207
|
+
});
|
|
208
|
+
const transformed = opts.onDelegationComplete ? await opts.onDelegationComplete({
|
|
209
|
+
subAgent: spec.name,
|
|
210
|
+
result
|
|
211
|
+
}) : result;
|
|
212
|
+
return await moderateDelegationResult(transformed, guardrails);
|
|
213
|
+
}
|
|
214
|
+
__name(delegate, "delegate");
|
|
215
|
+
async function moderateDelegationResult(result, guardrails) {
|
|
216
|
+
if (guardrails.length === 0) return result;
|
|
217
|
+
return {
|
|
218
|
+
...result,
|
|
219
|
+
response: await runOutputGuards(result.response, guardrails)
|
|
220
|
+
};
|
|
221
|
+
}
|
|
222
|
+
__name(moderateDelegationResult, "moderateDelegationResult");
|
|
223
|
+
|
|
224
|
+
// src/bridge/delegation-lifecycle.ts
|
|
225
|
+
import { TheokitAgentError as TheokitAgentError2 } from "@theokit/sdk/errors";
|
|
226
|
+
var DelegationTimeoutError = class extends TheokitAgentError2 {
|
|
227
|
+
static {
|
|
228
|
+
__name(this, "DelegationTimeoutError");
|
|
229
|
+
}
|
|
230
|
+
name = "DelegationTimeoutError";
|
|
231
|
+
constructor(subAgent, timeoutMs) {
|
|
232
|
+
super(`delegation to "${subAgent}" exceeded its ${String(timeoutMs)} ms clock cap. This is a WALL CLOCK limit, not a budget: the run may have been progressing and simply slow, or hung. Raise \`timeoutMs\` if the work legitimately takes longer.`, {
|
|
233
|
+
code: "DELEGATION_TIMEOUT",
|
|
234
|
+
// A hang is often transient — the model, a tool or a network call. Unlike the budget errors,
|
|
235
|
+
// this one is worth another attempt, which is exactly why it is a separate class.
|
|
236
|
+
isRetryable: true
|
|
237
|
+
});
|
|
238
|
+
}
|
|
239
|
+
};
|
|
240
|
+
async function withClockCap(promise, timeoutMs, subAgent) {
|
|
241
|
+
let timer;
|
|
242
|
+
const clock = new Promise((_resolve, reject) => {
|
|
243
|
+
timer = setTimeout(() => {
|
|
244
|
+
reject(new DelegationTimeoutError(subAgent, timeoutMs));
|
|
245
|
+
}, timeoutMs);
|
|
246
|
+
});
|
|
247
|
+
try {
|
|
248
|
+
return await Promise.race([
|
|
249
|
+
promise,
|
|
250
|
+
clock
|
|
251
|
+
]);
|
|
252
|
+
} finally {
|
|
253
|
+
if (timer !== void 0) clearTimeout(timer);
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
__name(withClockCap, "withClockCap");
|
|
257
|
+
async function withEphemeralAgent(create, body, options = {}) {
|
|
258
|
+
const { agent, dispose } = await create();
|
|
259
|
+
try {
|
|
260
|
+
return await body(agent);
|
|
261
|
+
} finally {
|
|
262
|
+
try {
|
|
263
|
+
await dispose();
|
|
264
|
+
} catch (error) {
|
|
265
|
+
options.onDisposeError?.(error);
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
__name(withEphemeralAgent, "withEphemeralAgent");
|
|
270
|
+
|
|
271
|
+
// src/bridge/delegation-scoring.ts
|
|
272
|
+
function isPort(target) {
|
|
273
|
+
if ("compiled" in target) return false;
|
|
274
|
+
return typeof target.run === "function";
|
|
275
|
+
}
|
|
276
|
+
__name(isPort, "isPort");
|
|
277
|
+
async function runOnce(target, message, delegateFn, opts) {
|
|
278
|
+
const port = isPort(target);
|
|
279
|
+
const started = port ? target.run(message) : delegateFn(target, message, opts);
|
|
280
|
+
if (opts.timeoutMs === void 0) return started;
|
|
281
|
+
return withClockCap(started, opts.timeoutMs, port ? "port" : target.name);
|
|
282
|
+
}
|
|
283
|
+
__name(runOnce, "runOnce");
|
|
284
|
+
function delegateBackground(subAgent, message, opts = {}) {
|
|
285
|
+
const { delegateFn = delegate, ...delegateOpts } = opts;
|
|
286
|
+
let isSettled = false;
|
|
287
|
+
const promise = runOnce(subAgent, message, delegateFn, delegateOpts).finally(() => {
|
|
288
|
+
isSettled = true;
|
|
289
|
+
});
|
|
290
|
+
promise.catch(() => void 0);
|
|
291
|
+
return {
|
|
292
|
+
wait: /* @__PURE__ */ __name(() => promise, "wait"),
|
|
293
|
+
settled: /* @__PURE__ */ __name(() => isSettled, "settled")
|
|
294
|
+
};
|
|
295
|
+
}
|
|
296
|
+
__name(delegateBackground, "delegateBackground");
|
|
297
|
+
var DEFAULT_MAX_ROUNDS = 3;
|
|
298
|
+
function defaultFeedbackTemplate(message, feedback) {
|
|
299
|
+
return `${message}
|
|
300
|
+
|
|
301
|
+
Feedback from the reviewer (address this): ${feedback}`;
|
|
302
|
+
}
|
|
303
|
+
__name(defaultFeedbackTemplate, "defaultFeedbackTemplate");
|
|
304
|
+
async function delegateWithScoring(subAgent, message, opts) {
|
|
305
|
+
const { scorer, maxRounds: maxRoundsOpt = DEFAULT_MAX_ROUNDS, delegateFn = delegate, feedbackTemplate = defaultFeedbackTemplate, ...delegateOpts } = opts;
|
|
306
|
+
const maxRounds = Math.max(1, maxRoundsOpt);
|
|
307
|
+
const verdicts = [];
|
|
308
|
+
let currentMessage = message;
|
|
309
|
+
let lastResult;
|
|
310
|
+
for (let round = 1; round <= maxRounds; round++) {
|
|
311
|
+
const result = await runOnce(subAgent, currentMessage, delegateFn, delegateOpts);
|
|
312
|
+
lastResult = result;
|
|
313
|
+
const verdict = await scorer(result);
|
|
314
|
+
verdicts.push(verdict);
|
|
315
|
+
if (verdict.pass) {
|
|
316
|
+
return {
|
|
317
|
+
result,
|
|
318
|
+
rounds: round,
|
|
319
|
+
passed: true,
|
|
320
|
+
verdicts
|
|
321
|
+
};
|
|
322
|
+
}
|
|
323
|
+
if (verdict.feedback) currentMessage = feedbackTemplate(message, verdict.feedback);
|
|
324
|
+
}
|
|
325
|
+
if (lastResult === void 0) {
|
|
326
|
+
throw new Error("[@theokit/agents] delegateWithScoring: no round ran (maxRounds < 1)");
|
|
327
|
+
}
|
|
328
|
+
return {
|
|
329
|
+
result: lastResult,
|
|
330
|
+
rounds: maxRounds,
|
|
331
|
+
passed: false,
|
|
332
|
+
verdicts
|
|
333
|
+
};
|
|
334
|
+
}
|
|
335
|
+
__name(delegateWithScoring, "delegateWithScoring");
|
|
336
|
+
|
|
337
|
+
export {
|
|
338
|
+
GoalRunner,
|
|
339
|
+
JudgeCredentialError,
|
|
340
|
+
formatGoalEvent,
|
|
341
|
+
DEFAULT_HANDLER_TIMEOUT_MS,
|
|
342
|
+
PreCompactionHandlerError,
|
|
343
|
+
withPreCompaction,
|
|
344
|
+
resolveDecomposition,
|
|
345
|
+
delegate,
|
|
346
|
+
DelegationTimeoutError,
|
|
347
|
+
withClockCap,
|
|
348
|
+
withEphemeralAgent,
|
|
349
|
+
isPort,
|
|
350
|
+
delegateBackground,
|
|
351
|
+
delegateWithScoring
|
|
352
|
+
};
|
|
353
|
+
//# sourceMappingURL=chunk-Z5SYU6Z6.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/loop/goal-runner.ts","../src/loop/format-goal-event.ts","../src/loop/pre-compaction.ts","../src/loop/decomposition.ts","../src/bridge/agent-orchestrator.ts","../src/bridge/delegation-lifecycle.ts","../src/bridge/delegation-scoring.ts"],"mappings":"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","names":["runGoalLoop","JudgeCredentialError","GoalRunner","agent","run","goal","options","deps","runGoalLoop","formatGoalEvent","event","candidate","type","turn","goal","content","verdict","reason","parseFailed","prompt","status","formatUnrecognised","String","TheokitAgentError","DEFAULT_HANDLER_TIMEOUT_MS","PreCompactionHandlerError","TheokitAgentError","name","reason","message","options","code","assertUsableTimeout","timeoutMs","Number","isFinite","TypeError","String","runHandlerBounded","handler","messages","onError","timer","controller","AbortController","Promise","race","resolve","signal","_resolve","reject","setTimeout","abort","cause","detail","Error","reported","undefined","clearTimeout","withPreCompaction","strategy","keepTokens","compact","callOptions","resolveDecomposition","callerSubgoals","declared","length","requireApiKey","opts","agentName","apiKey","DelegationError","withInheritedHooks","compiled","parentHooks","plugin","hooksPlugin","inheritHooks","undefined","plugins","mergeTools","parentTools","subTools","subToolNames","Set","map","t","name","inherited","filter","has","delegate","spec","message","budget","Math","min","resolveRunBudget","Infinity","parentBudgetRemaining","rewritten","onDelegationStart","subAgent","input","guardrails","effectiveMessage","runInputGuards","allTools","tools","compiledForMember","streamFactory","createSdkAgentStream","model","cwd","providers","agents","budgetTracker","sdkTools","sessionId","crypto","randomUUID","loopStrategy","resolveLoopStrategy","strategy","maxIterations","reflection","ladderReflectionStrategy","noopReflectionStrategy","result","runReflectiveLoop","loop","signal","retry","transformed","onDelegationComplete","moderateDelegationResult","length","response","runOutputGuards","TheokitAgentError","DelegationTimeoutError","TheokitAgentError","name","subAgent","timeoutMs","String","code","isRetryable","withClockCap","promise","timer","clock","Promise","_resolve","reject","setTimeout","race","undefined","clearTimeout","withEphemeralAgent","create","body","options","agent","dispose","error","onDisposeError","isPort","target","run","runOnce","message","delegateFn","opts","port","started","timeoutMs","undefined","withClockCap","name","delegateBackground","subAgent","delegate","delegateOpts","isSettled","promise","finally","catch","wait","settled","DEFAULT_MAX_ROUNDS","defaultFeedbackTemplate","feedback","delegateWithScoring","scorer","maxRounds","maxRoundsOpt","feedbackTemplate","Math","max","verdicts","currentMessage","lastResult","round","result","verdict","push","pass","rounds","passed","Error"]}
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
import { D as DelegationResult, S as SubAgentSpec, a as DelegateOptions } from './agent-orchestrator-BFWg2URC.js';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* M25 (theokit-ai-first) — background delegation + task-completion scoring.
|
|
5
|
+
*
|
|
6
|
+
* Two THIN wrappers over the M12 `delegate` (ADR 0038/0040): no new orchestration engine, no second
|
|
7
|
+
* loop, no new store. `delegateBackground` kicks off a sub-agent without blocking the supervisor and
|
|
8
|
+
* hands back a handle to await later. `delegateWithScoring` runs `delegate`, scores the result with
|
|
9
|
+
* an injected scorer, and re-delegates with the scorer's feedback until it passes or `maxRounds` is
|
|
10
|
+
* hit. The `delegate` implementation is injectable (`delegateFn`) so this is testable without a
|
|
11
|
+
* SubAgent class or an LLM — and so it NEVER re-implements the delegation runtime.
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* M81 — anything that can run a delegation.
|
|
16
|
+
*
|
|
17
|
+
* The reach gap this closes: both wrappers took a `SubAgentSpec` produced by the capability
|
|
18
|
+
* compiler, so a consumer holding an SDK `SubAgent` or `Squad` could not feed them. That is why the
|
|
19
|
+
* scoring loop — the layer's highest-value piece — had ZERO adoption in a product that runs an
|
|
20
|
+
* explicit review pass: it was unreachable from the primitives that product actually holds.
|
|
21
|
+
*
|
|
22
|
+
* An SDK `SubAgent` or `Squad` satisfies this by having `run`. So does a test double, which is why
|
|
23
|
+
* the loop is now testable without a compiler, a class or an LLM.
|
|
24
|
+
*/
|
|
25
|
+
interface DelegationPort {
|
|
26
|
+
run(message: string): Promise<DelegationResult>;
|
|
27
|
+
}
|
|
28
|
+
/** What both wrappers accept: the compiled spec (unchanged) or the port (M81, additive). */
|
|
29
|
+
type DelegationTarget = SubAgentSpec | DelegationPort;
|
|
30
|
+
/** The delegation primitive both wrappers drive. Defaults to the M12 {@link delegate}. */
|
|
31
|
+
type DelegateFn = (subAgent: SubAgentSpec, message: string, opts?: DelegateOptions) => Promise<DelegationResult>;
|
|
32
|
+
/** A running background delegation the supervisor can await/poll later. */
|
|
33
|
+
interface BackgroundDelegation {
|
|
34
|
+
/** Await the sub-agent's result (or rejection). Idempotent — returns the same settled promise. */
|
|
35
|
+
wait(): Promise<DelegationResult>;
|
|
36
|
+
/** Whether the underlying delegation has resolved or rejected. */
|
|
37
|
+
settled(): boolean;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Start a sub-agent WITHOUT blocking the supervisor. Returns immediately with a handle; the
|
|
41
|
+
* supervisor keeps working and calls `wait()` when it needs the result. A thin async wrapper over
|
|
42
|
+
* `delegate` — not a scheduler (Top-risk 1). Rejections are still observable via `wait()`.
|
|
43
|
+
*/
|
|
44
|
+
declare function delegateBackground(subAgent: DelegationTarget, message: string, opts?: DelegateOptions & {
|
|
45
|
+
delegateFn?: DelegateFn;
|
|
46
|
+
}): BackgroundDelegation;
|
|
47
|
+
/** A scorer's verdict on a sub-agent result. `feedback` is fed back into the next round on failure. */
|
|
48
|
+
interface ScoreVerdict {
|
|
49
|
+
pass: boolean;
|
|
50
|
+
/** Optional numeric score (0..1) for logging/telemetry. */
|
|
51
|
+
score?: number;
|
|
52
|
+
/** Guidance appended to the next delegation when `pass` is false. */
|
|
53
|
+
feedback?: string;
|
|
54
|
+
}
|
|
55
|
+
/** Scores a sub-agent result. Opt-in (Top-risk 2) — the caller supplies it, and pays its cost. */
|
|
56
|
+
type Scorer = (result: DelegationResult) => ScoreVerdict | Promise<ScoreVerdict>;
|
|
57
|
+
/** The outcome of a scored delegation: the final result plus the per-round verdict trail. */
|
|
58
|
+
interface ScoredDelegation {
|
|
59
|
+
result: DelegationResult;
|
|
60
|
+
/** Rounds actually run (1..maxRounds). */
|
|
61
|
+
rounds: number;
|
|
62
|
+
/** Whether the final round passed the scorer. */
|
|
63
|
+
passed: boolean;
|
|
64
|
+
/** The verdict from each round, in order. */
|
|
65
|
+
verdicts: ScoreVerdict[];
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Run `delegate`, score the result, and re-delegate with the scorer's feedback until it passes or
|
|
69
|
+
* `maxRounds` is reached. Each round is ONE `delegate` call — no second loop, no new store. Returns
|
|
70
|
+
* the final result (passing, or the last attempt) with the per-round verdict trail.
|
|
71
|
+
*/
|
|
72
|
+
declare function delegateWithScoring(subAgent: DelegationTarget, message: string, opts: DelegateOptions & {
|
|
73
|
+
scorer: Scorer;
|
|
74
|
+
maxRounds?: number;
|
|
75
|
+
delegateFn?: DelegateFn;
|
|
76
|
+
feedbackTemplate?: (message: string, feedback: string) => string;
|
|
77
|
+
}): Promise<ScoredDelegation>;
|
|
78
|
+
|
|
79
|
+
export { type BackgroundDelegation as B, type DelegationTarget as D, type ScoreVerdict as S, type DelegateFn as a, type DelegationPort as b, type ScoredDelegation as c, type Scorer as d, delegateBackground as e, delegateWithScoring as f };
|
package/dist/evals.d.ts
ADDED
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import { TheokitAgentError } from '@theokit/sdk/errors';
|
|
2
|
+
import { Scorer, NamedScorer } from '@theokit/sdk/eval';
|
|
3
|
+
export { EvalAlreadyRunningError, NamedScorer, Scorer, Scorers } from '@theokit/sdk/eval';
|
|
4
|
+
import { D as DefinitionOrThunk, A as ApprovalPosture, R as RuntimeOverrides } from './sdk-adapter-DQnKx7bA.js';
|
|
5
|
+
import '@theokit/sdk';
|
|
6
|
+
import '@theokit/sdk/retry';
|
|
7
|
+
import './types-D5cHmSLi.js';
|
|
8
|
+
import 'zod';
|
|
9
|
+
import './agent-compiler-JSYkHpa7.js';
|
|
10
|
+
import '@theokit/sdk/subagents-loader';
|
|
11
|
+
import './setting-sources-gate-BJJiKq33.js';
|
|
12
|
+
import './hook-handlers-Cw2FsnE5.js';
|
|
13
|
+
import './agent-sse-handler-BRp9vHrb.js';
|
|
14
|
+
import '@theokit/presenter/wire';
|
|
15
|
+
import '@theokit/sdk/sandbox';
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* B-413 — run a list of cases against a theokit agent definition and read a verdict per case.
|
|
19
|
+
*
|
|
20
|
+
* This is a layer over the SDK's `Eval` runner, not a second runner (ADR D1): the SDK runs each case,
|
|
21
|
+
* scores it and isolates its failure; this module builds each case's agent through
|
|
22
|
+
* {@link toAgentFactory}, disposes what it built, and maps every returned row to `pass`, `fail` or
|
|
23
|
+
* `error`.
|
|
24
|
+
*
|
|
25
|
+
* `error` means nobody measured the answer: the run did not finish, a guard stopped the turn, the
|
|
26
|
+
* factory threw, or a scorer threw or returned something that is not a score within [0, 1] (ADR D2).
|
|
27
|
+
* Such a case is never counted as `fail`, which would tell the caller the agent answered badly.
|
|
28
|
+
*/
|
|
29
|
+
|
|
30
|
+
/** One input the caller wants checked; the SDK calls it a dataset entry. */
|
|
31
|
+
interface AgentEvalCase {
|
|
32
|
+
input: string;
|
|
33
|
+
expected?: unknown;
|
|
34
|
+
}
|
|
35
|
+
/** This layer's answer for one case. */
|
|
36
|
+
type AgentEvalVerdict = 'pass' | 'fail' | 'error';
|
|
37
|
+
interface AgentEvalCaseResult {
|
|
38
|
+
index: number;
|
|
39
|
+
input: string;
|
|
40
|
+
expected?: unknown;
|
|
41
|
+
output: string;
|
|
42
|
+
verdict: AgentEvalVerdict;
|
|
43
|
+
meanScore: number;
|
|
44
|
+
scores: readonly {
|
|
45
|
+
readonly name: string;
|
|
46
|
+
readonly score: number;
|
|
47
|
+
readonly reason?: string;
|
|
48
|
+
}[];
|
|
49
|
+
/** Why the case is an `error`; absent on `pass` and `fail`. */
|
|
50
|
+
error?: string;
|
|
51
|
+
durationMs: number;
|
|
52
|
+
}
|
|
53
|
+
interface AgentEvalResult {
|
|
54
|
+
name: string;
|
|
55
|
+
threshold: number;
|
|
56
|
+
cases: AgentEvalCaseResult[];
|
|
57
|
+
counts: {
|
|
58
|
+
pass: number;
|
|
59
|
+
fail: number;
|
|
60
|
+
error: number;
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
interface RunAgentEvalsOptions {
|
|
64
|
+
/** The definition under test, or a per-session thunk that returns one. */
|
|
65
|
+
agent: DefinitionOrThunk;
|
|
66
|
+
apiKey: string | (() => string | Promise<string>);
|
|
67
|
+
/** Mandatory, as on {@link toAgentFactory}: what a gated tool's approval request gets (ADR D3). */
|
|
68
|
+
approvals: ApprovalPosture;
|
|
69
|
+
cases: readonly AgentEvalCase[];
|
|
70
|
+
scorers: readonly (Scorer | NamedScorer)[];
|
|
71
|
+
/** A case passes when its mean score is at or above this. Within [0, 1]; default 0.5. */
|
|
72
|
+
threshold?: number;
|
|
73
|
+
/** The SDK run's name. Default `theokit-agent-evals-<uuid>`, so unnamed runs never collide (ADR D4). */
|
|
74
|
+
name?: string;
|
|
75
|
+
overrides?: RuntimeOverrides;
|
|
76
|
+
}
|
|
77
|
+
/** A configuration `runAgentEvals` refuses before it builds any agent. */
|
|
78
|
+
declare class EvalConfigError extends TheokitAgentError {
|
|
79
|
+
readonly name = "EvalConfigError";
|
|
80
|
+
constructor(message: string);
|
|
81
|
+
}
|
|
82
|
+
declare function runAgentEvals(opts: RunAgentEvalsOptions): Promise<AgentEvalResult>;
|
|
83
|
+
|
|
84
|
+
export { type AgentEvalCase, type AgentEvalCaseResult, type AgentEvalResult, type AgentEvalVerdict, EvalConfigError, type RunAgentEvalsOptions, runAgentEvals };
|