@sentry/junior-datadog 0.30.0 → 0.31.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sentry/junior-datadog",
3
- "version": "0.30.0",
3
+ "version": "0.31.0",
4
4
  "private": false,
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -1,12 +1,11 @@
1
1
  ---
2
2
  name: datadog
3
3
  description: Query live Datadog telemetry (logs, metrics, traces, spans, monitors, incidents, dashboards, services, hosts) through Datadog's hosted MCP server. Use when users ask to investigate production behavior in Datadog — searching logs, checking monitor status, inspecting traces or spans, looking up incidents, finding services, or correlating metrics. Do not use it for Sentry issues, repository/source-code work, or ticketing.
4
- uses-config: datadog.env datadog.service
5
4
  ---
6
5
 
7
6
  # Datadog Operations
8
7
 
9
- Use this skill for Datadog observability investigations in the harness.
8
+ Use this skill for Datadog observability investigations.
10
9
 
11
10
  ## Reference loading
12
11
 
@@ -29,10 +28,8 @@ Load references conditionally based on the request:
29
28
  - If the request refers to an earlier telemetry item indirectly (an incident, trace, or monitor already mentioned in the thread), inspect the current thread for the existing ID or URL before asking the user to restate it.
30
29
  - Ask one concise follow-up only when a search is genuinely under-specified, for example when the user asks about "errors" with no env, service, or time window hint and the thread has no prior context.
31
30
 
32
- 2. Use the active Datadog MCP tools:
31
+ 2. Use the active Datadog tools:
33
32
 
34
- - `loadSkill` returns `available_tools` for this skill, including the exact `tool_name` values and input schemas exposed in this turn.
35
- - Call those exact tool names directly. Use `searchTools` only if you need to rediscover or filter the active Datadog tools later in the same turn.
36
33
  - Start narrow: pick the single most direct tool for the request before reaching for broader search.
37
34
  - Known incident ID → `get_datadog_incident`
38
35
  - Known trace ID → `get_datadog_trace`
@@ -62,7 +59,6 @@ Load references conditionally based on the request:
62
59
 
63
60
  - Read-only only in this skill. Do not create, edit, mute, or resolve monitors, incidents, notebooks, dashboards, SLOs, or feature flags — the plugin intentionally does not expose those tools.
64
61
  - Log, RUM, APM, and incident payloads can contain PII or sensitive customer data. Quote only the minimum needed to answer the question. Do not paste full raw log bodies or span payloads when a summary plus a deep link is enough.
65
- - If Datadog authorization is required, let the MCP OAuth flow pause and resume the thread automatically instead of asking the user to handle credentials manually.
66
62
  - If a Datadog tool returns a generic `403`, `permission denied`, or similar, stop and tell the user the current Datadog connection could not access the requested resource. Do not guess at missing RBAC scopes.
67
63
  - If Datadog responds with `429 Too Many Requests`, wait briefly and retry the same query once. If it still fails, report the throttle and stop.
68
64
  - For large traces that the server marks as truncated, report that fact; do not pretend the shown spans are complete.
@@ -2,14 +2,6 @@
2
2
 
3
3
  Use this reference for any Datadog operation.
4
4
 
5
- ## Runtime contract
6
-
7
- - `loadSkill` returns `available_tools` for this skill, including the exact Datadog MCP `tool_name` values exposed in the current turn.
8
- - Call those exact `tool_name` values directly.
9
- - Use `searchTools` only when you need to rediscover or filter the active Datadog tools later in the same turn.
10
- - Do not hardcode raw Datadog MCP tool names in advance. Tool discovery is part of the workflow.
11
- - Return concrete findings plus Datadog deep links for navigation.
12
-
13
5
  ## Provider surface
14
6
 
15
7
  The packaged plugin points at Datadog's hosted remote MCP server and enables the `core`, `apm`, and `error-tracking` toolsets. Tool exposure is intentionally limited to the read-oriented surface below.
@@ -59,34 +51,6 @@ If a user asks for a mutation, stop and explain that this skill is read-only.
59
51
  | "Which hosts are unhealthy?" | `search_datadog_hosts` filtered by health/tags. |
60
52
  | "Find slow page loads." | `search_datadog_rum_events` with a page/speed filter. |
61
53
 
62
- ## Config helpers
63
-
64
- Use these commands only when the user explicitly asks to inspect or store Datadog defaults for the current conversation/channel.
65
-
66
- Resolve env default:
67
-
68
- ```bash
69
- jr-rpc config get datadog.env
70
- ```
71
-
72
- Set env default:
73
-
74
- ```bash
75
- jr-rpc config set datadog.env prod
76
- ```
77
-
78
- Resolve service default:
79
-
80
- ```bash
81
- jr-rpc config get datadog.service
82
- ```
83
-
84
- Set service default:
85
-
86
- ```bash
87
- jr-rpc config set datadog.service checkout
88
- ```
89
-
90
54
  ## Content expectations
91
55
 
92
56
  - Translate Slack-thread wording into stable observability language (env, service, status, span, monitor, incident, host).
@@ -79,6 +79,4 @@ Use these patterns to shape concrete Datadog requests.
79
79
 
80
80
  ## 13. Storing channel defaults
81
81
 
82
- - Use `jr-rpc config set datadog.env <env>` only when the user explicitly asks to store an env default for the conversation/channel.
83
- - Use `jr-rpc config set datadog.service <service>` only when the user explicitly asks to store a service default for the conversation/channel.
84
82
  - Treat both defaults as optional fallbacks. Explicit user input wins whenever a request names a different env or service.
@@ -2,14 +2,6 @@
2
2
 
3
3
  Use this reference when Datadog MCP calls fail or return unexpected results.
4
4
 
5
- ## Authentication and connection
6
-
7
- | Symptom | Likely cause | What to do |
8
- | ------------------------------------------------------------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
9
- | Tool call returns an authorization-required signal before running. | User has not yet completed the Datadog OAuth flow in Slack. | Let the runtime DM the user the authorization link and pause the turn. Do not prompt for credentials manually. |
10
- | Tool call returned `401` mid-session. | OAuth token expired or was revoked. | Expect Junior's MCP layer to resurface the authorization flow. Retry once the user has re-authorized; do not loop before that. |
11
- | OAuth callback did not resume the thread. | User closed the browser before the redirect completed. | Ask the user to retry the request — the OAuth flow will restart and complete if they finish it this time. |
12
-
13
5
  ## Permission and scope errors
14
6
 
15
7
  - A Datadog API returning `403 Forbidden` or `permission denied` means the user's Datadog role cannot read that resource (metrics, APM, incidents, RUM, etc.).