ambleloft

Connect the Node / npm ecosystem

Bring familiar JavaScript libraries into your AI workflow.

PRACTICAL GUIDE

Outcome: Package the required Node dependencies with the extension.

Before you begin: Prepare the files and tools specified on this page. The previous page in the learning path is not automatically a dependency.

On this page

01Develop with local tooling

Install the matching local SDK, CLI and core packages using the first-extension guide. Bundle runtime dependencies into the extension.

Code example
npm install zod
# Use the dependency in your backend, then rebuild
npm run build
npm run validate
npm run pack
Open the complete sample and instructions

02Ship the runtime code

Bundle dependencies into the backend or explicitly include them in the installation directory’s node_modules. The host uses its own Node runtime and never installs packages or runs npm lifecycle scripts when loading extensions.

03Respect runtime boundaries

Native modules need OS, CPU and host ABI validation. Browser pages cannot directly access Node APIs; communicate through declared operations. The SDK does not bypass host trust or permission checks.

04Develop with the internal SDK

Install matching local SDK, CLI and core packages using the first-extension guide. A version string does not indicate a formal release. Bundle runtime dependencies into the extension.

Check the result and troubleshoot

Package the required Node dependencies with the extension.

Check actual results using this page’s verification steps. For business integrations, inspect UI submission, tool receipts and server records separately.

Open the error reference →
SDK / CLI 0.1.0-alpha.9 · Contract baseline Compatibility and preview notes · Sample source