@n8n/agents 0.6.0 → 0.8.0

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

@@ -0,0 +1,99 @@
+import type { AgentDbMessage } from './message';
+export declare const OBSERVATION_LOG_MARKERS: readonly ["critical", "important", "info", "completion"];
+export type ObservationLogMarker = (typeof OBSERVATION_LOG_MARKERS)[number];
+export declare const OBSERVATION_LOG_STATUSES: readonly ["active", "superseded", "dropped"];
+export type ObservationLogStatus = (typeof OBSERVATION_LOG_STATUSES)[number];
+export type ObservationLogScopeKind = 'thread' | 'resource';
+export type ObservationLogTaskKind = 'observer' | 'reflector';
+export declare function createObservationLogThreadScopeId(threadId: string, resourceId: string): string;
+export declare function createObservationLogThreadScopePrefix(threadId: string): string;
+export interface ObservationLogScope {
+    scopeKind: ObservationLogScopeKind;
+    scopeId: string;
+}
+export interface ObservationLogTaskLockHandle extends ObservationLogScope {
+    taskKind: ObservationLogTaskKind;
+    holderId: string;
+    heldUntil: Date;
+}
+export interface ObservationLogEntry extends ObservationLogScope {
+    id: string;
+    marker: ObservationLogMarker;
+    text: string;
+    parentId: string | null;
+    tokenCount: number;
+    status: ObservationLogStatus;
+    supersededBy: string | null;
+    createdAt: Date;
+}
+export interface NewObservationLogEntry extends ObservationLogScope {
+    marker: ObservationLogMarker;
+    text: string;
+    parentId?: string | null;
+    tokenCount?: number;
+    createdAt?: Date;
+}
+export interface ObservationLogReadOptions extends ObservationLogScope {
+    status?: ObservationLogStatus;
+    parentId?: string | null;
+    limit?: number;
+    order?: 'asc' | 'desc';
+}
+export interface ObservationLogMerge {
+    supersedes: string[];
+    marker: ObservationLogMarker;
+    text: string;
+    parentId?: string | null;
+    tokenCount?: number;
+    createdAt?: Date;
+}
+export interface ObservationLogReflection {
+    drop: string[];
+    merge: ObservationLogMerge[];
+}
+export interface ObservationLogReflectionResult {
+    droppedIds: string[];
+    supersededIds: string[];
+    inserted: ObservationLogEntry[];
+}
+export type TokenCounter = (text: string) => number;
+export declare const estimateObservationTokens: TokenCounter;
+export interface ObservationLogObserverInput {
+    scopeKind: ObservationLogScopeKind;
+    scopeId: string;
+    now: Date;
+    deltaMessages: AgentDbMessage[];
+    transcript: string;
+    transcriptTokenCount: number;
+    observationLogTail: ObservationLogEntry[];
+    renderedObservationLogTail: string | null;
+}
+export type ObservationLogObserveFn = (input: ObservationLogObserverInput) => Promise<string>;
+export interface ObservationLogReflectorInput {
+    scopeKind: ObservationLogScopeKind;
+    scopeId: string;
+    now: Date;
+    activeObservationLog: ObservationLogEntry[];
+    renderedObservationLog: string;
+    tokenCount: number;
+    tokenBudget: number;
+}
+export type ObservationLogReflectFn = (input: ObservationLogReflectorInput) => Promise<string>;
+export interface BuiltObservationLogStore {
+    appendObservationLogEntries(rows: NewObservationLogEntry[]): Promise<ObservationLogEntry[]>;
+    getActiveObservationLog(scope: ObservationLogScope & {
+        limit?: number;
+        order?: 'asc' | 'desc';
+    }): Promise<ObservationLogEntry[]>;
+    getObservationLog(opts: ObservationLogReadOptions): Promise<ObservationLogEntry[]>;
+    dropObservationLogEntries(ids: string[]): Promise<void>;
+    supersedeObservationLogEntries(ids: string[], supersededBy: string): Promise<void>;
+    applyObservationLogReflection(scope: ObservationLogScope, reflection: ObservationLogReflection): Promise<ObservationLogReflectionResult>;
+}
+export interface BuiltObservationLogTaskLockStore {
+    acquireObservationLogTaskLock(scopeKind: ObservationLogScopeKind, scopeId: string, taskKind: ObservationLogTaskKind, opts: {
+        ttlMs: number;
+        holderId: string;
+    }): Promise<ObservationLogTaskLockHandle | null>;
+    releaseObservationLogTaskLock(handle: ObservationLogTaskLockHandle): Promise<void>;
+}

