@sakki_chin/dsh-codex-orchestrate 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Atlas AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# @sakki_chin/dsh-codex-orchestrate
+
+把 **Codex** 任务按 YAML schema 编排成 DAG 工作流的 DSH 插件。每个节点是一个独立的 codex session，下游首轮会自动拿到直接依赖节点的终态结果；进度在 DSH **右侧边栏以原生 React tab** 呈现（DAG 连线 + 逐轮 conversation）。
+
+- 派发方式：DSH agent 调用 `codex_orchestrate` tool（异步 + 可查进度），或直接调 HTTP API
+- 每个节点独立 codex session，终态后可在工作台里继续对话（`resumeThread`，不重跑下游）
+- 运行中也能改 DAG：`kind: nodePatch` 原子化新增 / 修改 / 删除**尚未执行**的节点
+- 工作流状态 append-only 落盘，进程重启后历史仍可查
+
+## 环境要求
+
+| 项 | 要求 |
+|---|---|
+| DSH | Desktop 或 `dsh` CLI |
+| codex CLI | 已安装并 `codex login`（订阅登录）或设置 `OPENAI_API_KEY` |
+| Node | ≥ 20 |
+
+插件**完全复用本机 codex 登录态**（`~/.codex/auth.json`）：不代管、不刷新、不转发 token。派发前会做一次只读探测，没有登录态就直接报错，不会烧掉一个必然失败的 turn。
+
+## 安装
+
+```bash
+dsh plugin add --profile web @sakki_chin/dsh-codex-orchestrate
+```
+
+`--profile` 换成你的 profile 名（真源：`~/Library/Application Support/DSH Desktop/profile-selection/state.json`，一般是 `web`）。
+
+安装后**需要完全重启 DSH**：包元数据（含"是不是客户端包"的判定）按 Loader specifier 缓存到进程重启，刷新页面不够。
+
+### 从本地目录安装（开发用）
+
+```bash
+cd <插件源码目录>
+npm install
+npm run build:client
+dsh plugin add --profile web "$PWD"
+```
+
+pnpm 会写成 `link:` 软链，所以之后改源码 → `npm run build:client` → 宿主 HMR（约 500ms 轮询）会原地重挂载，**无需重启或刷新**。
+
+## 打开工作台
+
+右侧边栏 → 点标签条的 **`+`（「新标签页」）**打开引导页 → 选「Codex Orchestrate」。
+
+也可以右键任意 tab，从 tab 菜单里进入。
+
+## 使用
+
+### 由 DSH agent 派发
+
+```
+codex_orchestrate(yaml: "...")
+```
+
+- `kind: workflow` 创建
+- `kind: workflowQuery` 查询（省略 `workflowId` 返回清单）
+- `kind: nodePatch` 对尚未执行的节点做原子化增删改
+
+tool 立即返回 `{ workflowId, nodes, progress, progressUrl, instance }`。
+
+> **用 `progressUrl`**（绝对地址，可直接 GET），不要用 `progress`（相对路径，需你自己知道 host:port——曾因此把跨实例查询误判成「workflow 不存在」）。`instance.instanceId` 用于确认「我查的是不是派发我的那个实例」。
+
+YAML schema 见包内 `schema/workflow.schema.md`（规范说明 + 回传契约），校验真源是 `schema/workflow.schema.json`。
+
+### 调度语义
+
+- 节点按 `dependsOn` 调度，无依赖（或依赖已满足）的节点并发执行，受 `concurrency` 上限约束（默认 3）
+- 下游节点首轮 prompt 自动注入所有**直接**依赖节点的终态结果
+- 节点未显式写 `cwd` 时，继承发起 DSH 会话的工作目录
+- 单节点 `timeoutS` 默认 600；`onFailure: fail`（默认）阻塞下游，`continue` 照常调度
+
+### 直接 HTTP
+
+```
+POST /codex-orchestrate/api/dispatch   { "yaml": "..." }
+GET  /codex-orchestrate/api/workflows
+GET  /codex-orchestrate/api/state?workflowId=wf_xxx
+POST /codex-orchestrate/api/message    { workflowId, nodeId, text, clientMessageId }
+POST /codex-orchestrate/api/cancel     { workflowId, nodeId }
+GET  /codex-orchestrate/api/events?workflowId=wf_xxx    # SSE
+```
+
+## 状态持久化
+
+workflow 状态 append-only 落盘到 `$DSH_HOME/workflows.jsonl`。
+
+- 进程重启后历史仍可查：`/api/state` 未命中内存时自动从磁盘回读
+- 重启前处于 `running`/`queued` 的节点会被照实标成 `cancelled`，而不是永远停在 `running` 骗查询方
+- 文件尾部半行 / 损坏行会被跳过，不影响其余历史
+- 落盘失败（磁盘满 / 权限）只记一条警告，**不打断**正在跑的工作流
+
+## 配置
+
+| 环境变量 | 作用 |
+|---|---|
+| `DSH_CODEX_MODEL` | 节点缺省模型（默认 `gpt-5.6-sol`） |
+| `DSH_CODEX_CLI` | 指定 codex CLI 可执行文件路径 |
+| `DSH_CODEX_MODULES` | 额外的 `node_modules` 目录（用于找 `@openai/codex-sdk`、YAML 解析器） |
+| `DSH_CODEX_STATE_DIR` | 覆盖状态落盘目录 |
+| `DSH_CODEX_DEBUG_EVENTS` | 打印原始 codex 事件流 |
+| `CODEX_HOME` | codex 登录态目录（默认 `~/.codex`） |
+
+也可在节点上写 `model:` 覆盖全局缺省。**不要用 `gpt-5-codex`**——该 slug 在 ChatGPT 订阅登录下会被服务端拒绝（`not supported when using Codex with a ChatGPT account`）；订阅可用 `gpt-5.6-sol` / `gpt-5.6-terra` / `gpt-5.6-luna` / `gpt-5.5`。
+
+## 排查
+
+**`http://127.0.0.1:43120` 返回 403** —— 这是 DSH Desktop 的 Electron 门禁，对所有非渲染器请求一律拒绝，**不是插件故障**。无头脚本穿不透它。
+
+**节点报「未找到 @openai/codex-sdk」** —— 设置 `DSH_CODEX_MODULES` 指向含该包的 `node_modules`；或在本插件目录执行 `npm install`。
+
+**Tab 菜单里没有「Codex Orchestrate」** —— 依次确认：右侧边栏已展开；包已装进 profile（`dsh plugin ls --profile web`）；DSH 已**完全重启**。若右栏当前是引导页且尚无扩展条目，右键不会弹菜单，点 `+` 打开引导页即可看到入口。
+
+## 开发
+
+```bash
+npm install
+npm run build:client     # 产出 lib/client.js（lazy-CJS 包装，宿主冻结模块全部 external）
+npm run verify:edges     # DAG 连线几何自证：采样每条路径，逐点判定是否覆盖节点卡片
+node server/orchestrator.test.cjs
+node server/plugin.test.cjs
+```
+
+`npm publish` 会通过 `prepublishOnly` 自动构建并跑一遍几何自证。
+
+## 边界
+
+- 运行句柄在内存中：进程重启时未完成的节点/轮次标为 `cancelled`，已完成历史从 JSONL 恢复
+- 只呈现**当前进程**派发的工作流
+- `file_change` 事件只有路径与 add/delete/update，无 diff 正文（SDK 限制）
+
+## License
+
+MIT

