openclaw-codex-feishu 0.1.1

package/dist/utils/keyedQueue.js

@@ -0,0 +1,16 @@
+export class KeyedQueue {
+    tails = new Map();
+    enqueue(key, task) {
+        const tail = this.tails.get(key) ?? Promise.resolve();
+        const next = tail
+            .catch(() => undefined)
+            .then(task)
+            .finally(() => {
+            if (this.tails.get(key) === next) {
+                this.tails.delete(key);
+            }
+        });
+        this.tails.set(key, next);
+        return next;
+    }
+}

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export interface LoggerLike {
+    info(message: string, ...meta: unknown[]): void;
+    warn(message: string, ...meta: unknown[]): void;
+    error(message: string, ...meta: unknown[]): void;
+    debug?(message: string, ...meta: unknown[]): void;
+}
+export declare const noopLogger: LoggerLike;

package/dist/utils/logger.js

@@ -0,0 +1,6 @@
+export const noopLogger = {
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+    debug: () => undefined
+};

package/docs/cards/approval-card.json

@@ -0,0 +1,21 @@
+{
+  "schema": "2.0",
+  "header": {
+    "title": { "tag": "plain_text", "content": "Codex 审批请求" },
+    "template": "orange"
+  },
+  "body": {
+    "elements": [
+      { "tag": "markdown", "content": "**RequestId**: `apr_001`\n**类型**: shell\n**命令**: `git push origin feat/codex`\n**原因**: 需要将修复提交到远端仓库" },
+      {
+        "tag": "action",
+        "actions": [
+          { "tag": "button", "text": { "tag": "plain_text", "content": "允许一次" }, "type": "primary", "value": { "a": "allow-once", "id": "apr_001" } },
+          { "tag": "button", "text": { "tag": "plain_text", "content": "本会话总是允许" }, "type": "default", "value": { "a": "allow-always", "id": "apr_001" } },
+          { "tag": "button", "text": { "tag": "plain_text", "content": "拒绝" }, "type": "danger", "value": { "a": "deny", "id": "apr_001" } },
+          { "tag": "button", "text": { "tag": "plain_text", "content": "取消" }, "type": "default", "value": { "a": "cancel", "id": "apr_001" } }
+        ]
+      }
+    ]
+  }
+}

package/docs/cards/control-card.json

@@ -0,0 +1,26 @@
+{
+  "schema": "2.0",
+  "config": { "wide_screen_mode": true },
+  "header": {
+    "title": { "tag": "plain_text", "content": "Codex 控制台" },
+    "template": "blue"
+  },
+  "body": {
+    "elements": [
+      { "tag": "markdown", "content": "**状态**: 运行中\n**Thread**: `thr_123`\n**工作目录**: `/Users/me/work`\n**模型**: `gpt-5.4`\n**Raw**: `cli`" },
+      { "tag": "hr" },
+      { "tag": "markdown", "content": "**最近命令**: `pnpm test`\n**Todo**: 2/5 完成\n**待审批**: 1" },
+      {
+        "tag": "action",
+        "actions": [
+          { "tag": "button", "text": { "tag": "plain_text", "content": "新建" }, "type": "default", "value": { "a": "new" } },
+          { "tag": "button", "text": { "tag": "plain_text", "content": "继续" }, "type": "default", "value": { "a": "resume" } },
+          { "tag": "button", "text": { "tag": "plain_text", "content": "停止" }, "type": "danger", "value": { "a": "stop" } },
+          { "tag": "button", "text": { "tag": "plain_text", "content": "Review" }, "type": "default", "value": { "a": "review" } },
+          { "tag": "button", "text": { "tag": "plain_text", "content": "日志" }, "type": "default", "value": { "a": "log" } },
+          { "tag": "button", "text": { "tag": "plain_text", "content": "Detach" }, "type": "default", "value": { "a": "detach" } }
+        ]
+      }
+    ]
+  }
+}

package/docs/cards/turn-live-card.json

@@ -0,0 +1,15 @@
+{
+  "schema": "2.0",
+  "header": {
+    "title": { "tag": "plain_text", "content": "Codex 当前 Turn 实时流" },
+    "template": "wathet"
+  },
+  "body": {
+    "elements": [
+      { "tag": "markdown", "content": "**Turn**: `turn_456`\n**阶段**: 执行中" },
+      { "tag": "markdown", "content": "**Agent Tail**\n```\n已定位到错误来源，正在修复并补充测试。\n```" },
+      { "tag": "markdown", "content": "**CLI Tail**\n```\n$ pnpm test\n PASS src/state/schemas.test.ts\n```" },
+      { "tag": "markdown", "content": "**Plan**\n1. 定位问题 ✅\n2. 修改实现 ⏳\n3. 增加回归测试 ⏳" }
+    ]
+  }
+}

package/openclaw.plugin.json

