botmux 3.10.0 → 3.23.1

package/dist/core/ask-types.d.ts

@@ -1,157 +0,0 @@
-/**
- * Public types for `botmux ask` (v0.1.8).
- *
- * See `/tmp/botmux-ask.md` for the full design. This module is import-safe for
- * both the daemon side (broker, card builder, click handler) and the CLI side
- * (`botmux ask buttons` subcommand) — no runtime cross-imports.
- */
-/** A single selectable option on an ask card. `key` is the stable identifier
- *  returned via stdout; `label` is the human-facing button text. When the user
- *  writes `--options "yes,no"`, `key === label`. With `--options "yes=继续"`,
- *  `key="yes"` and `label="继续"`. */
-export interface AskOption {
-    key: string;
-    label: string;
-}
-/** 多问多选模型中一个问题的描述。`key` 是问题的稳定标识符（可选，默认用序号），
- *  `label` 是人类可读的标题（暂保留向后兼容），`prompt` 是问题正文，
- *  `options` 是该问题的选项列表，`multiSelect` 表示是否允许多选。 */
-export interface AskQuestion {
-    /** 问题正文文本，展示给用户。 */
-    prompt: string;
-    /** 该问题的选项列表，调用方保证 `options.length ≥ 2` 且 `key` 唯一。 */
-    options: ReadonlyArray<AskOption>;
-    /** true = 多选（可选多个 key）；false = 单选（恰好 1 个 key）。 */
-    multiSelect: boolean;
-}
-/** Terminal result of an ask, returned to the CLI caller. Discriminated by
- *  `kind` so the CLI can map straight to stdout shape + exit code.
- *
- *  v0.1.8 变更：`answered` 变体的 `selected: string` 升级为
- *  `answers: ReadonlyArray<ReadonlyArray<string>>`，其中 `answers[i]`
- *  对应第 i 个问题（`questions[i]`）选中的 key 数组。
- *  向后兼容：单问单选场景用 `toLegacySelected` 取回旧的 `string`。
- *
- *  自定义回复（comment）：用户在话题里直接回一句文字当答案时，broker 用
- *  `submitCustomReply` settle，此时 `answers` 各问为空数组、`comment` 携带
- *  用户原文。CLI hook adapter 的 `formatAnswer` 据此把没有选中项的问题回落到
- *  这段自定义文字（替代语义，见 §自定义回复）。按钮路径的 comment 仍为 null。 */
-export type AskResult = {
-    kind: 'answered';
-    /** answers[i] = questions[i] 选中的 key 数组。 */
-    answers: ReadonlyArray<ReadonlyArray<string>>;
-    by: string;
-    /** 自定义回复原文（用户在话题里直接打字作答）；按钮选择时为 null。 */
-    comment: string | null;
-    timedOut: false;
-} | {
-    kind: 'timedOut';
-    selected: null;
-    by: null;
-    comment: null;
-    timedOut: true;
-} | {
-    kind: 'invalidated';
-    reason: string;
-    selected: null;
-    by: null;
-    comment: null;
-    timedOut: false;
-};
-/** JSON envelope emitted by `botmux ask buttons --json`.
- *
- *  v0.1.8 新增 `answers: string[][] | null`（多问多选完整答案），
- *  保留 `selected: string | null` 做向后兼容（等价于 `toLegacySelected`）。
- *  `comment` 携带用户的自定义回复原文（话题直接打字作答），无则 null。 */
-export interface AskJsonOutput {
-    /** 向后兼容：单问单选时等于 `answers[0][0]`，否则为 null。 */
-    selected: string | null;
-    /** v0.1.8 新增：按问题分组的完整答案，answered 时非 null。 */
-    answers: string[][] | null;
-    by: string | null;
-    /** 自定义回复原文；按钮选择 / 超时 / 失效时为 null。 */
-    comment: string | null;
-    timedOut: boolean;
-}
-/** Input accepted by broker.registerAsk. Caller (CLI subcommand → daemon IPC
- *  handler) is responsible for env validation and parameter parsing. Click
- *  authorization is the bot's canTalk gate, injected via `setCanTalkChecker`.
- *
- *  v0.1.8 变更：`options`/`prompt` 字段替换为 `questions: ReadonlyArray<AskQuestion>`。 */
-export interface CreateAskInput {
-    larkAppId: string;
-    chatId: string;
-    /** thread-scope ask → root message_id; chat-scope ask → null. */
-    rootMessageId: string | null;
-    /** Session that issued the ask — used for audit + future replay scoping. */
-    sessionId: string;
-    /** 问题列表，调用方保证每问 `options.length ≥ 2` 且 key 唯一。 */
-    questions: ReadonlyArray<AskQuestion>;
-    /** Absolute deadline; computed by caller from `--timeout`. Broker won't
-     *  re-compute. */
-    timeoutMs: number;
-    /** 发起 ask 的会话类型。仅用于点击鉴权时把 chatType 喂给 canTalk（p2pOpen 腿）；
-     *  缺省时该腿 fail-closed，鉴权退回原语义。 */
-    chatType?: 'group' | 'p2p';
-}
-/** Daemon-internal state for a pending ask. Not exported on the IPC boundary —
- *  the CLI side only sees `AskResult`.
- *
- *  v0.1.8 变更：`options`/`prompt` 替换为 `questions`。 */
-export interface PendingAsk {
-    askId: string;
-    /** Anti-replay nonce embedded in each button's action value. Click events
-     *  whose nonce doesn't match → treated as stale (e.g. card from a previous
-     *  daemon process before restart). */
-    nonce: string;
-    larkAppId: string;
-    chatId: string;
-    rootMessageId: string | null;
-    sessionId: string;
-    /** 发起 ask 的会话类型（见 CreateAskInput.chatType）。 */
-    chatType?: 'group' | 'p2p';
-    /** 问题列表，替代旧的 `options` + `prompt`。 */
-    questions: ReadonlyArray<AskQuestion>;
-    /** 当前已勾选答案快照。仅 daemon/card 内部使用；CLI IPC 边界不暴露。 */
-    selections?: ReadonlyArray<ReadonlyArray<string>>;
-    createdAt: number;
-    deadlineAt: number;
-    /** Set after the card dispatch succeeds. Until then, the ask is "registered
-     *  but not visible" — clicks can't physically arrive yet. */
-    cardMessageId?: string;
-    /** Once true, subsequent click attempts return `already_settled`. */
-    settled: boolean;
-}
-/** Outcome of a click-resolution attempt. Card click handler maps these to
- *  user-visible toasts. */
-export type AskClickOutcome = 
-/** First valid click — caller's Promise resolves with `kind:'answered'`. */
-'accepted'
-/** Clicker can't canTalk to the bot in this chat — caller shows "你没有权限". */
- | 'unauthorized'
-/** No such askId, nonce mismatch, or unknown option — caller shows
- *  "此 ask 已失效（daemon 重启）". Covers the §8 stale-card case. */
- | 'stale'
-/** Ask already settled (race winner exists or timed out). */
- | 'already_settled'
-/** 多选累积：用户勾选/取消某项，尚未 submit——不触发 settle。 */
- | 'toggled';
-/** 旧单选语义兼容：仅当"单问且恰好选 1 个"时返回该 key，否则 null。
- *  `botmux ask buttons` 子命令与其测试据此保持单选行为不变。 */
-export declare function toLegacySelected(result: AskResult): string | null;
-/** 用户以文字作答（`submitCustomReply`）而非点选按钮：各问 `answers` 为空数组、
- *  `comment` 携带原文。此时 `toLegacySelected` 返回 null，非 JSON 模式的 stdout
- *  与"多选/多问"的降级空值无法区分——调用方据此在 stderr 提示答案去向。 */
-export declare function isCustomReply(result: AskResult): boolean;
-/** Card dispatcher contract. The im/lark side registers a dispatcher via
- *  `setCardDispatcher`; the broker is otherwise IM-agnostic. */
-export interface AskCardDispatcher {
-    send(ask: PendingAsk): Promise<{
-        messageId: string;
-    }>;
-    /** Called when an ask settles (answered / timedOut / invalidated). Card
-     *  builder uses this to PATCH the card into a terminal state. Best-effort —
-     *  the broker does not block on it. */
-    onSettle?(ask: PendingAsk, result: AskResult): void | Promise<void>;
-}
-//# sourceMappingURL=ask-types.d.ts.map

