@modelzen/feishu-codex-bridge 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+interface LogContext {
+    traceId?: string;
+    chatId?: string;
+    msgId?: string;
+}
+type LogFields = Record<string, unknown>;
+declare const log: {
+    info(phase: string, event: string, fields?: LogFields): void;
+    warn(phase: string, event: string, fields?: LogFields): void;
+    fail(phase: string, err: unknown, fields?: LogFields): void;
+};
+/** Run `fn` inside a logging context; all `log.*` inside pick up the fields. */
+declare function withTrace<T>(ctx: LogContext, fn: () => Promise<T>): Promise<T>;
+declare function newTraceId(): string;
+
+declare const paths: {
+    appDir: string;
+    cacheDir: string;
+    /** bot 注册表：保存的全部 bot + 当前选中的 appId */
+    botsFile: string;
+    /** app id / 租户 / 偏好（当前 bot；不含明文密钥） */
+    readonly configFile: string;
+    /** thread(话题) → codex thread_id + cwd + 会话级配置（当前 bot） */
+    readonly sessionsFile: string;
+    /** project(群) → cwd + 默认参数 注册表（当前 bot） */
+    readonly projectsFile: string;
+    /** 在跑的 start 进程注册中心（同 App 冲突检测；当前 bot） */
+    readonly processesFile: string;
+    secretsFile: string;
+    keystoreSaltFile: string;
+    npmCacheDir: string;
+    /** 空白项目默认落地目录 */
+    projectsRootDir: string;
+    larkCliDir: string;
+    larkCliBinDir: string;
+    codexCliDir: string;
+    codexCliBinDir: string;
+    /**
+     * Thin shell wrapper that lark-cli invokes to resolve secrets from the
+     * bridge's encrypted store. Written user-owned and non-symlinked so it
+     * passes lark-cli's AssertSecurePath audit.
+     */
+    secretsGetterScript: string;
+    mediaDir: string;
+};
+
+export { log, newTraceId, paths, withTrace };

package/dist/index.js

