@atelierai/uco 1.0.0

package/dist/codegen/coerce.js

@@ -0,0 +1,117 @@
+// Runtime value coercers used by generated commands.
+//
+// CLI flags are always strings; tool parameters expect typed objects.
+// These helpers translate the raw flag value into the shape the
+// upstream Unity-MCP server wants, with friendly shorthands for
+// Vector3 ("1,2,3") and GameObjectRef ("/Player" or "1234").
+import { expandStructuredReference } from '../util/input.js';
+import { CliError } from '../util/errors.js';
+export function coerceVec3(raw) {
+    const referenced = raw.startsWith('@');
+    const expanded = expandStructuredReference(raw);
+    if (referenced || expanded.trim().startsWith('{')) {
+        const parsed = parseStructuredJson(expanded, 'Vector3');
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error(`Vector3 JSON must be an object, got: ${expanded}`);
+        }
+        const obj = parsed;
+        const x = Number(obj.x);
+        const y = Number(obj.y);
+        const z = Number(obj.z);
+        if (![x, y, z].every(Number.isFinite)) {
+            throw new Error(`Vector3 JSON missing numeric x/y/z: ${expanded}`);
+        }
+        return { x, y, z };
+    }
+    const parts = expanded.split(',').map((s) => Number(s.trim()));
+    if (parts.length !== 3 || parts.some((n) => !Number.isFinite(n))) {
+        throw new Error(`Expected "x,y,z" or JSON {x,y,z}, got: ${expanded}`);
+    }
+    return { x: parts[0], y: parts[1], z: parts[2] };
+}
+export function coerceGameObjectRef(raw) {
+    const referenced = raw.startsWith('@');
+    const trimmed = expandStructuredReference(raw).trim();
+    if (referenced || trimmed.startsWith('{')) {
+        const parsed = parseStructuredJson(trimmed, 'GameObjectRef');
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new Error(`GameObjectRef JSON must be an object, got: ${trimmed}`);
+        }
+        return parsed;
+    }
+    // Pure integer → instance ID
+    if (/^-?\d+$/.test(trimmed)) {
+        return { instanceID: parseInt(trimmed, 10) };
+    }
+    // Looks like a hierarchy path (contains slash) or anything else → treat as path
+    if (trimmed.includes('/')) {
+        return { path: trimmed };
+    }
+    // Single token, non-numeric → could be either name or path; upstream
+    // priority is instanceID > path > name, so default to path which is
+    // the most common positional match.
+    return { path: trimmed };
+}
+export function coerceInteger(raw, minimum, maximum) {
+    const trimmed = raw.trim();
+    const expectation = integerExpectation(minimum, maximum);
+    if (!/^[+-]?\d+$/.test(trimmed)) {
+        throw new Error(`Expected ${expectation}, got: ${raw}`);
+    }
+    const n = Number(trimmed);
+    if (!Number.isSafeInteger(n)
+        || (minimum !== undefined && n < minimum)
+        || (maximum !== undefined && n > maximum)) {
+        throw new Error(`Expected ${expectation}, got: ${raw}`);
+    }
+    return n;
+}
+export function coerceNumber(raw) {
+    if (typeof raw !== 'string')
+        return raw;
+    const n = Number(raw);
+    if (!Number.isFinite(n))
+        throw new Error(`Expected number, got: ${raw}`);
+    return n;
+}
+export function coerceBoolean(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (typeof raw === 'boolean')
+        return raw;
+    const lower = raw.toLowerCase();
+    if (lower === 'true' || lower === '1' || lower === 'yes')
+        return true;
+    if (lower === 'false' || lower === '0' || lower === 'no')
+        return false;
+    throw new Error(`Expected true|false, got: ${raw}`);
+}
+export function coerceJson(raw) {
+    try {
+        return JSON.parse(expandStructuredReference(raw));
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw new Error(`Invalid JSON: ${err.message}`);
+    }
+}
+function parseStructuredJson(raw, label) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Invalid ${label} JSON: ${err.message}`);
+    }
+}
+function integerExpectation(minimum, maximum) {
+    if (minimum !== undefined && maximum !== undefined) {
+        return `a safe integer from ${minimum} to ${maximum}`;
+    }
+    if (minimum !== undefined)
+        return `a safe integer greater than or equal to ${minimum}`;
+    if (maximum !== undefined)
+        return `a safe integer less than or equal to ${maximum}`;
+    return 'a safe integer';
+}
+//# sourceMappingURL=coerce.js.map

package/dist/codegen/coerce.js.map

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

package/dist/codegen/emit.d.ts

@@ -0,0 +1,2 @@
+import type { ToolCatalogEntry } from './types.js';
+export declare function emitToolCommands(tools: readonly ToolCatalogEntry[]): string;

package/dist/codegen/emit.js

@@ -0,0 +1,213 @@
+// JSON Schema → TypeScript commander command emitter.
+//
+// Input:  the GET /api/tools catalog (an array of ToolCatalogEntry)
+// Output: a TS source file that exports `registerGeneratedTools(program)`
+//         which registers one commander command per tool, with smart
+//         flag coercion for primitives, Vector3, GameObjectRef, enums.
+import { resolveRef, refName, classifyRefTarget } from './refs.js';
+import { normalizeToolCatalog } from '../catalog.js';
+const INTEGER_BOUND_OVERRIDES = {
+    // The current Unity-MCP catalog describes these bounds but does not emit
+    // JSON Schema minimum/maximum keywords. Keep the CLI boundary aligned with
+    // the server-side validation across catalog regeneration.
+    'tests-run': {
+        executionTimeoutSeconds: { minimum: 1, maximum: 86_400 },
+        waitTimeoutSeconds: { minimum: 1, maximum: 300 },
+    },
+};
+const HEADER = `// AUTO-GENERATED by uco codegen — do not edit by hand.
+// Regenerate with: \`npm run gen --silent -- <unity-project-path>\`
+// or programmatically via src/codegen/{fetch,emit}.ts.
+//
+// Source: GET /api/tools from a Unity-MCP server (IvanMurzak/Unity-MCP).
+// Each tool becomes a top-level commander subcommand whose flags
+// mirror its inputSchema.properties — required → .requiredOption(),
+// optional → .option(), with smart coercion for Vector3 / GameObjectRef
+// shorthand, enums via .choices(), and JSON for nested objects/arrays.
+`;
+export function emitToolCommands(tools) {
+    // Emit a command for every tool, regardless of upstream `enabled` flag.
+    // The server gates invocation; uco's job is to maximize discoverability.
+    // When a disabled tool is called, the server returns 4xx — the user can
+    // then run `uco configure --enable-tools <name>` to switch it on.
+    const catalog = normalizeToolCatalog(tools);
+    const out = [];
+    out.push(HEADER);
+    out.push(`import { Command, Option } from 'commander';`);
+    out.push(`import { runCommand } from '../util/cli-context.js';`);
+    out.push(`import { addToolCallControlOptions, toolCallOptionsFromCli } from '../util/call-control.js';`);
+    out.push(`import { coerceVec3, coerceGameObjectRef, coerceInteger, coerceNumber, coerceBoolean, coerceJson } from '../codegen/coerce.js';`);
+    out.push(`import { resolveTextInput } from '../util/input.js';`);
+    out.push(``);
+    out.push(`export const GENERATED_TOOL_NAMES: readonly string[] = [`);
+    for (const t of catalog)
+        out.push(`  ${JSON.stringify(t.name)},`);
+    out.push(`];`);
+    out.push(``);
+    out.push(`/** Tools the server has marked disabled in its config at codegen time. */`);
+    out.push(`export const DEFAULT_DISABLED_TOOLS: readonly string[] = [`);
+    for (const t of catalog) {
+        if (t.enabled === false)
+            out.push(`  ${JSON.stringify(t.name)},`);
+    }
+    out.push(`];`);
+    out.push(``);
+    out.push(`export function registerGeneratedTools(program: Command): void {`);
+    for (const tool of catalog) {
+        out.push(emitOne(tool));
+    }
+    out.push(`}`);
+    return out.join('\n') + '\n';
+}
+function emitOne(tool) {
+    const props = resolveProperties(tool);
+    const summary = oneLine(tool.description || tool.title || tool.name);
+    const lines = [];
+    lines.push(`  // ${tool.title || tool.name}`);
+    lines.push(`  {`);
+    lines.push(`    const cmd = program`);
+    lines.push(`      .command(${JSON.stringify(tool.name)})`);
+    lines.push(`      .description(${JSON.stringify(summary)});`);
+    for (const p of props) {
+        lines.push(emitFlag(p, tool.name === 'script-execute' && p.name === 'csharpCode'));
+    }
+    if (tool.name === 'script-execute') {
+        lines.push(`    cmd.addOption(new Option("--code-file <path>", "Read csharpCode as strict UTF-8 from a path or - (stdin)."));`);
+    }
+    lines.push(`    addToolCallControlOptions(cmd);`);
+    lines.push(`    cmd.action(function (this: Command, _opts: Record<string, unknown>) {`);
+    lines.push(`      return runCommand(this, async (ctx) => {`);
+    lines.push(`        const opts = this.opts();`);
+    lines.push(`        const args: Record<string, unknown> = {};`);
+    for (const p of props) {
+        // Only include the parameter when the user actually passed it.
+        if (tool.name === 'script-execute' && p.name === 'csharpCode') {
+            lines.push(`        args["csharpCode"] = resolveTextInput(opts["csharpCode"], opts["codeFile"], "--csharpCode", "--code-file");`);
+        }
+        else {
+            lines.push(`        if (opts[${JSON.stringify(p.name)}] !== undefined) args[${JSON.stringify(p.name)}] = opts[${JSON.stringify(p.name)}];`);
+        }
+    }
+    lines.push(`        return ctx.transport.callTool(${JSON.stringify(tool.name)}, args, toolCallOptionsFromCli(opts));`);
+    lines.push(`      })();`);
+    lines.push(`    });`);
+    lines.push(`  }`);
+    return lines.join('\n');
+}
+function emitFlag(p, deferRequired = false) {
+    const flag = `--${p.name} ${valueToken(p)}`;
+    const desc = oneLine(p.description || p.name);
+    // Build via Option so we can attach choices + parser cleanly.
+    const optExpr = buildOptionExpr(flag, desc, p);
+    const method = p.required ? 'addOption' : 'addOption';
+    // Required: use `.makeOptionMandatory(true)` chained on the Option.
+    const suffix = p.required && !deferRequired ? '.makeOptionMandatory(true)' : '';
+    return `    cmd.${method}(${optExpr}${suffix});`;
+}
+function buildOptionExpr(flag, desc, p) {
+    const base = `new Option(${JSON.stringify(flag)}, ${JSON.stringify(desc)})`;
+    switch (p.kind) {
+        case 'enum-string':
+            return `${base}.choices(${JSON.stringify(p.enumValues ?? [])})`;
+        case 'integer':
+            return `${base}.argParser(${integerParser(p)})`;
+        case 'number':
+            return `${base}.argParser(coerceNumber)`;
+        case 'boolean':
+            return `${base}.argParser(coerceBoolean)`;
+        case 'vec3':
+            return `${base}.argParser(coerceVec3)`;
+        case 'gameobject-ref':
+            return `${base}.argParser(coerceGameObjectRef)`;
+        case 'object':
+        case 'array':
+            return `${base}.argParser(coerceJson)`;
+        case 'string':
+        default:
+            return base;
+    }
+}
+function valueToken(p) {
+    switch (p.kind) {
+        case 'enum-string': return '<value>';
+        case 'integer': return '<int>';
+        case 'number': return '<num>';
+        case 'boolean': return '<bool>';
+        case 'vec3': return '<x,y,z|json>';
+        case 'gameobject-ref': return '<ref>';
+        case 'object': return '<json>';
+        case 'array': return '<json-array>';
+        case 'string':
+        default: return '<string>';
+    }
+}
+function resolveProperties(tool) {
+    const schema = asJsonSchema(tool.inputSchema);
+    if (!schema || !schema.properties)
+        return [];
+    const $defs = schema.$defs ?? {};
+    const required = new Set(schema.required ?? []);
+    const result = [];
+    for (const [name, raw] of Object.entries(schema.properties)) {
+        const resolved = resolveRef(raw, $defs);
+        const refTarget = raw.$ref ? refName(raw) : undefined;
+        const refClass = refTarget ? classifyRefTarget(refTarget) : undefined;
+        const kind = pickKind(resolved, refClass);
+        const enumValues = resolved.enum && Array.isArray(resolved.enum)
+            ? resolved.enum.filter((v) => typeof v === 'string')
+            : undefined;
+        const override = INTEGER_BOUND_OVERRIDES[tool.name]?.[name];
+        const minimum = finiteNumber(raw.minimum ?? resolved.minimum ?? override?.minimum);
+        const maximum = finiteNumber(raw.maximum ?? resolved.maximum ?? override?.maximum);
+        result.push({
+            name,
+            required: required.has(name),
+            description: resolved.description || raw.description || '',
+            kind,
+            ...(enumValues && enumValues.length > 0 ? { enumValues } : {}),
+            ...(kind === 'integer' && minimum !== undefined ? { minimum } : {}),
+            ...(kind === 'integer' && maximum !== undefined ? { maximum } : {}),
+        });
+    }
+    return result;
+}
+function asJsonSchema(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function integerParser(property) {
+    if (property.minimum === undefined && property.maximum === undefined)
+        return 'coerceInteger';
+    return `(raw) => coerceInteger(raw, ${property.minimum ?? 'undefined'}, ${property.maximum ?? 'undefined'})`;
+}
+function finiteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function pickKind(schema, refClass) {
+    if (refClass === 'vec3')
+        return 'vec3';
+    if (refClass === 'gameobject-ref')
+        return 'gameobject-ref';
+    const t = Array.isArray(schema.type) ? schema.type[0] : schema.type;
+    if (t === 'string') {
+        if (schema.enum && schema.enum.length > 0)
+            return 'enum-string';
+        return 'string';
+    }
+    if (t === 'integer')
+        return 'integer';
+    if (t === 'number')
+        return 'number';
+    if (t === 'boolean')
+        return 'boolean';
+    if (t === 'array')
+        return 'array';
+    if (t === 'object')
+        return 'object';
+    return 'object';
+}
+function oneLine(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+//# sourceMappingURL=emit.js.map

package/dist/codegen/emit.js.map

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

package/dist/codegen/fetch.d.ts

@@ -0,0 +1,9 @@
+import type { ToolCatalogEntry } from './types.js';
+export interface FetchOptions {
+    projectPath?: string;
+    url?: string;
+    token?: string;
+    timeoutMs?: number;
+}
+export declare function fetchTools(opts: FetchOptions): Promise<ToolCatalogEntry[]>;
+export declare function writeCatalog(tools: ToolCatalogEntry[], outPath: string): void;

package/dist/codegen/fetch.js

@@ -0,0 +1,30 @@
+// Fetch the tool catalog from a live Unity-MCP server.
+//
+// Uses uco's own transport so it inherits port resolution, auth, and
+// timeout handling. The catalog is written verbatim to
+// src/generated/tools.json — agnostic to schema changes upstream.
+import { writeFileSync } from 'node:fs';
+import { resolveConnection } from '../config/resolve.js';
+import { canonicalCatalogJson, normalizeCatalogResponse } from '../catalog.js';
+export async function fetchTools(opts) {
+    const resolved = resolveConnection({
+        ...(opts.projectPath ? { projectPath: opts.projectPath } : {}),
+        ...(opts.url ? { url: opts.url } : {}),
+        ...(opts.token ? { token: opts.token } : {}),
+    });
+    const headers = { 'Content-Type': 'application/json' };
+    if (resolved.token)
+        headers['Authorization'] = `Bearer ${resolved.token}`;
+    const res = await fetch(`${resolved.baseUrl}/api/tools`, {
+        headers,
+        ...(opts.timeoutMs ? { signal: AbortSignal.timeout(opts.timeoutMs) } : {}),
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch /api/tools: HTTP ${res.status} ${res.statusText}`);
+    }
+    return normalizeCatalogResponse(await res.json());
+}
+export function writeCatalog(tools, outPath) {
+    writeFileSync(outPath, canonicalCatalogJson(tools), 'utf8');
+}
+//# sourceMappingURL=fetch.js.map

package/dist/codegen/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/codegen/fetch.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,qEAAqE;AACrE,uDAAuD;AACvD,kEAAkE;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAS/E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAkB;IACjD,MAAM,QAAQ,GAAG,iBAAiB,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC,CAAC;IACH,MAAM,OAAO,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;IAC/E,IAAI,QAAQ,CAAC,KAAK;QAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,CAAC,OAAO,YAAY,EAAE;QACvD,OAAO;QACP,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,wBAAwB,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAyB,EAAE,OAAe;IACrE,aAAa,CAAC,OAAO,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC"}

package/dist/codegen/refs.d.ts

@@ -0,0 +1,9 @@
+import type { JsonSchema } from './types.js';
+export declare function resolveRef(schema: JsonSchema | undefined, $defs: Record<string, JsonSchema>): JsonSchema;
+/**
+ * Classify a $ref target so we can pick a coercer.
+ * Returns one of: 'vec3' | 'gameobject-ref' | undefined.
+ */
+export declare function classifyRefTarget(refName: string): 'vec3' | 'gameobject-ref' | undefined;
+/** Pull the bare type name out of a `#/$defs/Foo.Bar` ref. */
+export declare function refName(schema: JsonSchema): string | undefined;

package/dist/codegen/refs.js

@@ -0,0 +1,38 @@
+// Resolve JSON Schema $ref pointers inside the tool's local $defs.
+//
+// Unity-MCP emits self-contained schemas: each tool's inputSchema has
+// its own $defs map, and refs look like `#/$defs/UnityEngine.Vector3`.
+export function resolveRef(schema, $defs) {
+    if (!schema || typeof schema !== 'object')
+        return schema ?? {};
+    if (typeof schema.$ref !== 'string')
+        return schema;
+    const m = /^#\/\$defs\/(.+)$/.exec(schema.$ref);
+    if (!m)
+        return schema;
+    const key = m[1];
+    const target = $defs[key];
+    if (!target)
+        return schema;
+    // Preserve description from the referring site so it surfaces in --help.
+    return { ...target, ...(schema.description ? { description: schema.description } : {}) };
+}
+/**
+ * Classify a $ref target so we can pick a coercer.
+ * Returns one of: 'vec3' | 'gameobject-ref' | undefined.
+ */
+export function classifyRefTarget(refName) {
+    if (refName === 'UnityEngine.Vector3')
+        return 'vec3';
+    if (refName === 'AIGD.GameObjectRef')
+        return 'gameobject-ref';
+    return undefined;
+}
+/** Pull the bare type name out of a `#/$defs/Foo.Bar` ref. */
+export function refName(schema) {
+    if (typeof schema.$ref !== 'string')
+        return undefined;
+    const m = /^#\/\$defs\/(.+)$/.exec(schema.$ref);
+    return m ? m[1] : undefined;
+}
+//# sourceMappingURL=refs.js.map

package/dist/codegen/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/codegen/refs.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,sEAAsE;AACtE,uEAAuE;AAIvE,MAAM,UAAU,UAAU,CAAC,MAA8B,EAAE,KAAiC;IAC1F,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,IAAI,EAAE,CAAC;IAC/D,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IACnD,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACtB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAC3B,yEAAyE;IACzE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,IAAI,OAAO,KAAK,qBAAqB;QAAE,OAAO,MAAM,CAAC;IACrD,IAAI,OAAO,KAAK,oBAAoB;QAAE,OAAO,gBAAgB,CAAC;IAC9D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,OAAO,CAAC,MAAkB;IACxC,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9B,CAAC"}

package/dist/codegen/types.d.ts

@@ -0,0 +1,40 @@
+export interface ToolCatalogEntry {
+    name: string;
+    enabled: boolean;
+    title?: string | null;
+    description?: string | null;
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+    readOnlyHint?: boolean | null;
+    destructiveHint?: boolean | null;
+    idempotentHint?: boolean | null;
+    openWorldHint?: boolean | null;
+    executionAffinity?: 'main-thread' | 'background' | 'either';
+    threadSafeRead?: boolean;
+    [member: string]: unknown;
+}
+export interface JsonSchema {
+    type?: string | string[];
+    description?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    enum?: unknown[];
+    minimum?: number;
+    maximum?: number;
+    $ref?: string;
+    $defs?: Record<string, JsonSchema>;
+    items?: JsonSchema | JsonSchema[];
+    additionalProperties?: boolean | JsonSchema;
+    [keyword: string]: unknown;
+}
+/** Categorical kind we map each input property to for flag generation. */
+export type FlagKind = 'string' | 'enum-string' | 'integer' | 'number' | 'boolean' | 'vec3' | 'gameobject-ref' | 'object' | 'array';
+export interface ResolvedProperty {
+    name: string;
+    required: boolean;
+    description: string;
+    kind: FlagKind;
+    enumValues?: string[];
+    minimum?: number;
+    maximum?: number;
+}

package/dist/codegen/types.js

@@ -0,0 +1,3 @@
+// Schema types for the GET /api/tools catalog the Unity-MCP server emits.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/codegen/types.js.map

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

package/dist/commands/call.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+import { type ToolCallCliOptions } from '../util/call-control.js';
+interface CallOptions extends ToolCallCliOptions {
+    args?: string;
+    argsFile?: string;
+    system?: boolean;
+}
+export declare function registerCall(program: Command): void;
+export declare function loadArgs(opts: CallOptions): Record<string, unknown>;
+export {};