hoolix 0.0.1-beta.19

package/dist/commands/secrets.js

@@ -0,0 +1,293 @@
+/**
+ * hoolix secrets list   <slug>           — show masked credential keys
+ * hoolix secrets set    <slug> <key> [value]  — add or update a credential
+ * hoolix secrets remove <slug> <key>     — delete a credential
+ *
+ * Credentials live in credentials.json (0600) alongside metadata.json.
+ * Values are never printed in full; only masked (first 6 chars … last 6).
+ */
+import { text, password, confirm, isCancel, cancel } from '@clack/prompts';
+import { getServerMetadata } from '../core/registry.js';
+import { ServerNotFoundError } from '../core/errors.js';
+import { logger } from '../core/logger.js';
+import { loadCredentials, updateCredential, removeCredential, maskCredentials, } from '../app/services/credentials.js';
+import { getTemplate } from '../app/services/catalog.js';
+import { printTitle, printSection, printDetails, printCommand, printJson, ui, } from '../ui/format.js';
+// ── Subcommands ───────────────────────────────────────────────────────────────
+async function cmdSecretsList(slug, json) {
+    let meta;
+    try {
+        meta = await getServerMetadata(slug);
+    }
+    catch (e) {
+        const msg = e instanceof ServerNotFoundError
+            ? `Server "${slug}" not found. Run "hoolix list".`
+            : e?.message || String(e);
+        if (json)
+            printJson({ ok: false, slug, error: msg });
+        else
+            logger.error(msg);
+        process.exit(1);
+    }
+    if ((meta.serverKind ?? 'docs-rag') !== 'mcp-server') {
+        const msg = `"${slug}" is a docs-rag server. Secrets management is for mcp-server kind servers only.`;
+        if (json)
+            printJson({ ok: false, slug, error: msg });
+        else
+            logger.error(msg);
+        process.exit(1);
+    }
+    const credentials = await loadCredentials(slug);
+    const templateId = meta.definition?.template?.id;
+    const template = templateId
+        ? await getTemplate(templateId).catch(() => null)
+        : null;
+    const masked = maskCredentials(credentials, template ?? undefined);
+    const credKeys = meta.credentialKeys ?? Object.keys(credentials);
+    if (json) {
+        printJson({
+            ok: true,
+            slug,
+            templateId,
+            credentialKeys: credKeys,
+            credentials: masked,
+        });
+        return;
+    }
+    printTitle('Secrets', `${meta.name} (${slug})`);
+    printDetails([
+        ['Template', templateId ? `${template?.name ?? templateId} (${templateId})` : 'unknown'],
+        ['Kind', 'mcp-server'],
+    ]);
+    console.log('');
+    if (credKeys.length === 0) {
+        console.log(`  ${ui.muted('No credentials stored.')}`);
+        console.log('');
+        if (template?.credentials.length) {
+            printSection('Expected credentials');
+            for (const c of template.credentials) {
+                const envNote = c.envVar ? `  ${ui.muted('env: ' + c.envVar)}` : '';
+                console.log(`  ${ui.accent(c.name)}${c.required ? ' (required)' : ''}  ${c.description}${envNote}`);
+            }
+            console.log('');
+            printCommand(`hoolix secrets set ${slug} ${template.credentials[0]?.name ?? '<key>'} <value>`);
+        }
+        return;
+    }
+    printSection('Stored credentials (values masked)');
+    for (const key of credKeys) {
+        const credDef = template?.credentials.find((c) => c.name === key);
+        const label = credDef?.label ?? key;
+        const maskedVal = masked[key] ?? ui.muted('(missing from credentials.json)');
+        const envNote = credDef?.envVar ? `  ${ui.muted('env: ' + credDef.envVar)}` : '';
+        console.log(`  ${ui.muted(key.padEnd(20))}  ${maskedVal}  ${ui.muted(label)}${envNote}`);
+    }
+    console.log('');
+    printSection('Next');
+    printCommand(`hoolix secrets set ${slug} <key> <new-value>`);
+    printCommand(`hoolix connect ${slug}   (regenerate client config after updating)`);
+    console.log('');
+}
+async function cmdSecretsSet(slug, key, value, json, force) {
+    let meta;
+    try {
+        meta = await getServerMetadata(slug);
+    }
+    catch (e) {
+        const msg = e instanceof ServerNotFoundError
+            ? `Server "${slug}" not found. Run "hoolix list".`
+            : e?.message || String(e);
+        if (json)
+            printJson({ ok: false, slug, error: msg });
+        else
+            logger.error(msg);
+        process.exit(1);
+    }
+    if ((meta.serverKind ?? 'docs-rag') !== 'mcp-server') {
+        const msg = `"${slug}" is a docs-rag server. Secrets management is for mcp-server kind servers only.`;
+        if (json)
+            printJson({ ok: false, slug, error: msg });
+        else
+            logger.error(msg);
+        process.exit(1);
+    }
+    // Resolve value: positional > interactive
+    let resolvedValue = value;
+    if (!resolvedValue) {
+        if (json || force) {
+            const msg = `Value for "${key}" is required. Pass it as the third argument or via --value <v>.`;
+            if (json)
+                printJson({ ok: false, slug, key, error: msg });
+            else
+                logger.error(msg);
+            process.exit(1);
+        }
+        // Interactive: masked input for sensitive credentials
+        const templateId = meta.definition?.template?.id;
+        const template = templateId ? await getTemplate(templateId).catch(() => null) : null;
+        const credDef = template?.credentials.find((c) => c.name === key);
+        const label = credDef?.label ?? key;
+        const hint = credDef?.validationHint ? ` (${credDef.validationHint})` : '';
+        const isSensitive = credDef?.sensitive !== false;
+        const raw = isSensitive
+            ? await password({ message: `New value for ${label}${hint}` })
+            : await text({
+                message: `New value for ${label}${hint}`,
+                placeholder: credDef?.placeholder ?? '',
+                validate: (v) => (v && v.trim().length > 0 ? undefined : `${label} is required`),
+            });
+        if (isCancel(raw)) {
+            cancel('Cancelled');
+            process.exit(0);
+        }
+        resolvedValue = String(raw).trim();
+    }
+    if (!resolvedValue) {
+        if (json)
+            printJson({ ok: false, slug, key, error: 'Value cannot be empty.' });
+        else
+            logger.error('Value cannot be empty.');
+        process.exit(1);
+    }
+    const keys = await updateCredential(slug, key, resolvedValue);
+    // Mask for display
+    const maskedDisplay = resolvedValue.length <= 12
+        ? `${resolvedValue.slice(0, 2)}...`
+        : `${resolvedValue.slice(0, 6)}...${resolvedValue.slice(-6)}`;
+    if (json) {
+        printJson({ ok: true, slug, key, credentialKeys: keys });
+        return;
+    }
+    console.log(`  ${ui.success('✓')} Credential "${key}" updated for "${meta.name}" (${maskedDisplay})`);
+    console.log('');
+    printSection('Next');
+    printCommand(`hoolix connect ${slug}   (regenerate client config — tokens are resolved at connect time)`);
+    printCommand(`hoolix client status     (verify which clients are wired)`);
+    console.log('');
+}
+async function cmdSecretsRemove(slug, key, json, force) {
+    let meta;
+    try {
+        meta = await getServerMetadata(slug);
+    }
+    catch (e) {
+        const msg = e instanceof ServerNotFoundError
+            ? `Server "${slug}" not found.`
+            : e?.message || String(e);
+        if (json)
+            printJson({ ok: false, slug, error: msg });
+        else
+            logger.error(msg);
+        process.exit(1);
+    }
+    if ((meta.serverKind ?? 'docs-rag') !== 'mcp-server') {
+        const msg = `"${slug}" is a docs-rag server. Secrets management is for mcp-server kind servers only.`;
+        if (json)
+            printJson({ ok: false, slug, error: msg });
+        else
+            logger.error(msg);
+        process.exit(1);
+    }
+    // Confirm unless --yes
+    if (!force && !json) {
+        const ok = await confirm({ message: `Remove credential "${key}" from "${meta.name}"?` });
+        if (isCancel(ok) || !ok) {
+            cancel('Cancelled');
+            process.exit(0);
+        }
+    }
+    else if (json && !force) {
+        printJson({ ok: false, slug, key, error: 'Removal requires --yes with --json.' });
+        process.exit(1);
+    }
+    // Warn if removing a required credential
+    const templateId = meta.definition?.template?.id;
+    const template = templateId ? await getTemplate(templateId).catch(() => null) : null;
+    const credDef = template?.credentials.find((c) => c.name === key);
+    if (credDef?.required && !json) {
+        logger.warn(`"${key}" is a required credential for template "${templateId}". The server may not work correctly without it.`);
+    }
+    const existing = await loadCredentials(slug);
+    if (!(key in existing)) {
+        const msg = `Credential "${key}" not found in "${slug}".`;
+        if (json)
+            printJson({ ok: false, slug, key, error: msg });
+        else
+            logger.warn(msg);
+        return;
+    }
+    const remainingKeys = await removeCredential(slug, key);
+    if (json) {
+        printJson({ ok: true, slug, key, credentialKeys: remainingKeys });
+        return;
+    }
+    console.log(`  ${ui.success('✓')} Credential "${key}" removed from "${meta.name}"`);
+    if (remainingKeys.length > 0) {
+        console.log(`  ${ui.muted('Remaining:')} ${remainingKeys.join(', ')}`);
+    }
+    else {
+        console.log(`  ${ui.muted('No credentials remaining.')}`);
+    }
+    console.log('');
+}
+// ── Dispatcher ────────────────────────────────────────────────────────────────
+export async function cmdSecrets(args, json) {
+    // args[0] = 'secrets' | 'secret', args[1] = sub, args[2] = slug, ...
+    const sub = args[1];
+    const force = args.includes('--yes') || args.includes('-y');
+    if (!sub || sub === 'list' || sub === 'ls') {
+        // hoolix secrets list <slug>  OR  hoolix secrets <slug>  (shorthand)
+        const slug = args[2] ?? sub; // allow 'hoolix secrets <slug>' as shorthand for list
+        if (!slug || slug === 'list' || slug === 'ls') {
+            if (json)
+                printJson({ ok: false, error: 'Usage: hoolix secrets list <slug>' });
+            else
+                logger.error('Usage: hoolix secrets list <slug>');
+            process.exit(1);
+        }
+        await cmdSecretsList(slug, json);
+        return;
+    }
+    if (sub === 'set') {
+        const slug = args[2];
+        const key = args[3];
+        // Value can come from positional arg or --value flag
+        const valueIdx = args.indexOf('--value');
+        const value = valueIdx !== -1 && args[valueIdx + 1]
+            ? args[valueIdx + 1]
+            : args[4];
+        if (!slug || !key) {
+            if (json)
+                printJson({ ok: false, error: 'Usage: hoolix secrets set <slug> <key> <value>' });
+            else
+                logger.error('Usage: hoolix secrets set <slug> <key> [value]');
+            process.exit(1);
+        }
+        await cmdSecretsSet(slug, key, value, json, force);
+        return;
+    }
+    if (sub === 'remove' || sub === 'rm' || sub === 'delete') {
+        const slug = args[2];
+        const key = args[3];
+        if (!slug || !key) {
+            if (json)
+                printJson({ ok: false, error: 'Usage: hoolix secrets remove <slug> <key>' });
+            else
+                logger.error('Usage: hoolix secrets remove <slug> <key>');
+            process.exit(1);
+        }
+        await cmdSecretsRemove(slug, key, json, force);
+        return;
+    }
+    // Fallback: treat first unknown arg as slug (shorthand: hoolix secrets <slug>)
+    if (/^[a-z0-9-]+$/.test(sub)) {
+        await cmdSecretsList(sub, json);
+        return;
+    }
+    if (json)
+        printJson({ ok: false, error: `Unknown secrets sub-command "${sub}". Use list, set, or remove.` });
+    else
+        logger.error(`Unknown sub-command "${sub}". Next: hoolix secrets list|set|remove <slug>`);
+    process.exit(1);
+}
+//# sourceMappingURL=secrets.js.map