@@ -0,0 +1,224 @@
+// src/core/logger.ts
+import { AsyncLocalStorage } from "async_hooks";
+import { createWriteStream, mkdirSync } from "fs";
+import { open, readdir, rm, stat } from "fs/promises";
+import { join as join2 } from "path";
+
+// src/config/paths.ts
+import { homedir } from "os";
+import { join } from "path";
+var appDir = join(homedir(), ".feishu-codex-bridge");
+var larkCliDir = join(appDir, "lark-cli");
+var codexCliDir = join(appDir, "codex-cli");
+var currentBotDir = appDir;
+var paths = {
+  appDir,
+  cacheDir: appDir,
+  /** bot 注册表：保存的全部 bot + 当前选中的 appId */
+  botsFile: join(appDir, "bots.json"),
+  /** app id / 租户 / 偏好（当前 bot；不含明文密钥） */
+  get configFile() {
+    return join(currentBotDir, "config.json");
+  },
+  /** thread(话题) → codex thread_id + cwd + 会话级配置（当前 bot） */
+  get sessionsFile() {
+    return join(currentBotDir, "sessions.json");
+  },
+  /** project(群) → cwd + 默认参数 注册表（当前 bot） */
+  get projectsFile() {
+    return join(currentBotDir, "projects.json");
+  },
+  /** 在跑的 start 进程注册中心（同 App 冲突检测；当前 bot） */
+  get processesFile() {
+    return join(currentBotDir, "processes.json");
+  },
+  secretsFile: join(appDir, "secrets.enc"),
+  keystoreSaltFile: join(appDir, ".keystore.salt"),
+  npmCacheDir: join(appDir, "npm-cache"),
+  /** 空白项目默认落地目录 */
+  projectsRootDir: join(appDir, "projects"),
+  larkCliDir,
+  larkCliBinDir: join(larkCliDir, "node_modules", ".bin"),
+  codexCliDir,
+  codexCliBinDir: join(codexCliDir, "node_modules", ".bin"),
+  /**
+   * Thin shell wrapper that lark-cli invokes to resolve secrets from the
+   * bridge's encrypted store. Written user-owned and non-symlinked so it
+   * passes lark-cli's AssertSecurePath audit.
+   */
+  secretsGetterScript: join(appDir, "secrets-getter"),
+  mediaDir: join(appDir, "media")
+};
+
+// src/core/logger.ts
+var LOG_RETENTION_DAYS = Math.max(
+  1,
+  Number(process.env.FEISHU_CODEX_LOG_DAYS ?? 7) || 7
+);
+var STDOUT_INFO_ALLOWLIST = /* @__PURE__ */ new Set([
+  "ws.connected",
+  "ws.reconnecting",
+  "ws.reconnected",
+  "intake.enter",
+  "intake.recv",
+  "intake.reject",
+  "card.final",
+  "card.config",
+  "card.action",
+  "card.launch",
+  "agent.spawn",
+  "agent.exit"
+]);
+var als = new AsyncLocalStorage();
+var stream = null;
+var currentDate = "";
+function todayKey() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function logsDir() {
+  return join2(paths.appDir, "logs");
+}
+function getStream() {
+  const today = todayKey();
+  if (stream && currentDate === today) return stream;
+  if (stream) {
+    try {
+      stream.end();
+    } catch {
+    }
+  }
+  try {
+    mkdirSync(logsDir(), { recursive: true });
+    stream = createWriteStream(join2(logsDir(), `${today}.log`), { flags: "a" });
+    currentDate = today;
+    return stream;
+  } catch {
+    return null;
+  }
+}
+var RESERVED_KEYS = /* @__PURE__ */ new Set([
+  "ts",
+  "level",
+  "phase",
+  "event",
+  "traceId",
+  "chatId",
+  "msgId"
+]);
+function emit(level, phase, event, fields = {}) {
+  const ctx = als.getStore() ?? {};
+  const entry = {
+    ts: (/* @__PURE__ */ new Date()).toISOString(),
+    level,
+    phase,
+    event,
+    ...ctx
+  };
+  for (const [k, v] of Object.entries(fields)) {
+    if (RESERVED_KEYS.has(k)) {
+      entry[`_${k}`] = v;
+    } else {
+      entry[k] = v;
+    }
+  }
+  const s = getStream();
+  if (s) {
+    try {
+      s.write(`${JSON.stringify(entry)}
+`);
+    } catch {
+    }
+  }
+  const showOnStdout = level !== "info" || STDOUT_INFO_ALLOWLIST.has(`${phase}.${event}`);
+  if (!showOnStdout) return;
+  const fn = level === "error" ? console.error : level === "warn" ? console.warn : console.log;
+  fn(formatStdout(level, phase, event, ctx, fields));
+}
+function formatStdout(level, phase, event, ctx, fields) {
+  if (phase === "ws") {
+    if (event === "connected") {
+      const bot = fields.bot ?? "-";
+      const appId = fields.appId ? ` (${fields.appId})` : "";
+      return `\u2713 \u5DF2\u8FDE\u63A5  bot: ${bot}${appId}`;
+    }
+    if (event === "reconnecting") return "\u21BB \u6B63\u5728\u91CD\u8FDE\u2026";
+    if (event === "reconnected") return "\u2713 \u5DF2\u91CD\u8FDE";
+    if (event === "fail") return `\u2717 WS \u9519\u8BEF: ${fields.err ?? ""}`;
+  }
+  if (phase === "intake" && event === "enter") {
+    const c = ctx.chatId ? ctx.chatId.slice(-6) : "-";
+    const sender = fields.sender ?? "-";
+    const preview = fields.preview ?? "";
+    return `\u25B8 ${fields.chatType ?? "?"}/${c} ${sender}: ${preview}`;
+  }
+  if (phase === "card" && event === "final") {
+    const c = ctx.chatId ? ctx.chatId.slice(-6) : "-";
+    const t = fields.terminal;
+    const mark = t === "done" ? "\u2713" : t === "interrupted" ? "\u23F9" : "\u2717";
+    return `  ${mark} ${c} ${t}`;
+  }
+  const ctxBits = [];
+  if (ctx.traceId) ctxBits.push(`t=${ctx.traceId}`);
+  if (ctx.chatId) ctxBits.push(`c=${ctx.chatId.slice(-6)}`);
+  const ctxStr = ctxBits.length > 0 ? ` ${ctxBits.join(" ")}` : "";
+  const summary = formatFields(fields);
+  const tag = level === "error" ? "\u2717" : level === "warn" ? "\u26A0" : "\xB7";
+  return `${tag} [${phase}.${event}]${ctxStr}${summary ? ` ${summary}` : ""}`;
+}
+function formatFields(fields) {
+  const keys = Object.keys(fields);
+  if (keys.length === 0) return "";
+  const parts = [];
+  for (const k of keys) {
+    const v = fields[k];
+    if (v === void 0 || v === null) continue;
+    if (k === "stack") continue;
+    if (typeof v === "string") {
+      parts.push(`${k}=${v.length > 80 ? `${v.slice(0, 80)}\u2026` : v}`);
+    } else if (typeof v === "number" || typeof v === "boolean") {
+      parts.push(`${k}=${v}`);
+    } else {
+      try {
+        const str = JSON.stringify(v);
+        parts.push(`${k}=${str.length > 80 ? `${str.slice(0, 80)}\u2026` : str}`);
+      } catch {
+        parts.push(`${k}=?`);
+      }
+    }
+  }
+  return parts.join(" ");
+}
+var log = {
+  info(phase, event, fields) {
+    emit("info", phase, event, fields);
+  },
+  warn(phase, event, fields) {
+    emit("warn", phase, event, fields);
+  },
+  fail(phase, err, fields) {
+    const message = err instanceof Error ? err.message : String(err);
+    const stack = err instanceof Error ? err.stack : void 0;
+    const apiData = err?.response?.data;
+    const apiStatus = err?.response?.status;
+    emit("error", phase, "fail", {
+      ...fields,
+      err: message,
+      apiStatus,
+      apiData,
+      stack
+    });
+  }
+};
+function withTrace(ctx, fn) {
+  const traceId = ctx.traceId ?? newTraceId();
+  return als.run({ ...ctx, traceId }, fn);
+}
+function newTraceId() {
+  return Math.random().toString(36).slice(2, 10);
+}
+export {
+  log,
+  newTraceId,
+  paths,
+  withTrace
+};

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@modelzen/feishu-codex-bridge",
+  "version": "0.1.0",
+  "description": "Bridge Feishu/Lark messenger with local Codex via app-server (project=group, thread=session)",
+  "type": "module",
+  "bin": {
+    "feishu-codex-bridge": "bin/feishu-codex-bridge.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "start": "node bin/feishu-codex-bridge.mjs run",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.65.0",
+    "commander": "^12.1.0",
+    "qrcode-terminal": "^0.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "feishu",
+    "lark",
+    "codex",
+    "app-server",
+    "cli",
+    "bridge",
+    "bot"
+  ],
+  "author": "modelzen",
+  "license": "MIT",
+  "homepage": "https://github.com/modelzen/feishu-codex-bridge#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/modelzen/feishu-codex-bridge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/modelzen/feishu-codex-bridge/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}