botmux 2.93.0 → 2.94.0

package/dist/im/lark/v3-blocked-card.js

@@ -0,0 +1,206 @@
+/**
+ * v3 blocked-node 重试卡 —— blocked/failed 两档里 blocked（契约性失败，可恢复）
+ * 的飞书入口。daemon 驱动的 run 走到 runBlocked 时发这张卡；点「重试」=
+ * `requestV3Retry`（append nodeRetryRequested）+ 重驱动，幂等沿 humanGate wait
+ * 那套思路（codex 拍的第一版边界：卡只带 runId/nodeId/attemptId/errorCode/
+ * message + Retry，不塞 live 终端 / 复杂诊断）。
+ *
+ * 自带 action namespace（`v3_blocked_retry`），不与 gate 卡混用。纯函数，单测友好。
+ */
+import { config } from '../../config.js';
+export const V3_BLOCKED_RETRY_ACTION = 'v3_blocked_retry';
+/** 运行时 human-ask 选项按钮的 action（与「重试」同卡不同 namespace）。 */
+export const V3_BLOCKED_ASK_ANSWER_ACTION = 'v3_blocked_ask_answer';
+export const V3_BLOCKED_ASK_TEXT_FIELD = 'v3_blocked_ask_text';
+const DEFAULT_MESSAGE_MAX_CHARS = 500;
+/** 稳定 nonce：同一 run 同一节点同一 attempt 的卡 nonce 固定（重发卡一致）；
+ *  attempt 入 nonce —— 重试后旧卡的 nonce 对不上新 attempt，不会误触。 */
+export function v3BlockedCardNonce(runId, nodeId, attemptId) {
+    return `v3blocked:${runId}:${nodeId}:${attemptId}`;
+}
+function v3RunDetailUrl(runId) {
+    return `http://${config.dashboard.externalHost}:${config.dashboard.port}/#/v3/${encodeURIComponent(runId)}`;
+}
+export function buildV3BlockedCard(input) {
+    const nonce = input.nonce ?? v3BlockedCardNonce(input.runId, input.nodeId, input.attemptId);
+    const webDetailUrl = input.webDetailUrl ?? v3RunDetailUrl(input.runId);
+    const msgMax = input.messageMaxChars ?? DEFAULT_MESSAGE_MAX_CHARS;
+    const { retried, ask, answered } = input;
+    // 四态共用一张卡，header 决定语气：蓝=等人拍板 / 绿=已回答·已重试 / 橙=受阻待重试。
+    let title;
+    let template;
+    if (answered) {
+        title = `已回答：节点 ${input.nodeId}`;
+        template = 'green';
+    }
+    else if (ask) {
+        title = `需要你拍板：节点 ${input.nodeId}`;
+        template = 'blue';
+    }
+    else if (retried) {
+        title = `已重试：节点 ${input.nodeId}`;
+        template = 'green';
+    }
+    else {
+        title = `节点受阻：${input.nodeId}`;
+        template = 'orange';
+    }
+    const attemptNNN = input.attemptId.slice(input.attemptId.lastIndexOf('/') + 1);
+    const elements = [
+        {
+            tag: 'div',
+            fields: [
+                { is_short: true, text: { tag: 'lark_md', content: `**Run**\n${escapeMd(short(input.runId, 24))}` } },
+                { is_short: true, text: { tag: 'lark_md', content: `**节点 / attempt**\n${escapeMd(input.nodeId)} · ${escapeMd(attemptNNN)}` } },
+            ],
+        },
+        { tag: 'hr' },
+    ];
+    if (ask || answered) {
+        // ── 运行时 human-ask：渲染问题 + 选项按钮（或冻结的「已回答」）──
+        const question = ask?.question;
+        if (question) {
+            elements.push({
+                tag: 'div',
+                text: { tag: 'lark_md', content: `**${escapeMd(truncate(question, msgMax))}**` },
+            });
+        }
+        if (answered) {
+            const answerPreview = answered.text ?? answered.selected ?? '';
+            elements.push({ tag: 'hr' });
+            elements.push({
+                tag: 'div',
+                text: {
+                    tag: 'lark_md',
+                    content: `✅ 已回答 → **${escapeMd(truncate(answerPreview, msgMax))}**` +
+                        (answered.by ? ` · by ${escapeMd(short(answered.by, 20))}` : '') +
+                        ` · 重跑 ${escapeMd(answered.nextAttemptId.slice(answered.nextAttemptId.lastIndexOf('/') + 1))}`,
+                },
+            });
+        }
+        else if (ask?.freeText) {
+            elements.push({
+                tag: 'form',
+                name: 'v3_blocked_ask_text_form',
+                elements: [
+                    {
+                        tag: 'input',
+                        name: V3_BLOCKED_ASK_TEXT_FIELD,
+                        placeholder: { tag: 'plain_text', content: '填写答案' },
+                    },
+                    {
+                        tag: 'button',
+                        text: { tag: 'plain_text', content: '提交并重跑' },
+                        type: 'primary',
+                        name: 'v3_blocked_ask_text_submit',
+                        action_type: 'form_submit',
+                        value: {
+                            action: V3_BLOCKED_ASK_ANSWER_ACTION,
+                            runId: input.runId,
+                            nodeId: input.nodeId,
+                            attemptId: input.attemptId,
+                            answerKind: 'text',
+                            nonce,
+                        },
+                    },
+                ],
+            });
+        }
+        else if (ask) {
+            // 一个选项一个按钮，选中文本回传为 answer.selected（按 attempt 入 nonce 防 stale）。
+            elements.push({
+                tag: 'action',
+                actions: (ask.options ?? []).map((opt) => ({
+                    tag: 'button',
+                    text: { tag: 'plain_text', content: short(opt, 80) },
+                    type: 'primary',
+                    value: {
+                        action: V3_BLOCKED_ASK_ANSWER_ACTION,
+                        runId: input.runId,
+                        nodeId: input.nodeId,
+                        attemptId: input.attemptId,
+                        selected: opt,
+                        nonce,
+                    },
+                })),
+            });
+        }
+    }
+    else {
+        // ── 普通受阻 / 已重试 ──
+        elements.push({
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: `**原因**\n${escapeMd(input.errorClass ?? 'blocked')}` +
+                    (input.errorCode ? ` · \`${escapeMd(input.errorCode)}\`` : '') +
+                    (input.message ? `\n${escapeMd(truncate(input.message, msgMax))}` : ''),
+            },
+        });
+        if (retried) {
+            elements.push({ tag: 'hr' });
+            elements.push({
+                tag: 'div',
+                text: {
+                    tag: 'lark_md',
+                    content: `🔄 已重试 → ${escapeMd(retried.nextAttemptId.slice(retried.nextAttemptId.lastIndexOf('/') + 1))}` +
+                        (retried.by ? ` · by ${escapeMd(short(retried.by, 20))}` : ''),
+                },
+            });
+        }
+        else {
+            elements.push({
+                tag: 'div',
+                text: { tag: 'lark_md', content: '处理掉阻塞原因（如完成鉴权）后点重试，会以新 attempt 重跑该节点。' },
+            });
+            elements.push({
+                tag: 'action',
+                actions: [
+                    {
+                        tag: 'button',
+                        text: { tag: 'plain_text', content: '🔄 重试' },
+                        type: 'primary',
+                        value: {
+                            action: V3_BLOCKED_RETRY_ACTION,
+                            runId: input.runId,
+                            nodeId: input.nodeId,
+                            attemptId: input.attemptId,
+                            nonce,
+                        },
+                    },
+                ],
+            });
+        }
+    }
+    elements.push({
+        tag: 'action',
+        actions: [
+            {
+                tag: 'button',
+                text: { tag: 'plain_text', content: 'Web 详情' },
+                type: 'default',
+                multi_url: {
+                    url: webDetailUrl, pc_url: webDetailUrl, android_url: webDetailUrl, ios_url: webDetailUrl,
+                },
+            },
+        ],
+    });
+    return JSON.stringify({
+        config: { wide_screen_mode: true },
+        header: { template, title: { tag: 'plain_text', content: title } },
+        elements,
+    });
+}
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return `${s.slice(0, max)}…（截断，完整见 Web 详情）`;
+}
+function short(s, max) {
+    return s.length <= max ? s : `${s.slice(0, max)}…`;
+}
+/** 转义 lark_md 里会被解析的字符，防 message 注入破坏卡片结构。 */
+function escapeMd(s) {
+    return s.replace(/[\\*_~`\[\]]/g, (c) => `\\${c}`);
+}
+//# sourceMappingURL=v3-blocked-card.js.map

package/dist/im/lark/v3-blocked-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-blocked-card.js","sourceRoot":"","sources":["../../../src/im/lark/v3-blocked-card.ts"],"names":[],"mappings":"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"}

package/dist/im/lark/v3-gate-card-handler.d.ts

@@ -0,0 +1,31 @@
+/**
+ * v3 humanGate 审批卡点击处理 —— card-handler 的 v3 分支（对称于 v0.2 的
+ * `workflow-card-handler`，但走 v3 自己的 wait/journal 权威，不复用 v0.2 wait
+ * path）。把一次点击翻译成：权限校验 → `resolveV3GateClick`（幂等 + terminal-safe）
+ * → 冻结卡 / toast + 触发 `driveV3Run` 续跑。
+ *
+ * 纯逻辑 + 注入 seam（resolveClick / driveRun / canResolve），单测友好；真正的
+ * Lark 发送 / driveV3Run 由 daemon 在 deps 里接。
+ */
+import { type V3GateActionValue } from './v3-gate-card.js';
+import { resolveV3GateClick } from '../../workflows/v3/daemon-run.js';
+import { type RunChatBinding } from '../../workflows/v3/grill-state.js';
+export declare function isV3GateAction(action: unknown): boolean;
+export interface V3GateCardHandlerDeps {
+    baseDir?: string;
+    /** Re-enter the run after a resolved gate.  Fire-and-forget; the daemon logs
+     *  errors (this is the `driveV3Run` wiring with postGateCard/onTerminal). */
+    driveRun: (runId: string) => void;
+    /** Permission: may this operator resolve gates for this run?  Default: allow
+     *  (MVP — daemon injects a canOperate-backed check). */
+    canResolve?: (binding: RunChatBinding | undefined, operatorOpenId: string | undefined) => boolean;
+    /** Injectable for tests. Default = real resolveV3GateClick. */
+    resolveClick?: typeof resolveV3GateClick;
+}
+/**
+ * Handle a v3 gate card click.  Returns the Lark card-action response: a frozen
+ * card object (replaces the clicked card so its buttons can't re-submit), or a
+ * `{ toast }` wrapper.  Triggers `driveRun` as a side effect on a real resolve.
+ */
+export declare function handleV3GateAction(value: V3GateActionValue, operatorOpenId: string | undefined, deps: V3GateCardHandlerDeps): Promise<unknown>;
+//# sourceMappingURL=v3-gate-card-handler.d.ts.map

package/dist/im/lark/v3-gate-card-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-gate-card-handler.d.ts","sourceRoot":"","sources":["../../../src/im/lark/v3-gate-card-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAI3C,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;iFAC6E;IAC7E,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;4DACwD;IACxD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;IAClG,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,kBAAkB,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAwFlB"}

package/dist/im/lark/v3-gate-card-handler.js

@@ -0,0 +1,110 @@
+/**
+ * v3 humanGate 审批卡点击处理 —— card-handler 的 v3 分支（对称于 v0.2 的
+ * `workflow-card-handler`，但走 v3 自己的 wait/journal 权威，不复用 v0.2 wait
+ * path）。把一次点击翻译成：权限校验 → `resolveV3GateClick`（幂等 + terminal-safe）
+ * → 冻结卡 / toast + 触发 `driveV3Run` 续跑。
+ *
+ * 纯逻辑 + 注入 seam（resolveClick / driveRun / canResolve），单测友好；真正的
+ * Lark 发送 / driveV3Run 由 daemon 在 deps 里接。
+ */
+import { join } from 'node:path';
+import { V3_GATE_APPROVE_ACTION, V3_GATE_REJECT_ACTION, buildV3GateCard, v3GateCardNonce, } from './v3-gate-card.js';
+import { resolveV3GateClick } from '../../workflows/v3/daemon-run.js';
+import { readGrillState, defaultBaseDir, } from '../../workflows/v3/grill-state.js';
+import { readWait } from '../../workflows/v3/human-gate.js';
+import { isValidRunId, isValidWaitId } from '../../workflows/v3/ops-projection.js';
+export function isV3GateAction(action) {
+    return action === V3_GATE_APPROVE_ACTION || action === V3_GATE_REJECT_ACTION;
+}
+/**
+ * Handle a v3 gate card click.  Returns the Lark card-action response: a frozen
+ * card object (replaces the clicked card so its buttons can't re-submit), or a
+ * `{ toast }` wrapper.  Triggers `driveRun` as a side effect on a real resolve.
+ */
+export async function handleV3GateAction(value, operatorOpenId, deps) {
+    const baseDir = deps.baseDir ?? defaultBaseDir();
+    // Guard BOTH externally-supplied ids before any path join: waitId flows into
+    // `runDir/waits/<waitId>.json` (resolveV3GateClick → human-gate), and the
+    // reproducible non-secret nonce can't stop a `../..` waitId on its own.
+    if (!isValidRunId(value.runId)) {
+        return { toast: { type: 'warning', content: 'gate 已失效（非法 run）' } };
+    }
+    if (typeof value.waitId !== 'string' || !isValidWaitId(value.waitId)) {
+        return { toast: { type: 'warning', content: 'gate 已失效（非法 wait）' } };
+    }
+    // Nonce check (codex medium): the card carries a stable nonce; a value whose
+    // nonce doesn't match the run/wait pair is a tampered/foreign card → stale.
+    if (value.nonce !== v3GateCardNonce(value.runId, value.waitId)) {
+        return { toast: { type: 'warning', content: 'gate 卡已失效（nonce 不匹配）' } };
+    }
+    const runDir = join(baseDir, value.runId);
+    const grill = readGrillState(runDir);
+    const binding = grill?.chatBinding;
+    if (deps.canResolve && !deps.canResolve(binding, operatorOpenId)) {
+        return { toast: { type: 'warning', content: '你没有权限审批这个 gate' } };
+    }
+    const selected = value.selected ?? (value.action === V3_GATE_APPROVE_ACTION ? 'approve' : 'reject');
+    const resolveClick = deps.resolveClick ?? resolveV3GateClick;
+    let outcome;
+    try {
+        outcome = resolveClick(baseDir, value.runId, {
+            waitId: value.waitId,
+            selected,
+            by: operatorOpenId ?? 'unknown',
+        });
+    }
+    catch (err) {
+        // journal append failed after resolveWait (codex #5): warn + don't fake
+        // success; the card stays clickable, cold-attach reconcile heals on restart.
+        return {
+            toast: {
+                type: 'error',
+                content: `处理失败，请重试：${err instanceof Error ? err.message : String(err)}`,
+            },
+        };
+    }
+    if (outcome.kind === 'stale-run') {
+        return {
+            toast: {
+                type: 'warning',
+                content: outcome.reason === 'terminal' ? '该 run 已结束，gate 失效' : 'gate 已失效',
+            },
+        };
+    }
+    if (outcome.kind === 'already-settled') {
+        // Idempotent recovery (codex nit #14): if a prior click already APPROVED the
+        // gate but its driveRun didn't land (transient), a re-click should re-drive
+        // instead of dead-ending at an info toast — mirrors the blocked/loop grant
+        // handlers' already-granted branch. driveRun is terminal-safe (short-circuits
+        // a finished run), so this is harmless if the run already moved on. A rejected
+        // gate is terminal-ish, so don't re-drive it.
+        if (outcome.status === 'approved')
+            deps.driveRun(value.runId);
+        return {
+            toast: {
+                type: 'info',
+                content: `已是「${outcome.status === 'approved' ? '通过' : '拒绝'}」状态`,
+            },
+        };
+    }
+    if (outcome.kind === 'unauthorized') {
+        return {
+            toast: {
+                type: 'warning',
+                content: '你不在这个 gate 的审批人名单中',
+            },
+        };
+    }
+    // resolved → drive the run forward (fresh replay) + freeze this card.
+    deps.driveRun(value.runId);
+    const prompt = readWait(runDir, value.waitId)?.prompt ?? '';
+    const frozen = buildV3GateCard({
+        runId: value.runId,
+        waitId: value.waitId,
+        nodeId: value.nodeId,
+        prompt,
+        resolution: { kind: outcome.resolution, by: operatorOpenId, selected },
+    });
+    return JSON.parse(frozen);
+}
+//# sourceMappingURL=v3-gate-card-handler.js.map

package/dist/im/lark/v3-gate-card-handler.js.map

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

package/dist/im/lark/v3-gate-card.d.ts

@@ -0,0 +1,47 @@
+/**
+ * v3 humanGate 审批卡 — 复用 v0.2 审批卡的视觉（header 配色 / 字段 / freeze 态），
+ * 但**自带 action namespace + value 形态**（codex review #4）：
+ *   - action: `v3_gate_approve` / `v3_gate_reject`
+ *   - value: `{ action, runId, waitId, nodeId, nonce, selected }`
+ * 刻意不复用 v0.2 `workflow-card-handler` 的 wait path —— v3 的 wait 权威是
+ * `waits/<id>.json + journal.ndjson`，跟 v0.2 events schema 不同（见 humanGate
+ * daemon-card 设计 §4.3）。本文件**纯函数**，不碰 daemon / IO，单测友好。
+ */
+export declare const V3_GATE_APPROVE_ACTION = "v3_gate_approve";
+export declare const V3_GATE_REJECT_ACTION = "v3_gate_reject";
+export type V3GateResolutionKind = 'approved' | 'rejected';
+/** card 按钮回传的 value 形态——v3-gate-card-handler 据此解析。 */
+export interface V3GateActionValue {
+    action: typeof V3_GATE_APPROVE_ACTION | typeof V3_GATE_REJECT_ACTION;
+    runId: string;
+    /** waitId = `${nodeId}-gate`；nodeId 单独带，免得 handler 去 strip 后缀（节点名可能含 -gate）。 */
+    waitId: string;
+    nodeId: string;
+    nonce: string;
+    selected?: string;
+}
+export interface V3GateCardInput {
+    runId: string;
+    waitId: string;
+    nodeId: string;
+    prompt: string;
+    /** 卡 nonce（防 stale 卡重复触发）；省略则按 runId/waitId 推导。 */
+    nonce?: string;
+    webDetailUrl?: string;
+    promptMaxChars?: number;
+    options?: string[];
+    approveOptions?: string[];
+    approvers?: string[];
+    /** 有值 → 渲染冻结的「已通过 / 已拒绝」卡（无按钮，防 stale UI 重复提交）。 */
+    resolution?: {
+        kind: V3GateResolutionKind;
+        by?: string;
+        selected?: string;
+    };
+}
+/** 稳定 nonce：同一 run 同一 wait 的卡 nonce 固定，重发卡也一致（幂等校验用）。 */
+export declare function v3GateCardNonce(runId: string, waitId: string): string;
+/** v3 run 在 dashboard 的详情页 URL（跟 v0.2 的 #/workflows 对称，走 #/v3）。 */
+export declare function v3RunDetailUrl(runId: string): string;
+export declare function buildV3GateCard(input: V3GateCardInput): string;
+//# sourceMappingURL=v3-gate-card.d.ts.map

package/dist/im/lark/v3-gate-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-gate-card.d.ts","sourceRoot":"","sources":["../../../src/im/lark/v3-gate-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AACxD,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAEtD,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,UAAU,CAAC;AAE3D,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,sBAAsB,GAAG,OAAO,qBAAqB,CAAC;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,mDAAmD;IACnD,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,oBAAoB,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAID,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAmE9D"}

package/dist/im/lark/v3-gate-card.js

@@ -0,0 +1,119 @@
+/**
+ * v3 humanGate 审批卡 — 复用 v0.2 审批卡的视觉（header 配色 / 字段 / freeze 态），
+ * 但**自带 action namespace + value 形态**（codex review #4）：
+ *   - action: `v3_gate_approve` / `v3_gate_reject`
+ *   - value: `{ action, runId, waitId, nodeId, nonce, selected }`
+ * 刻意不复用 v0.2 `workflow-card-handler` 的 wait path —— v3 的 wait 权威是
+ * `waits/<id>.json + journal.ndjson`，跟 v0.2 events schema 不同（见 humanGate
+ * daemon-card 设计 §4.3）。本文件**纯函数**，不碰 daemon / IO，单测友好。
+ */
+import { config } from '../../config.js';
+import { DEFAULT_HUMAN_GATE_OPTIONS } from '../../workflows/v3/dag.js';
+export const V3_GATE_APPROVE_ACTION = 'v3_gate_approve';
+export const V3_GATE_REJECT_ACTION = 'v3_gate_reject';
+const DEFAULT_PROMPT_MAX_CHARS = 500;
+/** 稳定 nonce：同一 run 同一 wait 的卡 nonce 固定，重发卡也一致（幂等校验用）。 */
+export function v3GateCardNonce(runId, waitId) {
+    return `v3gate:${runId}:${waitId}`;
+}
+/** v3 run 在 dashboard 的详情页 URL（跟 v0.2 的 #/workflows 对称，走 #/v3）。 */
+export function v3RunDetailUrl(runId) {
+    return `http://${config.dashboard.externalHost}:${config.dashboard.port}/#/v3/${encodeURIComponent(runId)}`;
+}
+export function buildV3GateCard(input) {
+    const nonce = input.nonce ?? v3GateCardNonce(input.runId, input.waitId);
+    const webDetailUrl = input.webDetailUrl ?? v3RunDetailUrl(input.runId);
+    const promptMax = input.promptMaxChars ?? DEFAULT_PROMPT_MAX_CHARS;
+    const prompt = truncate(input.prompt, promptMax);
+    const resolution = input.resolution;
+    const options = input.options ?? [...DEFAULT_HUMAN_GATE_OPTIONS];
+    const approveOptions = input.approveOptions ?? (options.includes('approve') ? ['approve'] : [options[0]]);
+    const title = resolution
+        ? `${resolutionPrefix(resolution.kind)}：${titleText(input.nodeId)}`
+        : `需要审批：${titleText(input.nodeId)}`;
+    const template = resolution ? (resolution.kind === 'approved' ? 'green' : 'red') : 'blue';
+    const elements = [
+        {
+            tag: 'div',
+            fields: [
+                { is_short: true, text: { tag: 'lark_md', content: `**Run**\n${escapeMd(short(input.runId, 24))}` } },
+                { is_short: true, text: { tag: 'lark_md', content: `**节点**\n${escapeMd(input.nodeId)}` } },
+            ],
+        },
+        { tag: 'hr' },
+        {
+            tag: 'div',
+            text: { tag: 'lark_md', content: `**审批内容**\n${escapeMd(prompt)}` },
+        },
+    ];
+    if (resolution) {
+        elements.push({ tag: 'hr' });
+        elements.push({
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: (resolution.kind === 'approved' ? '✅ 已通过' : '❌ 已拒绝') +
+                    (resolution.selected ? ` · ${escapeMd(short(resolution.selected, 20))}` : '') +
+                    (resolution.by ? ` · by ${escapeMd(short(resolution.by, 20))}` : ''),
+            },
+        });
+    }
+    else {
+        elements.push({
+            tag: 'action',
+            actions: options.map((opt) => optionButton(opt, approveOptions, input, nonce)),
+        });
+    }
+    elements.push({
+        tag: 'action',
+        actions: [
+            {
+                tag: 'button',
+                text: { tag: 'plain_text', content: 'Web 详情' },
+                type: 'default',
+                multi_url: {
+                    url: webDetailUrl, pc_url: webDetailUrl, android_url: webDetailUrl, ios_url: webDetailUrl,
+                },
+            },
+        ],
+    });
+    return JSON.stringify({
+        config: { wide_screen_mode: true },
+        header: { template, title: { tag: 'plain_text', content: title } },
+        elements,
+    });
+}
+function actionValue(action, runId, waitId, nodeId, nonce, selected) {
+    return { action, runId, waitId, nodeId, nonce, selected };
+}
+function optionButton(selected, approveOptions, input, nonce) {
+    const approved = approveOptions.includes(selected);
+    const label = selected === 'approve' ? '✅ 通过'
+        : selected === 'reject' ? '❌ 拒绝'
+            : selected;
+    return {
+        tag: 'button',
+        text: { tag: 'plain_text', content: label },
+        type: approved ? 'primary' : 'danger',
+        value: actionValue(approved ? V3_GATE_APPROVE_ACTION : V3_GATE_REJECT_ACTION, input.runId, input.waitId, input.nodeId, nonce, selected),
+    };
+}
+function resolutionPrefix(kind) {
+    return kind === 'approved' ? '已通过' : '已拒绝';
+}
+function titleText(nodeId) {
+    return `humanGate · ${nodeId}`;
+}
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return `${s.slice(0, max)}…（截断，完整见 Web 详情）`;
+}
+function short(s, max) {
+    return s.length <= max ? s : `${s.slice(0, max)}…`;
+}
+/** 转义 lark_md 里会被解析的字符，防 prompt 注入破坏卡片结构。 */
+function escapeMd(s) {
+    return s.replace(/[\\*_~`\[\]]/g, (c) => `\\${c}`);
+}
+//# sourceMappingURL=v3-gate-card.js.map

package/dist/im/lark/v3-gate-card.js.map

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

package/dist/im/lark/v3-loop-grant-card-handler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * v3 loop 追加一轮卡点击处理 —— card-handler 的 v3 分支（与
+ * `v3-blocked-card-handler` 同骨架）。把一次「➕ 追加 1 轮」点击翻译成：
+ * 权限校验 → `requestV3LoopGrant`（幂等：pendingGrant → already-granted）
+ * → 冻结卡 / toast + 触发 `driveV3Run` 跑新一轮。
+ *
+ * 纯逻辑 + 注入 seam（requestGrant / driveRun / canResolve），单测友好。
+ */
+import { type V3LoopGrantActionValue } from './v3-loop-grant-card.js';
+import { requestV3LoopGrant } from '../../workflows/v3/daemon-run.js';
+import { type RunChatBinding } from '../../workflows/v3/grill-state.js';
+export declare function isV3LoopGrantAction(action: unknown): boolean;
+export interface V3LoopGrantCardHandlerDeps {
+    baseDir?: string;
+    /** Re-enter the run after a grant append.  Fire-and-forget (daemon logs errors). */
+    driveRun: (runId: string) => void;
+    /** Permission: may this operator grant iterations of this run?  Same
+     *  semantics as the gate/blocked handlers' canResolve. */
+    canResolve?: (binding: RunChatBinding | undefined, operatorOpenId: string | undefined) => boolean;
+    /** Injectable for tests. Default = real requestV3LoopGrant. */
+    requestGrant?: typeof requestV3LoopGrant;
+}
+/**
+ * Handle a v3 loop-grant card click.  Returns the Lark card-action response:
+ * a frozen「已追加」card, or a `{ toast }`.  Triggers `driveRun` on success.
+ */
+export declare function handleV3LoopGrantAction(value: V3LoopGrantActionValue, operatorOpenId: string | undefined, deps: V3LoopGrantCardHandlerDeps): Promise<unknown>;
+//# sourceMappingURL=v3-loop-grant-card-handler.d.ts.map

package/dist/im/lark/v3-loop-grant-card-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-loop-grant-card-handler.d.ts","sourceRoot":"","sources":["../../../src/im/lark/v3-loop-grant-card-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAwB,MAAM,kCAAkC,CAAC;AAE5F,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAG3C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;8DAC0D;IAC1D,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;IAClG,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,kBAAkB,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,EAC7B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,OAAO,CAAC,CAwElB"}