@nimrobo/mcporter-remote 0.1.0

package/dist/cli/list-doc-comments.js

@@ -0,0 +1,114 @@
+import { cyanText, extraDimText, yellowText } from './terminal.js';
+const DEFAULT_WRAP_WIDTH = 100;
+export function buildDocComment(description, options, opts) {
+    const colorize = opts?.colorize !== false;
+    const descriptionLines = description?.split(/\r?\n/) ?? [];
+    const paramDocs = options.filter((option) => option.description);
+    if (descriptionLines.every((line) => line.trim().length === 0) && paramDocs.length === 0) {
+        return undefined;
+    }
+    const tint = colorize ? extraDimText : (value) => value;
+    const highlightParam = colorize ? (value) => yellowText(value) : (value) => value;
+    const highlightName = colorize ? (value) => cyanText(value) : (value) => value;
+    const lines = [];
+    lines.push(tint('/**'));
+    let hasDescription = false;
+    for (const line of descriptionLines) {
+        const trimmed = line.trimEnd();
+        if (trimmed.trim().length > 0) {
+            const wrapped = wrapCommentText(trimmed);
+            for (const segment of wrapped) {
+                lines.push(tint(` * ${segment}`));
+            }
+            hasDescription = true;
+        }
+    }
+    if (hasDescription && paramDocs.length > 0) {
+        lines.push(tint(' *'));
+    }
+    for (const option of paramDocs) {
+        const optionLines = formatParamDoc(option, DEFAULT_WRAP_WIDTH, {
+            colorize,
+            highlightParam,
+            highlightName,
+        });
+        lines.push(...optionLines);
+    }
+    lines.push(tint(' */'));
+    return lines;
+}
+function formatParamDoc(option, wrapWidth, config) {
+    const { colorize, highlightParam, highlightName } = config;
+    const descriptionLines = option.description?.split(/\r?\n/) ?? [''];
+    const optionalSuffix = option.required ? '' : '?';
+    const plainLabel = `@param ${option.property}${optionalSuffix}`;
+    const continuationPrefix = colorize
+        ? extraDimText(` * ${' '.repeat(plainLabel.length + 1)}`)
+        : ` * ${' '.repeat(plainLabel.length + 1)}`;
+    const rendered = [];
+    descriptionLines.forEach((entry, index) => {
+        const suffix = entry.trimEnd();
+        if (index === 0) {
+            const lineParts = [
+                colorize ? extraDimText(' * ') : ' * ',
+                highlightParam('@param '),
+                highlightName(`${option.property}${optionalSuffix}`),
+            ];
+            if (suffix.length > 0) {
+                const wrapped = wrapCommentText(suffix, wrapWidth - plainLabel.length - 1);
+                if (wrapped.length > 0) {
+                    lineParts.push(colorize ? extraDimText(` ${wrapped[0]}`) : ` ${wrapped[0]}`);
+                    rendered.push(lineParts.join(''));
+                    for (const continuation of wrapped.slice(1)) {
+                        rendered.push(`${continuationPrefix}${colorize ? extraDimText(continuation) : continuation}`);
+                    }
+                    return;
+                }
+            }
+            rendered.push(lineParts.join(''));
+            return;
+        }
+        if (suffix.length > 0) {
+            const wrapped = wrapCommentText(suffix, wrapWidth - plainLabel.length - 1);
+            if (wrapped.length === 0) {
+                return;
+            }
+            const [first, ...rest] = wrapped;
+            if (!first) {
+                return;
+            }
+            rendered.push(`${continuationPrefix}${colorize ? extraDimText(first) : first}`);
+            for (const segment of rest) {
+                rendered.push(`${continuationPrefix}${colorize ? extraDimText(segment) : segment}`);
+            }
+        }
+    });
+    return rendered;
+}
+export function wrapCommentText(text, width = DEFAULT_WRAP_WIDTH) {
+    if (!text) {
+        return [];
+    }
+    const words = text.split(/\s+/).filter(Boolean);
+    if (words.length === 0) {
+        return [];
+    }
+    const lines = [];
+    let current = words[0] ?? '';
+    for (let index = 1; index < words.length; index += 1) {
+        const word = words[index];
+        if (!word) {
+            continue;
+        }
+        if (`${current} ${word}`.length > width) {
+            lines.push(current);
+            current = word;
+        }
+        else {
+            current += ` ${word}`;
+        }
+    }
+    lines.push(current);
+    return lines;
+}
+//# sourceMappingURL=list-doc-comments.js.map

