qyl-mcp-server 7.1.1 → 7.2.0

package/dist/tools.js

@@ -24,18 +24,55 @@ export const TELEMETRY_TOOL_AUTH_META = {
 };
 /** Re-exported for the callers that learned it here; it lives with `runTool`. */
 export { toolError } from "./request-scope.js";
+function withoutAttributes(value) {
+    const rest = { ...value };
+    delete rest.attributes;
+    return rest;
+}
+function omitSpanAttributes(span) {
+    return {
+        ...withoutAttributes(span),
+        resource: withoutAttributes(span.resource),
+        ...(span.events === undefined ? {} : { events: span.events.map(withoutAttributes) }),
+        ...(span.links === undefined ? {} : { links: span.links.map(withoutAttributes) }),
+        ...(span.instrumentation_scope === undefined ? {} : {
+            instrumentation_scope: withoutAttributes(span.instrumentation_scope),
+        }),
+    };
+}
+function projectTrace(trace, args) {
+    const matching = args.errors_only
+        ? trace.spans.filter((span) => span.status.code === 2)
+        : trace.spans;
+    const selected = matching.slice(0, args.max_spans);
+    const projectSpan = args.include_attributes === false ? omitSpanAttributes : (span) => span;
+    const { root_span: root, ...summary } = trace;
+    // A separate root copy must not reintroduce a span excluded by the filter or cap.
+    const selectedRoot = !args.errors_only && args.max_spans === undefined
+        ? root
+        : selected.find((span) => span.span_id === root?.span_id);
+    return {
+        trace: {
+            ...summary,
+            spans: selected.map(projectSpan),
+            ...(selectedRoot === undefined ? {} : { root_span: projectSpan(selectedRoot) }),
+        },
+        matchingSpanCount: matching.length,
+    };
+}
 /** 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 with summary fields (root span, services, duration, " +
-            "span count, error flag). Spans are omitted — use get_trace for full span data. " +
-            "Use display_traces instead when the user wants to LOOK at traces in the explorer UI.",
+        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. " +
+            "Spans are omitted; get_trace returns the full span tree, while display_traces " +
+            "provides the interactive explorer.",
         inputSchema: ListTracesInputSchema,
         outputSchema: compactOutputSchema(ListTracesOutputSchema),
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
         _meta: TELEMETRY_TOOL_AUTH_META,
-    }, (args, ctx) => runTool(ctx, "list_traces", 1, async (scope) => {
+    }, (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 output = {
@@ -46,29 +83,39 @@ export function registerTelemetryTools(server) {
     }));
     server.registerTool("get_trace", {
         title: "Get Trace",
-        description: "Fetch a single qyl trace by trace id, including every span with timing, " +
-            "attributes, events, and status. Use display_traces instead when the user " +
-            "wants to SEE the trace waterfall.",
+        description: "Fetch a single qyl trace by trace_id when the user wants span timing, " +
+            "events, status, and attributes. By default returns all spans; errors_only " +
+            "keeps error spans, max_spans caps them after filtering in Collector order, " +
+            "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. " +
+            "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, "get_trace", 1, async (scope) => {
+    }, (args, ctx) => runTool(ctx, 1, 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 output = { trace, mode };
-        return telemetryToolResult(summarizeTrace(trace, mode), output);
+        const projected = projectTrace(trace, args);
+        const output = { trace: projected.trace, mode };
+        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." : "");
+        return telemetryToolResult(summary, output);
     }));
     server.registerTool("list_sessions", {
         title: "List Sessions",
-        description: "List qyl sessions with trace/span/error counts, state, and GenAI token " +
-            "usage where present. Pass a session id to display_traces to see a " +
-            "session's traces in the explorer UI.",
+        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. " +
+            "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, "list_sessions", 1, async (scope) => {
+    }, (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 };
@@ -76,14 +123,14 @@ export function registerTelemetryTools(server) {
     }));
     server.registerTool("search_logs", {
         title: "Search Logs",
-        description: "Search qyl log records, filterable by trace id (correlated logs), service " +
-            "name, minimum severity (OTel numbers: 9 INFO, 13 WARN, 17 ERROR), and a " +
-            "body substring query.",
+        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.",
         inputSchema: SearchLogsInputSchema,
         outputSchema: compactOutputSchema(SearchLogsOutputSchema),
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
         _meta: TELEMETRY_TOOL_AUTH_META,
-    }, (args, ctx) => runTool(ctx, "search_logs", 1, async (scope) => {
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
         const { logs, mode } = await fetchLogs({
             trace_id: args.trace_id,
             service_name: args.service_name,

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/trace-query.d.ts

@@ -0,0 +1,5 @@
+import type { DisplayTracesInput } from "@ancplua/qyl-api-schema/types";
+import type { CallToolResult } from "@modelcontextprotocol/server";
+export declare const TRACE_QUERY_META_KEY = "qyl/traceQuery";
+/** Restore the query with its result when a host opens or recreates the viewer. */
+export declare function traceQueryForResult(result: Pick<CallToolResult, "_meta">, fallback: DisplayTracesInput): DisplayTracesInput;

package/dist/trace-query.js

