@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/services/notes-search.js

@@ -0,0 +1,289 @@
+import { CliError } from "@wirecat/cli-base";
+import { dateRange, parseLucene, timezoneOf } from "@wirecat/cli-base/query";
+import { INTERNAL_NOTES } from "../domain/providers.js";
+import { normalizeTag } from "../domain/tags.js";
+import { defaultThreads, isTextModelInstalled, textModelsDirectory } from "../embeddings/embed.js";
+import { DEFAULT_TEXT_MODEL, meaningFloor, textModel } from "../embeddings/models.js";
+import { entriesOfList, fitting } from "../search/account-list.js";
+import { validateFields } from "../search/lucene/registry.js";
+import { hasStems } from "../search/lucene/resolved.js";
+import { SEARCH_QUERY } from "../search/lucene/types.js";
+import { createStemmer, DEFAULT_STEMMERS } from "../search/stem.js";
+import { vectorModelKey } from "./embeddings.js";
+import { listContextOf } from "./search-kind.js";
+/** A notes search in the query language messages use, for `search notes` and `search all` to call. */
+export const searchNotesQuery = async (store, request) => {
+    if (!request.text.trim())
+        throw new CliError("validation_error", "say what to find in the notes");
+    const ast = validateFields(parseLucene(request.text, { ...SEARCH_QUERY, defaultField: request.exact ? "exact" : "text" }));
+    const timezone = timezoneOf(request.timezone);
+    const resolve = (node) => {
+        if (node.kind === "boolean")
+            return { ...node, clauses: node.clauses.map(({ occur, node }) => ({ occur, node: resolve(node) })) };
+        if (node.field !== "date")
+            return node;
+        return {
+            ...node,
+            resolution: {
+                date: dateRange(node.value, node.operator === "range" ? (node.upper ?? "*") : node.value, node.operator === "range" ? node.lower_inclusive === true : true, node.operator === "range" ? node.upper_inclusive === true : true, timezone, node.span),
+            },
+        };
+    };
+    const stemmers = hasStems(ast.root) ? await store.stemmers() : undefined;
+    if (stemmers === null)
+        throw new CliError("validation_error", "the store asks for stemmers this tool does not know — upgrade this tool, or search exact forms with --exact", { reason: "stemmer.unknown" });
+    return store.notes.search({
+        root: resolve(ast.root),
+        limit: request.limit,
+        ...(request.offset === undefined ? {} : { offset: request.offset }),
+        ...(request.newest ? { newest: true } : {}),
+        ...(request.folderIds ? { folderIds: request.folderIds } : {}),
+        ...(request.withInternal ? { withInternal: true } : {}),
+        ...(request.source ? { source: request.source } : {}),
+        ...(request.signal ? { signal: request.signal } : {}),
+        ...(hasStems(ast.root) ? { stemmer: createStemmer(stemmers ?? DEFAULT_STEMMERS) } : {}),
+    });
+};
+/** Chunks one batch embeds: one short transaction writes each, as for conversations. */
+const NOTE_BATCH = 8;
+const localModel = (choice, env, command) => {
+    const model = textModel(choice ?? DEFAULT_TEXT_MODEL);
+    const directory = textModelsDirectory(env);
+    if (!isTextModelInstalled(model, directory))
+        throw new CliError("not_found", `${model.id} is not downloaded — \`${command} models text download ${model.id}\``);
+    return { model, directory, key: vectorModelKey(model) };
+};
+const withLocal = async (model, directory, threads, work) => {
+    const { openPool } = await import("../embeddings/pool.js");
+    const embedder = await openPool(model, directory, { workers: 1, threads: threads ?? defaultThreads() });
+    try {
+        return await work(embedder);
+    }
+    finally {
+        await embedder.close();
+    }
+};
+/**
+ * Embeds the notes' chunks that have no vector of the model yet, with the same model, prefixes and key
+ * as conversations, so a chunk whose text a conversation shares is embedded once. A missing model is
+ * an error naming the download command; nothing is downloaded.
+ */
+const embedChunks = async (store, source, { model: choice, maxChunks = Number.POSITIVE_INFINITY, env, threads, command = "tg", } = {}) => {
+    const { model, directory, key } = localModel(choice, env, command);
+    if ((await source.chunksToEmbed(key, { limit: 1 })).length === 0)
+        return { model: model.id, embedded: 0, left: false };
+    return withLocal(model, directory, threads, async (embedder) => {
+        let embedded = 0;
+        let after;
+        while (embedded < maxChunks) {
+            const batch = await source.chunksToEmbed(key, {
+                limit: Math.min(NOTE_BATCH, maxChunks - embedded),
+                ...(after === undefined ? {} : { after }),
+            });
+            if (batch.length === 0)
+                break;
+            after = batch.at(-1)?.hash;
+            const vectors = await embedder.embed(batch.map(({ text }) => text), "passage");
+            await store.saveVectors(key, model.dims, batch.map(({ hash }, index) => ({ hash, vector: vectors[index] })));
+            embedded += batch.length;
+        }
+        const left = (await source.chunksToEmbed(key, { limit: 1, ...(after === undefined ? {} : { after }) })).length > 0;
+        return { model: model.id, embedded, left };
+    });
+};
+export const embedNotes = (store, options = {}) => embedChunks(store, store.notes, options);
+/** Embeds mail's chunks as notes' are embedded: same model and key, so search by meaning reads both. */
+export const embedMail = (store, options = {}) => embedChunks(store, store.mail, options);
+/** Notes nearest in meaning to the query, best first; only notes already embedded can be found. */
+export const nearestNotes = async (store, query, { model: choice, limit, folderIds, withInternal, source, env, threads, command = "tg", }) => {
+    if (!query.trim())
+        throw new CliError("validation_error", "say what to find in the notes");
+    const { model, directory, key } = localModel(choice, env, command);
+    const scope = {
+        ...(folderIds ? { folderIds } : {}),
+        ...(withInternal ? { withInternal: true } : {}),
+        ...(source ? { source } : {}),
+    };
+    if (!(await store.notes.embedded(key, scope)))
+        throw new CliError("not_found", `nothing searched here has vectors of ${model.id} yet, so only words were matched`);
+    const [vector] = await withLocal(model, directory, threads, (embedder) => embedder.embed([query], "query"));
+    const floor = meaningFloor(key);
+    const nearest = await store.notes.nearest(key, vector, {
+        limit,
+        ...(folderIds ? { folderIds } : {}),
+        ...(withInternal ? { withInternal: true } : {}),
+        ...(source ? { source } : {}),
+    });
+    return nearest.filter(({ score }) => score > floor);
+};
+const MAX_LINE = 200;
+const MAX_NOTES_OFFSET = 1000;
+/** How deep each half is read before the two are merged. */
+const CANDIDATES = 50;
+/** What a filter may narrow the meaning half to; past this the filter is applied to words only. */
+const FILTERED = 500;
+/** Reciprocal rank fusion's usual constant, as conversations use. */
+export const RRF_K = 60;
+const firstLine = (text, query) => {
+    const words = query
+        .toLowerCase()
+        .split(/\s+/)
+        .map((word) => word.replace(/^[^\p{L}\p{N}]+|[^\p{L}\p{N}]+$/gu, ""))
+        .filter((word) => word.length > 2 && !["and", "or", "not"].includes(word));
+    const lines = text.split("\n");
+    const found = lines.find((line) => words.some((word) => line.toLowerCase().includes(word)));
+    return (found ?? lines.find((line) => line.trim() !== "") ?? "").trim().slice(0, MAX_LINE);
+};
+/**
+ * `search notes`: words and stems, and meaning when the local model is there, merged by reciprocal rank;
+ * each hit says which half found it, and the answer lists what the notes found link to.
+ */
+export const searchNotes = async (store, query, { limit = 20, offset = 0, tag, filter: expression, folderIds, withInternal, source, exact = false, timezone, env, command = "tg", } = {}) => {
+    const label = tag === undefined ? undefined : normalizeTag(tag);
+    const filter = [expression ? `(${expression})` : "", label === undefined ? "" : `tag:${label}`].filter(Boolean).join(" AND ") ||
+        undefined;
+    const text = [query.trim() ? `(${query})` : "", filter ?? ""].filter(Boolean).join(" AND ");
+    const window = offset + limit;
+    const scope = {
+        ...(folderIds === undefined ? {} : { folderIds }),
+        ...(withInternal ? { withInternal: true } : {}),
+        ...(source === undefined ? {} : { source }),
+        ...(timezone === undefined ? {} : { timezone }),
+    };
+    let meaningSkipped;
+    let meaning;
+    if (exact)
+        meaningSkipped = "--exact searches words as written";
+    else if (query.trim()) {
+        try {
+            const nearest = await nearestNotes(store, query, {
+                limit: Math.max(window, CANDIDATES),
+                command,
+                ...(env === undefined ? {} : { env }),
+                ...(folderIds === undefined ? {} : { folderIds }),
+                ...(withInternal ? { withInternal: true } : {}),
+                ...(source === undefined ? {} : { source }),
+            });
+            if (filter === undefined)
+                meaning = nearest;
+            else {
+                const allowed = await searchNotesQuery(store, { text: filter, limit: FILTERED, ...scope });
+                const refs = new Set(allowed.items.map(({ ref }) => ref));
+                meaning = nearest.filter(({ ref }) => refs.has(ref));
+            }
+        }
+        catch (error) {
+            if (!(error instanceof CliError && error.code === "not_found"))
+                throw error;
+            meaningSkipped = error.message;
+        }
+    }
+    const words = await searchNotesQuery(store, {
+        text,
+        limit: meaning === undefined ? limit : Math.max(window, CANDIDATES),
+        offset: meaning === undefined ? offset : 0,
+        exact,
+        ...scope,
+    });
+    const ranked = new Map();
+    const add = (list, by) => list.forEach(({ ref, note }, rank) => {
+        const held = ranked.get(ref) ?? { note, score: 0, foundBy: [] };
+        held.score += 1 / (RRF_K + rank + 1);
+        held.foundBy.push(by);
+        ranked.set(ref, held);
+    });
+    add(words.items, "words");
+    if (meaning !== undefined)
+        add(meaning, "meaning");
+    const ordered = [...ranked.entries()].sort(([, a], [, b]) => b.score - a.score);
+    const page = meaning === undefined ? ordered : ordered.slice(offset, window);
+    const hasMore = meaning === undefined ? words.hasMore : ordered.length > window || words.hasMore;
+    const hits = [];
+    const counts = new Map();
+    for (const [ref, { note, foundBy }] of page) {
+        const links = (await store.notes.links({ from: ref })).map(({ to, targetText, kind, anchor }) => ({
+            to,
+            targetText,
+            kind,
+            anchor,
+        }));
+        hits.push({
+            ref,
+            source: note.source,
+            folderId: note.folderId,
+            path: note.path,
+            title: note.title,
+            modifiedAt: note.updatedAt,
+            line: firstLine(note.text, query),
+            links,
+            foundBy,
+        });
+        for (const link of new Map(links.map((link) => [link.to ?? `?${link.targetText}`, link])).values()) {
+            const key = link.to ?? `?${link.targetText}`;
+            const known = counts.get(key) ?? { ref: link.to, name: link.targetText, notes: 0 };
+            known.notes++;
+            counts.set(key, known);
+        }
+    }
+    const names = new Map([...(await store.knowledge.organizations()), ...(await store.knowledge.projects())].map(({ ref, name }) => [
+        ref,
+        name,
+    ]));
+    for (const record of counts.values()) {
+        if (record.ref && names.has(record.ref))
+            record.name = names.get(record.ref) ?? record.name;
+        if (record.ref?.startsWith("person:"))
+            record.name = (await store.personByUid(record.ref.slice("person:".length)))?.name ?? record.name;
+        if (record.ref?.startsWith("note:") || record.ref?.startsWith("document:"))
+            record.name = (await store.notes.note(record.ref).catch(() => undefined))?.title ?? record.name;
+    }
+    return {
+        query,
+        ...(label === undefined ? {} : { tag: label }),
+        ...(filter === undefined ? {} : { filter }),
+        by: meaning === undefined ? "words" : "words and meaning",
+        ...(meaningSkipped === undefined ? {} : { meaningSkipped }),
+        hits,
+        hasMore,
+        ...(hasMore && window <= MAX_NOTES_OFFSET ? { nextOffset: window } : {}),
+        linked: [...counts.values()].sort((a, b) => b.notes - a.notes || (a.name ?? a.ref ?? "").localeCompare(b.name ?? b.ref ?? "")),
+    };
+};
+/** What `notes:internal` and `notes:<folder id>` ask of the store: one query, so a page of it is one page. */
+export const notesScopeOf = (accounts) => {
+    const folderIds = accounts.map(({ account }) => account).filter((account) => account !== INTERNAL_NOTES);
+    if (!folderIds.length)
+        return { source: "internal" };
+    return { folderIds, ...(accounts.length > folderIds.length ? { withInternal: true } : {}) };
+};
+/**
+ * `search notes` with `--source`: the notes accounts the list names — `notes:internal`, `notes:<folder id>`, `notes`
+ * — and every entry naming none of them in `skipped`. Without a list, every notes account `type` leaves in.
+ */
+export const searchNotesOf = async (store, account, text, { accounts: list, app, ...query }) => {
+    const what = `${app?.command ?? query.command ?? "tg"} search notes`;
+    const held = [
+        { provider: "notes", account: INTERNAL_NOTES },
+        ...(await store.notes.folders()).map(({ id }) => ({ provider: "notes", account: id })),
+    ];
+    const named = list === undefined
+        ? { accounts: held, skipped: [] }
+        : fitting(entriesOfList(list, await listContextOf(store, account, app)), ["notes", "documents"], what);
+    const typed = named.accounts.filter(({ account }) => query.source === undefined || (account === INTERNAL_NOTES) === (query.source === "internal"));
+    if (!typed.length && list !== undefined)
+        throw new CliError("validation_error", query.source === "internal"
+            ? "--type internal reads the notes written in memo, and --source names none: add notes:internal"
+            : "--type file reads notes folders, and --source names none: add notes:<folder id>");
+    const scope = list === undefined ? {} : notesScopeOf(typed);
+    const found = await searchNotes(store, text, {
+        ...query,
+        ...scope,
+        ...(query.source ? { source: query.source } : {}),
+    });
+    return {
+        ...found,
+        accounts: typed.map(({ account }) => ({ resource: "notes", provider: "notes", account })),
+        skipped: named.skipped,
+    };
+};
+//# sourceMappingURL=notes-search.js.map

