Bundles

Bundles .tgz artifacts

What is a bundle?

A bundle is a .tgz archive containing:

your compiled tool implementations (dist/)
a manifest.json file with metadata

Bundles are organization-scoped and uploaded via the CLI or webapp. The platform uses them to build downloadable connector packages for each OS.

Creating bundles

edge-connector package \
  --implementations ./custom-implementations \
  --out ./artifacts

This command:

compiles TypeScript implementations (unless --no-build is set),
discovers tools in dist/tools/,
computes a checksum of the distribution directory,
writes a manifest.json,
creates edge-bundle-<org>-<timestamp>.tgz in the output folder.

Manifest structure

{
"schemaVersion": 1,
"orgId": "org_123",
"language": "typescript",
"tools": ["my_tool", "sync_customers"],
"builtAt": "2025-01-01T12:00:00.000Z",
"checksum": "..."
}

Uploading bundles

Use the upload command to send bundles to the platform:

edge-connector upload \
  --file ./artifacts/edge-bundle-org-123.tgz \
  --api https://your-nara-webapp.example.com

If --file is omitted, upload can package the current implementations directory first and then upload the resulting bundle.