botmux 2.9.0 → 2.9.2

package/dist/services/groups-store.js

@@ -0,0 +1,213 @@
+/**
+ * Thin wrappers over Feishu IM v1 chat APIs for the dashboard's groups board.
+ *
+ * Phase B (Web Dashboard) — Task 24. These wrappers are stateless; they reuse
+ * the per-bot Lark SDK client created by `bot-registry`.
+ *
+ * The "proxy bot" pattern in `addBotToChat`: Feishu requires the inviter to
+ * already be a member of the chat, so the dashboard picks an existing-member
+ * bot to do the invite. This wrapper just exposes the underlying call —
+ * proxy selection happens at the route layer.
+ */
+import { getBotClient } from '../bot-registry.js';
+/**
+ * List chats the given bot is a member of, draining pagination internally.
+ * Uses /open-apis/im/v1/chats.
+ */
+export async function listChats(larkAppId) {
+    const client = getBotClient(larkAppId);
+    const out = [];
+    let pageToken;
+    do {
+        const res = await client.im.v1.chat.list({
+            params: {
+                page_size: 100,
+                user_id_type: 'open_id',
+                ...(pageToken ? { page_token: pageToken } : {}),
+            },
+        });
+        if (res.code !== 0 && res.code !== undefined) {
+            throw new Error(`Failed to list chats: ${res.msg} (code: ${res.code})`);
+        }
+        for (const c of res.data?.items ?? []) {
+            out.push({
+                chatId: c.chat_id,
+                name: c.name,
+                description: c.description,
+                chatMode: c.chat_mode,
+                ownerId: c.owner_id,
+            });
+        }
+        pageToken = res.data?.has_more ? res.data?.page_token : undefined;
+    } while (pageToken);
+    return out;
+}
+/**
+ * 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 async function isInChat(larkAppId, chatId) {
+    const client = getBotClient(larkAppId);
+    try {
+        const res = await client.im.v1.chatMembers.isInChat({
+            path: { chat_id: chatId },
+        });
+        if (res.code !== 0 && res.code !== undefined)
+            return false;
+        return !!res.data?.is_in_chat;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 async function createChat(creatorLarkAppId, opts) {
+    const client = getBotClient(creatorLarkAppId);
+    // Filter out the creator from bot_id_list — Lark errors if the inviter
+    // appears in their own invite list.
+    const otherBots = opts.botIds.filter(id => id !== creatorLarkAppId);
+    const userIds = (opts.userIds ?? []).filter(Boolean);
+    const data = {};
+    if (opts.name)
+        data.name = opts.name;
+    if (otherBots.length > 0)
+        data.bot_id_list = otherBots;
+    if (userIds.length > 0)
+        data.user_id_list = userIds;
+    const params = {};
+    if (userIds.length > 0)
+        params.user_id_type = 'open_id';
+    const res = await client.im.v1.chat.create({ data, params });
+    if (res.code !== 0 && res.code !== undefined) {
+        throw new Error(`Failed to create chat: ${res.msg ?? 'unknown'} (code: ${res.code})`);
+    }
+    return {
+        chatId: res.data?.chat_id,
+        invalidBotIds: res.data?.invalid_bot_id_list ?? [],
+        invalidUserIds: res.data?.invalid_user_id_list ?? [],
+    };
+}
+/**
+ * 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 async function transferChatOwner(ownerLarkAppId, chatId, newOwnerOpenId) {
+    const client = getBotClient(ownerLarkAppId);
+    try {
+        const res = await client.im.v1.chat.update({
+            path: { chat_id: chatId },
+            params: { user_id_type: 'open_id' },
+            data: { owner_id: newOwnerOpenId },
+        });
+        if (res.code !== 0 && res.code !== undefined) {
+            return { ok: false, error: `${res.msg ?? 'unknown'} (code: ${res.code})` };
+        }
+        return { ok: true };
+    }
+    catch (e) {
+        return { ok: false, error: e?.message ?? String(e) };
+    }
+}
+/**
+ * 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 async function disbandChat(larkAppId, chatId) {
+    const client = getBotClient(larkAppId);
+    try {
+        const res = await client.im.v1.chat.delete({ path: { chat_id: chatId } });
+        if (res.code !== 0 && res.code !== undefined) {
+            return { ok: false, error: `${res.msg ?? 'unknown'} (code: ${res.code})` };
+        }
+        return { ok: true };
+    }
+    catch (e) {
+        return { ok: false, error: e?.message ?? String(e) };
+    }
+}
+/**
+ * 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 async function leaveChat(larkAppId, chatId) {
+    const client = getBotClient(larkAppId);
+    try {
+        const res = await client.im.v1.chatMembers.delete({
+            path: { chat_id: chatId },
+            params: { member_id_type: 'app_id' },
+            data: { id_list: [larkAppId] },
+        });
+        if (res.code !== 0 && res.code !== undefined) {
+            return { ok: false, error: `${res.msg ?? 'unknown'} (code: ${res.code})` };
+        }
+        return { ok: true };
+    }
+    catch (e) {
+        return { ok: false, error: e?.message ?? String(e) };
+    }
+}
+/**
+ * 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 async function addBotToChat(proxyLarkAppId, chatId, targetLarkAppIds) {
+    if (targetLarkAppIds.length === 0)
+        return [];
+    const client = getBotClient(proxyLarkAppId);
+    const out = [];
+    try {
+        const res = await client.im.v1.chatMembers.create({
+            path: { chat_id: chatId },
+            params: { member_id_type: 'app_id' },
+            data: { id_list: targetLarkAppIds },
+        });
+        if (res.code !== 0 && res.code !== undefined) {
+            const errMsg = `${res.msg ?? 'unknown'} (code: ${res.code})`;
+            for (const id of targetLarkAppIds)
+                out.push({ id, ok: false, error: errMsg });
+            return out;
+        }
+        const invalid = new Set(res.data?.invalid_id_list ?? []);
+        for (const id of targetLarkAppIds) {
+            out.push(invalid.has(id) ? { id, ok: false, error: 'invalid_id' } : { id, ok: true });
+        }
+    }
+    catch (e) {
+        const msg = e?.message ?? String(e);
+        for (const id of targetLarkAppIds)
+            out.push({ id, ok: false, error: msg });
+    }
+    return out;
+}
+//# sourceMappingURL=groups-store.js.map

package/dist/services/groups-store.js.map

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

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

@@ -1,22 +1,94 @@
-import { type OncallChat } from '../bot-registry.js';
+import { type BotDefaultOncall, type OncallChat } from '../bot-registry.js';
 /**
- * Upsert an oncall binding. If the chat is already bound, only existing owners
- * can update the workingDir (ownerOpenId must be in owners). First-time bind
- * puts the caller into owners automatically.
+ * Upsert an oncall binding. Returns whether it was newly created.
  */
