@rithamnatani/agentmux 1.5.39

package/dist/index.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import { loadConfig } from './config.js';
+import { startHttpServer } from './httpServer.js';
+import { createLogger } from './logger.js';
+import { startServer as startStdioServer } from './serverApp.js';
+import { handleServiceCommand } from './service/manager.js';
+function parseCommand(argv) {
+    const [firstArg, ...rest] = argv;
+    if (firstArg === 'serve-http') {
+        return { command: 'serve-http', args: rest };
+    }
+    if (firstArg === 'serve-stdio') {
+        return { command: 'serve-stdio', args: rest };
+    }
+    if (firstArg === 'service') {
+        return { command: 'service', args: rest };
+    }
+    return {
+        command: loadConfig().transport === 'http' ? 'serve-http' : 'serve-stdio',
+        args: argv,
+    };
+}
+async function main() {
+    const parsed = parseCommand(process.argv.slice(2));
+    const config = loadConfig();
+    const rootLogger = createLogger({
+        filePath: config.logPath,
+        fileLevel: config.logLevel,
+        stderrLevel: config.stderrLogLevel,
+        bindings: { component: 'agentmux' },
+    });
+    const logger = rootLogger.child({ component: 'index' });
+    logger.info('process_bootstrap', {
+        config,
+        argv: process.argv,
+        parsedCommand: parsed.command,
+        cwd: process.cwd(),
+        nodeVersion: process.version,
+        platform: process.platform,
+    });
+    if (parsed.command === 'service') {
+        await handleServiceCommand(parsed.args, config, rootLogger);
+        return;
+    }
+    const runtime = parsed.command === 'serve-http'
+        ? await startHttpServer({ ...config, transport: 'http' }, rootLogger)
+        : await startStdioServer({ ...config, transport: 'stdio' }, rootLogger);
+    const shutdown = async (signalName) => {
+        logger.info('process_signal_received', { signalName });
+        await runtime.close(`Received ${signalName}`);
+    };
+    const handleFatalError = (event, error) => {
+        logger.error(event, { error });
+        process.exitCode = 1;
+        void runtime.close(event);
+        setTimeout(() => {
+            process.exit(1);
+        }, parsed.command === 'serve-http' ? 250 : 25).unref();
+    };
+    process.once('SIGINT', () => {
+        void shutdown('SIGINT');
+    });
+    process.once('SIGTERM', () => {
+        void shutdown('SIGTERM');
+    });
+    process.once('beforeExit', (code) => {
+        logger.info('process_before_exit', { code });
+    });
+    process.once('exit', (code) => {
+        logger.info('process_exit', { code });
+    });
+    process.on('warning', (warning) => {
+        logger.error('process_warning', { warning });
+    });
+    process.on('uncaughtExceptionMonitor', (error, origin) => {
+        logger.error('process_uncaught_exception_monitor', { error, origin });
+    });
+    process.on('uncaughtException', (error, origin) => {
+        handleFatalError('process_uncaught_exception', { error, origin });
+    });
+    process.on('unhandledRejection', (reason, promise) => {
+        handleFatalError('process_unhandled_rejection', { reason, promise });
+    });
+}
+main().catch((error) => {
+    const config = loadConfig();
+    const rootLogger = createLogger({
+        filePath: config.logPath,
+        fileLevel: config.logLevel,
+        stderrLevel: config.stderrLogLevel,
+        bindings: { component: 'agentmux' },
+    });
+    const logger = rootLogger.child({ component: 'index' });
+    logger.error('server_startup_failed', { error });
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,19 @@
+import { MultiCliLogLevel, MultiCliStderrLogLevel } from './config.js';
+export interface Logger {
+    readonly logPath: string;
+    readonly sessionId: string;
+    child(bindings: Record<string, unknown>): Logger;
+    error(event: string, meta?: Record<string, unknown>): void;
+    info(event: string, meta?: Record<string, unknown>): void;
+    debug(event: string, meta?: Record<string, unknown>): void;
+}
+interface LoggerOptions {
+    filePath: string;
+    fileLevel: MultiCliLogLevel;
+    stderrLevel?: MultiCliStderrLogLevel;
+    sessionId?: string;
+    bindings?: Record<string, unknown>;
+}
+export declare function createLogger(options: LoggerOptions): Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AA4HvE,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IACjD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAqFD,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE3D"}

package/dist/logger.js

@@ -0,0 +1,172 @@
+import { randomUUID } from 'node:crypto';
+import { appendFileSync, existsSync, mkdirSync, renameSync, rmSync, statSync } from 'node:fs';
+import path from 'node:path';
+const LEVEL_PRIORITY = {
+    error: 0,
+    info: 1,
+    debug: 2,
+};
+const MAX_LOG_FILE_SIZE_BYTES = 10 * 1024 * 1024;
+const MAX_LOG_BACKUPS = 5;
+function shouldWrite(currentLevel, minimumLevel) {
+    if (minimumLevel === 'silent') {
+        return false;
+    }
+    return LEVEL_PRIORITY[currentLevel] <= LEVEL_PRIORITY[minimumLevel];
+}
+function serializeValue(value, seen = new WeakSet()) {
+    if (value instanceof Error) {
+        if (seen.has(value)) {
+            return '[Circular]';
+        }
+        seen.add(value);
+        const serialized = {
+            name: value.name,
+            message: value.message,
+            stack: value.stack,
+            cause: serializeValue(value.cause, seen),
+        };
+        seen.delete(value);
+        return serialized;
+    }
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    if (typeof value === 'function') {
+        return `[Function ${value.name || 'anonymous'}]`;
+    }
+    if (typeof value === 'symbol') {
+        return value.toString();
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (Buffer.isBuffer(value)) {
+        return {
+            type: 'Buffer',
+            length: value.length,
+            utf8: value.toString('utf8'),
+        };
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => serializeValue(entry, seen));
+    }
+    if (value && typeof value === 'object') {
+        if (seen.has(value)) {
+            return '[Circular]';
+        }
+        seen.add(value);
+        const serialized = Object.fromEntries(Object.entries(value).map(([key, entry]) => [
+            key,
+            shouldRedactKey(key) ? '[Redacted]' : serializeValue(entry, seen),
+        ]));
+        seen.delete(value);
+        return serialized;
+    }
+    return value;
+}
+function shouldRedactKey(key) {
+    const normalized = key.toLowerCase();
+    return normalized.includes('authorization')
+        || normalized.includes('token')
+        || normalized.includes('cookie')
+        || normalized.includes('api-key')
+        || normalized.includes('apikey');
+}
+function rotateLogsIfNeeded(logPath) {
+    try {
+        if (!existsSync(logPath)) {
+            return;
+        }
+        const { size } = statSync(logPath);
+        if (size < MAX_LOG_FILE_SIZE_BYTES) {
+            return;
+        }
+        rmSync(`${logPath}.${MAX_LOG_BACKUPS}`, { force: true });
+        for (let index = MAX_LOG_BACKUPS - 1; index >= 1; index -= 1) {
+            const currentPath = `${logPath}.${index}`;
+            const nextPath = `${logPath}.${index + 1}`;
+            if (existsSync(currentPath)) {
+                renameSync(currentPath, nextPath);
+            }
+        }
+        renameSync(logPath, `${logPath}.1`);
+    }
+    catch {
+        // Rotation is best-effort only.
+    }
+}
+class StructuredLogger {
+    options;
+    logPath;
+    sessionId;
+    constructor(options) {
+        this.options = options;
+        this.logPath = options.filePath;
+        this.sessionId = options.sessionId ?? randomUUID();
+        mkdirSync(path.dirname(this.logPath), { recursive: true });
+    }
+    child(bindings) {
+        return new StructuredLogger({
+            ...this.options,
+            sessionId: this.sessionId,
+            bindings: {
+                ...(this.options.bindings ?? {}),
+                ...bindings,
+            },
+        });
+    }
+    error(event, meta) {
+        this.write('error', event, meta);
+    }
+    info(event, meta) {
+        this.write('info', event, meta);
+    }
+    debug(event, meta) {
+        this.write('debug', event, meta);
+    }
+    write(level, event, meta) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            event,
+            sessionId: this.sessionId,
+            pid: process.pid,
+            ...serializeValue(this.options.bindings ?? {}),
+            ...(meta ? { meta: serializeValue(meta) } : {}),
+        };
+        const line = `${JSON.stringify(entry)}\n`;
+        try {
+            if (shouldWrite(level, this.options.fileLevel)) {
+                rotateLogsIfNeeded(this.logPath);
+                appendFileSync(this.logPath, line, 'utf8');
+            }
+        }
+        catch (error) {
+            const fallback = JSON.stringify({
+                timestamp: new Date().toISOString(),
+                level: 'error',
+                event: 'logger_file_write_failed',
+                sessionId: this.sessionId,
+                pid: process.pid,
+                component: 'logger',
+                meta: serializeValue({
+                    targetPath: this.logPath,
+                    originalLevel: level,
+                    originalEvent: event,
+                    error,
+                }),
+            });
+            process.stderr.write(`${fallback}\n`);
+            return;
+        }
+        const stderrLevel = this.options.stderrLevel ?? 'error';
+        if (shouldWrite(level, stderrLevel)) {
+            process.stderr.write(line);
+        }
+    }
+}
+export function createLogger(options) {
+    return new StructuredLogger(options);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/modelCatalog.d.ts

@@ -0,0 +1,15 @@
+import type { StaticCLIName } from './tierConfig.js';
+export interface ModelTier {
+    tier: 'fast' | 'balanced' | 'powerful';
+    label: string;
+    models: string[];
+    useWhen: string;
+}
+export interface CLICatalog {
+    cli: StaticCLIName;
+    tiers: ModelTier[];
+    note: string;
+}
+export declare function getCatalog(cli: StaticCLIName): CLICatalog;
+export declare function formatCatalog(cli: StaticCLIName): string;
+//# sourceMappingURL=modelCatalog.d.ts.map

package/dist/modelCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCatalog.d.ts","sourceRoot":"","sources":["../src/modelCatalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,iBAAiB,CAAC;AAE/D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,aAAa,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAuFD,wBAAgB,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAEzD;AAQD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAgBxD"}

package/dist/modelCatalog.generated.json

@@ -0,0 +1,80 @@
+{
+  "generatedAt": "2026-04-18T09:19:53.537Z",
+  "catalogs": {
+    "claude": {
+      "cli": "claude",
+      "tiers": [
+        {
+          "tier": "fast",
+          "models": [
+            "claude-haiku-4-5"
+          ]
+        },
+        {
+          "tier": "balanced",
+          "models": [
+            "claude-sonnet-4-5",
+            "claude-sonnet-4-6"
+          ]
+        },
+        {
+          "tier": "powerful",
+          "models": [
+            "claude-opus-4-7"
+          ]
+        }
+      ]
+    },
+    "gemini": {
+      "cli": "gemini",
+      "tiers": [
+        {
+          "tier": "fast",
+          "models": [
+            "gemini-2.5-flash",
+            "gemini-2.5-flash-lite",
+            "gemini-3-flash-preview",
+            "gemini-3.1-flash-lite-preview"
+          ]
+        },
+        {
+          "tier": "balanced",
+          "models": [
+            "gemini-2.5-pro"
+          ]
+        },
+        {
+          "tier": "powerful",
+          "models": [
+            "gemini-3-pro-preview",
+            "gemini-3.1-pro-preview"
+          ]
+        }
+      ]
+    },
+    "codex": {
+      "cli": "codex",
+      "tiers": [
+        {
+          "tier": "fast",
+          "models": [
+            "gpt-5.4-mini"
+          ]
+        },
+        {
+          "tier": "balanced",
+          "models": [
+            "gpt-5.2",
+            "gpt-5.3-codex"
+          ]
+        },
+        {
+          "tier": "powerful",
+          "models": [
+            "gpt-5.4"
+          ]
+        }
+      ]
+    }
+  }
+}

package/dist/modelCatalog.js

@@ -0,0 +1,81 @@
+import { createRequire } from 'node:module';
+import { TIER_CONFIG, CLI_NOTES } from './tierConfig.js';
+let generatedData;
+try {
+    const require = createRequire(import.meta.url);
+    const raw = require('./modelCatalog.generated.json');
+    if (!raw ||
+        typeof raw !== 'object' ||
+        !('catalogs' in raw) ||
+        typeof raw.catalogs !== 'object') {
+        throw new Error('invalid shape');
+    }
+    generatedData = raw;
+}
+catch {
+    throw new Error('Failed to load modelCatalog.generated.json. ' +
+        "If developing locally, run 'npm run refresh-catalog'. " +
+        'If using the published package, try reinstalling or upgrading.');
+}
+// ── Build catalog from generated data (no static fallback — generated file
+//    is checked into git and always ships with the package) ──────────────────
+function buildFromGenerated(cliName) {
+    const entry = generatedData.catalogs[cliName];
+    if (!entry?.tiers?.length)
+        return null;
+    const tiers = [];
+    for (const genTier of entry.tiers) {
+        const tierName = genTier.tier;
+        const config = TIER_CONFIG[cliName]?.[tierName];
+        if (!config || !Array.isArray(genTier.models) || !genTier.models.length)
+            continue;
+        tiers.push({
+            tier: tierName,
+            label: config.label,
+            models: genTier.models,
+            useWhen: config.useWhen,
+        });
+    }
+    if (tiers.length === 0)
+        return null;
+    return {
+        cli: cliName,
+        tiers,
+        note: CLI_NOTES[cliName],
+    };
+}
+// ── Resolved catalogs ────────────────────────────────────────────────────────
+const CATALOGS = {};
+for (const cli of ['gemini', 'codex', 'claude']) {
+    const built = buildFromGenerated(cli);
+    if (!built) {
+        throw new Error(`No catalog entry for "${cli}" in generated data. ` +
+            "If developing locally, run 'npm run refresh-catalog'. " +
+            'If using the published package, try reinstalling or upgrading.');
+    }
+    CATALOGS[cli] = built;
+}
+// ── Public API (unchanged signatures) ────────────────────────────────────────
+export function getCatalog(cli) {
+    return CATALOGS[cli];
+}
+const SELECTION_RULE = `MODEL SELECTION RULE: Default to the "balanced" tier for most tasks. ` +
+    `Use "powerful" for complex reasoning, architecture, nuanced analysis, or when quality matters most. ` +
+    `Reserve "fast" only for trivial lookups, simple math, or quick one-line answers. ` +
+    `When multiple model IDs are listed for a tier, prefer the one with the highest version number (newest and most capable).\n`;
+export function formatCatalog(cli) {
+    const catalog = CATALOGS[cli];
+    const lines = [
+        `${catalog.cli.toUpperCase()} — Available Models\n`,
+        SELECTION_RULE,
+    ];
+    for (const tier of catalog.tiers) {
+        lines.push(`[${tier.tier.toUpperCase()}] ${tier.label}`);
+        lines.push(`  Use when: ${tier.useWhen}`);
+        lines.push(`  Model IDs: ${tier.models.join(', ')}`);
+        lines.push('');
+    }
+    lines.push(`> ${catalog.note}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=modelCatalog.js.map

package/dist/modelCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCatalog.js","sourceRoot":"","sources":["../src/modelCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAiCzD,IAAI,aAA4B,CAAC;AACjC,IAAI,CAAC;IACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,+BAA+B,CAAY,CAAC;IAChE,IACE,CAAC,GAAG;QACJ,OAAO,GAAG,KAAK,QAAQ;QACvB,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC;QACpB,OAAQ,GAA+B,CAAC,QAAQ,KAAK,QAAQ,EAC7D,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IACD,aAAa,GAAG,GAAoB,CAAC;AACvC,CAAC;AAAC,MAAM,CAAC;IACP,MAAM,IAAI,KAAK,CACb,8CAA8C;QAC5C,wDAAwD;QACxD,gEAAgE,CACnE,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,+EAA+E;AAE/E,SAAS,kBAAkB,CAAC,OAAsB;IAChD,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAgB,CAAC;QAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM;YAAE,SAAS;QAElF,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,OAAO;QACL,GAAG,EAAE,OAAO;QACZ,KAAK;QACL,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,MAAM,QAAQ,GAA+B,EAAE,CAAC;AAChD,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAU,EAAE,CAAC;IACzD,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,uBAAuB;YACjD,wDAAwD;YACxD,gEAAgE,CACnE,CAAC;IACJ,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AACxB,CAAC;AAED,gFAAgF;AAEhF,MAAM,UAAU,UAAU,CAAC,GAAkB;IAC3C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,cAAc,GAClB,uEAAuE;IACvE,sGAAsG;IACtG,mFAAmF;IACnF,4HAA4H,CAAC;AAE/H,MAAM,UAAU,aAAa,CAAC,GAAkB;IAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAa;QACtB,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,uBAAuB;QACnD,cAAc;KACf,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/router/config.d.ts

@@ -0,0 +1,13 @@
+import type { RouterConfig } from './types.js';
+export interface LoadRouterConfigResult {
+    config: RouterConfig;
+    warnings: string[];
+}
+export declare function getUserRouterConfigPath(): string;
+export declare function findProjectRouterConfig(startDir: string): string | undefined;
+/**
+ * Merge package defaults → user config → project config (later wins).
+ * Invalid layers are skipped with warnings; catastrophic failure falls back to defaults.
+ */
+export declare function loadRouterConfig(projectRoot?: string): LoadRouterConfigResult;
+//# sourceMappingURL=config.d.ts.map

package/dist/router/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/router/config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAA6C,MAAM,YAAY,CAAC;AA4D1F,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAwHD,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,sBAAsB,CA6B7E"}