package/client/api.js

@@ -0,0 +1,50 @@
+const API_ROOT = '/codex-orchestrate/api'
+
+async function request(path, options = {}) {
+  const response = await fetch(`${API_ROOT}/${path}`, {
+    cache: 'no-store',
+    headers: {
+      accept: 'application/json',
+      ...(options.body ? { 'content-type': 'application/json' } : {}),
+      ...options.headers,
+    },
+    ...options,
+  })
+  const payload = await response.json().catch(() => null)
+  if (!response.ok) {
+    throw new Error(payload?.error || `请求失败（HTTP ${response.status}）`)
+  }
+  return payload
+}
+
+export const orchestrateApi = {
+  listWorkflows(signal) {
+    return request('workflows', { signal })
+  },
+  getState(workflowId, signal) {
+    return request(`state?workflowId=${encodeURIComponent(workflowId)}`, { signal })
+  },
+  sendMessage({ workflowId, nodeId, text, clientMessageId }, signal) {
+    return request('message', {
+      method: 'POST',
+      signal,
+      body: JSON.stringify({ workflowId, nodeId, text, clientMessageId }),
+    })
+  },
+  cancel({ workflowId, nodeId }, signal) {
+    return request('cancel', {
+      method: 'POST',
+      signal,
+      body: JSON.stringify({ workflowId, nodeId }),
+    })
+  },
+  eventsUrl(workflowId) {
+    return `${API_ROOT}/events?workflowId=${encodeURIComponent(workflowId)}`
+  },
+}
+
+export function createClientMessageId() {
+  return globalThis.crypto?.randomUUID?.()
+    || `msg_${Date.now()}_${Math.random().toString(16).slice(2)}`
+}
+

