capybara-mcp 0.1.0

package/README.md

@@ -0,0 +1,59 @@
+# capybara-mcp
+
+MCP server for [Capybara](https://capybara.dev) game asset generation. Works with Claude Code, Cursor, Codex, OpenCode, Pi, and any MCP-capable agent.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `generate_asset` | Generate maps, characters, props, HUD, and audio |
+| `check_job_status` | Recover results if a session was interrupted |
+
+## Quick start
+
+### 1. Configure (one time)
+
+```bash
+npx capybara-mcp-setup --api-key <your-api-key> --server-url https://api.capybara.dev/v1
+```
+
+This writes MCP config for Claude Desktop. For Claude Code:
+
+```bash
+claude mcp add capybara-mcp \
+  -e CAPYBARA_API_KEY=<your-api-key> \
+  -e CAPYBARA_API_URL=https://api.capybara.dev/v1 \
+  -- npx -y capybara-mcp
+```
+
+### 2. Environment variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CAPYBARA_API_KEY` | Yes | Your Capybara API key |
+| `CAPYBARA_API_URL` | No | MCP API base URL (default: `https://api.capybara.dev/v1`) |
+
+### 3. Run manually
+
+```bash
+CAPYBARA_API_KEY=<key> CAPYBARA_API_URL=https://api.capybara.dev/v1 npx capybara-mcp
+```
+
+## How it works
+
+1. The agent calls `generate_asset` with asset specs (maps, characters, etc.).
+2. The client reads `src/data/assets.md` and existing JSON from your game repo.
+3. Assets are generated via the Capybara API and written back to disk.
+4. Live progress appears in `.capybara/status.md` during the run.
+
+If interrupted, use `check_job_status` with the returned `job_id`.
+
+## Requirements
+
+- Node.js 18+
+- A Capybara API key with sufficient credits
+- A game project with `src/data/assets.md` (for non-first-build generation)
+
+## License
+
+MIT

package/dist/api/capybara-api.d.ts

@@ -0,0 +1,21 @@
+import { type JobStatusResponse, type McpGenerateAssetInput, type ProgressReporter } from "capybara-mcp-shared";
+export type ClientContext = {
+    apiKey: string;
+    apiUrl: string;
+    report?: ProgressReporter;
+    onJobId?: (jobId: string) => void | Promise<void>;
+    signal?: AbortSignal;
+};
+export type GenerationResult = {
+    summary: string;
+    jobId?: string;
+};
+export declare function generateAssets(input: McpGenerateAssetInput, ctx: ClientContext): Promise<GenerationResult>;
+export declare function formatJobStatus(status: JobStatusResponse): string;
+export declare function checkJobStatus(jobId: string, ctx: ClientContext & {
+    output_dir?: string;
+}): Promise<{
+    summary: string;
+    status: JobStatusResponse;
+}>;
+//# sourceMappingURL=capybara-api.d.ts.map

package/dist/api/capybara-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capybara-api.d.ts","sourceRoot":"","sources":["../../src/api/capybara-api.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAWF,wBAAsB,cAAc,CAClC,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,gBAAgB,CAAC,CA+C3B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAcjE;AAuBD,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAsBzD"}

package/dist/api/capybara-api.js

@@ -0,0 +1,102 @@
+import path from "node:path";
+import { getJobStatus, mapAssetToolInputToLegacy, postApiRequest, } from "capybara-mcp-shared";
+import { writeFiles } from "../lib/write-files.js";
+import { readWorkspaceContext } from "../lib/read-workspace-context.js";
+function withJobId(summary, jobId) {
+    if (!jobId) {
+        return summary;
+    }
+    return [summary, "", `job_id: ${jobId}`, "If interrupted, call check_job_status with this job_id."].join("\n");
+}
+export async function generateAssets(input, ctx) {
+    const { output_dir, workspace_root, plan_used_to_build, art_reference_url, ...schemaInput } = input;
+    const payload = mapAssetToolInputToLegacy(schemaInput);
+    const workspaceRoot = path.resolve(workspace_root || ".");
+    const workspace_files = await readWorkspaceContext(workspaceRoot);
+    await ctx.report?.({
+        message: `Queued ${payload.assets.length} asset(s) for generation...`,
+        progress: 0,
+        total: payload.assets.length,
+    });
+    const { jobId, data } = await postApiRequest({
+        url: `${ctx.apiUrl}/generate-assets`,
+        body: {
+            ...payload,
+            workspace_files,
+            workspace_root: workspaceRoot,
+            plan_used_to_build,
+            art_reference_url,
+        },
+        apiKey: ctx.apiKey,
+        apiUrl: ctx.apiUrl,
+        report: ctx.report,
+        onJobId: ctx.onJobId,
+        signal: ctx.signal,
+    });
+    const result = data;
+    const rootDir = path.resolve(output_dir || workspaceRoot);
+    const written = await writeFiles(result.assets ?? result.files ?? [], rootDir);
+    const summaryParts = [
+        result.message || `Generated ${payload.assets.length} asset(s).`,
+        result.status ? `Status: ${result.status}` : null,
+        result.assets_md ? "Updated src/data/assets.md." : null,
+        result.warnings?.length ? `Warnings:\n${result.warnings.map((w) => `  - ${w}`).join("\n")}` : null,
+        result.failedAssets?.length
+            ? `Failures:\n${result.failedAssets.map((f) => `  - ${f.id}: ${f.error}`).join("\n")}`
+            : null,
+        written.length > 0
+            ? [`Wrote ${written.length} file(s) to ${rootDir}:`, ...written.map((p) => `  - ${p}`)].join("\n")
+            : null,
+    ].filter(Boolean);
+    return { summary: withJobId(summaryParts.join("\n"), jobId), jobId };
+}
+export function formatJobStatus(status) {
+    const lines = [
+        `job_id: ${status.job_id}`,
+        `status: ${status.status}`,
+        status.progress_message || status.message
+            ? `message: ${status.progress_message || status.message}`
+            : null,
+        status.progress != null
+            ? `progress: ${status.progress}${status.total != null ? `/${status.total}` : ""}`
+            : null,
+        status.error ? `error: ${status.error}` : null,
+    ].filter(Boolean);
+    return lines.join("\n");
+}
+async function applyCompletedJob(status, outputDir) {
+    if (status.status !== "complete" || status.result == null) {
+        return null;
+    }
+    const result = status.result;
+    const rootDir = path.resolve(outputDir || ".");
+    const written = await writeFiles(result.assets ?? result.files ?? [], rootDir);
+    return [
+        result.message || "Recovered generated assets.",
+        written.length > 0
+            ? [`Wrote ${written.length} file(s) to ${rootDir}:`, ...written.map((p) => `  - ${p}`)].join("\n")
+            : null,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+export async function checkJobStatus(jobId, ctx) {
+    const status = await getJobStatus({
+        apiUrl: ctx.apiUrl,
+        apiKey: ctx.apiKey,
+        jobId,
+        signal: ctx.signal,
+    });
+    let summary = formatJobStatus(status);
+    if (status.status === "complete") {
+        const recovered = await applyCompletedJob(status, ctx.output_dir);
+        if (recovered) {
+            summary = [recovered, "", `job_id: ${status.job_id}`].join("\n");
+        }
+    }
+    if (status.status === "failed") {
+        summary = [summary, status.error ? `error: ${status.error}` : null].filter(Boolean).join("\n");
+    }
+    return { summary, status };
+}
+//# sourceMappingURL=capybara-api.js.map

package/dist/api/capybara-api.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerTools } from "./tools/register-tools.js";
+const API_KEY = process.env.CAPYBARA_API_KEY;
+const API_URL = process.env.CAPYBARA_API_URL || "https://api.capybara.dev/v1";
+if (!API_KEY) {
+    console.error("CAPYBARA_API_KEY is not set. Run the setup command first:");
+    console.error("  npx -y capybara-mcp-setup --api-key <your-key>");
+    process.exit(1);
+}
+const server = new McpServer({
+    name: "capybara_tools",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        logging: {},
+    },
+});
+registerTools(server, {
+    apiKey: API_KEY,
+    apiUrl: API_URL,
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,6BAA6B,CAAC;AAE9E,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,OAAO,EAAE,EAAE;KACZ;CACF,CACF,CAAC;AAEF,aAAa,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,OAAO;CAChB,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/lib/file-log.d.ts

@@ -0,0 +1,12 @@
+export type FileLogger = {
+    latestPath: string;
+    archivePath: string;
+    append: (line: string) => Promise<void>;
+    close: (footer?: string) => Promise<void>;
+};
+export declare function createFileLogger(label: string): Promise<FileLogger>;
+export declare function jobLogPath(jobId: string): string;
+export declare function appendJobLog(jobId: string, line: string): Promise<string>;
+export declare function initJobLog(jobId: string, label: string): Promise<string>;
+export declare function formatLogHint(filePath: string): string;
+//# sourceMappingURL=file-log.d.ts.map

package/dist/lib/file-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-log.d.ts","sourceRoot":"","sources":["../../src/lib/file-log.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C,CAAC;AAUF,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAyBzE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK/E;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9E;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/lib/file-log.js

@@ -0,0 +1,48 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+function logDir() {
+    return process.env.CAPYBARA_LOG_DIR || path.join(process.cwd(), ".capybara", "logs");
+}
+function formatLine(line) {
+    return `[${new Date().toISOString()}] ${line}\n`;
+}
+export async function createFileLogger(label) {
+    const dir = logDir();
+    await fs.mkdir(dir, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const latestPath = path.resolve(dir, "latest.log");
+    const archivePath = path.resolve(dir, `${label}-${timestamp}.log`);
+    const header = `=== ${label} started ${new Date().toISOString()} ===\n`;
+    await fs.writeFile(latestPath, header);
+    await fs.writeFile(archivePath, header);
+    const append = async (line) => {
+        const formatted = formatLine(line);
+        await Promise.all([fs.appendFile(latestPath, formatted), fs.appendFile(archivePath, formatted)]);
+    };
+    const close = async (footer) => {
+        if (footer) {
+            await append(footer);
+        }
+        await append(`=== ${label} finished ===`);
+    };
+    return { latestPath, archivePath, append, close };
+}
+export function jobLogPath(jobId) {
+    return path.resolve(logDir(), `job-${jobId}.log`);
+}
+export async function appendJobLog(jobId, line) {
+    const filePath = jobLogPath(jobId);
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.appendFile(filePath, formatLine(line));
+    return filePath;
+}
+export async function initJobLog(jobId, label) {
+    const filePath = jobLogPath(jobId);
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, `=== ${label} job ${jobId} started ${new Date().toISOString()} ===\n`);
+    return filePath;
+}
+export function formatLogHint(filePath) {
+    return `Live log: ${filePath}\nWatch with: tail -f ${filePath}`;
+}
+//# sourceMappingURL=file-log.js.map

package/dist/lib/file-log.js.map

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

package/dist/lib/progress.d.ts

@@ -0,0 +1,16 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import type { ServerNotification, ServerRequest } from "@modelcontextprotocol/sdk/types.js";
+import type { ProgressUpdate } from "capybara-mcp-shared";
+import type { StatusLogger } from "./status-markdown.js";
+type ToolExtra = RequestHandlerExtra<ServerRequest, ServerNotification>;
+export declare function createProgressReporter({ extra, server, label, statusLog, }: {
+    extra: ToolExtra;
+    server: McpServer;
+    label: string;
+    statusLog?: StatusLogger;
+}): {
+    report: (update: ProgressUpdate) => Promise<void>;
+};
+export {};
+//# sourceMappingURL=progress.d.ts.map

package/dist/lib/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/lib/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,KAAK,SAAS,GAAG,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;AAaxE,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,MAAM,EACN,KAAK,EACL,SAAS,GACV,EAAE;IACD,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B;qBAI+B,cAAc;EAiC7C"}

package/dist/lib/progress.js

@@ -0,0 +1,40 @@
+function formatProgressLine({ message, progress, total }) {
+    const parts = [];
+    if (progress != null) {
+        parts.push(total != null ? `${progress}/${total}` : String(progress));
+    }
+    if (message) {
+        parts.push(message);
+    }
+    return parts.join(" — ") || "working...";
+}
+export function createProgressReporter({ extra, server, label, statusLog, }) {
+    const progressToken = extra._meta?.progressToken;
+    let lastProgress = 0;
+    const report = async (update) => {
+        if (extra.signal.aborted) {
+            throw new DOMException("Cancelled", "AbortError");
+        }
+        if (update.progress != null) {
+            lastProgress = update.progress;
+        }
+        await statusLog?.append(formatProgressLine(update));
+        if (progressToken !== undefined) {
+            await extra.sendNotification({
+                method: "notifications/progress",
+                params: {
+                    progressToken,
+                    progress: update.progress ?? lastProgress,
+                    ...(update.total != null ? { total: update.total } : {}),
+                    ...(update.message ? { message: update.message } : {}),
+                },
+            });
+            return;
+        }
+        if (extra.sessionId && update.message) {
+            await server.sendLoggingMessage({ level: "info", data: `[${label}] ${update.message}` }, extra.sessionId);
+        }
+    };
+    return { report };
+}
+//# sourceMappingURL=progress.js.map

package/dist/lib/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/lib/progress.ts"],"names":[],"mappings":"AAWA,SAAS,kBAAkB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAkB;IACtE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,EACrC,KAAK,EACL,MAAM,EACN,KAAK,EACL,SAAS,GAMV;IACC,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC;IACjD,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,MAAM,MAAM,GAAG,KAAK,EAAE,MAAsB,EAAE,EAAE;QAC9C,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC5B,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjC,CAAC;QAED,MAAM,SAAS,EAAE,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;QAEpD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,KAAK,CAAC,gBAAgB,CAAC;gBAC3B,MAAM,EAAE,wBAAwB;gBAChC,MAAM,EAAE;oBACN,aAAa;oBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,YAAY;oBACzC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACvD;aACF,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,MAAM,CAAC,kBAAkB,CAC7B,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,EACvD,KAAK,CAAC,SAAS,CAChB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/lib/read-workspace-context.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Reads the local workspace context the asset pipeline expects:
+ * assets.md plus generated JSON under src/data.
+ */
+export declare function readWorkspaceContext(workspaceRoot?: string): Promise<Record<string, string>>;
+//# sourceMappingURL=read-workspace-context.d.ts.map

package/dist/lib/read-workspace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-workspace-context.d.ts","sourceRoot":"","sources":["../../src/lib/read-workspace-context.ts"],"names":[],"mappings":"AAuCA;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,aAAa,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyBzG"}

package/dist/lib/read-workspace-context.js

@@ -0,0 +1,58 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+const ASSETS_REGISTRY_PATH = "src/data/assets.md";
+const DATA_DIR = "src/data";
+const normalizeRepoPath = (rootDir, absolutePath) => path.relative(rootDir, absolutePath).split(path.sep).join("/");
+async function readFileIfExists(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+async function collectDataJsonFiles(dataDir, rootDir, files) {
+    let entries = [];
+    try {
+        entries = await fs.readdir(dataDir);
+    }
+    catch {
+        return;
+    }
+    await Promise.all(entries
+        .filter((name) => name.endsWith(".json"))
+        .map(async (name) => {
+        const absolutePath = path.join(dataDir, name);
+        const content = await readFileIfExists(absolutePath);
+        if (content == null) {
+            return;
+        }
+        files[normalizeRepoPath(rootDir, absolutePath)] = content;
+    }));
+}
+/**
+ * Reads the local workspace context the asset pipeline expects:
+ * assets.md plus generated JSON under src/data.
+ */
+export async function readWorkspaceContext(workspaceRoot = process.cwd()) {
+    const rootDir = path.resolve(workspaceRoot);
+    const files = {};
+    const assetsMdPath = path.join(rootDir, ASSETS_REGISTRY_PATH);
+    const assetsMd = await readFileIfExists(assetsMdPath);
+    if (assetsMd != null) {
+        files[ASSETS_REGISTRY_PATH] = assetsMd;
+    }
+    await collectDataJsonFiles(path.join(rootDir, DATA_DIR), rootDir, files);
+    const indexTsPath = path.join(rootDir, DATA_DIR, "index.ts");
+    const indexTs = await readFileIfExists(indexTsPath);
+    if (indexTs != null) {
+        files[normalizeRepoPath(rootDir, indexTsPath)] = indexTs;
+    }
+    const propsTsPath = path.join(rootDir, DATA_DIR, "props.ts");
+    const propsTs = await readFileIfExists(propsTsPath);
+    if (propsTs != null) {
+        files[normalizeRepoPath(rootDir, propsTsPath)] = propsTs;
+    }
+    return files;
+}
+//# sourceMappingURL=read-workspace-context.js.map

package/dist/lib/read-workspace-context.js.map

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

package/dist/lib/resolve-image.d.ts

@@ -0,0 +1,24 @@
+export declare function isUrl(value: string): boolean;
+export declare function resolveImageInput(value: string): Promise<{
+    type: "url";
+    url: string;
+    mediaType?: undefined;
+    data?: undefined;
+} | {
+    type: "base64";
+    mediaType: string;
+    data: string;
+    url?: undefined;
+}>;
+export declare function resolveImageInputs(values?: string[]): Promise<({
+    type: "url";
+    url: string;
+    mediaType?: undefined;
+    data?: undefined;
+} | {
+    type: "base64";
+    mediaType: string;
+    data: string;
+    url?: undefined;
+})[]>;
+//# sourceMappingURL=resolve-image.d.ts.map

package/dist/lib/resolve-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-image.d.ts","sourceRoot":"","sources":["../../src/lib/resolve-image.ts"],"names":[],"mappings":"AAWA,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM;;;;;;;;;;GAepD;AAED,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,MAAM,EAAO;;;;;;;;;;MAE7D"}

package/dist/lib/resolve-image.js

@@ -0,0 +1,30 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+const EXT_TO_MIME = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+};
+export function isUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+export async function resolveImageInput(value) {
+    if (isUrl(value)) {
+        return { type: "url", url: value };
+    }
+    const absolute = path.resolve(value);
+    const buffer = await fs.readFile(absolute);
+    const ext = path.extname(absolute).toLowerCase();
+    const mediaType = EXT_TO_MIME[ext] || "application/octet-stream";
+    return {
+        type: "base64",
+        mediaType,
+        data: buffer.toString("base64"),
+    };
+}
+export async function resolveImageInputs(values = []) {
+    return Promise.all(values.map(resolveImageInput));
+}
+//# sourceMappingURL=resolve-image.js.map

package/dist/lib/resolve-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-image.js","sourceRoot":"","sources":["../../src/lib/resolve-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,WAAW,GAA2B;IAC1C,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAa;IACnD,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,KAAc,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;IAEjE,OAAO;QACL,IAAI,EAAE,QAAiB;QACvB,SAAS;QACT,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAmB,EAAE;IAC5D,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/lib/status-markdown.d.ts

@@ -0,0 +1,8 @@
+export type StatusOutcome = "running" | "complete" | "cancelled" | "failed";
+export type StatusLogger = {
+    filePath: string;
+    append: (line: string) => Promise<void>;
+    finish: (outcome: Exclude<StatusOutcome, "running">, message?: string) => Promise<void>;
+};
+export declare function createStatusLogger(label: string): Promise<StatusLogger>;
+//# sourceMappingURL=status-markdown.d.ts.map

package/dist/lib/status-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-markdown.d.ts","sourceRoot":"","sources":["../../src/lib/status-markdown.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5E,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzF,CAAC;AAyEF,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAwB7E"}

package/dist/lib/status-markdown.js

@@ -0,0 +1,73 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+function statusFilePath() {
+    const custom = process.env.CAPYBARA_STATUS_FILE;
+    if (custom) {
+        return path.resolve(custom);
+    }
+    return path.resolve(process.cwd(), ".capybara", "status.md");
+}
+function formatTimestamp() {
+    return new Date().toISOString();
+}
+function renderMarkdown({ label, outcome, startedAt, lines, footer, }) {
+    const statusLabel = outcome === "running"
+        ? "running"
+        : outcome === "complete"
+            ? "complete"
+            : outcome === "cancelled"
+                ? "cancelled"
+                : "failed";
+    const body = [
+        `# Capybara — ${label}`,
+        "",
+        `**Status:** ${statusLabel}  `,
+        `**Started:** ${startedAt}  `,
+        `**Updated:** ${formatTimestamp()}  `,
+        "",
+        "> Temporary status file. Removed automatically when this tool finishes.",
+        "",
+        "## Progress",
+        "",
+        ...lines.map((line) => `- ${line}`),
+    ];
+    if (footer) {
+        body.push("", "## Result", "", footer);
+    }
+    body.push("");
+    return body.join("\n");
+}
+async function writeStatus(filePath, content) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, content, "utf-8");
+}
+async function removeStatus(filePath) {
+    try {
+        await fs.unlink(filePath);
+    }
+    catch (err) {
+        if (err.code !== "ENOENT") {
+            throw err;
+        }
+    }
+}
+export async function createStatusLogger(label) {
+    const filePath = statusFilePath();
+    const startedAt = formatTimestamp();
+    const lines = [];
+    const refresh = async (outcome, footer) => {
+        await writeStatus(filePath, renderMarkdown({ label, outcome, startedAt, lines, footer }));
+    };
+    await refresh("running");
+    return {
+        filePath,
+        append: async (line) => {
+            lines.push(`\`${formatTimestamp()}\` ${line}`);
+            await refresh("running");
+        },
+        finish: async () => {
+            await removeStatus(filePath);
+        },
+    };
+}
+//# sourceMappingURL=status-markdown.js.map

package/dist/lib/status-markdown.js.map

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

package/dist/lib/write-files.d.ts

@@ -0,0 +1,3 @@
+import type { FileWriteEntry } from "capybara-mcp-shared";
+export declare function writeFiles(files: FileWriteEntry[], rootDir: string): Promise<string[]>;
+//# sourceMappingURL=write-files.d.ts.map

package/dist/lib/write-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-files.d.ts","sourceRoot":"","sources":["../../src/lib/write-files.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,wBAAsB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB5F"}

package/dist/lib/write-files.js

@@ -0,0 +1,22 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export async function writeFiles(files, rootDir) {
+    const resolvedRoot = path.resolve(rootDir);
+    const written = [];
+    for (const file of files) {
+        const targetPath = path.resolve(resolvedRoot, file.path);
+        if (targetPath !== resolvedRoot && !targetPath.startsWith(resolvedRoot + path.sep)) {
+            throw new Error(`Refusing to write outside of ${resolvedRoot}: ${file.path}`);
+        }
+        await fs.mkdir(path.dirname(targetPath), { recursive: true });
+        if (file.content_base64) {
+            await fs.writeFile(targetPath, Buffer.from(file.content_base64, "base64"));
+        }
+        else {
+            await fs.writeFile(targetPath, file.content ?? "", "utf-8");
+        }
+        written.push(targetPath);
+    }
+    return written;
+}
+//# sourceMappingURL=write-files.js.map

package/dist/lib/write-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-files.js","sourceRoot":"","sources":["../../src/lib/write-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAuB,EAAE,OAAe;IACvE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,UAAU,KAAK,YAAY,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9D,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":""}

package/dist/setup.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+function parseArgs(argv) {
+    const args = {};
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i].startsWith("--")) {
+            const key = argv[i].slice(2);
+            const next = argv[i + 1];
+            const hasValue = next !== undefined && !next.startsWith("--");
+            args[key] = hasValue ? argv[++i] : true;
+        }
+    }
+    return args;
+}
+const args = parseArgs(process.argv.slice(2));
+const apiKey = args["api-key"];
+const serverUrl = args["server-url"] || "https://api.capybara.dev/v1";
+if (!apiKey || typeof apiKey !== "string") {
+    console.error("Missing required flag: --api-key <your-key>");
+    console.error("\nUsage:");
+    console.error("  npx -y capybara-mcp-setup --api-key <your-key>");
+    process.exit(1);
+}
+function getClaudeDesktopConfigPath() {
+    const platform = process.platform;
+    if (platform === "darwin") {
+        return path.join(os.homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    }
+    if (platform === "win32") {
+        const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
+        return path.join(appData, "Claude", "claude_desktop_config.json");
+    }
+    return path.join(os.homedir(), ".config", "Claude", "claude_desktop_config.json");
+}
+function loadConfig(configPath) {
+    if (!fs.existsSync(configPath)) {
+        return { mcpServers: {} };
+    }
+    try {
+        const parsed = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        if (!parsed.mcpServers)
+            parsed.mcpServers = {};
+        return parsed;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Could not parse existing config at ${configPath}: ${message}`);
+        process.exit(1);
+    }
+}
+const configPath = getClaudeDesktopConfigPath();
+const parsed = loadConfig(configPath);
+parsed.mcpServers ??= {};
+parsed.mcpServers["capybara-mcp"] = {
+    command: "npx",
+    args: ["-y", "capybara-mcp"],
+    env: {
+        CAPYBARA_API_KEY: apiKey,
+        CAPYBARA_API_URL: serverUrl,
+    },
+};
+fs.mkdirSync(path.dirname(configPath), { recursive: true });
+fs.writeFileSync(configPath, JSON.stringify(parsed, null, 2), "utf-8");
+console.log(`capybara-mcp configured in:\n  ${configPath}`);
+console.log("\nRestart Claude Desktop to load the new tools.");
+console.log("\nUsing Claude Code instead? Run this:");
+console.log(`  claude mcp add capybara-mcp -e CAPYBARA_API_KEY=${apiKey} -e CAPYBARA_API_URL=${serverUrl} -- npx -y capybara-mcp`);
+console.log("\nIf a generate tool is interrupted, use check_job_status with the returned job_id.");
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/tools/register-tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ClientContext } from "../api/capybara-api.js";
+export declare function registerTools(server: McpServer, ctx: Omit<ClientContext, "report" | "signal" | "onJobId">): void;
+//# sourceMappingURL=register-tools.d.ts.map

package/dist/tools/register-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAsDhC,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC,QA4DzG"}

package/dist/tools/register-tools.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { ASSET_TOOL_DESCRIPTION, mcpGenerateAssetInputSchema, } from "capybara-mcp-shared";
+import { checkJobStatus, generateAssets, } from "../api/capybara-api.js";
+import { createProgressReporter } from "../lib/progress.js";
+import { createStatusLogger } from "../lib/status-markdown.js";
+async function runLongTool({ label, extra, server, work, }) {
+    const statusLog = await createStatusLogger(label);
+    const { report } = createProgressReporter({ extra, server, label, statusLog });
+    const onJobId = async (jobId) => {
+        await statusLog.append(`job_id: ${jobId} (use check_job_status if interrupted)`);
+    };
+    try {
+        await statusLog.append("Tool call accepted");
+        const result = await work({ report, signal: extra.signal, onJobId });
+        await statusLog.finish("complete", "Completed successfully");
+        return {
+            content: [{ type: "text", text: result.summary }],
+        };
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === "AbortError") {
+            await statusLog.finish("cancelled", "Cancelled — use check_job_status with your job_id");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${label} cancelled. If a job_id was issued, call check_job_status to recover results.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        await statusLog.finish("failed", message);
+        return {
+            content: [{ type: "text", text: `Error in ${label}: ${message}` }],
+            isError: true,
+        };
+    }
+}
+export function registerTools(server, ctx) {
+    server.registerTool("generate_asset", {
+        title: "Generate game assets",
+        description: ASSET_TOOL_DESCRIPTION +
+            " Returns a job_id for check_job_status if interrupted. " +
+            "Live progress is written to `.capybara/status.md` (removed when the tool finishes).",
+        inputSchema: mcpGenerateAssetInputSchema,
+        annotations: { openWorldHint: true },
+    }, async (input, extra) => runLongTool({
+        label: "generate_asset",
+        extra,
+        server,
+        work: ({ report, signal, onJobId }) => generateAssets(input, { ...ctx, report, signal, onJobId }).then((r) => ({
+            summary: r.summary,
+        })),
+    }));
+    server.registerTool("check_job_status", {
+        title: "Check job status",
+        description: "Poll a generation job by job_id. Use when generate_asset was interrupted, or to check " +
+            "progress after closing the agent. When status is complete, writes any recovered files to disk.",
+        inputSchema: {
+            job_id: z.string().min(1).describe("The job_id from generate_asset."),
+            output_dir: z
+                .string()
+                .optional()
+                .describe("Optional output directory when recovering asset files."),
+        },
+    }, async ({ job_id, output_dir }, extra) => {
+        try {
+            const { summary, status } = await checkJobStatus(job_id, {
+                ...ctx,
+                output_dir,
+                signal: extra.signal,
+            });
+            const isError = status.status === "failed";
+            return {
+                content: [{ type: "text", text: summary }],
+                ...(isError ? { isError: true } : {}),
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `Error checking job: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=register-tools.js.map

package/dist/tools/register-tools.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "capybara-mcp",
+  "version": "0.1.0",
+  "description": "Capybara MCP tools — generate game assets from Claude Code, Cursor, Codex, and other MCP agents",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "capybara-mcp": "./dist/index.js",
+    "capybara-mcp-setup": "./dist/setup.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "capybara-mcp-shared": "0.1.0",
+    "@modelcontextprotocol/sdk": "^1.11.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "capybara",
+    "game-assets",
+    "claude",
+    "cursor"
+  ]
+}