@nimrobo/mcporter-remote 0.1.0

package/dist/cli/list-signature.js

@@ -0,0 +1,176 @@
+import { buildFallbackLiteral, pickExampleLiteral } from './generate/tools.js';
+import { cyanText, dimText, extraDimText } from './terminal.js';
+export function formatFunctionSignature(name, options, outputSchema, formatOptions) {
+    const colorize = formatOptions?.colorize !== false;
+    const keyword = colorize ? extraDimText('function') : 'function';
+    const formattedName = colorize ? cyanText(name) : name;
+    const paramsText = options.map((option) => formatInlineParameter(option, colorize)).join(', ');
+    const returnType = inferReturnTypeName(outputSchema) ?? formatOptions?.defaultReturnType;
+    const signature = `${keyword} ${formattedName}(${paramsText})`;
+    return returnType ? `${signature}: ${returnType};` : `${signature};`;
+}
+export function formatOptionalSummary(hiddenOptions, options) {
+    const colorize = options?.colorize !== false;
+    const maxNames = 5;
+    const names = hiddenOptions.map((option) => option.property);
+    if (names.length === 0) {
+        return '';
+    }
+    const preview = names.slice(0, maxNames).join(', ');
+    const suffix = names.length > maxNames ? ', ...' : '';
+    const tint = colorize ? extraDimText : (value) => value;
+    return tint(`// optional (${names.length}): ${preview}${suffix}`);
+}
+export function formatFlagUsage(options, extras, opts) {
+    const colorize = opts?.colorize !== false;
+    const entries = options.map((option) => ({
+        text: formatFlagLabel(option),
+        required: option.required,
+    }));
+    if (extras) {
+        entries.push(...extras
+            .map((extra) => ({
+            text: extra.text.trim(),
+            required: Boolean(extra.required),
+        }))
+            .filter((entry) => entry.text.length > 0));
+    }
+    const parts = entries
+        .filter((entry) => entry.text.length > 0)
+        .map((entry) => (entry.required ? entry.text : `[${entry.text}]`));
+    if (parts.length === 0) {
+        return '';
+    }
+    const rendered = parts.join(' ');
+    return colorize ? extraDimText(rendered) : rendered;
+}
+export function formatFlagLabel(option) {
+    return `--${option.cliName} ${option.placeholder}`.trim();
+}
+export function formatCallExpressionExample(serverName, toolName, options, extra) {
+    const assignments = options
+        .map((option) => ({ option, literal: pickExampleLiteral(option) }))
+        .filter(({ option, literal }) => option.required || literal !== undefined)
+        .map(({ option, literal }) => {
+        const value = literal ?? buildFallbackLiteral(option);
+        return `${option.property}: ${value}`;
+    });
+    const args = assignments.join(', ');
+    const callSuffix = assignments.length > 0 ? `(${args})` : '()';
+    const selector = extra?.callSelector ?? serverName;
+    const expression = `${selector}.${toolName}${callSuffix}`;
+    const rendered = extra?.wrapExpression ? quoteShellExpression(expression) : expression;
+    return `mcporter call ${rendered}`;
+}
+export function formatExampleBlock(examples, options) {
+    const maxExamples = options?.maxExamples ?? 1;
+    const maxLength = options?.maxLength ?? 80;
+    return Array.from(new Set(examples))
+        .filter(Boolean)
+        .slice(0, maxExamples)
+        .map((example) => truncateExample(example, maxLength));
+}
+function truncateExample(example, maxLength) {
+    if (example.length <= maxLength) {
+        return example;
+    }
+    const openIndex = example.indexOf('(');
+    const closeIndex = example.lastIndexOf(')');
+    if (openIndex === -1 || closeIndex === -1 || closeIndex <= openIndex) {
+        return `${example.slice(0, Math.max(0, maxLength - 1))}…`;
+    }
+    const prefix = example.slice(0, openIndex + 1);
+    const suffix = example.slice(closeIndex);
+    const available = maxLength - prefix.length - suffix.length - 5;
+    if (available <= 0) {
+        return `${prefix}...${suffix}`;
+    }
+    const args = example.slice(openIndex + 1, closeIndex).trim();
+    const shortened = args
+        .slice(0, available)
+        .trimEnd()
+        .replace(/[\s,]+$/, '');
+    const ellipsis = shortened.length > 0 ? `${shortened}, ...` : '...';
+    return `${prefix}${ellipsis}${suffix}`;
+}
+function formatInlineParameter(option, colorize) {
+    const typeAnnotation = formatTypeAnnotation(option, colorize);
+    const optionalSuffix = option.required ? '' : '?';
+    return `${option.property}${optionalSuffix}: ${typeAnnotation}`;
+}
+function quoteShellExpression(expression) {
+    if (!expression.includes("'")) {
+        return `'${expression}'`;
+    }
+    const escaped = expression.replace(/(["\\$`])/g, '\\$1');
+    return `"${escaped}"`;
+}
+function inferReturnTypeName(schema) {
+    if (!schema || typeof schema !== 'object') {
+        return undefined;
+    }
+    return inferSchemaDisplayType(schema);
+}
+function inferSchemaDisplayType(descriptor) {
+    const title = typeof descriptor.title === 'string' ? descriptor.title.trim() : undefined;
+    if (title) {
+        return title;
+    }
+    const type = typeof descriptor.type === 'string' ? descriptor.type : undefined;
+    if (!type && typeof descriptor.properties === 'object') {
+        return 'object';
+    }
+    if (!type && descriptor.items && typeof descriptor.items === 'object') {
+        return `${inferSchemaDisplayType(descriptor.items)}[]`;
+    }
+    if (type === 'array' && descriptor.items && typeof descriptor.items === 'object') {
+        return `${inferSchemaDisplayType(descriptor.items)}[]`;
+    }
+    if (!type && Array.isArray(descriptor.enum)) {
+        const values = descriptor.enum.filter((entry) => typeof entry === 'string');
+        if (values.length > 0) {
+            return values.map((entry) => JSON.stringify(entry)).join(' | ');
+        }
+    }
+    return type ?? 'unknown';
+}
+function formatTypeAnnotation(option, colorize) {
+    let baseType;
+    if (option.enumValues && option.enumValues.length > 0) {
+        baseType = option.enumValues.map((value) => JSON.stringify(value)).join(' | ');
+    }
+    else {
+        switch (option.type) {
+            case 'number':
+                baseType = 'number';
+                break;
+            case 'boolean':
+                baseType = 'boolean';
+                break;
+            case 'array':
+                baseType = 'string[]';
+                break;
+            case 'string':
+                baseType = 'string';
+                break;
+            default:
+                baseType = 'unknown';
+                break;
+        }
+    }
+    const tint = colorize ? dimText : (value) => value;
+    const base = tint(baseType);
+    if (option.formatHint && option.type === 'string' && (!option.enumValues || option.enumValues.length === 0)) {
+        const descriptionText = option.description?.toLowerCase() ?? '';
+        const hintLower = option.formatHint.toLowerCase();
+        const normalizedDescription = descriptionText.replace(/[\s_-]+/g, '');
+        const normalizedHint = hintLower.replace(/[\s_-]+/g, '');
+        const hasHintInDescription = descriptionText.includes(hintLower) || normalizedDescription.includes(normalizedHint);
+        if (hasHintInDescription) {
+            return base;
+        }
+        return `${base} ${tint(`/* ${option.formatHint} */`)}`;
+    }
+    return base;
+}
+//# sourceMappingURL=list-signature.js.map

package/dist/cli/list-signature.js.map

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

package/dist/cli/logger-context.d.ts

@@ -0,0 +1,9 @@
+import { type Logger, type LogLevel } from '../logging.js';
+export declare function getActiveLogLevel(): LogLevel;
+export declare function getActiveLogger(): Logger;
+export declare function setLogLevel(level: LogLevel): void;
+export declare function setLogger(logger: Logger, level?: LogLevel): void;
+export declare function logInfo(message: string): void;
+export declare function logWarn(message: string): void;
+export declare function logError(message: string, error?: unknown): void;
+//# sourceMappingURL=logger-context.d.ts.map

package/dist/cli/logger-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-context.d.ts","sourceRoot":"","sources":["../../src/cli/logger-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,MAAM,EAAE,KAAK,QAAQ,EAA0B,MAAM,eAAe,CAAC;AAKhH,wBAAgB,iBAAiB,IAAI,QAAQ,CAE5C;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAGjD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,CAKhE;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAE/D"}

package/dist/cli/logger-context.js

@@ -0,0 +1,29 @@
+import { createPrefixedConsoleLogger, resolveLogLevelFromEnv } from '../logging.js';
+let activeLogLevel = resolveLogLevelFromEnv();
+let activeLogger = createPrefixedConsoleLogger('mcporter', activeLogLevel);
+export function getActiveLogLevel() {
+    return activeLogLevel;
+}
+export function getActiveLogger() {
+    return activeLogger;
+}
+export function setLogLevel(level) {
+    activeLogLevel = level;
+    activeLogger = createPrefixedConsoleLogger('mcporter', activeLogLevel);
+}
+export function setLogger(logger, level) {
+    activeLogger = logger;
+    if (level) {
+        activeLogLevel = level;
+    }
+}
+export function logInfo(message) {
+    activeLogger.info(message);
+}
+export function logWarn(message) {
+    activeLogger.warn(message);
+}
+export function logError(message, error) {
+    activeLogger.error(message, error);
+}
+//# sourceMappingURL=logger-context.js.map

package/dist/cli/logger-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-context.js","sourceRoot":"","sources":["../../src/cli/logger-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAA8B,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEhH,IAAI,cAAc,GAAa,sBAAsB,EAAE,CAAC;AACxD,IAAI,YAAY,GAAW,2BAA2B,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAEnF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,cAAc,GAAG,KAAK,CAAC;IACvB,YAAY,GAAG,2BAA2B,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,KAAgB;IACxD,YAAY,GAAG,MAAM,CAAC;IACtB,IAAI,KAAK,EAAE,CAAC;QACV,cAAc,GAAG,KAAK,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,KAAe;IACvD,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC"}

package/dist/cli/output-format.d.ts

@@ -0,0 +1,11 @@
+import type { OutputFormat } from './output-utils.js';
+interface ConsumeOutputOptions {
+    defaultFormat?: OutputFormat;
+    allowed?: OutputFormat[];
+    enableRawShortcut?: boolean;
+    jsonShortcutFlag?: string;
+}
+export declare function consumeOutputFormat(args: string[], options?: ConsumeOutputOptions): OutputFormat;
+export declare function isCliOutputFormat(value: string): value is OutputFormat;
+export {};
+//# sourceMappingURL=output-format.d.ts.map

package/dist/cli/output-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.d.ts","sourceRoot":"","sources":["../../src/cli/output-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,UAAU,oBAAoB;IAC5B,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,YAAY,CAiDpG;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEtE"}

package/dist/cli/output-format.js

@@ -0,0 +1,51 @@
+export function consumeOutputFormat(args, options = {}) {
+    const allowed = options.allowed ?? ['auto', 'text', 'markdown', 'json', 'raw'];
+    const defaultFormat = options.defaultFormat ?? 'auto';
+    const enableRawShortcut = options.enableRawShortcut !== false;
+    let format = defaultFormat;
+    const isAllowed = (value) => allowed.includes(value);
+    let index = 0;
+    while (index < args.length) {
+        const token = args[index];
+        if (token === '--output') {
+            const value = args[index + 1];
+            if (!value) {
+                throw new Error("Flag '--output' requires a value.");
+            }
+            if (!isCliOutputFormat(value)) {
+                throw new Error('--output format must be one of: auto, text, markdown, json, raw.');
+            }
+            if (!isAllowed(value)) {
+                throw new Error(`--output format '${value}' is not supported for this command.`);
+            }
+            format = value;
+            args.splice(index, 2);
+            continue;
+        }
+        if (enableRawShortcut && token === '--raw') {
+            if (!isAllowed('raw')) {
+                throw new Error('--raw is not supported for this command.');
+            }
+            format = 'raw';
+            args.splice(index, 1);
+            continue;
+        }
+        if (options.jsonShortcutFlag && token === options.jsonShortcutFlag) {
+            if (!isAllowed('json')) {
+                throw new Error(`${options.jsonShortcutFlag} is not supported for this command.`);
+            }
+            format = 'json';
+            args.splice(index, 1);
+            continue;
+        }
+        index += 1;
+    }
+    if (!isAllowed(format)) {
+        throw new Error(`Format '${format}' is not supported for this command.`);
+    }
+    return format;
+}
+export function isCliOutputFormat(value) {
+    return value === 'auto' || value === 'text' || value === 'markdown' || value === 'json' || value === 'raw';
+}
+//# sourceMappingURL=output-format.js.map

package/dist/cli/output-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.js","sourceRoot":"","sources":["../../src/cli/output-format.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,mBAAmB,CAAC,IAAc,EAAE,UAAgC,EAAE;IACpF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,MAAM,CAAC;IACtD,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,KAAK,KAAK,CAAC;IAC9D,IAAI,MAAM,GAAiB,aAAa,CAAC;IAEzC,MAAM,SAAS,GAAG,CAAC,KAAmB,EAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE5E,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;YACtF,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,sCAAsC,CAAC,CAAC;YACnF,CAAC;YACD,MAAM,GAAG,KAAK,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,iBAAiB,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YAC3C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC9D,CAAC;YACD,MAAM,GAAG,KAAK,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,gBAAgB,IAAI,KAAK,KAAK,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACnE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,gBAAgB,qCAAqC,CAAC,CAAC;YACpF,CAAC;YACD,MAAM,GAAG,MAAM,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,sCAAsC,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,CAAC;AAC7G,CAAC"}

package/dist/cli/output-utils.d.ts

@@ -0,0 +1,5 @@
+import type { CallResult } from '../result-utils.js';
+export type OutputFormat = 'auto' | 'text' | 'markdown' | 'json' | 'raw';
+export declare function printCallOutput<T>(wrapped: CallResult<T>, raw: T, format: OutputFormat): void;
+export declare function tailLogIfRequested(result: unknown, enabled: boolean): void;
+//# sourceMappingURL=output-utils.d.ts.map

package/dist/cli/output-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-utils.d.ts","sourceRoot":"","sources":["../../src/cli/output-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAkBzE,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAI7F;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA0C1E"}

package/dist/cli/output-utils.js

@@ -0,0 +1,143 @@
+import fs from 'node:fs';
+import { inspect } from 'node:util';
+import { logWarn } from './logger-context.js';
+const RAW_INSPECT_DEPTH = 8;
+const PREFERRED_OUTPUT_BY_FORMAT = {
+    auto: ['json', 'markdown', 'text', 'raw'],
+    text: ['text', 'markdown', 'json', 'raw'],
+    markdown: ['markdown', 'text', 'json', 'raw'],
+    json: ['json', 'raw'],
+    raw: ['raw'],
+};
+export function printCallOutput(wrapped, raw, format) {
+    const preferredKinds = PREFERRED_OUTPUT_BY_FORMAT[format];
+    const renderable = resolveRenderableOutput(wrapped, raw, preferredKinds);
+    emitRenderableOutput(renderable);
+}
+export function tailLogIfRequested(result, enabled) {
+    // Some transports still encode log paths inside tool results; tail when explicitly asked.
+    if (!enabled) {
+        return;
+    }
+    const candidates = [];
+    if (typeof result === 'string') {
+        const idx = result.indexOf(':');
+        if (idx !== -1) {
+            const candidate = result.slice(idx + 1).trim();
+            if (candidate) {
+                candidates.push(candidate);
+            }
+        }
+    }
+    if (result && typeof result === 'object') {
+        const possibleKeys = ['logPath', 'logFile', 'logfile', 'path'];
+        for (const key of possibleKeys) {
+            const value = result[key];
+            if (typeof value === 'string') {
+                candidates.push(value);
+            }
+        }
+    }
+    for (const candidate of candidates) {
+        if (!fs.existsSync(candidate)) {
+            logWarn(`Log path not found: ${candidate}`);
+            continue;
+        }
+        try {
+            const content = fs.readFileSync(candidate, 'utf8');
+            const lines = content.trimEnd().split(/\r?\n/);
+            const tail = lines.slice(-20);
+            console.log(`--- tail ${candidate} ---`);
+            for (const line of tail) {
+                console.log(line);
+            }
+        }
+        catch (error) {
+            logWarn(`Failed to read log file ${candidate}: ${error.message}`);
+        }
+    }
+}
+function resolveRenderableOutput(wrapped, raw, preferredKinds) {
+    for (const kind of preferredKinds) {
+        if (kind === 'json') {
+            const jsonValue = wrapped.json();
+            if (jsonValue !== null) {
+                return { kind, value: jsonValue };
+            }
+            continue;
+        }
+        if (kind === 'markdown') {
+            const markdown = wrapped.markdown();
+            if (typeof markdown === 'string') {
+                return { kind, value: markdown };
+            }
+            continue;
+        }
+        if (kind === 'text') {
+            const text = wrapped.text();
+            if (typeof text === 'string') {
+                return { kind, value: text };
+            }
+            continue;
+        }
+        if (kind === 'raw') {
+            return { kind, value: raw };
+        }
+    }
+    return { kind: 'raw', value: raw };
+}
+function emitRenderableOutput(renderable) {
+    if (renderable.kind === 'json') {
+        if (!attemptPrintJson(renderable.value)) {
+            printRaw(renderable.value);
+        }
+        return;
+    }
+    if (renderable.kind === 'markdown' || renderable.kind === 'text') {
+        console.log(String(renderable.value));
+        return;
+    }
+    printRaw(renderable.value);
+}
+function attemptPrintJson(value) {
+    if (value === undefined) {
+        return false;
+    }
+    try {
+        if (value === null) {
+            console.log('null');
+        }
+        else {
+            console.log(JSON.stringify(value, null, 2));
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function printRaw(raw) {
+    if (typeof raw === 'string') {
+        console.log(raw);
+        return;
+    }
+    if (raw === null) {
+        console.log('null');
+        return;
+    }
+    if (raw === undefined) {
+        console.log('undefined');
+        return;
+    }
+    if (typeof raw === 'bigint') {
+        console.log(raw.toString());
+        return;
+    }
+    if (typeof raw === 'symbol' || typeof raw === 'function') {
+        console.log(raw.toString());
+        return;
+    }
+    // Keep nested payloads readable without unbounded inspect walks on huge objects.
+    console.log(inspect(raw, { depth: RAW_INSPECT_DEPTH, maxStringLength: null, breakLength: 80 }));
+}
+//# sourceMappingURL=output-utils.js.map

package/dist/cli/output-utils.js.map

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

package/dist/cli/path-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function formatPathForDisplay(filePath: string): string;
+//# sourceMappingURL=path-utils.d.ts.map

package/dist/cli/path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/cli/path-utils.ts"],"names":[],"mappings":"AAIA,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ7D"}

package/dist/cli/path-utils.js

@@ -0,0 +1,12 @@
+import os from 'node:os';
+import path from 'node:path';
+// formatPathForDisplay rewrites absolute paths into user-friendly display strings.
+export function formatPathForDisplay(filePath) {
+    const cwd = process.cwd();
+    const relative = path.relative(cwd, filePath);
+    const displayPath = relative && !relative.startsWith('..') && !path.isAbsolute(relative)
+        ? relative
+        : filePath.replace(os.homedir(), '~');
+    return displayPath;
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/cli/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../src/cli/path-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,WAAW,GACf,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAClE,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IAC1C,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/cli/runtime-debug.d.ts

@@ -0,0 +1,4 @@
+export declare const DEBUG_HANG: boolean;
+export declare function dumpActiveHandles(label: string): void;
+export declare function terminateChildProcesses(label: string): void;
+//# sourceMappingURL=runtime-debug.d.ts.map

package/dist/cli/runtime-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-debug.d.ts","sourceRoot":"","sources":["../../src/cli/runtime-debug.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,SAA0C,CAAC;AAiElE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAcrD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAwD3D"}

package/dist/cli/runtime-debug.js

@@ -0,0 +1,134 @@
+import { logInfo, logWarn } from './logger-context.js';
+export const DEBUG_HANG = process.env.MCPORTER_DEBUG_HANG === '1';
+function describeHandle(handle) {
+    if (!handle || (typeof handle !== 'object' && typeof handle !== 'function')) {
+        return String(handle);
+    }
+    const ctor = handle.constructor?.name ?? typeof handle;
+    if (ctor === 'Socket') {
+        try {
+            const socket = handle;
+            const parts = ['Socket'];
+            if (socket.localAddress) {
+                parts.push(`local=${socket.localAddress}:${socket.localPort ?? '?'}`);
+            }
+            if (socket.remoteAddress) {
+                parts.push(`remote=${socket.remoteAddress}:${socket.remotePort ?? '?'}`);
+            }
+            if (typeof socket.address === 'function') {
+                const addr = socket.address?.();
+                if (addr) {
+                    parts.push(`addr=${addr.address}:${addr.port}`);
+                }
+            }
+            const host = handle._host;
+            if (host) {
+                parts.push(`host=${host}`);
+            }
+            const pipeName = handle.path;
+            if (pipeName) {
+                parts.push(`path=${pipeName}`);
+            }
+            const extraKeys = Reflect.ownKeys(handle)
+                .filter((key) => typeof key === 'string' && key.startsWith('_') && !['_events', '_eventsCount'].includes(key))
+                .slice(0, 4);
+            if (extraKeys.length > 0) {
+                parts.push(`keys=${extraKeys.join(',')}`);
+            }
+            return parts.join(' ');
+        }
+        catch {
+            return ctor;
+        }
+    }
+    if (typeof handle === 'object') {
+        const pid = handle.pid;
+        if (typeof pid === 'number') {
+            return `${ctor} (pid=${pid})`;
+        }
+        const fd = handle.fd;
+        if (typeof fd === 'number') {
+            return `${ctor} (fd=${fd})`;
+        }
+    }
+    return ctor;
+}
+export function dumpActiveHandles(label) {
+    if (!DEBUG_HANG) {
+        return;
+    }
+    const proc = process;
+    const activeHandles = proc._getActiveHandles?.() ?? [];
+    const activeRequests = proc._getActiveRequests?.() ?? [];
+    logInfo(`[debug] ${label}: ${activeHandles.length} active handle(s), ${activeRequests.length} request(s)`);
+    for (const handle of activeHandles) {
+        logInfo(`[debug] handle => ${describeHandle(handle)}`);
+    }
+    for (const request of activeRequests) {
+        logInfo(`[debug] request => ${describeHandle(request)}`);
+    }
+}
+export function terminateChildProcesses(label) {
+    const proc = process;
+    const handles = proc._getActiveHandles?.() ?? [];
+    for (const handle of handles) {
+        if (!handle || typeof handle !== 'object') {
+            continue;
+        }
+        const candidate = handle;
+        const ctor = handle.constructor?.name ?? '';
+        if (ctor === 'Socket' && typeof handle.destroy === 'function') {
+            try {
+                handle.destroy?.();
+                if (typeof handle.unref === 'function') {
+                    handle.unref?.();
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+        if (typeof candidate.stdout?.destroy === 'function') {
+            try {
+                candidate.stdout.destroy?.();
+            }
+            catch {
+                // ignore
+            }
+        }
+        if (typeof candidate.stderr?.destroy === 'function') {
+            try {
+                candidate.stderr.destroy?.();
+            }
+            catch {
+                // ignore
+            }
+        }
+        if (typeof candidate.stdin?.end === 'function') {
+            try {
+                candidate.stdin.end?.();
+            }
+            catch {
+                // ignore
+            }
+        }
+        // When DEBUG_HANG is enabled we leave extra breadcrumbs so developers can see
+        // which transports required forceful teardown before Node would exit.
+        if (DEBUG_HANG) {
+            const killed = candidate.kill?.('SIGKILL') ?? false;
+            if (candidate.pid) {
+                const outcome = killed ? 'killed' : 'kill-failed';
+                logWarn(`[debug] forcibly ${outcome} child pid=${candidate.pid} (${label})`);
+            }
+        }
+        else if (typeof candidate.kill === 'function' && typeof candidate.pid === 'number' && !candidate.killed) {
+            try {
+                candidate.kill('SIGKILL');
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+//# sourceMappingURL=runtime-debug.js.map