@n8n/agents 0.10.1 → 0.11.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/dist/build.tsbuildinfo +1 -1
- package/dist/index.d.ts +8 -2
- package/dist/index.js +27 -5
- package/dist/index.js.map +1 -1
- package/dist/runtime/agent-runtime.d.ts +14 -6
- package/dist/runtime/agent-runtime.js +320 -243
- package/dist/runtime/agent-runtime.js.map +1 -1
- package/dist/runtime/delegate-sub-agent-tool.d.ts +87 -0
- package/dist/runtime/delegate-sub-agent-tool.js +362 -0
- package/dist/runtime/delegate-sub-agent-tool.js.map +1 -0
- package/dist/runtime/event-bus.d.ts +8 -0
- package/dist/runtime/event-bus.js +48 -0
- package/dist/runtime/event-bus.js.map +1 -1
- package/dist/runtime/mcp-connection.d.ts +1 -2
- package/dist/runtime/mcp-connection.js +1 -4
- package/dist/runtime/mcp-connection.js.map +1 -1
- package/dist/runtime/message-list.d.ts +9 -3
- package/dist/runtime/message-list.js +16 -5
- package/dist/runtime/message-list.js.map +1 -1
- package/dist/runtime/messages.js +10 -2
- package/dist/runtime/messages.js.map +1 -1
- package/dist/runtime/model-factory.js +12 -0
- package/dist/runtime/model-factory.js.map +1 -1
- package/dist/runtime/provider-credentials.d.ts +13 -0
- package/dist/runtime/provider-credentials.js +1 -0
- package/dist/runtime/provider-credentials.js.map +1 -1
- package/dist/runtime/runtime-helpers.d.ts +1 -2
- package/dist/runtime/runtime-helpers.js +0 -8
- package/dist/runtime/runtime-helpers.js.map +1 -1
- package/dist/runtime/sdk-owned-tool.d.ts +4 -0
- package/dist/runtime/sdk-owned-tool.js +19 -0
- package/dist/runtime/sdk-owned-tool.js.map +1 -0
- package/dist/runtime/stream.js +8 -0
- package/dist/runtime/stream.js.map +1 -1
- package/dist/runtime/sub-agent-task-path.d.ts +10 -0
- package/dist/runtime/sub-agent-task-path.js +39 -0
- package/dist/runtime/sub-agent-task-path.js.map +1 -0
- package/dist/runtime/title-generation.js +3 -5
- package/dist/runtime/title-generation.js.map +1 -1
- package/dist/runtime/tool-adapter.d.ts +0 -9
- package/dist/runtime/tool-adapter.js +12 -21
- package/dist/runtime/tool-adapter.js.map +1 -1
- package/dist/runtime/write-todos-tool.d.ts +3 -0
- package/dist/runtime/write-todos-tool.js +95 -0
- package/dist/runtime/write-todos-tool.js.map +1 -0
- package/dist/sdk/agent.d.ts +19 -12
- package/dist/sdk/agent.js +318 -91
- package/dist/sdk/agent.js.map +1 -1
- package/dist/sdk/cancellation.d.ts +7 -0
- package/dist/sdk/cancellation.js +16 -0
- package/dist/sdk/cancellation.js.map +1 -0
- package/dist/sdk/catalog.js +20 -4
- package/dist/sdk/catalog.js.map +1 -1
- package/dist/sdk/mcp-client.d.ts +1 -1
- package/dist/sdk/mcp-client.js +2 -2
- package/dist/sdk/mcp-client.js.map +1 -1
- package/dist/sdk/memory.d.ts +1 -3
- package/dist/sdk/memory.js +0 -14
- package/dist/sdk/memory.js.map +1 -1
- package/dist/sdk/provider-capabilities.js +1 -0
- package/dist/sdk/provider-capabilities.js.map +1 -1
- package/dist/sdk/tool.d.ts +3 -0
- package/dist/sdk/tool.js +42 -10
- package/dist/sdk/tool.js.map +1 -1
- package/dist/storage/base-memory.d.ts +0 -31
- package/dist/storage/base-memory.js +0 -9
- package/dist/storage/base-memory.js.map +1 -1
- package/dist/types/index.d.ts +2 -2
- package/dist/types/index.js.map +1 -1
- package/dist/types/runtime/event.d.ts +31 -1
- package/dist/types/runtime/event.js +2 -0
- package/dist/types/runtime/event.js.map +1 -1
- package/dist/types/sdk/agent-builder.d.ts +0 -1
- package/dist/types/sdk/agent.d.ts +20 -15
- package/dist/types/sdk/memory.d.ts +0 -42
- package/dist/types/sdk/message.d.ts +1 -0
- package/dist/types/sdk/tool.d.ts +19 -1
- package/dist/utils/json-schema.d.ts +3 -0
- package/dist/utils/json-schema.js +72 -0
- package/dist/utils/json-schema.js.map +1 -0
- package/dist/workspace/filesystem/daytona-filesystem.d.ts +25 -0
- package/dist/workspace/filesystem/daytona-filesystem.js +130 -0
- package/dist/workspace/filesystem/daytona-filesystem.js.map +1 -0
- package/dist/workspace/filesystem/n8n-sandbox-filesystem.d.ts +25 -0
- package/dist/workspace/filesystem/n8n-sandbox-filesystem.js +126 -0
- package/dist/workspace/filesystem/n8n-sandbox-filesystem.js.map +1 -0
- package/dist/workspace/sandbox/create-workspace.d.ts +4 -0
- package/dist/workspace/sandbox/create-workspace.js +58 -0
- package/dist/workspace/sandbox/create-workspace.js.map +1 -0
- package/dist/workspace/sandbox/daytona-auth-manager.d.ts +26 -0
- package/dist/workspace/sandbox/daytona-auth-manager.js +84 -0
- package/dist/workspace/sandbox/daytona-auth-manager.js.map +1 -0
- package/dist/workspace/sandbox/daytona-sandbox.d.ts +72 -0
- package/dist/workspace/sandbox/daytona-sandbox.js +357 -0
- package/dist/workspace/sandbox/daytona-sandbox.js.map +1 -0
- package/dist/workspace/sandbox/index.d.ts +7 -0
- package/dist/workspace/sandbox/index.js +22 -0
- package/dist/workspace/sandbox/index.js.map +1 -0
- package/dist/workspace/sandbox/lazy-daytona.d.ts +2 -0
- package/dist/workspace/sandbox/lazy-daytona.js +12 -0
- package/dist/workspace/sandbox/lazy-daytona.js.map +1 -0
- package/dist/workspace/sandbox/logger.d.ts +12 -0
- package/dist/workspace/sandbox/logger.js +3 -0
- package/dist/workspace/sandbox/logger.js.map +1 -0
- package/dist/workspace/sandbox/n8n-sandbox-sandbox.d.ts +35 -0
- package/dist/workspace/sandbox/n8n-sandbox-sandbox.js +138 -0
- package/dist/workspace/sandbox/n8n-sandbox-sandbox.js.map +1 -0
- package/dist/workspace/sandbox/provider.d.ts +4 -0
- package/dist/workspace/sandbox/provider.js +14 -0
- package/dist/workspace/sandbox/provider.js.map +1 -0
- package/dist/workspace/sandbox/run-in-sandbox.d.ts +26 -0
- package/dist/workspace/sandbox/run-in-sandbox.js +19 -0
- package/dist/workspace/sandbox/run-in-sandbox.js.map +1 -0
- package/dist/workspace/sandbox/types.d.ts +41 -0
- package/dist/workspace/sandbox/types.js +3 -0
- package/dist/workspace/sandbox/types.js.map +1 -0
- package/dist/workspace/sandbox/workspace-root.d.ts +16 -0
- package/dist/workspace/sandbox/workspace-root.js +69 -0
- package/dist/workspace/sandbox/workspace-root.js.map +1 -0
- package/dist/workspace/tools/batch-str-replace-file.js +2 -2
- package/dist/workspace/tools/batch-str-replace-file.js.map +1 -1
- package/dist/workspace/tools/str-replace-file.js +2 -2
- package/dist/workspace/tools/str-replace-file.js.map +1 -1
- package/package.json +29 -17
- package/dist/sdk/network.d.ts +0 -20
- package/dist/sdk/network.js +0 -46
- package/dist/sdk/network.js.map +0 -1
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.CANCELLATION_TYPE = void 0;
|
|
4
|
+
exports.createCancellation = createCancellation;
|
|
5
|
+
exports.isCancellation = isCancellation;
|
|
6
|
+
exports.CANCELLATION_TYPE = 'agent.cancellation';
|
|
7
|
+
function createCancellation(message) {
|
|
8
|
+
return { _type: exports.CANCELLATION_TYPE, message };
|
|
9
|
+
}
|
|
10
|
+
function isCancellation(value) {
|
|
11
|
+
return (typeof value === 'object' &&
|
|
12
|
+
value !== null &&
|
|
13
|
+
value._type === exports.CANCELLATION_TYPE &&
|
|
14
|
+
typeof value.message === 'string');
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=cancellation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cancellation.js","sourceRoot":"","sources":["../../src/sdk/cancellation.ts"],"names":[],"mappings":";;;AAiBA,gDAEC;AAED,wCAOC;AAnBY,QAAA,iBAAiB,GAAG,oBAA6B,CAAC;AAQ/D,SAAgB,kBAAkB,CAAC,OAAe;IACjD,OAAO,EAAE,KAAK,EAAE,yBAAiB,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC5C,OAAO,CACN,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,KAAK,KAAK,yBAAiB;QAC9D,OAAQ,KAAiC,CAAC,OAAO,KAAK,QAAQ,CAC9D,CAAC;AACH,CAAC"}
|
package/dist/sdk/catalog.js
CHANGED
|
@@ -5,6 +5,18 @@ exports.getCachedCatalog = getCachedCatalog;
|
|
|
5
5
|
exports.getModelCost = getModelCost;
|
|
6
6
|
exports.computeCost = computeCost;
|
|
7
7
|
const MODELS_DEV_URL = 'https://models.dev/api.json';
|
|
8
|
+
const MODELS_DEV_PROVIDER_ALIASES = {
|
|
9
|
+
'amazon-bedrock': 'aws-bedrock',
|
|
10
|
+
azure: 'azure-openai',
|
|
11
|
+
'azure-cognitive-services': 'azure-openai',
|
|
12
|
+
};
|
|
13
|
+
const AGENT_PROVIDER_NAMES = {
|
|
14
|
+
'aws-bedrock': 'AWS Bedrock',
|
|
15
|
+
'azure-openai': 'Azure OpenAI',
|
|
16
|
+
};
|
|
17
|
+
function toAgentProviderId(modelsDevProviderId) {
|
|
18
|
+
return MODELS_DEV_PROVIDER_ALIASES[modelsDevProviderId] ?? modelsDevProviderId;
|
|
19
|
+
}
|
|
8
20
|
async function fetchProviderCatalog() {
|
|
9
21
|
const response = await fetch(MODELS_DEV_URL);
|
|
10
22
|
if (!response.ok) {
|
|
@@ -40,10 +52,14 @@ async function fetchProviderCatalog() {
|
|
|
40
52
|
}
|
|
41
53
|
models[modelId] = info;
|
|
42
54
|
}
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
55
|
+
const providerId = toAgentProviderId(key);
|
|
56
|
+
catalog[providerId] = {
|
|
57
|
+
id: providerId,
|
|
58
|
+
name: catalog[providerId]?.name ?? AGENT_PROVIDER_NAMES[providerId] ?? provider.name,
|
|
59
|
+
models: {
|
|
60
|
+
...(catalog[providerId]?.models ?? {}),
|
|
61
|
+
...models,
|
|
62
|
+
},
|
|
47
63
|
};
|
|
48
64
|
}
|
|
49
65
|
return catalog;
|
package/dist/sdk/catalog.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/sdk/catalog.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/sdk/catalog.ts"],"names":[],"mappings":"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"}
|
package/dist/sdk/mcp-client.d.ts
CHANGED
|
@@ -5,7 +5,7 @@ export declare class McpClient {
|
|
|
5
5
|
private connections;
|
|
6
6
|
private listToolsPromise;
|
|
7
7
|
private closePromise;
|
|
8
|
-
constructor(configs: McpServerConfig[]
|
|
8
|
+
constructor(configs: McpServerConfig[]);
|
|
9
9
|
get serverNames(): string[];
|
|
10
10
|
connect(): Promise<void>;
|
|
11
11
|
listTools(): Promise<BuiltTool[]>;
|
package/dist/sdk/mcp-client.js
CHANGED
|
@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
3
3
|
exports.McpClient = void 0;
|
|
4
4
|
const mcp_connection_1 = require("../runtime/mcp-connection");
|
|
5
5
|
class McpClient {
|
|
6
|
-
constructor(configs
|
|
6
|
+
constructor(configs) {
|
|
7
7
|
for (const cfg of configs) {
|
|
8
8
|
if (!cfg.url && !cfg.command) {
|
|
9
9
|
throw new Error(`MCP server "${cfg.name}": exactly one of "url" or "command" must be provided`);
|
|
@@ -20,7 +20,7 @@ class McpClient {
|
|
|
20
20
|
seen.add(cfg.name);
|
|
21
21
|
}
|
|
22
22
|
this.configs = configs;
|
|
23
|
-
this.connections = configs.map((cfg) => new mcp_connection_1.McpConnection(cfg
|
|
23
|
+
this.connections = configs.map((cfg) => new mcp_connection_1.McpConnection(cfg));
|
|
24
24
|
}
|
|
25
25
|
get serverNames() {
|
|
26
26
|
return this.configs.map((cfg) => cfg.name);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../src/sdk/mcp-client.ts"],"names":[],"mappings":";;;AAAA,8DAA0D;AA6B1D,MAAa,SAAS;
|
|
1
|
+
{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../src/sdk/mcp-client.ts"],"names":[],"mappings":"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"}
|
package/dist/sdk/memory.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { DEFAULT_OBSERVATION_LOG_LOCK_TTL_MS, DEFAULT_OBSERVATION_LOG_RENDER_TOKEN_BUDGET } from '../runtime/observation-log-defaults';
|
|
2
|
-
import type { BuiltMemory, EpisodicMemoryConfig, MemoryConfig, ObservationalMemoryConfig,
|
|
2
|
+
import type { BuiltMemory, EpisodicMemoryConfig, MemoryConfig, ObservationalMemoryConfig, TitleGenerationConfig } from '../types';
|
|
3
3
|
import type { ModelConfig } from '../types/sdk/agent';
|
|
4
4
|
export { DEFAULT_OBSERVATION_LOG_LOCK_TTL_MS, DEFAULT_OBSERVATION_LOG_RENDER_TOKEN_BUDGET };
|
|
5
5
|
export interface ResolveObservationalMemoryConfigOptions {
|
|
@@ -11,13 +11,11 @@ export declare function resolveEpisodicMemoryConfig(config: EpisodicMemoryConfig
|
|
|
11
11
|
export declare function resolveMemoryConfigDefaults(config: MemoryConfig, options: ResolveMemoryConfigDefaultsOptions): MemoryConfig;
|
|
12
12
|
export declare function normalizeMemoryConfig(config: MemoryConfig): MemoryConfig;
|
|
13
13
|
export declare class Memory {
|
|
14
|
-
private semanticRecallConfig?;
|
|
15
14
|
private episodicMemoryConfig?;
|
|
16
15
|
private memoryBackend?;
|
|
17
16
|
private titleGenerationConfig?;
|
|
18
17
|
private observationalMemoryConfig?;
|
|
19
18
|
storage(backend: 'memory' | BuiltMemory): this;
|
|
20
|
-
semanticRecall(config: SemanticRecallConfig): this;
|
|
21
19
|
episodicMemory(config?: EpisodicMemoryConfig): this;
|
|
22
20
|
titleGeneration(config: boolean | TitleGenerationConfig): this;
|
|
23
21
|
observationalMemory(config?: ObservationalMemoryConfig): this;
|
package/dist/sdk/memory.js
CHANGED
|
@@ -105,10 +105,6 @@ class Memory {
|
|
|
105
105
|
}
|
|
106
106
|
return this;
|
|
107
107
|
}
|
|
108
|
-
semanticRecall(config) {
|
|
109
|
-
this.semanticRecallConfig = config;
|
|
110
|
-
return this;
|
|
111
|
-
}
|
|
112
108
|
episodicMemory(config = {}) {
|
|
113
109
|
if (config.enabled === false) {
|
|
114
110
|
this.episodicMemoryConfig = undefined;
|
|
@@ -136,15 +132,6 @@ class Memory {
|
|
|
136
132
|
}
|
|
137
133
|
build() {
|
|
138
134
|
const memory = this.memoryBackend ?? new memory_store_1.InMemoryMemory();
|
|
139
|
-
if (this.semanticRecallConfig) {
|
|
140
|
-
if (!memory.queryEmbeddings && !memory.search) {
|
|
141
|
-
throw new Error('Semantic recall requires a storage backend with queryEmbeddings() or search() support.');
|
|
142
|
-
}
|
|
143
|
-
if (!memory.search && !this.semanticRecallConfig.embedder) {
|
|
144
|
-
throw new Error('Semantic recall requires an embedder when using queryEmbeddings(). Add embedder to your semanticRecall config: ' +
|
|
145
|
-
".semanticRecall({ topK: 5, embedder: 'openai/text-embedding-3-small' })");
|
|
146
|
-
}
|
|
147
|
-
}
|
|
148
135
|
if ((0, episodic_memory_1.isEpisodicMemoryEnabled)(this.episodicMemoryConfig)) {
|
|
149
136
|
if (!(0, episodic_memory_1.hasEpisodicMemoryStore)(memory)) {
|
|
150
137
|
throw new Error('Episodic memory requires a storage backend that implements BuiltEpisodicMemoryStore.');
|
|
@@ -152,7 +139,6 @@ class Memory {
|
|
|
152
139
|
}
|
|
153
140
|
const baseConfig = {
|
|
154
141
|
memory,
|
|
155
|
-
semanticRecall: this.semanticRecallConfig,
|
|
156
142
|
episodicMemory: this.episodicMemoryConfig,
|
|
157
143
|
titleGeneration: this.titleGenerationConfig,
|
|
158
144
|
};
|
package/dist/sdk/memory.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/sdk/memory.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/sdk/memory.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"provider-capabilities.js","sourceRoot":"","sources":["../../src/sdk/provider-capabilities.ts"],"names":[],"mappings":";;;AAQa,QAAA,oBAAoB,GAK7B;IACH,SAAS,EAAE;QACV,QAAQ,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE;KAC3F;IACD,MAAM,EAAE;QACP,QAAQ,EAAE;YACT,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;SAClC;KACD;IACD,MAAM,EAAE,EAAE;IACV,GAAG,EAAE,EAAE;IACP,IAAI,EAAE,EAAE;IACR,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;CACjB,CAAC"}
|
|
1
|
+
{"version":3,"file":"provider-capabilities.js","sourceRoot":"","sources":["../../src/sdk/provider-capabilities.ts"],"names":[],"mappings":";;;AAQa,QAAA,oBAAoB,GAK7B;IACH,SAAS,EAAE;QACV,QAAQ,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE;KAC3F;IACD,MAAM,EAAE;QACP,QAAQ,EAAE;YACT,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;SAClC;KACD;IACD,MAAM,EAAE,EAAE;IACV,GAAG,EAAE,EAAE;IACP,IAAI,EAAE,EAAE;IACR,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,cAAc,EAAE,EAAE;IAClB,aAAa,EAAE,EAAE;CACjB,CAAC"}
|
package/dist/sdk/tool.d.ts
CHANGED
|
@@ -10,6 +10,7 @@ export interface ApprovalConfig {
|
|
|
10
10
|
requireApproval?: boolean;
|
|
11
11
|
needsApprovalFn?: (args: unknown) => Promise<boolean> | boolean;
|
|
12
12
|
}
|
|
13
|
+
export declare function getToolApprovalDisplayName(tool: BuiltTool): string | undefined;
|
|
13
14
|
export declare function wrapToolForApproval(tool: BuiltTool, config: ApprovalConfig): BuiltTool;
|
|
14
15
|
type HandlerContext<S, R> = S extends z.ZodType ? R extends z.ZodType ? InterruptibleToolContext<z.infer<S>, z.infer<R>> : ToolContext : ToolContext;
|
|
15
16
|
export declare class Tool<TInput extends ZodOrJsonSchema = z.ZodTypeAny, TOutput extends ZodOrJsonSchema = z.ZodTypeAny, TSuspend extends ZodOrJsonSchema | undefined = undefined, TResume extends ZodOrJsonSchema | undefined = undefined> {
|
|
@@ -23,6 +24,7 @@ export declare class Tool<TInput extends ZodOrJsonSchema = z.ZodTypeAny, TOutput
|
|
|
23
24
|
private toMessageFn?;
|
|
24
25
|
private toModelOutputFn?;
|
|
25
26
|
private providerOptionsValue?;
|
|
27
|
+
private handleCancellationValue?;
|
|
26
28
|
private requireApprovalValue?;
|
|
27
29
|
private needsApprovalFnValue?;
|
|
28
30
|
private systemInstructionText?;
|
|
@@ -36,6 +38,7 @@ export declare class Tool<TInput extends ZodOrJsonSchema = z.ZodTypeAny, TOutput
|
|
|
36
38
|
handler(fn: (input: OutputType<TInput>, ctx: HandlerContext<TSuspend, TResume>) => Promise<OutputType<TOutput>>): this;
|
|
37
39
|
toMessage(toMessage: (output: OutputType<TOutput>) => AgentMessage): this;
|
|
38
40
|
toModelOutput(fn: (output: OutputType<TOutput>) => unknown): this;
|
|
41
|
+
handleCancellation(): this;
|
|
39
42
|
requireApproval(): this;
|
|
40
43
|
needsApprovalFn(fn: (args: OutputType<TInput>) => Promise<boolean> | boolean): this;
|
|
41
44
|
providerOptions(options: Record<string, JSONObject>): this;
|
package/dist/sdk/tool.js
CHANGED
|
@@ -1,25 +1,47 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.Tool = void 0;
|
|
4
|
+
exports.getToolApprovalDisplayName = getToolApprovalDisplayName;
|
|
4
5
|
exports.wrapToolForApproval = wrapToolForApproval;
|
|
5
6
|
const zod_1 = require("zod");
|
|
6
7
|
const zod_2 = require("../utils/zod");
|
|
7
8
|
const APPROVAL_SUSPEND_SCHEMA = zod_1.z.object({
|
|
8
9
|
type: zod_1.z.literal('approval'),
|
|
9
10
|
toolName: zod_1.z.string(),
|
|
11
|
+
displayName: zod_1.z.string().optional(),
|
|
10
12
|
args: zod_1.z.unknown(),
|
|
11
13
|
});
|
|
12
14
|
const APPROVAL_RESUME_SCHEMA = zod_1.z.object({
|
|
13
15
|
approved: zod_1.z.boolean(),
|
|
14
16
|
});
|
|
17
|
+
function emitToolExecutionStart(tool, input, ctx) {
|
|
18
|
+
if (!ctx.toolCallId)
|
|
19
|
+
return;
|
|
20
|
+
ctx.emitEvent?.({
|
|
21
|
+
type: "tool_execution_start",
|
|
22
|
+
toolCallId: ctx.toolCallId,
|
|
23
|
+
toolName: tool.name,
|
|
24
|
+
args: input,
|
|
25
|
+
});
|
|
26
|
+
}
|
|
27
|
+
function getToolApprovalDisplayName(tool) {
|
|
28
|
+
const metadata = tool.metadata;
|
|
29
|
+
const displayName = metadata?.displayName ?? metadata?.workflowName;
|
|
30
|
+
return typeof displayName === 'string' && displayName.length > 0 ? displayName : undefined;
|
|
31
|
+
}
|
|
15
32
|
function wrapToolForApproval(tool, config) {
|
|
16
33
|
const originalHandler = tool.handler;
|
|
34
|
+
const hasConditionalApproval = config.needsApprovalFn !== undefined;
|
|
17
35
|
return {
|
|
18
36
|
...tool,
|
|
19
|
-
|
|
37
|
+
approval: {
|
|
38
|
+
required: config.requireApproval === true,
|
|
39
|
+
...(hasConditionalApproval ? { conditional: true } : {}),
|
|
40
|
+
},
|
|
20
41
|
suspendSchema: APPROVAL_SUSPEND_SCHEMA,
|
|
21
42
|
resumeSchema: APPROVAL_RESUME_SCHEMA,
|
|
22
|
-
|
|
43
|
+
async handler(input, ctx) {
|
|
44
|
+
const currentTool = this ?? tool;
|
|
23
45
|
const interruptCtx = ctx;
|
|
24
46
|
if (interruptCtx.resumeData === undefined) {
|
|
25
47
|
let needs = config.requireApproval ?? false;
|
|
@@ -27,19 +49,24 @@ function wrapToolForApproval(tool, config) {
|
|
|
27
49
|
needs = await config.needsApprovalFn(input);
|
|
28
50
|
}
|
|
29
51
|
if (needs) {
|
|
30
|
-
|
|
52
|
+
const displayName = getToolApprovalDisplayName(currentTool);
|
|
53
|
+
return await interruptCtx.suspend({
|
|
54
|
+
type: 'approval',
|
|
55
|
+
toolName: currentTool.name,
|
|
56
|
+
...(displayName ? { displayName } : {}),
|
|
57
|
+
args: input,
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
if (hasConditionalApproval) {
|
|
61
|
+
emitToolExecutionStart(currentTool, input, interruptCtx);
|
|
31
62
|
}
|
|
32
|
-
return await originalHandler(input,
|
|
33
|
-
parentTelemetry: interruptCtx.parentTelemetry,
|
|
34
|
-
});
|
|
63
|
+
return await originalHandler(input, interruptCtx);
|
|
35
64
|
}
|
|
36
65
|
const { approved } = interruptCtx.resumeData;
|
|
37
66
|
if (!approved) {
|
|
38
|
-
return { declined: true, message: `Tool "${
|
|
67
|
+
return { declined: true, message: `Tool "${currentTool.name}" was not approved` };
|
|
39
68
|
}
|
|
40
|
-
return await originalHandler(input,
|
|
41
|
-
parentTelemetry: interruptCtx.parentTelemetry,
|
|
42
|
-
});
|
|
69
|
+
return await originalHandler(input, interruptCtx);
|
|
43
70
|
},
|
|
44
71
|
};
|
|
45
72
|
}
|
|
@@ -87,6 +114,10 @@ class Tool {
|
|
|
87
114
|
this.toModelOutputFn = fn;
|
|
88
115
|
return this;
|
|
89
116
|
}
|
|
117
|
+
handleCancellation() {
|
|
118
|
+
this.handleCancellationValue = true;
|
|
119
|
+
return this;
|
|
120
|
+
}
|
|
90
121
|
requireApproval() {
|
|
91
122
|
this.requireApprovalValue = true;
|
|
92
123
|
return this;
|
|
@@ -130,6 +161,7 @@ class Tool {
|
|
|
130
161
|
systemInstruction: this.systemInstructionText,
|
|
131
162
|
suspendSchema: this.suspendSchemaValue,
|
|
132
163
|
resumeSchema: this.resumeSchemaValue,
|
|
164
|
+
handleCancellation: this.handleCancellationValue,
|
|
133
165
|
toMessage: this.toMessageFn,
|
|
134
166
|
toModelOutput: this.toModelOutputFn,
|
|
135
167
|
handler: this.handlerFn,
|
package/dist/sdk/tool.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/sdk/tool.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/sdk/tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -18,37 +18,6 @@ export declare abstract class BaseMemory<TConstructorOptions extends JSONObject
|
|
|
18
18
|
messages: AgentDbMessage[];
|
|
19
19
|
}): Promise<void>;
|
|
20
20
|
deleteMessages(_messageIds: string[]): Promise<void>;
|
|
21
|
-
search?(_query: string, _opts?: {
|
|
22
|
-
scope?: 'thread' | 'resource';
|
|
23
|
-
threadId?: string;
|
|
24
|
-
resourceId?: string;
|
|
25
|
-
topK?: number;
|
|
26
|
-
messageRange?: {
|
|
27
|
-
before: number;
|
|
28
|
-
after: number;
|
|
29
|
-
};
|
|
30
|
-
}): Promise<AgentDbMessage[]>;
|
|
31
|
-
saveEmbeddings?(_opts: {
|
|
32
|
-
scope?: 'thread' | 'resource';
|
|
33
|
-
threadId?: string;
|
|
34
|
-
resourceId?: string;
|
|
35
|
-
entries: Array<{
|
|
36
|
-
id: string;
|
|
37
|
-
vector: number[];
|
|
38
|
-
text: string;
|
|
39
|
-
model: string;
|
|
40
|
-
}>;
|
|
41
|
-
}): Promise<void>;
|
|
42
|
-
queryEmbeddings?(_opts: {
|
|
43
|
-
scope?: 'thread' | 'resource';
|
|
44
|
-
threadId?: string;
|
|
45
|
-
resourceId?: string;
|
|
46
|
-
vector: number[];
|
|
47
|
-
topK: number;
|
|
48
|
-
}): Promise<Array<{
|
|
49
|
-
id: string;
|
|
50
|
-
score: number;
|
|
51
|
-
}>>;
|
|
52
21
|
close?(): Promise<void>;
|
|
53
22
|
describe(): MemoryDescriptor<TConstructorOptions>;
|
|
54
23
|
}
|
|
@@ -24,15 +24,6 @@ class BaseMemory {
|
|
|
24
24
|
deleteMessages(_messageIds) {
|
|
25
25
|
throw new Error('Method not implemented.');
|
|
26
26
|
}
|
|
27
|
-
search(_query, _opts) {
|
|
28
|
-
throw new Error('Method not implemented.');
|
|
29
|
-
}
|
|
30
|
-
saveEmbeddings(_opts) {
|
|
31
|
-
throw new Error('Method not implemented.');
|
|
32
|
-
}
|
|
33
|
-
queryEmbeddings(_opts) {
|
|
34
|
-
throw new Error('Method not implemented.');
|
|
35
|
-
}
|
|
36
27
|
close() {
|
|
37
28
|
throw new Error('Method not implemented.');
|
|
38
29
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base-memory.js","sourceRoot":"","sources":["../../src/storage/base-memory.ts"],"names":[],"mappings":";;;AAKA,MAAsB,UAAU;IAG/B,YACoB,IAAY,EACZ,kBAAuC;QADvC,SAAI,GAAJ,IAAI,CAAQ;QACZ,uBAAkB,GAAlB,kBAAkB,CAAqB;IACxD,CAAC;IAEJ,SAAS,CAAC,SAAiB;QAC1B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,UAAU,CAAC,OAAgD;QAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,YAAY,CAAC,SAAiB;QAC7B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,WAAW,CACV,SAAiB,EACjB,KAAyC;QAEzC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,YAAY,CAAC,KAIZ;QACA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,cAAc,CAAC,WAAqB;QACnC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;
|
|
1
|
+
{"version":3,"file":"base-memory.js","sourceRoot":"","sources":["../../src/storage/base-memory.ts"],"names":[],"mappings":";;;AAKA,MAAsB,UAAU;IAG/B,YACoB,IAAY,EACZ,kBAAuC;QADvC,SAAI,GAAJ,IAAI,CAAQ;QACZ,uBAAkB,GAAlB,kBAAkB,CAAqB;IACxD,CAAC;IAEJ,SAAS,CAAC,SAAiB;QAC1B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,UAAU,CAAC,OAAgD;QAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,YAAY,CAAC,SAAiB;QAC7B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,WAAW,CACV,SAAiB,EACjB,KAAyC;QAEzC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,YAAY,CAAC,KAIZ;QACA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,cAAc,CAAC,WAAqB;QACnC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACJ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IAED,QAAQ;QACP,OAAO;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YACtC,gBAAgB,EAAE,IAAI,CAAC,kBAAkB;SACzC,CAAC;IACH,CAAC;CACD;AA7CD,gCA6CC"}
|
package/dist/types/index.d.ts
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
export type { JSONValue, JSONObject, JSONArray } from './utils/json';
|
|
2
2
|
export type { MessageRole, MessageContent, ContentMetadata, ContentCitation, ContentText, ContentReasoning, ContentFile, ContentToolCall, ContentInvalidToolCall, ContentProvider, Message, AgentMessageBase, CustomAgentMessages, AgentMessage, AgentDbMessage, } from './sdk/message';
|
|
3
3
|
export type { Provider, AnthropicThinkingConfig, OpenAIThinkingConfig, GoogleThinkingConfig, XaiThinkingConfig, ThinkingConfigFor, ThinkingConfig, } from './sdk/provider';
|
|
4
|
-
export type { AgentResult, StreamChunk, FinishReason, TokenUsage, ModelConfig, RunOptions, ExecutionOptions, AgentExecutionCounter, PersistedExecutionOptions, ResumeOptions, GenerateResult, StreamResult,
|
|
4
|
+
export type { AgentResult, StreamChunk, FinishReason, TokenUsage, ModelConfig, RunOptions, ExecutionOptions, SmoothStreamOptions, AgentExecutionCounter, PersistedExecutionOptions, ResumeOptions, GenerateResult, StreamResult, BuiltAgent, AgentRunState, AgentResumeData, PendingToolCall, SerializableAgentState, } from './sdk/agent';
|
|
5
5
|
export type { SerializedMessageList } from './runtime/message-list';
|
|
6
6
|
export type { ToolContext, ToolExecutionContext, InterruptibleToolContext, BuiltTool, BuiltProviderTool, } from './sdk/tool';
|
|
7
|
-
export type { Thread, BuiltMemory, BuiltEpisodicMemoryStore, EpisodicMemoryConfig, EpisodicMemoryCursor, EpisodicMemoryEmbeddingProviderOptions, EpisodicMemoryEntry, EpisodicMemoryEntrySource, EpisodicMemoryExtractFn, EpisodicMemoryExtraction, EpisodicMemoryExtractionCandidate, EpisodicMemoryExtractorInput, EpisodicMemoryMethods, EpisodicMemoryPrompts, EpisodicMemoryReflectFn, EpisodicMemoryReflection, EpisodicMemoryReflectionApply, EpisodicMemoryReflectionApplyMerge, EpisodicMemoryReflectionMerge, EpisodicMemoryReflectionResult, EpisodicMemoryReflectorInput, EpisodicMemoryScope, EpisodicMemorySearchOptions, EpisodicMemoryStatus, EpisodicMemoryTaskLockHandle, EpisodicMemoryTaskLockMethods, NewEpisodicMemoryCursor, NewEpisodicMemoryEntry, NewEpisodicMemoryEntrySource, NewEpisodicMemoryEntrySourceForEntry, RetrievedEpisodicMemoryEntry, ObservationCapableMemory, MemoryDescriptor,
|
|
7
|
+
export type { Thread, BuiltMemory, BuiltEpisodicMemoryStore, EpisodicMemoryConfig, EpisodicMemoryCursor, EpisodicMemoryEmbeddingProviderOptions, EpisodicMemoryEntry, EpisodicMemoryEntrySource, EpisodicMemoryExtractFn, EpisodicMemoryExtraction, EpisodicMemoryExtractionCandidate, EpisodicMemoryExtractorInput, EpisodicMemoryMethods, EpisodicMemoryPrompts, EpisodicMemoryReflectFn, EpisodicMemoryReflection, EpisodicMemoryReflectionApply, EpisodicMemoryReflectionApplyMerge, EpisodicMemoryReflectionMerge, EpisodicMemoryReflectionResult, EpisodicMemoryReflectorInput, EpisodicMemoryScope, EpisodicMemorySearchOptions, EpisodicMemoryStatus, EpisodicMemoryTaskLockHandle, EpisodicMemoryTaskLockMethods, NewEpisodicMemoryCursor, NewEpisodicMemoryEntry, NewEpisodicMemoryEntrySource, NewEpisodicMemoryEntrySourceForEntry, RetrievedEpisodicMemoryEntry, ObservationCapableMemory, MemoryDescriptor, MemoryConfig, ObservationLogMemoryConfig, ObservationalMemoryConfig, CheckpointStore, TitleGenerationConfig, } from './sdk/memory';
|
|
8
8
|
export type { ObservationCursor } from './sdk/observation';
|
|
9
9
|
export type { BuiltObservationLogStore, BuiltObservationLogTaskLockStore, NewObservationLogEntry, ObservationLogEntry, ObservationLogMarker, ObservationLogMerge, ObservationLogObserveFn, ObservationLogObserverInput, ObservationLogReadOptions, ObservationLogReflectFn, ObservationLogReflectorInput, ObservationLogReflection, ObservationLogReflectionResult, ObservationLogScope, ObservationLogStatus, ObservationLogTaskKind, ObservationLogTaskLockHandle, TokenCounter, } from './sdk/observation-log';
|
|
10
10
|
export { estimateObservationTokens, OBSERVATION_LOG_MARKERS, OBSERVATION_LOG_STATUSES, } from './sdk/observation-log';
|
package/dist/types/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AA4HA,yDAI+B;AAH9B,4HAAA,yBAAyB,OAAA;AACzB,0HAAA,uBAAuB,OAAA;AACvB,2HAAA,wBAAwB,OAAA;AA6BzB,yCAA6C;AAApC,mGAAA,UAAU,OAAA"}
|
|
@@ -1,4 +1,28 @@
|
|
|
1
|
+
import type { FinishReason, TokenUsage } from '../sdk/agent';
|
|
1
2
|
import type { AgentMessage, ContentToolCall } from '../sdk/message';
|
|
3
|
+
export type SubAgentLifecycleUsage = Pick<TokenUsage, 'promptTokens' | 'completionTokens' | 'totalTokens' | 'cost'>;
|
|
4
|
+
export interface SubAgentLifecycleBase {
|
|
5
|
+
taskName: string;
|
|
6
|
+
taskPath: string;
|
|
7
|
+
parentRunId?: string;
|
|
8
|
+
parentToolCallId?: string;
|
|
9
|
+
subAgentId?: string;
|
|
10
|
+
}
|
|
11
|
+
export interface SubAgentStartedPayload extends SubAgentLifecycleBase {
|
|
12
|
+
startedAt: number;
|
|
13
|
+
}
|
|
14
|
+
export interface SubAgentCompletedPayload extends SubAgentLifecycleBase {
|
|
15
|
+
status: 'completed' | 'failed' | 'suspended';
|
|
16
|
+
startedAt: number;
|
|
17
|
+
finishedAt: number;
|
|
18
|
+
durationMs: number;
|
|
19
|
+
runId?: string;
|
|
20
|
+
threadId?: string;
|
|
21
|
+
model?: string;
|
|
22
|
+
usage?: SubAgentLifecycleUsage;
|
|
23
|
+
finishReason?: FinishReason;
|
|
24
|
+
error?: string;
|
|
25
|
+
}
|
|
2
26
|
export declare const enum AgentEvent {
|
|
3
27
|
AgentStart = "agent_start",
|
|
4
28
|
AgentEnd = "agent_end",
|
|
@@ -6,6 +30,8 @@ export declare const enum AgentEvent {
|
|
|
6
30
|
TurnEnd = "turn_end",
|
|
7
31
|
ToolExecutionStart = "tool_execution_start",
|
|
8
32
|
ToolExecutionEnd = "tool_execution_end",
|
|
33
|
+
SubAgentStarted = "subagent_started",
|
|
34
|
+
SubAgentCompleted = "subagent_completed",
|
|
9
35
|
Error = "error"
|
|
10
36
|
}
|
|
11
37
|
export type AgentEventData = {
|
|
@@ -30,7 +56,11 @@ export type AgentEventData = {
|
|
|
30
56
|
toolName: string;
|
|
31
57
|
result: unknown;
|
|
32
58
|
isError: boolean;
|
|
33
|
-
} | {
|
|
59
|
+
} | ({
|
|
60
|
+
type: AgentEvent.SubAgentStarted;
|
|
61
|
+
} & SubAgentStartedPayload) | ({
|
|
62
|
+
type: AgentEvent.SubAgentCompleted;
|
|
63
|
+
} & SubAgentCompletedPayload) | {
|
|
34
64
|
type: AgentEvent.Error;
|
|
35
65
|
message: string;
|
|
36
66
|
error: unknown;
|
|
@@ -9,6 +9,8 @@ var AgentEvent;
|
|
|
9
9
|
AgentEvent["TurnEnd"] = "turn_end";
|
|
10
10
|
AgentEvent["ToolExecutionStart"] = "tool_execution_start";
|
|
11
11
|
AgentEvent["ToolExecutionEnd"] = "tool_execution_end";
|
|
12
|
+
AgentEvent["SubAgentStarted"] = "subagent_started";
|
|
13
|
+
AgentEvent["SubAgentCompleted"] = "subagent_completed";
|
|
12
14
|
AgentEvent["Error"] = "error";
|
|
13
15
|
})(AgentEvent || (exports.AgentEvent = AgentEvent = {}));
|
|
14
16
|
//# sourceMappingURL=event.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/types/runtime/event.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/types/runtime/event.ts"],"names":[],"mappings":";;;AAmCA,IAAkB,UAUjB;AAVD,WAAkB,UAAU;IAC3B,wCAA0B,CAAA;IAC1B,oCAAsB,CAAA;IACtB,sCAAwB,CAAA;IACxB,kCAAoB,CAAA;IACpB,yDAA2C,CAAA;IAC3C,qDAAuC,CAAA;IACvC,kDAAoC,CAAA;IACpC,sDAAwC,CAAA;IACxC,6BAAe,CAAA;AAChB,CAAC,EAViB,UAAU,0BAAV,UAAU,QAU3B"}
|
|
@@ -17,7 +17,6 @@ export interface AgentBuilder {
|
|
|
17
17
|
providerTool(t: BuiltProviderTool): this;
|
|
18
18
|
thinking(provider: string, config?: Record<string, unknown>): this;
|
|
19
19
|
toolCallConcurrency(n: number): this;
|
|
20
|
-
requireToolApproval(): this;
|
|
21
20
|
memory(m: unknown): this;
|
|
22
21
|
checkpoint(storage: 'memory' | CheckpointStore): this;
|
|
23
22
|
inputGuardrail(g: BuiltGuardrail): this;
|