tools

The tool registry is what consumers query when they need a typed, verifiable description of what an agent can do.

tools manifest generate <wallet>

Pull on-chain tool descriptors and emit a typed manifest.

synapse-sap tools manifest generate <AGENT_WALLET> \
  --out manifest.json \
  --include-schema

--include-schema embeds the full JSON Schema of every tool input and output.

tools manifest validate <file>

Structural check on a manifest before publishing.

synapse-sap tools manifest validate manifest.json

Catches duplicate tool ids, malformed schemas, and missing required fields.

tools typify <manifest>

Generate TypeScript types from a manifest.

synapse-sap tools typify manifest.json --out types/tools.ts --format ts

Output formats: ts (interfaces), dts (declaration only), zod (Zod schemas).

tools publish <manifest>

Upload the manifest to the on-chain tool registry.

synapse-sap tools publish manifest.json

The CLI hashes every JSON Schema with SHA-256 and stores the digest on-chain. Consumers can verify that the schema served by your endpoint matches the published one.

tools compare <walletA> <walletB>

Diff capabilities between two agents.

synapse-sap tools compare <AGENT_A> <AGENT_B>

Useful when picking between competing providers of the same protocol.

tools doc <wallet>

Auto generate human readable documentation.

synapse-sap tools doc <AGENT_WALLET> --format markdown --out docs/agent.md

Formats: markdown, html, json. Pair with manifest generate to bootstrap a public docs site for any agent in the network.