qyl-mcp-server 7.6.1 → 8.0.0

package/dist/analysis-tools.js

@@ -0,0 +1,167 @@
+import { compactOutputSchema, contractSchema } from "./contract-validation.js";
+import { runTool } from "./request-scope.js";
+import { READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS, TELEMETRY_TOOL_AUTH_META } from "./tools.js";
+import { queryAnalysis } from "./analysis-client.js";
+import { collectorPatch, parseCollectorBody } from "./collector.js";
+import { ifMatch, refusals, changeRefusals } from "./collector-resources.js";
+import { assertToolScopes, toolScopeChallenge } from "./tool-scopes.js";
+import { WRITE_SCOPES, UPDATE_TOOL_ANNOTATIONS, securityMeta } from "./write-tools.js";
+import { CollectorError } from "./collector.js";
+import { telemetryToolResult } from "./telemetry-redaction.js";
+const TriageInputSchema = contractSchema("Mcp.Tools.TriageInput");
+const TriageOutputSchema = contractSchema("Mcp.Tools.TriageOutput");
+const ListFailuresInputSchema = contractSchema("Mcp.Tools.ListFailuresInput");
+const ListFailuresOutputSchema = contractSchema("Mcp.Tools.ListFailuresOutput");
+const GetFailureContextInputSchema = contractSchema("Mcp.Tools.GetFailureContextInput");
+const GetFailureContextOutputSchema = contractSchema("Mcp.Tools.GetFailureContextOutput");
+const CompareGroupsInputSchema = contractSchema("Mcp.Tools.CompareGroupsInput");
+const CompareGroupsOutputSchema = contractSchema("Mcp.Tools.CompareGroupsOutput");
+const CompareTracesInputSchema = contractSchema("Mcp.Tools.CompareTracesInput");
+const CompareTracesOutputSchema = contractSchema("Mcp.Tools.CompareTracesOutput");
+const VerifyFixInputSchema = contractSchema("Mcp.Tools.VerifyFixInput");
+const VerifyFixOutputSchema = contractSchema("Mcp.Tools.VerifyFixOutput");
+const AggregateTelemetryInputSchema = contractSchema("Mcp.Tools.AggregateTelemetryInput");
+const AggregateTelemetryOutputSchema = contractSchema("Mcp.Tools.AggregateTelemetryOutput");
+const DiscoverAttributesInputSchema = contractSchema("Mcp.Tools.DiscoverAttributesInput");
+const DiscoverAttributesOutputSchema = contractSchema("Mcp.Tools.DiscoverAttributesOutput");
+const GetAgentRunInputSchema = contractSchema("Mcp.Tools.GetAgentRunInput");
+const GetAgentRunOutputSchema = contractSchema("Mcp.Tools.GetAgentRunOutput");
+const ListReleasesInputSchema = contractSchema("Mcp.Tools.ListReleasesInput");
+const ListReleasesOutputSchema = contractSchema("Mcp.Tools.ListReleasesOutput");
+const GetServiceMapInputSchema = contractSchema("Mcp.Tools.GetServiceMapInput");
+const GetServiceMapOutputSchema = contractSchema("Mcp.Tools.GetServiceMapOutput");
+const CheckTelemetryHealthInputSchema = contractSchema("Mcp.Tools.CheckTelemetryHealthInput");
+const CheckTelemetryHealthOutputSchema = contractSchema("Mcp.Tools.CheckTelemetryHealthOutput");
+const GetMcpStatsInputSchema = contractSchema("Mcp.Tools.GetMcpStatsInput");
+const GetMcpStatsOutputSchema = contractSchema("Mcp.Tools.GetMcpStatsOutput");
+const UpdateFailureStatusInputSchema = contractSchema("Mcp.Tools.UpdateFailureStatusInput");
+const UpdateFailureStatusOutputSchema = contractSchema("Mcp.Tools.UpdateFailureStatusOutput");
+export function registerAnalysisTools(server) {
+    server.registerTool("triage", {
+        title: "Triage",
+        description: "Rank new or worsening failures, performance regressions, releases and silent services when investigating what changed.",
+        inputSchema: TriageInputSchema,
+        outputSchema: compactOutputSchema(TriageOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("triage", args, TriageOutputSchema, scope)));
+    server.registerTool("list_failures", {
+        title: "List Failures",
+        description: "List failures grouped by stable fingerprints when investigating recurring errors or their recorded status.",
+        inputSchema: ListFailuresInputSchema,
+        outputSchema: compactOutputSchema(ListFailuresOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("list_failures", args, ListFailuresOutputSchema, scope)));
+    server.registerTool("get_failure_context", {
+        title: "Get Failure Context",
+        description: "Return the recorded failure path, correlated logs and comparison evidence when investigating a failed execution.",
+        inputSchema: GetFailureContextInputSchema,
+        outputSchema: compactOutputSchema(GetFailureContextOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("get_failure_context", args, GetFailureContextOutputSchema, scope)));
+    server.registerTool("compare_groups", {
+        title: "Compare Groups",
+        description: "Compare attribute distributions and durations between two telemetry groups when identifying associations with a failure.",
+        inputSchema: CompareGroupsInputSchema,
+        outputSchema: compactOutputSchema(CompareGroupsOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("compare_groups", args, CompareGroupsOutputSchema, scope)));
+    server.registerTool("compare_traces", {
+        title: "Compare Traces",
+        description: "Align two executions and locate their first divergence when comparing a failing path with another execution.",
+        inputSchema: CompareTracesInputSchema,
+        outputSchema: compactOutputSchema(CompareTracesOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("compare_traces", args, CompareTracesOutputSchema, scope)));
+    server.registerTool("verify_fix", {
+        title: "Verify Fix",
+        description: "Measure failure recurrence and traffic after a change when checking whether enough evidence supports a fix.",
+        inputSchema: VerifyFixInputSchema,
+        outputSchema: compactOutputSchema(VerifyFixOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("verify_fix", args, VerifyFixOutputSchema, scope)));
+    server.registerTool("aggregate_telemetry", {
+        title: "Aggregate Telemetry",
+        description: "Group spans or logs and calculate counts, error rates and durations when comparing operations or attributes.",
+        inputSchema: AggregateTelemetryInputSchema,
+        outputSchema: compactOutputSchema(AggregateTelemetryOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("aggregate_telemetry", args, AggregateTelemetryOutputSchema, scope)));
+    server.registerTool("discover_attributes", {
+        title: "Discover Attributes",
+        description: "List recorded attribute keys, value distributions and convention descriptions when choosing telemetry filters.",
+        inputSchema: DiscoverAttributesInputSchema,
+        outputSchema: compactOutputSchema(DiscoverAttributesOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("discover_attributes", args, DiscoverAttributesOutputSchema, scope)));
+    server.registerTool("get_agent_run", {
+        title: "Get Agent Run",
+        description: "Reconstruct agent and tool execution steps, token usage and repeated calls when investigating an agent run.",
+        inputSchema: GetAgentRunInputSchema,
+        outputSchema: compactOutputSchema(GetAgentRunOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("get_agent_run", args, GetAgentRunOutputSchema, scope)));
+    server.registerTool("list_releases", {
+        title: "List Releases",
+        description: "List observed service versions and their before-and-after impact when investigating a release.",
+        inputSchema: ListReleasesInputSchema,
+        outputSchema: compactOutputSchema(ListReleasesOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("list_releases", args, ListReleasesOutputSchema, scope)));
+    server.registerTool("get_service_map", {
+        title: "Get Service Map",
+        description: "Return service dependencies and their traffic, error rates and latency when investigating calls between services.",
+        inputSchema: GetServiceMapInputSchema,
+        outputSchema: compactOutputSchema(GetServiceMapOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("get_service_map", args, GetServiceMapOutputSchema, scope)));
+    server.registerTool("check_telemetry_health", {
+        title: "Check Telemetry Health",
+        description: "Report silent services, orphan spans and missing convention attributes when checking telemetry coverage.",
+        inputSchema: CheckTelemetryHealthInputSchema,
+        outputSchema: compactOutputSchema(CheckTelemetryHealthOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("check_telemetry_health", args, CheckTelemetryHealthOutputSchema, scope)));
+    server.registerTool("get_mcp_stats", {
+        title: "Get MCP Stats",
+        description: "Return MCP request totals, failure classes and latency aggregates when investigating MCP tool health.",
+        inputSchema: GetMcpStatsInputSchema,
+        outputSchema: compactOutputSchema(GetMcpStatsOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("get_mcp_stats", args, GetMcpStatsOutputSchema, scope)));
+    server.registerTool("update_failure_status", {
+        title: "Update Failure Status",
+        description: "Set a failure's status or assignee when recording triage decisions, returning the stored failure available through list_failures.",
+        inputSchema: UpdateFailureStatusInputSchema,
+        outputSchema: compactOutputSchema(UpdateFailureStatusOutputSchema),
+        annotations: UPDATE_TOOL_ANNOTATIONS,
+        scopeChallenge: toolScopeChallenge("update_failure_status", WRITE_SCOPES),
+        _meta: securityMeta(WRITE_SCOPES),
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
+        assertToolScopes("update_failure_status", WRITE_SCOPES, ctx.http?.authInfo);
+        if (args.ignore_until !== undefined && args.status !== "ignored")
+            throw new CollectorError("ignore_until is valid only with status=ignored", false, 400, "invalid_argument");
+        const { failure_id, etag, ...changes } = args;
+        const path = `/api/v1/failures/${encodeURIComponent(failure_id)}`;
+        const response = await refusals(changeRefusals("failure", failure_id, "write"), () => collectorPatch(path, changes, {
+            ...scope.collector,
+            headers: { ...scope.collector.headers, ...ifMatch(etag) },
+        }));
+        const output = parseCollectorBody(response, path, UpdateFailureStatusOutputSchema);
+        await scope.step("Failure status saved");
+        return telemetryToolResult("Failure status saved; list_failures returns the current failure.", output);
+    }));
+}
+//# sourceMappingURL=analysis-tools.js.map

package/dist/analysis-tools.js.map

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

package/dist/authorization.d.ts

@@ -3,6 +3,8 @@ export interface ResourceAuthorizationOptions {
     readonly verifier: OAuthTokenVerifier;
     readonly resourceMetadataUrl: string;
     readonly requiredScopes: readonly string[];
+    /** Scopes requested at initial sign-in; individual operations still enforce their own requirements. */
+    readonly authorizationScopes?: readonly string[];
     /** Explicit implications only; a wildcard-looking string grants nothing by itself. */
     readonly scopeImplications?: Readonly<Record<string, readonly string[]>>;
 }

package/dist/authorization.js

@@ -27,6 +27,8 @@ export function scopeClosure(granted, implications) {
 export function createResourceAuthorization(options) {
     const requiredScopes = [...new Set(options.requiredScopes)].sort();
     validateScopes(requiredScopes);
+    const authorizationScopes = [...new Set(options.authorizationScopes ?? requiredScopes)];
+    validateScopes(authorizationScopes);
     const implications = new Map(Object.entries(options.scopeImplications ?? {})
         .map(([scope, implied]) => {
         validateScopes([scope, ...implied]);
@@ -42,10 +44,10 @@ export function createResourceAuthorization(options) {
         verifier: options.verifier,
         resourceMetadataUrl: metadataUrl.href,
     });
-    const challenge = (status, error) => {
+    const challenge = (status, error, scopes = requiredScopes) => {
         const parameters = [
             ...(error === undefined ? [] : [`error="${error}"`]),
-            ...(requiredScopes.length === 0 ? [] : [`scope="${requiredScopes.join(" ")}"`]),
+            ...(scopes.length === 0 ? [] : [`scope="${scopes.join(" ")}"`]),
             `resource_metadata="${metadataUrl.href}"`,
         ];
         return Response.json({ error: error ?? "unauthorized" }, {
@@ -66,15 +68,15 @@ export function createResourceAuthorization(options) {
             headers: { authorization: `Bearer ${bearer[1]}` },
         }));
         if (auth instanceof Response) {
-            // Keep authentication failures distinct from authorization failures and
-            // include the complete operation scope set on every challenge.
+            // Hosts use this scope list for sign-in. Request the complete product
+            // grant here without requiring every scope for a read-only request.
             if (auth.status === 401)
-                return challenge(401, authorization === null ? undefined : "invalid_token");
+                return challenge(401, authorization === null ? undefined : "invalid_token", authorizationScopes);
             return auth;
         }
         const effectiveScopes = scopeClosure(auth.scopes, implications);
         if (!requiredScopes.every((scope) => effectiveScopes.has(scope))) {
-            return challenge(403, "insufficient_scope");
+            return challenge(403, "insufficient_scope", requiredScopes.filter((scope) => !effectiveScopes.has(scope)));
         }
         return auth;
     };

package/dist/authorization.js.map

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

package/dist/ci.d.ts

@@ -1,25 +1,4 @@
-/**
- * Qyl's CI dogfooding block (the fourth tool block next to traces, sessions,
- * and logs): answers "which CI leg hung on what" from qyl's OWN telemetry
- * instead of wrapping the GitHub API.
- *
- * Emitter convention (what CI runs must send to appear here):
- *   - resource `service.name` starts with "qyl-ci" (e.g. "qyl-ci-smoke"),
- *   - `session.id` identifies one workflow run (e.g. "nuget-publish-<run_id>"),
- *   - one span per phase, named after the phase, carrying a `ci.leg` string
- *     attribute (e.g. "macos-latest"); a failed phase sets span status error.
- *
- */
-import type { CiPhase, CiRunSummary } from "@ancplua/qyl-api-schema/types";
+/** CI evidence is computed by the Collector from recorded pipeline tasks. */
 import type { McpServer } from "@modelcontextprotocol/server";
-import type { Mode, QylSession, QylTrace } from "./wire.js";
-/** Resource service-name prefix that marks telemetry as CI-emitted. */
-export declare const CI_SERVICE_PREFIX = "qyl-ci";
-/** CI sessions carry at least one service matching the requested prefix. */
-export declare function filterCiSessions(sessions: QylSession[], servicePrefix?: string): QylSession[];
-/** Flatten a run's traces into per-leg phases, failures first. */
-export declare function collectCiPhases(traces: QylTrace[], servicePrefix?: string): CiPhase[];
-export declare function summarizeCiRuns(runs: CiRunSummary[], mode: Mode, servicePrefix?: string): string;
-export declare function summarizeCiRun(runId: string, phases: CiPhase[], mode: Mode, servicePrefix?: string): string;
-/** Register the CI dogfooding block. */
+/** Query all matching CI telemetry before pagination. */
 export declare function registerCiTools(server: McpServer): void;

package/dist/ci.js

@@ -1,117 +1,16 @@
-import { CiLogInputSchema, CiLogOutputSchema, compactOutputSchema, } from "./contract-validation.js";
-import { fetchSessions, fetchSessionTraces } from "./data.js";
+import { compactOutputSchema, contractSchema } from "./contract-validation.js";
+import { queryAnalysis } from "./analysis-client.js";
 import { runTool } from "./request-scope.js";
-import { telemetryToolResult } from "./telemetry-redaction.js";
 import { READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS, TELEMETRY_TOOL_AUTH_META } from "./tools.js";
-/** Resource service-name prefix that marks telemetry as CI-emitted. */
-export const CI_SERVICE_PREFIX = "qyl-ci";
-/** CI sessions carry at least one service matching the requested prefix. */
-export function filterCiSessions(sessions, servicePrefix = CI_SERVICE_PREFIX) {
-    return sessions.filter((session) => session.services.some((service) => service.startsWith(servicePrefix)));
-}
-function spanLeg(span) {
-    const attribute = span.attributes?.find((entry) => entry.key === "ci.leg");
-    return typeof attribute?.value === "string"
-        ? attribute.value
-        : span.resource.service_name;
-}
-/** Flatten a run's traces into per-leg phases, failures first. */
-export function collectCiPhases(traces, servicePrefix = CI_SERVICE_PREFIX) {
-    const phases = traces.flatMap((trace) => trace.spans.filter((span) => span.resource.service_name.startsWith(servicePrefix)).map((span) => ({
-        leg: spanLeg(span),
-        phase: span.name,
-        status: span.status.code === 2 ? "error" : span.status.code === 1 ? "ok" : "unset",
-        duration_ms: Math.max(0, Math.round(Number(BigInt(span.end_time_unix_nano) - BigInt(span.start_time_unix_nano)) / 1_000_000)),
-        ...(span.status.message ? { message: span.status.message } : {}),
-    })));
-    return phases.sort((a, b) => a.status === b.status
-        ? a.leg.localeCompare(b.leg) || a.phase.localeCompare(b.phase)
-        : a.status === "error"
-            ? -1
-            : b.status === "error"
-                ? 1
-                : 0);
-}
-export function summarizeCiRuns(runs, mode, servicePrefix = CI_SERVICE_PREFIX) {
-    if (runs.length === 0) {
-        return `No CI runs found (${mode} mode). CI telemetry appears once runs emit ` +
-            `spans with a '${servicePrefix}*' service.name.`;
-    }
-    const lines = runs.map((run) => {
-        const failure = run.error_count > 0 ? `${run.error_count} error(s)` : "clean";
-        const duration = run.duration_ms === undefined ? "?" : `${Math.round(run.duration_ms / 1000)}s`;
-        return `- ${run.run_id} [${run.state}] ${run.start_time} ${duration} — ${failure}`;
-    });
-    return `${runs.length} CI run(s) (${mode} mode), pass a run_id for the per-leg breakdown:\n${lines.join("\n")}`;
-}
-export function summarizeCiRun(runId, phases, mode, servicePrefix = CI_SERVICE_PREFIX) {
-    if (phases.length === 0) {
-        return `CI run ${runId} has no phase spans matching '${servicePrefix}*' (${mode} mode).`;
-    }
-    const legs = new Map();
-    for (const phase of phases) {
-        const existing = legs.get(phase.leg);
-        if (existing)
-            existing.push(phase);
-        else
-            legs.set(phase.leg, [phase]);
-    }
-    const lines = [];
-    for (const [leg, legPhases] of legs) {
-        const failed = legPhases.filter((phase) => phase.status === "error");
-        lines.push(`${failed.length > 0 ? "✗" : "✓"} ${leg}`);
-        for (const phase of failed.length > 0 ? failed : legPhases) {
-            const detail = phase.message ? ` — ${phase.message}` : "";
-            lines.push(`    ${phase.status === "error" ? "✗" : "·"} ${phase.phase} (${phase.duration_ms}ms)${detail}`);
-        }
-    }
-    return `CI run ${runId} (${mode} mode):\n${lines.join("\n")}`;
-}
-/** Register the CI dogfooding block. */
+/** Query all matching CI telemetry before pagination. */
 export function registerCiTools(server) {
     server.registerTool("ci_log", {
         title: "CI Log",
-        description: "Read CI telemetry from qyl when the user wants recent runs or a per-leg " +
-            "phase breakdown with failures first. Any CI can emit this convention: " +
-            `resource service.name starts with service_prefix (default '${CI_SERVICE_PREFIX}'), session.id identifies ` +
-            "the run, and one span per phase carries a ci.leg attribute; failed phases " +
-            "set span status to error. Without run_id, filters the 50 most recent " +
-            "sessions and returns up to limit matching runs (default 10). With run_id, " +
-            "reads up to 100 traces for that session and returns only phases matching " +
-            "the same case-sensitive service prefix; phase output can be large.",
-        inputSchema: CiLogInputSchema,
-        outputSchema: compactOutputSchema(CiLogOutputSchema),
+        description: "List or compare CI runs and phase failures when investigating a build or test regression.",
+        inputSchema: contractSchema("Mcp.Tools.CiLogInput"),
+        outputSchema: compactOutputSchema(contractSchema("Mcp.Tools.CiLogOutput")),
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
         _meta: TELEMETRY_TOOL_AUTH_META,
-    }, (args, ctx) => 
-    // A run breakdown is two units a client can watch: the collector round
-    // trip for the run's traces, then the flatten into per-leg phases. The
-    // run list is one round trip.
-    runTool(ctx, args.run_id ? 2 : 1, async (scope) => {
-        const servicePrefix = args.service_prefix ?? CI_SERVICE_PREFIX;
-        if (args.run_id) {
-            const { traces, mode } = await fetchSessionTraces(args.run_id, 100, scope.collector);
-            await scope.step(`Fetched ${traces.length} trace(s) of CI run ${args.run_id}`);
-            const phases = collectCiPhases(traces, servicePrefix);
-            const legs = new Set(phases.map((phase) => phase.leg)).size;
-            await scope.step(`Collected ${phases.length} phase(s) across ${legs} leg(s)`);
-            const output = { run_id: args.run_id, phases, mode };
-            return telemetryToolResult(summarizeCiRun(args.run_id, phases, mode, servicePrefix), output);
-        }
-        const { sessions, mode } = await fetchSessions({ limit: 50 }, scope.collector);
-        const runs = filterCiSessions(sessions, servicePrefix)
-            .slice(0, args.limit ?? 10)
-            .map((session) => ({
-            run_id: session["session_id"],
-            state: session.state,
-            start_time: session.start_time,
-            ...(session.duration_ms === undefined ? {} : { duration_ms: session.duration_ms }),
-            error_count: session.error_count,
-            services: session.services,
-        }));
-        await scope.step(`Found ${runs.length} CI run(s) among ${sessions.length} session(s)`);
-        const output = { runs, mode };
-        return telemetryToolResult(summarizeCiRuns(runs, mode, servicePrefix), output);
-    }));
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("ci_log", args, contractSchema("Mcp.Tools.CiLogOutput"), scope)));
 }
 //# sourceMappingURL=ci.js.map

package/dist/ci.js.map

@@ -1 +1 @@
-{"version":3,"file":"ci.js","sourceRoot":"","sources":["../src/ci.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ci.js","sourceRoot":"","sources":["../src/ci.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,oCAAoC,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC5F,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;QACE,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,2FAA2F;QACxG,WAAW,EAAE,cAAc,CAAC,sBAAsB,CAAC;QACnD,YAAY,EAAE,mBAAmB,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;QAC1E,WAAW,EAAE,oCAAoC;QACjD,KAAK,EAAE,wBAAwB;KAChC,EACD,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAC7C,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,uBAAuB,CAAC,EAAE,KAAK,CAAC,CAAC,CACjF,CAAC;AACJ,CAAC"}

package/dist/collector-resources.d.ts

@@ -7,39 +7,31 @@
  * subject; no argument names a project or a credential. Nothing here changes
  * telemetry: an annotation points at a trace, span or session and leaves it
  * as recorded, and the one delete operation removes only these objects.
- *
- * Demo mode has no Collector and therefore no such objects. A call there is
- * refused rather than answered from an invented store.
  */
-import type { Annotation, CreateAnnotationInput, CreateSavedQueryInput, DeletableKind, ListSavedQueriesInput, RunSavedQueryInput, SavedQuery, SavedQueryRunResult, SessionId, TraceId, UpdateAnnotationInput, UpdateSavedQueryInput } from "@ancplua/qyl-api-schema/types";
+import type { Annotation, CreateAnnotationInput, CreateSavedQueryInput, DeletableKind, SavedQuery, UpdateAnnotationInput, UpdateSavedQueryInput } from "@ancplua/qyl-api-schema/types";
 import { type CollectorRequestOptions } from "./collector.js";
-import { type ToolScope } from "./request-scope.js";
+/**
+ * The If-Match value for a change. An etag is opaque, but it travels as an
+ * HTTP field value, so one that could not be sent is refused here instead of
+ * failing inside fetch as if the Collector were unreachable.
+ */
+export declare function ifMatch(etag: string): Readonly<Record<string, string>>;
+/**
+ * Runs one Collector call and names its refusals for what the caller tried:
+ * a status listed in `messages` becomes that message, keeping the code the
+ * status decides (`not_found`, `conflict`, `precondition_failed`,
+ * `collector_unauthorized`). A body that breaks the contract stays a
+ * contract mismatch, and every other failure passes through unchanged.
+ */
+export declare function refusals<T>(messages: Readonly<Partial<Record<number, string>>>, request: () => Promise<T>): Promise<T>;
+/** The refusals every change to an existing object shares. */
+export declare function changeRefusals(kind: string, id: string, role: "write" | "delete"): Partial<Record<number, string>>;
 export declare function createAnnotation(input: CreateAnnotationInput, options: CollectorRequestOptions): Promise<Annotation>;
 export declare function updateAnnotation(input: UpdateAnnotationInput, options: CollectorRequestOptions): Promise<Annotation>;
 export declare function createSavedQuery(input: CreateSavedQueryInput, options: CollectorRequestOptions): Promise<SavedQuery>;
 export declare function updateSavedQuery(input: UpdateSavedQueryInput, options: CollectorRequestOptions): Promise<SavedQuery>;
-export interface SavedQueryPage {
-    savedQueries: SavedQuery[];
-    hasMore: boolean;
-    nextCursor?: string;
-}
-export declare function listSavedQueries(input: ListSavedQueriesInput, options: CollectorRequestOptions): Promise<SavedQueryPage>;
-export declare function runSavedQuery(input: RunSavedQueryInput, options: CollectorRequestOptions): Promise<SavedQueryRunResult>;
 export declare function deleteResource(kind: DeletableKind, id: string, etag: string, options: CollectorRequestOptions): Promise<void>;
-/** What a read tool adds to its result: the annotations and one text line. */
-export interface AnnotationReadBack {
-    /** Present when the read succeeded; absent in demo mode and when it failed. */
-    annotations?: Annotation[];
-    /** Appended to the tool's text summary; empty when there is nothing to say. */
-    text: string;
-}
 /** The telemetry object an annotation names, in full. */
 export declare function describeTarget(target: Annotation["target"]): string;
 /** One text line per annotation: what it is on, how to change it, and the note. */
 export declare function annotationLine(annotation: Annotation): string;
-/** The text block for a list of annotations, newest first. */
-export declare function summarizeAnnotations(annotations: readonly Annotation[], truncated: boolean): string;
-/** The annotations on one trace and its spans, for get_trace. */
-export declare function readTraceAnnotations(traceId: TraceId, scope: ToolScope): Promise<AnnotationReadBack>;
-/** The annotations on the listed sessions, newest first, for list_sessions. */
-export declare function readSessionAnnotations(sessionIds: readonly SessionId[], scope: ToolScope): Promise<AnnotationReadBack>;