@rithamnatani/agentmux 1.5.39

package/dist/router/modelMetadata.js

@@ -0,0 +1,81 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const catalog = require('../modelCatalog.generated.json');
+function inferCostClass(provider, modelId) {
+    const id = modelId.toLowerCase();
+    if (provider === 'opencode' && id.includes('pickle'))
+        return 'free';
+    if (id.includes('flash') || id.includes('mini') || id.includes('haiku'))
+        return 'low';
+    if (id.includes('opus') || (id.includes('gpt-5.4') && !id.includes('mini')))
+        return 'premium';
+    if (id.includes('pro-preview') || id.includes('3.1-pro'))
+        return 'premium';
+    if (id.includes('sonnet') || id.includes('codex') || id.includes('composer'))
+        return 'medium';
+    if (id.includes('gpt-5.5'))
+        return 'medium';
+    if (id.includes('gpt-5.3'))
+        return 'medium';
+    if (id.includes('gpt-5.2'))
+        return 'medium';
+    return 'medium';
+}
+function collectCatalogModels() {
+    const out = [];
+    const catalogs = catalog.catalogs;
+    for (const [providerKey, entry] of Object.entries(catalogs)) {
+        const provider = providerKey;
+        if (!entry?.tiers)
+            continue;
+        for (const tier of entry.tiers) {
+            for (const modelId of tier.models ?? []) {
+                out.push({
+                    provider,
+                    modelId,
+                    costClass: inferCostClass(provider, modelId),
+                });
+            }
+        }
+    }
+    return out;
+}
+/** Models not present in the generated Codex/Gemini/Claude catalog. */
+const EXTRA_MODELS = [
+    { provider: 'opencode', modelId: 'opencode/big-pickle', costClass: 'free' },
+    { provider: 'cursor', modelId: 'composer-2', costClass: 'medium' },
+    { provider: 'cursor', modelId: 'gpt-5.5-low', costClass: 'medium' },
+];
+const ROUTABLE_BY_KEY = new Map();
+function key(provider, modelId) {
+    return `${provider}:${modelId}`;
+}
+for (const m of [...collectCatalogModels(), ...EXTRA_MODELS]) {
+    ROUTABLE_BY_KEY.set(key(m.provider, m.modelId), m);
+}
+/** Default alias target model IDs (see `defaultConfig.ts`); listed here to avoid import cycles. */
+const DEFAULT_ALIAS_TARGET_MODEL_IDS = [
+    'opencode/big-pickle',
+    'gemini-3.1-pro-preview',
+    'composer-2',
+    'gpt-5.5-low',
+    'gpt-5.4-mini',
+    'gpt-5.3-codex',
+    'claude-sonnet-4-6',
+    'claude-opus-4-7',
+];
+/** Known model IDs for validation warnings (catalog + extras + default alias targets). */
+export function getKnownModelIdSet() {
+    const ids = new Set();
+    for (const m of ROUTABLE_BY_KEY.values()) {
+        ids.add(m.modelId);
+    }
+    for (const id of DEFAULT_ALIAS_TARGET_MODEL_IDS) {
+        ids.add(id);
+    }
+    return ids;
+}
+export function lookupRoutableModel(provider, modelId) {
+    return ROUTABLE_BY_KEY.get(key(provider, modelId));
+}
+//# sourceMappingURL=modelMetadata.js.map

package/dist/router/modelMetadata.js.map

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

package/dist/router/quota.d.ts

@@ -0,0 +1,4 @@
+import type { QuotaBucket } from './types.js';
+/** Reserved for Stage 3+ quota-aware routing. */
+export declare function quotaAllowsRoute(_bucket: QuotaBucket | undefined): boolean;
+//# sourceMappingURL=quota.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../../src/router/quota.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAE1E"}

package/dist/router/quota.js

@@ -0,0 +1,5 @@
+/** Reserved for Stage 3+ quota-aware routing. */
+export function quotaAllowsRoute(_bucket) {
+    return true;
+}
+//# sourceMappingURL=quota.js.map

package/dist/router/quota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.js","sourceRoot":"","sources":["../../src/router/quota.ts"],"names":[],"mappings":"AAEA,iDAAiD;AACjD,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/router/router.d.ts