package/dist/services/notes-search.js.map

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

package/dist/services/package-upgrade.d.ts

@@ -0,0 +1,43 @@
+import { type Installer } from "@wirecat/cli-base/update";
+export interface ServerRestarts {
+    restarted: readonly string[];
+    left: readonly string[];
+}
+export interface PackageUpgradePorts {
+    installer: () => Installer;
+    latest: () => Promise<string | undefined>;
+    install: (argv: string[]) => number | Promise<number>;
+    afterUpdate?: () => ServerRestarts | Promise<ServerRestarts>;
+    onInstall?: (argv: readonly string[]) => void;
+    /** The version the command now answers, read after the install; `undefined` when it cannot be read. */
+    installed?: () => string | undefined | Promise<string | undefined>;
+    /** When npm published this version, ISO 8601; `undefined` when it cannot be read. */
+    publishedAt?: (version: string) => Promise<string | undefined>;
+}
+export interface PackageUpgradeResult {
+    current: string;
+    latest: string | null;
+    newer: boolean;
+    installer: Installer;
+    command: string | null;
+    updated: boolean;
+    restarted: readonly string[];
+    installed?: string;
+    /** The package manager installed an older version than `latest`. */
+    heldBack?: {
+        until: string | null;
+        command: string;
+    };
+}
+export interface PackageUpgradeOutcome {
+    result: PackageUpgradeResult;
+    reason: "checked" | "unavailable" | "up_to_date" | "manual" | "updated" | "held_back";
+    left: readonly string[];
+}
+export declare const upgradePackage: ({ current, command, packageName, check }: {
+    current: string;
+    command: string;
+    packageName: string;
+    check: boolean;
+}, ports: PackageUpgradePorts) => Promise<PackageUpgradeOutcome>;
+//# sourceMappingURL=package-upgrade.d.ts.map