package/dist/cli/list-doc-comments.js.map

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

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

@@ -0,0 +1,38 @@
+import type { ServerDefinition, ServerSource } from '../config.js';
+import type { ConnectionIssue } from '../error-classifier.js';
+import type { ServerToolInfo } from '../runtime.js';
+export type StatusCategory = 'ok' | 'auth' | 'offline' | 'http' | 'error';
+export type ListSummaryResult = {
+    status: 'ok';
+    server: ServerDefinition;
+    tools: ServerToolInfo[];
+    durationMs: number;
+} | {
+    status: 'error';
+    server: ServerDefinition;
+    error: unknown;
+    durationMs: number;
+};
+export declare function renderServerListRow(result: ListSummaryResult, timeoutMs: number, options?: {
+    verbose?: boolean;
+}): {
+    line: string;
+    summary: string;
+    category: StatusCategory;
+    authCommand?: string;
+    issue?: ConnectionIssue;
+};
+export declare function truncateForSpinner(text: string, maxLength?: number): string;
+export declare function formatSourceSuffix(sourceOrSources: ServerSource | readonly ServerSource[] | undefined, inline?: boolean, options?: {
+    verbose?: boolean;
+}): string;
+export declare function classifyListError(error: unknown, serverName: string, _timeoutSeconds: number, options?: {
+    authCommand?: string;
+}): {
+    colored: string;
+    summary: string;
+    category: StatusCategory;
+    authCommand?: string;
+    issue: ConnectionIssue;
+};
+//# sourceMappingURL=list-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-format.d.ts","sourceRoot":"","sources":["../../src/cli/list-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1E,MAAM,MAAM,iBAAiB,GACzB;IACE,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC;IACD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB,CA6BA;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAKvE;AAED,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,GAAG,SAAS,EACnE,MAAM,UAAQ,EACd,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,MAAM,CA0BR;AAiBD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;CACxB,CAoBA"}

package/dist/cli/list-format.js

