@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/speech/wav.js

@@ -0,0 +1,199 @@
+import { createHash } from "node:crypto";
+import { basename, resolve } from "node:path";
+import { CliError } from "@wirecat/cli-base";
+import { openOrdinaryFile } from "../files/index.js";
+const prepared = new WeakMap();
+const checkCancelled = (signal) => {
+    if (!signal?.aborted)
+        return;
+    if (signal.reason instanceof CliError)
+        throw signal.reason;
+    const timedOut = signal.reason instanceof Error && signal.reason.name === "TimeoutError";
+    throw new CliError(timedOut ? "timeout" : "cancelled", timedOut ? "command timed out" : "command cancelled");
+};
+const invalid = () => {
+    throw new CliError("validation_error", "local transcription requires PCM16 mono/stereo WAV at 16 or 48 kHz; convert the media locally to PCM WAV first");
+};
+const validate = (options) => {
+    if (!Number.isSafeInteger(options.maxBytes) ||
+        options.maxBytes < 1 ||
+        options.maxBytes > 4 * 1024 ** 3 ||
+        !Number.isSafeInteger(options.maxDurationMs) ||
+        options.maxDurationMs < 1 ||
+        options.maxDurationMs > 24 * 3600_000)
+        throw new CliError("validation_error", "audio byte and duration budgets must be positive bounded integers");
+    checkCancelled(options.signal);
+};
+const exact = async (file, offset, size, signal) => {
+    const bytes = Buffer.alloc(size);
+    let read = 0;
+    while (read < size) {
+        checkCancelled(signal);
+        const result = await file.read(bytes, read, size - read, offset + read);
+        if (!result.bytesRead)
+            throw new CliError("validation_error", "WAV changed or was truncated while reading");
+        read += result.bytesRead;
+    }
+    return bytes;
+};
+const layoutOf = async (file, size, options) => {
+    if (size < 44 || size > options.maxBytes)
+        invalid();
+    const header = await exact(file, 0, 12, options.signal);
+    if (header.toString("ascii", 0, 4) !== "RIFF" ||
+        header.toString("ascii", 8, 12) !== "WAVE" ||
+        header.readUInt32LE(4) + 8 !== size)
+        invalid();
+    let format;
+    let data;
+    let at = 12;
+    let chunks = 0;
+    while (at < size) {
+        checkCancelled(options.signal);
+        if (++chunks > 1024 || size - at < 8)
+            invalid();
+        const chunk = await exact(file, at, 8, options.signal);
+        const kind = chunk.toString("ascii", 0, 4);
+        const length = chunk.readUInt32LE(4);
+        const start = at + 8;
+        const next = start + length + (length % 2);
+        if (next > size)
+            invalid();
+        if (kind === "fmt ") {
+            if (format || ![16, 18].includes(length))
+                invalid();
+            const bytes = await exact(file, start, length, options.signal);
+            const channels = bytes.readUInt16LE(2);
+            const sampleRate = bytes.readUInt32LE(4);
+            if (bytes.readUInt16LE(0) !== 1 ||
+                ![1, 2].includes(channels) ||
+                ![16000, 48000].includes(sampleRate) ||
+                bytes.readUInt16LE(14) !== 16 ||
+                bytes.readUInt16LE(12) !== channels * 2 ||
+                bytes.readUInt32LE(8) !== sampleRate * channels * 2 ||
+                (length === 18 && bytes.readUInt16LE(16) !== 0))
+                invalid();
+            format = { sampleRate: sampleRate, channels: channels };
+        }
+        else if (kind === "data") {
+            if (data || !length)
+                invalid();
+            data = { offset: start, size: length };
+        }
+        at = next;
+    }
+    if (!format || !data || data.size % (format.channels * 2) !== 0)
+        return invalid();
+    const frames = data.size / (format.channels * 2);
+    if (Math.ceil((frames * 1000) / format.sampleRate) > options.maxDurationMs)
+        throw new CliError("validation_error", "WAV exceeds the configured duration limit");
+    return { ...format, dataOffset: data.offset, dataSize: data.size, frames };
+};
+const hashRange = async (file, hash, start, end, signal) => {
+    let at = start;
+    while (at < end) {
+        const bytes = await exact(file, at, Math.min(65536, end - at), signal);
+        hash.update(bytes);
+        at += bytes.length;
+    }
+};
+const hashFile = async (file, size, signal) => {
+    const hash = createHash("sha256");
+    await hashRange(file, hash, 0, size, signal);
+    if ((await file.stat()).size !== size)
+        throw new CliError("validation_error", "WAV changed while verifying its content");
+    return hash.digest("hex");
+};
+export const preflightWavAudio = async (path, input) => {
+    const options = { ...input };
+    validate(options);
+    if (typeof path !== "string" || !path.trim() || /\0/.test(path))
+        throw new CliError("validation_error", "local audio file is required");
+    const absolute = resolve(path);
+    const file = await openOrdinaryFile(absolute);
+    try {
+        const stat = await file.stat({ bigint: true });
+        const size = Number(stat.size);
+        const layout = await layoutOf(file, size, options);
+        const contentHash = await hashFile(file, size, options.signal);
+        const after = await file.stat({ bigint: true });
+        if (stat.size !== after.size || stat.mtimeNs !== after.mtimeNs)
+            throw new CliError("validation_error", "WAV changed while preparing the transcription");
+        const media = Object.freeze({
+            id: createHash("sha256").update(basename(absolute)).digest("hex"),
+            contentHash,
+            size,
+            durationMs: Math.ceil((layout.frames * 1000) / layout.sampleRate),
+            format: "wav",
+            sampleRate: layout.sampleRate,
+            channels: layout.channels,
+        });
+        const plan = Object.freeze({ media });
+        prepared.set(plan, { path: absolute, dev: stat.dev, ino: stat.ino, layout });
+        return plan;
+    }
+    finally {
+        await file.close();
+    }
+};
+export const openWavAudio = async (plan, input) => {
+    const options = { ...input };
+    validate(options);
+    const known = prepared.get(plan);
+    if (!known)
+        throw new CliError("validation_error", "audio plan was not prepared by this adapter");
+    const file = await openOrdinaryFile(known.path);
+    try {
+        const stat = await file.stat({ bigint: true });
+        if (stat.dev !== known.dev || stat.ino !== known.ino || Number(stat.size) !== plan.media.size)
+            throw new CliError("validation_error", "WAV identity changed before transcription");
+        const layout = await layoutOf(file, plan.media.size, options);
+        if (JSON.stringify(layout) !== JSON.stringify(known.layout) ||
+            (await hashFile(file, plan.media.size, options.signal)) !== plan.media.contentHash)
+            throw new CliError("validation_error", "WAV content changed before transcription");
+        let closed = false;
+        let consumed = false;
+        return {
+            async *windows() {
+                if (closed || consumed)
+                    throw new CliError("configuration_error", "audio source can be consumed once before closing");
+                consumed = true;
+                const hash = createHash("sha256");
+                await hashRange(file, hash, 0, layout.dataOffset, options.signal);
+                const step = layout.sampleRate / 16000;
+                for (let frame = 0; frame < layout.frames;) {
+                    checkCancelled(options.signal);
+                    const count = Math.min(layout.sampleRate * 30, layout.frames - frame);
+                    const bytes = await exact(file, layout.dataOffset + frame * layout.channels * 2, count * layout.channels * 2, options.signal);
+                    hash.update(bytes);
+                    const samples = new Float32Array(Math.floor(count / step));
+                    for (let index = 0; index < samples.length; index++) {
+                        let sum = 0;
+                        for (let offset = 0; offset < step; offset++)
+                            for (let channel = 0; channel < layout.channels; channel++)
+                                sum += bytes.readInt16LE(((index * step + offset) * layout.channels + channel) * 2);
+                        samples[index] = sum / (32768 * step * layout.channels);
+                    }
+                    const startMs = Math.floor((frame * 1000) / layout.sampleRate);
+                    frame += count;
+                    if (samples.length)
+                        yield { startMs, endMs: Math.ceil((frame * 1000) / layout.sampleRate), samples };
+                }
+                await hashRange(file, hash, layout.dataOffset + layout.dataSize, plan.media.size, options.signal);
+                if (hash.digest("hex") !== plan.media.contentHash || (await file.stat()).size !== plan.media.size)
+                    throw new CliError("validation_error", "WAV changed during recognition; no transcript may be stored");
+            },
+            async close() {
+                if (!closed) {
+                    closed = true;
+                    await file.close();
+                }
+            },
+        };
+    }
+    catch (error) {
+        await file.close();
+        throw error;
+    }
+};
+//# sourceMappingURL=wav.js.map

