@atlassian/mcp-compressor 0.28.0 → 0.29.0

package/dist/just_bash_commands.js

@@ -1,5 +1,5 @@
 import { defineCommand } from "just-bash";
-import { parseToolArgv } from "./rust_core.js";
+import { parseToolArgv, renderCliSubcommandHelp, renderCliTopLevelHelp, } from "./rust_core.js";
 import { normalizeStructuredArgValues } from "./tool_specs.js";
 export function createJustBashCommandRegistrations(sources) {
     const grouped = new Map();
@@ -21,13 +21,21 @@ export function createJustBashCommandRegistrations(sources) {
             command: defineCommand(providerName, async (args) => {
                 try {
                     const [subcommand, ...toolArgs] = args;
-                    if (subcommand === undefined || subcommand === "--help" || subcommand === "-h") {
-                        return output(dispatcherHelp(providerName, providerSources));
+                    if (subcommand === undefined ||
+                        subcommand === "--help" ||
+                        subcommand === "-h" ||
+                        subcommand === "help") {
+                        return output(renderCliTopLevelHelp(providerName, providerName, providerSources.map((source) => source.tool)));
                     }
                     const source = bySubcommand.get(subcommand);
                     if (source === undefined) {
                         throw new Error(`Unknown ${providerName} subcommand: ${subcommand}`);
                     }
+                    // Per-subcommand help must match the generated CLI's rich `--help`
+                    // output, so render it from the shared Rust renderer.
+                    if (toolArgs.includes("--help") || toolArgs.includes("-h")) {
+                        return output(renderCliSubcommandHelp(providerName, source.tool));
+                    }
                     const parsedInput = parseToolArgv(source.tool, toolArgs);
                     const toolInput = normalizeStructuredArgValues(source.tool.inputSchema, parsedInput);
                     return output(await source.invoke(toolInput));
@@ -52,22 +60,6 @@ export function installJustBashRegistrations(bash, registrations) {
         ];
     }
 }
-function dispatcherHelp(providerName, sources) {
-    const maxNameLength = Math.max(...sources.map((source) => source.backendToolName.replaceAll("_", "-").length), 0);
-    return [
-        `${providerName} - the ${providerName} toolset`,
-        "",
-        "USAGE:",
-        `  ${providerName} <subcommand> [options]`,
-        "",
-        "SUBCOMMANDS:",
-        ...sources.map((source) => {
-            const description = (source.tool.description ?? "").replace(/\s+/g, " ").trim();
-            const subcommand = source.backendToolName.replaceAll("_", "-");
-            return `  ${subcommand.padEnd(maxNameLength + 2)}${description}`.trimEnd();
-        }),
-    ].join("\n");
-}
 function output(stdout) {
     return { stdout: `${stdout}\n`, stderr: "", exitCode: 0 };
 }

package/dist/native.d.ts

@@ -8,6 +8,8 @@ export interface NativeCore {
     formatToolSchemaResponseJson(toolJson: string): string;
     maybeToonifyOutputJson(output: string): string;
     parseToolArgvJson(toolJson: string, argvJson: string): string;
+    renderCliTopLevelHelpJson(command: string, cliName: string, toolsJson: string): string;
+    renderCliSubcommandHelpJson(cliName: string, toolJson: string): string;
     generateClientArtifactsJson(kind: string, configJson: string): string;
     generateClientArtifactFilesJson(kind: string, configJson: string): string;
     buildHostTransformPlanJson(configJson: string): string;

package/dist/rust_core.d.ts

@@ -8,6 +8,17 @@ export declare function compressToolListing(level: string, tools: ToolSpec[]): s
 export declare function formatToolSchemaResponse(tool: ToolSpec): string;
 export declare function maybeToonifyOutput(output: string): string;
 export declare function parseToolArgv(tool: ToolSpec, argv: string[]): Record<string, unknown>;
+/**
+ * Render the shared top-level CLI help text (`<command> --help`). Backed by the
+ * same Rust renderer used for the generated CLI script and the `*_help` tool
+ * description, so all transform modes stay in sync.
+ */
+export declare function renderCliTopLevelHelp(command: string, cliName: string, tools: ToolSpec[]): string;
+/**
+ * Render the shared rich per-subcommand CLI help text
+ * (`<command> <subcommand> --help`).
+ */
+export declare function renderCliSubcommandHelp(cliName: string, tool: ToolSpec): string;
 export type ClientArtifactKind = "cli" | "python" | "typescript";
 export interface ClientGeneratorConfig {
     cliName: string;

package/dist/rust_core.js

@@ -21,6 +21,21 @@ export function maybeToonifyOutput(output) {
 export function parseToolArgv(tool, argv) {
     return JSON.parse(loadNativeCore().parseToolArgvJson(stringify(toNativeTool(tool)), stringify(argv)));
 }
+/**
+ * Render the shared top-level CLI help text (`<command> --help`). Backed by the
+ * same Rust renderer used for the generated CLI script and the `*_help` tool
+ * description, so all transform modes stay in sync.
+ */
+export function renderCliTopLevelHelp(command, cliName, tools) {
+    return loadNativeCore().renderCliTopLevelHelpJson(command, cliName, stringify(tools.map(toNativeTool)));
+}
+/**
+ * Render the shared rich per-subcommand CLI help text
+ * (`<command> <subcommand> --help`).
+ */
+export function renderCliSubcommandHelp(cliName, tool) {
+    return loadNativeCore().renderCliSubcommandHelpJson(cliName, stringify(toNativeTool(tool)));
+}
 function toNativeGeneratorConfig(config) {
     return {
         cli_name: config.cliName,

package/native/index.d.ts

@@ -32,6 +32,10 @@ export declare function parseToolArgvJson(toolJson: string, argvJson: string): s
 
 export declare function rememberOauthBackendJson(backendUri: string, backendName: string, storeDir: string): void
 
+export declare function renderCliSubcommandHelpJson(cliName: string, toolJson: string): string
+
+export declare function renderCliTopLevelHelpJson(command: string, cliName: string, toolsJson: string): string
+
 export declare function startCompressedSessionFromMcpConfigJson(configJson: string, mcpConfigJson: string): Promise<NativeCompressedSession>
 
 export declare function startCompressedSessionJson(configJson: string, backendsJson: string): Promise<NativeCompressedSession>

package/native/index.js

@@ -590,6 +590,8 @@ module.exports.normalizeServersJson = nativeBinding.normalizeServersJson
 module.exports.parseMcpConfigJson = nativeBinding.parseMcpConfigJson
 module.exports.parseToolArgvJson = nativeBinding.parseToolArgvJson
 module.exports.rememberOauthBackendJson = nativeBinding.rememberOauthBackendJson
+module.exports.renderCliSubcommandHelpJson = nativeBinding.renderCliSubcommandHelpJson
+module.exports.renderCliTopLevelHelpJson = nativeBinding.renderCliTopLevelHelpJson
 module.exports.startCompressedSessionFromMcpConfigJson = nativeBinding.startCompressedSessionFromMcpConfigJson
 module.exports.startCompressedSessionJson = nativeBinding.startCompressedSessionJson
 module.exports.startCompressedSessionWithProviderBackendsJson = nativeBinding.startCompressedSessionWithProviderBackendsJson

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlassian/mcp-compressor",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "TypeScript MCP server wrapper for reducing tokens consumed by MCP tools.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/atlassian-labs/mcp-compressor",