Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Registry

Manage the local agent package registry. Packages are WASM components with metadata that can be published and shared across nodes.

GET /api/v1/registry/packages

List all registered packages.

Response 200 OK

[
  {
    "id": "log-monitor",
    "version": "1.2.0",
    "description": "Monitors log files for anomalies",
    "wasm_size_bytes": 524288,
    "published_at": "2026-03-15T12:00:00Z",
    "checksum": "sha256:def456..."
  }
]

POST /api/v1/registry/packages

Publish a new package or update an existing one.

Request body (multipart/form-data)

FieldTypeDescription
idstringPackage identifier
versionstringSemver version string
descriptionstringHuman-readable description
wasmfileThe compiled WASM component binary

Response 201 Created

{
  "id": "log-monitor",
  "version": "1.3.0",
  "checksum": "sha256:abc789...",
  "published_at": "2026-03-17T10:00:00Z"
}

Returns 409 Conflict if the exact version already exists.

GET /api/v1/registry/packages/

Get metadata for a specific package.

Response 200 OK

{
  "id": "log-monitor",
  "version": "1.2.0",
  "description": "Monitors log files for anomalies",
  "wasm_size_bytes": 524288,
  "published_at": "2026-03-15T12:00:00Z",
  "checksum": "sha256:def456...",
  "versions": ["1.0.0", "1.1.0", "1.2.0"]
}

Returns 404 if the package does not exist.