minecodex 1.0.8 → 1.0.10

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.8",
+  "version": "1.0.10",
   "description": "Lightweight, local-first plugins for the Codex desktop app.",
   "license": "MIT",
   "type": "module",

package/packages/runtime-host/README.md

@@ -132,8 +132,8 @@ Host 会再次发送当前状态。功能页面可据此暂停隐藏状态下的
 - `attach-file`：用 CDP 填充临时 file input，再把真实 `File` drop 给 Composer；只有
   观察到原生附件 chip/preview 才报告 `attach`，否则明确返回 `insert-path`。
 - `open-detail-tab`：动态发现当前 Codex React right-panel controller 与当前 Task scope，
-  用稳定的 `featureId-detailId` 聚焦或创建唯一原生 Tab；capability 不可用时才回退到
-  RuntimeHost 自建的兼容 Tab host。
+  传入包含 `Component`、`isAvailable`、`kind` 和 `dropDestinations` 的标签描述对象，
+  用稳定的 `featureId-detailId` 聚焦或创建唯一原生 Tab；capability 不可用时返回明确错误。
 - `resolve-file-paths`：通过 Codex preload 暴露的 Electron file bridge 解析 Finder
   drop 的真实 `File` 对象。
 
@@ -145,6 +145,8 @@ Host 会再次发送当前状态。功能页面可据此暂停隐藏状态下的
   本地 Surface 不直接导航到 loopback URL：Host 先创建 `about:blank` iframe，再校验
   manifest URL、health service/protocol/instance，抓取 HTML 并用 `Page.setDocumentContent`
   写入目标 frame。Images/Notes 只向精确的 `app://-` Origin 开放 CORS。
+- CDP 重连时同步轮换后的 binding token；保留已就绪的 Surface 和编辑草稿，
+  使用新 token 重试未就绪页面，避免弹窗停留在空白 iframe。
 - 入口由 Renderer 内的 MutationObserver 幂等挂载，React 重绘不会产生重复入口。
 - Summary 根据对话主区域宽度连续派生 `overlay / shift / gutter`：小于 1096px
   使用临时 Popover；1096–1535px 预留 316px 并把对话内容左移 158px；更宽时
@@ -166,7 +168,7 @@ Host 会再次发送当前状态。功能页面可据此暂停隐藏状态下的
 | --- | --- | --- |
 | loopback HTTP、manifest、Surface message schema | 项目自有稳定接口 | 可由测试直接覆盖 |
 | `window.electronBridge.getPathForFile` | 当前稳定 internal/preload | 仅用于 Finder `File` 路径解析 |
-| React right-panel `openTab`、Task scope、JSX runtime | private internal capability | 动态发现 bundle 并做能力检测；失败时回退自建 Tab host |
+| React right-panel `openTab`、Task scope、JSX runtime | private internal capability | 动态发现 bundle 并做能力检测；失败时返回明确的不可用错误 |
 | toolbar、summary、tabs、Composer selectors | DOM inference | 统一留在本 Adapter |
 | `Runtime.addBinding`、`DOM.setFileInputFiles`、注入脚本 | high-risk CDP | 必须使用隔离 profile 验收 |
 | `togglePinnedSummary`、`composer.addFiles` 字符串 | 探索证据 | 当前实现不把它们当契约 |

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",
+]);