capix-mcp 2.1.0 → 2.2.0

package/dist/tools/generate.js

@@ -0,0 +1,149 @@
+/**
+ * Capix MCP Server — declarative tool generator.
+ *
+ * The generation pattern adapted here — declare method + path + input schema
+ * ONCE in a tool spec, then derive both the MCP tool registration and the
+ * HTTP dispatch from that single declaration — follows the route-registry
+ * approach of OpenShip (https://github.com/oblien/openship),
+ * apps/api/src/modules/mcp/ (mcp-tools.ts / mcp-dispatch.ts).
+ * Copyright the OpenShip contributors, licensed under the Apache License 2.0.
+ * See the NOTICE file at the repository root. Only the pattern is adapted;
+ * this implementation is original and specific to the Capix control plane.
+ *
+ * Why this exists: hand-written tools drift when the control-plane API
+ * changes. A generated tool keeps the endpoint declaration (method, canonical
+ * `/api/v1/*` path, typed Zod input) co-located with the registration, so the
+ * MCP surface and the HTTP call can never disagree.
+ *
+ * The generator enforces the repo's existing control-plane conventions:
+ *
+ *   - problem passthrough — the handler delegates to the shared CapixClient,
+ *     which parses non-2xx responses as problem+json (RFC 9457, which
+ *     obsoletes RFC 7807) and throws CapixApiError; the generator never
+ *     catches or rewrites it, so problem details reach the server wrapper
+ *     (server.ts errorResult) untouched.
+ *   - idempotency        — mutation specs (billable / requiresApproval POST or
+ *     DELETE) route through the client's existing Idempotency-Key helper
+ *     (client.post(..., { idempotent: true }) / client.delete), reusing the
+ *     path+body-hash key derivation in client.ts rather than re-inventing it.
+ *   - typed inputs       — inputs are declared as a Zod raw shape, validated
+ *     by the McpServer before dispatch, exactly like defineTool.
+ *   - approval gate      — billable / requiresApproval specs throw the same
+ *     `approval_required` (402) error shape as callBillable in tools.ts when
+ *     no approvalToken is bound.
+ *   - payload truncation — an optional `transform` post-processes successful
+ *     responses so oversized inline artifacts (SVG, base64) are reduced to a
+ *     pointer (share URL / id) before they reach the agent's context.
+ */
+// ===========================================================================
+// Generator
+// ===========================================================================
+/** Extract `:param` names from a canonical path, in order. */
+export function pathParamsOf(path) {
+    return path
+        .split("/")
+        .filter((s) => s.startsWith(":"))
+        .map((s) => s.slice(1));
+}
+/** Throw the repo-standard approval error (same shape as callBillable). */
+function approvalRequiredError() {
+    const err = new Error("approvalToken is required for this billable tool (§5)");
+    err.capixCode = "approval_required";
+    err.status = 402;
+    return err;
+}
+/** Throw the repo-standard invalid-argument error (same shape as asStr). */
+function invalidArgumentError(field) {
+    const err = new Error(`${field} is required`);
+    err.capixCode = "invalid_argument";
+    err.status = 400;
+    return err;
+}
+/**
+ * Generate a ToolDef from a declarative spec. The returned definition is a
+ * plain ToolDef — indistinguishable from a defineTool declaration to the
+ * server, the registry, and the annotations layer.
+ */
+export function defineGeneratedTool(spec) {
+    const pathParams = pathParamsOf(spec.path);
+    // Declaration-time enforcement: every path param must be a declared input,
+    // so a spec can never reference a path segment the caller cannot supply.
+    for (const param of pathParams) {
+        if (!(param in spec.input)) {
+            throw new Error(`defineGeneratedTool(${spec.name}): path param :${param} is not declared in the input shape`);
+        }
+    }
+    if (spec.method === "GET" && spec.body) {
+        throw new Error(`defineGeneratedTool(${spec.name}): GET tools cannot declare a request body`);
+    }
+    const pathParamSet = new Set(pathParams);
+    const nonPathKeys = Object.keys(spec.input).filter((k) => !pathParamSet.has(k));
+    const queryKeys = spec.query ?? (spec.method === "GET" ? nonPathKeys : []);
+    const bodyKeys = spec.body ?? (spec.method === "POST" ? nonPathKeys : []);
+    const idempotent = spec.idempotent ?? (spec.method !== "GET" && (spec.billable || spec.requiresApproval));
+    const needsApproval = spec.billable || spec.requiresApproval;
+    const handler = async (rawArgs, { client, ctx }) => {
+        // Approval gate — mirrors callBillable in tools.ts. The server wrapper
+        // also gates before dispatch; this keeps the invariant when a handler is
+        // invoked directly (tests, future transports).
+        if (needsApproval && !ctx.approvalToken)
+            throw approvalRequiredError();
+        // Fill path params (URL-encoded), failing closed on empty values.
+        let path = spec.path;
+        for (const param of pathParams) {
+            const value = rawArgs[param];
+            if (value === undefined || value === null || `${value}` === "") {
+                throw invalidArgumentError(param);
+            }
+            path = path.replace(`:${param}`, encodeURIComponent(String(value)));
+        }
+        // Success-path post-processing (e.g. payload truncation); problem
+        // passthrough is untouched because this never wraps a throw.
+        const finish = (result) => spec.transform ? spec.transform(result) : result;
+        if (spec.method === "GET") {
+            const params = {};
+            for (const key of queryKeys)
+                params[key] = rawArgs[key];
+            return finish(await client.get(path, queryKeys.length > 0 ? params : undefined));
+        }
+        if (spec.method === "DELETE") {
+            // client.delete always derives an Idempotency-Key from the path.
+            return finish(await client.delete(path));
+        }
+        // POST: assemble the body from the declared body keys, dropping undefined
+        // fields. When nothing has a value, send no body at all (hand-written
+        // convention).
+        let body;
+        if (bodyKeys.length > 0) {
+            const assembled = {};
+            for (const key of bodyKeys) {
+                if (rawArgs[key] !== undefined)
+                    assembled[key] = rawArgs[key];
+            }
+            body = Object.keys(assembled).length > 0 ? assembled : undefined;
+        }
+        if (!idempotent && !needsApproval) {
+            // Read-only POST (quote/plan/validate): no idempotency key, no approval
+            // header — identical to the hand-written `client.post(path, args)`.
+            return finish(await client.post(path, body));
+        }
+        return finish(await client.post(path, body, {
+            ...(idempotent ? { idempotent: true } : {}),
+            ...(needsApproval ? { approvalToken: ctx.approvalToken } : {}),
+        }));
+    };
+    return {
+        name: spec.name,
+        description: spec.description,
+        scope: spec.scope,
+        billable: spec.billable,
+        requiresApproval: spec.requiresApproval,
+        routePath: spec.path,
+        inputShape: spec.input,
+        outputShape: spec.outputShape,
+        // Sound cast: same guarantee as defineTool — the McpServer validates args
+        // against inputShape before the handler runs.
+        handler: handler,
+    };
+}
+//# sourceMappingURL=generate.js.map

