@n8n/agents 0.6.0 → 0.7.0

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

@@ -1,6 +1,13 @@
 import type { z } from 'zod';
 import type { ModelConfig, SerializableAgentState } from './agent';
 import type { AgentDbMessage } from './message';
+import type { BuiltObservationStore, ObservationalMemoryConfig } from './observation';
+import type { JSONObject } from '../utils/json';
+export interface MemoryDescriptor<TParams extends JSONObject = JSONObject> {
+    name: string;
+    constructorName: string;
+    connectionParams: TParams | null;
+}
 export interface Thread {
     id: string;
     resourceId: string;
@@ -16,6 +23,10 @@ export interface BuiltMemory {
     getMessages(threadId: string, opts?: {
         limit?: number;
         before?: Date;
+        since?: {
+            sinceCreatedAt: Date;
+            sinceMessageId: string;
+        };
     }): Promise<AgentDbMessage[]>;
     saveMessages(args: {
         threadId: string;
@@ -65,6 +76,7 @@ export interface BuiltMemory {
         score: number;
     }>>;
     close?(): Promise<void>;
+    describe(): MemoryDescriptor;
 }
 export interface SemanticRecallConfig {
     scope?: 'thread' | 'resource';
@@ -79,9 +91,10 @@ export interface SemanticRecallConfig {
 export interface TitleGenerationConfig {
     model?: ModelConfig;
     instructions?: string;
+    sync?: boolean;
 }
-export interface MemoryConfig {
-    memory: BuiltMemory;
+export type ObservationCapableMemory = BuiltMemory & BuiltObservationStore;
+interface MemoryConfigBase {
     lastMessages: number;
     workingMemory?: {
         template: string;
@@ -93,8 +106,16 @@ export interface MemoryConfig {
     semanticRecall?: SemanticRecallConfig;
     titleGeneration?: TitleGenerationConfig;
 }
+export type MemoryConfig = (MemoryConfigBase & {
+    memory: BuiltMemory;
+    observationalMemory?: undefined;
+}) | (MemoryConfigBase & {
+    memory: ObservationCapableMemory;
+    observationalMemory: ObservationalMemoryConfig;
+});
 export interface CheckpointStore {
     save(key: string, state: SerializableAgentState): Promise<void>;
     load(key: string): Promise<SerializableAgentState | undefined>;
     delete(key: string): Promise<void>;
 }
+export {};

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

@@ -1,7 +1,7 @@
 import type { ProviderOptions } from '@ai-sdk/provider-utils';
 import type { JSONValue } from '../utils/json';
 export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
-export type MessageContent = ContentText | ContentToolCall | ContentInvalidToolCall | ContentToolResult | ContentReasoning | ContentFile | ContentCitation | ContentProvider;
+export type MessageContent = ContentText | ContentToolCall | ContentInvalidToolCall | ContentReasoning | ContentFile | ContentCitation | ContentProvider;
 export interface ContentMetadata {
     providerMetadata?: Record<string, unknown>;
     providerOptions?: ProviderOptions;
@@ -30,18 +30,19 @@ export type ContentFile = ContentMetadata & {
 };
 export type ContentToolCall = ContentMetadata & {
     type: 'tool-call';
-    toolCallId?: string;
+    toolCallId: string;
     toolName: string;
     input: JSONValue;
     providerExecuted?: boolean;
-};
-export type ContentToolResult = ContentMetadata & {
-    type: 'tool-result';
-    toolName: string;
-    toolCallId: string;
-    result: JSONValue;
-    isError?: boolean;
-};
+} & ({
+    state: 'pending';
+} | {
+    state: 'resolved';
+    output: JSONValue;
+} | {
+    state: 'rejected';
+    error: string;
+});
 export type ContentInvalidToolCall = ContentMetadata & {
     type: 'invalid-tool-call';
     toolCallId?: string;

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

@@ -0,0 +1,100 @@
+import type { z } from 'zod';
+import type { ModelConfig } from './agent';
+import type { AgentDbMessage } from './message';
+import type { BuiltTelemetry } from '../telemetry';
+import type { JSONValue } from '../utils/json';
+export declare const OBSERVATION_SCHEMA_VERSION = 1;
+export type ScopeKind = 'thread' | 'resource' | 'agent';
+export interface Observation {
+    id: string;
+    scopeKind: ScopeKind;
+    scopeId: string;
+    kind: string;
+    payload: JSONValue;
+    durationMs: number | null;
+    schemaVersion: number;
+    createdAt: Date;
+}
+export type NewObservation = Omit<Observation, 'id'>;
+export interface ObservationCursor {
+    scopeKind: ScopeKind;
+    scopeId: string;
+    lastObservedMessageId: string;
+    lastObservedAt: Date;
+    updatedAt: Date;
+}
+export interface ObservationLockHandle {
+    scopeKind: ScopeKind;
+    scopeId: string;
+    holderId: string;
+    heldUntil: Date;
+}
+export type ObserveFn = (ctx: {
+    deltaMessages: AgentDbMessage[];
+    currentWorkingMemory: string | null;
+    cursor: ObservationCursor | null;
+    threadId: string;
+    resourceId: string;
+    now: Date;
+    trigger: ObservationalMemoryTrigger;
+    telemetry: BuiltTelemetry | undefined;
+}) => Promise<NewObservation[]>;
+export type CompactFn = (ctx: {
+    observations: Observation[];
+    currentWorkingMemory: string | null;
+    workingMemoryTemplate: string;
+    structured: boolean;
+    schema?: z.ZodObject<z.ZodRawShape>;
+    threadId: string;
+    resourceId: string;
+    model: ModelConfig;
+    compactorPrompt: string;
+    telemetry: BuiltTelemetry | undefined;
+}) => Promise<{
+    content: string;
+}>;
+export interface BuiltObservationStore {
+    appendObservations(rows: NewObservation[]): Promise<Observation[]>;
+    getObservations(opts: {
+        scopeKind: ScopeKind;
+        scopeId: string;
+        since?: {
+            sinceCreatedAt: Date;
+            sinceObservationId: string;
+        };
+        kindIs?: string;
+        limit?: number;
+        schemaVersionAtMost?: number;
+    }): Promise<Observation[]>;
+    getMessagesForScope(scopeKind: ScopeKind, scopeId: string, opts?: {
+        since?: {
+            sinceCreatedAt: Date;
+            sinceMessageId: string;
+        };
+    }): Promise<AgentDbMessage[]>;
+    deleteObservations(ids: string[]): Promise<void>;
+    getCursor(scopeKind: ScopeKind, scopeId: string): Promise<ObservationCursor | null>;
+    setCursor(cursor: ObservationCursor): Promise<void>;
+    acquireObservationLock(scopeKind: ScopeKind, scopeId: string, opts: {
+        ttlMs: number;
+        holderId: string;
+    }): Promise<ObservationLockHandle | null>;
+    releaseObservationLock(handle: ObservationLockHandle): Promise<void>;
+}
+export type ObservationalMemoryTrigger = {
+    type: 'per-turn';
+} | {
+    type: 'idle-timer';
+    idleMs: number;
+    gapThresholdMs?: number;
+};
+export interface ObservationalMemoryConfig {
+    observe?: ObserveFn;
+    compact?: CompactFn;
+    trigger?: ObservationalMemoryTrigger;
+    compactionThreshold?: number;
+    observerPrompt?: string;
+    compactorPrompt?: string;
+    lockTtlMs?: number;
+    sync?: boolean;
+}

package/dist/types/sdk/observation.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OBSERVATION_SCHEMA_VERSION = void 0;
+exports.OBSERVATION_SCHEMA_VERSION = 1;
+//# sourceMappingURL=observation.js.map

package/dist/types/sdk/observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../../../src/types/sdk/observation.ts"],"names":[],"mappings":";;;AAYa,QAAA,0BAA0B,GAAG,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { JSONSchema7 } from 'json-schema';
+export interface ToolDescriptor {
+    name: string;
+    description: string;
+    systemInstruction: string | null;
+    inputSchema: JSONSchema7 | null;
+    outputSchema: JSONSchema7 | null;
+    hasSuspend: boolean;
+    hasResume: boolean;
+    hasToMessage: boolean;
+    requireApproval: boolean;
+    providerOptions: Record<string, unknown> | null;
+}

package/dist/types/sdk/{schema.js → tool-descriptor.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=schema.js.map
+//# sourceMappingURL=tool-descriptor.js.map

package/dist/types/sdk/tool-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-descriptor.js","sourceRoot":"","sources":["../../../src/types/sdk/tool-descriptor.ts"],"names":[],"mappings":""}

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

@@ -4,27 +4,32 @@ import type { AgentMessage } from './message';
 import type { BuiltTelemetry } from '../telemetry';
 import type { JSONObject } from '../utils/json';
 export interface ToolContext {
+    toolCallId?: string;
     parentTelemetry?: BuiltTelemetry;
 }
 export interface InterruptibleToolContext<S = unknown, R = unknown> {
     suspend: (payload: S) => Promise<never>;
     resumeData: R | undefined;
+    toolCallId?: string;
     parentTelemetry?: BuiltTelemetry;
 }
 export interface BuiltTool {
     readonly name: string;
     readonly description: string;
-    readonly suspendSchema?: ZodType;
-    readonly resumeSchema?: ZodType;
+    readonly systemInstruction?: string;
+    readonly suspendSchema?: ZodType | JSONSchema7;
+    readonly resumeSchema?: ZodType | JSONSchema7;
     readonly withDefaultApproval?: boolean;
     readonly toMessage?: (output: unknown) => AgentMessage | undefined;
     readonly toModelOutput?: (output: unknown) => unknown;
     readonly handler?: (input: unknown, ctx: ToolContext | InterruptibleToolContext) => Promise<unknown>;
     readonly inputSchema?: ZodType | JSONSchema7;
-    readonly outputSchema?: ZodType;
+    readonly outputSchema?: ZodType | JSONSchema7;
     readonly mcpTool?: boolean;
     readonly mcpServerName?: string;
     readonly providerOptions?: Record<string, JSONObject>;
+    readonly metadata?: Record<string, unknown>;
+    readonly editable?: boolean;
 }
 export interface BuiltProviderTool {
     readonly name: `${string}.${string}`;

package/dist/types/telemetry.d.ts

@@ -11,6 +11,7 @@ export interface BuiltTelemetry {
     readonly metadata?: Record<string, AttributeValue>;
     readonly recordInputs: boolean;
     readonly recordOutputs: boolean;
+    readonly runtimeRootSpanEnabled?: boolean;
     readonly integrations: TelemetryIntegration[];
     readonly tracer?: OpaqueTracer;
     readonly provider?: OpaqueTracerProvider;

package/dist/utils/parse.d.ts

@@ -0,0 +1,10 @@
+import type { JSONSchema7 } from 'json-schema';
+import type { ZodType } from 'zod';
+export type ParseResult<T = unknown> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+export declare function parseWithSchema(schema: ZodType | JSONSchema7, data: unknown): Promise<ParseResult>;

package/dist/utils/parse.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseWithSchema = parseWithSchema;
+const zod_1 = require("./zod");
+let ajvInstance;
+function getAjv() {
+    if (!ajvInstance) {
+        const { default: Ajv } = require('ajv');
+        ajvInstance = new Ajv({ strict: false });
+    }
+    return ajvInstance;
+}
+async function parseWithSchema(schema, data) {
+    if ((0, zod_1.isZodSchema)(schema)) {
+        const result = await schema.safeParseAsync(data);
+        if (result.success)
+            return { success: true, data: result.data };
+        return { success: false, error: result.error.message };
+    }
+    const ajv = getAjv();
+    const validate = ajv.compile(schema);
+    if (validate(data))
+        return { success: true, data };
+    return { success: false, error: ajv.errorsText(validate.errors) };
+}
+//# sourceMappingURL=parse.js.map

package/dist/utils/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/utils/parse.ts"],"names":[],"mappings":";;AAyBA,0CAcC;AAnCD,+BAAoC;AAMpC,IAAI,WAAqD,CAAC;AAE1D,SAAS,MAAM;IACd,IAAI,CAAC,WAAW,EAAE,CAAC;QAElB,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAgC,CAAC;QACvE,WAAW,GAAG,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,WAAW,CAAC;AACpB,CAAC;AAMM,KAAK,UAAU,eAAe,CACpC,MAA6B,EAC7B,IAAa;IAEb,IAAI,IAAA,iBAAW,EAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;AACnE,CAAC"}

package/dist/utils/zod.d.ts

@@ -1,4 +1,4 @@
 import type { JSONSchema7 } from 'json-schema';
 import type { ZodType } from 'zod';
-export declare function isZodSchema(schema: ZodType | JSONSchema7): schema is ZodType;
+export declare function isZodSchema(schema: unknown): schema is ZodType;
 export declare function zodToJsonSchema(schema?: unknown): JSONSchema7 | null;

package/dist/utils/zod.js.map

@@ -1 +1 @@
-{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/utils/zod.ts"],"names":[],"mappings":";;AAKA,kCAMC;AAED,0CAgBC;AA3BD,2DAA4E;AAG5E,SAAgB,WAAW,CAAC,MAA6B;IACxD,OAAO,CACN,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAQ,MAAkB,CAAC,SAAS,KAAK,UAAU,CACnD,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAAC,MAAgB;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC;QACJ,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,IAAI,cAAc,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;gBAC3E,OAAQ,MAAyD,CAAC,YAAY,EAAE,CAAC;YAClF,CAAC;YACD,OAAO,IAAA,oCAAmB,EAAC,MAAM,CAA4B,CAAC;QAC/D,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACnD,OAAO,MAAM,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/utils/zod.ts"],"names":[],"mappings":";;AAKA,kCAMC;AAED,0CAgBC;AA3BD,2DAA4E;AAG5E,SAAgB,WAAW,CAAC,MAAe;IAC1C,OAAO,CACN,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAQ,MAAkC,CAAC,SAAS,KAAK,UAAU,CACnE,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAAC,MAAgB;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC;QACJ,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,IAAI,cAAc,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;gBAC3E,OAAQ,MAAyD,CAAC,YAAY,EAAE,CAAC;YAClF,CAAC;YACD,OAAO,IAAA,oCAAmB,EAAC,MAAM,CAA4B,CAAC;QAC/D,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACnD,OAAO,MAAM,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/workspace/tools/batch-str-replace-file.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltTool } from '../../types/sdk/tool';
+import type { WorkspaceFilesystem } from '../types';
+export declare function createBatchStrReplaceFileTool(filesystem: WorkspaceFilesystem): BuiltTool;

package/dist/workspace/tools/batch-str-replace-file.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBatchStrReplaceFileTool = createBatchStrReplaceFileTool;
+const text_editor_1 = require("@n8n/ai-utilities/text-editor");
+const zod_1 = require("zod");
+const tool_1 = require("../../sdk/tool");
+const strReplacementSchema = zod_1.z.object({
+    old_str: zod_1.z.string().describe('Exact text to replace. Must match exactly and be unique.'),
+    new_str: zod_1.z.string().describe('Replacement text to write in place of old_str.'),
+});
+const inputSchema = zod_1.z.object({
+    path: zod_1.z.string().describe('Path to the file to edit'),
+    replacements: zod_1.z
+        .array(strReplacementSchema)
+        .describe('Ordered exact string replacements applied atomically.'),
+});
+const batchReplaceResultSchema = zod_1.z.object({
+    index: zod_1.z.number().int(),
+    old_str: zod_1.z.string(),
+    status: zod_1.z.enum(['success', 'failed', 'not_attempted']),
+    error: zod_1.z.string().optional(),
+});
+const outputSchema = zod_1.z.object({
+    success: zod_1.z.boolean().describe('Whether all replacements were applied'),
+    result: zod_1.z.string().optional().describe('Success message'),
+    error: zod_1.z.string().optional().describe('Error message when replacements could not be applied'),
+    results: zod_1.z
+        .array(batchReplaceResultSchema)
+        .optional()
+        .describe('Per-replacement statuses for a failed batch edit'),
+});
+function createErrorOutput(error) {
+    return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Unknown workspace edit error.',
+    };
+}
+function isBatchReplaceResult(result) {
+    return Array.isArray(result);
+}
+function createBatchStrReplaceFileTool(filesystem) {
+    return new tool_1.Tool('workspace_batch_str_replace_file')
+        .description('Apply multiple exact text replacements to a workspace file atomically. If any replacement fails, no changes are written.')
+        .input(inputSchema)
+        .output(outputSchema)
+        .handler(async (input) => {
+        try {
+            const content = await filesystem.readFile(input.path, { encoding: 'utf-8' });
+            const editor = new text_editor_1.TextEditorDocument({ initialText: content.toString() });
+            const result = editor.executeBatch(input.replacements);
+            if (isBatchReplaceResult(result)) {
+                return { success: false, error: 'Batch replacement failed.', results: result };
+            }
+            const editedContent = editor.getText();
+            if (editedContent === null) {
+                throw new Error(`File "${input.path}" is not loaded.`);
+            }
+            await filesystem.writeFile(input.path, editedContent, { overwrite: true });
+            return { success: true, result };
+        }
+        catch (error) {
+            return createErrorOutput(error);
+        }
+    })
+        .build();
+}
+//# sourceMappingURL=batch-str-replace-file.js.map

package/dist/workspace/tools/batch-str-replace-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-str-replace-file.js","sourceRoot":"","sources":["../../../src/workspace/tools/batch-str-replace-file.ts"],"names":[],"mappings":"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"}

package/dist/workspace/tools/str-replace-file.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltTool } from '../../types/sdk/tool';
+import type { WorkspaceFilesystem } from '../types';
+export declare function createStrReplaceFileTool(filesystem: WorkspaceFilesystem): BuiltTool;

package/dist/workspace/tools/str-replace-file.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStrReplaceFileTool = createStrReplaceFileTool;
+const text_editor_1 = require("@n8n/ai-utilities/text-editor");
+const zod_1 = require("zod");
+const tool_1 = require("../../sdk/tool");
+const inputSchema = zod_1.z.object({
+    path: zod_1.z.string().describe('Path to the file to edit'),
+    old_str: zod_1.z.string().describe('Exact text to replace. Must match exactly and be unique.'),
+    new_str: zod_1.z.string().describe('Replacement text to write in place of old_str.'),
+});
+const outputSchema = zod_1.z.object({
+    success: zod_1.z.boolean().describe('Whether the edit was applied'),
+    result: zod_1.z.string().optional().describe('Success message'),
+    error: zod_1.z.string().optional().describe('Error message when the edit could not be applied'),
+});
+function createErrorOutput(error) {
+    return {
+        success: false,
+        error: error instanceof Error ? error.message : 'Unknown workspace edit error.',
+    };
+}
+function createStrReplaceFileTool(filesystem) {
+    return new tool_1.Tool('workspace_str_replace_file')
+        .description('Replace one exact, unique text match in a workspace file without rewriting the whole file.')
+        .input(inputSchema)
+        .output(outputSchema)
+        .handler(async (input) => {
+        try {
+            const content = await filesystem.readFile(input.path, { encoding: 'utf-8' });
+            const editor = new text_editor_1.TextEditorDocument({ initialText: content.toString() });
+            const result = editor.execute({
+                command: 'str_replace',
+                path: input.path,
+                old_str: input.old_str,
+                new_str: input.new_str,
+            });
+            const editedContent = editor.getText();
+            if (editedContent === null) {
+                throw new Error(`File "${input.path}" is not loaded.`);
+            }
+            await filesystem.writeFile(input.path, editedContent, { overwrite: true });
+            return { success: true, result };
+        }
+        catch (error) {
+            return createErrorOutput(error);
+        }
+    })
+        .build();
+}
+//# sourceMappingURL=str-replace-file.js.map

package/dist/workspace/tools/str-replace-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"str-replace-file.js","sourceRoot":"","sources":["../../../src/workspace/tools/str-replace-file.ts"],"names":[],"mappings":";;AA4BA,4DA6BC;AAzDD,+DAAmE;AACnE,6BAAwB;AAExB,yCAAsC;AAItC,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACrD,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;IACxF,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAC9E,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7B,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC7D,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACzD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;CACzF,CAAC,CAAC;AAIH,SAAS,iBAAiB,CAAC,KAAc;IACxC,OAAO;QACN,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B;KAC/E,CAAC;AACH,CAAC;AAED,SAAgB,wBAAwB,CAAC,UAA+B;IACvE,OAAO,IAAI,WAAI,CAAC,4BAA4B,CAAC;SAC3C,WAAW,CACX,4FAA4F,CAC5F;SACA,KAAK,CAAC,WAAW,CAAC;SAClB,MAAM,CAAC,YAAY,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACxB,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7E,MAAM,MAAM,GAAG,IAAI,gCAAkB,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;gBAC7B,OAAO,EAAE,aAAa;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACvC,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,kBAAkB,CAAC,CAAC;YACxD,CAAC;YAED,MAAM,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACF,CAAC,CAAC;SACD,KAAK,EAAE,CAAC;AACX,CAAC"}

package/dist/workspace/tools/workspace-tools.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createWorkspaceTools = createWorkspaceTools;
 const append_file_1 = require("./append-file");
+const batch_str_replace_file_1 = require("./batch-str-replace-file");
 const copy_file_1 = require("./copy-file");
 const delete_file_1 = require("./delete-file");
 const execute_command_1 = require("./execute-command");
@@ -12,11 +13,14 @@ const move_file_1 = require("./move-file");
 const process_tools_1 = require("./process-tools");
 const read_file_1 = require("./read-file");
 const rmdir_1 = require("./rmdir");
+const str_replace_file_1 = require("./str-replace-file");
 const write_file_1 = require("./write-file");
 function createWorkspaceTools(workspace) {
     const tools = [];
     if (workspace.filesystem) {
         tools.push((0, read_file_1.createReadFileTool)(workspace.filesystem));
+        tools.push((0, str_replace_file_1.createStrReplaceFileTool)(workspace.filesystem));
+        tools.push((0, batch_str_replace_file_1.createBatchStrReplaceFileTool)(workspace.filesystem));
         tools.push((0, write_file_1.createWriteFileTool)(workspace.filesystem));
         tools.push((0, list_files_1.createListFilesTool)(workspace.filesystem));
         tools.push((0, file_stat_1.createFileStatTool)(workspace.filesystem));

package/dist/workspace/tools/workspace-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-tools.js","sourceRoot":"","sources":["../../../src/workspace/tools/workspace-tools.ts"],"names":[],"mappings":";;AAoBA,oDA0BC;AA5CD,+CAAqD;AACrD,2CAAiD;AACjD,+CAAqD;AACrD,uDAA6D;AAC7D,2CAAiD;AACjD,6CAAmD;AACnD,mCAA0C;AAC1C,2CAAiD;AACjD,mDAAiF;AACjF,2CAAiD;AACjD,mCAA0C;AAC1C,6CAAmD;AAOnD,SAAgB,oBAAoB,CAAC,SAAwB;IAC5D,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,IAAA,8BAAkB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,IAAA,gCAAmB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,IAAA,gCAAmB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,IAAA,8BAAkB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,IAAA,uBAAe,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,IAAA,kCAAoB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,IAAA,kCAAoB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,IAAA,8BAAkB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,IAAA,8BAAkB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,IAAA,uBAAe,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,IAAA,0CAAwB,EAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,IAAA,uCAAuB,EAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,IAAA,qCAAqB,EAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}
+{"version":3,"file":"workspace-tools.js","sourceRoot":"","sources":["../../../src/workspace/tools/workspace-tools.ts"],"names":[],"mappings":";;AAsBA,oDA4BC;AAhDD,+CAAqD;AACrD,qEAAyE;AACzE,2CAAiD;AACjD,+CAAqD;AACrD,uDAA6D;AAC7D,2CAAiD;AACjD,6CAAmD;AACnD,mCAA0C;AAC1C,2CAAiD;AACjD,mDAAiF;AACjF,2CAAiD;AACjD,mCAA0C;AAC1C,yDAA8D;AAC9D,6CAAmD;AAOnD,SAAgB,oBAAoB,CAAC,SAAwB;IAC5D,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,IAAA,8BAAkB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,IAAA,2CAAwB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,IAAA,sDAA6B,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,IAAA,gCAAmB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,IAAA,gCAAmB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,IAAA,8BAAkB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,IAAA,uBAAe,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,IAAA,kCAAoB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,IAAA,kCAAoB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,IAAA,8BAAkB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,IAAA,8BAAkB,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,IAAA,uBAAe,EAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,IAAA,0CAAwB,EAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,IAAA,uCAAuB,EAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,IAAA,qCAAqB,EAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n8n/agents",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "AI agent SDK for n8n's code-first execution engine",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -11,23 +11,32 @@
     "LICENSE_EE.md"
   ],
   "dependencies": {
+    "@ai-sdk/amazon-bedrock": "^4.0.95",
     "@ai-sdk/anthropic": "^3.0.58",
+    "@ai-sdk/azure": "^3.0.54",
+    "@ai-sdk/cohere": "^3.0.30",
+    "@ai-sdk/deepseek": "^2.0.29",
+    "@ai-sdk/gateway": "^3.0.104",
     "@ai-sdk/google": "^3.0.43",
+    "@ai-sdk/groq": "^3.0.35",
+    "@ai-sdk/mistral": "^3.0.30",
     "@ai-sdk/openai": "^3.0.41",
-    "@ai-sdk/xai": "^3.0.67",
     "@ai-sdk/provider-utils": "^4.0.21",
-    "@modelcontextprotocol/sdk": "1.26.0",
-    "ajv": "^8.18.0",
+    "@ai-sdk/xai": "^3.0.67",
     "@libsql/client": "^0.17.0",
+    "@modelcontextprotocol/sdk": "1.26.0",
+    "@openrouter/ai-sdk-provider": "^2.8.0",
     "ai": "^6.0.116",
+    "ajv": "^8.18.0",
     "pg": "8.17.0",
-    "zod": "3.25.67"
+    "zod": "3.25.67",
+    "@n8n/ai-utilities": "0.15.0"
   },
   "peerDependencies": {
-    "langsmith": ">=0.3.0",
-    "@opentelemetry/sdk-trace-node": ">=1.0.0",
+    "@opentelemetry/exporter-trace-otlp-http": ">=0.50.0",
     "@opentelemetry/sdk-trace-base": ">=1.0.0",
-    "@opentelemetry/exporter-trace-otlp-http": ">=0.50.0"
+    "@opentelemetry/sdk-trace-node": ">=1.0.0",
+    "langsmith": ">=0.3.0"
   },
   "peerDependenciesMeta": {
     "langsmith": {

package/dist/codegen/generate-agent-code.d.ts

@@ -1,2 +0,0 @@
-import type { AgentSchema } from '../types/sdk/schema';
-export declare function generateAgentCode(schema: AgentSchema, agentName: string): Promise<string>;