caplets 0.12.4 → 0.12.6

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <img src="assets/icon.png" alt="Caplets logo" width="140" height="140" />
+  <img src="plugins/caplets/assets/icon.png" alt="Caplets logo" width="140" height="140" />
 
   <h1>Caplets</h1>
 
@@ -81,9 +81,11 @@ your coding agent supports one.
 | OpenCode       | Install [`@caplets/opencode`](packages/opencode/README.md)                                          | Native `caplets_<id>` tools and prompt guidance hooks              |
 | Pi             | Install [`@caplets/pi`](packages/pi/README.md)                                                      | Native `caplets_<id>` tools with Pi prompt snippets/guidelines     |
 
-Codex and Claude Code plugins are plugin-native but MCP-backed. Their manifests live in
-`.codex-plugin/` and `.claude-plugin/`; component files live at the plugin root so
-marketplace installs can copy and resolve them correctly.
+Codex and Claude Code plugins are plugin-native but MCP-backed. The installable plugin
+lives under `plugins/caplets/`, with agent-specific manifests in `.codex-plugin/` and
+`.claude-plugin/`, a shared `skills/` directory, and shared `mcp.json` config. The
+repo-level `.agents/plugins/marketplace.json` and `.claude-plugin/marketplace.json`
+files only advertise that installable plugin root.
 
 The Claude Code and Codex commands install from this GitHub repository through each agent's
 plugin marketplace flow; users do not need to clone the repository manually. Plugin MCP
@@ -123,8 +125,8 @@ exposed two ways: direct flat MCP aggregation versus Caplets progressive disclos
 | Initial Agent Surface     |   Direct Flat MCP |      Caplets |     Reduction |
 | ------------------------- | ----------------: | -----------: | ------------: |
 | Visible tools             |               106 |            3 |   97.2% fewer |
-| Serialized MCP payload    |      32,090 bytes |  8,400 bytes | 73.8% smaller |
-| Approx. context surface   |      8,023 tokens | 2,100 tokens |   5,923 fewer |
+| Serialized MCP payload    |      32,090 bytes |  8,442 bytes | 73.7% smaller |
+| Approx. context surface   |      8,023 tokens | 2,111 tokens |   5,912 fewer |
 | Top-level name collisions | 3 duplicate names |            0 |    eliminated |
 
 Caplets does not remove access to downstream tools. It places them behind scoped
@@ -299,7 +301,7 @@ the committed schema stays in sync with the Zod config validator.
 
 For richer skill-like cards, add Markdown Caplet files beside `config.json`. Every Caplet
 file must include exactly one executable backend: `mcpServer`, `openapiEndpoint`,
-`graphqlEndpoint`, `httpApi`, or `cliTools`;
+`graphqlEndpoint`, `httpApi`, `cliTools`, or `capletSet`;
 serverless Caplets are intentionally out of scope.
 
 Top-level files derive the Caplet ID from the filename:
@@ -452,7 +454,7 @@ caplets init --force
 
 ### Caplet IDs
 
-Each key under `mcpServers`, `openapiEndpoints`, `graphqlEndpoints`, `httpApis`, or `cliTools` is the
+Each key under `mcpServers`, `openapiEndpoints`, `graphqlEndpoints`, `httpApis`, `cliTools`, or `capletSets` is the
 stable Caplet ID. It becomes the generated MCP tool name exactly, so keep it short and specific:
 
 ```json
@@ -469,7 +471,7 @@ stable Caplet ID. It becomes the generated MCP tool name exactly, so keep it sho
 ```
 
 Caplet IDs must match `^[a-zA-Z0-9_-]{1,64}$` and must be unique across `mcpServers`,
-`openapiEndpoints`, `graphqlEndpoints`, `httpApis`, and `cliTools`. Spaces, dots, slashes, colons, and Unicode IDs are rejected.
+`openapiEndpoints`, `graphqlEndpoints`, `httpApis`, `cliTools`, and `capletSets`. Spaces, dots, slashes, colons, and Unicode IDs are rejected.
 
 ### Stdio Servers
 
@@ -687,6 +689,42 @@ Pass `-g` or `--global` to write to the user Caplets root, `--print` to review t
 manifest without writing, `--output <path>` for an explicit destination, or `--force` to overwrite
 an existing destination file.
 
+### Caplet Sets
+
+Use `capletSets` to expose another Caplets collection as nested Caplets. Each child Caplet appears
+as one downstream tool and supports the full Caplets operation set: `get_caplet`, `check_backend`,
+`check_mcp_server`, `list_tools`, `search_tools`, `get_tool`, and `call_tool`.
+
+```json
+{
+  "capletSets": {
+    "team": {
+      "name": "Team Caplets",
+      "description": "Use the team's shared Caplets collection.",
+      "configPath": "./team-caplets/config.json",
+      "capletsRoot": "./team-caplets/caplets"
+    }
+  }
+}
+```
+
+`configPath` and `capletsRoot` are independently optional, but at least one is required. Child
+collections are isolated from the parent collection; they use their own config and Caplet files,
+with their own `defaultSearchLimit` and `maxSearchLimit` when set on the `capletSets` entry.
+Recursive nesting is supported, and repeated source paths are rejected as cycles.
+
+Markdown Caplet files use `capletSet` frontmatter:
+
+```yaml
+---
+name: Team Caplets
+description: Use the team's shared Caplets collection.
+capletSet:
+  configPath: ./team-caplets/config.json
+  capletsRoot: ./team-caplets/caplets
+---
+```
+
 Add MCP, OpenAPI, GraphQL, and HTTP API Caplets with the same destination options:
 
 ```sh
@@ -852,7 +890,7 @@ Call one exact downstream tool:
 Available operations:
 
 - `get_caplet`: return the configured capability card without starting the downstream server.
-- `check_backend`: verify the selected backend, whether MCP, OpenAPI, or GraphQL.
+- `check_backend`: verify the selected backend, whether MCP, OpenAPI, GraphQL, HTTP, CLI, or nested Caplets.
 - `check_mcp_server`: start or connect to an MCP server and verify its tool list.
 - `list_tools`: return compact downstream tool metadata.
 - `search_tools`: search downstream tool names and descriptions within this Caplet.

package/dist/index.js

@@ -2,7 +2,7 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CapletsRuntime, runCli } from "@caplets/core";
 //#region package.json
-var version = "0.12.4";
+var version = "0.12.6";
 //#endregion
 //#region src/index.ts
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "caplets",
-  "version": "0.12.4",
+  "version": "0.12.6",
   "description": "Progressive disclosure gateway CLI for MCP servers and native Caplets adapters.",
   "keywords": [
     "caplets",
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@caplets/core": "0.12.2"
+    "@caplets/core": "0.13.0"
   },
   "devDependencies": {
     "@types/node": "^25.7.0",