@aexol/spectral 0.9.169 → 0.9.170

package/dist/mcp/ui-stream-types.d.ts

@@ -40,19 +40,19 @@ export declare const visualizationStreamEnvelopeSchema: z.ZodObject<{
     checkpoint: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     status: "error" | "ok";
+    phase: "structure" | "settled" | "shell" | "detail" | "narrative";
     streamId: string;
     sequence: number;
     frameType: "patch" | "checkpoint" | "final";
-    phase: "structure" | "settled" | "shell" | "narrative" | "detail";
     message?: string | undefined;
     spec?: Record<string, unknown> | undefined;
     checkpoint?: Record<string, unknown> | undefined;
 }, {
     status: "error" | "ok";
+    phase: "structure" | "settled" | "shell" | "detail" | "narrative";
     streamId: string;
     sequence: number;
     frameType: "patch" | "checkpoint" | "final";
-    phase: "structure" | "settled" | "shell" | "narrative" | "detail";
     message?: string | undefined;
     spec?: Record<string, unknown> | undefined;
     checkpoint?: Record<string, unknown> | undefined;

package/dist/relay/models-fetch.d.ts

@@ -13,9 +13,10 @@
  *    in its public GraphQL schema (`schema.graphql`); there is no
  *    equivalent REST endpoint and we don't want to add one just for the
  *    CLI.
- *  - The query is parameterless and authenticated via the same Bearer
- *    machine JWT used by `/v1/*`, so a single `fetch` call is enough —
- *    no Zeus client setup required.
+ *
+ * The query is built with the generated Zeus client (`src/generated/zeus`)
+ * instead of a raw `fetch` + hand-written GraphQL string, so the selected
+ * fields and their result shape stay in lock-step with `schema.graphql`.
  *
  * Caching:
  *  - In-memory TTL cache (default 5 min), keyed by `${backendUrl}|${jwt}`.
@@ -53,8 +54,6 @@ export interface AllowedModel {
 export interface FetchAllowedModelsOptions {
     backendUrl: string;
     machineJwt: string;
-    /** Override for tests. */
-    fetchImpl?: typeof fetch;
     /**
      * Bypass the in-memory cache for this call. Tests use this to assert
      * that the network is actually hit; production code never sets it.

package/dist/relay/models-fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models-fetch.d.ts","sourceRoot":"","sources":["../../src/relay/models-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,QAAQ,EAAE,MAAM,CAAC;IACjB;yEACqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,2FAA2F;IAC3F,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAUD,kDAAkD;AAClD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AA0BD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,YAAY,EAAE,CAAC,CAyHzB"}
+{"version":3,"file":"models-fetch.d.ts","sourceRoot":"","sources":["../../src/relay/models-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAQH,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,QAAQ,EAAE,MAAM,CAAC;IACjB;yEACqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,2FAA2F;IAC3F,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAUD,kDAAkD;AAClD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,YAAY,EAAE,CAAC,CA4FzB"}

package/dist/relay/models-fetch.js

@@ -13,9 +13,10 @@
  *    in its public GraphQL schema (`schema.graphql`); there is no
  *    equivalent REST endpoint and we don't want to add one just for the
  *    CLI.
- *  - The query is parameterless and authenticated via the same Bearer
- *    machine JWT used by `/v1/*`, so a single `fetch` call is enough —
- *    no Zeus client setup required.
+ *
+ * The query is built with the generated Zeus client (`src/generated/zeus`)
+ * instead of a raw `fetch` + hand-written GraphQL string, so the selected
+ * fields and their result shape stay in lock-step with `schema.graphql`.
  *
  * Caching:
  *  - In-memory TTL cache (default 5 min), keyed by `${backendUrl}|${jwt}`.
@@ -23,12 +24,12 @@
  *    creates many of them, so we don't want to hammer the GraphQL
  *    endpoint on every reconnect.
  */
+import { classifyGraphqlError, createBackendClient, scalars, } from "../generated/graphql-client.js";
 const cache = new Map();
 /** Test-only helper: drops every cached entry. */
 export function clearAllowedModelsCache() {
     cache.clear();
 }
-const QUERY = `query AvailableAgentModels { availableAgentModels { name provider userModelId agentEnabled creditInputPer1M creditOutputPer1M creditCachedInputPer1M creditCacheReadPer1M creditCacheWritePer1M contextWindow supportsImages supportsReasoning isDefault isVisionDefault } }`;
 /**
  * Fetch the whitelist of allowed base models. Throws on any failure with a
  * message tailored for an operator running `spectral serve` — the caller
@@ -44,93 +45,63 @@ export async function fetchAllowedModels(opts) {
             return hit.models;
         }
     }
-    const fetchImpl = opts.fetchImpl ?? fetch;
     const url = `${opts.backendUrl.replace(/\/$/, "")}/graphql`;
-    let res;
+    let rows;
     try {
-        res = await fetchImpl(url, {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${opts.machineJwt}`,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({ query: QUERY }),
+        const client = createBackendClient({
+            backendUrl: opts.backendUrl,
+            machineJwt: opts.machineJwt,
+        });
+        const result = await client("query", { scalars })({
+            availableAgentModels: [
+                {},
+                {
+                    name: true,
+                    provider: true,
+                    userModelId: true,
+                    agentEnabled: true,
+                    creditInputPer1M: true,
+                    creditOutputPer1M: true,
+                    creditCachedInputPer1M: true,
+                    creditCacheReadPer1M: true,
+                    creditCacheWritePer1M: true,
+                    contextWindow: true,
+                    supportsImages: true,
+                    supportsReasoning: true,
+                    isDefault: true,
+                    isVisionDefault: true,
+                },
+            ],
         });
+        rows = result.availableAgentModels;
     }
     catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
+        const { message: msg } = classifyGraphqlError(err);
         throw new Error(`Failed to fetch allowed models from backend (${url}): ${msg}. ` +
             `Check SPECTRAL_BACKEND_URL and machine JWT.`);
     }
-    if (!res.ok) {
-        let detail = "";
-        try {
-            detail = await res.text();
-        }
-        catch {
-            // ignore
-        }
-        throw new Error(`Failed to fetch allowed models from backend (HTTP ${res.status} ${res.statusText})` +
-            (detail ? `: ${detail.slice(0, 500)}` : "") +
-            ". Check SPECTRAL_BACKEND_URL and machine JWT.");
-    }
-    let payload;
-    try {
-        payload = (await res.json());
-    }
-    catch (err) {
-        throw new Error(`Failed to fetch allowed models: backend returned non-JSON (${err instanceof Error ? err.message : String(err)})`);
-    }
-    if (payload.errors && payload.errors.length > 0) {
-        const msg = payload.errors
-            .map((e) => (typeof e?.message === "string" ? e.message : "unknown"))
-            .join("; ");
-        throw new Error(`Failed to fetch allowed models: GraphQL errors: ${msg}`);
-    }
-    const rows = payload.data?.availableAgentModels;
-    if (!Array.isArray(rows)) {
-        throw new Error(`Failed to fetch allowed models: response missing availableAgentModels array`);
-    }
     const models = [];
-    for (const row of rows) {
-        const name = typeof row?.name === "string" ? row.name : null;
-        const provider = typeof row?.provider === "string" ? row.provider : null;
-        if (!name || !provider)
+    for (const row of rows ?? []) {
+        if (!row?.name || !row?.provider)
             continue; // skip malformed rows defensively
-        const asOptionalNumber = (v) => typeof v === "number" ? v : v == null ? null : undefined;
-        const contextWindow = typeof row?.contextWindow === "number" && row.contextWindow > 0
-            ? row.contextWindow
-            : null;
-        const supportsImages = typeof row?.supportsImages === "boolean"
-            ? row.supportsImages
-            : null;
-        const supportsReasoning = typeof row?.supportsReasoning === "boolean"
-            ? row.supportsReasoning
-            : null;
-        const isDefault = typeof row?.isDefault === "boolean"
-            ? row.isDefault
-            : null;
-        const isVisionDefault = typeof row?.isVisionDefault === "boolean"
-            ? row.isVisionDefault
-            : null;
         const model = {
-            modelId: name,
-            displayName: name,
-            provider,
-            creditInputPer1M: asOptionalNumber(row?.creditInputPer1M),
-            creditOutputPer1M: asOptionalNumber(row?.creditOutputPer1M),
-            creditCachedInputPer1M: asOptionalNumber(row?.creditCachedInputPer1M),
-            creditCacheReadPer1M: asOptionalNumber(row?.creditCacheReadPer1M),
-            creditCacheWritePer1M: asOptionalNumber(row?.creditCacheWritePer1M),
-            contextWindow,
-            supportsImages,
-            supportsReasoning,
-            isDefault,
-            isVisionDefault,
+            modelId: row.name,
+            displayName: row.name,
+            provider: row.provider,
+            userModelId: typeof row.userModelId === "string" ? row.userModelId : undefined,
+            creditInputPer1M: row.creditInputPer1M ?? null,
+            creditOutputPer1M: row.creditOutputPer1M ?? null,
+            creditCachedInputPer1M: row.creditCachedInputPer1M ?? null,
+            creditCacheReadPer1M: row.creditCacheReadPer1M ?? null,
+            creditCacheWritePer1M: row.creditCacheWritePer1M ?? null,
+            contextWindow: typeof row.contextWindow === "number" && row.contextWindow > 0
+                ? row.contextWindow
+                : null,
+            supportsImages: row.supportsImages ?? null,
+            supportsReasoning: row.supportsReasoning ?? null,
+            isDefault: row.isDefault ?? null,
+            isVisionDefault: row.isVisionDefault ?? null,
         };
-        if (typeof row?.userModelId === "string") {
-            model.userModelId = row.userModelId;
-        }
         models.push(model);
     }
     cache.set(key, { fetchedAt: Date.now(), ttlMs, models });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.9.169",
+  "version": "0.9.170",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,