abtars 0.1.0-alpha.1

package/bundle/chunk-Y6XAEX2Q.js

@@ -0,0 +1,408 @@
+import { createRequire as __bundleCreateRequire } from 'node:module'; import { fileURLToPath as __bundleFileURLToPath } from 'node:url'; import { dirname as __bundleDirname } from 'node:path'; const require = __bundleCreateRequire(import.meta.url); const __chunk_filename = __bundleFileURLToPath(import.meta.url); const __chunk_dirname = __bundleDirname(__chunk_filename);
+import {
+  readEnvWithDefault
+} from "./chunk-YOCTDKKL.js";
+import {
+  TRANSPORT_SCHEMA,
+  init_config_validator,
+  validateShape
+} from "./chunk-2UPU3OW6.js";
+import {
+  init_log_and_swallow,
+  logAndSwallow
+} from "./chunk-FMWKEPM7.js";
+import {
+  getEnv,
+  init_env_schema
+} from "./chunk-JCJS4ZIB.js";
+import {
+  init_logger,
+  logError,
+  logInfo,
+  logWarn
+} from "./chunk-BUUVFUPO.js";
+import {
+  abtarsHome,
+  init_paths
+} from "./chunk-X76UX47U.js";
+import {
+  __require
+} from "./chunk-NWDBD4PA.js";
+
+// src/components/transport-config.ts
+init_log_and_swallow();
+init_env_schema();
+init_config_validator();
+init_paths();
+import { readFileSync, writeFileSync, existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+init_logger();
+var TAG = "transport-config";
+var cachedTransport = null;
+function configDir() {
+  return join(abtarsHome(), "config");
+}
+function loadModels() {
+  const p = join(configDir(), getEnv().modelsConfig);
+  try {
+    return JSON.parse(readFileSync(p, "utf-8"));
+  } catch (err) {
+    logWarn(TAG, `Failed to load models.json: ${err instanceof Error ? err.message : String(err)}`);
+    return {};
+  }
+}
+function loadTransport() {
+  if (cachedTransport) return cachedTransport;
+  const dir = configDir();
+  const p = join(dir, getEnv().transportConfig);
+  try {
+    cachedTransport = JSON.parse(readFileSync(p, "utf-8"));
+    validateShape(cachedTransport, TRANSPORT_SCHEMA, "transport.json");
+    logInfo(TAG, `Loaded transport config (${Object.keys(cachedTransport.agents).length} agents, ${Object.keys(cachedTransport.providers).length} providers)`);
+    const repairs = validateAndRepair(cachedTransport);
+    if (repairs.length > 0) {
+      for (const r of repairs) logWarn(TAG, `Auto-repaired: ${r.agent} was on ${r.oldProvider} \u2014 ${r.reason}`);
+      writeTransportConfig(cachedTransport, `invariant auto-repair (${repairs.length} agents)`);
+      pendingRepairs = repairs;
+    }
+    return cachedTransport;
+  } catch (err) {
+    logAndSwallow(TAG, "loadTransport parse", err);
+    try {
+      cachedTransport = JSON.parse(readFileSync(join(dir, "transport.default.json"), "utf-8"));
+      logWarn(TAG, `transport.json missing/corrupt \u2014 loaded transport.default.json`);
+      return cachedTransport;
+    } catch (err2) {
+      logError(TAG, `No transport config available: ${err2 instanceof Error ? err2.message : String(err2)}`);
+      return null;
+    }
+  }
+}
+function resolveHailMary(transport) {
+  const tc = transport ?? loadTransport();
+  if (!tc?.hailMary) return null;
+  const provider = tc.providers[tc.hailMary.provider];
+  if (!provider?.endpoint) return null;
+  return { model: tc.hailMary.model, endpoint: provider.endpoint, apiKeyEnv: provider.apiKeyEnv };
+}
+function clearTransportCache() {
+  cachedTransport = null;
+}
+var pendingRepairs = [];
+function consumeRepairs() {
+  const r = pendingRepairs;
+  pendingRepairs = [];
+  return r;
+}
+function validateAndRepair(tc) {
+  const profAssignment = tc.agents["professor"];
+  if (!profAssignment) return [];
+  const profProvider = tc.providers[profAssignment.provider];
+  if (!profProvider) return [];
+  const profType = profProvider.transport;
+  const repairs = [];
+  for (const [agent, assignment] of Object.entries(tc.agents)) {
+    if (agent === "professor") continue;
+    const provider = tc.providers[assignment.provider];
+    if (!provider) continue;
+    const agentType = provider.transport;
+    let violation = false;
+    if (agentType !== profType) {
+      violation = true;
+    } else if (profType !== "api" && assignment.provider !== profAssignment.provider) {
+      violation = true;
+    }
+    if (violation) {
+      repairs.push({ agent, oldProvider: assignment.provider, reason: `${provider.transport} incompatible with professor (${profType}/${profAssignment.provider})` });
+      tc.agents[agent] = { model: profAssignment.model, provider: profAssignment.provider };
+    }
+  }
+  const fallbacks = profAssignment.fallbacks;
+  if (fallbacks) {
+    for (let i = fallbacks.length - 1; i >= 0; i--) {
+      const fb = fallbacks[i];
+      const fbProvider = tc.providers[fb.provider];
+      if (!fbProvider) continue;
+      const fbType = fbProvider.transport;
+      if (fbType !== profType || profType !== "api" && fb.provider !== profAssignment.provider) {
+        repairs.push({ agent: `professor_fb${i + 1}`, oldProvider: fb.provider, reason: `fallback ${fbProvider.transport} incompatible with professor (${profType}/${profAssignment.provider})` });
+        fallbacks.splice(i, 1);
+      }
+    }
+  }
+  return repairs;
+}
+function resolveAgent(role, transport, models) {
+  const tc = transport ?? loadTransport();
+  if (!tc) return null;
+  const effectiveRole = role === "task" ? "professor" : role;
+  const assignment = tc.agents[effectiveRole];
+  if (!assignment) {
+    logWarn(TAG, `No agent assignment for role "${role}"`);
+    return null;
+  }
+  const providers = tc.providers;
+  let effectiveModel = assignment.model;
+  let effectiveProvider = assignment.provider;
+  const demotedModel = assignment.demotedModel ?? assignment.model;
+  if (assignment.demoted && demotedModel === assignment.model) {
+    const firstHealthy = (assignment.fallbacks ?? []).find((fb) => !fb.demoted);
+    if (firstHealthy) {
+      effectiveModel = firstHealthy.model;
+      effectiveProvider = firstHealthy.provider;
+    } else {
+      logWarn(TAG, `All models demoted for role "${role}" \u2014 using primary anyway`);
+    }
+  }
+  const resolvedProvider = providers[effectiveProvider];
+  if (!resolvedProvider) {
+    logWarn(TAG, `Provider "${effectiveProvider}" not found for role "${role}"`);
+    return null;
+  }
+  const mc = models ?? loadModels();
+  const modelEntry = mc[effectiveModel];
+  if (!modelEntry && effectiveModel) {
+    logWarn(TAG, `Model "${effectiveModel}" not in models.json \u2014 using defaults`);
+  }
+  return {
+    model: effectiveModel,
+    provider: resolvedProvider,
+    providerName: effectiveProvider,
+    contextWindow: modelEntry?.contextWindow ?? 128e3,
+    maxOutput: modelEntry?.maxOutput ?? 8192,
+    fallbacks: (assignment.fallbacks ?? []).filter((fb) => !fb.demoted && fb.model !== effectiveModel)
+  };
+}
+function getEnvFallback() {
+  const providerName = readEnvWithDefault("DEFAULT_PROVIDER", "openrouter", "default LLM provider");
+  const transport = getEnv().defaultTransport;
+  const model = readEnvWithDefault("DEFAULT_MODEL", "minimax-m2.5:cloud", "default LLM model");
+  const provider = { transport };
+  if (transport === "api") {
+    provider.endpoint = providerName === "openrouter" ? "https://openrouter.ai/api/v1" : "http://localhost:11434/v1";
+    if (providerName === "openrouter") provider.apiKeyEnv = "OPENROUTER_API_KEY";
+  }
+  return { provider, providerName, model, contextWindow: 128e3, maxOutput: 8192 };
+}
+function validateAtStartup() {
+  const tc = loadTransport();
+  if (!tc) return;
+  const mc = loadModels();
+  for (const [role, assignment] of Object.entries(tc.agents)) {
+    if (!tc.providers[assignment.provider]) {
+      logWarn(TAG, `Agent "${role}": provider "${assignment.provider}" not defined in providers`);
+    }
+    const modelEntry = mc[assignment.model];
+    if (!modelEntry) {
+      logWarn(TAG, `Agent "${role}": model "${assignment.model}" not in models.json`);
+    } else if (!modelEntry.transports.includes(assignment.provider)) {
+      logWarn(TAG, `Agent "${role}": model "${assignment.model}" not listed for provider "${assignment.provider}" in models.json`);
+    }
+  }
+}
+function writeTransportConfig(tc, reason) {
+  for (const [role, agent] of Object.entries(tc.agents)) {
+    if (!agent.model?.trim()) {
+      logWarn(TAG, `Refusing to write transport.json \u2014 agent "${role}" has empty model`);
+      return;
+    }
+  }
+  const p = join(configDir(), getEnv().transportConfig);
+  const oldPath = p.replace(".json", ".old.json");
+  try {
+    const oldAge = Date.now() - statSync(oldPath).mtimeMs;
+    if (oldAge > 15 * 6e4) writeFileSync(oldPath, readFileSync(p, "utf-8"), "utf-8");
+  } catch {
+    try {
+      writeFileSync(oldPath, readFileSync(p, "utf-8"), "utf-8");
+    } catch (err) {
+      logAndSwallow(TAG, "backup transport.old.json", err);
+    }
+  }
+  writeFileSync(p, JSON.stringify(tc, null, 2), "utf-8");
+  cachedTransport = tc;
+  logInfo(TAG, reason ? `transport.json updated \u2014 ${reason}` : "transport.json updated");
+}
+function cleanDemotedModels(tc, chosenModel) {
+  for (const agent of Object.values(tc.agents)) {
+    if (agent.demoted) {
+      if (agent.model === chosenModel) {
+        delete agent.demoted;
+        delete agent.demotedReason;
+        delete agent.demotedModel;
+      }
+    }
+    if (agent.fallbacks) {
+      for (const fb of agent.fallbacks) {
+        if (fb.demoted && fb.model === chosenModel) {
+          delete fb.demoted;
+          delete fb.demotedReason;
+          delete fb.demotedModel;
+        }
+      }
+    }
+  }
+}
+function demoteModel(model, reason) {
+  const tc = loadTransport();
+  if (!tc) return;
+  let found = false;
+  for (const agent of Object.values(tc.agents)) {
+    if (agent.model === model) {
+      agent.demoted = (/* @__PURE__ */ new Date()).toISOString();
+      agent.demotedReason = reason;
+      agent.demotedModel = model;
+      found = true;
+    }
+    for (const fb of agent.fallbacks ?? []) {
+      if (fb.model === model) {
+        fb.demoted = (/* @__PURE__ */ new Date()).toISOString();
+        fb.demotedReason = reason;
+        fb.demotedModel = model;
+        found = true;
+      }
+    }
+  }
+  if (found) writeTransportConfig(tc, `auto-demote ${model} (${reason})`);
+}
+function restorePrevious() {
+  const dir = configDir();
+  const activePath = join(dir, getEnv().transportConfig);
+  const oldPath = activePath.replace(".json", ".old.json");
+  if (!existsSync(oldPath)) return { ok: false, error: "Nothing to restore \u2014 no previous config saved." };
+  try {
+    const current = readFileSync(activePath, "utf-8");
+    const old = readFileSync(oldPath, "utf-8");
+    writeFileSync(activePath, old, "utf-8");
+    writeFileSync(oldPath, current, "utf-8");
+    cachedTransport = null;
+    logInfo(TAG, "transport.json swapped with .old (restore)");
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: `Restore failed: ${err instanceof Error ? err.message : String(err)}` };
+  }
+}
+function resetToDefaults() {
+  const dir = configDir();
+  const defaultPath = join(dir, "transport.default.json");
+  const activePath = join(dir, getEnv().transportConfig);
+  try {
+    try {
+      writeFileSync(activePath.replace(".json", ".old.json"), readFileSync(activePath, "utf-8"), "utf-8");
+    } catch (err) {
+      logAndSwallow("transport_config", "op", err);
+    }
+    const defaults = readFileSync(defaultPath, "utf-8");
+    writeFileSync(activePath, defaults, "utf-8");
+    cachedTransport = null;
+    logInfo(TAG, "transport.json reset to defaults (old saved as .old.json)");
+    return true;
+  } catch (err) {
+    logWarn(TAG, `No transport.default.json \u2014 keeping current config: ${err instanceof Error ? err.message : String(err)}`);
+    return false;
+  }
+}
+function getAvailableProviders(tc) {
+  return Object.entries(tc.providers).map(([name, config]) => ({ name, config }));
+}
+function loadProviderDefaults(providerName, tc) {
+  const config = tc ?? loadTransport();
+  if (!config) return null;
+  const provider = config.providers[providerName];
+  if (!provider?.defaults) return null;
+  const defaults = provider.defaults;
+  if (!defaults["professor"]) return null;
+  const profModel = defaults["professor"].model;
+  const result = { ...defaults };
+  for (const role of ["dreamy", "browsie", "coding"]) {
+    if (!result[role]) result[role] = { model: profModel };
+  }
+  return result;
+}
+function getModelsForProvider(providerName, models) {
+  const mc = models ?? loadModels();
+  return Object.entries(mc).filter(([, entry]) => entry.transports.includes(providerName)).map(([id, entry]) => ({ id, entry })).sort((a, b) => a.entry.rank - b.entry.rank || a.entry.cost.input - b.entry.cost.input);
+}
+function formatRank(rank) {
+  const stars = Math.max(1, Math.min(5, 6 - rank));
+  return "\u2605".repeat(stars) + "\u2606".repeat(5 - stars);
+}
+function formatCost(cost) {
+  if (cost.input === 0 && cost.output === 0) return "free";
+  const inp = `$${cost.input}`;
+  const out = cost.output != null ? `$${cost.output}` : "$???";
+  return `${inp}/${out}`;
+}
+function validateProviderReady(providerName, provider, env) {
+  if (provider.transport === "tmux") return { ok: true };
+  if (provider.transport === "api") {
+    if (!provider.apiKeyEnv) return { ok: true };
+    const key = env.getApiKey(provider.apiKeyEnv);
+    if (!key) {
+      return {
+        ok: false,
+        reason: `${providerName} requires API key from env var '${provider.apiKeyEnv}' but it's not set`,
+        fix: `Add ${provider.apiKeyEnv}=... to .env and restart`
+      };
+    }
+    return { ok: true };
+  }
+  if (provider.transport === "acp") {
+    const cli = provider.cli;
+    if (!cli) {
+      return {
+        ok: false,
+        reason: `ACP provider ${providerName} has no 'cli' field set in transport.json`,
+        fix: `Add "cli": "<path-to-cli>" to provider ${providerName} in transport.json`
+      };
+    }
+    try {
+      const { execSync } = __require("node:child_process");
+      execSync(`${cli} --version`, { timeout: 3e3, stdio: "pipe" });
+      return { ok: true };
+    } catch (err) {
+      const errMsg = err instanceof Error ? err.message.split("\n")[0] : String(err);
+      return {
+        ok: false,
+        reason: `ACP provider ${providerName} CLI '${cli}' is not runnable (${errMsg})`,
+        fix: `Install ${cli} or update its path in transport.json`
+      };
+    }
+  }
+  return {
+    ok: false,
+    reason: `Unknown transport type '${provider.transport}' for provider ${providerName}`,
+    fix: `Use 'api', 'acp', or 'tmux' for provider.transport`
+  };
+}
+function formatValidationError(providerName, result) {
+  if (result.ok) return "";
+  return `\u274C Cannot switch to ${providerName}: ${result.reason}
+   Fix: ${result.fix}`;
+}
+
+export {
+  configDir,
+  loadModels,
+  loadTransport,
+  resolveHailMary,
+  clearTransportCache,
+  consumeRepairs,
+  validateAndRepair,
+  resolveAgent,
+  getEnvFallback,
+  validateAtStartup,
+  writeTransportConfig,
+  cleanDemotedModels,
+  demoteModel,
+  restorePrevious,
+  resetToDefaults,
+  getAvailableProviders,
+  loadProviderDefaults,
+  getModelsForProvider,
+  formatRank,
+  formatCost,
+  validateProviderReady,
+  formatValidationError
+};
+//# sourceMappingURL=chunk-Y6XAEX2Q.js.map

