@nimrobo/mcporter-remote 0.1.0

package/dist/cli/generate/template.js

@@ -0,0 +1,366 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { MCPORTER_VERSION } from '../../runtime.js';
+import { buildToolDoc } from '../list-detail-helpers.js';
+import { markExecutable } from './fs-helpers.js';
+import { renderEmbeddedHelpSource } from './template-help.js';
+import { buildEmbeddedSchemaMap } from './tools.js';
+export async function writeTemplate(input) {
+    const resolvedOutput = input.outputPath
+        ? path.resolve(input.outputPath)
+        : path.resolve(process.cwd(), `${input.serverName}.ts`);
+    await fs.mkdir(path.dirname(resolvedOutput), { recursive: true });
+    await fs.writeFile(resolvedOutput, renderTemplate(input), 'utf8');
+    await markExecutable(resolvedOutput);
+    return resolvedOutput;
+}
+export async function readPackageMetadata() {
+    const packageJsonPath = path.resolve(process.cwd(), 'package.json');
+    try {
+        const buffer = await fs.readFile(packageJsonPath, 'utf8');
+        const pkg = JSON.parse(buffer);
+        return {
+            name: pkg.name ?? 'mcporter',
+            version: pkg.version ?? '0.0.0',
+        };
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+        return { name: 'mcporter', version: MCPORTER_VERSION };
+    }
+}
+export function renderTemplate({ runtimeKind, timeoutMs, definition, serverName, tools, generator, metadata, }) {
+    const imports = [
+        "import { Command } from 'commander';",
+        "import { createRuntime, createServerProxy } from '@nimrobo/mcporter-remote';",
+        "import { createCallResult } from '@nimrobo/mcporter-remote';",
+    ].join('\n');
+    const embedded = JSON.stringify(definition, (_key, value) => (value instanceof URL ? value.toString() : value), 2);
+    const generatorHeader = `Generated by ${generator.name}@${generator.version} — https://github.com/steipete/mcporter`;
+    const toolDocs = tools.map((tool) => ({
+        tool,
+        doc: buildToolDoc({
+            serverName,
+            toolName: tool.tool.name,
+            description: tool.tool.description,
+            outputSchema: tool.tool.outputSchema,
+            options: tool.options,
+            requiredOnly: true,
+            colorize: false,
+            flagExtras: [{ text: '--raw <json>' }],
+        }),
+    }));
+    const renderedTools = toolDocs.map((entry) => ({
+        ...renderToolCommand(entry.tool, timeoutMs, serverName, entry.doc),
+        doc: entry.doc,
+        tool: entry.tool,
+    }));
+    const toolHelp = renderedTools.map((entry) => ({
+        name: entry.commandName,
+        description: entry.tool.tool.description ?? '',
+        usage: entry.doc.flagUsage ? `${entry.commandName} ${entry.doc.flagUsage}` : undefined,
+        flags: entry.doc.flagUsage ?? '',
+    }));
+    const generatorHeaderLiteral = JSON.stringify(generatorHeader);
+    const toolHelpLiteral = JSON.stringify(toolHelp, undefined, 2);
+    const embeddedSchemas = JSON.stringify(buildEmbeddedSchemaMap(tools), undefined, 2);
+    const embeddedMetadata = JSON.stringify(metadata, undefined, 2);
+    const toolBlocks = renderedTools.map((entry) => entry.block).join('\n\n');
+    const signatureMap = Object.fromEntries(renderedTools.map((entry) => [entry.commandName, entry.tsSignature]));
+    const signatureMapLiteral = JSON.stringify(signatureMap, undefined, 2);
+    const generatedHeaderComment = `// @generated by ${generator.name}@${generator.version} on ${metadata.generatedAt}. DO NOT EDIT.`;
+    return `#!/usr/bin/env ${runtimeKind === 'bun' ? 'bun' : 'node'}
+${generatedHeaderComment}
+${imports}
+
+const embeddedServer = ${embedded} as const;
+const embeddedSchemas = ${embeddedSchemas} as const;
+const embeddedName = ${JSON.stringify(serverName)};
+const embeddedDescription = ${JSON.stringify(definition.description ?? `Standalone CLI for the ${serverName} MCP server.`)};
+const generatorInfo = ${generatorHeaderLiteral};
+const generatorTools = ${toolHelpLiteral} as const;
+const embeddedMetadata = ${embeddedMetadata} as const;
+const artifactKind = determineArtifactKind();
+const program = new Command();
+program.name(embeddedName);
+program.description(embeddedDescription);
+program.option('-t, --timeout <ms>', 'Call timeout in milliseconds', (value) => parseInt(value, 10), ${timeoutMs});
+program.option('-o, --output <format>', 'Output format: text|markdown|json|raw', 'text');
+const commandSignatures: Record<string, string> = ${signatureMapLiteral};
+program.configureHelp({
+\tcommandTerm(cmd) {
+\t\tconst term = cmd.name();
+\t\treturn commandSignatures[term] ?? cmd.name();
+\t},
+});
+program.showSuggestionAfterError(true);
+
+${toolBlocks}
+
+program
+\t.command('__mcporter_inspect', { hidden: true })
+\t.description('Internal metadata printer for mcporter inspect-cli.')
+\t.action(() => {
+\t\tconst payload = buildMetadataPayload();
+\t\tconsole.log(JSON.stringify(payload, null, 2));
+\t});
+
+configureToolCommandHelps();
+
+const FORCE_COLOR = process.env.FORCE_COLOR?.toLowerCase();
+const forceDisableColor = FORCE_COLOR === '0' || FORCE_COLOR === 'false';
+const forceEnableColor = FORCE_COLOR === '1' || FORCE_COLOR === 'true' || FORCE_COLOR === '2' || FORCE_COLOR === '3';
+const hasNoColor = process.env.NO_COLOR !== undefined;
+const stdoutStream = process.stdout as NodeJS.WriteStream | undefined;
+const supportsAnsiColor = !hasNoColor && (forceEnableColor || (!forceDisableColor && Boolean(stdoutStream?.isTTY)));
+
+const tint = {
+	bold(text: string): string {
+		return supportsAnsiColor ? '\u001B[1m' + text + '\u001B[0m' : text;
+	},
+	dim(text: string): string {
+		return supportsAnsiColor ? '\u001B[90m' + text + '\u001B[0m' : text;
+	},
+	extraDim(text: string): string {
+		return supportsAnsiColor ? '\u001B[38;5;244m' + text + '\u001B[0m' : text;
+	},
+};
+
+${renderEmbeddedHelpSource()}
+
+function printResult(result: unknown, format: string) {
+\tconst wrapped = createCallResult(result);
+\tswitch (format) {
+\t\tcase 'json': {
+\t\t\tconst json = wrapped.json();
+\t\t\tif (json) {
+\t\t\t\tconsole.log(JSON.stringify(json, null, 2));
+\t\t\t\treturn;
+\t\t\t}
+\t\t\tbreak;
+\t\t}
+\t\tcase 'markdown': {
+\t\t\tconst markdown = wrapped.markdown();
+\t\t\tif (markdown) {
+\t\t\t\tconsole.log(markdown);
+\t\t\t\treturn;
+\t\t\t}
+\t\t\tbreak;
+\t\t}
+\t\tcase 'raw': {
+\t\t\tconsole.log(JSON.stringify(wrapped.raw, null, 2));
+\t\t\treturn;
+\t\t}
+\t}
+\tconst text = wrapped.text();
+\tif (text) {
+\t\tconsole.log(text);
+\t} else {
+\t\tconsole.log(JSON.stringify(wrapped.raw, null, 2));
+\t}
+}
+
+function normalizeEmbeddedServer(server: typeof embeddedServer) {
+\tconst base = { ...server } as Record<string, unknown>;
+\tif ((server.command as any).kind === 'http') {
+\t\tconst urlRaw = (server.command as any).url;
+\t\tconst urlValue = typeof urlRaw === 'string' ? urlRaw : String(urlRaw);
+\t\treturn {
+\t\t\t...base,
+\t\t\tcommand: {
+\t\t\t\t...(server.command as Record<string, unknown>),
+\t\t\t\turl: new URL(urlValue),
+\t\t\t},
+\t\t};
+\t}
+\tif ((server.command as any).kind === 'stdio') {
+\t\treturn {
+\t\t\t...base,
+\t\t\tcommand: {
+\t\t\t\t...(server.command as Record<string, unknown>),
+\t\t\t\targs: [ ...((server.command as any).args ?? []) ],
+\t\t\t},
+\t\t};
+\t}
+\treturn base;
+}
+
+function determineArtifactKind(): 'template' | 'bundle' | 'binary' {
+\tconst scriptPath = typeof process !== 'undefined' && Array.isArray(process.argv) ? process.argv[1] ?? '' : '';
+\tif (scriptPath.endsWith('.ts')) {
+\t\treturn 'template';
+\t}
+\tif (scriptPath.endsWith('.js')) {
+\t\treturn 'bundle';
+\t}
+\treturn 'binary';
+}
+
+function resolveArtifactPath(): string {
+\tif (typeof process !== 'undefined' && Array.isArray(process.argv) && process.argv.length > 1) {
+\t\tconst script = process.argv[1];
+\t\tif (script) {
+\t\t\treturn script;
+\t\t}
+\t}
+\treturn embeddedMetadata.artifact.path;
+}
+
+function buildMetadataPayload() {
+\tconst invocation = { ...embeddedMetadata.invocation };
+\tconst path = resolveArtifactPath();
+\tif (artifactKind === 'template' && path) {
+\t\tinvocation.outputPath = invocation.outputPath ?? path;
+\t} else if (artifactKind === 'bundle' && path) {
+\t\tinvocation.bundle = invocation.bundle ?? path;
+\t} else if (artifactKind === 'binary' && path) {
+\t\tinvocation.compile = invocation.compile ?? path;
+\t}
+\treturn {
+\t\t...embeddedMetadata,
+\t\tartifact: {
+\t\t\tpath,
+\t\t\tkind: artifactKind,
+\t\t},
+\t\tinvocation,
+\t};
+}
+
+async function ensureRuntime(): Promise<Awaited<ReturnType<typeof createRuntime>>> {
+	return await createRuntime({
+		servers: [normalizeEmbeddedServer(embeddedServer)],
+	});
+}
+
+async function invokeWithTimeout<T>(call: Promise<T>, timeout: number): Promise<T> {
+\tif (!Number.isFinite(timeout) || timeout <= 0) {
+\t\treturn await call;
+\t}
+\tlet timer: ReturnType<typeof setTimeout> | undefined;
+\ttry {
+\t\treturn await Promise.race([
+\t\t\tcall,
+\t\t\tnew Promise<never>((_, reject) => {
+\t\t\t\ttimer = setTimeout(() => {
+\t\t\t\t\treject(new Error('Call timed out after ' + timeout + 'ms.'));
+\t\t\t\t}, timeout);
+\t\t\t}),
+\t\t]);
+\t} finally {
+\t\tif (timer) {
+\t\t\tclearTimeout(timer);
+\t\t}
+\t}
+}
+
+async function runCli(): Promise<void> {
+\tconst args = process.argv.slice(2);
+\tif (args.length === 0) {
+\t\tprogram.outputHelp();
+\t\treturn;
+\t}
+\tawait program.parseAsync(process.argv);
+}
+
+if (process.env.MCPORTER_DISABLE_AUTORUN !== '1') {
+\trunCli().catch((error) => {
+\t\tconst message = error instanceof Error ? error.message : String(error);
+\t\tconsole.error(message);
+\t\tprocess.exit(1);
+\t});
+}
+`;
+}
+export function renderToolCommand(tool, defaultTimeout, serverName, existingDoc) {
+    const commandName = tool.tool.name.replace(/[^a-zA-Z0-9-]/g, '-');
+    const description = tool.tool.description ?? `Invoke the ${tool.tool.name} tool.`;
+    const doc = existingDoc ??
+        buildToolDoc({
+            serverName,
+            toolName: tool.tool.name,
+            description: tool.tool.description,
+            outputSchema: tool.tool.outputSchema,
+            options: tool.options,
+            requiredOnly: true,
+            colorize: false,
+            flagExtras: [{ text: '--raw <json>' }],
+        });
+    const buildArgs = tool.options
+        .map((option) => {
+        // Commander.js camelcases flag names (e.g. --relative-path => relativePath).
+        const camelCaseProp = option.cliName
+            .split('-')
+            .filter(Boolean)
+            .map((segment, index) => (index === 0 ? segment : `${segment.charAt(0).toUpperCase()}${segment.slice(1)}`))
+            .join('');
+        const source = `cmdOpts.${camelCaseProp}`;
+        return `if (${source} !== undefined) args.${option.property} = ${source};`;
+    })
+        .join('\n\t\t');
+    const flagUsage = doc.flagUsage;
+    const optionLines = doc.optionDocs.map((entry) => renderOption(entry)).join('\n');
+    const summary = flagUsage ? `${commandName} ${flagUsage}` : commandName;
+    const signature = summary;
+    const usageSnippet = flagUsage ? `.usage(${JSON.stringify(flagUsage)})\n` : '';
+    const tsSignature = doc.tsSignature;
+    const exampleText = doc.examples[0];
+    const exampleSnippet = exampleText
+        ? `\n\t.addHelpText('after', () => '\\nExample:\\n  ' + ${JSON.stringify(exampleText)})`
+        : '';
+    const optionalSnippet = doc.optionalSummary
+        ? `\n\t.addHelpText('afterAll', () => '\\n' + ${JSON.stringify(doc.optionalSummary)} + '\\n')`
+        : '';
+    const aliasSnippet = tool.tool.name !== commandName ? `\n\t.alias(${JSON.stringify(tool.tool.name)})` : '';
+    const block = `program
+\t.command(${JSON.stringify(commandName)})
+\t.summary(${JSON.stringify(summary)})
+\t.description(${JSON.stringify(description)})
+${usageSnippet ? `\t${usageSnippet}` : ''}\t.option('--raw <json>', 'Provide raw JSON arguments to the tool, bypassing flag parsing.')
+${optionLines ? `\n${optionLines}` : ''}
+${aliasSnippet ? `\t${aliasSnippet}` : ''}\t.action(async (cmdOpts) => {
+\t\tconst globalOptions = program.opts();
+\t\tconst runtime = await ensureRuntime();
+\t\tconst serverName = embeddedName;
+\t\tconst proxy = createServerProxy(runtime, serverName, {
+\t\t\tinitialSchemas: embeddedSchemas,
+\t\t});
+\t\ttry {
+\t\t\tconst args = cmdOpts.raw ? JSON.parse(cmdOpts.raw) : ({} as Record<string, unknown>);
+\t\t\t${buildArgs}
+\t\t\tconst call = (proxy.${tool.methodName} as any)(args);
+\t\t\tconst result = await invokeWithTimeout(call, globalOptions.timeout || ${defaultTimeout});
+\t\t\tprintResult(result, globalOptions.output ?? 'text');
+\t\t} finally {
+\t\t\tawait runtime.close(serverName).catch(() => {});
+\t\t}
+\t})${exampleSnippet}${optionalSnippet};`;
+    return { block, commandName, signature, tsSignature };
+}
+function renderOption(optionDoc) {
+    const parser = optionParser(optionDoc.option);
+    const method = optionDoc.option.required ? '.requiredOption' : '.option';
+    return `\t${method}(${JSON.stringify(optionDoc.flagLabel)}, ${JSON.stringify(optionDoc.description)}${parser ? `, ${parser}` : ''})`;
+}
+function optionParser(option) {
+    switch (option.type) {
+        case 'number':
+            return '(value) => parseFloat(value)';
+        case 'boolean':
+            return "(value) => value !== 'false'";
+        case 'array':
+            // Coerce array elements to their proper types based on schema
+            switch (option.arrayItemType) {
+                case 'number':
+                    return "(value) => value.split(',').map((v) => parseFloat(v.trim()))";
+                case 'boolean':
+                    return "(value) => value.split(',').map((v) => v.trim() !== 'false')";
+                default:
+                    return "(value) => value.split(',').map((v) => v.trim())";
+            }
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=template.js.map

package/dist/cli/generate/template.js.map

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

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

@@ -0,0 +1,46 @@
+import type { ServerToolInfo } from '../../runtime.js';
+export interface ToolMetadata {
+    tool: ServerToolInfo;
+    methodName: string;
+    options: GeneratedOption[];
+}
+export interface GeneratedOption {
+    property: string;
+    cliName: string;
+    description?: string;
+    required: boolean;
+    type: 'string' | 'number' | 'boolean' | 'array' | 'unknown';
+    arrayItemType?: 'string' | 'number' | 'boolean' | 'unknown';
+    placeholder: string;
+    exampleValue?: string;
+    enumValues?: string[];
+    defaultValue?: unknown;
+    formatHint?: string;
+}
+export declare function buildToolMetadata(tool: ServerToolInfo): ToolMetadata;
+export declare function buildEmbeddedSchemaMap(tools: ToolMetadata[]): Record<string, unknown>;
+export declare function extractOptions(tool: ServerToolInfo): GeneratedOption[];
+export declare function getEnumValues(descriptor: unknown): string[] | undefined;
+export declare function getDescriptorDefault(descriptor: unknown): unknown;
+export declare function buildPlaceholder(property: string, type: GeneratedOption['type'], enumValues?: string[], formatSlug?: string): string;
+export declare function buildExampleValue(property: string, type: GeneratedOption['type'], enumValues: string[] | undefined, defaultValue: unknown): string | undefined;
+export declare function pickExampleLiteral(option: GeneratedOption): string | undefined;
+export declare function buildFallbackLiteral(option: GeneratedOption): string;
+export declare function inferType(descriptor: unknown): GeneratedOption['type'];
+export declare function inferArrayItemType(descriptor: unknown): GeneratedOption['arrayItemType'];
+export declare function getDescriptorDescription(descriptor: unknown): string | undefined;
+export declare function getDescriptorFormatHint(descriptor: unknown): {
+    display: string;
+    slug: string;
+} | undefined;
+export declare function toProxyMethodName(toolName: string): string;
+export declare function toCliOption(property: string): string;
+export declare const toolsTestHelpers: {
+    getEnumValues: typeof getEnumValues;
+    getDescriptorDefault: typeof getDescriptorDefault;
+    buildPlaceholder: typeof buildPlaceholder;
+    buildExampleValue: typeof buildExampleValue;
+    pickExampleLiteral: typeof pickExampleLiteral;
+    buildFallbackLiteral: typeof buildFallbackLiteral;
+};
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/cli/generate/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5D,aAAa,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,CAQpE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQrF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,eAAe,EAAE,CAkCtE;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAiBvE;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAYjE;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAkBR;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAC7B,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,EAChC,YAAY,EAAE,OAAO,GACpB,MAAM,GAAG,SAAS,CA2BpB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CA6B9E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAkBpE;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CA4BtE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,GAAG,eAAe,CAAC,eAAe,CAAC,CAiCxF;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMhF;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAwC1G;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,eAAO,MAAM,gBAAgB;;;;;;;CAO5B,CAAC"}