@agentproto/provider-kit
v0.3.0
Published
@agentproto/provider-kit — generic provider/backend catalog, status, creds, setup-ledger, and MCP tool primitives shared by the agent-CLI, browser, tunnel, and eval-reporter families.
Maintainers
Readme
@agentproto/provider-kit
Generic provider/backend catalog, status, creds, setup-ledger, list/resolve, MCP tool, and CLI wizard primitives shared by the agentproto provider families (agent-CLI, browser, tunnel, and eval-reporter backends).
The kit owns the skeleton; each family parameterises it with its own TInfo
descriptor and THandle (which extends AdapterHandle). The runtime keeps
importing zero concrete providers — everything flows through injected
load / toInfo callbacks.
Surface
| Export | Module | Purpose |
|---|---|---|
| computeStatus | ./status | Pure sync supported \| available \| ready classifier |
| makeCredsStore | ./creds | File-backed creds store, mode 0600, never leaks value |
| makeSetupLedger | ./ledger | ~/.agentproto/setup/<slug>.json existence/read/write |
| makeAdapterResolver, makeAdapterLister | ./list-resolve | Slug→handle + catalog→entry list |
| makeListTool, makeSetupTool | ./mcp-tools | MCP tool factories (value param is sensitive) |
| makeAdapterWizard | ./wizard | CLI radio-picker + step runner; skips ledger-completed steps |
See docs/provider-kit.md for the full design (the kit's concepts are unchanged; only the package name was renamed from @agentproto/adapter-kit).
Status engine is pure & sync (fed pre-resolved booleans).
AdapterHandle.check()is async and never invoked during listing — status comes from resolvability plus ledger/creds existence only.
The previous package name @agentproto/adapter-kit remains available as a deprecated shim that re-exports @agentproto/provider-kit unchanged.