package/dist/tools/generate.js.map

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

package/dist/tools/infra-context.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Capix MCP Server — infra-context tools (2).
+ *
+ * Read-only live views over the customer's Capix infrastructure footprint.
+ * Every tool is read-only — safe to auto-run after authentication — and
+ * delegates to a canonical `/api/v1/*` route that EXISTS in the control
+ * plane (verified 2026-07; see ../route-families.ts):
+ *
+ *   capix_marketplace_browse  GET /api/v1/marketplace/offers  live GPU offers (public)
+ *   capix_model_list          GET /api/v1/models              deployable model catalog
+ *
+ * Removed in the 2026-07 repair (no backing route in the control plane):
+ *   capix_node_status      — there is no /api/v1/nodes/status (only
+ *                            nodes/[id]/earnings and nodes/[id]/conformance)
+ *   capix_earnings_check   — there is no /api/v1/earnings aggregate route
+ *   capix_deployment_list  — duplicated capix_deployments once both were
+ *                            aligned to the real GET /api/v1/deployments
+ *                            contract (status/cursor/limit, no phase/include)
+ *
+ * This module shares `defineTool` with the aggregate registry in ../tools.ts
+ * via ./define-tool.js (a leaf module), so there is no import cycle. The
+ * small Zod shapes below are re-declared locally to keep the module
+ * self-contained.
+ */
+import type { ToolDef } from "../types.js";
+export declare const infraContextTools: ToolDef[];
+export declare const INFRA_CONTEXT_TOOL_NAMES: string[];
+//# sourceMappingURL=infra-context.d.ts.map