package/dist/services/package-upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-upgrade.d.ts","sourceRoot":"","sources":["../../src/services/package-upgrade.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAA0B,MAAM,0BAA0B,CAAA;AAEjF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,SAAS,CAAA;IAC1B,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACrD,WAAW,CAAC,EAAE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC5D,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAA;IAC7C,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAClE,qFAAqF;IACrF,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAC/D;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oEAAoE;IACpE,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CACrD;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,oBAAoB,CAAA;IAC5B,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;IACrF,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACxB;AAED,eAAO,MAAM,cAAc,6CACiB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,SAC5G,mBAAmB,KACzB,OAAO,CAAC,qBAAqB,CAmC/B,CAAA"}

package/dist/services/package-upgrade.js

@@ -0,0 +1,58 @@
+import { CliError } from "@wirecat/cli-base";
+import { isNewer, updateCommand } from "@wirecat/cli-base/update";
+export const upgradePackage = async ({ current, command, packageName, check }, ports) => {
+    const installer = ports.installer();
+    const argv = updateCommand(installer, packageName);
+    const latest = await ports.latest();
+    const newer = latest !== undefined && isNewer(latest, current);
+    const result = {
+        current,
+        latest: latest ?? null,
+        newer,
+        installer,
+        command: argv?.join(" ") ?? null,
+        updated: false,
+        restarted: [],
+    };
+    if (check)
+        return { result, reason: "checked", left: [] };
+    if (latest === undefined)
+        return { result, reason: "unavailable", left: [] };
+    if (!newer)
+        return { result, reason: "up_to_date", left: [] };
+    if (!argv)
+        return { result, reason: "manual", left: [] };
+    ports.onInstall?.(argv);
+    const code = await ports.install(argv);
+    if (code !== 0)
+        throw new CliError("provider_error", `${argv[0]} exited with ${code}; ${command} is still ${current}`, {
+            reason: "upgrade.install-failed",
+        });
+    const installed = await ports.installed?.();
+    if (installed === undefined)
+        return restart(result, ports);
+    const read = { ...result, installed };
+    if (!isNewer(latest, installed))
+        return restart(read, ports);
+    const heldBack = {
+        // pnpm 11 resolves `@latest` to the newest version older than minimumReleaseAge, 1 day by default.
+        until: installer === "pnpm" ? dayAfter(await ports.publishedAt?.(latest)) : null,
+        command: [...argv.slice(0, -1), `${packageName}@${latest}`].join(" "),
+    };
+    if (installed === current)
+        return { result: { ...read, heldBack }, reason: "held_back", left: [] };
+    return { ...(await restart({ ...read, heldBack }, ports)), reason: "held_back" };
+};
+const restart = async (result, ports) => {
+    const servers = await ports.afterUpdate?.();
+    return {
+        result: { ...result, updated: true, restarted: servers?.restarted ?? [] },
+        reason: "updated",
+        left: servers?.left ?? [],
+    };
+};
+const dayAfter = (published) => {
+    const time = published === undefined ? Number.NaN : Date.parse(published);
+    return Number.isNaN(time) ? null : new Date(time + 24 * 60 * 60 * 1000).toISOString();
+};
+//# sourceMappingURL=package-upgrade.js.map

