@rnsk/toolkits 0.0.5 → 0.0.6

package/dist/toolkits/gcp/tools/index.d.ts

@@ -0,0 +1,162 @@
+import { gcpListComputeInstances } from './compute/list-instances.js';
+import { gcpGetComputeInstance } from './compute/get-instance.js';
+import { gcpStartComputeInstance } from './compute/start-instance.js';
+import { gcpStopComputeInstance } from './compute/stop-instance.js';
+import { gcpGetMonitoringMetrics } from './monitoring/get-metrics.js';
+import { gcpListMonitoringMetricDescriptors } from './monitoring/list-metric-descriptors.js';
+export { gcpListComputeInstances, gcpGetComputeInstance, gcpStartComputeInstance, gcpStopComputeInstance, gcpGetMonitoringMetrics, gcpListMonitoringMetricDescriptors, };
+export declare const gcpTools: ({
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        gcpCredentials?: string | undefined;
+        zone?: string | undefined;
+    }, {
+        error: string;
+        count?: undefined;
+        instances?: undefined;
+        message?: undefined;
+    } | {
+        count: number;
+        instances: Record<string, unknown>[];
+        error?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        count?: undefined;
+        instances?: undefined;
+    }>;
+    requiredAuth: "gcpCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        zone: string;
+        instance: string;
+        gcpCredentials?: string | undefined;
+    }, {
+        error: string;
+        name?: undefined;
+        zone?: undefined;
+        status?: undefined;
+        machineType?: undefined;
+        privateIp?: undefined;
+        publicIp?: undefined;
+        creationTimestamp?: undefined;
+        message?: undefined;
+    } | {
+        name: string | null | undefined;
+        zone: string;
+        status: string | null | undefined;
+        machineType: string | undefined;
+        privateIp: string | null | undefined;
+        publicIp: string | null | undefined;
+        creationTimestamp: string | null | undefined;
+        error?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        name?: undefined;
+        zone?: undefined;
+        status?: undefined;
+        machineType?: undefined;
+        privateIp?: undefined;
+        publicIp?: undefined;
+        creationTimestamp?: undefined;
+    }>;
+    requiredAuth: "gcpCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        zone: string;
+        instance: string;
+        gcpCredentials?: string | undefined;
+    }, {
+        error: string;
+        instance?: undefined;
+        zone?: undefined;
+        operation?: undefined;
+        status?: undefined;
+        message?: undefined;
+    } | {
+        instance: string;
+        zone: string;
+        operation: string | undefined;
+        status: string;
+        error?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        instance?: undefined;
+        zone?: undefined;
+        operation?: undefined;
+        status?: undefined;
+    }>;
+    requiredAuth: "gcpCredentials";
+    scope: "write";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        filter: string;
+        startTime?: string | undefined;
+        endTime?: string | undefined;
+        gcpCredentials?: string | undefined;
+    }, {
+        error: string;
+        timeSeries?: undefined;
+        message?: undefined;
+    } | {
+        timeSeries: {
+            metric: import("@google-cloud/monitoring/build/protos/protos.js").google.api.IMetric | null | undefined;
+            resource: import("@google-cloud/monitoring/build/protos/protos.js").google.api.IMonitoredResource | null | undefined;
+            points: {
+                value: import("@google-cloud/monitoring/build/protos/protos.js").google.monitoring.v3.ITypedValue | null | undefined;
+                interval: import("@google-cloud/monitoring/build/protos/protos.js").google.monitoring.v3.ITimeInterval | null | undefined;
+            }[];
+        }[];
+        error?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        timeSeries?: undefined;
+    }>;
+    requiredAuth: "gcpCredentials";
+    scope: "read";
+} | {
+    name: string;
+    description: string;
+    tool: import("ai").Tool<{
+        filter?: string | undefined;
+        gcpCredentials?: string | undefined;
+    }, {
+        error: string;
+        descriptors?: undefined;
+        message?: undefined;
+    } | {
+        descriptors: {
+            type: string | null | undefined;
+            displayName: string | null | undefined;
+            description: string | null | undefined;
+            metricKind: import("@google-cloud/monitoring/build/protos/protos.js").google.api.MetricDescriptor.MetricKind | "METRIC_KIND_UNSPECIFIED" | "GAUGE" | "DELTA" | "CUMULATIVE" | null | undefined;
+            valueType: import("@google-cloud/monitoring/build/protos/protos.js").google.api.MetricDescriptor.ValueType | "VALUE_TYPE_UNSPECIFIED" | "BOOL" | "INT64" | "DOUBLE" | "STRING" | "DISTRIBUTION" | "MONEY" | null | undefined;
+            unit: string | null | undefined;
+        }[];
+        error?: undefined;
+        message?: undefined;
+    } | {
+        error: string;
+        message: string;
+        descriptors?: undefined;
+    }>;
+    requiredAuth: "gcpCredentials";
+    scope: "read";
+})[];
+//# sourceMappingURL=index.d.ts.map

