capix-mcp 2.1.1 → 2.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/tools/generate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAY,SAAS,EAAE,MAAM,aAAa,CAAC;AAMhE,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,MAAM,EAAE,eAAe,CAAC;IACxB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC;IACT;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;IACtC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;IACrC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC3C;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1E;AAMD,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKnD;AAqBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAyGhG"}

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

@@ -1,17 +1,21 @@
 /**
- * Capix MCP Server — infra-context tools (5).
+ * Capix MCP Server — infra-context tools (2).
  *
- * Read-only live views over the customer's Capix infrastructure footprint,
- * mirroring the IDE assistant's infra panel (marketplace offers, node health,
- * earnings, model catalog, deployment inventory). Every tool is read-only —
- * safe to auto-run after authentication — and delegates to the canonical
- * `/api/v1/*` routes through the shared Capix client.
+ * 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  live GPU marketplace offers        (read-only)
- *   capix_node_status         per-node liveness / health         (read-only)
- *   capix_earnings_check      wallet + dev-token earnings        (read-only)
- *   capix_model_list          deployable model catalog           (read-only)
- *   capix_deployment_list     deployment inventory + health      (read-only)
+ *   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

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

@@ -1 +1 @@
-{"version":3,"file":"infra-context.d.ts","sourceRoot":"","sources":["../../src/tools/infra-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AA0B3C,eAAO,MAAM,iBAAiB,EAAE,OAAO,EAyGtC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,MAAM,EAAyC,CAAC"}
+{"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

@@ -1,17 +1,21 @@
 /**
- * Capix MCP Server — infra-context tools (5).
+ * Capix MCP Server — infra-context tools (2).
  *
- * Read-only live views over the customer's Capix infrastructure footprint,
- * mirroring the IDE assistant's infra panel (marketplace offers, node health,
- * earnings, model catalog, deployment inventory). Every tool is read-only —
- * safe to auto-run after authentication — and delegates to the canonical
- * `/api/v1/*` routes through the shared Capix client.
+ * 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  live GPU marketplace offers        (read-only)
- *   capix_node_status         per-node liveness / health         (read-only)
- *   capix_earnings_check      wallet + dev-token earnings        (read-only)
- *   capix_model_list          deployable model catalog           (read-only)
- *   capix_deployment_list     deployment inventory + health      (read-only)
+ *   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
@@ -20,119 +24,66 @@
  */
 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 moneyShape = z.object({
-    amount: z.string().describe("Integer minor units (e.g. lamports, micro-USDC, cents)."),
-    asset: z.enum(["SOL", "USDC", "USD-credit"]),
-    scale: z.number().int(),
-}).describe("Integer minor/native money amount serialized as a JSON string.");
-const deploymentIdShape = z.string().describe("Canonical deployment id (dep_…).");
 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 (5) — read-only infra visibility for agents.
+// Infra-context tools (2) — read-only infra visibility for agents.
 // ===========================================================================
 export const infraContextTools = [
     defineTool({
         name: "capix_marketplace_browse",
-        description: "Browse live GPU marketplace offers (gpu, vram, price/hr, location, reliability), cheapest first. Read-only.",
+        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: {
-            gpu: z.string().optional().describe("Optional GPU model filter (e.g. A100, H100)."),
+            gpuModel: z.string().optional().describe("Optional GPU model filter (e.g. A100, H100)."),
             region: z.string().optional().describe("Optional region filter."),
-            limit: z.number().int().min(1).max(200).default(50).describe("Max offers to return."),
+            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", {
-            gpu: args.gpu,
+            gpuModel: args.gpuModel,
             region: args.region,
+            trustTier: args.trustTier,
+            capability: args.capability,
             limit: args.limit,
+            cursor: args.cursor,
         }),
     }),
