qyl-mcp-server 7.3.1 → 7.5.0

package/dist/tool-scopes.js

@@ -0,0 +1,97 @@
+/**
+ * The OAuth scope a write tool needs beyond `qyl:read`, and how a call
+ * without it is refused.
+ *
+ * Every hosted request already carries `qyl:read`: it is the endpoint's
+ * required scope, which the bearer gate checks (authorization.ts). The create
+ * and update tools also need `qyl:write`, the delete tool `qyl:delete`.
+ *
+ * A write tool registers an SDK `scopeChallenge`. The SDK's HTTP serving runs
+ * it before the handler, in both protocol eras, and answers a token without
+ * the scope with `403` and `WWW-Authenticate: Bearer error="insufficient_scope"`
+ * naming the scopes to request — the MCP authorization "scope challenge" a
+ * client answers with step-up authorization. The handler checks again
+ * (`assertToolScopes`), so a transport that runs no scope challenge still
+ * refuses the call, as an `isError` result whose `structuredContent.error.code`
+ * is `insufficient_scope` and whose `_meta["mcp/www_authenticate"]` carries
+ * the same challenge (OpenAI's documented in-band form).
+ *
+ * Without verified authentication — stdio, local HTTP — there is no token to
+ * check: the operator's Collector key decides what the server may change.
+ * Scopes are compared as issued; an explicit scope hierarchy configured on
+ * the bearer gate covers the endpoint's required scopes only.
+ */
+import { getOAuthProtectedResourceMetadataUrl, } from "@modelcontextprotocol/server";
+import { QYL_MCP_SCOPES_SUPPORTED } from "./oauth.js";
+/** The tool-result `_meta` key OpenAI documents for an authentication challenge. */
+export const WWW_AUTHENTICATE_META_KEY = "mcp/www_authenticate";
+/** A verified token lacks a scope the tool needs; the message says which. */
+export class InsufficientScopeError extends Error {
+    challenge;
+    name = "InsufficientScopeError";
+    constructor(message, 
+    /** The RFC 6750 `WWW-Authenticate` value a client can answer with step-up. */
+    challenge) {
+        super(message);
+        this.challenge = challenge;
+    }
+}
+function missingScopes(required, authInfo) {
+    const granted = new Set(authInfo.scopes);
+    return required.filter((scope) => !granted.has(scope));
+}
+/**
+ * The scopes a challenge names: the tool's own plus the qyl scopes the token
+ * already holds, so re-authorizing for this tool does not drop another
+ * tool's grant (MCP authorization, "Scope challenge handling").
+ */
+function challengeScopes(required, authInfo) {
+    const supported = new Set(QYL_MCP_SCOPES_SUPPORTED);
+    const kept = authInfo.scopes.filter((scope) => supported.has(scope));
+    const scopes = [...new Set([...required, ...kept])].sort();
+    return [scopes[0] ?? required[0], ...scopes.slice(1)];
+}
+function errorDescription(tool, missing) {
+    return `${tool} needs the ${missing.join(" and ")} scope`;
+}
+/** The SDK registration hook: a challenge for a verified token without `required`. */
+export function toolScopeChallenge(tool, required) {
+    return ({ authInfo }) => {
+        if (authInfo === undefined)
+            return undefined;
+        const missing = missingScopes(required, authInfo);
+        if (missing.length === 0)
+            return undefined;
+        return {
+            scopes: challengeScopes(required, authInfo),
+            errorDescription: errorDescription(tool, missing),
+        };
+    };
+}
+/** The same Protected Resource Metadata URL the SDK's scope challenge names. */
+function resourceMetadataUrl(authInfo) {
+    if (authInfo.resourceMetadataUrl !== undefined)
+        return authInfo.resourceMetadataUrl;
+    const resource = authInfo.resource;
+    return resource !== undefined && (resource.protocol === "https:" || resource.protocol === "http:")
+        ? getOAuthProtectedResourceMetadataUrl(resource)
+        : undefined;
+}
+/**
+ * The handler's own check: throws `InsufficientScopeError` when a verified
+ * token lacks one of `required`. No verified authentication, no check.
+ */
+export function assertToolScopes(tool, required, authInfo) {
+    if (authInfo === undefined)
+        return;
+    const missing = missingScopes(required, authInfo);
+    if (missing.length === 0)
+        return;
+    const metadata = resourceMetadataUrl(authInfo);
+    const challenge = `Bearer error="insufficient_scope", error_description="${errorDescription(tool, missing)}", ` +
+        `scope="${challengeScopes(required, authInfo).join(" ")}"` +
+        (metadata === undefined ? "" : `, resource_metadata="${metadata}"`);
+    throw new InsufficientScopeError(`${errorDescription(tool, missing)}, which this sign-in does not grant. ` +
+        `Reconnect qyl and allow ${missing.join(" and ")} to use it.`, challenge);
+}
+//# sourceMappingURL=tool-scopes.js.map

