qyl-mcp-server 7.6.1 → 8.0.0

package/README.md

@@ -5,8 +5,8 @@ logs, metrics, sessions and CI runs, plus the Trace Explorer and MCP Dashboard
 viewers for hosts that render MCP Apps.
 
 ```bash
-npx qyl-mcp-server --stdio    # stdio MCP server
-npx qyl-mcp-server            # Streamable HTTP on 127.0.0.1:3001
+bunx qyl-mcp-server --stdio    # stdio MCP server
+bunx qyl-mcp-server      # Streamable HTTP on 127.0.0.1:3001
 ```
 
 Use a modern or 2025-era MCP client. Point it at a collector:
@@ -27,7 +27,6 @@ its own.
 Both use MCP TypeScript SDK v2: Streamable HTTP through `createMcpHandler`
 and stdio through `serveStdio`, with their documented compatibility defaults.
 One factory serves revision `2026-07-28` and supported 2025-era requests.
-Events require `2026-07-28`.
 The HTTP server serves a product page at `/`; `/mcp` is the only protocol
 endpoint.
 
@@ -39,7 +38,8 @@ with PKCE S256, both `private_key_jwt` and `none` for ChatGPT CIMD compatibility
 issuance; this server validates resource-bound RFC 9068 access tokens on every
 MCP request. It rejects malformed/query credentials, invalid tokens and
 insufficient scopes with distinct 400/401/403 responses. Every request needs
-`qyl:read`; a write tool called without `qyl:write` or `qyl:delete` gets a
+`qyl:read`. The initial 401 requests `qyl:read qyl:write qyl:delete` so new
+connections can authorize the complete tool set. A write tool called without `qyl:write` or `qyl:delete` gets a
 `403` with `error="insufficient_scope"` naming the scopes to request, in both
 protocol eras, before the handler runs.
 
@@ -63,81 +63,55 @@ an enabled module proves a client has been provisioned.
 
 ## Tools
 