package/dist/tools/infra-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infra-context.d.ts","sourceRoot":"","sources":["../../src/tools/infra-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAkB3C,eAAO,MAAM,iBAAiB,EAAE,OAAO,EAkDtC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,MAAM,EAAyC,CAAC"}

package/dist/tools/infra-context.js

@@ -0,0 +1,90 @@
+/**
+ * Capix MCP Server — infra-context tools (2).
+ *
+ * Read-only live views over the customer's Capix infrastructure footprint.
+ * Every tool is read-only — safe to auto-run after authentication — and
+ * delegates to a canonical `/api/v1/*` route that EXISTS in the control
+ * plane (verified 2026-07; see ../route-families.ts):
+ *
+ *   capix_marketplace_browse  GET /api/v1/marketplace/offers  live GPU offers (public)
+ *   capix_model_list          GET /api/v1/models              deployable model catalog
+ *
+ * Removed in the 2026-07 repair (no backing route in the control plane):
+ *   capix_node_status      — there is no /api/v1/nodes/status (only
+ *                            nodes/[id]/earnings and nodes/[id]/conformance)
+ *   capix_earnings_check   — there is no /api/v1/earnings aggregate route
+ *   capix_deployment_list  — duplicated capix_deployments once both were
+ *                            aligned to the real GET /api/v1/deployments
+ *                            contract (status/cursor/limit, no phase/include)
+ *
+ * This module shares `defineTool` with the aggregate registry in ../tools.ts
+ * via ./define-tool.js (a leaf module), so there is no import cycle. The
+ * small Zod shapes below are re-declared locally to keep the module
+ * self-contained.
+ */
+import { z } from "zod";
+import { defineTool } from "./define-tool.js";
+import { defineGeneratedTool } from "./generate.js";
+import { READ_ONLY } from "../types.js";
+// ===========================================================================
+// Local Zod fragments (mirror tools.ts — keep in sync)
+// ===========================================================================
+const iso8601 = z.string().datetime().or(z.string());
+const listResultShape = {
+    entries: z.array(z.record(z.unknown())).optional().describe("Paginated item array."),
+    nextCursor: z.string().optional().describe("Opaque cursor for the next page; absent when exhausted."),
+    fetchedAt: iso8601.optional().describe("ISO8601 fetch timestamp."),
+};
+// ===========================================================================
+// Infra-context tools (2) — read-only infra visibility for agents.
+// ===========================================================================
+export const infraContextTools = [
+    defineTool({
+        name: "capix_marketplace_browse",
+        description: "Browse live GPU marketplace offers (provider-anonymized: region, trust tier, capability, price/hr, health score). Read-only.",
+        scope: "infra-context",
+        ...READ_ONLY,
+        routePath: "/api/v1/marketplace/offers",
+        inputShape: {
+            gpuModel: z.string().optional().describe("Optional GPU model filter (e.g. A100, H100)."),
+            region: z.string().optional().describe("Optional region filter."),
+            trustTier: z
+                .enum(["community", "verified", "sovereign"])
+                .optional()
+                .describe("Optional trust tier filter."),
+            capability: z
+                .enum(["cpu", "gpu", "gpu_high_mem", "secure_enclave", "quantum_sim"])
+                .optional()
+                .describe("Optional capability filter."),
+            limit: z.number().int().min(1).max(200).default(50).describe("Max offers to return (upstream bounds)."),
+            cursor: z.string().optional().describe("Opaque pagination cursor from a previous page."),
+        },
+        outputShape: listResultShape,
+        handler: async (args, { client }) => client.get("/api/v1/marketplace/offers", {
+            gpuModel: args.gpuModel,
+            region: args.region,
+            trustTier: args.trustTier,
+            capability: args.capability,
+            limit: args.limit,
+            cursor: args.cursor,
+        }),
+    }),
+    defineGeneratedTool({
+        name: "capix_model_list",
+        description: "List deployable models: the public Capix catalog plus the caller's ready private " +
+            "endpoints (id, label, category, context window, pricing, availability). Read-only.",
+        scope: "infra-context",
+        ...READ_ONLY,
+        method: "GET",
+        path: "/api/v1/models",
+        input: {
+            projectId: z.string().optional().describe("Optional project id (the only query param the route accepts)."),
+        },
+        outputShape: {
+            models: z.array(z.record(z.unknown())).optional(),
+            projectId: z.string().optional(),
+        },
+    }),
+];
+export const INFRA_CONTEXT_TOOL_NAMES = infraContextTools.map((t) => t.name);
+//# sourceMappingURL=infra-context.js.map

