Store, retrieve, and list content-addressed assets. Assets are immutable, identified by the CAD3 hash of their metadata.
| Name: | asset |
| Class: | covia.adapter.AssetAdapter |
This adapter provides 5 MCP tool(s) for AI agent integration:
| Tool Name | Description |
|---|---|
| asset_content | Retrieve bytes by any content reference: an asset address, workspace path, file:// root path, or DLFS path. Returned as a hex-encoded Blob with contentType when known. Returns {truncated: true, size} if it exceeds maxSize (default 1MB). Use asset_get for metadata; raw file/DLFS references have content but no asset metadata. |
| asset_store | Store an immutable content-addressed asset in your a/ namespace. The ID is the CAD3 hash — storing identical metadata twice returns the same ID (idempotent). Use for documents, definitions, or data needing a stable tamper-proof identity. For named operations callable via grid_run, prefer covia_write to o/<name> — simpler than store-then-pin. |
| asset_get | Read asset metadata from any resolvable address (a/<hash>, o/<name>, v/ops/..., DID URL). Returns {id, exists, value}. Use asset_content for the binary payload, or covia_read if you just want the raw value without asset semantics. |
| asset_list | List your own pinned assets (the per-user a/ namespace), with pagination. Returns summary info (id is the asset hash; ref is the fully qualified DID/a address; plus name, type, description) per asset; use asset_get for full metadata. Filter by type for narrow searches (e.g. type='agent-definition'). Venue operations are not listed here — discover those with covia_functions / covia_adapters. |
| asset_pin | Snapshot any resolvable metadata value into your a/ content-addressed store. Idempotent — the same value produces the same hash. Use to freeze a venue op or workspace value at a specific version. Returns {ref, id}; historical {path, hash} aliases are also included. |