package/dist/core/ask-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ask-types.d.ts","sourceRoot":"","sources":["../../src/core/ask-types.ts"],"names":[],"mappings":"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"}

package/dist/core/ask-types.js

@@ -1,28 +0,0 @@
-/**
- * Public types for `botmux ask` (v0.1.8).
- *
- * See `/tmp/botmux-ask.md` for the full design. This module is import-safe for
- * both the daemon side (broker, card builder, click handler) and the CLI side
- * (`botmux ask buttons` subcommand) — no runtime cross-imports.
- */
-/** 旧单选语义兼容：仅当"单问且恰好选 1 个"时返回该 key，否则 null。
- *  `botmux ask buttons` 子命令与其测试据此保持单选行为不变。 */
-export function toLegacySelected(result) {
-    if (result.kind !== 'answered')
-        return null;
-    if (result.answers.length === 1 && result.answers[0].length === 1) {
-        return result.answers[0][0];
-    }
-    return null;
-}
-/** 用户以文字作答（`submitCustomReply`）而非点选按钮：各问 `answers` 为空数组、
- *  `comment` 携带原文。此时 `toLegacySelected` 返回 null，非 JSON 模式的 stdout
- *  与"多选/多问"的降级空值无法区分——调用方据此在 stderr 提示答案去向。 */
-export function isCustomReply(result) {
-    if (result.kind !== 'answered')
-        return false;
-    if (result.comment === null)
-        return false;
-    return result.answers.every((keys) => keys.length === 0);
-}
-//# sourceMappingURL=ask-types.js.map