package/dist/tools/infra-context.js.map

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

package/dist/tools/memes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Capix MCP Server — meme + image generation tools (3).
+ *
+ * Thin wrappers over the control-plane content routes (see
+ * app/api/v1/memes/route.ts and app/api/v1/images/route.ts in the protocol
+ * repo):
+ *
+ *   capix_meme            POST /api/v1/memes   generate a meme       (billable)
+ *   capix_image_gen       POST /api/v1/images  text-to-image         (billable)
+ *   capix_meme_templates  GET  /api/v1/memes   template/vibe catalog (read-only)
+ *
+ * All three are declared with `defineGeneratedTool` (./generate.ts), so the
+ * registration and the HTTP dispatch share one spec. The two POSTs are real
+ * money-moving mutations — they inherit the generator's defaults for billable
+ * specs: an Idempotency-Key derived from path+body and the bound
+ * approvalToken header, matching the routes' `Idempotency-Key` requirement.
+ *
+ * Payload truncation: both POST responses carry large inline artifacts
+ * (`svg` markup for memes, `base64` rasters for images). The `transform`
+ * hook replaces each artifact with a short omission pointer (share URL /
+ * id + the canonical GET /api/v1/memes/:id retrieval route) so the payload
+ * itself never floods the agent's context. Captions, prompt, and the
+ * `charge` object pass through untouched.
+ *
+ * This module shares `defineGeneratedTool` with the aggregate registry in
+ * ../tools.ts via ./generate.js (a leaf module), so there is no import cycle.
+ */
+import type { ToolDef } from "../types.js";
+export declare const memeImageTools: ToolDef[];
+export declare const MEME_IMAGE_TOOL_NAMES: string[];
+//# sourceMappingURL=memes.d.ts.map

package/dist/tools/memes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memes.d.ts","sourceRoot":"","sources":["../../src/tools/memes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAmE3C,eAAO,MAAM,cAAc,EAAE,OAAO,EAwFnC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAAsC,CAAC"}

package/dist/tools/memes.js

