cabletidy 0.1.0 → 0.3.0-rc.2

package/src/cli.mjs

@@ -1,141 +0,0 @@
-import fs from "node:fs/promises";
-
-import {
-  getPaths,
-  loadConfig,
-  readRuntimeInfo,
-} from "./config.mjs";
-import { configurationBaseUrl } from "../web/config-identity.js";
-
-const [, , command = "status", ...args] = process.argv;
-
-async function main() {
-  if (["--help", "-h", "help"].includes(command)) {
-    printHelp();
-    return;
-  }
-
-  if (["--version", "-v"].includes(command)) {
-    const metadata = JSON.parse(await fs.readFile(new URL("../package.json", import.meta.url), "utf8"));
-    console.log(metadata.version);
-    return;
-  }
-
-  if (command === "start") {
-    if (args.length) throw new Error("用法: cabletidy start");
-    const { startDaemon } = await import("./server.mjs");
-    await startDaemon();
-    return;
-  }
-
-  const paths = getPaths();
-
-  if (command === "status") {
-    const [config, runtime] = await Promise.all([loadConfig(paths), readRuntimeInfo(paths)]);
-    const daemon = runtime ? await probeDaemon(runtime) : { online: false, reason: "runtime.json 不存在" };
-    const web = runtime?.web || {
-      host: config.web.listenHost,
-      port: config.web.port,
-    };
-    print({
-      configRevision: config.revision,
-      runtime: runtime
-        ? { ...runtime, web: { ...web, url: web.url || webUrl(web) }, status: daemon.online ? "online" : "offline", liveness: daemon.reason }
-        : { web: { ...web, url: webUrl(web) }, status: "offline", liveness: daemon.reason },
-      configurations: Object.entries(config.bindings).map(([id, binding]) => {
-        const provider = config.virtualProviders[binding.virtualProvider];
-        return {
-          id,
-          name: binding.name || id,
-          target: binding.target,
-          url: `${configurationBaseUrl(config, id)}/v1`,
-          enabled: binding.enabled !== false && provider?.enabled !== false,
-        };
-      }),
-    });
-    return;
-  }
-
-  console.error(`未知命令: ${[command, ...args].join(" ")}`);
-  printHelp();
-  process.exitCode = 1;
-}
-
-function printHelp() {
-  console.log(`CableTidy CLI
-
-Usage: cabletidy <command>
-
-Commands:
-  start                       Start the daemon in the foreground
-  --help, -h                  Show this help
-  --version, -v               Print the installed version
-  status                      Show daemon status and management URL
-
-Data: CABLETIDY_HOME or ~/.cabletidy
-No command: show status
-`);
-}
-
-async function probeDaemon(runtime) {
-  const pid = Number(runtime.pid);
-  if (!Number.isInteger(pid) || pid <= 0) {
-    return { online: false, reason: "CableTidy runtime.json 无有效 daemon PID，请重新执行 cabletidy start" };
-  }
-  try {
-    process.kill(pid, 0);
-  } catch (error) {
-    return { online: false, reason: `CableTidy daemon 不在线（PID ${pid}）：${error.message}` };
-  }
-
-  const web = runtime.web || {};
-  const host = web.host || "127.0.0.1";
-  const port = Number(web.port);
-  if (!Number.isInteger(port) || port < 1 || port > 65535) {
-    return { online: false, reason: "CableTidy runtime.json 无有效 Web 端口，请重新执行 cabletidy start" };
-  }
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), 1500);
-  try {
-    const response = await fetch(`http://${formatHostForUrl(host)}:${port}/api/v1/runtime`, {
-      signal: controller.signal,
-    });
-    // The Web console is loopback-only and has no management session. A 200
-    // response with the CableTidy marker proves the daemon is alive.
-    if (response.status !== 200 || response.headers.get("x-cabletidy") !== "cabletidy") {
-      return {
-        online: false,
-        reason: `CableTidy Web runtime probe 返回异常响应（HTTP ${response.status}）`,
-      };
-    }
-    return { online: true, reason: `Web runtime probe 正常（PID ${pid}）` };
-  } catch (error) {
-    if (error.name === "AbortError") {
-      return { online: false, reason: "CableTidy daemon Web 管理台无响应，请重新执行 cabletidy start" };
-    }
-    return { online: false, reason: `CableTidy daemon Web 管理台不可达：${error.message}` };
-  } finally {
-    clearTimeout(timeout);
-  }
-}
-
-function formatHostForUrl(host) {
-  const value = String(host || "127.0.0.1");
-  if (value.includes(":") && !value.startsWith("[")) return `[${value}]`;
-  return value;
-}
-
-function webUrl(web = {}) {
-  const host = formatHostForUrl(web.host || "127.0.0.1");
-  const port = Number(web.port || 43100);
-  return `http://${host}:${port}/`;
-}
-
-function print(value) {
-  console.log(JSON.stringify(value, null, 2));
-}
-
-main().catch((error) => {
-  console.error(error.stack || error.message);
-  process.exitCode = 1;
-});

