@respan/cli 0.15.0 → 0.16.0

package/dist/commands/tools/call.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class ToolsCall extends BaseCommand {
+    static description: string;
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        input: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'input-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'mcp-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tools/call.js

@@ -0,0 +1,31 @@
+import { readFileSync } from 'node:fs';
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+import { withMcpClient } from '../../lib/mcp-client.js';
+class ToolsCall extends BaseCommand {
+    async run() {
+        const { args, flags } = await this.parse(ToolsCall);
+        this.globalFlags = flags;
+        try {
+            const input = JSON.parse(flags['input-file'] ? readFileSync(flags['input-file'], 'utf8') : flags.input ?? '{}');
+            if (!input || typeof input !== 'object' || Array.isArray(input))
+                throw new Error('Tool input must be a JSON object.');
+            const result = await withMcpClient(this.getAuth(), flags['mcp-url'], (client) => client.callTool({ name: args.name, arguments: input }));
+            this.log(JSON.stringify(result, null, 2));
+            if (result.isError)
+                this.exit(1);
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+ToolsCall.description = 'Call a Respan MCP tool with its exact tool name and JSON arguments. Writes execute immediately; inspect tools list --json before calling.';
+ToolsCall.args = { name: Args.string({ description: 'MCP tool name, e.g. log_list or trace_get', required: true }) };
+ToolsCall.flags = {
+    ...BaseCommand.baseFlags,
+    input: Flags.string({ description: 'JSON object of MCP tool arguments', exclusive: ['input-file'] }),
+    'input-file': Flags.string({ description: 'File containing a JSON object of MCP tool arguments', exclusive: ['input'] }),
+    'mcp-url': Flags.string({ description: 'Custom MCP server URL (defaults to the active Platform or Enterprise server)' }),
+};
+export default ToolsCall;

package/dist/commands/tools/list.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class ToolsList extends BaseCommand {
+    static description: string;
+    static flags: {
+        'mcp-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tools/list.js

@@ -0,0 +1,22 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+import { listMcpTools, withMcpClient } from '../../lib/mcp-client.js';
+class ToolsList extends BaseCommand {
+    async run() {
+        const { flags } = await this.parse(ToolsList);
+        this.globalFlags = flags;
+        try {
+            const tools = await withMcpClient(this.getAuth(), flags['mcp-url'], listMcpTools);
+            this.outputResult(tools, ['name', 'description']);
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+ToolsList.description = 'List the current Respan MCP tools, their input schemas, and annotations.';
+ToolsList.flags = {
+    ...BaseCommand.baseFlags,
+    'mcp-url': Flags.string({ description: 'Custom MCP server URL (defaults to the active Platform or Enterprise server)' }),
+};
+export default ToolsList;

package/dist/lib/mcp-client.d.ts

@@ -0,0 +1,38 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { AuthConfig } from './auth.js';
+export declare function resolveMcpUrl(baseUrl: string, override?: string): URL;
+export declare function withMcpClient<T>(auth: AuthConfig, override: string | undefined, run: (client: Client) => Promise<T>): Promise<T>;
+export declare function listMcpTools(client: Client): Promise<{
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: Record<string, object> | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: Record<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?: Record<string, unknown> | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+}[]>;

package/dist/lib/mcp-client.js

@@ -0,0 +1,52 @@
+import { readFileSync } from 'node:fs';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+export function resolveMcpUrl(baseUrl, override) {
+    if (override) {
+        const url = new URL(override);
+        if (url.protocol !== 'https:' && !(url.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname))) {
+            throw new Error('MCP URL must use HTTPS (HTTP is allowed for localhost).');
+        }
+        if (url.username || url.password)
+            throw new Error('MCP URL must not contain credentials.');
+        return url;
+    }
+    const origin = new URL(baseUrl).origin;
+    if (origin === 'https://api.respan.ai')
+        return new URL('https://mcp.respan.ai/api/mcp');
+    if (origin === 'https://endpoint.respan.ai')
+        return new URL('https://mcp.respan.ai/api/mcp/enterprise');
+    throw new Error('For a custom API endpoint, specify its MCP server with --mcp-url.');
+}
+export async function withMcpClient(auth, override, run) {
+    const token = auth.apiKey || auth.accessToken;
+    if (!token)
+        throw new Error('No API key or access token available.');
+    const { version } = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+    const client = new Client({ name: 'respan-cli', version });
+    const transport = new StreamableHTTPClientTransport(resolveMcpUrl(auth.baseUrl, override), {
+        requestInit: { headers: { Authorization: `Bearer ${token}` } },
+    });
+    try {
+        await client.connect(transport);
+        return await run(client);
+    }
+    finally {
+        await client.close();
+    }
+}
+export async function listMcpTools(client) {
+    const tools = [];
+    const seen = new Set();
+    let cursor;
+    do {
+        const result = await client.listTools(cursor ? { cursor } : undefined);
+        tools.push(...result.tools);
+        cursor = result.nextCursor;
+        if (cursor && seen.has(cursor))
+            throw new Error('MCP server returned a repeated pagination cursor.');
+        if (cursor)
+            seen.add(cursor);
+    } while (cursor);
+    return tools;
+}