package/dist/core/ask-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ask-types.js","sourceRoot":"","sources":["../../src/core/ask-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+IH;8CAC8C;AAC9C,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;+CAE+C;AAC/C,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/core/attachment-path.d.ts

@@ -1,3 +0,0 @@
-/** Per-bot attachment bucket shared by Lark downloads and Dashboard uploads. */
-export declare function getAttachmentsDir(larkAppId: string, messageId: string): string;
-//# sourceMappingURL=attachment-path.d.ts.map

package/dist/core/attachment-path.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachment-path.d.ts","sourceRoot":"","sources":["../../src/core/attachment-path.ts"],"names":[],"mappings":"AAIA,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E"}

package/dist/core/attachment-path.js

@@ -1,8 +0,0 @@
-import { join, resolve } from 'node:path';
-import { assertSafeAppId } from '../adapters/cli/read-isolation.js';
-import { config } from '../config.js';
-/** Per-bot attachment bucket shared by Lark downloads and Dashboard uploads. */
-export function getAttachmentsDir(larkAppId, messageId) {
-    return join(resolve(config.session.dataDir), 'attachments', assertSafeAppId(larkAppId), messageId);
-}
-//# sourceMappingURL=attachment-path.js.map

package/dist/core/attachment-path.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachment-path.js","sourceRoot":"","sources":["../../src/core/attachment-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,SAAiB;IACpE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AACrG,CAAC"}

package/dist/core/auto-start.d.ts

