@adonis-agora/telescope 0.4.0 → 0.5.0

package/dist/src/mcp/server.d.ts

@@ -0,0 +1,89 @@
+import { type Entry } from '../entry.js';
+import type { MetricsService } from '../metrics/metrics_service.js';
+import type { TelescopeService } from '../service.js';
+import { type McpToolName } from './define_config.js';
+/** JSON-RPC error code for an unauthorized request (there is no transport 401 in MCP). */
+export declare const MCP_UNAUTHORIZED = -32001;
+/** JSON-RPC "method not found". */
+export declare const MCP_METHOD_NOT_FOUND = -32601;
+/** JSON-RPC "internal error" — a tool handler threw. */
+export declare const MCP_INTERNAL_ERROR = -32603;
+/** One entry in the MCP tool catalogue (name + human description + JSON-Schema for args). */
+export interface McpToolSpec {
+    name: McpToolName;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * The full tool catalogue. `tools/list` returns the subset the config enables;
+ * `tools/call` dispatches on `name`. Keep the descriptions agent-facing — they are
+ * what a coding agent (Claude Code, Cursor, …) reads to decide which tool to call.
+ */
+export declare const MCP_TOOLS: readonly McpToolSpec[];
+/** A parsed JSON-RPC request body (all fields optional so a malformed body is handled, not thrown). */
+export interface JsonRpcRequest {
+    jsonrpc?: string;
+    id?: string | number | null;
+    method?: string;
+    params?: {
+        protocolVersion?: string;
+        name?: string;
+        arguments?: Record<string, unknown>;
+    };
+}
+/** Optional AI diagnosis hook — resolves the diagnosis markdown, or `null` when AI is off. */
+export type DiagnoseExceptionHook = (entry: Entry) => Promise<string | null> | string | null;
+/** Construction deps for {@link TelescopeMcpServer}. */
+export interface TelescopeMcpServerOptions {
+    /** Which tools this server exposes. Omit for all. */
+    tools?: ReadonlySet<McpToolName>;
+    /** `serverInfo` reported on `initialize`. */
+    serverInfo?: {
+        name: string;
+        version: string;
+    };
+    /**
+     * AI diagnosis hook backing `diagnose_exception`. When omitted, the tool reports
+     * that AI diagnosis is not configured (rather than failing), mirroring the
+     * default-open dashboard posture.
+     */
+    diagnose?: DiagnoseExceptionHook;
+}
+/**
+ * MCP (Model Context Protocol) server — a stateless JSON-RPC surface — so a coding
+ * agent can query the app's captured telemetry: "why is POST /checkout slow?" → the
+ * agent lists slow requests, pulls the trace waterfall, reads the queries.
+ *
+ * Hand-rolled JSON-RPC (no SDK dependency), backed by the SAME
+ * {@link TelescopeService} / {@link MetricsService} / Pulse APIs the dashboard uses,
+ * so analysis reads already-redacted, already-sampled stored entries — redaction is
+ * never bypassed. Idiomatic Adonis: a plain, testable class with no framework
+ * coupling; the provider owns the HTTP transport and the auth guard, and hands this
+ * server a pre-computed `authorized` flag per call.
+ */
+export declare class TelescopeMcpServer {
+    private readonly service;
+    private readonly metrics;
+    private readonly tools;
+    private readonly serverInfo;
+    private readonly diagnose;
+    constructor(service: TelescopeService, metrics: MetricsService, options?: TelescopeMcpServerOptions);
+    /** The enabled tool catalogue (what `tools/list` returns), in declaration order. */
+    toolCatalogue(): McpToolSpec[];
+    /**
+     * Handle one JSON-RPC request. `authorized` is the outcome of the transport's
+     * auth guard: when `false`, every method is refused with a JSON-RPC `-32001`
+     * error (MCP has no transport-level 401, so the denial rides inside the RPC
+     * envelope where a compliant client can read it). Notifications (no `id`) resolve
+     * to `null` — the caller answers `202` with no body.
+     */
+    handle(body: JsonRpcRequest, authorized: boolean): Promise<unknown>;
+    private respond;
+    private fail;
+    private callTool;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/src/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQtE,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC3F;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,WAAW,EAuE3C,CAAC;AAEF,uGAAuG;AACvG,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QACP,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACH;AAYD,8FAA8F;AAC9F,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;AAE7F,wDAAwD;AACxD,MAAM,WAAW,yBAAyB;IACxC,qDAAqD;IACrD,KAAK,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IACjC,6CAA6C;IAC7C,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAM3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;gBAG1C,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,EACxC,OAAO,GAAE,yBAA8B;IAOzC,oFAAoF;IACpF,aAAa,IAAI,WAAW,EAAE;IAI9B;;;;;;OAMG;IACG,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAgCzE,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,IAAI;YAIE,QAAQ;CAmEvB"}

package/dist/src/mcp/server.js

@@ -0,0 +1,279 @@
+import { EntryType } from '../entry.js';
+import { MCP_TOOL_NAMES } from './define_config.js';
+/** The MCP protocol revision this server advertises when a client omits its own. */
+const PROTOCOL_VERSION = '2025-06-18';
+const DEFAULT_LIST_LIMIT = 20;
+const MAX_LIST_LIMIT = 100;
+const DEFAULT_HEALTH_WINDOW_MS = 60 * 60_000;
+/** JSON-RPC error code for an unauthorized request (there is no transport 401 in MCP). */
+export const MCP_UNAUTHORIZED = -32001;
+/** JSON-RPC "method not found". */
+export const MCP_METHOD_NOT_FOUND = -32601;
+/** JSON-RPC "internal error" — a tool handler threw. */
+export const MCP_INTERNAL_ERROR = -32603;
+/**
+ * The full tool catalogue. `tools/list` returns the subset the config enables;
+ * `tools/call` dispatches on `name`. Keep the descriptions agent-facing — they are
+ * what a coding agent (Claude Code, Cursor, …) reads to decide which tool to call.
+ */
+export const MCP_TOOLS = [
+    {
+        name: 'list_entries',
+        description: 'List recent telescope entries (requests, queries, exceptions, diagnostics, jobs, logs, …). Filter by type, full-text search, tag, or time window. Returns newest first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    description: 'Entry type: request, query, exception, client_exception, log, event, mail, job, cache, http-client, redis, diagnostic…',
+                },
+                search: { type: 'string', description: 'Case-insensitive substring over entry content + tags' },
+                tag: { type: 'string', description: 'Exact tag match, e.g. "status:500" or "lib:billing"' },
+                sinceMinutes: { type: 'number', description: 'Only entries from the last N minutes' },
+                limit: { type: 'number', description: 'Max entries (default 20, max 100)' },
+            },
+        },
+    },
+    {
+        name: 'get_entry',
+        description: 'Get one entry by id, together with the other entries recorded in the same trace (its siblings) — the request/job waterfall context.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Entry id' } },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'get_trace',
+        description: 'Get every entry recorded under one trace id (one request/job execution), newest-first — queries, logs, diagnostics, the request itself.',
+        inputSchema: {
+            type: 'object',
+            properties: { traceId: { type: 'string', description: 'Trace id' } },
+            required: ['traceId'],
+        },
+    },
+    {
+        name: 'get_waterfall',
+        description: 'Get the span waterfall for one trace: each recorded operation as a start/duration span, ordered, so you can see what ran (and how long) inside a request.',
+        inputSchema: {
+            type: 'object',
+            properties: { traceId: { type: 'string', description: 'Trace id' } },
+            required: ['traceId'],
+        },
+    },
+    {
+        name: 'get_health',
+        description: 'Aggregate Pulse health snapshot over a trailing window (default 1h): request throughput + latency percentiles, slowest requests/queries, slow-route/outgoing/job hotspots, N+1 suspects, top exception families, cache hit rate, load-by-user.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sinceMinutes: { type: 'number', description: 'Trailing window in minutes (default 60)' },
+            },
+        },
+    },
+    {
+        name: 'diagnose_exception',
+        description: 'Run the AI diagnosis on an exception entry (probable cause, where to look, suggested fix). Only available when AI diagnosis is configured on this telescope.',
+        inputSchema: {
+            type: 'object',
+            properties: { id: { type: 'string', description: 'Exception entry id' } },
+            required: ['id'],
+        },
+    },
+];
+/**
+ * MCP (Model Context Protocol) server — a stateless JSON-RPC surface — so a coding
+ * agent can query the app's captured telemetry: "why is POST /checkout slow?" → the
+ * agent lists slow requests, pulls the trace waterfall, reads the queries.
+ *
+ * Hand-rolled JSON-RPC (no SDK dependency), backed by the SAME
+ * {@link TelescopeService} / {@link MetricsService} / Pulse APIs the dashboard uses,
+ * so analysis reads already-redacted, already-sampled stored entries — redaction is
+ * never bypassed. Idiomatic Adonis: a plain, testable class with no framework
+ * coupling; the provider owns the HTTP transport and the auth guard, and hands this
+ * server a pre-computed `authorized` flag per call.
+ */
+export class TelescopeMcpServer {
+    service;
+    metrics;
+    tools;
+    serverInfo;
+    diagnose;
+    constructor(service, metrics, options = {}) {
+        this.service = service;
+        this.metrics = metrics;
+        this.tools = options.tools ?? new Set(MCP_TOOL_NAMES);
+        this.serverInfo = options.serverInfo ?? { name: 'adonis-telescope', version: '0.0.0' };
+        this.diagnose = options.diagnose;
+    }
+    /** The enabled tool catalogue (what `tools/list` returns), in declaration order. */
+    toolCatalogue() {
+        return MCP_TOOLS.filter((tool) => this.tools.has(tool.name));
+    }
+    /**
+     * Handle one JSON-RPC request. `authorized` is the outcome of the transport's
+     * auth guard: when `false`, every method is refused with a JSON-RPC `-32001`
+     * error (MCP has no transport-level 401, so the denial rides inside the RPC
+     * envelope where a compliant client can read it). Notifications (no `id`) resolve
+     * to `null` — the caller answers `202` with no body.
+     */
+    async handle(body, authorized) {
+        const { id, method, params } = body ?? {};
+        if (!authorized) {
+            return this.fail(id, MCP_UNAUTHORIZED, 'Unauthorized: telescope MCP access was denied.');
+        }
+        try {
+            switch (method) {
+                case 'initialize':
+                    return this.respond(id, {
+                        protocolVersion: params?.protocolVersion ?? PROTOCOL_VERSION,
+                        capabilities: { tools: {} },
+                        serverInfo: this.serverInfo,
+                    });
+                case 'notifications/initialized':
+                case 'notifications/cancelled':
+                    return null;
+                case 'ping':
+                    return this.respond(id, {});
+                case 'tools/list':
+                    return this.respond(id, { tools: this.toolCatalogue() });
+                case 'tools/call': {
+                    const text = await this.callTool(params?.name, (params?.arguments ?? {}));
+                    return this.respond(id, { content: [{ type: 'text', text }] });
+                }
+                default:
+                    return this.fail(id, MCP_METHOD_NOT_FOUND, `Method not found: ${String(method)}`);
+            }
+        }
+        catch (error) {
+            return this.fail(id, MCP_INTERNAL_ERROR, error instanceof Error ? error.message : String(error));
+        }
+    }
+    respond(id, result) {
+        return id === undefined || id === null ? null : { jsonrpc: '2.0', id, result };
+    }
+    fail(id, code, message) {
+        return id === undefined || id === null ? null : { jsonrpc: '2.0', id, error: { code, message } };
+    }
+    async callTool(name, args) {
+        if (name !== undefined && !this.tools.has(name)) {
+            throw new Error(`Tool not enabled: ${name}`);
+        }
+        switch (name) {
+            case 'list_entries': {
+                const query = {
+                    ...(args.type !== undefined ? { type: args.type } : {}),
+                    ...(args.search !== undefined && args.search !== '' ? { search: args.search } : {}),
+                    ...(args.tag !== undefined ? { tag: args.tag } : {}),
+                    ...(typeof args.sinceMinutes === 'number'
+                        ? { after: new Date(Date.now() - args.sinceMinutes * 60_000) }
+                        : {}),
+                    limit: clampLimit(args.limit),
+                };
+                const entries = await this.service.list(query);
+                return json({ entries: entries.map(slim) });
+            }
+            case 'get_entry': {
+                if (typeof args.id !== 'string')
+                    throw new Error('`id` is required.');
+                const entry = await this.service.find(args.id);
+                if (entry === null)
+                    return 'Entry not found (it may have been pruned).';
+                const siblings = entry.traceId !== null
+                    ? (await this.service.byTrace(entry.traceId)).filter((e) => e.id !== entry.id)
+                    : [];
+                return json({ entry, trace: siblings.map(slim) });
+            }
+            case 'get_trace': {
+                if (typeof args.traceId !== 'string')
+                    throw new Error('`traceId` is required.');
+                const entries = await this.service.byTrace(args.traceId);
+                if (entries.length === 0)
+                    return 'Trace not found (it may have been pruned).';
+                return json({ entries });
+            }
+            case 'get_waterfall': {
+                if (typeof args.traceId !== 'string')
+                    throw new Error('`traceId` is required.');
+                const waterfall = await this.metrics.getWaterfall(args.traceId);
+                if (waterfall === null)
+                    return 'Trace not found (it may have been pruned).';
+                return json(waterfall);
+            }
+            case 'get_health': {
+                const windowMs = typeof args.sinceMinutes === 'number' && args.sinceMinutes > 0
+                    ? args.sinceMinutes * 60_000
+                    : DEFAULT_HEALTH_WINDOW_MS;
+                const health = await this.service.getHealth({ windowMs });
+                return json(health);
+            }
+            case 'diagnose_exception': {
+                if (typeof args.id !== 'string')
+                    throw new Error('`id` is required.');
+                if (this.diagnose === undefined) {
+                    return 'AI diagnosis is not configured on this telescope.';
+                }
+                const entry = await this.service.find(args.id);
+                if (entry === null ||
+                    (entry.type !== EntryType.Exception && entry.type !== EntryType.ClientException)) {
+                    return 'No exception entry with that id.';
+                }
+                const markdown = await this.diagnose(entry);
+                return markdown ?? 'AI diagnosis returned no result.';
+            }
+            default:
+                throw new Error(`Unknown tool: ${String(name)}`);
+        }
+    }
+}
+function json(value) {
+    return JSON.stringify(value, null, 2);
+}
+function clampLimit(limit) {
+    if (typeof limit !== 'number' || !Number.isFinite(limit))
+        return DEFAULT_LIST_LIMIT;
+    return Math.max(1, Math.min(Math.floor(limit), MAX_LIST_LIMIT));
+}
+/** Compact projection for list payloads — agents drill in via `get_entry`/`get_trace`. */
+function slim(entry) {
+    const c = (entry.content ?? {});
+    let summary;
+    switch (entry.type) {
+        case EntryType.Request:
+            summary = `${String(c.method)} ${String(c.url)} → ${String(c.status)}`;
+            break;
+        case EntryType.Query:
+            summary = String(c.sql ?? '').slice(0, 200);
+            break;
+        case EntryType.Exception:
+        case EntryType.ClientException:
+            summary = `${String(c.name ?? c.class)}: ${String(c.message)}`;
+            break;
+        case EntryType.Log:
+            summary = `${String(c.level)}: ${String(c.message)}`;
+            break;
+        case EntryType.Job:
+            summary = `${String(c.name)} (${String(c.status)})`;
+            break;
+        default:
+            summary = safeSummary(c, entry.type);
+    }
+    return {
+        id: entry.id,
+        type: entry.type,
+        traceId: entry.traceId,
+        durationMs: entry.durationMs,
+        createdAt: entry.createdAt instanceof Date ? entry.createdAt.toISOString() : entry.createdAt,
+        tags: entry.tags,
+        summary,
+    };
+}
+function safeSummary(content, type) {
+    try {
+        return JSON.stringify(content).slice(0, 200);
+    }
+    catch {
+        return type;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/src/mcp/server.js.map

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

package/dist/src/metrics/pulse.d.ts

@@ -0,0 +1,158 @@
+import { type Entry } from '../entry.js';
+import type { TelescopeStore } from '../store.js';
+import { type CacheStats, type LatencyStats, type StatusBreakdown } from './stats.js';
+import { type TimeseriesReport } from './timeseries.js';
+/** The togglable pulse cards. `counts` and the window meta are always present. */
+export declare const PULSE_CARDS: readonly ["throughput", "requests", "cache", "slowest", "slowRoutes", "slowOutgoing", "slowJobs", "exceptions", "nPlusOne", "loadByUser"];
+export type PulseCardName = (typeof PULSE_CARDS)[number];
+/** A single slow entry across all types, labelled from its content. */
+export interface PulseSlowEntry {
+    id: string;
+    type: string;
+    durationMs: number;
+    label: string;
+    traceId: string | null;
+}
+/** A grouped exception family (mirrors {@link summarizeStats}'s exception groups). */
+export interface PulseExceptionGroup {
+    key: string;
+    class: string;
+    message: string;
+    count: number;
+    /** ISO timestamp of the most recent occurrence in the window. */
+    lastSeen: string;
+}
+/** A consistently-slow family (request route, outgoing target, or job), by p99. */
+export interface PulseHotspot {
+    /** The family label — the entry's `familyHash` (or a content-derived fallback). */
+    route: string;
+    count: number;
+    p99: number;
+    p50: number;
+}
+/** An N+1 query hotspot aggregated across traces. */
+export interface PulseNPlusOne {
+    familyHash: string;
+    sql: string;
+    /** Worst (max) repetition count of this family within a single trace. */
+    perRequest: number;
+    /** Number of distinct traces where this family tripped the threshold. */
+    traces: number;
+    /** Sum of repetition counts across those traces. */
+    total: number;
+    /** Total duration (ms) spent across all occurrences — the time "wasted" in the loop. */
+    totalDurationMs: number;
+    /** One trace id (the worst) to deep-link to. */
+    sampleTraceId: string;
+}
+/** A user's share of the load in the window (from the `user:<id>` request tag). */
+export interface PulseUserLoad {
+    user: string;
+    count: number;
+    totalDurationMs: number;
+}
+/** Overall throughput over the window. */
+export interface PulseThroughput {
+    /** Entries recorded in the window. */
+    total: number;
+    /** Entries per minute across the window. */
+    perMinute: number;
+    /** Per-bucket throughput — reuses {@link bucketTimeseries}. */
+    overTime: TimeseriesReport;
+}
+/** Request health: volume, error rate, HTTP status breakdown, and latency. */
+export interface PulseRequestHealth {
+    total: number;
+    /** Share of requests that returned a 4xx or 5xx (`0`–`1`). */
+    errorRate: number;
+    status: StatusBreakdown;
+    /** Present only when at least one request carried a `durationMs`. */
+    latency?: LatencyStats;
+}
+/** The aggregated pulse rollup returned by {@link PulseService.getHealth}. */
+export interface PulseSummary {
+    windowStart: string;
+    windowEnd: string;
+    windowMs: number;
+    /** Per-type entry counts over the window. */
+    counts: Record<string, number>;
+    throughput: PulseThroughput;
+    requests: PulseRequestHealth;
+    /** Present only when the `cache` card is enabled and cache entries exist. */
+    cache?: CacheStats;
+    slowest: PulseSlowEntry[];
+    slowRoutes: PulseHotspot[];
+    slowOutgoing: PulseHotspot[];
+    slowJobs: PulseHotspot[];
+    topExceptions: PulseExceptionGroup[];
+    nPlusOne: PulseNPlusOne[];
+    loadByUser: PulseUserLoad[];
+    /** Entries scanned to build this summary. */
+    scanned: number;
+    /** Whether the scan hit its cap (results may be incomplete). */
+    truncated: boolean;
+}
+/** Fully-resolved pulse options the pure aggregator acts on. */
+export interface PulseOptions {
+    topN: number;
+    buckets: number;
+    slowMs: number;
+    slowRouteMs: number;
+    hotspotMinCount: number;
+    nPlusOneThreshold: number;
+    cards: ReadonlySet<PulseCardName>;
+}
+/**
+ * Aggregate a window of entries — each carrying its `content` — into a
+ * {@link PulseSummary}. Pure: callers fetch the windowed entries and supply the
+ * window bounds. Reuses {@link summarizeStats}, {@link bucketTimeseries},
+ * {@link percentile}, and {@link detectNPlusOne} for the heavy lifting.
+ */
+export declare function summarizePulse(entries: Entry[], windowStart: Date, windowEnd: Date, options: PulseOptions, truncated?: boolean): PulseSummary;
+/** Per-call / per-instance pulse tuning (all optional; sensible defaults). */
+export interface PulseServiceOptions {
+    /** Trailing window (ms) the summary aggregates over. Default 3_600_000 (1h). */
+    windowMs?: number;
+    /** How many rows each top-N list returns. Default 5. */
+    topN?: number;
+    /** Throughput/over-time bucket count. Default 60 (clamped 1–500). */
+    buckets?: number;
+    /** Latency "slow" threshold (ms). Default 100. */
+    slowMs?: number;
+    /** Min p99 (ms) for a route/outgoing family to count as a hotspot. Default 1000. */
+    slowRouteMs?: number;
+    /** Min samples a family needs to rank as a hotspot. Default 1. */
+    hotspotMinCount?: number;
+    /** Min repetitions of one query template within a trace to flag N+1. Default 5. */
+    nPlusOneThreshold?: number;
+    /** Which cards to compute. Omit for all. */
+    cards?: readonly PulseCardName[];
+    /** Safety cap on entries scanned per pulse. Default 50000. */
+    scanCap?: number;
+}
+/** A per-call override of the window (and, optionally, top-N). */
+export interface PulseQuery {
+    windowMs?: number;
+    topN?: number;
+}
+/**
+ * Read-only Pulse rollup over a {@link TelescopeStore}. Storage-agnostic — it
+ * reads the store (the source of truth) on demand through the newest-first
+ * {@link TelescopeStore.list} contract, never a specific provider, and never a
+ * live counter. Analysis reads ALREADY-redacted stored entries, so redaction is
+ * never bypassed. Idiomatic Adonis: a plain class, no DI decorators (constructed
+ * by the provider / {@link TelescopeService}, exactly like {@link import('./metrics_service.js').MetricsService}).
+ */
+export declare class PulseService {
+    private readonly store;
+    private readonly windowMs;
+    private readonly scanCap;
+    private readonly base;
+    constructor(store: TelescopeStore, options?: PulseServiceOptions);
+    /**
+     * Build the health snapshot over the trailing window. `query.windowMs` /
+     * `query.topN` override the configured defaults for a single call.
+     */
+    getHealth(query?: PulseQuery): Promise<PulseSummary>;
+}
+//# sourceMappingURL=pulse.d.ts.map

package/dist/src/metrics/pulse.d.ts.map

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