@@ -0,0 +1,98 @@
+import { analyzeConnectionError } from '../error-classifier.js';
+import { formatPathForDisplay } from './path-utils.js';
+import { dimText, extraDimText, redText, yellowText } from './terminal.js';
+export function renderServerListRow(result, timeoutMs, options = {}) {
+    const description = result.server.description ? dimText(` — ${result.server.description}`) : '';
+    const durationLabel = dimText(`${(result.durationMs / 1000).toFixed(1)}s`);
+    const sourceSuffix = formatSourceSuffix(result.server.sources ?? result.server.source, false, {
+        verbose: options.verbose,
+    });
+    const prefix = `- ${result.server.name}${description}`;
+    if (result.status === 'ok') {
+        const toolSuffix = result.tools.length === 0
+            ? 'no tools reported'
+            : `${result.tools.length === 1 ? '1 tool' : `${result.tools.length} tools`}`;
+        return {
+            line: `${prefix} (${toolSuffix}, ${durationLabel})${sourceSuffix}`,
+            summary: toolSuffix,
+            category: 'ok',
+        };
+    }
+    const timeoutSeconds = Math.round(timeoutMs / 1000);
+    const advice = classifyListError(result.error, result.server.name, timeoutSeconds);
+    return {
+        line: `${prefix} (${advice.colored}, ${durationLabel})${sourceSuffix}`,
+        summary: advice.summary,
+        category: advice.category,
+        authCommand: advice.authCommand,
+        issue: advice.issue,
+    };
+}
+export function truncateForSpinner(text, maxLength = 72) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return `${text.slice(0, Math.max(0, maxLength - 1))}…`;
+}
+export function formatSourceSuffix(sourceOrSources, inline = false, options = {}) {
+    const sources = Array.isArray(sourceOrSources) ? [...sourceOrSources] : sourceOrSources ? [sourceOrSources] : [];
+    if (sources.length === 0) {
+        return '';
+    }
+    const verbose = options.verbose ?? false;
+    if (!verbose) {
+        const primary = sources[0];
+        if (primary.kind !== 'import') {
+            return '';
+        }
+        const formatted = formatPathForDisplay(primary.path);
+        const tinted = extraDimText(inline ? formatted : `[source: ${formatted}]`);
+        return inline ? tinted : ` ${tinted}`;
+    }
+    // When verbose, show every contributing source (primary first) so duplicates are discoverable.
+    const [primary, ...alternates] = sources;
+    const primaryLabel = buildSourceLabel(primary, { primary: true });
+    const altLabels = alternates.map((entry) => {
+        const shadowedByLocal = primary.kind === 'local' && entry.kind !== 'local';
+        return buildSourceLabel(entry, { shadowReason: shadowedByLocal ? 'shadowed by local' : 'shadowed' });
+    });
+    const label = altLabels.length === 0 ? `source: ${primaryLabel}` : `sources: ${[primaryLabel, ...altLabels].join(' · ')}`;
+    const tinted = extraDimText(inline ? label : `[${label}]`);
+    return inline ? tinted : ` ${tinted}`;
+}
+function buildSourceLabel(source, options) {
+    const base = formatPathForDisplay(source.path);
+    const tags = [];
+    if (options.primary) {
+        tags.push('primary');
+    }
+    if (options.shadowReason) {
+        tags.push(options.shadowReason);
+    }
+    if (source.importKind) {
+        tags.push(source.importKind);
+    }
+    return tags.length === 0 ? base : `${base} (${tags.join(', ')})`;
+}
+export function classifyListError(error, serverName, _timeoutSeconds, options) {
+    const issue = analyzeConnectionError(error);
+    if (issue.kind === 'auth') {
+        const authCommand = options?.authCommand ?? `mcporter auth ${serverName}`;
+        const note = yellowText(`auth required — run '${authCommand}'`);
+        return { colored: note, summary: 'auth required', category: 'auth', authCommand, issue };
+    }
+    if (issue.kind === 'offline') {
+        const note = redText('offline — unable to reach server');
+        return { colored: note, summary: 'offline', category: 'offline', issue };
+    }
+    if (issue.kind === 'http') {
+        const statusText = issue.statusCode ? `HTTP ${issue.statusCode}` : 'HTTP error';
+        const detail = issue.rawMessage && issue.rawMessage !== String(issue.statusCode) ? ` — ${issue.rawMessage}` : '';
+        const note = redText(`${statusText}${detail}`);
+        return { colored: note, summary: statusText.toLowerCase(), category: 'http', issue };
+    }
+    const rawMessage = issue.rawMessage || 'unknown error';
+    const note = redText(rawMessage);
+    return { colored: note, summary: rawMessage, category: 'error', issue };
+}
+//# sourceMappingURL=list-format.js.map

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

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

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

@@ -0,0 +1,39 @@
+import type { ServerDefinition } from '../config.js';
+import type { ToolMetadata } from './generate/tools.js';
+import type { SerializedConnectionIssue } from './json-output.js';
+import type { ListSummaryResult, StatusCategory } from './list-format.js';
+export interface ToolDetailResult {
+    examples: string[];
+    optionalOmitted: boolean;
+}
+export interface ListJsonServerEntry {
+    name: string;
+    status: StatusCategory;
+    durationMs: number;
+    description?: string;
+    transport?: string;
+    source?: ServerDefinition['source'];
+    sources?: ServerDefinition['sources'];
+    tools?: Array<{
+        name: string;
+        description?: string;
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+    }>;
+    issue?: SerializedConnectionIssue;
+    authCommand?: string;
+    error?: string;
+}
+export declare function printSingleServerHeader(definition: ReturnType<Awaited<ReturnType<typeof import('../runtime.js')['createRuntime']>>['getDefinition']>, toolCount: number | undefined, durationMs: number | undefined, transportSummary: string, sourcePath: string | undefined, options?: {
+    printSummaryNow?: boolean;
+}): string;
+export declare function printToolDetail(definition: ReturnType<Awaited<ReturnType<typeof import('../runtime.js')['createRuntime']>>['getDefinition']>, metadata: ToolMetadata, includeSchema: boolean, requiredOnly: boolean): ToolDetailResult;
+export declare function createEmptyStatusCounts(): Record<StatusCategory, number>;
+export declare function summarizeStatusCounts(entries: ListJsonServerEntry[]): Record<StatusCategory, number>;
+export declare function buildJsonListEntry(result: ListSummaryResult, timeoutSeconds: number, options: {
+    includeSchemas: boolean;
+    includeSources?: boolean;
+}): ListJsonServerEntry;
+export declare function createUnknownResult(server: ServerDefinition): ListSummaryResult;
+export declare function buildAuthCommandHint(definition: ReturnType<Awaited<ReturnType<typeof import('../runtime.js')['createRuntime']>>['getDefinition']>): string;
+//# sourceMappingURL=list-output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-output.d.ts","sourceRoot":"","sources":["../../src/cli/list-output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAK1E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,yBAAyB,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,eAAe,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,EAC7G,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GACtC,MAAM,CA4BR;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,eAAe,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,EAC7G,QAAQ,EAAE,YAAY,EACtB,aAAa,EAAE,OAAO,EACtB,YAAY,EAAE,OAAO,GACpB,gBAAgB,CA8BlB;AAeD,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAQxE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAMpG;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7D,mBAAmB,CAwCrB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,CAO/E;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,eAAe,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,GAC5G,MAAM,CAaR"}