@@ -0,0 +1,3 @@
+import type { RouteBuildContext, RouteDecision, RouteRequestInput, RouterConfig } from './types.js';
+export declare function buildRouteDecision(routerConfig: RouterConfig, input: RouteRequestInput, context: RouteBuildContext, configWarnings?: string[]): RouteDecision;
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,iBAAiB,EAEjB,aAAa,EAEb,iBAAiB,EACjB,YAAY,EACb,MAAM,YAAY,CAAC;AAmCpB,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,iBAAiB,EAC1B,cAAc,GAAE,MAAM,EAAO,GAC5B,aAAa,CAsIf"}

package/dist/router/router.js

@@ -0,0 +1,141 @@
+import { getExcludedCategory } from '../clientFilter.js';
+import { getKnownModelIdSet } from './modelMetadata.js';
+import { quotaAllowsRoute } from './quota.js';
+const COST_RANK = {
+    free: 0,
+    included: 1,
+    low: 2,
+    medium: 3,
+    premium: 4,
+    any: 5,
+};
+function costAllowed(candidateCost, maxCost) {
+    if (maxCost === undefined)
+        return true;
+    return COST_RANK[candidateCost] <= COST_RANK[maxCost];
+}
+/** Stable partition: preferred provider routes first (relative order preserved). */
+function stablePreferProviderOrder(routes, preferred) {
+    if (!preferred)
+        return routes;
+    const pref = [];
+    const rest = [];
+    for (const r of routes) {
+        (r.provider === preferred ? pref : rest).push(r);
+    }
+    return [...pref, ...rest];
+}
+function applyCandidateOverrides(c, input) {
+    return {
+        ...c,
+        allowEdits: input.allowEdits ?? c.allowEdits,
+        requireReview: input.requireReview ?? c.requireReview,
+    };
+}
+export function buildRouteDecision(routerConfig, input, context, configWarnings = []) {
+    const reasons = [];
+    const warnings = [...configWarnings];
+    const rejected = [];
+    const tierDef = routerConfig.tiers[input.tier];
+    if (!tierDef) {
+        return {
+            selected: null,
+            fallbacks: [],
+            rejected: [{ reason: `Unknown tier "${input.tier}".` }],
+            reasons: ['No tier definition available.'],
+            warnings,
+        };
+    }
+    reasons.push(`Evaluated tier "${input.tier}" with ${tierDef.routes.length} configured routes (deterministic order).`);
+    if (input.prompt.trim().length > 0) {
+        reasons.push(`Prompt length ${input.prompt.length} characters.`);
+    }
+    if (input.domain) {
+        reasons.push(`Domain hint: ${input.domain} (informational for this router stage).`);
+    }
+    const excludedCategory = getExcludedCategory(context.mcpClientName);
+    const blocked = new Set(input.blockedProviders ?? []);
+    const knownModels = getKnownModelIdSet();
+    const ordered = stablePreferProviderOrder([...tierDef.routes], input.preferredProvider);
+    if (input.preferredProvider) {
+        reasons.push(`Preferred provider "${input.preferredProvider}" — matching routes are tried first while preserving relative order.`);
+    }
+    const tierDefaultNoEdits = tierDef.routes.every((r) => !r.allowEdits);
+    if (input.allowEdits === true && tierDefaultNoEdits) {
+        warnings.push('Edits were requested (allowEdits: true) but this tier defaults to read-only routes.');
+    }
+    const eligible = [];
+    for (const raw of ordered) {
+        if (!quotaAllowsRoute(undefined)) {
+            rejected.push({
+                routeId: raw.routeId,
+                provider: raw.provider,
+                modelId: raw.modelId,
+                reason: 'Quota gate rejected route (stub).',
+            });
+            continue;
+        }
+        if (!knownModels.has(raw.modelId)) {
+            warnings.push(`Model ID "${raw.modelId}" (${raw.provider}) is not in the bundled catalog or default alias targets — verify against List-*-Models before invoking.`);
+        }
+        if (!context.availability[raw.provider]) {
+            rejected.push({
+                routeId: raw.routeId,
+                provider: raw.provider,
+                modelId: raw.modelId,
+                reason: `Provider "${raw.provider}" is not available in this runtime.`,
+            });
+            continue;
+        }
+        if (blocked.has(raw.provider)) {
+            rejected.push({
+                routeId: raw.routeId,
+                provider: raw.provider,
+                modelId: raw.modelId,
+                reason: `Provider "${raw.provider}" is blocked by this request.`,
+            });
+            continue;
+        }
+        if (excludedCategory !== undefined && excludedCategory === raw.provider) {
+            rejected.push({
+                routeId: raw.routeId,
+                provider: raw.provider,
+                modelId: raw.modelId,
+                reason: `Provider "${raw.provider}" is excluded to prevent self-calls for MCP client "${context.mcpClientName ?? 'unknown'}".`,
+            });
+            continue;
+        }
+        if (!costAllowed(raw.costClass, input.maxCostClass)) {
+            rejected.push({
+                routeId: raw.routeId,
+                provider: raw.provider,
+                modelId: raw.modelId,
+                reason: `Cost class "${raw.costClass}" exceeds maxCostClass "${String(input.maxCostClass)}".`,
+            });
+            continue;
+        }
+        if (input.forceTask === true && raw.executionMode !== 'task') {
+            rejected.push({
+                routeId: raw.routeId,
+                provider: raw.provider,
+                modelId: raw.modelId,
+                reason: 'Route is sync-oriented but forceTask requested.',
+            });
+            continue;
+        }
+        eligible.push(applyCandidateOverrides(raw, input));
+    }
+    if (eligible.length === 0) {
+        warnings.push('No routes remained after applying availability, blocks, cost ceiling, and task constraints.');
+        return { selected: null, fallbacks: [], rejected, reasons, warnings };
+    }
+    const selected = eligible[0];
+    const fallbacks = eligible.slice(1);
+    const originFirstId = tierDef.routes[0]?.routeId;
+    if (originFirstId !== undefined && selected.routeId !== originFirstId) {
+        warnings.push(`Configured first route "${originFirstId}" was skipped; selected "${selected.routeId}" as the first eligible option.`);
+    }
+    reasons.push(`Selected ${selected.provider} / ${selected.modelId} (${selected.executionMode}) as the first eligible route.`);
+    return { selected, fallbacks, rejected, reasons, warnings };
+}
+//# sourceMappingURL=router.js.map

