@theokit/agents 16.2.0 → 16.4.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 +30 -0
- package/dist/a2a.d.ts +33 -1
- package/dist/a2a.js +353 -3
- package/dist/a2a.js.map +1 -1
- package/dist/{agent-compiler-JSYkHpa7.d.ts → agent-compiler-C-4X_vKz.d.ts} +1 -51
- package/dist/{agent-orchestrator-BFWg2URC.d.ts → agent-orchestrator-BHF1bS6k.d.ts} +1 -1
- package/dist/{agent-runner-BUJKNNuI.d.ts → agent-runner-BoMoOnHV.d.ts} +2 -2
- package/dist/auth.d.ts +15 -2
- package/dist/auth.js +13 -2
- package/dist/auth.js.map +1 -1
- package/dist/{bridge-entry-BNWDrPzg.d.ts → bridge-entry-C8vEw3AX.d.ts} +202 -8
- package/dist/bridge.d.ts +6 -6
- package/dist/bridge.js +25 -9
- package/dist/{chunk-A7RXWJZE.js → chunk-AZ2FOUSN.js} +450 -476
- package/dist/chunk-AZ2FOUSN.js.map +1 -0
- package/dist/{chunk-MB23MSOK.js → chunk-K4MY4CV7.js} +45 -22
- package/dist/chunk-K4MY4CV7.js.map +1 -0
- package/dist/{chunk-CJMYZKUL.js → chunk-LQ57DUMJ.js} +332 -14
- package/dist/chunk-LQ57DUMJ.js.map +1 -0
- package/dist/{chunk-SAKSZKVK.js → chunk-ZLKZOSWR.js} +39 -17
- package/dist/chunk-ZLKZOSWR.js.map +1 -0
- package/dist/code-mode-quickjs.d.ts +33 -0
- package/dist/code-mode-quickjs.js +353 -0
- package/dist/code-mode-quickjs.js.map +1 -0
- package/dist/code-mode.d.ts +110 -0
- package/dist/code-mode.js +165 -0
- package/dist/code-mode.js.map +1 -0
- package/dist/{delegation-scoring-Cn5eM4lQ.d.ts → delegation-scoring-BBPJ9eug.d.ts} +8 -2
- package/dist/evals.d.ts +2 -2
- package/dist/evals.js +3 -1
- package/dist/evals.js.map +1 -1
- package/dist/handoff.d.ts +3 -3
- package/dist/handoff.js +2 -2
- package/dist/index.d.ts +25 -10
- package/dist/index.js +31 -9
- package/dist/index.js.map +1 -1
- package/dist/persistence.d.ts +1 -1
- package/dist/persistence.js +2 -1
- package/dist/persistence.js.map +1 -1
- package/dist/sandbox.d.ts +1 -1
- package/dist/sandbox.js +2 -0
- package/dist/sandbox.js.map +1 -1
- package/dist/{sdk-adapter-DQnKx7bA.d.ts → sdk-adapter-C57SpmLH.d.ts} +3 -1
- package/dist/testing.d.ts +1 -1
- package/dist/tools.d.ts +140 -5
- package/dist/tools.js +591 -29
- package/dist/tools.js.map +1 -1
- package/docs/capability-map.md +80 -6
- package/package.json +23 -5
- package/dist/chunk-A7RXWJZE.js.map +0 -1
- package/dist/chunk-CJMYZKUL.js.map +0 -1
- package/dist/chunk-MB23MSOK.js.map +0 -1
- package/dist/chunk-SAKSZKVK.js.map +0 -1
|
@@ -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 };
|