minecodex 1.0.7 → 1.0.9

package/features/notes/web/i18n.mjs

@@ -0,0 +1,237 @@
+// i18n for CodexNotes web surfaces. Single source of all user-visible copy.
+// Locale state is initialised by app.js via setLocale(); this module never touches DOM.
+
+const SUPPORTED_LOCALES = new Set(["en", "zh-CN"]);
+
+function normalizeLocale(value) {
+  const candidate = String(value ?? "").trim();
+  if (candidate.toLowerCase().startsWith("zh")) return "zh-CN";
+  return SUPPORTED_LOCALES.has(candidate) ? candidate : "en";
+}
+
+let locale = "en";
+
+export function getLocale() {
+  return locale;
+}
+
+export function setLocale(value) {
+  const next = normalizeLocale(value);
+  if (next === locale) return false;
+  locale = next;
+  return true;
+}
+
+const MESSAGES = Object.freeze({
+  en: {
+    requestFailed: ({ status }) => `Request failed (${status})`,
+    temporarilyUnavailable: "CodexNotes is temporarily unavailable",
+    unavailable: "CodexNotes is unavailable",
+    retry: "Retry",
+    hostUnavailable: "Codex host is not connected",
+    hostTimeout: "Codex did not respond",
+    hostActionFailed: "Host action failed",
+    restoreTodo: "Restore Todo",
+    completeTodo: "Complete Todo",
+    edit: "Edit",
+    delete: "Delete",
+    editTodo: "Edit Todo",
+    newTodo: "New Todo",
+    todoText: "Todo text",
+    todoPlaceholder: "What do you want to remember?",
+    saveTodo: "Save Todo",
+    addTodo: "Add Todo",
+    cancel: "Cancel",
+    editPrompt: "Edit Prompt",
+    newPrompt: "New Prompt",
+    optionalTitle: "Optional title",
+    promptTitle: "Prompt title",
+    promptBody: "Prompt body",
+    promptPlaceholder: "Write a reusable prompt…",
+    savePrompt: "Save Prompt",
+    addPrompt: "Add Prompt",
+    insertPrompt: "Insert Prompt",
+    morePromptActions: "More prompt actions",
+    star: "Star",
+    unstar: "Unstar",
+    showInFolder: "Show in folder",
+    attachToChat: "Attach to chat",
+    viewAll: "View all",
+    todo: "Todo",
+    noTodo: "No Todo yet",
+    prompts: "Prompts",
+    noPrompts: "No prompts yet",
+    files: "Files",
+    pinFiles: "Pin files",
+    noPinnedFiles: "No pinned files",
+    active: "Active",
+    add: "Add",
+    nothingActive: "Nothing active",
+    completed: "Completed",
+    deleteAll: "Delete all",
+    deleteCompletedTitle: "Delete all completed Todo",
+    noCompletedTodo: "No completed Todo",
+    starred: "Starred",
+    noStarredPrompts: "No starred prompts",
+    pinnedFiles: "Pinned files",
+    loading: "Loading CodexNotes…",
+    insertedAtCaret: "Inserted at the Composer caret",
+    addedToComposer: "Added to Composer",
+    insertedFilePath: "Inserted file path",
+    filesPinned: ({ count }) => `${count} file${count === 1 ? "" : "s"} pinned`,
+    alreadyPinned: "Already pinned",
+    todoEmpty: "Todo text cannot be empty",
+    promptEmpty: "Prompt body cannot be empty",
+    editorItemMissing: "This item no longer exists.",
+    close: "Close",
+    invalidRequest: "The request is invalid",
+    invalidContentType: "The request must use JSON",
+    invalidJson: "The request body is not valid JSON",
+    bodyTooLarge: "The request is too large",
+    notFound: "The item was not found",
+    invalidOrder: "The Todo order is no longer current",
+    invalidUse: "The requested action could not be recorded",
+    fileUnavailable: "The file is unavailable",
+    fileMissing: "The source file no longer exists",
+    directoryNotAllowed: "Folders cannot be pinned; choose regular files",
+    pathNotAbsolute: "Only absolute paths can be pinned",
+    pickerUnavailable: "The system file picker is unavailable",
+    pickerFailed: "The system file picker could not be opened",
+    revealUnavailable: "Show in folder is unavailable on this platform",
+    revealFailed: "The file could not be shown in the system file manager",
+    previewUnavailable: "This file does not have an image preview",
+    previewTooLarge: "The image is too large to preview",
+    internalError: "CodexNotes could not complete the request",
+    actionNotAllowed: "This action is not available",
+  },
+  "zh-CN": {
+    requestFailed: ({ status }) => `请求失败（${status}）`,
+    temporarilyUnavailable: "CodexNotes 暂时不可用",
+    unavailable: "CodexNotes 不可用",
+    retry: "重试",
+    hostUnavailable: "尚未连接 Codex 宿主",
+    hostTimeout: "Codex 未响应",
+    hostActionFailed: "宿主操作失败",
+    restoreTodo: "恢复待办",
+    completeTodo: "完成待办",
+    edit: "编辑",
+    delete: "删除",
+    editTodo: "编辑待办",
+    newTodo: "新建待办",
+    todoText: "待办内容",
+    todoPlaceholder: "你想记住什么？",
+    saveTodo: "保存待办",
+    addTodo: "添加待办",
+    cancel: "取消",
+    editPrompt: "编辑提示词",
+    newPrompt: "新建提示词",
+    optionalTitle: "可选标题",
+    promptTitle: "提示词标题",
+    promptBody: "提示词正文",
+    promptPlaceholder: "编写一条可复用的提示词…",
+    savePrompt: "保存提示词",
+    addPrompt: "添加提示词",
+    insertPrompt: "插入提示词",
+    morePromptActions: "更多提示词操作",
+    star: "收藏",
+    unstar: "取消收藏",
+    showInFolder: "在文件夹中显示",
+    attachToChat: "添加到对话",
+    viewAll: "查看全部",
+    todo: "待办",
+    noTodo: "暂无待办",
+    prompts: "提示词",
+    noPrompts: "暂无提示词",
+    files: "文件",
+    pinFiles: "固定文件",
+    noPinnedFiles: "暂无固定文件",
+    active: "进行中",
+    add: "添加",
+    nothingActive: "暂无进行中的待办",
+    completed: "已完成",
+    deleteAll: "全部删除",
+    deleteCompletedTitle: "删除全部已完成待办",
+    noCompletedTodo: "暂无已完成待办",
+    starred: "已收藏",
+    noStarredPrompts: "暂无收藏的提示词",
+    pinnedFiles: "已固定文件",
+    loading: "正在加载 CodexNotes…",
+    insertedAtCaret: "已插入到消息输入框光标处",
+    addedToComposer: "已添加到消息输入框",
+    insertedFilePath: "已插入文件路径",
+    filesPinned: ({ count }) => `已固定 ${count} 个文件`,
+    alreadyPinned: "文件已固定",
+    todoEmpty: "待办内容不能为空",
+    promptEmpty: "提示词正文不能为空",
+    editorItemMissing: "该项目已不存在。",
+    close: "关闭",
+    invalidRequest: "请求无效",
+    invalidContentType: "请求必须使用 JSON",
+    invalidJson: "请求正文不是有效的 JSON",
+    bodyTooLarge: "请求内容过大",
+    notFound: "找不到该项目",
+    invalidOrder: "待办顺序已发生变化",
+    invalidUse: "无法记录这次操作",
+    fileUnavailable: "文件不可用",
+    fileMissing: "源文件已不存在",
+    directoryNotAllowed: "不能固定文件夹，请选择普通文件",
+    pathNotAbsolute: "只能固定绝对路径",
+    pickerUnavailable: "系统文件选择器不可用",
+    pickerFailed: "无法打开系统文件选择器",
+    revealUnavailable: "当前平台不支持在文件夹中显示",
+    revealFailed: "无法在系统文件管理器中显示该文件",
+    previewUnavailable: "该文件没有图片预览",
+    previewTooLarge: "图片过大，无法预览",
+    internalError: "CodexNotes 无法完成请求",
+    actionNotAllowed: "当前操作不可用",
+  },
+});
+
+export function t(key, params = {}) {
+  const value = MESSAGES[locale]?.[key] ?? MESSAGES.en[key] ?? key;
+  return typeof value === "function" ? value(params) : value;
+}
+
+const ERROR_MESSAGE_KEYS = Object.freeze({
+  ACTION_NOT_ALLOWED: "actionNotAllowed",
+  BODY_TOO_LARGE: "bodyTooLarge",
+  DIRECTORY_NOT_ALLOWED: "directoryNotAllowed",
+  EMPTY_BODY: "invalidRequest",
+  FILE_MISSING: "fileMissing",
+  FILE_UNAVAILABLE: "fileUnavailable",
+  HOST_ACTION_FAILED: "hostActionFailed",
+  HOST_NOT_ALLOWED: "actionNotAllowed",
+  HOST_TIMEOUT: "hostTimeout",
+  HOST_UNAVAILABLE: "hostUnavailable",
+  INTERNAL_ERROR: "internalError",
+  INVALID_BODY: "invalidRequest",
+  INVALID_CHANGES: "invalidRequest",
+  INVALID_COMPLETED: "invalidRequest",
+  INVALID_CONTENT_TYPE: "invalidContentType",
+  INVALID_ID: "invalidRequest",
+  INVALID_JSON: "invalidJson",
+  INVALID_ORDER: "invalidOrder",
+  INVALID_PATHS: "invalidRequest",
+  INVALID_REQUEST: "invalidRequest",
+  INVALID_SURFACE: "invalidRequest",
+  INVALID_ORIGIN: "actionNotAllowed",
+  INVALID_STAR: "invalidRequest",
+  INVALID_TITLE: "invalidRequest",
+  INVALID_USE: "invalidUse",
+  NOT_FOUND: "notFound",
+  ORIGIN_NOT_ALLOWED: "actionNotAllowed",
+  PATH_NOT_ABSOLUTE: "pathNotAbsolute",
+  PICKER_FAILED: "pickerFailed",
+  PICKER_UNAVAILABLE: "pickerUnavailable",
+  PREVIEW_TOO_LARGE: "previewTooLarge",
+  PREVIEW_UNAVAILABLE: "previewUnavailable",
+  REVEAL_FAILED: "revealFailed",
+  REVEAL_UNAVAILABLE: "revealUnavailable",
+});
+
+export function localizedErrorMessage(code, fallback, params = {}) {
+  const key = ERROR_MESSAGE_KEYS[code];
+  return key ? t(key, params) : fallback;
+}
+
+export { SUPPORTED_LOCALES, normalizeLocale };

