@samanhappy/mcphub 1.0.0 → 1.0.2

package/dist/cli/commands/keys.js

@@ -0,0 +1,91 @@
+import { CliUsageError } from '../errors.js';
+import { buildClient, resolveTarget } from '../context.js';
+import { extractFlags } from '../parse-args.js';
+import { green, maskToken, printJson, printLine, printTable } from '../output.js';
+const VALID_ACCESS_TYPES = ['all', 'groups', 'servers', 'custom'];
+export async function run(args, globals, deps = {}) {
+    const sub = args.shift();
+    const client = deps.client ?? buildClient(resolveTarget(globals));
+    switch (sub) {
+        case undefined:
+        case 'list':
+            return list(client, globals);
+        case 'create':
+            return create(client, args, globals);
+        case 'delete':
+            return remove(client, args);
+        default:
+            throw new CliUsageError(`Unknown keys subcommand: ${sub}`);
+    }
+}
+async function list(client, globals) {
+    const res = await client.get('/api/auth/keys');
+    const keys = res.data ?? [];
+    if (globals.json) {
+        // Show the raw token in --json so scripts can capture it. Plaintext only
+        // returns to the user who has admin access to the hub anyway.
+        printJson(keys);
+        return;
+    }
+    printTable(keys.map((k) => ({
+        id: k.id,
+        name: k.name,
+        enabled: k.enabled ? 'yes' : 'no',
+        accessType: k.accessType,
+        token: maskToken(k.token),
+    })), ['id', 'name', 'enabled', 'accessType', 'token']);
+}
+async function create(client, args, globals) {
+    const { flags } = extractFlags(args, {
+        valued: ['--name', '--access-type', '--groups', '--servers', '--token'],
+        boolean: ['--disabled'],
+    });
+    const name = flags['--name'];
+    if (!name) {
+        throw new CliUsageError('Usage: mcphub keys create --name <n> [--access-type all|groups|servers|custom] [--groups a,b] [--servers x,y]');
+    }
+    const accessType = flags['--access-type'] ?? 'all';
+    if (!VALID_ACCESS_TYPES.includes(accessType)) {
+        throw new CliUsageError(`Invalid --access-type: ${accessType}. Expected one of ${VALID_ACCESS_TYPES.join(', ')}`);
+    }
+    const body = {
+        name,
+        enabled: !flags['--disabled'],
+        accessType,
+    };
+    if (flags['--token'])
+        body.token = flags['--token'];
+    if (accessType === 'groups' || accessType === 'custom') {
+        if (flags['--groups'])
+            body.allowedGroups = splitCsv(flags['--groups']);
+    }
+    if (accessType === 'servers' || accessType === 'custom') {
+        if (flags['--servers'])
+            body.allowedServers = splitCsv(flags['--servers']);
+    }
+    const res = await client.post('/api/auth/keys', body);
+    if (globals.json) {
+        printJson(res.data);
+        return;
+    }
+    printLine(green(`Created key "${name}" (id: ${res.data?.id ?? 'unknown'}).`));
+    if (res.data?.token) {
+        // The server generates the token if not supplied. Print it once — admins
+        // need to copy it before navigating away.
+        printLine(`Token: ${res.data.token}`);
+    }
+}
+async function remove(client, args) {
+    const id = args[0];
+    if (!id)
+        throw new CliUsageError('Usage: mcphub keys delete <id>');
+    await client.delete(`/api/auth/keys/${encodeURIComponent(id)}`);
+    printLine(green(`Deleted key ${id}.`));
+}
+function splitCsv(s) {
+    return s
+        .split(',')
+        .map((p) => p.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=keys.js.map

package/dist/cli/commands/keys.js.map

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

package/dist/cli/commands/login.js

@@ -0,0 +1,70 @@
+import { ApiClient } from '../http.js';
+import { CliUsageError } from '../errors.js';
+import { extractFlags } from '../parse-args.js';
+import { loadCredentials, saveCredentials, setProfile, getProfile, } from '../profile.js';
+import { green, yellow, printLine, printWarn } from '../output.js';
+import { promptLine, promptPassword } from '../prompts.js';
+export async function run(args, globals, deps = {}) {
+    const { flags } = extractFlags(args, {
+        valued: ['--url', '--username', '--password', '--profile-name'],
+    });
+    const loadCreds = deps.loadCreds ?? loadCredentials;
+    const saveCreds = deps.saveCreds ?? saveCredentials;
+    const prompts = deps.prompts ?? { line: promptLine, password: promptPassword };
+    const credentials = loadCreds();
+    const targetProfileName = flags['--profile-name'] ||
+        globals.profile ||
+        credentials.current ||
+        'default';
+    const existing = getProfile(credentials, targetProfileName);
+    const url = flags['--url'] ||
+        globals.url ||
+        existing?.url ||
+        (await prompts.line('mcphub URL [http://localhost:3000]: ')) ||
+        'http://localhost:3000';
+    const username = flags['--username'] ||
+        existing?.username ||
+        (await prompts.line('Username [admin]: ')) ||
+        'admin';
+    const password = flags['--password'] || (await prompts.password('Password: '));
+    if (!password) {
+        throw new CliUsageError('Password is required.');
+    }
+    const client = deps.createClient ? deps.createClient(url) : new ApiClient({ baseUrl: url });
+    const response = await client.post('/api/auth/login', { username, password });
+    if (!response || !response.token) {
+        throw new CliUsageError('Login response did not include a token.');
+    }
+    const next = setProfile(credentials, targetProfileName, {
+        url,
+        tokenKind: 'jwt',
+        token: response.token,
+        username: response.user?.username || username,
+    });
+    saveCreds(next);
+    printLine(green(`Logged in as ${response.user?.username || username} at ${url}`));
+    printLine(`Saved as profile "${targetProfileName}".`);
+    if (response.isUsingDefaultPassword) {
+        printWarn('Warning: this account is still using the default password. Change it soon.');
+    }
+}
+export async function logout(args, globals, deps = {}) {
+    const loadCreds = deps.loadCreds ?? loadCredentials;
+    const saveCreds = deps.saveCreds ?? saveCredentials;
+    const credentials = loadCreds();
+    const targetName = globals.profile || credentials.current;
+    if (!targetName || !credentials.profiles[targetName]) {
+        throw new CliUsageError('No active profile to log out from.');
+    }
+    const existing = credentials.profiles[targetName];
+    const next = setProfile(credentials, targetName, {
+        url: existing.url,
+        username: existing.username,
+        // token + tokenKind dropped intentionally
+    });
+    saveCreds(next);
+    printLine(yellow(`Cleared token for profile "${targetName}".`));
+    // Silence unused-arg warning while keeping the signature consistent.
+    void args;
+}
+//# sourceMappingURL=login.js.map

package/dist/cli/commands/login.js.map

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

package/dist/cli/commands/servers.js

@@ -0,0 +1,142 @@
+import fs from 'node:fs';
+import { CliUsageError } from '../errors.js';
+import { buildClient, resolveTarget } from '../context.js';
+import { extractFlags } from '../parse-args.js';
+import { green, printJson, printLine, printTable } from '../output.js';
+export async function run(args, globals, deps = {}) {
+    const sub = args.shift();
+    const client = deps.client ?? buildClient(resolveTarget(globals));
+    switch (sub) {
+        case undefined:
+        case 'list':
+            return list(client, globals);
+        case 'get':
+            return get(client, args, globals);
+        case 'add':
+            return add(client, args, globals, deps);
+        case 'remove':
+            return remove(client, args);
+        case 'toggle':
+            return toggle(client, args);
+        case 'reload':
+            return reload(client, args);
+        default:
+            throw new CliUsageError(`Unknown servers subcommand: ${sub}`);
+    }
+}
+async function list(client, globals) {
+    const res = await client.get('/api/servers');
+    const servers = res.data ?? [];
+    if (globals.json) {
+        printJson(servers);
+        return;
+    }
+    printTable(servers.map((s) => ({
+        name: s.name,
+        status: s.status,
+        tools: s.tools?.length ?? 0,
+        owner: s.owner ?? '',
+        error: s.error ?? '',
+    })), ['name', 'status', 'tools', 'owner', 'error']);
+}
+async function get(client, args, globals) {
+    const name = args[0];
+    if (!name)
+        throw new CliUsageError('Usage: mcphub servers get <name>');
+    const res = await client.get(`/api/servers/${encodeURIComponent(name)}`);
+    if (globals.json) {
+        printJson(res.data);
+        return;
+    }
+    printLine(JSON.stringify(res.data, null, 2));
+}
+async function add(client, args, globals, deps) {
+    const { positional, flags } = extractFlags(args, {
+        valued: ['--from-file', '--type', '--command', '--url', '--description'],
+        boolean: ['--enabled', '--disabled'],
+    });
+    const name = positional[0];
+    if (!name) {
+        throw new CliUsageError('Usage: mcphub servers add <name> --from-file <path>\n' +
+            '   or  mcphub servers add <name> --type <stdio|sse|streamable-http|openapi> [--command ...] [--arg ...] [--env K=V ...]');
+    }
+    let config;
+    if (flags['--from-file']) {
+        const path = flags['--from-file'];
+        const raw = (deps.fs ?? fs).readFileSync(path, 'utf8');
+        config = JSON.parse(raw);
+    }
+    else {
+        const argArgs = collectRepeated(args, '--arg');
+        const envEntries = collectRepeated(args, '--env').map((kv) => {
+            const idx = kv.indexOf('=');
+            if (idx < 0)
+                throw new CliUsageError(`--env expects KEY=VALUE, got: ${kv}`);
+            return [kv.slice(0, idx), kv.slice(idx + 1)];
+        });
+        config = {
+            type: flags['--type'] || 'stdio',
+            description: flags['--description'],
+            command: flags['--command'],
+            args: argArgs.length > 0 ? argArgs : undefined,
+            env: envEntries.length > 0 ? Object.fromEntries(envEntries) : undefined,
+            url: flags['--url'],
+            enabled: flags['--disabled'] ? false : true,
+        };
+    }
+    const res = await client.post('/api/servers', { name, config });
+    if (globals.json) {
+        printJson(res);
+        return;
+    }
+    printLine(green(`Added server "${name}".`));
+}
+async function remove(client, args) {
+    const name = args[0];
+    if (!name)
+        throw new CliUsageError('Usage: mcphub servers remove <name>');
+    await client.delete(`/api/servers/${encodeURIComponent(name)}`);
+    printLine(green(`Removed server "${name}".`));
+}
+async function toggle(client, args) {
+    const { positional, flags } = extractFlags(args, { boolean: ['--on', '--off'] });
+    const name = positional[0];
+    if (!name)
+        throw new CliUsageError('Usage: mcphub servers toggle <name> [--on|--off]');
+    const body = {};
+    if (flags['--on'])
+        body.enabled = true;
+    if (flags['--off'])
+        body.enabled = false;
+    await client.post(`/api/servers/${encodeURIComponent(name)}/toggle`, body);
+    printLine(green(`Toggled server "${name}".`));
+}
+async function reload(client, args) {
+    const name = args[0];
+    if (!name)
+        throw new CliUsageError('Usage: mcphub servers reload <name>');
+    await client.post(`/api/servers/${encodeURIComponent(name)}/reload`, {});
+    printLine(green(`Reloaded server "${name}".`));
+}
+// Helper: pull every occurrence of `--flag <value>` out of argv. extractFlags
+// only captures the last occurrence, so repeated flags need this scan. Values
+// may legitimately start with `--` (e.g. `--arg --version` for a wrapped CLI);
+// we consume them unconditionally and skip the next index so we don't re-scan
+// the value as another flag boundary.
+function collectRepeated(argv, flag) {
+    const out = [];
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === flag) {
+            const v = argv[i + 1];
+            if (v !== undefined) {
+                out.push(v);
+                i++;
+            }
+        }
+        else if (argv[i].startsWith(`${flag}=`)) {
+            out.push(argv[i].slice(flag.length + 1));
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=servers.js.map

package/dist/cli/commands/servers.js.map

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

package/dist/cli/commands/tools.js

@@ -0,0 +1,162 @@
+import { CliUsageError } from '../errors.js';
+import { buildClient, resolveTarget } from '../context.js';
+import { extractFlags } from '../parse-args.js';
+import { bold, dim, printJson, printLine, printTable } from '../output.js';
+// `tools` is the agent-friendly index for `call`: it answers "what can I call,
+// what params does it take, where does it live" in one place, without making
+// callers post-process `servers list` responses.
+export async function run(args, globals, deps = {}) {
+    const sub = args.shift();
+    const client = deps.client ?? buildClient(resolveTarget(globals));
+    switch (sub) {
+        case undefined:
+        case 'list':
+            return list(client, args, globals);
+        case 'get':
+        case 'schema':
+            return get(client, args, globals);
+        default:
+            throw new CliUsageError(`Unknown tools subcommand: ${sub}`);
+    }
+}
+async function fetchFlatTools(client) {
+    const res = await client.get('/api/servers');
+    const servers = res.data ?? [];
+    const out = [];
+    for (const s of servers) {
+        for (const t of (s.tools ?? [])) {
+            out.push({
+                server: s.name,
+                serverStatus: s.status,
+                name: t.name,
+                description: t.description,
+                enabled: t.enabled,
+                inputSchema: t.inputSchema,
+            });
+        }
+    }
+    return out;
+}
+async function list(client, args, globals) {
+    const { flags } = extractFlags(args, {
+        valued: ['--server'],
+        boolean: ['--schema', '--enabled-only'],
+    });
+    let tools = await fetchFlatTools(client);
+    if (flags['--server']) {
+        const wanted = String(flags['--server']);
+        tools = tools.filter((t) => t.server === wanted);
+    }
+    if (flags['--enabled-only']) {
+        tools = tools.filter((t) => t.enabled !== false);
+    }
+    if (globals.json) {
+        if (!flags['--schema']) {
+            // Drop inputSchema by default to keep the JSON small; callers can opt in.
+            printJson(tools.map(({ inputSchema: _omit, ...rest }) => rest));
+        }
+        else {
+            printJson(tools);
+        }
+        return;
+    }
+    if (tools.length === 0) {
+        printLine(dim('(no tools)'));
+        return;
+    }
+    printTable(tools.map((t) => ({
+        server: t.server,
+        tool: t.name,
+        enabled: t.enabled === false ? 'no' : 'yes',
+        description: truncate(t.description ?? '', 60),
+    })), ['server', 'tool', 'enabled', 'description']);
+    printLine(dim(`\nUse \`mcphub tools get <tool> [--server <name>]\` to see input schema and required params.`));
+}
+async function get(client, args, globals) {
+    const { positional, flags } = extractFlags(args, { valued: ['--server'] });
+    const name = positional[0];
+    if (!name) {
+        throw new CliUsageError('Usage: mcphub tools get <tool-name> [--server <server-name>]');
+    }
+    const wantedServer = flags['--server'];
+    const matches = (await fetchFlatTools(client)).filter((t) => t.name === name && (!wantedServer || t.server === wantedServer));
+    if (matches.length === 0) {
+        throw new CliUsageError(wantedServer
+            ? `Tool "${name}" not found on server "${wantedServer}". Run \`mcphub tools list\` to see what's available.`
+            : `Tool "${name}" not found. Run \`mcphub tools list\` to see what's available.`);
+    }
+    if (matches.length > 1 && !wantedServer) {
+        const hosts = matches.map((m) => m.server).join(', ');
+        throw new CliUsageError(`Tool "${name}" exists on multiple servers (${hosts}). Pass --server <name> to pick one.`);
+    }
+    const tool = matches[0];
+    if (globals.json) {
+        printJson(tool);
+        return;
+    }
+    const schema = tool.inputSchema;
+    const required = new Set(schema?.required ?? []);
+    const props = schema?.properties ?? {};
+    printLine(`${bold('Server:')}      ${tool.server} (${tool.serverStatus})`);
+    printLine(`${bold('Tool:')}        ${tool.name}`);
+    if (tool.description) {
+        printLine(`${bold('Description:')} ${tool.description}`);
+    }
+    if (tool.enabled === false) {
+        printLine(dim('(disabled — calls will fail until re-enabled)'));
+    }
+    printLine('');
+    if (Object.keys(props).length === 0) {
+        printLine(dim('No documented parameters.'));
+    }
+    else {
+        printLine(bold('Parameters:'));
+        const rows = Object.entries(props).map(([key, p]) => ({
+            param: key,
+            type: typeof p === 'object' && p ? p.type ?? '' : '',
+            required: required.has(key) ? 'yes' : 'no',
+            description: truncate(typeof p === 'object' && p ? p.description ?? '' : '', 60),
+        }));
+        printTable(rows, ['param', 'type', 'required', 'description']);
+    }
+    printLine('');
+    printLine(bold('Input schema (JSON):'));
+    printLine(JSON.stringify(tool.inputSchema ?? {}, null, 2));
+    printLine('');
+    printLine(bold('Example:'));
+    const example = buildExample(tool, required, props);
+    printLine(`  ${example}`);
+}
+function buildExample(tool, required, props) {
+    const sample = (type) => {
+        switch (type) {
+            case 'number':
+            case 'integer':
+                return '0';
+            case 'boolean':
+                return 'true';
+            case 'array':
+                return '[]';
+            case 'object':
+                return '{}';
+            default:
+                return '<value>';
+        }
+    };
+    const parts = ['mcphub', 'call', tool.name];
+    // Show required params first, with a hint at the type. Optional params are
+    // intentionally omitted so the example is the minimum-viable call.
+    const reqKeys = Array.from(required);
+    for (const key of reqKeys) {
+        const p = props[key];
+        parts.push(`${key}=${sample(typeof p === 'object' && p ? p.type : undefined)}`);
+    }
+    parts.push(`--server`, tool.server);
+    return parts.join(' ');
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1) + '…';
+}
+//# sourceMappingURL=tools.js.map

package/dist/cli/commands/tools.js.map

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

package/dist/cli/context.js

@@ -0,0 +1,44 @@
+import { ApiClient } from './http.js';
+import { CliUsageError } from './errors.js';
+import { getProfile, loadCredentials, } from './profile.js';
+// Resolve where requests should go and what token to use, in this order:
+// 1. CLI flags (--url / --token / --bearer)
+// 2. Environment variables (MCPHUB_URL / MCPHUB_TOKEN / MCPHUB_TOKEN_KIND)
+// 3. Active profile in credentials.json (--profile <name> or current)
+// Commands that only need a URL (e.g. discover) call resolveTargetForPublic()
+// instead, which doesn't require a token.
+export function resolveTarget(globals, creds) {
+    const credentials = creds ?? loadCredentials();
+    const profile = getProfile(credentials, globals.profile);
+    const baseUrl = globals.url ?? process.env.MCPHUB_URL ?? profile?.url;
+    if (!baseUrl) {
+        throw new CliUsageError('No mcphub URL configured. Use --url <url>, MCPHUB_URL env, or run `mcphub login`.');
+    }
+    const tokenKind = (globals.bearer ? 'bearer' : undefined) ??
+        process.env.MCPHUB_TOKEN_KIND ??
+        profile?.tokenKind ??
+        'jwt';
+    const token = globals.token ?? process.env.MCPHUB_TOKEN ?? profile?.token;
+    if (!token) {
+        throw new CliUsageError('Not logged in. Use --token <token>, MCPHUB_TOKEN env, or run `mcphub login`.');
+    }
+    return { baseUrl, token, tokenKind, profileName: globals.profile ?? credentials.current };
+}
+export function resolveTargetForPublic(globals, remote, creds) {
+    const credentials = creds ?? loadCredentials();
+    const profile = getProfile(credentials, globals.profile);
+    const baseUrl = remote ?? globals.url ?? process.env.MCPHUB_URL ?? profile?.url;
+    if (!baseUrl) {
+        throw new CliUsageError('No mcphub URL configured. Use --remote <url>, --url <url>, MCPHUB_URL env, or run `mcphub login`.');
+    }
+    return { baseUrl };
+}
+export function buildClient(target, fetchImpl) {
+    return new ApiClient({
+        baseUrl: target.baseUrl,
+        token: target.token,
+        tokenKind: target.tokenKind,
+        fetchImpl,
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAEL,UAAU,EACV,eAAe,GAEhB,MAAM,cAAc,CAAC;AAkBtB,yEAAyE;AACzE,4CAA4C;AAC5C,2EAA2E;AAC3E,sEAAsE;AACtE,8EAA8E;AAC9E,0CAA0C;AAE1C,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,KAAmB;IACrE,MAAM,WAAW,GAAG,KAAK,IAAI,eAAe,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAwB,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,EAAE,GAAG,CAAC;IACtE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CACrB,mFAAmF,CACpF,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GACb,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,iBAA2C;QACxD,OAAO,EAAE,SAAS;QAClB,KAAK,CAAC;IACR,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,EAAE,KAAK,CAAC;IAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,aAAa,CACrB,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAoB,EACpB,MAAe,EACf,KAAmB;IAEnB,MAAM,WAAW,GAAG,KAAK,IAAI,eAAe,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,EAAE,GAAG,CAAC;IAChF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CACrB,mGAAmG,CACpG,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAsB,EAAE,SAAwB;IAC1E,OAAO,IAAI,SAAS,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/errors.js

@@ -0,0 +1,19 @@
+// Errors thrown by the CLI layer. Top-level handler in main.ts inspects the
+// constructor (or `requiresLogin` flag) to choose an exit code and decide
+// whether to print remediation hints.
+export class CliUsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CliUsageError';
+    }
+}
+export class CliApiError extends Error {
+    constructor(init) {
+        super(init.message);
+        this.name = 'CliApiError';
+        this.status = init.status;
+        this.body = init.body;
+        this.requiresLogin = init.requiresLogin ?? init.status === 401;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,sCAAsC;AAEtC,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AASD,MAAM,OAAO,WAAY,SAAQ,KAAK;IAKpC,YAAY,IAAqB;QAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IACjE,CAAC;CACF"}