package/src/codex-catalog.mjs

@@ -1,227 +0,0 @@
-import { spawn } from "node:child_process";
-import { clientModelIdForProfile, effectiveCapabilities } from "./model-resolver.mjs";
-
-let cached;
-let pending;
-let activeCommand;
-
-async function executeCodex(args) {
-  const timeout = AbortSignal.timeout(15_000);
-  const command = spawn("codex", args, {
-    windowsHide: true,
-    stdio: ["ignore", "pipe", "pipe"],
-    // Keep npm launcher descendants in a group we can stop on forced daemon exit.
-    detached: process.platform !== "win32",
-  });
-  activeCommand = command;
-  const closed = new Promise(resolve => {
-    command.once("close", (code, signal) => resolve({ code, signal }));
-  });
-  let onTimeout;
-  const completed = new Promise((resolve, reject) => {
-    command.once("error", reject);
-    command.once("exit", (code, signal) => {
-      if (code !== 0) reject(new Error(`codex exited with ${signal || code}`));
-    });
-    // Descendants may hold the pipes open after the launcher has exited.
-    onTimeout = () => reject(timeout.reason);
-    timeout.addEventListener("abort", onTimeout, { once: true });
-    closed.then(resolve);
-  });
-  const output = [readCommandOutput(command.stdout), readCommandOutput(command.stderr)];
-  try {
-    const [, stdout] = await Promise.all([completed, ...output]);
-    return { stdout };
-  } catch (error) {
-    forceStopCodexCatalog();
-    await Promise.allSettled([closed, ...output]);
-    throw error;
-  } finally {
-    timeout.removeEventListener("abort", onTimeout);
-    activeCommand = undefined;
-  }
-}
-
-async function readCommandOutput(stream) {
-  const chunks = [];
-  let size = 0;
-  for await (const chunk of stream) {
-    size += chunk.length;
-    if (size > 16 * 1024 * 1024) throw new Error("codex output exceeded 16 MiB");
-    chunks.push(chunk);
-  }
-  return Buffer.concat(chunks).toString("utf8");
-}
-
-export function forceStopCodexCatalog() {
-  if (!activeCommand?.pid) return;
-  try {
-    if (process.platform === "win32") activeCommand.kill("SIGKILL");
-    else process.kill(-activeCommand.pid, "SIGKILL");
-  } catch (error) {
-    if (error.code !== "ESRCH") throw error;
-  }
-}
-
-export function validateCatalog(value) {
-  if (!value || !Array.isArray(value.models) || !value.models.length) {
-    throw new Error("Codex 模型目录为空或格式不受支持，请更新 Codex 后重试");
-  }
-  const names = new Set();
-  for (const model of value.models) {
-    if (!model || typeof model.slug !== "string" || !model.slug || names.has(model.slug)) {
-      throw new Error("Codex 模型目录包含无效或重复的模型 ID");
-    }
-    names.add(model.slug);
-  }
-  return value;
-}
-
-export async function loadCodexCatalog({ refresh = false } = {}) {
-  if (!refresh && cached && Date.now() - cached.loadedAt < 60_000) return structuredClone(cached);
-  if (!pending) {
-    pending = (async () => {
-      try {
-        const version = (await executeCodex(["--version"])).stdout.trim();
-        // Bundled metadata is independent of the user's catalog and never
-        // needs their upstream credentials or a remote model request.
-        const result = await executeCodex(["debug", "models", "--bundled"]);
-        const catalog = validateCatalog(JSON.parse(result.stdout));
-        cached = { version, catalog, loadedAt: Date.now() };
-        return cached;
-      } catch (error) {
-        const reason = error.code === "ENOENT" ? "找不到 codex 命令" : "当前版本无法导出有效目录";
-        throw new Error(`无法读取本机 Codex 官方模型目录：${reason}。请安装或更新 Codex，并确认 daemon 的 PATH 包含 codex。`, { cause: error });
-      }
-    })().finally(() => { pending = null; });
-  }
-  return structuredClone(await pending);
-}
-
-export function officialModels(snapshot) {
-  return validateCatalog(snapshot.catalog).models.filter((model) =>
-    /^gpt-/i.test(model.slug) && model.supported_in_api === true,
-  );
-}
-
-export function defaultCapabilities(model) {
-  return [
-    "streaming", "tools", "parallel_tool_calls",
-    ...(model.supported_reasoning_levels?.length ? ["reasoning"] : []),
-    ...(model.input_modalities?.includes("image") ? ["vision"] : []),
-  ];
-}
-
-export function publicCodexCatalog(snapshot) {
-  return {
-    available: true,
-    version: snapshot.version,
-    models: officialModels(snapshot).map((model) => ({
-      id: model.slug,
-      name: model.display_name || model.slug,
-      hidden: model.visibility === "hide",
-      contextWindow: model.context_window ?? null,
-      maxContextWindow: model.max_context_window ?? model.context_window ?? null,
-      inputModalities: model.input_modalities || ["text"],
-      capabilities: defaultCapabilities(model),
-    })),
-  };
-}
-
-export function codexModelIds(config) {
-  const ids = new Set();
-  for (const binding of Object.values(config.bindings || {})) {
-    if (binding?.target !== "codex") continue;
-    for (const id of config.virtualProviders?.[binding.virtualProvider]?.allowedModels || []) ids.add(id);
-  }
-  return ids;
-}
-
-export function catalogEntryForProfile(snapshot, id, profile) {
-  const name = clientModelIdForProfile(id, profile);
-  const official = officialModels(snapshot).find((model) => model.slug === name);
-  if (!official) {
-    throw new Error(`模型 ${name} 未匹配本机 Codex 官方 GPT 目录。请选择对应的官方模型；若本机目录过旧，请更新 Codex。当前不支持非对应模型。`);
-  }
-  if (!official.base_instructions && !official.model_messages?.instructions_template) {
-    throw new Error(`官方模型 ${name} 缺少指令定义，不能生成替代提示词`);
-  }
-  const entry = structuredClone(official);
-  if (profile.codex?.metadataMode === "override") {
-    if (profile.contextWindow !== undefined) {
-      const maximum = official.max_context_window ?? official.context_window;
-      if (!Number.isSafeInteger(profile.contextWindow) || profile.contextWindow < 1 ||
-          !Number.isSafeInteger(maximum) || profile.contextWindow > maximum) {
-        throw new Error(`${name} 的 context window 必须为 1 到 ${maximum || "官方已知上限"} 之间的整数`);
-      }
-      entry.context_window = profile.contextWindow;
-      entry.max_context_window = profile.contextWindow;
-    }
-    if (profile.codex.inputModalities !== undefined) {
-      const modalities = profile.codex.inputModalities;
-      if (!Array.isArray(modalities) || !modalities.includes("text") ||
-          new Set(modalities).size !== modalities.length ||
-          modalities.some((item) => !["text", "image"].includes(item) || !official.input_modalities?.includes(item))) {
-        throw new Error(`${name} 的输入类型只能是官方已支持类型的子集，且必须保留 text`);
-      }
-      entry.input_modalities = [...modalities];
-    }
-  }
-  return { official, entry };
-}
-
-export function planCodexCatalog(config, provider, snapshot) {
-  const catalog = structuredClone(validateCatalog(snapshot.catalog));
-  const overrides = [];
-  const warnings = [];
-  const models = [];
-  const route = config.routes?.[provider.route];
-  if (route?.backends?.length !== 1) throw new Error("每份配置必须且只能连接一个 upstream");
-  for (const id of provider.allowedModels || []) {
-    const profile = config.models[id];
-    if (!profile) throw new Error(`模型不存在: ${id}`);
-    const { official, entry } = catalogEntryForProfile(snapshot, id, profile);
-    const backends = (config.routes?.[provider.route]?.backends || []).filter((backend) =>
-      backend.enabled !== false && config.upstreams?.[backend.upstream] && config.upstreams[backend.upstream].enabled !== false &&
-      (!backend.models?.length || backend.models.includes(id)),
-    );
-    if (backends.length !== 1) throw new Error(`${entry.slug} 的 Codex MVP 接入必须对应一个有效上游`);
-    if (config.upstreams[backends[0].upstream].protocol !== "openai.responses") {
-      throw new Error(`${entry.slug} 的 Codex MVP 上游必须使用 Responses 协议，暂不支持跨协议转换`);
-    }
-    const binding = profile.upstreams?.[backends[0].upstream];
-    if (Object.keys(profile.upstreams || {}).length !== 1) throw new Error(`${entry.slug} 必须且只能映射一个 upstream`);
-    if (!binding) throw new Error(`${entry.slug} 缺少上游模型设置`);
-    if (profile.codex && !effectiveCapabilities(profile, binding).has("vision") && entry.input_modalities?.includes("image")) {
-      entry.input_modalities = entry.input_modalities.filter((item) => item !== "image");
-      warnings.push(`${entry.slug} 的上游 vision 能力未启用，生成目录将禁用图片输入。`);
-    }
-    models.push(entry.slug);
-    if (JSON.stringify(entry) !== JSON.stringify(official)) {
-      catalog.models[catalog.models.findIndex((model) => model.slug === entry.slug)] = entry;
-      overrides.push(entry.slug);
-    }
-    if (!profile.codex && (profile.contextWindow || profile.compact)) {
-      warnings.push(`${entry.slug} 的旧 context window / compact 配置未同步；请在模型映射中确认元数据设置。`);
-    }
-    if (profile.compact) warnings.push(`${entry.slug} 的 compact 策略仍由 Codex 管理，CableTidy 未同步逐模型压缩配置。`);
-  }
-  return { sourceVersion: snapshot.version, catalog: overrides.length ? catalog : null, models, overrides, warnings };
-}
-
-export async function validateCodexChanges(config, previous, loadCatalog = loadCodexCatalog) {
-  const oldIds = codexModelIds(previous);
-  const changed = [...codexModelIds(config)].filter((id) =>
-    !oldIds.has(id) || JSON.stringify(config.models[id]) !== JSON.stringify(previous.models?.[id]),
-  );
-  if (!changed.length) return [];
-  let snapshot;
-  try { snapshot = await loadCatalog(); }
-  catch (error) { return [{ path: "models", message: error.message }]; }
-  const errors = [];
-  for (const id of changed) {
-    try { catalogEntryForProfile(snapshot, id, config.models[id]); }
-    catch (error) { errors.push({ path: `models.${id}`, message: error.message }); }
-  }
-  return errors;
-}

