@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/services/conversations.js

@@ -0,0 +1,138 @@
+import { CliError } from "@wirecat/cli-base";
+import { cutChunks } from "../conversations/chunks.js";
+import { linkMessages, RULES_VERSION } from "../conversations/link.js";
+import { accountStore } from "./deps.js";
+import { chatIdIn } from "./messages.js";
+/** A page of messages handed to the rules at a time; reading is quick, the rules hold a 50-message window. */
+const READ_PAGE = 5_000;
+/** How far `links` follows a message's chosen parents back. */
+const CHAIN = 50;
+/** Messages to answer per batch, by default and at most: the agent's turn stays small (A1). */
+export const BATCH_SIZE = { default: 50, min: 10, max: 200 };
+export const conversationsService = (deps) => {
+    const found = async (chat) => {
+        const store = await accountStore(deps);
+        return { store, chatId: await chatIdIn(deps.messenger, chat, store) };
+    };
+    const notBuilt = (chatId) => new CliError("not_found", `chat ${chatId} has no conversations yet — \`${deps.messenger.app.command} conversations build --chat ${chatId}\``);
+    return {
+        build: async (chat, { maxMessages, check } = {}) => {
+            check?.();
+            const { store, chatId } = await found(chat);
+            const startedAt = Date.now();
+            const inputs = [];
+            let after;
+            for (;;) {
+                check?.();
+                const page = await store.linkInputs(chatId, { limit: READ_PAGE, ...(after ? { after } : {}) });
+                if (maxMessages !== undefined && inputs.length + page.items.length > maxMessages)
+                    throw new CliError("validation_error", "the chat exceeds the catch-up message budget");
+                inputs.push(...page.items);
+                if (page.next === null)
+                    break;
+                after = page.next;
+            }
+            if (inputs.length === 0) {
+                throw new CliError("not_found", `the store holds no messages of chat ${chatId} — fetch them first`);
+            }
+            check?.();
+            const { links, conversations } = linkMessages(inputs, {
+                check,
+                handles: await store.senderHandles(chatId),
+                answers: await store.agentAnswers(chatId),
+            });
+            const byId = new Map(inputs.map((input) => [input.id, input]));
+            const chunks = conversations.map((ids) => cutChunks(ids.flatMap((id) => {
+                const input = byId.get(id);
+                return input ? [{ id, sender: input.senderName ?? null, text: input.text }] : [];
+            }), undefined, check).map(({ firstId, lastId, hash, range }) => ({ firstId, lastId, hash, ...(range ? { range } : {}) })));
+            await store.replaceConversations(chatId, {
+                check,
+                startedAt,
+                algorithmVersion: RULES_VERSION,
+                links,
+                conversations,
+                chunks,
+            });
+            return {
+                chat: chatId,
+                messages: inputs.length,
+                links: links.length,
+                conversations: conversations.length,
+                builtAt: new Date(startedAt).toISOString(),
+                rulesVersion: RULES_VERSION,
+            };
+        },
+        list: async (chat, { limit, since }) => {
+            const { store, chatId } = await found(chat);
+            if (!(await store.conversationState(chatId))?.builtAt)
+                throw notBuilt(chatId);
+            return store.conversations(chatId, { limit, ...(since === undefined ? {} : { after: since }) });
+        },
+        show: async (target) => {
+            const store = await accountStore(deps);
+            let id;
+            if ("id" in target) {
+                id = target.id;
+            }
+            else {
+                const { chatId } = await found(target.chat);
+                const of = await store.conversationOf(chatId, target.message);
+                if (of === undefined) {
+                    if (!(await store.conversationState(chatId))?.builtAt)
+                        throw notBuilt(chatId);
+                    throw new CliError("not_found", `message ${target.message} is in no conversation of chat ${chatId}`);
+                }
+                id = of;
+            }
+            const conversation = await store.conversation(id);
+            if (!conversation) {
+                throw new CliError("not_found", `no conversation ${id} — a rebuild gives new ids; \`conversations list\``);
+            }
+            return conversation;
+        },
+        batchStatus: async (chat, size) => {
+            const { store, chatId } = await found(chat);
+            const { messages, characters } = await store.batchStatus(chatId);
+            return {
+                chat: chatId,
+                messages,
+                characters,
+                batches: Math.ceil(messages / sized(size)),
+                tokensEstimate: Math.round(characters / 4),
+            };
+        },
+        nextBatch: async (chat, size) => {
+            const { store, chatId } = await found(chat);
+            return store.nextBatch(chatId, { size: sized(size) });
+        },
+        addAnswers: async (batch, answer) => {
+            return (await accountStore(deps)).saveAnswers(batch, answer);
+        },
+        clearAnswers: async (chat, model) => {
+            const { store, chatId } = await found(chat);
+            return { chat: chatId, cleared: await store.clearAnswers(chatId, model) };
+        },
+        links: async (chat, message) => {
+            const { store, chatId } = await found(chat);
+            const chosenOf = (links) => links.find((link) => !link.stale);
+            const own = await store.links(chatId, message);
+            const chosen = chosenOf(own);
+            const chain = [];
+            for (let parent = chosen?.parentId ?? null; parent !== null && chain.length < CHAIN;) {
+                if (chain.includes(parent))
+                    break;
+                chain.push(parent);
+                parent = chosenOf(await store.links(chatId, parent))?.parentId ?? null;
+            }
+            return { chat: chatId, message, links: own.map((link) => ({ ...link, chosen: link === chosen })), chain };
+        },
+    };
+};
+const sized = (size) => {
+    if (!Number.isInteger(size) || size < BATCH_SIZE.min || size > BATCH_SIZE.max) {
+        throw new CliError("validation_error", `--size takes ${BATCH_SIZE.min} to ${BATCH_SIZE.max} messages`);
+    }
+    return size;
+};
+//# sourceMappingURL=conversations.js.map

