@n8n/agents 0.10.1 → 0.12.0

package/dist/sdk/tool.js

@@ -1,25 +1,47 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Tool = void 0;
+exports.getToolApprovalDisplayName = getToolApprovalDisplayName;
 exports.wrapToolForApproval = wrapToolForApproval;
 const zod_1 = require("zod");
 const zod_2 = require("../utils/zod");
 const APPROVAL_SUSPEND_SCHEMA = zod_1.z.object({
     type: zod_1.z.literal('approval'),
     toolName: zod_1.z.string(),
+    displayName: zod_1.z.string().optional(),
     args: zod_1.z.unknown(),
 });
 const APPROVAL_RESUME_SCHEMA = zod_1.z.object({
     approved: zod_1.z.boolean(),
 });
+function emitToolExecutionStart(tool, input, ctx) {
+    if (!ctx.toolCallId)
+        return;
+    ctx.emitEvent?.({
+        type: "tool_execution_start",
+        toolCallId: ctx.toolCallId,
+        toolName: tool.name,
+        args: input,
+    });
+}
+function getToolApprovalDisplayName(tool) {
+    const metadata = tool.metadata;
+    const displayName = metadata?.displayName ?? metadata?.workflowName;
+    return typeof displayName === 'string' && displayName.length > 0 ? displayName : undefined;
+}
 function wrapToolForApproval(tool, config) {
     const originalHandler = tool.handler;
+    const hasConditionalApproval = config.needsApprovalFn !== undefined;
     return {
         ...tool,
-        withDefaultApproval: true,
+        approval: {
+            required: config.requireApproval === true,
+            ...(hasConditionalApproval ? { conditional: true } : {}),
+        },
         suspendSchema: APPROVAL_SUSPEND_SCHEMA,
         resumeSchema: APPROVAL_RESUME_SCHEMA,
-        handler: async (input, ctx) => {
+        async handler(input, ctx) {
+            const currentTool = this ?? tool;
             const interruptCtx = ctx;
             if (interruptCtx.resumeData === undefined) {
                 let needs = config.requireApproval ?? false;
@@ -27,19 +49,24 @@ function wrapToolForApproval(tool, config) {
                     needs = await config.needsApprovalFn(input);
                 }
                 if (needs) {
-                    return await interruptCtx.suspend({ type: 'approval', toolName: tool.name, args: input });
+                    const displayName = getToolApprovalDisplayName(currentTool);
+                    return await interruptCtx.suspend({
+                        type: 'approval',
+                        toolName: currentTool.name,
+                        ...(displayName ? { displayName } : {}),
+                        args: input,
+                    });
+                }
+                if (hasConditionalApproval) {
+                    emitToolExecutionStart(currentTool, input, interruptCtx);
                 }
-                return await originalHandler(input, {
-                    parentTelemetry: interruptCtx.parentTelemetry,
-                });
+                return await originalHandler(input, interruptCtx);
             }
             const { approved } = interruptCtx.resumeData;
             if (!approved) {
-                return { declined: true, message: `Tool "${tool.name}" was not approved` };
+                return { declined: true, message: `Tool "${currentTool.name}" was not approved` };
             }
-            return await originalHandler(input, {
-                parentTelemetry: interruptCtx.parentTelemetry,
-            });
+            return await originalHandler(input, interruptCtx);
         },
     };
 }
@@ -87,6 +114,10 @@ class Tool {
         this.toModelOutputFn = fn;
         return this;
     }
+    handleCancellation() {
+        this.handleCancellationValue = true;
+        return this;
+    }
     requireApproval() {
         this.requireApprovalValue = true;
         return this;
@@ -130,6 +161,7 @@ class Tool {
             systemInstruction: this.systemInstructionText,
             suspendSchema: this.suspendSchemaValue,
             resumeSchema: this.resumeSchemaValue,
+            handleCancellation: this.handleCancellationValue,
             toMessage: this.toMessageFn,
             toModelOutput: this.toModelOutputFn,
             handler: this.handlerFn,

package/dist/sdk/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/sdk/tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/sdk/tool.ts"],"names":[],"mappings":"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"}

package/dist/storage/base-memory.d.ts

@@ -18,37 +18,6 @@ export declare abstract class BaseMemory<TConstructorOptions extends JSONObject
         messages: AgentDbMessage[];
     }): Promise<void>;
     deleteMessages(_messageIds: string[]): Promise<void>;
-    search?(_query: string, _opts?: {
-        scope?: 'thread' | 'resource';
-        threadId?: string;
-        resourceId?: string;
-        topK?: number;
-        messageRange?: {
-            before: number;
-            after: number;
-        };
-    }): Promise<AgentDbMessage[]>;
-    saveEmbeddings?(_opts: {
-        scope?: 'thread' | 'resource';
-        threadId?: string;
-        resourceId?: string;
-        entries: Array<{
-            id: string;
-            vector: number[];
-            text: string;
-            model: string;
-        }>;
-    }): Promise<void>;
-    queryEmbeddings?(_opts: {
-        scope?: 'thread' | 'resource';
-        threadId?: string;
-        resourceId?: string;
-        vector: number[];
-        topK: number;
-    }): Promise<Array<{
-        id: string;
-        score: number;
-    }>>;
     close?(): Promise<void>;
     describe(): MemoryDescriptor<TConstructorOptions>;
 }

