botmux 3.13.0 → 3.15.0

package/dist/services/session-group-title.js

@@ -0,0 +1,226 @@
+/**
+ * Async AI title for session groups (p2pMode='group', naming.mode='ai-summary').
+ *
+ * Two-phase naming: the group is created instantly with a truncated
+ * placeholder name; this module then runs ONE headless single-turn call
+ * through the bot's own CLI to produce a short title and renames the chat
+ * when it lands. Fire-and-forget — every failure path simply keeps the
+ * placeholder, never blocks or breaks the conversation.
+ *
+ * The one-shot command is a small per-cliId argv template (print/exec modes
+ * of the CLIs botmux already drives). CLIs without a known print mode
+ * degrade to the placeholder silently.
+ */
+import { execFile } from 'node:child_process';
+import { tmpdir } from 'node:os';
+import { getBot } from '../bot-registry.js';
+import { redactChildEnv } from '../utils/child-env.js';
+import { sanitizePerBotEnv } from '../core/per-bot-env.js';
+import { buildWrappedLaunch, wrapperLaunchEnv } from '../setup/cli-selection.js';
+import { renameChat } from './groups-store.js';
+import { getSessionGroup, markSessionGroupTitled, touchSessionGroup } from './session-groups-store.js';
+import * as sessionStore from './session-store.js';
+import { updateSessionTitle } from '../core/session-title.js';
+import { localeForBot } from '../i18n/index.js';
+import { logger } from '../utils/logger.js';
+// Generous: one-shot CLIs pay cold-start + API latency (codex regularly
+// exceeds 15s); the rename is async so a slow title costs nothing visible.
+const TITLE_TIMEOUT_MS = 45_000;
+const DEFAULT_MAX_LEN = 12;
+/** Per-cliId one-shot print-mode argv template. `argv[0]` is replaced by
+ *  `cliPathOverride` when configured. Prompt is appended as the last arg. */
+const ONE_SHOT_ARGV = {
+    'claude-code': ['claude', '-p'],
+    codex: ['codex', 'exec', '--skip-git-repo-check'],
+    // TRAE CLI is a codex fork — same exec surface and bare-answer stdout.
+    traex: ['traex', 'exec', '--skip-git-repo-check'],
+    opencode: ['opencode', 'run'],
+    gemini: ['gemini', '-p'],
+};
+/** One in-flight title job per chat — birth and the heal-on-activity path
+ *  (handleThreadReply) can otherwise race duplicate CLI calls. */
+const inFlightTitles = new Set();
+/**
+ * Child env for the one-shot title call — the SAME security boundary as every
+ * other CLI child the daemon spawns (PR review P2): `redactChildEnv` strips
+ * daemon-only secrets (LARK_APP_SECRET, GITHUB_TOKEN, tmux client vars, Claude
+ * session markers) and `sanitizePerBotEnv(cfg.env)` layers the bot's own
+ * provider environment (base URL / auth token) on top so multi-provider bots
+ * title through their own account instead of the daemon's. Exported for the
+ * env-boundary regression tests.
+ */
+/**
+ * Resolve the one-shot launch with the SAME launcher semantics as the formal
+ * CLI spawn path (PR review): `wrapperCli` goes through buildWrappedLaunch —
+ * the shared builder that knows the gateway specifics (ttadk needs
+ * `-m <model> --skip-check` or it opens an interactive model selector /
+ * preflight and a non-TTY execFile hangs to timeout; aiden strips args it
+ * rejects; cjadk rewrites codex config args) — plus wrapperLaunchEnv for the
+ * wrapper's non-interactive env knobs (CJADK_INTERACTIVE=0). Without a
+ * wrapper, `cliPathOverride` (registerBot enforces it as an exact shadow of
+ * cliRuntime.executable, so runtime configs are covered transitively)
+ * replaces the template bin; otherwise the template runs verbatim. Exported
+ * for tests.
+ */
+export function resolveOneShotCommand(cfg, template) {
+    const wrapper = cfg.wrapperCli?.trim();
+    if (wrapper) {
+        const { bin, args } = buildWrappedLaunch(wrapper, template.slice(1), b => b, { ttadkModel: cfg.model });
+        return { argv: [bin, ...args], env: wrapperLaunchEnv(wrapper) };
+    }
+    const override = cfg.cliPathOverride?.trim();
+    if (override)
+        return { argv: [override, ...template.slice(1)] };
+    return { argv: [...template] };
+}
+export function buildOneShotEnv(botEnv) {
+    const env = {
+        ...redactChildEnv(process.env),
+        ...sanitizePerBotEnv(botEnv),
+    };
+    // Never let the one-shot inherit a botmux session identity (redundant with
+    // the marker scrub above, kept as an explicit invariant).
+    delete env.BOTMUX_SESSION_ID;
+    return env;
+}
+export function buildTitlePrompt(text, maxLen, locale) {
+    const excerpt = text.replace(/\s+/g, ' ').trim().slice(0, 500);
+    if (locale === 'en') {
+        return `Summarize the following request as a conversation title of at most ${maxLen} characters. Output ONLY the title itself — no quotes, no trailing period, no explanation:\n\n${excerpt}`;
+    }
+    return `用不超过${maxLen}个字总结下面这条请求，作为会话标题。只输出标题本身，不要引号、句号或任何解释：\n\n${excerpt}`;
+}
+/** Strip decoration from a candidate title line. */
+function cleanTitleLine(raw) {
+    return raw
+        .replace(/^["'“”‘’`#*\s]+/, '')
+        // Trailing quotes/backticks and sentence punctuation interleave (e.g.
+        // `标题"。`) — strip them as one class so the order can't matter.
+        .replace(/["'“”‘’`。.!！?？\s]+$/, '')
+        .trim();
+}
+/** Extract a plausible title from one-shot CLI stdout: last non-empty line
+ *  (codex/opencode prepend progress logs; claude/gemini print the bare
+ *  answer), stripped of quotes/markdown and length-capped. Two passes: a
+ *  strict pass drops known log-line shapes; if that filters EVERYTHING (an
+ *  output shape we didn't predict), a lenient pass takes the last line that
+ *  still looks like prose — never let over-filtering blank a real answer. */
+export function sanitizeTitleOutput(stdout, maxLen) {
+    const all = stdout.split('\n').map(l => l.trim()).filter(Boolean);
+    // Obvious non-answers in ANY pass: dividers, bare numbers, hook chatter,
+    // lines with no letter/digit at all.
+    const junk = (l) => !/[\p{L}\p{N}]/u.test(l) || /^[-=—_\s]+$/.test(l) || /^\d[\d,.\s]*$/.test(l) || /^hook:/i.test(l);
+    const strict = all
+        // codex exec progress lines look like "[2026-08-05T…] tokens used: 123" —
+        // drop bracketed/log-ish lines so the answer line survives as the last one.
+        .filter(l => !junk(l) && !/^\[.*\]/.test(l) && !/^(tokens used|thinking|codex$|user$)/i.test(l));
+    // Lenient fallback: keep anything prose-like, including bracket-prefixed
+    // lines the strict pass dropped (unpredicted "[ts] answer" shapes).
+    const lenient = all.filter(l => !junk(l));
+    const raw = strict.length ? strict[strict.length - 1]
+        // The lenient pick may still carry a bracketed log prefix — strip it so a
+        // "[ts] answer" line yields the answer, not the timestamp.
+        : lenient.length ? lenient[lenient.length - 1].replace(/^\[[^\]]*\]\s*/, '') : '';
+    const cleaned = cleanTitleLine(raw);
+    if (!cleaned)
+        return null;
+    // Hard cap: maxLen is advisory to the model; enforce a generous ceiling so
+    // a slightly-long but good title still beats the placeholder.
+    const capped = Array.from(cleaned).slice(0, Math.max(maxLen * 2, 16)).join('');
+    return capped || null;
+}
+/** Fire-and-forget: generate an AI title for a freshly-born session group and
+ *  rename the chat (+ session record) when it lands. */
+export function scheduleSessionGroupTitle(opts) {
+    const { larkAppId, chatId, userText } = opts;
+    if (inFlightTitles.has(chatId))
+        return;
+    inFlightTitles.add(chatId);
+    void (async () => {
+        try {
+            const cfg = getBot(larkAppId).config;
+            const sg = cfg.sessionGroup ?? {};
+            if ((sg.naming?.mode ?? 'ai-summary') !== 'ai-summary')
+                return;
+            if (!userText.trim())
+                return;
+            const maxLen = sg.naming?.maxLen && sg.naming.maxLen > 0 ? sg.naming.maxLen : DEFAULT_MAX_LEN;
+            const template = ONE_SHOT_ARGV[cfg.cliId];
+            if (!template) {
+                logger.info(`[session-group] no one-shot template for cliId=${cfg.cliId}; keeping placeholder title`);
+                return;
+            }
+            const { argv, env: wrapperEnv } = resolveOneShotCommand(cfg, template);
+            const prompt = buildTitlePrompt(userText, maxLen, localeForBot(larkAppId));
+            const runOnce = () => new Promise((resolve, reject) => {
+                const env = { ...buildOneShotEnv(cfg.env), ...wrapperEnv };
+                const child = execFile(argv[0], [...argv.slice(1), prompt], {
+                    timeout: TITLE_TIMEOUT_MS,
+                    maxBuffer: 1024 * 1024,
+                    cwd: tmpdir(),
+                    env,
+                }, (err, out, errOut) => {
+                    if (err && !out) {
+                        // Surface stderr — execFile's bare "Command failed: …" hides the
+                        // actual CLI error (API failures, auth, rate limits).
+                        const detail = String(errOut ?? '').trim().split('\n').slice(-2).join(' ').slice(0, 200);
+                        return reject(new Error(`${err.message.split('\n')[0]}${detail ? ` | stderr: ${detail}` : ''}`));
+                    }
+                    resolve(String(out ?? ''));
+                });
+                // CRITICAL: close stdin. codex-family CLIs (codex/traex) treat a piped
+                // stdin as "additional input" and BLOCK reading it until EOF — with
+                // execFile's default open pipe they hang to the timeout and get killed
+                // ("Reading additional input from stdin..."). A TTY stdin (manual
+                // testing) skips that path, which is why this only bites under the
+                // daemon. Closing stdin is a no-op for CLIs that never read it.
+                child.stdin?.end();
+            });
+            // One-shot CLI calls fail transiently (API hiccups, cold start races) —
+            // a single spaced retry recovers most of them without delaying much.
+            let stdout;
+            try {
+                stdout = await runOnce();
+            }
+            catch (firstErr) {
+                logger.info(`[session-group] AI title attempt 1 failed for chat=${chatId.substring(0, 12)} (retrying): ${firstErr}`);
+                await new Promise(r => setTimeout(r, 3000));
+                stdout = await runOnce();
+            }
+            const title = sanitizeTitleOutput(stdout, maxLen);
+            if (!title) {
+                // Log the raw head — an unpredicted output shape is invisible otherwise.
+                const rawHead = stdout.replace(/\s+/g, ' ').trim().slice(0, 200);
+                logger.info(`[session-group] AI title empty for chat=${chatId.substring(0, 12)}; keeping placeholder (raw: "${rawHead}")`);
+                return;
+            }
+            const prefix = sg.namePrefix ?? '';
+            const finalName = `${prefix}${title}`;
+            // Reuse the shared renameChat wrapper (membership precheck + error
+            // classification) instead of a bespoke chat.update call.
+            const r = await renameChat(larkAppId, chatId, finalName);
+            if (!r.ok) {
+                logger.warn(`[session-group] rename chat=${chatId.substring(0, 12)} failed: ${r.error}${r.detail ? ` (${r.detail})` : ''}`);
+                return;
+            }
+            markSessionGroupTitled(chatId);
+            // Best-effort: keep the botmux session title in sync so `botmux list` /
+            // dashboard show the same name as the chat (same path as /rename).
+            const entry = getSessionGroup(chatId);
+            if (entry?.lastSessionId) {
+                const session = sessionStore.getSession(entry.lastSessionId);
+                if (session)
+                    updateSessionTitle(session, title, 'system');
+                touchSessionGroup(chatId);
+            }
+            logger.info(`[session-group] titled chat=${chatId.substring(0, 12)} "${finalName}"`);
+        }
+        catch (err) {
+            logger.info(`[session-group] AI title failed for chat=${chatId.substring(0, 12)} (placeholder kept): ${err}`);
+        }
+        finally {
+            inFlightTitles.delete(chatId);
+        }
+    })();
+}
+//# sourceMappingURL=session-group-title.js.map

package/dist/services/session-group-title.js.map

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

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

@@ -0,0 +1,30 @@
+export interface SessionGroupEntry {
+    /** The DM user this group was born for (open_id in the bot's app scope). */
+    ownerOpenId: string;
+    /** Most recent session anchored in this group; same-group resume target. */
+    lastSessionId: string;
+    /** Epoch ms the group was created. */
+    createdAt: number;
+    /** Epoch ms of the last observed activity (birth, resume, new session). */
+    lastActiveAt: number;
+    /** True once the async AI title has been applied to the chat name. */
+    titled?: boolean;
+}
+export declare function initSessionGroups(appId: string): void;
+/** Register a freshly-born session group (or overwrite after a re-birth). */
+export declare function registerSessionGroup(chatId: string, entry: Omit<SessionGroupEntry, 'createdAt' | 'lastActiveAt'> & {
+    createdAt?: number;
+}): void;
+/** Typing check — the ONLY sanctioned way to tell a session group apart. */
+export declare function isSessionGroup(chatId: string): boolean;
+export declare function getSessionGroup(chatId: string): SessionGroupEntry | undefined;
+/** Point the registry at the session currently living in this group. */
+export declare function touchSessionGroup(chatId: string, lastSessionId?: string): void;
+/** Mark the async AI title as applied (idempotent). */
+export declare function markSessionGroupTitled(chatId: string): void;
+/** Remove a registry entry (group disbanded / bot removed / gc). */
+export declare function removeSessionGroup(chatId: string): void;
+export declare function listSessionGroups(): Array<{
+    chatId: string;
+} & SessionGroupEntry>;
+//# sourceMappingURL=session-groups-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-groups-store.d.ts","sourceRoot":"","sources":["../../src/services/session-groups-store.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrD;AAyCD,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,cAAc,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWhJ;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAItD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAI7E;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAO9E;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAM3D;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGvD;AAED,wBAAgB,iBAAiB,IAAI,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAAC,CAIjF"}

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

@@ -0,0 +1,132 @@
+/**
+ * Session-group registry — the authoritative "is this chat a session group?"
+ * lookup for p2pMode='group'.
+ *
+ * A session group is a disposable 1-user+1-bot chat auto-created to host ONE
+ * DM-born conversation (see docs: p2pMode=group). It is deliberately typed
+ * apart from workspace groups: per-chat features (oncall UI, /reply-mode,
+ * dashboard group management) consult this registry to exclude or specialize
+ * session groups WITHOUT string-matching on chat names.
+ *
+ * Registry answers three questions:
+ *   1. isSessionGroup(chatId)      — typing / feature gating
+ *   2. lastSessionId for a chatId  — same-group resume: a new message in a
+ *      session group whose session was /close'd resumes that session instead
+ *      of spawning a fresh one (的话题内续聊同款体验).
+ *   3. ownerOpenId                 — the DM user the group was born for.
+ *
+ * File layout mirrors session-store / chat-first-seen-store: one file per bot
+ * at `${config.session.dataDir}/session-groups-${appId}.json`, written
+ * atomically via tmp + rename. One daemon process serves one bot, so the
+ * per-appId singleton pattern applies.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, renameSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { config } from '../config.js';
+import { logger } from '../utils/logger.js';
+let entries = new Map();
+let loaded = false;
+let currentAppId;
+export function initSessionGroups(appId) {
+    currentAppId = appId;
+    loaded = false;
+    entries = new Map();
+}
+function getFilePath() {
+    if (!currentAppId)
+        throw new Error('session-groups-store not initialised (call initSessionGroups(appId) first)');
+    return join(config.session.dataDir, `session-groups-${currentAppId}.json`);
+}
+function ensureDir() {
+    const dir = dirname(getFilePath());
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function load() {
+    if (loaded)
+        return;
+    ensureDir();
+    const fp = getFilePath();
+    if (existsSync(fp)) {
+        try {
+            const data = JSON.parse(readFileSync(fp, 'utf-8'));
+            entries = new Map(Object.entries(data).filter(([, v]) => v && typeof v.ownerOpenId === 'string' && typeof v.lastSessionId === 'string'));
+        }
+        catch (err) {
+            logger.error(`[session-groups] failed to load ${fp}: ${err}`);
+            entries = new Map();
+        }
+    }
+    loaded = true;
+}
+function persist() {
+    ensureDir();
+    const fp = getFilePath();
+    const tmp = `${fp}.tmp`;
+    try {
+        writeFileSync(tmp, JSON.stringify(Object.fromEntries(entries), null, 2), 'utf-8');
+        renameSync(tmp, fp);
+    }
+    catch (err) {
+        logger.error(`[session-groups] failed to persist ${fp}: ${err}`);
+    }
+}
+/** Register a freshly-born session group (or overwrite after a re-birth). */
+export function registerSessionGroup(chatId, entry) {
+    load();
+    const now = Date.now();
+    entries.set(chatId, {
+        ownerOpenId: entry.ownerOpenId,
+        lastSessionId: entry.lastSessionId,
+        createdAt: entry.createdAt ?? now,
+        lastActiveAt: now,
+        titled: entry.titled,
+    });
+    persist();
+}
+/** Typing check — the ONLY sanctioned way to tell a session group apart. */
+export function isSessionGroup(chatId) {
+    if (!currentAppId)
+        return false;
+    load();
+    return entries.has(chatId);
+}
+export function getSessionGroup(chatId) {
+    if (!currentAppId)
+        return undefined;
+    load();
+    return entries.get(chatId);
+}
+/** Point the registry at the session currently living in this group. */
+export function touchSessionGroup(chatId, lastSessionId) {
+    load();
+    const cur = entries.get(chatId);
+    if (!cur)
+        return;
+    if (lastSessionId)
+        cur.lastSessionId = lastSessionId;
+    cur.lastActiveAt = Date.now();
+    persist();
+}
+/** Mark the async AI title as applied (idempotent). */
+export function markSessionGroupTitled(chatId) {
+    load();
+    const cur = entries.get(chatId);
+    if (!cur || cur.titled)
+        return;
+    cur.titled = true;
+    persist();
+}
+/** Remove a registry entry (group disbanded / bot removed / gc). */
+export function removeSessionGroup(chatId) {
+    load();
+    if (entries.delete(chatId))
+        persist();
+}
+export function listSessionGroups() {
+    if (!currentAppId)
+        return [];
+    load();
+    return Array.from(entries.entries()).map(([chatId, v]) => ({ chatId, ...v }));
+}
+//# sourceMappingURL=session-groups-store.js.map

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

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

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

@@ -131,4 +131,62 @@ export declare function countActiveSessionsOnDisk(dataDir?: string): number;
  * resumable via their own session-closed cards.
  */
 export declare function collectBotmuxSessionIdentities(dataDir?: string): Set<string>;
+/**
+ * Read-only snapshot of every session row across the legacy `sessions.json`
+ * and all per-bot `sessions-<appId>.json` files. Per-bot rows win duplicate
+ * sessionIds and get `larkAppId` stamped from their filename so a later
+ * offline mutation resolves the owning file. Deliberately lock-free: atomic
+ * tmp+rename publication keeps each file self-consistent, and snapshot
+ * composition must stay a pure reader (an older CLI opportunistically migrated
+ * legacy rows here, which made even `botmux list` a whole-file writer able to
+ * race a daemon save).
+ */
+export declare function loadAllSessionsSnapshot(options?: {
+    dataDir?: string;
+    /** Per-bot fallback when the data dir cannot be enumerated (the CLI file
+     *  sandbox exposes sessions-<self>.json but NOT a listing of data/). */
+    fallbackAppId?: string;
+}): Map<string, Session>;
+/**
+ * Unlocked point-read of one row straight from disk, bypassing this process's
+ * in-memory cache: the owning per-bot file first, then the legacy
+ * `sessions.json`. Atomic tmp+rename publication keeps each file
+ * self-consistent, so this never blocks on (or throws from) the store lock —
+ * safe on hot paths that only need a freshness hint.
+ */
+export declare function readSessionRowFromDisk(sessionId: string, larkAppId?: string, dataDir?: string): Session | undefined;
+/**
+ * Fail-closed identity scan: every file's copy of one session row across the
+ * legacy and all per-bot files — one entry per file that holds the id. An
+ * unlistable data dir THROWS: a caller proving "this row resolves exactly
+ * once" must not mistake an unreadable store for an empty one. A corrupt
+ * individual file is skipped: an unrelated bot's bad file must neither block
+ * nor impersonate a valid record; the target row still has to resolve from a
+ * readable file.
+ */
+export declare function readSessionRowCopiesAcrossStores(sessionId: string, dataDir?: string): Session[];
+/**
+ * Locked offline mutation of one exact row in its owning file (per-bot when
+ * the caller-observed row carries `larkAppId`, legacy `sessions.json`
+ * otherwise). Re-reads the row under the SAME lock the owning daemon uses for
+ * every save and hands the FRESH copy to `mutate` — never publishing the
+ * caller's possibly-stale snapshot — then republishes with the daemon's own
+ * tmp+rename / mismatched-key cleanup / legacy-field strip.
+ *
+ * `abortIf` is evaluated under the lock at entry and re-evaluated immediately
+ * before publication; returning true abandons the mutation with `undefined`
+ * (callers pass a daemon-liveness probe so an owning daemon that appears
+ * mid-flight stays authoritative and the file is left untouched).
+ *
+ * Returns the fresh row — mutated when `mutate` returned true, otherwise
+ * unmodified (so `() => false` is a locked fresh read) — or undefined when
+ * the row is absent or `abortIf` aborted.
+ */
+export declare function mutateSessionRowOffline(target: {
+    sessionId: string;
+    larkAppId?: string;
+}, mutate: (current: Session) => boolean, options?: {
+    dataDir?: string;
+    abortIf?: () => boolean;
+}): Session | undefined;
 //# sourceMappingURL=session-store.d.ts.map

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

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