qyl-mcp-server 0.1.0

package/dist/telemetry.js

@@ -0,0 +1,362 @@
+/** MCP self-telemetry exported through the official OpenTelemetry SDK. */
+import { context, defaultTextMapGetter, defaultTextMapSetter, isSpanContextValid, propagation, ROOT_CONTEXT, SpanStatusCode, trace, } from "@opentelemetry/api";
+import { CompositePropagator, W3CBaggagePropagator, W3CTraceContextPropagator, } from "@opentelemetry/core";
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-proto";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { MeterProvider, PeriodicExportingMetricReader, } from "@opentelemetry/sdk-metrics";
+import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { ATTR_SERVICE_INSTANCE_ID, ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION, } from "@opentelemetry/semantic-conventions";
+import { METRIC_MCP_CLIENT_OPERATION_DURATION, METRIC_MCP_CLIENT_SESSION_DURATION, METRIC_MCP_SERVER_OPERATION_DURATION, METRIC_MCP_SERVER_SESSION_DURATION, } from "@opentelemetry/semantic-conventions/incubating";
+import qylOpenApi from "@ancplua/qyl-api-schema/openapi" with { type: "json" };
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
+import packageMetadata from "../package.json" with { type: "json" };
+import { describeMcpOperationMetric, describeMcpOperationSpan, describeMcpSessionMetric, } from "./mcp-semconv.js";
+import { isObservabilitySelfExportSuppressed } from "./observability-suppression.js";
+import { SecretRedactor } from "./secret-redactor.js";
+export { WorkbenchTelemetryAttributes, describeMcpOperationMetric, describeMcpOperationSpan, describeMcpSessionMetric, } from "./mcp-semconv.js";
+const Product = {
+    name: "qyl.mcp",
+    version: packageMetadata.version,
+};
+const FLUSH_INTERVAL_MS = 5_000;
+const MAX_QUEUE = 512;
+const EXPORT_TIMEOUT_MS = 3_000;
+const ATTRIBUTE_VALUE_LIMIT = 2_000;
+const MAX_PROPAGATION_FIELDS = 32;
+const MAX_PROPAGATION_KEY_CHARACTERS = 256;
+const MAX_PROPAGATION_VALUE_CHARACTERS = 8_192;
+const INSTRUMENTATION_SCOPE = "qyl.mcp";
+const STANDARD_MCP_PROPAGATOR = new CompositePropagator({
+    propagators: [
+        new W3CTraceContextPropagator(),
+        new W3CBaggagePropagator(),
+    ],
+});
+export const MCP_DURATION_EXPLICIT_BUCKET_BOUNDARIES = [
+    0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300,
+];
+const API_KEY_HEADER = qylOpenApi.components.securitySchemes.ApiKeyAuth.name;
+if (typeof API_KEY_HEADER !== "string" || API_KEY_HEADER.length === 0) {
+    throw new Error("published Qyl OpenAPI has no API-key header name");
+}
+const activeMcpContext = new AsyncLocalStorage();
+/**
+ * Carries one explicitly-created MCP operation through SDK dispatch without
+ * installing a global OpenTelemetry provider or context manager. A null store
+ * deliberately clears any outer operation so unrelated requests cannot inherit
+ * stale propagation state.
+ */
+export function runWithMcpPropagation(carrier, operation) {
+    if (carrier === undefined)
+        return activeMcpContext.run(null, operation);
+    const extracted = extractPropagation(context.active(), carrier);
+    return activeMcpContext.run(extracted, () => context.with(extracted, operation));
+}
+/** Compatibility wrapper for callers that only have a W3C traceparent. */
+export function runWithMcpTraceparent(traceparent, operation) {
+    return runWithMcpPropagation(traceparent === undefined ? undefined : { traceparent }, operation);
+}
+/** Current execution-local propagation carrier, if an MCP operation exists. */
+export function currentMcpPropagation() {
+    const active = activeMcpContext.getStore();
+    return active === null || active === undefined ? undefined : injectPropagation(active);
+}
+/** Current execution-local W3C trace parent, if a client operation span exists. */
+export function currentMcpTraceparent() {
+    return currentMcpPropagation()?.traceparent;
+}
+export function signalEndpoint(env, signal) {
+    const explicit = signal === "traces"
+        ? env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT
+        : env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT;
+    if (explicit)
+        return explicit;
+    const base = (env.QYL_OTLP_ENDPOINT
+        ?? env.QYL_COLLECTOR_URL
+        ?? env.OTEL_EXPORTER_OTLP_ENDPOINT
+        ?? "http://127.0.0.1:4318").replace(/\/+$/, "");
+    return `${base}/v1/${signal}`;
+}
+/**
+ * Records completed MCP operations and sessions without installing global SDK
+ * providers. Signal-specific descriptors prevent span-only identifiers from
+ * appearing on duration histograms.
+ */
+export class McpTelemetry {
+    traceProvider;
+    metricProvider;
+    tracer;
+    histograms = new Map();
+    redactor;
+    get operationTracingEnabled() {
+        return this.tracer !== undefined;
+    }
+    constructor(env = process.env, redactor = new SecretRedactor({ environment: env }), options = {}) {
+        this.redactor = redactor;
+        this.tracer = options.tracer;
+        if (env.QYL_MCP_TELEMETRY === "0")
+            return;
+        const resource = resourceFromAttributes({
+            [ATTR_SERVICE_NAME]: Product.name,
+            [ATTR_SERVICE_VERSION]: Product.version,
+            [ATTR_SERVICE_INSTANCE_ID]: randomUUID(),
+        });
+        const headers = env.QYL_API_KEY?.trim()
+            ? { [API_KEY_HEADER]: env.QYL_API_KEY.trim() }
+            : undefined;
+        const traceExporter = new OTLPTraceExporter({
+            url: signalEndpoint(env, "traces"),
+            timeoutMillis: EXPORT_TIMEOUT_MS,
+            headers,
+        });
+        const processor = new BatchSpanProcessor(traceExporter, {
+            maxQueueSize: MAX_QUEUE,
+            maxExportBatchSize: MAX_QUEUE,
+            scheduledDelayMillis: FLUSH_INTERVAL_MS,
+            exportTimeoutMillis: EXPORT_TIMEOUT_MS,
+        });
+        this.traceProvider = new NodeTracerProvider({
+            resource,
+            spanProcessors: [processor],
+            spanLimits: {
+                attributeValueLengthLimit: ATTRIBUTE_VALUE_LIMIT,
+                attributeCountLimit: 32,
+                eventCountLimit: 0,
+                linkCountLimit: 1,
+            },
+        });
+        this.tracer ??= this.traceProvider.getTracer(INSTRUMENTATION_SCOPE, Product.version);
+        const metricExporter = new OTLPMetricExporter({
+            url: signalEndpoint(env, "metrics"),
+            timeoutMillis: EXPORT_TIMEOUT_MS,
+            headers,
+        });
+        this.metricProvider = new MeterProvider({
+            resource,
+            readers: [new PeriodicExportingMetricReader({
+                    exporter: metricExporter,
+                    exportIntervalMillis: FLUSH_INTERVAL_MS,
+                    exportTimeoutMillis: EXPORT_TIMEOUT_MS,
+                })],
+        });
+        const meter = this.metricProvider.getMeter(INSTRUMENTATION_SCOPE, Product.version);
+        for (const name of [
+            METRIC_MCP_CLIENT_OPERATION_DURATION,
+            METRIC_MCP_CLIENT_SESSION_DURATION,
+            METRIC_MCP_SERVER_OPERATION_DURATION,
+            METRIC_MCP_SERVER_SESSION_DURATION,
+        ]) {
+            this.histograms.set(name, meter.createHistogram(name, {
+                unit: "s",
+                advice: {
+                    explicitBucketBoundaries: [...MCP_DURATION_EXPLICIT_BUCKET_BOUNDARIES],
+                },
+            }));
+        }
+    }
+    /**
+     * Start an MCP operation before the SDK call so its trace context can be
+     * propagated. Completion-only attributes are applied immediately before
+     * ending the span, and the metric is recorded exactly once at completion.
+     */
+    startOperation(input) {
+        if (isObservabilitySelfExportSuppressed())
+            return inactiveOperation();
+        const ambientContext = activeMcpContext.getStore() ?? context.active();
+        const baseParentContext = input.role === "server" ? ROOT_CONTEXT : ambientContext;
+        const parentContext = input.remotePropagation === undefined
+            ? baseParentContext
+            : extractPropagation(baseParentContext, input.remotePropagation);
+        const links = operationLinks(input.role, ambientContext, parentContext);
+        let span;
+        let operationContext;
+        if (this.tracer) {
+            try {
+                const descriptor = describeMcpOperationSpan({
+                    ...input,
+                    endTimeMs: input.startTimeMs,
+                }, this.redactor);
+                span = this.tracer.startSpan(descriptor.name, {
+                    kind: descriptor.kind,
+                    attributes: descriptor.attributes,
+                    startTime: input.startTimeMs,
+                    ...(links === undefined ? {} : { links }),
+                }, parentContext);
+                operationContext = trace.setSpan(parentContext, span);
+            }
+            catch {
+                // Self-telemetry must never change the MCP request.
+            }
+        }
+        const identifiers = span?.spanContext();
+        const correlation = identifiers !== undefined && isSpanContextValid(identifiers)
+            ? { traceId: identifiers.traceId, spanId: identifiers.spanId }
+            : undefined;
+        const carrier = operationContext === undefined
+            ? undefined
+            : injectPropagation(operationContext);
+        const traceparent = carrier?.traceparent;
+        let ended = false;
+        return {
+            ...(correlation === undefined ? {} : { correlation }),
+            ...(carrier === undefined ? {} : { propagation: carrier }),
+            ...(traceparent === undefined ? {} : { traceparent }),
+            run: (operation) => operationContext === undefined
+                ? operation()
+                : activeMcpContext.run(operationContext, () => context.with(operationContext, operation)),
+            end: (completion) => {
+                if (ended)
+                    return correlation;
+                ended = true;
+                const completed = { ...input, ...completion };
+                let metric;
+                try {
+                    metric = describeMcpOperationMetric(completed, this.redactor);
+                }
+                catch {
+                    // Self-telemetry must never change the MCP response.
+                }
+                if (span === undefined) {
+                    this.recordOperationMetric(metric);
+                    return correlation;
+                }
+                try {
+                    try {
+                        const descriptor = describeMcpOperationSpan(completed, this.redactor);
+                        span.setAttributes(descriptor.attributes);
+                    }
+                    catch {
+                        // Keep the already-started span valid even if optional completion data is invalid.
+                    }
+                    if (metric !== undefined) {
+                        this.histograms.get(metric.name)?.record(metric.value, metric.attributes, operationContext);
+                        metric = undefined;
+                    }
+                    if (completed.errorType) {
+                        span.setStatus({ code: SpanStatusCode.ERROR });
+                    }
+                }
+                catch {
+                    // Self-telemetry must never change the MCP response.
+                }
+                finally {
+                    try {
+                        span.end(completed.endTimeMs);
+                    }
+                    catch {
+                        // Self-telemetry must never change the MCP response.
+                    }
+                }
+                this.recordOperationMetric(metric);
+                return correlation;
+            },
+        };
+    }
+    /** Record one already-completed client or server operation. Never throws. */
+    recordOperation(input) {
+        const { endTimeMs, errorType, rpcResponseStatusCode, jsonRpcRequestId, ...start } = input;
+        return this.startOperation(start).end({
+            endTimeMs,
+            ...(errorType === undefined ? {} : { errorType }),
+            ...(rpcResponseStatusCode === undefined ? {} : { rpcResponseStatusCode }),
+            ...(jsonRpcRequestId === undefined ? {} : { jsonRpcRequestId }),
+        });
+    }
+    /** Record one completed client or server session histogram. Never throws. */
+    recordSession(input) {
+        if (isObservabilitySelfExportSuppressed())
+            return;
+        try {
+            const metric = describeMcpSessionMetric(input, this.redactor);
+            this.histograms.get(metric.name)?.record(metric.value, metric.attributes);
+        }
+        catch {
+            // Self-telemetry must never change connection shutdown.
+        }
+    }
+    /** Flush and stop both SDK providers during runner shutdown. */
+    async close() {
+        await Promise.all([
+            this.traceProvider?.shutdown(),
+            this.metricProvider?.shutdown(),
+        ]);
+    }
+    recordOperationMetric(metric) {
+        if (metric === undefined)
+            return;
+        try {
+            this.histograms.get(metric.name)?.record(metric.value, metric.attributes);
+        }
+        catch {
+            // Self-telemetry must never change the MCP response.
+        }
+    }
+}
+function inactiveOperation() {
+    return {
+        run: (operation) => operation(),
+        end: () => undefined,
+    };
+}
+function extractPropagation(base, carrier) {
+    let extracted = STANDARD_MCP_PROPAGATOR.extract(base, carrier, defaultTextMapGetter);
+    try {
+        extracted = propagation.extract(extracted, carrier, defaultTextMapGetter);
+    }
+    catch {
+        // A host-configured propagator cannot change MCP behavior.
+    }
+    return extracted;
+}
+function injectPropagation(value) {
+    const staging = Object.create(null);
+    STANDARD_MCP_PROPAGATOR.inject(value, staging, defaultTextMapSetter);
+    try {
+        propagation.inject(value, staging, defaultTextMapSetter);
+    }
+    catch {
+        // Retain the standard W3C fields when a host propagator fails.
+    }
+    const bounded = Object.create(null);
+    for (const [key, entry] of prioritizedPropagationEntries(staging)) {
+        if (key.length === 0
+            || key.length > MAX_PROPAGATION_KEY_CHARACTERS
+            || typeof entry !== "string"
+            || entry.length > MAX_PROPAGATION_VALUE_CHARACTERS) {
+            continue;
+        }
+        bounded[key] = entry;
+        if (Object.keys(bounded).length >= MAX_PROPAGATION_FIELDS)
+            break;
+    }
+    return Object.keys(bounded).length === 0
+        ? undefined
+        : Object.freeze({ ...bounded });
+}
+function operationLinks(role, ambientContext, parentContext) {
+    if (role !== "server")
+        return undefined;
+    const ambient = trace.getSpanContext(ambientContext);
+    const parent = trace.getSpanContext(parentContext);
+    if (ambient === undefined || !isSpanContextValid(ambient)) {
+        return undefined;
+    }
+    if (parent !== undefined
+        && isSpanContextValid(parent)
+        && ambient.traceId === parent.traceId
+        && ambient.spanId === parent.spanId)
+        return undefined;
+    return [{ context: ambient }];
+}
+function prioritizedPropagationEntries(value) {
+    const entries = Object.entries(value);
+    const priority = new Set(["traceparent", "tracestate", "baggage"]);
+    return [
+        ...entries.filter(([key]) => priority.has(key)),
+        ...entries.filter(([key]) => !priority.has(key)),
+    ];
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,17 @@
+/** Qyl's directly registered, read-only telemetry tools. */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * The qyl telemetry tools only query the configured collector. They neither
+ * mutate it nor reach an unbounded set of external entities.
+ */
+export declare const READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS: {
+    readonly readOnlyHint: true;
+    readonly destructiveHint: false;
+    readonly idempotentHint: true;
+    readonly openWorldHint: false;
+};
+/** Uniform failure result: clear text + isError, never a thrown exception. */
+export declare function toolError(err: unknown): CallToolResult;
+/** Register the four model-visible read tools against published contract schemas. */
+export declare function registerTelemetryTools(server: McpServer): void;

package/dist/tools.js

@@ -0,0 +1,111 @@
+/** Qyl's directly registered, read-only telemetry tools. */
+import { GetTraceInputSchema, GetTraceOutputSchema, ListSessionsInputSchema, ListSessionsOutputSchema, ListTracesInputSchema, ListTracesOutputSchema, SearchLogsInputSchema, SearchLogsOutputSchema, } from "./contract-validation.js";
+import { fetchLogs, fetchSessions, fetchTrace, fetchTraces } from "./data.js";
+import { summarizeLogs, summarizeSessions, summarizeTrace, summarizeTraceTable, } from "./summaries.js";
+import { CollectorError } from "./collector.js";
+import { redactTelemetryText, telemetryToolResult, } from "./telemetry-redaction.js";
+/**
+ * The qyl telemetry tools only query the configured collector. They neither
+ * mutate it nor reach an unbounded set of external entities.
+ */
+export const READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+/** Uniform failure result: clear text + isError, never a thrown exception. */
+export function toolError(err) {
+    const message = err instanceof CollectorError
+        ? err.message
+        : "Telemetry request failed.";
+    return {
+        content: [{ type: "text", text: redactTelemetryText(message) }],
+        isError: true,
+    };
+}
+/** 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.",
+        inputSchema: ListTracesInputSchema,
+        outputSchema: ListTracesOutputSchema,
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+    }, async (args) => {
+        try {
+            const { traces, mode } = await fetchTraces(args.limit ?? 20);
+            const output = {
+                traces: traces.map(({ spans: _spans, ...summary }) => summary),
+                mode,
+            };
+            return telemetryToolResult(summarizeTraceTable(traces, mode), output);
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    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.",
+        inputSchema: GetTraceInputSchema,
+        outputSchema: GetTraceOutputSchema,
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+    }, async (args) => {
+        try {
+            const { trace, mode } = await fetchTrace(args.trace_id);
+            const output = { trace, mode };
+            return telemetryToolResult(summarizeTrace(trace, mode), output);
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    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.",
+        inputSchema: ListSessionsInputSchema,
+        outputSchema: ListSessionsOutputSchema,
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+    }, async (args) => {
+        try {
+            const { sessions, mode } = await fetchSessions(args.limit ?? 20, args.active_only);
+            const output = { sessions, mode };
+            return telemetryToolResult(summarizeSessions(sessions, mode), output);
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    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.",
+        inputSchema: SearchLogsInputSchema,
+        outputSchema: SearchLogsOutputSchema,
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+    }, async (args) => {
+        try {
+            const { logs, mode } = await fetchLogs({
+                trace_id: args.trace_id,
+                service_name: args.service_name,
+                severity_min: args.severity_min,
+                query: args.query,
+                limit: args.limit ?? 50,
+            });
+            const output = { logs, mode };
+            return telemetryToolResult(summarizeLogs(logs, mode), output);
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAiB5D,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;CACc,CAAC;AAErC,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,MAAM,OAAO,GAAG,GAAG,YAAY,cAAc;QAC3C,CAAC,CAAC,GAAG,CAAC,OAAO;QACb,CAAC,CAAC,2BAA2B,CAAC;IAChC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,6EAA6E;YAC7E,iFAAiF;YACjF,sFAAsF;QACxF,WAAW,EAAE,qBAAqB;QAClC,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE,oCAAoC;KAClD,EACD,KAAK,EAAE,IAAqB,EAA2B,EAAE;QACvD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC7D,MAAM,MAAM,GAAqB;gBAC/B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC;gBAC9D,IAAI;aACL,CAAC;YACF,OAAO,mBAAmB,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EACT,0EAA0E;YAC1E,2EAA2E;YAC3E,mCAAmC;QACrC,WAAW,EAAE,mBAAmB;QAChC,YAAY,EAAE,oBAAoB;QAClC,WAAW,EAAE,oCAAoC;KAClD,EACD,KAAK,EAAE,IAAmB,EAA2B,EAAE;QACrD,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxD,MAAM,MAAM,GAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAC/C,OAAO,mBAAmB,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,yEAAyE;YACzE,oEAAoE;YACpE,sCAAsC;QACxC,WAAW,EAAE,uBAAuB;QACpC,YAAY,EAAE,wBAAwB;QACtC,WAAW,EAAE,oCAAoC;KAClD,EACD,KAAK,EAAE,IAAuB,EAA2B,EAAE;QACzD,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;YACnF,MAAM,MAAM,GAAuB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACtD,OAAO,mBAAmB,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,4EAA4E;YAC5E,0EAA0E;YAC1E,uBAAuB;QACzB,WAAW,EAAE,qBAAqB;QAClC,YAAY,EAAE,sBAAsB;QACpC,WAAW,EAAE,oCAAoC;KAClD,EACD,KAAK,EAAE,IAAqB,EAA2B,EAAE;QACvD,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,SAAS,CAAC;gBACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;aACxB,CAAC,CAAC;YACH,MAAM,MAAM,GAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAChD,OAAO,mBAAmB,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/wire.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Internal aliases over the generated Qyl contract types. This module contains
+ * no handwritten wire shape; TypeSpec and its published JSON Schema own both
+ * compile-time types and runtime validators.
+ */
+import type { McpDataMode, McpToolStats } from "@ancplua/qyl-api-schema/types";
+export type { LogRecord as QylLogRecord, McpDashboardStats, SessionEntity as QylSession, Span as QylSpan, Trace as QylTrace, } from "@ancplua/qyl-api-schema/types";
+export type Mode = McpDataMode;
+export type McpToolRow = McpToolStats;
+export { LogRecordSchema, McpDashboardStatsSchema, ModeSchema, ProblemDetailsSchema, SessionSchema, SpanSchema, TraceSchema, TraceSummarySchema, } from "./contract-validation.js";

package/dist/wire.js

@@ -0,0 +1,7 @@
+/**
+ * Internal aliases over the generated Qyl contract types. This module contains
+ * no handwritten wire shape; TypeSpec and its published JSON Schema own both
+ * compile-time types and runtime validators.
+ */
+export { LogRecordSchema, McpDashboardStatsSchema, ModeSchema, ProblemDetailsSchema, SessionSchema, SpanSchema, TraceSchema, TraceSummarySchema, } from "./contract-validation.js";
+//# sourceMappingURL=wire.js.map

package/dist/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,WAAW,EACX,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "qyl-mcp-server",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "qyl telemetry MCP Apps server: trace explorer and MCP dashboard for a live collector or explicit demo mode",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ANcpLua/qyl.mcp",
+    "directory": "server"
+  },
+  "license": "MIT",
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./contract-validation": {
+      "types": "./dist/contract-validation.d.ts",
+      "default": "./dist/contract-validation.js"
+    },
+    "./secret-redactor": {
+      "types": "./dist/secret-redactor.d.ts",
+      "default": "./dist/secret-redactor.js"
+    },
+    "./atomic-json-store": {
+      "types": "./dist/atomic-json-store.d.ts",
+      "default": "./dist/atomic-json-store.js"
+    },
+    "./execution-evidence": {
+      "types": "./dist/execution-evidence.d.ts",
+      "default": "./dist/execution-evidence.js"
+    },
+    "./execution-result": {
+      "types": "./dist/execution-result.d.ts",
+      "default": "./dist/execution-result.js"
+    },
+    "./mcp-semconv": {
+      "types": "./dist/mcp-semconv.d.ts",
+      "default": "./dist/mcp-semconv.js"
+    },
+    "./observability-suppression": {
+      "types": "./dist/observability-suppression.d.ts",
+      "default": "./dist/observability-suppression.js"
+    },
+    "./telemetry": {
+      "types": "./dist/telemetry.d.ts",
+      "default": "./dist/telemetry.js"
+    }
+  },
+  "bin": {
+    "qyl-mcp-server": "dist/main.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true }); require('node:fs').rmSync('dist-test', { recursive: true, force: true })\"",
+    "build": "npm run clean && tsc --noEmit && vite build --mode mcp-app && vite build --mode mcp-dashboard && tsc -p tsconfig.server.json && node -e \"require('node:fs').chmodSync('dist/main.js', 0o755)\"",
+    "test": "npm run build && tsc -p tsconfig.test.json && node --test dist-test/*.test.js",
+    "smoke": "node smoke-test.mjs",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@ancplua/qyl-api-schema": "1.0.2",
+    "@modelcontextprotocol/ext-apps": "^1.7.4",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/core": "^2.9.0",
+    "@opentelemetry/exporter-metrics-otlp-proto": "^0.220.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.220.0",
+    "@opentelemetry/resources": "^2.9.0",
+    "@opentelemetry/sdk-metrics": "^2.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.9.0",
+    "@opentelemetry/sdk-trace-node": "^2.9.0",
+    "@opentelemetry/semantic-conventions": "^1.43.0",
+    "express": "^5.2.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/express": "5.0.6",
+    "@types/node": "24.13.3",
+    "typescript": "7.0.2",
+    "vite": "8.1.4",
+    "vite-plugin-singlefile": "2.3.3"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  }
+}