@@ -0,0 +1,175 @@
+/**
+ * Capix MCP Server — meme + image generation tools (3).
+ *
+ * Thin wrappers over the control-plane content routes (see
+ * app/api/v1/memes/route.ts and app/api/v1/images/route.ts in the protocol
+ * repo):
+ *
+ *   capix_meme            POST /api/v1/memes   generate a meme       (billable)
+ *   capix_image_gen       POST /api/v1/images  text-to-image         (billable)
+ *   capix_meme_templates  GET  /api/v1/memes   template/vibe catalog (read-only)
+ *
+ * All three are declared with `defineGeneratedTool` (./generate.ts), so the
+ * registration and the HTTP dispatch share one spec. The two POSTs are real
+ * money-moving mutations — they inherit the generator's defaults for billable
+ * specs: an Idempotency-Key derived from path+body and the bound
+ * approvalToken header, matching the routes' `Idempotency-Key` requirement.
+ *
+ * Payload truncation: both POST responses carry large inline artifacts
+ * (`svg` markup for memes, `base64` rasters for images). The `transform`
+ * hook replaces each artifact with a short omission pointer (share URL /
+ * id + the canonical GET /api/v1/memes/:id retrieval route) so the payload
+ * itself never floods the agent's context. Captions, prompt, and the
+ * `charge` object pass through untouched.
+ *
+ * This module shares `defineGeneratedTool` with the aggregate registry in
+ * ../tools.ts via ./generate.js (a leaf module), so there is no import cycle.
+ */
+import { z } from "zod";
+import { defineGeneratedTool } from "./generate.js";
+import { BILLABLE, READ_ONLY } from "../types.js";
+// ===========================================================================
+// Local Zod fragments (mirror tools.ts — keep in sync)
+// ===========================================================================
+/**
+ * Charge envelope returned by the meme/image routes: either a settled
+ * balance charge (integer minor units as a string) or a free-tier grant.
+ */
+const chargeShape = z
+    .object({
+    kind: z.enum(["free", "balance"]).optional(),
+    amountMinor: z
+        .string()
+        .optional()
+        .describe("Integer minor units charged, serialized as a string."),
+    asset: z.string().optional(),
+    scale: z.number().int().optional(),
+    freeUsedToday: z.number().int().optional(),
+    freePerDay: z.number().int().optional(),
+})
+    .describe("Settled charge for the generation (balance debit or free-tier grant).");
+/** Caption voices accepted by POST /api/v1/memes (MEME_VIBES upstream). */
+const MEME_VIBE_VALUES = ["degen", "pump", "bagholder", "unhinged", "dev", "spicy"];
+// ===========================================================================
+// Payload truncation (transform hooks)
+// ===========================================================================
+/** Replace an oversized inline payload with a short omission pointer. */
+function omitPayload(payload, pointer) {
+    return `[omitted ${payload.length} chars — ${pointer}]`;
+}
+/**
+ * Swap the inline meme SVG for a pointer to the share page / canonical
+ * retrieval route. Everything else (captions, charge, ids) passes through.
+ */
+function truncateMemeResponse(res) {
+    if (typeof res.svg !== "string")
+        return res;
+    const memeId = typeof res.memeId === "string" ? res.memeId : "unknown";
+    const shareUrl = typeof res.shareUrl === "string" ? res.shareUrl : undefined;
+    const pointer = shareUrl
+        ? `view at ${shareUrl} or fetch via GET /api/v1/memes/${memeId}`
+        : `fetch via GET /api/v1/memes/${memeId}`;
+    return { ...res, svg: omitPayload(res.svg, pointer) };
+}
+/**
+ * Swap the inline base64 raster for a pointer to the image id. The image is
+ * persisted server-side and retrievable via GET /api/v1/memes/:id.
+ */
+function truncateImageResponse(res) {
+    if (typeof res.base64 !== "string")
+        return res;
+    const imageId = typeof res.imageId === "string" ? res.imageId : "unknown";
+    return {
+        ...res,
+        base64: omitPayload(res.base64, `imageId ${imageId} — fetch via GET /api/v1/memes/${imageId}`),
+    };
+}
+// ===========================================================================
+// Meme + image tools (3)
+// ===========================================================================
+export const memeImageTools = [
+    defineGeneratedTool({
+        name: "capix_meme",
+        description: "Generate a meme from a topic: template captions, or a fully AI-generated canvas image. " +
+            "The account gets a small free daily allowance, then a fixed balance charge; omitting " +
+            "templateId (or passing \"ai-canvas\") generates the image with AI at 2x the template " +
+            "price. Returns the meme id, captions, shareUrl, and the settled charge; the inline SVG " +
+            "is replaced with a pointer to the share URL. Billable; requires approval.",
+        scope: "lifecycle",
+        ...BILLABLE,
+        method: "POST",
+        path: "/api/v1/memes",
+        input: {
+            topic: z.string().min(1).describe("What the meme is about."),
+            vibe: z
+                .enum(MEME_VIBE_VALUES)
+                .optional()
+                .describe("Caption voice (see capix_meme_templates for the live catalog)."),
+            templateId: z
+                .string()
+                .optional()
+                .describe("Template id from capix_meme_templates. Omit (or pass \"ai-canvas\") for a fully " +
+                "AI-generated image at 2x the template price."),
+        },
+        outputShape: {
+            memeId: z.string().optional(),
+            svg: z
+                .string()
+                .optional()
+                .describe("Omission pointer — the full SVG is at shareUrl / GET /api/v1/memes/:id."),
+            caption: z.string().optional(),
+            captions: z.record(z.string()).optional(),
+            templateId: z.string().optional(),
+            vibe: z.string().optional(),
+            mode: z.string().optional(),
+            shareUrl: z.string().optional(),
+            charge: chargeShape.optional(),
+        },
+        transform: truncateMemeResponse,
+    }),
+    defineGeneratedTool({
+        name: "capix_image_gen",
+        description: "Generate an image from a text prompt (fixed per-image balance charge, no free tier). " +
+            "Returns the image id, content type, and the settled charge; the base64 payload is " +
+            "replaced with a pointer to the retrievable image id. Billable; requires approval.",
+        scope: "lifecycle",
+        ...BILLABLE,
+        method: "POST",
+        path: "/api/v1/images",
+        input: {
+            prompt: z
+                .string()
+                .min(2)
+                .max(1000)
+                .describe("Image prompt (2–1000 characters, per the control-plane limit)."),
+        },
+        outputShape: {
+            imageId: z.string().optional(),
+            base64: z
+                .string()
+                .optional()
+                .describe("Omission pointer — the full image is retrievable via GET /api/v1/memes/:id."),
+            contentType: z.string().optional(),
+            prompt: z.string().optional(),
+            charge: chargeShape.optional(),
+        },
+        transform: truncateImageResponse,
+    }),
+    defineGeneratedTool({
+        name: "capix_meme_templates",
+        description: "List the meme catalog: available templates (ids, slots, hints), caption vibes, and " +
+            "whether AI-canvas image generation is currently available. Free; read-only.",
+        scope: "discovery",
+        ...READ_ONLY,
+        method: "GET",
+        path: "/api/v1/memes",
+        input: {},
+        outputShape: {
+            templates: z.array(z.record(z.unknown())).optional(),
+            vibes: z.array(z.string()).optional(),
+            aiCanvasAvailable: z.boolean().optional(),
+        },
+    }),
+];
+export const MEME_IMAGE_TOOL_NAMES = memeImageTools.map((t) => t.name);
+//# sourceMappingURL=memes.js.map

