@wirecat/cli-memo 0.131.65 → 0.131.67

package/dist/sources/command.js

@@ -0,0 +1,246 @@
+import { existsSync } from "node:fs";
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { environmentOf, FETCH, LOCAL_READ, LOCAL_WRITE } from "@wirecat/cli-core/cli";
+import { MAX_TEXT_CHARS } from "@wirecat/cli-core/documents";
+import { addedSourceKeyOf } from "@wirecat/cli-core/store";
+import { InvalidArgumentError } from "commander";
+import { answers, itemAnswer, listAnswer, withStore } from "../answer.js";
+import { byOption, reasonOption, whoRuns } from "../author.js";
+import { loadConfig } from "../config.js";
+import { searchModelPresent } from "../notes/embed.js";
+import { collect } from "../options.js";
+import { subjectOf } from "../people/subject.js";
+import { refuseBareNumber } from "../refs.js";
+import { dropCopy, keepCopy } from "./copy.js";
+import { namedIn } from "./mentions.js";
+import { argumentKind, readFile, readPage, readText, SOURCE_TEXT_CHARS, withNextStep } from "./read.js";
+const SUBJECT_HELP = "who or what it is about: person:, organization:, project:, task:, meeting:, or <messenger>:<name or id>; repeat for more";
+const TEXT_BYTES = 16_384;
+const MAX_TEXT_BYTES = 1_048_576;
+const between = (low, high, what) => (value) => {
+    const number = Number(value);
+    if (!Number.isInteger(number) || number < low || number > high)
+        throw new InvalidArgumentError(`${what}: a whole number, ${low} to ${high}`);
+    return number;
+};
+/** The text cut at a character, so its UTF-8 form is at most `bytes`. */
+const boundedText = (text, bytes) => {
+    const encoded = Buffer.from(text);
+    if (encoded.byteLength <= bytes)
+        return { text, truncated: false };
+    let cut = encoded.subarray(0, bytes).toString("utf8");
+    if (cut.endsWith("�"))
+        cut = cut.slice(0, -1);
+    return { text: cut, truncated: true };
+};
+const documentRef = async (store, reference) => {
+    await refuseBareNumber(store, reference, ["document"]);
+    const ref = reference.trim();
+    if (!/^document:[1-9]\d*$/.test(ref))
+        throw new CliError("validation_error", `${reference} is not a source; give its document:<id>`, {
+            reason: "input.invalid",
+        });
+    return ref;
+};
+const isAgentServer = (command, env) => environmentOf(command).agent !== undefined || env.AI_AGENT === "memo-mcp";
+/** Every findings batch whose evidence cites `ref`; the store lists batches by project only, so all are read. */
+const batchesCiting = async (store, ref) => {
+    const found = [];
+    for (let offset = 0;; offset += 50) {
+        const page = await store.evidenceFindings.list({ limit: 50, offset });
+        for (const batch of page.items) {
+            const findings = batch.input.findings
+                .filter((finding) => finding.evidence.some((evidence) => evidence.reference === ref))
+                .map((finding) => finding.id);
+            if (findings.length > 0)
+                found.push({ id: batch.id, status: batch.status, findings });
+        }
+        if (!page.hasMore)
+            return found;
+    }
+};
+const citing = async (store, ref) => {
+    const links = await store.notes.links({ to: ref, kind: "evidence" });
+    const of = (type) => [...new Set(links.flatMap(({ from }) => (from.startsWith(`${type}:`) ? [from] : [])))];
+    return { facts: of("fact"), memories: of("memory") };
+};
+export const sourcesCommand = (program, streams, env, { fetch } = {}) => {
+    const { print, run } = answers(program, streams, env);
+    const sources = program
+        .command("sources")
+        .summary("files, web pages and text you add by hand")
+        .description("sources you add by hand: pasted text, a file or a web page, kept as searchable documents");
+    byOption(reasonOption(annotate(sources.command("add"), { effects: FETCH, output: { entity: "added_source" } })
+        .summary("keep a file, a web page or pasted text as a document")
+        .description("keep a file, a web page or pasted text as a document of its own; only its text is kept unless --keep-copy")))
+        .argument("<source>", "a file's path, an http(s) address, or - to read the text from stdin")
+        .option("--title <title>", "a title; otherwise the page's or file's own, or the text's first line")
+        .option("--subject <ref>", SUBJECT_HELP, collect)
+        .option("--keep-copy", "also keep a copy of the file in memo's data folder, so it opens after the file is gone")
+        .option("--max-chars <n>", `most characters of text to keep, up to ${MAX_TEXT_CHARS} (default ${SOURCE_TEXT_CHARS})`, between(1, MAX_TEXT_CHARS, "--max-chars"))
+        .option("--json", "print JSON; --json=id,title keeps only those fields")
+        .action(async (given, options, command) => {
+        const kind = argumentKind(given);
+        if (isAgentServer(command, env) && kind !== "text")
+            throw new CliError("permission_error", "over MCP a source is added as text only, never from a path or a link");
+        if (options.keepCopy && kind !== "path")
+            throw new CliError("validation_error", "--keep-copy keeps a file; a link or pasted text keeps its text only", {
+                reason: "input.invalid",
+                param: "keep_copy",
+            });
+        const maxChars = options.maxChars ?? SOURCE_TEXT_CHARS;
+        const who = await whoRuns(command, env, { asOwner: options.asOwner, question: "add this source as yours?" });
+        const by = who === "owner" ? "owner" : { bot: who.bot, reason: options.reason?.trim() || "memo sources add" };
+        const read = await (kind === "text"
+            ? readText(environmentOf(command).stdin ?? process.stdin, { maxChars })
+            : kind === "url"
+                ? readPage(given, { maxChars, ...(fetch ? { fetch } : {}) })
+                : readFile(given, { maxChars })).catch((error) => {
+            throw withNextStep(error);
+        });
+        const content = {
+            kind: read.kind,
+            text: read.text,
+            url: read.url ?? null,
+            ...(read.bytes ? { bytes: read.bytes } : {}),
+        };
+        const item = await withStore(env, async (store) => {
+            const subjects = await Promise.all((options.subject ?? []).map(async (subject) => (await subjectOf(store, subject)).ref));
+            let copy;
+            if (options.keepCopy && read.bytes && (await store.notes.findAddedSource(content)).duplicateOf === null)
+                copy = keepCopy(env, addedSourceKeyOf(content).hash, read.bytes);
+            let saved;
+            try {
+                saved = await store.notes.saveAddedSource({
+                    ...content,
+                    read: read.read,
+                    title: options.title?.trim() || read.title,
+                    fileName: read.fileName ?? null,
+                    mime: read.mime ?? null,
+                    size: read.size,
+                    subjects,
+                    by,
+                    ...(copy ? { keepCopy: { path: copy.path } } : {}),
+                    ...(read.metadata ? { metadata: read.metadata } : {}),
+                    ...(read.sections ? { sections: read.sections } : {}),
+                });
+            }
+            catch (error) {
+                if (copy?.wrote)
+                    dropCopy(env, copy.path);
+                throw error;
+            }
+            if (copy?.wrote && saved.duplicateOf !== null)
+                dropCopy(env, copy.path);
+            const text = read.read === "extracted";
+            // A source stored before keeps the text of its first read; this read's cut says nothing about it.
+            const same = saved.duplicateOf === null && saved.note.text === read.text.trim();
+            return {
+                ref: saved.note.ref,
+                created: saved.created,
+                duplicateOf: saved.duplicateOf,
+                title: saved.note.title,
+                kind: read.kind,
+                mime: read.mime ?? null,
+                bytes: read.size,
+                chars: saved.note.text.length,
+                truncated: same ? read.truncated : null,
+                extractor: read.extractor,
+                read: read.read,
+                url: read.url ?? null,
+                kept: saved.kept,
+                searchable: {
+                    words: text,
+                    meaning: text && searchModelPresent(env) && loadConfig(env).notes?.embed !== false,
+                },
+                subjects: saved.subjects,
+            };
+        });
+        print(options.json, itemAnswer(item), [
+            `${item.ref}${item.duplicateOf ? "  already stored: only its subjects were added" : item.created ? "  added" : "  already added"}`,
+            `  ${item.title ?? ""}  ${item.kind}${item.mime ? ` · ${item.mime}` : ""} · ${item.chars} characters${item.truncated === true ? " (only the first part is kept)" : ""}`,
+            `  kept: ${item.kept === "copy" ? "its text and a copy of the file" : item.kept === "text" ? "its text" : "nothing new"}`,
+            `  search: ${item.searchable.words ? "by words" : "by its title and subjects only"}${item.searchable.meaning ? " and by meaning after memo sync" : ""}`,
+            ...(item.subjects.length ? [`  about: ${item.subjects.join(", ")}`] : []),
+        ].join("\n"));
+    });
+    annotate(sources.command("show"), { effects: LOCAL_READ, output: { entity: "source_detail" } })
+        .summary("one source: its text, what is kept, and what cites it")
+        .description("one source: its text, what is kept, what it is about, and the facts, memories and batches citing it")
+        .argument("<ref>", "document:<id>, as sources add answered")
+        .option("--bytes <bytes>", `most UTF-8 bytes of its text, up to ${MAX_TEXT_BYTES} (default ${TEXT_BYTES})`, between(1, MAX_TEXT_BYTES, "--bytes"))
+        .option("--json", "print JSON; --json=id,title keeps only those fields")
+        .action((reference, options) => run(options.json, async (store) => {
+        const ref = await documentRef(store, reference);
+        const source = await store.notes.addedSource(ref);
+        const note = source?.note ?? (await store.notes.note(ref));
+        const { text, truncated } = boundedText(note.text, options.bytes ?? TEXT_BYTES);
+        const subjects = (await store.notes.links({ from: ref, kind: "about" })).flatMap(({ to, confirmed }) => to === null ? [] : [{ ref: to, confirmed }]);
+        return itemAnswer({
+            ref,
+            title: note.title,
+            added: source !== undefined,
+            kind: source?.kind ?? null,
+            url: source?.url ?? null,
+            fileName: source?.fileName ?? null,
+            mime: source?.mime ?? null,
+            bytes: source?.size ?? null,
+            // The row says a copy was kept; only the file itself says it still is.
+            kept: source === undefined ? null : source.copy !== null && existsSync(source.copy) ? "copy" : "text",
+            chars: note.text.length,
+            text,
+            textTruncated: truncated,
+            createdAt: note.createdAt,
+            updatedAt: note.updatedAt,
+            subjects,
+            ...(await citing(store, ref)),
+            batches: await batchesCiting(store, ref),
+        });
+    }));
+    annotate(sources.command("mentions"), { effects: LOCAL_READ, output: { entity: "source_mention" } })
+        .summary("known people and organizations named in a source")
+        .description("people and organizations memo knows whose names appear in a source's text; nothing leaves")
+        .argument("<ref>", "document:<id>")
+        .option("--json", "print JSON; --json=id,title keeps only those fields")
+        .action((reference, options) => run(options.json, async (store) => {
+        const ref = await documentRef(store, reference);
+        const found = await namedIn(store, await store.notes.note(ref));
+        return listAnswer("sources mentions", {
+            items: found.items,
+            limit: Math.max(1, found.items.length),
+            has_more: false,
+            ...(found.organizationsComplete
+                ? {}
+                : {
+                    missing: [
+                        {
+                            field: "organizations",
+                            why: `only the first ${found.organizationsChecked} organizations were matched by name`,
+                        },
+                    ],
+                }),
+        });
+    }));
+    byOption(annotate(sources.command("remove"), { effects: LOCAL_WRITE, output: { entity: "source_removal" } })
+        .summary("remove a source you added, and its kept copy")
+        .description("remove a source you added, and its copy if one was kept; the next source check reviews what cites it"))
+        .argument("<ref>", "document:<id> of a source you added")
+        .option("--json", "print JSON; --json=id,title keeps only those fields")
+        .action(async (reference, options, command) => {
+        const who = await whoRuns(command, env, { asOwner: options.asOwner, question: "remove this source as you?" });
+        const by = who === "owner" ? "owner" : { bot: who.bot, reason: "memo sources remove" };
+        await run(options.json, async (store) => {
+            const ref = await documentRef(store, reference);
+            const cited = await citing(store, ref);
+            const removed = await store.notes.removeAddedSource(ref, by);
+            return itemAnswer({
+                ref: removed.ref,
+                removed: true,
+                copyDeleted: removed.copy !== null && dropCopy(env, removed.copy),
+                ...cited,
+            });
+        });
+    });
+};
+//# sourceMappingURL=command.js.map