package/dist/toolkits/gcp/tools/index.js

@@ -0,0 +1,52 @@
+import { gcpListComputeInstances } from './compute/list-instances.js';
+import { gcpGetComputeInstance } from './compute/get-instance.js';
+import { gcpStartComputeInstance } from './compute/start-instance.js';
+import { gcpStopComputeInstance } from './compute/stop-instance.js';
+import { gcpGetMonitoringMetrics } from './monitoring/get-metrics.js';
+import { gcpListMonitoringMetricDescriptors } from './monitoring/list-metric-descriptors.js';
+export { gcpListComputeInstances, gcpGetComputeInstance, gcpStartComputeInstance, gcpStopComputeInstance, gcpGetMonitoringMetrics, gcpListMonitoringMetricDescriptors, };
+export const gcpTools = [
+    {
+        name: 'gcpListComputeInstances',
+        description: 'List Compute Engine instances, optionally filtered by zone.',
+        tool: gcpListComputeInstances,
+        requiredAuth: 'gcpCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'gcpGetComputeInstance',
+        description: 'Get details about a specific Compute Engine instance.',
+        tool: gcpGetComputeInstance,
+        requiredAuth: 'gcpCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'gcpStartComputeInstance',
+        description: 'Start a stopped Compute Engine instance.',
+        tool: gcpStartComputeInstance,
+        requiredAuth: 'gcpCredentials',
+        scope: 'write',
+    },
+    {
+        name: 'gcpStopComputeInstance',
+        description: 'Stop a running Compute Engine instance.',
+        tool: gcpStopComputeInstance,
+        requiredAuth: 'gcpCredentials',
+        scope: 'write',
+    },
+    {
+        name: 'gcpGetMonitoringMetrics',
+        description: 'Retrieve Cloud Monitoring time series data for a metric filter.',
+        tool: gcpGetMonitoringMetrics,
+        requiredAuth: 'gcpCredentials',
+        scope: 'read',
+    },
+    {
+        name: 'gcpListMonitoringMetricDescriptors',
+        description: 'List available Cloud Monitoring metric descriptors.',
+        tool: gcpListMonitoringMetricDescriptors,
+        requiredAuth: 'gcpCredentials',
+        scope: 'read',
+    },
+];
+//# sourceMappingURL=index.js.map

package/dist/toolkits/gcp/tools/monitoring/get-metrics.d.ts

@@ -0,0 +1,26 @@
+export declare const gcpGetMonitoringMetrics: import("ai").Tool<{
+    filter: string;
+    startTime?: string | undefined;
+    endTime?: string | undefined;
+    gcpCredentials?: string | undefined;
+}, {
+    error: string;
+    timeSeries?: undefined;
+    message?: undefined;
+} | {
+    timeSeries: {
+        metric: import("@google-cloud/monitoring/build/protos/protos.js").google.api.IMetric | null | undefined;
+        resource: import("@google-cloud/monitoring/build/protos/protos.js").google.api.IMonitoredResource | null | undefined;
+        points: {
+            value: import("@google-cloud/monitoring/build/protos/protos.js").google.monitoring.v3.ITypedValue | null | undefined;
+            interval: import("@google-cloud/monitoring/build/protos/protos.js").google.monitoring.v3.ITimeInterval | null | undefined;
+        }[];
+    }[];
+    error?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    timeSeries?: undefined;
+}>;
+//# sourceMappingURL=get-metrics.d.ts.map

package/dist/toolkits/gcp/tools/monitoring/get-metrics.js