package/dist/tool-scopes.js.map

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

package/dist/tools.js

@@ -1,8 +1,9 @@
 /** Qyl's directly registered, read-only telemetry tools. */
 import { GetTraceInputSchema, GetTraceOutputSchema, ListSessionsInputSchema, ListSessionsOutputSchema, ListTracesInputSchema, ListTracesOutputSchema, SearchLogsInputSchema, SearchLogsOutputSchema, compactOutputSchema, } from "./contract-validation.js";
 import { fetchLogs, fetchSessions, fetchTrace, fetchTraces } from "./data.js";
-import { summarizeLogs, summarizeSessions, summarizeTrace, summarizeTraceTable, } from "./summaries.js";
+import { filterNote, pageNote, summarizeLogs, summarizeSessions, summarizeTrace, summarizeTraceTable, } from "./summaries.js";
 import { runTool } from "./request-scope.js";
+import { readSessionAnnotations, readTraceAnnotations } from "./collector-resources.js";
 import { telemetryToolResult } from "./telemetry-redaction.js";
 import { QYL_MCP_SCOPE } from "./oauth.js";
 /**
@@ -60,12 +61,22 @@ function projectTrace(trace, args) {
         matchingSpanCount: matching.length,
     };
 }
+/** `from …`, `until …` for a list header; the window is what the caller asked for. */
+function windowNote(range) {
+    return [
+        range.start_time === undefined ? undefined : `from ${range.start_time}`,
+        range.end_time === undefined ? undefined : `until ${range.end_time}`,
+    ];
+}
 /** Register the four model-visible read tools against published contract schemas. */
 export function registerTelemetryTools(server) {
     server.registerTool("list_traces", {
         title: "List Traces",
         description: "List recent qyl traces when the user wants a compact overview of activity " +
             "and failures: root span, services, duration, span count, and error flag. " +
+            "Filters: a start_time/end_time window (RFC 3339), service_name (traces with " +
+            "a span from that service) and errors_only. Pages: when has_more is true, " +
+            "pass next_cursor as cursor with the same filters for the next page. " +
             "Spans are omitted; get_trace returns the full span tree, while display_traces " +
             "provides the interactive explorer.",
         inputSchema: ListTracesInputSchema,
@@ -73,13 +84,27 @@ export function registerTelemetryTools(server) {
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
         _meta: TELEMETRY_TOOL_AUTH_META,
     }, (args, ctx) => runTool(ctx, 1, async (scope) => {
-        const { traces, mode } = await fetchTraces(args.limit ?? 20, scope.collector);
-        await scope.step(`Fetched ${traces.length} trace(s)`);
+        const page = await fetchTraces({
+            limit: args.limit ?? 20,
+            start_time: args.start_time,
+            end_time: args.end_time,
+            service_name: args.service_name,
+            errors_only: args.errors_only,
+            cursor: args.cursor,
+        }, scope.collector);
+        await scope.step(`Fetched ${page.traces.length} trace(s)`);
         const output = {
-            traces: traces.map(({ spans: _spans, ...summary }) => summary),
-            mode,
+            traces: page.traces.map(({ spans: _spans, ...summary }) => summary),
+            mode: page.mode,
+            has_more: page.hasMore,
+            ...(page.nextCursor === undefined ? {} : { next_cursor: page.nextCursor }),
         };
-        return telemetryToolResult(summarizeTraceTable(traces, mode), output);
+        const filters = filterNote([
+            args.errors_only ? "errors only" : undefined,
+            args.service_name === undefined ? undefined : `service ${args.service_name}`,
+            ...windowNote(args),
+        ]);
+        return telemetryToolResult(summarizeTraceTable(page.traces, page.mode, filters) + pageNote(page), output);
     }));
     server.registerTool("get_trace", {
         title: "Get Trace",
@@ -89,58 +114,95 @@ export function registerTelemetryTools(server) {
             "and include_attributes=false omits attribute collections. Trace totals " +
             "are preserved and the summary reports returned and matching counts. " +
             "The root span is omitted when excluded by the filter or cap. " +
+            "It also returns the annotations on the trace and its spans, with the id and " +
+            "etag that update_annotation and delete take. " +
             "display_traces provides the visual waterfall.",
         inputSchema: GetTraceInputSchema,
         outputSchema: compactOutputSchema(GetTraceOutputSchema),
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
         _meta: TELEMETRY_TOOL_AUTH_META,
-    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
+    }, (args, ctx) => runTool(ctx, 2, async (scope) => {
         const { trace, mode } = await fetchTrace(args.trace_id, scope.collector);
         await scope.step(`Fetched trace ${args.trace_id} (${trace.span_count} spans)`);
         const projected = projectTrace(trace, args);
-        const output = { trace: projected.trace, mode };
+        const notes = await readTraceAnnotations(args.trace_id, scope);
+        const output = {
+            trace: projected.trace,
+            mode,
+            ...(notes.annotations === undefined ? {} : { annotations: notes.annotations }),
+        };
         const rootExcluded = trace.root_span !== undefined && projected.trace.root_span === undefined;
         const summary = summarizeTrace(projected.trace, mode, rootExcluded) +
             `\nReturned ${projected.trace.spans.length} of ${projected.matchingSpanCount} matching spans ` +
             `(${trace.span_count} total)${args.errors_only ? "; error status only" : ""}.` +
-            (args.include_attributes === false ? " Attribute collections omitted." : "");
+            (args.include_attributes === false ? " Attribute collections omitted." : "") +
+            notes.text;
         return telemetryToolResult(summary, output);
     }));
     server.registerTool("list_sessions", {
         title: "List Sessions",
         description: "List qyl sessions when the user wants to find active or failing sessions, " +
             "with trace/span/error counts, state, and GenAI token usage where present. " +
+            "Filters: active_only and a start_time/end_time window (RFC 3339) on the " +
+            "session start. Pages: when has_more is true, pass next_cursor as cursor with " +
+            "the same filters for the next page. It also returns the annotations on the " +
+            "listed sessions. " +
             "display_traces accepts a session_id to show that session's traces in the explorer.",
         inputSchema: ListSessionsInputSchema,
         outputSchema: compactOutputSchema(ListSessionsOutputSchema),
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
         _meta: TELEMETRY_TOOL_AUTH_META,
-    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
-        const { sessions, mode } = await fetchSessions(args.limit ?? 20, args.active_only, scope.collector);
-        await scope.step(`Fetched ${sessions.length} session(s)`);
-        const output = { sessions, mode };
-        return telemetryToolResult(summarizeSessions(sessions, mode), output);
+    }, (args, ctx) => runTool(ctx, 2, async (scope) => {
+        const page = await fetchSessions({
+            limit: args.limit ?? 20,
+            active_only: args.active_only,
+            start_time: args.start_time,
+            end_time: args.end_time,
+            cursor: args.cursor,
+        }, scope.collector);
+        await scope.step(`Fetched ${page.sessions.length} session(s)`);
+        const notes = await readSessionAnnotations(page.sessions.map((session) => session.session_id), scope);
+        const output = {
+            sessions: page.sessions,
+            mode: page.mode,
+            has_more: page.hasMore,
+            ...(page.nextCursor === undefined ? {} : { next_cursor: page.nextCursor }),
+            ...(notes.annotations === undefined ? {} : { annotations: notes.annotations }),
+        };
+        const filters = filterNote([args.active_only ? "active only" : undefined, ...windowNote(args)]);
+        return telemetryToolResult(summarizeSessions(page.sessions, page.mode, filters) + pageNote(page) + notes.text, output);
     }));
     server.registerTool("search_logs", {
         title: "Search Logs",
         description: "Search qyl log records when the user wants error details or logs correlated " +
-            "with a trace. Filters include trace_id, service_name, minimum severity " +
-            "(OTel numbers: 9 INFO, 13 WARN, 17 ERROR), and a body substring query.",
+            "with a trace or a session. Filters include trace_id, session_id, service_name, " +
+            "minimum severity (OTel numbers: 9 INFO, 13 WARN, 17 ERROR), a body substring " +
+            "query, and a start_time/end_time window (RFC 3339). Pages: when has_more is " +
+            "true, pass next_cursor as cursor with the same filters for the next page.",
         inputSchema: SearchLogsInputSchema,
         outputSchema: compactOutputSchema(SearchLogsOutputSchema),
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
         _meta: TELEMETRY_TOOL_AUTH_META,
     }, (args, ctx) => runTool(ctx, 1, async (scope) => {
-        const { logs, mode } = await fetchLogs({
+        const page = await fetchLogs({
             trace_id: args.trace_id,
+            session_id: args.session_id,
             service_name: args.service_name,
             severity_min: args.severity_min,
             query: args.query,
+            start_time: args.start_time,
+            end_time: args.end_time,
             limit: args.limit ?? 50,
+            cursor: args.cursor,
         }, scope.collector);
-        await scope.step(`Fetched ${logs.length} log record(s)`);
-        const output = { logs, mode };
-        return telemetryToolResult(summarizeLogs(logs, mode), output);
+        await scope.step(`Fetched ${page.logs.length} log record(s)`);
+        const output = {
+            logs: page.logs,
+            mode: page.mode,
+            has_more: page.hasMore,
+            ...(page.nextCursor === undefined ? {} : { next_cursor: page.nextCursor }),
+        };
+        return telemetryToolResult(summarizeLogs(page.logs, page.mode) + pageNote(page), output);
     }));
 }
 //# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/write-tools.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The tools that change something: annotations, saved queries and the one
+ * delete tool, plus the two saved-query reads that belong with them.
+ *
+ * What they change is limited to objects users create in qyl, inside the
+ * verified caller's Collector project: a note on a trace, span or session, and
+ * a named filter. No tool here edits or deletes a trace, log or metric;
+ * retention alone removes telemetry. Reading and writing stay separate tools,
+ * so a host can approve them separately, and each write is its own tool:
+ * create, update and delete are never one generic executor.
+ *
+ * Annotations follow the contract's tool table: create is not idempotent (each
+ * call adds a note), update and delete are destructive and idempotent (they
+ * replace or remove a version named by its etag, and repeating them changes
+ * nothing more). The create and update tools need `qyl:write`, delete needs
+ * `qyl:delete`, and the saved-query reads keep `qyl:read` (tool-scopes.ts).
+ */
+import type { McpServer } from "@modelcontextprotocol/server";
+/** Adds an object; a repeated call adds another. */
+export declare const CREATE_TOOL_ANNOTATIONS: {
+    readonly readOnlyHint: false;
+    readonly destructiveHint: false;
+    readonly idempotentHint: false;
+    readonly openWorldHint: false;
+};
+/** Replaces the version an etag names; repeating it changes nothing more. */
+export declare const UPDATE_TOOL_ANNOTATIONS: {
+    readonly readOnlyHint: false;
+    readonly destructiveHint: true;
+    readonly idempotentHint: true;
+    readonly openWorldHint: false;
+};
+/** Removes the version an etag names; repeating it removes nothing more. */
+export declare const DELETE_TOOL_ANNOTATIONS: {
+    readonly readOnlyHint: false;
+    readonly destructiveHint: true;
+    readonly idempotentHint: true;
+    readonly openWorldHint: false;
+};
+/** Registers the seven tools; every handler runs inside runTool. */
+export declare function registerWriteTools(server: McpServer): void;

package/dist/write-tools.js

@@ -0,0 +1,214 @@
+/**
+ * The tools that change something: annotations, saved queries and the one
+ * delete tool, plus the two saved-query reads that belong with them.
+ *
+ * What they change is limited to objects users create in qyl, inside the
+ * verified caller's Collector project: a note on a trace, span or session, and
+ * a named filter. No tool here edits or deletes a trace, log or metric;
+ * retention alone removes telemetry. Reading and writing stay separate tools,
+ * so a host can approve them separately, and each write is its own tool:
+ * create, update and delete are never one generic executor.
+ *
+ * Annotations follow the contract's tool table: create is not idempotent (each
+ * call adds a note), update and delete are destructive and idempotent (they
+ * replace or remove a version named by its etag, and repeating them changes
+ * nothing more). The create and update tools need `qyl:write`, delete needs
+ * `qyl:delete`, and the saved-query reads keep `qyl:read` (tool-scopes.ts).
+ */
+import { compactOutputSchema, contractSchema } from "./contract-validation.js";
+import { annotationLine, createAnnotation, createSavedQuery, deleteResource, describeTarget, listSavedQueries, runSavedQuery, updateAnnotation, updateSavedQuery, } from "./collector-resources.js";
+import { QYL_MCP_DELETE_SCOPE, QYL_MCP_SCOPE, QYL_MCP_WRITE_SCOPE } from "./oauth.js";
+import { runTool } from "./request-scope.js";
+import { humanizeNs, pageNote, shortId } from "./summaries.js";
+import { telemetryToolResult } from "./telemetry-redaction.js";
+import { assertToolScopes, toolScopeChallenge } from "./tool-scopes.js";
+import { READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS, TELEMETRY_TOOL_AUTH_META } from "./tools.js";
+/** Adds an object; a repeated call adds another. */
+export const CREATE_TOOL_ANNOTATIONS = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: false,
+};
+/** Replaces the version an etag names; repeating it changes nothing more. */
+export const UPDATE_TOOL_ANNOTATIONS = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+/** Removes the version an etag names; repeating it removes nothing more. */
+export const DELETE_TOOL_ANNOTATIONS = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+const WRITE_SCOPES = [QYL_MCP_SCOPE, QYL_MCP_WRITE_SCOPE];
+const DELETE_SCOPES = [QYL_MCP_SCOPE, QYL_MCP_DELETE_SCOPE];
+/** OpenAI's per-tool `securitySchemes`, in the `_meta` form the read tools use. */
+function securityMeta(scopes) {
+    return { securitySchemes: [{ type: "oauth2", scopes: [...scopes] }] };
+}
+const CreateAnnotationInputSchema = contractSchema("Mcp.Tools.CreateAnnotationInput");
+const UpdateAnnotationInputSchema = contractSchema("Mcp.Tools.UpdateAnnotationInput");
+const AnnotationOutputSchema = contractSchema("Mcp.Tools.AnnotationOutput");
+const CreateSavedQueryInputSchema = contractSchema("Mcp.Tools.CreateSavedQueryInput");
+const UpdateSavedQueryInputSchema = contractSchema("Mcp.Tools.UpdateSavedQueryInput");
+const SavedQueryOutputSchema = contractSchema("Mcp.Tools.SavedQueryOutput");
+const ListSavedQueriesInputSchema = contractSchema("Mcp.Tools.ListSavedQueriesInput");
+const ListSavedQueriesOutputSchema = contractSchema("Mcp.Tools.ListSavedQueriesOutput");
+const RunSavedQueryInputSchema = contractSchema("Mcp.Tools.RunSavedQueryInput");
+const RunSavedQueryOutputSchema = contractSchema("Mcp.Tools.RunSavedQueryOutput");
+const DeleteInputSchema = contractSchema("Mcp.Tools.DeleteInput");
+const DeleteOutputSchema = contractSchema("Mcp.Tools.DeleteOutput");
+function savedQueryLine(query) {
+    const description = query.description ? ` — ${query.description.replace(/\s+/gu, " ").slice(0, 120)}` : "";
+    return `- ${query.name} (${query.filter.signal}) · id ${query.id} · etag ${query.etag}${description}`;
+}
+function summarizeRun(id, result) {
+    switch (result.signal) {
+        case "traces": {
+            const rows = result.items.map((trace) => `- ${shortId(trace.trace_id)} ${trace.root_span?.name ?? "unknown root"} · ${humanizeNs(trace.duration_ns)} · ` +
+                `${trace.span_count} spans · ${trace.has_error ? "ERROR" : "OK"} · ${trace.services.slice(0, 3).join(", ")}`);
+            return `Saved query ${id}: ${result.items.length} trace(s)` +
+                (rows.length === 0 ? "." : `\n${rows.join("\n")}`) + pageNote({ hasMore: result.has_more });
+        }
+        case "logs":
+            return `Saved query ${id}: ${result.items.length} log record(s); the records are in the structured result.` +
+                pageNote({ hasMore: result.has_more });
+        case "metrics":
+            return `Saved query ${id}: ${result.result.name} ${result.result.aggregation} over ` +
+                `${result.result.start_time}..${result.result.end_time}, ${result.result.series.length} series` +
+                (result.result.truncated ? " (truncated at the series limit)" : "") + ".";
+    }
+}
+/** Registers the seven tools; every handler runs inside runTool. */
+export function registerWriteTools(server) {
+    server.registerTool("create_annotation", {
+        title: "Create Annotation",
+        description: "Attach a plain-text note of at most 2000 characters to a trace, a span or a session " +
+            "in the user's qyl project when the user wants to record a finding next to the telemetry. " +
+            "The note leaves the telemetry it points at unchanged; get_trace and list_sessions return " +
+            "it with its id and etag. Each call adds a new annotation.",
+        inputSchema: CreateAnnotationInputSchema,
+        outputSchema: compactOutputSchema(AnnotationOutputSchema),
+        annotations: CREATE_TOOL_ANNOTATIONS,
+        scopeChallenge: toolScopeChallenge("create_annotation", WRITE_SCOPES),
+        _meta: securityMeta(WRITE_SCOPES),
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
+        assertToolScopes("create_annotation", WRITE_SCOPES, ctx.http?.authInfo);
+        const annotation = await createAnnotation(args, scope.collector);
+        await scope.step(`Created annotation ${annotation.id}`);
+        const output = { annotation };
+        return telemetryToolResult(`Created annotation ${annotation.id} on ${describeTarget(annotation.target)} (etag ${annotation.etag}).`, output);
+    }));
+    server.registerTool("update_annotation", {
+        title: "Update Annotation",
+        description: "Replace the text of one annotation when the user wants to correct or extend a note. " +
+            "Pass its id and current etag from get_trace, list_sessions or create_annotation; a stale " +
+            "etag is refused instead of overwriting a newer version. What the note is attached to stays fixed.",
+        inputSchema: UpdateAnnotationInputSchema,
+        outputSchema: compactOutputSchema(AnnotationOutputSchema),
+        annotations: UPDATE_TOOL_ANNOTATIONS,
+        scopeChallenge: toolScopeChallenge("update_annotation", WRITE_SCOPES),
+        _meta: securityMeta(WRITE_SCOPES),
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
+        assertToolScopes("update_annotation", WRITE_SCOPES, ctx.http?.authInfo);
+        const annotation = await updateAnnotation(args, scope.collector);
+        await scope.step(`Updated annotation ${annotation.id}`);
+        const output = { annotation };
+        return telemetryToolResult(`Updated annotation ${annotation.id}; its etag is now ${annotation.etag}.\n${annotationLine(annotation)}`, output);
+    }));
+    server.registerTool("create_saved_query", {
+        title: "Create Saved Query",
+        description: "Save a named filter for traces, logs or metrics in the user's qyl project when the user " +
+            "wants to ask the same question again later. Names are unique per project. Only the filter " +
+            "is stored, never results; run_saved_query evaluates it against the telemetry of that moment.",
+        inputSchema: CreateSavedQueryInputSchema,
+        outputSchema: compactOutputSchema(SavedQueryOutputSchema),
+        annotations: CREATE_TOOL_ANNOTATIONS,
+        scopeChallenge: toolScopeChallenge("create_saved_query", WRITE_SCOPES),
+        _meta: securityMeta(WRITE_SCOPES),
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
+        assertToolScopes("create_saved_query", WRITE_SCOPES, ctx.http?.authInfo);
+        const savedQuery = await createSavedQuery(args, scope.collector);
+        await scope.step(`Created saved query ${savedQuery.id}`);
+        const output = { saved_query: savedQuery };
+        return telemetryToolResult(`Created saved query ${savedQuery.name} (${savedQuery.filter.signal}), id ${savedQuery.id}, ` +
+            `etag ${savedQuery.etag}.`, output);
+    }));
+    server.registerTool("update_saved_query", {
+        title: "Update Saved Query",
+        description: "Rename a saved query or change its description or filter when the user wants to adjust a " +
+            "stored question. Pass its id and current etag from list_saved_queries or create_saved_query; " +
+            "omitted fields keep their value, and a stale etag is refused instead of overwriting a newer version.",
+        inputSchema: UpdateSavedQueryInputSchema,
+        outputSchema: compactOutputSchema(SavedQueryOutputSchema),
+        annotations: UPDATE_TOOL_ANNOTATIONS,
+        scopeChallenge: toolScopeChallenge("update_saved_query", WRITE_SCOPES),
+        _meta: securityMeta(WRITE_SCOPES),
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
+        assertToolScopes("update_saved_query", WRITE_SCOPES, ctx.http?.authInfo);
+        const savedQuery = await updateSavedQuery(args, scope.collector);
+        await scope.step(`Updated saved query ${savedQuery.id}`);
+        const output = { saved_query: savedQuery };
+        return telemetryToolResult(`Updated saved query ${savedQuery.id}; its etag is now ${savedQuery.etag}.\n${savedQueryLine(savedQuery)}`, output);
+    }));
+    server.registerTool("list_saved_queries", {
+        title: "List Saved Queries",
+        description: "List the saved queries in the user's qyl project by name when the user wants to find a " +
+            "stored question to run, change or delete, optionally only those for traces, logs or metrics. " +
+            "Each entry carries its id, etag and filter; pass next_cursor as cursor for the next page.",
+        inputSchema: ListSavedQueriesInputSchema,
+        outputSchema: compactOutputSchema(ListSavedQueriesOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
+        const page = await listSavedQueries(args, scope.collector);
+        await scope.step(`Fetched ${page.savedQueries.length} saved query(s)`);
+        const output = {
+            saved_queries: page.savedQueries,
+            has_more: page.hasMore,
+            ...(page.nextCursor === undefined ? {} : { next_cursor: page.nextCursor }),
+        };
+        const text = page.savedQueries.length === 0
+            ? `No saved queries${args.signal === undefined ? "" : ` for ${args.signal}`} in this project.`
+            : `Saved queries (${page.savedQueries.length}):\n${page.savedQueries.map(savedQueryLine).join("\n")}`;
+        return telemetryToolResult(text + pageNote(page), output);
+    }));
+    server.registerTool("run_saved_query", {
+        title: "Run Saved Query",
+        description: "Run one saved query against the current telemetry when the user wants the stored question's " +
+            "answer now: trace summaries, log records or a metric range result, depending on its signal. " +
+            "It only reads. start_time and end_time replace the saved look-back window, and next_cursor " +
+            "pages trace and log results.",
+        inputSchema: RunSavedQueryInputSchema,
+        outputSchema: compactOutputSchema(RunSavedQueryOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
+        const result = await runSavedQuery(args, scope.collector);
+        await scope.step(`Ran saved query ${args.id}`);
+        const output = { result, mode: "live" };
+        return telemetryToolResult(summarizeRun(args.id, result), output);
+    }));
+    server.registerTool("delete", {
+        title: "Delete Annotation or Saved Query",
+        description: "Delete one annotation or saved query by id when the user asks to remove it. Pass its current " +
+            "etag; a stale etag is refused instead of deleting a newer version. It deletes only objects users " +
+            "created in qyl, never traces, logs or metrics: retention removes telemetry.",
+        inputSchema: DeleteInputSchema,
+        outputSchema: compactOutputSchema(DeleteOutputSchema),
+        annotations: DELETE_TOOL_ANNOTATIONS,
+        scopeChallenge: toolScopeChallenge("delete", DELETE_SCOPES),
+        _meta: securityMeta(DELETE_SCOPES),
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
+        assertToolScopes("delete", DELETE_SCOPES, ctx.http?.authInfo);
+        await deleteResource(args.kind, args.id, args.etag, scope.collector);
+        await scope.step(`Deleted ${args.kind} ${args.id}`);
+        const output = { deleted: true };
+        return telemetryToolResult(`Deleted ${args.kind === "annotation" ? "annotation" : "saved query"} ${args.id}.`, output);
+    }));
+}
+//# sourceMappingURL=write-tools.js.map

package/dist/write-tools.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qyl-mcp-server",
-  "version": "7.3.1",
+  "version": "7.5.0",
   "type": "module",
   "description": "qyl telemetry MCP Apps server: trace explorer and MCP dashboard for a live collector or explicit demo mode",
   "repository": {
@@ -78,7 +78,7 @@
     "smoke:projects": "node project-access-smoke.mjs"
   },
   "dependencies": {
-    "@ancplua/qyl-api-schema": "11.5.0",
+    "@ancplua/qyl-api-schema": "11.6.0",
     "@modelcontextprotocol/core": "2.3.1",
     "@modelcontextprotocol/server": "2.3.1",
     "@opentelemetry/api": "1.9.1",