-**Telemetry** — `list_traces`, `get_trace`, `list_sessions`, `search_logs`,
-`ci_log`, `display_traces`, `display_mcp_dashboard`.
-
-`list_traces` filters by a `start_time`/`end_time` window (RFC 3339, start
-inclusive, end exclusive), `service_name` (traces with a span from that
-service) and `errors_only`. `list_sessions` filters by `active_only` and the
-same window on the session start. `search_logs` filters by `trace_id`,
-`session_id`, `service_name`, `severity_min`, a body substring `query` and the
-window. Every list tool pages the same way: the output carries `has_more` and,
-when more exist, `next_cursor`; pass it back as `cursor` with the same filters
-for the next page. A cursor is opaque; one that is not ours is refused with
-`invalid_argument` rather than answered with the first page again.
-
-`get_trace` returns every span by default. `errors_only` selects error spans;
-`max_spans` (1–1000) caps the result after filtering in Collector order.
-`include_attributes=false` omits span, resource, event, link and instrumentation
-scope attribute collections, including any returned root-span copy. Trace
-totals remain the Collector's totals; the text reports matching and returned
-counts. `ci_log.service_prefix` is case-sensitive, defaults to `qyl-ci`, and
-filters both recent runs and individual phase spans.
-
-**Metrics** — `list_metrics`, `get_metric_series`, `query_metric`. Read in that
-order: the catalog gives you an exact instrument name and how many attribute
-streams it has, series discovery tells you which attribute keys are worth
-grouping or filtering on, and the range query answers the actual question —
-a window, a bucket width in whole milliseconds (`step_ms`), a reducer (`avg`,
-`min`, `max`, `sum`, `count`, `last`, `p50`, `p90`, `p95`, `p99`), optional
-`group_by` keys, and optional `matchers`, each `{ key, op, value }` with `op`
-`eq` (exact) or `prefix`; the server serializes them to the Collector's
-`attr` / `attr_prefix` parameters. One bucket spanning the whole window
-collapses the answer to a single number. The catalog and the series list page
-with `cursor` like the telemetry lists.
-
-**App-only** — `fetch_telemetry` is called by the bundled MCP Apps, not by a
-model. Its input is one of four shapes selected by `view` (`traces`, `trace`,
-`logs`, `mcp_stats`); the `trace` view requires `trace_id` at the schema layer.
-
-**Writes** — `create_annotation`, `update_annotation`, `create_saved_query`,
-`update_saved_query` and `delete` change only objects users create in qyl, in
-the caller's Collector project: annotations (plain-text notes of at most 2000
-characters on a trace, span or session) and saved queries (named filters for
-traces, logs or metrics). `delete` takes `kind` (`annotation` or
-`saved_query`; alert rules follow with Contract 11.7.0), `id` and `etag`. No
-tool deletes or edits traces, logs or metrics; retention removes telemetry.
-Updates and deletes send the `etag` as `If-Match`: a stale one fails with
-`precondition_failed`, a duplicate saved-query name with `conflict`.
-`list_saved_queries` and `run_saved_query` read saved queries; `get_trace` and
-`list_sessions` return the annotations on what they read. Demo mode keeps none
-of these objects and refuses these tools.
-
-**Failures** — every failed call returns `isError: true`, the message as text,
-and `structuredContent.error = { code, message, retryable }` with the
-contract's `ToolErrorCode`.
-
-The thirteen read tools carry `readOnlyHint: true` and only query the
-configured collector. The create tools carry `destructiveHint: false` and
-`idempotentHint: false`; the update tools and `delete` carry
-`destructiveHint: true` and `idempotentHint: true`. On the hosted server
-`qyl:read` covers the read tools, `qyl:write` adds the create and update tools,
-and `qyl:delete` adds `delete`.
-
-The `display_*` tools return MCP Apps UI resources as single-file viewers.
-
-Every tool runs inside its request scope. Cancellation: a
-`notifications/cancelled` for the request, or a closed connection, aborts the
-in-flight collector fetch instead of waiting out its timeout. Progress: a
-request that carries a `progressToken` gets `notifications/progress` per
-completed step, one per collector round trip plus a final "Result ready"
-(`ci_log` with a `run_id` reports the flatten into legs as a step of its own).
-Logging: the server declares no `logging` capability and sends no
-`notifications/message`, including when a client supplies a log level.
-Operational error diagnostics go to stderr; native tool timing/status telemetry
-uses OpenTelemetry. Requested progress and cancellation remain available.
-[Source and test commands/output, 2026-10-08](https://github.com/ANcpLua/qyl.mcp/blob/main/docs/evidence/2026-10-08-followup-01.md).
+The server publishes 32 tools, including one app-only read tool. Reads use the collector's
+analysis queries and the generated qyl API contracts.
 
+| Purpose | Tools |
+| --- | --- |
+| Investigate failures | `triage`, `list_failures`, `get_failure_context`, `compare_groups`, `compare_traces`, `verify_fix` |
+| Explore telemetry | `aggregate_telemetry`, `discover_attributes`, `get_agent_run`, `list_releases`, `get_service_map`, `check_telemetry_health`, `get_mcp_stats` |
+| Read executions | `list_sessions`, `list_traces`, `get_trace`, `search_logs`, `ci_log` |
+| Read metrics | `list_metrics`, `get_metric_series`, `query_metric` |
+| Saved questions | `list_saved_queries`, `run_saved_query` |
+| Interactive views | `display_traces`, `display_mcp_dashboard`, `fetch_telemetry` (app-only) |
+| Write project records | `create_annotation`, `update_annotation`, `create_saved_query`, `update_saved_query`, `delete`, `update_failure_status` |
+
+Read tools accept an absolute RFC 3339 time window or `lookback_minutes` and report the
+resolved `window` and `coverage`: examined, matched and returned counts, truncation,
+scan completeness and observation time. Unknown counts are null. Filtering happens before
+pagination; reuse an opaque `next_cursor` with the same filters to continue a page.
+
+Shared matchers support `eq`, `neq`, `in`, `prefix`, `contains`, `exists`, `gt`, `gte`,
+`lt` and `lte`, with span, resource or log scope. Span durations are milliseconds;
+metrics retain their recorded units. Histogram percentiles identify their approximation,
+and cumulative counter changes account for resets. Verification reports insufficient
+traffic as pending rather than calling an unobserved failure fixed.
+
+`get_trace` supports all spans, errors, errors with ancestors, or the critical path,
+selected attributes and correlated logs. `display_traces` preserves the selected span
+and can compare two executions. Notes and bookmarks are created only through explicit
+viewer actions. `display_mcp_dashboard` uses the same MCP aggregates as `get_mcp_stats`,
+shows the numerator and denominator behind rates, classifies failures, and opens matching
+calls from aggregate selections. `fetch_telemetry` serves five app-only views: traces,
+trace, logs, MCP statistics and comparison, with incremental refresh and field selection.
+
+The 26 read tools carry `readOnlyHint: true`. Six write tools change annotations, saved
+queries or failure status in the caller's project. An annotation can target a trace, span,
+session or failure and has optional labels and a classification. A bookmark is a note
+labelled `bookmark`. Updates and deletes require the current `etag`; stale writes are
+rejected. Create calls reuse the stored result for 24 hours. Without an explicit
+`idempotency_key`, the server derives one from the project, operation and request
+body, so identical retries are safe. Supply a different key to deliberately create
+another identical record. No tool edits or deletes recorded telemetry.
+
+`qyl:read` covers reads, `qyl:write` adds creation and updates, and `qyl:delete` permits
+`delete`. A missing scope returns the supported OAuth step-up challenge. Failed calls
+carry a stable code, retryability, the problem type and field-level validation details
+when available. Secrets are redacted before model text or structured content is returned.
+
+Every tool runs inside its request scope, forwarding cancellation to the collector.
+Requested progress reports completion; no logging notifications are sent to clients.
+Analysis reads require a live collector. Synthetic data is used only by test fixtures, and is never substituted when a collector fails.
 
 Every inbound `tools/call` on a local server — `--stdio`, or HTTP without
 `MCP_PUBLIC_URL` — records only its tool name, timing, status and error type,
@@ -155,14 +129,13 @@ multi-tenant audit log.
 | --- | --- |
 | `QYL_COLLECTOR_URL` | Collector read API base; default `http://127.0.0.1:5100`. Also the OTLP base when set. |
 | `QYL_API_KEY` | Collector credential for reads and OTLP; the write tools need the Collector's `write` and `delete` roles on it. Outgoing only. |
-| `QYL_PROJECT` | Server-owned collector project scope. Unset, the server sends no project-scope header, so the Collector's default project applies; the Events subscription source key records that as `default`. Never accepted as tool input. This is the only place that states the default; other documents link here. |
+| `QYL_PROJECT` | Server-owned collector project scope. Unset, the server sends no project-scope header, so the Collector's default project applies. Never accepted as tool input. This is the only place that states the default; other documents link here. |
 | `MCP_COLLECTOR_PROJECTS` | Optional secret JSON mapping validated Auth0 subjects to project-bound Collector keys; see account isolation below. |
 | `QYL_OTLP_ENDPOINT` | Optional OTLP base for self-telemetry. |
-| `QYL_DEMO=1` | Explicit, visibly labelled demo telemetry. A collector failure never silently substitutes demo data. |
 | `QYL_MCP_TELEMETRY=0` | Disable MCP spans, metrics, and operation logs. |
 | `QYL_MCP_CAPTURE_CONTENT=1` | Workbench content capture; native incoming tool-call telemetry never supplies request or response bodies. |
 | `QYL_MCP_NATIVE_STATE_PATH` | Override the native execution-evidence path. |
-| `MCP_EVENTS_STORE` | Persistent Events subscription file; requires Auth0 and the access-check credentials below. |
+| `MCP_EVENTS_STORE` | Optional internal Events subscription file; leave unset for the shared ChatGPT/Claude deployment. |
 | `MCP_EVENTS_AUTH0_CLIENT_ID` / `MCP_EVENTS_AUTH0_CLIENT_SECRET` | Dedicated Management API application with `read:users`, `read:clients`, `read:client_grants`, `read:grants`; resolves CIMD identities and keeps access checks current without storing subscriber tokens. |
 | `MCP_EVENTS_POLL_MS` | Collector polling interval, at least 5000 ms; default 30000 ms. |
 | `PORT` | HTTP listener port; default `3001`. |
@@ -170,9 +143,8 @@ multi-tenant audit log.
 Secrets are redacted before results reach the model, structured content, or
 durable evidence.
 
-`--stdio` runs under Node.js 24 or Bun 1.4, which is what `npx` gives you.
-The HTTP entry is a web-standard fetch handler served by its default export,
-so serving it requires Bun.
+`npx` and `pnpm dlx` also work when Bun 1.4 or newer is installed.
+Both the HTTP and stdio executables use Bun 1.4 or newer.
 
 ### Account isolation for hosted Auth0
 
@@ -202,20 +174,48 @@ existing deployment-wide credential behavior is retained.
 
 Only the verified SDK `AuthInfo.extra.subject` selects the project. Tool inputs
 and request metadata cannot override it. All telemetry tools, viewer refreshes
-and Events queries use that account's project credential. Removing the account
-assignment revokes its Events subscription on the next access check. Project
+use that account's project credential. Project
 keys are redacted from text and structured results, including keys nested in
 this JSON configuration. Keep the map in host secrets and out of the plugin ZIP.
 
 `bun run smoke:projects` from the repository root checks every tool, the
-writes included, viewer query paths, both protocol eras and Events against a
-real local Collector with two temporary projects. Set `QYL_COLLECTOR_PROJECT` to its
-`.csproj` when using a different checkout. The script uses local test identities
+writes included, viewer query paths and both protocol eras against a
+real local Collector with two temporary projects. It reuses the completed Release
+build; set `QYL_COLLECTOR_DLL` for another build. The script uses local test identities
 and an in-process signed webhook receiver; the hosted reviewer OAuth login and
 real ChatGPT demonstration are separate checks before upload.
 
+### Seeded analysis verification
+
+`bun run --cwd server test:answer-key` starts a fresh temporary collector database,
+seeds real OTLP, and runs the 32 analysis checks through MCP and generated validators.
+It reuses the collector's completed build; set `QYL_COLLECTOR_DLL` when its location
+or configuration differs. `mise run check` includes this verification and the quiet
+SSE check. No pre-existing temporary file or manually seeded database is required.
+
+`QYL_BIN=/path/to/installed/qyl node live-tools-smoke.mjs` additionally checks
+all 32 tools against an isolated collector started by the published CLI.
+
 ## Release notes
 
+### 8.0.0
+
+- The executable now requires Bun 1.4 or later, including stdio. Library subpaths remain usable on Node 24; TypeScript 7 continues to emit the package.
+- Start HTTP explicitly with a 60-second idle timeout so quiet SSE responses survive the SDK keep-alive. Stop the HTTP server during shutdown.
+- Request read, write and delete scopes at initial sign-in; step-up challenges name only missing scopes.
+- Return useful text summaries, bounded evidence and continuations; validate failure updates and make create retries idempotent by default.
+- Use collector contract 12.1.1 for corrected analysis paging, coverage and failure timestamps. Remove the obsolete demo runtime and duplicate read implementations.
+- Pin SemanticConventions 9.9.1, including the canonical `qyl.gen_ai.tool.call.arguments_hash` definition used by collector 12.1.1 for repeated-call analysis.
+- Preserve note drafts, render trace drill-down results and use consistent dashboard filters. Gate the real OTLP answer-key and Bun quiet-stream regressions.
+
+### 7.7.0
+
+- Expand to 32 tools: failure triage and lifecycle, trace/group comparisons, fix verification, telemetry aggregation and discovery, agent runs, releases, service maps, telemetry health and MCP statistics.
+- Use the collector's shared typed analysis contracts for filtering, pagination, coverage and saved-query execution; retain official SDKs/exporters and project-scoped authorization.
+- Add responsive trace comparison, explicit note/bookmark controls, dashboard filters and drill-downs, with denominator counts behind rates.
+- Preserve numeric agent token usage during secret redaction, and verify the new surface against real OTLP fixtures plus both protocol eras.
+
+
 ### 7.6.1
 
 - Manage existing Auth0 API permissions, client grants and mapped-user permissions with scoped tenant configuration and a drift check.

package/dist/analysis-budget.d.ts

@@ -0,0 +1,8 @@
+import type { CallToolResult } from "@modelcontextprotocol/server";
+export declare const ANALYSIS_RESPONSE_BYTES = 24000;
+export declare const responseBytes: (result: object) => number;
+/** Final compaction for a single large record, after the Collector has paged it.
+ * Stable identities, counts and signed continuations are preserved. Bulk text and
+ * nested evidence can be omitted; totals and the text response explain the loss.
+ */
+export declare function compactAnalysisResult(operation: string, original: object): CallToolResult;

package/dist/analysis-budget.js

@@ -0,0 +1,73 @@
+import { analysisSummary } from "./analysis-summary.js";
+import { telemetryToolResult } from "./telemetry-redaction.js";
+export const ANALYSIS_RESPONSE_BYTES = 24_000;
+export const responseBytes = (result) => Buffer.byteLength(JSON.stringify(result), "utf8");
+/** Final compaction for a single large record, after the Collector has paged it.
+ * Stable identities, counts and signed continuations are preserved. Bulk text and
+ * nested evidence can be omitted; totals and the text response explain the loss.
+ */
+export function compactAnalysisResult(operation, original) {
+    const output = structuredClone(original);
+    const totals = { ...output.page_totals };
+    let omitted = 0;
+    let shortened = 0;
+    const coverage = { ...output.coverage, truncated: true, returned: null };
+    output.coverage = coverage;
+    output.page_totals = totals;
+    const result = () => telemetryToolResult(`${analysisSummary(operation, output)}\nResponse budget: ${omitted} other evidence item(s) omitted; ${shortened} text field(s) shortened. Narrow the filters or use the continuation for more evidence.`, output);
+    // These fields are descriptions/content, never identifiers, credentials or cursors.
+    const textFields = new Set(["body", "text", "message", "status_message", "description", "brief", "summary", "pattern", "value", "name"]);
+    function trimText(value, cap) {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                trimText(item, cap);
+            return;
+        }
+        if (value === null || typeof value !== "object")
+            return;
+        for (const [key, item] of Object.entries(value)) {
+            if (typeof item === "string" && item.length > cap && textFields.has(key)) {
+                value[key] = `${Array.from(item).slice(0, cap).join("")}…`;
+                shortened++;
+            }
+            else
+                trimText(item, cap);
+        }
+    }
+    trimText(output, 512);
+    for (let iteration = 0; responseBytes(result()) > ANALYSIS_RESPONSE_BYTES && iteration < 128; iteration++) {
+        const arrays = [];
+        function collect(value, path) {
+            if (Array.isArray(value)) {
+                if (value.length > 0)
+                    arrays.push({ values: value, path, bytes: responseBytes(value) });
+                value.forEach((item, index) => collect(item, `${path}.${index}`));
+            }
+            else if (value !== null && typeof value === "object") {
+                for (const [key, item] of Object.entries(value)) {
+                    if (key !== "page_totals" && key !== "coverage")
+                        collect(item, path ? `${path}.${key}` : key);
+                }
+            }
+        }
+        collect(output, "");
+        // Prefer removing bulk inside a trace over removing the trace itself.
+        arrays.sort((a, b) => (b.path.split(".").length > 1 ? b.bytes : b.bytes / 4) - (a.path.split(".").length > 1 ? a.bytes : a.bytes / 4));
+        const candidate = arrays[0];
+        if (!candidate) {
+            trimText(output, 64);
+            break;
+        }
+        const removed = candidate.values.splice(Math.floor(candidate.values.length / 2)).length;
+        omitted += removed;
+        totals[`other.${candidate.path}`] = (totals[`other.${candidate.path}`] ?? 0) + removed;
+    }
+    // A cursor can encode large filters. Keeping it must not defeat the response cap.
+    if (responseBytes(result()) > ANALYSIS_RESPONSE_BYTES) {
+        delete output.next_cursor;
+        delete output.next_phase_cursor;
+        trimText(output, 64);
+    }
+    return result();
+}
+//# sourceMappingURL=analysis-budget.js.map