package/dist/router/router.js.map

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

package/dist/router/types.d.ts

@@ -0,0 +1,86 @@
+import type { CliAvailability } from '../utils/cliDetector.js';
+export type Tier = 'trivial' | 'small' | 'medium' | 'large' | 'long' | 'crucial';
+export type Provider = 'codex' | 'claude' | 'gemini' | 'opencode' | 'cursor';
+export type ExecutionMode = 'sync' | 'task';
+export type CostClass = 'free' | 'included' | 'low' | 'medium' | 'premium' | 'any';
+/** Routing domain hint for future rules; optional in v1. */
+export type RouteDomain = 'general' | 'code' | 'review' | 'docs' | 'analysis';
+export type RouteId = string;
+export interface RoutableModel {
+    provider: Provider;
+    modelId: string;
+    costClass: CostClass;
+}
+export interface RouteCandidate {
+    routeId: RouteId;
+    provider: Provider;
+    modelId: string;
+    executionMode: ExecutionMode;
+    allowEdits: boolean;
+    requireReview: boolean;
+    costClass: CostClass;
+    /** Per-route execution budget override (bytes UTF-8) after provider returns. */
+    maxOutputBytes?: number;
+    /** Per-route subprocess timeout override (ms), forwarded via ToolExecutionContext.timeoutMs. */
+    timeoutMs?: number;
+}
+export interface TierDefinition {
+    tier: Tier;
+    routes: RouteCandidate[];
+    /** Tier-wide defaults when routes omit limits. */
+    maxOutputBytes?: number;
+    timeoutMs?: number;
+}
+/** Optional global routing behavior (merged from user/project config). */
+export interface RouterRoutingConfig {
+    /** How many additional routes to try after the primary when execution fails (default 2). */
+    maxFallbackAttempts?: number;
+    /** When true, trivial tier may honor allowEdits (default false — trivial stays read-only). */
+    allowTrivialEdits?: boolean;
+    defaultTimeoutMs?: number;
+    defaultMaxOutputBytes?: number;
+}
+export interface RouterConfig {
+    aliases: Record<string, {
+        provider: Provider;
+        modelId: string;
+    }>;
+    tiers: Record<Tier, TierDefinition>;
+    routing?: RouterRoutingConfig;
+}
+export interface RouteRejected {
+    routeId?: RouteId;
+    provider?: Provider;
+    modelId?: string;
+    reason: string;
+}
+export interface RouteDecision {
+    selected: RouteCandidate | null;
+    fallbacks: RouteCandidate[];
+    rejected: RouteRejected[];
+    reasons: string[];
+    warnings: string[];
+}
+export interface RouteRequestInput {
+    prompt: string;
+    tier: Tier;
+    domain?: RouteDomain;
+    allowEdits?: boolean;
+    requireReview?: boolean;
+    preferredProvider?: Provider;
+    blockedProviders?: Provider[];
+    maxCostClass?: CostClass;
+    forceTask?: boolean;
+}
+export interface RouteBuildContext {
+    availability: CliAvailability;
+    /** MCP client `Implementation.name` for self-call exclusion. */
+    mcpClientName?: string;
+    /** Working directory used to locate `multi-cli.config.json`. */
+    projectRoot?: string;
+}
+/** Stub for future quota-aware routing. */
+export interface QuotaBucket {
+    readonly label?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/router/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/router/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":""}

package/dist/routerConfig.d.ts

@@ -0,0 +1,14 @@
+import type { ToolArguments } from './constants.js';
+export type RouterTier = 'default' | 'trivial' | 'low' | 'medium' | 'high' | 'crucial' | 'huge-trivial' | 'huge-medium' | 'huge-hard';
+export type RouterBackend = 'gemini' | 'opencode' | 'cursor' | 'codex';
+export interface RouterCandidate {
+    label: string;
+    toolName: string;
+    backend: RouterBackend;
+    model: string;
+    extraArgs?: ToolArguments;
+}
+export declare const ROUTER_TIER_ORDER: RouterTier[];
+export declare const ROUTER_TIERS: Record<RouterTier, RouterCandidate[]>;
+export declare function getRouterTiers(env?: NodeJS.ProcessEnv): Record<RouterTier, RouterCandidate[]>;
+//# sourceMappingURL=routerConfig.d.ts.map

package/dist/routerConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routerConfig.d.ts","sourceRoot":"","sources":["../src/routerConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,KAAK,GACL,QAAQ,GACR,MAAM,GACN,SAAS,GACT,cAAc,GACd,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAUzC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,eAAe,EAAE,CA2I9D,CAAC;AAsCF,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,UAAU,EAAE,eAAe,EAAE,CAAC,CAU1G"}

package/dist/routerConfig.js

@@ -0,0 +1,194 @@
+import { readFileSync } from 'node:fs';
+export const ROUTER_TIER_ORDER = [
+    'default',
+    'trivial',
+    'low',
+    'medium',
+    'high',
+    'crucial',
+    'huge-trivial',
+    'huge-medium',
+    'huge-hard',
+];
+export const ROUTER_TIERS = {
+    default: [
+        {
+            label: 'Gemini Flash Lite',
+            toolName: 'Ask-Gemini',
+            backend: 'gemini',
+            model: 'gemini-3.1-flash-lite-preview',
+        },
+        {
+            label: 'Copilot GPT-5 mini xhigh',
+            toolName: 'Ask-OpenCode',
+            backend: 'opencode',
+            model: 'github-copilot/gpt-5-mini',
+            extraArgs: { variant: 'xhigh' },
+        },
+    ],
+    trivial: [
+        {
+            label: 'Gemini Flash Lite',
+            toolName: 'Ask-Gemini',
+            backend: 'gemini',
+            model: 'gemini-3.1-flash-lite-preview',
+        },
+        {
+            label: 'Copilot GPT-5 mini xhigh',
+            toolName: 'Ask-OpenCode',
+            backend: 'opencode',
+            model: 'github-copilot/gpt-5-mini',
+            extraArgs: { variant: 'xhigh' },
+        },
+    ],
+    low: [
+        {
+            label: 'Gemini Flash',
+            toolName: 'Ask-Gemini',
+            backend: 'gemini',
+            model: 'gemini-3-flash-preview',
+        },
+        {
+            label: 'Copilot GPT-5 mini xhigh',
+            toolName: 'Ask-OpenCode',
+            backend: 'opencode',
+            model: 'github-copilot/gpt-5-mini',
+            extraArgs: { variant: 'xhigh' },
+        },
+    ],
+    medium: [
+        {
+            label: 'Ring 2.6 1T',
+            toolName: 'Ask-OpenCode',
+            backend: 'opencode',
+            model: 'opencode/ring-2.6-1t-free',
+        },
+        {
+            label: 'Gemini 3.1 Pro preview',
+            toolName: 'Ask-Gemini',
+            backend: 'gemini',
+            model: 'gemini-3.1-pro-preview',
+        },
+        {
+            label: 'Codex GPT-5.4 mini medium',
+            toolName: 'Ask-Codex',
+            backend: 'codex',
+            model: 'gpt-5.4-mini-medium',
+        },
+    ],
+    high: [
+        {
+            label: 'Gemini 3.1 Pro preview',
+            toolName: 'Ask-Gemini',
+            backend: 'gemini',
+            model: 'gemini-3.1-pro-preview',
+        },
+        {
+            label: 'Cursor Composer 2',
+            toolName: 'Ask-Cursor',
+            backend: 'cursor',
+            model: 'composer-2',
+        },
+    ],
+    crucial: [
+        {
+            label: 'Codex GPT-5.5 low',
+            toolName: 'Ask-Codex',
+            backend: 'codex',
+            model: 'gpt-5.5-low',
+        },
+        {
+            label: 'Gemini 3.1 Pro preview',
+            toolName: 'Ask-Gemini',
+            backend: 'gemini',
+            model: 'gemini-3.1-pro-preview',
+        },
+    ],
+    'huge-trivial': [
+        {
+            label: 'Copilot GPT-5 mini xhigh',
+            toolName: 'Ask-OpenCode',
+            backend: 'opencode',
+            model: 'github-copilot/gpt-5-mini',
+            extraArgs: { variant: 'xhigh' },
+        },
+        {
+            label: 'Gemini Flash Lite',
+            toolName: 'Ask-Gemini',
+            backend: 'gemini',
+            model: 'gemini-3.1-flash-lite-preview',
+        },
+    ],
+    'huge-medium': [
+        {
+            label: 'Copilot GPT-5.4 mini xhigh',
+            toolName: 'Ask-OpenCode',
+            backend: 'opencode',
+            model: 'github-copilot/gpt-5.4-mini',
+            extraArgs: { variant: 'xhigh' },
+        },
+        {
+            label: 'Gemini 3.1 Pro preview',
+            toolName: 'Ask-Gemini',
+            backend: 'gemini',
+            model: 'gemini-3.1-pro-preview',
+        },
+    ],
+    'huge-hard': [
+        {
+            label: 'Copilot GPT-5.2 Codex xhigh',
+            toolName: 'Ask-OpenCode',
+            backend: 'opencode',
+            model: 'github-copilot/gpt-5.2-codex',
+            extraArgs: { variant: 'xhigh' },
+        },
+        {
+            label: 'Gemini 3.1 Pro preview',
+            toolName: 'Ask-Gemini',
+            backend: 'gemini',
+            model: 'gemini-3.1-pro-preview',
+        },
+    ],
+};
+function isRouterTier(value) {
+    return ROUTER_TIER_ORDER.includes(value);
+}
+function isRouterCandidate(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    return (typeof candidate.label === 'string' &&
+        typeof candidate.toolName === 'string' &&
+        typeof candidate.backend === 'string' &&
+        ['gemini', 'opencode', 'cursor', 'codex'].includes(candidate.backend) &&
+        typeof candidate.model === 'string' &&
+        (candidate.extraArgs === undefined || (typeof candidate.extraArgs === 'object' && candidate.extraArgs !== null)));
+}
+function parseRouterTierOverrides(configPath) {
+    const parsed = JSON.parse(readFileSync(configPath, 'utf-8'));
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error('router config must be a JSON object keyed by tier name');
+    }
+    const overrides = {};
+    for (const [tier, candidates] of Object.entries(parsed)) {
+        if (!isRouterTier(tier)) {
+            throw new Error(`router config contains unknown tier "${tier}"`);
+        }
+        if (!Array.isArray(candidates) || !candidates.every(isRouterCandidate)) {
+            throw new Error(`router config tier "${tier}" must be an array of router candidates`);
+        }
+        overrides[tier] = candidates;
+    }
+    return overrides;
+}
+export function getRouterTiers(env = process.env) {
+    const configPath = env.AGENTMUX_ROUTER_CONFIG?.trim();
+    if (!configPath) {
+        return ROUTER_TIERS;
+    }
+    return {
+        ...ROUTER_TIERS,
+        ...parseRouterTierOverrides(configPath),
+    };
+}
+//# sourceMappingURL=routerConfig.js.map

