n8n/packages/@n8n/ai-utilities
Jaakko Husso 19582fb20d
fix(core): Verify a resolved agent model against the credential's live list (#37240)
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-31 10:42:51 +00:00
..
integration-tests feat: Update CLI examples (#25881) 2026-02-19 14:11:47 +00:00
scripts feat: Add example node in ai-utilities, improve response handling (#25388) 2026-02-10 13:52:14 +00:00
src fix(core): Verify a resolved agent model against the credential's live list (#37240) 2026-08-31 10:42:51 +00:00
.editorconfig chore: Move logWrapper and related helpers to ai-utilities (#25279) 2026-02-04 13:46:03 +00:00
.gitignore feat: Add ai-node-sdk package (#25838) 2026-02-19 12:01:11 +00:00
.npmignore chore: Move logWrapper and related helpers to ai-utilities (#25279) 2026-02-04 13:46:03 +00:00
eslint.config.mjs feat: Add ai-node-sdk package (#25838) 2026-02-19 12:01:11 +00:00
package.json 🚀 Release 2.37.0 (#36986) 2026-08-25 07:32:14 +00:00
README.md feat: Update CLI examples (#25881) 2026-02-19 14:11:47 +00:00
tsconfig.build.cjs.json chore: Migrate ai modules to TypeScript 7 (no-changelog) (#33916) 2026-07-09 14:08:31 +00:00
tsconfig.build.esm.json feat: Update CLI examples (#25881) 2026-02-19 14:11:47 +00:00
tsconfig.json chore: Migrate ai modules to TypeScript 7 (no-changelog) (#33916) 2026-07-09 14:08:31 +00:00
vite.config.ts test: Centralize the zod CJS-pin alias in shared Vitest config (#33627) 2026-07-06 09:20:27 +00:00

@n8n/ai-utilities

Core utilities and abstractions for AI functionality in n8n. This package provides the foundational building blocks used internally by the n8n platform.

This package is reexported from @n8n/ai-node-sdk, that exposes methods and types for public usage.

When changing logic in this package, make sure your changes are backwards compatible. What that means:

  • don't remove existing interfaces or properties in them
  • make new properties optional or create new versions of interfaces
  • publicly exposed methods should handle both old and new interfaces
  • when making a breaking change or adding a new public helper function that is exported in @n8n/ai-node-sdk, make sure to update AI_NODE_SDK_VERSION in ai-node-sdk-version.ts

Development

# Build the package
pnpm build

# Run tests
pnpm test

# Run in watch mode
pnpm dev

Usage

For public SDK documentation see @n8n/ai-node-sdk.