Overview
The public, reviewable index of agents built with AbsoluteJS or exposing an Absolute-compatible open discovery document.
Public Agent Registry
@absolutejs/public-agent-registryv0.1.0betaAIThe public, signed, searchable registry of AbsoluteJS agents.
#Installation
BASH
git clone https://github.com/absolutejs/agents.git#Capabilities
Overview
The public, reviewable index of agents built with AbsoluteJS or exposing an Absolute-compatible open discovery document.
Human catalog:
Registry metadata:
Show 8 more
Machine index:
Package index:
Signed registry descriptor:
OpenAPI:
Arazzo workflow:
Crawler index:
Sitemap:
Security contact:
List an agent
Expose /.well-known/absolute-agent.json using
@absolutejs/agent-discovery.
Sign the descriptor with a key controlled by the publisher.
Show 5 more
Add the exact signed JSON envelope to registry/agents/.json and the
public verification JWK to registry/keys/.jwk.json.
Open a pull request. CI performs the same canonical digest and cryptographic
signature verification as @absolutejs/agent-discovery, then rejects malformed, expired, duplicate, insecure, or misleading entries before human publisher/domain review.
Descriptors use the provider-neutral https://absolutejs.github.io/agents/schemas/agent-discovery/v1.json contract and may point to MCP, A2A, Arazzo, WebMCP, HTTP, OpenAPI, or WebSocket interfaces. The former absolutejs.com identifier remains accepted for migration, but new descriptors should use the live immutable schema. A listing is discovery, not authorization: callers must still follow the agent's advertised OAuth and approval requirements.
Rotate the registry signing key
bun run sign:registry-agent reads REGISTRY_AGENT_SIGNING_JWK, writes only the signed envelope and public JWK, and never logs private key material. The private key is held as a GitHub Actions secret; published descriptors identify the exact key with a JWKS fragment.
The repository model is intentional for launch. Every listing and removal has public history, code-owner review, and a reproducible generated index. A federated submission API can ingest these same signed documents later.
Outcomes
What you can build
List an agent
Expose /.well-known/absolute-agent.json using
Rotate the registry signing key
bun run sign:registry-agent reads REGISTRY_AGENT_SIGNING_JWK, writes only the signed envelope and public JWK, and never logs private key material. The private key is held as a GitHub Actions secret; published descriptors identify the exact key with a JWKS fragment.
Hardening checklist
Production guidance
Make every external boundary explicitPin the deployed @absolutejs/public-agent-registry version, replace example or memory-backed dependencies with durable implementations, bound external calls, protect credentials, and emit enough evidence to retry or recover safely.
Follow in order
Troubleshooting path
1
Trace from the first failed boundary
Reproduce the smallest canonical @absolutejs/public-agent-registry example, confirm the supported entry point and version in the API explorer, then inspect the first boundary that did not produce its documented result.
#Package commands
Scripts declared by this project’s package manifest.
bun run buildbun scripts/build.ts
bun run checkbun run build && bun test
bun run testbun test
Workspace project
This workspace project is not published as a standalone npm package. Use its repository and the accurately labeled public or private workspace contents below.