package/features/notes/web/todo-drag.mjs

@@ -0,0 +1,18 @@
+// Todo 拖拽排序纯算法：drop 位置判定与顺序重排。
+// 不触碰 DOM/状态，仅输入计算；app.js 的拖拽事件处理调用它们。
+
+function todoDropPosition(event, row) {
+  const rect = row.getBoundingClientRect();
+  return event.clientY < rect.top + rect.height / 2 ? "before" : "after";
+}
+
+function reorderedTodoIds(ids, draggedId, targetId, position) {
+  if (!ids.includes(draggedId) || !ids.includes(targetId) || draggedId === targetId) return ids;
+  const reordered = ids.filter((id) => id !== draggedId);
+  const targetIndex = reordered.indexOf(targetId);
+  const insertAt = targetIndex + (position === "after" ? 1 : 0);
+  reordered.splice(insertAt, 0, draggedId);
+  return reordered;
+}
+
+export { todoDropPosition, reorderedTodoIds };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minecodex",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",

package/packages/runtime-host/src/codex-cdp.mjs

@@ -0,0 +1,153 @@
+// CDP (Chrome DevTools Protocol) 客户端：WebSocket 连接、表达式求值与进程等待。
+// 与注入内容无关；CodexRuntime 通过这里的 connectClient 与 Codex Renderer 通信。
+export async function connect(url) {
+  const socket = new WebSocket(url);
+  const pending = new Map();
+  const eventWaiters = new Map();
+  const eventListeners = new Map();
+  let nextId = 1;
+
+  await new Promise((resolve, reject) => {
+    socket.addEventListener("open", resolve, { once: true });
+    socket.addEventListener("error", reject, { once: true });
+  });
+  socket.addEventListener("message", (event) => {
+    const message = JSON.parse(String(event.data));
+    if (!message.id) {
+      for (const listener of eventListeners.get(message.method) ?? []) listener(message.params);
+      const waiters = eventWaiters.get(message.method) ?? [];
+      eventWaiters.delete(message.method);
+      for (const waiter of waiters) waiter.resolve(message.params);
+      return;
+    }
+    const request = pending.get(message.id);
+    if (!request) return;
+    pending.delete(message.id);
+    if (message.error) request.reject(new Error(message.error.message));
+    else request.resolve(message.result);
+  });
+  socket.addEventListener("close", () => {
+    const error = new Error("CDP WebSocket closed");
+    for (const request of pending.values()) request.reject(error);
+    pending.clear();
+    for (const waiters of eventWaiters.values()) {
+      for (const waiter of waiters) waiter.reject(error);
+    }
+    eventWaiters.clear();
+    eventListeners.clear();
+  });
+
+  return {
+    socket,
+    send(method, params = {}) {
+      const id = nextId++;
+      return new Promise((resolve, reject) => {
+        pending.set(id, { resolve, reject });
+        socket.send(JSON.stringify({ id, method, params }));
+      });
+    },
+    on(method, listener) {
+      const listeners = eventListeners.get(method) ?? new Set();
+      listeners.add(listener);
+      eventListeners.set(method, listeners);
+      return () => listeners.delete(listener);
+    },
+    waitFor(method, timeoutMs) {
+      return new Promise((resolve, reject) => {
+        const waiters = eventWaiters.get(method) ?? [];
+        const waiter = {
+          resolve(value) {
+            clearTimeout(timeout);
+            resolve(value);
+          },
+          reject,
+        };
+        const timeout = setTimeout(() => {
+          const remaining = (eventWaiters.get(method) ?? []).filter((item) => item !== waiter);
+          if (remaining.length) eventWaiters.set(method, remaining);
+          else eventWaiters.delete(method);
+          reject(new Error(`Timed out waiting for CDP event ${method}`));
+        }, timeoutMs);
+        waiters.push(waiter);
+        eventWaiters.set(method, waiters);
+      });
+    },
+  };
+}
+
+export async function waitForExpression(client, expression, timeoutMs = 20_000) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      const result = await client.send("Runtime.evaluate", { expression, returnByValue: true });
+      if (result.result?.value) return;
+    } catch {
+      // Reloading briefly destroys the previous execution context.
+    }
+    await new Promise((resolve) => setTimeout(resolve, 250));
+  }
+  throw new Error(`Timed out waiting for renderer state: ${expression}`);
+}
+
+export function evaluationValue(result) {
+  if (result.exceptionDetails) {
+    throw new Error(result.exceptionDetails.exception?.description ?? result.exceptionDetails.text);
+  }
+  return result.result?.value;
+}
+
+export function requireCdpWebSocketUrl(version, expectedCdpPort) {
+  const value = typeof version?.webSocketDebuggerUrl === "string"
+    ? version.webSocketDebuggerUrl.trim()
+    : "";
+  if (!value) {
+    throw new Error("Codex CDP /json/version is missing webSocketDebuggerUrl");
+  }
+  let parsed;
+  try {
+    parsed = new URL(value);
+  } catch {
+    throw new Error("Codex CDP webSocketDebuggerUrl is invalid");
+  }
+  if (!new Set(["ws:", "wss:"]).has(parsed.protocol) || !parsed.host) {
+    throw new Error("Codex CDP webSocketDebuggerUrl must use ws: or wss:");
+  }
+  const hostname = parsed.hostname.toLowerCase().replace(/^\[|\]$/g, "");
+  if (!new Set(["127.0.0.1", "localhost", "::1"]).has(hostname)) {
+    throw new Error("Codex CDP webSocketDebuggerUrl must use a loopback host");
+  }
+  const configuredPort = Number(expectedCdpPort);
+  const effectivePort = parsed.port
+    ? Number(parsed.port)
+    : parsed.protocol === "wss:" ? 443 : 80;
+  if (!Number.isInteger(configuredPort) || effectivePort !== configuredPort) {
+    throw new Error(`Codex CDP webSocketDebuggerUrl must use configured CDP port ${expectedCdpPort}`);
+  }
+  return value;
+}
+
+export function processChildHasExited(child) {
+  return child && (
+    (child.exitCode !== null && child.exitCode !== undefined)
+    || (child.signalCode !== null && child.signalCode !== undefined)
+  );
+}
+
+export function waitForProcessChildExit(child, timeoutMs) {
+  if (processChildHasExited(child)) return Promise.resolve(true);
+  return new Promise((resolve) => {
+    let settled = false;
+    let timer;
+    const finish = (exited) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      child.removeListener?.("exit", onExit);
+      resolve(exited || processChildHasExited(child));
+    };
+    const onExit = () => finish(true);
+    child.once?.("exit", onExit);
+    timer = setTimeout(() => finish(false), timeoutMs);
+  });
+}
+

