AgentKit Studio
Reference

Plugin catalog schema

Plugin market catalog schema v1: 18 row fields, 3 builtin rows and 6 error codes.

Catalog document shape

The plugin market catalog schema version is 1. A remote index is a JSON document: either an array, or an object { schemaVersion, plugins, updatedAt }.

{
  "schemaVersion": 1,
  "updatedAt": "1970-01-01T00:00:00Z",
  "plugins": [
    {
      "id": "@scope/dsh-plugin",
      "displayName": "Example plugin",
      "category": "Collaboration",
      "tags": [
        "team"
      ]
    }
  ]
}
FieldTypeNotes
schemaVersionnumberDefaults to 1; any other value is rejected
pluginsarrayRows, capped at 500
updatedAtstringISO timestamp; dropped when unparsable, without affecting rows

Row fields

When the source is builtin, readiness fields are also accepted. A remote document cannot declare them; this is a trust boundary, not an option.

FieldTypeLimitRequiredNotes
idstring120YesPackage name; also the dedupe key.
installSpecstring140YesInstall spec; defaults to id.
displayNamestring80NoMarket row title; defaults to id.
descriptionstring400NoOne-line summary, truncated.
categorystring24NoGrouping; defaults to 其他.
tagsstring[]8 × 24NoDeduped then truncated.
featuredboolean—NoOnly true counts.
experimentalboolean—NoRenders the beta badge.
capabilitiesstring[]12 × 40NoCapability labels.
homepagehttps URL400NoNon-HTTPS is dropped.
repositoryhttps URL400NoNon-HTTPS is dropped.
authorstring60NoDisplay credit.
icon`glyph \https URL`8 字符No
origin``builtin` \`remote``—Yes
expectedEntriesstring[]12 × 60Nobuiltin only: entries probed for readiness.
service{name, methods, probe?}16 methodsNobuiltin only: Host service probed for readiness.
readinessNotestring200Nobuiltin only: readiness hint.
defaultEnabledboolean—Nobuiltin only: enabled after install.

Builtin rows

3 curated rows ship with the product and work offline. Readiness probes read Host services; when absent they surface a hint instead of blocking install.

Plugin iddisplayNamecategorycapabilitiesBadgeexpectedEntries
@deepseek-ai/dsh-experimental-agent-team-profileAgent Teams协作4betaagent-team tool-agent-team ui-agent-team
@deepseek-ai/dsh-experimental-voice-input-bundle语音输入输入3betaspeech-to-text speech-to-text-sensevoice api-speech-to-text ui-voice-input
@deepseek-ai/dsh-experimental-auto-reviewAuto Review权限3betaauto-review

Index address and merging

ItemValue
EnvironmentAGENTKIT_STUDIO_DSH_PLUGIN_INDEX
AliasesDSH_PLUGIN_INDEX_URL
Protocolhttps:; http: only for localhost / 127.0.0.1 / ::1
RejectedURLs with a username or password, non-HTTP(S) schemes, unparsable URLs
MergeBuiltin rows reserve the id; a remote row overrides copy fields but not readiness fields; new ids append
FailureA failed refresh keeps the last good document as stale; the market never empties

Error codes

CodeSource
DSH_PLUGIN_CATALOG_INVALIDsrc/dsh-plugin-catalog.mjs:184
DSH_PLUGIN_CATALOG_VERSION_UNSUPPORTEDsrc/dsh-plugin-catalog.mjs:187
DSH_PLUGIN_CATALOG_TOO_LARGEsrc/dsh-plugin-catalog.mjs:191
DSH_PLUGIN_INDEX_TIMEOUTsrc/dsh-plugin-index.mjs:57
DSH_PLUGIN_INDEX_UNAVAILABLEsrc/dsh-plugin-index.mjs:58
DSH_PLUGIN_INDEX_URL_REJECTEDsrc/dsh-plugin-index.mjs:107

Version and compatibility

ItemValueNotes
Schema version1An incompatible change must bump it
Row cap500Exceeding it throws DSH_PLUGIN_CATALOG_TOO_LARGE
Builtin rows3Ship with the product, no network
Readiness probesBuiltin onlyA remote document cannot declare probes

Developer entry points

ItemSource
Catalog normalizationsrc/dsh-plugin-catalog.mjs
Remote index refreshsrc/dsh-plugin-index.mjs
Plugin discoverysrc/dsh-plugin-discovery.mjs
Plugin market UIsrc/client/state/plugins.mjs

Related tests:

Test fileLocation
dsh-plugin-catalog.test.mjstests/dsh-plugin-catalog.test.mjs
dsh-plugin-index.test.mjstests/dsh-plugin-index.test.mjs

On this page