qyl-mcp-server 7.1.0 → 7.2.0

package/dist/mcp-home.html

@@ -6,7 +6,7 @@
   <meta name="color-scheme" content="dark">
   <meta name="description" content="Bring qyl traces, logs, and MCP telemetry into your coding agent.">
   <title>qyl · MCP telemetry for coding agents</title>
-  <script type="module" crossorigin>(function(){let e=document.createElement(`link`).relList;if(e&&e.supports&&e.supports(`modulepreload`))return;for(let e of document.querySelectorAll(`link[rel="modulepreload"]`))n(e);new MutationObserver(e=>{for(let t of e)if(t.type===`childList`)for(let e of t.addedNodes)e.tagName===`LINK`&&e.rel===`modulepreload`&&n(e)}).observe(document,{childList:!0,subtree:!0});function t(e){let t={};return e.integrity&&(t.integrity=e.integrity),e.referrerPolicy&&(t.referrerPolicy=e.referrerPolicy),t.credentials=e.crossOrigin===`use-credentials`?`include`:e.crossOrigin===`anonymous`?`omit`:`same-origin`,t}function n(e){if(e.ep)return;e.ep=!0;let n=t(e);fetch(e.href,n)}})();var e=`7.1.0`,t=`https://mcp.qyl.at/mcp`,n={codex:{title:`terminal`,value:`codex mcp add qyl --url ${t}`},claude:{title:`terminal`,value:`claude mcp add --transport http qyl ${t}`},cursor:{title:`mcp.json`,value:`{
+  <script type="module" crossorigin>(function(){let e=document.createElement(`link`).relList;if(e&&e.supports&&e.supports(`modulepreload`))return;for(let e of document.querySelectorAll(`link[rel="modulepreload"]`))n(e);new MutationObserver(e=>{for(let t of e)if(t.type===`childList`)for(let e of t.addedNodes)e.tagName===`LINK`&&e.rel===`modulepreload`&&n(e)}).observe(document,{childList:!0,subtree:!0});function t(e){let t={};return e.integrity&&(t.integrity=e.integrity),e.referrerPolicy&&(t.referrerPolicy=e.referrerPolicy),t.credentials=e.crossOrigin===`use-credentials`?`include`:e.crossOrigin===`anonymous`?`omit`:`same-origin`,t}function n(e){if(e.ep)return;e.ep=!0;let n=t(e);fetch(e.href,n)}})();var e=`7.2.0`,t=`https://mcp.qyl.at/mcp`,n={codex:{title:`terminal`,value:`codex mcp add qyl --url ${t}`},claude:{title:`terminal`,value:`claude mcp add --transport http qyl ${t}`},cursor:{title:`mcp.json`,value:`{
   "mcpServers": {
     "qyl": {
       "url": "${t}"
@@ -117,23 +117,23 @@
       <p class="section-index">02 / REQUEST SCOPE</p>
       <div class="protocol-heading">
         <h2 id="scope-title">Every call runs inside its request.</h2>
-        <p>One frame around all eleven tools. A tool registered outside it fails the build, so none of the three can go missing.</p>
+        <p>One frame around all eleven tools. A tool registered outside it fails the build, so cancellation and requested progress stay in the common frame.</p>
       </div>
       <div class="protocol-grid scope-grid">
         <article><span>Cancel</span><h3>Stop means stop</h3><p>A <code>notifications/cancelled</code>, or a dropped connection, aborts the in-flight collector fetch at once instead of waiting out its timeout.</p></article>
         <article><span>Progress</span><h3>Only when you ask</h3><p>A request that carries a <code>progressToken</code> gets one <code>notifications/progress</code> per collector round trip and a final <em>Result ready</em>. No token, no noise.</p></article>
-        <article><span>Log</span><h3>One line per call</h3><p>A request that names a log level in its <code>_meta</code> envelope receives one <code>notifications/message</code>: <em>info</em> on success, <em>warning</em> on failure, logger <code>qyl.mcp</code>.</p></article>
+        <article><span>Observe</span><h3>Operation telemetry</h3><p>Native tool telemetry records timing, status and error type through OpenTelemetry. The server sends no deprecated protocol log messages.</p></article>
       </div>
     </section>
 
     <section class="protocol-section" aria-labelledby="protocol-title">
       <p class="section-index">03 / PROTOCOL</p>
       <div class="protocol-heading">
-        <h2 id="protocol-title">Built for the 2026 MCP.</h2>
-        <p>No session, no 2025 handshake, no SSE compatibility layer &mdash; a 2025-era request is refused with <code>-32022</code>.</p>
+        <h2 id="protocol-title">Connect your MCP client.</h2>
+        <p>Tools support MCP <code>2026-07-28</code> and 2025-era clients. Events use <code>2026-07-28</code>.</p>
       </div>
       <div class="protocol-grid">
-        <article><span>01</span><h3>Per-request identity</h3><p>Every request carries its protocol, client identity, and capabilities.</p></article>
+        <article><span>01</span><h3>Per-request identity</h3><p>Modern requests declare their protocol and capabilities; authorization is checked on every HTTP request.</p></article>
         <article><span>02</span><h3>OAuth resource server</h3><p>Your client discovers authorization and opens the browser flow automatically.</p></article>
         <article><span>03</span><h3>Trace context intact</h3><p>W3C trace context follows calls from the agent through MCP into downstream work.</p></article>
         <article><span>04</span><h3>Server-rendered views</h3><p>Trace and traffic interfaces travel as MCP Apps, beside the evidence they explain.</p></article>

package/dist/metrics-tools.js

@@ -20,7 +20,7 @@ import { listMetricSeries, listMetrics, queryMetric, } from "./metrics.js";
 import { summarizeMetricCatalog, summarizeMetricQuery, summarizeMetricSeries, } from "./summaries.js";
 import { runTool } from "./request-scope.js";
 import { telemetryToolResult } from "./telemetry-redaction.js";
-import { READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS } from "./tools.js";
+import { READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS, TELEMETRY_TOOL_AUTH_META } from "./tools.js";
 const METRICS_PATH = "/api/v1/metrics";
 const SERIES_PATH = "/api/v1/metrics/{metric_name}/series";
 const QUERY_PATH = "/api/v1/metrics/{metric_name}/query";
@@ -34,12 +34,13 @@ export function registerMetricsTools(server) {
         title: "List Metrics",
         description: "List the metric instruments recorded for this project: name, kind " +
             "(gauge/sum/histogram), unit, how many attribute streams exist under each " +
-            "name, and when it was last written. Start here — query_metric needs an " +
-            "exact instrument name, and this is where the names come from.",
+            "name, and when it was last written. Useful when the user wants to discover " +
+            "instrument names before querying a metric by its exact name.",
         inputSchema: operationInputSchema(METRICS_PATH),
         outputSchema: compactOutputSchema(MetricsListResponseSchema),
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
-    }, (args, ctx) => runTool(ctx, "list_metrics", 1, async (scope) => {
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
         const { metrics, mode } = await listMetrics(args, scope.collector);
         await scope.step(`Fetched ${metrics.length} metric instrument(s)`);
         return telemetryToolResult(summarizeMetricCatalog(metrics, mode), {
@@ -50,14 +51,14 @@ export function registerMetricsTools(server) {
     server.registerTool("get_metric_series", {
         title: "Get Metric Series",
         description: "List the distinct attribute streams recorded under one metric name, with " +
-            "each stream's attributes, service, and first/last seen. Use it to discover " +
-            "which attribute keys are worth passing to query_metric as group_by or attr " +
-            "filters, before running a range query that would otherwise collapse or " +
-            "explode the result.",
+            "each stream's attributes, service, and first/last seen. Useful when the user " +
+            "wants to discover group_by keys or attr filters for query_metric before " +
+            "choosing the groups in a range query.",
         inputSchema: operationInputSchema(SERIES_PATH),
         outputSchema: compactOutputSchema(MetricSeriesListResponseSchema),
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
-    }, (args, ctx) => runTool(ctx, "get_metric_series", 1, async (scope) => {
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
         const { series, mode } = await listMetricSeries(args, scope.collector);
         await scope.step(`Fetched ${series.length} series of ${args.metric_name}`);
         return telemetryToolResult(summarizeMetricSeries(series, mode), {
@@ -67,16 +68,18 @@ export function registerMetricsTools(server) {
     }));
     server.registerTool("query_metric", {
         title: "Query Metric",
-        description: "Run a time-bucketed range query over one metric: a window (start_time, " +
+        description: "Run a time-bucketed range query when the user wants to compare a metric " +
+            "over time or across groups: a window (start_time, " +
             "end_time), a bucket width (step_ms), a reducer (aggregation: avg, min, max, " +
             "sum, count, last, p50, p90, p95, p99), optional group_by attribute keys, and " +
             "optional attr/attr_prefix matchers written 'key=value'. Returns one stream " +
-            "per grouping with its buckets. One bucket spanning the whole window collapses " +
-            "the answer to a single number.",
+            "per grouping with its buckets. With step_ms equal to the window duration, " +
+            "each grouping yields one bucket: one number per series.",
         inputSchema: operationInputSchema(QUERY_PATH),
         outputSchema: compactOutputSchema(MetricQueryResultSchema),
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
-    }, (args, ctx) => runTool(ctx, "query_metric", 1, async (scope) => {
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
         const { result, mode } = await queryMetric(args, scope.collector);
         await scope.step(`Queried ${args.metric_name}: ${result.series.length} series, ` +
             `${result.series[0]?.buckets.length ?? 0} bucket(s) each`);

package/dist/metrics-tools.js.map

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

package/dist/native-execution.d.ts

@@ -1,12 +1,11 @@
-import type { WorkbenchExecutionCost, WorkbenchExecutionTokenUsage } from "@ancplua/qyl-api-schema/types";
 import type { McpServer, CallToolRequest, CallToolResult, ServerContext } from "@modelcontextprotocol/server";
-import { z } from "zod";
+import * as z from "zod/v4";
 import type { McpTelemetryTransport } from "./mcp-semconv.js";
 import { SecretRedactor } from "./secret-redactor.js";
 import { McpTelemetry } from "./telemetry.js";
 declare const NativeExecutionRecordSchema: z.ZodObject<{
     id: z.ZodString;
-    serverId: z.ZodLiteral<"qyl.mcp/native">;
+    toolName: z.ZodString;
     status: z.ZodEnum<{
         failed: "failed";
         running: "running";
@@ -16,51 +15,7 @@ declare const NativeExecutionRecordSchema: z.ZodObject<{
     startedAt: z.ZodISODateTime;
     completedAt: z.ZodOptional<z.ZodISODateTime>;
     durationMs: z.ZodOptional<z.ZodNumber>;
-    attemptCount: z.ZodLiteral<1>;
-    request: z.ZodObject<{
-        requestId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
-        toolName: z.ZodString;
-        arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        transport: z.ZodEnum<{
-            builtin: "builtin";
-            http: "http";
-            inproc: "inproc";
-            sse: "sse";
-            stdio: "stdio";
-            "streamable-http": "streamable-http";
-            streamable_http: "streamable_http";
-        }>;
-        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strict>;
-    result: z.ZodOptional<z.ZodUnknown>;
-    error: z.ZodOptional<z.ZodObject<{
-        code: z.ZodString;
-        message: z.ZodString;
-    }, z.core.$strict>>;
-    tokenUsage: z.ZodOptional<z.ZodType<WorkbenchExecutionTokenUsage, unknown, z.core.$ZodTypeInternals<WorkbenchExecutionTokenUsage, unknown>>>;
-    cost: z.ZodOptional<z.ZodType<WorkbenchExecutionCost, unknown, z.core.$ZodTypeInternals<WorkbenchExecutionCost, unknown>>>;
-    protocolEvents: z.ZodArray<z.ZodObject<{
-        sequence: z.ZodNumber;
-        timestamp: z.ZodISODateTime;
-        direction: z.ZodEnum<{
-            inbound: "inbound";
-            outbound: "outbound";
-        }>;
-        messageKind: z.ZodEnum<{
-            error: "error";
-            request: "request";
-            result: "result";
-        }>;
-        jsonrpc: z.ZodLiteral<"2.0">;
-        requestId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
-        method: z.ZodLiteral<"tools/call">;
-        payload: z.ZodUnknown;
-    }, z.core.$strict>>;
-    telemetryCorrelation: z.ZodObject<{
-        executionId: z.ZodString;
-        traceIds: z.ZodArray<z.ZodString>;
-        spanIds: z.ZodArray<z.ZodString>;
-    }, z.core.$strict>;
+    errorType: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type NativeExecutionRecord = z.infer<typeof NativeExecutionRecordSchema>;
 export interface NativeExecutionRepository {
@@ -73,7 +28,7 @@ export interface FileNativeExecutionRepositoryOptions {
     redactor?: SecretRedactor;
     environment?: Readonly<Record<string, string | undefined>>;
 }
-/** Durable, redacted native-server evidence kept separately from workbench state. */
+/** Bounded operation metadata kept separately from Workbench execution state. */
 export declare class FileNativeExecutionRepository implements NativeExecutionRepository {
     private store;
     private readonly openStore;
@@ -81,17 +36,18 @@ export declare class FileNativeExecutionRepository implements NativeExecutionRep
     private readonly maxExecutions;
     private readonly now;
     private initialization;
+    private needsMigration;
     constructor(options?: FileNativeExecutionRepositoryOptions);
     /**
      * Move a state file this build cannot read out of the way, and say so.
      *
-     * The schema deliberately refuses to half-parse an older layout, but refusing
+     * The schema deliberately refuses to guess an unknown layout, but refusing
      * forever is not the same as refusing to guess: a state file written before a
      * version bump would otherwise fail every single tool call for the life of the
      * installation, because the store caches its failed load and evidence is
      * written before the tool runs. Renaming preserves the old records for anyone
-     * who wants them and lets this process start a fresh log. Nothing is deleted
-     * and nothing is migrated.
+     * who wants them and lets this process start a fresh log. Known version-1/2
+     * files follow the payload-removing migration instead of this recovery path.
      */
     private archiveUnreadableState;
     save(record: NativeExecutionRecord): Promise<void>;