package/packages/runtime-host/src/codex-design-contract.mjs

@@ -0,0 +1,116 @@
+// Codex 原生设计契约：token 名单与派生规则的单一事实来源。
+// 注入到 Codex Renderer 的 install 脚本必须自包含（install.toString() 序列化
+// 后经 CDP 注入），因此 install 内通过 config.themeTokens 拿到本模块的名单；
+// 名单只在这里维护，install 不再持有自己的字面量副本。
+
+export const CODEX_THEME_TOKENS = Object.freeze([
+  "--codex-base-accent",
+  "--codex-base-ink",
+  "--codex-base-surface",
+  "--codex-corner-radius-scale",
+  "--codex-corner-shape",
+  "--spacing",
+  "--radius-3xl-base",
+  "--elevation-prominent",
+  "--elevation-stroke",
+  "--color-token-main-surface-primary",
+  "--color-token-dropdown-background",
+  "--color-token-foreground",
+  "--color-token-text-secondary",
+  "--color-token-text-tertiary",
+  "--color-token-border",
+  "--color-token-focus-border",
+  "--color-token-conversation-summary-trailing",
+  "--color-token-bg-primary",
+  "--color-token-bg-secondary",
+  "--color-token-bg-tertiary",
+  "--color-surface-tertiary",
+  "--color-surface-elevated-secondary",
+  "--color-background-elevated-primary-opaque",
+  "--color-background-primary-ghost-hover",
+  "--color-chart-blue",
+  "--color-chart-purple",
+  "--color-background-panel",
+  "--color-background-control",
+  "--color-background-primary-solid",
+  "--color-text-primary-solid",
+  "--color-background-button-primary",
+  "--color-background-button-primary-hover",
+  "--color-background-button-secondary",
+  "--color-background-button-secondary-hover",
+  "--color-background-button-tertiary-hover",
+  "--color-text-button-tertiary",
+  "--color-token-button-background",
+  "--color-token-button-foreground",
+  "--color-text-foreground",
+  "--color-text-foreground-secondary",
+  "--color-text-foreground-tertiary",
+  "--color-text-inverse",
+  "--color-text-on-accent",
+  "--color-text-button-primary",
+  "--color-text-accent",
+  "--color-token-text-link-foreground",
+  "--color-border",
+  "--color-border-subtle",
+  "--color-border-heavy",
+  "--color-border-focus",
+  "--color-token-scrollbar-slider-background",
+  "--color-token-scrollbar-slider-hover-background",
+  "--color-token-scrollbar-slider-active-background",
+  "--color-icon-primary",
+  "--color-icon-secondary",
+  "--color-icon-tertiary",
+  "--color-token-list-hover-background",
+  "--color-token-input-background",
+  "--color-token-input-border",
+  "--color-token-input-foreground",
+  "--color-token-input-placeholder-foreground",
+  "--font-sans-default",
+  "--font-weight-normal",
+  "--vscode-font-weight",
+  "--default-mono-font-family",
+  "--text-heading-lg",
+  "--text-heading-md",
+  "--text-base",
+  "--text-base--line-height",
+  "--text-sm",
+  "--text-sm--line-height",
+  "--text-xs",
+  "--spacing-token-button-composer",
+  "--radius-sm",
+  "--radius-md",
+  "--radius-lg",
+  "--radius-xl",
+  "--radius-2xl",
+  "--shadow-md",
+  "--shadow-lg",
+  "--shadow-xl",
+]);
+
+// images 图片编辑器可用性依赖的宿主 token 子集。
+// 与 features/images/web/app.js 的 editorTokens 保持同一来源（一致性由测试锁定）。
+export const EDITOR_TOKEN_NAMES = Object.freeze([
+  "--color-surface-tertiary",
+  "--color-surface-elevated-secondary",
+  "--color-border-subtle",
+  "--color-background-primary-ghost-hover",
+  "--color-chart-blue",
+  "--color-text-inverse",
+  "--color-token-main-surface-primary",
+  "--color-token-input-foreground",
+  "--color-text-foreground",
+  "--color-text-foreground-tertiary",
+  "--color-text-on-accent",
+  "--color-border",
+  "--color-border-focus",
+  "--color-token-list-hover-background",
+  "--color-text-accent",
+  "--font-sans-default",
+  "--font-weight-normal",
+  "--text-sm",
+  "--text-sm--line-height",
+  "--radius-md",
+  "--radius-xl",
+  "--shadow-md",
+  "--shadow-xl",
+]);

