22
33This is the independent Store root for Agent Plugins 1.0.0 packages. It does
44not change or share validation with the legacy ` agents/ ` and ` skills/ ` Stores.
5+ Clawdi's first-party Skill and MCP capabilities are built into its Cloud/runtime
6+ projection, not distributed as an installable Agent Plugin, and therefore do
7+ not appear in this Store catalog.
58
69## Package layout
710
@@ -68,9 +71,9 @@ Store validation accepts all three standard transports independently of a
6871runtime's connection capabilities. ` compatibility.runtimes ` names intended
6972install targets; it is not a transport capability matrix or proof that every
7073component can run there. Installers and runtimes must gate unsupported
71- ` streamable-http ` , legacy ` sse ` , and secret-binding behavior without treating
72- the portable package as invalid. In particular, this Store contract does not
73- claim Hermes support for ` sse ` or ` configuration.secretSlots ` .
74+ ` streamable-http ` and legacy ` sse ` behavior without treating the portable
75+ package as invalid. In particular, this Store contract does not claim Hermes
76+ support for ` sse ` .
7477
7578## Clawdi extension
7679
@@ -80,20 +83,16 @@ claim Hermes support for `sse` or `configuration.secretSlots`.
8083- ` display ` requires ` name ` , ` category ` , and ` languages ` ; ` icon ` is an optional
8184 in-package ` ./ ` file. The Store requires the standard top-level ` keywords `
8285 field for search and discovery instead of duplicating tags in the extension.
83- - ` configuration.secretSlots ` maps slot IDs to ` label ` , ` description ` ,
84- ` required ` , and one or more MCP bindings. Bindings target an existing stdio
85- environment key or remote header and may add a bounded, non-secret header
86- prefix.
8786- ` compatibility ` may list only ` openclaw ` and ` hermes ` runtimes and bare
8887 ` executables ` . If either list is present, it must not be empty.
8988
9089Secret values, trust or review state, featured ranking, install counts,
91- arbitrary settings, install hooks, OAuth registration, and dependency
92- installers are not author-controlled extension data. Literal credential-bearing
93- MCP environment or header values are rejected; declare credentials as secret
94- slots only for targets that implement this Clawdi extension. Agent Plugins
95- 1.0.0 defines no portable ` secretRefs ` field; authentication can instead remain
96- entirely client-managed .
90+ arbitrary settings, configuration, install hooks, OAuth registration, and
91+ dependency installers are not author-controlled extension data. Values
92+ committed in standard MCP ` env ` or ` headers ` fields must be public and
93+ non-secret. For protected remote MCP servers, standard MCP Authorization is
94+ performed by the MCP client and managed by its host/runtime, not declared as
95+ Store package authentication metadata .
9796
9897## Generated Store index
9998
@@ -111,26 +110,27 @@ declared `runtimes`; `path` and optional `icon`; the `sha256-tree-v1` `digest`;
111110` hasConfiguration ` ; and a closed ` components ` summary. ` components.skills `
112111contains exact Skill names, while ` components.mcpServers ` maps exact server
113112names to declared ` stdio ` , ` streamable-http ` , or ` sse ` transports. It contains
114- no Skill bodies or descriptions and no MCP URLs, headers, commands, or config
115- bindings . Catalog-facing human strings and array items cannot contain ASCII
116- control characters or DEL.
113+ no Skill bodies or descriptions and no MCP URLs, headers, commands, or
114+ configuration data . Catalog-facing human strings and array items cannot
115+ contain ASCII control characters or DEL.
117116
118- ` hasConfiguration ` is derived only from the presence of
119- ` extensions["ai.clawdi"].configuration ` ; it never copies secret slot bindings
120- or values. The current Clawdi native adapter must not offer entries with
121- ` hasConfiguration: true ` until it supports that object.
117+ ` hasConfiguration ` is retained for catalog schema compatibility and is always
118+ ` false ` . Packages cannot declare ` extensions["ai.clawdi"].configuration ` .
122119
123120The index contains no Git commit. ` path ` is resolved relative to the directory
124- containing ` v2/catalog.json ` , so ` ./plugins/clawdi ` selects
125- ` v2/plugins/clawdi ` in the same snapshot. A consumer resolves an external Store
126- commit, verifies ` digest ` , and binds the install to that commit plus digest. The
127- index exposes one current published version per plugin; it is not a
128- multi-version registry. Existing installs remain pinned to their original
129- commit and digest after a newer version replaces the listing.
121+ containing ` v2/catalog.json ` , so ` ./plugins/example-plugin ` selects
122+ ` v2/plugins/example-plugin ` in the same snapshot. A consumer resolves an
123+ external Store commit, verifies ` digest ` , and binds the install to that commit
124+ plus digest. The index exposes one current published version per plugin; it is
125+ not a multi-version registry. Existing installs remain pinned to their original
126+ commit and digest after a newer version replaces or removes the listing; the
127+ package bytes remain fetchable from that historical commit.
130128
131129CI rejects generated-file drift. Its separate baseline check also rejects a
132130version regression or a changed digest for a ` name ` and ` version ` already
133- present in the baseline catalog; changed package bytes require a newer version.
131+ present in both catalogs; changed package bytes require a newer version. A
132+ removed listing is intentionally absent from that comparison because it does
133+ not change the package identity at its historical commit.
134134
135135## Validation and digest
136136
@@ -182,4 +182,5 @@ explicitly Clawdi-owned.
182182- [ MCP schema 1.0.0] ( https://agent-plugins.org/schemas/1.0.0/mcp.schema.json )
183183- [ Loading and discovery] ( https://agent-plugins.org/client-implementers/loading-and-discovery.md )
184184- [ MCP runtime] ( https://agent-plugins.org/client-implementers/mcp-runtime.md )
185+ - [ MCP Authorization] ( https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization )
185186- [ Agent Skills specification] ( https://agentskills.io/specification.md )
0 commit comments