package/dist/services/package-upgrade.js.map

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

package/dist/services/patience.d.ts

@@ -0,0 +1,3 @@
+/** Sits out a provider's "wait N seconds" when it is short, a few times; a long one ends the run. */
+export declare const patiently: <T>(request: () => Promise<T>, note: (message: string) => void, stop: AbortSignal) => Promise<T>;
+//# sourceMappingURL=patience.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patience.d.ts","sourceRoot":"","sources":["../../src/services/patience.ts"],"names":[],"mappings":"AAMA,qGAAqG;AACrG,eAAO,MAAM,SAAS,GAAU,CAAC,WACtB,MAAM,OAAO,CAAC,CAAC,CAAC,QACnB,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,QACzB,WAAW,KAChB,OAAO,CAAC,CAAC,CAaX,CAAA"}

package/dist/services/patience.js

@@ -0,0 +1,23 @@
+import { setTimeout as sleep } from "node:timers/promises";
+import { isCliFailure } from "../cli/failures.js";
+/** Waits longer than this are not sat out: the run stops, and the next one resumes. */
+const LONGEST_WAIT_MS = 5 * 60 * 1000;
+/** Sits out a provider's "wait N seconds" when it is short, a few times; a long one ends the run. */
+export const patiently = async (request, note, stop) => {
+    for (let attempt = 1;; attempt += 1) {
+        stop.throwIfAborted();
+        try {
+            return await request();
+        }
+        catch (error) {
+            const wait = isCliFailure(error) && error.code === "rate_limited" ? Number(error.details?.retry_after_ms) : NaN;
+            if (!Number.isFinite(wait) || wait < 0 || wait > LONGEST_WAIT_MS || attempt >= 3)
+                throw error;
+            note(`asked to wait ${Math.ceil(wait / 1000)} s — waiting, then going on`);
+            await sleep(wait, undefined, { signal: stop }).catch(() => { });
+            if (stop.aborted)
+                throw error;
+        }
+    }
+};
+//# sourceMappingURL=patience.js.map

