@miragon/mcp-toolkit-tool-codegen 0.10.1

package/README.md

@@ -0,0 +1,41 @@
+# @miragon/mcp-toolkit-tool-codegen
+
+Build-time codegen + runtime glue for type-safe MCP tool calls: TypedCallTool
+helper and a CLI that generates TypeScript types + React Query hooks from an
+MCP server's tools/list.
+
+## Install
+
+Published to the public npm registry under the `@miragon` scope — no `.npmrc`
+or token needed.
+
+```sh
+pnpm add -D @miragon/mcp-toolkit-tool-codegen @miragon/mcp-toolkit-core @modelcontextprotocol/sdk@1.29.0
+```
+
+## Import paths
+
+| Subpath                             | Key exports                                                                  | Constraint                                                                                          |
+| ----------------------------------- | ---------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| `@miragon/mcp-toolkit-tool-codegen` | `generateTools`, `renderCodegen`, `writeCodegenOutput`, `fetchUpstreamTools` | Build-time only — never import from runtime code.                                                   |
+| `…-tool-codegen/runtime`            | `ToolShape`, `TypedCallTool` (types only)                                    | The only subpath widget bundles / step modules may import; pulls in no `handlebars` / codegen deps. |
+| `…-tool-codegen/templates/*`        | Handlebars templates used by the codegen                                     | Internal to the CLI.                                                                                |
+
+## CLI
+
+The `mcp-tool-codegen` bin generates `tools.ts` + `hooks.tsx` from a
+source server's `tools/list`:
+
+```sh
+mcp-tool-codegen generate            # reads ./codegen.config.ts (CodegenConfig)
+mcp-tool-codegen generate --check    # CI: exit 1 on drift vs committed output
+mcp-tool-codegen inspect --upstream https://source.example/mcp
+```
+
+Generated code imports only `@miragon/mcp-toolkit-tool-codegen/runtime`.
+
+## Links
+
+- [API reference](https://github.com/Miragon/mcp-toolkit/blob/main/docs/reference/api-tool-codegen.md)
+- [Getting started](https://github.com/Miragon/mcp-toolkit/blob/main/docs/getting-started.md)
+- [Starter template](https://github.com/Miragon/mcp-toolkit-starter) — "Use this template" for a new server project

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { generateTools, writeCodegenOutput } from "./codegen.js";
+import { fetchUpstreamTools } from "./fetch-tools.js";
+function parseArgs(argv) {
+    const args = { command: "help", check: false };
+    const [command, ...rest] = argv;
+    if (command === "generate" || command === "inspect")
+        args.command = command;
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        const next = () => rest[++i];
+        switch (arg) {
+            case "--config":
+            case "-c":
+                args.config = next();
+                break;
+            case "--check":
+                args.check = true;
+                break;
+            case "--upstream":
+            case "-u":
+                args.upstream = next();
+                break;
+            case "--token":
+                args.token = next();
+                break;
+            case "--header":
+                args.header = next();
+                break;
+            case "--header-value":
+                args.headerValue = next();
+                break;
+            case "--out":
+            case "-o":
+                args.out = next();
+                break;
+            case "--proxy":
+            case "-p":
+                args.proxyName = next();
+                break;
+            case "--help":
+            case "-h":
+                args.command = "help";
+                break;
+        }
+    }
+    return args;
+}
+function printHelp() {
+    console.log(`mcp-tool-codegen — generate typed TS client code from an MCP server's tools/list.
+
+Commands:
+  generate [--config <path>] [--check]
+      Fetch tools/list and write TypeScript + React Query hooks.
+      --check    regenerate into a temp dir and exit != 0 if the output differs
+                 from the committed files (for CI drift checks)
+  inspect --upstream <url> [--token <bearer>] [--header <name> --header-value <v>]
+      Print a markdown table of the upstream's tools without generating code.
+  help
+      Show this message.
+
+Generate reads its configuration from a file (default: ./codegen.config.ts).
+The config module's default export must satisfy the CodegenConfig type:
+
+  export default {
+    proxyName: "lexoffice",
+    upstreamUrl: process.env.LEXOFFICE_CODEGEN_SOURCE_URL,
+    auth: { mode: "bearer", token: process.env.LEXOFFICE_CODEGEN_TOKEN },
+    out: "./src/generated",
+  }
+`);
+}
+async function loadConfig(configPath) {
+    const abs = path.resolve(process.cwd(), configPath);
+    const mod = (await import(pathToFileURL(abs).href));
+    if (!mod.default) {
+        throw new Error(`codegen config at ${abs} has no default export`);
+    }
+    return mod.default;
+}
+async function runGenerate(args) {
+    const configPath = args.config ?? "./codegen.config.ts";
+    const config = await loadConfig(configPath);
+    const result = await generateTools(config);
+    if (args.check) {
+        const tmp = await fs.mkdtemp(path.join(os.tmpdir(), "mcp-tool-codegen-"));
+        try {
+            const clone = { ...config, out: tmp };
+            await writeCodegenOutput(clone, result);
+            await assertMatches(config.out, tmp);
+            console.log(`OK (${result.tools.length} tools match committed output)`);
+        }
+        finally {
+            await fs.rm(tmp, { recursive: true, force: true });
+        }
+        return;
+    }
+    await writeCodegenOutput(config, result);
+    console.log(`generated ${result.tools.length} tools → ${path.resolve(process.cwd(), config.out)}`);
+}
+async function assertMatches(committed, generated) {
+    const committedAbs = path.resolve(process.cwd(), committed);
+    let drifted = false;
+    for (const file of ["tools.ts", "hooks.tsx"]) {
+        const a = await fs.readFile(path.join(committedAbs, file), "utf-8").catch(() => null);
+        const b = await fs.readFile(path.join(generated, file), "utf-8");
+        if (a === null) {
+            console.error(`drift: ${file} missing from committed output (${committedAbs})`);
+            drifted = true;
+            continue;
+        }
+        if (a !== b) {
+            console.error(`drift: ${file} differs from committed output`);
+            printLineDiff(a, b);
+            drifted = true;
+        }
+    }
+    if (drifted)
+        process.exit(1);
+}
+/**
+ * Prints the first N differing lines between two strings. Cheap line-level
+ * diff (no LCS) — sufficient to tell the user where regeneration would
+ * change the file without pulling in a diff library.
+ */
+function printLineDiff(committed, generated, maxLines = 20) {
+    const aLines = committed.split("\n");
+    const bLines = generated.split("\n");
+    const max = Math.max(aLines.length, bLines.length);
+    let shown = 0;
+    for (let i = 0; i < max && shown < maxLines; i++) {
+        const a = aLines[i];
+        const b = bLines[i];
+        if (a !== b) {
+            if (a !== undefined)
+                console.error(`  - ${i + 1}: ${a}`);
+            if (b !== undefined)
+                console.error(`  + ${i + 1}: ${b}`);
+            shown++;
+        }
+    }
+    if (shown >= maxLines) {
+        console.error(`  ... (truncated; more differences not shown)`);
+    }
+}
+async function runInspect(args) {
+    if (!args.upstream) {
+        console.error("inspect: --upstream <url> is required");
+        process.exit(1);
+    }
+    const auth = resolveAuthFromFlags(args);
+    const tools = await fetchUpstreamTools({ upstreamUrl: args.upstream, auth });
+    console.log(`| name | description | input keys |`);
+    console.log(`| --- | --- | --- |`);
+    for (const tool of tools) {
+        const inputKeys = Object.keys(tool.inputSchema.properties ?? {});
+        const desc = (tool.description ?? "").replace(/\|/g, "\\|").replace(/\n/g, " ");
+        console.log(`| ${tool.name} | ${desc} | ${inputKeys.join(", ")} |`);
+    }
+}
+function resolveAuthFromFlags(args) {
+    if (args.token)
+        return { mode: "bearer", token: args.token };
+    if (args.header && args.headerValue) {
+        return { mode: "header", headerName: args.header, value: args.headerValue };
+    }
+    return { mode: "none" };
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    try {
+        if (args.command === "help") {
+            printHelp();
+            return;
+        }
+        if (args.command === "generate")
+            return await runGenerate(args);
+        if (args.command === "inspect")
+            return await runInspect(args);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+}
+void main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/codegen.d.ts

@@ -0,0 +1,50 @@
+import { type FetchToolsOptions, type UpstreamToolDescriptor } from "./fetch-tools.js";
+export interface CodegenConfig {
+    /** Namespace prefix for the generated tool names and type names (`<proxyName>_<tool>`). */
+    proxyName: string;
+    upstreamUrl: string;
+    auth?: FetchToolsOptions["auth"];
+    /** Output directory (relative paths resolve against process.cwd()). */
+    out: string;
+    /**
+     * Optional per-tool type overrides. Keys are full tool names
+     * (`<proxy>_<tool>`), values are literal TypeScript type expressions
+     * that replace the codegen output for that tool.
+     *
+     * Useful when the upstream omits `outputSchema` — generated output type
+     * defaults to `unknown`, an override lets you paste a hand-written
+     * result shape without editing the generated file.
+     */
+    overrides?: Record<string, {
+        input?: string;
+        output?: string;
+    }>;
+}
+export interface CodegenResult {
+    toolsFile: string;
+    hooksFile: string;
+    tools: UpstreamToolDescriptor[];
+}
+/**
+ * Fetches `tools/list` from the upstream MCP, runs `json-schema-to-typescript`
+ * on each tool's input/output schemas, and renders the two generated files
+ * from the shipped Handlebars templates.
+ *
+ * Called by the CLI (`mcp-tool-codegen generate`) but exposed programmatically
+ * so consumers can wire it into custom build pipelines or tests.
+ */
+export declare function generateTools(config: CodegenConfig): Promise<CodegenResult>;
+/**
+ * Renders the two generated files from an explicit list of upstream tools —
+ * the pure, network-free half of {@link generateTools}. Split out so the
+ * build-time↔runtime naming/output contract can be pinned by a test that feeds
+ * a fixed tool list, instead of reaching for a live upstream.
+ *
+ * Sorts by tool name so two regenerations against the same upstream produce
+ * byte-identical output regardless of the upstream's `tools/list` order.
+ */
+export declare function renderCodegen(fetched: UpstreamToolDescriptor[], config: CodegenConfig): Promise<CodegenResult>;
+export declare function toPascalCase(input: string): string;
+/** Resolve an output path against cwd, creating the directory if needed. */
+export declare function writeCodegenOutput(config: CodegenConfig, result: CodegenResult): Promise<void>;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC5B,MAAM,kBAAkB,CAAA;AAEzB,MAAM,WAAW,aAAa;IAC5B,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAChC,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAA;IACX;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChE;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,sBAAsB,EAAE,CAAA;CAChC;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAMjF;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,sBAAsB,EAAE,EACjC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,CA2BxB;AAmED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAaD,4EAA4E;AAC5E,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/codegen.js

@@ -0,0 +1,132 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import Handlebars from "handlebars";
+import { compile as compileJsonSchema, } from "json-schema-to-typescript";
+import { fetchUpstreamTools, } from "./fetch-tools.js";
+/**
+ * Fetches `tools/list` from the upstream MCP, runs `json-schema-to-typescript`
+ * on each tool's input/output schemas, and renders the two generated files
+ * from the shipped Handlebars templates.
+ *
+ * Called by the CLI (`mcp-tool-codegen generate`) but exposed programmatically
+ * so consumers can wire it into custom build pipelines or tests.
+ */
+export async function generateTools(config) {
+    const fetched = await fetchUpstreamTools({
+        upstreamUrl: config.upstreamUrl,
+        auth: config.auth,
+    });
+    return renderCodegen(fetched, config);
+}
+/**
+ * Renders the two generated files from an explicit list of upstream tools —
+ * the pure, network-free half of {@link generateTools}. Split out so the
+ * build-time↔runtime naming/output contract can be pinned by a test that feeds
+ * a fixed tool list, instead of reaching for a live upstream.
+ *
+ * Sorts by tool name so two regenerations against the same upstream produce
+ * byte-identical output regardless of the upstream's `tools/list` order.
+ */
+export async function renderCodegen(fetched, config) {
+    const tools = [...fetched].sort((a, b) => a.name.localeCompare(b.name));
+    const proxyPascal = toPascalCase(config.proxyName);
+    const toolMapName = `${proxyPascal}ToolMap`;
+    const toolNameTypeName = `${proxyPascal}ToolName`;
+    const callToolTypeName = `${proxyPascal}CallTool`;
+    const view = {
+        proxyName: config.proxyName,
+        upstreamUrl: config.upstreamUrl,
+        toolMapName,
+        toolNameTypeName,
+        callToolTypeName,
+        tools: await Promise.all(tools.map((tool) => renderTool(tool, config, proxyPascal))),
+    };
+    const [toolsTpl, hooksTpl] = await Promise.all([
+        loadTemplate("tools.ts.hbs"),
+        loadTemplate("hooks.tsx.hbs"),
+    ]);
+    return {
+        toolsFile: normalizeEof(toolsTpl(view)),
+        hooksFile: normalizeEof(hooksTpl(view)),
+        tools,
+    };
+}
+/**
+ * Exactly one trailing newline, so committed output passes the repo's
+ * Prettier gate while staying byte-identical to `generate --check`.
+ */
+function normalizeEof(rendered) {
+    return rendered.replace(/\n*$/, "\n");
+}
+async function renderTool(tool, config, proxyPascal) {
+    const toolPascal = toPascalCase(tool.name);
+    const inputTypeName = `${proxyPascal}${toolPascal}Input`;
+    const outputTypeName = `${proxyPascal}${toolPascal}Output`;
+    const fullName = `${config.proxyName}_${tool.name}`;
+    const override = config.overrides?.[fullName];
+    const inputTypeBody = override?.input
+        ? undefined
+        : await schemaToType(tool.inputSchema, inputTypeName);
+    const outputTypeBody = override?.output
+        ? undefined
+        : tool.outputSchema
+            ? await schemaToType(tool.outputSchema, outputTypeName)
+            : undefined;
+    const inputTypeRef = override?.input ?? (inputTypeBody ? inputTypeName : "unknown");
+    const outputTypeRef = override?.output ?? (outputTypeBody ? outputTypeName : "unknown");
+    return {
+        name: tool.name,
+        fullName,
+        quotedFullName: JSON.stringify(fullName),
+        hookName: `use${proxyPascal}${toolPascal}`,
+        inputTypeBody,
+        outputTypeBody,
+        inputTypeRef,
+        outputTypeRef,
+        // Prettier-style spacing so committed output passes the repo's format gate
+        // without breaking `generate --check`'s byte comparison.
+        queryKey: `[${JSON.stringify(config.proxyName)}, ${JSON.stringify(tool.name)}]`,
+    };
+}
+const json2tsOptions = {
+    bannerComment: "",
+    additionalProperties: false,
+    style: { singleQuote: false, semi: false },
+    unreachableDefinitions: false,
+};
+async function schemaToType(schema, name) {
+    const result = await compileJsonSchema(
+    // json-schema-to-typescript treats the top-level title as the type name,
+    // and `title` beats the `name` arg to `compile()`. Spread first so an
+    // upstream-supplied title can't override the codegen's chosen name.
+    { ...schema, title: name }, name, json2tsOptions);
+    return result.trim();
+}
+export function toPascalCase(input) {
+    return input
+        .split(/[-_\s]+/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+let templateDir;
+async function loadTemplate(name) {
+    if (!templateDir) {
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        // dist/codegen.js → ../templates
+        templateDir = path.resolve(here, "..", "templates");
+    }
+    const src = await fs.readFile(path.join(templateDir, name), "utf-8");
+    return Handlebars.compile(src, { noEscape: true });
+}
+/** Resolve an output path against cwd, creating the directory if needed. */
+export async function writeCodegenOutput(config, result) {
+    const outDir = path.resolve(process.cwd(), config.out);
+    await fs.mkdir(outDir, { recursive: true });
+    await Promise.all([
+        fs.writeFile(path.join(outDir, "tools.ts"), result.toolsFile),
+        fs.writeFile(path.join(outDir, "hooks.tsx"), result.hooksFile),
+    ]);
+}
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

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

package/dist/fetch-tools.d.ts

@@ -0,0 +1,38 @@
+export interface UpstreamToolDescriptor {
+    name: string;
+    description?: string;
+    title?: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+export interface FetchToolsOptions {
+    upstreamUrl: string;
+    /**
+     * Static auth for the build-time handshake. OAuth2 is not supported here —
+     * run the OAuth2 flow once in dev, paste the resulting access token, and
+     * use `{ mode: "bearer", token }` for subsequent regenerations.
+     */
+    auth?: {
+        mode: "none";
+    } | {
+        mode: "bearer";
+        token: string;
+    } | {
+        mode: "header";
+        headerName: string;
+        value: string;
+    };
+    /** Optional request headers to merge on top of the auth header. */
+    headers?: Record<string, string>;
+}
+/**
+ * Connects to an upstream MCP server over streamable HTTP, performs the
+ * initialize handshake, and returns the `tools/list` response. The
+ * connection is closed before returning.
+ *
+ * Used by the codegen CLI (`generate` / `inspect`) to snapshot a source
+ * server's tool surface. Build-time only — not intended for request-path
+ * use at runtime.
+ */
+export declare function fetchUpstreamTools(options: FetchToolsOptions): Promise<UpstreamToolDescriptor[]>;
+//# sourceMappingURL=fetch-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-tools.d.ts","sourceRoot":"","sources":["../src/fetch-tools.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,IAAI,CAAC,EACD;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChB;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GACjC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzD,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAQD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAqBnC"}

package/dist/fetch-tools.js

@@ -0,0 +1,41 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+function authHeaders(auth) {
+    if (!auth || auth.mode === "none")
+        return {};
+    if (auth.mode === "bearer")
+        return { authorization: `Bearer ${auth.token}` };
+    return { [auth.headerName.toLowerCase()]: auth.value };
+}
+/**
+ * Connects to an upstream MCP server over streamable HTTP, performs the
+ * initialize handshake, and returns the `tools/list` response. The
+ * connection is closed before returning.
+ *
+ * Used by the codegen CLI (`generate` / `inspect`) to snapshot a source
+ * server's tool surface. Build-time only — not intended for request-path
+ * use at runtime.
+ */
+export async function fetchUpstreamTools(options) {
+    const url = new URL(options.upstreamUrl);
+    const requestInit = {
+        headers: { ...authHeaders(options.auth), ...(options.headers ?? {}) },
+    };
+    const transport = new StreamableHTTPClientTransport(url, { requestInit });
+    const client = new Client({ name: "mcp-tool-codegen", version: "0.1.0" }, { capabilities: {} });
+    try {
+        await client.connect(transport);
+        const result = await client.listTools();
+        return result.tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            title: t.title,
+            inputSchema: t.inputSchema,
+            outputSchema: t.outputSchema,
+        }));
+    }
+    finally {
+        await client.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=fetch-tools.js.map

package/dist/fetch-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-tools.js","sourceRoot":"","sources":["../src/fetch-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAClE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAA;AAyBlG,SAAS,WAAW,CAAC,IAA+B;IAClD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,CAAA;IAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE,EAAE,CAAA;IAC5E,OAAO,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;AACxD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA0B;IAE1B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IACxC,MAAM,WAAW,GAAgB;QAC/B,OAAO,EAAE,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;KACtE,CAAA;IACD,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC,CAAA;IACzE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAA;IAE/F,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAC/B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAA;QACvC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;SAC7B,CAAC,CAAC,CAAA;IACL,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACtC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { ToolShape, TypedCallTool } from "./runtime.js";
+export { fetchUpstreamTools } from "./fetch-tools.js";
+export type { FetchToolsOptions, UpstreamToolDescriptor } from "./fetch-tools.js";
+export { generateTools, renderCodegen, writeCodegenOutput } from "./codegen.js";
+export type { CodegenConfig, CodegenResult } from "./codegen.js";
+//# 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":"AAAA,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AACjF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC/E,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { fetchUpstreamTools } from "./fetch-tools.js";
+export { generateTools, renderCodegen, writeCodegenOutput } from "./codegen.js";
+//# 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,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA"}

package/dist/runtime.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Runtime types referenced by codegen output. Kept in their own subpath
+ * (`@miragon/mcp-toolkit-tool-codegen/runtime`) so widget bundles and
+ * step modules can import the types without pulling in the CLI / codegen
+ * dependencies (handlebars, json-schema-to-typescript).
+ */
+export interface ToolShape {
+    input: unknown;
+    output: unknown;
+}
+/**
+ * A typed `callTool` closure bound to a specific upstream-MCP's tool map.
+ * The `TMap` type is filled in by the generated `<Proxy>ToolMap` interface;
+ * consumers write `TypedCallTool<LexofficeToolMap>` and get auto-completion
+ * plus compile-time validation on tool names, args, and results.
+ *
+ * Surface is deliberately 2-arg — the framework pipeline executor injects
+ * the caller's userId behind the scenes so step code stays clean.
+ */
+export type TypedCallTool<TMap extends Record<string, ToolShape>> = <TName extends keyof TMap & string>(name: TName, args: TMap[TName]["input"]) => Promise<TMap[TName]["output"]>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAClE,KAAK,SAAS,MAAM,IAAI,GAAG,MAAM,EAEjC,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KACvB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA"}

package/dist/runtime.js

@@ -0,0 +1,8 @@
+/**
+ * Runtime types referenced by codegen output. Kept in their own subpath
+ * (`@miragon/mcp-toolkit-tool-codegen/runtime`) so widget bundles and
+ * step modules can import the types without pulling in the CLI / codegen
+ * dependencies (handlebars, json-schema-to-typescript).
+ */
+export {};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@miragon/mcp-toolkit-tool-codegen",
+  "version": "0.10.1",
+  "description": "Build-time codegen + runtime glue for type-safe MCP tool calls: TypedCallTool helper and a CLI that generates TypeScript types + React Query hooks from an MCP server's tools/list.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcp-tool-codegen": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js"
+    },
+    "./templates/*": "./templates/*"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@miragon/mcp-toolkit-core": "0.10.1"
+  },
+  "dependencies": {
+    "handlebars": "4.7.9",
+    "json-schema-to-typescript": "15.0.4"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@types/node": "26.1.1",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10",
+    "@miragon/mcp-toolkit-core": "0.10.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/make-cli-executable.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src --max-warnings 0",
+    "lint:fix": "eslint src --fix"
+  }
+}

package/templates/hooks.tsx.hbs

@@ -0,0 +1,22 @@
+// AUTO-GENERATED by @miragon/mcp-toolkit-tool-codegen. Do not edit by hand.
+// Regenerate with: pnpm mcp-tool-codegen generate
+// Source: {{upstreamUrl}}
+// Proxy: {{proxyName}}
+
+import { useToolQuery, type UseToolQueryOptions } from "@miragon/mcp-toolkit-ui"
+import type { {{toolMapName}} } from "./tools.js"
+
+{{#each tools}}
+export function {{hookName}}(
+  args: {{../toolMapName}}[{{{quotedFullName}}}]["input"],
+  options?: UseToolQueryOptions<{{../toolMapName}}[{{{quotedFullName}}}]["output"]>,
+) {
+  return useToolQuery<{{../toolMapName}}[{{{quotedFullName}}}]["output"]>(
+    {{{queryKey}}},
+    {{{quotedFullName}}},
+    args,
+    options,
+  )
+}
+
+{{/each}}

package/templates/tools.ts.hbs

@@ -0,0 +1,28 @@
+// AUTO-GENERATED by @miragon/mcp-toolkit-tool-codegen. Do not edit by hand.
+// Regenerate with: pnpm mcp-tool-codegen generate
+// Source: {{upstreamUrl}}
+// Proxy: {{proxyName}}
+/* eslint-disable @typescript-eslint/no-empty-object-type */
+
+import type { ToolShape, TypedCallTool } from "@miragon/mcp-toolkit-tool-codegen/runtime"
+
+{{#each tools}}
+{{#if inputTypeBody}}
+{{{inputTypeBody}}}
+{{/if}}
+{{#if outputTypeBody}}
+{{{outputTypeBody}}}
+{{/if}}
+{{/each}}
+
+export interface {{toolMapName}} extends Record<string, ToolShape> {
+{{#each tools}}
+  {{{quotedFullName}}}: {
+    input: {{inputTypeRef}}
+    output: {{outputTypeRef}}
+  }
+{{/each}}
+}
+
+export type {{toolNameTypeName}} = keyof {{toolMapName}} & string
+export type {{callToolTypeName}} = TypedCallTool<{{toolMapName}}>