package/dist/types/sdk/observation-log.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateObservationTokens = exports.OBSERVATION_LOG_STATUSES = exports.OBSERVATION_LOG_MARKERS = void 0;
+exports.createObservationLogThreadScopeId = createObservationLogThreadScopeId;
+exports.createObservationLogThreadScopePrefix = createObservationLogThreadScopePrefix;
+exports.OBSERVATION_LOG_MARKERS = ['critical', 'important', 'info', 'completion'];
+exports.OBSERVATION_LOG_STATUSES = ['active', 'superseded', 'dropped'];
+const OBSERVATION_LOG_THREAD_SCOPE_PREFIX = 'thread';
+function createObservationLogThreadScopeId(threadId, resourceId) {
+    return `${OBSERVATION_LOG_THREAD_SCOPE_PREFIX}:${encodeURIComponent(threadId)}:resource:${encodeURIComponent(resourceId)}`;
+}
+function createObservationLogThreadScopePrefix(threadId) {
+    return `${OBSERVATION_LOG_THREAD_SCOPE_PREFIX}:${encodeURIComponent(threadId)}:resource:`;
+}
+const estimateObservationTokens = (text) => Math.ceil(text.length / 4);
+exports.estimateObservationTokens = estimateObservationTokens;
+//# sourceMappingURL=observation-log.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observation-log.js","sourceRoot":"","sources":["../../../src/types/sdk/observation-log.ts"],"names":[],"mappings":";;;AAgBA,8EAEC;AAED,sFAEC;AApBY,QAAA,uBAAuB,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAInF,QAAA,wBAAwB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAU,CAAC;AAQrF,MAAM,mCAAmC,GAAG,QAAQ,CAAC;AAErD,SAAgB,iCAAiC,CAAC,QAAgB,EAAE,UAAkB;IACrF,OAAO,GAAG,mCAAmC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,aAAa,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;AAC5H,CAAC;AAED,SAAgB,qCAAqC,CAAC,QAAgB;IACrE,OAAO,GAAG,mCAAmC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,YAAY,CAAC;AAC3F,CAAC;AA6DM,MAAM,yBAAyB,GAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAA/E,QAAA,yBAAyB,6BAAsD"}

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

@@ -0,0 +1,9 @@
+import type { ObservationLogScopeKind } from './observation-log';
+export type ScopeKind = ObservationLogScopeKind;
+export interface ObservationCursor {
+    scopeKind: ObservationLogScopeKind;
+    scopeId: string;
+    lastObservedMessageId: string;
+    lastObservedAt: Date;
+    updatedAt: Date;
+}

package/dist/types/sdk/{schema.js → observation.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=schema.js.map
+//# 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":""}

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

@@ -1,7 +1,10 @@
 export type Provider = 'anthropic' | 'cerebras' | 'deepinfra' | 'deepseek' | 'google' | 'groq' | 'mistral' | 'openai' | 'openrouter' | 'perplexity' | 'togetherai' | 'vercel' | 'xai' | (string & {});
-export interface AnthropicThinkingConfig {
+export type AnthropicThinkingConfig = {
+    mode: 'adaptive';
+} | {
+    mode?: 'enabled';
     budgetTokens?: number;
-}
+};
 export interface OpenAIThinkingConfig {
     reasoningEffort?: 'low' | 'medium' | 'high';
 }

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/tool-descriptor.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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.8.0",
   "description": "AI agent SDK for n8n's code-first execution engine",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -11,23 +11,30 @@
     "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",
+    "@ai-sdk/xai": "^3.0.67",
     "@modelcontextprotocol/sdk": "1.26.0",
-    "ajv": "^8.18.0",
-    "@libsql/client": "^0.17.0",
+    "@openrouter/ai-sdk-provider": "^2.8.0",
     "ai": "^6.0.116",
-    "pg": "8.17.0",
-    "zod": "3.25.67"
+    "ajv": "^8.18.0",
+    "zod": "3.25.67",
+    "@n8n/ai-utilities": "0.16.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.6.0"
   },
   "peerDependenciesMeta": {
     "langsmith": {
@@ -45,8 +52,6 @@
   },
   "devDependencies": {
     "@types/json-schema": "^7.0.15",
-    "@types/pg": "^8.15.6",
-    "testcontainers": "^11.13.0",
     "@n8n/typescript-config": "1.4.0"
   },
   "license": "SEE LICENSE IN LICENSE.md",

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>;