package/dist/sources/command.js.map

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

package/dist/sources/copy.d.ts

@@ -0,0 +1,13 @@
+/** Where memo keeps the copies the owner asked for, each named by the hash of its bytes. */
+export declare const copiesDir: (env: NodeJS.ProcessEnv) => string;
+/** Writes the copy unless it is there; answers whether this call wrote it, so a failed save can take it back. */
+export declare const keepCopy: (env: NodeJS.ProcessEnv, hash: string, bytes: Uint8Array) => {
+    path: string;
+    wrote: boolean;
+};
+/**
+ * Deletes a copy the store named, only inside memo's own folder: the path comes from the database, and a row
+ * someone edited must not make memo delete any other file.
+ */
+export declare const dropCopy: (env: NodeJS.ProcessEnv, path: string) => boolean;
+//# sourceMappingURL=copy.d.ts.map

package/dist/sources/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/sources/copy.ts"],"names":[],"mappings":"AAMA,4FAA4F;AAC5F,eAAO,MAAM,SAAS,QAAS,MAAM,CAAC,UAAU,WAC2C,CAAA;AAI3F,iHAAiH;AACjH,eAAO,MAAM,QAAQ,QAAS,MAAM,CAAC,UAAU,QAAQ,MAAM,SAAS,UAAU,KAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAShH,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAS,MAAM,CAAC,UAAU,QAAQ,MAAM,KAAG,OAM/D,CAAA"}

