n8n/packages/@n8n/ai-utilities
n8n-assistant[bot] 2222fe3a6c
chore: Bundle/2.x (#34680)
Co-authored-by: Charlie Kolb <charlie@n8n.io>
Co-authored-by: Guillaume Jacquart <jacquart.guillaume@gmail.com>
Co-authored-by: Stephen Wright <sjw948@gmail.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Bernhard Wittmann <bernhard.wittmann@n8n.io>
Co-authored-by: Nikhil Kuriakose <nikhil.kuriakose@n8n.io>
Co-authored-by: Albert Alises <albert.alises@gmail.com>
Co-authored-by: Michael Kret <88898367+michael-radency@users.noreply.github.com>
Co-authored-by: Andreas Fitzek <andreas.fitzek@n8n.io>
Co-authored-by: Elias Meire <elias@meire.dev>
Co-authored-by: Robin Braumann <50590409+bjorger@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: yehorkardash <yehor.kardash@n8n.io>
Co-authored-by: Mike Repeć <mike.repec@n8n.io>
Co-authored-by: Yuliia Pominchuk <31064937+yuliia-pominchuk@users.noreply.github.com>
Co-authored-by: RomanDavydchuk <roman.davydchuk@n8n.io>
2026-07-22 08:09:00 +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 chore: Bundle/2.x (#34680) 2026-07-22 08:09:00 +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.32.0 (#34600) 2026-07-21 07:14:52 +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.