package/src/codex-config-file.mjs

@@ -1,67 +0,0 @@
-import { getStaticTOMLValue, parseTOML } from "toml-eslint-parser";
-
-export function parseCodexConfig(text) {
-  return parseTOML(text, { tomlVersion: "1.0.0" });
-}
-
-export function readCodexConfig(text) {
-  return getStaticTOMLValue(parseCodexConfig(text));
-}
-
-function keyParts(node) {
-  return node.key.keys.map((key) => key.type === "TOMLBare" ? key.name : key.value);
-}
-
-export function patchRootConfig(text, values) {
-  const body = parseCodexConfig(text).body[0].body;
-  const edits = [];
-  const additions = [];
-  for (const [key, value] of Object.entries(values)) {
-    const node = body.find((item) => item.type === "TOMLKeyValue" && keyParts(item).length === 1 && keyParts(item)[0] === key);
-    if (node) {
-      edits.push({ start: value === undefined ? node.range[0] : node.value.range[0], end: node.range[1], text: value === undefined ? "" : JSON.stringify(value) });
-    } else if (value !== undefined) additions.push(`${key} = ${JSON.stringify(value)}\n`);
-  }
-  for (const edit of edits.sort((a, b) => b.start - a.start)) {
-    text = text.slice(0, edit.start) + edit.text + text.slice(edit.end);
-  }
-  const result = additions.join("") + text;
-  parseCodexConfig(result);
-  return result;
-}
-
-export function patchProviderConfig(text, providerId, providerContents) {
-  const ast = parseCodexConfig(text);
-  const edits = [];
-  for (const node of ast.body[0].body) {
-    if (node.type !== "TOMLTable") continue;
-    const parts = node.resolvedKey || keyParts(node);
-    if (parts[0] === "model_providers" && parts[1] === providerId) {
-      edits.push({ start: node.range[0], end: node.range[1] });
-    }
-  }
-  for (const edit of edits.sort((a, b) => b.start - a.start)) {
-    text = text.slice(0, edit.start) + text.slice(edit.end);
-  }
-  // Remove only real marker comments, never matching text inside instructions.
-  const markers = parseCodexConfig(text).comments.filter((comment) =>
-    ["# >>> CABLETIDY MANAGED PROVIDER", "# <<< CABLETIDY MANAGED PROVIDER"].some((marker) =>
-      text.slice(...comment.range).startsWith(`${marker} ${providerId} `),
-    ),
-  );
-  for (const comment of markers.sort((a, b) => b.range[0] - a.range[0])) {
-    text = text.slice(0, comment.range[0]) + text.slice(comment.range[1]);
-  }
-  const updatedAst = parseCodexConfig(text);
-  const firstProvider = updatedAst.body[0].body.find((node) => {
-    if (node.type !== "TOMLTable") return false;
-    const parts = node.resolvedKey || keyParts(node);
-    return parts[0] === "model_providers";
-  });
-  const providerBlock = `${providerContents.trimEnd()}\n\n`;
-  const result = firstProvider
-    ? `${text.slice(0, firstProvider.range[0]).trimEnd()}\n\n${providerBlock}${text.slice(firstProvider.range[0])}`
-    : `${text.trimEnd()}\n\n${providerContents}`;
-  parseCodexConfig(result);
-  return result;
-}