@n8n/agents 0.7.1 → 0.8.1

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

@@ -1,100 +1,9 @@
-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'>;
+import type { ObservationLogScopeKind } from './observation-log';
+export type ScopeKind = ObservationLogScopeKind;
 export interface ObservationCursor {
-    scopeKind: ScopeKind;
+    scopeKind: ObservationLogScopeKind;
     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

@@ -1,5 +1,3 @@
 "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

@@ -1 +1 @@
-{"version":3,"file":"observation.js","sourceRoot":"","sources":["../../../src/types/sdk/observation.ts"],"names":[],"mappings":";;;AAYa,QAAA,0BAA0B,GAAG,CAAC,CAAC"}
+{"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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n8n/agents",
-  "version": "0.7.1",
+  "version": "0.8.1",
   "description": "AI agent SDK for n8n's code-first execution engine",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -23,20 +23,18 @@
     "@ai-sdk/openai": "^3.0.41",
     "@ai-sdk/provider-utils": "^4.0.21",
     "@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",
-    "@n8n/ai-utilities": "0.15.1"
+    "@n8n/ai-utilities": "0.16.1"
   },
   "peerDependencies": {
     "@opentelemetry/exporter-trace-otlp-http": ">=0.50.0",
     "@opentelemetry/sdk-trace-base": ">=1.0.0",
     "@opentelemetry/sdk-trace-node": ">=1.0.0",
-    "langsmith": ">=0.3.0"
+    "langsmith": "0.6.0"
   },
   "peerDependenciesMeta": {
     "langsmith": {
@@ -54,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/runtime/working-memory.d.ts

@@ -1,14 +0,0 @@
-import { z } from 'zod';
-import type { BuiltTool } from '../types';
-type ZodObjectSchema = z.ZodObject<z.ZodRawShape>;
-export declare const UPDATE_WORKING_MEMORY_TOOL_NAME = "update_working_memory";
-export declare const WORKING_MEMORY_DEFAULT_INSTRUCTION: string;
-export declare function buildWorkingMemoryInstruction(template: string, structured: boolean, instruction?: string): string;
-export declare function templateFromSchema(schema: ZodObjectSchema): string;
-export interface WorkingMemoryToolConfig {
-    structured: boolean;
-    schema?: ZodObjectSchema;
-    persist: (content: string) => Promise<void>;
-}
-export declare function buildWorkingMemoryTool(config: WorkingMemoryToolConfig): BuiltTool;
-export {};

package/dist/runtime/working-memory.js

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WORKING_MEMORY_DEFAULT_INSTRUCTION = exports.UPDATE_WORKING_MEMORY_TOOL_NAME = void 0;
-exports.buildWorkingMemoryInstruction = buildWorkingMemoryInstruction;
-exports.templateFromSchema = templateFromSchema;
-exports.buildWorkingMemoryTool = buildWorkingMemoryTool;
-const zod_1 = require("zod");
-exports.UPDATE_WORKING_MEMORY_TOOL_NAME = 'update_working_memory';
-exports.WORKING_MEMORY_DEFAULT_INSTRUCTION = [
-    'You have persistent working memory that survives across conversations.',
-    'Your current working memory state is shown below.',
-    `When you learn new information about the user or conversation that should be remembered, call the \`${exports.UPDATE_WORKING_MEMORY_TOOL_NAME}\` tool.`,
-    'Only call it when something has actually changed — do NOT call it if nothing new was learned.',
-].join('\n');
-function buildWorkingMemoryInstruction(template, structured, instruction) {
-    const format = structured
-        ? 'The memory argument must be valid JSON matching the schema'
-        : 'Update the template with any new information learned';
-    const body = instruction ?? exports.WORKING_MEMORY_DEFAULT_INSTRUCTION;
-    return [
-        '',
-        '## Working Memory',
-        '',
-        body,
-        `${format}.`,
-        '',
-        'Current template:',
-        '```',
-        template,
-        '```',
-    ].join('\n');
-}
-function templateFromSchema(schema) {
-    const obj = {};
-    for (const [key, field] of Object.entries(schema.shape)) {
-        const desc = field.description;
-        obj[key] = desc ?? '';
-    }
-    return JSON.stringify(obj, null, 2);
-}
-function buildWorkingMemoryTool(config) {
-    if (config.structured && config.schema) {
-        const schema = config.schema;
-        return {
-            name: exports.UPDATE_WORKING_MEMORY_TOOL_NAME,
-            description: 'Update your persistent working memory with new information about the user or conversation. Only call this when something has actually changed.',
-            inputSchema: schema,
-            handler: async (input) => {
-                const content = JSON.stringify(input, null, 2);
-                await config.persist(content);
-                return { success: true, message: 'Working memory updated.' };
-            },
-        };
-    }
-    const freeformSchema = zod_1.z.object({
-        memory: zod_1.z.string().describe('The updated working memory content.'),
-    });
-    return {
-        name: exports.UPDATE_WORKING_MEMORY_TOOL_NAME,
-        description: 'Update your persistent working memory with new information about the user or conversation. Only call this when something has actually changed.',
-        inputSchema: freeformSchema,
-        handler: async (input) => {
-            const { memory } = input;
-            await config.persist(memory);
-            return { success: true, message: 'Working memory updated.' };
-        },
-    };
-}
-//# sourceMappingURL=working-memory.js.map

package/dist/runtime/working-memory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"working-memory.js","sourceRoot":"","sources":["../../src/runtime/working-memory.ts"],"names":[],"mappings":";;;AA4BA,sEAuBC;AAKD,gDAOC;AAkBD,wDA+BC;AAhHD,6BAAwB;AAMX,QAAA,+BAA+B,GAAG,uBAAuB,CAAC;AAM1D,QAAA,kCAAkC,GAAG;IACjD,wEAAwE;IACxE,mDAAmD;IACnD,uGAAuG,uCAA+B,UAAU;IAChJ,+FAA+F;CAC/F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAWb,SAAgB,6BAA6B,CAC5C,QAAgB,EAChB,UAAmB,EACnB,WAAoB;IAEpB,MAAM,MAAM,GAAG,UAAU;QACxB,CAAC,CAAC,4DAA4D;QAC9D,CAAC,CAAC,sDAAsD,CAAC;IAE1D,MAAM,IAAI,GAAG,WAAW,IAAI,0CAAkC,CAAC;IAE/D,OAAO;QACN,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,IAAI;QACJ,GAAG,MAAM,GAAG;QACZ,EAAE;QACF,mBAAmB;QACnB,KAAK;QACL,QAAQ;QACR,KAAK;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAKD,SAAgB,kBAAkB,CAAC,MAAuB;IACzD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC;QAC/B,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC;AAkBD,SAAgB,sBAAsB,CAAC,MAA+B;IACrE,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,OAAO;YACN,IAAI,EAAE,uCAA+B;YACrC,WAAW,EACV,gJAAgJ;YACjJ,WAAW,EAAE,MAAM;YACnB,OAAO,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE;gBACjC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC/C,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;YAC9D,CAAC;SACD,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;QAC/B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KAClE,CAAC,CAAC;IAEH,OAAO;QACN,IAAI,EAAE,uCAA+B;QACrC,WAAW,EACV,gJAAgJ;QACjJ,WAAW,EAAE,cAAc;QAC3B,OAAO,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE;YACjC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAuC,CAAC;YAC3D,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;QAC9D,CAAC;KACD,CAAC;AACH,CAAC"}

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

@@ -1,96 +0,0 @@
-import { BaseMemory } from './base-memory';
-import type { Thread } from '../types/sdk/memory';
-import type { AgentDbMessage } from '../types/sdk/message';
-export type PostgresConnectionOptions = {
-    connectionType: 'url';
-    connection: {
-        url: string;
-    };
-} | {
-    connectionType: 'config';
-    connection: {
-        host?: string;
-        port?: number;
-        database?: string;
-        user?: string;
-        password?: string;
-    };
-};
-export type PostgresMemoryOptions = {
-    pool?: {
-        max?: number;
-        min?: number;
-        idleTimeoutMillis?: number;
-        connectionTimeoutMillis?: number;
-        allowExitOnIdle?: boolean;
-    };
-    ssl?: boolean;
-    namespace?: string;
-};
-export type PostgresConstructorOptions = ({
-    type: 'credential';
-    credential: string;
-} | {
-    type: 'connection';
-    connection: PostgresConnectionOptions;
-}) & {
-    options?: PostgresMemoryOptions;
-};
-export declare class PostgresMemory extends BaseMemory<PostgresConstructorOptions> {
-    protected readonly constructorOptions: PostgresConstructorOptions;
-    private readonly resolveConfig?;
-    private initPromise;
-    private embeddingsInitPromise;
-    private readonly ns;
-    constructor(constructorOptions: PostgresConstructorOptions, resolveConfig?: ((credential: string) => Promise<PostgresConnectionOptions>) | undefined);
-    private ensureInitialized;
-    private _initialize;
-    getThread(threadId: string): Promise<Thread | null>;
-    saveThread(thread: Omit<Thread, 'createdAt' | 'updatedAt'>): Promise<Thread>;
-    deleteThread(threadId: string): Promise<void>;
-    getMessages(threadId: string, opts?: {
-        limit?: number;
-        before?: Date;
-    }): Promise<AgentDbMessage[]>;
-    saveMessages(args: {
-        threadId: string;
-        resourceId?: string;
-        messages: AgentDbMessage[];
-    }): Promise<void>;
-    deleteMessages(messageIds: string[]): Promise<void>;
-    getWorkingMemory(params: {
-        threadId: string;
-        resourceId: string;
-        scope: 'resource' | 'thread';
-    }): Promise<string | null>;
-    saveWorkingMemory(params: {
-        threadId: string;
-        resourceId: string;
-        scope: 'resource' | 'thread';
-    }, content: string): Promise<void>;
-    private embeddingDimension;
-    private ensureEmbeddingsTable;
-    private _initializeEmbeddingsTable;
-    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>;
-}