package/dist/routerConfig.js.map

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

package/dist/serverApp.d.ts

@@ -0,0 +1,43 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import { type Implementation, type ListRootsResult } from "@modelcontextprotocol/sdk/types.js";
+import { MultiCliConfig } from "./config.js";
+import { Logger } from "./logger.js";
+import type { CliAvailability } from "./utils/cliDetector.js";
+export interface MultiCliRuntime {
+    availability: CliAvailability;
+    initializedAt: string;
+}
+export interface MultiCliSessionContext {
+    cwd?: string;
+    rootUri?: string;
+    projectRoots?: ListRootsResult['roots'];
+    env?: NodeJS.ProcessEnv;
+    transport?: 'stdio' | 'http';
+    clientName?: string;
+    resolveWorkingDirectory?: (server: Server, logger: Logger) => Promise<{
+        cwd?: string;
+        rootUri?: string;
+        projectRoots?: ListRootsResult['roots'];
+    }>;
+}
+export interface CreateServerAppOptions {
+    runtime?: MultiCliRuntime;
+    sessionContext?: MultiCliSessionContext;
+    onClientInitialized?: (server: Server, clientInfo: Implementation | undefined, sessionContext: MultiCliSessionContext) => Promise<void> | void;
+}
+export declare function createServerRuntime(config?: MultiCliConfig, rootLogger?: Logger): Promise<MultiCliRuntime>;
+export declare function resolveWorkingDirectoryFromRoots(server: Server, logger: Logger): Promise<{
+    cwd?: string;
+    rootUri?: string;
+    projectRoots?: ListRootsResult['roots'];
+}>;
+export interface MultiCliServerApp {
+    readonly server: Server;
+    readonly config: MultiCliConfig;
+    connect(transport: Transport): Promise<void>;
+    close(reason?: string): Promise<void>;
+}
+export declare function createServerApp(config?: MultiCliConfig, rootLogger?: Logger, options?: CreateServerAppOptions): Promise<MultiCliServerApp>;
+export declare function startServer(config?: MultiCliConfig, rootLogger?: Logger): Promise<MultiCliServerApp>;
+//# sourceMappingURL=serverApp.d.ts.map

package/dist/serverApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverApp.d.ts","sourceRoot":"","sources":["../src/serverApp.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAkBL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAC;AAiBnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAQ9D,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,eAAe,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB,CAAC,EAAE,CACxB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,KACX,OAAO,CAAC;QACX,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;KACzC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,cAAc,GAAG,SAAS,EACtC,cAAc,EAAE,sBAAsB,KACnC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3B;AAuED,wBAAsB,mBAAmB,CACvC,MAAM,GAAE,cAA6B,EACrC,UAAU,GAAE,MAKV,GACD,OAAO,CAAC,eAAe,CAAC,CAgB1B;AAED,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CACzC,CAAC,CA0BD;AA+JD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,wBAAsB,eAAe,CACnC,MAAM,GAAE,cAA6B,EACrC,UAAU,GAAE,MAKV,EACF,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAuZ5B;AAED,wBAAsB,WAAW,CAC/B,MAAM,GAAE,cAA6B,EACrC,UAAU,GAAE,MAKV,GACD,OAAO,CAAC,iBAAiB,CAAC,CA0C5B"}