@theokit/agents 16.3.0 → 16.5.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 (52) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/dist/a2a.d.ts +33 -1
  3. package/dist/a2a.js +353 -3
  4. package/dist/a2a.js.map +1 -1
  5. package/dist/{agent-compiler-JSYkHpa7.d.ts → agent-compiler-C-4X_vKz.d.ts} +1 -51
  6. package/dist/{agent-orchestrator-BFWg2URC.d.ts → agent-orchestrator-BHF1bS6k.d.ts} +1 -1
  7. package/dist/{agent-runner-BUJKNNuI.d.ts → agent-runner-BoMoOnHV.d.ts} +2 -2
  8. package/dist/auth.d.ts +5 -4
  9. package/dist/auth.js.map +1 -1
  10. package/dist/{bridge-entry-BNWDrPzg.d.ts → bridge-entry-DO1LjHkc.d.ts} +215 -8
  11. package/dist/bridge.d.ts +6 -6
  12. package/dist/bridge.js +25 -9
  13. package/dist/{chunk-A7RXWJZE.js → chunk-AZ2FOUSN.js} +450 -476
  14. package/dist/chunk-AZ2FOUSN.js.map +1 -0
  15. package/dist/{chunk-MB23MSOK.js → chunk-K4MY4CV7.js} +45 -22
  16. package/dist/chunk-K4MY4CV7.js.map +1 -0
  17. package/dist/{chunk-CJMYZKUL.js → chunk-RZWD73QG.js} +429 -14
  18. package/dist/chunk-RZWD73QG.js.map +1 -0
  19. package/dist/{chunk-SAKSZKVK.js → chunk-ZLKZOSWR.js} +39 -17
  20. package/dist/chunk-ZLKZOSWR.js.map +1 -0
  21. package/dist/code-mode-quickjs.d.ts +33 -0
  22. package/dist/code-mode-quickjs.js +353 -0
  23. package/dist/code-mode-quickjs.js.map +1 -0
  24. package/dist/code-mode.d.ts +110 -0
  25. package/dist/code-mode.js +165 -0
  26. package/dist/code-mode.js.map +1 -0
  27. package/dist/{delegation-scoring-Cn5eM4lQ.d.ts → delegation-scoring-BBPJ9eug.d.ts} +8 -2
  28. package/dist/evals.d.ts +2 -2
  29. package/dist/evals.js +3 -1
  30. package/dist/evals.js.map +1 -1
  31. package/dist/handoff.d.ts +3 -3
  32. package/dist/handoff.js +2 -2
  33. package/dist/index.d.ts +25 -10
  34. package/dist/index.js +31 -9
  35. package/dist/index.js.map +1 -1
  36. package/dist/persistence.d.ts +1 -1
  37. package/dist/persistence.js +2 -1
  38. package/dist/persistence.js.map +1 -1
  39. package/dist/sandbox.d.ts +1 -1
  40. package/dist/sandbox.js +2 -0
  41. package/dist/sandbox.js.map +1 -1
  42. package/dist/{sdk-adapter-DQnKx7bA.d.ts → sdk-adapter-C57SpmLH.d.ts} +3 -1
  43. package/dist/testing.d.ts +1 -1
  44. package/dist/tools.d.ts +140 -5
  45. package/dist/tools.js +591 -29
  46. package/dist/tools.js.map +1 -1
  47. package/docs/capability-map.md +80 -6
  48. package/package.json +23 -5
  49. package/dist/chunk-A7RXWJZE.js.map +0 -1
  50. package/dist/chunk-CJMYZKUL.js.map +0 -1
  51. package/dist/chunk-MB23MSOK.js.map +0 -1
  52. package/dist/chunk-SAKSZKVK.js.map +0 -1
@@ -4,7 +4,7 @@ import {
4
4
  moderateOutputStream,
5
5
  runInputGuards,
6
6
  textPayloadExtractor
7
- } from "./chunk-A7RXWJZE.js";
7
+ } from "./chunk-AZ2FOUSN.js";
8
8
  import {
9
9
  debugLog
10
10
  } from "./chunk-M5J3Q6YC.js";
@@ -464,9 +464,15 @@ function ceilingRoundFactory(factory, round, maxIterations) {
464
464
  });
465
465
  }