package/dist/services/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/services/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,EAAkB,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAGtF,OAAO,EAAE,YAAY,EAAoB,MAAM,WAAW,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,8GAA8G;AAC9G,MAAM,SAAS,GAAG,KAAK,CAAA;AAEvB,+DAA+D;AAC/D,MAAM,KAAK,GAAG,EAAE,CAAA;AAqDhB,+FAA+F;AAC/F,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;AAE5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAiB,EAAwB,EAAE;IAC9E,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;QACtC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,CAAA;IACvE,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,MAAU,EAAE,EAAE,CAC9B,IAAI,QAAQ,CACV,WAAW,EACX,QAAQ,MAAM,iCAAiC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,+BAA+B,MAAM,IAAI,CACnH,CAAA;IAEH,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;YACjD,KAAK,EAAE,EAAE,CAAA;YACT,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC5B,MAAM,MAAM,GAAgB,EAAE,CAAA;YAC9B,IAAI,KAAyB,CAAA;YAC7B,SAAS,CAAC;gBACR,KAAK,EAAE,EAAE,CAAA;gBACT,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;gBAC9F,IAAI,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW;oBAC9E,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,8CAA8C,CAAC,CAAA;gBACxF,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;gBAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;oBAAE,MAAK;gBAC7B,KAAK,GAAG,IAAI,CAAC,IAAI,CAAA;YACnB,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,uCAAuC,MAAM,qBAAqB,CAAC,CAAA;YACrG,CAAC;YACD,KAAK,EAAE,EAAE,CAAA;YACT,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE;gBACpD,KAAK;gBACL,OAAO,EAAE,MAAM,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC;gBAC1C,OAAO,EAAE,MAAM,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC;aAC1C,CAAC,CAAA;YACF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;YAC9D,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACvC,SAAS,CACP,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;gBACjB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBAC1B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YAClF,CAAC,CAAC,EACF,SAAS,EACT,KAAK,CACN,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CACtG,CAAA;YACD,MAAM,KAAK,CAAC,oBAAoB,CAAC,MAAM,EAAE;gBACvC,KAAK;gBACL,SAAS;gBACT,gBAAgB,EAAE,aAAa;gBAC/B,KAAK;gBACL,aAAa;gBACb,MAAM;aACP,CAAC,CAAA;YACF,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,MAAM,CAAC,MAAM;gBACvB,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,aAAa,EAAE,aAAa,CAAC,MAAM;gBACnC,OAAO,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;gBAC1C,YAAY,EAAE,aAAa;aAC5B,CAAA;QACH,CAAC;QAED,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;YACrC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO;gBAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC7E,OAAO,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QACjG,CAAC;QAED,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACrB,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;YACtC,IAAI,EAAU,CAAA;YACd,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACnB,EAAE,GAAG,MAAM,CAAC,EAAE,CAAA;YAChB,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBAC3C,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;gBAC7D,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;oBACrB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO;wBAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;oBAC7E,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,WAAW,MAAM,CAAC,OAAO,kCAAkC,MAAM,EAAE,CAAC,CAAA;gBACtG,CAAC;gBACD,EAAE,GAAG,EAAE,CAAA;YACT,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;YACjD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,mBAAmB,EAAE,oDAAoD,CAAC,CAAA;YAC5G,CAAC;YACD,OAAO,YAAY,CAAA;QACrB,CAAC;QAED,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAChC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3C,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;YAChE,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,QAAQ;gBACR,UAAU;gBACV,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1C,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;aAC3C,CAAA;QACH,CAAC;QAED,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3C,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACvD,CAAC;QAED,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAClC,OAAO,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAC9D,CAAC;QAED,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YAClC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAA;QAC3E,CAAC;QAED,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC7B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;YAC3C,MAAM,QAAQ,GAAG,CAAC,KAAmB,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC3E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;YAC5B,MAAM,KAAK,GAAS,EAAE,CAAA;YACtB,KAAK,IAAI,MAAM,GAAG,MAAM,EAAE,QAAQ,IAAI,IAAI,EAAE,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,GAAI,CAAC;gBACtF,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,MAAK;gBACjC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBAClB,MAAM,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAA;YACxE,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAA;QAC3G,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,UAAU,CAAC,GAAG,IAAI,IAAI,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;QAC9E,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,gBAAgB,UAAU,CAAC,GAAG,OAAO,UAAU,CAAC,GAAG,WAAW,CAAC,CAAA;IACxG,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/dist/services/counters.d.ts