-export declare function bindOncall(larkAppId: string, chatId: string, workingDir: string, ownerOpenId: string): {
+export declare function bindOncall(larkAppId: string, chatId: string, workingDir: string): Promise<{
     ok: true;
     entry: OncallChat;
     created: boolean;
 } | {
     ok: false;
     reason: string;
-};
-export declare function unbindOncall(larkAppId: string, chatId: string, ownerOpenId: string): {
+}>;
+/**
+ * Unbind oncall for `chatId` and ALWAYS write a tombstone into
+ * `defaultOncallAutoboundChats`. The tombstone protects against the case
+ * where a user manually fiddled with a chat (bound then unbound, or just
+ * unbound) and we then mis-classify it as "new" on the next observation
+ * and re-auto-bind. Treating unbind as "default's one shot is spent" is
+ * symmetric with auto-bind already adding to the same list.
+ *
+ * Idempotent: never errors on "not bound". `wasBound` reports whether an
+ * existing binding was actually removed so callers can phrase UI text
+ * accordingly (the Lark `/oncall unbind` command still wants to say "未绑定"
+ * vs "已解绑").
+ */
+export declare function unbindOncall(larkAppId: string, chatId: string): Promise<{
     ok: true;
+    wasBound: boolean;
 } | {
     ok: false;
     reason: string;
-};
+}>;
 export declare function getOncallStatus(larkAppId: string, chatId: string): OncallChat | undefined;
