@rnsk/toolkits 0.0.6 → 0.0.8

package/dist/toolkits/grafana/icon.js

@@ -0,0 +1,6 @@
+const SVG = `<svg width="800px" height="800px" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg" fill="none"><path fill="url(#grafana-color-16__paint0_linear_2372_364)" d="M13.985 7.175a4.408 4.408 0 00-.138-.802 5.035 5.035 0 00-1.054-1.998 2.96 2.96 0 00-.366-.393c.198-.787-.245-1.468-.245-1.468-.764-.046-1.237.227-1.42.363-.031-.015-.062-.03-.092-.03-.122-.046-.26-.106-.397-.137-.138-.045-.275-.075-.413-.12-.137-.031-.29-.061-.443-.092-.03 0-.046 0-.076-.015C9.005 1.44 8.058 1 8.058 1 7.004 1.666 6.79 2.604 6.79 2.604s0 .015-.016.06l-.183.046c-.076.03-.168.06-.244.076-.077.03-.168.06-.245.09-.153.076-.32.152-.473.228-.153.09-.306.181-.443.272-.016-.015-.03-.015-.03-.015-1.467-.545-2.766.136-2.766.136-.122 1.544.58 2.528.733 2.71-.03.09-.06.196-.091.287a8.104 8.104 0 00-.245 1.09c0 .06-.015.106-.015.166C1.397 8.386 1 9.748 1 9.748c1.13 1.287 2.46 1.377 2.46 1.377.167.303.366.575.58.848.092.106.183.212.29.318a3.014 3.014 0 00.061 2.149c1.268.045 2.093-.545 2.261-.681.122.045.26.076.382.106.382.106.78.151 1.176.181h.49c.595.848 1.634.954 1.634.954.748-.772.779-1.544.779-1.71v-.015-.03-.03c.153-.107.305-.228.443-.35a5.37 5.37 0 00.779-.892c.015-.03.046-.06.061-.09.84.045 1.436-.515 1.436-.515-.138-.863-.642-1.287-.749-1.378l-.015-.015h-.015s-.015 0-.015-.015c0-.045.015-.106.015-.151 0-.091.015-.182.015-.288V9.4v-.166-.076-.152l-.015-.075c-.015-.091-.03-.197-.061-.288a3.506 3.506 0 00-.428-1.044 3.856 3.856 0 00-.718-.848 3.784 3.784 0 00-.901-.575 3.347 3.347 0 00-.993-.272c-.168-.015-.336-.03-.504-.03H9.37 9.204c-.092.015-.169.015-.26.03-.336.06-.642.181-.932.348-.275.166-.52.363-.718.605a2.579 2.579 0 00-.459.757 2.63 2.63 0 00-.183.817v.393c.015.137.046.273.077.394.076.258.183.485.336.666.137.197.32.348.504.485.183.12.382.212.58.272.199.06.382.076.565.076h.244c.031 0 .047 0 .062-.015.015 0 .046-.015.061-.015.046-.016.076-.016.122-.03l.23-.092a.869.869 0 00.198-.12c.015-.016.03-.03.046-.03a.129.129 0 00.015-.198c-.046-.06-.122-.075-.183-.03-.015.015-.03.015-.046.03-.046.03-.107.046-.168.06l-.183.046c-.03 0-.061.015-.092.015H8.73a1.519 1.519 0 01-.825-.378 1.452 1.452 0 01-.306-.378 1.655 1.655 0 01-.168-.485c-.015-.09-.015-.166-.015-.257v-.106-.03c0-.046.015-.091.015-.136.061-.364.26-.727.55-1 .077-.075.153-.136.23-.181.076-.06.167-.106.259-.151.092-.046.183-.076.29-.106a.993.993 0 01.306-.046h.321c.107.015.229.03.336.046.214.045.427.12.626.242.397.212.733.56.947.969.107.211.183.423.214.65.015.06.015.121.015.167v.363c0 .06-.015.121-.015.182 0 .06-.015.12-.03.181l-.046.182c-.03.121-.077.242-.123.363a3.183 3.183 0 01-.366.666 3.002 3.002 0 01-1.91 1.18c-.122.016-.26.03-.382.046h-.198c-.061 0-.138 0-.199-.015a3.637 3.637 0 01-.81-.151 4.068 4.068 0 01-.748-.303 4.098 4.098 0 01-1.696-1.695 4.398 4.398 0 01-.29-.742c-.076-.257-.107-.514-.137-.772v-.302-.091c0-.136.015-.258.03-.394s.046-.272.061-.393c.03-.137.061-.258.092-.394a5.33 5.33 0 01.275-.741c.214-.47.504-.893.855-1.226.092-.091.184-.167.275-.243.092-.075.184-.136.29-.211a5.39 5.39 0 01.306-.182c.046-.03.107-.045.153-.076a.26.26 0 01.076-.03.26.26 0 01.077-.03c.107-.046.229-.091.336-.121.03-.015.06-.015.091-.03.03-.016.061-.016.092-.03.061-.016.122-.031.168-.046.03-.015.061-.015.092-.015.03 0 .06-.016.091-.016.03 0 .061-.015.092-.015l.046-.015h.046c.03 0 .06-.015.091-.015.03 0 .061-.015.107-.015.03 0 .077-.015.107-.015h.764c.23.015.443.03.657.075.428.076.84.212 1.207.394.366.182.702.393.977.636l.046.045.046.045c.03.03.061.061.107.091l.092.091.091.09c.123.122.23.258.336.394.199.258.367.515.49.772.014.015.014.03.03.046.015.015.015.03.015.045l.046.09.046.092.045.09c.046.122.092.228.123.333.06.167.107.318.137.455.015.045.061.09.122.075a.104.104 0 00.107-.106c.092-.227.092-.393.077-.575z"/><defs><linearGradient id="grafana-color-16__paint0_linear_2372_364" x1="7.502" x2="7.502" y1="18.142" y2="5.356" gradientUnits="userSpaceOnUse"><stop stop-color="#FFF200"/><stop offset="1" stop-color="#F15A29"/></linearGradient></defs></svg>`;
+export const GRAFANA_ICON = {
+    kind: 'svg',
+    dataUri: `data:image/svg+xml;base64,${Buffer.from(SVG).toString('base64')}`,
+};
+//# sourceMappingURL=icon.js.map