package/dist/speech/wav.js.map

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

package/dist/sqlite-runtime.d.ts

@@ -0,0 +1,29 @@
+import { type ChildProcess } from "node:child_process";
+export interface SqliteRuntime {
+    env: NodeJS.ProcessEnv;
+    platform: NodeJS.Platform;
+    bun: boolean;
+    maps(): string;
+    capable(): Promise<boolean>;
+    library(musl: boolean): Promise<{
+        path: string;
+        version: string;
+    } | undefined>;
+    works(env: NodeJS.ProcessEnv, version: string): boolean;
+    restart(env: NodeJS.ProcessEnv): Promise<never>;
+}
+/**
+ * Run first by `tg` and `max`, before their program is imported. A Linux distribution's Node takes
+ * the system's `libsqlite3`; when that one cannot hold the store, the command starts again on the
+ * SQLite of `@wirecat/cli-messaging-sqlite`. Restarting here, before anything is read or sent, is
+ * what makes it safe — later in the command it could repeat an action.
+ */
+export declare const ensureSqlite: (runtime?: SqliteRuntime) => Promise<void>;
+export declare const nodeRuntime: () => SqliteRuntime;
+/**
+ * The parent stays while the command runs in the child: it passes on what stops it — an MCP client
+ * or `kill <pid>` signals the process it started — and leaves with the child's code or signal. The
+ * terminal sends Ctrl-C to both, so the parent ignores SIGINT and waits.
+ */
+export declare const relay: (child: ChildProcess, host?: Pick<NodeJS.Process, "on" | "exit" | "kill" | "pid" | "removeAllListeners">) => Promise<never>;
+//# sourceMappingURL=sqlite-runtime.d.ts.map

