Files
deepseek-harness/packages/extensions/tool-cordis

description, kind
description kind
Read-only runtime API discovery for agents developing and configuring installed Harness plugins. package-reference

@deepseek-ai/dsh-tool-cordis

English | 中文

Summary

Inspect Host and Client runtime APIs before writing plugin code. Creator mode provides these read-only tools alongside Plugin Manager, which owns persistent profile changes. The inspection registry is supplied by the Cordis host runner; browser queries need a connected page.

Table of Contents


Use this package

Creator mode includes this toolset. Other compositions mount @deepseek-ai/dsh-tool-cordis alongside the host runner that provides cordisInspect. Call cordis_inspect_list to discover providers, then cordis_inspect_query for a provider's exact methods and types. Use Plugin Manager to install bundles containing plugin code or MCP configuration.


Understand the implementation

Implementation internals — click to expand

Host providers combine generated Service/Event catalogs and the requesting agent's tool registry. Client providers synchronize their manifests through the existing inspection registry and answer queries from a connected page. The tool plugin owns its registrations through Cordis effects; disposal removes the two tools and the Host inspect providers. No invariant companion is published because inspection reads its providers directly and maintains no independent runtime projection.


Further Exploration

Model Experience

Runtime inspection

What the model sees

The tool catalog describes two read-only inspection tools. The plugin contributes no system prompt section: the tool descriptions state when to call each tool and that queries never invoke business methods. In the cordis preset, the first-turn skill catalog carries the descriptions of the two shipped skills, which route plugin, MCP, composition, and destination-less visual requests to the skill covering Plugin Manager, MCP setup, Client packaging, and slot registration. Query results contain the requested API declarations or live tool schemas.

Token effect

Only the two tool schemas enter model requests while this plugin is visible. Query results append to the transcript; exact queries avoid loading unrelated declarations.

KV Cache effect

Unchanged tool schemas remain prefix-stable. Query results append to history; enabling other plugins can change subsequent tool schemas.

Known Limitations and Deferred Work

  • Client queries wait for a responding page or cancellation. Inspection cannot invoke service methods, configure plugins, or execute generated code.

Dev Note

None.