package/dist/services/patience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patience.js","sourceRoot":"","sources":["../../src/services/patience.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,uFAAuF;AACvF,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AAErC,qGAAqG;AACrG,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,OAAyB,EACzB,IAA+B,EAC/B,IAAiB,EACL,EAAE;IACd,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,cAAc,EAAE,CAAA;QACrB,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,EAAE,CAAA;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;YAC/G,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,eAAe,IAAI,OAAO,IAAI,CAAC;gBAAE,MAAM,KAAK,CAAA;YAC7F,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,6BAA6B,CAAC,CAAA;YAC1E,MAAM,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAC9D,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM,KAAK,CAAA;QAC/B,CAAC;IACH,CAAC;AACH,CAAC,CAAA"}

package/dist/services/people.d.ts

@@ -0,0 +1,81 @@
+import type { Contact, Id, Member, Page, PersonCard, PersonProfile, PhoneBookEntry } from "../domain/models.js";
+import { type Operated } from "../sends/guarded.js";
+import type { PersonRecord } from "../store/store.js";
+import type { PageWindow } from "./chats.js";
+import { type ServiceDeps } from "./deps.js";
+import { type ContextOptions, type Detail, type PersonContext, type PersonMessages } from "./person-context.js";
+import { type PersonTimeline, type TimelineOptions } from "./person-timeline.js";
+export interface ContactSync {
+    added: number;
+    changed: number;
+    known: number;
+}
+/**
+ * A contact is somebody this account has a one-to-one chat with — a query over the chat list, never
+ * a flag somebody maintains (max-cli `NEED-105`). Where the store holds who is in each one-to-one
+ * chat, it answers; otherwise the dialogs themselves do, offline from the stored chats.
+ */
+export interface PeopleService {
+    list(options: {
+        order: "recent" | "name";
+        search?: string;
+        notesSearch?: string;
+    } & PageWindow): Promise<Page<Contact>>;
+    show(person: string, options?: {
+        notes?: boolean;
+    }): Promise<PersonCard>;
+    /** What the messenger says about them, and their stored activity in each shared chat. */
+    profile(person: string): Promise<PersonProfile>;
+    /** `phone` as digits, parsed by the caller (`phoneOf`). */
+    lookup(phone: string): Promise<Member>;
+    /** The whole contact list from the messenger into the store: what was new, what changed. */
+    sync(): Promise<ContactSync>;
+    add(person: string): Promise<Operated<{
+        person: Member;
+    }>>;
+    remove(person: string): Promise<Operated<{
+        personId: Id;
+    }>>;
+    block(person: string): Promise<Operated<{
+        personId: Id;
+    }>>;
+    unblock(person: string): Promise<Operated<{
+        personId: Id;
+    }>>;
+    rename(person: string, firstName: string, lastName?: string): Promise<Operated<{
+        person: Member;
+    }>>;
+    /** What the store holds about them, across every messenger linked to them; never connects. */
+    context(person: string, options?: ContextOptions): Promise<PersonContext>;
+    /** Everything they took part in, from the store's involvement index; never connects. */
+    timeline(person: string, options?: TimelineOptions): Promise<PersonTimeline>;
+    /**
+     * Their newest messages in each chat named, from the store; `fetch` reads them from the messenger
+     * first — by sender where it can search so, the newest page of the chat where it cannot.
+     */
+    messagesIn(person: string, options: {
+        chats: string[];
+        limit?: number;
+        detail?: Detail;
+        fetch?: boolean;
+    }): Promise<PersonMessages>;
+    /** `other` may name another messenger of the store: `max:Ana`. */
+    link(person: string, other: string, method?: string): Promise<PersonRecord>;
+    unlink(person: string): Promise<PersonRecord>;
+    /**
+     * Only counts and the people recognised: never a number. `IMPORT_CHUNK` numbers a request, each request
+     * through the guard, each number counted toward the hourly limit.
+     */
+    import(entries: PhoneBookEntry[]): Promise<Operated<{
+        sent: number;
+        recognised: Member[];
+    }>>;
+}
+export declare const peopleService: (deps: ServiceDeps) => PeopleService;
+/** Digits, with the `+` and the spaces, dashes and brackets people type dropped. */
+export declare const phoneOf: (typed: string) => string;
+/** The phone cut to its last four digits: enough to tell two accounts apart. */
+export declare const maskedAccount: <T extends {
+    phone?: string | null;
+}>(account: T) => T;
+//# sourceMappingURL=people.d.ts.map

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

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