-    defineTool({
-        name: "capix_node_status",
-        description: "Show liveness and health for every node across the account's deployments. Read-only.",
-        scope: "infra-context",
-        ...READ_ONLY,
-        inputShape: {
-            deploymentId: deploymentIdShape.optional().describe("Optional deployment filter."),
-        },
-        outputShape: {
-            ...listResultShape,
-            summary: z
-                .object({
-                total: z.number().int().optional(),
-                online: z.number().int().optional(),
-                offline: z.number().int().optional(),
-            })
-                .optional()
-                .describe("Aggregate liveness counts across the returned nodes."),
-        },
-        handler: async (args, { client }) => client.get("/api/v1/nodes/status", {
-            deploymentId: args.deploymentId,
-        }),
-    }),
-    defineTool({
-        name: "capix_earnings_check",
-        description: "Check the earnings dashboard: wallet balance, total spend, active deployments and dev-token earnings. Read-only.",
-        scope: "infra-context",
-        ...READ_ONLY,
-        inputShape: {},
-        outputShape: {
-            wallet: moneyShape.optional(),
-            totalSpent: moneyShape.optional(),
-            activeDeployments: z.number().int().optional(),
-            devTokenBalance: z.number().optional(),
-            devTokenTotalEarned: z.number().optional(),
-            asOf: iso8601.optional(),
-        },
-        handler: async (_args, { client }) => client.get("/api/v1/earnings"),
-    }),
-    defineTool({
+    defineGeneratedTool({
         name: "capix_model_list",
-        description: "List deployable models from the Capix catalog (id, label, category, parameter count, min VRAM). Read-only.",
+        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,
-        inputShape: {
-            category: z.string().optional().describe("Optional category filter (e.g. chat, code, embedding)."),
-            limit: z.number().int().min(1).max(200).default(100).describe("Max models to return."),
+        method: "GET",
+        path: "/api/v1/models",
+        input: {
+            projectId: z.string().optional().describe("Optional project id (the only query param the route accepts)."),
         },
         outputShape: {
-            ...listResultShape,
-            catalogVersion: z.string().optional(),
-        },
-        handler: async (args, { client }) => client.get("/api/v1/models", {
-            category: args.category,
-            limit: args.limit,
-        }),
-    }),
-    defineTool({
-        name: "capix_deployment_list",
-        description: "List the deployment inventory with live status, health and hourly cost. Read-only.",
-        scope: "infra-context",
-        ...READ_ONLY,
-        inputShape: {
-            limit: z.number().int().min(1).max(200).default(50).describe("Max deployments to return."),
-            phase: z.string().optional().describe("Optional DeploymentPhase filter."),
-            includeNodes: z
-                .boolean()
-                .default(false)
-                .describe("When true, embed per-node health for each deployment."),
+            models: z.array(z.record(z.unknown())).optional(),
+            projectId: z.string().optional(),
         },
-        outputShape: listResultShape,
-        handler: async (args, { client }) => client.get("/api/v1/deployments", {
-            limit: args.limit,
-            phase: args.phase,
-            include: args.includeNodes ? "nodes,health" : undefined,
-        }),
     }),
 ];
 export const INFRA_CONTEXT_TOOL_NAMES = infraContextTools.map((t) => t.name);

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

@@ -1 +1 @@
-{"version":3,"file":"infra-context.js","sourceRoot":"","sources":["../../src/tools/infra-context.ts"],"names":[],"mappings":"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"}
+{"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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGlD,8EAA8E;AAC9E,uDAAuD;AACvD,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,QAAQ,CAAC,uEAAuE,CAAC,CAAC;AAErF,2EAA2E;AAC3E,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAU,CAAC;AAE7F,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E,yEAAyE;AACzE,SAAS,WAAW,CAAC,OAAe,EAAE,OAAe;IACnD,OAAO,YAAY,OAAO,CAAC,MAAM,YAAY,OAAO,GAAG,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,GAA4B;IACxD,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,OAAO,GAAG,QAAQ;QACtB,CAAC,CAAC,WAAW,QAAQ,mCAAmC,MAAM,EAAE;QAChE,CAAC,CAAC,+BAA+B,MAAM,EAAE,CAAC;IAC5C,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,GAA4B;IACzD,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,OAAO;QACL,GAAG,GAAG;QACN,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,OAAO,kCAAkC,OAAO,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,mBAAmB,CAAC;QAClB,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,yFAAyF;YACzF,uFAAuF;YACvF,uFAAuF;YACvF,yFAAyF;YACzF,2EAA2E;QAC7E,KAAK,EAAE,WAAW;QAClB,GAAG,QAAQ;QACX,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE;YACL,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAC5D,IAAI,EAAE,CAAC;iBACJ,IAAI,CAAC,gBAAgB,CAAC;iBACtB,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;YAC7E,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,kFAAkF;gBAChF,8CAA8C,CACjD;SACJ;QACD,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,yEAAyE,CAAC;YACtF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE;SAC/B;QACD,SAAS,EAAE,oBAAoB;KAChC,CAAC;IACF,mBAAmB,CAAC;QAClB,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,uFAAuF;YACvF,oFAAoF;YACpF,mFAAmF;QACrF,KAAK,EAAE,WAAW;QAClB,GAAG,QAAQ;QACX,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE;YACL,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,gEAAgE,CAAC;SAC9E;QACD,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,6EAA6E,CAAC;YAC1F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE;SAC/B;QACD,SAAS,EAAE,qBAAqB;KACjC,CAAC;IACF,mBAAmB,CAAC;QAClB,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,qFAAqF;YACrF,6EAA6E;QAC/E,KAAK,EAAE,WAAW;QAClB,GAAG,SAAS;QACZ,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,EAAE;QACT,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;YACpD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YACrC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC1C;KACF,CAAC;CACH,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAa,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC"}