feat(grafana): validate integration and add folder, health, and contact-point tools

[waleedlatif1]

Summary

• Validated every existing Grafana tool against the live HTTP API docs and fixed the issues found
• Block now requires alert-rule title/ruleGroup/data (create previously could 400 with only folder set)
• Trim UID path params across dashboard + alert-rule tools to avoid copy-paste 404s
• Use Grafana brand color (#F46800) for the block background
• Surface previously-unsettable list params: limit, starred, annotation type
• Add 6 new tools: get/update/delete folder, check data source health, get health, create contact point
• Stripped non-TSDoc comments; regenerated docs and integrations.json

Type of Change

• New feature
• Bug fix

Testing

Tested manually; bun run lint and typecheck pass clean for all Grafana files.

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Jun 16, 2026 1:59am

[cursor]

PR Summary

Medium Risk
New mutating Grafana APIs (folder delete, contact-point create) can change production alerting config; scope is limited to standard bearer-token calls with existing patterns, including DNS-pinned fetch on folder update.

Overview
Expands the Grafana integration from 19 to 25 operations with six new API tools: instance health, data-source health check, create contact point, and folder get / update / delete (including optional forceDeleteRules on delete).

The workflow block gains matching operations and UI fields (contact-point type/settings, folder management, list limit / starred / annotation type), switches block→tool param mapping to per-operation switch logic, and enforces title, ruleGroup, and query data when creating alert rules. Grafana branding uses #F46800 in docs, block, and integrations.json.

Fixes: .trim() on dashboard and alert-rule UIDs in request URLs to avoid stray-whitespace 404s; alert-rule custom UID trimmed on create.

Docs, registry wiring, types, and a provision-alerting skill (plus audit-dashboards health-check step) are updated. Minor unrelated change: MicrosoftIcon SVG redraw.

^{Reviewed by Cursor Bugbot for commit 014c928. Configure here.}

[greptile-apps]

Greptile Summary

This PR validates all existing Grafana tools against the live API docs and adds six new tools: get/update/delete folder, check data source health, get health, and create contact point. It also fixes several bugs in the existing block, including required-field enforcement on alert-rule creation, UID trimming on path params, and the previous contactPointType/annotationType interaction issue.

• New tools: get_folder, update_folder, delete_folder, check_data_source_health, get_health, create_contact_point — all registered in tools/registry.ts, exported from index.ts, and wired into the block's access list.
• Block improvements: The params() switch now routes per-operation params explicitly, preventing field bleed between operations; starred, limit, and annotationType filters are newly surfaced in the UI; required-field markers added for alertTitle, ruleGroup, and queryData on create.
• update_folder uses the same GET-then-PUT pattern as update_dashboard and update_alert_rule, calling secureFetchWithPinnedIP + validateUrlWithDNS in postProcess for SSRF protection on the mutation leg.

Confidence Score: 5/5

Safe to merge — the new tools follow existing patterns correctly and the block param-routing refactor is logically sound.

All six new tools correctly wire their params (via the block's pass-through mechanism where subBlock IDs match tool param names, and via explicit switch-case mapping where they don't). The update_folder two-step GET+PUT correctly applies SSRF protection on the mutation leg, consistent with update_dashboard and update_alert_rule. The previously reported contactPointType/annotationType interaction bug is fixed by the per-operation switch. No incorrect data flows, missing required side effects, or broken contracts were found.

No files require special attention.

Important Files Changed

Filename	Overview
apps/sim/blocks/blocks/grafana.ts	Block config refactored: per-operation switch eliminates cross-operation field bleed, six new operations added with correct conditions and UI fields, required markers added on alert-rule create params.
apps/sim/tools/grafana/update_folder.ts	Implements GET-then-PUT pattern (matching update_dashboard / update_alert_rule); uses validateUrlWithDNS + secureFetchWithPinnedIP for SSRF protection on the mutation; reads current folder version to avoid version conflicts.
apps/sim/tools/grafana/create_contact_point.ts	New tool for POST /api/v1/provisioning/contact-points; correctly parses JSON settings string, handles X-Disable-Provenance header, and returns full contact-point response.
apps/sim/tools/grafana/delete_folder.ts	New tool for DELETE /api/folders/{uid}; conditionally appends ?forceDeleteRules=true; uses .catch(()=>{}) on response.json() since DELETE responses may have no body.
apps/sim/tools/grafana/check_data_source_health.ts	New tool for GET /api/datasources/uid/{uid}/health; correctly uses dataSourceUid (not legacy numeric id) and trims the path parameter.
apps/sim/tools/grafana/get_health.ts	New tool for GET /api/health; returns commit, version, and database status; apiKey declared required for consistency with other Grafana tools.
apps/sim/tools/grafana/types.ts	Type interfaces for all six new tools added and exported; GrafanaResponse union extended correctly.
apps/sim/tools/registry.ts	All six new tools correctly imported and registered under their canonical string IDs.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    UI[Block UI\nOperation dropdown] --> Switch{params switch\nper operation}

    Switch -->|grafana_create_contact_point| CP[create_contact_point\nPOST /api/v1/provisioning/contact-points]
    Switch -->|grafana_get_folder| GF[get_folder\nGET /api/folders/:uid]
    Switch -->|grafana_update_folder| UF_GET[GET /api/folders/:uid\ninitial fetch]
    Switch -->|grafana_delete_folder| DF[delete_folder\nDELETE /api/folders/:uid\n?forceDeleteRules=true optional]
    Switch -->|grafana_check_data_source_health| DSH[check_data_source_health\nGET /api/datasources/uid/:uid/health]
    Switch -->|grafana_get_health| GH[get_health\nGET /api/health]

    UF_GET --> TR[transformResponse\nstores _existingFolder]
    TR --> PP[postProcess\nvalidateUrlWithDNS\nsecureFetchWithPinnedIP]
    PP --> UF_PUT[PUT /api/folders/:uid\nwith version + new title]

    CP --> Grafana[(Grafana API)]
    GF --> Grafana
    UF_PUT --> Grafana
    DF --> Grafana
    DSH --> Grafana
    GH --> Grafana

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    UI[Block UI\nOperation dropdown] --> Switch{params switch\nper operation}

    Switch -->|grafana_create_contact_point| CP[create_contact_point\nPOST /api/v1/provisioning/contact-points]
    Switch -->|grafana_get_folder| GF[get_folder\nGET /api/folders/:uid]
    Switch -->|grafana_update_folder| UF_GET[GET /api/folders/:uid\ninitial fetch]
    Switch -->|grafana_delete_folder| DF[delete_folder\nDELETE /api/folders/:uid\n?forceDeleteRules=true optional]
    Switch -->|grafana_check_data_source_health| DSH[check_data_source_health\nGET /api/datasources/uid/:uid/health]
    Switch -->|grafana_get_health| GH[get_health\nGET /api/health]

    UF_GET --> TR[transformResponse\nstores _existingFolder]
    TR --> PP[postProcess\nvalidateUrlWithDNS\nsecureFetchWithPinnedIP]
    PP --> UF_PUT[PUT /api/folders/:uid\nwith version + new title]

    CP --> Grafana[(Grafana API)]
    GF --> Grafana
    UF_PUT --> Grafana
    DF --> Grafana
    DSH --> Grafana
    GH --> Grafana

Loading

_{Reviews (3): Last reviewed commit: "fix(grafana): scope block param remaps p..." | Re-trigger Greptile}

[waleedlatif1]

@greptile

[waleedlatif1]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 014c928. Configure here.}

[waleedlatif1]

@greptile review