botmux 2.111.0 → 2.112.0

package/dist/vc-agent/cards.js

@@ -116,12 +116,305 @@ export function buildVcMeetingConfirmCard(input) {
     };
     return JSON.stringify(card);
 }
+export function buildVcMeetingConsumerRecoveryCard(input) {
+    const pending = input.status === 'pending';
+    const title = pending
+        ? '会议 agent 恢复需要处理'
+        : input.status === 'recovered'
+            ? '会议 agent 已恢复'
+            : input.status === 'abandoned'
+                ? '会议 agent 已从当前时点继续'
+                : '会议 agent 恢复失败';
+    const template = pending ? 'orange' : input.status === 'failed' ? 'red' : 'green';
+    const body = pending
+        ? [
+            'daemon 重启后无法从事件源恢复一个已冻结投递的正文。旧流保持隔离，不会静默跳过。',
+            '',
+            `**会议**：${escapeMd(meetingTitle(input.meeting))}`,
+            `**member epoch**：${input.memberEpoch}`,
+            ...(input.memberLabel || input.memberId
+                ? [`**profile member**：${escapeMd(input.memberLabel ?? input.memberId)}`]
+                : []),
+            ...(input.missingItemVersionKey
+                ? [`**缺失版本**：\`${escapeMd(input.missingItemVersionKey)}\``]
+                : []),
+            ...(input.error ? [`**最近一次尝试**：${escapeMd(input.error)}`] : []),
+            '',
+            '可以再次尝试回补；若确认事件源已无法恢复，可隔离旧 epoch，并让同一 agent 从当前时点开启新 epoch。',
+        ].join('\n')
+        : [
+            input.status === 'recovered'
+                ? '缺失正文已回补，原冻结投递将继续。'
+                : input.status === 'abandoned'
+                    ? '旧投递流已隔离，新 epoch 从当前时点继续；缺失区间不会伪装成已处理。'
+                    : `处理失败：${escapeMd(input.error ?? '请稍后重试')}`,
+            '',
+            `**会议**：${escapeMd(meetingTitle(input.meeting))}`,
+        ].join('\n');
+    const actions = pending ? [{
+            tag: 'button',
+            text: { tag: 'plain_text', content: '再次回补' },
+            type: 'primary',
+            value: {
+                action: 'vc_meeting_consumer_recovery',
+                decision: 'retry',
+                meeting_id: input.meeting.id,
+                nonce: input.nonce,
+                ...(input.memberId ? { member_id: input.memberId } : {}),
+            },
+        }, {
+            tag: 'button',
+            text: { tag: 'plain_text', content: '隔离旧流并从现在继续' },
+            type: 'danger',
+            value: {
+                action: 'vc_meeting_consumer_recovery',
+                decision: 'abandon_from_now',
+                meeting_id: input.meeting.id,
+                nonce: input.nonce,
+                ...(input.memberId ? { member_id: input.memberId } : {}),
+            },
+        }] : [];
+    return JSON.stringify({
+        config: { wide_screen_mode: true },
+        header: { title: { tag: 'plain_text', content: title }, template },
+        elements: [
+            { tag: 'markdown', content: body },
+            ...(actions.length > 0 ? [{ tag: 'action', actions }] : []),
+        ],
+    });
+}
+export function buildVcMeetingListenerRejoinCard(input) {
+    const retryable = input.status === 'pending' || input.status === 'failed';
+    const title = input.status === 'rejoined'
+        ? '会议监听已恢复'
+        : input.status === 'expired'
+            ? '会议重新加入已失效'
+            : input.status === 'failed'
+                ? '重新加入会议失败'
+                : '会议监听已中断';
+    const template = input.status === 'rejoined'
+        ? 'green'
+        : input.status === 'expired'
+            ? 'grey'
+            : input.status === 'failed'
+                ? 'red'
+                : 'orange';
+    const body = input.status === 'rejoined'
+        ? '监听 bot 已重新入会，已有的监听群和会议 agent 状态已保留。'
+        : input.status === 'expired'
+            ? '会议已结束、监听状态已变更，或该卡片已被新卡片替代。'
+            : input.status === 'failed'
+                ? `重新入会失败：${escapeMd(input.error ?? '请稍后重试')}`
+                : '检测到监听 bot 被移出本场会议。为避免被踢后立即自动重入，需由本场授权人确认。';
+    const actions = retryable ? [{
+            tag: 'button',
+            text: { tag: 'plain_text', content: '重新加入会议' },
+            type: 'primary',
+            value: {
+                action: 'vc_meeting_listener_rejoin',
+                meeting_id: input.meeting.id,
+                nonce: input.nonce,
+            },
+        }] : [];
+    return JSON.stringify({
+        config: { wide_screen_mode: true },
+        header: { title: { tag: 'plain_text', content: title }, template },
+        elements: [
+            {
+                tag: 'markdown',
+                content: [
+                    body,
+                    '',
+                    `**会议**：${escapeMd(meetingTitle(input.meeting))}`,
+                    ...(input.meeting.meetingNo ? [`**会议号**：${escapeMd(input.meeting.meetingNo)}`] : []),
+                ].join('\n'),
+            },
+            ...(actions.length > 0 ? [{ tag: 'action', actions }] : []),
+        ],
+    });
+}
 function consumerCandidateLabel(candidate) {
     return candidate.label?.trim() || candidate.larkAppId;
 }
 function consumerCandidateOptionLabel(candidate) {
     return consumerCandidateLabel(candidate).slice(0, 60);
 }