package/dist/toolkits/grafana/manifest.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("../../index.js").ToolkitManifest;
+export default _default;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/toolkits/grafana/manifest.js

@@ -0,0 +1,31 @@
+import { defineToolkit, defineTool } from '../../core/define.js';
+import { GRAFANA_ICON } from './icon.js';
+import { grafanaTools } from './tools/index.js';
+export default defineToolkit({
+    id: 'grafana',
+    displayName: 'Grafana',
+    shortDescription: 'Monitor Grafana health, query public dashboards, ingest OTLP logs, and inspect Mimir/Loki ring status.',
+    category: 'Developer Tools & DevOps',
+    icon: GRAFANA_ICON,
+    auth: {
+        type: 'service_account',
+        tokenField: 'grafanaCredentials',
+        provider: {
+            fields: ['baseUrl', 'apiToken'],
+            connectDescription: 'Connect your Grafana instance with its base URL (e.g. https://grafana.example.com) and an optional service account API token.',
+        },
+    },
+    tools: grafanaTools.map((entry) => defineTool({
+        name: entry.name,
+        description: entry.description,
+        tool: entry.tool,
+        requiredAuth: entry.requiredAuth,
+        scope: entry.scope,
+    })),
+    meta: {
+        since: '0.0.6',
+        homepage: 'https://grafana.com',
+        docsUrl: 'https://grafana.com/docs/grafana/latest/developer-resources/api-reference/http-api/',
+    },
+});
+//# sourceMappingURL=manifest.js.map

package/dist/toolkits/grafana/tools/create-otlp-v1-logs.d.ts