package/dist/cli/list-output.js

@@ -0,0 +1,159 @@
+import { formatErrorMessage, serializeConnectionIssue } from './json-output.js';
+import { buildToolDoc } from './list-detail-helpers.js';
+import { classifyListError } from './list-format.js';
+import { boldText, extraDimText } from './terminal.js';
+import { formatTransportSummary } from './transport-utils.js';
+export function printSingleServerHeader(definition, toolCount, durationMs, transportSummary, sourcePath, options) {
+    const prefix = boldText(definition.name);
+    if (definition.description) {
+        console.log(`${prefix} - ${extraDimText(definition.description)}`);
+    }
+    else {
+        console.log(prefix);
+    }
+    const summaryParts = [];
+    summaryParts.push(extraDimText(typeof toolCount === 'number' ? `${toolCount} tool${toolCount === 1 ? '' : 's'}` : 'tools unavailable'));
+    if (typeof durationMs === 'number') {
+        summaryParts.push(extraDimText(`${durationMs}ms`));
+    }
+    if (transportSummary) {
+        summaryParts.push(extraDimText(transportSummary));
+    }
+    if (sourcePath) {
+        summaryParts.push(sourcePath);
+    }
+    const summaryLine = `  ${summaryParts.join(extraDimText(' · '))}`;
+    if (options?.printSummaryNow === false) {
+        console.log('');
+    }
+    else {
+        console.log(summaryLine);
+        console.log('');
+    }
+    return summaryLine;
+}
+export function printToolDetail(definition, metadata, includeSchema, requiredOnly) {
+    const exampleOptions = buildExampleOptions(definition);
+    const doc = buildToolDoc({
+        serverName: definition.name,
+        toolName: metadata.tool.name,
+        description: metadata.tool.description,
+        outputSchema: metadata.tool.outputSchema,
+        options: metadata.options,
+        requiredOnly,
+        colorize: true,
+        callSelector: exampleOptions?.selector,
+        wrapExampleExpression: exampleOptions?.wrapExpression,
+    });
+    if (doc.docLines) {
+        for (const line of doc.docLines) {
+            console.log(`  ${line}`);
+        }
+    }
+    console.log(`  ${doc.signature}`);
+    if (doc.optionalSummary && requiredOnly) {
+        console.log(`  ${doc.optionalSummary}`);
+    }
+    if (includeSchema && metadata.tool.inputSchema) {
+        console.log(indent(JSON.stringify(metadata.tool.inputSchema, null, 2), '      '));
+    }
+    console.log('');
+    return {
+        examples: doc.examples,
+        optionalOmitted: doc.hiddenOptions.length > 0,
+    };
+}
+function buildExampleOptions(definition) {
+    if (definition.source?.kind !== 'local' || definition.source.path !== '<adhoc>') {
+        return undefined;
+    }
+    if (definition.command.kind === 'http') {
+        const url = definition.command.url instanceof URL ? definition.command.url.href : String(definition.command.url);
+        return { selector: url, wrapExpression: true };
+    }
+    return undefined;
+}
+export function createEmptyStatusCounts() {
+    return {
+        ok: 0,
+        auth: 0,
+        offline: 0,
+        http: 0,
+        error: 0,
+    };
+}
+export function summarizeStatusCounts(entries) {
+    const counts = createEmptyStatusCounts();
+    entries.forEach((entry) => {
+        counts[entry.status] = (counts[entry.status] ?? 0) + 1;
+    });
+    return counts;
+}
+export function buildJsonListEntry(result, timeoutSeconds, options) {
+    if (result.status === 'ok') {
+        return {
+            name: result.server.name,
+            status: 'ok',
+            durationMs: result.durationMs,
+            description: result.server.description,
+            transport: formatTransportSummary(result.server),
+            source: result.server.source,
+            sources: options.includeSources ? result.server.sources : undefined,
+            tools: result.tools.map((tool) => ({
+                name: tool.name,
+                description: tool.description,
+                inputSchema: options.includeSchemas ? tool.inputSchema : undefined,
+                outputSchema: options.includeSchemas ? tool.outputSchema : undefined,
+            })),
+        };
+    }
+    const authCommand = buildAuthCommandHint(result.server);
+    const advice = classifyListError(result.error, result.server.name, timeoutSeconds, { authCommand });
+    return {
+        name: result.server.name,
+        status: advice.category,
+        durationMs: result.durationMs,
+        description: result.server.description,
+        transport: formatTransportSummary(result.server),
+        source: result.server.source,
+        sources: options.includeSources ? result.server.sources : undefined,
+        issue: serializeConnectionIssue(advice.issue),
+        authCommand: advice.authCommand,
+        error: formatErrorMessage(result.error),
+    };
+}
+export function createUnknownResult(server) {
+    return {
+        status: 'error',
+        server,
+        error: new Error('Unknown server result'),
+        durationMs: 0,
+    };
+}
+export function buildAuthCommandHint(definition) {
+    if (definition.source?.kind === 'local' && definition.source.path === '<adhoc>') {
+        if (definition.command.kind === 'http') {
+            const url = definition.command.url instanceof URL ? definition.command.url.href : String(definition.command.url);
+            return `mcporter auth ${url}`;
+        }
+        if (definition.command.kind === 'stdio') {
+            const parts = [definition.command.command, ...(definition.command.args ?? [])];
+            const rendered = parts.map(quoteCommandSegment).join(' ').trim();
+            return rendered.length > 0 ? `mcporter auth --stdio ${rendered}` : 'mcporter auth --stdio';
+        }
+    }
+    return `mcporter auth ${definition.name}`;
+}
+function indent(text, pad) {
+    return text
+        .split('\n')
+        .map((line) => pad + line)
+        .join('\n');
+}
+function quoteCommandSegment(segment) {
+    if (/^[A-Za-z0-9_./:-]+$/.test(segment)) {
+        return segment;
+    }
+    return JSON.stringify(segment);
+}
+//# sourceMappingURL=list-output.js.map

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

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