@@ -1,84 +0,0 @@
-/**
- * Proactive auto-start policy — pure decision helpers for the two
- * "主动开工" features (see docs/specs/20260529-proactive-auto-start/).
- *
- * Two independent triggers, both opt-in per bot (default off):
- *   1. Bot added to a new chat  → spawn a session (场景① / autoStartOnGroupJoin)
- *   2. New topic in a topic group → spawn a session without @ (场景② / autoStartOnNewTopic)
- *
- * Kept side-effect-free so the routing/spawn logic stays unit-testable; the
- * I/O (member lookup, session spawn, event subscription) lives in the
- * dispatcher / daemon and calls into these predicates.
- */
-/** Per-bot auto-start preferences, resolved from BotConfig. */
-export interface AutoStartPrefs {
-    /** 场景①: auto-start when the bot is added to a new chat. */
-    autoStartOnGroupJoin: boolean;
-    /** 场景①: optional pre-configured first-turn prompt. '' = empty user_message. */
-    autoStartOnGroupJoinPrompt: string;
-    /** 场景②: auto-start on every new topic in a topic group (no @ required). */
-    autoStartOnNewTopic: boolean;
-}
-/**
- * 场景②: should a non-@mention message auto-start a session?
- *
- * True only for a brand-new topic seed in a 话题群 (topic mode):
- *   - the feature is enabled for this bot,
- *   - it's a group chat (not p2p),
- *   - routing landed on thread-scope anchored at this very message
- *     (decideRouting returns {scope:'thread', anchor: messageId} only for a
- *     top-level message in a topic group — a reply anchors at the thread root),
- *   - no existing session owns the anchor (a true new topic, not a reply).
- *
- * Regular groups route to chat-scope (anchor = chatId ≠ messageId), so they
- * never satisfy this — FR-7. Disabled bots never satisfy it — FR-8.
- */
-export declare function shouldAutoStartOnNewTopic(opts: {
-    enabled: boolean;
-    scope: 'thread' | 'chat';
-    anchor: string;
-    messageId: string;
-    chatType: 'group' | 'p2p';
-    ownsSession: boolean;
-}): boolean;
-/**
- * 场景①: does the chat contain at least one of the bot's allowedUsers?
- *
- * The trigger gate per D7: auto-start only when an allowedUser is a member of
- * the chat the bot was just added to (the person who added the bot need not be
- * one). Open_ids are app-scoped, so both sides must come from the SAME bot's
- * app view. Empty allowedUsers → never triggers (FR-2).
- */
-export declare function chatHasAllowedUser(memberOpenIds: Iterable<string>, allowedUserOpenIds: Iterable<string>): boolean;
-/**
- * 场景①: resolve the first-turn prompt body from the configured prompt.
- * Trims whitespace; an unset / blank config yields '' (empty user_message,
- * per D8 — the model reads the group context itself). The surrounding prompt
- * envelope (role / identity) is added by buildNewTopicPrompt, so '' here still
- * produces a non-empty CLI turn (FR-11).
- */
-export declare function resolveGroupJoinPrompt(configured: string | undefined): string;
-/**
- * 场景①: D7 gate with retry — wait for an allowedUser to appear in the chat.
- *
- * Alarm/oncall platforms that auto-create incident chats
- * add the bot FIRST and the human members moments later. A one-shot
- * membership snapshot taken at bot.added time races against that and loses:
- * the chat looks like it has no allowedUser and auto-start is silently
- * skipped even though the owner lands in the chat a second later. Re-check
- * membership a few times with backoff before giving up.
- *
- * Attempts = retryDelaysMs.length + 1 (default 4 attempts over ~25s). Errors
- * from `listMembers` propagate to the caller on ANY attempt — same handling
- * as the previous one-shot check (warn + scope hint). Empty allowedUsers
- * short-circuits to false without calling `listMembers` (FR-2).
- */
-export declare function waitForAllowedUserInChat(opts: {
-    listMembers: () => Promise<string[]>;
-    allowedUsers: Iterable<string>;
-    /** Waits BETWEEN attempts (ms). Default [3000, 7000, 15000]. */
-    retryDelaysMs?: number[];
-    sleep?: (ms: number) => Promise<void>;
-    onRetry?: (attempt: number, delayMs: number) => void;
-}): Promise<boolean>;
-//# sourceMappingURL=auto-start.d.ts.map

package/dist/core/auto-start.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auto-start.d.ts","sourceRoot":"","sources":["../../src/core/auto-start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,oBAAoB,EAAE,OAAO,CAAC;IAC9B,+EAA+E;IAC/E,0BAA0B,EAAE,MAAM,CAAC;IACnC,2EAA2E;IAC3E,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAQV;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC/B,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACnC,OAAO,CAOT;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE7E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD,GAAG,OAAO,CAAC,OAAO,CAAC,CAWnB"}

package/dist/core/auto-start.js

@@ -1,92 +0,0 @@
-/**
- * Proactive auto-start policy — pure decision helpers for the two
- * "主动开工" features (see docs/specs/20260529-proactive-auto-start/).
- *
- * Two independent triggers, both opt-in per bot (default off):
- *   1. Bot added to a new chat  → spawn a session (场景① / autoStartOnGroupJoin)
- *   2. New topic in a topic group → spawn a session without @ (场景② / autoStartOnNewTopic)
- *
- * Kept side-effect-free so the routing/spawn logic stays unit-testable; the
- * I/O (member lookup, session spawn, event subscription) lives in the
- * dispatcher / daemon and calls into these predicates.
- */
-/**
- * 场景②: should a non-@mention message auto-start a session?
- *
- * True only for a brand-new topic seed in a 话题群 (topic mode):
- *   - the feature is enabled for this bot,
- *   - it's a group chat (not p2p),
- *   - routing landed on thread-scope anchored at this very message
- *     (decideRouting returns {scope:'thread', anchor: messageId} only for a
- *     top-level message in a topic group — a reply anchors at the thread root),
- *   - no existing session owns the anchor (a true new topic, not a reply).
- *
- * Regular groups route to chat-scope (anchor = chatId ≠ messageId), so they
- * never satisfy this — FR-7. Disabled bots never satisfy it — FR-8.
- */
-export function shouldAutoStartOnNewTopic(opts) {
-    return (opts.enabled &&
-        opts.chatType === 'group' &&
-        opts.scope === 'thread' &&
-        opts.anchor === opts.messageId &&
-        !opts.ownsSession);
-}
-/**
- * 场景①: does the chat contain at least one of the bot's allowedUsers?
- *
- * The trigger gate per D7: auto-start only when an allowedUser is a member of
- * the chat the bot was just added to (the person who added the bot need not be
- * one). Open_ids are app-scoped, so both sides must come from the SAME bot's
- * app view. Empty allowedUsers → never triggers (FR-2).
- */
-export function chatHasAllowedUser(memberOpenIds, allowedUserOpenIds) {
-    const allowed = new Set(allowedUserOpenIds);
-    if (allowed.size === 0)
-        return false;
-    for (const m of memberOpenIds) {
-        if (allowed.has(m))
-            return true;
-    }
-    return false;
-}
-/**
- * 场景①: resolve the first-turn prompt body from the configured prompt.
- * Trims whitespace; an unset / blank config yields '' (empty user_message,
- * per D8 — the model reads the group context itself). The surrounding prompt
- * envelope (role / identity) is added by buildNewTopicPrompt, so '' here still
- * produces a non-empty CLI turn (FR-11).
- */
-export function resolveGroupJoinPrompt(configured) {
-    return (configured ?? '').trim();
-}
-/**
- * 场景①: D7 gate with retry — wait for an allowedUser to appear in the chat.
- *
- * Alarm/oncall platforms that auto-create incident chats
- * add the bot FIRST and the human members moments later. A one-shot
- * membership snapshot taken at bot.added time races against that and loses:
- * the chat looks like it has no allowedUser and auto-start is silently
- * skipped even though the owner lands in the chat a second later. Re-check
- * membership a few times with backoff before giving up.
- *
- * Attempts = retryDelaysMs.length + 1 (default 4 attempts over ~25s). Errors
- * from `listMembers` propagate to the caller on ANY attempt — same handling
- * as the previous one-shot check (warn + scope hint). Empty allowedUsers
- * short-circuits to false without calling `listMembers` (FR-2).
- */
-export async function waitForAllowedUserInChat(opts) {
-    const allowed = [...opts.allowedUsers];
-    if (allowed.length === 0)
-        return false;
-    const delays = opts.retryDelaysMs ?? [3000, 7000, 15000];
-    const sleep = opts.sleep ?? ((ms) => new Promise(r => setTimeout(r, ms)));
-    for (let attempt = 0;; attempt++) {
-        if (chatHasAllowedUser(await opts.listMembers(), allowed))
-            return true;
-        if (attempt >= delays.length)
-            return false;
-        opts.onRetry?.(attempt + 1, delays[attempt]);
-        await sleep(delays[attempt]);
-    }
-}
-//# sourceMappingURL=auto-start.js.map

package/dist/core/auto-start.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auto-start.js","sourceRoot":"","sources":["../../src/core/auto-start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAOzC;IACC,OAAO,CACL,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,QAAQ,KAAK,OAAO;QACzB,IAAI,CAAC,KAAK,KAAK,QAAQ;QACvB,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS;QAC9B,CAAC,IAAI,CAAC,WAAW,CAClB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,aAA+B,EAC/B,kBAAoC;IAEpC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAA8B;IACnE,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAO9C;IACC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACxF,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE,CAAC;QAClC,IAAI,kBAAkB,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QACvE,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,GAAG,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/core/bot-live-control.d.ts

@@ -1,41 +0,0 @@
-export interface BotmuxPm2App {
-    name: string;
-    online: boolean;
-    /** Raw bots.json slot assigned by the generated PM2 ecosystem config. */
-    botIndex?: string;
-    /** Exact Feishu App identity assigned by the generated PM2 ecosystem config. */
-    larkAppId?: string;
-    /** App identity carried only by a gated managed-activation daemon. */
-    activationAppId?: string;
-    /** Durable activation receipt carried only by the exact gated PM2 process. */
-    activationJobId?: string;
-}
-export type BotmuxPm2Inspection = {
-    ok: true;
-    apps: BotmuxPm2App[];
-} | {
-    ok: false;
-    message: string;
-};
-export type ExactPm2StopResult = {
-    ok: true;
-    state: 'stopped' | 'already-stopped';
-    processName: string;
-} | {
-    ok: false;
-    reason: 'pm2_error';
-    message: string;
-};
-export declare function isExactPm2BotActivationReceipt(app: BotmuxPm2App, processName: string, index: number, appId: string, activationJobId?: string): boolean;
-export declare function managedActivationPm2Disposition(apps: BotmuxPm2App[], processName: string, index: number, appId: string, activationJobId: string): 'acknowledged' | 'replace' | 'identity_mismatch';
-/**
- * Parse the real `pm2 jlist` transport shape. PM2 may prefix stdout with log
- * lines, but a syntactically valid non-array JSON document is never process
- * absence.
- */
-export declare function parsePm2JlistOutputStrict(output: string): any[];
-/** Keep PM2 transport/parse failures distinct from confirmed process absence. */
-export declare function inspectBotmuxPm2Apps(load: () => unknown[]): BotmuxPm2Inspection;
-/** Delete one exact row, then require a successful readback proving absence. */
-export declare function stopExactPm2Process(processName: string, list: () => BotmuxPm2Inspection, remove: (processName: string) => void): ExactPm2StopResult;
-//# sourceMappingURL=bot-live-control.d.ts.map

package/dist/core/bot-live-control.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bot-live-control.d.ts","sourceRoot":"","sources":["../../src/core/bot-live-control.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,YAAY,EAAE,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,iBAAiB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAaT;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,YAAY,EAAE,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,GACtB,cAAc,GAAG,SAAS,GAAG,mBAAmB,CAWlD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,CAqB/D;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,OAAO,EAAE,GAAG,mBAAmB,CAsD/E;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,mBAAmB,EAC/B,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,GACpC,kBAAkB,CA6BpB"}

package/dist/core/bot-live-control.js

@@ -1,135 +0,0 @@
-export function isExactPm2BotActivationReceipt(app, processName, index, appId, activationJobId) {
-    return (app.name === processName
-        && app.botIndex === String(index)
-        && app.larkAppId === appId
-        && (activationJobId === undefined
-            || (app.activationAppId === appId
-                && app.activationJobId === activationJobId)));
-}
-export function managedActivationPm2Disposition(apps, processName, index, appId, activationJobId) {
-    if (apps.some(app => (isExactPm2BotActivationReceipt(app, processName, index, appId, activationJobId)
-        && app.online))) {
-        return 'acknowledged';
-    }
-    if (!apps.every(app => isExactPm2BotActivationReceipt(app, processName, index, appId))) {
-        return 'identity_mismatch';
-    }
-    return 'replace';
-}
-/**
- * Parse the real `pm2 jlist` transport shape. PM2 may prefix stdout with log
- * lines, but a syntactically valid non-array JSON document is never process
- * absence.
- */
-export function parsePm2JlistOutputStrict(output) {
-    let parsedWholeDocument = false;
-    try {
-        const parsed = JSON.parse(output);
-        parsedWholeDocument = true;
-        if (Array.isArray(parsed))
-            return parsed;
-    }
-    catch {
-        // PM2 sometimes prefixes its JSON array with log lines; scan those below.
-    }
-    if (parsedWholeDocument) {
-        throw new Error('pm2_jlist_json_not_found');
-    }
-    for (let start = output.lastIndexOf('['); start >= 0; start = output.lastIndexOf('[', start - 1)) {
-        try {
-            const parsed = JSON.parse(output.slice(start).trim());
-            if (Array.isArray(parsed))
-                return parsed;
-        }
-        catch {
-            // Try an earlier '['.
-        }
-    }
-    throw new Error('pm2_jlist_json_not_found');
-}
-/** Keep PM2 transport/parse failures distinct from confirmed process absence. */
-export function inspectBotmuxPm2Apps(load) {
-    try {
-        const apps = load();
-        if (!Array.isArray(apps)) {
-            return { ok: false, message: 'pm2 jlist result is not an array' };
-        }
-        if (apps.some(app => (!app
-            || typeof app !== 'object'
-            || typeof app.name !== 'string'
-            || !app.name.trim()))) {
-            return {
-                ok: false,
-                message: 'pm2 jlist contains a malformed process row',
-            };
-        }
-        return {
-            ok: true,
-            apps: apps.flatMap((app) => (app.name === 'botmux' || app.name.startsWith('botmux-')
-                ? [{
-                        name: app.name,
-                        online: app?.pm2_env?.status === 'online',
-                        botIndex: typeof app?.pm2_env?.BOTMUX_BOT_INDEX === 'string'
-                            ? app.pm2_env.BOTMUX_BOT_INDEX
-                            : typeof app?.pm2_env?.env?.BOTMUX_BOT_INDEX === 'string'
-                                ? app.pm2_env.env.BOTMUX_BOT_INDEX
-                                : undefined,
-                        larkAppId: typeof app?.pm2_env?.BOTMUX_LARK_APP_ID === 'string'
-                            ? app.pm2_env.BOTMUX_LARK_APP_ID
-                            : typeof app?.pm2_env?.env?.BOTMUX_LARK_APP_ID === 'string'
-                                ? app.pm2_env.env.BOTMUX_LARK_APP_ID
-                                : undefined,
-                        activationAppId: typeof app?.pm2_env?.BOTMUX_MANAGED_ACTIVATION_APP_ID === 'string'
-                            ? app.pm2_env.BOTMUX_MANAGED_ACTIVATION_APP_ID
-                            : typeof app?.pm2_env?.env?.BOTMUX_MANAGED_ACTIVATION_APP_ID === 'string'
-                                ? app.pm2_env.env.BOTMUX_MANAGED_ACTIVATION_APP_ID
-                                : undefined,
-                        activationJobId: typeof app?.pm2_env?.BOTMUX_MANAGED_ACTIVATION_JOB_ID === 'string'
-                            ? app.pm2_env.BOTMUX_MANAGED_ACTIVATION_JOB_ID
-                            : typeof app?.pm2_env?.env?.BOTMUX_MANAGED_ACTIVATION_JOB_ID === 'string'
-                                ? app.pm2_env.env.BOTMUX_MANAGED_ACTIVATION_JOB_ID
-                                : undefined,
-                    }]
-                : [])),
-        };
-    }
-    catch (err) {
-        return {
-            ok: false,
-            message: err instanceof Error ? err.message : String(err),
-        };
-    }
-}
-/** Delete one exact row, then require a successful readback proving absence. */
-export function stopExactPm2Process(processName, list, remove) {
-    const before = list();
-    if (!before.ok) {
-        return { ok: false, reason: 'pm2_error', message: before.message };
-    }
-    if (!before.apps.some(app => app.name === processName)) {
-        return { ok: true, state: 'already-stopped', processName };
-    }
-    try {
-        remove(processName);
-    }
-    catch (err) {
-        return {
-            ok: false,
-            reason: 'pm2_error',
-            message: err instanceof Error ? err.message : String(err),
-        };
-    }
-    const after = list();
-    if (!after.ok) {
-        return { ok: false, reason: 'pm2_error', message: after.message };
-    }
-    if (after.apps.some(app => app.name === processName)) {
-        return {
-            ok: false,
-            reason: 'pm2_error',
-            message: `pm2 process ${processName} is still present after delete`,
-        };
-    }
-    return { ok: true, state: 'stopped', processName };
-}
-//# sourceMappingURL=bot-live-control.js.map