package/dist/sources/copy.js

@@ -0,0 +1,32 @@
+import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { resolvePaths } from "@wirecat/cli-base";
+import { APP } from "../app.js";
+/** Where memo keeps the copies the owner asked for, each named by the hash of its bytes. */
+export const copiesDir = (env) => join(resolvePaths({ appName: APP.appName, prefix: APP.envPrefix, env }).state, "sources");
+const copyPath = (env, hash) => join(copiesDir(env), hash);
+/** Writes the copy unless it is there; answers whether this call wrote it, so a failed save can take it back. */
+export const keepCopy = (env, hash, bytes) => {
+    const path = copyPath(env, hash);
+    if (existsSync(path))
+        return { path, wrote: false };
+    mkdirSync(copiesDir(env), { recursive: true, mode: 0o700 });
+    // A rename is whole or nothing: a run stopped half way leaves no copy that looks kept.
+    const partial = `${path}.${randomUUID()}.part`;
+    writeFileSync(partial, bytes, { mode: 0o600 });
+    renameSync(partial, path);
+    return { path, wrote: true };
+};
+/**
+ * Deletes a copy the store named, only inside memo's own folder: the path comes from the database, and a row
+ * someone edited must not make memo delete any other file.
+ */
+export const dropCopy = (env, path) => {
+    const inside = relative(resolve(copiesDir(env)), resolve(path));
+    if (!inside || isAbsolute(inside) || inside.startsWith("..") || inside.includes(sep) || !existsSync(path))
+        return false;
+    rmSync(path);
+    return true;
+};
+//# sourceMappingURL=copy.js.map