package/dist/tools/memes.js.map

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

package/dist/tools.d.ts

@@ -1,5 +1,11 @@
 /**
- * Capix MCP Server — all 59 tool definitions.
+ * Capix MCP Server — all 37 tool definitions.
+ *
+ * 2026-07 repair: every tool below targets a route family that EXISTS in the
+ * control plane (app/api/v1/* in the protocol repo), verified route-by-route
+ * against the live source. Each tool declares its canonical path (`routePath`)
+ * and the registry gate (tools/registry.test.ts) asserts it against the
+ * allowlist in route-families.ts — no phantom routes can be re-introduced.
  *
  * Each tool is declared with:
  *   - inputShape  : a Zod raw shape (validated by the McpServer before dispatch)
@@ -11,16 +17,51 @@
  * structured content. The CapixApiError (problem+json) thrown by the client is
  * caught by the server wrapper and surfaced as an MCP error result.
  *
- * Tools are grouped by scope (mirrors services/capix-mcp/tools/*.ts):
- *   discovery (9) · planning (6) · lifecycle (7) · networking (8) ·
- *   testing (6) · verification (6) · website (17)
+ * CRUD-shaped tools are declared with `defineGeneratedTool` (tools/generate.ts)
+ * — a declarative spec (method, path, input) from which the registration AND
+ * the HTTP call are generated — instead of a hand-written handler. Everything
+ * else uses `defineTool` (tools/define-tool.ts) with an explicit handler.
+ *
+ * Tools are grouped by scope:
+ *   discovery (7) · planning (2) · lifecycle (19) · verification (1) ·
+ *   website (6) · infra-context (2)
+ * (The factory tools — jobs/training/agent-deploys — live in
+ * tools/factory.ts and join lifecycle; the meme/image tools live in
+ * tools/memes.ts: the meme catalog joins discovery, the two billable
+ * generators join lifecycle.)
+ *
+ * Removed in the repair (no backing route in the control plane — hidden, not
+ * deleted from git history):
+ *   - networking scope (8 tools): /api/v1/networking/* and /api/v1/vpc do not
+ *     exist. Returns with the networking roadmap (N1–N5).
+ *   - testing scope (6 tools): /api/v1/testing/* does not exist (disposable
+ *     test envs are not built).
+ *   - attestation/zkVM/measurement tools (5): /api/v1/verification/* and
+ *     /api/v1/attestations do not exist. Secured Cloud (TEE/zkVM) is deferred.
+ *   - planning stubs (capix_compute_plan, capix_model_plan, capix_stack_*):
+ *     /api/v1/planning/* does not exist; quoting lives at /api/v1/quotes.
+ *   - lifecycle stubs (capix_start/stop/restart/extend): start/stop exist
+ *     upstream ONLY as PATCH /api/v1/deployments/[id] { desiredState } with a
+ *     mandatory If-Match etag — unreachable through the current client
+ *     surface (no PATCH, no etag access). Restart/extend have no backend.
+ *   - discovery stubs: capix_projects (no /api/v1/projects),
+ *     capix_model_catalog (real catalog is /api/v1/models, covered by
+ *     capix_model_list), capix_attestations (Secured Cloud deferred).
+ *   - website stubs (12 tools): singular /api/v1/website/* never existed and
+ *     detect/plan/quote/deploy/preview/deployments/logs/metrics/domains have
+ *     no routes under the real /api/v1/websites family (build logs surface as
+ *     `logTail` inside capix_website_get; previews are implicit per release).
+ *   - infra-context stubs: capix_node_status, capix_earnings_check (no
+ *     /api/v1/nodes/status or /api/v1/earnings), capix_deployment_list
+ *     (duplicate of capix_deployments).
  */
 import type { ToolDef } from "./types.js";
