DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

LJH-snow /

LJH-snow/dsh-tool-pagerduty

Topic repository only

This plugin has no description yet.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@ca4aa27d

dsh-tool-pagerduty

English | 中文

PagerDuty integration for DeepSeek Harness (dsh) as a Cordis plugin. The agent can verify credentials, inspect services, incidents, on-call schedules, and escalation policies, and acknowledge or resolve incidents.

Install

npm install @libai168/dsh-tool-pagerduty

Requires @deepseek-ai/cordis (^4.0.1) and @deepseek-ai/dsh-tools (^0.1.0-rc.6) as peer dependencies.

Configuration

- name: 'github:LJH-snow/dsh-tool-pagerduty'
  config:
    token: 'u+...'                    # REST API v2 user token
    # baseUrl: 'https://api.pagerduty.com' # optional API origin/path prefix
    # fromEmail: 'bot@example.com'         # identity used by write endpoints
    # timeoutMs: 15000

baseUrl defaults to https://api.pagerduty.com. It must be an absolute http or https URL with a hostname and no username, password, query, or fragment; a path prefix is allowed and trailing slashes are normalized. Before every request, the resolved host is checked and localhost, loopback, private, link-local, CGNAT, multicast, and every IANA special-purpose block (reserved/documentation/benchmark ranges, the 2001::/23 IETF protocol assignments prefix, deprecated site-local, SRv6 SIDs, AS112, and IPv4-mapped/NAT64 forms) are rejected, along with DNS results that include any such address. DNS failures are rejected closed. Keep credentials out of baseUrl.

Create the token under User Settings > API Access. Write actions require a user token with incident write permission; prefer a dedicated bot account.

Tools

Tool Description Write
pagerduty_auth_test Verify the token and return the current user No
pagerduty_list_services List services with search/status filters No
pagerduty_list_incidents List incidents with status/service/urgency/time filters No
pagerduty_get_incident Get one incident with assignments and escalation context No
pagerduty_list_on_calls List current on-call entries No
pagerduty_list_escalation_policies List escalation policies with rule summaries No
pagerduty_acknowledge_incident Acknowledge one incident Yes
pagerduty_resolve_incident Resolve one incident, optionally with a resolution note Yes
pagerduty_list_incident_notes List notes on one incident No
pagerduty_create_incident_note Add a note to one incident (requires fromEmail) Yes

Error contract

  • Missing token: { ok: false, reason } or { found: false, reason }.
  • PagerDuty errors throw PagerDutyError (status + errors list); tools surface them as normalized failure values.
  • Write tools are single-object operations only (kind: 'edit'); no bulk or delete actions.

Development

npm install
npm run typecheck
npm test
npm run build

License

MIT

—/ 5

No ratings yet

Manifest verification required

Commit ca4aa27d81ff

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout