qyl-mcp-server 0.1.0

package/dist/stats.js

@@ -0,0 +1,141 @@
+/**
+ * MCP dashboard aggregation — shared verbatim by the demo and live paths so
+ * the demo dataset exercises exactly the code that renders production stats.
+ */
+export function spanAttr(span, key) {
+    const attr = span.attributes?.find((a) => a.key === key);
+    return attr === undefined || attr.value === undefined
+        ? undefined
+        : String(attr.value);
+}
+/**
+ * Pick a clean bucket size that tiles the window into 24–48 buckets.
+ * For every integer hours in 1–168 the resulting count lands in range.
+ */
+export function pickBucketMs(windowMs) {
+    const MINUTE = 60_000;
+    const candidates = [
+        MINUTE, 2 * MINUTE, 5 * MINUTE, 10 * MINUTE, 15 * MINUTE, 30 * MINUTE,
+        60 * MINUTE, 120 * MINUTE, 180 * MINUTE, 240 * MINUTE, 360 * MINUTE,
+    ];
+    for (const candidate of candidates) {
+        if (Math.ceil(windowMs / candidate) <= 48)
+            return candidate;
+    }
+    return candidates[candidates.length - 1];
+}
+const round2 = (n) => Math.round(n * 100) / 100;
+const round4 = (n) => Math.round(n * 10_000) / 10_000;
+/** Nearest-rank 95th percentile of an ascending-sorted array. */
+function nearestRankP95(sortedAsc) {
+    return sortedAsc[Math.max(0, Math.ceil(sortedAsc.length * 0.95) - 1)];
+}
+const MCP_METHOD_NAME_RE = /^(initialize|ping|tools\/(?:call|list)|resources\/(?:read|list|templates\/list|subscribe|unsubscribe)|prompts\/(?:get|list)|completion\/complete|logging\/setLevel|notifications\/[\w/]+)(?:\s+(.+))?$/;
+/**
+ * Classify a span as MCP traffic. Attributes win (full-fidelity emitters); the
+ * span-name fallback ("tools/call get_trace") recovers method and tool when a
+ * collector redacts incubating MCP attributes.
+ */
+function classifyMcpSpan(span) {
+    const attrMethod = spanAttr(span, "mcp.method.name");
+    const nameMatch = MCP_METHOD_NAME_RE.exec(span.name ?? "");
+    const method = attrMethod ?? nameMatch?.[1];
+    if (method === undefined)
+        return null;
+    const target = nameMatch?.[2];
+    const tool = spanAttr(span, "gen_ai.tool.name") ??
+        (method === "tools/call" ? target : undefined);
+    return { method, tool };
+}
+/**
+ * Aggregate flattened spans into McpDashboardStats (minus mode/truncated,
+ * which depend on the data source). Classified MCP spans starting inside
+ * [windowStart, windowEnd] count; durations come from the span nano fields;
+ * error = status.code 2.
+ */
+export function aggregateMcpStats(spans, windowStart, windowEnd, bucketMs) {
+    const startNano = windowStart * 1e6;
+    const endNano = windowEnd * 1e6;
+    const mcpSpans = [];
+    for (const s of spans) {
+        if (s.start_time_unix_nano < startNano || s.start_time_unix_nano > endNano)
+            continue;
+        const cls = classifyMcpSpan(s);
+        if (cls)
+            mcpSpans.push({ span: s, cls });
+    }
+    const bucketCount = Math.max(1, Math.ceil((windowEnd - windowStart) / bucketMs));
+    const buckets = Array.from({ length: bucketCount }, (_, i) => ({
+        start: new Date(windowStart + i * bucketMs).toISOString(),
+        requests: 0,
+        errors: 0,
+    }));
+    const byServer = new Map();
+    const byTransport = new Map();
+    const byMethod = new Map();
+    const toolAcc = new Map();
+    const bump = (map, name) => map.set(name, (map.get(name) ?? 0) + 1);
+    const accumulate = (map, name, error, ms) => {
+        let acc = map.get(name);
+        if (!acc)
+            map.set(name, (acc = { requests: 0, errors: 0, durations: [] }));
+        acc.requests++;
+        if (error)
+            acc.errors++;
+        acc.durations.push(ms);
+    };
+    let totalErrors = 0;
+    for (const { span, cls } of mcpSpans) {
+        const error = span.status.code === 2;
+        if (error)
+            totalErrors++;
+        const ms = (span.end_time_unix_nano - span.start_time_unix_nano) / 1e6;
+        const startMs = span.start_time_unix_nano / 1e6;
+        const index = Math.min(bucketCount - 1, Math.max(0, Math.floor((startMs - windowStart) / bucketMs)));
+        buckets[index].requests++;
+        if (error)
+            buckets[index].errors++;
+        bump(byServer, spanAttr(span, "service.peer.name") ?? "unknown");
+        bump(byTransport, spanAttr(span, "network.transport") ?? "unknown");
+        bump(byMethod, cls.method);
+        if (cls.tool !== undefined)
+            accumulate(toolAcc, cls.tool, error, ms);
+    }
+    const toNameRequests = (map) => [...map]
+        .map(([name, requests]) => ({ name, requests }))
+        .sort((a, b) => b.requests - a.requests);
+    const toRows = (map) => [...map]
+        .map(([name, acc]) => {
+        const sorted = [...acc.durations].sort((a, b) => a - b);
+        const sum = sorted.reduce((total, d) => total + d, 0);
+        return {
+            name,
+            requests: acc.requests,
+            errors: acc.errors,
+            error_rate: round4(acc.errors / acc.requests),
+            avg_ms: round2(sum / sorted.length),
+            p95_ms: round2(nearestRankP95(sorted)),
+        };
+    })
+        .sort((a, b) => b.requests - a.requests);
+    const requests = mcpSpans.length;
+    return {
+        window: {
+            start: new Date(windowStart).toISOString(),
+            end: new Date(windowEnd).toISOString(),
+            bucket_ms: bucketMs,
+        },
+        buckets,
+        totals: {
+            requests,
+            errors: totalErrors,
+            error_rate: requests > 0 ? round4(totalErrors / requests) : 0,
+        },
+        by_server: toNameRequests(byServer),
+        by_transport: toNameRequests(byTransport),
+        by_method: toNameRequests(byMethod),
+        tools: toRows(toolAcc),
+        span_count_analyzed: requests,
+    };
+}
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

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

package/dist/summaries.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Text summaries (compact and model-friendly) for tool results.
+ */
+import type { McpDashboardStats, Mode, QylLogRecord, QylSession, QylTrace } from "./wire.js";
+/** Humanize a nanosecond duration: "1.24 s" / "87 ms" / "640 µs". */
+export declare function humanizeNs(ns: number): string;
+export declare function shortId(id: string): string;
+/** Root span name, or the earliest span when no root is identified. */
+export declare function rootSpanName(trace: QylTrace): string;
+export declare function summarizeTraceTable(traces: QylTrace[], mode: Mode): string;
+export declare function summarizeTrace(trace: QylTrace, mode: Mode): string;
+export declare function summarizeSessions(sessions: QylSession[], mode: Mode): string;
+export declare function summarizeLogs(logs: QylLogRecord[], mode: Mode): string;
+export declare function summarizeMcpStats(stats: McpDashboardStats, hours: number): string;

package/dist/summaries.js

@@ -0,0 +1,128 @@
+/**
+ * Text summaries (compact and model-friendly) for tool results.
+ */
+import { logBodyText } from "./log-body.js";
+/** Humanize a nanosecond duration: "1.24 s" / "87 ms" / "640 µs". */
+export function humanizeNs(ns) {
+    if (ns >= 1e9)
+        return `${(ns / 1e9).toFixed(2)} s`;
+    if (ns >= 1e6)
+        return `${Math.round(ns / 1e6)} ms`;
+    return `${Math.round(ns / 1e3)} µs`;
+}
+export function shortId(id) {
+    return id.length > 8 ? `${id.slice(0, 8)}…` : id;
+}
+/** Root span name, or the earliest span when no root is identified. */
+export function rootSpanName(trace) {
+    if (trace.root_span?.name)
+        return trace.root_span.name;
+    const earliest = [...(trace.spans ?? [])].sort((a, b) => a.start_time_unix_nano - b.start_time_unix_nano)[0];
+    return earliest?.name ?? "unknown";
+}
+function serviceOf(span) {
+    return String(span.resource?.["service.name"] ?? "unknown");
+}
+function modeNote(mode) {
+    return mode === "demo" ? " [demo data]" : "";
+}
+export function summarizeTraceTable(traces, mode) {
+    const lines = [
+        `Traces (${traces.length})${modeNote(mode)}`,
+        "",
+        "| Trace | Root span | Spans | Duration | Status | Services |",
+        "|-------|-----------|-------|----------|--------|----------|",
+    ];
+    for (const trace of traces) {
+        const services = trace.services.slice(0, 3).join(", ") +
+            (trace.services.length > 3 ? ` +${trace.services.length - 3}` : "");
+        lines.push(`| ${shortId(trace.trace_id)} | ${rootSpanName(trace)} | ${trace.span_count} | ` +
+            `${humanizeNs(trace.duration_ns)} | ${trace.has_error ? "ERROR" : "OK"} | ${services} |`);
+    }
+    return lines.join("\n");
+}
+export function summarizeTrace(trace, mode) {
+    const spansByService = new Map();
+    for (const span of trace.spans) {
+        const service = serviceOf(span);
+        spansByService.set(service, (spansByService.get(service) ?? 0) + 1);
+    }
+    const perService = [...spansByService]
+        .map(([service, count]) => `${service} ×${count}`)
+        .join(", ");
+    const lines = [
+        `Trace ${trace.trace_id}${modeNote(mode)}`,
+        `Root: ${rootSpanName(trace)} — ${humanizeNs(trace.duration_ns)}, ` +
+            `${trace.span_count} spans, started ${trace.start_time}`,
+        `Spans by service: ${perService}`,
+    ];
+    const errorSpans = trace.spans.filter((s) => s.status.code === 2);
+    if (errorSpans.length > 0) {
+        lines.push(`Error spans (${errorSpans.length}):`);
+        for (const span of errorSpans) {
+            lines.push(`- ${span.name} (${serviceOf(span)})` +
+                (span.status.message ? ` — ${span.status.message}` : ""));
+        }
+    }
+    return lines.join("\n");
+}
+export function summarizeSessions(sessions, mode) {
+    const lines = [
+        `Sessions (${sessions.length})${modeNote(mode)}`,
+        "",
+        "| Session | State | Traces | Spans | Errors | Duration | GenAI |",
+        "|---------|-------|--------|-------|--------|----------|-------|",
+    ];
+    for (const session of sessions) {
+        const duration = session.duration_ms !== undefined
+            ? humanizeNs(session.duration_ms * 1e6)
+            : "—";
+        const genai = session.genai_usage
+            ? `${session.genai_usage.request_count} req, ` +
+                `${session.genai_usage.total_input_tokens}/${session.genai_usage.total_output_tokens} tok`
+            : "—";
+        lines.push(`| ${session["session.id"]} | ${session.state} | ${session.trace_count} | ` +
+            `${session.span_count} | ${session.error_count} | ${duration} | ${genai} |`);
+    }
+    return lines.join("\n");
+}
+export function summarizeLogs(logs, mode) {
+    if (logs.length === 0)
+        return `No logs matched${modeNote(mode)}.`;
+    const lines = logs.map((record) => {
+        const time = new Date(record.time_unix_nano / 1e6)
+            .toISOString()
+            .slice(11, 23);
+        const severity = record.severity_text ?? String(record.severity_number);
+        const renderedBody = logBodyText(record.body).replace(/\s+/g, " ");
+        const body = renderedBody.length > 140
+            ? `${renderedBody.slice(0, 140)}…`
+            : renderedBody;
+        const correlation = record.trace_id
+            ? ` (trace ${shortId(record.trace_id)})`
+            : "";
+        return `- ${time} ${severity} [${String(record.resource["service.name"] ?? "unknown")}] ${body}${correlation}`;
+    });
+    return `Logs (${logs.length})${modeNote(mode)}\n${lines.join("\n")}`;
+}
+export function summarizeMcpStats(stats, hours) {
+    const pct = (rate) => `${(rate * 100).toFixed(1)}%`;
+    const nameList = (rows) => rows.map((r) => `${r.name} ×${r.requests}`).join(", ") || "—";
+    const lines = [
+        `MCP traffic — last ${hours}h${modeNote(stats.mode)}` +
+            (stats.truncated ? " (truncated at the 1000-trace fetch cap)" : ""),
+        `Requests: ${stats.totals.requests}, errors: ${stats.totals.errors} ` +
+            `(${pct(stats.totals.error_rate)})`,
+        `Servers: ${nameList(stats.by_server)}`,
+        `Transports: ${nameList(stats.by_transport)}`,
+        `Methods: ${nameList(stats.by_method)}`,
+    ];
+    if (stats.tools.length > 0) {
+        lines.push("", "| Tool | Requests | Error rate | p95 |", "|------|----------|------------|-----|");
+        for (const tool of stats.tools.slice(0, 5)) {
+            lines.push(`| ${tool.name} | ${tool.requests} | ${pct(tool.error_rate)} | ${tool.p95_ms} ms |`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=summaries.js.map

package/dist/summaries.js.map

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

package/dist/telemetry-redaction.d.ts

@@ -0,0 +1,6 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/** Redact already-validated telemetry while preserving its published shape. */
+export declare function redactTelemetry<T>(value: T): T;
+export declare function redactTelemetryText(value: string): string;
+/** Final MCP result guard for both model text and structured telemetry. */
+export declare function telemetryToolResult<T extends object>(text: string, output: T): CallToolResult;

package/dist/telemetry-redaction.js

@@ -0,0 +1,28 @@
+import { isCredentialKey, SecretRedactor } from "./secret-redactor.js";
+// The standalone server and the runner share this implementation through the
+// server package export. Keep one process-local instance so configured secret
+// values remain available for every result path without ever being serialized.
+const redactor = new SecretRedactor({ environment: process.env });
+function registerCurrentEnvironmentSecrets() {
+    redactor.registerSecretValues(Object.entries(process.env)
+        .filter(([name, value]) => value !== undefined && isCredentialKey(name))
+        .map(([, value]) => value));
+}
+/** Redact already-validated telemetry while preserving its published shape. */
+export function redactTelemetry(value) {
+    registerCurrentEnvironmentSecrets();
+    return redactor.redact(value);
+}
+export function redactTelemetryText(value) {
+    registerCurrentEnvironmentSecrets();
+    return redactor.redactText(value);
+}
+/** Final MCP result guard for both model text and structured telemetry. */
+export function telemetryToolResult(text, output) {
+    const safeOutput = redactTelemetry(output);
+    return {
+        content: [{ type: "text", text: redactTelemetryText(text) }],
+        structuredContent: safeOutput,
+    };
+}
+//# sourceMappingURL=telemetry-redaction.js.map

package/dist/telemetry-redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-redaction.js","sourceRoot":"","sources":["../src/telemetry-redaction.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEvE,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAElE,SAAS,iCAAiC;IACxC,QAAQ,CAAC,oBAAoB,CAC3B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;SACvE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAe,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAI,KAAQ;IACzC,iCAAiC,EAAE,CAAC;IACpC,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAM,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,iCAAiC,EAAE,CAAC;IACpC,OAAO,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,MAAS;IAET,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,iBAAiB,EAAE,UAAgD;KACpE,CAAC;AACJ,CAAC"}

package/dist/telemetry.d.ts

@@ -0,0 +1,72 @@
+/** MCP self-telemetry exported through the official OpenTelemetry SDK. */
+import { type Tracer } from "@opentelemetry/api";
+import { type McpPropagationCarrier, type McpOperationInput, type McpSessionInput } from "./mcp-semconv.js";
+import { SecretRedactor } from "./secret-redactor.js";
+export { WorkbenchTelemetryAttributes, describeMcpOperationMetric, describeMcpOperationSpan, describeMcpSessionMetric, type McpOperationInput, type McpPropagationCarrier, type McpSessionInput, } from "./mcp-semconv.js";
+export declare const MCP_DURATION_EXPLICIT_BUCKET_BOUNDARIES: readonly [0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300];
+export interface McpSpanCorrelation {
+    traceId: string;
+    spanId: string;
+}
+export type McpOperationStartInput = Omit<McpOperationInput, "endTimeMs" | "errorType" | "rpcResponseStatusCode" | "jsonRpcRequestId">;
+export interface McpOperationCompletion {
+    endTimeMs: number;
+    errorType?: string;
+    rpcResponseStatusCode?: string;
+    jsonRpcRequestId?: string | number;
+    protocolVersion?: string;
+    mcpSessionId?: string;
+}
+export interface ActiveMcpOperation {
+    readonly correlation?: McpSpanCorrelation;
+    readonly propagation?: McpPropagationCarrier;
+    /** Compatibility view of the standard W3C field in `propagation`. */
+    readonly traceparent?: string;
+    run<T>(operation: () => T): T;
+    end(completion: McpOperationCompletion): McpSpanCorrelation | undefined;
+}
+export interface McpTelemetryOptions {
+    /** Test/embedding seam; production creates its isolated OTLP tracer. */
+    tracer?: Tracer;
+}
+/**
+ * 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 declare function runWithMcpPropagation<T>(carrier: McpPropagationCarrier | undefined, operation: () => T): T;
+/** Compatibility wrapper for callers that only have a W3C traceparent. */
+export declare function runWithMcpTraceparent<T>(traceparent: string | undefined, operation: () => T): T;
+/** Current execution-local propagation carrier, if an MCP operation exists. */
+export declare function currentMcpPropagation(): McpPropagationCarrier | undefined;
+/** Current execution-local W3C trace parent, if a client operation span exists. */
+export declare function currentMcpTraceparent(): string | undefined;
+export declare function signalEndpoint(env: Readonly<Record<string, string | undefined>>, signal: "traces" | "metrics"): string;
+/**
+ * Records completed MCP operations and sessions without installing global SDK
+ * providers. Signal-specific descriptors prevent span-only identifiers from
+ * appearing on duration histograms.
+ */
+export declare class McpTelemetry {
+    private readonly traceProvider?;
+    private readonly metricProvider?;
+    private tracer?;
+    private readonly histograms;
+    private readonly redactor;
+    get operationTracingEnabled(): boolean;
+    constructor(env?: Readonly<Record<string, string | undefined>>, redactor?: SecretRedactor, options?: McpTelemetryOptions);
+    /**
+     * 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: McpOperationStartInput): ActiveMcpOperation;
+    /** Record one already-completed client or server operation. Never throws. */
+    recordOperation(input: McpOperationInput): McpSpanCorrelation | undefined;
+    /** Record one completed client or server session histogram. Never throws. */
+    recordSession(input: McpSessionInput): void;
+    /** Flush and stop both SDK providers during runner shutdown. */
+    close(): Promise<void>;
+    private recordOperationMetric;
+}