@hypercli.com/cli 0.0.0-stage → 0.9.2

package/dist/core/captured-logs.d.ts

@@ -0,0 +1,9 @@
+import type { AgentLogCapture } from '@hypercli.com/sdk';
+/** The original SDK snapshot stays intact for JSON. */
+type Capture = Pick<AgentLogCapture, 'source' | 'generation' | 'file_generation' | 'launch_epoch' | 'content_base64' | 'truncated' | 'unavailable' | 'assignment_id' | 'capture' | 'diagnostics_dropped'>;
+/** No offsets are provided by the capture protocol: overlapping tails are not deltas. */
+export declare function capturedLogRenderer(write: (text: string) => void, info: (text: string) => void): (snapshot: {
+    unavailable: string | null;
+    captures: Capture[];
+}) => void;
+export {};

package/dist/core/captured-logs.js

@@ -0,0 +1,52 @@
+/** No offsets are provided by the capture protocol: overlapping tails are not deltas. */
+export function capturedLogRenderer(write, info) {
+    const previous = new Map();
+    return (snapshot) => {
+        if (snapshot.unavailable)
+            info(`runner logs unavailable: ${snapshot.unavailable}`);
+        const present = new Set();
+        for (const capture of snapshot.captures) {
+            const key = `${capture.source}/${capture.generation}`;
+            present.add(key);
+            const old = previous.get(key);
+            previous.set(key, capture);
+            if (capture.capture?.dropped_bytes && capture.capture.dropped_bytes !== old?.capture?.dropped_bytes) {
+                info(`${key}: capture dropped ${capture.capture.dropped_bytes} bytes; continuity unavailable`);
+            }
+            if (capture.diagnostics_dropped && capture.diagnostics_dropped !== old?.diagnostics_dropped) {
+                info(`${key}: ${capture.diagnostics_dropped} diagnostics dropped`);
+            }
+            if (capture.unavailable) {
+                if (old?.unavailable !== capture.unavailable)
+                    info(`${key}: unavailable (${capture.unavailable})`);
+                continue;
+            }
+            const bytes = Buffer.from(capture.content_base64 ?? '', 'base64');
+            const sameFile = old && capture.file_generation !== null && old.file_generation === capture.file_generation
+                && old.assignment_id === capture.assignment_id && old.launch_epoch === capture.launch_epoch && !old.unavailable;
+            if (sameFile && old.content_base64 === capture.content_base64 && old.truncated === capture.truncated)
+                continue;
+            if (!old || !sameFile) {
+                info(`${key}: ${old ? 'replacement generation' : 'captured snapshot'}${capture.truncated ? ' (truncated)' : ''}`);
+                if (bytes.length)
+                    write(bytes.toString('utf8'));
+                else
+                    info(`${key}: empty capture`);
+                continue;
+            }
+            const prior = Buffer.from(old.content_base64 ?? '', 'base64');
+            if (!old.truncated && !capture.truncated && bytes.subarray(0, prior.length).equals(prior)) {
+                const suffix = bytes.subarray(prior.length);
+                if (suffix.length)
+                    write(suffix.toString('utf8'));
+            }
+            else {
+                info(`${key}: bounded snapshot replaced; continuity unavailable (use --json --follow for replacement snapshots)`);
+            }
+        }
+        for (const key of previous.keys())
+            if (!present.has(key))
+                previous.delete(key);
+    };
+}
+//# sourceMappingURL=captured-logs.js.map

package/dist/core/captured-logs.js.map

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

package/dist/core/client.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The one place that builds the SDK client.
+ *
+ * Construction honors the SDK config precedence exactly:
+ *   product key:  HYPER_API_KEY > $HYPER_HOME/config or ~/.hypercli/config
+ *   agents key:   product key first, then HYPER_AGENTS_API_KEY fallback
+ *   apiUrl:       HYPER_API_BASE / config / default
+ *   agents base:  HYPER_AGENTS_API_BASE / config / derived from product base
+ *
+ * The retired HYPERCLI_API_URL / AGENTS_API_BASE_URL override envs are no
+ * longer read anywhere; endpoint resolution lives in the SDK config.
+ *
+ * Throws (as a plain Error, mapped to exit 1 by the entrypoint) when no
+ * credential is configured.
+ */
+import { HyperCLI } from '@hypercli.com/sdk';
+/** Lazily-built singleton for CommandContext.client(). */
+export declare function lazyClient(): () => Promise<HyperCLI>;