package/dist/sources/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../src/sources/copy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAE/B,4FAA4F;AAC5F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAsB,EAAE,EAAE,CAClD,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;AAE3F,MAAM,QAAQ,GAAG,CAAC,GAAsB,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;AAErF,iHAAiH;AACjH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAsB,EAAE,IAAY,EAAE,KAAiB,EAAoC,EAAE;IACpH,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAChC,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IACnD,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC3D,uFAAuF;IACvF,MAAM,OAAO,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,OAAO,CAAA;IAC9C,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9C,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IACzB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AAC9B,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAsB,EAAE,IAAY,EAAW,EAAE;IACxE,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAC/D,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QACvG,OAAO,KAAK,CAAA;IACd,MAAM,CAAC,IAAI,CAAC,CAAA;IACZ,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/dist/sources/mentions.d.ts

@@ -0,0 +1,21 @@
+import type { MessageStore, Note } from "@wirecat/cli-core/store";
+export interface NamedInSource {
+    ref: string;
+    type: "person" | "organization";
+    name: string | null;
+    /** The words of the text it was found by: a name as written, an e-mail address or a phone number. */
+    foundAs: string[];
+}
+export interface SourceMentions {
+    items: NamedInSource[];
+    /** Organizations memo read the names of; a store with more than the store lists at once is not covered whole. */
+    organizationsChecked: number;
+    organizationsComplete: boolean;
+}
+/**
+ * People and organizations memo knows whose names appear in a document. People come from cli-core's mentions: a
+ * name it found, linked or matching known people, and an e-mail address or phone number a person owns. Organizations
+ * are matched by their whole name in the text, since no mention kind finds them.
+ */
+export declare const namedIn: (store: MessageStore, note: Note) => Promise<SourceMentions>;
+//# sourceMappingURL=mentions.d.ts.map

