@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.
Files changed (37) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +47 -1
  3. package/dist/{agent-compiler-BMpuJFAI.d.ts → agent-compiler-JSYkHpa7.d.ts} +2 -2
  4. package/dist/{delegation-scoring-CURe4oSL.d.ts → agent-orchestrator-BFWg2URC.d.ts} +11 -426
  5. package/dist/agent-runner-BUJKNNuI.d.ts +364 -0
  6. package/dist/agent-sse-handler-BRp9vHrb.d.ts +348 -0
  7. package/dist/{bridge-entry-BxJWDpQP.d.ts → bridge-entry-BNWDrPzg.d.ts} +8 -422
  8. package/dist/bridge.d.ts +8 -5
  9. package/dist/bridge.js +19 -15
  10. package/dist/{chunk-4PHZ25JN.js → chunk-3TE4PJZL.js} +62 -1137
  11. package/dist/chunk-3TE4PJZL.js.map +1 -0
  12. package/dist/{chunk-FIGLHWR2.js → chunk-4SXVNI5O.js} +7 -7
  13. package/dist/chunk-A2UVVEB3.js +799 -0
  14. package/dist/chunk-A2UVVEB3.js.map +1 -0
  15. package/dist/chunk-Z5SYU6Z6.js +353 -0
  16. package/dist/chunk-Z5SYU6Z6.js.map +1 -0
  17. package/dist/delegation-scoring-Cn5eM4lQ.d.ts +79 -0
  18. package/dist/evals.d.ts +84 -0
  19. package/dist/evals.js +191 -0
  20. package/dist/evals.js.map +1 -0
  21. package/dist/handoff.d.ts +91 -0
  22. package/dist/handoff.js +268 -0
  23. package/dist/handoff.js.map +1 -0
  24. package/dist/index.d.ts +19 -369
  25. package/dist/index.js +36 -32
  26. package/dist/index.js.map +1 -1
  27. package/dist/mcp-health.d.ts +1 -1
  28. package/dist/sdk-adapter-DQnKx7bA.d.ts +435 -0
  29. package/dist/testing.d.ts +2 -2
  30. package/dist/tools.d.ts +5 -3
  31. package/dist/tools.js +10 -6
  32. package/dist/tools.js.map +1 -1
  33. package/dist/{types-DdltPCj2.d.ts → types-D5cHmSLi.d.ts} +1 -1
  34. package/docs/capability-map.md +31 -1
  35. package/package.json +12 -2
  36. package/dist/chunk-4PHZ25JN.js.map +0 -1
  37. /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 };
@@ -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 };