botmux 2.9.1 → 2.9.3

package/dist/services/codex-transcript.js

@@ -0,0 +1,298 @@
+/**
+ * Reader for Codex's per-session rollout JSONL.
+ *
+ * Codex stores each session's full transcript at
+ *   ~/.codex/sessions/<YYYY>/<MM>/<DD>/rollout-<ts>-<cliSessionId>.jsonl
+ * and creates the file lazily on the first user submit. Inside, the bridge
+ * fallback only cares about two `response_item.payload.type === 'message'`
+ * shapes:
+ *
+ *   - role=user             → the user's prompt text (input_text content)
+ *   - role=assistant +
+ *     phase=final_answer    → the model's final reply (output_text content)
+ *
+ * Why these and not `event_msg`:
+ *   - `response_item` is the canonical transcript record; `event_msg` is a
+ *     UI-event stream that can carry the same final text via two channels
+ *     (`agent_message phase=final_answer` AND `task_complete.last_agent_message`).
+ *     Picking `response_item` keeps the reader to a single source of truth
+ *     and avoids any chance of double-emit if both paths are present.
+ *   - Skipping role=developer (system instructions), phase=commentary
+ *     (mid-turn status), reasoning, and function_call* keeps the bridge
+ *     focused on what the user actually said and what the model finally
+ *     answered — same scope as the Claude bridge.
+ *
+ * Pure I/O. Attribution belongs in CodexBridgeQueue.
+ */
+import { existsSync, statSync, openSync, readSync, closeSync, readdirSync, readlinkSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+const CODEX_SESSIONS_ROOT = join(homedir(), '.codex', 'sessions');
+const IS_LINUX = platform() === 'linux';
+/** Extract the cliSessionId encoded in a rollout filename. Codex's session
+ *  id is UUID-shaped (8-4-4-4-12 hex), which lets us anchor the regex on
+ *  the UUID alone — the `<ts>` segment between "rollout-" and the sid
+ *  contains its own dashes that would otherwise let a greedy match swallow
+ *  parts of the sid. Returns undefined for paths that don't match. */
+export function codexSessionIdFromRolloutPath(path) {
+    const m = /rollout-.*-([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\.jsonl$/i.exec(path);
+    return m ? m[1] : undefined;
+}
+/** Find the rollout file an externally-running Codex process has open. The
+ *  Codex process keeps fd open on its current rollout for the entire
+ *  lifetime of the session, so this is the authoritative way to bind a
+ *  Codex pid to its sessionId — far more reliable than scanning
+ *  `~/.codex/sessions` by mtime (which would race with sibling Codex panes
+ *  in the same project).
+ *
+ *  Linux: `/proc/<pid>/fd/*` fast path.
+ *  macOS / BSD: `lsof -p <pid> -Fn` 兜底（同 session-discovery 里的 readCwd）。
+ *  两种平台都用 `codexSessionIdFromRolloutPath` 提取 sid。 */
+export function findCodexRolloutByPid(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return undefined;
+    if (IS_LINUX) {
+        const fdDir = `/proc/${pid}/fd`;
+        if (existsSync(fdDir)) {
+            let entries;
+            try {
+                entries = readdirSync(fdDir);
+            }
+            catch {
+                return undefined;
+            }
+            for (const fd of entries) {
+                let target;
+                try {
+                    target = readlinkSync(join(fdDir, fd));
+                }
+                catch {
+                    continue;
+                }
+                const hit = matchCodexRolloutPath(target);
+                if (hit)
+                    return hit;
+            }
+            return undefined;
+        }
+        // /proc 不可读时落到下面的 lsof 兜底（极少见，但兜一下）
+    }
+    // BSD ps 的 lsof：每个 fd 输出一行 `f<n>` 加一行 `n<path>`，socket / pipe
+    // 之类的内部条目以 `n->0x...` 或 `n<garbage>` 开头，所以只接受 `n/` 开头。
+    let out;
+    try {
+        out = execSync(`lsof -p ${pid} -Fn`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch {
+        return undefined;
+    }
+    for (const line of out.split('\n')) {
+        if (!line.startsWith('n/'))
+            continue;
+        const target = line.slice(1);
+        const hit = matchCodexRolloutPath(target);
+        if (hit)
+            return hit;
+    }
+    return undefined;
+}
+function matchCodexRolloutPath(target) {
+    if (!target.endsWith('.jsonl'))
+        return undefined;
+    if (!target.includes('/.codex/sessions/'))
+        return undefined;
+    const sid = codexSessionIdFromRolloutPath(target);
+    if (!sid)
+        return undefined;
+    return { path: target, cliSessionId: sid };
+}
+/** Extract the last completed user/assistant turn from a Codex / CoCo bridge
+ *  event sequence. Used by /adopt to surface the previous turn as a
+ *  preamble card in the Lark thread — gives the user context to continue
+ *  from. CoCo events share the same shape (uuid/timestampMs/kind/text),
+ *  so this works for both bridges.
+ *
+ *  Algorithm: scan tail-first for the most recent `assistant_final`, then
+ *  pair it with the most recent `user` event that precedes it. Returns
+ *  undefined when either side is missing — typically a fresh session whose
+ *  user typed something but the model hasn't replied yet. */
+export function extractLastCodexTurn(events) {
+    let assistantIdx = -1;
+    for (let i = events.length - 1; i >= 0; i--) {
+        if (events[i].kind === 'assistant_final') {
+            assistantIdx = i;
+            break;
+        }
+    }
+    if (assistantIdx < 0)
+        return undefined;
+    let userIdx = -1;
+    for (let i = assistantIdx - 1; i >= 0; i--) {
+        if (events[i].kind === 'user') {
+            userIdx = i;
+            break;
+        }
+    }
+    if (userIdx < 0)
+        return undefined;
+    return {
+        userText: events[userIdx].text,
+        assistantText: events[assistantIdx].text,
+    };
+}
+/** Split a drained event list into "history" (older than the live cutoff)
+ *  and "live" (cutoff or newer). The Codex adopt bridge uses this when
+ *  it discovers the rollout file LATE (after the user already typed in
+ *  iTerm or sent a Lark message): drain-from-0 produces a mix of pre-
+ *  adopt history and post-adopt live events. The worker then `absorb()`s
+ *  the history (so it isn't replayed) and `ingest()`s the live partition
+ *  (so the local-turn synthesis / fingerprint match still works). Pure
+ *  function — no I/O, easy to test against fixed timestamps. */
+export function splitCodexEventsByCutoff(events, liveSinceMs) {
+    const history = [];
+    const live = [];
+    for (const ev of events) {
+        if (ev.timestampMs < liveSinceMs)
+            history.push(ev);
+        else
+            live.push(ev);
+    }
+    return { history, live };
+}
+/** Locate the rollout file for a given Codex sessionId. Codex names files
+ *  `rollout-<ts>-<sid>.jsonl`, so a suffix match is unambiguous. The
+ *  directory tree is small (year/month/day) — a one-shot recursive scan
+ *  is cheap enough that we don't bother caching. */
+export function findCodexRolloutBySessionId(cliSessionId) {
+    if (!cliSessionId || !existsSync(CODEX_SESSIONS_ROOT))
+        return undefined;
+    const suffix = `-${cliSessionId}.jsonl`;
+    const stack = [CODEX_SESSIONS_ROOT];
+    while (stack.length > 0) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries) {
+            const full = join(dir, name);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                stack.push(full);
+            }
+            else if (st.isFile() && name.endsWith(suffix)) {
+                return full;
+            }
+        }
+    }
+    return undefined;
+}
+/** Concatenate all text blocks of a content array. Codex rollout content
+ *  is always an array of `{type, text}`; the kinds we care about are
+ *  `input_text` (user) and `output_text` (assistant). Other block types
+ *  (image_url, audio, etc.) are ignored — the bridge only forwards text. */
+function joinTextBlocks(content, kind) {
+    if (!Array.isArray(content))
+        return '';
+    const parts = [];
+    for (const block of content) {
+        if (block && typeof block === 'object' && block.type === kind) {
+            const text = block.text;
+            if (typeof text === 'string')
+                parts.push(text);
+        }
+    }
+    return parts.join('');
+}
+/** Increment-read the rollout from `fromOffset`. Mirrors the byte-offset
+ *  contract of claude-transcript.drainTranscript so callers can swap them
+ *  out and reuse the existing fs.watch / poll wakeup machinery. */
+export function drainCodexRollout(path, fromOffset) {
+    if (!existsSync(path))
+        return { events: [], newOffset: 0, pendingTail: '' };
+    let size;
+    try {
+        size = statSync(path).size;
+    }
+    catch {
+        return { events: [], newOffset: fromOffset, pendingTail: '' };
+    }
+    let start = fromOffset;
+    // Truncated/rotated jsonl — re-read from the top. Codex doesn't normally
+    // rewrite rollouts, but mirror Claude's defensive handling.
+    if (size < start)
+        start = 0;
+    if (size === start)
+        return { events: [], newOffset: start, pendingTail: '' };
+    const len = size - start;
+    const buf = Buffer.alloc(len);
+    const fd = openSync(path, 'r');
+    try {
+        readSync(fd, buf, 0, len, start);
+    }
+    finally {
+        closeSync(fd);
+    }
+    const text = buf.toString('utf8');
+    const lastNl = text.lastIndexOf('\n');
+    const completeText = lastNl >= 0 ? text.slice(0, lastNl + 1) : '';
+    const pendingTail = lastNl >= 0 ? text.slice(lastNl + 1) : text;
+    const newOffset = start + Buffer.byteLength(completeText, 'utf8');
+    const events = [];
+    // Track byte offset within the file as we walk lines so synthetic uuids
+    // are stable across re-drains.
+    let cursor = start;
+    for (const line of completeText.split('\n')) {
+        if (line.length === 0) {
+            cursor += 1; // the \n after an empty line
+            continue;
+        }
+        const lineByteLen = Buffer.byteLength(line, 'utf8') + 1; // include \n
+        const lineStart = cursor;
+        cursor += lineByteLen;
+        let obj;
+        try {
+            obj = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (obj?.type !== 'response_item')
+            continue;
+        const p = obj.payload;
+        if (!p || typeof p !== 'object' || p.type !== 'message')
+            continue;
+        const ts = typeof obj.timestamp === 'string' ? Date.parse(obj.timestamp) : NaN;
+        const timestampMs = Number.isFinite(ts) ? ts : Date.now();
+        if (p.role === 'user') {
+            const text = joinTextBlocks(p.content, 'input_text');
+            if (!text)
+                continue;
+            events.push({ uuid: `${path}:${lineStart}`, timestampMs, kind: 'user', text });
+        }
+        else if (p.role === 'assistant' && p.phase === 'final_answer') {
+            const text = joinTextBlocks(p.content, 'output_text');
+            if (!text)
+                continue;
+            events.push({ uuid: `${path}:${lineStart}`, timestampMs, kind: 'assistant_final', text });
+        }
+        // Skip role=developer (instructions), phase=commentary (mid-turn
+        // status), and any reasoning / function_call* events — see file
+        // header for rationale.
+    }
+    return { events, newOffset, pendingTail };
+}
+//# sourceMappingURL=codex-transcript.js.map

package/dist/services/codex-transcript.js.map

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

package/dist/services/group-creator.d.ts

@@ -0,0 +1,23 @@
+export interface CreateGroupOpts {
+    creatorLarkAppId: string;
+    /** Bots expected to join the new chat. Creator is filtered out internally
+     *  (Lark rejects self-invite). May be empty (creator-only chat). */
+    larkAppIds: string[];
+    name?: string;
+    userOpenIds?: string[];
+    transferOwnerTo?: string;
+    notifyOwnerOpenId?: string;
+}
+export interface CreateGroupResult {
+    ok: true;
+    chatId: string;
+    creator: string;
+    invalidBotIds: string[];
+    invalidUserIds: string[];
+    ownerTransferredTo: string | null;
+    transferError: string | null;
+    notifyMessageId: string | null;
+    notifyError: string | null;
+}
+export declare function createGroupWithBots(opts: CreateGroupOpts): Promise<CreateGroupResult>;
+//# sourceMappingURL=group-creator.d.ts.map

package/dist/services/group-creator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-creator.d.ts","sourceRoot":"","sources":["../../src/services/group-creator.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB;wEACoE;IACpE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuD3F"}

package/dist/services/group-creator.js

@@ -0,0 +1,75 @@
+/**
+ * Group creation service — execution layer shared by dashboard and CLI.
+ *
+ * Decision layers (dashboard handler / CLI subcommand) are responsible for
+ * choosing `creatorLarkAppId`, resolving bot refs, deriving user_open_ids, etc.
+ * This service only orchestrates the Lark API sequence:
+ *
+ *   1. createChat (bots + invited users)
+ *   2. transferChatOwner (best-effort, skipped if invitee was rejected)
+ *   3. send @-mention notify (best-effort, skipped if invitee was rejected)
+ *
+ * Partial failures (transfer/notify) are returned as `*Error` fields without
+ * throwing — the chat already exists at that point and retrying would create
+ * duplicate groups. Only createChat throwing surfaces as an exception.
+ *
+ * Lark open_id is app-scoped: `userOpenIds`, `transferOwnerTo`, and
+ * `notifyOwnerOpenId` MUST be in `creatorLarkAppId`'s app scope. Enforcing
+ * this is the decision layer's job — the service trusts its inputs.
+ */
+import { createChat, transferChatOwner } from './groups-store.js';
+import { sendMessage } from '../im/lark/client.js';
+export async function createGroupWithBots(opts) {
+    // Filter creator out of the bot invite list. createChat does this defensively
+    // too, but doing it here makes the service contract explicit and keeps
+    // invalidBotIds reporting stable across underlying API changes.
+    const otherBots = opts.larkAppIds.filter(id => id !== opts.creatorLarkAppId);
+    const r = await createChat(opts.creatorLarkAppId, {
+        name: opts.name,
+        botIds: otherBots,
+        userIds: opts.userOpenIds ?? [],
+    });
+    let ownerTransferredTo = null;
+    let transferError = null;
+    if (opts.transferOwnerTo) {
+        // Skip transfer if Feishu rejected the invite — transferring to a
+        // non-member returns "user not in chat" anyway.
+        if (r.invalidUserIds.includes(opts.transferOwnerTo)) {
+            transferError = 'invitee_rejected';
+        }
+        else {
+            const tr = await transferChatOwner(opts.creatorLarkAppId, r.chatId, opts.transferOwnerTo);
+            if (tr.ok)
+                ownerTransferredTo = opts.transferOwnerTo;
+            else
+                transferError = tr.error;
+        }
+    }
+    let notifyMessageId = null;
+    let notifyError = null;
+    if (opts.notifyOwnerOpenId) {
+        if (r.invalidUserIds.includes(opts.notifyOwnerOpenId)) {
+            notifyError = 'invitee_rejected';
+        }
+        else {
+            try {
+                notifyMessageId = await sendMessage(opts.creatorLarkAppId, r.chatId, `<at user_id="${opts.notifyOwnerOpenId}"></at>`, 'text');
+            }
+            catch (e) {
+                notifyError = e?.message ?? String(e);
+            }
+        }
+    }
+    return {
+        ok: true,
+        chatId: r.chatId,
+        creator: opts.creatorLarkAppId,
+        invalidBotIds: r.invalidBotIds,
+        invalidUserIds: r.invalidUserIds,
+        ownerTransferredTo,
+        transferError,
+        notifyMessageId,
+        notifyError,
+    };
+}
+//# sourceMappingURL=group-creator.js.map

package/dist/services/group-creator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-creator.js","sourceRoot":"","sources":["../../src/services/group-creator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAyBnD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAqB;IAC7D,8EAA8E;IAC9E,uEAAuE;IACvE,gEAAgE;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC7E,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAChD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;KAChC,CAAC,CAAC;IAEH,IAAI,kBAAkB,GAAkB,IAAI,CAAC;IAC7C,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,kEAAkE;QAClE,gDAAgD;QAChD,IAAI,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YACpD,aAAa,GAAG,kBAAkB,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1F,IAAI,EAAE,CAAC,EAAE;gBAAE,kBAAkB,GAAG,IAAI,CAAC,eAAe,CAAC;;gBAChD,aAAa,GAAG,EAAE,CAAC,KAAK,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACtD,WAAW,GAAG,kBAAkB,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,eAAe,GAAG,MAAM,WAAW,CACjC,IAAI,CAAC,gBAAgB,EACrB,CAAC,CAAC,MAAM,EACR,gBAAgB,IAAI,CAAC,iBAAiB,SAAS,EAC/C,MAAM,CACP,CAAC;YACJ,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,WAAW,GAAG,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,IAAI,CAAC,gBAAgB;QAC9B,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,kBAAkB;QAClB,aAAa;QACb,eAAe;QACf,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/services/groups-store.d.ts

@@ -0,0 +1,98 @@
+export interface ChatBrief {
+    chatId: string;
+    name?: string;
+    description?: string;
+    chatMode?: string;
+    ownerId?: string;
+}
+/**
+ * List chats the given bot is a member of, draining pagination internally.
+ * Uses /open-apis/im/v1/chats.
+ */
+export declare function listChats(larkAppId: string): Promise<ChatBrief[]>;
+/**
+ * Check whether the given bot is a member of the given chat.
+ * Uses /open-apis/im/v1/chats/:chat_id/members/is_in_chat — the bot's own
+ * access token implicitly identifies the bot being checked.
+ *
+ * Errors (chat not found, no permission, etc.) are swallowed and treated as
+ * "not in chat" so callers can use this as a simple boolean predicate.
+ */
+export declare function isInChat(larkAppId: string, chatId: string): Promise<boolean>;
+/**
+ * Create a brand-new chat with `bot_id_list` as initial bot members.  The
+ * `creatorLarkAppId` bot becomes the chat's owner and an implicit member; the
+ * other bots in `botIds` are added in the same call.  Used by the dashboard's
+ * "Create new group" flow.
+ *
+ * Returns the new chatId on success.  Throws on any non-zero Lark response so
+ * the route can surface a real error.  We deliberately don't soften failures
+ * here (unlike `isInChat`) because the caller wants to know whether the chat
+ * actually got created.
+ */
+export declare function createChat(creatorLarkAppId: string, opts: {
+    name?: string;
+    botIds: string[];
+    userIds?: string[];
+}): Promise<{
+    chatId: string;
+    invalidBotIds: string[];
+    invalidUserIds: string[];
+}>;
+/**
+ * Transfer ownership of a chat from the calling bot to a Feishu user.  Used
+ * after `createChat` so the dashboard operator (who's been invited as a
+ * member) ends up as the actual owner — otherwise the bot stays group owner
+ * and the user can't manage the chat.
+ *
+ * Calls /open-apis/im/v1/chats/:chat_id with `owner_id` in the body and
+ * `user_id_type=open_id`. The caller's bot must currently be the owner; this
+ * is the case right after createChat since the creator bot is the implicit
+ * owner.
+ *
+ * `newOwnerOpenId` must be in the calling bot's app scope — Lark open_ids are
+ * app-scoped, see operator-selector.ts for why.
+ */
+export declare function transferChatOwner(ownerLarkAppId: string, chatId: string, newOwnerOpenId: string): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+}>;
+/**
+ * Disband (delete) a chat. The Lark API only succeeds when the calling bot is
+ * the chat's current owner, OR is the creator AND the app holds
+ * `im:chat:operate_as_owner`. Routes that fan-out to multiple bots can use
+ * this best-effort: try each in-chat bot until one succeeds.
+ */
+export declare function disbandChat(larkAppId: string, chatId: string): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+}>;
+/**
+ * Make the calling bot leave a chat.  Per Lark docs, self-removal succeeds
+ * regardless of role (owner/manager/member). Useful when the bot can't disband
+ * (not owner, no operate_as_owner scope) but still wants to detach.
+ */
+export declare function leaveChat(larkAppId: string, chatId: string): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+}>;
+/**
+ * Add bot apps to a chat using a "proxy" bot that's already a member.
+ * Uses /open-apis/im/v1/chats/:chat_id/members with member_id_type=app_id.
+ * Returns per-id result derived from the API's invalid_id_list.
+ *
+ * On total failure (network error, non-zero code) every id reports the same
+ * error so the caller can present a uniform per-id status.
+ */
+export declare function addBotToChat(proxyLarkAppId: string, chatId: string, targetLarkAppIds: string[]): Promise<{
+    id: string;
+    ok: boolean;
+    error?: string;
+}[]>;
+//# sourceMappingURL=groups-store.d.ts.map

package/dist/services/groups-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups-store.d.ts","sourceRoot":"","sources":["../../src/services/groups-store.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA2BvE;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC5D,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqBhF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAetD;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAChC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAWtD;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAChC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAetD;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAwBxD"}