package/dist/sources/mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../../src/sources/mentions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAEjE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAA;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,qGAAqG;IACrG,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,iHAAiH;IACjH,oBAAoB,EAAE,MAAM,CAAA;IAC5B,qBAAqB,EAAE,OAAO,CAAA;CAC/B;AA6BD;;;;GAIG;AACH,eAAO,MAAM,OAAO,UAAiB,YAAY,QAAQ,IAAI,KAAG,OAAO,CAAC,cAAc,CAuCrF,CAAA"}

package/dist/sources/mentions.js

@@ -0,0 +1,78 @@
+const PAGE = 500;
+const ORGANIZATIONS_LISTED = 500;
+const escaped = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+const folded = (text) => text.normalize("NFC").toLocaleLowerCase();
+/**
+ * The document's own mentions, read from cli-core's list of every document's mentions. The list is ordered by each
+ * document's time, newest first, then its id, so one document's mentions come together and the walk stops once it is
+ * past them, or past where they would be.
+ */
+const mentionsOf = async (store, note) => {
+    const id = Number(note.id);
+    const at = note.modifiedAt ?? note.updatedAt;
+    const found = [];
+    for (let offset = 0;; offset += PAGE) {
+        const page = await store.sourceMentions.list("document", undefined, { limit: PAGE, offset }, []);
+        for (const mention of page.items) {
+            const when = mention.source.at ?? "";
+            if (mention.source.id === id)
+                found.push(mention);
+            else if (found.length > 0 || when < at || (when === at && mention.source.id < id))
+                return found;
+        }
+        if (!page.hasMore)
+            return found;
+    }
+};
+/**
+ * People and organizations memo knows whose names appear in a document. People come from cli-core's mentions: a
+ * name it found, linked or matching known people, and an e-mail address or phone number a person owns. Organizations
+ * are matched by their whole name in the text, since no mention kind finds them.
+ */
+export const namedIn = async (store, note) => {
+    const named = new Map();
+    const add = (ref, type, name, foundAs) => {
+        const entry = named.get(ref) ?? { ref, type, name, foundAs: [] };
+        if (!entry.foundAs.includes(foundAs))
+            entry.foundAs.push(foundAs);
+        named.set(ref, entry);
+    };
+    const candidates = new Map();
+    for (const mention of await mentionsOf(store, note)) {
+        if (mention.status === "dismissed")
+            continue;
+        if (mention.kind === "person-name") {
+            let people = mention.target?.startsWith("person:") ? [mention.target] : candidates.get(mention.value);
+            if (people === undefined) {
+                people = (await store.sourceMentions.show(mention.id, []))?.candidates ?? [];
+                candidates.set(mention.value, people);
+            }
+            for (const ref of people)
+                add(ref, "person", null, mention.written);
+        }
+        else if (mention.kind === "email" || mention.kind === "phone") {
+            const person = await store.people.personOf({ provider: mention.kind, id: mention.value });
+            if (person)
+                add(`person:${person.uid}`, "person", person.name, mention.written);
+        }
+    }
+    for (const entry of named.values())
+        if (entry.name === null)
+            entry.name = (await store.people.personByUid(entry.ref.slice("person:".length)))?.name ?? null;
+    const text = folded(`${note.title ?? ""}\n${note.text}`);
+    const organizations = await store.knowledge.organizations();
+    for (const organization of organizations) {
+        const name = organization.name.trim();
+        if (name.length < 3)
+            continue;
+        const at = new RegExp(`(?<![\\p{L}\\p{N}])${escaped(folded(name))}(?![\\p{L}\\p{N}])`, "u");
+        if (at.test(text))
+            add(organization.ref, "organization", organization.name, name);
+    }
+    return {
+        items: [...named.values()],
+        organizationsChecked: organizations.length,
+        organizationsComplete: organizations.length < ORGANIZATIONS_LISTED,
+    };
+};
+//# sourceMappingURL=mentions.js.map