package/client/components/Composer.jsx

@@ -0,0 +1,179 @@
+import React from 'react'
+import { createClientMessageId, orchestrateApi } from '../api.js'
+import { Icon, Spinner } from './Icons.jsx'
+import { styles } from '../styles.js'
+
+function modelLabel(model = '') {
+  return model.replace(/^gpt-/i, 'GPT-').replace(/-([a-z])/g, (_, letter) => ` ${letter.toUpperCase()}`)
+}
+
+function formatTokens(value) {
+  if (value >= 1_000_000) return `${(value / 1_000_000).toFixed(value >= 10_000_000 ? 0 : 1)}M`
+  if (value >= 1000) return `${(value / 1000).toFixed(value >= 100_000 ? 0 : 1)}K`
+  return String(value)
+}
+
+function usageFor(node) {
+  const turns = node?.turns || []
+  const completed = turns.filter(turn => turn.usage)
+  const latest = completed.at(-1)?.usage || null
+  return completed.reduce((result, turn) => ({
+    latest,
+    total: result.total + (turn.usage.input_tokens || 0) + (turn.usage.output_tokens || 0),
+    input: result.input + (turn.usage.input_tokens || 0),
+    cached: result.cached + (turn.usage.cached_input_tokens || 0),
+  }), { latest, total: 0, input: 0, cached: 0 })
+}
+
+function changedFileCount(node) {
+  const paths = new Set(
+    (node?.turns || [])
+      .flatMap(turn => turn.items || [])
+      .filter(item => item.type === 'file_change')
+      .flatMap(item => item.changes || [])
+      .map(change => change.path)
+      .filter(Boolean),
+  )
+  return paths.size
+}
+
+export function Composer({ workflow, node, refresh, toast }) {
+  const [draft, setDraft] = React.useState('')
+  const [submitting, setSubmitting] = React.useState(false)
+  const textareaRef = React.useRef(null)
+  const controllerRef = React.useRef(null)
+  const active = Boolean(node?.activeTurnId) || node?.status === 'running'
+  const ready = Boolean(node?.sessionId) && ['completed', 'failed', 'cancelled'].includes(node?.status)
+  const usage = usageFor(node)
+  const changeCount = changedFileCount(node)
+  const reasoning = ({ minimal: '最小', low: '低', medium: '中', high: '高' })[node?.reasoningEffort] || '中'
+  const model = modelLabel(node?.model || 'gpt-5.6-sol')
+  const access = ({ 'read-only': '只读', 'workspace-write': '工作区访问', 'danger-full-access': '完全访问' })[node?.sandboxMode] || '完全访问'
+  const context = usage.latest?.input_tokens || 0
+  const cacheRate = usage.input ? Math.round(usage.cached / usage.input * 100) : 0
+
+  React.useLayoutEffect(() => {
+    const textarea = textareaRef.current
+    if (!textarea) return
+    textarea.style.height = 'auto'
+    textarea.style.height = `${Math.min(textarea.scrollHeight, 180)}px`
+  }, [draft])
+
+  React.useEffect(() => () => controllerRef.current?.abort(), [])
+
+  let placeholder = '随心输入'
+  if (!node) placeholder = '选择一个任务开始对话…'
+  else if (active) placeholder = 'Codex 正在回复…'
+  else if (!node.sessionId) placeholder = '等待任务创建 Codex session…'
+  else if (!ready) placeholder = '任务完成后可继续对话…'
+
+  const submit = async event => {
+    event?.preventDefault()
+    if (!workflow || !node) {
+      toast('等待工作流派发后才能追加指令')
+      return
+    }
+    controllerRef.current?.abort()
+    const controller = new AbortController()
+    controllerRef.current = controller
+    if (active) {
+      try {
+        setSubmitting(true)
+        await orchestrateApi.cancel({ workflowId: workflow.workflowId, nodeId: node.id }, controller.signal)
+        toast('正在停止本轮任务')
+        await refresh()
+      } catch (error) {
+        if (error?.name !== 'AbortError') toast(`停止失败：${error.message}`)
+      } finally {
+        setSubmitting(false)
+      }
+      return
+    }
+
+    const text = draft.trim()
+    if (!text) return
+    if (!node.sessionId) {
+      toast('该任务还没有可续接的 Codex session')
+      return
+    }
+    if (!ready) {
+      toast('任务完成后才能继续对话')
+      return
+    }
+    try {
+      setSubmitting(true)
+      await orchestrateApi.sendMessage({
+        workflowId: workflow.workflowId,
+        nodeId: node.id,
+        text,
+        clientMessageId: createClientMessageId(),
+      }, controller.signal)
+      setDraft('')
+      await refresh()
+    } catch (error) {
+      if (error?.name !== 'AbortError') toast(`发送失败：${error.message}`)
+    } finally {
+      setSubmitting(false)
+    }
+  }
+
+  return (
+    <footer style={styles.composerWrap}>
+      {changeCount > 0 && <div style={styles.changeSummary}>{changeCount} 个文件已更改</div>}
+      <form style={styles.composer} onSubmit={submit}>
+        <textarea
+          ref={textareaRef}
+          rows={1}
+          maxLength={4000}
+          value={draft}
+          disabled={submitting || active || !ready}
+          placeholder={placeholder}
+          aria-label="向当前任务节点发送指令"
+          onChange={event => setDraft(event.target.value)}
+          onKeyDown={event => {
+            if (event.key === 'Enter' && !event.shiftKey) {
+              event.preventDefault()
+              event.currentTarget.form?.requestSubmit()
+            }
+          }}
+          style={{ ...styles.textarea, opacity: submitting || active || !ready ? 0.68 : 1 }}
+        />
+        <div style={styles.composerBar}>
+          <div style={styles.tools}>
+            <button type="button" aria-label="添加上下文" title="添加上下文" onClick={() => toast('当前版本通过文字或任务依赖添加上下文')} style={{ ...styles.buttonReset, ...styles.toolButton, width: 28, padding: 0 }}>
+              <Icon kind="plus" size={16} />
+            </button>
+            <button type="button" aria-label="沙箱访问级别" title="访问级别由 Workflow 节点 sandboxMode 决定" onClick={() => toast('访问级别由 Workflow 节点 sandboxMode 决定')} style={{ ...styles.buttonReset, ...styles.toolButton, color: node?.sandboxMode === 'danger-full-access' ? '#e6732f' : 'var(--co-ink-muted)' }}>
+              <Icon kind="shield" size={16} />
+              <span>{access}</span>
+            </button>
+          </div>
+          <div style={styles.tools}>
+            {active && <Spinner size={16} />}
+            <button type="button" aria-label="模型和推理强度" title={`${model} · ${reasoning}`} onClick={() => toast('模型与推理强度由 Workflow 节点配置决定')} style={{ ...styles.buttonReset, ...styles.toolButton }}>
+              <span>{model}</span><span style={{ color: 'var(--co-ink-faint)' }}>{reasoning}</span>
+            </button>
+            <button
+              type="submit"
+              aria-label={active ? '停止生成' : '发送'}
+              disabled={submitting || (!active && (!ready || !draft.trim()))}
+              data-action={active ? 'stop' : 'send'}
+              style={{ ...styles.buttonReset, ...styles.send, opacity: submitting || (!active && (!ready || !draft.trim())) ? 0.35 : 1, cursor: submitting ? 'not-allowed' : 'pointer' }}
+            >
+              <Icon kind={active ? 'stop' : 'send'} size={15} style={active ? { fill: 'currentColor', stroke: 'none' } : undefined} />
+            </button>
+          </div>
+        </div>
+      </form>
+      <div style={styles.runtime} aria-label="当前任务运行信息">
+        <span style={{ color: 'var(--co-ink-secondary)', fontFamily: 'inherit' }}>{model} · {reasoning}</span>
+        <span title={context ? '最近一轮输入 token，包含该 Codex 会话的历史上下文' : '尚无上下文用量'}>{context ? `上下文 ${formatTokens(context)} tok` : '上下文 —'}</span>
+        <span title={usage.total ? `该节点全部轮次输入与输出合计 ${usage.total} token` : '尚无 token 用量'}>{usage.total ? `累计 ${formatTokens(usage.total)} tok` : '累计 —'}</span>
+        <span title={usage.input ? `缓存命中 ${usage.cached} / 输入 ${usage.input} token` : '尚无缓存命中数据'}>{usage.cached ? `缓存 ${formatTokens(usage.cached)} · ${cacheRate}%` : '缓存 —'}</span>
+      </div>
+    </footer>
+  )
+}
+
+export { changedFileCount, usageFor }
+