@n8n/agents 0.27.4 → 0.28.1

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

@@ -66,7 +66,12 @@ export interface ObservationLogObserverInput {
     executionCounter?: AgentExecutionCounter;
     telemetry?: BuiltTelemetry;
 }
-export type ObservationLogObserveFn = (input: ObservationLogObserverInput) => Promise<string>;
+export interface ObservationLogObserveResult {
+    text: string;
+    usage?: TokenUsage;
+    model: string;
+}
+export type ObservationLogObserveFn = (input: ObservationLogObserverInput) => Promise<string | ObservationLogObserveResult>;
 export interface ObservationLogReflectorInput {
     observationScopeId: string;
     now: Date;
@@ -77,7 +82,12 @@ export interface ObservationLogReflectorInput {
     executionCounter?: AgentExecutionCounter;
     telemetry?: BuiltTelemetry;
 }
-export type ObservationLogReflectFn = (input: ObservationLogReflectorInput) => Promise<string>;
+export interface ObservationLogReflectResult {
+    text: string;
+    usage?: TokenUsage;
+    model: string;
+}
+export type ObservationLogReflectFn = (input: ObservationLogReflectorInput) => Promise<string | ObservationLogReflectResult>;
 export interface MemoryTaskUsageReport {
     task: ObservationLogTaskKind;
     model: string;

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

@@ -1,11 +1,18 @@
 import type { JSONSchema7 } from 'json-schema';
 import type { ZodType } from 'zod';
 import type { AgentExecutionCounter } from './agent';
+import type { McpToolAnnotations } from './mcp';
 import type { AgentMessage } from './message';
+import type { ApprovalResumePayload } from '../../sdk/tool';
 import type { RuntimeSkillLoader } from '../../skills/types';
 import type { AgentEventData } from '../runtime/event';
 import type { BuiltTelemetry } from '../telemetry';
 import type { JSONObject, JSONValue } from '../utils/json';
+export interface ToolApprovalContext {
+    readonly approvedKeys: ReadonlySet<string>;
+    getDisplayArgs?(toolName: string, input: unknown): unknown;
+    onDecision(grantKey: string, decision: ApprovalResumePayload): Promise<void>;
+}
 export interface ToolSuspendOptions {
     resumeSchema?: ZodType | JSONSchema7;
     continuation?: JSONValue;
@@ -21,6 +28,7 @@ export interface ToolExecutionContext {
     emitEvent?: (event: AgentEventData) => void;
     abortSignal?: AbortSignal;
     executionCounter?: AgentExecutionCounter;
+    approvalContext?: ToolApprovalContext;
     onSuspend?: (payload: unknown, options?: ToolSuspendOptions) => void | Promise<void>;
     suspendPayload?: unknown;
     continuation?: JSONValue;
@@ -36,6 +44,7 @@ export interface ToolContext {
     emitEvent?: ToolExecutionContext['emitEvent'];
     abortSignal?: ToolExecutionContext['abortSignal'];
     executionCounter?: ToolExecutionContext['executionCounter'];
+    approvalContext?: ToolExecutionContext['approvalContext'];
 }
 export interface InterruptibleToolContext<S = unknown, R = unknown> {
     loadSkill?: ToolExecutionContext['loadSkill'];
@@ -52,6 +61,7 @@ export interface InterruptibleToolContext<S = unknown, R = unknown> {
     emitEvent?: ToolExecutionContext['emitEvent'];
     abortSignal?: ToolExecutionContext['abortSignal'];
     executionCounter?: ToolExecutionContext['executionCounter'];
+    approvalContext?: ToolExecutionContext['approvalContext'];
     suspendPayload?: S;
     continuation?: JSONValue;
     resumeSchema?: ToolSuspendOptions['resumeSchema'];
@@ -85,6 +95,7 @@ export interface BuiltTool {
     readonly mcpTool?: boolean;
     readonly mcpServerName?: string;
     readonly mcpToolName?: string;
+    readonly mcpAnnotations?: McpToolAnnotations;
     readonly providerOptions?: Record<string, JSONObject>;
     readonly metadata?: Record<string, unknown>;
     readonly editable?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n8n/agents",
-  "version": "0.27.4",
+  "version": "0.28.1",
   "description": "AI agent SDK for n8n's code-first execution engine",
   "engines": {
     "node": ">=24.0.0"
@@ -94,9 +94,9 @@
     "@ai-sdk/xai": "^4.0.18",
     "@daytona/sdk": "0.205.1",
     "@modelcontextprotocol/sdk": "1.26.0",
-    "@n8n/ai-utilities": "0.35.3",
+    "@n8n/ai-utilities": "0.36.0",
     "@n8n/sandbox-client": "0.1.1",
-    "@n8n/utils": "1.49.0",
+    "@n8n/utils": "1.50.0",
     "@openrouter/ai-sdk-provider": "^3.0.0",
     "@opentelemetry/exporter-trace-otlp-http": ">=0.50.0",
     "@opentelemetry/sdk-trace-base": "2.7.1",
@@ -142,8 +142,9 @@
     }
   },
   "devDependencies": {
+    "@n8n/oxlint-config": "0.0.1",
     "@n8n/typescript-config": "1.12.0",
-    "@n8n/vitest-config": "1.23.0",
+    "@n8n/vitest-config": "1.24.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/context-async-hooks": "^2.7.1",
     "@pinecone-database/pinecone": "^5.0.2",
@@ -155,6 +156,8 @@
     "dotenv": "17.2.3",
     "cross-env": "^7.0.3",
     "nock": "14.0.14",
+    "oxlint": "1.78.0",
+    "oxlint-tsgolint": "^0.21.1",
     "pg": "8.21.0",
     "tsx": "^4.19.3",
     "typescript": "7.0.2",
@@ -181,8 +184,8 @@
     "build:unchecked": "rimraf dist && tsc -p tsconfig.build.json --noCheck",
     "format": "biome format --write src examples",
     "format:check": "biome ci src examples",
-    "lint": "eslint . --quiet",
-    "lint:fix": "eslint . --fix",
+    "lint": "oxlint --quiet",
+    "lint:fix": "oxlint --fix",
     "watch": "tsc -p tsconfig.build.json --watch",
     "test": "vitest run",
     "test:unit": "vitest run",