package/packages/runtime-host/src/codex-efforts.mjs

@@ -0,0 +1,47 @@
+import { readFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+// Model Slider 思考强度来源说明（为什么需要这个模块）
+//
+// OpenCodex 把第三方模型路由给 Codex 时，会在 catalog 里给所有“有思考强度”的
+// 模型额外广告 mock 的 max/ultra（即使上游并不支持）。GLM 之类被 OpenCodex 测得
+// 准的模型没有这个问题；而像 Qwen/Grok/MiMo 这类 OpenCodex 没内置档位的模型，
+// 只能通过用户的 OpenCodex 配置声明真实档位。
+//
+// 这个模块只做一件事：读取 OpenCodex 配置（~/.opencodex/config.json）中按
+// provider 声明的 modelReasoningEfforts，作为 Model Slider 的“真实档位表”。
+// 它不产生、不猜测、不修改任何档位；配置里没有的模型保持原样。
+function canonicalEfforts(values) {
+  if (!Array.isArray(values)) return null;
+  const seen = new Set();
+  const out = values
+    .map((value) => String(value).trim().toLowerCase())
+    .filter((value) => {
+      if (!value || seen.has(value)) return false;
+      seen.add(value);
+      return true;
+    });
+  return out.length ? out : null;
+}
+
+// 读取 OpenCodex 配置中按 provider 声明的真实思考强度档位。OpenCodex 同步 catalog
+// 时会额外广告 mock 的 max/ultra；这里只透传 provider 自己声明的档位，供 Model
+// Slider 精确显示，避免 UI 出现上游并不支持的档位。
+export async function loadOpenCodexRealEfforts({
+  opencodexConfigPath = process.env.OPENCODEX_CONFIG_PATH ?? path.join(os.homedir(), ".opencodex", "config.json"),
+  read = readFile,
+} = {}) {
+  const configPayload = await read(opencodexConfigPath, "utf8")
+    .then((value) => JSON.parse(value))
+    .catch(() => null);
+  const entries = {};
+  for (const [provider, providerConfig] of Object.entries(configPayload?.providers ?? {})) {
+    for (const [modelId, efforts] of Object.entries(providerConfig?.modelReasoningEfforts ?? {})) {
+      const levels = canonicalEfforts(efforts);
+      if (!levels) continue;
+      entries[`${provider}/${modelId}`.toLowerCase()] = levels;
+    }
+  }
+  return entries;
+}