@@ -0,0 +1,64 @@
+import { type CounterField } from "../domain/counters.js";
+import type { ServiceDeps } from "./deps.js";
+import type { SearchQuery } from "./messages.js";
+export type CounterQuery = SearchQuery & {
+    counters?: string;
+    maxAge?: string;
+    selection?: unknown;
+    maxMessages?: number;
+    syncTime?: string;
+    dryRun?: boolean;
+};
+export declare const counterFields: (text?: string) => CounterField[];
+export declare const countersService: (deps: ServiceDeps) => {
+    show: (query: CounterQuery) => Promise<{
+        items: {
+            locator: string;
+            account: {
+                provider: string;
+                account: string;
+            };
+            chatId: string;
+            messageId: string;
+            counters: import("../domain/counters.js").CounterState[];
+        }[];
+        included: number;
+        hasMore: boolean;
+        cutoff: string;
+        maxAgeMilliseconds: number;
+        selection: {
+            kind: string;
+            version: number;
+            locators: string[];
+        };
+    }>;
+    refresh: (query: CounterQuery) => Promise<{
+        dryRun: boolean;
+        targets: string[];
+        counters: ("comments" | "reactions" | "views")[];
+        supported: ("comments" | "reactions" | "views")[];
+        unsupported: ("comments" | "reactions" | "views")[];
+        maxMessages: number;
+        timeMilliseconds: number;
+        hasMore: boolean;
+    } | {
+        targets: string[];
+        counters: ("comments" | "reactions" | "views")[];
+        supported: ("comments" | "reactions" | "views")[];
+        unsupported: ("comments" | "reactions" | "views")[];
+        maxMessages: number;
+        timeMilliseconds: number;
+        hasMore: boolean;
+        dryRun: boolean;
+        items: {
+            locator: string;
+            updated: CounterField[];
+            missing: CounterField[];
+            status: "updated" | "missing" | "failed" | "unsupported" | "skipped";
+        }[];
+        stopped: "complete";
+        complete: boolean;
+    }>;
+};
+export type CountersService = ReturnType<typeof countersService>;
+//# sourceMappingURL=counters.d.ts.map

package/dist/services/counters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counters.d.ts","sourceRoot":"","sources":["../../src/services/counters.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,YAAY,EAGlB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAIhD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AACD,eAAO,MAAM,aAAa,qBAAwC,YAAY,EAS7E,CAAA;AAMD,eAAO,MAAM,eAAe,SAAU,WAAW;IAqE7C,IAAI,UAAgB,YAAY;;;;;;;;;;;;;;;;YAQf,IAAI;YAAqB,OAAO;YAAK,QAAQ;;;IAG9D,OAAO,UAAgB,YAAY;;;;;;;;;;;;;;;;;;;qBAoCtB,MAAM;qBACN,YAAY,EAAE;qBACd,YAAY,EAAE;oBACf,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS;;;;;CA6G3E,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA"}

package/dist/services/counters.js