package/dist/analysis-budget.js.map

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

package/dist/analysis-client.d.ts

@@ -0,0 +1,5 @@
+/** Shared HTTP transport; every callable analysis operation is registered by name. */
+import type { CallToolResult } from "@modelcontextprotocol/server";
+import type * as z from "zod/v4";
+import type { ToolScope } from "./request-scope.js";
+export declare function queryAnalysis<Input extends object, Output extends object>(operation: string, input: Input, schema: z.ZodType<Output>, scope: ToolScope): Promise<CallToolResult>;

package/dist/analysis-client.js

@@ -0,0 +1,46 @@
+import { CollectorError, collectorPost, parseCollectorBody } from "./collector.js";
+import { ANALYSIS_RESPONSE_BYTES, compactAnalysisResult, responseBytes } from "./analysis-budget.js";
+import { analysisSummary } from "./analysis-summary.js";
+import { telemetryToolResult } from "./telemetry-redaction.js";
+export async function queryAnalysis(operation, input, schema, scope) {
+    const path = `/api/v1/analysis/${operation}`;
+    const deadline = Date.now() + 55_000;
+    let query = input;
+    let previousPageSize = Infinity;
+    for (;;) {
+        const remaining = deadline - Date.now();
+        if (remaining <= 0)
+            throw new CollectorError("The query exceeded its time budget; narrow the time window and matchers.");
+        const response = await collectorPost(path, query, { ...scope.collector, timeoutMs: remaining });
+        const output = parseCollectorBody(response, path, schema);
+        const result = telemetryToolResult(analysisSummary(operation, output), output);
+        // Bytes give a conservative upper bound even for token-dense identifiers.
+        const bytes = responseBytes(result);
+        if (bytes <= ANALYSIS_RESPONSE_BYTES) {
+            await scope.step(`Queried ${operation}`);
+            return result;
+        }
+        // Re-query the collector so its cursor, coverage and totals describe the
+        // smaller page. Never slice a response and leave its paging metadata stale.
+        const args = query;
+        const page = output;
+        const traceView = operation === "get_trace" || operation === "fetch_telemetry" && args.view === "trace";
+        const sizeKey = traceView ? "max_spans" : operation === "query_metric" ? "series_limit" : operation === "get_agent_run" ? "max_steps" : "limit";
+        const trace = page.trace;
+        const observed = page.observed;
+        const sizes = [trace?.spans?.length, observed?.error_spans?.length, observed?.logs?.length,
+            ...Object.values(page).filter(Array.isArray).map((items) => items.length)].filter((size) => size !== undefined);
+        const pageSize = Math.max(0, ...sizes);
+        if (pageSize > 1 && pageSize < previousPageSize) {
+            previousPageSize = pageSize;
+            const limit = Math.max(1, Math.floor(pageSize * ANALYSIS_RESPONSE_BYTES / bytes * 0.8));
+            // The collector creates the smaller page and its continuation together.
+            query = { ...args, ...page.window, [sizeKey]: limit,
+                ...(operation === "get_failure_context" ? { max_spans: limit, max_logs: limit } : {}) };
+            continue;
+        }
+        await scope.step(`Queried ${operation}; large evidence compacted`);
+        return compactAnalysisResult(operation, output);
+    }
+}
+//# sourceMappingURL=analysis-client.js.map