package/bundle/chunk-Y6XAEX2Q.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/components/transport-config.ts"],
+  "sourcesContent": ["import { logAndSwallow } from \"./log-and-swallow.js\";\nimport { getEnv } from \"./env-schema.js\";\nimport { validateShape, TRANSPORT_SCHEMA } from \"./config-validator.js\";\n/**\n * transport-config.ts \u2014 Load and validate transport.json + models.json.\n * Falls back to .env defaults if JSON is broken.\n */\n\nimport { readFileSync, writeFileSync, existsSync, statSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { abtarsHome } from \"../paths.js\";\nimport { readEnvWithDefault } from \"./env.js\";\nimport { logInfo, logWarn, logError } from \"./logger.js\";\n\nconst TAG = \"transport-config\";\n\n// \u2500\u2500 Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type ModelCost = { input: number; output: number };\n\nexport type ModelEntry = {\n  contextWindow: number;\n  maxOutput: number;\n  rank: number;\n  cost: ModelCost;\n  transports: string[];\n  description?: string;\n  addedAt?: string;\n  validatedAt?: string;\n  status?: \"alive\" | \"dead\" | \"untested\";\n};\n\nexport type ModelCatalog = Record<string, ModelEntry>;\n\nexport type AgentAssignment = {\n  model: string;\n  provider: string;\n  fallbacks?: Array<{ model: string; provider: string }>;\n};\n\nexport type ProviderConfig = {\n  transport: \"acp\" | \"tmux\" | \"api\";\n  cli?: string;\n  endpoint?: string;\n  apiKeyEnv?: string;\n  apiFormat?: \"chat\" | \"responses\" | \"anthropic\";\n  thinking?: { style: \"effort\"; default: string } | { style: \"extended\"; default: number };\n  defaults?: Record<string, { model: string; fallbacks?: string[] }>;\n  fallbackChain?: string[];\n};\n\nexport type TransportDefaults = {\n  tmux?: { session?: string; captureDelaySec?: number; maxWaitSec?: number };\n  acp?: { permissionTimeoutMs?: number };\n};\n\nimport type { HealthPolicyConfig } from \"./transport/model-health-registry.js\";\n\nexport type TransportConfig = {\n  agents: Record<string, AgentAssignment>;\n  providers: Record<string, ProviderConfig>;\n  transportDefaults?: TransportDefaults;\n  maxTurns?: number;\n  hailMary?: { model: string; provider: string };\n  healthPolicy?: HealthPolicyConfig;\n};\n\nexport type ResolvedAgent = {\n  model: string;\n  provider: ProviderConfig;\n  providerName: string;\n  contextWindow: number;\n  maxOutput: number;\n  fallbacks: Array<{ model: string; provider: string }>;\n};\n\n// \u2500\u2500 Loaders \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nlet cachedTransport: TransportConfig | null = null;\n\nexport function configDir(): string {\n  return join(abtarsHome(), \"config\");\n}\n\nexport function loadModels(): ModelCatalog {\n  const p = join(configDir(), getEnv().modelsConfig);\n  try {\n    return JSON.parse(readFileSync(p, \"utf-8\")) as ModelCatalog;\n  } catch (err) {\n    logWarn(TAG, `Failed to load models.json: ${err instanceof Error ? err.message : String(err)}`);\n    return {};\n  }\n}\n\nexport function loadTransport(): TransportConfig | null {\n  if (cachedTransport) return cachedTransport;\n  const dir = configDir();\n  const p = join(dir, getEnv().transportConfig);\n  try {\n    cachedTransport = JSON.parse(readFileSync(p, \"utf-8\")) as TransportConfig;\n    validateShape(cachedTransport, TRANSPORT_SCHEMA, \"transport.json\");\n    logInfo(TAG, `Loaded transport config (${Object.keys(cachedTransport.agents).length} agents, ${Object.keys(cachedTransport.providers).length} providers)`);\n    const repairs = validateAndRepair(cachedTransport);\n    if (repairs.length > 0) {\n      for (const r of repairs) logWarn(TAG, `Auto-repaired: ${r.agent} was on ${r.oldProvider} \u2014 ${r.reason}`);\n      writeTransportConfig(cachedTransport, `invariant auto-repair (${repairs.length} agents)`);\n      pendingRepairs = repairs;\n    }\n    return cachedTransport;\n  } catch (err) {\n    logAndSwallow(TAG, \"loadTransport parse\", err);\n    // Fallback to transport.default.json\n    try {\n      cachedTransport = JSON.parse(readFileSync(join(dir, \"transport.default.json\"), \"utf-8\")) as TransportConfig;\n      logWarn(TAG, `transport.json missing/corrupt \u2014 loaded transport.default.json`);\n      return cachedTransport;\n    } catch (err) {\n      logError(TAG, `No transport config available: ${err instanceof Error ? err.message : String(err)}`);\n      return null;\n    }\n  }\n}\n\n/** Resolve hailMary from transport.json. Returns null if not configured. */\nexport function resolveHailMary(transport?: TransportConfig | null): { model: string; endpoint: string; apiKeyEnv?: string } | null {\n  const tc = transport ?? loadTransport();\n  if (!tc?.hailMary) return null;\n  const provider = tc.providers[tc.hailMary.provider];\n  if (!provider?.endpoint) return null;\n  return { model: tc.hailMary.model, endpoint: provider.endpoint, apiKeyEnv: provider.apiKeyEnv };\n}\n\n/** Force re-read on next call (for tests). */\nexport function clearTransportCache(): void {\n  cachedTransport = null;\n}\n\n// \u2500\u2500 Invariant validation \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type RepairEntry = { agent: string; oldProvider: string; reason: string };\n\n/** Stashed repairs from last loadTransport() \u2014 consumed by model-health task. */\nlet pendingRepairs: RepairEntry[] = [];\nexport function consumeRepairs(): RepairEntry[] {\n  const r = pendingRepairs;\n  pendingRepairs = [];\n  return r;\n}\n\n/**\n * Validate transport invariant: all agents must share professor's transport type.\n * For acp/tmux, provider name must also match (single child process).\n * Violations are auto-repaired (subagent reset to professor's assignment).\n */\nexport function validateAndRepair(tc: TransportConfig): RepairEntry[] {\n  const profAssignment = tc.agents[\"professor\"];\n  if (!profAssignment) return [];\n  const profProvider = tc.providers[profAssignment.provider];\n  if (!profProvider) return [];\n\n  const profType = profProvider.transport;\n  const repairs: RepairEntry[] = [];\n\n  for (const [agent, assignment] of Object.entries(tc.agents)) {\n    if (agent === \"professor\") continue;\n    const provider = tc.providers[assignment.provider];\n    if (!provider) continue;\n\n    const agentType = provider.transport;\n    let violation = false;\n\n    if (agentType !== profType) {\n      // Cross-transport-type violation\n      violation = true;\n    } else if (profType !== \"api\" && assignment.provider !== profAssignment.provider) {\n      // ACP/tmux: must share exact provider (single child process)\n      violation = true;\n    }\n\n    if (violation) {\n      repairs.push({ agent, oldProvider: assignment.provider, reason: `${provider.transport} incompatible with professor (${profType}/${profAssignment.provider})` });\n      tc.agents[agent] = { model: profAssignment.model, provider: profAssignment.provider };\n    }\n  }\n\n  // Validate professor fallbacks \u2014 must also match professor's transport type\n  const fallbacks = profAssignment.fallbacks;\n  if (fallbacks) {\n    for (let i = fallbacks.length - 1; i >= 0; i--) {\n      const fb = fallbacks[i]!;\n      const fbProvider = tc.providers[fb.provider];\n      if (!fbProvider) continue;\n      const fbType = fbProvider.transport;\n      if (fbType !== profType || (profType !== \"api\" && fb.provider !== profAssignment.provider)) {\n        repairs.push({ agent: `professor_fb${i + 1}`, oldProvider: fb.provider, reason: `fallback ${fbProvider.transport} incompatible with professor (${profType}/${profAssignment.provider})` });\n        fallbacks.splice(i, 1);\n      }\n    }\n  }\n\n  // hailMary is exempt \u2014 manual emergency override that rebuilds transport\n\n  return repairs;\n}\n\n// \u2500\u2500 Resolution \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport function resolveAgent(role: string, transport?: TransportConfig | null, models?: ModelCatalog): ResolvedAgent | null {\n  const tc = transport ?? loadTransport();\n  if (!tc) return null;\n\n  // cron inherits professor\n  const effectiveRole = role === \"task\" ? \"professor\" : role;\n  const assignment = tc.agents[effectiveRole];\n  if (!assignment) {\n    logWarn(TAG, `No agent assignment for role \"${role}\"`);\n    return null;\n  }\n\n  const providers = tc.providers;\n  // If primary is demoted AND the demoted model matches current, promote first non-demoted fallback\n  let effectiveModel = assignment.model;\n  let effectiveProvider = assignment.provider;\n  const demotedModel = (assignment as any).demotedModel ?? assignment.model;\n  if ((assignment as any).demoted && demotedModel === assignment.model) {\n    const firstHealthy = (assignment.fallbacks ?? []).find((fb: any) => !fb.demoted);\n    if (firstHealthy) {\n      effectiveModel = firstHealthy.model;\n      effectiveProvider = firstHealthy.provider;\n    } else {\n      logWarn(TAG, `All models demoted for role \"${role}\" \u2014 using primary anyway`);\n    }\n  }\n\n  const resolvedProvider = providers[effectiveProvider];\n  if (!resolvedProvider) {\n    logWarn(TAG, `Provider \"${effectiveProvider}\" not found for role \"${role}\"`);\n    return null;\n  }\n\n  const mc = models ?? loadModels();\n  const modelEntry = mc[effectiveModel];\n  if (!modelEntry && effectiveModel) {\n    logWarn(TAG, `Model \"${effectiveModel}\" not in models.json \u2014 using defaults`);\n  }\n\n  return {\n    model: effectiveModel,\n    provider: resolvedProvider,\n    providerName: effectiveProvider,\n    contextWindow: modelEntry?.contextWindow ?? 128000,\n    maxOutput: modelEntry?.maxOutput ?? 8192,\n    fallbacks: (assignment.fallbacks ?? []).filter((fb: any) => !fb.demoted && fb.model !== effectiveModel),\n  };\n}\n\n// \u2500\u2500 Fallback from .env \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type EnvFallback = {\n  provider: ProviderConfig;\n  providerName: string;\n  model: string;\n  contextWindow: number;\n  maxOutput: number;\n};\n\nexport function getEnvFallback(): EnvFallback {\n  const providerName = readEnvWithDefault(\"DEFAULT_PROVIDER\", \"openrouter\", \"default LLM provider\");\n  const transport = getEnv().defaultTransport as \"api\" | \"acp\" | \"tmux\";\n  const model = readEnvWithDefault(\"DEFAULT_MODEL\", \"minimax-m2.5:cloud\", \"default LLM model\");\n\n  const provider: ProviderConfig = { transport };\n  if (transport === \"api\") {\n    provider.endpoint = providerName === \"openrouter\"\n      ? \"https://openrouter.ai/api/v1\"\n      : \"http://localhost:11434/v1\";\n    if (providerName === \"openrouter\") provider.apiKeyEnv = \"OPENROUTER_API_KEY\";\n  }\n\n  return { provider, providerName, model, contextWindow: 128000, maxOutput: 8192 };\n}\n\n// \u2500\u2500 Validation (startup) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport function validateAtStartup(): void {\n  const tc = loadTransport();\n  if (!tc) return;\n  const mc = loadModels();\n\n  for (const [role, assignment] of Object.entries(tc.agents)) {\n    if (!tc.providers[assignment.provider]) {\n      logWarn(TAG, `Agent \"${role}\": provider \"${assignment.provider}\" not defined in providers`);\n    }\n    const modelEntry = mc[assignment.model];\n    if (!modelEntry) {\n      logWarn(TAG, `Agent \"${role}\": model \"${assignment.model}\" not in models.json`);\n    } else if (!modelEntry.transports.includes(assignment.provider)) {\n      logWarn(TAG, `Agent \"${role}\": model \"${assignment.model}\" not listed for provider \"${assignment.provider}\" in models.json`);\n    }\n  }\n}\n\n// \u2500\u2500 Write \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport function writeTransportConfig(tc: TransportConfig, reason?: string): void {\n  // Guard: reject empty model strings before persisting\n  for (const [role, agent] of Object.entries(tc.agents)) {\n    if (!agent.model?.trim()) {\n      logWarn(TAG, `Refusing to write transport.json \u2014 agent \"${role}\" has empty model`);\n      return;\n    }\n  }\n  const p = join(configDir(), getEnv().transportConfig);\n  // Save current as .old before overwriting (enables /model restore)\n  // Only overwrite .old if it's >15min old \u2014 preserves last-known-good during rapid changes\n  const oldPath = p.replace(\".json\", \".old.json\");\n  try {\n    const oldAge = Date.now() - statSync(oldPath).mtimeMs;\n    if (oldAge > 15 * 60_000) writeFileSync(oldPath, readFileSync(p, \"utf-8\"), \"utf-8\");\n  } catch { try { writeFileSync(oldPath, readFileSync(p, \"utf-8\"), \"utf-8\"); } catch (err) { logAndSwallow(TAG, \"backup transport.old.json\", err); } }\n  writeFileSync(p, JSON.stringify(tc, null, 2), \"utf-8\");\n  cachedTransport = tc;\n  logInfo(TAG, reason ? `transport.json updated \u2014 ${reason}` : \"transport.json updated\");\n}\n\n/** Remove demoted models from config. Called on user-initiated model switch.\n *  Models the user just chose are resurrected (demotion cleared). All other demoted entries are deleted. */\nexport function cleanDemotedModels(tc: TransportConfig, chosenModel?: string): void {\n  for (const agent of Object.values(tc.agents)) {\n    if ((agent as any).demoted) {\n      if (agent.model === chosenModel) { delete (agent as any).demoted; delete (agent as any).demotedReason; delete (agent as any).demotedModel; }\n    }\n    if (agent.fallbacks) {\n      for (const fb of agent.fallbacks) {\n        if ((fb as any).demoted && fb.model === chosenModel) { delete (fb as any).demoted; delete (fb as any).demotedReason; delete (fb as any).demotedModel; }\n      }\n    }\n  }\n}\n\n/** Mark a model as demoted in transport.json. Skipped by candidate loading. */\nexport function demoteModel(model: string, reason: \"auth\" | \"timeout\"): void {\n  const tc = loadTransport();\n  if (!tc) return;\n  let found = false;\n  for (const agent of Object.values(tc.agents)) {\n    if (agent.model === model) { (agent as any).demoted = new Date().toISOString(); (agent as any).demotedReason = reason; (agent as any).demotedModel = model; found = true; }\n    for (const fb of agent.fallbacks ?? []) {\n      if (fb.model === model) { (fb as any).demoted = new Date().toISOString(); (fb as any).demotedReason = reason; (fb as any).demotedModel = model; found = true; }\n    }\n  }\n  if (found) writeTransportConfig(tc, `auto-demote ${model} (${reason})`);\n}\n\n/** Swap transport.json \u2194 transport.json.old (undo last switch). */\nexport function restorePrevious(): { ok: boolean; error?: string } {\n  const dir = configDir();\n  const activePath = join(dir, getEnv().transportConfig);\n  const oldPath = activePath.replace(\".json\", \".old.json\");\n  if (!existsSync(oldPath)) return { ok: false, error: \"Nothing to restore \u2014 no previous config saved.\" };\n  try {\n    const current = readFileSync(activePath, \"utf-8\");\n    const old = readFileSync(oldPath, \"utf-8\");\n    writeFileSync(activePath, old, \"utf-8\");\n    writeFileSync(oldPath, current, \"utf-8\");\n    cachedTransport = null;\n    logInfo(TAG, \"transport.json swapped with .old (restore)\");\n    return { ok: true };\n  } catch (err) {\n    return { ok: false, error: `Restore failed: ${err instanceof Error ? err.message : String(err)}` };\n  }\n}\n\n/** Copy transport.default.json \u2192 transport.json, clear cache. Returns true if successful. */\nexport function resetToDefaults(): boolean {\n  const dir = configDir();\n  const defaultPath = join(dir, \"transport.default.json\");\n  const activePath = join(dir, getEnv().transportConfig);\n  try {\n    // Backup current before overwriting\n    try { writeFileSync(activePath.replace(\".json\", \".old.json\"), readFileSync(activePath, \"utf-8\"), \"utf-8\"); } catch (err) { logAndSwallow(\"transport_config\", \"op\", err); }\n    const defaults = readFileSync(defaultPath, \"utf-8\");\n    writeFileSync(activePath, defaults, \"utf-8\");\n    cachedTransport = null;\n    logInfo(TAG, \"transport.json reset to defaults (old saved as .old.json)\");\n    return true;\n  } catch (err) {\n    logWarn(TAG, `No transport.default.json \u2014 keeping current config: ${err instanceof Error ? err.message : String(err)}`);\n    return false;\n  }\n}\n\n// \u2500\u2500 Provider availability \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport function getAvailableProviders(tc: TransportConfig): Array<{ name: string; config: ProviderConfig }> {\n  return Object.entries(tc.providers).map(([name, config]) => ({ name, config }));\n}\n\n/** Load a provider's defaults block. Missing subagents inherit professor's model. */\nexport function loadProviderDefaults(providerName: string, tc?: TransportConfig | null): Record<string, { model: string; fallbacks?: string[] }> | null {\n  const config = tc ?? loadTransport();\n  if (!config) return null;\n  const provider = config.providers[providerName];\n  if (!provider?.defaults) return null;\n  const defaults = provider.defaults;\n  if (!defaults[\"professor\"]) return null;\n  const profModel = defaults[\"professor\"].model;\n  const result: Record<string, { model: string; fallbacks?: string[] }> = { ...defaults };\n  for (const role of [\"dreamy\", \"browsie\", \"coding\"]) {\n    if (!result[role]) result[role] = { model: profModel };\n  }\n  return result;\n}\n\n// \u2500\u2500 Model helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport function getModelsForProvider(providerName: string, models?: ModelCatalog): Array<{ id: string; entry: ModelEntry }> {\n  const mc = models ?? loadModels();\n  return Object.entries(mc)\n    .filter(([, entry]) => entry.transports.includes(providerName))\n    .map(([id, entry]) => ({ id, entry }))\n    .sort((a, b) => a.entry.rank - b.entry.rank || a.entry.cost.input - b.entry.cost.input);\n}\n\nexport function formatRank(rank: number): string {\n  const stars = Math.max(1, Math.min(5, 6 - rank));\n  return \"\u2605\".repeat(stars) + \"\u2606\".repeat(5 - stars);\n}\n\nexport function formatCost(cost: ModelCost): string {\n  if (cost.input === 0 && cost.output === 0) return \"free\";\n  const inp = `$${cost.input}`;\n  const out = cost.output != null ? `$${cost.output}` : \"$???\";\n  return `${inp}/${out}`;\n}\n\n// \u2500\u2500 Provider readiness validation (#367) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type ProviderValidationResult =\n  | { ok: true }\n  | { ok: false; reason: string; fix: string };\n\n/**\n * Minimal env accessor \u2014 just the slice validateProviderReady needs.\n * Matches the shape exposed by getEnv().\n */\nexport type EnvAccessor = {\n  getApiKey(envName: string): string | undefined;\n};\n\n/**\n * Validate that a transport provider's prerequisites are in place BEFORE the\n * bridge attempts to switch to it (#367).\n *\n * Contract:\n * - `api` + `apiKeyEnv` declared \u2192 env var must be non-empty\n * - `api` + no `apiKeyEnv` \u2192 always ok (local ollama-style)\n * - `acp` \u2192 `provider.cli` must be runnable (`<cli> --version` within 3s)\n * - `tmux` \u2192 always ok (out of scope)\n *\n * Pure aside from the ACP `execSync` probe. execSync is imported lazily so\n * unit tests can stub it via dependency injection if needed.\n */\nexport function validateProviderReady(\n  providerName: string,\n  provider: ProviderConfig,\n  env: EnvAccessor,\n): ProviderValidationResult {\n  if (provider.transport === \"tmux\") return { ok: true };\n\n  if (provider.transport === \"api\") {\n    if (!provider.apiKeyEnv) return { ok: true };\n    const key = env.getApiKey(provider.apiKeyEnv);\n    if (!key) {\n      return {\n        ok: false,\n        reason: `${providerName} requires API key from env var '${provider.apiKeyEnv}' but it's not set`,\n        fix: `Add ${provider.apiKeyEnv}=... to .env and restart`,\n      };\n    }\n    return { ok: true };\n  }\n\n  if (provider.transport === \"acp\") {\n    const cli = provider.cli;\n    if (!cli) {\n      return {\n        ok: false,\n        reason: `ACP provider ${providerName} has no 'cli' field set in transport.json`,\n        fix: `Add \\\"cli\\\": \\\"<path-to-cli>\\\" to provider ${providerName} in transport.json`,\n      };\n    }\n    try {\n      // Inline require so mocks work in tests and production stays synchronous.\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      const { execSync } = require(\"node:child_process\") as typeof import(\"node:child_process\");\n      execSync(`${cli} --version`, { timeout: 3000, stdio: \"pipe\" });\n      return { ok: true };\n    } catch (err) {\n      const errMsg = err instanceof Error ? err.message.split(\"\\n\")[0] : String(err);\n      return {\n        ok: false,\n        reason: `ACP provider ${providerName} CLI '${cli}' is not runnable (${errMsg})`,\n        fix: `Install ${cli} or update its path in transport.json`,\n      };\n    }\n  }\n\n  // Unknown transport \u2014 fail closed with a clear message.\n  return {\n    ok: false,\n    reason: `Unknown transport type '${(provider as ProviderConfig).transport}' for provider ${providerName}`,\n    fix: `Use 'api', 'acp', or 'tmux' for provider.transport`,\n  };\n}\n\n/** Format a validation failure for user-visible error messages. */\nexport function formatValidationError(providerName: string, result: ProviderValidationResult): string {\n  if (result.ok) return \"\";\n  return `\u274C Cannot switch to ${providerName}: ${result.reason}\\n   Fix: ${result.fix}`;\n}\n"],
+  "mappings": "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",
+  "names": ["err"]
+}