package/dist/commands/secrets.js.map

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

package/dist/commands/start.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdStart(args: string[], json: boolean): Promise<void>;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAOA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiP3E"}

package/dist/commands/start.js

@@ -0,0 +1,234 @@
+import { getServerMetadata } from '../core/registry.js';
+import { serverManager } from '../process/manager.js';
+import { logger } from '../core/logger.js';
+import { printTitle, printSection, printDetails, printCommand, printJson, ui, } from '../ui/format.js';
+export async function cmdStart(args, json) {
+    const slug = args[1];
+    if (!slug) {
+        if (json)
+            printJson({ ok: false, error: 'Missing slug. Next: pass hoolix start <slug> [--port <n>] [--transport stdio] --json.' });
+        else
+            logger.error('Usage: hoolix start <slug> [--port <n>] [--transport stdio] [--json]');
+        process.exit(1);
+    }
+    // ── mcp-server kind: proxy mode or helpful redirect ──────────────────────
+    const metaEarly = await getServerMetadata(slug).catch(() => null);
+    if (metaEarly?.serverKind === 'mcp-server') {
+        const templateId = metaEarly.definition?.template?.id ?? 'unknown';
+        const isProxy = args.includes('--proxy');
+        if (!isProxy) {
+            // Default: explain stdio model and direct user to connect or --proxy
+            if (json) {
+                printJson({
+                    ok: false,
+                    kind: 'mcp-server',
+                    slug,
+                    error: `"${metaEarly.name}" uses stdio transport (${templateId}). Your MCP client spawns the process — no Hoolix host is needed.`,
+                    next: [`hoolix connect ${slug}`, `hoolix start ${slug} --proxy  (wrap behind HTTP for sharing/remote access)`],
+                });
+            }
+            else {
+                printTitle('Stdio server', `"${metaEarly.name}" (${templateId})`);
+                console.log(`  ${ui.accent('○')} This server uses ${ui.accent('stdio transport')} — your MCP client spawns it on demand.`);
+                console.log(`  ${ui.muted('No Hoolix host process is needed.')}`);
+                console.log('');
+                printSection('Wire it into your client');
+                printCommand(`hoolix connect ${slug}`);
+                printCommand(`hoolix connect ${slug} --client claude-code --yes`);
+                console.log('');
+                console.log(`  ${ui.muted('Proxy mode:')} hoolix start ${slug} --proxy   ${ui.muted('(wrap behind HTTP for sharing / remote access)')}`);
+            }
+            process.exit(0);
+        }
+        // ── Proxy mode: spawn proxy-host wrapping the stdio server ──────────────
+        const portIdx = args.indexOf('--port');
+        const port = parseInt(args[portIdx + 1] || '0', 10) || (3456 + Math.floor(Math.random() * 400));
+        const authKey = metaEarly.authKey;
+        if (!json)
+            printTitle('Starting proxy', `Wrapping "${metaEarly.name}" behind HTTP`);
+        try {
+            const { port: actualPort, pid } = await serverManager.startProxied(slug, { port, authKey });
+            if (json) {
+                printJson({
+                    ok: true,
+                    slug,
+                    name: metaEarly.name,
+                    transport: 'proxy',
+                    mode: 'proxy',
+                    url: `http://127.0.0.1:${actualPort}/mcp`,
+                    port: actualPort,
+                    pid,
+                    mcpServers: {
+                        [slug]: {
+                            type: 'streamable-http',
+                            url: `http://127.0.0.1:${actualPort}/mcp`,
+                            headers: { Authorization: `Bearer ${authKey}` },
+                        },
+                    },
+                    next: [`hoolix connect ${slug} --client cursor --yes`, `hoolix info ${slug}`],
+                });
+                return;
+            }
+            printTitle('Proxy running', `"${metaEarly.name}" is accessible via HTTP.`);
+            printDetails([
+                ['Mode', 'Proxy (stdio → HTTP)'],
+                ['Template', templateId],
+                ['URL', `http://127.0.0.1:${actualPort}/mcp`],
+                ['Auth', `Authorization: Bearer ${authKey}`],
+                ['PID', pid],
+            ]);
+            console.log('');
+            printSection('Client config (streamable-http)');
+            console.log(JSON.stringify({
+                mcpServers: {
+                    [slug]: {
+                        type: 'streamable-http',
+                        url: `http://127.0.0.1:${actualPort}/mcp`,
+                        headers: { Authorization: `Bearer ${authKey}` },
+                    },
+                },
+            }, null, 2));
+            console.log('');
+            printSection('Next steps');
+            printCommand(`hoolix connect ${slug} --client cursor --yes`);
+            printCommand(`curl -s http://127.0.0.1:${actualPort}/health`);
+            console.log(`  ${ui.muted('Tip:')} hoolix stop ${slug}   (stops the proxy process)`);
+        }
+        catch (err) {
+            if (json) {
+                printJson({ ok: false, slug, error: err.message || String(err), next: `Run hoolix doctor --json, then retry.` });
+                process.exit(1);
+            }
+            logger.warn('Could not start proxy host:', err.message);
+            console.log('');
+            printSection('Fallback: wire via stdio instead');
+            printCommand(`hoolix connect ${slug}`);
+        }
+        return;
+    }
+    // ── stdio transport path ─────────────────────────────────────────────────
+    // Runs the MCP server in-process over stdin/stdout (foreground, no spawn).
+    // The MCP client spawns this process; stdout/stdin carry the MCP protocol.
+    // All human-readable output goes to stderr so it doesn't corrupt the stream.
+    const transportIdx = args.indexOf('--transport');
+    const transport = transportIdx !== -1 ? args[transportIdx + 1] : 'http';
+    if (transport === 'stdio') {
+        const meta = await getServerMetadata(slug).catch(() => null);
+        if (!meta) {
+            process.stderr.write(`hoolix error: server "${slug}" not found. Run "hoolix list".\n`);
+            process.exit(1);
+        }
+        // Print the client config snippet to stderr (visible when run manually;
+        // invisible to the MCP protocol which only reads stdout).
+        const clientConfig = {
+            mcpServers: {
+                [slug]: {
+                    command: 'hoolix',
+                    args: ['start', slug, '--transport', 'stdio'],
+                },
+            },
+        };
+        if (json) {
+            printJson({
+                ok: true,
+                slug,
+                name: meta.name,
+                transport: 'stdio',
+                ...clientConfig,
+                next: [`Add this config to your MCP client`, `hoolix verify ${slug} --json`],
+            });
+            return;
+        }
+        process.stderr.write(`\nhoolix › "${meta.name}" starting in stdio mode\n\n`);
+        process.stderr.write('Client config (paste into your MCP client):\n');
+        process.stderr.write(JSON.stringify(clientConfig, null, 2) + '\n\n');
+        process.stderr.write('Tip: hoolix connect ' + slug + ' --client claude  (auto-writes the config above)\n\n');
+        const { startStdioServer } = await import('../mcp/stdio-host.js');
+        await startStdioServer(slug);
+        return; // startStdioServer never resolves; this is defensive
+    }
+    // ── HTTP transport path (default) ────────────────────────────────────────
+    const meta = await getServerMetadata(slug);
+    const portIdx = args.indexOf('--port');
+    const port = parseInt(args[portIdx + 1] || '0', 10) || (3456 + Math.floor(Math.random() * 400));
+    const authKey = meta.authKey;
+    if (!json)
+        printTitle('Starting', `Preparing "${meta.name}"`);
+    try {
+        const { port: actualPort, pid } = await serverManager.start(slug, { port, authKey });
+        if (json) {
+            printJson({
+                ok: true,
+                slug,
+                name: meta.name,
+                transport: 'http',
+                url: `http://127.0.0.1:${actualPort}/mcp`,
+                port: actualPort,
+                pid,
+                mcpServers: {
+                    [slug]: {
+                        type: 'streamable-http',
+                        url: `http://127.0.0.1:${actualPort}/mcp`,
+                        headers: { Authorization: `Bearer ${authKey}` },
+                    },
+                },
+                next: [`hoolix connect ${slug} --client cursor --yes`, `hoolix verify ${slug} --json`],
+            });
+            return;
+        }
+        printTitle('Running', `"${meta.name}" is ready for MCP clients.`);
+        printDetails([
+            ['Transport', 'Streamable HTTP'],
+            ['URL', `http://127.0.0.1:${actualPort}/mcp`],
+            ['Auth', `Authorization: Bearer ${authKey}`],
+            ['PID', pid],
+        ]);
+        console.log('');
+        printSection('Streamable HTTP client config');
+        console.log(JSON.stringify({
+            mcpServers: {
+                [slug]: {
+                    type: 'streamable-http',
+                    url: `http://127.0.0.1:${actualPort}/mcp`,
+                    headers: { Authorization: `Bearer ${authKey}` },
+                },
+            },
+        }, null, 2));
+        console.log('');
+        printSection('stdio client config (Claude Desktop / VS Code)');
+        console.log(JSON.stringify({
+            mcpServers: {
+                [slug]: {
+                    command: 'hoolix',
+                    args: ['start', slug, '--transport', 'stdio'],
+                },
+            },
+        }, null, 2));
+        console.log('');
+        printSection('Quick checks');
+        printCommand(`curl -s http://127.0.0.1:${actualPort}/health`);
+        printCommand(`curl -s -H "Authorization: Bearer ${authKey}" -X POST -d '{}' -H 'content-type: application/json' http://127.0.0.1:${actualPort}/mcp`);
+        console.log('');
+        console.log(`  ${ui.muted('Tip:')} hoolix connect ${slug} --client cursor   (or claude|windsurf|continue|cline|grokbuild|generic; use --project for workspace)`);
+        console.log(`  ${ui.muted('Tip:')} hoolix start ${slug} --transport stdio   (for Claude Desktop / VS Code / stdio clients)`);
+    }
+    catch (err) {
+        if (json) {
+            printJson({
+                ok: false,
+                slug,
+                error: err.message || String(err),
+                next: `Run hoolix doctor --json, then retry hoolix start ${slug} --json.`,
+            });
+            process.exit(1);
+        }
+        logger.warn('Could not automatically start the host process:', err.message);
+        console.log('');
+        printSection('Manual start options');
+        printCommand(`npx tsx src/mcp/host.ts --slug ${slug} --port ${port} --data-dir ".hoolix/servers/${slug}/data" --auth-key ${authKey}`);
+        printCommand(`hoolix start ${slug} --transport stdio`);
+        console.log('');
+        console.log(`  ${ui.muted('Tip:')} hoolix connect ${slug} --client cursor`);
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

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

package/dist/commands/stats.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdStats(args: string[], json: boolean): Promise<void>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/commands/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAgCA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiO3E"}