package/dist/cli/list-signature.d.ts

@@ -0,0 +1,26 @@
+import type { GeneratedOption } from './generate/tools.js';
+export interface SignatureFormatOptions {
+    colorize?: boolean;
+    defaultReturnType?: string;
+}
+export interface FlagUsageExtra {
+    text: string;
+    required?: boolean;
+}
+export declare function formatFunctionSignature(name: string, options: GeneratedOption[], outputSchema: unknown, formatOptions?: SignatureFormatOptions): string;
+export declare function formatOptionalSummary(hiddenOptions: GeneratedOption[], options?: {
+    colorize?: boolean;
+}): string;
+export declare function formatFlagUsage(options: GeneratedOption[], extras?: FlagUsageExtra[], opts?: {
+    colorize?: boolean;
+}): string;
+export declare function formatFlagLabel(option: GeneratedOption): string;
+export declare function formatCallExpressionExample(serverName: string, toolName: string, options: GeneratedOption[], extra?: {
+    callSelector?: string;
+    wrapExpression?: boolean;
+}): string | undefined;
+export declare function formatExampleBlock(examples: string[], options?: {
+    maxExamples?: number;
+    maxLength?: number;
+}): string[];
+//# sourceMappingURL=list-signature.d.ts.map

package/dist/cli/list-signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-signature.d.ts","sourceRoot":"","sources":["../../src/cli/list-signature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EAAE,EAC1B,YAAY,EAAE,OAAO,EACrB,aAAa,CAAC,EAAE,sBAAsB,GACrC,MAAM,CAQR;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,eAAe,EAAE,EAAE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAWhH;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EAAE,EAC1B,MAAM,CAAC,EAAE,cAAc,EAAE,EACzB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,MAAM,CAwBR;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAE/D;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EAAE,EAC1B,KAAK,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1D,MAAM,GAAG,SAAS,CAepB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,MAAM,EAAE,CAOV"}