qyl-mcp-server 7.3.0 → 7.4.0

package/dist/contract-operations.js

@@ -1,124 +0,0 @@
-/**
- * Tool INPUT shapes derived from the published operation parameters.
- *
- * contract-validation.ts binds every response body and every `Mcp.Tools.*`
- * shape the contract publishes. The metrics read API arrived in
- * @ancplua/qyl-api-schema 8.0.0 with its response bodies but without
- * `Mcp.Tools.*Metric*` input shapes, so there is nothing there to bind for the
- * arguments of `list_metrics`, `get_metric_series`, and `query_metric`.
- *
- * Hand-writing those three objects is exactly what architecture gate G10a
- * exists to prevent, and an exemption would carve the hole in the one place the
- * gate names first ("request, response, or tool-input shapes"). So the inputs
- * are generated too — from the other artifact the contract package publishes,
- * its OpenAPI document. Every name, type, bound, default, enum, and description
- * a metrics tool advertises is read out of `@ancplua/qyl-api-schema/openapi` at
- * startup; nothing here is typed by hand except which operation a tool wraps,
- * which is the same standing as `Operations.TracesApi_list.Response.200` being
- * named in contract-validation.ts. A parameter added, retyped, or re-bounded on
- * the collector side therefore moves the tool's advertised input and fails the
- * G10b manifest snapshot, instead of drifting silently.
- *
- * This module is deliberately NOT re-exported through contract-validation.ts:
- * the OpenAPI document is ~730 KB and that module is also imported by the
- * dashboard and workbench browser bundles.
- *
- * When the contract publishes `Mcp.Tools.ListMetricsInput` and friends, delete
- * this file and bind them in contract-validation.ts like every other tool.
- */
-import { createRequire } from "node:module";
-import * as z from "zod/v4";
-const COMPONENT_SCHEMA_PREFIX = "#/components/schemas/";
-// require() rather than an import attribute: the package's "./openapi" export
-// declares no "types" condition, so a static JSON import has no type to resolve
-// and `verbatimModuleSyntax` would have to be worked around at every call site.
-const publishedOpenApi = createRequire(import.meta.url)("@ancplua/qyl-api-schema/openapi");
-/**
- * Rewrite a published parameter schema into the subset `z.fromJSONSchema`
- * accepts, resolving component references as it goes.
- *
- * Two published constructs need it, for the same reasons the contract package's
- * own zod adapter documents: `unevaluatedProperties` is rejected outright by
- * `z.fromJSONSchema` and is only ever used to seal an object, and a
- * `#/components/schemas/...` reference has no meaning once the parameter is
- * lifted out of the OpenAPI document. Resolution is by inlining, which is exact
- * for the enums and scalars parameters actually use and would need a `$defs`
- * carrier if a parameter ever referenced a recursive model.
- */
-function resolvePublishedSchema(node, seen = []) {
-    if (Array.isArray(node))
-        return node.map((item) => resolvePublishedSchema(item, seen));
-    if (typeof node !== "object" || node === null)
-        return node;
-    const source = node;
-    const resolved = {};
-    for (const [key, value] of Object.entries(source)) {
-        if (key === "unevaluatedProperties" || key === "$ref")
-            continue;
-        resolved[key] = resolvePublishedSchema(value, seen);
-    }
-    const reference = source.$ref;
-    if (typeof reference !== "string")
-        return resolved;
-    if (!reference.startsWith(COMPONENT_SCHEMA_PREFIX)) {
-        throw new Error(`contract-operations: unsupported parameter reference ${reference}`);
-    }
-    const name = reference.slice(COMPONENT_SCHEMA_PREFIX.length);
-    if (seen.includes(name)) {
-        throw new Error(`contract-operations: ${name} is recursive; a parameter referencing it needs a ` +
-            "$defs carrier rather than inlining");
-    }
-    const target = publishedOpenApi.components.schemas[name];
-    if (target === undefined) {
-        throw new Error(`contract-operations: ${reference} is not a published component schema`);
-    }
-    // A `$ref` with siblings is how the contract spells "this published model,
-    // with this default" — `aggregation` is `MetricAggregation` plus
-    // `default: "avg"`. Dropping the siblings would silently drop the default and
-    // leave the tool advertising a required-looking enum with no fallback, so the
-    // resolved target is merged UNDER them: the local keywords win.
-    return { ...resolvePublishedSchema(target, [...seen, name]), ...resolved };
-}
-/**
- * The tool-input schema for one published GET operation.
- *
- * Header parameters are excluded: `ProjectScopeHeader` is the server-owned
- * collector project scope, which QYL_PROJECT sets and a model never supplies —
- * the same boundary the root README states for every other tool.
- */
-export function operationInputSchema(pathname) {
-    const operation = publishedOpenApi.paths[pathname]?.get;
-    if (operation === undefined) {
-        throw new Error(`contract-operations: the contract publishes no GET ${pathname}`);
-    }
-    const properties = {};
-    const required = [];
-    for (const parameter of operation.parameters ?? []) {
-        // A $ref parameter is a shared component; the only one the metrics
-        // operations use is the project-scope header.
-        if (parameter.$ref !== undefined || parameter.name === undefined)
-            continue;
-        if (parameter.in === "header")
-            continue;
-        const schema = resolvePublishedSchema(parameter.schema);
-        properties[parameter.name] = parameter.description === undefined
-            ? schema
-            : { ...schema, description: parameter.description };
-        if (parameter.required === true)
-            required.push(parameter.name);
-    }
-    if (Object.keys(properties).length === 0) {
-        throw new Error(`contract-operations: GET ${pathname} publishes no model-supplied parameters`);
-    }
-    // The assembled document is JSON Schema by construction — every property came
-    // out of the published parameter list — but it is built as plain data, so the
-    // cast is what tells the compiler that.
-    const assembled = {
-        type: "object",
-        properties,
-        ...(required.length === 0 ? {} : { required }),
-        additionalProperties: false,
-    };
-    return z.fromJSONSchema(assembled);
-}
-//# sourceMappingURL=contract-operations.js.map

package/dist/contract-operations.js.map

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