+import { factoryTools } from "./tools/factory.js";
+import { infraContextTools } from "./tools/infra-context.js";
+import { memeImageTools } from "./tools/memes.js";
 declare const discoveryTools: ToolDef[];
 declare const planningTools: ToolDef[];
 declare const lifecycleTools: ToolDef[];
-declare const networkingTools: ToolDef[];
-declare const testingTools: ToolDef[];
 declare const verificationTools: ToolDef[];
 declare const websiteTools: ToolDef[];
 export declare const TOOLS: ToolDef[];
@@ -28,5 +69,5 @@ export declare const TOOL_NAMES: string[];
 export declare const TOOL_COUNT: number;
 /** Map of tool name → definition, used by the server for O(1) lookup. */
 export declare const TOOL_MAP: Map<string, ToolDef>;
-export { discoveryTools, planningTools, lifecycleTools, networkingTools, testingTools, verificationTools, websiteTools };
+export { discoveryTools, planningTools, lifecycleTools, verificationTools, websiteTools, factoryTools, infraContextTools, memeImageTools };
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAEV,OAAO,EAGR,MAAM,YAAY,CAAC;AAyIpB,QAAA,MAAM,cAAc,EAAE,OAAO,EAmK5B,CAAC;AAqCF,QAAA,MAAM,aAAa,EAAE,OAAO,EA8F3B,CAAC;AAMF,QAAA,MAAM,cAAc,EAAE,OAAO,EA0I5B,CAAC;AAMF,QAAA,MAAM,eAAe,EAAE,OAAO,EA8H7B,CAAC;AAMF,QAAA,MAAM,YAAY,EAAE,OAAO,EA4I1B,CAAC;AAMF,QAAA,MAAM,iBAAiB,EAAE,OAAO,EAmI/B,CAAC;AAaF,QAAA,MAAM,YAAY,EAAE,OAAO,EAmU1B,CAAC;AAMF,eAAO,MAAM,KAAK,EAAE,OAAO,EAQ1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,EAA6B,CAAC;AAE7D,eAAO,MAAM,UAAU,QAAe,CAAC;AAEvC,yEAAyE;AACzE,eAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAA0C,CAAC;AAErF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQ1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAkClD,QAAA,MAAM,cAAc,EAAE,OAAO,EA2H5B,CAAC;AA8BF,QAAA,MAAM,aAAa,EAAE,OAAO,EA2E3B,CAAC;AAqBF,QAAA,MAAM,cAAc,EAAE,OAAO,EA6C5B,CAAC;AAYF,QAAA,MAAM,iBAAiB,EAAE,OAAO,EAoB/B,CAAC;AAkCF,QAAA,MAAM,YAAY,EAAE,OAAO,EA0G1B,CAAC;AAMF,eAAO,MAAM,KAAK,EAAE,OAAO,EAS1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,EAA6B,CAAC;AAE7D,eAAO,MAAM,UAAU,QAAe,CAAC;AAEvC,yEAAyE;AACzE,eAAO,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAA0C,CAAC;AAErF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC"}