package/dist/storage/base-memory.js

@@ -24,15 +24,6 @@ class BaseMemory {
     deleteMessages(_messageIds) {
         throw new Error('Method not implemented.');
     }
-    search(_query, _opts) {
-        throw new Error('Method not implemented.');
-    }
-    saveEmbeddings(_opts) {
-        throw new Error('Method not implemented.');
-    }
-    queryEmbeddings(_opts) {
-        throw new Error('Method not implemented.');
-    }
     close() {
         throw new Error('Method not implemented.');
     }

package/dist/storage/base-memory.js.map

@@ -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;IACD,MAAM,CACL,MAAc,EACd,KAMC;QAED,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,cAAc,CAAE,KAKf;QACA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,eAAe,CAAE,KAMhB;QACA,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;AA1ED,gCA0EC"}
+{"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

@@ -1,10 +1,10 @@
 export type { JSONValue, JSONObject, JSONArray } from './utils/json';
 export type { MessageRole, MessageContent, ContentMetadata, ContentCitation, ContentText, ContentReasoning, ContentFile, ContentToolCall, ContentInvalidToolCall, ContentProvider, Message, AgentMessageBase, CustomAgentMessages, AgentMessage, AgentDbMessage, } from './sdk/message';
 export type { Provider, AnthropicThinkingConfig, OpenAIThinkingConfig, GoogleThinkingConfig, XaiThinkingConfig, ThinkingConfigFor, ThinkingConfig, } from './sdk/provider';
-export type { AgentResult, StreamChunk, FinishReason, TokenUsage, ModelConfig, RunOptions, ExecutionOptions, AgentExecutionCounter, PersistedExecutionOptions, ResumeOptions, GenerateResult, StreamResult, SubAgentUsage, BuiltAgent, AgentRunState, AgentResumeData, PendingToolCall, SerializableAgentState, } from './sdk/agent';
+export type { AgentResult, StreamChunk, FinishReason, TokenUsage, ModelConfig, RunOptions, ExecutionOptions, SmoothStreamOptions, AgentExecutionCounter, PersistedExecutionOptions, ResumeOptions, GenerateResult, StreamResult, BuiltAgent, AgentRunState, AgentResumeData, PendingToolCall, SerializableAgentState, } from './sdk/agent';
 export type { SerializedMessageList } from './runtime/message-list';
 export type { ToolContext, ToolExecutionContext, InterruptibleToolContext, BuiltTool, BuiltProviderTool, } from './sdk/tool';
-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, SemanticRecallConfig, MemoryConfig, ObservationLogMemoryConfig, ObservationalMemoryConfig, CheckpointStore, TitleGenerationConfig, } from './sdk/memory';
+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';
 export type { ObservationCursor } from './sdk/observation';
 export type { BuiltObservationLogStore, BuiltObservationLogTaskLockStore, NewObservationLogEntry, ObservationLogEntry, ObservationLogMarker, ObservationLogMerge, ObservationLogObserveFn, ObservationLogObserverInput, ObservationLogReadOptions, ObservationLogReflectFn, ObservationLogReflectorInput, ObservationLogReflection, ObservationLogReflectionResult, ObservationLogScope, ObservationLogStatus, ObservationLogTaskKind, ObservationLogTaskLockHandle, TokenCounter, } from './sdk/observation-log';
 export { estimateObservationTokens, OBSERVATION_LOG_MARKERS, OBSERVATION_LOG_STATUSES, } from './sdk/observation-log';

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AA6HA,yDAI+B;AAH9B,4HAAA,yBAAyB,OAAA;AACzB,0HAAA,uBAAuB,OAAA;AACvB,2HAAA,wBAAwB,OAAA;AA6BzB,yCAA6C;AAApC,mGAAA,UAAU,OAAA"}
+{"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"}

package/dist/types/runtime/event.d.ts

@@ -1,4 +1,28 @@
+import type { FinishReason, TokenUsage } from '../sdk/agent';
 import type { AgentMessage, ContentToolCall } from '../sdk/message';
+export type SubAgentLifecycleUsage = Pick<TokenUsage, 'promptTokens' | 'completionTokens' | 'totalTokens' | 'cost'>;
+export interface SubAgentLifecycleBase {
+    taskName: string;
+    taskPath: string;
+    parentRunId?: string;
+    parentToolCallId?: string;
+    subAgentId?: string;
+}
+export interface SubAgentStartedPayload extends SubAgentLifecycleBase {
+    startedAt: number;
+}
+export interface SubAgentCompletedPayload extends SubAgentLifecycleBase {
+    status: 'completed' | 'failed' | 'suspended';
+    startedAt: number;
+    finishedAt: number;
+    durationMs: number;
+    runId?: string;
+    threadId?: string;
+    model?: string;
+    usage?: SubAgentLifecycleUsage;
+    finishReason?: FinishReason;
+    error?: string;
+}
 export declare const enum AgentEvent {
     AgentStart = "agent_start",
     AgentEnd = "agent_end",
@@ -6,6 +30,8 @@ export declare const enum AgentEvent {
     TurnEnd = "turn_end",
     ToolExecutionStart = "tool_execution_start",
     ToolExecutionEnd = "tool_execution_end",
+    SubAgentStarted = "subagent_started",
+    SubAgentCompleted = "subagent_completed",
     Error = "error"
 }
 export type AgentEventData = {
@@ -30,7 +56,11 @@ export type AgentEventData = {
     toolName: string;
     result: unknown;
     isError: boolean;
-} | {
+} | ({
+    type: AgentEvent.SubAgentStarted;
+} & SubAgentStartedPayload) | ({
+    type: AgentEvent.SubAgentCompleted;
+} & SubAgentCompletedPayload) | {
     type: AgentEvent.Error;
     message: string;
     error: unknown;

package/dist/types/runtime/event.js

@@ -9,6 +9,8 @@ var AgentEvent;
     AgentEvent["TurnEnd"] = "turn_end";
     AgentEvent["ToolExecutionStart"] = "tool_execution_start";
     AgentEvent["ToolExecutionEnd"] = "tool_execution_end";
+    AgentEvent["SubAgentStarted"] = "subagent_started";
+    AgentEvent["SubAgentCompleted"] = "subagent_completed";
     AgentEvent["Error"] = "error";
 })(AgentEvent || (exports.AgentEvent = AgentEvent = {}));
 //# sourceMappingURL=event.js.map

package/dist/types/runtime/event.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/types/runtime/event.ts"],"names":[],"mappings":";;;AAEA,IAAkB,UAQjB;AARD,WAAkB,UAAU;IAC3B,wCAA0B,CAAA;IAC1B,oCAAsB,CAAA;IACtB,sCAAwB,CAAA;IACxB,kCAAoB,CAAA;IACpB,yDAA2C,CAAA;IAC3C,qDAAuC,CAAA;IACvC,6BAAe,CAAA;AAChB,CAAC,EARiB,UAAU,0BAAV,UAAU,QAQ3B"}
+{"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"}

package/dist/types/sdk/agent-builder.d.ts

@@ -17,7 +17,6 @@ export interface AgentBuilder {
     providerTool(t: BuiltProviderTool): this;
     thinking(provider: string, config?: Record<string, unknown>): this;
     toolCallConcurrency(n: number): this;
-    requireToolApproval(): this;
     memory(m: unknown): this;
     checkpoint(storage: 'memory' | CheckpointStore): this;
     inputGuardrail(g: BuiltGuardrail): this;

package/dist/types/sdk/agent.d.ts

@@ -1,13 +1,13 @@
 import type { ProviderOptions } from '@ai-sdk/provider-utils';
-import type { LanguageModel } from 'ai';
+import type { LanguageModel, smoothStream } from 'ai';
 import type { JsonSchema7Type } from 'zod-to-json-schema';
 import type { AgentMessage, ContentMetadata } from './message';
-import type { BuiltTool } from './tool';
 import type { ProviderId, ProviderCredentials } from '../../runtime/provider-credentials';
-import type { AgentEvent, AgentEventHandler } from '../runtime/event';
+import type { AgentEvent, AgentEventHandler, SubAgentCompletedPayload, SubAgentStartedPayload } from '../runtime/event';
 import type { SerializedMessageList } from '../runtime/message-list';
 import type { BuiltTelemetry } from '../telemetry';
 import type { JSONValue } from '../utils/json';
+export type SmoothStreamOptions = NonNullable<Parameters<typeof smoothStream>[0]>;
 export type FinishReason = 'stop' | 'max-iterations' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other';
 export type TokenUsage<T extends Record<string, unknown> = Record<string, unknown>> = {
     promptTokens: number;
@@ -82,12 +82,20 @@ export type StreamChunk = ContentMetadata & ({
     type: 'tool-execution-start';
     toolCallId: string;
     toolName: string;
+    startTime: number;
+} | {
+    type: 'tool-execution-end';
+    toolCallId: string;
+    toolName: string;
+    isError: boolean;
+    endTime: number;
 } | {
     type: 'tool-result';
     toolCallId: string;
     toolName: string;
     output: unknown;
     isError?: boolean;
+    canceled?: boolean;
 } | {
     type: 'tool-call-suspended';
     runId: string;
@@ -99,14 +107,16 @@ export type StreamChunk = ContentMetadata & ({
 } | {
     type: 'message';
     message: AgentMessage;
-} | {
+} | ({
+    type: 'subagent-started';
+} & SubAgentStartedPayload) | ({
+    type: 'subagent-completed';
+} & SubAgentCompletedPayload) | {
     type: 'finish';
     finishReason: FinishReason;
     usage?: TokenUsage;
     model?: string;
     structuredOutput?: unknown;
-    subAgentUsage?: SubAgentUsage[];
-    totalCost?: number;
 } | {
     type: 'error';
     error: unknown;
@@ -123,6 +133,7 @@ export interface ExecutionOptions {
     maxIterations?: number;
     abortSignal?: AbortSignal;
     providerOptions?: ProviderOptions;
+    smoothStream?: SmoothStreamOptions | false;
     telemetry?: BuiltTelemetry;
     executionCounter?: AgentExecutionCounter;
 }
@@ -134,11 +145,7 @@ export interface ToolResultEntry {
     input: unknown;
     output: unknown;
     transformed?: boolean;
-}
-export interface SubAgentUsage {
-    agent: string;
-    model?: string;
-    usage: TokenUsage;
+    canceled?: boolean;
 }
 export interface GenerateResult {
     runId: string;
@@ -149,8 +156,6 @@ export interface GenerateResult {
     finishReason?: FinishReason;
     providerMetadata?: Record<string, unknown>;
     toolCalls?: ToolResultEntry[];
-    subAgentUsage?: SubAgentUsage[];
-    totalCost?: number;
     pendingSuspend?: Array<{
         runId: string;
         toolCallId: string;
@@ -160,10 +165,12 @@ export interface GenerateResult {
         resumeSchema?: JsonSchema7Type;
     }>;
     error?: unknown;
+    getState(): SerializableAgentState;
 }
 export interface StreamResult {
     runId: string;
     stream: ReadableStream<StreamChunk>;
+    getState(): SerializableAgentState;
 }
 export interface ResumeOptions {
     runId: string;
@@ -174,8 +181,6 @@ export interface BuiltAgent {
     generate(input: AgentMessage[] | string, options?: RunOptions & ExecutionOptions): Promise<GenerateResult>;
     stream(input: AgentMessage[] | string, options?: RunOptions & ExecutionOptions): Promise<StreamResult>;
     on(event: AgentEvent, handler: AgentEventHandler): void;
-    asTool(description: string): BuiltTool;
-    getState(): SerializableAgentState;
     abort(): void;
     close(): Promise<void>;
     resume(method: 'generate', data: unknown, options: ResumeOptions & ExecutionOptions): Promise<GenerateResult>;

package/dist/types/sdk/guardrail.d.ts

@@ -1,6 +1,6 @@
 export type GuardrailType = 'pii' | 'prompt-injection' | 'moderation' | 'custom';
 export type GuardrailStrategy = 'block' | 'redact' | 'warn';
-export type PiiDetectionType = 'email' | 'phone' | 'credit-card' | 'ssn' | 'address';
+export type PiiDetectionType = 'email' | 'phone' | 'credit-card' | 'ssn-us' | 'address';
 export interface BuiltGuardrail {
     readonly name: string;
     readonly guardType: 'pii' | 'prompt-injection' | 'moderation' | 'custom';

package/dist/types/sdk/memory.d.ts

@@ -31,51 +31,10 @@ export interface BuiltMemory {
         messages: AgentDbMessage[];
     }): Promise<void>;
     deleteMessages(messageIds: string[]): Promise<void>;
-    search?(query: string, opts?: {
-        scope?: 'thread' | 'resource';
-        threadId?: string;
-        resourceId?: string;
-        topK?: number;
-        messageRange?: {
-            before: number;
-            after: number;
-        };
-    }): Promise<AgentDbMessage[]>;
-    saveEmbeddings?(opts: {
-        scope?: 'thread' | 'resource';
-        threadId?: string;
-        resourceId?: string;
-        entries: Array<{
-            id: string;
-            vector: number[];
-            text: string;
-            model: string;
-        }>;
-    }): Promise<void>;
-    queryEmbeddings?(opts: {
-        scope?: 'thread' | 'resource';
-        threadId?: string;
-        resourceId?: string;
-        vector: number[];
-        topK: number;
-    }): Promise<Array<{
-        id: string;
-        score: number;
-    }>>;
     episodic?: EpisodicMemoryMethods;
     close?(): Promise<void>;
     describe(): MemoryDescriptor;
 }
-export interface SemanticRecallConfig {
-    scope?: 'thread' | 'resource';
-    topK: number;
-    messageRange?: {
-        before: number;
-        after: number;
-    };
-    embedder?: string;
-    apiKey?: string;
-}
 export type EpisodicMemoryStatus = 'active' | 'superseded' | 'dropped';
 export interface EpisodicMemoryScope {
     resourceId: string;
@@ -244,7 +203,6 @@ export interface ObservationalMemoryConfig {
 }
 interface MemoryConfigBase {
     observationLog?: ObservationLogMemoryConfig;
-    semanticRecall?: SemanticRecallConfig;
     episodicMemory?: EpisodicMemoryConfig;
     titleGeneration?: TitleGenerationConfig;
 }

package/dist/types/sdk/message.d.ts

@@ -39,6 +39,7 @@ export type ContentToolCall = ContentMetadata & {
 } | {
     state: 'resolved';
     output: JSONValue;
+    canceled?: boolean;
 } | {
     state: 'rejected';
     error: string;

package/dist/types/sdk/tool.d.ts

@@ -1,6 +1,8 @@
 import type { JSONSchema7 } from 'json-schema';
 import type { ZodType } from 'zod';
+import type { AgentExecutionCounter } from './agent';
 import type { AgentMessage } from './message';
+import type { AgentEventData } from '../runtime/event';
 import type { BuiltTelemetry } from '../telemetry';
 import type { JSONObject } from '../utils/json';
 export interface ToolExecutionContext {
@@ -9,20 +11,32 @@ export interface ToolExecutionContext {
         threadId: string;
         resourceId: string;
     };
+    emitEvent?: (event: AgentEventData) => void;
+    abortSignal?: AbortSignal;
+    executionCounter?: AgentExecutionCounter;
 }
 export interface ToolContext {
     toolCallId?: string;
     runId?: string;
     persistence?: ToolExecutionContext['persistence'];
     parentTelemetry?: BuiltTelemetry;
+    emitEvent?: ToolExecutionContext['emitEvent'];
+    abortSignal?: ToolExecutionContext['abortSignal'];
+    executionCounter?: ToolExecutionContext['executionCounter'];
 }
 export interface InterruptibleToolContext<S = unknown, R = unknown> {
     suspend: (payload: S) => Promise<never>;
     resumeData: R | undefined;
+    cancellation?: {
+        message: string;
+    };
     toolCallId?: string;
     runId?: string;
     persistence?: ToolExecutionContext['persistence'];
     parentTelemetry?: BuiltTelemetry;
+    emitEvent?: ToolExecutionContext['emitEvent'];
+    abortSignal?: ToolExecutionContext['abortSignal'];
+    executionCounter?: ToolExecutionContext['executionCounter'];
 }
 export interface BuiltTool {
     readonly name: string;
@@ -30,7 +44,11 @@ export interface BuiltTool {
     readonly systemInstruction?: string;
     readonly suspendSchema?: ZodType | JSONSchema7;
     readonly resumeSchema?: ZodType | JSONSchema7;
-    readonly withDefaultApproval?: boolean;
+    readonly approval?: {
+        readonly required: boolean;
+        readonly conditional?: boolean;
+    };
+    readonly handleCancellation?: boolean;
     readonly toMessage?: (output: unknown) => AgentMessage | undefined;
     readonly toModelOutput?: (output: unknown) => unknown;
     readonly handler?: (input: unknown, ctx: ToolContext | InterruptibleToolContext) => Promise<unknown>;

package/dist/utils/json-schema.d.ts

@@ -0,0 +1,3 @@
+import type { JSONSchema7 } from 'json-schema';
+export declare const fixSchema: (schema: JSONSchema7) => JSONSchema7;
+export declare function lockAdditionalProperties(schema: JSONSchema7): JSONSchema7;

package/dist/utils/json-schema.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fixSchema = void 0;
+exports.lockAdditionalProperties = lockAdditionalProperties;
+const fixSchema = (schema) => {
+    if (typeof schema === 'object' &&
+        schema !== null &&
+        'properties' in schema &&
+        !('type' in schema)) {
+        return { ...schema, type: 'object' };
+    }
+    return schema;
+};
+exports.fixSchema = fixSchema;
+function lockAdditionalProperties(schema) {
+    const result = lockDefinition(schema);
+    return typeof result === 'object' ? result : schema;
+}
+function lockDefinition(schema) {
+    if (typeof schema !== 'object' || schema === null)
+        return schema;
+    const result = { ...schema };
+    if (result.properties !== undefined && result.type === undefined) {
+        result.type = 'object';
+    }
+    const isObjectSchema = result.type === 'object' ||
+        (Array.isArray(result.type) && result.type.includes('object')) ||
+        result.properties !== undefined;
+    if (isObjectSchema && result.additionalProperties === undefined) {
+        result.additionalProperties = false;
+    }
+    if (result.properties) {
+        result.properties = mapDefinitions(result.properties);
+    }
+    if (result.$defs) {
+        result.$defs = mapDefinitions(result.$defs);
+    }
+    if (result.definitions) {
+        result.definitions = mapDefinitions(result.definitions);
+    }
+    if (result.items !== undefined) {
+        result.items = Array.isArray(result.items)
+            ? result.items.map(lockDefinition)
+            : lockDefinition(result.items);
+    }
+    if (typeof result.additionalProperties === 'object' && result.additionalProperties !== null) {
+        result.additionalProperties = lockDefinition(result.additionalProperties);
+    }
+    for (const key of ['allOf', 'anyOf', 'oneOf']) {
+        const branch = result[key];
+        if (Array.isArray(branch)) {
+            result[key] = branch.map(lockDefinition);
+        }
+    }
+    if (result.not !== undefined) {
+        result.not = lockDefinition(result.not);
+    }
+    return result;
+}
+function mapDefinitions(record) {
+    const out = {};
+    for (const [key, value] of Object.entries(record)) {
+        Object.defineProperty(out, key, {
+            value: lockDefinition(value),
+            enumerable: true,
+            writable: true,
+            configurable: true,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/utils/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../src/utils/json-schema.ts"],"names":[],"mappings":"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"}

package/dist/workspace/filesystem/daytona-filesystem.d.ts

@@ -0,0 +1,25 @@
+import type { CopyOptions, FileContent, FileEntry, FileStat, ListOptions, ProviderStatus, ReadOptions, RemoveOptions, WriteOptions } from '../types';
+import { BaseFilesystem } from './base-filesystem';
+import type { DaytonaSandbox } from '../sandbox/daytona-sandbox';
+export declare class DaytonaFilesystem extends BaseFilesystem {
+    private readonly sandbox;
+    readonly id: string;
+    readonly name = "DaytonaFilesystem";
+    readonly provider = "daytona";
+    status: ProviderStatus;
+    constructor(sandbox: DaytonaSandbox);
+    private withFs;
+    readFile(path: string, options?: ReadOptions): Promise<string | Buffer>;
+    writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void>;
+    appendFile(path: string, content: FileContent): Promise<void>;
+    deleteFile(path: string, options?: RemoveOptions): Promise<void>;
+    copyFile(src: string, dest: string, _options?: CopyOptions): Promise<void>;
+    moveFile(src: string, dest: string, _options?: CopyOptions): Promise<void>;
+    mkdir(path: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rmdir(path: string, options?: RemoveOptions): Promise<void>;
+    readdir(path: string, _options?: ListOptions): Promise<FileEntry[]>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+}