n8n/packages/@n8n/ai-utilities
Matsu 3ea606ac60
Some checks are pending
Build: Benchmark Image / build (push) Waiting to run
CI: Master (Build, Test, Lint) / Build for Github Cache (push) Waiting to run
CI: Master (Build, Test, Lint) / Unit tests (22.22.3) (push) Waiting to run
CI: Master (Build, Test, Lint) / Unit tests (24.15.0) (push) Waiting to run
CI: Master (Build, Test, Lint) / Lint (push) Waiting to run
CI: Master (Build, Test, Lint) / Performance (push) Waiting to run
CI: Master (Build, Test, Lint) / Notify Slack on failure (push) Blocked by required conditions
Util: Sync API Docs / sync-public-api (push) Waiting to run
test: Resolve test-config module aliases dynamically instead of hardcoding versions (no-changelog) (#31621)
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-03 07:44:01 +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 test: Stabilize AI unit tests against cold heavy-load timeouts (#31592) 2026-06-02 21:13:49 +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 test: Migrate @n8n/ai-utilities from Jest to Vitest (#31490) 2026-06-02 12:33:58 +00:00
README.md feat: Update CLI examples (#25881) 2026-02-19 14:11:47 +00:00
tsconfig.build.cjs.json feat: Update CLI examples (#25881) 2026-02-19 14:11:47 +00:00
tsconfig.build.esm.json feat: Update CLI examples (#25881) 2026-02-19 14:11:47 +00:00
tsconfig.json test: Migrate @n8n/ai-utilities from Jest to Vitest (#31490) 2026-06-02 12:33:58 +00:00
vite.config.ts test: Resolve test-config module aliases dynamically instead of hardcoding versions (no-changelog) (#31621) 2026-06-03 07:44:01 +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.