@mickorz/opencode-agentic-workflow 0.3.0

package/dist/plugin/checkpoint-rpc.js

@@ -0,0 +1,73 @@
+/**
+ * Checkpoint RPC 契约（P2.3，server 与 TUI 双形态共享）
+ *
+ * 流向：
+ *   server workflow -> checkpoint() -> InteractiveCheckpointGate
+ *     --emit--> rpc.agentic-workflow.requested { requestId, label, message }
+ *     <--call-- TUI: ui.dialog.confirm -> rpc "reply" { requestId, approved, reason? }
+ *
+ * 事件经 OpenCode 事件流广播（V2EventRpc），TUI 侧 ctx.data.on 订阅；
+ * 应答经 client.rpc(...)（或 rpc.call）回到 server 侧注册的 handler。
+ */
+import { Rpc } from "@opencode/plugin/rpc";
+export const CheckpointRpc = Rpc.define({
+    id: "agentic-workflow",
+    methods: {
+        /** TUI -> server：应答审批请求 */
+        reply: {
+            input: {
+                type: "object",
+                properties: {
+                    requestId: { type: "string" },
+                    approved: { type: "boolean" },
+                    reason: { type: "string" },
+                },
+                required: ["requestId", "approved"],
+                additionalProperties: false,
+            },
+            output: {
+                type: "object",
+                properties: {
+                    ok: { type: "boolean" },
+                },
+                required: ["ok"],
+                additionalProperties: false,
+            },
+        },
+    },
+    events: {
+        /** server -> TUI：审批请求 */
+        requested: {
+            schema: {
+                type: "object",
+                properties: {
+                    requestId: { type: "string" },
+                    label: { type: "string" },
+                    message: { type: "string" },
+                },
+                required: ["requestId", "label", "message"],
+                additionalProperties: false,
+            },
+        },
+    },
+});
+/** TUI 订阅用的事件名（字面量类型，保证 data.on 类型匹配；与 CheckpointRpc.id 的一致性由单测保证） */
+export const CHECKPOINT_REQUESTED_EVENT = "rpc.agentic-workflow.requested";
+/** 解析 TUI 应答（handler 入参为 unknown，需手动收窄） */
+export function parseCheckpointReply(input) {
+    if (typeof input !== "object" || input === null)
+        return undefined;
+    const record = input;
+    if (typeof record.requestId !== "string" || typeof record.approved !== "boolean") {
+        return undefined;
+    }
+    if (record.reason !== undefined && typeof record.reason !== "string") {
+        return undefined;
+    }
+    return {
+        requestId: record.requestId,
+        approved: record.approved,
+        ...(typeof record.reason === "string" ? { reason: record.reason } : {}),
+    };
+}
+//# sourceMappingURL=checkpoint-rpc.js.map

package/dist/plugin/checkpoint-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-rpc.js","sourceRoot":"","sources":["../../src/plugin/checkpoint-rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAE1C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,kBAAkB;IACtB,OAAO,EAAE;QACP,2BAA2B;QAC3B,KAAK,EAAE;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC7B,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC3B;gBACD,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;gBACnC,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;iBACxB;gBACD,QAAQ,EAAE,CAAC,IAAI,CAAC;gBAChB,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;IACD,MAAM,EAAE;QACN,yBAAyB;QACzB,SAAS,EAAE;YACT,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC5B;gBACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,CAAC;gBAC3C,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;CACF,CAAC,CAAA;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,0BAA0B,GAAG,gCAAyC,CAAA;AAEnF,2CAA2C;AAC3C,MAAM,UAAU,oBAAoB,CAClC,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,MAAM,GAAG,KAAsE,CAAA;IACrF,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjF,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACrE,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAA;AACH,CAAC"}

package/dist/plugin/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * OpenCode V2 插件入口
+ *
+ * P0 接线：
+ *   setup(ctx)
+ *     -> 注册 OpenCodeV2Executor（绑定 ctx.session，经 withConcurrencyLimit 限流）
+ *     -> ctx.tool.transform 注册 workflow tool
+ *     -> Main Session 调用 workflow tool -> Workflow Core -> 子会话
+ *
+ * 插件 options（经 opencode.json 的 plugins[].options 传入）：
+ *   {
+ *     "package": "<路径>",
+ *     "options": {
+ *       "model": { "providerID": "glm", "id": "glm-5.3-flash" },
+ *       "agent": "build",
+ *       "concurrency": 3
+ *     }
+ *   }
+ *
+ * 架构约束：本目录（plugin 层）是仅有的允许触碰 OpenCode API 的位置。
+ */
+import { Plugin } from "@opencode/plugin";
+declare const _default: Plugin.Plugin;
+export default _default;

