@wirecat/cli-core 0.399.0 → 0.401.0

package/dist/services/chat-documents.js

@@ -1,12 +1,18 @@
 import { googleDocumentLinks } from "../domain/google-documents.js";
-import { formatLocator } from "../domain/locator.js";
+import { formatLocator, parseLocator } from "../domain/locator.js";
 import { accountStore } from "./deps.js";
 import { chatIdIn } from "./message-resolution.js";
 export const chatDocumentsService = (deps) => ({
-    list: async (chat, { limit, offset }) => {
+    list: async (chat, { limit, offset, ref }) => {
         const store = await accountStore(deps);
         const chatId = await chatIdIn(deps.messenger, chat, store, { includeLeft: true });
-        const items = (await store.messages.documentLinkMessages(chatId)).flatMap((message) => googleDocumentLinks(message.text).map(({ url, documentId }) => {
+        const target = ref === undefined ? undefined : parseLocator(ref);
+        const sameScope = target === undefined ||
+            (target.provider === store.account.provider && target.account === store.account.account && target.chat === chatId);
+        const messages = sameScope
+            ? await store.messages.documentLinkMessages(chatId, target ? { messageId: target.message } : {})
+            : [];
+        const items = messages.flatMap((message) => googleDocumentLinks(message.text).map(({ url, documentId }) => {
             const stored = documentId === null ? undefined : message.documents.find((one) => one.fileId === documentId);
             return {
                 url,

package/dist/services/chats.d.ts

@@ -79,7 +79,7 @@ export interface ChatsService {
         track?: boolean;
     }): Promise<FetchedMembers>;
     /** The chats whose members `serve` fetches daily, from the store. */
-    tracked(): Promise<TrackedChat[]>;
+    tracked(query?: QueryAst): Promise<TrackedChat[]>;
     /** One chat's tracking and its member counts of the last `TRACKED_DAYS` days, tracked or not. */
     trackedChat(chat: string): Promise<{
         chatId: Id;

package/dist/services/chats.js

@@ -7,7 +7,7 @@ import { syncsOneChat } from "../ports/traits.js";
 import { typedCommand } from "../runs/scope.js";
 import { codeOf, guardedWrite } from "../sends/guarded.js";
 import { newOperationId } from "../sends/send-id.js";
-import { CHAT_COLUMNS, queryFilter, } from "../store/store.js";
+import { CHAT_COLUMNS, queryFilter, TRACKED_CHAT_COLUMNS, } from "../store/store.js";
 import { chatStats } from "./chat-stats.js";
 import { accountStore, accountStoreIfOpen, fromStore, nothingStored, unlessBusy } from "./deps.js";
 import { memberEvents } from "./member-history.js";
@@ -210,7 +210,10 @@ export const chatsService = (deps) => ({
         const tracked = (await store.roster.trackedChats()).some((one) => one.chatId === chatId);
         return { chatId, read: members.length, participants, complete, more, ...change, tracked };
     },
-    tracked: async () => (await accountStore(deps)).roster.trackedChats(),
+    tracked: async (query) => {
+        const where = query ? queryFilter(query, TRACKED_CHAT_COLUMNS, { command: "chats tracking list" }) : undefined;
+        return (await accountStore(deps)).roster.trackedChats(where ? { where } : {});
+    },
     memberHistory: async (chat, { since }) => {
         const store = await accountStore(deps);
         const chatId = await chatIdIn(deps.messenger, chat, store, { includeLeft: true });

package/dist/services/documents/mirrors.d.ts

@@ -0,0 +1,98 @@
+import type { DocumentTarget, Keep, PushStatePort } from "../../documents/push-model.js";
+import { type PushConflict, type PushOptions } from "./push.js";
+/** A local folder mirrored into a remote folder, as the app's profile config keeps it. */
+export interface Mirror {
+    id: string;
+    path: string;
+    folder: string;
+}
+export declare const mirrorId: (root: string, folder: string) => string;
+/**
+ * A mirror's sync state in `<dir>/<id>.json`. A missing file is a first sync; an unreadable or invalid one is
+ * refused rather than reset, since a reset would push every file again as new.
+ */
+export declare const fileMirrorState: <S>(dir: string, mirror: Mirror, principal: string, kinds: [string, ...string[]]) => PushStatePort<S>;
+/** What the next sync of each mirror would create or send, from local files and the state alone. */
+export declare const mirrorStatus: <S>(mirrors: Mirror[], kindOf: (path: string) => string | undefined, stateOf: (mirror: Mirror) => PushStatePort<S>) => Promise<{
+    id: string;
+    path: string;
+    folder: string;
+    create: string[];
+    update: string[];
+    unchanged: number;
+    orphans: string[];
+    unsupported: number;
+    remote_checked: boolean;
+}[]>;
+/** A conflict as the user reads it, with the remote side named the way the app names it (`google`). */
+export declare const conflictReport: (conflict: PushConflict, remote: string) => {
+    path: string;
+    url: string;
+    reason: string;
+    parts?: {
+        [x: string]: string;
+        last_sync: string;
+        local: string;
+    }[] | undefined;
+    local_changed_at?: string | undefined;
+};
+export interface MirrorSyncOptions<S> extends Pick<PushOptions<S>, "principal" | "recreate" | "guard" | "operationId" | "errorOf" | "signal"> {
+    mirrors: Mirror[];
+    target: DocumentTarget<S>;
+    stateOf(mirror: Mirror): PushStatePort<S>;
+    keep?: Keep;
+    /** Taken once for all the mirrors, so a second sync or a watcher's next cycle waits its turn. */
+    lock(): Promise<{
+        assertHeld(): void;
+        release(): Promise<void> | void;
+    }>;
+    /** How the app names the remote side in conflict reports. */
+    remote: string;
+}
+/**
+ * Syncs each mirror both ways. A mirror with conflicts, missing remote files or errors does not stop the others;
+ * it gets one `mirror.partial` issue, so the caller can answer `complete: false` and fail after printing.
+ */
+export declare const syncMirrors: <S>(options: MirrorSyncOptions<S>) => Promise<{
+    items: {
+        created: string[];
+        updated: string[];
+        pulled: string[];
+        unchanged: number;
+        missing: string[];
+        orphans: {
+            path: string;
+            url: string;
+        }[];
+        errors: {
+            path: string;
+            code: string;
+            message: string;
+        }[];
+        unsupported: number;
+        plan?: {
+            create: string[];
+            update: string[];
+            orphans: string[];
+        };
+        stopped?: true;
+        id: string;
+        path: string;
+        conflicts: {
+            path: string;
+            url: string;
+            reason: string;
+            parts?: {
+                [x: string]: string;
+                last_sync: string;
+                local: string;
+            }[] | undefined;
+            local_changed_at?: string | undefined;
+        }[];
+    }[];
+    issues: {
+        code: "provider_error";
+        reason: string;
+        source: string;
+    }[];
+}>;

package/dist/services/documents/mirrors.js

@@ -0,0 +1,144 @@
+import { createHash } from "node:crypto";
+import { mkdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, writeSecurely } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { planPush, pushDocuments, scanLocal } from "./push.js";
+export const mirrorId = (root, folder) => createHash("sha256")
+    .update(JSON.stringify([root, folder]))
+    .digest("hex")
+    .slice(0, 8);
+const ID = v.pipe(v.string(), v.regex(/^[A-Za-z0-9_-]{1,200}$/));
+const stateSchema = (kinds) => v.object({
+    version: v.literal(1),
+    principal: v.string(),
+    root: v.string(),
+    target: ID,
+    folders: v.record(v.string(), ID),
+    entries: v.record(v.string(), v.object({
+        id: ID,
+        url: v.string(),
+        kind: v.string(),
+        hash: v.string(),
+        // Checked by kind only: the rest is the provider's own read-back.
+        snapshot: v.looseObject({ kind: v.picklist(kinds) }),
+        pushedAt: v.string(),
+    })),
+    pending: v.record(v.string(), v.object({ origin: v.string(), operationId: v.string() })),
+});
+/**
+ * A mirror's sync state in `<dir>/<id>.json`. A missing file is a first sync; an unreadable or invalid one is
+ * refused rather than reset, since a reset would push every file again as new.
+ */
+export const fileMirrorState = (dir, mirror, principal, kinds) => {
+    const path = join(dir, `${mirror.id}.json`);
+    const schema = stateSchema(kinds);
+    return {
+        read: () => {
+            let value;
+            try {
+                value = JSON.parse(readFileSync(path, "utf8"));
+            }
+            catch (error) {
+                if (error.code === "ENOENT")
+                    return {
+                        version: 1,
+                        principal,
+                        root: mirror.path,
+                        target: mirror.folder,
+                        folders: {},
+                        entries: {},
+                        pending: {},
+                    };
+                throw new CliError("configuration_error", "mirror state is unreadable; refusing to reset it", {
+                    reason: "state.invalid",
+                });
+            }
+            const parsed = v.safeParse(schema, value);
+            if (!parsed.success)
+                throw new CliError("configuration_error", "mirror state is invalid; refusing to reset it", {
+                    reason: "state.invalid",
+                });
+            return parsed.output;
+        },
+        save: (state) => {
+            mkdirSync(dir, { recursive: true, mode: 0o700 });
+            writeSecurely(path, `${JSON.stringify(state)}\n`, 0o600);
+        },
+    };
+};
+/** What the next sync of each mirror would create or send, from local files and the state alone. */
+export const mirrorStatus = async (mirrors, kindOf, stateOf) => {
+    const items = [];
+    for (const mirror of mirrors) {
+        const { files, unsupported } = await scanLocal(mirror.path, kindOf);
+        const plan = planPush(files, stateOf(mirror).read());
+        items.push({
+            id: mirror.id,
+            path: mirror.path,
+            folder: mirror.folder,
+            create: plan.create.map((file) => file.path),
+            update: plan.update.map((file) => file.path),
+            unchanged: plan.unchanged.length,
+            orphans: plan.orphans,
+            unsupported,
+            remote_checked: false,
+        });
+    }
+    return items;
+};
+/** A conflict as the user reads it, with the remote side named the way the app names it (`google`). */
+export const conflictReport = (conflict, remote) => ({
+    path: conflict.path,
+    url: conflict.url,
+    reason: conflict.reason,
+    ...(conflict.parts
+        ? { parts: conflict.parts.map((part) => ({ last_sync: part.base, local: part.local, [remote]: part.remote })) }
+        : {}),
+    ...(conflict.localChangedAt ? { local_changed_at: conflict.localChangedAt } : {}),
+    ...(conflict.remoteChangedAt ? { [`${remote}_changed_at`]: conflict.remoteChangedAt } : {}),
+    ...(conflict.remoteChangedBy ? { [`${remote}_changed_by`]: conflict.remoteChangedBy } : {}),
+});
+/**
+ * Syncs each mirror both ways. A mirror with conflicts, missing remote files or errors does not stop the others;
+ * it gets one `mirror.partial` issue, so the caller can answer `complete: false` and fail after printing.
+ */
+export const syncMirrors = async (options) => {
+    const { mirrors, keep, remote } = options;
+    const lock = await options.lock();
+    const results = [];
+    try {
+        for (const mirror of mirrors)
+            results.push({
+                id: mirror.id,
+                path: mirror.path,
+                ...(await pushDocuments({
+                    root: mirror.path,
+                    folder: mirror.folder,
+                    target: options.target,
+                    state: options.stateOf(mirror),
+                    principal: options.principal,
+                    ...(keep ? { keep } : {}),
+                    recreate: options.recreate === true,
+                    guard: options.guard,
+                    operationId: options.operationId,
+                    errorOf: options.errorOf,
+                    assertHeld: () => lock.assertHeld(),
+                    ...(options.signal ? { signal: options.signal } : {}),
+                })),
+            });
+    }
+    finally {
+        await lock.release();
+    }
+    const issues = results
+        .filter((result) => result.errors.length || result.conflicts.length || result.missing.length)
+        .map((result) => ({ code: "provider_error", reason: "mirror.partial", source: `mirror ${result.id}` }));
+    return {
+        items: results.map(({ conflicts, ...result }) => ({
+            ...result,
+            conflicts: conflicts.map((conflict) => conflictReport(conflict, remote)),
+        })),
+        issues,
+    };
+};

package/dist/services/meeting-links.d.ts

@@ -1,22 +1,7 @@
-import type { MeetingChatLinesInput, MeetingHitSearchRequest } from "../meetings/index.js";
+import type { MeetingChatLinesInput, MeetingHitSearchRequest, MeetingLink } from "../meetings/index.js";
 import type { MessageStore } from "../store/store.js";
+export type { MeetingLink };
 export type MeetingLinksRequest = Omit<MeetingHitSearchRequest, "limit" | "after" | "maxReadBytes"> & Pick<MeetingChatLinesInput, "maxMessages">;
-/** One link as the meetings' chat holds it: where and how often it was shared. */
-export interface MeetingLink {
-    url: string;
-    domain: string | null;
-    /** The Google Docs, Sheets, Slides, Forms or Drive file it names. */
-    documentId: string | null;
-    count: number;
-    firstAt: number;
-    lastAt: number;
-    senders: string[];
-    meetings: {
-        meetingId: number;
-        accountId: number;
-        title: string | null;
-    }[];
-}
 /** Links shared in the chat of the selected meetings, most shared first; found when read, not stored. */
 export declare const readMeetingLinks: (store: Pick<MessageStore, "meetings"> & {
     knowledge?: MessageStore["knowledge"];

package/dist/services/messages.js

@@ -283,6 +283,7 @@ export const messagesService = (deps) => {
                 sendId: id,
                 operationId: id,
                 length: text.length,
+                ...(attachments.length > 1 ? { count: attachments.length } : {}),
                 ...(replyTo === undefined ? {} : { replyTo }),
                 ...(threadId === undefined ? {} : { threadId }),
                 ...(sendAs === undefined ? {} : { sendAs }),

package/dist/services/search-all-meetings.js

@@ -4,6 +4,7 @@ import { formatMeetingReference } from "../meetings/index.js";
 import { entriesOfList, fitting } from "../search/account-list.js";
 import { SEARCH_QUERY } from "../search/lucene/types.js";
 import { codeOf } from "../sends/guarded.js";
+import { MAX_SEARCH_OFFSET } from "./messages-archive-search.js";
 import { RRF_K } from "./notes-search.js";
 import { RESOURCES_SEARCHED, searchAll, } from "./search-all.js";
 import { listContextOf } from "./search-kind.js";
@@ -139,26 +140,35 @@ export const searchAllIncludingMeetings = async (store, account, request, messen
         whole(request.meetingCursor.hitOffset, 0, Number.MAX_SAFE_INTEGER, "cursor hit offset");
     }
     cancelled(request.signal);
-    const legacy = await searchAll(store, account, { ...request, only: only.filter((one) => one !== "meetings") }, messenger, searchMessages);
+    const others = { ...request, only: only.filter((one) => one !== "meetings") };
+    if (!only.includes("meetings")) {
+        const found = await searchAll(store, account, others, messenger, searchMessages);
+        cancelled(request.signal);
+        return found;
+    }
+    // Meetings rank with the rest, so a later page is the same merge read deeper, then cut.
+    const offset = request.offset ?? 0;
+    const window = offset + request.limit;
+    const legacy = await searchAll(store, account, { ...others, offset: 0, limit: window }, messenger, searchMessages);
     cancelled(request.signal);
-    if (!only.includes("meetings"))
-        return legacy;
     const compiled = meetingQuery(request.text, request.exact);
     if ("reason" in compiled)
         return {
             ...legacy,
+            items: legacy.items.slice(offset),
             skipped: [...legacy.skipped, { resource: "meetings", code: "validation_error", reason: compiled.reason }],
         };
     let meetings;
     const meetingAccount = request.meetingAccount ?? account;
     try {
-        meetings = await collectMeetings(store, meetingAccount, request, compiled.query);
+        meetings = await collectMeetings(store, meetingAccount, { ...request, limit: window }, compiled.query);
     }
     catch (error) {
         if (codeOf(error) !== "not_found")
             throw error;
         return {
             ...legacy,
+            items: legacy.items.slice(offset),
             skipped: [
                 ...legacy.skipped,
                 { resource: "meetings", code: "not_found", reason: "the selected meeting account is not stored" },
@@ -176,13 +186,16 @@ export const searchAllIncludingMeetings = async (store, account, request, messen
             ranked.set(key, held);
         });
     const ordered = [...ranked.values()].sort((a, b) => b.score - a.score).map(({ item }) => item);
-    const items = ordered.slice(0, request.limit);
-    const returnedMeetings = items.filter((item) => item.kind === "meeting").length;
+    const items = ordered.slice(offset, window);
+    const returnedMeetings = ordered.slice(0, window).filter((item) => item.kind === "meeting").length;
     const nextCursor = meetings.items[returnedMeetings]?.before ?? (!meetings.coverage.complete ? meetings.after : undefined);
+    const more = legacy.hasMore || ordered.length > window;
+    const { nextOffset: _, ...rest } = legacy;
     return {
-        ...legacy,
+        ...rest,
         items,
-        hasMore: legacy.hasMore || ordered.length > request.limit ? true : meetings.coverage.complete ? false : null,
+        hasMore: more ? true : meetings.coverage.complete ? false : null,
+        ...(more && window <= MAX_SEARCH_OFFSET ? { nextOffset: window } : {}),
         searched: [...legacy.searched, "meetings"],
         accounts: [
             ...legacy.accounts,

package/dist/services/task-rules.d.ts

@@ -5,7 +5,7 @@ import { type TaskCategory } from "./task-categories.js";
 export interface RuleResult {
     added: number;
     closed: number;
-    /** Opened tasks that may be the same job as another: on the review list (`tasks duplicates`). */
+    /** Opened tasks that may be the same job as another: on the review list (`tasks duplicates list`). */
     review: number;
     /** Tasks the rules found but did not open: over the per-chat limit, or a dry run. */
     held?: number;

package/dist/services/tasks.d.ts

@@ -26,7 +26,7 @@ export declare const TASK_QUERY: {
     readonly backend: "sql";
     readonly fields: import("@wirecat/cli-base/query").FieldSpec[];
 };
-/** Which pairs `tasks duplicates` lists: those waiting for the reviewing agent, or those it left to the owner. */
+/** Which pairs `tasks duplicates list` lists: those waiting for the reviewing agent, or those it left to the owner. */
 export declare const PAIR_DECISIONS: readonly ["review", "unsure"];
 export type PairDecision = (typeof PAIR_DECISIONS)[number];
 export declare const TASK_PAIR_QUERY: {
@@ -168,7 +168,7 @@ export interface TasksService {
     /**
      * Links a task to stored things (`msg:`, `chat:`, `person:`, `document:`…) or, for what the store does
      * not hold, to the text as written — a URL, a message not saved yet. After a `msg:` target, `review` counts the
-     * pairs the duplicate check sent to `tasks duplicates`.
+     * pairs the duplicate check sent to `tasks duplicates list`.
      */
     link(id: string, targets: {
         references?: readonly string[];

package/dist/services/tasks.js

@@ -49,7 +49,7 @@ export const TASK_QUERY = {
         },
     }),
 };
-/** Which pairs `tasks duplicates` lists: those waiting for the reviewing agent, or those it left to the owner. */
+/** Which pairs `tasks duplicates list` lists: those waiting for the reviewing agent, or those it left to the owner. */
 export const PAIR_DECISIONS = ["review", "unsure"];
 export const TASK_PAIR_QUERY = {
     entity: "task_pair",

package/dist/store/exports.d.ts

@@ -17,7 +17,7 @@ export type { AdminStoreRequest, AdminStoreResult } from "./sqlite/admin-statist
 export { type AttachmentTextEntry, type AttachmentView, attachmentColumns, type FileAttachment, resetAttachmentWords, type TextOrigin, } from "./sqlite/attachment-texts.js";
 export { pendingNormalization } from "./sqlite/backfill.js";
 export type { ChatRekey, ChatRekeys } from "./sqlite/chat-rekey.js";
-export { CHAT_COLUMNS, titlePart } from "./sqlite/chats.js";
+export { CHAT_COLUMNS, TRACKED_CHAT_COLUMNS, titlePart } from "./sqlite/chats.js";
 export { CHAT_LIST_KEY, type ChatCompleteness, fetchedKey, historyStartKey } from "./sqlite/completeness.js";
 export { CONVERSATION_COLUMNS } from "./sqlite/conversations.js";
 export type { CounterTarget } from "./sqlite/counters.js";

package/dist/store/exports.js

@@ -1,7 +1,7 @@
 export { accountGroupsOf } from "./sqlite/account-groups.js";
 export { attachmentColumns, resetAttachmentWords, } from "./sqlite/attachment-texts.js";
 export { pendingNormalization } from "./sqlite/backfill.js";
-export { CHAT_COLUMNS, titlePart } from "./sqlite/chats.js";
+export { CHAT_COLUMNS, TRACKED_CHAT_COLUMNS, titlePart } from "./sqlite/chats.js";
 export { CHAT_LIST_KEY, fetchedKey, historyStartKey } from "./sqlite/completeness.js";
 export { CONVERSATION_COLUMNS } from "./sqlite/conversations.js";
 export { messageOfEmail, threadConversation } from "./sqlite/emails.js";

package/dist/store/messages.d.ts

@@ -128,7 +128,9 @@ export interface AccountMessages {
     /** Keeps a finished transcript; an empty one is not kept, so the message is heard again. */
     keepTranscript(key: AccountKey, chatId: Id, messageId: Id, text: string, source: string): Promise<void>;
     /** The chat's messages that may hold a Google document link, newest first, with the documents linked from each. */
-    documentLinkMessages(key: AccountKey, chatId: Id): Promise<DocumentLinkMessage[]>;
+    documentLinkMessages(key: AccountKey, chatId: Id, options?: {
+        messageId?: Id;
+    }): Promise<DocumentLinkMessage[]>;
     /** Messages of the account that name this person, newest first. */
     mentioning(key: AccountKey, person: {
         id: Id;

package/dist/store/messages.js

@@ -123,9 +123,9 @@ export const accountMessagesOver = (context) => {
                 return;
             write(database, () => transcripts.keepTranscript(context, chatPkFor(accountPk(key), chatId), messageId, text, source));
         },
-        documentLinkMessages: async (key, chatId) => {
+        documentLinkMessages: async (key, chatId, { messageId } = {}) => {
             const chatKey = chatKeyOf(key, chatId);
-            return chatKey === undefined ? [] : documentLinkMessages(context, chatKey);
+            return chatKey === undefined ? [] : documentLinkMessages(context, chatKey, messageId);
         },
         mentioning: async (key, person, limit) => {
             const accountKey = findAccountPk(key);

package/dist/store/roster.d.ts

@@ -1,6 +1,7 @@
 import type { ChatEvent, Id, Member } from "../domain/models.js";
 import type { RetentionOptions } from "../domain/retention.js";
 import type { StoreContext } from "./sqlite/open.js";
+import type { Where } from "./sqlite/query-filter.js";
 import { type RetentionResult } from "./sqlite/retention.js";
 import type { MemberCount, MemberStay, ProfileRevision, RosterChange, RosterRead, TrackedChat } from "./sqlite/roster.js";
 import type { AccountKey } from "./types.js";
@@ -35,7 +36,9 @@ export interface RosterStore {
     }): Promise<ChatEvent[]>;
     /** Starts or stops `serve`'s daily fetch of the chat's members; history already kept stays. */
     trackMembers(key: AccountKey, chatId: Id, tracked: boolean): Promise<void>;
-    trackedChats(key: AccountKey): Promise<TrackedChat[]>;
+    trackedChats(key: AccountKey, options?: {
+        where?: Where;
+    }): Promise<TrackedChat[]>;
     retention(key: AccountKey, chatId: Id, options: RetentionOptions, evidence?: {
         cohort: string;
         cursor?: string;

package/dist/store/roster.js

@@ -52,9 +52,9 @@ export const rosterStoreOver = (context) => {
                 }));
         },
         trackMembers: async (key, chatId, tracked) => write(database, () => roster.setTracked(context, chatPkFor(accountPk(key), chatId), tracked)),
-        trackedChats: async (key) => {
+        trackedChats: async (key, { where } = {}) => {
             const accountKey = findAccountPk(key);
-            return accountKey === undefined ? [] : roster.trackedChats(context, accountKey);
+            return accountKey === undefined ? [] : roster.trackedChats(context, accountKey, where);
         },
         retention: async (key, chatId, options, evidence) => {
             const accountKey = findAccountPk(key);

package/dist/store/sqlite/chats.d.ts

@@ -94,6 +94,18 @@ export declare const CHAT_COLUMNS: {
         readonly sql: "chats.participants_count";
     };
 };
+export declare const TRACKED_CHAT_COLUMNS: {
+    readonly chat_id: {
+        readonly type: "kw";
+        readonly sql: "chats.external_id";
+    };
+    readonly title: {
+        readonly where: (node: import("@wirecat/cli-base/query").Predicate) => {
+            sql: string;
+            params: string[];
+        };
+    };
+};
 /** `title:*book*` and `title:book` ask the same: the title holds "book". */
 export declare const titlePart: (value: string) => string;
 export declare const listChats: ({ orm, now }: StoreContext, accountKey: number, { limit, offset, ...filter }: {

package/dist/store/sqlite/chats.js

@@ -340,6 +340,7 @@ export const CHAT_COLUMNS = {
     last_message_at: { type: "time", sql: "chats.last_message_at" },
     participants_count: { type: "num", sql: "chats.participants_count" },
 };
+export const TRACKED_CHAT_COLUMNS = { chat_id: CHAT_COLUMNS.id, title: CHAT_COLUMNS.title };
 /** `title:*book*` and `title:book` ask the same: the title holds "book". */
 export const titlePart = (value) => value.replace(/^\*+|\*+$/g, "").trim();
 export const listChats = ({ orm, now }, accountKey, { limit, offset = 0, ...filter }) => {

package/dist/store/sqlite/document-links.d.ts

@@ -14,4 +14,4 @@ export interface DocumentLinkMessage {
     }[];
 }
 /** Newest first. Read from the text, so an edit that removed a link drops it whatever link rows remain. */
-export declare const documentLinkMessages: ({ database }: StoreContext, chatKey: number) => DocumentLinkMessage[];
+export declare const documentLinkMessages: ({ database }: StoreContext, chatKey: number, messageId?: Id) => DocumentLinkMessage[];

package/dist/store/sqlite/document-links.js

@@ -1,13 +1,13 @@
 import { linkKind } from "./link-kinds.js";
 /** Newest first. Read from the text, so an edit that removed a link drops it whatever link rows remain. */
-export const documentLinkMessages = ({ database }, chatKey) => {
-    const rows = database
-        .prepare("SELECT m.id, m.external_id, m.text, m.sent_at, m.sender_name, " +
+export const documentLinkMessages = ({ database }, chatKey, messageId) => {
+    const read = database.prepare("SELECT m.id, m.external_id, m.text, m.sent_at, m.sender_name, " +
         "coalesce(m.sender_chat_external_id, i.external_id) AS sender_id FROM messages m " +
         "LEFT JOIN identities i ON i.id = m.sender_identity_id " +
         "WHERE m.chat_id = ? AND m.deleted_at IS NULL AND (m.text LIKE '%google.com%' OR m.text LIKE '%forms.gle%') " +
-        "ORDER BY m.sent_at DESC, m.id DESC")
-        .all(chatKey);
+        (messageId === undefined ? "" : "AND m.external_id = ? ") +
+        "ORDER BY m.sent_at DESC, m.id DESC");
+    const rows = messageId === undefined ? read.all(chatKey) : read.all(chatKey, messageId);
     const linked = database.prepare("SELECT json_extract(d.front_matter, '$.fileId') AS file_id, d.title FROM links l " +
         "JOIN documents d ON d.id = l.to_id AND d.deleted_at IS NULL " +
         `WHERE l.from_type = 'message' AND l.from_id = ? AND l.to_type = 'document' AND l.kind = ${linkKind("links-to")}`);

package/dist/store/sqlite/drizzle/bun.js

@@ -10,9 +10,9 @@ import {
   entityKind,
   jitCompatCheck,
   sql
-} from "./shared-O7CTKP45.js";
+} from "./shared-HKXF6HKX.js";
 
-// node_modules/.pnpm/drizzle-orm@1.0.0-rc.4_valibot@1.5.0_typescript@7.0.2__zod@4.6.5/node_modules/drizzle-orm/bun-sqlite/session.js
+// node_modules/.pnpm/drizzle-orm@1.0.0-rc.4_valibot@1.5.0_typescript@7.0.2__zod@4.6.7/node_modules/drizzle-orm/bun-sqlite/session.js
 var SQLiteBunSession = class extends SQLiteAsyncSession {
   static [entityKind] = "SQLiteBunSession";
   logger;
@@ -76,7 +76,7 @@ var SQLiteBunTransaction = class SQLiteBunTransaction2 extends SQLiteAsyncTransa
   }
 };
 
-// node_modules/.pnpm/drizzle-orm@1.0.0-rc.4_valibot@1.5.0_typescript@7.0.2__zod@4.6.5/node_modules/drizzle-orm/bun-sqlite/driver.js
+// node_modules/.pnpm/drizzle-orm@1.0.0-rc.4_valibot@1.5.0_typescript@7.0.2__zod@4.6.7/node_modules/drizzle-orm/bun-sqlite/driver.js
 import { Database } from "bun:sqlite";
 var SQLiteBunDatabase = class extends SQLiteAsyncDatabase {
   static [entityKind] = "SQLiteBunDatabase";

package/dist/store/sqlite/drizzle/bun.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../../../node_modules/.pnpm/drizzle-orm@1.0.0-rc.4_valibot@1.5.0_typescript@7.0.2__zod@4.6.5/node_modules/src/bun-sqlite/session.ts", "../../../../node_modules/.pnpm/drizzle-orm@1.0.0-rc.4_valibot@1.5.0_typescript@7.0.2__zod@4.6.5/node_modules/src/bun-sqlite/driver.ts"],
+  "sources": ["../../../../node_modules/.pnpm/drizzle-orm@1.0.0-rc.4_valibot@1.5.0_typescript@7.0.2__zod@4.6.7/node_modules/src/bun-sqlite/session.ts", "../../../../node_modules/.pnpm/drizzle-orm@1.0.0-rc.4_valibot@1.5.0_typescript@7.0.2__zod@4.6.7/node_modules/src/bun-sqlite/driver.ts"],
   "sourcesContent": ["/// <reference types=\"bun-types\" />\n\nimport type { Changes, Database } from 'bun:sqlite';\nimport { entityKind } from '~/entity.ts';\nimport { DrizzleQueryError } from '~/errors.ts';\nimport type { Logger } from '~/logger.ts';\nimport { NoopLogger } from '~/logger.ts';\nimport type { AnyRelations } from '~/relations.ts';\nimport { type Query, sql } from '~/sql/sql.ts';\nimport {\n\tSQLiteAsyncPreparedQuery,\n\ttype SQLiteAsyncPreparedQueryConfig as PreparedQueryConfigBase,\n\tSQLiteAsyncSession,\n\tSQLiteAsyncTransaction,\n\ttype SQLiteQueryExecutors,\n} from '~/sqlite-core/async/session.ts';\nimport type { SQLiteDialect } from '~/sqlite-core/dialect.ts';\nimport type { SQLiteExecuteMethod, SQLiteTransactionConfig } from '~/sqlite-core/session.ts';\nimport type { DrizzleTypeError } from '~/utils.ts';\n\nexport interface SQLiteBunSessionOptions {\n\tlogger?: Logger;\n\tcache?: Cache;\n}\n\nexport type SQLiteBunRunResult = Changes;\n\ntype PreparedQueryConfig = Omit<PreparedQueryConfigBase, 'statement' | 'run'>;\n\nexport class SQLiteBunSession<TRelations extends AnyRelations>\n\textends SQLiteAsyncSession<'sync', SQLiteBunRunResult, TRelations>\n{\n\tstatic override readonly [entityKind]: string = 'SQLiteBunSession';\n\n\tprivate logger: Logger;\n\n\tconstructor(\n\t\tprivate client: Database,\n\t\tdialect: SQLiteDialect,\n\t\tprivate relations: TRelations,\n\t\tprivate options: SQLiteBunSessionOptions = {},\n\t) {\n\t\tsuper(dialect, 'sync');\n\t\tthis.logger = options.logger ?? new NoopLogger();\n\t}\n\n\texec(query: string): void {\n\t\tthis.client.exec(query);\n\t}\n\n\tprepareQuery<T extends Omit<PreparedQueryConfig, 'run'>>(\n\t\tquery: Query,\n\t\tmode: 'arrays' | 'objects' | 'raw',\n\t\t_prepare: boolean,\n\t\texecuteMethod?: SQLiteExecuteMethod,\n\t\tmapper?: (rows: any[]) => any,\n\t\tqueryMetadata?: {\n\t\t\ttype: 'select' | 'update' | 'delete' | 'insert';\n\t\t\ttables: string[];\n\t\t},\n\t): SQLiteAsyncPreparedQuery<T & { run: SQLiteBunRunResult }> {\n\t\tlet stmt: ReturnType<typeof this.client.query>;\n\t\ttry {\n\t\t\tstmt = this.client.query(query.sql);\n\t\t} catch (e) {\n\t\t\tthrow new DrizzleQueryError(query.sql, query.params, e as Error);\n\t\t}\n\t\tconst executors: SQLiteQueryExecutors<'sync'> = {\n\t\t\tall: (params) => {\n\t\t\t\tif (mode === 'arrays') return stmt.values(...params as any[]);\n\t\t\t\treturn stmt.all(...params as any[]);\n\t\t\t},\n\t\t\tget: (params) => {\n\t\t\t\tif (mode === 'arrays') return stmt.values(...params as any[])[0];\n\t\t\t\treturn stmt.get(...params as any[]);\n\t\t\t},\n\t\t\trun: (params) => {\n\t\t\t\treturn stmt.run(...params as any[]);\n\t\t\t},\n\t\t\tvalues: (params) => {\n\t\t\t\treturn stmt.values(...params as any[]);\n\t\t\t},\n\t\t};\n\n\t\treturn new SQLiteAsyncPreparedQuery(\n\t\t\t'sync',\n\t\t\texecuteMethod,\n\t\t\texecutors,\n\t\t\tquery,\n\t\t\tmapper,\n\t\t\tmode,\n\t\t\tthis.logger,\n\t\t\tundefined,\n\t\t\tqueryMetadata,\n\t\t\tundefined,\n\t\t);\n\t}\n\n\toverride transaction<T>(\n\t\ttransaction: (tx: SQLiteBunTransaction<TRelations>) => T,\n\t\tconfig: SQLiteTransactionConfig = {},\n\t): T {\n\t\tconst tx = new SQLiteBunTransaction('sync', this.dialect, this, this.relations);\n\t\tlet result: T | undefined;\n\t\tconst nativeTx = this.client.transaction(() => {\n\t\t\tresult = transaction(tx);\n\t\t});\n\t\tnativeTx[config.behavior ?? 'deferred']();\n\t\treturn result!;\n\t}\n}\n\nexport class SQLiteBunTransaction<\n\tTRelations extends AnyRelations,\n> extends SQLiteAsyncTransaction<'sync', SQLiteBunRunResult, TRelations> {\n\tstatic override readonly [entityKind]: string = 'SQLiteBunTransaction';\n\n\toverride transaction<T>(\n\t\ttransaction: (\n\t\t\ttx: SQLiteBunTransaction<TRelations>,\n\t\t) => T extends Promise<any> ? DrizzleTypeError<\"Sync drivers can't use async functions in transactions!\">\n\t\t\t: T,\n\t): T {\n\t\tconst savepointName = `sp${this.nestedIndex}`;\n\t\tconst tx = new SQLiteBunTransaction(\n\t\t\t'sync',\n\t\t\tthis.dialect,\n\t\t\tthis.session,\n\t\t\tthis._.relations,\n\t\t\tthis.nestedIndex + 1,\n\t\t);\n\t\tthis.session.run(sql.raw(`savepoint ${savepointName}`));\n\t\ttry {\n\t\t\tconst result = transaction(tx);\n\t\t\tthis.session.run(sql.raw(`release savepoint ${savepointName}`));\n\t\t\treturn result as T;\n\t\t} catch (err) {\n\t\t\tthis.session.run(sql.raw(`rollback to savepoint ${savepointName}`));\n\t\t\tthrow err;\n\t\t}\n\t}\n}\n", "/// <reference types=\"bun-types\" />\n\nimport { Database } from 'bun:sqlite';\nimport { entityKind } from '~/entity.ts';\nimport { DefaultLogger } from '~/logger.ts';\nimport type { AnyRelations, EmptyRelations } from '~/relations.ts';\nimport { SQLiteAsyncDatabase } from '~/sqlite-core/async/db.ts';\nimport { SQLiteDialect } from '~/sqlite-core/dialect.ts';\nimport type { DrizzleSQLiteConfig } from '~/sqlite-core/utils.ts';\nimport { jitCompatCheck } from '~/utils.ts';\nimport { type SQLiteBunRunResult, SQLiteBunSession } from './session.ts';\n\nexport class SQLiteBunDatabase<\n\tTRelations extends AnyRelations = EmptyRelations,\n> extends SQLiteAsyncDatabase<'sync', SQLiteBunRunResult, TRelations> {\n\tstatic override readonly [entityKind]: string = 'SQLiteBunDatabase';\n}\n\ntype DrizzleSqliteBunDatabaseOptions = {\n\t/**\n\t * Open the database as read-only (no write operations, no create).\n\t *\n\t * Equivalent to {@link constants.SQLITE_OPEN_READONLY}\n\t */\n\treadonly?: boolean;\n\t/**\n\t * Allow creating a new database\n\t *\n\t * Equivalent to {@link constants.SQLITE_OPEN_CREATE}\n\t */\n\tcreate?: boolean;\n\t/**\n\t * Open the database as read-write\n\t *\n\t * Equivalent to {@link constants.SQLITE_OPEN_READWRITE}\n\t */\n\treadwrite?: boolean;\n};\n\nexport type DrizzleBunSqliteDatabaseConfig =\n\t| ({\n\t\tsource?: string;\n\t} & DrizzleSqliteBunDatabaseOptions)\n\t| string\n\t| undefined;\n\nfunction construct<\n\tTRelations extends AnyRelations = EmptyRelations,\n>(\n\tclient: Database,\n\tconfig: DrizzleSQLiteConfig<TRelations> = {},\n): SQLiteBunDatabase<TRelations> & {\n\t$client: Database;\n} {\n\tconst dialect = new SQLiteDialect({\n\t\tuseJitMappers: jitCompatCheck(config.jit),\n\t});\n\tlet logger;\n\tif (config.logger === true) {\n\t\tlogger = new DefaultLogger();\n\t} else if (config.logger !== false) {\n\t\tlogger = config.logger;\n\t}\n\n\tconst relations = config.relations ?? {} as TRelations;\n\tconst session = new SQLiteBunSession<TRelations>(\n\t\tclient,\n\t\tdialect,\n\t\trelations,\n\t\t{\n\t\t\tlogger,\n\t\t},\n\t);\n\tconst db = new SQLiteBunDatabase('sync', dialect, session, relations);\n\t(<any> db).$client = client;\n\n\treturn db as any;\n}\n\nexport function drizzle<\n\tTRelations extends AnyRelations = EmptyRelations,\n\tTClient extends Database = Database,\n>(\n\t...params:\n\t\t| []\n\t\t| [\n\t\t\tstring,\n\t\t]\n\t\t| [\n\t\t\tstring,\n\t\t\tDrizzleSQLiteConfig<TRelations>,\n\t\t]\n\t\t| [\n\t\t\t(\n\t\t\t\t& DrizzleSQLiteConfig<TRelations>\n\t\t\t\t& ({\n\t\t\t\t\tconnection?: DrizzleBunSqliteDatabaseConfig;\n\t\t\t\t} | {\n\t\t\t\t\tclient: TClient;\n\t\t\t\t})\n\t\t\t),\n\t\t]\n): SQLiteBunDatabase<TRelations> & {\n\t$client: TClient;\n} {\n\tif (params[0] === undefined || typeof params[0] === 'string') {\n\t\tconst instance = params[0] === undefined ? new Database() : new Database(params[0]);\n\n\t\treturn construct(instance, params[1]) as any;\n\t}\n\n\tconst { connection, client, ...DrizzleSQLiteConfig } = params[0] as\n\t\t& ({\n\t\t\tconnection?: DrizzleBunSqliteDatabaseConfig | string;\n\t\t\tclient?: TClient;\n\t\t})\n\t\t& DrizzleSQLiteConfig<TRelations>;\n\n\tif (client) return construct(client, DrizzleSQLiteConfig) as any;\n\n\tif (typeof connection === 'object') {\n\t\tconst { source, ...opts } = connection;\n\n\t\tconst options = Object.values(opts).filter((v) => v !== undefined).length ? opts : undefined;\n\n\t\tconst instance = new Database(source, options);\n\n\t\treturn construct(instance, DrizzleSQLiteConfig) as any;\n\t}\n\n\tconst instance = new Database(connection);\n\n\treturn construct(instance, DrizzleSQLiteConfig) as any;\n}\n\nexport namespace drizzle {\n\texport function mock<TRelations extends AnyRelations = EmptyRelations>(\n\t\tconfig?: DrizzleSQLiteConfig<TRelations>,\n\t): SQLiteBunDatabase<TRelations> & {\n\t\t$client: '$client is not available on drizzle.mock()';\n\t} {\n\t\treturn construct({} as any, config) as any;\n\t}\n}\n"],
   "mappings": "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",
   "names": ["SQLiteBunTransaction"]