package/dist/core/bot-live-control.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bot-live-control.js","sourceRoot":"","sources":["../../src/core/bot-live-control.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,8BAA8B,CAC5C,GAAiB,EACjB,WAAmB,EACnB,KAAa,EACb,KAAa,EACb,eAAwB;IAExB,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,WAAW;WACrB,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC;WAC9B,GAAG,CAAC,SAAS,KAAK,KAAK;WACvB,CACD,eAAe,KAAK,SAAS;eAC1B,CACD,GAAG,CAAC,eAAe,KAAK,KAAK;mBAC1B,GAAG,CAAC,eAAe,KAAK,eAAe,CAC3C,CACF,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,IAAoB,EACpB,WAAmB,EACnB,KAAa,EACb,KAAa,EACb,eAAuB;IAEvB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CACnB,8BAA8B,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC;WAC5E,GAAG,CAAC,MAAM,CACd,CAAC,EAAE,CAAC;QACH,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,8BAA8B,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACvF,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,mBAAmB,GAAG,IAAI,CAAC;QAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;IAC5E,CAAC;IACD,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,KAAK,IAAI,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;QACjG,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC9C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAAC,IAAqB;IACxD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;QACpE,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CACnB,CAAC,GAAG;eACD,OAAO,GAAG,KAAK,QAAQ;eACvB,OAAQ,GAAW,CAAC,IAAI,KAAK,QAAQ;eACrC,CAAE,GAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAC7B,CAAC,EAAE,CAAC;YACH,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,4CAA4C;aACtD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,CAC/B,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBACrD,CAAC,CAAC,CAAC;wBACC,IAAI,EAAE,GAAG,CAAC,IAAI;wBACd,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,KAAK,QAAQ;wBACzC,QAAQ,EAAE,OAAO,GAAG,EAAE,OAAO,EAAE,gBAAgB,KAAK,QAAQ;4BAC1D,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB;4BAC9B,CAAC,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,KAAK,QAAQ;gCACvD,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB;gCAClC,CAAC,CAAC,SAAS;wBACf,SAAS,EAAE,OAAO,GAAG,EAAE,OAAO,EAAE,kBAAkB,KAAK,QAAQ;4BAC7D,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,kBAAkB;4BAChC,CAAC,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,KAAK,QAAQ;gCACzD,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB;gCACpC,CAAC,CAAC,SAAS;wBACf,eAAe,EAAE,OAAO,GAAG,EAAE,OAAO,EAAE,gCAAgC,KAAK,QAAQ;4BACjF,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,gCAAgC;4BAC9C,CAAC,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,gCAAgC,KAAK,QAAQ;gCACvE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gCAAgC;gCAClD,CAAC,CAAC,SAAS;wBACf,eAAe,EAAE,OAAO,GAAG,EAAE,OAAO,EAAE,gCAAgC,KAAK,QAAQ;4BACjF,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,gCAAgC;4BAC9C,CAAC,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,gCAAgC,KAAK,QAAQ;gCACvE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gCAAgC;gCAClD,CAAC,CAAC,SAAS;qBAChB,CAAC;gBACJ,CAAC,CAAC,EAAE,CACP,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAC1D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,IAA+B,EAC/B,MAAqC;IAErC,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAC1D,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACpE,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;QACrD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,eAAe,WAAW,gCAAgC;SACpE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AACrD,CAAC"}

package/dist/core/bot-turn-mutation-gate.d.ts

@@ -1,24 +0,0 @@
-export declare function withBotTurnAdmission<T>(larkAppId: string, action: () => Promise<T> | T): Promise<T>;
-export declare function withBotTurnMutation<T>(larkAppId: string, action: () => Promise<T> | T): Promise<T>;
-export type BoundedBotTurnMutationResult<T> = {
-    acquired: true;
-    value: T;
-} | {
-    acquired: false;
-    reason: 'timeout' | 'upgrade_conflict';
-};
-export declare function tryWithBotTurnMutation<T>(larkAppId: string, acquireTimeoutMs: number, action: () => Promise<T> | T): Promise<BoundedBotTurnMutationResult<T>>;
-/**
- * Start an independent admission branch from fire-and-forget code. Normal
- * same-bot nesting is intentionally reentrant and MUST be awaited by its
- * caller; JavaScript cannot infer whether a returned Promise was floated.
- * Detached callers clear both contexts and acquire a fresh counted root lease.
- */
-export declare function runDetachedBotTurnAdmission<T>(larkAppId: string, action: () => Promise<T> | T): Promise<T>;
-/** Fire-and-forget counterpart for exclusive lifecycle mutations. A detached
- * mutation inside an admission waits for that admission to drain; one inside a
- * mutation waits for the parent mutation to reopen the gate. Do not await this
- * helper from the parent scope whose lease it must wait on. */
-export declare function runDetachedBotTurnMutation<T>(larkAppId: string, action: () => Promise<T> | T): Promise<T>;
-export declare function __testOnly_resetBotTurnMutationGates(): void;
-//# sourceMappingURL=bot-turn-mutation-gate.d.ts.map

package/dist/core/bot-turn-mutation-gate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bot-turn-mutation-gate.d.ts","sourceRoot":"","sources":["../../src/core/bot-turn-mutation-gate.ts"],"names":[],"mappings":"AA2KA,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,CAAC,CAAC,CA6CZ;AAoDD,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAED,MAAM,MAAM,4BAA4B,CAAC,CAAC,IACtC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC5B;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,kBAAkB,CAAA;CAAE,CAAC;AAgFhE,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,CA4C1C;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,CAAC,CAAC,CAGZ;AAED;;;+DAG+D;AAC/D,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,CAAC,CAAC,CAGZ;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}