@@ -0,0 +1,8 @@
+import { DisplayTracesInputSchema } from "./contract-validation.js";
+export const TRACE_QUERY_META_KEY = "qyl/traceQuery";
+/** Restore the query with its result when a host opens or recreates the viewer. */
+export function traceQueryForResult(result, fallback) {
+    const parsed = DisplayTracesInputSchema.safeParse(result._meta?.[TRACE_QUERY_META_KEY]);
+    return parsed.success ? parsed.data : fallback;
+}
+//# sourceMappingURL=trace-query.js.map

package/dist/trace-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-query.js","sourceRoot":"","sources":["../src/trace-query.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAErD,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CACjC,MAAqC,EACrC,QAA4B;IAE5B,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACxF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjD,CAAC"}

package/dist/ui-domain.d.ts

@@ -0,0 +1,4 @@
+import { type ServerContext } from "@modelcontextprotocol/server";
+export type UiDomain = string | ((context: ServerContext) => string | undefined);
+/** Client hints select presentation metadata only, never credentials or access. */
+export declare function hostedUiDomain(publicMcpUrl: string): (context: ServerContext) => string | undefined;

package/dist/ui-domain.js

@@ -0,0 +1,28 @@
+import { createHash } from "node:crypto";
+import { CLIENT_INFO_META_KEY } from "@modelcontextprotocol/server";
+/** Client hints select presentation metadata only, never credentials or access. */
+export function hostedUiDomain(publicMcpUrl) {
+    const origin = new URL(publicMcpUrl).origin;
+    // Hash the exact configured connector URL, including its path and trailing slash.
+    const claudeDomain = `${createHash("sha256").update(publicMcpUrl).digest("hex").slice(0, 32)}.claudemcpcontent.com`;
+    return (context) => {
+        const envelope = context.mcpReq.envelope;
+        const clientInfo = envelope && CLIENT_INFO_META_KEY in envelope
+            ? envelope[CLIENT_INFO_META_KEY]
+            : undefined;
+        const clientName = typeof clientInfo === "object" && clientInfo !== null
+            && "name" in clientInfo && typeof clientInfo.name === "string"
+            ? clientInfo.name
+            : undefined;
+        // Stateless legacy HTTP has no retained initialize.clientInfo. Its
+        // per-request User-Agent is a fallback only when SDK clientInfo is absent.
+        const clientHint = clientName ?? context.http?.req?.headers.get("user-agent") ?? "";
+        if (/^(?:claude(?:ai)?(?:[-\s_./]|$)|anthropic\/claude(?:ai)?(?:[-\s_./]|$))/iu.test(clientHint)) {
+            return claudeDomain;
+        }
+        if (/^(?:chatgpt|openai-mcp)(?:[-\s_./]|$)/iu.test(clientHint))
+            return origin;
+        return undefined;
+    };
+}
+//# sourceMappingURL=ui-domain.js.map

package/dist/ui-domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-domain.js","sourceRoot":"","sources":["../src/ui-domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAsB,MAAM,8BAA8B,CAAC;AAIxF,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;IAC5C,kFAAkF;IAClF,MAAM,YAAY,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC;IAEpH,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;QACzC,MAAM,UAAU,GAAG,QAAQ,IAAI,oBAAoB,IAAI,QAAQ;YAC7D,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAChC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,UAAU,GAAG,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI;eACnE,MAAM,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ;YAC9D,CAAC,CAAC,UAAU,CAAC,IAAI;YACjB,CAAC,CAAC,SAAS,CAAC;QACd,mEAAmE;QACnE,2EAA2E;QAC3E,MAAM,UAAU,GAAG,UAAU,IAAI,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACpF,IAAI,2EAA2E,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACjG,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,IAAI,yCAAyC,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,OAAO,MAAM,CAAC;QAC9E,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qyl-mcp-server",
-  "version": "7.1.1",
+  "version": "7.2.0",
   "type": "module",
   "description": "qyl telemetry MCP Apps server: trace explorer and MCP dashboard for a live collector or explicit demo mode",
   "repository": {
@@ -74,10 +74,11 @@
     "test": "bun run verify:readme && bun run verify:frame && bun run build && tsc -p tsconfig.test.json && node -e \"const fs=require('node:fs'); for (const name of ['mcp-app.html','mcp-dashboard.html']) fs.copyFileSync('dist/'+name,'dist-test/'+name)\" && node --test dist-test/*.test.js",
     "smoke": "node smoke-test.mjs",
     "smoke:live": "node live-tools-smoke.mjs",
-    "prepack": "bun run build"
+    "prepack": "bun run build",
+    "smoke:projects": "node project-access-smoke.mjs"
   },
   "dependencies": {
-    "@ancplua/qyl-api-schema": "11.2.0",
+    "@ancplua/qyl-api-schema": "11.3.0",
     "@modelcontextprotocol/core": "2.3.1",
     "@modelcontextprotocol/server": "2.3.1",
     "@opentelemetry/api": "1.9.1",
@@ -99,7 +100,7 @@
     "@modelcontextprotocol/client": "2.3.1",
     "@types/node": "26.6.4",
     "typescript": "7.0.2",
-    "vite": "8.3.2",
+    "vite": "8.3.3",
     "vite-plugin-singlefile": "2.3.3"
   },
   "engines": {