@hyper3d/cli 0.0.1 → 0.1.0-beta.2.1

package/dist/index.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { Command, Option } from 'commander';
+import { accountInfo } from './account.js';
+import { login, logout } from './auth.js';
+import { DEFAULT_BASE_URL, configureEndpoints, endpoints, } from './endpoints.js';
+import { generate, status, result, poll, bang } from './operations.js';
+import { formatOutput } from './output.js';
+import { checkUpdate, update, startupUpdate, updateChannel } from './update.js';
+import { getConfigDir } from './utils.js';
+const pkg = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+const print = (value, kind) => {
+    process.stdout.write(`${formatOutput(value, { format: cli.opts().output, kind })}\n`);
+};
+const cli = new Command('hyper3d').version(pkg.version);
+cli.option('--base-url <url>', 'Hyper3D API base URL (overrides BASE_URL)', process.env.BASE_URL ?? DEFAULT_BASE_URL);
+cli.addOption(new Option('--output <format>', 'Output format')
+    .choices(['human', 'json'])
+    .default('human'));
+cli.hook('preAction', () => {
+    configureEndpoints(cli.opts().baseUrl);
+});
+cli.hook('preAction', async (_root, command) => {
+    if (command.parent !== cli ||
+        !['generate', 'status', 'poll', 'result', 'bang'].includes(command.name()))
+        return;
+    if (process.env.CI ||
+        !process.stderr.isTTY ||
+        process.env.HYPER3D_UPDATE_CHECK === '0')
+        return;
+    const updated = await startupUpdate(pkg, {
+        autoUpdate: process.env.HYPER3D_AUTO_UPDATE === '1',
+        cacheDir: getConfigDir(),
+    });
+    if (updated)
+        throw new Error('CLI updated; rerun your command.');
+});
+// auth
+const authentication = cli.command('auth');
+authentication
+    .command('login')
+    .option('--no-browser', 'Print the verification link and code without opening a browser')
+    .action(async (options) => {
+    await login(endpoints.mcp, { browser: options.browser });
+    print({ authenticated: true }, 'auth-login');
+});
+authentication.command('logout').action(async () => {
+    await logout(endpoints.mcp);
+    print({ localCredentialsRemoved: true }, 'auth-logout');
+});
+authentication
+    .command('status')
+    .alias('info')
+    .description('Show your account and authorized wallet credit balances')
+    .action(async () => print(await accountInfo(), 'account'));
+// generate
+cli
+    .command('generate')
+    .description('Generate a model from text and/or local reference images')
+    .option('--prompt <text>', 'Model description')
+    .option('--image <path>', 'Reference image; repeat for up to five images', (path, paths) => [...paths, path], [])
+    .option('--tier <tier>', 'Generation tier')
+    .option('--mesh-mode <mode>', 'Mesh mode, e.g. Raw or Quad')
+    .option('--format <format>', 'Geometry format, e.g. glb')
+    .option('--quality <count>', 'Target polygon count', Number)
+    .action(async (options) => print(await generate(options)));
+// poll
+for (const [command, action] of [
+    ['status', status],
+    ['result', result],
+]) {
+    cli
+        .command(`${command} <generation-id>`)
+        .action(async (id) => print(await action(id)));
+}
+cli
+    .command('poll <generation-id>')
+    .description('Poll until generation finishes or the timeout expires')
+    .option('--timeout <seconds>', 'Total polling timeout in seconds', Number, 30)
+    .action(async (id, options) => print(await poll(id, options.timeout)));
+// bang
+cli
+    .command('bang <generation-id>')
+    .description('Run BANG to separate a completed model into parts')
+    .option('--instruction <text>', 'Parts to separate')
+    .option('--strength <count>', 'Target part count', Number)
+    .option('--format <format>', 'Geometry format')
+    .action(async (id, options) => print(await bang(id, options)));
+// update
+cli
+    .command('update')
+    .option('--check', 'Only check npm')
+    .option('--channel <channel>', 'latest, next or beta', updateChannel(pkg))
+    .action(async (options) => print(options.check
+    ? await checkUpdate(pkg, options.channel)
+    : await update(pkg, fileURLToPath(new URL('..', import.meta.url)), options.channel)));
+try {
+    await cli.parseAsync();
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : 'Request failed';
+    process.stderr.write(`error: ${message}\n`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,99 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { Payload, ToolClient } from './types.js';
+import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare function withClient<T>({ endpoint, version }: {
+    endpoint: string;
+    version: string;
+}, action: (client: Client) => Promise<T>): Promise<T>;
+export declare function listTools(client: Client): Promise<{
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+}[]>;
+export interface ToolContext {
+    client: ToolClient;
+    remoteTools: Tool[];
+}
+export declare function withToolContext<T>(action: (context: ToolContext) => Promise<T>, context?: ToolContext): Promise<T>;
+export declare function resultData(result: CallToolResult): Payload;
+export interface GenerateInput {
+    prompt?: string;
+    reference_upload_ids?: string[];
+    mesh_mode?: string;
+    tier?: string;
+    quality_override?: number;
+    geometry_file_format?: string;
+}
+export declare function validateGenerate(context: ToolContext, input: GenerateInput): void;
+export declare function rodinCreateUploads(context: ToolContext, input: {
+    files: {
+        filename: string;
+        mime_type: string;
+        size_bytes: number;
+    }[];
+}): Promise<Payload>;
+export declare function rodinImportImages(context: ToolContext, input: {
+    images: {
+        download_url: string;
+        file_id: string;
+        mime_type?: string;
+        file_name?: string;
+    }[];
+}): Promise<Payload>;
+export declare function rodinGenerate(context: ToolContext, input: GenerateInput): Promise<Payload>;
+export declare function rodinGenerateBang(context: ToolContext, input: {
+    asset_id: string;
+    instruction?: string;
+    strength?: number;
+    explode_strength?: number;
+    escore?: number;
+    reference_scale?: number;
+    seed?: number;
+    geometry_file_format?: string;
+    resolution?: string;
+}): Promise<Payload>;
+export declare function rodinGetStatus(context: ToolContext, input: {
+    generation_id: string;
+}): Promise<Payload>;
+export declare function rodinWait(context: ToolContext, input: {
+    generation_id: string;
+    timeout_seconds?: number;
+}): Promise<Payload>;
+export declare function rodinGetResult(context: ToolContext, input: {
+    generation_id: string;
+}): Promise<Payload>;

package/dist/mcp.js

@@ -0,0 +1,116 @@
+import { readFile } from 'node:fs/promises';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { loadCredentials, createProvider } from './auth.js';
+import { endpoints, secureUrl } from './endpoints.js';
+import { prepareCall } from './schema.js';
+const { version } = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+export async function withClient({ endpoint, version }, action) {
+    const url = secureUrl(endpoint);
+    const client = new Client({ name: 'hyper3d-cli', version });
+    const credentials = await loadCredentials(endpoint);
+    const transport = new StreamableHTTPClientTransport(url, {
+        requestInit: { headers: { 'X-Hyper3D-CLI-Version': version } },
+        authProvider: credentials.clientId
+            ? createProvider(endpoint, credentials)
+            : undefined,
+    });
+    try {
+        await client.connect(transport, { timeout: 15000 });
+        return await action(client);
+    }
+    finally {
+        await client.close();
+    }
+}
+export async function listTools(client) {
+    const tools = [], seen = new Set();
+    let cursor;
+    do {
+        const page = await client.listTools(cursor ? { cursor } : {}, {
+            timeout: 15000,
+        });
+        tools.push(...page.tools);
+        cursor = page.nextCursor;
+        if (cursor && seen.has(cursor))
+            throw new Error('MCP returned a repeated pagination cursor');
+        seen.add(cursor);
+        if (seen.size > 100)
+            throw new Error('MCP tool pagination limit exceeded');
+    } while (cursor);
+    return tools;
+}
+// A workflow owns one connection; an injected context remains caller-owned.
+export async function withToolContext(action, context) {
+    if (context)
+        return action(context);
+    return withClient({ endpoint: endpoints.mcp, version }, async (client) => action({ client, remoteTools: await listTools(client) }));
+}
+function cliResult(data) {
+    if (!data || typeof data !== 'object' || Array.isArray(data))
+        return data;
+    const result = { ...data };
+    delete result.display_url;
+    return result;
+}
+export function resultData(result) {
+    if (result.isError)
+        throw new Error(`Operation failed: ${result.content
+            ?.filter((c) => c.type === 'text')
+            .map((c) => (c.type === 'text' ? c.text : ''))
+            .join('\n') || 'server returned an error'}`);
+    if (result.structuredContent)
+        return cliResult(result.structuredContent);
+    for (const item of result.content ?? []) {
+        if (item.type === 'text') {
+            try {
+                return cliResult(JSON.parse(item.text));
+            }
+            catch {
+                /* Try the next text block. */
+            }
+        }
+    }
+    throw new Error('Server returned no structured operation result');
+}
+function updateHint(error) {
+    return new Error(`${error instanceof Error ? error.message : String(error)}\nCheck for updates: hyper3d update --check. The operation was not retried.`, { cause: error });
+}
+async function call(context, name, input) {
+    try {
+        const request = prepareCall(name, input, context.remoteTools.find((tool) => tool.name === name));
+        // Submit once; a failed or timed-out call may already have created a task.
+        const response = await context.client.callTool(request, undefined, {
+            timeout: 60000,
+        });
+        return resultData(response);
+    }
+    catch (error) {
+        throw updateHint(error);
+    }
+}
+export function validateGenerate(context, input) {
+    prepareCall('rodin_generate', input, context.remoteTools.find((tool) => tool.name === 'rodin_generate'), () => { });
+}
+export async function rodinCreateUploads(context, input) {
+    return call(context, 'rodin_create_uploads', input);
+}
+export async function rodinImportImages(context, input) {
+    return call(context, 'rodin_import_images', input);
+}
+export async function rodinGenerate(context, input) {
+    return call(context, 'rodin_generate', input);
+}
+export async function rodinGenerateBang(context, input) {
+    return call(context, 'rodin_generate_bang', input);
+}
+export async function rodinGetStatus(context, input) {
+    return call(context, 'rodin_get_status', input);
+}
+export async function rodinWait(context, input) {
+    return call(context, 'rodin_wait', input);
+}
+export async function rodinGetResult(context, input) {
+    return call(context, 'rodin_get_result', input);
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/operations.d.ts

@@ -0,0 +1,12 @@
+import type { ToolContext } from './mcp.js';
+import type { GenerateOptions } from './types.js';
+export declare function poll(generationId: string, timeoutSeconds?: number, context?: ToolContext): Promise<import("./types.js").Payload>;
+export declare function generate(options: GenerateOptions, context?: ToolContext): Promise<import("./types.js").Payload>;
+export declare function status(generationId: string, context?: ToolContext): Promise<import("./types.js").Payload>;
+export declare function result(generationId: string, context?: ToolContext): Promise<import("./types.js").Payload>;
+export interface BangOptions {
+    instruction?: string;
+    strength?: number;
+    format?: string;
+}
+export declare function bang(generationId: string, options?: BangOptions, context?: ToolContext): Promise<import("./types.js").Payload>;

package/dist/operations.js

@@ -0,0 +1,139 @@
+import { randomUUID } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+import { basename, extname } from 'node:path';
+import { rodinCreateUploads, rodinGenerate, rodinGenerateBang, rodinGetStatus, rodinGetResult, rodinWait, validateGenerate, withToolContext, } from './mcp.js';
+import { omitUndefined } from './utils.js';
+const mimeTypes = {
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.webp': 'image/webp',
+    '.tif': 'image/tiff',
+    '.tiff': 'image/tiff',
+    '.gif': 'image/gif',
+    '.avif': 'image/avif',
+    '.heic': 'image/heic',
+    '.heif': 'image/heif',
+    '.bmp': 'image/bmp',
+    '.jp2': 'image/jp2',
+    '.jpx': 'image/jpx',
+    '.jpm': 'image/jpm',
+    '.mj2': 'image/mj2',
+};
+const defaultPollTimeoutSeconds = 30;
+// Leave ample headroom under the MCP client's 60-second per-request timeout.
+const maximumWaitCallSeconds = 30;
+export async function poll(generationId, timeoutSeconds = defaultPollTimeoutSeconds, context) {
+    return withToolContext(async (context) => {
+        if (!Number.isSafeInteger(timeoutSeconds) || timeoutSeconds < 1)
+            throw new Error('Poll timeout must be a positive integer number of seconds');
+        let remainingSeconds = timeoutSeconds;
+        let latest;
+        do {
+            const waitSeconds = Math.min(remainingSeconds, maximumWaitCallSeconds);
+            latest = await rodinWait(context, {
+                generation_id: generationId,
+                timeout_seconds: waitSeconds,
+            });
+            if (latest.timed_out !== true)
+                return latest;
+            remainingSeconds -= waitSeconds;
+        } while (remainingSeconds > 0);
+        return latest;
+    }, context);
+}
+export async function generate(options, context) {
+    return withToolContext(async (context) => {
+        const paths = options.image ?? [];
+        if (paths.length > 5)
+            throw new Error('Provide at most five images');
+        if (!paths.length && !options.prompt?.trim())
+            throw new Error('Provide --prompt or --image');
+        const input = omitUndefined({
+            prompt: options.prompt,
+            tier: options.tier,
+            mesh_mode: options.meshMode,
+            geometry_file_format: options.format,
+            quality_override: options.quality,
+        });
+        const images = await Promise.all(paths.map(async (path) => {
+            const mime = mimeTypes[extname(path).toLowerCase()];
+            if (!mime)
+                throw new Error(`Unsupported image file extension: ${path}`);
+            if (!(await stat(path)).isFile())
+                throw new Error(`Image is not a regular file: ${path}`);
+            const body = await readFile(path);
+            if (!body.length)
+                throw new Error(`Image is empty: ${path}`);
+            return {
+                body,
+                file: {
+                    filename: basename(path),
+                    mime_type: mime,
+                    size_bytes: body.length,
+                },
+            };
+        }));
+        // Validate generation options before creating uploads. IDs are assigned below.
+        validateGenerate(context, {
+            ...input,
+            ...(images.length
+                ? { reference_upload_ids: images.map(() => randomUUID()) }
+                : {}),
+        });
+        if (images.length) {
+            const { uploads } = await rodinCreateUploads(context, {
+                files: images.map((image) => image.file),
+            });
+            if (!Array.isArray(uploads) || uploads.length !== images.length)
+                throw new Error('Server returned an unexpected number of image uploads');
+            // Validate all destinations before sending any image bytes.
+            for (const upload of uploads) {
+                const url = new URL(upload.upload_url);
+                if (url.protocol !== 'https:')
+                    throw new Error('Image upload URL must use HTTPS');
+                if (upload.method !== 'PUT' ||
+                    typeof upload.upload_id !== 'string' ||
+                    !upload.headers ||
+                    typeof upload.headers['Content-Type'] !== 'string')
+                    throw new Error('Server returned an invalid image upload');
+            }
+            validateGenerate(context, {
+                ...input,
+                reference_upload_ids: uploads.map((u) => u.upload_id),
+            });
+            for (const [index, upload] of uploads.entries()) {
+                // Presigned URL authentication only; never forward MCP credentials.
+                const response = await fetch(upload.upload_url, {
+                    method: 'PUT',
+                    headers: upload.headers,
+                    body: images[index].body,
+                    redirect: 'error',
+                    signal: AbortSignal.timeout(60000),
+                });
+                await response.body?.cancel();
+                if (!response.ok)
+                    throw new Error(`Image ${index + 1} upload failed (HTTP ${response.status}); generation was not started`);
+            }
+            input.reference_upload_ids = uploads.map((upload) => upload.upload_id);
+        }
+        return rodinGenerate(context, input);
+    }, context);
+}
+export async function status(generationId, context) {
+    return withToolContext(async (context) => rodinGetStatus(context, { generation_id: generationId }), context);
+}
+export async function result(generationId, context) {
+    return withToolContext(async (context) => rodinGetResult(context, { generation_id: generationId }), context);
+}
+export async function bang(generationId, options = {}, context) {
+    return withToolContext(async (context) => rodinGenerateBang(context, {
+        asset_id: generationId,
+        ...omitUndefined({
+            instruction: options.instruction,
+            strength: options.strength,
+            geometry_file_format: options.format,
+        }),
+    }), context);
+}
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,5 @@
+import type { Payload } from './types.js';
+export declare function formatOutput(value: Payload, { format, kind }?: {
+    format?: string;
+    kind?: string;
+}): string;

package/dist/output.js

@@ -0,0 +1,123 @@
+const initialisms = new Map([
+    ['api', 'API'],
+    ['cli', 'CLI'],
+    ['id', 'ID'],
+    ['mime', 'MIME'],
+    ['url', 'URL'],
+    ['uuid', 'UUID'],
+]);
+function label(key) {
+    const words = key
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .split(/[\s_-]+/)
+        .filter(Boolean)
+        .map((word) => initialisms.get(word.toLowerCase()) ?? word.toLowerCase());
+    if (!words.length)
+        return key;
+    if (!initialisms.has(words[0].toLowerCase()))
+        words[0] = `${words[0][0].toUpperCase()}${words[0].slice(1)}`;
+    return words.join(' ');
+}
+function scalar(value) {
+    if (value === null || value === undefined)
+        return 'None';
+    if (typeof value === 'boolean')
+        return value ? 'Yes' : 'No';
+    return String(value);
+}
+function scalarLine(prefix, value, continuationIndent) {
+    const lines = scalar(value).split('\n');
+    return [
+        `${prefix}${lines[0]}`,
+        ...lines.slice(1).map((line) => `${' '.repeat(continuationIndent)}${line}`),
+    ];
+}
+function renderEntry(key, value, indent) {
+    const padding = ' '.repeat(indent);
+    const prefix = `${padding}${label(key)}:`;
+    if (!value || typeof value !== 'object')
+        return scalarLine(`${prefix} `, value, prefix.length + 1);
+    if (Array.isArray(value))
+        return value.length
+            ? [prefix, ...renderArray(value, indent + 2)]
+            : [`${prefix} None`];
+    const entries = Object.entries(value);
+    return entries.length
+        ? [prefix, ...renderObject(value, indent + 2)]
+        : [`${prefix} None`];
+}
+function renderObject(value, indent = 0) {
+    return Object.entries(value).flatMap(([key, child]) => renderEntry(key, child, indent));
+}
+function renderArray(value, indent = 0) {
+    const padding = ' '.repeat(indent);
+    return value.flatMap((item) => {
+        if (!item || typeof item !== 'object')
+            return scalarLine(`${padding}- `, item, indent + 2);
+        if (Array.isArray(item))
+            return [`${padding}-`, ...renderArray(item, indent + 2)];
+        const entries = Object.entries(item);
+        if (!entries.length)
+            return [`${padding}- None`];
+        const [[firstKey, firstValue], ...rest] = entries;
+        if (!firstValue || typeof firstValue !== 'object') {
+            const firstPrefix = `${padding}- ${label(firstKey)}: `;
+            return [
+                ...scalarLine(firstPrefix, firstValue, firstPrefix.length),
+                ...rest.flatMap(([key, child]) => renderEntry(key, child, indent + 2)),
+            ];
+        }
+        return [
+            `${padding}- ${label(firstKey)}:`,
+            ...(Array.isArray(firstValue)
+                ? renderArray(firstValue, indent + 4)
+                : renderObject(firstValue, indent + 4)),
+            ...rest.flatMap(([key, child]) => renderEntry(key, child, indent + 2)),
+        ];
+    });
+}
+function formatAccount(value) {
+    if (!value.authenticated)
+        return 'Not authenticated. Run hyper3d auth login.';
+    const workspace = value.wallet.type === 'group'
+        ? `${value.wallet.name || 'Team'} (${value.wallet.group_uuid})`
+        : 'Personal';
+    const lines = [
+        `Authenticated as ${value.user.username}`,
+        `User ID: ${value.user.uuid}`,
+        `Workspace: ${workspace}`,
+        'Credits:',
+        `  Regular: ${scalar(value.wallet.balance)}`,
+    ];
+    if (value.wallet.type === 'personal')
+        lines.push(`  Subscription: ${scalar(value.wallet.subscription_balance)}`);
+    lines.push(`  Frozen: ${scalar(value.wallet.frozen)}`);
+    return lines.join('\n');
+}
+function formatHuman(value, kind) {
+    if (kind === 'auth-login')
+        return 'Authenticated successfully.';
+    if (kind === 'auth-logout')
+        return 'Local credentials removed.';
+    if (kind === 'account')
+        return formatAccount(value);
+    if (!value || typeof value !== 'object')
+        return scalar(value);
+    if (Array.isArray(value))
+        return renderArray(value).join('\n');
+    const displayed = value.stage && typeof value.stage === 'object'
+        ? {
+            ...value,
+            stage: `${value.stage.name} (${value.stage.current}/${value.stage.total})`,
+        }
+        : value;
+    return renderObject(displayed).join('\n');
+}
+export function formatOutput(value, { format = 'human', kind } = {}) {
+    if (format === 'json')
+        return JSON.stringify(value, null, 2);
+    if (format === 'human')
+        return formatHuman(value, kind);
+    throw new Error(`Unsupported output format: ${format}`);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,10 @@
+import type { Payload } from './types.js';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const baseSchema: {
+    tools: Tool[];
+};
+export declare function validateInput(schema: Payload, value: unknown): void;
+export declare function prepareCall(name: string, input: Payload, remote: Tool | undefined, warn?: (message: string) => void): {
+    name: string;
+    arguments: Payload;
+};