466
466
  __name(ceilingRoundFactory, "ceilingRoundFactory");
467
- async function* runReflectiveLoopStream(factory, message, sessionId, config) {
468
- const { loop, reflection, budget = Number.POSITIVE_INFINITY, signal, agentName = loop.name, retry } = config;
469
- const acc = {
467
+ function resolveBudgetAndName(config) {
468
+ return {
469
+ budget: config.budget ?? Number.POSITIVE_INFINITY,
470
+ agentName: config.agentName ?? config.loop.name
471
+ };
472
+ }
473
+ __name(resolveBudgetAndName, "resolveBudgetAndName");
474
+ function emptyDelegationResult() {
475
+ return {
470
476
  response: "",
471
477
  toolCalls: [],
472
478
  cost: 0,
@@ -478,11 +484,35 @@ async function* runReflectiveLoopStream(factory, message, sessionId, config) {
478
484
  cacheWriteTokens: 0,
479
485
  rounds: 0
480
486
  };
487
+ }
488
+ __name(emptyDelegationResult, "emptyDelegationResult");
489
+ function throwIfRoundFailed(acc, r, budget, agentName) {
490
+ if (r.finishReason === "error") throw new DelegationError(agentName, r.errorMessage);
491
+ if (Number.isFinite(budget) && acc.cost > budget) {
492
+ throw new DelegationBudgetExceededError(agentName, acc.cost, budget);
493
+ }
494
+ }
495
+ __name(throwIfRoundFailed, "throwIfRoundFailed");
496
+ function isNoProgress(p, r) {
497
+ if (r.finishReason !== TOOL_CALLS || r.toolCalls.length === 0) return false;
498
+ const sig = roundSignature(r.toolCalls);
499
+ p.stuck = sig === p.prevSig ? p.stuck + 1 : 0;
500
+ if (p.stuck >= NO_PROGRESS_THRESHOLD) return true;
501
+ p.prevSig = sig;
502
+ return false;
503
+ }
504
+ __name(isNoProgress, "isNoProgress");
505
+ async function* runReflectiveLoopStream(factory, message, sessionId, config) {
506
+ const { loop, reflection, signal, retry } = config;
507
+ const { budget, agentName } = resolveBudgetAndName(config);
508
+ const acc = emptyDelegationResult();
481
509
  const reflectionContext = {};
482
510
  let round = 1;
483
511
  let feedback;
484
- let prevSig;
485
- let stuck = 0;
512
+ const progress = {
513
+ prevSig: void 0,
514
+ stuck: 0
515
+ };
486
516
  while (!signal?.aborted) {
487
517
  const prompt = buildPrompt(round, loop.maxIterations, message, feedback);
488
518
  const roundFactory = ceilingRoundFactory(factory, round, loop.maxIterations);
@@ -496,16 +526,8 @@ async function* runReflectiveLoopStream(factory, message, sessionId, config) {
496
526
  acc.response += r.responseText;
497
527
  acc.toolCalls.push(...r.toolCalls);
498
528
  accumulateUsage(acc, r);
499
- if (r.finishReason === "error") throw new DelegationError(agentName, r.errorMessage);
500
- if (Number.isFinite(budget) && acc.cost > budget) {
501
- throw new DelegationBudgetExceededError(agentName, acc.cost, budget);
502
- }
503
- if (r.finishReason === TOOL_CALLS && r.toolCalls.length > 0) {
504
- const sig = roundSignature(r.toolCalls);
505
- stuck = sig === prevSig ? stuck + 1 : 0;
506
- if (stuck >= NO_PROGRESS_THRESHOLD) return finalize(acc, round, "no_progress", loop.name);
507
- prevSig = sig;
508
- }
529
+ throwIfRoundFailed(acc, r, budget, agentName);
530
+ if (isNoProgress(progress, r)) return finalize(acc, round, "no_progress", loop.name);
509
531
  const outcome = {
510
532
  finishReason: r.finishReason,
511
533
  round,
@@ -796,4 +818,4 @@ export {
796
818
  AgentRunner,
797
819
  AgentRunnerBuilder
798
820
  };
799
- //# sourceMappingURL=chunk-SAKSZKVK.js.map
821
+ //# sourceMappingURL=chunk-ZLKZOSWR.js.map
@@ -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","resolveBudgetAndName","config","budget","Number","POSITIVE_INFINITY","loop","emptyDelegationResult","response","throwIfRoundFailed","isFinite","isNoProgress","p","length","sig","stuck","prevSig","runReflectiveLoopStream","reflection","reflectionContext","progress","roundFactory","accumulateUsage","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,33 @@
1
+ import { TheokitAgentError } from '@theokit/sdk/errors';
2
+ import { Sandbox } from './code-mode.js';
3
+ import '@theokit/sdk';
4
+
5
+ interface QuickJsSandboxOptions {
6
+ /** The whole run's bound, host calls included. Default 10000. */
7
+ readonly timeoutMs?: number;
8
+ /** The runtime's allocation limit. Default 33554432 (32 MiB). */
9
+ readonly memoryLimitBytes?: number;
10
+ /** How many `api` calls one run may make. Default 16. */
11
+ readonly maxCalls?: number;
12
+ }
13
+ type CodeModeSandboxErrorCode = 'script_error' | 'timeout' | 'memory_limit' | 'call_limit' | 'unserialisable_result' | 'cancelled' | 'host_call_unsettled';
14
+ /** A script run that did not produce a JSON value, with the reason as a stable code. */
15
+ declare class CodeModeSandboxError extends TheokitAgentError {
16
+ readonly code: CodeModeSandboxErrorCode;
17
+ readonly name = "CodeModeSandboxError";
18
+ constructor(code: CodeModeSandboxErrorCode, message: string);
19
+ }
20
+ /** A sandbox option that is not a usable limit, refused when the sandbox is built (B-697). */
21
+ declare class CodeModeSandboxConfigError extends TheokitAgentError {
22
+ readonly option: keyof QuickJsSandboxOptions;
23
+ readonly value: unknown;
24
+ readonly name = "CodeModeSandboxConfigError";
25
+ constructor(option: keyof QuickJsSandboxOptions, value: unknown, expected: string);
26
+ }
27
+ /**
28
+ * A `Sandbox` that runs each script in a fresh QuickJS-WASM runtime, bounded in time, memory and
29
+ * calls. The WASM module is compiled once per sandbox, on its first run.
30
+ */
31
+ declare function createQuickJsSandbox(options?: QuickJsSandboxOptions): Sandbox;
32
+
33
+ export { CodeModeSandboxConfigError, CodeModeSandboxError, type CodeModeSandboxErrorCode, type QuickJsSandboxOptions, createQuickJsSandbox };
@@ -0,0 +1,353 @@
1
+ import {
2
+ __name
3
+ } from "./chunk-Z4QWC7IK.js";
4
+
5
+ // src/code-mode/quickjs-sandbox.ts
6
+ import variant from "@jitl/quickjs-wasmfile-release-sync";
7
+ import { TheokitAgentError } from "@theokit/sdk/errors";
8
+ import { newQuickJSWASMModuleFromVariant } from "quickjs-emscripten-core";
9
+ var CodeModeSandboxError = class extends TheokitAgentError {
10
+ static {
11
+ __name(this, "CodeModeSandboxError");
12
+ }
13
+ code;
14
+ name = "CodeModeSandboxError";
15
+ constructor(code, message) {
16
+ super(`code-mode sandbox: ${code}: ${message}`, {
17
+ code,
18
+ isRetryable: false
19
+ }), this.code = code;
20
+ }
21
+ };
22
+ var CodeModeSandboxConfigError = class extends TheokitAgentError {
23
+ static {
24
+ __name(this, "CodeModeSandboxConfigError");
25
+ }
26
+ option;
27
+ value;
28
+ name = "CodeModeSandboxConfigError";
29
+ constructor(option, value, expected) {
30
+ super(`code-mode sandbox: option ${option} must be ${expected} (got ${String(value)})`, {
31
+ code: "CODE_MODE_SANDBOX_CONFIG",
32
+ isRetryable: false
33
+ }), this.option = option, this.value = value;
34
+ }
35
+ };
36
+ var DEFAULTS = {
37
+ timeoutMs: 1e4,
38
+ memoryLimitBytes: 33554432,
39
+ maxCalls: 16
40
+ };
41
+ var HOST_CALL_GRACE_MS = 250;
42
+ function checkedLimits(options) {
43
+ const given = Object.fromEntries(Object.entries(options).filter(([, value]) => value !== void 0));
44
+ const limits = {
45
+ ...DEFAULTS,
46
+ ...given
47
+ };
48
+ for (const option of [
49
+ "timeoutMs",
50
+ "memoryLimitBytes"
51
+ ]) {
52
+ const value = limits[option];
53
+ if (!Number.isFinite(value) || value <= 0) {
54
+ throw new CodeModeSandboxConfigError(option, value, "a finite number greater than 0");
55
+ }
56
+ }
57
+ if (!Number.isInteger(limits.maxCalls) || limits.maxCalls < 0) {
58
+ throw new CodeModeSandboxConfigError("maxCalls", limits.maxCalls, "an integer of at least 0");
59
+ }
60
+ return limits;
61
+ }
62
+ __name(checkedLimits, "checkedLimits");
63
+ function messageOf(dumped) {
64
+ if (typeof dumped === "object" && dumped !== null && "message" in dumped) {
65
+ return String(dumped.message);
66
+ }
67
+ return String(dumped);
68
+ }
69
+ __name(messageOf, "messageOf");
70
+ function classify(thrown, state) {
71
+ if (state.callLimitReached) {
72
+ return new CodeModeSandboxError("call_limit", "the script made more api calls than its limit allows");
73
+ }
74
+ if (state.cancelled) return new CodeModeSandboxError("cancelled", "the run's signal aborted");
75
+ if (state.interrupted) return new CodeModeSandboxError("timeout", "the script ran past its deadline");
76
+ const message = messageOf(thrown);
77
+ if (/out of memory/i.test(message)) {
78
+ return new CodeModeSandboxError("memory_limit", "the script allocated past its memory limit");
79
+ }
80
+ if (thrown instanceof CodeModeSandboxError) return thrown;
81
+ return new CodeModeSandboxError("script_error", message);
82
+ }
83
+ __name(classify, "classify");
84
+ var QuickJsRun = class QuickJsRun2 {
85
+ static {
86
+ __name(this, "QuickJsRun");
87
+ }
88
+ limits;
89
+ deadline;
90
+ signal;
91
+ owned = [];
92
+ pending = /* @__PURE__ */ new Set();
93
+ state = {
94
+ interrupted: false,
95
+ cancelled: false,
96
+ callLimitReached: false,
97
+ calls: 0
98
+ };
99
+ /** Aborted when the run ends, or when the caller's signal aborts: what each host call receives. */
100
+ hostCalls = new AbortController();
101
+ onAbort = /* @__PURE__ */ __name(() => {
102
+ this.state.cancelled = true;
103
+ this.hostCalls.abort();
104
+ }, "onAbort");
105
+ runtime;
106
+ context;
107
+ jsonParse;
108
+ jsonStringify;
109
+ timer;
110
+ /** Set when disposal itself failed: the WASM module may have aborted, and must not be reused. */
111
+ moduleBroken = false;
112
+ constructor(module, limits, deadline, signal) {
113
+ this.limits = limits;
114
+ this.deadline = deadline;
115
+ this.signal = signal;
116
+ if (signal?.aborted === true) this.onAbort();
117
+ else signal?.addEventListener("abort", this.onAbort, {
118
+ once: true
119
+ });
120
+ this.runtime = module.newRuntime();
121
+ this.runtime.setMemoryLimit(limits.memoryLimitBytes);
122
+ this.runtime.setInterruptHandler(() => {
123
+ if (Date.now() <= this.deadline) return false;
124
+ this.state.interrupted = true;
125
+ return true;
126
+ });
127
+ this.context = this.runtime.newContext();
128
+ const json = this.own(this.context.getProp(this.context.global, "JSON"));
129
+ this.jsonParse = this.own(this.context.getProp(json, "parse"));
130
+ this.jsonStringify = this.own(this.context.getProp(json, "stringify"));
131
+ }
132
+ async execute(code, api) {
133
+ let failure;
134
+ try {
135
+ this.installApi(api);
136
+ const promise = this.own(this.context.unwrapResult(this.context.evalCode(`(async () => {
137
+ ${code}
138
+ })()`)));
139
+ return await this.settle(promise);
140
+ } catch (error) {
141
+ failure = classify(error, this.state);
142
+ throw failure;
143
+ } finally {
144
+ this.dispose(failure);
145
+ await this.waitForHostCalls(failure);
146
+ }
147
+ }
148
+ /**
149
+ * After the run aborted them, give the host calls still in flight a short grace to settle. A run
150
+ * that would otherwise succeed never resolves while one is still running: it says it could not
151
+ * stop it. A run already failing keeps its own error.
152
+ */
153
+ async waitForHostCalls(failure) {
154
+ if (this.pending.size === 0) return;
155
+ let grace;
156
+ const graceOver = new Promise((resolve) => {
157
+ grace = setTimeout(resolve, HOST_CALL_GRACE_MS);
158
+ });
159
+ try {
160
+ await Promise.race([
161
+ Promise.allSettled([
162
+ ...this.pending
163
+ ]),
164
+ graceOver
165
+ ]);
166
+ } finally {
167
+ clearTimeout(grace);
168
+ }
169
+ if (failure === void 0 && this.pending.size > 0) {
170
+ throw new CodeModeSandboxError("host_call_unsettled", `a host call was still running ${HOST_CALL_GRACE_MS} ms after the run aborted it`);
171
+ }
172
+ }
173
+ own(item) {
174
+ this.owned.push(item);
175
+ return item;
176
+ }
177
+ installApi(api) {
178
+ const apiObject = this.own(this.context.newObject());
179
+ for (const [name, call] of Object.entries(api)) {
180
+ const fn = this.own(this.context.newFunction(name, (argument) => this.callHost(call, argument)));
181
+ this.context.setProp(apiObject, name, fn);
182
+ }
183
+ this.context.setProp(this.context.global, "api", apiObject);
184
+ }
185
+ /** Answer one `api.<name>(input)` with a VM promise the host call settles. */
186
+ callHost(call, argument) {
187
+ this.state.calls += 1;
188
+ if (this.state.calls > this.limits.maxCalls) {
189
+ this.state.callLimitReached = true;
190
+ throw new Error(`call_limit: more than ${this.limits.maxCalls} api calls`);
191
+ }
192
+ const input = argument === void 0 || this.context.typeof(argument) === "undefined" ? {} : this.context.dump(argument);
193
+ const deferred = this.own(this.context.newPromise());
194
+ const settled = Promise.resolve().then(() => call(input, {
195
+ signal: this.hostCalls.signal
196
+ })).then((value) => {
197
+ this.settleDeferred(deferred, () => this.toHandle(value), "resolve");
198
+ }, (error) => {
199
+ const message = error instanceof Error ? error.message : String(error);
200
+ this.settleDeferred(deferred, () => this.context.newError(message), "reject");
201
+ }).finally(() => {
202
+ this.pending.delete(settled);
203
+ });
204
+ this.pending.add(settled);
205
+ return deferred.handle;
206
+ }
207
+ settleDeferred(deferred, make, how) {
208
+ if (!deferred.alive || !this.context.alive) return;
209
+ const handle = make();
210
+ try {
211
+ deferred[how](handle);
212
+ } finally {
213
+ handle.dispose();
214
+ }
215
+ }
216
+ /**
217
+ * A host value as a VM value: JSON through the VM's own `JSON.parse`, a non-JSON string as itself
218
+ * (EC-8). A string that IS JSON arrives parsed, so a tool answering `"42"` hands the script 42.
219
+ */
220
+ toHandle(value) {
221
+ if (value === void 0) return this.context.undefined;
222
+ let json;
223
+ if (typeof value === "string") {
224
+ try {
225
+ JSON.parse(value);
226
+ json = value;
227
+ } catch {
228
+ return this.context.newString(value);
229
+ }
230
+ } else {
231
+ json = JSON.stringify(value);
232
+ }
233
+ const text = this.context.newString(json);
234
+ try {
235
+ return this.context.unwrapResult(this.context.callFunction(this.jsonParse, this.context.undefined, text));
236
+ } finally {
237
+ text.dispose();
238
+ }
239
+ }
240
+ /** Drive the VM's jobs until the script's promise settles, waiting on host calls between passes. */
241
+ async settle(promise) {
242
+ const deadlineReached = new Promise((resolve) => {
243
+ this.timer = setTimeout(resolve, Math.max(0, this.deadline - Date.now()));
244
+ });
245
+ const cancelled = new Promise((resolve) => {
246
+ this.hostCalls.signal.addEventListener("abort", () => {
247
+ resolve();
248
+ });
249
+ });
250
+ for (; ; ) {
251
+ const jobs = this.runtime.executePendingJobs();
252
+ if (jobs.error) {
253
+ const thrown = this.context.dump(jobs.error);
254
+ jobs.error.dispose();
255
+ throw thrown;
256
+ }
257
+ if (this.state.callLimitReached) throw classify(void 0, this.state);
258
+ const state = this.context.getPromiseState(promise);
259
+ if (state.type === "fulfilled") {
260
+ try {
261
+ return this.toJson(state.value);
262
+ } finally {
263
+ state.value.dispose();
264
+ }
265
+ }
266
+ if (state.type === "rejected") {
267
+ const thrown = this.context.dump(state.error);
268
+ state.error.dispose();
269
+ throw thrown;
270
+ }
271
+ if (this.pending.size === 0) {
272
+ throw new CodeModeSandboxError("script_error", "the script awaits a promise that nothing can settle");
273
+ }
274
+ await Promise.race([
275
+ ...this.pending,
276
+ deadlineReached,
277
+ cancelled
278
+ ]);
279
+ if (this.state.cancelled) throw classify(void 0, this.state);
280
+ if (Date.now() > this.deadline) {
281
+ this.state.interrupted = true;
282
+ throw classify(void 0, this.state);
283
+ }
284
+ }
285
+ }
286
+ /** The script's value as JSON, read through the VM's own `JSON.stringify`; `undefined` is `null` (EC-5). */
287
+ toJson(value) {
288
+ const kind = this.context.typeof(value);
289
+ if (kind === "undefined") return null;
290
+ if (kind === "function" || kind === "symbol" || kind === "bigint") {
291
+ throw new CodeModeSandboxError("unserialisable_result", `the script returned a ${kind}`);
292
+ }
293
+ const result = this.context.callFunction(this.jsonStringify, this.context.undefined, value);
294
+ if (result.error) {
295
+ const reason = messageOf(this.context.dump(result.error));
296
+ result.error.dispose();
297
+ throw new CodeModeSandboxError("unserialisable_result", reason);
298
+ }
299
+ const text = result.value;
300
+ try {
301
+ if (this.context.typeof(text) !== "string") {
302
+ throw new CodeModeSandboxError("unserialisable_result", "the script returned a value JSON cannot carry");
303
+ }
304
+ return JSON.parse(this.context.getString(text));
305
+ } finally {
306
+ text.dispose();
307
+ }
308
+ }
309
+ /** Dispose everything this run made, newest first, then the context and the runtime. */
310
+ dispose(failure) {
311
+ clearTimeout(this.timer);
312
+ this.signal?.removeEventListener("abort", this.onAbort);
313
+ this.hostCalls.abort();
314
+ try {
315
+ for (const item of [
316
+ ...this.owned
317
+ ].reverse()) {
318
+ if (item.alive) item.dispose();
319
+ }
320
+ this.context.dispose();
321
+ this.runtime.dispose();
322
+ } catch (error) {
323
+ this.moduleBroken = true;
324
+ if (failure === void 0) throw error;
325
+ }
326
+ }
327
+ };
328
+ function createQuickJsSandbox(options = {}) {
329
+ const limits = checkedLimits(options);
330
+ let module;
331
+ return {
332
+ run: /* @__PURE__ */ __name(async (code, api, options2) => {
333
+ const deadline = Date.now() + limits.timeoutMs;
334
+ if (options2?.signal?.aborted === true) {
335
+ throw new CodeModeSandboxError("cancelled", "the run's signal aborted before it started");
336
+ }
337
+ module ??= newQuickJSWASMModuleFromVariant(variant);
338
+ const run = new QuickJsRun(await module, limits, deadline, options2?.signal);
339
+ try {
340
+ return await run.execute(code, api);
341
+ } finally {
342
+ if (run.moduleBroken) module = void 0;
343
+ }
344
+ }, "run")
345
+ };
346
+ }
347
+ __name(createQuickJsSandbox, "createQuickJsSandbox");
348
+ export {
349
+ CodeModeSandboxConfigError,
350
+ CodeModeSandboxError,
351
+ createQuickJsSandbox
352
+ };
353
+ //# sourceMappingURL=code-mode-quickjs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/code-mode/quickjs-sandbox.ts"],"mappings":"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","names":["variant","TheokitAgentError","newQuickJSWASMModuleFromVariant","CodeModeSandboxError","TheokitAgentError","name","code","message","isRetryable","CodeModeSandboxConfigError","option","value","expected","String","DEFAULTS","timeoutMs","memoryLimitBytes","maxCalls","HOST_CALL_GRACE_MS","checkedLimits","options","given","Object","fromEntries","entries","filter","undefined","limits","Number","isFinite","isInteger","messageOf","dumped","classify","thrown","state","callLimitReached","cancelled","interrupted","test","QuickJsRun","owned","pending","Set","calls","hostCalls","AbortController","onAbort","abort","runtime","context","jsonParse","jsonStringify","timer","moduleBroken","module","deadline","signal","aborted","addEventListener","once","newRuntime","setMemoryLimit","setInterruptHandler","Date","now","newContext","json","own","getProp","global","execute","api","failure","installApi","promise","unwrapResult","evalCode","settle","error","dispose","waitForHostCalls","size","grace","graceOver","Promise","resolve","setTimeout","race","allSettled","clearTimeout","item","push","apiObject","newObject","call","fn","newFunction","argument","callHost","setProp","Error","input","typeof","dump","deferred","newPromise","settled","then","settleDeferred","toHandle","newError","finally","delete","add","handle","make","how","alive","JSON","parse","newString","stringify","text","callFunction","deadlineReached","Math","max","jobs","executePendingJobs","getPromiseState","type","toJson","kind","result","reason","getString","removeEventListener","reverse","createQuickJsSandbox","run","newQuickJSWASMModuleFromVariant","variant"]}
@@ -0,0 +1,110 @@
1
+ import { CustomTool } from '@theokit/sdk';
2
+ import { TheokitAgentError } from '@theokit/sdk/errors';
3
+
4
+ /**
5
+ * B-386 — moved here from `theokit` (`packages/theo/src/server/agent/code-mode.ts`, which now
6
+ * re-exports it), so an app that depends on `@theokit/agents` and not on the web package reaches it.
7
+ * Typed over the SDK's own `CustomTool`, so any SDK tool, a published factory's included, is accepted.
8
+ *
9
+ * M29 — `createCodeMode`: expose a set of tools to agent-authored code run inside an
10
+ * ISOLATION boundary, so the agent composes tools programmatically instead of one call at a time.
11
+ *
12
+ * Security posture (the whole point of this feature):
13
+ * - The isolation boundary (`sandbox`) is **injected**, never hand-rolled here (Top-risk 1). The app
14
+ * supplies a vetted sandbox — isolated-vm, QuickJS-WASM, or a locked-down worker. This module
15
+ * imports no VM (same posture as the injected deploy adapter / the M17 transport); the QuickJS-WASM
16
+ * one is `@theokit/agents/code-mode-quickjs`, whose VM packages are optional peers. `node:vm` is
17
+ * NOT a security boundary and MUST NOT be used as the sandbox.
18
+ * - TheoKit owns the **restricted API** (only the declared tools are reachable from the code — no
19
+ * `fs`, `process`, `require`, or network unless a declared, permission-gated tool provides it) and
20
+ * the **mandatory permission gate**: every tool call from the code passes `onPermissionRequest`
21
+ * first, and there is NO default-allow (mirrors M17 `onPermissionRequest`).
22
+ *
23
+ * Threat model (summary): a malicious model could author code that (a) calls a dangerous tool, or
24
+ * (b) tries to reach a host capability. (a) is stopped by the permission gate (deny → the API call
25
+ * throws). (b) is stopped by the injected sandbox (the restricted API is the ONLY surface the code
26
+ * sees). If the app injects a weak sandbox, (b) is on the app — hence the vetted-sandbox requirement.
27
+ */
28
+
29
+ /**
30
+ * What a run hands along with each call: the run's `AbortSignal`, so a cancelled turn stops the
31
+ * script and the host tool calls it started instead of leaving them running unobserved.
32
+ */
33
+ interface CodeModeCallOptions {
34
+ readonly signal?: AbortSignal;
35
+ }
36
+ /** The restricted API handed to sandboxed code: declared tool names → permission-gated callables. */
37
+ type CodeModeApi = Record<string, (args: unknown, options?: CodeModeCallOptions) => Promise<unknown>>;
38
+ /** The injected isolation boundary. The app supplies a vetted implementation. */
39
+ interface Sandbox {
40
+ /**
41
+ * Run `code` with access to ONLY `api` (the restricted tool surface). Resolve the code's result.
42
+ * An implementation that honours `options.signal` ends the run when it aborts and passes a signal
43
+ * to each `api` call; one that ignores it runs to its own bound.
44
+ */
45
+ run(code: string, api: CodeModeApi, options?: CodeModeCallOptions): Promise<unknown>;
46
+ }
47
+ /** A permission decision for one tool call from sandboxed code. */
48
+ interface CodeModePermission {
49
+ granted: boolean;
50
+ /** Optional reason surfaced to the model on denial. */
51
+ reason?: string;
52
+ }
53
+ interface CodeModeConfig {
54
+ /** The tools reachable from the code (the restricted API). */
55
+ tools: CustomTool[];
56
+ /** The injected isolation boundary (vetted sandbox — NEVER node:vm). */
57
+ sandbox: Sandbox;
58
+ /**
59
+ * REQUIRED — decide each tool call the code attempts. Security by default: NO default-allow.
60
+ * Return `{ granted }` (may be async). Mirrors M17 `onPermissionRequest`.
61
+ */
62
+ onPermissionRequest: (req: {
63
+ tool: string;
64
+ args: unknown;
65
+ }) => CodeModePermission | Promise<CodeModePermission>;
66
+ /** Tool name the model calls (default `run_code`). */
67
+ name?: string;
68
+ /** Tool description surfaced to the model. */
69
+ description?: string;
70
+ }
71
+ /**
72
+ * The code-mode tool: an SDK `CustomTool` whose handler always answers a string (the script's JSON
73
+ * result). Narrower than `CustomTool` on purpose, so `theokit`'s pass-through keeps the `string`
74
+ * result its callers read.
75
+ */
76
+ type CodeModeTool = Omit<CustomTool, 'handler'> & {
77
+ handler: (input: Record<string, unknown>, ctx?: CodeModeCallOptions) => Promise<string>;
78
+ };
79
+ /**
80
+ * Thrown when the permission gate denies a tool call from sandboxed code. A `TheokitAgentError`, so
81
+ * `isTransientError` reads it: a denial is refused the same way on every attempt.
82
+ */
83
+ declare class CodeModePermissionDeniedError extends TheokitAgentError {
84
+ readonly name = "CodeModePermissionDeniedError";
85
+ constructor(tool: string, reason?: string);
86
+ }
87
+ /**
88
+ * Thrown when a script calls a tool with arguments whose top-level shape the tool's `inputSchema`
89
+ * refuses (B-697 D4), before the permission gate or the tool sees them. `property` is the argument
90
+ * at fault, `undefined` when the arguments are not an object at all.
91
+ */
92
+ declare class CodeModeInvalidArgumentsError extends TheokitAgentError {
93
+ readonly tool: string;
94
+ readonly property: string | undefined;
95
+ readonly name = "CodeModeInvalidArgumentsError";
96
+ constructor(tool: string, property: string | undefined, reason: string);
97
+ }
98
+ /**
99
+ * Build a code-mode tool + its generated model instructions (M40). Fails fast if
100
+ * `onPermissionRequest` or `sandbox` is missing (security by default). `tool` takes `{ code }`,
101
+ * assembles the permission-gated restricted API from `tools`, runs the code in the injected sandbox,
102
+ * and returns the code's result. `instructions` (add it to the agent's system prompt) teaches the
103
+ * model the sandboxed-code contract + the available `api.<name>(input)` calls.
104
+ */
105
+ declare function createCodeMode(config: CodeModeConfig): {
106
+ tool: CodeModeTool;
107
+ instructions: string;
108
+ };
109
+
110
+ export { type CodeModeApi, type CodeModeCallOptions, type CodeModeConfig, CodeModeInvalidArgumentsError, type CodeModePermission, CodeModePermissionDeniedError, type CodeModeTool, type Sandbox, createCodeMode };