package/dist/core/client.js

@@ -0,0 +1,31 @@
+/**
+ * The one place that builds the SDK client.
+ *
+ * Construction honors the SDK config precedence exactly:
+ *   product key:  HYPER_API_KEY > $HYPER_HOME/config or ~/.hypercli/config
+ *   agents key:   product key first, then HYPER_AGENTS_API_KEY fallback
+ *   apiUrl:       HYPER_API_BASE / config / default
+ *   agents base:  HYPER_AGENTS_API_BASE / config / derived from product base
+ *
+ * The retired HYPERCLI_API_URL / AGENTS_API_BASE_URL override envs are no
+ * longer read anywhere; endpoint resolution lives in the SDK config.
+ *
+ * Throws (as a plain Error, mapped to exit 1 by the entrypoint) when no
+ * credential is configured.
+ */
+import { HyperCLI, getAgentApiKey, getApiKey, getApiUrl, } from '@hypercli.com/sdk';
+/** Lazily-built singleton for CommandContext.client(). */
+export function lazyClient() {
+    let cached;
+    return async () => {
+        if (!cached) {
+            cached = new HyperCLI({
+                apiKey: getApiKey(),
+                agentApiKey: getAgentApiKey(),
+                apiUrl: getApiUrl(),
+            });
+        }
+        return cached;
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,QAAQ,EACR,cAAc,EACd,SAAS,EACT,SAAS,GACV,MAAM,mBAAmB,CAAC;AAE3B,0DAA0D;AAC1D,MAAM,UAAU,UAAU;IACxB,IAAI,MAA4B,CAAC;IACjC,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,QAAQ,CAAC;gBACpB,MAAM,EAAE,SAAS,EAAE;gBACnB,WAAW,EAAE,cAAc,EAAE;gBAC7B,MAAM,EAAE,SAAS,EAAE;aACpB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/config-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CLI config file ($HYPER_HOME/config or ~/.hypercli/config).
+ *
+ * HYPER_API_KEY, HYPER_API_BASE and HYPER_AGENTS_API_BASE are honored. HYPER_HOME is used
+ * verbatim (no tilde expansion), matching the rs and py SDKs, and retired
+ * legacy override keys are scrubbed at save time so stale persisted values
+ * cannot shadow the selected bases.
+ */
+export declare function cliConfigDir(): string;
+export declare function cliConfigFile(): string;
+export declare function loadCliConfigFile(): Record<string, string>;
+export declare function applyCliConfigFile(): void;
+export declare function saveCliConfig(apiKey: string, apiBase?: string): void;

package/dist/core/config-file.js

@@ -0,0 +1,79 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * CLI config file ($HYPER_HOME/config or ~/.hypercli/config).
+ *
+ * HYPER_API_KEY, HYPER_API_BASE and HYPER_AGENTS_API_BASE are honored. HYPER_HOME is used
+ * verbatim (no tilde expansion), matching the rs and py SDKs, and retired
+ * legacy override keys are scrubbed at save time so stale persisted values
+ * cannot shadow the selected bases.
+ */
+export function cliConfigDir() {
+    const hyperHome = process.env.HYPER_HOME?.trim();
+    return hyperHome || join(homedir(), '.hypercli');
+}
+export function cliConfigFile() {
+    return join(cliConfigDir(), 'config');
+}
+function parseConfigValue(value) {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+export function loadCliConfigFile() {
+    const config = {};
+    const path = cliConfigFile();
+    if (!existsSync(path))
+        return config;
+    for (const line of readFileSync(path, 'utf8').split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#') || !trimmed.includes('='))
+            continue;
+        const normalized = trimmed.startsWith('export ') ? trimmed.slice('export '.length).trim() : trimmed;
+        const [key, ...valueParts] = normalized.split('=');
+        config[key.trim()] = parseConfigValue(valueParts.join('='));
+    }
+    return config;
+}
+export function applyCliConfigFile() {
+    const config = loadCliConfigFile();
+    if (!process.env.HYPER_API_KEY && config.HYPER_API_KEY) {
+        process.env.HYPER_API_KEY = config.HYPER_API_KEY;
+    }
+    if (!process.env.HYPER_API_BASE && config.HYPER_API_BASE) {
+        process.env.HYPER_API_BASE = config.HYPER_API_BASE;
+    }
+    if (!process.env.HYPER_AGENTS_API_BASE && config.HYPER_AGENTS_API_BASE) {
+        process.env.HYPER_AGENTS_API_BASE = config.HYPER_AGENTS_API_BASE;
+    }
+}
+export function saveCliConfig(apiKey, apiBase) {
+    const config = loadCliConfigFile();
+    config.HYPER_API_KEY = apiKey;
+    // Drop retired legacy overrides, preserving both supported base settings.
+    delete config.HYPERCLI_API_KEY;
+    delete config.HYPERCLI_API_URL;
+    delete config.AGENTS_API_BASE_URL;
+    delete config.AGENTS_WS_URL;
+    if (apiBase) {
+        config.HYPER_API_BASE = apiBase;
+    }
+    else if (!config.HYPER_API_BASE) {
+        delete config.HYPER_API_BASE;
+    }
+    const dir = cliConfigDir();
+    const path = cliConfigFile();
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(path, Object.entries(config).map(([key, value]) => `${key}=${value}`).join('\n') + '\n');
+    try {
+        chmodSync(path, 0o600);
+    }
+    catch {
+        // Some platforms do not support POSIX permissions.
+    }
+}
+//# sourceMappingURL=config-file.js.map

package/dist/core/config-file.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI errors and exit-code mapping.
+ *
+ * Exit codes (non-negotiable):
+ *   0   success
+ *   1   generic error (default)
+ *   2   usage error (bad flags / bad arguments) — throw UsageError
+ *   130 SIGINT (Ctrl+C) — handled by the entrypoint
+ *
+ * All errors print `error: <message>` to stderr, nothing to stdout.
+ */
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare class UsageError extends CliError {
+    constructor(message: string);
+}
+/** Print an error to stderr in the canonical `error: <message>` form. */
+export declare function printError(err: unknown): void;
+/** Map any thrown value to a process exit code. */
+export declare function exitCodeFor(err: unknown): number;

package/dist/core/errors.js

@@ -0,0 +1,37 @@
+/**
+ * CLI errors and exit-code mapping.
+ *
+ * Exit codes (non-negotiable):
+ *   0   success
+ *   1   generic error (default)
+ *   2   usage error (bad flags / bad arguments) — throw UsageError
+ *   130 SIGINT (Ctrl+C) — handled by the entrypoint
+ *
+ * All errors print `error: <message>` to stderr, nothing to stdout.
+ */
+export class CliError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = 'CliError';
+        this.exitCode = exitCode;
+    }
+}
+export class UsageError extends CliError {
+    constructor(message) {
+        super(message, 2);
+        this.name = 'UsageError';
+    }
+}
+/** Print an error to stderr in the canonical `error: <message>` form. */
+export function printError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`error: ${message}\n`);
+}
+/** Map any thrown value to a process exit code. */
+export function exitCodeFor(err) {
+    if (err instanceof CliError)
+        return err.exitCode;
+    return 1;
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,QAAQ,CAAS;IAE1B,YAAY,OAAe,EAAE,QAAQ,GAAG,CAAC;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,GAAG,YAAY,QAAQ;QAAE,OAAO,GAAG,CAAC,QAAQ,CAAC;IACjD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/core/help.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Root and group help rendering, driven by the registry.
+ */
+import type { CommandGroup } from './types.js';
+export declare function renderRootHelp(groups: readonly CommandGroup[]): string;
+export declare function renderGroupHelp(group: CommandGroup): string;
+/**
+ * Closest match for an unknown group name: shortest candidate that starts
+ * with the input, else the shortest candidate containing it. Anything else
+ * gets no suggestion — with only a handful of groups, fuzzy edit-distance
+ * guesses are more misleading than helpful.
+ */
+export declare function closestMatch(input: string, candidates: readonly string[]): string | undefined;

package/dist/core/help.js

@@ -0,0 +1,55 @@
+/**
+ * Root and group help rendering, driven by the registry.
+ */
+import { formatTable } from './table.js';
+const UNIVERSAL_HELP = `\
+Universal flags:
+  --json            machine output: single JSON value on stdout
+  --output, -o FMT  'table' (default) or 'json'
+  --help, -h        show help`;
+export function renderRootHelp(groups) {
+    const lines = [
+        'hyper — HyperCLI command line',
+        '',
+        'Usage:',
+        '  hyper <group> <command> [flags]',
+        '  hyper <command> [flags]',
+        '',
+        'Commands:',
+        formatTable(['GROUP', 'DESCRIPTION'], groups.map((g) => [g.name, g.summary])),
+        '',
+        UNIVERSAL_HELP,
+        '',
+        "Run 'hyper <group> --help' for command-level help.",
+    ];
+    return lines.join('\n');
+}
+export function renderGroupHelp(group) {
+    const lines = [
+        `hyper ${group.name} — ${group.summary}`,
+        '',
+        'Usage:',
+        ...group.usage.map((u) => `  ${u}`),
+        '',
+        UNIVERSAL_HELP,
+    ];
+    return lines.join('\n');
+}
+/**
+ * Closest match for an unknown group name: shortest candidate that starts
+ * with the input, else the shortest candidate containing it. Anything else
+ * gets no suggestion — with only a handful of groups, fuzzy edit-distance
+ * guesses are more misleading than helpful.
+ */
+export function closestMatch(input, candidates) {
+    const query = input.toLowerCase();
+    if (!query)
+        return undefined;
+    const byLength = (a, b) => a.length - b.length;
+    const prefix = candidates.filter((c) => c.toLowerCase().startsWith(query)).sort(byLength);
+    if (prefix.length > 0)
+        return prefix[0];
+    const containing = candidates.filter((c) => c.toLowerCase().includes(query)).sort(byLength);
+    return containing[0];
+}
+//# sourceMappingURL=help.js.map

package/dist/core/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/core/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,MAAM,cAAc,GAAG;;;;8BAIO,CAAC;AAE/B,MAAM,UAAU,cAAc,CAAC,MAA+B;IAC5D,MAAM,KAAK,GAAG;QACZ,+BAA+B;QAC/B,EAAE;QACF,QAAQ;QACR,mCAAmC;QACnC,2BAA2B;QAC3B,EAAE;QACF,WAAW;QACX,WAAW,CACT,CAAC,OAAO,EAAE,aAAa,CAAC,EACxB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CACvC;QACD,EAAE;QACF,cAAc;QACd,EAAE;QACF,oDAAoD;KACrD,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,MAAM,KAAK,GAAG;QACZ,SAAS,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE;QACxC,EAAE;QACF,QAAQ;QACR,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,EAAE;QACF,cAAc;KACf,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAA6B;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1F,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5F,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/core/integrations-mcp.d.ts

@@ -0,0 +1,2 @@
+import type { CommandContext } from './types.js';
+export declare function runIntegrationsMcp(ctx: CommandContext, args: string[]): Promise<number | void>;

package/dist/core/integrations-mcp.js

@@ -0,0 +1,115 @@
+import { deriveIntegrationsApiBase } from '@hypercli.com/sdk';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { APP_VERSION } from '../version.js';
+import { parseCommandArgs } from './argv.js';
+import { CliError, UsageError } from './errors.js';
+const HELP = `hyper integrations --mcp [--json]
+  List server tool names and descriptions; --json includes full input schemas.
+hyper integrations --mcp <tool> --help [--json]
+  Fetch a tool's description and input schema (requires authentication).
+hyper integrations --mcp <tool> [--args JSON] [--json]
+  Invoke a tool with a JSON object (defaults to {}). Server permissions apply.
+  --json returns the complete MCP result; tool errors exit with status 1.
+  Uses the same credentials and HYPER_AGENTS_API_BASE (or HYPER_API_BASE fallback) as integrations REST.`;
+export async function runIntegrationsMcp(ctx, args) {
+    const parsed = parseCommandArgs(args, { mcp: { type: 'boolean' }, args: { type: 'string' } });
+    const [name, extra] = parsed.positionals;
+    if (extra !== undefined)
+        throw new UsageError('expected at most one MCP tool name');
+    if (parsed.values.args !== undefined && !name)
+        throw new UsageError('--args requires an MCP tool name');
+    if (parsed.help && !name) {
+        ctx.output.result({ help: HELP }, HELP);
+        return;
+    }
+    let toolArgs = {};
+    if (typeof parsed.values.args === 'string') {
+        try {
+            const value = JSON.parse(parsed.values.args);
+            if (value === null || typeof value !== 'object' || Array.isArray(value))
+                throw new Error();
+            toolArgs = value;
+        }
+        catch {
+            // Do not echo arguments: they may contain provider credentials.
+            throw new UsageError('--args must be a valid JSON object');
+        }
+    }
+    const resolved = await ctx.client();
+    const client = new Client({ name: 'hyper-cli', version: APP_VERSION });
+    let transport;
+    let action = 'connect to integrations MCP';
+    try {
+        // Same base resolution as lazyClient -> HyperCLI.integrations. Reuse the
+        // resolved key rather than introducing a separate credential precedence.
+        const base = deriveIntegrationsApiBase(resolved.deployments.agentApiBase);
+        transport = new StreamableHTTPClientTransport(new URL(`${base}/mcp`), {
+            requestInit: { headers: { Authorization: `Bearer ${resolved.apiKey}` } },
+        });
+        await client.connect(transport);
+        action = 'list integrations MCP tools';
+        const tools = [];
+        const cursors = new Set();
+        let cursor;
+        do {
+            const page = await client.listTools(cursor === undefined ? undefined : { cursor });
+            tools.push(...page.tools);
+            cursor = page.nextCursor;
+            if (cursor !== undefined) {
+                if (cursors.has(cursor))
+                    throw new CliError('integrations MCP returned a repeated pagination cursor');
+                cursors.add(cursor);
+            }
+        } while (cursor !== undefined);
+        if (!name) {
+            ctx.output.result(tools, {
+                columns: ['NAME', 'DESCRIPTION'],
+                rows: tools.map((tool) => [tool.name, tool.description ?? '']),
+            });
+            return;
+        }
+        const tool = tools.find((entry) => entry.name === name);
+        if (!tool)
+            throw new UsageError('unknown MCP tool; run hyper integrations --mcp to list available tools');
+        if (parsed.help) {
+            ctx.output.result(tool, [
+                `hyper integrations --mcp ${tool.name} --args JSON`,
+                tool.description ?? '',
+                'Arguments (inputSchema):',
+                JSON.stringify(tool.inputSchema, null, 2),
+            ].join('\n'));
+            return;
+        }
+        action = 'call integrations MCP tool';
+        const result = await client.callTool({ name, arguments: toolArgs }, undefined, { timeout: 90000 });
+        // Preserve all content blocks and structuredContent in either output mode.
+        // A server error can echo the request credential; never print that key.
+        const safeResult = result.isError
+            ? JSON.parse(JSON.stringify(result).split(resolved.apiKey).join('[REDACTED]'))
+            : result;
+        ctx.output.result(safeResult, JSON.stringify(safeResult, null, 2));
+        return result.isError ? 1 : 0;
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        // SDK/HTTP exceptions can embed response bodies, URLs or auth headers.
+        throw new CliError(`failed to ${action}; check credentials, base URL and server availability`);
+    }
+    finally {
+        try {
+            await client.close();
+        }
+        catch {
+            ctx.output.info('warning: failed to close integrations MCP client');
+        }
+        finally {
+            // Also cover partial connect failures before the client owns transport.
+            await transport?.close().catch(() => {
+                ctx.output.info('warning: failed to close integrations MCP transport');
+            });
+        }
+    }
+}
+//# sourceMappingURL=integrations-mcp.js.map

package/dist/core/integrations-mcp.js.map

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

package/dist/core/output.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Output discipline:
+ *
+ * - JSON mode: stdout receives exactly one `JSON.stringify` of the result
+ *   plus a trailing newline. Nothing else may be written to stdout; progress
+ *   and diagnostics go to stderr via `output.info()`.
+ * - Table mode: human-readable aligned columns (see core/table.ts). Commands
+ *   must pass an explicit TableData or a preformatted string; there is no
+ *   auto-rendering of raw data.
+ */
+export type OutputFormat = 'table' | 'json';
+export interface TableData {
+    columns: string[];
+    rows: unknown[][];
+}
+export interface Output {
+    readonly format: OutputFormat;
+    /**
+     * Emit the command's result.
+     * - json:  writes `JSON.stringify(data)` + '\n' to stdout. `table` ignored.
+     * - table: writes the rendered table/string to stdout. In table mode you
+     *   MUST pass `table` (TableData or preformatted string); without it the
+     *   data is not rendered, only surfaced in JSON mode.
+     */
+    result(data: unknown, table?: TableData | string): void;
+    /** Progress / diagnostic message to stderr. Never stdout. */
+    info(message: string): void;
+}
+export declare function createOutput(format: OutputFormat): Output;

package/dist/core/output.js

@@ -0,0 +1,34 @@
+/**
+ * Output discipline:
+ *
+ * - JSON mode: stdout receives exactly one `JSON.stringify` of the result
+ *   plus a trailing newline. Nothing else may be written to stdout; progress
+ *   and diagnostics go to stderr via `output.info()`.
+ * - Table mode: human-readable aligned columns (see core/table.ts). Commands
+ *   must pass an explicit TableData or a preformatted string; there is no
+ *   auto-rendering of raw data.
+ */
+import { formatTable } from './table.js';
+export function createOutput(format) {
+    return {
+        format,
+        result(data, table) {
+            if (format === 'json') {
+                process.stdout.write(`${JSON.stringify(data)}\n`);
+                return;
+            }
+            const text = typeof table === 'string'
+                ? table
+                : table
+                    ? formatTable(table.columns, table.rows)
+                    : undefined;
+            if (!text)
+                return;
+            process.stdout.write(text.endsWith('\n') ? text : `${text}\n`);
+        },
+        info(message) {
+            process.stderr.write(`${message}\n`);
+        },
+    };
+}
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAyBzC,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO;QACL,MAAM;QACN,MAAM,CAAC,IAAa,EAAE,KAA0B;YAC9C,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ;gBACvB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,KAAK;oBACL,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC;oBACxC,CAAC,CAAC,SAAS,CAAC;YAClB,IAAI,CAAC,IAAI;gBAAE,OAAO;YAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,OAAe;YAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/skills-runtime.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Bundled-skills runtime.
+ *
+ * scripts/build-skills.mjs compiles the allowlisted skills into
+ * <pkg>/skills/: one <name>.json per skill (full record, markdown
+ * included) and an index.json with { skills: [{ name, description,
+ * commands }] } in display order.
+ *
+ * index.json is the single source of truth for listSkills() and name
+ * resolution — the skills directory is never scanned, so the build-time
+ * allowlist fully controls what `hyper skills` can see. getSkill()
+ * resolves an exact name or an unambiguous case-insensitive prefix against
+ * the index, then loads <name>.json for the full markdown record; failures
+ * list candidate skill names on the error.
+ */
+export interface SkillIndexEntry {
+    name: string;
+    description: string;
+    commands: string[];
+}
+export interface BundledSkill extends SkillIndexEntry {
+    markdown: string;
+}
+/** Resolve the generated catalog relative to the installed CLI artifact. */
+export declare function skillsDir(): string;
+/**
+ * Index entries in display order. Empty when the dir or index is missing
+ * or corrupt.
+ */
+export declare function listSkills(dir?: string): SkillIndexEntry[];
+/**
+ * Resolve a name or unambiguous prefix against candidate names.
+ * Returns the matched name, or throws CliError listing candidates.
+ */
+export declare function resolveSkillName(nameOrPrefix: string, names: readonly string[]): string;
+/** Load one skill by exact name or unambiguous prefix. */
+export declare function getSkill(nameOrPrefix: string, dir?: string): BundledSkill;