dsh-tool-sentry
A Cordis tool plugin that gives DeepSeek Harness (dsh) focused Sentry workflows: project health, unresolved issues, event context, releases, teams, and organization members.
The plugin registers 12 tools with the official ctx.tools.register(defineTool(...)) contract, uses presentCall/presentResult for compact replay-friendly UI cards, and treats authentication, request timeout, and cancellation as first-class concerns.
Install
Install directly from GitHub (no npm publish needed):
npm install github:LJH-snow/dsh-tool-sentry
# or a specific branch/tag
npm install github:LJH-snow/dsh-tool-sentry#mainOr from a local checkout:
git clone https://github.com/LJH-snow/dsh-tool-sentry
cd dsh-tool-sentry
npm install && npm run build # builds to lib/
npm install /path/to/dsh-tool-sentryRequires @deepseek-ai/cordis (^4.0.1) and @deepseek-ai/dsh-tools (^0.1.0-rc.6) as peer dependencies, provided by the host dsh runtime.
Configuration
Load the plugin in a dsh composition config (cordis.yml):
- name: 'dsh-tool-sentry'
config:
token: 'sntrys_xxx' # required Sentry API token
organization: 'acme' # optional default org slug; tools can still override it
baseUrl: 'https://sentry.io/api/0' # optional; use your self-hosted Sentry API root
timeoutMs: 15000 # optional request timeout in ms (default 15000)Full example: examples/cordis.yml.
Tools
Read-only
| Tool | Description | Organization |
|---|---|---|
sentry_get_organization |
Organization metadata, 2FA policy, pending access requests, URL | config or arg |
sentry_list_projects |
Projects visible to the token, optionally filtered by query | config or arg |
sentry_get_project |
One project: team, platform, first event, latest release, features | config or arg |
sentry_list_issues |
Issues in a project with query/status filters | config or arg |
sentry_get_issue |
Issue detail: counts, status, assignee, permalink | config or arg |
sentry_list_issue_events |
Recent events for an issue | config or arg |
sentry_list_releases |
Releases for a project | config or arg |
sentry_get_release |
One release with projects and commit/new-group counts | config or arg |
sentry_list_teams |
Organization teams with member/project counts | config or arg |
sentry_get_team |
One team with access and pending state | config or arg |
sentry_list_members |
Organization members with role and invite state | config or arg |
Write
| Tool | Description | Organization |
|---|---|---|
sentry_update_issue |
Update issue status or assignee | config or arg |
Behavior contract
- Sentry REST API is auth-first, so every tool requires a plugin
token. - Missing/invalid calls return canonical business values: missing objects give
{ found: false }, andsentry_update_issuemaps 400/404 to{ ok: false, reason }. - Infrastructure errors such as 401, 403, 429, timeout, and network failures throw
SentryErroror the original fetch error. - All requests forward
exec.signaland use a 15 second timeout by default. - Output schemas,
render,presentCall, andpresentResultstay pure, so tool calls and results are replay-safe.
Development
npm install
npm run typecheck # type check
npm test # unit tests (vitest)
npm run build # build to lib/See DEVELOPMENT.md for technical notes and decisions.
Publishing
- Ensure
npm run typecheck,npm test, andnpm run buildall pass. - Publish with
npm publish --access public. - Add the
dsh-plugintopic to the GitHub repository for ecosystem discovery.