@n8n/agents 0.8.1 → 0.9.1

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

@@ -1,15 +1,12 @@
+import type { AgentExecutionCounter } from './agent';
 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;
+    observationScopeId: string;
 }
 export interface ObservationLogTaskLockHandle extends ObservationLogScope {
     taskKind: ObservationLogTaskKind;
@@ -59,24 +56,24 @@ export interface ObservationLogReflectionResult {
 export type TokenCounter = (text: string) => number;
 export declare const estimateObservationTokens: TokenCounter;
 export interface ObservationLogObserverInput {
-    scopeKind: ObservationLogScopeKind;
-    scopeId: string;
+    observationScopeId: string;
     now: Date;
     deltaMessages: AgentDbMessage[];
     transcript: string;
     transcriptTokenCount: number;
     observationLogTail: ObservationLogEntry[];
     renderedObservationLogTail: string | null;
+    executionCounter?: AgentExecutionCounter;
 }
 export type ObservationLogObserveFn = (input: ObservationLogObserverInput) => Promise<string>;
 export interface ObservationLogReflectorInput {
-    scopeKind: ObservationLogScopeKind;
-    scopeId: string;
+    observationScopeId: string;
     now: Date;
     activeObservationLog: ObservationLogEntry[];
     renderedObservationLog: string;
     tokenCount: number;
     tokenBudget: number;
+    executionCounter?: AgentExecutionCounter;
 }
 export type ObservationLogReflectFn = (input: ObservationLogReflectorInput) => Promise<string>;
 export interface BuiltObservationLogStore {
@@ -91,7 +88,7 @@ export interface BuiltObservationLogStore {
     applyObservationLogReflection(scope: ObservationLogScope, reflection: ObservationLogReflection): Promise<ObservationLogReflectionResult>;
 }
 export interface BuiltObservationLogTaskLockStore {
-    acquireObservationLogTaskLock(scopeKind: ObservationLogScopeKind, scopeId: string, taskKind: ObservationLogTaskKind, opts: {
+    acquireObservationLogTaskLock(observationScopeId: string, taskKind: ObservationLogTaskKind, opts: {
         ttlMs: number;
         holderId: string;
     }): Promise<ObservationLogTaskLockHandle | null>;

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

@@ -1,17 +1,8 @@
 "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

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

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

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

@@ -22,8 +22,10 @@ function createExecuteCommandTool(sandbox) {
         if (!sandbox.executeCommand) {
             throw new Error('Sandbox does not support command execution');
         }
+        const env = sandbox.getDefaultCommandEnv?.();
         const result = await sandbox.executeCommand(input.command, undefined, {
             cwd: input.cwd,
+            ...(env ? { env } : {}),
             timeout: input.timeout,
         });
         return {

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

@@ -1 +1 @@
-{"version":3,"file":"execute-command.js","sourceRoot":"","sources":["../../../src/workspace/tools/execute-command.ts"],"names":[],"mappings":";;AAMA,4DAoCC;AA1CD,6BAAwB;AAExB,yCAAsC;AAItC,SAAgB,wBAAwB,CAAC,OAAyB;IACjE,OAAO,IAAI,WAAI,CAAC,2BAA2B,CAAC;SAC1C,WAAW,CAAC,wCAAwC,CAAC;SACrD,KAAK,CACL,OAAC,CAAC,MAAM,CAAC;QACR,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC5D,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QACxE,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KAClE,CAAC,CACF;SACA,MAAM,CACN,OAAC,CAAC,MAAM,CAAC;QACR,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;QACpB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;QAClB,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE;KAC3B,CAAC,CACF;SACA,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACxB,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE;YACrE,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,OAAO,EAAE,KAAK,CAAC,OAAO;SACtB,CAAC,CAAC;QACH,OAAO;YACN,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,eAAe,EAAE,MAAM,CAAC,eAAe;SACvC,CAAC;IACH,CAAC,CAAC;SACD,KAAK,EAAE,CAAC;AACX,CAAC"}
+{"version":3,"file":"execute-command.js","sourceRoot":"","sources":["../../../src/workspace/tools/execute-command.ts"],"names":[],"mappings":";;AAMA,4DAsCC;AA5CD,6BAAwB;AAExB,yCAAsC;AAItC,SAAgB,wBAAwB,CAAC,OAAyB;IACjE,OAAO,IAAI,WAAI,CAAC,2BAA2B,CAAC;SAC1C,WAAW,CAAC,wCAAwC,CAAC;SACrD,KAAK,CACL,OAAC,CAAC,MAAM,CAAC;QACR,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC5D,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QACxE,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KAClE,CAAC,CACF;SACA,MAAM,CACN,OAAC,CAAC,MAAM,CAAC;QACR,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;QACpB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;QAClB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;QAClB,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE;KAC3B,CAAC,CACF;SACA,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACxB,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE;YACrE,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,KAAK,CAAC,OAAO;SACtB,CAAC,CAAC;QACH,OAAO;YACN,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,eAAe,EAAE,MAAM,CAAC,eAAe;SACvC,CAAC;IACH,CAAC,CAAC;SACD,KAAK,EAAE,CAAC;AACX,CAAC"}

package/dist/workspace/types.d.ts

@@ -102,6 +102,7 @@ export interface WorkspaceSandbox {
     readonly provider: string;
     status: ProviderStatus;
     getInstructions?(): string;
+    getDefaultCommandEnv?(): NodeJS.ProcessEnv;
     executeCommand?(command: string, args?: string[], options?: ExecuteCommandOptions): Promise<CommandResult>;
     readonly processes?: SandboxProcessManager;
     start?(): Promise<void>;

package/dist/workspace/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":";;;AAwJA,qCAAiE;AAAxD,gHAAA,qBAAqB,OAAA;AAAE,wGAAA,aAAa,OAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":";;;AAyJA,qCAAiE;AAAxD,gHAAA,qBAAqB,OAAA;AAAE,wGAAA,aAAa,OAAA"}

package/package.json

@@ -1,10 +1,34 @@
 {
   "name": "@n8n/agents",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "description": "AI agent SDK for n8n's code-first execution engine",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "tool": [
+        "dist/sdk/tool.d.ts"
+      ],
+      "catalog": [
+        "dist/sdk/catalog.d.ts"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./tool": {
+      "types": "./dist/sdk/tool.d.ts",
+      "default": "./dist/sdk/tool.js"
+    },
+    "./catalog": {
+      "types": "./dist/sdk/catalog.d.ts",
+      "default": "./dist/sdk/catalog.js"
+    }
+  },
   "files": [
     "dist/**/*",
     "LICENSE.md",
@@ -12,7 +36,7 @@
   ],
   "dependencies": {
     "@ai-sdk/amazon-bedrock": "^4.0.95",
-    "@ai-sdk/anthropic": "^3.0.58",
+    "@ai-sdk/anthropic": "3.0.58",
     "@ai-sdk/azure": "^3.0.54",
     "@ai-sdk/cohere": "^3.0.30",
     "@ai-sdk/deepseek": "^2.0.29",
@@ -27,8 +51,9 @@
     "@openrouter/ai-sdk-provider": "^2.8.0",
     "ai": "^6.0.116",
     "ajv": "^8.18.0",
+    "yaml": "2.8.3",
     "zod": "3.25.67",
-    "@n8n/ai-utilities": "0.16.1"
+    "@n8n/ai-utilities": "0.17.0"
   },
   "peerDependencies": {
     "@opentelemetry/exporter-trace-otlp-http": ">=0.50.0",