package/dist/plugin/index.js

@@ -0,0 +1,271 @@
+/**
+ * OpenCode V2 插件入口
+ *
+ * P0 接线：
+ *   setup(ctx)
+ *     -> 注册 OpenCodeV2Executor（绑定 ctx.session，经 withConcurrencyLimit 限流）
+ *     -> ctx.tool.transform 注册 workflow tool
+ *     -> Main Session 调用 workflow tool -> Workflow Core -> 子会话
+ *
+ * 插件 options（经 opencode.json 的 plugins[].options 传入）：
+ *   {
+ *     "package": "<路径>",
+ *     "options": {
+ *       "model": { "providerID": "glm", "id": "glm-5.3-flash" },
+ *       "agent": "build",
+ *       "concurrency": 3
+ *     }
+ *   }
+ *
+ * 架构约束：本目录（plugin 层）是仅有的允许触碰 OpenCode API 的位置。
+ */
+import { Plugin } from "@opencode/plugin";
+import path from "node:path";
+import { setCheckpointGate } from "../quality/checkpoint.js";
+import { setExecutor } from "../runtime/engine.js";
+import { withConcurrencyLimit } from "../runtime/semaphore.js";
+import { createFileTraceSink } from "../observability/trace.js";
+import { MetricsCollector, formatMetrics } from "../metrics/collector.js";
+import { WorkflowRegistry } from "../registry/registry.js";
+import { startWorkflow, resumeWorkflow, runWorkflowInline } from "../registry/runner.js";
+import { WorkflowExecutionError } from "../registry/errors.js";
+import { FileExecutionStore } from "../state/file-store.js";
+import { reliableWorkflow } from "../workflows/reliable.js";
+import { smokeWorkflow } from "../workflows/smoke.js";
+import { artifactWorkflow } from "../workflows/artifact.js";
+import { GitWorktreeProvider } from "../workspace/index.js";
+import { InteractiveCheckpointGate, } from "./interactive-checkpoint-gate.js";
+import { OpenCodeV2Executor } from "./opencode-v2-executor.js";
+import { buildPriceTable, estimateCostUSD } from "./price-table.js";
+import { PolicyCheckpointGate } from "./policy-checkpoint-gate.js";
+export default Plugin.define({
+    id: "agentic-workflow",
+    async setup(ctx) {
+        console.log(`[agentic-workflow] loaded: ${ctx.location.directory}`);
+        const options = ctx.options;
+        // P2.6 成本估算兜底：宿主价目表（ctx.model.list，USD/M tokens）。
+        // 宿主消息未带精确 cost（或记账为 0）时按 token 用量估算。
+        let priceTable = buildPriceTable((await ctx.model.list()).data);
+        const wantedModel = options.model
+            ? `${options.model.providerID}/${options.model.id}`
+            : undefined;
+        if (wantedModel && !priceTable.has(wantedModel)) {
+            // 价目缓存缺目标模型（实测：本地 models-dev 缓存可能滞后于线上）：
+            // 尝试重同步一次，失败则保持原表（成本退回宿主上报值）
+            try {
+                await ctx.model.reload();
+                priceTable = buildPriceTable((await ctx.model.list()).data);
+            }
+            catch {
+                /* 保持原表 */
+            }
+        }
+        // 用户价格覆盖（最高优先）
+        if (options.prices) {
+            for (const [model, price] of Object.entries(options.prices)) {
+                priceTable.set(model, price);
+            }
+        }
+        if (wantedModel) {
+            const price = priceTable.get(wantedModel);
+            console.log(`[agentic-workflow] price table: ${priceTable.size} models` +
+                (price
+                    ? `; ${wantedModel}: in $${price.input}/M out $${price.output}/M cache r $${price.cacheRead}/M`
+                    : `; ${wantedModel}: no pricing (cost will be host-reported only)`));
+        }
+        const executor = withConcurrencyLimit(new OpenCodeV2Executor({
+            session: ctx.session,
+            model: options.model,
+            agent: options.agent,
+            estimateCost: (model, usage) => estimateCostUSD(priceTable, model, usage),
+        }), options.concurrency);
+        setExecutor(executor);
+        // checkpoint 审批门：
+        //   auto-approve / auto-reject（默认策略门，headless 友好）
+        //   interactive（P2.3：TUI 双形态 + RPC，真正的人工审批）
+        if (options.checkpoint?.mode === "interactive") {
+            const gate = new InteractiveCheckpointGate(ctx.rpc, {
+                timeoutMs: options.checkpoint.timeoutMs,
+                onTimeout: options.checkpoint.onTimeout,
+            });
+            await gate.bind();
+            setCheckpointGate(gate);
+            console.log("[agentic-workflow] checkpoint gate: interactive (TUI dialog via RPC)");
+        }
+        else {
+            setCheckpointGate(new PolicyCheckpointGate(options.checkpoint?.mode));
+        }
+        // P2.6 metrics collector：纯事件总线消费者（token/cost/时长/计数聚合）
+        const metrics = new MetricsCollector();
+        // observability（P2.4）：可选 JSONL 事件 trace 落盘
+        // 注意：相对路径以项目目录（ctx.location.directory）为基准——
+        // 插件运行在 opencode service 进程内，其 cwd 不是项目目录
+        if (options.traceDir) {
+            const traceDir = path.isAbsolute(options.traceDir)
+                ? options.traceDir
+                : path.join(ctx.location.directory, options.traceDir);
+            const traceFile = path.join(traceDir, "events.jsonl");
+            createFileTraceSink(traceFile);
+            console.log(`[agentic-workflow] event trace sink: ${traceFile}`);
+            // P2.6 metrics：workflow 结束时把聚合快照落盘（查询/取证用，写失败只记录）
+            metrics.subscribeFileSink(path.join(traceDir, "metrics.json"));
+        }
+        // P2.5 workflow registry：新增 workflow = 新增定义 + 在此注册，
+        // 工具描述/枚举/路由全部由注册表驱动
+        const registry = new WorkflowRegistry()
+            .register(smokeWorkflow())
+            .register(reliableWorkflow({ checkCommand: options.checkCommand }))
+            .register(artifactWorkflow());
+        // P2.5 durable journal：配置 journalDir 后，run 经 startWorkflow/resumeWorkflow
+        // 走持久化链路（journal 记录 workflow {id, version} + args + steps，可恢复）
+        let store;
+        if (options.journalDir) {
+            const journalDir = path.isAbsolute(options.journalDir)
+                ? options.journalDir
+                : path.join(ctx.location.directory, options.journalDir);
+            store = new FileExecutionStore(journalDir);
+            console.log(`[agentic-workflow] journal store: ${journalDir}`);
+        }
+        // P2.7 workspace 隔离：GitWorktreeProvider（startDir = 项目目录，
+        // 内部解析到 git 仓库根；worktree 落在仓库同级目录，不污染仓库）
+        let workspaceBinding;
+        if (options.isolation?.mode === "git-worktree") {
+            const dir = options.isolation.dir
+                ? path.isAbsolute(options.isolation.dir)
+                    ? options.isolation.dir
+                    : path.join(ctx.location.directory, options.isolation.dir)
+                : undefined;
+            workspaceBinding = {
+                provider: new GitWorktreeProvider({ startDir: ctx.location.directory, dir }),
+                ...(options.isolation.baseRef ? { options: { baseRef: options.isolation.baseRef } } : {}),
+                cleanup: options.isolation.cleanup,
+            };
+            console.log(`[agentic-workflow] workspace isolation: git-worktree ` +
+                `(cleanup=${options.isolation.cleanup ?? "on-success"}${dir ? `, dir=${dir}` : ""})`);
+        }
+        // 递归防护：workflow 运行期间，子会话里的 agent 也可能看到并调用 workflow 工具，
+        // 形成递归 workflow；叠加并发信号量后会自饿死死锁（实测卡死）。
+        // P0 策略：运行中直接拒绝嵌套调用，让子 agent 用自身能力直接完成任务。
+        let workflowDepth = 0;
+        ctx.tool.transform((editor) => {
+            editor.add({
+                name: "workflow",
+                description: "Run a registered agentic workflow (flow = workflow id). Available workflows:\n" +
+                    `${registry.summarize()}\n` +
+                    "Returns the workflow's final output. " +
+                    "Do NOT call this tool from inside a workflow; do the work directly instead.",
+                input: {
+                    type: "object",
+                    properties: {
+                        topic: {
+                            type: "string",
+                            description: "The topic to analyze (not needed when resuming)",
+                        },
+                        flow: {
+                            type: "string",
+                            enum: registry.listLatest().map((definition) => definition.id),
+                            description: "Workflow id, default smoke",
+                        },
+                        resumeRunId: {
+                            type: "string",
+                            description: "Resume a previous durable run (from journal); overrides flow/topic. " +
+                                "Use the runId reported by a failed workflow call",
+                        },
+                    },
+                },
+                // V2 强校验：Tool.Result 使用 output 字段必须声明 output schema，
+                // 否则报 "Tool result declared output without an output schema"
+                output: {
+                    type: "string",
+                },
+                async execute(input) {
+                    const parsed = input ?? {};
+                    if (workflowDepth > 0) {
+                        return {
+                            output: "[agentic-workflow] nested workflow calls are not allowed: " +
+                                "another workflow is running. Complete the task directly yourself.",
+                        };
+                    }
+                    workflowDepth += 1;
+                    try {
+                        // resume 分支：journal -> registry 精确版本解析 -> 续跑
+                        if (typeof parsed.resumeRunId === "string" && parsed.resumeRunId.length > 0) {
+                            if (!store) {
+                                return {
+                                    output: "[agentic-workflow] resume requires the journalDir plugin option to be configured",
+                                };
+                            }
+                            const resumed = await resumeWorkflow(registry, store, parsed.resumeRunId, {
+                                workspace: workspaceBinding,
+                            });
+                            return {
+                                output: `[resumed ${resumed.workflow.id}@${resumed.workflow.version} ` +
+                                    `runId=${resumed.runId}]\n${resumed.output}`,
+                            };
+                        }
+                        const workflowId = typeof parsed.flow === "string" && parsed.flow.length > 0
+                            ? parsed.flow
+                            : "smoke";
+                        if (store) {
+                            const started = await startWorkflow(registry, store, workflowId, {
+                                topic: parsed.topic,
+                            }, { workspace: workspaceBinding });
+                            return {
+                                output: `[${started.workflow.id}@${started.workflow.version} ` +
+                                    `runId=${started.runId}]\n${started.output}`,
+                            };
+                        }
+                        // 未配置 journalDir：直跑（不持久化、不可恢复）
+                        const inline = await runWorkflowInline(registry, workflowId, {
+                            topic: parsed.topic,
+                        });
+                        return { output: inline.output };
+                    }
+                    catch (error) {
+                        // 抛错会诱发主 agent 无限重试工具调用（实测 22 轮重试耗尽配额）。
+                        // 失败信息以结果文本返回，让主 agent 停止重试并向用户报告。
+                        const message = error instanceof Error ? error.message : String(error);
+                        const resumeHint = error instanceof WorkflowExecutionError
+                            ? ` (runId: ${error.runId}; 可用 resumeRunId="${error.runId}" 恢复本次执行)`
+                            : "";
+                        return {
+                            output: `[agentic-workflow] workflow failed: ${message}${resumeHint}`,
+                        };
+                    }
+                    finally {
+                        workflowDepth -= 1;
+                    }
+                },
+            });
+            // P2.6 metrics 查询工具：读取聚合快照（纯只读，不执行任何 workflow）
+            editor.add({
+                name: "workflow_metrics",
+                description: "Query cumulative execution metrics of agentic workflows in this service: " +
+                    "agent calls, token usage (input/output/reasoning/cache), cost in USD, " +
+                    "per-model breakdown, workflow durations and quality-gate counters " +
+                    "(check/verify/checkpoint). Read-only; call after running workflows to report cost & usage.",
+                input: {
+                    type: "object",
+                    properties: {
+                        format: {
+                            type: "string",
+                            enum: ["text", "json"],
+                            description: "Output format, default text",
+                        },
+                    },
+                },
+                output: {
+                    type: "string",
+                },
+                async execute(input) {
+                    const parsed = input ?? {};
+                    const format = parsed.format === "json" ? "json" : "text";
+                    const snapshot = metrics.snapshot();
+                    const output = format === "json" ? JSON.stringify(snapshot, null, 2) : formatMetrics(snapshot);
+                    return { output };
+                },
+            });
+        });
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAA8C,MAAM,uBAAuB,CAAA;AACvG,OAAO,EACL,yBAAyB,GAE1B,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,kBAAkB,EAAyB,MAAM,2BAA2B,CAAA;AACrF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAyB,MAAM,6BAA6B,CAAA;AAEzF,eAAe,MAAM,CAAC,MAAM,CAAC;IAC3B,EAAE,EAAE,kBAAkB;IAEtB,KAAK,CAAC,KAAK,CAAC,GAAG;QACb,OAAO,CAAC,GAAG,CAAC,8BAA8B,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;QAEnE,MAAM,OAAO,GAAG,GAAG,CAAC,OA+BnB,CAAA;QAED,kDAAkD;QAClD,sCAAsC;QACtC,IAAI,UAAU,GAAG,eAAe,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QAC/D,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK;YAC/B,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE;YACnD,CAAC,CAAC,SAAS,CAAA;QACb,IAAI,WAAW,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAChD,yCAAyC;YACzC,6BAA6B;YAC7B,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAA;gBACxB,UAAU,GAAG,eAAe,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC;QACD,eAAe;QACf,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5D,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;YAC9B,CAAC;QACH,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;YACzC,OAAO,CAAC,GAAG,CACT,mCAAmC,UAAU,CAAC,IAAI,SAAS;gBACzD,CAAC,KAAK;oBACJ,CAAC,CAAC,KAAK,WAAW,SAAS,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,MAAM,eAAe,KAAK,CAAC,SAAS,IAAI;oBAC/F,CAAC,CAAC,KAAK,WAAW,gDAAgD,CAAC,CACxE,CAAA;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,oBAAoB,CACnC,IAAI,kBAAkB,CAAC;YACrB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC;SAC1E,CAAC,EACF,OAAO,CAAC,WAAW,CACpB,CAAA;QACD,WAAW,CAAC,QAAQ,CAAC,CAAA;QAErB,kBAAkB;QAClB,kDAAkD;QAClD,4CAA4C;QAC5C,IAAI,OAAO,CAAC,UAAU,EAAE,IAAI,KAAK,aAAa,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,yBAAyB,CAAC,GAAG,CAAC,GAAG,EAAE;gBAClD,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,SAAS;gBACvC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,SAAS;aACxC,CAAC,CAAA;YACF,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;YACjB,iBAAiB,CAAC,IAAI,CAAC,CAAA;YACvB,OAAO,CAAC,GAAG,CACT,sEAAsE,CACvE,CAAA;QACH,CAAC;aAAM,CAAC;YACN,iBAAiB,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAA;QACvE,CAAC;QAED,sDAAsD;QACtD,MAAM,OAAO,GAAG,IAAI,gBAAgB,EAAE,CAAA;QAEtC,2CAA2C;QAC3C,4CAA4C;QAC5C,0CAA0C;QAC1C,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAChD,CAAC,CAAC,OAAO,CAAC,QAAQ;gBAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;YACvD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAA;YACrD,mBAAmB,CAAC,SAAS,CAAC,CAAA;YAC9B,OAAO,CAAC,GAAG,CAAC,wCAAwC,SAAS,EAAE,CAAC,CAAA;YAEhE,kDAAkD;YAClD,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAA;QAChE,CAAC;QAED,oDAAoD;QACpD,qBAAqB;QACrB,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE;aACpC,QAAQ,CAAC,aAAa,EAAE,CAAC;aACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;aAClE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAA;QAE/B,0EAA0E;QAC1E,+DAA+D;QAC/D,IAAI,KAAiC,CAAA;QACrC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;gBACpD,CAAC,CAAC,OAAO,CAAC,UAAU;gBACpB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;YACzD,KAAK,GAAG,IAAI,kBAAkB,CAAC,UAAU,CAAC,CAAA;YAC1C,OAAO,CAAC,GAAG,CAAC,qCAAqC,UAAU,EAAE,CAAC,CAAA;QAChE,CAAC;QAED,yDAAyD;QACzD,yCAAyC;QACzC,IAAI,gBAAsH,CAAA;QAC1H,IAAI,OAAO,CAAC,SAAS,EAAE,IAAI,KAAK,cAAc,EAAE,CAAC;YAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG;gBAC/B,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC;oBACtC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG;oBACvB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC;gBAC5D,CAAC,CAAC,SAAS,CAAA;YACb,gBAAgB,GAAG;gBACjB,QAAQ,EAAE,IAAI,mBAAmB,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC;gBAC5E,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzF,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO;aACnC,CAAA;YACD,OAAO,CAAC,GAAG,CACT,uDAAuD;gBACrD,YAAY,OAAO,CAAC,SAAS,CAAC,OAAO,IAAI,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CACvF,CAAA;QACH,CAAC;QAED,uDAAuD;QACvD,sCAAsC;QACtC,0CAA0C;QAC1C,IAAI,aAAa,GAAG,CAAC,CAAA;QAErB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,CAAC;gBACT,IAAI,EAAE,UAAU;gBAChB,WAAW,EACT,gFAAgF;oBAChF,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI;oBAC3B,uCAAuC;oBACvC,6EAA6E;gBAC/E,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,iDAAiD;yBAC/D;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;4BAC9D,WAAW,EAAE,4BAA4B;yBAC1C;wBACD,WAAW,EAAE;4BACX,IAAI,EAAE,QAAQ;4BACd,WAAW,EACT,sEAAsE;gCACtE,kDAAkD;yBACrD;qBACF;iBACyB;gBAC5B,qDAAqD;gBACrD,6DAA6D;gBAC7D,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;iBACY;gBAC5B,KAAK,CAAC,OAAO,CAAC,KAAc;oBAC1B,MAAM,MAAM,GACT,KAAoE,IAAI,EAAE,CAAA;oBAC7E,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;wBACtB,OAAO;4BACL,MAAM,EACJ,4DAA4D;gCAC5D,mEAAmE;yBACtE,CAAA;oBACH,CAAC;oBACD,aAAa,IAAI,CAAC,CAAA;oBAClB,IAAI,CAAC;wBACH,6CAA6C;wBAC7C,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC5E,IAAI,CAAC,KAAK,EAAE,CAAC;gCACX,OAAO;oCACL,MAAM,EACJ,kFAAkF;iCACrF,CAAA;4BACH,CAAC;4BACD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE;gCACxE,SAAS,EAAE,gBAAgB;6BAC5B,CAAC,CAAA;4BACF,OAAO;gCACL,MAAM,EACJ,YAAY,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG;oCAC9D,SAAS,OAAO,CAAC,KAAK,MAAM,OAAO,CAAC,MAAM,EAAE;6BAC/C,CAAA;wBACH,CAAC;wBAED,MAAM,UAAU,GACd,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;4BACvD,CAAC,CAAC,MAAM,CAAC,IAAI;4BACb,CAAC,CAAC,OAAO,CAAA;wBAEb,IAAI,KAAK,EAAE,CAAC;4BACV,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE;gCAC/D,KAAK,EAAE,MAAM,CAAC,KAAK;6BACpB,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAA;4BACnC,OAAO;gCACL,MAAM,EACJ,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG;oCACtD,SAAS,OAAO,CAAC,KAAK,MAAM,OAAO,CAAC,MAAM,EAAE;6BAC/C,CAAA;wBACH,CAAC;wBAED,+BAA+B;wBAC/B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE;4BAC3D,KAAK,EAAE,MAAM,CAAC,KAAK;yBACpB,CAAC,CAAA;wBACF,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;oBAClC,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,wCAAwC;wBACxC,mCAAmC;wBACnC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;wBACtE,MAAM,UAAU,GACd,KAAK,YAAY,sBAAsB;4BACrC,CAAC,CAAC,YAAY,KAAK,CAAC,KAAK,qBAAqB,KAAK,CAAC,KAAK,WAAW;4BACpE,CAAC,CAAC,EAAE,CAAA;wBACR,OAAO;4BACL,MAAM,EAAE,uCAAuC,OAAO,GAAG,UAAU,EAAE;yBACtE,CAAA;oBACH,CAAC;4BAAS,CAAC;wBACT,aAAa,IAAI,CAAC,CAAA;oBACpB,CAAC;gBACH,CAAC;aACF,CAAC,CAAA;YAEF,+CAA+C;YAC/C,MAAM,CAAC,GAAG,CAAC;gBACT,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EACT,2EAA2E;oBAC3E,wEAAwE;oBACxE,oEAAoE;oBACpE,4FAA4F;gBAC9F,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;4BACtB,WAAW,EAAE,6BAA6B;yBAC3C;qBACF;iBACyB;gBAC5B,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;iBACY;gBAC5B,KAAK,CAAC,OAAO,CAAC,KAAc;oBAC1B,MAAM,MAAM,GAAI,KAA8B,IAAI,EAAE,CAAA;oBACpD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;oBACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;oBACnC,MAAM,MAAM,GACV,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;oBACjF,OAAO,EAAE,MAAM,EAAE,CAAA;gBACnB,CAAC;aACF,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;CACF,CAAC,CAAA"}

package/dist/plugin/interactive-checkpoint-gate.d.ts

@@ -0,0 +1,35 @@
+/**
+ * InteractiveCheckpointGate —— server 侧交互审批门（P2.3）
+ *
+ * 实现 CheckpointGate（Core 抽象不变，checkpoint() 零改动）：
+ *   ask(request)
+ *     -> emit rpc.agentic-workflow.requested 事件（TUI 订阅并弹确认框）
+ *     -> 挂起等待 reply RPC 回调或超时
+ *     -> 超时按 onTimeout 策略裁决（默认 reject——headless 无 TUI 应答时安全失败）
+ *
+ * 依赖注入：构造时传入 Plugin.Context["rpc"]（RpcDomain），
+ * 仅使用 register 一项能力，便于单测用 fake 注入。
+ */
+import type { Plugin } from "@opencode/plugin";
+import type { CheckpointDecision, CheckpointGate, CheckpointRequest } from "../quality/checkpoint.js";
+type RpcDomain = Plugin.Context["rpc"];
+export interface InteractiveCheckpointOptions {
+    /** 等待人工应答的超时毫秒数，默认 300000（5 分钟） */
+    timeoutMs?: number;
+    /** 超时裁决策略，默认 "reject"（无 TUI 应答时安全失败） */
+    onTimeout?: "reject" | "approve";
+}
+export declare class InteractiveCheckpointGate implements CheckpointGate {
+    private readonly rpc;
+    private readonly timeoutMs;
+    private readonly onTimeout;
+    private registration;
+    private readonly pending;
+    constructor(rpc: RpcDomain, options?: InteractiveCheckpointOptions);
+    /** 注册 reply handler（插件 setup 时调用；成功后才可作为 gate 生效） */
+    bind(): Promise<void>;
+    ask(request: CheckpointRequest): Promise<CheckpointDecision>;
+    /** 清理：未决请求全部按拒绝收口（插件卸载/热重载时调用） */
+    dispose(): void;
+}
+export {};

package/dist/plugin/interactive-checkpoint-gate.js

@@ -0,0 +1,86 @@
+/**
+ * InteractiveCheckpointGate —— server 侧交互审批门（P2.3）
+ *
+ * 实现 CheckpointGate（Core 抽象不变，checkpoint() 零改动）：
+ *   ask(request)
+ *     -> emit rpc.agentic-workflow.requested 事件（TUI 订阅并弹确认框）
+ *     -> 挂起等待 reply RPC 回调或超时
+ *     -> 超时按 onTimeout 策略裁决（默认 reject——headless 无 TUI 应答时安全失败）
+ *
+ * 依赖注入：构造时传入 Plugin.Context["rpc"]（RpcDomain），
+ * 仅使用 register 一项能力，便于单测用 fake 注入。
+ */
+import { randomUUID } from "node:crypto";
+import { CheckpointRpc, parseCheckpointReply } from "./checkpoint-rpc.js";
+export class InteractiveCheckpointGate {
+    rpc;
+    timeoutMs;
+    onTimeout;
+    registration;
+    pending = new Map();
+    constructor(rpc, options) {
+        this.rpc = rpc;
+        this.timeoutMs = options?.timeoutMs ?? 300_000;
+        this.onTimeout = options?.onTimeout ?? "reject";
+    }
+    /** 注册 reply handler（插件 setup 时调用；成功后才可作为 gate 生效） */
+    async bind() {
+        this.registration = await this.rpc.register(CheckpointRpc, {
+            reply: async (input) => {
+                const reply = parseCheckpointReply(input);
+                if (!reply) {
+                    return { ok: false };
+                }
+                const resolve = this.pending.get(reply.requestId);
+                if (!resolve) {
+                    // 已超时/已被处置的请求
+                    return { ok: false };
+                }
+                this.pending.delete(reply.requestId);
+                resolve({
+                    approved: reply.approved,
+                    reason: reply.reason ??
+                        (reply.approved ? undefined : "rejected by reviewer in TUI"),
+                });
+                return { ok: true };
+            },
+        });
+    }
+    async ask(request) {
+        if (!this.registration) {
+            throw new Error("[agentic-workflow] InteractiveCheckpointGate not bound: call bind() first");
+        }
+        const requestId = randomUUID();
+        await this.registration.events.emit("requested", {
+            requestId,
+            label: request.label,
+            message: request.message,
+        });
+        console.log(`[agentic-workflow] checkpoint waiting for interactive approval: ` +
+            `${request.label} (requestId=${requestId.slice(0, 8)}…)`);
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(requestId);
+                resolve(this.onTimeout === "approve"
+                    ? { approved: true, reason: "auto-approved after interactive timeout" }
+                    : {
+                        approved: false,
+                        reason: `no interactive reply within ${this.timeoutMs}ms ` +
+                            "(no TUI attached?)",
+                    });
+            }, this.timeoutMs);
+            this.pending.set(requestId, (decision) => {
+                clearTimeout(timer);
+                resolve(decision);
+            });
+        });
+    }
+    /** 清理：未决请求全部按拒绝收口（插件卸载/热重载时调用） */
+    dispose() {
+        for (const resolve of this.pending.values()) {
+            resolve({ approved: false, reason: "checkpoint gate disposed" });
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=interactive-checkpoint-gate.js.map

package/dist/plugin/interactive-checkpoint-gate.js.map

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

package/dist/plugin/opencode-v2-executor.d.ts

@@ -0,0 +1,55 @@
+/**
+ * OpenCodeV2Executor —— AgentExecutor 在 OpenCode V2 上的实现
+ *
+ * 调用链（全部基于 @opencode/plugin 2.0.22 已核实的类型）：
+ *   execute(task)
+ *     -> session.create({ parentID, title, agent?, model? })  创建子会话（挂在主会话下，TUI 可导航）
+ *     -> session.prompt({ sessionID, text })   投递用户消息（V2 为 inbox 异步模型，
+ *                                               返回 SessionInboxUser 而非 assistant 内容）
+ *     -> session.wait({ sessionID })           等待会话空闲（处理完成）
+ *     -> session.context({ sessionID })        拉取消息列表
+ *     -> 取最后一条 assistant 消息的 text parts 拼接为 output
+ *
+ * 架构约束：本文件与 plugin/index.ts 是仅有的允许触碰 OpenCode API 的位置。
+ */
+import type { Plugin } from "@opencode/plugin";
+import type { AgentExecutor, AgentResult, AgentTask, TokenUsage } from "../runtime/executor.js";
+/** plugin context 的 session 域类型（避免在多处直接依赖 @opencode/plugin） */
+export type SessionDomain = Plugin.Context["session"];
+/** 子会话使用的模型引用（对应 models 列表中的 providerID/id） */
+export interface ExecutorModelRef {
+    id: string;
+    providerID: string;
+    variant?: string;
+}
+export interface OpenCodeV2ExecutorOptions {
+    /** OpenCode V2 plugin context 提供的 session 域 */
+    session: SessionDomain;
+    /** 主会话 ID；子会话挂在其下（TUI 父子视图可导航） */
+    parentSessionId?: string;
+    /** 子会话标题前缀，默认 "workflow" */
+    titlePrefix?: string;
+    /**
+     * 子会话使用的模型。不指定时子会话会用默认 agent 的默认模型，
+     * 可能与主会话模型不一致（实测 CLI --model 不会传导到 session.create）。
+     */
+    model?: ExecutorModelRef;
+    /** 子会话使用的 OpenCode agent 名（如 build / explore / plan） */
+    agent?: string;
+    /**
+     * 成本估算兜底（P2.6 metrics）：宿主消息未带 cost 时，
+     * 由宿主价目表（ctx.model.list）按 token 用量估算 USD。
+     */
+    estimateCost?: (model: string, usage: TokenUsage) => number | undefined;
+}
+export declare class OpenCodeV2Executor implements AgentExecutor {
+    private readonly session;
+    private readonly parentSessionId?;
+    private readonly titlePrefix;
+    private readonly model?;
+    private readonly agent?;
+    private readonly estimateCost?;
+    private counter;
+    constructor(options: OpenCodeV2ExecutorOptions);
+    execute(task: AgentTask): Promise<AgentResult>;
+}