@@ -0,0 +1,23 @@
+export declare const createOtlpV1Logs: import("ai").Tool<{
+    grafanaCredentials: string;
+    resourceLogs: Record<string, any>[];
+}, {
+    error: string;
+    details: any;
+    statusCode: number;
+    success?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    statusCode: number;
+    message: string;
+    error?: undefined;
+    details?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    statusCode?: undefined;
+    success?: undefined;
+}>;
+//# sourceMappingURL=create-otlp-v1-logs.d.ts.map

package/dist/toolkits/grafana/tools/create-otlp-v1-logs.js

@@ -0,0 +1,41 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { grafanaRequest } from './utils.js';
+export const createOtlpV1Logs = tool({
+    description: 'Send OpenTelemetry Protocol (OTLP) v1 logs to Grafana Loki for ingestion and storage.',
+    inputSchema: z.object({
+        grafanaCredentials: z.string().describe('Grafana credentials JSON with baseUrl and optional apiToken'),
+        resourceLogs: z
+            .array(z.record(z.any()))
+            .describe('List of resource logs to send to Grafana Loki in OTLP format'),
+    }),
+    execute: async ({ grafanaCredentials, resourceLogs }) => {
+        try {
+            const result = await grafanaRequest(grafanaCredentials, '/otlp/v1/logs', {
+                method: 'POST',
+                body: { resourceLogs },
+                contentType: 'application/json',
+            });
+            if (!result.ok) {
+                return {
+                    error: 'Failed to create OTLP v1 logs',
+                    details: result.data,
+                    statusCode: result.status,
+                };
+            }
+            return {
+                success: true,
+                statusCode: result.status,
+                message: 'Logs ingested successfully',
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error creating OTLP v1 logs',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=create-otlp-v1-logs.js.map

package/dist/toolkits/grafana/tools/get-distributor-ha-tracker.d.ts

@@ -0,0 +1,22 @@
+export declare const getDistributorHaTracker: import("ai").Tool<{
+    grafanaCredentials: string;
+}, {
+    error: string;
+    details: any;
+    statusCode: number;
+    htmlContent?: undefined;
+    message?: undefined;
+} | {
+    statusCode: number;
+    htmlContent: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    statusCode?: undefined;
+    htmlContent?: undefined;
+}>;
+//# sourceMappingURL=get-distributor-ha-tracker.d.ts.map

package/dist/toolkits/grafana/tools/get-distributor-ha-tracker.js

@@ -0,0 +1,33 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { grafanaRequest } from './utils.js';
+export const getDistributorHaTracker = tool({
+    description: 'Retrieve distributor HA tracker status showing which replica is elected leader for each Prometheus HA cluster.',
+    inputSchema: z.object({
+        grafanaCredentials: z.string().describe('Grafana credentials JSON with baseUrl and optional apiToken'),
+    }),
+    execute: async ({ grafanaCredentials }) => {
+        try {
+            const result = await grafanaRequest(grafanaCredentials, '/distributor/ha_tracker');
+            if (!result.ok) {
+                return {
+                    error: 'Failed to get distributor HA tracker status',
+                    details: result.data,
+                    statusCode: result.status,
+                };
+            }
+            return {
+                statusCode: result.status,
+                htmlContent: result.data,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error getting distributor HA tracker status',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-distributor-ha-tracker.js.map

package/dist/toolkits/grafana/tools/get-health.d.ts

@@ -0,0 +1,4 @@
+export declare const getHealth: import("ai").Tool<{
+    grafanaCredentials: string;
+}, any>;
+//# sourceMappingURL=get-health.d.ts.map

package/dist/toolkits/grafana/tools/get-health.js

@@ -0,0 +1,32 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { grafanaRequest } from './utils.js';
+export const getHealth = tool({
+    description: 'Check Grafana server health and database connectivity. Returns ok if the web server is running and can access the database.',
+    inputSchema: z.object({
+        grafanaCredentials: z.string().describe('Grafana credentials JSON with baseUrl and optional apiToken'),
+    }),
+    execute: async ({ grafanaCredentials }) => {
+        try {
+            const result = await grafanaRequest(grafanaCredentials, '/api/health', {
+                acceptJson: true,
+            });
+            if (!result.ok) {
+                return {
+                    error: 'Failed to get Grafana health status',
+                    details: result.data,
+                    statusCode: result.status,
+                };
+            }
+            return result.data;
+        }
+        catch (error) {
+            return {
+                error: 'Error getting Grafana health status',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-health.js.map

package/dist/toolkits/grafana/tools/get-index-gateway-ring.d.ts

@@ -0,0 +1,22 @@
+export declare const getIndexGatewayRing: import("ai").Tool<{
+    grafanaCredentials: string;
+}, {
+    error: string;
+    details: any;
+    statusCode: number;
+    htmlContent?: undefined;
+    message?: undefined;
+} | {
+    statusCode: number;
+    htmlContent: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    statusCode?: undefined;
+    htmlContent?: undefined;
+}>;
+//# sourceMappingURL=get-index-gateway-ring.d.ts.map

package/dist/toolkits/grafana/tools/get-index-gateway-ring.js

@@ -0,0 +1,33 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { grafanaRequest } from './utils.js';
+export const getIndexGatewayRing = tool({
+    description: 'Retrieve index gateway hash ring status including state, health, and last heartbeat of each node.',
+    inputSchema: z.object({
+        grafanaCredentials: z.string().describe('Grafana credentials JSON with baseUrl and optional apiToken'),
+    }),
+    execute: async ({ grafanaCredentials }) => {
+        try {
+            const result = await grafanaRequest(grafanaCredentials, '/indexgateway/ring');
+            if (!result.ok) {
+                return {
+                    error: 'Failed to get index gateway ring status',
+                    details: result.data,
+                    statusCode: result.status,
+                };
+            }
+            return {
+                statusCode: result.status,
+                htmlContent: result.data,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error getting index gateway ring status',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-index-gateway-ring.js.map

package/dist/toolkits/grafana/tools/get-overrides-exporter-ring.d.ts

@@ -0,0 +1,22 @@
+export declare const getOverridesExporterRing: import("ai").Tool<{
+    grafanaCredentials: string;
+}, {
+    error: string;
+    details: any;
+    statusCode: number;
+    htmlContent?: undefined;
+    message?: undefined;
+} | {
+    statusCode: number;
+    htmlContent: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    statusCode?: undefined;
+    htmlContent?: undefined;
+}>;
+//# sourceMappingURL=get-overrides-exporter-ring.d.ts.map

package/dist/toolkits/grafana/tools/get-overrides-exporter-ring.js

@@ -0,0 +1,33 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { grafanaRequest } from './utils.js';
+export const getOverridesExporterRing = tool({
+    description: 'Retrieve overrides-exporter hash ring status including state, health, and last heartbeat of each node.',
+    inputSchema: z.object({
+        grafanaCredentials: z.string().describe('Grafana credentials JSON with baseUrl and optional apiToken'),
+    }),
+    execute: async ({ grafanaCredentials }) => {
+        try {
+            const result = await grafanaRequest(grafanaCredentials, '/overrides-exporter/ring');
+            if (!result.ok) {
+                return {
+                    error: 'Failed to get overrides-exporter ring status',
+                    details: result.data,
+                    statusCode: result.status,
+                };
+            }
+            return {
+                statusCode: result.status,
+                htmlContent: result.data,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error getting overrides-exporter ring status',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-overrides-exporter-ring.js.map

package/dist/toolkits/grafana/tools/get-ruler-ring.d.ts

@@ -0,0 +1,22 @@
+export declare const getRulerRing: import("ai").Tool<{
+    grafanaCredentials: string;
+}, {
+    error: string;
+    details: any;
+    statusCode: number;
+    htmlContent?: undefined;
+    message?: undefined;
+} | {
+    statusCode: number;
+    htmlContent: any;
+    error?: undefined;
+    details?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    statusCode?: undefined;
+    htmlContent?: undefined;
+}>;
+//# sourceMappingURL=get-ruler-ring.d.ts.map

package/dist/toolkits/grafana/tools/get-ruler-ring.js

@@ -0,0 +1,33 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { grafanaRequest } from './utils.js';
+export const getRulerRing = tool({
+    description: 'Retrieve ruler hash ring status including state, health, and last heartbeat of each ruler node.',
+    inputSchema: z.object({
+        grafanaCredentials: z.string().describe('Grafana credentials JSON with baseUrl and optional apiToken'),
+    }),
+    execute: async ({ grafanaCredentials }) => {
+        try {
+            const result = await grafanaRequest(grafanaCredentials, '/ruler/ring');
+            if (!result.ok) {
+                return {
+                    error: 'Failed to get ruler ring status',
+                    details: result.data,
+                    statusCode: result.status,
+                };
+            }
+            return {
+                statusCode: result.status,
+                htmlContent: result.data,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error getting ruler ring status',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-ruler-ring.js.map

package/dist/toolkits/grafana/tools/get-status.d.ts

@@ -0,0 +1,22 @@
+export declare const getStatus: import("ai").Tool<{
+    grafanaCredentials: string;
+}, {
+    error: string;
+    details: any;
+    statusCode: number;
+    licenseAvailable?: undefined;
+    message?: undefined;
+} | {
+    licenseAvailable: any;
+    error?: undefined;
+    details?: undefined;
+    statusCode?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    statusCode?: undefined;
+    licenseAvailable?: undefined;
+}>;
+//# sourceMappingURL=get-status.d.ts.map

package/dist/toolkits/grafana/tools/get-status.js

@@ -0,0 +1,35 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { grafanaRequest } from './utils.js';
+export const getStatus = tool({
+    description: 'Check if a valid Grafana Enterprise license is available on the instance.',
+    inputSchema: z.object({
+        grafanaCredentials: z.string().describe('Grafana credentials JSON with baseUrl and apiToken'),
+    }),
+    execute: async ({ grafanaCredentials }) => {
+        try {
+            const result = await grafanaRequest(grafanaCredentials, '/api/licensing/check', {
+                acceptJson: true,
+            });
+            if (!result.ok) {
+                return {
+                    error: 'Failed to get license status',
+                    details: result.data,
+                    statusCode: result.status,
+                };
+            }
+            const licenseAvailable = typeof result.data === 'boolean'
+                ? result.data
+                : result.data?.license_available ?? result.data?.licenseAvailable ?? false;
+            return { licenseAvailable };
+        }
+        catch (error) {
+            return {
+                error: 'Error getting license status',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-status.js.map

package/dist/toolkits/grafana/tools/get-store-gateway-tenants.d.ts

@@ -0,0 +1,25 @@
+export declare const getStoreGatewayTenants: import("ai").Tool<{
+    grafanaCredentials: string;
+}, {
+    error: string;
+    details: any;
+    statusCode: number;
+    content?: undefined;
+    contentType?: undefined;
+    message?: undefined;
+} | {
+    content: any;
+    contentType: string;
+    error?: undefined;
+    details?: undefined;
+    statusCode?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    details?: undefined;
+    statusCode?: undefined;
+    content?: undefined;
+    contentType?: undefined;
+}>;
+//# sourceMappingURL=get-store-gateway-tenants.d.ts.map

package/dist/toolkits/grafana/tools/get-store-gateway-tenants.js

@@ -0,0 +1,33 @@
+// @ts-nocheck
+import { tool } from 'ai';
+import { z } from 'zod';
+import { grafanaRequest } from './utils.js';
+export const getStoreGatewayTenants = tool({
+    description: 'Retrieve store gateway tenants that have blocks stored in the configured storage.',
+    inputSchema: z.object({
+        grafanaCredentials: z.string().describe('Grafana credentials JSON with baseUrl and optional apiToken'),
+    }),
+    execute: async ({ grafanaCredentials }) => {
+        try {
+            const result = await grafanaRequest(grafanaCredentials, '/store-gateway/tenants');
+            if (!result.ok) {
+                return {
+                    error: 'Failed to get store gateway tenants',
+                    details: result.data,
+                    statusCode: result.status,
+                };
+            }
+            return {
+                content: result.data,
+                contentType: result.contentType,
+            };
+        }
+        catch (error) {
+            return {
+                error: 'Error getting store gateway tenants',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-store-gateway-tenants.js.map