Skip to main content

Adapters

Adapters are how a venue gets its capabilities. Each adapter contributes a family of operations — self-describing, invocable units with JSON Schema inputs and outputs — that any client, agent, or orchestration can call. Out of the box a venue ships with nearly thirty adapters spanning LLMs, agents, human oversight, files, lattice state, governance, and federation; operators add more as venue modules.

AI and agents

AdapterOperationsWhat it does
LangChainlangchain:*Call LLMs — OpenAI, Anthropic, Ollama, xAI, and OpenAI-compatible endpoints
Skillsv/ops/skillsSkill discovery and retrieval; every venue ships a skill library
User Memoryv/ops/memoryDurable per-user memory that agents recall every turn and edit by number
Human-in-the-Loophitl:*Park a job for human approval, choices, or capability grants

Agent execution (agent:*, llmagent:*, goaltree:*) is documented under Agents.

Federation and connectivity

AdapterOperationsWhat it does
Gridgrid:*Invoke operations on local or remote venues (federation)
Orchestrator(adapter, not ops)Multi-step DAG workflows, defined as operation assets and run via grid:run
MCPmcp:*Call external MCP servers; bridge their tools into the catalog
A2Aa2a:*Call remote A2A agents; serve A2A inbound
HTTPhttp:*SSRF-protected outbound HTTP requests
Convexconvex:*Query and transact against the Convex lattice network

State and data

AdapterOperationsWhat it does
Covia (Venue)covia:*CRUD over the venue's lattice state
Assetsasset:*Immutable, content-addressed asset store — store, read, list, pin
Secretssecret:*Per-user encrypted secret store; s/NAME references
Filefile:*Root-jailed local filesystem access
DLFSdlfs:*Decentralised, user-signed file system (WebDAV)
Vaultvault:*Simplified, fixed-drive file access
Archivearchive:*Zip handling — jailed, zip-slip-proof, bomb-guarded
JSONjson:*Pure JSON data manipulation (merge, select, …)
Schemaschema:*JSON Schema validate, infer, coerce — pure and sub-millisecond
Schedulerscheduler:*Run operations later; deferred and agent wakes

Identity and governance

AdapterOperationsWhat it does
UCANucan:*Issue and verify capability tokens — authority as an inspectable artifact
Authauth:*Caller identity diagnostics (whoami)
Usersuser:*Administrative user registration and authenticator key management

Extensibility

AdapterOperationsWhat it does
JVMjvm:*In-process utility ops, plus the venue-module mechanism for arbitrary JVM code
SQL (module)sql:*Governed SQL over any JDBC database, delegable per database
Python (module)python:*Operator-configured Python operations, in-process via FFM

SQL and Python are optional venue modules — separate artifacts on Maven Central (ai.covia:covia-sql, ai.covia:covia-python-adapter), loaded by config.

How operations are named and invoked

Operations are written as adapter:op (e.g. grid:run) or as a venue catalog path (v/ops/grid/run). Invoke them over REST (POST /api/v1/invoke), through an SDK, as MCP tools, or as agent tools. Because every operation is self-describing, both humans and agents can discover and call them.