n8n/packages/@n8n/ai-utilities
2026-05-08 14:33:31 +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): Inline AI_NODE_SDK_VERSION to save memory by not loading @n8n/ai-utilities on boot (#30113) 2026-05-08 14:33:31 +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
jest.config.js feat: Add ai-node-sdk package (#25838) 2026-02-19 12:01:11 +00:00
package.json feat(agents): Add reusable workspace edit tools (no-changelog) (#30013) 2026-05-07 16:03:13 +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 chore: Prepare tsconfigs for tsgo (#29230) 2026-04-27 12:30:22 +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.