@prodisco/prometheus-client 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Prodisco
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,212 @@
+# @prodisco/prometheus-client
+
+Typed Prometheus client with semantic metric discovery for AI agents. Wraps the `prometheus-query` library with a clean TypeScript interface.
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+- [Types](#types)
+- [Environment Variables](#environment-variables)
+- [License](#license)
+
+## Features
+
+- **Semantic Metric Search**: Find metrics by natural language queries (e.g., "memory usage")
+- **Typed Execution**: Full TypeScript support for PromQL execution
+- **Orama Integration**: Uses `@prodisco/search-libs` for fast, indexed metric search
+
+## Installation
+
+```bash
+npm install @prodisco/prometheus-client
+```
+
+## Quick Start
+
+```typescript
+import { PrometheusClient, MetricSearchEngine } from '@prodisco/prometheus-client';
+
+// Create client and search engine
+const client = new PrometheusClient({ endpoint: 'http://prometheus:9090' });
+const search = new MetricSearchEngine(client);
+
+// 1. DISCOVER metrics with semantic search
+const memoryMetrics = await search.search('memory usage');
+console.log(memoryMetrics);
+// [{ name: 'container_memory_working_set_bytes', type: 'gauge', help: 'Current working set in bytes' }, ...]
+
+// 2. EXECUTE PromQL with discovered metric names
+const result = await client.executeRange('container_memory_working_set_bytes', {
+  start: new Date(Date.now() - 3600000), // 1 hour ago
+  end: new Date(),
+  step: '5m'
+});
+console.log(result.data);
+```
+
+## API Reference
+
+### MetricSearchEngine
+
+Semantic search for discovering available metrics. **Use this first** before executing queries.
+
+```typescript
+import { PrometheusClient, MetricSearchEngine } from '@prodisco/prometheus-client';
+
+const client = new PrometheusClient({ endpoint: 'http://prometheus:9090' });
+const search = new MetricSearchEngine(client);
+```
+
+#### Methods
+
+##### `search(query: string, options?: MetricSearchOptions): Promise<MetricInfo[]>`
+
+Search metrics by natural language. Searches both metric names AND descriptions.
+
+```typescript
+// Find memory-related metrics
+const metrics = await search.search('memory usage');
+
+// Find CPU metrics, filter by type
+const gauges = await search.search('cpu', { type: 'gauge', limit: 10 });
+```
+
+##### `index(force?: boolean): Promise<number>`
+
+Manually index/refresh metrics from Prometheus. Called automatically on first search.
+
+```typescript
+const count = await search.index();
+console.log(`Indexed ${count} metrics`);
+```
+
+##### `list(options?: MetricSearchOptions): Promise<MetricInfo[]>`
+
+List all indexed metrics.
+
+```typescript
+const allMetrics = await search.list({ limit: 100 });
+```
+
+### PrometheusClient
+
+Execute PromQL queries against Prometheus. **Note**: You should know the metric names first - use `MetricSearchEngine.search()` to discover them.
+
+```typescript
+import { PrometheusClient } from '@prodisco/prometheus-client';
+
+const client = new PrometheusClient({
+  endpoint: 'http://prometheus:9090',
+  timeout: 30000, // optional, default 30s
+});
+```
+
+#### Methods
+
+##### `execute(promql: string, time?: Date): Promise<InstantQueryResult>`
+
+Execute an instant PromQL query.
+
+```typescript
+// First discover metrics: await search.search('http requests')
+// Then execute with known metric name:
+const result = await client.execute('http_requests_total');
+```
+
+##### `executeRange(promql: string, range: TimeRange): Promise<RangeQueryResult>`
+
+Execute a range PromQL query over a time period.
+
+```typescript
+// First discover metrics: await search.search('memory')
+// Then execute with known metric name:
+const result = await client.executeRange('node_memory_MemTotal_bytes', {
+  start: new Date(Date.now() - 3600000), // 1 hour ago
+  end: new Date(),
+  step: '5m',
+});
+
+result.data.forEach(series => {
+  console.log(`Labels: ${JSON.stringify(series.labels)}`);
+  series.samples.forEach(s => {
+    console.log(`  ${new Date(s.time * 1000)}: ${s.value}`);
+  });
+});
+```
+
+##### `listMetrics(): Promise<MetricInfo[]>`
+
+Get raw metric metadata from Prometheus. For semantic search, use `MetricSearchEngine` instead.
+
+```typescript
+const metrics = await client.listMetrics();
+```
+
+##### `labelNames(): Promise<string[]>`
+
+Get all label names.
+
+##### `labelValues(label: string): Promise<string[]>`
+
+Get all values for a specific label.
+
+##### `isHealthy(): Promise<boolean>`
+
+Check if Prometheus is reachable.
+
+### Helper Function
+
+##### `createMetricSearchEngine(endpoint: string): MetricSearchEngine`
+
+Create a MetricSearchEngine directly from an endpoint.
+
+```typescript
+import { createMetricSearchEngine } from '@prodisco/prometheus-client';
+
+const search = createMetricSearchEngine('http://prometheus:9090');
+const metrics = await search.search('disk usage');
+```
+
+## Types
+
+### MetricInfo
+
+```typescript
+interface MetricInfo {
+  name: string;      // Metric name (e.g., "http_requests_total")
+  type: MetricType;  // 'counter' | 'gauge' | 'histogram' | 'summary' | 'unknown'
+  help: string;      // Description
+}
+```
+
+### MetricSearchOptions
+
+```typescript
+interface MetricSearchOptions {
+  limit?: number;    // Max results (default: 20)
+  type?: MetricType; // Filter by metric type
+}
+```
+
+### TimeRange
+
+```typescript
+interface TimeRange {
+  start: Date | number;  // Start time
+  end: Date | number;    // End time
+  step: string;          // Step interval (e.g., "15s", "1m", "5m")
+}
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `PROMETHEUS_URL` | Prometheus server endpoint | - |
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,119 @@
+/**
+ * PrometheusClient - Typed wrapper around prometheus-query library
+ *
+ * IMPORTANT: This client executes PromQL queries. To DISCOVER available metrics,
+ * use MetricSearchEngine.search() first.
+ */
+import type { PrometheusClientOptions, TimeRange, InstantQueryResult, RangeQueryResult, MetricInfo } from './types.js';
+/**
+ * Typed client for executing PromQL queries against Prometheus.
+ *
+ * NOTE: This client runs PromQL expressions. To discover available metrics,
+ * use MetricSearchEngine.search() - it provides semantic search over metric
+ * names and descriptions.
+ */
+export declare class PrometheusClient {
+    private options;
+    private driver;
+    constructor(options: PrometheusClientOptions);
+    /**
+     * Get the Prometheus endpoint URL
+     */
+    getEndpoint(): string;
+    /**
+     * Initialize the Prometheus driver
+     */
+    private getDriver;
+    /**
+     * Execute an instant PromQL query.
+     *
+     * This runs a PromQL expression and returns the current value.
+     * You must already know the metric name - use MetricSearchEngine.search()
+     * to discover available metrics first.
+     *
+     * @param promql - PromQL expression (e.g., "node_memory_MemTotal_bytes")
+     * @param time - Optional evaluation time (defaults to now)
+     * @returns Query result with time series data
+     *
+     * @example
+     * // First discover metrics with MetricSearchEngine.search("memory")
+     * // Then execute with known metric name:
+     * const result = await client.execute("node_memory_MemTotal_bytes");
+     */
+    execute(promql: string, time?: Date): Promise<InstantQueryResult>;
+    /**
+     * Execute a range PromQL query over a time period.
+     *
+     * This runs a PromQL expression over a time range and returns samples.
+     * You must already know the metric name - use MetricSearchEngine.search()
+     * to discover available metrics first.
+     *
+     * @param promql - PromQL expression (e.g., "rate(http_requests_total[5m])")
+     * @param range - Time range with start, end, and step
+     * @returns Query result with time series data
+     *
+     * @example
+     * // First discover metrics with MetricSearchEngine.search("memory")
+     * // Then execute with known metric name:
+     * const result = await client.executeRange("node_memory_MemTotal_bytes", {
+     *   start: new Date(Date.now() - 3600000),
+     *   end: new Date(),
+     *   step: "5m"
+     * });
+     */
+    executeRange(promql: string, range: TimeRange): Promise<RangeQueryResult>;
+    /**
+     * Get all label names
+     */
+    labelNames(): Promise<string[]>;
+    /**
+     * Get all values for a label
+     *
+     * @param label - Label name
+     * @returns Array of label values
+     */
+    labelValues(label: string): Promise<string[]>;
+    /**
+     * Get metric metadata from Prometheus
+     *
+     * @returns Map of metric name to metadata array
+     */
+    metadata(): Promise<Record<string, MetadataEntry[]>>;
+    /**
+     * Get all series matching a set of label matchers
+     *
+     * @param match - Label matcher expressions
+     * @param start - Optional start time
+     * @param end - Optional end time
+     * @returns Array of label sets
+     */
+    series(match: string[], start?: Date, end?: Date): Promise<Record<string, string>[]>;
+    /**
+     * Check if Prometheus is reachable
+     */
+    isHealthy(): Promise<boolean>;
+    /**
+     * List all available metrics from the live Prometheus cluster.
+     *
+     * Returns raw metric metadata. For semantic search (e.g., "memory usage"),
+     * use MetricSearchEngine instead.
+     *
+     * @returns Array of all available metrics with name, type, and description
+     */
+    listMetrics(): Promise<MetricInfo[]>;
+    /**
+     * Parse time series from prometheus-query result
+     */
+    private parseTimeSeries;
+    /**
+     * Parse sample values
+     */
+    private parseSamples;
+}
+interface MetadataEntry {
+    type?: string;
+    help?: string;
+    unit?: string;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAGhB,UAAU,EACX,MAAM,YAAY,CAAC;AAKpB;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,MAAM,CAA6B;gBAE/B,OAAO,EAAE,uBAAuB;IAO5C;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;YACW,SAAS;IAcvB;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAUvE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAa/E;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrC;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKnD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAK1D;;;;;;;OAOG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,CAAC,EAAE,IAAI,EACZ,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAKpC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAWnC;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAgB1C;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,YAAY;CAMrB;AAiBD,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/client.js

@@ -0,0 +1,189 @@
+/**
+ * PrometheusClient - Typed wrapper around prometheus-query library
+ *
+ * IMPORTANT: This client executes PromQL queries. To DISCOVER available metrics,
+ * use MetricSearchEngine.search() first.
+ */
+/**
+ * Typed client for executing PromQL queries against Prometheus.
+ *
+ * NOTE: This client runs PromQL expressions. To discover available metrics,
+ * use MetricSearchEngine.search() - it provides semantic search over metric
+ * names and descriptions.
+ */
+export class PrometheusClient {
+    options;
+    driver = null;
+    constructor(options) {
+        this.options = {
+            timeout: 30000,
+            ...options,
+        };
+    }
+    /**
+     * Get the Prometheus endpoint URL
+     */
+    getEndpoint() {
+        return this.options.endpoint;
+    }
+    /**
+     * Initialize the Prometheus driver
+     */
+    async getDriver() {
+        if (this.driver) {
+            return this.driver;
+        }
+        const { PrometheusDriver } = await import('prometheus-query');
+        this.driver = new PrometheusDriver({
+            endpoint: this.options.endpoint,
+            timeout: this.options.timeout,
+        });
+        return this.driver;
+    }
+    /**
+     * Execute an instant PromQL query.
+     *
+     * This runs a PromQL expression and returns the current value.
+     * You must already know the metric name - use MetricSearchEngine.search()
+     * to discover available metrics first.
+     *
+     * @param promql - PromQL expression (e.g., "node_memory_MemTotal_bytes")
+     * @param time - Optional evaluation time (defaults to now)
+     * @returns Query result with time series data
+     *
+     * @example
+     * // First discover metrics with MetricSearchEngine.search("memory")
+     * // Then execute with known metric name:
+     * const result = await client.execute("node_memory_MemTotal_bytes");
+     */
+    async execute(promql, time) {
+        const driver = await this.getDriver();
+        const result = await driver.instantQuery(promql, time);
+        return {
+            resultType: result.resultType,
+            data: this.parseTimeSeries(result.result),
+        };
+    }
+    /**
+     * Execute a range PromQL query over a time period.
+     *
+     * This runs a PromQL expression over a time range and returns samples.
+     * You must already know the metric name - use MetricSearchEngine.search()
+     * to discover available metrics first.
+     *
+     * @param promql - PromQL expression (e.g., "rate(http_requests_total[5m])")
+     * @param range - Time range with start, end, and step
+     * @returns Query result with time series data
+     *
+     * @example
+     * // First discover metrics with MetricSearchEngine.search("memory")
+     * // Then execute with known metric name:
+     * const result = await client.executeRange("node_memory_MemTotal_bytes", {
+     *   start: new Date(Date.now() - 3600000),
+     *   end: new Date(),
+     *   step: "5m"
+     * });
+     */
+    async executeRange(promql, range) {
+        const driver = await this.getDriver();
+        const start = range.start instanceof Date ? range.start : new Date(range.start * 1000);
+        const end = range.end instanceof Date ? range.end : new Date(range.end * 1000);
+        const result = await driver.rangeQuery(promql, start, end, range.step);
+        return {
+            resultType: 'matrix',
+            data: this.parseTimeSeries(result.result),
+        };
+    }
+    /**
+     * Get all label names
+     */
+    async labelNames() {
+        const driver = await this.getDriver();
+        return driver.labelNames();
+    }
+    /**
+     * Get all values for a label
+     *
+     * @param label - Label name
+     * @returns Array of label values
+     */
+    async labelValues(label) {
+        const driver = await this.getDriver();
+        return driver.labelValues(label);
+    }
+    /**
+     * Get metric metadata from Prometheus
+     *
+     * @returns Map of metric name to metadata array
+     */
+    async metadata() {
+        const driver = await this.getDriver();
+        return driver.metadata();
+    }
+    /**
+     * Get all series matching a set of label matchers
+     *
+     * @param match - Label matcher expressions
+     * @param start - Optional start time
+     * @param end - Optional end time
+     * @returns Array of label sets
+     */
+    async series(match, start, end) {
+        const driver = await this.getDriver();
+        return driver.series(match, start, end);
+    }
+    /**
+     * Check if Prometheus is reachable
+     */
+    async isHealthy() {
+        try {
+            const driver = await this.getDriver();
+            // Try to get label names as a health check
+            await driver.labelNames();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * List all available metrics from the live Prometheus cluster.
+     *
+     * Returns raw metric metadata. For semantic search (e.g., "memory usage"),
+     * use MetricSearchEngine instead.
+     *
+     * @returns Array of all available metrics with name, type, and description
+     */
+    async listMetrics() {
+        const allMetadata = await this.metadata();
+        const metrics = [];
+        for (const [name, entries] of Object.entries(allMetadata)) {
+            const entry = Array.isArray(entries) ? entries[0] : entries;
+            metrics.push({
+                name,
+                type: entry?.type || 'unknown',
+                help: entry?.help || 'No description available',
+            });
+        }
+        return metrics;
+    }
+    /**
+     * Parse time series from prometheus-query result
+     */
+    parseTimeSeries(result) {
+        return result.map((series) => ({
+            labels: series.metric.labels || {},
+            samples: this.parseSamples(series.values || (series.value ? [series.value] : [])),
+        }));
+    }
+    /**
+     * Parse sample values
+     */
+    parseSamples(values) {
+        return values.filter((v) => v !== undefined).map((v) => ({
+            time: typeof v.time === 'number' ? v.time : v.time.getTime() / 1000,
+            value: typeof v.value === 'string' ? parseFloat(v.value) : v.value,
+        }));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @prodisco/prometheus-client
+ *
+ * Typed Prometheus client with semantic metric discovery for AI agents
+ */
+export { PrometheusClient } from './client.js';
+export { MetricSearchEngine, createMetricSearchEngine, type MetricSearchOptions, } from './metrics.js';
+export type { MetricType, MetricInfo, MetricMetadata, PrometheusClientOptions, TimeRange, Sample, TimeSeries, InstantQueryResult, RangeQueryResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,uBAAuB,EACvB,SAAS,EACT,MAAM,EACN,UAAU,EACV,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @prodisco/prometheus-client
+ *
+ * Typed Prometheus client with semantic metric discovery for AI agents
+ */
+// Client
+export { PrometheusClient } from './client.js';
+// Metric search
+export { MetricSearchEngine, createMetricSearchEngine, } from './metrics.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS;AACT,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,gBAAgB;AAChB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,cAAc,CAAC"}

package/dist/metrics.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Metric search engine using Orama for semantic search
+ *
+ * Indexes live Prometheus metrics and enables semantic search
+ * by name and description, not just regex pattern matching.
+ */
+import type { MetricInfo, MetricType } from './types.js';
+import { PrometheusClient } from './client.js';
+/**
+ * Search options for finding metrics
+ */
+export interface MetricSearchOptions {
+    /** Maximum number of results (default: 20) */
+    limit?: number;
+    /** Filter by metric type */
+    type?: MetricType;
+}
+/**
+ * MetricSearchEngine - Semantic search for Prometheus metrics
+ *
+ * Uses Orama search engine to index metric names and descriptions,
+ * enabling natural language search like "memory consumption" instead
+ * of requiring exact metric names.
+ */
+export declare class MetricSearchEngine {
+    private client;
+    private searchEngine;
+    private indexed;
+    private indexedCount;
+    private lastIndexTime;
+    /** Cache TTL in milliseconds (5 minutes) */
+    private static readonly CACHE_TTL_MS;
+    constructor(client: PrometheusClient);
+    /**
+     * Index all metrics from Prometheus into the search engine.
+     *
+     * @param force - Force re-indexing even if cache is valid
+     */
+    index(force?: boolean): Promise<number>;
+    /**
+     * Search for metrics using natural language.
+     *
+     * Examples:
+     * - "memory usage" → finds container_memory_usage_bytes, etc.
+     * - "http requests" → finds http_requests_total, etc.
+     * - "cpu" → finds all CPU-related metrics
+     *
+     * @param query - Natural language search query
+     * @param options - Search options (limit, type filter)
+     * @returns Ranked list of matching metrics
+     */
+    search(query: string, options?: MetricSearchOptions): Promise<MetricInfo[]>;
+    /**
+     * List all indexed metrics
+     */
+    list(options?: MetricSearchOptions): Promise<MetricInfo[]>;
+    getIndexedCount(): number;
+    isReady(): boolean;
+    clear(): Promise<void>;
+}
+/**
+ * Create a MetricSearchEngine from a Prometheus endpoint
+ */
+export declare function createMetricSearchEngine(endpoint: string): MetricSearchEngine;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAuB;IAE5C,4CAA4C;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAiB;gBAEzC,MAAM,EAAE,gBAAgB;IAUpC;;;;OAIG;IACG,KAAK,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAoD3C;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAoBrF;;OAEG;IACG,IAAI,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAoBpE,eAAe,IAAI,MAAM;IAIzB,OAAO,IAAI,OAAO;IAIZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAG7E"}

package/dist/metrics.js

@@ -0,0 +1,150 @@
+/**
+ * Metric search engine using Orama for semantic search
+ *
+ * Indexes live Prometheus metrics and enables semantic search
+ * by name and description, not just regex pattern matching.
+ */
+import { SearchEngine } from '@prodisco/search-libs';
+import { PrometheusClient } from './client.js';
+/**
+ * MetricSearchEngine - Semantic search for Prometheus metrics
+ *
+ * Uses Orama search engine to index metric names and descriptions,
+ * enabling natural language search like "memory consumption" instead
+ * of requiring exact metric names.
+ */
+export class MetricSearchEngine {
+    client;
+    searchEngine;
+    indexed = false;
+    indexedCount = 0;
+    lastIndexTime = null;
+    /** Cache TTL in milliseconds (5 minutes) */
+    static CACHE_TTL_MS = 5 * 60 * 1000;
+    constructor(client) {
+        this.client = client;
+        this.searchEngine = new SearchEngine({
+            tokenizerOptions: {
+                stemming: true,
+                stemmerSkipProperties: ['name'],
+            },
+        });
+    }
+    /**
+     * Index all metrics from Prometheus into the search engine.
+     *
+     * @param force - Force re-indexing even if cache is valid
+     */
+    async index(force = false) {
+        // Check if cache is still valid
+        if (!force && this.indexed && this.lastIndexTime) {
+            const elapsed = Date.now() - this.lastIndexTime;
+            if (elapsed < MetricSearchEngine.CACHE_TTL_MS) {
+                return this.indexedCount;
+            }
+        }
+        // Fetch all metrics from Prometheus
+        const metrics = await this.client.listMetrics();
+        // Build documents for indexing
+        const docs = metrics.map((m) => ({
+            id: `metric:${m.name}`,
+            documentType: 'metric',
+            name: m.name,
+            description: m.help,
+            searchTokens: `${m.name.replace(/_/g, ' ')} ${m.type} ${m.help}`,
+            library: 'prometheus',
+            category: m.type,
+            properties: '',
+            typeDefinition: '',
+            nestedTypes: '',
+            typeKind: '',
+            parameters: '',
+            returnType: '',
+            returnTypeDefinition: '',
+            signature: '',
+            className: '',
+            filePath: '',
+            keywords: m.type,
+        }));
+        // Re-initialize search engine for fresh index
+        this.searchEngine = new SearchEngine({
+            tokenizerOptions: {
+                stemming: true,
+                stemmerSkipProperties: ['name'],
+            },
+        });
+        await this.searchEngine.initialize();
+        await this.searchEngine.insertBatch(docs);
+        this.indexed = true;
+        this.indexedCount = docs.length;
+        this.lastIndexTime = Date.now();
+        return this.indexedCount;
+    }
+    /**
+     * Search for metrics using natural language.
+     *
+     * Examples:
+     * - "memory usage" → finds container_memory_usage_bytes, etc.
+     * - "http requests" → finds http_requests_total, etc.
+     * - "cpu" → finds all CPU-related metrics
+     *
+     * @param query - Natural language search query
+     * @param options - Search options (limit, type filter)
+     * @returns Ranked list of matching metrics
+     */
+    async search(query, options = {}) {
+        const { limit = 20, type } = options;
+        if (!this.indexed) {
+            await this.index();
+        }
+        const result = await this.searchEngine.search({
+            query,
+            limit,
+            category: type,
+        });
+        return result.results.map((doc) => ({
+            name: doc.name,
+            type: doc.category || 'unknown',
+            help: doc.description,
+        }));
+    }
+    /**
+     * List all indexed metrics
+     */
+    async list(options = {}) {
+        const { limit = 100, type } = options;
+        if (!this.indexed) {
+            await this.index();
+        }
+        const result = await this.searchEngine.search({
+            query: '',
+            limit,
+            category: type,
+        });
+        return result.results.map((doc) => ({
+            name: doc.name,
+            type: doc.category || 'unknown',
+            help: doc.description,
+        }));
+    }
+    getIndexedCount() {
+        return this.indexedCount;
+    }
+    isReady() {
+        return this.indexed;
+    }
+    async clear() {
+        await this.searchEngine.shutdown();
+        this.indexed = false;
+        this.indexedCount = 0;
+        this.lastIndexTime = null;
+    }
+}
+/**
+ * Create a MetricSearchEngine from a Prometheus endpoint
+ */
+export function createMetricSearchEngine(endpoint) {
+    const client = new PrometheusClient({ endpoint });
+    return new MetricSearchEngine(client);
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Types for Prometheus client
+ */
+/**
+ * Metric type as reported by Prometheus
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram' | 'summary' | 'unknown';
+/**
+ * Information about a Prometheus metric
+ */
+export interface MetricInfo {
+    /** Metric name (e.g., "http_requests_total") */
+    name: string;
+    /** Metric type (counter, gauge, histogram, summary) */
+    type: MetricType;
+    /** Help text / description */
+    help: string;
+}
+/**
+ * Metadata for a metric as returned by Prometheus API
+ */
+export interface MetricMetadata {
+    type?: string;
+    help?: string;
+    unit?: string;
+}
+/**
+ * Options for creating PrometheusClient
+ */
+export interface PrometheusClientOptions {
+    /** Prometheus server endpoint (e.g., "http://prometheus:9090") */
+    endpoint: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Custom headers for requests */
+    headers?: Record<string, string>;
+}
+/**
+ * Time range for range queries
+ */
+export interface TimeRange {
+    /** Start time (Date or Unix timestamp in seconds) */
+    start: Date | number;
+    /** End time (Date or Unix timestamp in seconds) */
+    end: Date | number;
+    /** Step interval (e.g., "15s", "1m", "5m") */
+    step: string;
+}
+/**
+ * A single sample point in a time series
+ */
+export interface Sample {
+    /** Unix timestamp in seconds */
+    time: number;
+    /** Metric value */
+    value: number;
+}
+/**
+ * A time series with labels and samples
+ */
+export interface TimeSeries {
+    /** Metric labels */
+    labels: Record<string, string>;
+    /** Sample values */
+    samples: Sample[];
+}
+/**
+ * Result of an instant query
+ */
+export interface InstantQueryResult {
+    /** Result type (vector, matrix, scalar, string) */
+    resultType: 'vector' | 'matrix' | 'scalar' | 'string';
+    /** Time series data */
+    data: TimeSeries[];
+}
+/**
+ * Result of a range query
+ */
+export interface RangeQueryResult {
+    /** Result type (always matrix for range queries) */
+    resultType: 'matrix';
+    /** Time series data with multiple samples */
+    data: TimeSeries[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IAEb,uDAAuD;IACvD,IAAI,EAAE,UAAU,CAAC;IAEjB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IAEjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qDAAqD;IACrD,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC;IAErB,mDAAmD;IACnD,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;IAEnB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B,oBAAoB;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAEtD,uBAAuB;IACvB,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,UAAU,EAAE,QAAQ,CAAC;IAErB,6CAA6C;IAC7C,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for Prometheus client
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@prodisco/prometheus-client",
+  "version": "0.1.1",
+  "description": "Typed Prometheus client with metric discovery for AI agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "prometheus",
+    "metrics",
+    "monitoring",
+    "typescript",
+    "ai-agents"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@prodisco/search-libs": "*",
+    "prometheus-query": "^3.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.15"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}