botmux 2.93.1 → 2.95.0

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

@@ -0,0 +1,90 @@
+/**
+ * v3 loop 追加一轮卡点击处理 —— card-handler 的 v3 分支（与
+ * `v3-blocked-card-handler` 同骨架）。把一次「➕ 追加 1 轮」点击翻译成：
+ * 权限校验 → `requestV3LoopGrant`（幂等：pendingGrant → already-granted）
+ * → 冻结卡 / toast + 触发 `driveV3Run` 跑新一轮。
+ *
+ * 纯逻辑 + 注入 seam（requestGrant / driveRun / canResolve），单测友好。
+ */
+import { join } from 'node:path';
+import { V3_LOOP_GRANT_ACTION, buildV3LoopGrantCard, v3LoopGrantCardNonce, } from './v3-loop-grant-card.js';
+import { requestV3LoopGrant, loopExhaustedInfoFor } from '../../workflows/v3/daemon-run.js';
+import { readJournal } from '../../workflows/v3/journal.js';
+import { readGrillState, defaultBaseDir, } from '../../workflows/v3/grill-state.js';
+import { isValidRunId } from '../../workflows/v3/ops-projection.js';
+export function isV3LoopGrantAction(action) {
+    return action === V3_LOOP_GRANT_ACTION;
+}
+/**
+ * Handle a v3 loop-grant card click.  Returns the Lark card-action response:
+ * a frozen「已追加」card, or a `{ toast }`.  Triggers `driveRun` on success.
+ */
+export async function handleV3LoopGrantAction(value, operatorOpenId, deps) {
+    const baseDir = deps.baseDir ?? defaultBaseDir();
+    if (!isValidRunId(value.runId)) {
+        return { toast: { type: 'warning', content: '追加已失效（非法 run）' } };
+    }
+    // 飞书卡片 value 回传可能把 number 落成 string —— 先归一化再比 nonce。
+    const iteration = typeof value.iteration === 'number' ? value.iteration : parseInt(String(value.iteration), 10);
+    if (!Number.isInteger(iteration) || iteration < 1) {
+        return { toast: { type: 'warning', content: '追加卡已失效（轮数非法）' } };
+    }
+    // iteration 入 nonce：grant 被消费 / 新一轮再耗尽后，旧卡 nonce 对不上 → stale。
+    if (value.nonce !== v3LoopGrantCardNonce(value.runId, value.loopId, iteration)) {
+        return { toast: { type: 'warning', content: '追加卡已失效（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: '你没有权限给这个 loop 追加轮数' } };
+    }
+    const requestGrant = deps.requestGrant ?? requestV3LoopGrant;
+    let outcome;
+    try {
+        // expectedIteration（expectedAttemptId 的同款教训）：nonce 只证明这张卡
+        // 自身没被改，证不了它指向的耗尽轮还是"当前这次耗尽"——core 必须再比一次。
+        outcome = requestGrant(baseDir, value.runId, {
+            loopId: value.loopId,
+            expectedIteration: iteration,
+            by: operatorOpenId,
+        });
+    }
+    catch (err) {
+        return {
+            toast: {
+                type: 'error',
+                content: `追加失败，请再试：${err instanceof Error ? err.message : String(err)}`,
+            },
+        };
+    }
+    if (outcome.kind === 'stale-run') {
+        return {
+            toast: {
+                type: 'warning',
+                content: outcome.reason === 'missing' ? '该 run 不存在或已清理'
+                    : outcome.reason === 'stale-iteration' ? '该 loop 已进入新一轮，这张旧卡失效（看最新那张卡）'
+                        : '该 loop 已不在耗尽状态，追加卡失效',
+            },
+        };
+    }
+    if (outcome.kind === 'already-granted') {
+        // Idempotent: a prior click already reserved the extra round — make sure
+        // the run is actually moving (covers click → daemon crash → click after restart).
+        deps.driveRun(value.runId);
+        return { toast: { type: 'info', content: '已在追加重跑中' } };
+    }
+    // granted → drive the run (fresh replay starts iteration N+1) + freeze this card.
+    deps.driveRun(value.runId);
+    const events = readJournal(join(runDir, 'journal.ndjson'));
+    const info = loopExhaustedInfoFor(events, value.loopId);
+    const frozen = buildV3LoopGrantCard({
+        runId: value.runId,
+        loopId: value.loopId,
+        iteration,
+        detail: info.detail,
+        grantedNow: { nextIteration: outcome.nextIteration, by: operatorOpenId },
+    });
+    return JSON.parse(frozen);
+}
+//# sourceMappingURL=v3-loop-grant-card-handler.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * v3 耗尽 loop 追加一轮卡 —— loop 跑满 maxIterations 仍没达成 exit 条件时
+ * （decision=exhausted → loop blocked）的飞书入口。和 blocked 重试卡是两张卡、
+ * 两个 action：这里没有任何东西"失败"，只是不收敛——按钮语义是「追加 1 轮」
+ * （append loopIterationGranted）而不是「重跑某 attempt」。
+ *
+ * stale 防护与 blocked 卡同构（expectedAttemptId 的同款教训）：nonce 以
+ * `iteration` 为 freshness key —— 一旦 grant 被消费 / 新一轮再次耗尽，旧卡的
+ * iteration 对不上 core 的 expectedIteration 比对，天然失效。
+ */
+export declare const V3_LOOP_GRANT_ACTION = "v3_loop_grant";
+/** card 按钮回传的 value 形态——v3-loop-grant-card-handler 据此解析。 */
+export interface V3LoopGrantActionValue {
+    action: typeof V3_LOOP_GRANT_ACTION;
+    runId: string;
+    loopId: string;
+    /** 耗尽时的 iteration —— nonce + core expectedIteration 的 freshness key。 */
+    iteration: number;
+    nonce: string;
+}
+export interface V3LoopGrantCardInput {
+    runId: string;
+    loopId: string;
+    /** 耗尽时的 iteration。 */
+    iteration: number;
+    /** 编排时的轮数上限（展示用，可缺）。 */
+    maxIterations?: number;
+    /** 已追加过的轮数。 */
+    granted?: number;
+    /** 最后一轮 decision detail（如 `result.passed=false (iteration 3/3)`）。 */
+    detail?: string;
+    /** 省略则按 runId/loopId/iteration 推导。 */
+    nonce?: string;
+    webDetailUrl?: string;
+    detailMaxChars?: number;
+    /** 有值 → 渲染冻结的「已追加」卡（无按钮，防 stale UI 重复提交）。 */
+    grantedNow?: {
+        nextIteration: number;
+        by?: string;
+    };
+}
+/** 稳定 nonce：同一 run 同一 loop 同一耗尽轮的卡 nonce 固定（重发卡一致）；
+ *  iteration 入 nonce —— 追加被消费后旧卡对不上新耗尽轮，不会误触。 */
+export declare function v3LoopGrantCardNonce(runId: string, loopId: string, iteration: number): string;
+export declare function buildV3LoopGrantCard(input: V3LoopGrantCardInput): string;
+//# sourceMappingURL=v3-loop-grant-card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v3-loop-grant-card.d.ts","sourceRoot":"","sources":["../../../src/im/lark/v3-loop-grant-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,oBAAoB,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,UAAU,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AAID;iDACiD;AACjD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7F;AAMD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CA2FxE"}

package/dist/im/lark/v3-loop-grant-card.js

@@ -0,0 +1,119 @@
+/**
+ * v3 耗尽 loop 追加一轮卡 —— loop 跑满 maxIterations 仍没达成 exit 条件时
+ * （decision=exhausted → loop blocked）的飞书入口。和 blocked 重试卡是两张卡、
+ * 两个 action：这里没有任何东西"失败"，只是不收敛——按钮语义是「追加 1 轮」
+ * （append loopIterationGranted）而不是「重跑某 attempt」。
+ *
+ * stale 防护与 blocked 卡同构（expectedAttemptId 的同款教训）：nonce 以
+ * `iteration` 为 freshness key —— 一旦 grant 被消费 / 新一轮再次耗尽，旧卡的
+ * iteration 对不上 core 的 expectedIteration 比对，天然失效。
+ */
+import { config } from '../../config.js';
+export const V3_LOOP_GRANT_ACTION = 'v3_loop_grant';
+const DEFAULT_DETAIL_MAX_CHARS = 500;
+/** 稳定 nonce：同一 run 同一 loop 同一耗尽轮的卡 nonce 固定（重发卡一致）；
+ *  iteration 入 nonce —— 追加被消费后旧卡对不上新耗尽轮，不会误触。 */
+export function v3LoopGrantCardNonce(runId, loopId, iteration) {
+    return `v3loopgrant:${runId}:${loopId}:${iteration}`;
+}
+function v3RunDetailUrl(runId) {
+    return `http://${config.dashboard.externalHost}:${config.dashboard.port}/#/v3/${encodeURIComponent(runId)}`;
+}
+export function buildV3LoopGrantCard(input) {
+    const nonce = input.nonce ?? v3LoopGrantCardNonce(input.runId, input.loopId, input.iteration);
+    const webDetailUrl = input.webDetailUrl ?? v3RunDetailUrl(input.runId);
+    const detailMax = input.detailMaxChars ?? DEFAULT_DETAIL_MAX_CHARS;
+    const granted = input.grantedNow;
+    const title = granted ? `已追加一轮：loop ${input.loopId}` : `loop 轮数耗尽：${input.loopId}`;
+    // 与 blocked 重试卡同款语义色：耗尽=橙（可恢复），追加后转绿。
+    const template = granted ? 'green' : 'orange';
+    const budget = input.maxIterations !== undefined
+        ? `${input.iteration}/${input.maxIterations + (input.granted ?? 0)}`
+        : `${input.iteration}`;
+    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: `**Loop / 轮数**\n${escapeMd(input.loopId)} · ${escapeMd(budget)}` } },
+            ],
+        },
+        { tag: 'hr' },
+        {
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: `**最后一轮结果**\n未达成 exit 条件` +
+                    (input.detail ? `\n${escapeMd(truncate(input.detail, detailMax))}` : ''),
+            },
+        },
+    ];
+    if (granted) {
+        elements.push({ tag: 'hr' });
+        elements.push({
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: `➕ 已追加 → 第 ${granted.nextIteration} 轮` +
+                    (granted.by ? ` · by ${escapeMd(short(granted.by, 20))}` : ''),
+            },
+        });
+    }
+    else {
+        elements.push({
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: '点「追加 1 轮」会带着上一轮反馈再跑一轮；若结果已无修复价值，留着不点即可（run 保持受阻）。',
+            },
+        });
+        elements.push({
+            tag: 'action',
+            actions: [
+                {
+                    tag: 'button',
+                    text: { tag: 'plain_text', content: '➕ 追加 1 轮' },
+                    type: 'primary',
+                    value: {
+                        action: V3_LOOP_GRANT_ACTION,
+                        runId: input.runId,
+                        loopId: input.loopId,
+                        iteration: input.iteration,
+                        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 里会被解析的字符，防 detail 注入破坏卡片结构。 */
+function escapeMd(s) {
+    return s.replace(/[\\*_~`\[\]]/g, (c) => `\\${c}`);
+}
+//# sourceMappingURL=v3-loop-grant-card.js.map

package/dist/im/lark/v3-loop-grant-card.js.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * v3 回溯预算准许卡点击处理 —— card-handler 的 v3 分支(与
+ * `v3-loop-grant-card-handler` 同骨架)。把一次「➕ 准许回溯 +1」点击翻译成:
+ * 权限校验 → `requestRevisitGrant`(原子 grant + retry;幂等:已恢复 →
+ * not-budget-blocked) → 冻结卡 / toast + 触发 `driveV3Run` 重跑被卡节点。
+ *
+ * scope 正确性:按钮 value 带 tier —— pair grant 带 source/target,run grant
+ * 都不带,交给 core 的 partial-pair / pair-source-mismatch 守卫兜底。
+ */
+import { type V3RevisitGrantActionValue } from './v3-revisit-grant-card.js';
+import { requestRevisitGrant } from '../../workflows/v3/daemon-run.js';
+import { type RunChatBinding } from '../../workflows/v3/grill-state.js';
+export declare function isV3RevisitGrantAction(action: unknown): boolean;
+export interface V3RevisitGrantCardHandlerDeps {
+    baseDir?: string;
+    /** Re-enter the run after grant + retry.  Fire-and-forget (daemon logs errors). */
+    driveRun: (runId: string) => void;
+    /** Permission: may this operator grant revisits of this run?  Same semantics
+     *  as the gate/blocked/loop-grant handlers' canResolve. */
+    canResolve?: (binding: RunChatBinding | undefined, operatorOpenId: string | undefined) => boolean;
+    /** Injectable for tests. Default = real requestRevisitGrant. */
+    requestGrant?: typeof requestRevisitGrant;
+}
+/**
+ * Handle a v3 revisit-grant card click.  Returns the Lark card-action response:
+ * a frozen「已准许」card, or a `{ toast }`.  Triggers `driveRun` on success.
+ */
+export declare function handleV3RevisitGrantAction(value: V3RevisitGrantActionValue, operatorOpenId: string | undefined, deps: V3RevisitGrantCardHandlerDeps): Promise<unknown>;
+//# sourceMappingURL=v3-revisit-grant-card-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v3-revisit-grant-card-handler.d.ts","sourceRoot":"","sources":["../../../src/im/lark/v3-revisit-grant-card-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAA+B,MAAM,kCAAkC,CAAC;AAEpG,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAG3C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAE/D;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;+DAC2D;IAC3D,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;IAClG,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,mBAAmB,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,yBAAyB,EAChC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,OAAO,CAAC,CA2ElB"}

package/dist/im/lark/v3-revisit-grant-card-handler.js

@@ -0,0 +1,96 @@
+/**
+ * v3 回溯预算准许卡点击处理 —— card-handler 的 v3 分支(与
+ * `v3-loop-grant-card-handler` 同骨架)。把一次「➕ 准许回溯 +1」点击翻译成:
+ * 权限校验 → `requestRevisitGrant`(原子 grant + retry;幂等:已恢复 →
+ * not-budget-blocked) → 冻结卡 / toast + 触发 `driveV3Run` 重跑被卡节点。
+ *
+ * scope 正确性:按钮 value 带 tier —— pair grant 带 source/target,run grant
+ * 都不带,交给 core 的 partial-pair / pair-source-mismatch 守卫兜底。
+ */
+import { join } from 'node:path';
+import { V3_REVISIT_GRANT_ACTION, buildV3RevisitGrantCard, v3RevisitGrantCardNonce, } from './v3-revisit-grant-card.js';
+import { requestRevisitGrant, revisitBudgetBlockedInfoFor } from '../../workflows/v3/daemon-run.js';
+import { readJournal } from '../../workflows/v3/journal.js';
+import { readGrillState, defaultBaseDir, } from '../../workflows/v3/grill-state.js';
+import { isValidRunId } from '../../workflows/v3/ops-projection.js';
+export function isV3RevisitGrantAction(action) {
+    return action === V3_REVISIT_GRANT_ACTION;
+}
+/**
+ * Handle a v3 revisit-grant card click.  Returns the Lark card-action response:
+ * a frozen「已准许」card, or a `{ toast }`.  Triggers `driveRun` on success.
+ */
+export async function handleV3RevisitGrantAction(value, operatorOpenId, deps) {
+    const baseDir = deps.baseDir ?? defaultBaseDir();
+    if (!isValidRunId(value.runId)) {
+        return { toast: { type: 'warning', content: '准许已失效（非法 run）' } };
+    }
+    // attemptId 入 nonce:grant+retry 消费后节点进入新 attempt,旧卡 nonce 对不上 → stale。
+    if (value.nonce !== v3RevisitGrantCardNonce(value.runId, value.sourceNodeId, value.attemptId)) {
+        return { toast: { type: 'warning', content: '准许卡已失效（nonce 不匹配，看最新那张卡）' } };
+    }
+    const tier = value.tier === 'run' ? 'run' : 'pair';
+    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: '你没有权限准许这个 run 的回溯' } };
+    }
+    const requestGrant = deps.requestGrant ?? requestRevisitGrant;
+    let outcome;
+    try {
+        // pair grant 带 source/target;run grant 都不带。expectedAttemptId(同
+        // expectedAttemptId 教训):nonce 只证卡自身没改,证不了它指向的耗尽 attempt
+        // 还是"当前这次"——core 必须再比一次。
+        outcome = requestGrant(baseDir, value.runId, {
+            ...(tier === 'pair' ? { sourceNodeId: value.sourceNodeId, toNodeId: value.toNodeId } : {}),
+            by: operatorOpenId ?? 'system',
+            expectedAttemptId: value.attemptId,
+        });
+    }
+    catch (err) {
+        return {
+            toast: { type: 'error', content: `准许失败，请再试：${err instanceof Error ? err.message : String(err)}` },
+        };
+    }
+    if (outcome.kind === 'invalid') {
+        return {
+            toast: {
+                type: 'warning',
+                content: outcome.reason === 'partial-pair' ? '准许卡参数不完整（pair 信息缺失）' : '准许卡与当前受阻节点不匹配',
+            },
+        };
+    }
+    if (outcome.kind === 'stale-run') {
+        // Idempotent recovery (codex nit #13): `not-budget-blocked` means a prior
+        // grant already extended the budget and the node is no longer blocked. If
+        // that grant's driveRun didn't land (transient), a re-click should re-drive
+        // rather than dead-end at a warning. driveRun is terminal-safe, so re-driving
+        // a run that genuinely moved on (or finished) is harmless. This mirrors the
+        // blocked/loop grant handlers' already-granted branch.
+        if (outcome.reason === 'not-budget-blocked')
+            deps.driveRun(value.runId);
+        return {
+            toast: {
+                type: 'warning',
+                content: outcome.reason === 'missing' ? '该 run 不存在或已清理'
+                    : outcome.reason === 'stale-attempt' ? '该节点已进入新一次尝试，这张旧卡失效（看最新那张卡）'
+                        : '该 run 已不在回溯预算受阻状态，准许卡失效',
+            },
+        };
+    }
+    // granted → drive the run (blocked node retries within extended budget) + freeze card.
+    deps.driveRun(value.runId);
+    const info = revisitBudgetBlockedInfoFor(readJournal(join(runDir, 'journal.ndjson')), value.sourceNodeId);
+    const frozen = buildV3RevisitGrantCard({
+        runId: value.runId,
+        sourceNodeId: value.sourceNodeId,
+        toNodeId: value.toNodeId,
+        tier,
+        attemptId: value.attemptId,
+        detail: info?.detail,
+        grantedNow: { by: operatorOpenId },
+    });
+    return JSON.parse(frozen);
+}
+//# sourceMappingURL=v3-revisit-grant-card-handler.js.map

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * v3 回溯预算耗尽卡 —— 一个节点想回溯某祖先,但 per-pair / per-run 预算用尽
+ * (nodeBlocked errorCode=REVISIT_BUDGET_EXHAUSTED → run blocked)时的飞书入口。
+ * 和 blocked 重试卡是两张卡:这里没有"失败",只是回溯次数到顶——按钮语义是
+ * 「准许再回溯 1 次」(append revisitBudgetGranted + 原子 retry blocked 节点),
+ * 不是「重跑某 attempt」。
+ *
+ * stale 防护与 loop grant 卡同构:nonce 以 blocked `attemptId` 为 freshness key
+ * —— grant+retry 后 blocked 节点进入新 attempt,旧卡 attemptId 对不上 core 的
+ * expectedAttemptId 比对,天然失效。
+ *
+ * scope 正确性(菲菲 review):卡片明确标出耗尽的是 pair 还是 run-wide,并据此
+ * 让按钮带对应 scope —— pair grant 带 source/target,run grant 都不带。给错
+ * scope 会出现"grant 了但 retry 后又因另一层预算继续 blocked"。
+ */
+export declare const V3_REVISIT_GRANT_ACTION = "v3_revisit_grant";
+/** card 按钮回传的 value 形态——v3-revisit-grant-card-handler 据此解析。 */
+export interface V3RevisitGrantActionValue {
+    action: typeof V3_REVISIT_GRANT_ACTION;
+    runId: string;
+    /** 发起回溯(被 blocked)的节点。 */
+    sourceNodeId: string;
+    /** 回溯目标祖先。 */
+    toNodeId: string;
+    /** 耗尽的层级 —— 决定 grant scope:'pair' 带 source/target,'run' 都不带。 */
+    tier: 'pair' | 'run';
+    /** blocked attemptId —— nonce + core expectedAttemptId 的 freshness key。 */
+    attemptId: string;
+    nonce: string;
+}
+export interface V3RevisitGrantCardInput {
+    runId: string;
+    sourceNodeId: string;
+    toNodeId: string;
+    tier: 'pair' | 'run';
+    attemptId: string;
+    /** 预算耗尽 detail(如 `... (1/1) — grant +1 ...`)。 */
+    detail?: string;
+    /** 省略则按 runId/sourceNodeId/attemptId 推导。 */
+    nonce?: string;
+    webDetailUrl?: string;
+    detailMaxChars?: number;
+    /** 有值 → 渲染冻结的「已准许」卡(无按钮,防 stale UI 重复提交)。 */
+    grantedNow?: {
+        by?: string;
+    };
+}
+/** 稳定 nonce:同一 run 同一节点同一 blocked attempt 的卡 nonce 固定(重发一致);
+ *  attemptId 入 nonce —— grant+retry 消费后 blocked 节点进入新 attempt,旧卡失效。 */
+export declare function v3RevisitGrantCardNonce(runId: string, sourceNodeId: string, attemptId: string): string;
+export declare function buildV3RevisitGrantCard(input: V3RevisitGrantCardInput): string;
+//# sourceMappingURL=v3-revisit-grant-card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v3-revisit-grant-card.d.ts","sourceRoot":"","sources":["../../../src/im/lark/v3-revisit-grant-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,+DAA+D;AAC/D,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,OAAO,uBAAuB,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,UAAU,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAID;uEACuE;AACvE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtG;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAuF9E"}

package/dist/im/lark/v3-revisit-grant-card.js

@@ -0,0 +1,123 @@
+/**
+ * v3 回溯预算耗尽卡 —— 一个节点想回溯某祖先,但 per-pair / per-run 预算用尽
+ * (nodeBlocked errorCode=REVISIT_BUDGET_EXHAUSTED → run blocked)时的飞书入口。
+ * 和 blocked 重试卡是两张卡:这里没有"失败",只是回溯次数到顶——按钮语义是
+ * 「准许再回溯 1 次」(append revisitBudgetGranted + 原子 retry blocked 节点),
+ * 不是「重跑某 attempt」。
+ *
+ * stale 防护与 loop grant 卡同构:nonce 以 blocked `attemptId` 为 freshness key
+ * —— grant+retry 后 blocked 节点进入新 attempt,旧卡 attemptId 对不上 core 的
+ * expectedAttemptId 比对,天然失效。
+ *
+ * scope 正确性(菲菲 review):卡片明确标出耗尽的是 pair 还是 run-wide,并据此
+ * 让按钮带对应 scope —— pair grant 带 source/target,run grant 都不带。给错
+ * scope 会出现"grant 了但 retry 后又因另一层预算继续 blocked"。
+ */
+import { config } from '../../config.js';
+export const V3_REVISIT_GRANT_ACTION = 'v3_revisit_grant';
+const DEFAULT_DETAIL_MAX_CHARS = 500;
+/** 稳定 nonce:同一 run 同一节点同一 blocked attempt 的卡 nonce 固定(重发一致);
+ *  attemptId 入 nonce —— grant+retry 消费后 blocked 节点进入新 attempt,旧卡失效。 */
+export function v3RevisitGrantCardNonce(runId, sourceNodeId, attemptId) {
+    return `v3revisitgrant:${runId}:${sourceNodeId}:${attemptId}`;
+}
+function v3RunDetailUrl(runId) {
+    return `http://${config.dashboard.externalHost}:${config.dashboard.port}/#/v3/${encodeURIComponent(runId)}`;
+}
+export function buildV3RevisitGrantCard(input) {
+    const nonce = input.nonce ?? v3RevisitGrantCardNonce(input.runId, input.sourceNodeId, input.attemptId);
+    const webDetailUrl = input.webDetailUrl ?? v3RunDetailUrl(input.runId);
+    const detailMax = input.detailMaxChars ?? DEFAULT_DETAIL_MAX_CHARS;
+    const granted = input.grantedNow;
+    const scopeLabel = input.tier === 'pair' ? `${input.sourceNodeId} → ${input.toNodeId}` : '整个 run';
+    const title = granted ? `已准许回溯：${scopeLabel}` : `回溯预算耗尽：${scopeLabel}`;
+    // 与 loop grant 卡同款语义色:耗尽=橙(可恢复),准许后转绿。
+    const template = granted ? 'green' : 'orange';
+    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.sourceNodeId)} → ${escapeMd(input.toNodeId)}` } },
+                { is_short: true, text: { tag: 'lark_md', content: `**耗尽层级**\n${input.tier === 'pair' ? 'per-pair（这条边）' : 'per-run（全局）'}` } },
+            ],
+        },
+        { tag: 'hr' },
+        {
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: `**情况**\n节点 ${escapeMd(input.sourceNodeId)} 想回溯到 ${escapeMd(input.toNodeId)},但回溯次数已到上限` +
+                    (input.detail ? `\n${escapeMd(truncate(input.detail, detailMax))}` : ''),
+            },
+        },
+    ];
+    if (granted) {
+        elements.push({ tag: 'hr' });
+        elements.push({
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: `➕ 已准许再回溯 1 次（${input.tier === 'pair' ? '本边' : '全局'}）` +
+                    (granted.by ? ` · by ${escapeMd(short(granted.by, 20))}` : ''),
+            },
+        });
+    }
+    else {
+        elements.push({
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: '点「准许回溯 +1」会放行这次回溯并自动重跑该节点；若觉得不该再回溯,留着不点即可（run 保持受阻）。',
+            },
+        });
+        elements.push({
+            tag: 'action',
+            actions: [
+                {
+                    tag: 'button',
+                    text: { tag: 'plain_text', content: '➕ 准许回溯 +1' },
+                    type: 'primary',
+                    value: {
+                        action: V3_REVISIT_GRANT_ACTION,
+                        runId: input.runId,
+                        sourceNodeId: input.sourceNodeId,
+                        toNodeId: input.toNodeId,
+                        tier: input.tier,
+                        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 里会被解析的字符,防 detail 注入破坏卡片结构。 */
+function escapeMd(s) {
+    return s.replace(/[\\*_~`\[\]]/g, (c) => `\\${c}`);
+}
+//# sourceMappingURL=v3-revisit-grant-card.js.map

package/dist/im/lark/v3-revisit-grant-card.js.map

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

package/dist/im/lark/workflow-cards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-cards.d.ts","sourceRoot":"","sources":["../../../src/im/lark/workflow-cards.ts"],"names":[],"mappings":"AACA,OAAO,EAAK,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAGjE,eAAO,MAAM,uBAAuB,eAAe,CAAC;AACpD,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAClD,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAClD,eAAO,MAAM,sBAAsB,eAAe,CAAC;AACnD,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAIzD,MAAM,MAAM,8BAA8B,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,8BAA8B,CAAC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;sEAEkE;IAClE,UAAU,CAAC,EAAE,8BAA8B,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;yDAEqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf;;wEAEoE;IACpE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,GAAE,2BAAgC,GACrC,2BAA2B,CAmC7B;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,GAAE,2BAAgC,EACtC,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAgIR"}
+{"version":3,"file":"workflow-cards.d.ts","sourceRoot":"","sources":["../../../src/im/lark/workflow-cards.ts"],"names":[],"mappings":"AACA,OAAO,EAAK,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAGjE,eAAO,MAAM,uBAAuB,eAAe,CAAC;AACpD,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAClD,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAClD,eAAO,MAAM,sBAAsB,eAAe,CAAC;AACnD,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAIzD,MAAM,MAAM,8BAA8B,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAEnF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,8BAA8B,CAAC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;sEAEkE;IAClE,UAAU,CAAC,EAAE,8BAA8B,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;yDAEqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf;;wEAEoE;IACpE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAMD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,GAAE,2BAAgC,GACrC,2BAA2B,CAmC7B;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,QAAQ,EAClB,IAAI,GAAE,2BAAgC,EACtC,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAgIR"}

package/dist/im/lark/workflow-cards.js

@@ -10,8 +10,12 @@ const DEFAULT_PROMPT_MAX_CHARS = 500;
 export function workflowApprovalCardNonce(runId, activityId, attemptId) {
     return `wf:${runId}:${activityId}:${attemptId}`;
 }
+// v2 (v0.2) workflow runs live at the legacy detail route now that the main
+// `#/workflows` URL belongs to the v3 runs page. v2 runs are not in the v3 runs
+// directory, so pointing these cards at `#/workflows/<id>` would 404 against
+// `/api/v3/runs/<id>`; `#/legacy-workflow/<id>` renders the v2 detail page.
 export function workflowRunDetailUrl(runId) {
-    return `http://${config.dashboard.externalHost}:${config.dashboard.port}/#/workflows/${encodeURIComponent(runId)}`;
+    return `http://${config.dashboard.externalHost}:${config.dashboard.port}/#/legacy-workflow/${encodeURIComponent(runId)}`;
 }
 export function getWorkflowApprovalCardContext(event, snapshot, opts = {}) {
     if (isPayloadRef(event.payload)) {