@framers/agentos 0.10.34 → 0.10.35
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/README.md +2 -2
- package/dist/api/agency.d.ts.map +1 -1
- package/dist/api/agency.js +23 -41
- package/dist/api/agency.js.map +1 -1
- package/dist/api/agent.d.ts.map +1 -1
- package/dist/api/agent.js +7 -9
- package/dist/api/agent.js.map +1 -1
- package/dist/api/agentExport.d.ts +1 -1
- package/dist/api/agentExport.js +1 -1
- package/dist/api/transferStyle.d.ts +1 -1
- package/dist/api/transferStyle.js +1 -1
- package/dist/api/types.d.ts +11 -10
- package/dist/api/types.d.ts.map +1 -1
- package/dist/api/types.js.map +1 -1
- package/dist/cognition/emergent/ComposableToolBuilder.d.ts +6 -5
- package/dist/cognition/emergent/ComposableToolBuilder.d.ts.map +1 -1
- package/dist/cognition/emergent/ComposableToolBuilder.js +6 -5
- package/dist/cognition/emergent/ComposableToolBuilder.js.map +1 -1
- package/dist/cognition/emergent/EmergentCapabilityEngine.d.ts +2 -2
- package/dist/cognition/emergent/EmergentCapabilityEngine.js +2 -2
- package/dist/cognition/emergent/SandboxedToolForge.d.ts +12 -10
- package/dist/cognition/emergent/SandboxedToolForge.d.ts.map +1 -1
- package/dist/cognition/emergent/SandboxedToolForge.js +13 -11
- package/dist/cognition/emergent/SandboxedToolForge.js.map +1 -1
- package/dist/cognition/emergent/types.d.ts +1 -1
- package/dist/cognition/memory/retrieval/typed-network/prompts/extraction-schema.d.ts +2 -2
- package/dist/cognition/rag/RetrievalAugmentor.d.ts +1 -1
- package/dist/cognition/rag/RetrievalAugmentor.js +1 -1
- package/dist/cognition/rag/index.d.ts +1 -1
- package/dist/cognition/rag/index.js +1 -1
- package/dist/cognition/rag/multimodal/MultimodalIndexer.d.ts +1 -1
- package/dist/cognition/rag/multimodal/MultimodalIndexer.js +1 -1
- package/dist/cognition/rag/multimodal/index.d.ts +1 -1
- package/dist/cognition/rag/multimodal/index.js +1 -1
- package/dist/cognition/rag/reranking/index.d.ts +2 -2
- package/dist/cognition/rag/reranking/index.js +2 -2
- package/dist/cognition/rag/unified/UnifiedRetriever.d.ts +1 -1
- package/dist/cognition/rag/unified/UnifiedRetriever.js +1 -1
- package/dist/cognition/rag/unified/index.d.ts +1 -1
- package/dist/cognition/rag/unified/index.js +1 -1
- package/dist/cognition/substrate/personas/SoulLoader.d.ts +1 -1
- package/dist/cognition/substrate/personas/SoulLoader.js +1 -1
- package/dist/cognition/web-search/index.d.ts +1 -1
- package/dist/cognition/web-search/index.js +1 -1
- package/dist/core/llm/providers/structuredOutputFormat.d.ts +1 -1
- package/dist/core/llm/providers/structuredOutputFormat.js +1 -1
- package/dist/core/safety/LLMProviderHealthRegistry.d.ts +1 -1
- package/dist/core/safety/LLMProviderHealthRegistry.js +1 -1
- package/dist/extensions/packs/provenance-pack.d.ts +1 -1
- package/dist/extensions/packs/provenance-pack.js +1 -1
- package/dist/io/vision/SceneDetector.d.ts +2 -2
- package/dist/io/vision/SceneDetector.js +2 -2
- package/dist/io/vision/index.d.ts +1 -1
- package/dist/io/vision/index.js +1 -1
- package/dist/io/vision/providers/LLMVisionProvider.d.ts +1 -1
- package/dist/io/vision/providers/LLMVisionProvider.js +1 -1
- package/dist/io/vision/providers/PipelineVisionProvider.d.ts +2 -2
- package/dist/io/vision/providers/PipelineVisionProvider.js +2 -2
- package/dist/io/voice-pipeline/WebRTCStreamTransport.d.ts +1 -1
- package/dist/io/voice-pipeline/WebRTCStreamTransport.js +1 -1
- package/dist/io/voice-pipeline/index.d.ts +1 -1
- package/dist/io/voice-pipeline/index.js +1 -1
- package/dist/io/voice-pipeline/providers/AgentSessionVoiceAdapter.d.ts +1 -1
- package/dist/io/voice-pipeline/providers/AgentSessionVoiceAdapter.js +1 -1
- package/dist/orchestration/pipeline/index.d.ts +2 -2
- package/dist/orchestration/pipeline/index.js +2 -2
- package/dist/safety/guardrails/ParallelGuardrailDispatcher.d.ts +1 -1
- package/dist/safety/guardrails/index.d.ts +2 -2
- package/dist/safety/guardrails/index.js +2 -2
- package/dist/safety/sandbox/executor/CodeSandbox.d.ts +12 -7
- package/dist/safety/sandbox/executor/CodeSandbox.d.ts.map +1 -1
- package/dist/safety/sandbox/executor/CodeSandbox.js +15 -10
- package/dist/safety/sandbox/executor/CodeSandbox.js.map +1 -1
- package/dist/safety/sandbox/executor/ICodeSandbox.d.ts +2 -2
- package/package.json +22 -19
|
@@ -12,8 +12,9 @@
|
|
|
12
12
|
* - Steps execute sequentially; the first failure aborts the pipeline and surfaces
|
|
13
13
|
* the error immediately.
|
|
14
14
|
* - The composite tool's final output is the last step's raw output value.
|
|
15
|
-
* -
|
|
16
|
-
*
|
|
15
|
+
* - Every tool invocation is delegated to a caller-supplied `executeTool`
|
|
16
|
+
* callback; the builder holds no registry, and the callback decides which
|
|
17
|
+
* checks a step meets.
|
|
17
18
|
*/
|
|
18
19
|
import type { ComposableToolSpec } from './types.js';
|
|
19
20
|
import type { ITool, ToolExecutionResult, ToolExecutionContext, JSONSchemaObject } from '../../core/tools/ITool.js';
|
|
@@ -37,9 +38,9 @@ import type { ITool, ToolExecutionResult, ToolExecutionContext, JSONSchemaObject
|
|
|
37
38
|
* Reference expressions nested inside plain objects are resolved recursively, so
|
|
38
39
|
* `{ query: "$input.topic", limit: 10 }` becomes `{ query: "actual-topic", limit: 10 }`.
|
|
39
40
|
*
|
|
40
|
-
*
|
|
41
|
-
*
|
|
42
|
-
*
|
|
41
|
+
* All tool invocations are delegated to the `executeTool` callback supplied at
|
|
42
|
+
* construction time. The builder never holds a reference to any tool registry,
|
|
43
|
+
* and it applies no permission or approval check of its own.
|
|
43
44
|
*
|
|
44
45
|
* @example
|
|
45
46
|
* ```ts
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ComposableToolBuilder.d.ts","sourceRoot":"","sources":["../../../src/cognition/emergent/ComposableToolBuilder.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"ComposableToolBuilder.d.ts","sourceRoot":"","sources":["../../../src/cognition/emergent/ComposableToolBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EACV,KAAK,EACL,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AA0BnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,qBAAqB;IAmB9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAlB9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B;;;;;;;;;OASG;gBAEgB,WAAW,EAAE,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC,mBAAmB,CAAC,EACjC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IASpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,gBAAgB,EAC7B,IAAI,EAAE,kBAAkB,GACvB,KAAK;IA4DR;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAgB1E"}
|
|
@@ -12,8 +12,9 @@
|
|
|
12
12
|
* - Steps execute sequentially; the first failure aborts the pipeline and surfaces
|
|
13
13
|
* the error immediately.
|
|
14
14
|
* - The composite tool's final output is the last step's raw output value.
|
|
15
|
-
* -
|
|
16
|
-
*
|
|
15
|
+
* - Every tool invocation is delegated to a caller-supplied `executeTool`
|
|
16
|
+
* callback; the builder holds no registry, and the callback decides which
|
|
17
|
+
* checks a step meets.
|
|
17
18
|
*/
|
|
18
19
|
// ============================================================================
|
|
19
20
|
// COMPOSABLE TOOL BUILDER
|
|
@@ -38,9 +39,9 @@
|
|
|
38
39
|
* Reference expressions nested inside plain objects are resolved recursively, so
|
|
39
40
|
* `{ query: "$input.topic", limit: 10 }` becomes `{ query: "actual-topic", limit: 10 }`.
|
|
40
41
|
*
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
-
*
|
|
42
|
+
* All tool invocations are delegated to the `executeTool` callback supplied at
|
|
43
|
+
* construction time. The builder never holds a reference to any tool registry,
|
|
44
|
+
* and it applies no permission or approval check of its own.
|
|
44
45
|
*
|
|
45
46
|
* @example
|
|
46
47
|
* ```ts
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ComposableToolBuilder.js","sourceRoot":"","sources":["../../../src/cognition/emergent/ComposableToolBuilder.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"ComposableToolBuilder.js","sourceRoot":"","sources":["../../../src/cognition/emergent/ComposableToolBuilder.ts"],"names":[],"mappings":"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"}
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
* forge request → build tool → run tests → judge review → register
|
|
8
8
|
*
|
|
9
9
|
* Supports two creation modes:
|
|
10
|
-
* - **Compose**: chains existing tools via {@link ComposableToolBuilder}
|
|
10
|
+
* - **Compose**: chains existing tools via {@link ComposableToolBuilder}.
|
|
11
11
|
* - **Sandbox**: runs agent-written code via {@link SandboxedToolForge} (judge-gated).
|
|
12
12
|
*
|
|
13
13
|
* After registration the engine tracks usage and auto-promotes tools that
|
|
@@ -115,7 +115,7 @@ export interface EmergentCapabilityEngineDeps {
|
|
|
115
115
|
* Pipeline: forge request → build tool → run tests → judge review → register.
|
|
116
116
|
*
|
|
117
117
|
* Supports two creation modes:
|
|
118
|
-
* - **Compose**: chains existing tools via {@link ComposableToolBuilder}
|
|
118
|
+
* - **Compose**: chains existing tools via {@link ComposableToolBuilder}.
|
|
119
119
|
* - **Sandbox**: runs agent-written code via {@link SandboxedToolForge} (judge-gated).
|
|
120
120
|
*
|
|
121
121
|
* @example
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
* forge request → build tool → run tests → judge review → register
|
|
8
8
|
*
|
|
9
9
|
* Supports two creation modes:
|
|
10
|
-
* - **Compose**: chains existing tools via {@link ComposableToolBuilder}
|
|
10
|
+
* - **Compose**: chains existing tools via {@link ComposableToolBuilder}.
|
|
11
11
|
* - **Sandbox**: runs agent-written code via {@link SandboxedToolForge} (judge-gated).
|
|
12
12
|
*
|
|
13
13
|
* After registration the engine tracks usage and auto-promotes tools that
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
* Pipeline: forge request → build tool → run tests → judge review → register.
|
|
23
23
|
*
|
|
24
24
|
* Supports two creation modes:
|
|
25
|
-
* - **Compose**: chains existing tools via {@link ComposableToolBuilder}
|
|
25
|
+
* - **Compose**: chains existing tools via {@link ComposableToolBuilder}.
|
|
26
26
|
* - **Sandbox**: runs agent-written code via {@link SandboxedToolForge} (judge-gated).
|
|
27
27
|
*
|
|
28
28
|
* @example
|
|
@@ -1,24 +1,24 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @fileoverview SandboxedToolForge runs agent-generated JavaScript code in a
|
|
3
|
-
*
|
|
3
|
+
* in-process node:vm context with wall-clock timeouts and API allowlisting.
|
|
4
4
|
*
|
|
5
5
|
* @module @framers/agentos/emergent/SandboxedToolForge
|
|
6
6
|
*
|
|
7
7
|
* Overview:
|
|
8
8
|
* - Delegates the actual VM execution to {@link CodeSandbox}, which provides
|
|
9
|
-
* the
|
|
9
|
+
* the in-process node:vm context (`codeGeneration: { strings: false, wasm: false }`,
|
|
10
10
|
* frozen console, explicit `process`/`globalThis`/`require`/etc. set to undefined).
|
|
11
11
|
* - Adds the forge-specific contract: code must define `function execute(input)`
|
|
12
12
|
* or `function run(input)`, and the resolved value is JSON-serialized back to
|
|
13
13
|
* the caller via a marker-prefixed stdout convention.
|
|
14
14
|
* - Allowlisted APIs (`fetch`, `fs.readFile`, `crypto`) are injected via
|
|
15
|
-
* `CodeSandbox`'s `extraGlobals` config so the
|
|
15
|
+
* `CodeSandbox`'s `extraGlobals` config so the minimal defaults stay intact.
|
|
16
16
|
*
|
|
17
17
|
* Security model:
|
|
18
18
|
* 1. **Static validation** (`validateCode()`) rejects dangerous patterns (regex
|
|
19
19
|
* scan) before any code reaches the runtime.
|
|
20
20
|
* 2. **Runtime isolation** executes validated code inside `CodeSandbox`'s
|
|
21
|
-
*
|
|
21
|
+
* minimal context, which exposes only JSON/Math/Date/etc. plus the
|
|
22
22
|
* explicitly opted-in APIs from this forge's allowlist.
|
|
23
23
|
* 3. **Resource bounding** enforces a wall-clock timeout via node:vm. Memory is
|
|
24
24
|
* NOT preemptively enforced (node:vm shares the host heap); `memoryUsedBytes`
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
* dependency would be required (deferred until hosted multi-tenant ships).
|
|
28
28
|
*
|
|
29
29
|
* Allowlisted APIs (each requires explicit opt-in via {@link SandboxAPI}):
|
|
30
|
-
* - `fetch` — HTTP requests
|
|
30
|
+
* - `fetch` — HTTP requests; {@link SandboxedToolForgeConfig.fetchDomainAllowlist} checks the first URL's host when set.
|
|
31
31
|
* - `fs.readFile` — Read-only file access, max 1 MB, restricted to the
|
|
32
32
|
* configured roots after symlink resolution (a link inside a root cannot
|
|
33
33
|
* be used to reach a file outside one).
|
|
@@ -67,7 +67,9 @@ export interface SandboxedToolForgeConfig {
|
|
|
67
67
|
fsReadRoots?: string[];
|
|
68
68
|
}
|
|
69
69
|
/**
|
|
70
|
-
* Runs agent-generated code in
|
|
70
|
+
* Runs agent-generated code in an in-process node:vm context via {@link CodeSandbox}.
|
|
71
|
+
* `node:vm` is not a security mechanism (Node's documentation): the checks here hold for
|
|
72
|
+
* code that acts through the injected functions, and memory is reported, not limited.
|
|
71
73
|
*
|
|
72
74
|
* Runtime bounds:
|
|
73
75
|
* - Memory: observed as a heap delta, not preemptively capped
|
|
@@ -75,7 +77,7 @@ export interface SandboxedToolForgeConfig {
|
|
|
75
77
|
* - Blocked APIs: eval, Function, process, require, import, child_process, fs.write*
|
|
76
78
|
*
|
|
77
79
|
* Allowlisted APIs (each requires explicit opt-in):
|
|
78
|
-
* - `fetch`: HTTP requests (
|
|
80
|
+
* - `fetch`: HTTP requests (the first URL's host is checked when `fetchDomainAllowlist` is set)
|
|
79
81
|
* - `fs.readFile`: Read-only file access (path-restricted, max 1 MB)
|
|
80
82
|
* - `crypto`: Hashing and HMAC only
|
|
81
83
|
*
|
|
@@ -118,7 +120,7 @@ export declare class SandboxedToolForge {
|
|
|
118
120
|
*/
|
|
119
121
|
private readonly realFsReadRootCache;
|
|
120
122
|
/**
|
|
121
|
-
*
|
|
123
|
+
* The node:vm sandbox shared across all execute() calls. Owns the
|
|
122
124
|
* codeGeneration restriction, frozen console, and explicit-undefined
|
|
123
125
|
* dangerous globals. Reused per forge instance to amortize stats bookkeeping.
|
|
124
126
|
*/
|
|
@@ -220,9 +222,9 @@ export declare class SandboxedToolForge {
|
|
|
220
222
|
execute(request: SandboxExecutionRequest): Promise<SandboxExecutionResult>;
|
|
221
223
|
/**
|
|
222
224
|
* Build the allowlist-injected globals to layer on top of CodeSandbox's
|
|
223
|
-
*
|
|
225
|
+
* minimal defaults. Only the three forge allowlist APIs (fetch, fs,
|
|
224
226
|
* crypto) are injected here; CodeSandbox provides JSON/Math/Date/etc.
|
|
225
|
-
* and the
|
|
227
|
+
* and the removed process/globalThis/require/etc.
|
|
226
228
|
*/
|
|
227
229
|
private buildExtraGlobals;
|
|
228
230
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SandboxedToolForge.d.ts","sourceRoot":"","sources":["../../../src/cognition/emergent/SandboxedToolForge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAKH,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAe9F;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AA+BD
|
|
1
|
+
{"version":3,"file":"SandboxedToolForge.d.ts","sourceRoot":"","sources":["../../../src/cognition/emergent/SandboxedToolForge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAKH,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAe9F;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AA+BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,kBAAkB;IAC7B,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAW;IAEhD,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;IAEvC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsC;IAE1E;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C;;;;;OAKG;gBACS,MAAM,CAAC,EAAE,wBAAwB;IAY7C;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,mBAAmB;IAiC3B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE;IAsC7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA4HhF;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;CAkG1B"}
|
|
@@ -1,24 +1,24 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @fileoverview SandboxedToolForge runs agent-generated JavaScript code in a
|
|
3
|
-
*
|
|
3
|
+
* in-process node:vm context with wall-clock timeouts and API allowlisting.
|
|
4
4
|
*
|
|
5
5
|
* @module @framers/agentos/emergent/SandboxedToolForge
|
|
6
6
|
*
|
|
7
7
|
* Overview:
|
|
8
8
|
* - Delegates the actual VM execution to {@link CodeSandbox}, which provides
|
|
9
|
-
* the
|
|
9
|
+
* the in-process node:vm context (`codeGeneration: { strings: false, wasm: false }`,
|
|
10
10
|
* frozen console, explicit `process`/`globalThis`/`require`/etc. set to undefined).
|
|
11
11
|
* - Adds the forge-specific contract: code must define `function execute(input)`
|
|
12
12
|
* or `function run(input)`, and the resolved value is JSON-serialized back to
|
|
13
13
|
* the caller via a marker-prefixed stdout convention.
|
|
14
14
|
* - Allowlisted APIs (`fetch`, `fs.readFile`, `crypto`) are injected via
|
|
15
|
-
* `CodeSandbox`'s `extraGlobals` config so the
|
|
15
|
+
* `CodeSandbox`'s `extraGlobals` config so the minimal defaults stay intact.
|
|
16
16
|
*
|
|
17
17
|
* Security model:
|
|
18
18
|
* 1. **Static validation** (`validateCode()`) rejects dangerous patterns (regex
|
|
19
19
|
* scan) before any code reaches the runtime.
|
|
20
20
|
* 2. **Runtime isolation** executes validated code inside `CodeSandbox`'s
|
|
21
|
-
*
|
|
21
|
+
* minimal context, which exposes only JSON/Math/Date/etc. plus the
|
|
22
22
|
* explicitly opted-in APIs from this forge's allowlist.
|
|
23
23
|
* 3. **Resource bounding** enforces a wall-clock timeout via node:vm. Memory is
|
|
24
24
|
* NOT preemptively enforced (node:vm shares the host heap); `memoryUsedBytes`
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
* dependency would be required (deferred until hosted multi-tenant ships).
|
|
28
28
|
*
|
|
29
29
|
* Allowlisted APIs (each requires explicit opt-in via {@link SandboxAPI}):
|
|
30
|
-
* - `fetch` — HTTP requests
|
|
30
|
+
* - `fetch` — HTTP requests; {@link SandboxedToolForgeConfig.fetchDomainAllowlist} checks the first URL's host when set.
|
|
31
31
|
* - `fs.readFile` — Read-only file access, max 1 MB, restricted to the
|
|
32
32
|
* configured roots after symlink resolution (a link inside a root cannot
|
|
33
33
|
* be used to reach a file outside one).
|
|
@@ -71,7 +71,9 @@ const ALWAYS_BANNED = [
|
|
|
71
71
|
// SANDBOXED TOOL FORGE
|
|
72
72
|
// ============================================================================
|
|
73
73
|
/**
|
|
74
|
-
* Runs agent-generated code in
|
|
74
|
+
* Runs agent-generated code in an in-process node:vm context via {@link CodeSandbox}.
|
|
75
|
+
* `node:vm` is not a security mechanism (Node's documentation): the checks here hold for
|
|
76
|
+
* code that acts through the injected functions, and memory is reported, not limited.
|
|
75
77
|
*
|
|
76
78
|
* Runtime bounds:
|
|
77
79
|
* - Memory: observed as a heap delta, not preemptively capped
|
|
@@ -79,7 +81,7 @@ const ALWAYS_BANNED = [
|
|
|
79
81
|
* - Blocked APIs: eval, Function, process, require, import, child_process, fs.write*
|
|
80
82
|
*
|
|
81
83
|
* Allowlisted APIs (each requires explicit opt-in):
|
|
82
|
-
* - `fetch`: HTTP requests (
|
|
84
|
+
* - `fetch`: HTTP requests (the first URL's host is checked when `fetchDomainAllowlist` is set)
|
|
83
85
|
* - `fs.readFile`: Read-only file access (path-restricted, max 1 MB)
|
|
84
86
|
* - `crypto`: Hashing and HMAC only
|
|
85
87
|
*
|
|
@@ -332,14 +334,14 @@ export class SandboxedToolForge {
|
|
|
332
334
|
return ${JSON.stringify(FORGE_RESULT_MARKER)} + (__out === undefined ? 'undefined' : JSON.stringify(__out));
|
|
333
335
|
`;
|
|
334
336
|
// Step 4: Build allowlisted-API extras. CodeSandbox provides the safe
|
|
335
|
-
// builtins +
|
|
337
|
+
// builtins + removed dangerous globals; this only adds the
|
|
336
338
|
// explicit forge allowlist (fetch / fs.readFile / crypto).
|
|
337
339
|
const extraGlobals = this.buildExtraGlobals(request.allowlist);
|
|
338
340
|
// Step 5: Heap snapshot before delegation. Best-effort observability
|
|
339
341
|
// (over-approximates because other event-loop activity allocates too).
|
|
340
342
|
// Not preemptive enforcement; node:vm cannot enforce memory limits.
|
|
341
343
|
const heapBefore = process.memoryUsage().heapUsed;
|
|
342
|
-
// Step 6: Delegate to
|
|
344
|
+
// Step 6: Delegate to CodeSandbox for the actual VM call.
|
|
343
345
|
const codeResult = await this.codeSandbox.execute({
|
|
344
346
|
language: 'javascript',
|
|
345
347
|
code: wrappedCode,
|
|
@@ -397,9 +399,9 @@ export class SandboxedToolForge {
|
|
|
397
399
|
// --------------------------------------------------------------------------
|
|
398
400
|
/**
|
|
399
401
|
* Build the allowlist-injected globals to layer on top of CodeSandbox's
|
|
400
|
-
*
|
|
402
|
+
* minimal defaults. Only the three forge allowlist APIs (fetch, fs,
|
|
401
403
|
* crypto) are injected here; CodeSandbox provides JSON/Math/Date/etc.
|
|
402
|
-
* and the
|
|
404
|
+
* and the removed process/globalThis/require/etc.
|
|
403
405
|
*/
|
|
404
406
|
buildExtraGlobals(allowlist) {
|
|
405
407
|
/* eslint-disable @typescript-eslint/no-explicit-any */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SandboxedToolForge.js","sourceRoot":"","sources":["../../../src/cognition/emergent/SandboxedToolForge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,sCAAsC,CAAC;AA0CnE,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,aAAa,GAAoC;IACrD,CAAC,aAAa,EAAE,qBAAqB,CAAC;IACtC,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IAC9C,CAAC,uBAAuB,EAAE,6BAA6B,CAAC;IACxD,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;IAC5C,CAAC,aAAa,EAAE,iCAAiC,CAAC;IAClD,CAAC,eAAe,EAAE,+BAA+B,CAAC;IAClD,CAAC,gBAAgB,EAAE,6BAA6B,CAAC;IACjD,CAAC,mBAAmB,EAAE,mCAAmC,CAAC;IAC1D,CAAC,mBAAmB,EAAE,wBAAwB,CAAC;IAC/C,CAAC,oBAAoB,EAAE,wBAAwB,CAAC;IAChD,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAC1C,CAAC,mBAAmB,EAAE,uBAAuB,CAAC;IAC9C,CAAC,wBAAwB,EAAE,4BAA4B,CAAC;IACxD,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;CACrD,CAAC;AAEF,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E
|
|
1
|
+
{"version":3,"file":"SandboxedToolForge.js","sourceRoot":"","sources":["../../../src/cognition/emergent/SandboxedToolForge.ts"],"names":[],"mappings":"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"}
|
|
@@ -556,7 +556,7 @@ export interface EmergentConfig {
|
|
|
556
556
|
* 'sandbox'` is rejected before validation or execution.
|
|
557
557
|
*
|
|
558
558
|
* This is intentionally disabled by default because sandboxed code carries
|
|
559
|
-
* higher review and persistence risk than
|
|
559
|
+
* higher review and persistence risk than composing tools that are already registered.
|
|
560
560
|
*
|
|
561
561
|
* @default false
|
|
562
562
|
*/
|
|
@@ -54,7 +54,7 @@ export declare const TypedExtractionFactSchema: z.ZodObject<{
|
|
|
54
54
|
EXPERIENCE: "EXPERIENCE";
|
|
55
55
|
OPINION: "OPINION";
|
|
56
56
|
OBSERVATION: "OBSERVATION";
|
|
57
|
-
}
|
|
57
|
+
}>, unknown>;
|
|
58
58
|
temporal: z.ZodDefault<z.ZodObject<{
|
|
59
59
|
start: z.ZodOptional<z.ZodString>;
|
|
60
60
|
end: z.ZodOptional<z.ZodString>;
|
|
@@ -82,7 +82,7 @@ export declare const TypedExtractionSchema: z.ZodObject<{
|
|
|
82
82
|
EXPERIENCE: "EXPERIENCE";
|
|
83
83
|
OPINION: "OPINION";
|
|
84
84
|
OBSERVATION: "OBSERVATION";
|
|
85
|
-
}
|
|
85
|
+
}>, unknown>;
|
|
86
86
|
temporal: z.ZodDefault<z.ZodObject<{
|
|
87
87
|
start: z.ZodOptional<z.ZodString>;
|
|
88
88
|
end: z.ZodOptional<z.ZodString>;
|
|
@@ -75,7 +75,7 @@ export declare class RetrievalAugmentor implements IRetrievalAugmentor {
|
|
|
75
75
|
*
|
|
76
76
|
* @example
|
|
77
77
|
* ```typescript
|
|
78
|
-
* import { CohereReranker, LocalCrossEncoderReranker } from '
|
|
78
|
+
* import { CohereReranker, LocalCrossEncoderReranker } from './reranking/index.js';
|
|
79
79
|
*
|
|
80
80
|
* // After initialization
|
|
81
81
|
* augmentor.registerRerankerProvider(new CohereReranker({
|
|
@@ -141,7 +141,7 @@ export class RetrievalAugmentor {
|
|
|
141
141
|
*
|
|
142
142
|
* @example
|
|
143
143
|
* ```typescript
|
|
144
|
-
* import { CohereReranker, LocalCrossEncoderReranker } from '
|
|
144
|
+
* import { CohereReranker, LocalCrossEncoderReranker } from './reranking/index.js';
|
|
145
145
|
*
|
|
146
146
|
* // After initialization
|
|
147
147
|
* augmentor.registerRerankerProvider(new CohereReranker({
|
|
@@ -62,7 +62,7 @@ import type { HydeRetriever } from '../HydeRetriever.js';
|
|
|
62
62
|
*
|
|
63
63
|
* @example
|
|
64
64
|
* ```typescript
|
|
65
|
-
* import { MultimodalIndexer } from '
|
|
65
|
+
* import { MultimodalIndexer } from '../index.js';
|
|
66
66
|
*
|
|
67
67
|
* const indexer = new MultimodalIndexer({
|
|
68
68
|
* embeddingManager,
|
|
@@ -75,7 +75,7 @@ const isNodeBuffer = (value) => typeof Buffer !== 'undefined' && Buffer.isBuffer
|
|
|
75
75
|
*
|
|
76
76
|
* @example
|
|
77
77
|
* ```typescript
|
|
78
|
-
* import { MultimodalIndexer } from '
|
|
78
|
+
* import { MultimodalIndexer } from '../index.js';
|
|
79
79
|
*
|
|
80
80
|
* const indexer = new MultimodalIndexer({
|
|
81
81
|
* embeddingManager,
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
*
|
|
10
10
|
* @example Basic usage with local model
|
|
11
11
|
* ```typescript
|
|
12
|
-
* import { RerankerService, LocalCrossEncoderReranker } from '
|
|
12
|
+
* import { RerankerService, LocalCrossEncoderReranker } from './index.js';
|
|
13
13
|
*
|
|
14
14
|
* const service = new RerankerService({
|
|
15
15
|
* config: {
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
*
|
|
29
29
|
* @example Using Cohere API
|
|
30
30
|
* ```typescript
|
|
31
|
-
* import { RerankerService, CohereReranker } from '
|
|
31
|
+
* import { RerankerService, CohereReranker } from './index.js';
|
|
32
32
|
*
|
|
33
33
|
* const service = new RerankerService({
|
|
34
34
|
* config: {
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
*
|
|
10
10
|
* @example Basic usage with local model
|
|
11
11
|
* ```typescript
|
|
12
|
-
* import { RerankerService, LocalCrossEncoderReranker } from '
|
|
12
|
+
* import { RerankerService, LocalCrossEncoderReranker } from './index.js';
|
|
13
13
|
*
|
|
14
14
|
* const service = new RerankerService({
|
|
15
15
|
* config: {
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
*
|
|
29
29
|
* @example Using Cohere API
|
|
30
30
|
* ```typescript
|
|
31
|
-
* import { RerankerService, CohereReranker } from '
|
|
31
|
+
* import { RerankerService, CohereReranker } from './index.js';
|
|
32
32
|
*
|
|
33
33
|
* const service = new RerankerService({
|
|
34
34
|
* config: {
|
|
@@ -203,7 +203,7 @@ export interface UnifiedRetrieverDeps {
|
|
|
203
203
|
*
|
|
204
204
|
* @example
|
|
205
205
|
* ```typescript
|
|
206
|
-
* import { UnifiedRetriever, buildDefaultPlan } from '
|
|
206
|
+
* import { UnifiedRetriever, buildDefaultPlan } from '../index.js';
|
|
207
207
|
*
|
|
208
208
|
* const retriever = new UnifiedRetriever({
|
|
209
209
|
* hybridSearcher,
|
|
@@ -74,7 +74,7 @@ import { buildRetrievalPlanFromPolicy, resolveMemoryRetrievalPolicy, } from './p
|
|
|
74
74
|
*
|
|
75
75
|
* @example
|
|
76
76
|
* ```typescript
|
|
77
|
-
* import { UnifiedRetriever, buildDefaultPlan } from '
|
|
77
|
+
* import { UnifiedRetriever, buildDefaultPlan } from '../index.js';
|
|
78
78
|
*
|
|
79
79
|
* const retriever = new UnifiedRetriever({
|
|
80
80
|
* hybridSearcher,
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
*
|
|
11
11
|
* @example
|
|
12
12
|
* ```typescript
|
|
13
|
-
* import { UnifiedRetriever, buildDefaultPlan } from '
|
|
13
|
+
* import { UnifiedRetriever, buildDefaultPlan } from '../index.js';
|
|
14
14
|
*
|
|
15
15
|
* const retriever = new UnifiedRetriever({ hybridSearcher, memoryManager });
|
|
16
16
|
* const plan = buildDefaultPlan('moderate');
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
*
|
|
11
11
|
* @example
|
|
12
12
|
* ```typescript
|
|
13
|
-
* import { UnifiedRetriever, buildDefaultPlan } from '
|
|
13
|
+
* import { UnifiedRetriever, buildDefaultPlan } from '../index.js';
|
|
14
14
|
*
|
|
15
15
|
* const retriever = new UnifiedRetriever({ hybridSearcher, memoryManager });
|
|
16
16
|
* const plan = buildDefaultPlan('moderate');
|
|
@@ -166,7 +166,7 @@ export interface SoulLoaderOptions {
|
|
|
166
166
|
*
|
|
167
167
|
* @example
|
|
168
168
|
* ```ts
|
|
169
|
-
* import { loadSoul } from '
|
|
169
|
+
* import { loadSoul } from './SoulLoader.js';
|
|
170
170
|
*
|
|
171
171
|
* const soul = await loadSoul({ source: '~/.agentos/agents/aria' });
|
|
172
172
|
*
|
|
@@ -64,7 +64,7 @@ import { normalizeHexacoTraits } from './hexaco.js';
|
|
|
64
64
|
*
|
|
65
65
|
* @example
|
|
66
66
|
* ```ts
|
|
67
|
-
* import { loadSoul } from '
|
|
67
|
+
* import { loadSoul } from './SoulLoader.js';
|
|
68
68
|
*
|
|
69
69
|
* const soul = await loadSoul({ source: '~/.agentos/agents/aria' });
|
|
70
70
|
*
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
*
|
|
7
7
|
* @example
|
|
8
8
|
* ```typescript
|
|
9
|
-
* import { WebSearchService, FirecrawlProvider, TavilyProvider } from '
|
|
9
|
+
* import { WebSearchService, FirecrawlProvider, TavilyProvider } from './index.js';
|
|
10
10
|
*
|
|
11
11
|
* const service = new WebSearchService();
|
|
12
12
|
* service.registerProvider(new FirecrawlProvider(process.env.FIRECRAWL_API_KEY!));
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
*
|
|
7
7
|
* @example
|
|
8
8
|
* ```typescript
|
|
9
|
-
* import { WebSearchService, FirecrawlProvider, TavilyProvider } from '
|
|
9
|
+
* import { WebSearchService, FirecrawlProvider, TavilyProvider } from './index.js';
|
|
10
10
|
*
|
|
11
11
|
* const service = new WebSearchService();
|
|
12
12
|
* service.registerProvider(new FirecrawlProvider(process.env.FIRECRAWL_API_KEY!));
|
|
@@ -42,7 +42,7 @@ export interface BuildResponseFormatInput {
|
|
|
42
42
|
* @example
|
|
43
43
|
* ```ts
|
|
44
44
|
* import { z } from 'zod';
|
|
45
|
-
* import { buildResponseFormat } from '
|
|
45
|
+
* import { buildResponseFormat } from './structuredOutputFormat.js';
|
|
46
46
|
*
|
|
47
47
|
* const schema = z.object({ verdict: z.enum(['yes', 'no']), confidence: z.number() });
|
|
48
48
|
* const rf = buildResponseFormat({ provider: 'openai', schema, schemaName: 'Verdict' });
|
|
@@ -102,7 +102,7 @@ function ensureAnthropicObjectSchema(jsonSchema) {
|
|
|
102
102
|
* @example
|
|
103
103
|
* ```ts
|
|
104
104
|
* import { z } from 'zod';
|
|
105
|
-
* import { buildResponseFormat } from '
|
|
105
|
+
* import { buildResponseFormat } from './structuredOutputFormat.js';
|
|
106
106
|
*
|
|
107
107
|
* const schema = z.object({ verdict: z.enum(['yes', 'no']), confidence: z.number() });
|
|
108
108
|
* const rf = buildResponseFormat({ provider: 'openai', schema, schemaName: 'Verdict' });
|
|
@@ -61,7 +61,7 @@
|
|
|
61
61
|
*
|
|
62
62
|
* @example Wiring into the fallback router
|
|
63
63
|
* ```ts
|
|
64
|
-
* import { globalLLMProviderHealth } from '
|
|
64
|
+
* import { globalLLMProviderHealth } from './LLMProviderHealthRegistry.js';
|
|
65
65
|
*
|
|
66
66
|
* // Before the primary call:
|
|
67
67
|
* if (globalLLMProviderHealth.isOpen(primaryProviderId)) {
|
|
@@ -61,7 +61,7 @@
|
|
|
61
61
|
*
|
|
62
62
|
* @example Wiring into the fallback router
|
|
63
63
|
* ```ts
|
|
64
|
-
* import { globalLLMProviderHealth } from '
|
|
64
|
+
* import { globalLLMProviderHealth } from './LLMProviderHealthRegistry.js';
|
|
65
65
|
*
|
|
66
66
|
* // Before the primary call:
|
|
67
67
|
* if (globalLLMProviderHealth.isOpen(primaryProviderId)) {
|