package/dist/analysis-client.js.map

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

package/dist/analysis-summary.d.ts

@@ -0,0 +1,2 @@
+/** Compact evidence for hosts that show text without expanding structuredContent. */
+export declare function analysisSummary(operation: string, output: object): string;

package/dist/analysis-summary.js

@@ -0,0 +1,54 @@
+/** Compact evidence for hosts that show text without expanding structuredContent. */
+export function analysisSummary(operation, output) {
+    const data = output;
+    const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+    const short = (value) => (value == null ? "unknown" : typeof value === "string" ? value : JSON.stringify(value) ?? "unknown").replace(/\s+/gu, " ").slice(0, 180);
+    const lines = [operation.replaceAll("_", " ")];
+    const coverage = record(data.coverage);
+    if (Object.keys(coverage).length)
+        lines.push(`Matched ${short(coverage.matched)}; returned ${short(coverage.returned)}. ${coverage.scan_complete === true ? "Scan complete." : "Scan incomplete; totals may be unknown."}`);
+    for (const key of ["verdict", "reason", "settled", "method", "unit", "approximate"]) {
+        if (data[key] !== undefined)
+            lines.push(`${key}: ${short(data[key])}`);
+    }
+    const totals = record(data.totals ?? record(data.stats).totals);
+    if (totals.requests !== undefined)
+        lines.push(`${short(totals.errors)} errors / ${short(totals.requests)} requests; p95 ${short(totals.p95_ms)} ms.`);
+    const trace = record(data.trace);
+    if (trace.trace_id)
+        lines.push(`Trace ${short(trace.trace_id)}: ${short(trace.span_count)} spans${trace.has_error ? ", contains errors" : ""}.`);
+    const cause = record(record(data.observed).root_cause_span);
+    if (cause.name)
+        lines.push(`Recorded failure: ${short(cause.service)} / ${short(cause.name)} — ${short(record(cause.exception).message ?? cause.status)}`);
+    const collections = ["failures", "regressions", "groups", "steps", "traces", "sessions", "logs", "items", "attributes", "releases", "nodes", "runs", "phases", "saved_queries"];
+    let evidence = 0;
+    for (const field of collections) {
+        const rows = data[field];
+        if (!Array.isArray(rows))
+            continue;
+        lines.push(`${field.replaceAll("_", " ")}: ${rows.length} on this page.`);
+        for (const value of rows) {
+            if (evidence >= 3)
+                break;
+            const row = record(value);
+            const title = row.normalized_message ?? row.name ?? row.operation ?? row.key ?? row.root_span_name ?? row.body ?? row.service ?? row.session_id;
+            if (title === undefined)
+                continue;
+            const label = typeof title === "object" ? JSON.stringify(title) : title;
+            const stats = row.count ?? row.requests ?? row.status ?? row.change;
+            const id = row.failure_id ?? row.trace_id;
+            lines.push(`- ${short(label)}${stats === undefined ? "" : ` (${short(stats)})`}${id === undefined ? "" : ` · ${short(id)}`}`);
+            evidence++;
+        }
+    }
+    if (data.has_more === true && typeof data.next_cursor === "string")
+        lines.push("More results: repeat with next_cursor and the same filters.");
+    else if (data.has_more === true && typeof data.next_phase_cursor === "string")
+        lines.push("More phases: repeat with next_phase_cursor as phase_cursor and the same filters.");
+    else if (data.has_more === true)
+        lines.push("More evidence exists; narrow the filters to retrieve it.");
+    else if (coverage.truncated === true)
+        lines.push("Evidence is truncated; narrow the query for more detail.");
+    return lines.slice(0, 14).join("\n");
+}
+//# sourceMappingURL=analysis-summary.js.map

package/dist/analysis-summary.js.map

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

package/dist/analysis-tools.d.ts

@@ -0,0 +1,3 @@
+/** Named analysis tools backed by the collector's generated query contracts. */
+import type { McpServer } from "@modelcontextprotocol/server";
+export declare function registerAnalysisTools(server: McpServer): void;