ysk-omni 1.0.0

package/dist/cli/index.js

@@ -0,0 +1,835 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const commander_1 = require("commander");
+const setup_1 = require("./commands/setup");
+const start_1 = require("./commands/start");
+const stop_1 = require("./commands/stop");
+const restart_1 = require("./commands/restart");
+const status_1 = require("./commands/status");
+const migrate_1 = require("./commands/migrate");
+const seed_1 = require("./commands/seed");
+const doctor_1 = require("./commands/doctor");
+const open_1 = require("./commands/open");
+const version_1 = require("./commands/version");
+const update_1 = require("./commands/update");
+const key_1 = require("./commands/key");
+const admin_panel_1 = require("./commands/admin-panel");
+const admin_otp_1 = require("./commands/admin-otp");
+const admin_sessions_1 = require("./commands/admin-sessions");
+const logs_1 = require("./commands/logs");
+const settings_1 = require("./commands/settings");
+const queue_1 = require("./commands/queue");
+const ddos_1 = require("./commands/ddos");
+const docs_1 = require("./commands/docs");
+const chats_1 = require("./commands/chats");
+const conversations_1 = require("./commands/conversations");
+const audit_1 = require("./commands/audit");
+const stats_1 = require("./commands/stats");
+const catalog_1 = require("./commands/catalog");
+const runtimes_1 = require("./commands/runtimes");
+const api_features_1 = require("./commands/api-features");
+const paths_1 = require("./lib/paths");
+function readPkgVersion() {
+    try {
+        const pkgPath = node_path_1.default.join(__dirname, '../../package.json');
+        const pkg = JSON.parse(node_fs_1.default.readFileSync(pkgPath, 'utf8'));
+        return pkg.version || '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+const program = new commander_1.Command();
+program
+    .name('ysk-omni')
+    .description('YSK Omni gateway controller (alias: ysko)')
+    .option('--home <path>', 'Data home directory (default: ~/.ysk-omni or project root)')
+    .option('--port <n>', `HTTP port (default ${paths_1.DEFAULT_PORT})`, (v) => Number(v))
+    .option('--json', 'Machine-readable JSON output where supported')
+    .version(readPkgVersion(), '-V, --version');
+function globalOpts() {
+    const g = program.opts();
+    return {
+        home: g.home,
+        port: g.port,
+        forceHome: Boolean(g.home),
+        json: Boolean(g.json),
+    };
+}
+program
+    .command('setup')
+    .description('Create data dirs, .env, migrate DB, seed admin key')
+    .action(async () => {
+    await (0, setup_1.cmdSetup)(globalOpts());
+});
+program
+    .command('start')
+    .description(`Start gateway (default port ${paths_1.DEFAULT_PORT}). Use --pm2 to run under PM2.`)
+    .option('-f, --foreground', 'Run in foreground')
+    .option('--pm2', 'Start under PM2 (process manager)')
+    .action(async (opts) => {
+    await (0, start_1.cmdStart)({
+        ...globalOpts(),
+        foreground: opts.foreground,
+        pm2: opts.pm2,
+    });
+});
+program
+    .command('stop')
+    .description('Stop background gateway')
+    .action(async () => {
+    await (0, stop_1.cmdStop)(globalOpts());
+});
+program
+    .command('restart')
+    .description('Restart gateway')
+    .option('-f, --foreground', 'Run in foreground')
+    .option('--pm2', 'Restart under PM2')
+    .action(async (opts) => {
+    await (0, restart_1.cmdRestart)({
+        ...globalOpts(),
+        foreground: opts.foreground,
+        pm2: opts.pm2,
+    });
+});
+program
+    .command('status')
+    .description('Show process + health status')
+    .action(async () => {
+    await (0, status_1.cmdStatus)(globalOpts());
+});
+program
+    .command('migrate')
+    .description('Run prisma migrate deploy')
+    .action(async () => {
+    await (0, migrate_1.cmdMigrate)(globalOpts());
+});
+program
+    .command('seed')
+    .description('Seed bootstrap admin API key (if missing)')
+    .action(async () => {
+    await (0, seed_1.cmdSeed)(globalOpts());
+});
+const keyCmd = program
+    .command('key')
+    .description('Manage API keys (create prints plaintext once)')
+    .action(async () => {
+    // Bare `ysk-omni key` still creates admin (compat) — prefer `key create`
+    const { warn } = await Promise.resolve().then(() => __importStar(require('./lib/print')));
+    warn('Bare `ysk-omni key` creates a new admin key. Prefer: ysk-omni key create [-r admin|client]');
+    await (0, key_1.cmdKeyCreate)({ ...globalOpts(), role: 'admin' });
+});
+keyCmd
+    .command('create')
+    .description('Create API key and print plaintext once (default: admin)')
+    .option('-n, --name <name>', 'Key name')
+    .option('-r, --role <role>', 'admin | client (alias: user → client)', 'admin')
+    .option('-m, --mode <mode>', 'safe | agent (client keys; admin is always agent)', 'safe')
+    .option('--rate-limit <n>', 'Per-key rate limit', (v) => Number(v))
+    .option('--models <ids>', 'Comma-separated model ids this key may use (empty = all)')
+    .action(async (opts) => {
+    await (0, key_1.cmdKeyCreate)({
+        ...globalOpts(),
+        name: opts.name,
+        role: opts.role,
+        mode: opts.mode,
+        rateLimit: opts.rateLimit,
+        models: opts.models,
+    });
+});
+keyCmd
+    .command('list')
+    .description('List API keys (prefix only; plaintext not stored)')
+    .action(async () => {
+    await (0, key_1.cmdKeyList)(globalOpts());
+});
+keyCmd
+    .command('revoke')
+    .description('Revoke (deactivate) an API key by id')
+    .argument('<id>', 'API key id')
+    .action(async (id) => {
+    await (0, key_1.cmdKeyRevoke)({ ...globalOpts(), id });
+});
+keyCmd
+    .command('activate')
+    .description('Re-activate a revoked API key')
+    .argument('<id>', 'API key id')
+    .action(async (id) => {
+    await (0, key_1.cmdKeyActivate)({ ...globalOpts(), id });
+});
+keyCmd
+    .command('show')
+    .description('Show public fields for an API key')
+    .argument('<id>', 'API key id')
+    .action(async (id) => {
+    await (0, key_1.cmdKeyShow)({ ...globalOpts(), id });
+});
+keyCmd
+    .command('update')
+    .description('Update API key fields (name, role, mode, rate, active, models)')
+    .argument('<id>', 'API key id')
+    .option('-n, --name <name>', 'Key name')
+    .option('-r, --role <role>', 'admin | client')
+    .option('-m, --mode <mode>', 'safe | agent')
+    .option('--rate-limit <n>', 'Per-key rate limit', (v) => Number(v))
+    .option('--active <on|off>', 'Active flag')
+    .option('--models <ids>', 'Comma-separated model ids this key may use (empty = all)')
+    .action(async (id, opts) => {
+    await (0, key_1.cmdKeyUpdate)({
+        ...globalOpts(),
+        id,
+        name: opts.name,
+        role: opts.role,
+        mode: opts.mode,
+        rateLimit: opts.rateLimit,
+        active: opts.active,
+        models: opts.models,
+    });
+});
+keyCmd
+    .command('admin')
+    .description('Create a new admin API key (same as: ysk-omni key create)')
+    .option('-n, --name <name>', 'Key name')
+    .action(async (opts) => {
+    await (0, key_1.cmdKeyCreate)({ ...globalOpts(), role: 'admin', name: opts.name });
+});
+const adminCmd = program
+    .command('admin')
+    .description('Enable/disable Admin panel (CLI is the only way to turn it back on)')
+    .action(async () => {
+    await (0, admin_panel_1.cmdAdminStatus)(globalOpts());
+});
+adminCmd
+    .command('status')
+    .description('Show Admin panel on/off status')
+    .action(async () => {
+    await (0, admin_panel_1.cmdAdminStatus)(globalOpts());
+});
+adminCmd
+    .command('on')
+    .description('Enable Admin panel (settings DB)')
+    .action(async () => {
+    await (0, admin_panel_1.cmdAdminOn)(globalOpts());
+});
+adminCmd
+    .command('off')
+    .description('Disable Admin panel (settings DB); re-enable with: ysk-omni admin on')
+    .action(async () => {
+    await (0, admin_panel_1.cmdAdminOff)(globalOpts());
+});
+adminCmd
+    .command('otp')
+    .alias('login-code')
+    .description('Generate a one-time Admin panel login code (5 min, single use). Required for every SPA login.')
+    .action(async () => {
+    await (0, admin_otp_1.cmdAdminOtp)(globalOpts());
+});
+const adminSessionsCmd = adminCmd
+    .command('sessions')
+    .description('List active OTP Admin sessions')
+    .action(async () => {
+    await (0, admin_sessions_1.cmdAdminSessionsList)(globalOpts());
+});
+adminSessionsCmd
+    .command('list')
+    .description('List active OTP Admin sessions')
+    .action(async () => {
+    await (0, admin_sessions_1.cmdAdminSessionsList)(globalOpts());
+});
+adminSessionsCmd
+    .command('revoke')
+    .description('Revoke session by id prefix, or: all | all-expired')
+    .argument('<id>', 'Session id / prefix / all / all-expired')
+    .action(async (id) => {
+    await (0, admin_sessions_1.cmdAdminSessionsRevoke)({ ...globalOpts(), id });
+});
+// ——— Settings (Safety) ———
+const settingsCmd = program
+    .command('settings')
+    .description('Safety / gateway settings (global safe, tools, model)')
+    .action(async () => {
+    await (0, settings_1.cmdSettingsGet)(globalOpts());
+});
+settingsCmd
+    .command('get')
+    .description('Show current settings')
+    .action(async () => {
+    await (0, settings_1.cmdSettingsGet)(globalOpts());
+});
+settingsCmd
+    .command('set')
+    .description('Update safety settings')
+    .option('--global-safe <on|off>', 'Force global safe mode')
+    .option('--tools <none|readonly>', 'Safe tools mode')
+    .option('--max-turns <n>', 'Safe max turns', (v) => Number(v))
+    .option('--timeout-ms <n>', 'Safe timeout ms', (v) => Number(v))
+    .option('--default-model <name>', 'Default model id')
+    .action(async (opts) => {
+    await (0, settings_1.cmdSettingsSet)({ ...globalOpts(), ...opts });
+});
+settingsCmd
+    .command('preset')
+    .description('Apply safety preset: local|prod|code|read|chat|long')
+    .argument('<name>', 'Preset name')
+    .action(async (name) => {
+    await (0, settings_1.cmdSettingsPreset)({ ...globalOpts(), name });
+});
+// ——— Chat queue ———
+const queueCmd = program
+    .command('queue')
+    .description('Chat work queue control (policy, jobs, pause/drain)')
+    .action(async () => {
+    await (0, queue_1.cmdQueueStats)(globalOpts());
+});
+queueCmd
+    .command('stats')
+    .description('Queue depth and job counts by status')
+    .action(async () => {
+    await (0, queue_1.cmdQueueStats)(globalOpts());
+});
+const queuePolicyCmd = queueCmd
+    .command('policy')
+    .description('Queue policy get/set/preset')
+    .action(async () => {
+    await (0, queue_1.cmdQueuePolicyGet)(globalOpts());
+});
+queuePolicyCmd
+    .command('get')
+    .description('Show queue policy')
+    .action(async () => {
+    await (0, queue_1.cmdQueuePolicyGet)(globalOpts());
+});
+queuePolicyCmd
+    .command('set')
+    .description('Update queue policy fields')
+    .option('--enabled <on|off>')
+    .option('--paused <on|off>')
+    .option('--drain-mode <on|off>')
+    .option('--global-concurrency <n>', '', (v) => Number(v))
+    .option('--per-key-concurrency <n>', '', (v) => Number(v))
+    .option('--max-queue-depth <n>', '', (v) => Number(v))
+    .option('--max-queue-depth-per-key <n>', '', (v) => Number(v))
+    .option('--default-priority <n>', '', (v) => Number(v))
+    .option('--playground-priority <n>', '', (v) => Number(v))
+    .option('--lease-ms <n>', '', (v) => Number(v))
+    .option('--max-wait-ms <n>', '', (v) => Number(v))
+    .option('--max-attempts <n>', '', (v) => Number(v))
+    .option('--fairness <fifo_global|weighted_round_robin>')
+    .action(async (opts) => {
+    await (0, queue_1.cmdQueuePolicySet)({
+        ...globalOpts(),
+        ...opts,
+        globalConcurrency: opts.globalConcurrency,
+        perKeyConcurrency: opts.perKeyConcurrency,
+        maxQueueDepth: opts.maxQueueDepth,
+        maxQueueDepthPerKey: opts.maxQueueDepthPerKey,
+        defaultPriority: opts.defaultPriority,
+        playgroundPriority: opts.playgroundPriority,
+        leaseMs: opts.leaseMs,
+        maxWaitMs: opts.maxWaitMs,
+        maxAttempts: opts.maxAttempts,
+        drainMode: opts.drainMode,
+    });
+});
+queuePolicyCmd
+    .command('preset')
+    .description('Apply queue preset: relaxed|balanced|strict')
+    .argument('<name>', 'Preset name')
+    .action(async (name) => {
+    await (0, queue_1.cmdQueuePolicyPreset)({ ...globalOpts(), name });
+});
+queueCmd.command('pause').description('Pause worker claiming').action(async () => {
+    await (0, queue_1.cmdQueuePause)(globalOpts());
+});
+queueCmd.command('resume').description('Resume worker claiming').action(async () => {
+    await (0, queue_1.cmdQueueResume)(globalOpts());
+});
+queueCmd.command('drain').description('Reject new enqueues').action(async () => {
+    await (0, queue_1.cmdQueueDrain)(globalOpts());
+});
+queueCmd.command('undrain').description('Allow new enqueues').action(async () => {
+    await (0, queue_1.cmdQueueUndrain)(globalOpts());
+});
+queueCmd
+    .command('jobs')
+    .description('List jobs')
+    .option('--status <status>', 'Filter status')
+    .option('--limit <n>', 'Limit', (v) => Number(v))
+    .option('--offset <n>', 'Offset', (v) => Number(v))
+    .action(async (opts) => {
+    await (0, queue_1.cmdQueueJobs)({ ...globalOpts(), ...opts });
+});
+queueCmd
+    .command('job')
+    .description('Show one job by id')
+    .argument('<id>', 'Job id')
+    .action(async (id) => {
+    await (0, queue_1.cmdQueueJob)({ ...globalOpts(), id });
+});
+queueCmd
+    .command('cancel')
+    .description('Cancel a queued/running job')
+    .argument('<id>', 'Job id')
+    .action(async (id) => {
+    await (0, queue_1.cmdQueueCancel)({ ...globalOpts(), id });
+});
+queueCmd
+    .command('requeue')
+    .description('Requeue a failed/dead/cancelled job')
+    .argument('<id>', 'Job id')
+    .action(async (id) => {
+    await (0, queue_1.cmdQueueRequeue)({ ...globalOpts(), id });
+});
+queueCmd
+    .command('priority')
+    .description('Set priority on a queued job (lower = sooner)')
+    .argument('<id>', 'Job id')
+    .argument('<priority>', '0–1000', (v) => Number(v))
+    .action(async (id, priority) => {
+    await (0, queue_1.cmdQueuePriority)({ ...globalOpts(), id, priority });
+});
+queueCmd
+    .command('purge-dead')
+    .description('Delete dead/failed/cancelled jobs')
+    .option('-y, --yes', 'Confirm purge')
+    .action(async (opts) => {
+    await (0, queue_1.cmdQueuePurgeDead)({ ...globalOpts(), yes: opts.yes });
+});
+// ——— DDoS ———
+const ddosCmd = program
+    .command('ddos')
+    .description('DDoS policy and IP blacklist')
+    .action(async () => {
+    await (0, ddos_1.cmdDdosSummary)(globalOpts());
+});
+const ddosPolicyCmd = ddosCmd
+    .command('policy')
+    .description('DDoS policy get/set/preset/reset')
+    .action(async () => {
+    await (0, ddos_1.cmdDdosPolicyGet)(globalOpts());
+});
+ddosPolicyCmd
+    .command('get')
+    .description('Show DDoS policy')
+    .action(async () => {
+    await (0, ddos_1.cmdDdosPolicyGet)(globalOpts());
+});
+ddosPolicyCmd
+    .command('set')
+    .description('Update DDoS policy fields')
+    .option('--auto-ban <on|off>')
+    .option('--rate-limit-max <n>', '', (v) => Number(v))
+    .option('--rate-limit-ip-max <n>', '', (v) => Number(v))
+    .option('--chat-burst-max <n>', '', (v) => Number(v))
+    .option('--failed-auth-threshold <n>', '', (v) => Number(v))
+    .option('--rate-hit-threshold <n>', '', (v) => Number(v))
+    .option('--max-concurrent-per-ip <n>', '', (v) => Number(v))
+    .option('--velocity-max-requests <n>', '', (v) => Number(v))
+    .option('--proxy-trust-hops <n>', '', (v) => Number(v))
+    .option('--proxy-ip-source <src>', 'auto|cloudflare|nginx|x-forwarded-for|socket')
+    .action(async (opts) => {
+    await (0, ddos_1.cmdDdosPolicySet)({
+        ...globalOpts(),
+        autoBan: opts.autoBan,
+        rateLimitMax: opts.rateLimitMax,
+        rateLimitIpMax: opts.rateLimitIpMax,
+        chatBurstMax: opts.chatBurstMax,
+        failedAuthThreshold: opts.failedAuthThreshold,
+        rateHitThreshold: opts.rateHitThreshold,
+        maxConcurrentPerIp: opts.maxConcurrentPerIp,
+        velocityMaxRequests: opts.velocityMaxRequests,
+        proxyTrustHops: opts.proxyTrustHops,
+        proxyIpSource: opts.proxyIpSource,
+    });
+});
+ddosPolicyCmd
+    .command('preset')
+    .description('Apply DDoS preset: relaxed|balanced|strict')
+    .argument('<name>', 'Preset name')
+    .action(async (name) => {
+    await (0, ddos_1.cmdDdosPolicyPreset)({ ...globalOpts(), name });
+});
+ddosPolicyCmd
+    .command('reset')
+    .description('Reset DDoS policy to env defaults')
+    .action(async () => {
+    await (0, ddos_1.cmdDdosPolicyReset)(globalOpts());
+});
+ddosCmd
+    .command('ban')
+    .description('Ban an IP')
+    .argument('<ip>', 'IP address')
+    .option('--ttl <seconds>', 'TTL seconds (omit = permanent)', (v) => Number(v))
+    .option('--reason <text>', 'Ban reason')
+    .action(async (ip, opts) => {
+    await (0, ddos_1.cmdDdosBan)({ ...globalOpts(), ip, ttl: opts.ttl, reason: opts.reason });
+});
+ddosCmd
+    .command('unban')
+    .description('Remove IP from blacklist')
+    .argument('<ip>', 'IP address')
+    .action(async (ip) => {
+    await (0, ddos_1.cmdDdosUnban)({ ...globalOpts(), ip });
+});
+ddosCmd
+    .command('blacklist')
+    .description('List active blacklist entries')
+    .action(async () => {
+    await (0, ddos_1.cmdDdosBlacklist)(globalOpts());
+});
+// ——— Documents / chats / conversations / audit ———
+const docsCmd = program
+    .command('docs')
+    .description('Manage stored documents')
+    .action(async () => {
+    await (0, docs_1.cmdDocsList)(globalOpts());
+});
+docsCmd
+    .command('list')
+    .option('--limit <n>', '', (v) => Number(v))
+    .option('--offset <n>', '', (v) => Number(v))
+    .action(async (opts) => {
+    await (0, docs_1.cmdDocsList)({ ...globalOpts(), ...opts });
+});
+docsCmd
+    .command('show')
+    .argument('<id>', 'Document id')
+    .action(async (id) => {
+    await (0, docs_1.cmdDocsShow)({ ...globalOpts(), id });
+});
+docsCmd
+    .command('delete')
+    .argument('<id>', 'Document id')
+    .option('-y, --yes', 'Confirm delete')
+    .action(async (id, opts) => {
+    await (0, docs_1.cmdDocsDelete)({ ...globalOpts(), id, yes: opts.yes });
+});
+const chatsCmd = program
+    .command('chats')
+    .description('List API chat requests (audit log of completions)')
+    .action(async () => {
+    await (0, chats_1.cmdChatsList)(globalOpts());
+});
+chatsCmd
+    .command('list')
+    .option('--status <status>')
+    .option('--limit <n>', '', (v) => Number(v))
+    .option('--offset <n>', '', (v) => Number(v))
+    .action(async (opts) => {
+    await (0, chats_1.cmdChatsList)({ ...globalOpts(), ...opts });
+});
+chatsCmd
+    .command('show')
+    .argument('<id>', 'Chat id or requestId')
+    .action(async (id) => {
+    await (0, chats_1.cmdChatsShow)({ ...globalOpts(), id });
+});
+const convCmd = program
+    .command('conversations')
+    .alias('conv')
+    .description('Playground multi-turn conversation threads')
+    .action(async () => {
+    await (0, conversations_1.cmdConversationsList)(globalOpts());
+});
+convCmd
+    .command('list')
+    .option('--limit <n>', '', (v) => Number(v))
+    .option('--offset <n>', '', (v) => Number(v))
+    .action(async (opts) => {
+    await (0, conversations_1.cmdConversationsList)({ ...globalOpts(), ...opts });
+});
+convCmd
+    .command('delete')
+    .argument('<id>', 'Conversation id')
+    .option('-y, --yes', 'Confirm delete')
+    .action(async (id, opts) => {
+    await (0, conversations_1.cmdConversationsDelete)({ ...globalOpts(), id, yes: opts.yes });
+});
+const auditCmd = program
+    .command('audit')
+    .description('Audit log viewer')
+    .action(async () => {
+    await (0, audit_1.cmdAuditList)(globalOpts());
+});
+auditCmd
+    .command('list')
+    .option('--action <action>', 'Filter by action')
+    .option('--limit <n>', '', (v) => Number(v))
+    .option('--offset <n>', '', (v) => Number(v))
+    .action(async (opts) => {
+    await (0, audit_1.cmdAuditList)({ ...globalOpts(), ...opts });
+});
+program
+    .command('stats')
+    .description('Dashboard-style summary from local DB')
+    .action(async () => {
+    await (0, stats_1.cmdStats)(globalOpts());
+});
+const catalogCmd = program
+    .command('catalog')
+    .description('Local registry + Hub (search, sync popular GGUF ids)')
+    .option('--modality <m>', 'Filter: text|image|video|tts|stt')
+    .action(async (opts) => {
+    await (0, catalog_1.cmdCatalog)({ ...globalOpts(), modality: opts.modality });
+});
+catalogCmd
+    .command('search')
+    .description('Search Hugging Face Hub (runnable runtimes only)')
+    .argument('[q]', 'Search string')
+    .option('--modality <m>', 'text|image|video|tts|stt')
+    .action(async (q, opts) => {
+    await (0, catalog_1.cmdCatalogSearch)({ ...globalOpts(), q, modality: opts.modality });
+});
+catalogCmd
+    .command('sync')
+    .description('Cache top 50 GGUF ids by downloads (metadata only)')
+    .action(async () => {
+    await (0, catalog_1.cmdCatalogSync)(globalOpts());
+});
+program
+    .command('show')
+    .description('List GGUF quants for a Hugging Face spec')
+    .argument('<spec>', 'org/repo or org/repo:Q4_K_M')
+    .action(async (spec) => {
+    await (0, catalog_1.cmdShow)({ ...globalOpts(), spec });
+});
+program
+    .command('pull')
+    .description('Pull a GGUF (or record a safetensors id) into the local registry')
+    .argument('<spec>', 'org/repo or org/repo:quant')
+    .action(async (spec) => {
+    await (0, catalog_1.cmdPull)({ ...globalOpts(), spec });
+});
+program
+    .command('models')
+    .description('List local registry models (includes echo)')
+    .action(async () => {
+    await (0, catalog_1.cmdLocalModels)({ ...globalOpts() });
+});
+program
+    .command('rm')
+    .description('Delete a local model (registry + file under models/)')
+    .argument('<id>', 'Registry id')
+    .action(async (id) => {
+    await (0, catalog_1.cmdRm)({ ...globalOpts(), id });
+});
+const runtimesCmd = program
+    .command('runtimes')
+    .description('List inference runtimes, host OS support, and install commands')
+    .action(async () => {
+    await (0, runtimes_1.cmdRuntimes)(globalOpts());
+});
+runtimesCmd
+    .command('install')
+    .description('One-click install a runtime via Homebrew, pip, winget, or Docker')
+    .argument('<id>', 'Runtime id (llamacpp, ffmpeg, mlx, …)')
+    .action(async (id) => {
+    await (0, runtimes_1.cmdRuntimesInstall)({ ...globalOpts(), id });
+});
+runtimesCmd
+    .command('uninstall')
+    .description('Uninstall a runtime via Homebrew, pip, winget, or Docker')
+    .argument('<id>', 'Runtime id (llamacpp, ffmpeg, mlx, …)')
+    .action(async (id) => {
+    await (0, runtimes_1.cmdRuntimesUninstall)({ ...globalOpts(), id });
+});
+program
+    .command('load')
+    .description('Load a local GGUF into llama-server (or vLLM)')
+    .argument('<id>', 'Registry id')
+    .action(async (id) => {
+    await (0, catalog_1.cmdLoad)({ ...globalOpts(), id });
+});
+program
+    .command('unload')
+    .description('Unload a local engine')
+    .argument('<id>', 'Registry id')
+    .action(async (id) => {
+    await (0, catalog_1.cmdUnload)({ ...globalOpts(), id });
+});
+// ——— API features / capability gates ———
+const apiCmd = program
+    .command('api')
+    .description('API protocol and capability feature flags');
+const apiFeaturesCmd = apiCmd
+    .command('features')
+    .description('Show or change API feature flags (Admin parity)')
+    .action(async () => {
+    await (0, api_features_1.cmdApiFeaturesGet)(globalOpts());
+});
+apiFeaturesCmd
+    .command('get')
+    .description('Show current API feature flags')
+    .action(async () => {
+    await (0, api_features_1.cmdApiFeaturesGet)(globalOpts());
+});
+apiFeaturesCmd
+    .command('set')
+    .description('Set feature flags (on/off)')
+    .option('--openai-chat <on|off>')
+    .option('--openai-responses <on|off>')
+    .option('--anthropic-messages <on|off>')
+    .option('--tools <on|off>')
+    .option('--structured-output <on|off>')
+    .option('--vision <on|off>')
+    .option('--reasoning-effort <on|off>')
+    .option('--web-search <on|off>')
+    .option('--subagents <on|off>')
+    .option('--plan-mode <on|off>')
+    .option('--memory <on|off>')
+    .option('--session-resume <on|off>')
+    .option('--best-of-n <on|off>')
+    .option('--check-loop <on|off>')
+    .option('--system-override <on|off>')
+    .option('--rules <on|off>')
+    .option('--permission-mode <on|off>')
+    .option('--sandbox <on|off>')
+    .option('--usage-estimate <on|off>')
+    .option('--assistants-emulation <on|off>')
+    .option('--strict-sampling <on|off>')
+    .option('--force-disable-tools-in-safe <on|off>')
+    .option('--images-api <on|off>')
+    .option('--audio-api <on|off>')
+    .option('--video-api <on|off>')
+    .option('--files-openai-alias <on|off>')
+    .action(async (opts) => {
+    await (0, api_features_1.cmdApiFeaturesSet)({
+        ...globalOpts(),
+        openaiChat: opts.openaiChat,
+        openaiResponses: opts.openaiResponses,
+        anthropicMessages: opts.anthropicMessages,
+        tools: opts.tools,
+        structuredOutput: opts.structuredOutput,
+        vision: opts.vision,
+        reasoningEffort: opts.reasoningEffort,
+        webSearch: opts.webSearch,
+        subagents: opts.subagents,
+        planMode: opts.planMode,
+        memory: opts.memory,
+        sessionResume: opts.sessionResume,
+        bestOfN: opts.bestOfN,
+        checkLoop: opts.checkLoop,
+        systemOverride: opts.systemOverride,
+        rules: opts.rules,
+        permissionMode: opts.permissionMode,
+        sandbox: opts.sandbox,
+        usageEstimate: opts.usageEstimate,
+        assistantsEmulation: opts.assistantsEmulation,
+        strictSampling: opts.strictSampling,
+        forceDisableToolsInSafe: opts.forceDisableToolsInSafe,
+        imagesApi: opts.imagesApi,
+        audioApi: opts.audioApi,
+        videoApi: opts.videoApi,
+        filesOpenAiAlias: opts.filesOpenAiAlias,
+    });
+});
+apiFeaturesCmd
+    .command('preset')
+    .description('Apply preset: open | locked | dev')
+    .argument('<name>', 'Preset name')
+    .action(async (name) => {
+    await (0, api_features_1.cmdApiFeaturesPreset)({ ...globalOpts(), name });
+});
+program
+    .command('doctor')
+    .description('Check Node, env, loaded models, VRAM, build, runner (ysk-omni/PM2), conflicts')
+    .action(async () => {
+    await (0, doctor_1.cmdDoctor)(globalOpts());
+});
+program
+    .command('open')
+    .description('Print API / Admin URLs')
+    .option('--admin', 'Print admin URL only')
+    .action(async (opts) => {
+    await (0, open_1.cmdOpen)({ ...globalOpts(), admin: opts.admin });
+});
+const logsCmd = program
+    .command('logs')
+    .description('Show or clear gateway log files (pm2 + ysk-omni)')
+    .option('-n, --lines <n>', 'Tail lines (default 40)', (v) => Number(v))
+    .action(async (opts) => {
+    await (0, logs_1.cmdLogsShow)({ ...globalOpts(), lines: opts.lines });
+});
+logsCmd
+    .command('clear')
+    .description('Truncate pm2-error/out and ysk-omni log files')
+    .action(async () => {
+    await (0, logs_1.cmdLogsClear)(globalOpts());
+});
+logsCmd
+    .command('show')
+    .description('Print tail of log files')
+    .option('-n, --lines <n>', 'Tail lines (default 40)', (v) => Number(v))
+    .action(async (opts) => {
+    await (0, logs_1.cmdLogsShow)({ ...globalOpts(), lines: opts.lines });
+});
+program
+    .command('version')
+    .description('Show package version')
+    .action(() => {
+    (0, version_1.cmdVersion)();
+});
+program
+    .command('update')
+    .description('Self-update this package (npm / git / GitHub)')
+    .option('--check', 'Only check for updates')
+    .option('--no-restart', 'Do not restart gateway after update')
+    .option('--channel <name>', 'Force channel: auto | git | npm-global | npm-local', 'auto')
+    .action(async (opts) => {
+    await (0, update_1.cmdUpdate)({
+        ...globalOpts(),
+        check: opts.check,
+        restart: opts.restart,
+        channel: opts.channel,
+    });
+});
+program
+    .parseAsync(process.argv)
+    .catch((err) => {
+    console.error(err instanceof Error ? err.message : err);
+    process.exit(1);
+})
+    .then(() => {
+    // Commands that use undici/fetch must hard-exit themselves (e.g. update).
+    // If still alive and no open handles intended, allow natural exit.
+});
+//# sourceMappingURL=index.js.map