+/** Read the current defaultOncall config + autobound list for a bot. Used by
+ *  the dashboard GET route and by the daemon's auto-bind judge. Sync because
+ *  it only reads the in-memory snapshot — file-level consistency comes from
+ *  the daemon never racing with itself on reads. */
+export declare function getBotDefaultOncall(larkAppId: string): {
+    defaultOncall: BotDefaultOncall | undefined;
+    autoboundChats: string[];
+};
+/**
+ * Persist a defaultOncall change for the given bot. The dashboard PUT route
+ * is the only authorized caller — `since` is server-side authoritative so the
+ * frontend can't backdate the cut-off and accidentally include existing chats.
+ *
+ * `since` is stamped on every enabled save, not just the first transition.
+ * This matches the dashboard copy/requirement and prevents a later workingDir
+ * edit from reaching chats that were first observed before that edit.
+ *
+ * When disabled with an empty `workingDir`, the prior workingDir is preserved
+ * so the UI can round-trip (toggle off → toggle back on) without forcing the
+ * user to retype the path. Disable with a non-empty workingDir overwrites.
+ */
+export declare function updateBotDefaultOncall(larkAppId: string, patch: {
+    enabled: boolean;
+    workingDir: string;
+}): Promise<{
+    ok: true;
+    defaultOncall: BotDefaultOncall;
+} | {
+    ok: false;
+    reason: string;
+}>;
+/**
+ * Auto-bind a chat as part of the defaultOncall flow. Atomically:
+ *   1. RE-CHECK tombstone + existing binding against the freshest on-disk
+ *      snapshot. The daemon's fast-path tombstone check is informational —
+ *      if a concurrent `unbindOncall` wrote a tombstone between then and
+ *      now, the lock-internal view sees it and we skip.
+ *   2. Upsert the oncallChats entry (same shape as manual bindOncall).
+ *   3. Append chatId to defaultOncallAutoboundChats (idempotent).
+ *
+ * Returns `skipped: 'tombstoned'` when the lock-internal tombstone check
+ * trips, `skipped: 'already_bound'` when another writer (manual bind by
+ * the user, or a sibling daemon) bound the chat between the fast-path read
+ * and the lock acquisition. Neither is an error.
+ */
+export declare function autoBindOncallFromDefault(larkAppId: string, chatId: string, workingDir: string): Promise<{
+    ok: true;
+    entry: OncallChat;
+    created: boolean;
+    skipped?: undefined;
+} | {
+    ok: true;
+    skipped: 'tombstoned' | 'already_bound';
+    entry?: undefined;
+    created?: undefined;
+} | {
+    ok: false;
+    reason: string;
+}>;
+export declare function _readRawConfigSyncForTesting(path: string): any[];
 //# sourceMappingURL=oncall-store.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"oncall-store.d.ts","sourceRoot":"","sources":["../../src/services/oncall-store.ts"],"names":[],"mappings":"AAMA,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAmBlF;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA6BnF;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAkB9C;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEzF"}
+{"version":3,"file":"oncall-store.d.ts","sourceRoot":"","sources":["../../src/services/oncall-store.ts"],"names":[],"mappings":"AAkBA,OAAO,EAA+B,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAsDzG;;GAEG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAuB5F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B1E;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAQzF;AAID;;;oDAGoD;AACpD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG;IACtD,aAAa,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC5C,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CASA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,gBAAgB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCxF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CACN;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,GACtE;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,YAAY,GAAG,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,GAC7F;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAChC,CAiDA;AAGD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,EAAE,CAEhE"}