@n8n/agents 0.3.0 → 0.5.0

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

@@ -0,0 +1,99 @@
+import type { JSONSchema7 } from 'json-schema';
+export interface AgentSchema {
+    model: {
+        provider: string | null;
+        name: string | null;
+        raw?: string;
+    };
+    credential: string | null;
+    instructions: string | null;
+    description: string | null;
+    tools: ToolSchema[];
+    providerTools: ProviderToolSchema[];
+    memory: MemorySchema | null;
+    evaluations: EvalSchema[];
+    guardrails: GuardrailSchema[];
+    mcp: McpServerSchema[] | null;
+    telemetry: TelemetrySchema | null;
+    checkpoint: 'memory' | null;
+    config: {
+        structuredOutput: {
+            enabled: boolean;
+            schemaSource: string | null;
+        };
+        thinking: ThinkingSchema | null;
+        toolCallConcurrency: number | null;
+        requireToolApproval: boolean;
+    };
+}
+export interface ToolSchema {
+    name: string;
+    description: string;
+    type: 'custom' | 'workflow' | 'provider' | 'mcp';
+    editable: boolean;
+    inputSchemaSource: string | null;
+    outputSchemaSource: string | null;
+    handlerSource: string | null;
+    suspendSchemaSource: string | null;
+    resumeSchemaSource: string | null;
+    toMessageSource: string | null;
+    requireApproval: boolean;
+    needsApprovalFnSource: string | null;
+    providerOptions: Record<string, unknown> | null;
+    inputSchema: JSONSchema7 | null;
+    outputSchema: JSONSchema7 | null;
+    hasSuspend: boolean;
+    hasResume: boolean;
+    hasToMessage: boolean;
+}
+export interface ProviderToolSchema {
+    name: string;
+    source: string;
+}
+export interface MemorySchema {
+    source: string | null;
+    storage: 'memory' | 'custom';
+    lastMessages: number | null;
+    semanticRecall: {
+        topK: number;
+        messageRange: {
+            before: number;
+            after: number;
+        } | null;
+        embedder: string | null;
+    } | null;
+    workingMemory: {
+        type: 'structured' | 'freeform';
+        schema?: JSONSchema7;
+        template?: string;
+    } | null;
+}
+export interface EvalSchema {
+    name: string;
+    description: string | null;
+    type: 'check' | 'judge';
+    modelId: string | null;
+    credentialName: string | null;
+    hasCredential: boolean;
+    handlerSource: string | null;
+}
+export interface GuardrailSchema {
+    name: string;
+    guardType: 'pii' | 'prompt-injection' | 'moderation' | 'custom';
+    strategy: 'block' | 'redact' | 'warn';
+    position: 'input' | 'output';
+    config: Record<string, unknown>;
+    source: string;
+}
+export interface McpServerSchema {
+    name: string;
+    configSource: string;
+}
+export interface TelemetrySchema {
+    source: string;
+}
+export interface ThinkingSchema {
+    provider: 'anthropic' | 'openai';
+    budgetTokens?: number;
+    reasoningEffort?: string;
+}

package/dist/types/sdk/schema.js

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

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

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

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

@@ -16,6 +16,7 @@ export interface BuiltTool {
     readonly description: string;
     readonly suspendSchema?: ZodType;
     readonly resumeSchema?: ZodType;
+    readonly withDefaultApproval?: boolean;
     readonly toMessage?: (output: unknown) => AgentMessage | undefined;
     readonly toModelOutput?: (output: unknown) => unknown;
     readonly handler?: (input: unknown, ctx: ToolContext | InterruptibleToolContext) => Promise<unknown>;

package/dist/utils/zod.d.ts

@@ -1,3 +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 zodToJsonSchema(schema?: unknown): JSONSchema7 | null;

package/dist/utils/zod.js

@@ -1,7 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isZodSchema = isZodSchema;
+exports.zodToJsonSchema = zodToJsonSchema;
+const zod_to_json_schema_1 = require("zod-to-json-schema");
 function isZodSchema(schema) {
-    return typeof schema.safeParse === 'function';
+    return (typeof schema === 'object' &&
+        schema !== null &&
+        typeof schema.safeParse === 'function');
+}
+function zodToJsonSchema(schema) {
+    if (!schema)
+        return null;
+    try {
+        if (isZodSchema(schema)) {
+            if ('toJSONSchema' in schema && typeof schema.toJSONSchema === 'function') {
+                return schema.toJSONSchema();
+            }
+            return (0, zod_to_json_schema_1.zodToJsonSchema)(schema);
+        }
+        if (typeof schema === 'object' && schema !== null) {
+            return schema;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
 }
 //# sourceMappingURL=zod.js.map

package/dist/utils/zod.js.map

@@ -1 +1 @@
-{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/utils/zod.ts"],"names":[],"mappings":";;AAIA,kCAEC;AAFD,SAAgB,WAAW,CAAC,MAA6B;IACxD,OAAO,OAAQ,MAAkB,CAAC,SAAS,KAAK,UAAU,CAAC;AAC5D,CAAC"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n8n/agents",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "AI agent SDK for n8n's code-first execution engine",
   "main": "dist/index.js",
   "module": "dist/index.js",