@@ -0,0 +1,53 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { createMonitoringClient, getProjectId } from '../client.js';
+export const gcpGetMonitoringMetrics = tool({
+    description: 'Retrieve Cloud Monitoring time series data for a metric filter (e.g. compute.googleapis.com/instance/cpu/utilization). Use this to check resource health or usage trends.',
+    inputSchema: z.object({
+        gcpCredentials: z.string().optional().describe('Injected by system; do not provide'),
+        filter: z
+            .string()
+            .describe('Monitoring filter, e.g. \'metric.type="compute.googleapis.com/instance/cpu/utilization"\''),
+        startTime: z.string().optional().describe('Start time in ISO 8601 format (default: 1 hour ago)'),
+        endTime: z.string().optional().describe('End time in ISO 8601 format (default: now)'),
+    }),
+    execute: async ({ gcpCredentials, filter, startTime, endTime }) => {
+        if (!gcpCredentials) {
+            return { error: 'GCP credentials are required. Connect GCP first.' };
+        }
+        try {
+            const client = createMonitoringClient(gcpCredentials);
+            const projectId = getProjectId(gcpCredentials);
+            const [timeSeries] = await client.listTimeSeries({
+                name: `projects/${projectId}`,
+                filter,
+                interval: {
+                    startTime: {
+                        seconds: startTime ? Math.floor(new Date(startTime).getTime() / 1000) : Math.floor(Date.now() / 1000) - 3600,
+                    },
+                    endTime: {
+                        seconds: endTime ? Math.floor(new Date(endTime).getTime() / 1000) : Math.floor(Date.now() / 1000),
+                    },
+                },
+                view: 'FULL',
+            });
+            return {
+                timeSeries: (timeSeries ?? []).map((series) => ({
+                    metric: series.metric,
+                    resource: series.resource,
+                    points: (series.points ?? []).map((point) => ({
+                        value: point.value,
+                        interval: point.interval,
+                    })),
+                })),
+            };
+        }
+        catch (err) {
+            return {
+                error: 'Failed to get Cloud Monitoring metrics',
+                message: err instanceof Error ? err.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=get-metrics.js.map

package/dist/toolkits/gcp/tools/monitoring/list-metric-descriptors.d.ts

@@ -0,0 +1,24 @@
+export declare const gcpListMonitoringMetricDescriptors: import("ai").Tool<{
+    filter?: string | undefined;
+    gcpCredentials?: string | undefined;
+}, {
+    error: string;
+    descriptors?: undefined;
+    message?: undefined;
+} | {
+    descriptors: {
+        type: string | null | undefined;
+        displayName: string | null | undefined;
+        description: string | null | undefined;
+        metricKind: import("@google-cloud/monitoring/build/protos/protos.js").google.api.MetricDescriptor.MetricKind | "METRIC_KIND_UNSPECIFIED" | "GAUGE" | "DELTA" | "CUMULATIVE" | null | undefined;
+        valueType: import("@google-cloud/monitoring/build/protos/protos.js").google.api.MetricDescriptor.ValueType | "VALUE_TYPE_UNSPECIFIED" | "BOOL" | "INT64" | "DOUBLE" | "STRING" | "DISTRIBUTION" | "MONEY" | null | undefined;
+        unit: string | null | undefined;
+    }[];
+    error?: undefined;
+    message?: undefined;
+} | {
+    error: string;
+    message: string;
+    descriptors?: undefined;
+}>;
+//# sourceMappingURL=list-metric-descriptors.d.ts.map

package/dist/toolkits/gcp/tools/monitoring/list-metric-descriptors.js

@@ -0,0 +1,40 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { createMonitoringClient, getProjectId } from '../client.js';
+export const gcpListMonitoringMetricDescriptors = tool({
+    description: 'List available Cloud Monitoring metric descriptors, optionally filtered by metric type.',
+    inputSchema: z.object({
+        gcpCredentials: z.string().optional().describe('Injected by system; do not provide'),
+        filter: z.string().optional().describe('Optional filter for metric type, e.g. \'metric.type = starts_with("compute")\''),
+    }),
+    execute: async ({ gcpCredentials, filter }) => {
+        if (!gcpCredentials) {
+            return { error: 'GCP credentials are required. Connect GCP first.' };
+        }
+        try {
+            const client = createMonitoringClient(gcpCredentials);
+            const projectId = getProjectId(gcpCredentials);
+            const [descriptors] = await client.listMetricDescriptors({
+                name: `projects/${projectId}`,
+                filter,
+            });
+            return {
+                descriptors: (descriptors ?? []).map((descriptor) => ({
+                    type: descriptor.type,
+                    displayName: descriptor.displayName,
+                    description: descriptor.description,
+                    metricKind: descriptor.metricKind,
+                    valueType: descriptor.valueType,
+                    unit: descriptor.unit,
+                })),
+            };
+        }
+        catch (err) {
+            return {
+                error: 'Failed to list Cloud Monitoring metric descriptors',
+                message: err instanceof Error ? err.message : 'Unknown error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=list-metric-descriptors.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rnsk/toolkits",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "Runstack toolkit registry — manifest-driven tool definitions for AI agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,6 +32,11 @@
     "zod": "^3.23.0 || ^4.0.0"
   },
   "dependencies": {
+    "@aws-sdk/client-cloudwatch": "^3.1134.0",
+    "@aws-sdk/client-cloudwatch-logs": "^3.1134.0",
+    "@aws-sdk/client-ec2": "^3.1134.0",
+    "@google-cloud/compute": "^7.4.0",
+    "@google-cloud/monitoring": "^6.1.0",
     "firecrawl": "^4.38.0",
     "octokit": "^5.0.5",
     "zod-to-json-schema": "^3.25.2"