@@ -0,0 +1,122 @@
+{
+  "id": "codex-feishu",
+  "name": "OpenClaw Codex Feishu Bridge",
+  "version": "0.1.1",
+  "description": "Feishu-first Codex app-server bridge plugin with control cards, raw chunk streaming, and JSONL journaling.",
+  "skills": [
+    "skills/codex-bridge"
+  ],
+  "uiHints": {
+    "adminLabel": "Codex × Feishu",
+    "category": "automation",
+    "tags": [
+      "codex",
+      "feishu",
+      "bridge"
+    ]
+  },
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "transport": {
+        "type": "string",
+        "enum": [
+          "stdio"
+        ],
+        "default": "stdio"
+      },
+      "command": {
+        "type": "string",
+        "default": "codex"
+      },
+      "args": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "default": [
+          "app-server",
+          "--listen",
+          "stdio://"
+        ]
+      },
+      "defaultWorkspaceDir": {
+        "type": "string"
+      },
+      "defaultModel": {
+        "type": "string",
+        "default": "gpt-5.4"
+      },
+      "attachModeDefault": {
+        "type": "string",
+        "enum": [
+          "attached",
+          "toolOnly"
+        ],
+        "default": "attached"
+      },
+      "rawModeDefault": {
+        "type": "string",
+        "enum": [
+          "off",
+          "cli",
+          "all"
+        ],
+        "default": "cli"
+      },
+      "feishu": {
+        "type": "object",
+        "properties": {
+          "pinControlCard": {
+            "type": "boolean",
+            "default": true
+          },
+          "rotateControlCardAfterDays": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 12
+          },
+          "controlCardEditMinIntervalMs": {
+            "type": "integer",
+            "minimum": 250,
+            "default": 1000
+          },
+          "streamFlushMs": {
+            "type": "integer",
+            "minimum": 100,
+            "default": 750
+          },
+          "streamChunkChars": {
+            "type": "integer",
+            "minimum": 400,
+            "default": 1500
+          },
+          "liveTailChars": {
+            "type": "integer",
+            "minimum": 400,
+            "default": 1200
+          },
+          "sendJsonlOnTurnComplete": {
+            "type": "boolean",
+            "default": true
+          },
+          "sendReadableTranscriptOnTurnComplete": {
+            "type": "boolean",
+            "default": false
+          },
+          "buttonsOnly": {
+            "type": "boolean",
+            "default": true
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "required": [
+      "transport",
+      "command",
+      "args"
+    ],
+    "additionalProperties": false
+  }
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "openclaw-codex-feishu",
+  "version": "0.1.1",
+  "description": "OpenClaw native plugin scaffold for bridging Codex app-server with Feishu-first rendering.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "openclaw-codex-feishu": "./scripts/install.mjs"
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "skills",
+    "docs/cards",
+    "scripts/install.mjs"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "validate:json": "python -m json.tool openclaw.plugin.json >/dev/null && python -m json.tool docs/cards/control-card.json >/dev/null && python -m json.tool docs/cards/approval-card.json >/dev/null && python -m json.tool docs/cards/turn-live-card.json >/dev/null"
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "codex",
+    "feishu"
+  ],
+  "license": "MIT",
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.3.24-beta.2",
+      "minGatewayVersion": "2026.3.24-beta.2"
+    },
+    "build": {
+      "openclawVersion": "2026.3.24-beta.2",
+      "pluginSdkVersion": "2026.3.24-beta.2"
+    }
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.41"
+  },
+  "devDependencies": {
+    "openclaw": "^2026.3.24-beta.2",
+    "typescript": "^5.8.3"
+  }
+}

package/scripts/install.mjs

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+const pluginRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const pluginId = "codex-feishu";
+const command = process.argv[2];
+
+function printHelp() {
+  console.log("用法: npx openclaw-codex-feishu install");
+}
+
+function runOrThrow(args) {
+  const result = spawnSync("npx", ["-y", "openclaw", ...args], {
+    stdio: "inherit",
+    env: process.env
+  });
+
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+}
+
+if (command !== "install") {
+  printHelp();
+  process.exit(command ? 1 : 0);
+}
+
+runOrThrow(["plugins", "install", pluginRoot]);
+runOrThrow(["plugins", "enable", pluginId]);
+
+console.log(`✅ 已安装并启用插件: ${pluginId}`);

package/skills/codex-bridge/SKILL.md

@@ -0,0 +1,14 @@
+# codex-bridge
+
+## 目的
+将“把任务交给 Codex”的自然语言意图路由到 `codex_bridge.send` 工具，避免主 agent 转述长输出。
+
+## 工作流
+1. 识别用户意图（例如“用 codex 做这个”）。
+2. 调用 `codex_bridge.send`，仅传入任务目标与上下文。
+3. 返回简短确认：`Codex 已接管，输出将直接回流到当前 Feishu 聊天。`
+4. 不在主 agent 中复述 Codex 的持续流式输出。
+
+## 约束
+- 长输出由插件直发 Feishu。
+- skill 不负责会话生命周期或审批逻辑。