package/bundle/chunk-YOCTDKKL.js

@@ -0,0 +1,28 @@
+import { createRequire as __bundleCreateRequire } from 'node:module'; import { fileURLToPath as __bundleFileURLToPath } from 'node:url'; import { dirname as __bundleDirname } from 'node:path'; const require = __bundleCreateRequire(import.meta.url); const __chunk_filename = __bundleFileURLToPath(import.meta.url); const __chunk_dirname = __bundleDirname(__chunk_filename);
+import {
+  init_logger,
+  logTrace
+} from "./chunk-BUUVFUPO.js";
+
+// src/components/env.ts
+init_logger();
+var warned = /* @__PURE__ */ new Set();
+function readEnv(key, impact) {
+  const v = process.env[key];
+  if (v !== void 0 && v.trim() !== "") return v;
+  if (!warned.has(key)) {
+    warned.add(key);
+    logTrace("env", `${key} not set \u2014 ${impact}`);
+  }
+  return void 0;
+}
+function readEnvWithDefault(key, fallback, impact) {
+  const v = readEnv(key, `${impact} (falling back to "${fallback}")`);
+  return v ?? fallback;
+}
+
+export {
+  readEnv,
+  readEnvWithDefault
+};
+//# sourceMappingURL=chunk-YOCTDKKL.js.map