package/dist/sqlite-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-runtime.d.ts","sourceRoot":"","sources":["../src/sqlite-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,oBAAoB,CAAA;AASxE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAA;IACzB,GAAG,EAAE,OAAO,CAAA;IACZ,IAAI,IAAI,MAAM,CAAA;IACd,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3B,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IAC9E,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IACvD,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;CAChD;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,aAAmB,aAAa,KAAmB,OAAO,CAAC,IAAI,CA4BvF,CAAA;AASD,eAAO,MAAM,WAAW,QAAO,aAiC7B,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,KAAK,UACT,YAAY,SACb,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,oBAAoB,CAAC,KAChF,OAAO,CAAC,KAAK,CAWZ,CAAA"}

package/dist/sqlite-runtime.js

@@ -0,0 +1,105 @@
+import { spawn, spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { CAPABILITY_STATEMENTS, storeCapable } from "./store/open.js";
+const RESTARTED = "CLI_MESSAGING_SQLITE_RESTARTED";
+const USER_LIBRARY_PATH = "CLI_MESSAGING_USER_LD_LIBRARY_PATH";
+const FORWARDED = ["SIGTERM", "SIGHUP", "SIGQUIT"];
+/**
+ * Run first by `tg` and `max`, before their program is imported. A Linux distribution's Node takes
+ * the system's `libsqlite3`; when that one cannot hold the store, the command starts again on the
+ * SQLite of `@wirecat/cli-messaging-sqlite`. Restarting here, before anything is read or sent, is
+ * what makes it safe — later in the command it could repeat an action.
+ */
+export const ensureSqlite = async (runtime = nodeRuntime()) => {
+    const { env } = runtime;
+    if (env[RESTARTED]) {
+        // Programs this one starts get the user's search path back, and check their own SQLite.
+        if (env[USER_LIBRARY_PATH] === undefined)
+            delete env.LD_LIBRARY_PATH;
+        else
+            env.LD_LIBRARY_PATH = env[USER_LIBRARY_PATH];
+        delete env[USER_LIBRARY_PATH];
+        delete env[RESTARTED];
+        return;
+    }
+    // Official Node builds SQLite in: nothing to swap, and nothing to pay for asking.
+    if (runtime.bun || runtime.platform !== "linux")
+        return;
+    const maps = runtime.maps();
+    if (!maps.includes("libsqlite3"))
+        return;
+    if (await runtime.capable())
+        return;
+    const library = await runtime.library(maps.includes("ld-musl"));
+    if (!library)
+        return;
+    const restarted = {
+        ...env,
+        LD_LIBRARY_PATH: [dirname(library.path), env.LD_LIBRARY_PATH].filter(Boolean).join(":"),
+        [RESTARTED]: "1",
+    };
+    if (env.LD_LIBRARY_PATH !== undefined)
+        restarted[USER_LIBRARY_PATH] = env.LD_LIBRARY_PATH;
+    // A library that does not load would crash the command before any of our code runs; the store's
+    // own check refuses with a message instead.
+    if (!runtime.works(restarted, library.version))
+        return;
+    await runtime.restart(restarted);
+};
+const trialScript = (version) => `
+  const { DatabaseSync } = await import("node:sqlite")
+  const database = new DatabaseSync(":memory:")
+  if (database.prepare("SELECT sqlite_version() AS v").get().v !== ${JSON.stringify(version)}) process.exit(1)
+  for (const statement of ${JSON.stringify(CAPABILITY_STATEMENTS)}) database.exec(statement)
+`;
+export const nodeRuntime = () => ({
+    env: process.env,
+    platform: process.platform,
+    bun: "Bun" in globalThis,
+    maps: () => {
+        try {
+            return readFileSync("/proc/self/maps", "utf8");
+        }
+        catch {
+            return "";
+        }
+    },
+    capable: () => storeCapable().then(() => true, () => false),
+    library: async (musl) => {
+        try {
+            const { libraryFor, SQLITE_VERSION } = await import("@wirecat/cli-messaging-sqlite");
+            const path = libraryFor({ musl });
+            return path === undefined ? undefined : { path, version: SQLITE_VERSION };
+        }
+        catch {
+            return undefined;
+        }
+    },
+    works: (env, version) => spawnSync(process.execPath, ["--no-warnings", "--input-type=module", "-e", trialScript(version)], {
+        env,
+        stdio: "ignore",
+        timeout: 10_000,
+    }).status === 0,
+    restart: (env) => relay(spawn(process.execPath, [...process.execArgv, ...process.argv.slice(1)], { env, stdio: "inherit" })),
+});
+/**
+ * The parent stays while the command runs in the child: it passes on what stops it — an MCP client
+ * or `kill <pid>` signals the process it started — and leaves with the child's code or signal. The
+ * terminal sends Ctrl-C to both, so the parent ignores SIGINT and waits.
+ */
+export const relay = (child, host = process) => new Promise(() => {
+    for (const signal of FORWARDED)
+        host.on(signal, () => child.kill(signal));
+    host.on("SIGINT", () => { });
+    child.on("error", () => host.exit(1));
+    child.on("exit", (code, signal) => {
+        if (signal) {
+            host.removeAllListeners(signal);
+            host.kill(host.pid, signal);
+        }
+        else
+            host.exit(code ?? 1);
+    });
+});
+//# sourceMappingURL=sqlite-runtime.js.map

package/dist/sqlite-runtime.js.map

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

package/dist/store/account-store.d.ts

@@ -0,0 +1,52 @@
+import type { Page } from "../domain/models.js";
+import type { Meeting, MeetingDetails, MeetingFilter, SearchHit } from "../meetings/index.js";
+import type { AttachmentTextEntry } from "./sqlite/attachment-texts.js";
+import type { Email, EmailFilter, EmailThread, Mailbox, MailFilter, ThreadDetails } from "./sqlite/emails.js";
+import type { AccountKey, AccountMessageFilter, MessageStore, StoredHit } from "./store.js";
+type Store = Omit<MessageStore, "forAccount">;
+/** Every store method whose first argument is the account it reads or writes. */
+declare const ACCOUNT_METHODS: readonly ["saveAccount", "saveChats", "saveMessages", "chats", "countChats", "saveMembers", "members", "saveRoster", "memberStays", "memberCounts", "profileRevisions", "trackMembers", "trackedChats", "chatsWith", "syncState", "setSyncState", "clearSyncState", "applyDelta", "claim", "release", "transcript", "keepTranscript", "keepDownloads", "fileAttachments", "attachments", "linkInputs", "senderHandles", "replaceConversations", "conversations", "conversation", "conversationOf", "conversationsOfMessages", "links", "replies", "agentAnswers", "saveAnswers", "clearAnswers", "batchStatus", "nextBatch", "chunksToEmbed", "imagesToDescribe", "saveImageChunks", "nearestImages", "vectorStatus", "clearVectors", "nearestConversations", "conversationVectors", "readiness", "unbuiltGroups", "embeddedOnlyElsewhere", "conversationState", "messages", "countMessages", "documentLinkMessages", "changes", "messagesWindow", "around", "message", "purge", "markChatsLeft", "leftChats", "markDeleted", "rankingDiscussionChats", "retention", "chatCompleteness", "savePeople", "contacts", "countContacts", "refreshRecency", "storedAccount", "accountName", "mentioning", "saveReactions", "counterStates", "updateCounterObservations", "markRange", "chatStats", "chatActivity", "senderStats", "personNames", "ranges", "chatMetadata", "saveChatMetadata", "replaceAutoTags", "privateContact", "setContactAlias", "addContactNote", "contactNote", "editContactNote", "removeContactNote", "addTags", "removeTags", "tags"];
+type Bound<F> = F extends (key: AccountKey, ...rest: infer R) => infer T ? (...rest: R) => T : never;
+type Listed = Pick<Store, (typeof ACCOUNT_METHODS)[number]>;
+/** One account's mail: the thread and email ids of another account read as nothing. */
+export interface AccountMail {
+    threads(filter?: Omit<MailFilter, "accountId">): Promise<EmailThread[]>;
+    thread(id: number): Promise<ThreadDetails | null>;
+    email(externalId: string): Promise<Email | null>;
+    emails(filter?: Omit<EmailFilter, "accountId">): Promise<Email[]>;
+    mailboxes(): Promise<Mailbox[]>;
+}
+/** One account's meetings: a meeting id of another account reads as nothing. */
+export interface AccountMeetings {
+    meetings(filter?: Omit<MeetingFilter, "accountId">): Promise<Meeting[]>;
+    meeting(id: number): Promise<MeetingDetails | null>;
+    search(query: string, filter?: Omit<MeetingFilter, "accountId">): Promise<SearchHit[]>;
+}
+/**
+ * The store with one account bound: every read and write takes the account from here, and a row id
+ * of another account is not found. A read across accounts goes to the whole store, by name.
+ */
+export type AccountStore = {
+    readonly account: AccountKey;
+} & {
+    [K in keyof Listed]: Bound<Listed[K]>;
+} & {
+    find(filter: AccountMessageFilter): Promise<Page<StoredHit>>;
+    search(query: string, options: {
+        limit: number;
+    }): Promise<Page<StoredHit>>;
+    localPathOf(attachmentPk: number): Promise<string | null>;
+    keepAttachmentText(attachmentPk: number, entry: AttachmentTextEntry): Promise<boolean>;
+    readonly mail: AccountMail;
+    readonly meetings: AccountMeetings;
+};
+/** What only the store's own tables can answer: whose an attachment row is. */
+export interface AccountOwners {
+    /** The account's row id; `undefined` until the account is stored. */
+    accountPk(): number | undefined;
+    /** The account row that holds an attachment's message, email or meeting. */
+    attachmentAccount(attachmentPk: number): number | undefined;
+}
+export declare const bindAccount: (store: MessageStore, account: AccountKey, owners: AccountOwners) => AccountStore;
+export {};
+//# sourceMappingURL=account-store.d.ts.map

package/dist/store/account-store.d.ts.map

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

package/dist/store/account-store.js

@@ -0,0 +1,166 @@
+import { CliError } from "@wirecat/cli-base";
+/** Every store method whose first argument is the account it reads or writes. */
+const ACCOUNT_METHODS = [
+    "saveAccount",
+    "saveChats",
+    "saveMessages",
+    "chats",
+    "countChats",
+    "saveMembers",
+    "members",
+    "saveRoster",
+    "memberStays",
+    "memberCounts",
+    "profileRevisions",
+    "trackMembers",
+    "trackedChats",
+    "chatsWith",
+    "syncState",
+    "setSyncState",
+    "clearSyncState",
+    "applyDelta",
+    "claim",
+    "release",
+    "transcript",
+    "keepTranscript",
+    "keepDownloads",
+    "fileAttachments",
+    "attachments",
+    "linkInputs",
+    "senderHandles",
+    "replaceConversations",
+    "conversations",
+    "conversation",
+    "conversationOf",
+    "conversationsOfMessages",
+    "links",
+    "replies",
+    "agentAnswers",
+    "saveAnswers",
+    "clearAnswers",
+    "batchStatus",
+    "nextBatch",
+    "chunksToEmbed",
+    "imagesToDescribe",
+    "saveImageChunks",
+    "nearestImages",
+    "vectorStatus",
+    "clearVectors",
+    "nearestConversations",
+    "conversationVectors",
+    "readiness",
+    "unbuiltGroups",
+    "embeddedOnlyElsewhere",
+    "conversationState",
+    "messages",
+    "countMessages",
+    "documentLinkMessages",
+    "changes",
+    "messagesWindow",
+    "around",
+    "message",
+    "purge",
+    "markChatsLeft",
+    "leftChats",
+    "markDeleted",
+    "rankingDiscussionChats",
+    "retention",
+    "chatCompleteness",
+    "savePeople",
+    "contacts",
+    "countContacts",
+    "refreshRecency",
+    "storedAccount",
+    "accountName",
+    "mentioning",
+    "saveReactions",
+    "counterStates",
+    "updateCounterObservations",
+    "markRange",
+    "chatStats",
+    "chatActivity",
+    "senderStats",
+    "personNames",
+    "ranges",
+    "chatMetadata",
+    "saveChatMetadata",
+    "replaceAutoTags",
+    "privateContact",
+    "setContactAlias",
+    "addContactNote",
+    "contactNote",
+    "editContactNote",
+    "removeContactNote",
+    "addTags",
+    "removeTags",
+    "tags",
+];
+const everyMethodListed = true;
+export const bindAccount = (store, account, owners) => {
+    void everyMethodListed;
+    const bound = {};
+    for (const name of ACCOUNT_METHODS) {
+        const method = store[name];
+        if (method)
+            bound[name] = (...rest) => method.call(store, account, ...rest);
+    }
+    const ownAttachment = (attachmentPk) => {
+        const pk = owners.accountPk();
+        if (pk === undefined || owners.attachmentAccount(attachmentPk) !== pk)
+            throw new CliError("not_found", `no attachment ${attachmentPk} in this account`);
+    };
+    const accountId = () => owners.accountPk();
+    const mail = {
+        threads: async (filter = {}) => {
+            const id = accountId();
+            return id === undefined ? [] : store.mail.threads({ ...filter, accountId: id });
+        },
+        thread: async (id) => {
+            const found = await store.mail.thread(id);
+            return found && found.thread.accountId === accountId() ? found : null;
+        },
+        email: async (externalId) => {
+            const id = accountId();
+            return id === undefined ? null : store.mail.email(id, externalId);
+        },
+        emails: async (filter = {}) => {
+            const id = accountId();
+            return id === undefined ? [] : store.mail.emails({ ...filter, accountId: id });
+        },
+        mailboxes: async () => {
+            const id = accountId();
+            return id === undefined ? [] : store.mail.mailboxes(id);
+        },
+    };
+    const meetings = {
+        meetings: async (filter = {}) => {
+            const id = accountId();
+            return id === undefined ? [] : store.meetings.meetings({ ...filter, accountId: id });
+        },
+        meeting: async (id) => {
+            const found = await store.meetings.meeting(id);
+            return found && found.meeting.accountId === accountId() ? found : null;
+        },
+        search: async (query, filter = {}) => {
+            const id = accountId();
+            return id === undefined ? [] : store.meetings.search(query, { ...filter, accountId: id });
+        },
+    };
+    return {
+        ...bound,
+        account,
+        find: (filter) => store.find({ ...filter, account }),
+        search: (query, options) => store.search(query, { ...options, account }),
+        localPathOf: async (attachmentPk) => {
+            ownAttachment(attachmentPk);
+            return store.localPathOf(attachmentPk);
+        },
+        keepAttachmentText: async (attachmentPk, entry) => {
+            ownAttachment(attachmentPk);
+            return store.keepAttachmentText(attachmentPk, entry);
+        },
+        mail,
+        meetings,
+    };
+};
+//# sourceMappingURL=account-store.js.map

package/dist/store/account-store.js.map

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

package/dist/store/driver.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The seam the two runtimes meet at.
+ *
+ * `node:sqlite` and `bun:sqlite` are different modules with different names, so a static import of
+ * either one breaks the other runtime **at load time** — before any code runs and before anything
+ * can catch it. The database is therefore handed in, the way the keyring and the clock already are
+ * (`CONVENTIONS.md`: core takes its environment as arguments).
+ *
+ * The surface is deliberately tiny. Everything above it is ordinary SQL, so replacing the driver —
+ * or adding a third — is writing thirty lines, not learning an abstraction.
+ */
+/** What SQLite itself can hold. Not `any`: a value it cannot store must fail to compile. */
+export type SqlValue = string | number | bigint | null | Uint8Array;
+export interface CacheStatement {
+    /** For writes. `changes` is how the fetch lease decides who won. */
+    run(...parameters: SqlValue[]): {
+        changes: number;
+    };
+    get(...parameters: SqlValue[]): Record<string, unknown> | undefined;
+    all(...parameters: SqlValue[]): Record<string, unknown>[];
+}
+export interface CacheDatabase {
+    exec(sql: string): void;
+    prepare(sql: string): CacheStatement;
+    close(): void;
+}
+export type OpenDatabase = (path: string) => CacheDatabase;
+/**
+ * **Write-ahead mode, and a timeout rather than an instant failure.**
+ *
+ * Without the first, one writer freezes out every reader for the length of its write, and several
+ * `max` invocations at once is the normal case here rather than the exception. Without the second,
+ * a writer that finds the database busy fails immediately instead of waiting the moment out.
+ *
+ * `foreign_keys` is off by default in SQLite, which surprises everyone once.
+ */
+export declare const PRAGMAS = "\n  PRAGMA busy_timeout = 5000;\n  PRAGMA journal_mode = WAL;\n  PRAGMA foreign_keys = ON;\n";
+//# sourceMappingURL=driver.d.ts.map

package/dist/store/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/store/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,4FAA4F;AAC5F,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,UAAU,CAAA;AAEnE,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,GAAG,CAAC,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,GAAG,CAAC,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IACnE,GAAG,CAAC,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CAC1D;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAA;IACpC,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,CAAA;AAE1D;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,iGAInB,CAAA"}