Changelog
GitHub releases: github.com/spiritledsoftware/caplets/releases
Unreleased
Section titled “Unreleased”Major Changes
Section titled “Major Changes”- Breaking: Caplet progressive wrapper operation names now use
check,tools,describe_tool, resource/prompt operation names withoutlist_, andname/argsfields instead oftool/prompt/arguments. Code Mode declarations now expose comprehensive Caplet handles with paginated discovery, result envelopes, resource/prompt methods, loose TypeScript diagnostics, and schema-derivedcallSignature.
0.12.0
Section titled “0.12.0”Minor Changes
Section titled “Minor Changes”-
0168746: Add project-first Caplet authoring with
caplets add, makecaplets installwrite to./.capletsby default, and load project Caplets without an explicit trust gate.Project Caplets now override global Caplets with source and shadowing information surfaced through
caplets list. Use-gor--globalwithcaplets addandcaplets installto write to the user Caplets root.
0.11.0
Section titled “0.11.0”Minor Changes
Section titled “Minor Changes”- aa0c0b3: Add
cliToolsCaplet backends for typed, shell-free CLI actions pluscaplets author clifor generating reviewable CLI Caplet manifests.
0.10.0
Section titled “0.10.0”Minor Changes
Section titled “Minor Changes”- 957e528: Add reproducible coding-agent benchmarks comparing direct MCP exposure with Caplets, including deterministic report checks and opt-in live Pi/OpenCode harnesses.
- 957e528: Add schema-aware
call_tool.fieldsprojection for MCP, OpenAPI, and HTTP-backed tools that expose output schemas.
Minor Changes
Section titled “Minor Changes”- 5657a01: Support configured OAuth/OIDC client metadata URLs for MCP, OpenAPI, GraphQL, and HTTP auth configs.
- 5657a01: Default user config and OAuth token state locations now follow XDG conventions on Unix-like platforms and Windows platform conventions on Windows.
Minor Changes
Section titled “Minor Changes”- 349459a: Add native HTTP actions for explicitly configured non-OpenAPI APIs.
Minor Changes
Section titled “Minor Changes”-
359eba4: # Hot reload serve config
Add default hot reload for
caplets serve, including live config and Caplet file reconciliation without restarting the MCP process.
Patch Changes
Section titled “Patch Changes”- 85bfe0c: Use the MCP SDK OAuth auth provider for remote OAuth MCP transports instead of precomputing static bearer headers, allowing SDK-managed refresh, resource metadata, and auth challenge handling.
Minor Changes
Section titled “Minor Changes”-
ad63f47: # CLI inspection and Caplet installation
Add CLI inspection commands for version, configured Caplets, resolved config paths, and installing Caplets from a repo.
Patch Changes
Section titled “Patch Changes”- 99bce4a: Fix MCP OAuth/OIDC token exchange for dynamically registered clients.
Patch Changes
Section titled “Patch Changes”- bcd0dde: Fix MCP OAuth/OIDC login for configured public clients by including the client ID in the token exchange.
Minor Changes
Section titled “Minor Changes”- 6e5ec50: Add native GraphQL Caplets with configured or auto-generated operations, OAuth/OIDC discovery for OpenAPI and GraphQL backends, and safer credential handling for discovered auth flows.
Minor Changes
Section titled “Minor Changes”-
9c9f3e2: Add native OpenAPI-backed Caplets alongside MCP server backends.
OpenAPI endpoint configs can now expose one generated Caplet tool per API spec, progressively disclose operations as tools, and execute HTTP calls through the existing
call_toolflow. The implementation includes explicit OpenAPI auth configuration, safe spec loading, guarded request construction, generated schema updates, and documentation foropenapiEndpoints.
Minor Changes
Section titled “Minor Changes”- b924a7b: Add MCP-backed Markdown Caplet files with Caplet-first discovery operations.
Patch Changes
Section titled “Patch Changes”- f936020: Load project config from
./.caplets/config.jsonalongside user config, with project values taking precedence while preserving user-only servers. Fix OAuth login token exchange for clients with secret authentication, and clarify generated Caplets tool descriptions so downstream tool inputs are passed undercall_tool.arguments.
Minor Changes
Section titled “Minor Changes”- 0d4c5df: Add the Caplets configuration quickstart, generated JSON Schema support, top-level config options, and Commander-based CLI commands for init and OAuth auth management.
Minor Changes
Section titled “Minor Changes”- 34da37a: Set up release automation with Changesets, Husky hooks, and GitHub Actions CI/release workflows.