package/bundle/chunk-YOCTDKKL.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/components/env.ts"],
+  "sourcesContent": ["/**\n * Env var helpers.\n *\n * `readEnv(key, impact)` reads process.env[key] and warns once per process\n * per missing key. Replaces raw `process.env.X` reads \u2014 authors get\n * visibility into misconfig without polluting hot paths with per-read\n * warnings.\n *\n * The helper intentionally warns AT the first read site (lazy), not at\n * boot. Reasons:\n *   - Boot-time lists go stale; consumer-site reads can't.\n *   - New env vars auto-covered when authors reach for this helper.\n *   - Warn-once guarantees quiet hot paths (Set<string> dedup).\n *\n * For vars that MUST be set for the bridge to function (e.g. TELEGRAM_BOT_TOKEN),\n * use a boot-time fatal check instead \u2014 missing them should exit(1), not log.\n */\n\nimport { logTrace } from \"./logger.js\";\n\nconst warned = new Set<string>();\n\nexport function readEnv(key: string, impact: string): string | undefined {\n  const v = process.env[key];\n  if (v !== undefined && v.trim() !== \"\") return v;\n  if (!warned.has(key)) {\n    warned.add(key);\n    logTrace(\"env\", `${key} not set \u2014 ${impact}`);\n  }\n  return undefined;\n}\n\n/** Same as readEnv but returns a fallback when the var is unset. Still warns once. */\nexport function readEnvWithDefault(key: string, fallback: string, impact: string): string {\n  const v = readEnv(key, `${impact} (falling back to \"${fallback}\")`);\n  return v ?? fallback;\n}\n\n/** Test-only: clear the warn-once cache. */\nexport function _resetEnvWarnedForTests(): void {\n  warned.clear();\n}\n"],
+  "mappings": ";;;;;;;AAkBA;AAEA,IAAM,SAAS,oBAAI,IAAY;AAExB,SAAS,QAAQ,KAAa,QAAoC;AACvE,QAAM,IAAI,QAAQ,IAAI,GAAG;AACzB,MAAI,MAAM,UAAa,EAAE,KAAK,MAAM,GAAI,QAAO;AAC/C,MAAI,CAAC,OAAO,IAAI,GAAG,GAAG;AACpB,WAAO,IAAI,GAAG;AACd,aAAS,OAAO,GAAG,GAAG,mBAAc,MAAM,EAAE;AAAA,EAC9C;AACA,SAAO;AACT;AAGO,SAAS,mBAAmB,KAAa,UAAkB,QAAwB;AACxF,QAAM,IAAI,QAAQ,KAAK,GAAG,MAAM,sBAAsB,QAAQ,IAAI;AAClE,SAAO,KAAK;AACd;",
+  "names": []
+}