+function isProfileConsumerCard(input) {
+    return input.selectionMode === 'profiles';
+}
+function consumerProfileLabel(profile) {
+    return profile.label?.trim() || profile.id;
+}
+function consumerProfileResponseModeLabel(profile) {
+    return profile.responseMode === 'silent' ? '静默' : '监听群回复';
+}
+function consumerProfileSinkLabel(profile) {
+    const labels = (profile.ownedSinks ?? []).map((sink) => {
+        if (sink === 'meeting_text')
+            return '会中文字';
+        return '会议语音';
+    });
+    return labels.length > 0 ? labels.join('、') : '无';
+}
+function consumerProfileActivationLabel(profile) {
+    if (profile.activationStatus === 'activating')
+        return '启用中';
+    if (profile.activationStatus === 'active')
+        return '已启用';
+    if (profile.activationStatus === 'failed') {
+        return profile.activationError?.trim()
+            ? `启用失败：${profile.activationError.trim()}`
+            : '启用失败';
+    }
+    return undefined;
+}
+function consumerProfileNames(input, profileIds) {
+    const byId = new Map(input.profiles.map(profile => [profile.id, profile]));
+    return profileIds.map(id => consumerProfileLabel(byId.get(id) ?? {
+        id,
+        agentAppId: id,
+        role: id,
+        responseMode: 'silent',
+        capabilities: [],
+    }));
+}
+function consumerProfileDefaultLabel(input) {
+    if (input.defaultMode === 'listenOnly')
+        return '只监听消息';
+    const names = consumerProfileNames(input, input.defaultConsumerIds ?? []);
+    return names.length > 0 ? names.join('、') : '未配置默认 profile';
+}
+function consumerProfileAgentLabel(profile) {
+    return profile.agentLabel?.trim() || profile.agentAppId;
+}
+function truncateCardText(text, max) {
+    return text.length > max ? `${text.slice(0, Math.max(1, max - 1))}…` : text;
+}
+/**
+ * Toggle 按钮文案：profile 名与 agent 名分别截断，为 agent 后缀保留预算，
+ * 超长 profile 名不会把「· agent」整段挤掉；完整名称在详情面板里。
+ */
+function consumerProfileToggleText(profile, isSelected) {
+    const name = truncateCardText(consumerProfileLabel(profile), 30);
+    const agent = truncateCardText(consumerProfileAgentLabel(profile), 22);
+    return `${isSelected ? '☑' : '☐'} ${name} · ${agent}`;
+}
+function consumerProfileDetailMarkdown(profiles) {
+    return profiles.map((profile) => {
+        const activation = consumerProfileActivationLabel(profile);
+        return [
+            `**${escapeMd(consumerProfileLabel(profile))}**（profile: \`${escapeMd(profile.id)}\`）`,
+            `agent：${escapeMd(consumerProfileAgentLabel(profile))} · 角色：\`${escapeMd(profile.role)}\` · 回复：${escapeMd(consumerProfileResponseModeLabel(profile))} · 受管输出：${escapeMd(consumerProfileSinkLabel(profile))}`,
+            ...(activation ? [`状态：${escapeMd(activation)}`] : []),
+        ].join('\n');
+    }).join('\n');
+}
+/** 每行最多 2 个 toggle，避免自定义预设名在手机端被截断。 */
+function consumerToggleGrid(buttons) {
+    const rows = [];
+    for (let i = 0; i < buttons.length; i += 2) {
+        rows.push({
+            tag: 'column_set',
+            flex_mode: 'bisect',
+            horizontal_spacing: 'small',
+            columns: buttons.slice(i, i + 2).map(button => ({
+                tag: 'column',
+                width: 'weighted',
+                weight: 1,
+                elements: [button],
+            })),
+        });
+    }
+    return rows;
+}
+function consumerProfileDisplayElements(input) {
+    if (input.status !== 'pending') {
+        return input.profiles.length > 0
+            ? [{ tag: 'markdown', content: consumerProfileDetailMarkdown(input.profiles) }]
+            : [];
+    }
+    const stagedIds = input.stagedSelectedProfileIds ?? input.selectedProfileIds ?? [];
+    const selected = new Set(stagedIds);
+    // “只监听”只在显式暂存空集合时高亮；默认 agents 且未操作时（staged 为
+    // undefined、合并选择为空）绝不能误亮，否则超时实际会跑默认 agents。
+    const listenOnlySelected = input.stagedSelectedProfileIds !== undefined
+        && input.stagedSelectedProfileIds.length === 0;
+    const toggles = input.profiles.map((profile) => {
+        const isSelected = selected.has(profile.id);
+        return {
+            tag: 'button',
+            text: {
+                tag: 'plain_text',
+                content: consumerProfileToggleText(profile, isSelected),
+            },
+            type: isSelected ? 'primary' : 'default',
+            width: 'fill',
+            behaviors: vcMeetingConsumerCallback({
+                action: 'vc_meeting_consumer_profile_toggle',
+                meeting_id: input.meeting.id,
+                profile_id: profile.id,
+                operation: isSelected ? 'deselect' : 'select',
+                selected: !isSelected,
+                nonce: input.nonce,
+            }),
+        };
+    });
+    toggles.push({
+        tag: 'button',
+        text: {
+            tag: 'plain_text',
+            content: `${listenOnlySelected ? '☑' : '☐'} 只监听（不启用 agent）`,
+        },
+        type: listenOnlySelected ? 'primary' : 'default',
+        width: 'fill',
+        behaviors: vcMeetingConsumerCallback({
+            action: 'vc_meeting_consumer_profile_clear',
+            operation: 'clear',
+            meeting_id: input.meeting.id,
+            nonce: input.nonce,
+        }),
+    });
+    return [
+        ...consumerToggleGrid(toggles),
+        {
+            tag: 'collapsible_panel',
+            expanded: true,
+            header: {
+                title: { tag: 'markdown', content: '**预设详情与高级设置**' },
+                vertical_align: 'center',
+                icon: { tag: 'standard_icon', token: 'down-small-ccm_outlined', size: '16px 16px' },
+                icon_position: 'follow_text',
+                icon_expanded_angle: -180,
+            },
+            border: { color: 'grey', corner_radius: '5px' },
+            padding: '8px 8px 8px 8px',
+            vertical_spacing: '8px',
+            elements: [
+                ...(input.profiles.length > 0
+                    ? [{ tag: 'markdown', content: consumerProfileDetailMarkdown(input.profiles) }, { tag: 'hr' }]
+                    : []),
+                {
+                    tag: 'select_static',
+                    placeholder: { tag: 'plain_text', content: '同步间隔' },
+                    width: 'fill',
+                    initial_option: consumerSyncIntervalPresetValue(input.stagedIntervalMs ?? input.syncIntervalMs),
+                    behaviors: vcMeetingConsumerCallback({
+                        action: 'vc_meeting_consumer_stage',
+                        stage_kind: 'interval',
+                        meeting_id: input.meeting.id,
+                        nonce: input.nonce,
+                    }),
+                    options: [
+                        { text: { tag: 'plain_text', content: '15 秒' }, value: '15000' },
+                        { text: { tag: 'plain_text', content: '30 秒' }, value: '30000' },
+                        { text: { tag: 'plain_text', content: '60 秒' }, value: '60000' },
+                        { text: { tag: 'plain_text', content: '90 秒' }, value: '90000' },
+                    ],
+                },
+            ],
+        },
+    ];
+}
 function consumerSyncIntervalLabel(ms) {
     if (!ms || !Number.isFinite(ms))
         return '默认';
@@ -140,6 +433,30 @@ function consumerSyncIntervalCustomDefault(ms) {
 function consumerStatusBody(input) {
     const lines = baseLines({ meeting: input.meeting, status: 'pending', targetOpenId: '', nonce: '' });
     if (input.status === 'pending') {
+        if (isProfileConsumerCard(input)) {
+            const staged = input.stagedSelectedProfileIds;
+            const stagedNames = staged === undefined ? undefined : consumerProfileNames(input, staged);
+            const currentNames = staged === undefined
+                ? consumerProfileNames(input, input.selectedProfileIds ?? [])
+                : [];
+            return {
+                template: 'blue',
+                title: '会议多 agent 处理方式',
+                body: [
+                    '点击预设按钮多选，选好后点「确认」生效；完全不操作会按默认设置执行。',
+                    '',
+                    ...lines,
+                    `**默认**：${escapeMd(consumerProfileDefaultLabel(input))}`,
+                    `**同步间隔**：${escapeMd(consumerSyncIntervalLabel(input.stagedIntervalMs ?? input.syncIntervalMs))}${input.stagedIntervalMs ? '（待确认）' : ''}`,
+                    ...(stagedNames !== undefined
+                        ? [`**当前选择**：${escapeMd(stagedNames.length > 0 ? stagedNames.join('、') : '只监听消息（空 profile 集合）')}（待确认）`]
+                        : currentNames.length > 0
+                            ? [`**已启用**：${escapeMd(currentNames.join('、'))}`]
+                            : []),
+                    ...(input.error ? [`**提示**：${escapeMd(input.error)}`] : []),
+                ].join('\n'),
+            };
+        }
         const defaultLabel = input.defaultMode === 'listenOnly'
             ? '只监听消息'
             : input.candidates.find(c => c.larkAppId === input.defaultAgentAppId)?.label || input.defaultAgentAppId || '默认 agent';
@@ -173,6 +490,18 @@ function consumerStatusBody(input) {
         };
     }
     if (input.status === 'processing') {
+        if (isProfileConsumerCard(input)) {
+            return {
+                template: 'blue',
+                title: '会议多 agent 设置中',
+                body: [
+                    '已收到确认，正在逐项激活本次会议的 agent profile。',
+                    '已成功的 profile 会保留；失败项会单独显示，不会让整场回退。',
+                    '',
+                    ...lines,
+                ].join('\n'),
+            };
+        }
         return {
             template: 'blue',
             title: '会议处理设置中',
@@ -185,6 +514,22 @@ function consumerStatusBody(input) {
         };
     }
     if (input.status === 'agent') {
+        if (isProfileConsumerCard(input)) {
+            const active = input.profiles.filter(profile => profile.activationStatus === 'active');
+            return {
+                template: active.length > 0 ? 'green' : 'red',
+                title: active.length > 0 ? '会议 agents 已启用' : '会议 agents 启用失败',
+                body: [
+                    active.length > 0
+                        ? `本次会议已启用 ${active.length} 个 agent profile。`
+                        : '没有 agent profile 成功启用。',
+                    `同步间隔：${escapeMd(consumerSyncIntervalLabel(input.syncIntervalMs))}`,
+                    ...(input.error ? [`部分失败：${escapeMd(input.error)}`] : []),
+                    '',
+                    ...lines,
+                ].join('\n'),
+            };
+        }
         return {
             template: 'green',
             title: '会议 agent 已启用',
@@ -214,85 +559,130 @@ export function buildVcMeetingConsumerCard(input) {
     const elements = [
         { tag: 'markdown', content: body },
     ];
+    if (isProfileConsumerCard(input)) {
+        elements.push(...consumerProfileDisplayElements(input));
+    }
     if (input.status === 'pending') {
-        elements.push(...(input.candidates.length > 0 ? [{
-                tag: 'select_static',
-                placeholder: { tag: 'plain_text', content: '选择 agent' },
-                width: 'fill',
-                initial_option: input.stagedMode === 'agent' ? input.stagedAgentAppId : undefined,
+        if (isProfileConsumerCard(input)) {
+            elements.push({
+                tag: 'form',
+                name: 'vc_meeting_consumer_confirm_form',
+                elements: [
+                    {
+                        tag: 'input',
+                        name: CONSUMER_SYNC_INTERVAL_INPUT_NAME,
+                        label: { tag: 'plain_text', content: '自定义同步间隔（秒）' },
+                        placeholder: { tag: 'plain_text', content: '例如 45，范围 10-3600' },
+                        default_value: consumerSyncIntervalCustomDefault(input.stagedIntervalMs ?? input.syncIntervalMs),
+                    },
+                    {
+                        tag: 'button',
+                        name: 'vc_meeting_consumer_confirm_submit',
+                        text: { tag: 'plain_text', content: '确认' },
+                        type: 'primary_filled',
+                        width: 'fill',
+                        action_type: 'form_submit',
+                        value: {
+                            action: 'vc_meeting_consumer_confirm',
+                            consumer_mode: 'profiles',
+                            meeting_id: input.meeting.id,
+                            nonce: input.nonce,
+                        },
+                    },
+                ],
+            }, {
+                tag: 'button',
+                // 仅暂存默认组合，仍需点“确认”生效，命名避免“立即生效”误读。
+                text: { tag: 'plain_text', content: '恢复默认选择' },
+                type: 'default',
                 behaviors: vcMeetingConsumerCallback({
-                    action: 'vc_meeting_consumer_stage',
-                    stage_kind: 'agent',
+                    action: 'vc_meeting_consumer_profile_default',
+                    operation: 'use_default',
                     meeting_id: input.meeting.id,
                     nonce: input.nonce,
                 }),
-                options: input.candidates.map(candidate => ({
-                    text: { tag: 'plain_text', content: consumerCandidateOptionLabel(candidate) },
-                    value: candidate.larkAppId,
-                })),
-            }] : []), {
-            tag: 'select_static',
-            placeholder: { tag: 'plain_text', content: '同步间隔' },
-            width: 'fill',
-            initial_option: consumerSyncIntervalPresetValue(input.stagedIntervalMs ?? input.syncIntervalMs),
-            behaviors: vcMeetingConsumerCallback({
-                action: 'vc_meeting_consumer_stage',
-                stage_kind: 'interval',
-                meeting_id: input.meeting.id,
-                nonce: input.nonce,
-            }),
-            options: [
-                { text: { tag: 'plain_text', content: '15 秒' }, value: '15000' },
-                { text: { tag: 'plain_text', content: '30 秒' }, value: '30000' },
-                { text: { tag: 'plain_text', content: '60 秒' }, value: '60000' },
-                { text: { tag: 'plain_text', content: '90 秒' }, value: '90000' },
-            ],
-        }, {
-            tag: 'form',
-            name: 'vc_meeting_consumer_confirm_form',
-            elements: [
-                {
-                    tag: 'input',
-                    name: CONSUMER_SYNC_INTERVAL_INPUT_NAME,
-                    label: { tag: 'plain_text', content: '自定义同步间隔（秒）' },
-                    placeholder: { tag: 'plain_text', content: '例如 45，范围 10-3600' },
-                    default_value: consumerSyncIntervalCustomDefault(input.stagedIntervalMs ?? input.syncIntervalMs),
-                },
-                {
-                    tag: 'button',
-                    name: 'vc_meeting_consumer_confirm_submit',
-                    text: { tag: 'plain_text', content: '确认' },
-                    type: 'primary_filled',
+            });
+        }
+        else {
+            elements.push(...(input.candidates.length > 0 ? [{
+                    tag: 'select_static',
+                    placeholder: { tag: 'plain_text', content: '选择 agent' },
                     width: 'fill',
-                    action_type: 'form_submit',
-                    value: {
-                        action: 'vc_meeting_consumer_confirm',
+                    initial_option: input.stagedMode === 'agent' ? input.stagedAgentAppId : undefined,
+                    behaviors: vcMeetingConsumerCallback({
+                        action: 'vc_meeting_consumer_stage',
+                        stage_kind: 'agent',
                         meeting_id: input.meeting.id,
                         nonce: input.nonce,
+                    }),
+                    options: input.candidates.map(candidate => ({
+                        text: { tag: 'plain_text', content: consumerCandidateOptionLabel(candidate) },
+                        value: candidate.larkAppId,
+                    })),
+                }] : []), {
+                tag: 'select_static',
+                placeholder: { tag: 'plain_text', content: '同步间隔' },
+                width: 'fill',
+                initial_option: consumerSyncIntervalPresetValue(input.stagedIntervalMs ?? input.syncIntervalMs),
+                behaviors: vcMeetingConsumerCallback({
+                    action: 'vc_meeting_consumer_stage',
+                    stage_kind: 'interval',
+                    meeting_id: input.meeting.id,
+                    nonce: input.nonce,
+                }),
+                options: [
+                    { text: { tag: 'plain_text', content: '15 秒' }, value: '15000' },
+                    { text: { tag: 'plain_text', content: '30 秒' }, value: '30000' },
+                    { text: { tag: 'plain_text', content: '60 秒' }, value: '60000' },
+                    { text: { tag: 'plain_text', content: '90 秒' }, value: '90000' },
+                ],
+            }, {
+                tag: 'form',
+                name: 'vc_meeting_consumer_confirm_form',
+                elements: [
+                    {
+                        tag: 'input',
+                        name: CONSUMER_SYNC_INTERVAL_INPUT_NAME,
+                        label: { tag: 'plain_text', content: '自定义同步间隔（秒）' },
+                        placeholder: { tag: 'plain_text', content: '例如 45，范围 10-3600' },
+                        default_value: consumerSyncIntervalCustomDefault(input.stagedIntervalMs ?? input.syncIntervalMs),
                     },
-                },
-            ],
-        }, {
-            tag: 'button',
-            text: { tag: 'plain_text', content: '只监听消息' },
-            type: 'default',
-            behaviors: vcMeetingConsumerCallback({
-                action: 'vc_meeting_consumer_stage',
-                stage_kind: 'listenOnly',
-                meeting_id: input.meeting.id,
-                nonce: input.nonce,
-            }),
-        }, {
-            tag: 'button',
-            text: { tag: 'plain_text', content: '使用默认设置' },
-            type: 'default',
-            behaviors: vcMeetingConsumerCallback({
-                action: 'vc_meeting_consumer_select',
-                consumer_mode: 'default',
-                meeting_id: input.meeting.id,
-                nonce: input.nonce,
-            }),
-        });
+                    {
+                        tag: 'button',
+                        name: 'vc_meeting_consumer_confirm_submit',
+                        text: { tag: 'plain_text', content: '确认' },
+                        type: 'primary_filled',
+                        width: 'fill',
+                        action_type: 'form_submit',
+                        value: {
+                            action: 'vc_meeting_consumer_confirm',
+                            meeting_id: input.meeting.id,
+                            nonce: input.nonce,
+                        },
+                    },
+                ],
+            }, {
+                tag: 'button',
+                text: { tag: 'plain_text', content: '只监听消息' },
+                type: 'default',
+                behaviors: vcMeetingConsumerCallback({
+                    action: 'vc_meeting_consumer_stage',
+                    stage_kind: 'listenOnly',
+                    meeting_id: input.meeting.id,
+                    nonce: input.nonce,
+                }),
+            }, {
+                tag: 'button',
+                text: { tag: 'plain_text', content: '使用默认设置' },
+                type: 'default',
+                behaviors: vcMeetingConsumerCallback({
+                    action: 'vc_meeting_consumer_select',
+                    consumer_mode: 'default',
+                    meeting_id: input.meeting.id,
+                    nonce: input.nonce,
+                }),
+            });
+        }
     }
     const card = {
         schema: '2.0',