@@ -0,0 +1,231 @@
+import { CliError } from "@wirecat/cli-base";
+import { COUNTER_FIELDS, counterObservationTime, } from "../domain/counters.js";
+import { formatLocator, parseLocator } from "../domain/locator.js";
+import { prepareLucene } from "./messages-search.js";
+import { observationDuration } from "./retention.js";
+export const counterFields = (text = "views,reactions,comments") => {
+    const fields = text.split(",").map((one) => one.trim());
+    if (!fields.length ||
+        fields.some((one) => !COUNTER_FIELDS.includes(one)) ||
+        new Set(fields).size !== fields.length)
+        throw new CliError("validation_error", "--counters takes distinct views,reactions,comments names");
+    return fields;
+};
+const bound = (value, flag) => {
+    if (!Number.isSafeInteger(value) || value < 1 || value > 100)
+        throw new CliError("validation_error", `${flag} must be 1–100`);
+    return value;
+};
+export const countersService = (deps) => {
+    const select = async (query) => {
+        query.signal?.throwIfAborted();
+        const fields = counterFields(query.counters), limit = bound(query.limit ?? 20, "--limit");
+        const maxAge = observationDuration(query.maxAge ?? "24h", "--max-age"), now = Date.now();
+        const store = await deps.store(), account = await deps.account();
+        let items, hasMore = false;
+        if (query.selection !== undefined) {
+            if (query.text || query.ast || query.chat || query.source || query.exact || query.timezone)
+                throw new CliError("validation_error", "--selection cannot be combined with query or scope options");
+            const raw = typeof query.selection === "string" ? query.selection : JSON.stringify(query.selection);
+            if (!raw || Buffer.byteLength(raw) > 64 * 1024)
+                throw new CliError("validation_error", "counter selection must fit within 64 KiB");
+            let pinned;
+            try {
+                pinned = JSON.parse(raw);
+            }
+            catch {
+                throw new CliError("validation_error", "invalid counter selection JSON");
+            }
+            if (pinned?.kind !== "counter-targets" ||
+                pinned.version !== 1 ||
+                !Array.isArray(pinned.locators) ||
+                !pinned.locators.length ||
+                pinned.locators.length > 100 ||
+                pinned.locators.some((one) => typeof one !== "string" || one.length > 2048))
+                throw new CliError("validation_error", "invalid bounded counter-target selection");
+            const locators = [...new Set(pinned.locators)];
+            hasMore = locators.length > limit;
+            items = [];
+            for (const locator of locators.slice(0, limit)) {
+                const target = parseLocator(locator);
+                if (target.provider !== account.provider || target.account !== account.account)
+                    throw new CliError("validation_error", "counter selection is outside the active account");
+                const counters = await store.counterStates?.(account, target.chat, target.message, { now, maxAge });
+                if (!counters?.length)
+                    throw new CliError("validation_error", "counter selection changed — obtain a new selection");
+                items.push({
+                    locator: formatLocator(target),
+                    account,
+                    chatId: target.chat,
+                    messageId: target.message,
+                    counters,
+                });
+            }
+        }
+        else {
+            if (!store.counterTargets)
+                throw new CliError("validation_error", "counter queries require a newer messaging store");
+            const prepared = await prepareLucene(store, account, { ...query, limit, language: "lucene" }, deps.messenger);
+            const found = await store.counterTargets(prepared.execution, { now, maxAge });
+            items = found.items;
+            hasMore = found.hasMore;
+        }
+        return {
+            store,
+            account,
+            fields,
+            now,
+            maxAge,
+            items: items.map((item) => ({ ...item, counters: item.counters.filter((one) => fields.includes(one.counter)) })),
+            hasMore,
+        };
+    };
+    return {
+        show: async (query) => {
+            const found = await select(query);
+            return {
+                items: found.items,
+                included: found.items.length,
+                hasMore: found.hasMore,
+                cutoff: new Date(found.now).toISOString(),
+                maxAgeMilliseconds: found.maxAge,
+                selection: { kind: "counter-targets", version: 1, locators: found.items.map((one) => one.locator) },
+            };
+        },
+        refresh: async (query) => {
+            if (!query.chat && query.selection === undefined)
+                throw new CliError("validation_error", "refresh requires an explicit --chat or pinned --selection");
+            const maxMessages = bound(query.maxMessages ?? query.limit ?? 20, "--max-messages");
+            const time = observationDuration(query.syncTime ?? "30s", "--sync-time");
+            if (time > 300_000)
+                throw new CliError("validation_error", "--sync-time must not exceed 5m");
+            const found = await select({ ...query, limit: Math.min(bound(query.limit ?? 20, "--limit"), maxMessages) });
+            if (found.items.some((one) => one.account.provider !== found.account.provider || one.account.account !== found.account.account))
+                throw new CliError("validation_error", "refresh targets must belong to the active account");
+            const supported = found.fields.filter((one) => deps.messenger.counterFields?.includes(one)), unsupported = found.fields.filter((one) => !supported.includes(one));
+            const preview = {
+                dryRun: true,
+                targets: found.items.map((one) => one.locator),
+                counters: found.fields,
+                supported,
+                unsupported,
+                maxMessages,
+                timeMilliseconds: time,
+                hasMore: found.hasMore,
+            };
+            if (query.dryRun)
+                return preview;
+            if (deps.offline)
+                throw new CliError("validation_error", "counter refresh requires an online session");
+            if (!found.store.updateCounterObservations)
+                throw new CliError("validation_error", "counter refresh requires a newer messaging store");
+            const request = { chatId: null, key: "stats.messages.counters.refresh" };
+            await deps.guard.ask?.(request);
+            deps.guard.check(request, { reserve: false });
+            const controller = new AbortController(), timer = setTimeout(() => controller.abort(new Error("counter refresh time budget exhausted")), time);
+            const signal = query.signal ? AbortSignal.any([query.signal, controller.signal]) : controller.signal;
+            const items = [];
+            let stopped = "complete";
+            try {
+                if (!supported.length || !found.items.length)
+                    return {
+                        ...preview,
+                        dryRun: false,
+                        items: found.items.map((one) => ({
+                            locator: one.locator,
+                            status: "unsupported",
+                            updated: [],
+                            missing: [],
+                        })),
+                        stopped,
+                        complete: !unsupported.length && !found.items.length,
+                    };
+                const work = async (adapter) => {
+                    if (!adapter.fetchCounters)
+                        throw new CliError("validation_error", "adapter does not support explicit counter refresh");
+                    for (const target of found.items) {
+                        if (signal.aborted) {
+                            stopped = query.signal?.aborted ? "cancelled" : "time";
+                            break;
+                        }
+                        try {
+                            let onAbort = () => { };
+                            const aborted = new Promise((_, reject) => {
+                                onAbort = () => {
+                                    void adapter.close().catch(() => { });
+                                    reject(signal.reason ?? new Error("counter refresh cancelled"));
+                                };
+                                signal.addEventListener("abort", onAbort, { once: true });
+                                if (signal.aborted)
+                                    onAbort();
+                            });
+                            let response;
+                            try {
+                                response = await Promise.race([
+                                    adapter.fetchCounters(target.chatId, target.messageId, supported, signal),
+                                    aborted,
+                                ]);
+                            }
+                            finally {
+                                signal.removeEventListener("abort", onAbort);
+                            }
+                            if (signal.aborted) {
+                                stopped = query.signal?.aborted ? "cancelled" : "time";
+                                break;
+                            }
+                            const observations = {};
+                            for (const field of supported)
+                                if (response[field]) {
+                                    counterObservationTime(response[field], Date.now());
+                                    observations[field] = response[field];
+                                }
+                            await found.store.updateCounterObservations?.(found.account, target.chatId, target.messageId, observations);
+                            const states = await found.store.counterStates?.(found.account, target.chatId, target.messageId, {
+                                now: Date.now(),
+                                maxAge: found.maxAge,
+                            });
+                            const updated = supported.filter((field) => {
+                                const observed = observations[field];
+                                return (observed !== undefined &&
+                                    states?.some((state) => state.counter === field &&
+                                        state.value === observed.value &&
+                                        state.observedAt !== null &&
+                                        Date.parse(state.observedAt) === Date.parse(observed.observedAt)));
+                            });
+                            items.push({
+                                locator: target.locator,
+                                updated,
+                                missing: supported.filter((one) => !updated.includes(one)),
+                                status: updated.length ? "updated" : Object.keys(observations).length ? "skipped" : "missing",
+                            });
+                        }
+                        catch {
+                            if (signal.aborted) {
+                                stopped = query.signal?.aborted ? "cancelled" : "time";
+                                break;
+                            }
+                            items.push({ locator: target.locator, updated: [], missing: supported, status: "failed" });
+                        }
+                    }
+                };
+                if (deps.withConnection)
+                    await deps.withConnection(work);
+                else
+                    await work(await deps.connection());
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            return {
+                ...preview,
+                dryRun: false,
+                items,
+                stopped,
+                complete: stopped === "complete" &&
+                    !unsupported.length &&
+                    items.every((one) => one.status === "updated" && !one.missing.length),
+            };
+        },
+    };
+};
+//# sourceMappingURL=counters.js.map

package/dist/services/counters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counters.js","sourceRoot":"","sources":["../../src/services/counters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EACL,cAAc,EAGd,sBAAsB,GACvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAIlE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAUpD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAI,GAAG,0BAA0B,EAAkB,EAAE;IACjF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IACvD,IACE,CAAC,MAAM,CAAC,MAAM;QACd,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAE,cAAoC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1E,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;QAEtC,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,0DAA0D,CAAC,CAAA;IACpG,OAAO,MAAwB,CAAA;AACjC,CAAC,CAAA;AACD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,EAAE;IAC5C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG;QAC1D,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,IAAI,gBAAgB,CAAC,CAAA;IACjE,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AACD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAiB,EAAE,EAAE;IACnD,MAAM,MAAM,GAAG,KAAK,EAAE,KAAmB,EAAE,EAAE;QAC3C,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,CAAA;QAC9B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,EAC1C,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,SAAS,CAAC,CAAA;QAC7C,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,WAAW,CAAC,EACpE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,EAC9B,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QAChC,IAAI,KAAsB,EACxB,OAAO,GAAG,KAAK,CAAA;QACjB,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ;gBACxF,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,4DAA4D,CAAC,CAAA;YACtG,MAAM,GAAG,GAAG,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YACnG,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI;gBAC5C,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,0CAA0C,CAAC,CAAA;YACpF,IAAI,MAAiE,CAAA;YACrE,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,gCAAgC,CAAC,CAAA;YAC1E,CAAC;YACD,IACE,MAAM,EAAE,IAAI,KAAK,iBAAiB;gBAClC,MAAM,CAAC,OAAO,KAAK,CAAC;gBACpB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAC/B,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM;gBACvB,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG;gBAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;gBAE3E,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,0CAA0C,CAAC,CAAA;YACpF,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAoB,CAAC,CAAC,CAAA;YAC1D,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAA;YACjC,KAAK,GAAG,EAAE,CAAA;YACV,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;gBACpC,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;oBAC5E,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,iDAAiD,CAAC,CAAA;gBAC3F,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;gBACnG,IAAI,CAAC,QAAQ,EAAE,MAAM;oBACnB,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,oDAAoD,CAAC,CAAA;gBAC9F,KAAK,CAAC,IAAI,CAAC;oBACT,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC;oBAC9B,OAAO;oBACP,MAAM,EAAE,MAAM,CAAC,IAAI;oBACnB,SAAS,EAAE,MAAM,CAAC,OAAO;oBACzB,QAAQ;iBACT,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,cAAc;gBACvB,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,iDAAiD,CAAC,CAAA;YAC3F,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;YAC7G,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;YAC7E,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;YACnB,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;QACzB,CAAC;QACD,OAAO;YACL,KAAK;YACL,OAAO;YACP,MAAM;YACN,GAAG;YACH,MAAM;YACN,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;YAChH,OAAO;SACR,CAAA;IACH,CAAC,CAAA;IACD,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,KAAmB,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAA;YACjC,OAAO;gBACL,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;gBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;gBACzC,kBAAkB,EAAE,KAAK,CAAC,MAAM;gBAChC,SAAS,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;aACpG,CAAA;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAmB,EAAE,EAAE;YACrC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;gBAC9C,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,2DAA2D,CAAC,CAAA;YACrG,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAA;YACnF,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,EAAE,aAAa,CAAC,CAAA;YACxE,IAAI,IAAI,GAAG,OAAO;gBAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,gCAAgC,CAAC,CAAA;YAC5F,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC,CAAA;YAC3G,IACE,KAAK,CAAC,KAAK,CAAC,IAAI,CACd,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC,OAAO,CAC1G;gBAED,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,mDAAmD,CAAC,CAAA;YAC7F,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EACzF,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;YACtE,MAAM,OAAO,GAAG;gBACd,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC9C,QAAQ,EAAE,KAAK,CAAC,MAAM;gBACtB,SAAS;gBACT,WAAW;gBACX,WAAW;gBACX,gBAAgB,EAAE,IAAI;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAA;YACD,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO,OAAO,CAAA;YAChC,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,4CAA4C,CAAC,CAAA;YACtG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB;gBACxC,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,kDAAkD,CAAC,CAAA;YAC5F,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,iCAAiC,EAAE,CAAA;YACxE,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAA;YAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;YAC7C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,EACtC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;YACtG,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAA;YACpG,MAAM,KAAK,GAKL,EAAE,CAAA;YACR,IAAI,OAAO,GAAsC,UAAU,CAAA;YAC3D,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM;oBAC1C,OAAO;wBACL,GAAG,OAAO;wBACV,MAAM,EAAE,KAAK;wBACb,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;4BAC/B,OAAO,EAAE,GAAG,CAAC,OAAO;4BACpB,MAAM,EAAE,aAAsB;4BAC9B,OAAO,EAAE,EAAE;4BACX,OAAO,EAAE,EAAE;yBACZ,CAAC,CAAC;wBACH,OAAO;wBACP,QAAQ,EAAE,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM;qBACrD,CAAA;gBACH,MAAM,IAAI,GAAG,KAAK,EAAE,OAAuD,EAAE,EAAE;oBAC7E,IAAI,CAAC,OAAO,CAAC,aAAa;wBACxB,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,mDAAmD,CAAC,CAAA;oBAC7F,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;wBACjC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;4BACnB,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAA;4BACtD,MAAK;wBACP,CAAC;wBACD,IAAI,CAAC;4BACH,IAAI,OAAO,GAAe,GAAG,EAAE,GAAE,CAAC,CAAA;4BAClC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gCAC/C,OAAO,GAAG,GAAG,EAAE;oCACb,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;oCACpC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAA;gCACjE,CAAC,CAAA;gCACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;gCACzD,IAAI,MAAM,CAAC,OAAO;oCAAE,OAAO,EAAE,CAAA;4BAC/B,CAAC,CAAC,CAAA;4BACF,IAAI,QAA6B,CAAA;4BACjC,IAAI,CAAC;gCACH,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oCAC5B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC;oCACzE,OAAO;iCACR,CAAC,CAAA;4BACJ,CAAC;oCAAS,CAAC;gCACT,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;4BAC9C,CAAC;4BACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gCACnB,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAA;gCACtD,MAAK;4BACP,CAAC;4BACD,MAAM,YAAY,GAAwB,EAAE,CAAA;4BAC5C,KAAK,MAAM,KAAK,IAAI,SAAS;gCAC3B,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oCACpB,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;oCACnD,YAAY,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;gCACvC,CAAC;4BACH,MAAM,KAAK,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAC3C,KAAK,CAAC,OAAO,EACb,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,SAAS,EAChB,YAAY,CACb,CAAA;4BACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE;gCAC/F,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;gCACf,MAAM,EAAE,KAAK,CAAC,MAAM;6BACrB,CAAC,CAAA;4BACF,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;gCACzC,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;gCACpC,OAAO,CACL,QAAQ,KAAK,SAAS;oCACtB,MAAM,EAAE,IAAI,CACV,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,OAAO,KAAK,KAAK;wCACvB,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK;wCAC9B,KAAK,CAAC,UAAU,KAAK,IAAI;wCACzB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CACnE,CACF,CAAA;4BACH,CAAC,CAAC,CAAA;4BACF,KAAK,CAAC,IAAI,CAAC;gCACT,OAAO,EAAE,MAAM,CAAC,OAAO;gCACvB,OAAO;gCACP,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gCAC1D,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;6BAC9F,CAAC,CAAA;wBACJ,CAAC;wBAAC,MAAM,CAAC;4BACP,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gCACnB,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAA;gCACtD,MAAK;4BACP,CAAC;4BACD,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;wBAC5F,CAAC;oBACH,CAAC;gBACH,CAAC,CAAA;gBACD,IAAI,IAAI,CAAC,cAAc;oBAAE,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;;oBACnD,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAA;YAC1C,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC;YACD,OAAO;gBACL,GAAG,OAAO;gBACV,MAAM,EAAE,KAAK;gBACb,KAAK;gBACL,OAAO;gBACP,QAAQ,EACN,OAAO,KAAK,UAAU;oBACtB,CAAC,WAAW,CAAC,MAAM;oBACnB,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;aACxE,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/services/deps.d.ts

@@ -0,0 +1,84 @@
+import type { AppIdentity } from "../cli/app.js";
+import type { Messenger } from "../cli/messenger/context.js";
+import type { MessengerAdapter } from "../cli/messenger/port.js";
+import type { WarmEmbedders } from "../embeddings/embed.js";
+import type { SendGuard } from "../sends/guard.js";
+import type { AccountStore } from "../store/account-store.js";
+import type { AccountKey, MessageStore } from "../store/store.js";
+/**
+ * What a service works with. Each part is opened on first use, so a read from the store never
+ * connects and a command that never touches the store never opens it. Whoever built the deps closes
+ * what they opened.
+ */
+export interface ServiceDeps {
+    messenger: Messenger;
+    offline: boolean;
+    /** `store`: the messenger's history is read from the local store (`Messenger.history`); `server` when unset. */
+    reads?: "server" | "store";
+    account: () => Promise<AccountKey>;
+    /** Already saving what its reads answer, and recording each call as a run event. */
+    connection: () => Promise<MessengerAdapter>;
+    /** A retained session serializes the whole fetch, including ingestion. */
+    withConnection?: <T>(work: (adapter: MessengerAdapter) => Promise<T>) => Promise<T>;
+    /**
+     * The whole store, every account in it. A service reads through `accountStore(deps)`; a read across
+     * accounts on purpose names itself with `crossAccount(deps, reason)`.
+     */
+    store: () => Promise<MessageStore>;
+    guard: SendGuard;
+    /** For the profile's own files — a group's moderation rules. `default` and `process.env` when unset. */
+    profile?: string;
+    env?: NodeJS.ProcessEnv;
+    /** A long-running process's open models, so a search does not load one each time. */
+    embedders?: WarmEmbedders;
+    /** `false` keeps no search history: recording was turned off by name. Kept when unset. */
+    history?: boolean;
+    searchCatchUp?: boolean;
+    agentText?: true;
+}
+/** The store with the running account bound: the default for a service's reads and writes. */
+export declare const accountStore: (deps: Pick<ServiceDeps, "store" | "account">) => Promise<AccountStore>;
+/**
+ * The whole store, for a read that spans accounts on purpose — `--source all`, `in:all`, `search all`.
+ * `reason` says which, so every such read is found by searching for this name.
+ */
+export declare const crossAccount: (deps: Pick<ServiceDeps, "store">, _reason: string) => Promise<MessageStore>;
+/** `accountStore`, or nothing when the store will not open or the account is not known yet. */
+export declare const accountStoreIfOpen: (deps: ServiceDeps) => Promise<AccountStore | undefined>;
+/**
+ * Online, the store only adds to an answer the messenger already gave, so a store that will not open,
+ * or that does not know whose account this is yet, loses nothing.
+ */
+export declare const storeIfOpen: (deps: ServiceDeps) => Promise<{
+    store: MessageStore;
+    account: AccountKey;
+} | undefined>;
+/** Whether `chats`, `messages list|context` and `contacts` answer from the store instead of the messenger. */
+export declare const fromStore: (deps: Pick<ServiceDeps, "offline" | "reads">) => boolean;
+/** What a store-mode read answers for a chat the store holds nothing of. */
+export declare const nothingStored: (messenger: Messenger) => string;
+/** Where a store-mode messenger's history comes from, for what it cannot do. */
+export declare const PUSHED = "this messenger's history is read from the local store";
+export declare const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context` and `contacts list|show`";
+/** Over a connection that is already open — an MCP session holds one for minutes. */
+export declare const onlineDeps: (messenger: Messenger, adapter: MessengerAdapter, guard: SendGuard, where?: {
+    profile?: string;
+    env?: NodeJS.ProcessEnv;
+}) => ServiceDeps;
+/** Over the local store alone, for `--offline` and the tools that never ask the messenger. */
+export declare const storedDeps: (messenger: Messenger, store: MessageStore, account: AccountKey, guard: SendGuard) => ServiceDeps;
+/**
+ * The store-backed reads of a messenger whose history is kept there, for an MCP read: not
+ * `--offline`, so `inbox` and `review` answer too. Nothing here connects.
+ */
+export declare const storeModeDeps: (messenger: Messenger, store: MessageStore, account: AccountKey, guard: SendGuard) => ServiceDeps;
+/**
+ * For a program that is not a messenger but keeps its own sources in the store — `cli-memo`'s notes and
+ * mail: the services that read and build from the store alone (conversations, embeddings, person
+ * context). It has no connection and no settings to resolve, and its guard refuses every write.
+ */
+export declare const storeOnlyDeps: (store: MessageStore, account: AccountKey, { app, env }: {
+    app: AppIdentity;
+    env?: NodeJS.ProcessEnv;
+}) => ServiceDeps;
+//# sourceMappingURL=deps.d.ts.map

package/dist/services/deps.d.ts.map

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