@mickorz/opencode-agentic-workflow 0.4.0 → 0.5.1

package/dist/plugin/opencode-v2-executor.js

@@ -12,6 +12,7 @@
  *
  * 架构约束：本文件与 plugin/index.ts 是仅有的允许触碰 OpenCode API 的位置。
  */
+import { trackRunSession, untrackRunSession } from "./run-sessions.js";
 export class OpenCodeV2Executor {
     session;
     parentSessionId;
@@ -33,60 +34,71 @@ export class OpenCodeV2Executor {
         const created = await this.session.create({
             parentID: this.parentSessionId,
             title: `${this.titlePrefix}#${this.counter}`,
-            model: this.model,
+            // P1-4 调用级覆盖：task.model 优先于构造期默认（agent() 注入）
+            model: task.model ?? this.model,
             agent: this.agent,
             // P2.7 隔离：子会话 cwd 绑定到 workflow workspace（worktree 根）
             ...(task.cwd ? { location: { directory: task.cwd } } : {}),
         });
         const sessionID = created.id;
-        await this.session.prompt({
-            sessionID,
-            text: task.prompt,
-        });
-        // V2 的 prompt 是 inbox 投递：等待会话处理完成后再读结果
-        await this.session.wait({ sessionID });
-        const messages = await this.session.context({ sessionID });
-        // 从后往前找最后一条 assistant 消息
-        for (let i = messages.length - 1; i >= 0; i--) {
-            const message = messages[i];
-            if (message && message.type === "assistant") {
-                const output = message.content
-                    .filter((part) => part.type === "text")
-                    .map((part) => part.text)
-                    .join("\n")
-                    .trim();
-                if (output.length > 0) {
-                    // token 用量 / 成本 / 模型（V2 assistant 消息自带；P2.6 metrics 消费）
-                    const usage = message.tokens && {
-                        input: message.tokens.input,
-                        output: message.tokens.output,
-                        reasoning: message.tokens.reasoning,
-                        cache: {
-                            read: message.tokens.cache.read,
-                            write: message.tokens.cache.write,
-                        },
-                    };
-                    const model = message.model && `${message.model.providerID}/${message.model.id}`;
-                    return {
-                        output,
-                        usage,
-                        // 成本优先级：宿主正值（精确）> 价目表估算（宿主 0/缺失时兜底——
-                        // 实测部分 provider 宿主记账为 0 但 models.dev 有实价）> 宿主原值
-                        costUSD: message.cost && message.cost > 0
-                            ? message.cost
-                            : (usage && model ? this.estimateCost?.(model, usage) : undefined) ??
-                                message.cost,
-                        model,
-                    };
+        // 并发 run 递归防护：任务执行期内登记本会话（workflow 工具据此拒绝
+        // 来自 run 内部的嵌套调用）；结束注销——空闲会话不会再发起工具调用
+        trackRunSession(sessionID);
+        try {
+            await this.session.prompt({
+                sessionID,
+                text: task.prompt,
+            });
+            // V2 的 prompt 是 inbox 投递：等待会话处理完成后再读结果
+            await this.session.wait({ sessionID });
+            const messages = await this.session.context({ sessionID });
+            // 从后往前找最后一条 assistant 消息
+            for (let i = messages.length - 1; i >= 0; i--) {
+                const message = messages[i];
+                if (message && message.type === "assistant") {
+                    const output = message.content
+                        .filter((part) => part.type === "text")
+                        .map((part) => part.text)
+                        .join("\n")
+                        .trim();
+                    if (output.length > 0) {
+                        // token 用量 / 成本 / 模型（V2 assistant 消息自带；P2.6 metrics 消费）
+                        const usage = message.tokens && {
+                            input: message.tokens.input,
+                            output: message.tokens.output,
+                            reasoning: message.tokens.reasoning,
+                            cache: {
+                                read: message.tokens.cache.read,
+                                write: message.tokens.cache.write,
+                            },
+                        };
+                        const model = message.model && `${message.model.providerID}/${message.model.id}`;
+                        return {
+                            output,
+                            usage,
+                            // 成本优先级：宿主正值（精确）> 价目表估算（宿主 0/缺失时兜底——
+                            // 实测部分 provider 宿主记账为 0 但 models.dev 有实价）> 宿主原值
+                            costUSD: message.cost && message.cost > 0
+                                ? message.cost
+                                : (usage && model ? this.estimateCost?.(model, usage) : undefined) ??
+                                    message.cost,
+                            model,
+                            // Open Session 回放：journal 按步骤聚合，详情/回放按它拉取完整对话
+                            sessionID,
+                        };
+                    }
+                    // assistant 存在但无文本：带出底层错误信息（如 provider 限流），便于排查
+                    const detail = message.error
+                        ? `${message.error.type ?? "error"}: ${message.error.message ?? "unknown"}`
+                        : "assistant message has no text parts";
+                    throw new Error(`[agentic-workflow] session ${sessionID} failed: ${detail}`);
                 }
-                // assistant 存在但无文本：带出底层错误信息（如 provider 限流），便于排查
-                const detail = message.error
-                    ? `${message.error.type ?? "error"}: ${message.error.message ?? "unknown"}`
-                    : "assistant message has no text parts";
-                throw new Error(`[agentic-workflow] session ${sessionID} failed: ${detail}`);
             }
+            throw new Error(`[agentic-workflow] session ${sessionID} finished without assistant message`);
+        }
+        finally {
+            untrackRunSession(sessionID);
         }
-        throw new Error(`[agentic-workflow] session ${sessionID} finished without assistant message`);
     }
 }
 //# sourceMappingURL=opencode-v2-executor.js.map

package/dist/plugin/opencode-v2-executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"opencode-v2-executor.js","sourceRoot":"","sources":["../../src/plugin/opencode-v2-executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"opencode-v2-executor.js","sourceRoot":"","sources":["../../src/plugin/opencode-v2-executor.ts"],"names":[],"mappings":"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"}

package/dist/plugin/progress-board.d.ts

@@ -0,0 +1,64 @@
+/**
+ * ProgressBoard —— server 侧运行看板（P2-8 TUI 进度树数据面）
+ *
+ * 职责：
+ *   - 订阅核心事件总线的 run.progress（RunJournal 每次状态转换的全量快照）
+ *   - 维护近期 run 快照（runId 去重、newest first、容量上限）
+ *   - 每次更新转发为 RPC 事件（TUI 面板实时消费）；无 TUI 监听时成本可忽略
+ *   - snapshot 方法返回当前板（面板打开时初始同步）
+ *
+ * 快照即真相：不做增量对账——单飞语义下（每进程同时至多一个 run），
+ * 全量快照流天然有序；历史 run 以 store 种子补齐。
+ *
+ * 依赖全部注入（subscribe/emit/store），单测用 fake 即可覆盖。
+ */
+import type { Plugin } from "@opencode/plugin";
+import { type EventBus, type RunProgressSnapshot, type WorkflowEvent } from "../observability/events.js";
+import type { ExecutionStore } from "../state/store.js";
+import { type SessionReplayMessage } from "./progress-rpc.js";
+type RpcDomain = Plugin.Context["rpc"];
+export interface ProgressBoardOptions {
+    /** 近期 run 保留上限（默认 20） */
+    capacity?: number;
+    /** 事件总线（默认全局 bus；测试注入） */
+    bus?: EventBus;
+    /** 初始种子（bind 时由 store 读出） */
+    seed?: readonly RunProgressSnapshot[];
+}
+export declare class ProgressBoard {
+    private readonly emit;
+    private readonly runs;
+    private readonly order;
+    private readonly capacity;
+    private unsubscribe;
+    constructor(emit: (run: RunProgressSnapshot) => void, options?: ProgressBoardOptions);
+    /** 核心事件入口（仅消费 run.progress） */
+    onEvent(event: WorkflowEvent): void;
+    /**
+     * 应用一个快照：runId 去重、维持 newest-first、容量淘汰。
+     * forward=false 用于种子（不回发 RPC——面板尚未订阅，快照方法自会读到）。
+     */
+    apply(run: RunProgressSnapshot, options?: {
+        forward?: boolean;
+    }): void;
+    /** 当前板（newest first；snapshot 方法与测试用） */
+    list(): readonly RunProgressSnapshot[];
+    dispose(): void;
+}
+/**
+ * 插件装配：注册 ProgressRpc（snapshot/detail/session 方法）+ 订阅事件总线
+ * + store 种子。返回 board（持有者可 dispose；插件生命周期内常驻）。
+ */
+export declare function bindProgressBoard(deps: {
+    rpc: RpcDomain;
+    store?: ExecutionStore;
+    /**
+     * Open Session 回放数据源：宿主会话消息拉取（ctx.session.context 映射）。
+     * 缺席时 session 方法统一回 null（旧 server 行为，面板静默降级）。
+     */
+    fetchSessionMessages?: (sessionID: string) => Promise<SessionReplayMessage[]>;
+    options?: ProgressBoardOptions;
+}): Promise<ProgressBoard>;
+/** store 里的近期 run -> 快照种子（newest first，容量截断） */
+export declare function seedFromStore(store: ExecutionStore, capacity?: number): Promise<RunProgressSnapshot[]>;
+export {};

package/dist/plugin/progress-board.js

@@ -0,0 +1,150 @@
+/**
+ * ProgressBoard —— server 侧运行看板（P2-8 TUI 进度树数据面）
+ *
+ * 职责：
+ *   - 订阅核心事件总线的 run.progress（RunJournal 每次状态转换的全量快照）
+ *   - 维护近期 run 快照（runId 去重、newest first、容量上限）
+ *   - 每次更新转发为 RPC 事件（TUI 面板实时消费）；无 TUI 监听时成本可忽略
+ *   - snapshot 方法返回当前板（面板打开时初始同步）
+ *
+ * 快照即真相：不做增量对账——单飞语义下（每进程同时至多一个 run），
+ * 全量快照流天然有序；历史 run 以 store 种子补齐。
+ *
+ * 依赖全部注入（subscribe/emit/store），单测用 fake 即可覆盖。
+ */
+import { getEventBus, } from "../observability/events.js";
+import { toProgressSnapshot, toRunDetail } from "../state/recorder.js";
+import { ProgressRpc, parseRunDetailRequest, parseSessionReplayRequest, } from "./progress-rpc.js";
+/** 回放消息的展示上限（防大对话刷爆面板/RPC 载荷） */
+const REPLAY_MESSAGE_LIMIT = 50;
+/** 单条消息文本预览上限 */
+const REPLAY_TEXT_LIMIT = 800;
+export class ProgressBoard {
+    emit;
+    runs = new Map();
+    order = [];
+    capacity;
+    unsubscribe;
+    constructor(emit, options) {
+        this.emit = emit;
+        this.capacity = options?.capacity ?? 20;
+        for (const run of options?.seed ?? []) {
+            this.apply(run, { forward: false });
+        }
+        this.unsubscribe = (options?.bus ?? getEventBus()).subscribe((event) => {
+            this.onEvent(event);
+        });
+    }
+    /** 核心事件入口（仅消费 run.progress） */
+    onEvent(event) {
+        if (event.type !== "run.progress")
+            return;
+        this.apply(event.run, { forward: true });
+    }
+    /**
+     * 应用一个快照：runId 去重、维持 newest-first、容量淘汰。
+     * forward=false 用于种子（不回发 RPC——面板尚未订阅，快照方法自会读到）。
+     */
+    apply(run, options) {
+        const forward = options?.forward ?? true;
+        if (!this.runs.has(run.runId)) {
+            this.order.unshift(run.runId);
+        }
+        this.runs.set(run.runId, run);
+        // 重新按开始时间排序（runId 重复应用时保持位置稳定即可）
+        this.order.sort((a, b) => {
+            const ra = this.runs.get(a);
+            const rb = this.runs.get(b);
+            const sa = ra?.startedAt ?? 0;
+            const sb = rb?.startedAt ?? 0;
+            return sb - sa;
+        });
+        while (this.order.length > this.capacity) {
+            const evicted = this.order.pop();
+            if (evicted !== undefined)
+                this.runs.delete(evicted);
+        }
+        if (forward) {
+            this.emit(run);
+        }
+    }
+    /** 当前板（newest first；snapshot 方法与测试用） */
+    list() {
+        const out = [];
+        for (const runId of this.order) {
+            const run = this.runs.get(runId);
+            if (run)
+                out.push(run);
+        }
+        return out;
+    }
+    dispose() {
+        this.unsubscribe?.();
+        this.unsubscribe = undefined;
+    }
+}
+/**
+ * 插件装配：注册 ProgressRpc（snapshot/detail/session 方法）+ 订阅事件总线
+ * + store 种子。返回 board（持有者可 dispose；插件生命周期内常驻）。
+ */
+export async function bindProgressBoard(deps) {
+    let board;
+    const registration = await deps.rpc.register(ProgressRpc, {
+        snapshot: async () => ({ runs: board ? board.list().slice() : [] }),
+        // journal 单读（无 journalDir 配置 -> store 缺席 -> null；面板不渲染详情区）
+        detail: async (input) => {
+            const runId = parseRunDetailRequest(input);
+            if (!deps.store || runId === undefined)
+                return { run: null };
+            const run = await deps.store.getRun(runId);
+            return { run: run ? toRunDetail(run) : null };
+        },
+        // Open Session 回放：journal 定位步骤会话 -> 宿主拉取 -> 预览截断
+        session: async (input) => {
+            const request = parseSessionReplayRequest(input);
+            if (!deps.store || !deps.fetchSessionMessages || request === undefined) {
+                return { session: null };
+            }
+            const run = await deps.store.getRun(request.runId);
+            const step = run?.steps.find((s) => s.name === request.step && s.sessionIDs !== undefined && s.sessionIDs.length > 0);
+            const sessionIDs = step?.sessionIDs;
+            if (!sessionIDs)
+                return { session: null };
+            const sessionID = request.index !== undefined
+                ? (sessionIDs[request.index] ?? sessionIDs[sessionIDs.length - 1])
+                : sessionIDs[sessionIDs.length - 1];
+            const messages = await deps.fetchSessionMessages(sessionID);
+            return {
+                session: {
+                    sessionID,
+                    step: request.step,
+                    messages: messages
+                        .slice(0, REPLAY_MESSAGE_LIMIT)
+                        .map((message) => ({ ...message, text: message.text.slice(0, REPLAY_TEXT_LIMIT) })),
+                },
+            };
+        },
+    });
+    // store 种子：面板打开时能立即看到近期历史 run（不只是本次会话的）
+    let seed;
+    if (deps.store) {
+        seed = await seedFromStore(deps.store, deps.options?.capacity ?? 20);
+    }
+    board = new ProgressBoard((run) => {
+        void registration.events.emit("progress", run).catch((error) => {
+            // 转发失败绝不影响 workflow（事件总线隔离原则的同款纪律）
+            console.log(`[agentic-workflow] progress emit failed (runId=${run.runId}): ` +
+                `${error instanceof Error ? error.message : String(error)}`);
+        });
+    }, { ...deps.options, ...(seed ? { seed } : {}) });
+    return board;
+}
+/** store 里的近期 run -> 快照种子（newest first，容量截断） */
+export async function seedFromStore(store, capacity = 20) {
+    const runs = await store.listRuns();
+    return runs
+        .sort((a, b) => b.startedAt - a.startedAt)
+        .slice(0, capacity)
+        .map(toProgressSnapshot);
+}
+//# sourceMappingURL=progress-board.js.map

package/dist/plugin/progress-board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-board.js","sourceRoot":"","sources":["../../src/plugin/progress-board.ts"],"names":[],"mappings":"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"}