package/dist/sources/mentions.js.map

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

package/dist/sources/read.d.ts

@@ -0,0 +1,30 @@
+import { type FetchPageOptions, type LoadEngine, type Section } from "@wirecat/cli-core/documents";
+import type { AddedSourceInput } from "@wirecat/cli-core/store";
+/** What memo's folder import keeps of a file's text; `--max-chars` may raise it to the store's own limit. */
+export declare const SOURCE_TEXT_CHARS = 200000;
+export declare const isUrl: (given: string) => boolean;
+export type SourceArgument = "text" | "url" | "path";
+export declare const argumentKind: (given: string) => SourceArgument;
+/** A source as read, before it is stored: what `saveAddedSource` takes, and what the answer reports. */
+export interface ReadSource extends Pick<AddedSourceInput, "kind" | "text" | "read" | "url" | "fileName" | "mime" | "bytes" | "metadata"> {
+    size: number;
+    extractor: string | null;
+    truncated: boolean;
+    title: string | null;
+    sections?: Section[];
+}
+/** cli-core's refusal, with the plain next step memo knows for it; its code and reason stay as they were. */
+export declare const withNextStep: (error: unknown) => unknown;
+export declare const readText: (stdin: AsyncIterable<string | Uint8Array>, { maxChars }: {
+    maxChars: number;
+}) => Promise<ReadSource>;
+export declare const readFile: (path: string, { maxChars, load }: {
+    maxChars: number;
+    load?: LoadEngine;
+}) => Promise<ReadSource>;
+/** The page as read from its address; only the address as given is kept, never where its redirects ended. */
+export declare const readPage: (address: string, { maxChars, fetch }: {
+    maxChars: number;
+    fetch?: FetchPageOptions;
+}) => Promise<ReadSource>;
+//# sourceMappingURL=read.d.ts.map

package/dist/sources/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/sources/read.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,gBAAgB,EAGrB,KAAK,UAAU,EAEf,KAAK,OAAO,EACb,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE/D,6GAA6G;AAC7G,eAAO,MAAM,iBAAiB,SAAU,CAAA;AAIxC,eAAO,MAAM,KAAK,UAAW,MAAM,YAAyB,CAAA;AAE5D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;AAEpD,eAAO,MAAM,YAAY,UAAW,MAAM,KAAG,cAA0E,CAAA;AAEvH,wGAAwG;AACxG,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAC7G,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CACrB;AA0CD,6GAA6G;AAC7G,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,OAK7C,CAAA;AAqDD,eAAO,MAAM,QAAQ,UACZ,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,gBAC3B;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KACjC,OAAO,CAAC,UAAU,CAgBpB,CAAA;AAED,eAAO,MAAM,QAAQ,SACb,MAAM,sBACuB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAA;CAAE,KACzE,OAAO,CAAC,UAAU,CAwCpB,CAAA;AAED,6GAA6G;AAC7G,eAAO,MAAM,QAAQ,YACV,MAAM,uBACM;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,KAClE,OAAO,CAAC,UAAU,CAkBpB,CAAA"}