@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/store/sqlite/accounts.js

@@ -0,0 +1,163 @@
+import { CliError } from "@wirecat/cli-base";
+import { and, asc, eq, inArray, sql } from "./drizzle/core.js";
+import { pointerPairs } from "./entity-types.js";
+import { accountIdentities, accounts, aliases, botUpdates, chatMembers, chats, chunks, fetchLeases, involvements, memberCounts, memberObservationMembers, memberObservations, memberStays, messageRevisions, messages, messageTranscripts, projects, syncCursors, syncRanges, syncs, } from "./schema.js";
+/** An account's row, made on first sight; a name only replaces what was known when there is one. */
+export const accountPk = ({ orm, now }, { provider, account, scope }, name = null) => Number(orm
+    .insert(accounts)
+    .values({ provider, externalId: account, name, scope: scope ?? "personal", createdAt: now(), updatedAt: now() })
+    .onConflictDoUpdate({
+    target: [accounts.provider, accounts.externalId],
+    set: {
+        scope: scope ?? sql `${accounts.scope}`,
+        name: sql `coalesce(excluded.name, ${accounts.name})`,
+        updatedAt: sql `excluded.updated_at`,
+    },
+})
+    .returning({ pk: accounts.id })
+    .get()?.pk);
+export const findAccountPk = ({ orm }, { provider, account }) => orm
+    .select({ pk: accounts.id })
+    .from(accounts)
+    .where(and(eq(accounts.provider, provider), eq(accounts.externalId, account)))
+    .get()?.pk;
+export const accountName = ({ orm }, { provider, account }) => orm
+    .select({ name: accounts.name })
+    .from(accounts)
+    .where(and(eq(accounts.provider, provider), eq(accounts.externalId, account)))
+    .get()?.name ?? null;
+export const heldAccounts = ({ orm }) => orm
+    .select({ provider: accounts.provider, account: accounts.externalId })
+    .from(accounts)
+    .orderBy(asc(accounts.provider), asc(accounts.externalId))
+    .all();
+/** Every account with the store's id for it, by provider then external id. */
+const STORED = {
+    id: accounts.id,
+    provider: accounts.provider,
+    account: accounts.externalId,
+    name: accounts.name,
+    scope: accounts.scope,
+};
+export const storedAccounts = ({ orm }) => orm.select(STORED).from(accounts).orderBy(asc(accounts.provider), asc(accounts.externalId)).all();
+/** One account by provider and external id, never created; a missing one is `not_found`. */
+export const storedAccount = ({ orm }, { provider, account }) => {
+    const found = orm
+        .select(STORED)
+        .from(accounts)
+        .where(and(eq(accounts.provider, provider), eq(accounts.externalId, account)))
+        .get();
+    if (!found)
+        throw new CliError("not_found", `no ${provider} account ${account} in the store`);
+    return found;
+};
+/** Everything the account holds, children before parents: the foreign keys are enforced. */
+export const purgeAccount = ({ orm, database }, accountKey) => {
+    const unseenBefore = unreferenced(database, "identities");
+    const chatsOf = orm.select({ pk: chats.id }).from(chats).where(eq(chats.accountId, accountKey));
+    const messagesOf = orm.select({ pk: messages.id }).from(messages).where(eq(messages.accountId, accountKey));
+    orm.delete(botUpdates).where(eq(botUpdates.accountId, accountKey)).run();
+    orm.delete(involvements).where(eq(involvements.accountId, accountKey)).run();
+    // Vectors are keyed by text: those of this account's pieces go at the end, unless another piece holds that text.
+    const hashes = orm
+        .all(sql `SELECT DISTINCT content_hash AS hash FROM chunks WHERE account_id = ${accountKey}`)
+        .map(({ hash }) => hash);
+    orm.delete(chunks).where(eq(chunks.accountId, accountKey)).run();
+    orm.delete(aliases).where(eq(aliases.accountId, accountKey)).run();
+    orm.delete(syncs).where(eq(syncs.accountId, accountKey)).run();
+    orm.delete(messageTranscripts).where(inArray(messageTranscripts.chatId, chatsOf)).run();
+    orm.delete(fetchLeases).where(inArray(fetchLeases.chatId, chatsOf)).run();
+    orm.delete(chatMembers).where(inArray(chatMembers.chatId, chatsOf)).run();
+    const observationsOf = orm
+        .select({ id: memberObservations.id })
+        .from(memberObservations)
+        .where(inArray(memberObservations.chatId, chatsOf));
+    orm
+        .delete(memberObservationMembers)
+        .where(inArray(memberObservationMembers.memberObservationId, observationsOf))
+        .run();
+    orm.delete(memberObservations).where(inArray(memberObservations.chatId, chatsOf)).run();
+    orm.delete(memberStays).where(inArray(memberStays.chatId, chatsOf)).run();
+    orm.delete(memberCounts).where(inArray(memberCounts.chatId, chatsOf)).run();
+    orm.delete(syncRanges).where(inArray(syncRanges.chatId, chatsOf)).run();
+    orm.delete(messageRevisions).where(inArray(messageRevisions.messageId, messagesOf)).run();
+    orm.delete(messages).where(eq(messages.accountId, accountKey)).run();
+    orm.delete(chats).where(eq(chats.accountId, accountKey)).run();
+    orm.delete(syncCursors).where(eq(syncCursors.accountId, accountKey)).run();
+    // Deleting an email clears its recipients, mailboxes, words, attachments and tags (trigger email_bd).
+    orm.run(sql `DELETE FROM emails WHERE account_id = ${accountKey}`);
+    orm.run(sql `DELETE FROM taggings WHERE taggable_type = 'email_thread' AND taggable_id IN (SELECT id FROM email_threads WHERE account_id = ${accountKey})`);
+    orm.run(sql `DELETE FROM email_threads WHERE account_id = ${accountKey}`);
+    orm.run(sql `DELETE FROM mailboxes WHERE account_id = ${accountKey}`);
+    // Meetings have no delete trigger: children first, then what points at a meeting, then the meetings.
+    const meetingsOf = sql `(SELECT id FROM meetings WHERE account_id = ${accountKey})`;
+    orm.run(sql `DELETE FROM meeting_transcript_rows WHERE meeting_transcript_id IN (SELECT id FROM meeting_transcripts WHERE meeting_id IN ${meetingsOf})`);
+    orm.run(sql `DELETE FROM meeting_transcripts WHERE meeting_id IN ${meetingsOf}`);
+    orm.run(sql `DELETE FROM meeting_chat_messages WHERE meeting_id IN ${meetingsOf}`);
+    orm.run(sql `DELETE FROM meeting_summaries WHERE meeting_id IN ${meetingsOf}`);
+    orm.run(sql `DELETE FROM meeting_participants WHERE meeting_id IN ${meetingsOf}`);
+    orm.run(sql `DELETE FROM attachments WHERE attachable_type = 'meeting' AND attachable_id IN ${meetingsOf}`);
+    orm.run(sql `DELETE FROM taggings WHERE taggable_type = 'meeting' AND taggable_id IN ${meetingsOf}`);
+    orm.run(sql `DELETE FROM links WHERE (from_type = 'meeting' AND from_id IN ${meetingsOf}) OR (to_type = 'meeting' AND to_id IN ${meetingsOf})`);
+    orm.run(sql `DELETE FROM meetings WHERE account_id = ${accountKey}`);
+    orm.run(sql `DELETE FROM meeting_series WHERE account_id = ${accountKey}`);
+    orm.delete(accountIdentities).where(eq(accountIdentities.accountId, accountKey)).run();
+    // The inbox project and its tasks are the owner's; only the tie to the account goes.
+    orm.update(projects).set({ accountId: null }).where(eq(projects.accountId, accountKey)).run();
+    orm.delete(accounts).where(eq(accounts.id, accountKey)).run();
+    dropOrphanPeople(database, unseenBefore);
+    orm.run(sql `DELETE FROM embeddings WHERE content_hash IN (SELECT value FROM json_each(${JSON.stringify(hashes)}))
+      AND NOT EXISTS (SELECT 1 FROM chunks k WHERE k.content_hash = embeddings.content_hash)`);
+};
+/** Identity and person rows a person's own record keeps, not evidence that anyone saw them. */
+const OWN = new Set(["identity_links", "identity_link_events", "identity_revisions"]);
+/** Every row that points at `table`: foreign keys and `<name>_type` pointers, read from the store so a new one counts. */
+const referencesTo = (database, table, skip) => {
+    const keys = database
+        .prepare(`SELECT m.name AS tbl, f."from" AS col FROM sqlite_master m JOIN pragma_foreign_key_list(m.name) f
+        WHERE m.type = 'table' AND f."table" = ?`)
+        .all(table)
+        .filter((row) => !skip.has(String(row.tbl)))
+        .map((row) => `SELECT "${String(row.col)}" AS id FROM "${String(row.tbl)}"`);
+    const type = table === "identities" ? "identity" : "person";
+    const pointers = pointerPairs(database).map(({ table: tbl, pointer }) => `SELECT ${pointer}_id AS id FROM "${tbl}" WHERE ${pointer}_type = '${type}'`);
+    return [...keys, ...pointers].join(" UNION ");
+};
+const unreferenced = (database, table) => new Set(database
+    .prepare(`SELECT id FROM ${table} WHERE id NOT IN (SELECT id FROM (${referencesTo(database, table, OWN)}) WHERE id IS NOT NULL)`)
+    .all()
+    .map(({ id }) => Number(id)));
+/**
+ * People only the purged account had seen go with it. An identity stays while anything else points at it
+ * (another account, a tag, a note, a link), or while its person is kept: the owner, a person something
+ * points at, or one linked to an identity that stays.
+ */
+const dropOrphanPeople = (database, unseenBefore) => {
+    const orphans = [...unreferenced(database, "identities")].filter((id) => !unseenBefore.has(id));
+    if (orphans.length === 0)
+        return;
+    const ids = JSON.stringify(orphans);
+    const personRefs = referencesTo(database, "persons", OWN);
+    const kept = new Set(database
+        .prepare(`SELECT DISTINCT l.identity_id AS id FROM identity_links l JOIN persons p ON p.id = l.person_id
+          WHERE l.identity_id IN (SELECT value FROM json_each(?)) AND (p.owner <> 0
+            OR p.id IN (SELECT id FROM (${personRefs}) WHERE id IS NOT NULL)
+            OR EXISTS (SELECT 1 FROM identity_links o WHERE o.person_id = p.id
+              AND o.identity_id NOT IN (SELECT value FROM json_each(?))))`)
+        .all(ids, ids)
+        .map(({ id }) => Number(id)));
+    const gone = JSON.stringify(orphans.filter((id) => !kept.has(id)));
+    const persons = database
+        .prepare("SELECT DISTINCT person_id AS id FROM identity_links WHERE identity_id IN (SELECT value FROM json_each(?))")
+        .all(gone)
+        .map(({ id }) => Number(id));
+    for (const table of ["identity_revisions", "identity_link_events", "identity_links"])
+        database.prepare(`DELETE FROM ${table} WHERE identity_id IN (SELECT value FROM json_each(?))`).run(gone);
+    database.prepare("DELETE FROM identities WHERE id IN (SELECT value FROM json_each(?))").run(gone);
+    database
+        .prepare(`DELETE FROM persons WHERE id IN (SELECT value FROM json_each(?)) AND owner = 0
+        AND NOT EXISTS (SELECT 1 FROM identity_links l WHERE l.person_id = persons.id)
+        AND id NOT IN (SELECT id FROM (${referencesTo(database, "persons", new Set(["identity_links"]))}) WHERE id IS NOT NULL)`)
+        .run(JSON.stringify(persons));
+};
+//# sourceMappingURL=accounts.js.map

package/dist/store/sqlite/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../../src/store/sqlite/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,WAAW,EACX,KAAK,EACL,MAAM,EACN,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,UAAU,EACV,KAAK,GACN,MAAM,aAAa,CAAA;AAEpB,oGAAoG;AACpG,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,EAAE,GAAG,EAAE,GAAG,EAAgB,EAC1B,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAc,EACxC,IAAI,GAAkB,IAAI,EAC1B,EAAE,CACF,MAAM,CACJ,GAAG;KACA,MAAM,CAAC,QAAQ,CAAC;KAChB,MAAM,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC;KAC/G,kBAAkB,CAAC;IAClB,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC;IAChD,GAAG,EAAE;QACH,KAAK,EAAE,KAAK,IAAI,GAAG,CAAA,GAAG,QAAQ,CAAC,KAAK,EAAE;QACtC,IAAI,EAAE,GAAG,CAAA,2BAA2B,QAAQ,CAAC,IAAI,GAAG;QACpD,SAAS,EAAE,GAAG,CAAA,qBAAqB;KACpC;CACF,CAAC;KACD,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;KAC9B,GAAG,EAAE,EAAE,EAAE,CACb,CAAA;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAE,GAAG,EAAgB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAc,EAAsB,EAAE,CAC5G,GAAG;KACA,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;KAC3B,IAAI,CAAC,QAAQ,CAAC;KACd,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;KAC7E,GAAG,EAAE,EAAE,EAAE,CAAA;AAEd,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,GAAG,EAAgB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAc,EAAiB,EAAE,CACrG,GAAG;KACA,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;KAC/B,IAAI,CAAC,QAAQ,CAAC;KACd,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;KAC7E,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,CAAA;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,GAAG,EAAgB,EAAgB,EAAE,CAClE,GAAG;KACA,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;KACrE,IAAI,CAAC,QAAQ,CAAC;KACd,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;KACzD,GAAG,EAAE,CAAA;AAEV,8EAA8E;AAC9E,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,QAAQ,CAAC,EAAE;IACf,QAAQ,EAAE,QAAQ,CAAC,QAAQ;IAC3B,OAAO,EAAE,QAAQ,CAAC,UAAU;IAC5B,IAAI,EAAE,QAAQ,CAAC,IAAI;IACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;CACtB,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAE,GAAG,EAAgB,EAAmB,EAAE,CACvE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAqB,CAAA;AAEtH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAE,GAAG,EAAgB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAc,EAAiB,EAAE;IACvG,MAAM,KAAK,GAAG,GAAG;SACd,MAAM,CAAC,MAAM,CAAC;SACd,IAAI,CAAC,QAAQ,CAAC;SACd,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;SAC7E,GAAG,EAAE,CAAA;IACR,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,MAAM,QAAQ,YAAY,OAAO,eAAe,CAAC,CAAA;IAC7F,OAAO,KAAsB,CAAA;AAC/B,CAAC,CAAA;AAED,4FAA4F;AAC5F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAgB,EAAE,UAAkB,EAAQ,EAAE;IACxF,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IACzD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAA;IAC/F,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAA;IAC3G,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACxE,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IAC5E,iHAAiH;IACjH,MAAM,MAAM,GAAG,GAAG;SACf,GAAG,CAAmB,GAAG,CAAA,uEAAuE,UAAU,EAAE,CAAC;SAC7G,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAC1B,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IAChE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IAClE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IAC9D,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACvF,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACzE,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACzE,MAAM,cAAc,GAAG,GAAG;SACvB,MAAM,CAAC,EAAE,EAAE,EAAE,kBAAkB,CAAC,EAAE,EAAE,CAAC;SACrC,IAAI,CAAC,kBAAkB,CAAC;SACxB,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACrD,GAAG;SACA,MAAM,CAAC,wBAAwB,CAAC;SAChC,KAAK,CAAC,OAAO,CAAC,wBAAwB,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;SAC5E,GAAG,EAAE,CAAA;IACR,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACvF,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACzE,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IAC3E,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACvE,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACzF,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACpE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IAC9D,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IAC1E,sGAAsG;IACtG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,yCAAyC,UAAU,EAAE,CAAC,CAAA;IACjE,GAAG,CAAC,GAAG,CACL,GAAG,CAAA,iIAAiI,UAAU,GAAG,CAClJ,CAAA;IACD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,gDAAgD,UAAU,EAAE,CAAC,CAAA;IACxE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,4CAA4C,UAAU,EAAE,CAAC,CAAA;IACpE,qGAAqG;IACrG,MAAM,UAAU,GAAG,GAAG,CAAA,+CAA+C,UAAU,GAAG,CAAA;IAClF,GAAG,CAAC,GAAG,CACL,GAAG,CAAA,8HAA8H,UAAU,GAAG,CAC/I,CAAA;IACD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,uDAAuD,UAAU,EAAE,CAAC,CAAA;IAC/E,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,yDAAyD,UAAU,EAAE,CAAC,CAAA;IACjF,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,qDAAqD,UAAU,EAAE,CAAC,CAAA;IAC7E,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,wDAAwD,UAAU,EAAE,CAAC,CAAA;IAChF,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,kFAAkF,UAAU,EAAE,CAAC,CAAA;IAC1G,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,2EAA2E,UAAU,EAAE,CAAC,CAAA;IACnG,GAAG,CAAC,GAAG,CACL,GAAG,CAAA,iEAAiE,UAAU,0CAA0C,UAAU,GAAG,CACtI,CAAA;IACD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,2CAA2C,UAAU,EAAE,CAAC,CAAA;IACnE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAA,iDAAiD,UAAU,EAAE,CAAC,CAAA;IACzE,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACtF,qFAAqF;IACrF,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IAC7F,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IAC7D,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;IACxC,GAAG,CAAC,GAAG,CACL,GAAG,CAAA,6EAA6E,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;6FACb,CAC1F,CAAA;AACH,CAAC,CAAA;AAED,+FAA+F;AAC/F,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,oBAAoB,CAAC,CAAC,CAAA;AAErF,0HAA0H;AAC1H,MAAM,YAAY,GAAG,CAAC,QAAuB,EAAE,KAA+B,EAAE,IAAiB,EAAU,EAAE;IAC3G,MAAM,IAAI,GAAG,QAAQ;SAClB,OAAO,CACN;iDAC2C,CAC5C;SACA,GAAG,CAAC,KAAK,CAAC;SACV,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;SAC3C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC9E,MAAM,IAAI,GAAG,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC3D,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,GAAG,CACzC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,UAAU,OAAO,mBAAmB,GAAG,WAAW,OAAO,YAAY,IAAI,GAAG,CAC1G,CAAA;IACD,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AAC/C,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,QAAuB,EAAE,KAAmB,EAAe,EAAE,CACjF,IAAI,GAAG,CACL,QAAQ;KACL,OAAO,CACN,kBAAkB,KAAK,qCAAqC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,yBAAyB,CACxH;KACA,GAAG,EAAE;KACL,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAC/B,CAAA;AAEH;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,CAAC,QAAuB,EAAE,YAAyB,EAAE,EAAE;IAC9E,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IACnC,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAA;IACzD,MAAM,IAAI,GAAG,IAAI,GAAG,CAClB,QAAQ;SACL,OAAO,CACN;;0CAEkC,UAAU;;0EAEsB,CACnE;SACA,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC;SACb,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAC/B,CAAA;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAClE,MAAM,OAAO,GAAG,QAAQ;SACrB,OAAO,CACN,2GAA2G,CAC5G;SACA,GAAG,CAAC,IAAI,CAAC;SACT,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;IAC9B,KAAK,MAAM,KAAK,IAAI,CAAC,oBAAoB,EAAE,sBAAsB,EAAE,gBAAgB,CAAC;QAClF,QAAQ,CAAC,OAAO,CAAC,eAAe,KAAK,wDAAwD,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC1G,QAAQ,CAAC,OAAO,CAAC,qEAAqE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjG,QAAQ;SACL,OAAO,CACN;;yCAEmC,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,yBAAyB,CAC3H;SACA,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;AACjC,CAAC,CAAA"}

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

@@ -0,0 +1,21 @@
+import type { CacheDatabase } from "../driver.js";
+/** Who made or owns something: the store's polymorphic actor pair. */
+export interface Actor {
+    type: "person" | "bot";
+    id: number;
+}
+/** How the task package names who acted; each maps to one stable actor row. */
+export type Origin = "owner" | "agent" | "rule";
+declare const BOT_KINDS: readonly ["agent", "script", "integration"];
+/** The owner's person row, which the initial migration seeds. */
+export declare const ownerPerson: (database: CacheDatabase) => Actor;
+/** A bot by its unique handle, registered on first use. */
+export declare const botNamed: (database: CacheDatabase, name: string, now: number, kind?: (typeof BOT_KINDS)[number]) => Actor;
+/**
+ * The task package's origins as actors: the owner is the owner's person, a rule and an unnamed agent are
+ * the seeded bots `rule` and `agent`.
+ */
+export declare const actorOfOrigin: (database: CacheDatabase, origin: Origin) => Actor;
+export declare const originOfActor: (database: CacheDatabase, type: unknown, id: unknown) => Origin | undefined;
+export {};
+//# sourceMappingURL=actors.d.ts.map

package/dist/store/sqlite/actors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actors.d.ts","sourceRoot":"","sources":["../../../src/store/sqlite/actors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,sEAAsE;AACtE,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAA;IACtB,EAAE,EAAE,MAAM,CAAA;CACX;AAED,+EAA+E;AAC/E,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;AAE/C,QAAA,MAAM,SAAS,YAAI,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAA;AAE7D,iEAAiE;AACjE,eAAO,MAAM,WAAW,aAAc,aAAa,KAAG,KAIrD,CAAA;AAED,2DAA2D;AAC3D,eAAO,MAAM,QAAQ,aACT,aAAa,QACjB,MAAM,OACP,MAAM,SACL,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,KAC/B,KAWF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,aAAc,aAAa,UAAU,MAAM,KAAG,KAKvE,CAAA;AAED,eAAO,MAAM,aAAa,aAAc,aAAa,QAAQ,OAAO,MAAM,OAAO,KAAG,MAAM,GAAG,SAI5F,CAAA"}

package/dist/store/sqlite/actors.js

@@ -0,0 +1,44 @@
+import { CliError } from "@wirecat/cli-base";
+const BOT_KINDS = ["agent", "script", "integration"];
+/** The owner's person row, which the initial migration seeds. */
+export const ownerPerson = (database) => {
+    const found = database.prepare("SELECT id FROM persons WHERE owner = 1 ORDER BY id LIMIT 1").get();
+    if (!found)
+        throw new CliError("configuration_error", "the store has no owner person");
+    return { type: "person", id: Number(found.id) };
+};
+/** A bot by its unique handle, registered on first use. */
+export const botNamed = (database, name, now, kind = "agent") => {
+    const handle = name.trim();
+    if (!handle || handle.length > 100)
+        throw new CliError("validation_error", "a bot's name takes 1–100 characters");
+    if (!BOT_KINDS.includes(kind))
+        throw new CliError("validation_error", `a bot's kind is one of ${BOT_KINDS.join(", ")}`);
+    const found = database.prepare("SELECT id FROM bots WHERE name = ?").get(handle);
+    if (found)
+        return { type: "bot", id: Number(found.id) };
+    const made = database
+        .prepare("INSERT INTO bots (name, kind, created_at, updated_at) VALUES (?, ?, ?, ?) RETURNING id")
+        .get(handle, kind, now, now);
+    return { type: "bot", id: Number(made?.id) };
+};
+/**
+ * The task package's origins as actors: the owner is the owner's person, a rule and an unnamed agent are
+ * the seeded bots `rule` and `agent`.
+ */
+export const actorOfOrigin = (database, origin) => {
+    if (origin === "owner")
+        return ownerPerson(database);
+    const found = database.prepare("SELECT id FROM bots WHERE name = ?").get(origin);
+    if (!found)
+        throw new CliError("configuration_error", `the store has no bot ${origin}`);
+    return { type: "bot", id: Number(found.id) };
+};
+export const originOfActor = (database, type, id) => {
+    if (type == null || id == null)
+        return undefined;
+    if (type === "person")
+        return "owner";
+    return database.prepare("SELECT name FROM bots WHERE id = ?").get(Number(id))?.name === "rule" ? "rule" : "agent";
+};
+//# sourceMappingURL=actors.js.map

package/dist/store/sqlite/actors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actors.js","sourceRoot":"","sources":["../../../src/store/sqlite/actors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAY5C,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAA;AAE7D,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAuB,EAAS,EAAE;IAC5D,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,4DAA4D,CAAC,CAAC,GAAG,EAAE,CAAA;IAClG,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,+BAA+B,CAAC,CAAA;IACtF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAA;AACjD,CAAC,CAAA;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,QAAuB,EACvB,IAAY,EACZ,GAAW,EACX,IAAI,GAA+B,OAAO,EACnC,EAAE;IACT,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC1B,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,qCAAqC,CAAC,CAAA;IACjH,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC3B,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC1F,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAChF,IAAI,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAA;IACvD,MAAM,IAAI,GAAG,QAAQ;SAClB,OAAO,CAAC,wFAAwF,CAAC;SACjG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAA;AAC9C,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAuB,EAAE,MAAc,EAAS,EAAE;IAC9E,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAA;IACpD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAChF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,wBAAwB,MAAM,EAAE,CAAC,CAAA;IACvF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAA;AAC9C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAuB,EAAE,IAAa,EAAE,EAAW,EAAsB,EAAE;IACvG,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IAChD,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAA;IACrC,OAAO,QAAQ,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;AACnH,CAAC,CAAA"}

package/dist/store/sqlite/admin-statistics.d.ts

@@ -0,0 +1,54 @@
+import { type AdminOptions, type AdminRow, calculateAdminStatistics } from "../../domain/admin-statistics.js";
+import { type CounterState } from "../../domain/counters.js";
+import type { QueryExecution } from "../../search/lucene/resolved.js";
+import type { StoredHit } from "../store.js";
+import type { StoreContext } from "./open.js";
+export interface AdminStoreRequest {
+    options: AdminOptions;
+    evidence?: {
+        entity: {
+            account: {
+                provider: string;
+                account: string;
+            };
+            id: string;
+        };
+        cursor?: string;
+    };
+}
+export interface AdminEvidenceItem {
+    message: StoredHit;
+    related?: StoredHit;
+    contribution: number | null;
+    counters?: CounterState[];
+}
+export interface AdminStoreResult {
+    items: AdminRow[];
+    total: number;
+    included: number;
+    hasMore: boolean;
+    cutoff: string;
+    summary: ReturnType<typeof calculateAdminStatistics>["summary"];
+    quality: {
+        graph: ReturnType<typeof calculateAdminStatistics>["graph"];
+        archives: {
+            account: {
+                provider: string;
+                account: string;
+            };
+            chatId: string;
+            state: string;
+            fetchedAt: string | null;
+        }[];
+        membership: "observed_stays_only" | "not_used";
+        archivesTotal: number;
+        counterFreshness: "fresh" | "stale" | "partial" | "unknown";
+        answererRoles: "user_selected_identities";
+    };
+    evidence?: AdminEvidenceItem[];
+    nextCursor?: string | null;
+    fingerprint: string;
+    byteLimit: number;
+}
+export declare const adminStatisticsQuery: (context: StoreContext, execution: QueryExecution, request: AdminStoreRequest) => AdminStoreResult;
+//# sourceMappingURL=admin-statistics.d.ts.map

package/dist/store/sqlite/admin-statistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-statistics.d.ts","sourceRoot":"","sources":["../../../src/store/sqlite/admin-statistics.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,QAAQ,EAGb,wBAAwB,EACzB,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,0BAA0B,CAAA;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAErE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAI5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAI7C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,CAAA;IACrB,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE;YAAE,OAAO,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACvG;AACD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;CAC1B;AACD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,SAAS,CAAC,CAAA;IAC/D,OAAO,EAAE;QACP,KAAK,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,OAAO,CAAC,CAAA;QAC3D,QAAQ,EAAE;YACR,OAAO,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAA;YAC9C,MAAM,EAAE,MAAM,CAAA;YACd,KAAK,EAAE,MAAM,CAAA;YACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;SACzB,EAAE,CAAA;QACH,UAAU,EAAE,qBAAqB,GAAG,UAAU,CAAA;QAC9C,aAAa,EAAE,MAAM,CAAA;QACrB,gBAAgB,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;QAC3D,aAAa,EAAE,0BAA0B,CAAA;KAC1C,CAAA;IACD,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AASD,eAAO,MAAM,oBAAoB,YACtB,YAAY,aACV,cAAc,WAChB,iBAAiB,KACzB,gBA2NC,CAAA"}

package/dist/store/sqlite/admin-statistics.js

@@ -0,0 +1,206 @@
+import { createHash } from "node:crypto";
+import { CliError } from "@wirecat/cli-base";
+import { adminEntityKey, calculateAdminStatistics, } from "../../domain/admin-statistics.js";
+import { counterFreshness } from "../../domain/counters.js";
+import { RANKING_GRAPH_LIMITS, rankingGraphEvidence } from "../../domain/rankings-graph.js";
+import { chatCompleteness } from "./completeness.js";
+import { counterStates } from "./counters.js";
+import { withQuerySelection } from "./lucene.js";
+import { rankingCounter } from "./rankings.js";
+import { hitsByPk } from "./search.js";
+function fail(message, reason = "query.too-large") {
+    throw new CliError("validation_error", message, { reason, complete: false });
+}
+const joined = "FROM messages m JOIN chats c ON c.id=m.chat_id JOIN accounts ac ON ac.id=m.account_id LEFT JOIN identities i ON i.id=m.sender_identity_id";
+const attachmentSnapshot = `(SELECT json_group_array(json_object('position',position,'kind',kind,'mime',mime,'name',name,'title',title,'url',url,'size',size,'width',width,'height',height,'duration',duration,'providerRef',provider_ref,'localPath',local_path)) FROM attachments WHERE attachable_type='message' AND attachable_id=m.id)`;
+const snapshot = `json_object('edited',m.edited_at,'senderName',m.sender_name,'reply',m.reply_to,'forward',m.forward,'reactions',m.reactions,'outgoing',m.outgoing,'thread',m.thread_external_id,'attachments',${attachmentSnapshot},'counterObservations',(SELECT json_group_array(json_object('counter',counter,'value',value,'at',created_at,'source',source)) FROM message_counter_observations WHERE message_id=m.id))`;
+export const adminStatisticsQuery = (context, execution, request) => withQuerySelection(context, execution, (selection, check) => {
+    const { database } = context, { options } = request;
+    const prefix = `WITH selected AS (${selection.sql}) `;
+    const root = database
+        .prepare(`${prefix}SELECT min(m.sent_at) AS oldest,count(*) AS total ${joined} WHERE m.id IN (SELECT id FROM selected)`)
+        .get(...selection.params);
+    const lower = options.report === "newcomers" ? options.joinSince : Number(root?.oldest ?? options.cutoff);
+    const params = execution.accounts.flatMap((account) => [account.provider, account.account]);
+    let scope = `(${execution.accounts.map(() => "(ac.provider=? AND ac.external_id=?)").join(" OR ") || "0"})`;
+    if (execution.chat) {
+        scope += ` AND ac.provider=? AND ac.external_id=? AND (c.external_id=? OR c.external_id IN (SELECT json_extract(CASE WHEN json_valid(post.metadata) THEN post.metadata ELSE '{}' END,'$.graph.discussionChatId') FROM messages post JOIN chats source ON source.id=post.chat_id WHERE post.account_id=ac.id AND source.external_id=? AND source.kind='channel' AND post.deleted_at IS NULL))`;
+        params.push(execution.chat.account.provider, execution.chat.account.account, execution.chat.chatId, execution.chat.chatId);
+    }
+    else
+        scope += " AND c.searchable=1";
+    const where = `m.deleted_at IS NULL AND ${scope} AND (m.sent_at BETWEEN ? AND ?${options.report === "newcomers" ? "" : " OR m.id IN (SELECT id FROM selected)"})`;
+    const bound = [...selection.params, ...params, lower, options.cutoff];
+    const size = database
+        .prepare(`${prefix}SELECT count(*) AS n,sum(length(cast(m.text AS BLOB))+length(cast(coalesce(m.metadata,'') AS BLOB))+length(cast(${snapshot} AS BLOB))) AS bytes ${joined} WHERE ${where}`)
+        .get(...bound);
+    check();
+    if (Number(size?.n ?? 0) > RANKING_GRAPH_LIMITS.nodes || Number(size?.bytes ?? 0) > RANKING_GRAPH_LIMITS.bytes)
+        fail("admin statistics context exceeds node/byte budgets — narrow chat/date scope");
+    const raw = database
+        .prepare(`${prefix}SELECT m.id AS pk,m.external_id AS id,c.id AS chat_id,ac.id AS account_id,c.external_id AS chat,c.title AS title,c.kind,ac.provider,ac.external_id AS account,i.external_id AS sender,m.sender_chat_external_id AS sender_chat,i.bot,m.sent_at,m.text,m.metadata,${snapshot} AS snapshot,${rankingCounter("m", "views")} AS views,${rankingCounter("m", "comments")} AS comments,m.id IN (SELECT id FROM selected) AS selected ${joined} WHERE ${where} ORDER BY m.id`)
+        .all(...bound);
+    const nodes = raw.map((row) => {
+        let metadata = {};
+        try {
+            const value = JSON.parse(String(row.metadata ?? "{}"));
+            if (value && typeof value === "object")
+                metadata = value;
+        }
+        catch {
+            /* Invalid metadata remains unknown. */
+        }
+        const graph = rankingGraphEvidence(metadata.graph);
+        return {
+            pk: Number(row.pk),
+            id: String(row.id),
+            account: { provider: String(row.provider), account: String(row.account) },
+            chatId: String(row.chat),
+            chatKind: String(row.kind),
+            sender: row.sender === null ? null : String(row.sender),
+            senderIsChat: row.sender_chat !== null,
+            timestamp: Number(row.sent_at),
+            text: String(row.text),
+            selected: Number(row.selected) === 1,
+            event: Number(row.sent_at) <= options.cutoff,
+            ...(graph ? { graph } : {}),
+            views: row.views === null ? null : Number(row.views),
+            comments: row.comments === null ? null : Number(row.comments),
+            bot: Number(row.bot) === 1,
+        };
+    });
+    let stays = [];
+    if (options.report === "newcomers" && execution.chat) {
+        const chat = execution.chat;
+        const records = database
+            .prepare("SELECT i.external_id AS id,s.joined_at,s.first_seen_at,s.left_at FROM member_stays s JOIN identities i ON i.id=s.identity_id JOIN chats c ON c.id=s.chat_id JOIN accounts ac ON ac.id=c.account_id WHERE ac.provider=? AND ac.external_id=? AND c.external_id=? AND ((s.joined_at BETWEEN ? AND ?) OR (s.joined_at IS NULL AND s.first_seen_at BETWEEN ? AND ?)) ORDER BY s.id LIMIT ?")
+            .all(chat.account.provider, chat.account.account, chat.chatId, options.joinSince, options.joinUntil, options.joinSince, options.joinUntil, RANKING_GRAPH_LIMITS.nodes + 1);
+        if (records.length > RANKING_GRAPH_LIMITS.nodes)
+            fail("newcomer cohort exceeds node budget — narrow join dates");
+        stays = records.map((row) => ({
+            id: String(row.id),
+            account: chat.account,
+            chatId: chat.chatId,
+            joinedAt: row.joined_at === null ? null : Number(row.joined_at),
+            firstSeenAt: Number(row.first_seen_at),
+            goneAt: row.left_at === null ? null : Number(row.left_at),
+        }));
+    }
+    const serialized = JSON.stringify({
+        rows: raw,
+        stays,
+        execution: { root: execution.root, accounts: execution.accounts, chat: execution.chat },
+        options,
+    });
+    if (Buffer.byteLength(serialized) > RANKING_GRAPH_LIMITS.bytes)
+        fail("admin statistics serialized fingerprint exceeds 8 MiB — narrow scope");
+    const fingerprint = createHash("sha256").update(serialized).digest("hex");
+    const calculated = calculateAdminStatistics(nodes, stays, options, check);
+    const archives = [];
+    const seen = new Set();
+    for (const row of raw) {
+        const pk = Number(row.chat_id);
+        if (seen.has(pk))
+            continue;
+        seen.add(pk);
+        check();
+        if (archives.length >= 100)
+            continue;
+        const complete = chatCompleteness(context, Number(row.account_id), [String(row.chat)])[0];
+        archives.push({
+            account: { provider: String(row.provider), account: String(row.account) },
+            chatId: String(row.chat),
+            state: complete?.state ?? "unknown",
+            fetchedAt: complete?.fetchedAt ?? null,
+        });
+    }
+    const reportItems = calculated.items.slice(0, execution.limit).map((item) => {
+        const node = nodes.find((one) => item.message ===
+            `msg:${[one.account.provider, one.account.account, one.chatId, one.id].map(encodeURIComponent).join("/")}`);
+        return node ? { ...item, counterObservations: counterStates(context, node.pk, context.now(), 86_400_000) } : item;
+    });
+    const result = {
+        items: reportItems,
+        total: calculated.items.length,
+        included: Math.min(execution.limit, calculated.items.length),
+        hasMore: calculated.items.length > execution.limit,
+        cutoff: new Date(options.cutoff).toISOString(),
+        summary: calculated.summary,
+        quality: {
+            graph: calculated.graph,
+            archives,
+            archivesTotal: seen.size,
+            membership: options.report === "newcomers" ? "observed_stays_only" : "not_used",
+            counterFreshness: options.report === "discussion"
+                ? counterFreshness(reportItems.flatMap((item) => (item.counterObservations ?? []).filter((state) => state.counter === "views" || state.counter === "comments")))
+                : "unknown",
+            answererRoles: "user_selected_identities",
+        },
+        fingerprint,
+        byteLimit: 64 * 1024,
+    };
+    if (request.evidence) {
+        const rows = calculated.evidence.get(adminEntityKey(request.evidence.entity));
+        if (!rows)
+            fail("report row is no longer eligible — rerun its report", "selection.changed");
+        let offset = 0;
+        if (request.evidence.cursor) {
+            if (request.evidence.cursor.length > 4096)
+                fail("invalid evidence cursor", "invalid_cursor");
+            try {
+                const cursor = JSON.parse(Buffer.from(request.evidence.cursor, "base64url").toString());
+                if (!Number.isSafeInteger(cursor.offset) ||
+                    cursor.offset < 0 ||
+                    cursor.offset > rows.length ||
+                    cursor.fingerprint !== fingerprint ||
+                    cursor.entity !== adminEntityKey(request.evidence.entity))
+                    fail("stored evidence changed — restart the report", "selection.changed");
+                offset = cursor.offset;
+            }
+            catch (error) {
+                if (error instanceof CliError)
+                    throw error;
+                fail("invalid evidence cursor", "invalid_cursor");
+            }
+        }
+        const evidence = [];
+        let bytes = 2;
+        for (const row of rows.slice(offset, offset + execution.limit)) {
+            check();
+            const pks = [row.pk, ...(row.related === undefined ? [] : [row.related])];
+            const hits = hitsByPk(context, pks), message = hits[0];
+            if (!message)
+                fail("report evidence changed — rerun its report", "selection.changed");
+            const item = {
+                message,
+                counters: counterStates(context, row.pk, context.now(), 86_400_000),
+                ...(row.related === undefined ? {} : { related: hits[1] }),
+                contribution: row.contribution,
+            };
+            const size = Buffer.byteLength(JSON.stringify(item)) + 1;
+            if (bytes + size > 64 * 1024) {
+                if (!evidence.length)
+                    fail("one evidence item exceeds 64 KiB — open its message locator", "evidence_item_too_large");
+                break;
+            }
+            evidence.push(item);
+            bytes += size;
+        }
+        const hasMore = offset + evidence.length < rows.length;
+        result.items = [];
+        result.evidence = evidence;
+        result.total = rows.length;
+        result.included = evidence.length;
+        result.hasMore = hasMore;
+        result.nextCursor = hasMore
+            ? Buffer.from(JSON.stringify({
+                offset: offset + evidence.length,
+                fingerprint,
+                entity: adminEntityKey(request.evidence.entity),
+            })).toString("base64url")
+            : null;
+    }
+    check();
+    return result;
+});
+//# sourceMappingURL=admin-statistics.js.map

package/dist/store/sqlite/admin-statistics.js.map

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

package/dist/store/sqlite/agent-actions.d.ts

@@ -0,0 +1,50 @@
+import type { Actor } from "./actors.js";
+import { type Author } from "./memories.js";
+import type { StoreContext } from "./open.js";
+export declare const ACTION_TIERS: readonly ["read", "draft", "write-private", "write-public", "destructive", "admin"];
+export declare const ACTION_OUTCOMES: readonly ["ok", "refused", "failed"];
+/**
+ * One tool call as the audit trail keeps it: who, which tool, at what tier, on what, how it ended. Never the
+ * arguments or the answer: `error` is a short code, not a message that could quote them.
+ */
+export interface AgentActionInput {
+    actor: Author;
+    tool: string;
+    tier: (typeof ACTION_TIERS)[number];
+    /** A reference to what it acted on, when the caller knows one. */
+    target?: string;
+    status: (typeof ACTION_OUTCOMES)[number];
+    error?: string;
+    startedAt: number;
+    finishedAt: number;
+}
+export interface AgentAction {
+    id: string;
+    /** `name` is a bot's handle; `null` for a person. */
+    actor: {
+        type: Actor["type"];
+        id: string;
+        name: string | null;
+    };
+    tool: string;
+    tier: AgentActionInput["tier"];
+    target: {
+        type: string;
+        id: string;
+    } | null;
+    status: AgentActionInput["status"];
+    error: string | null;
+    startedAt: string;
+    finishedAt: string | null;
+}
+export interface AgentActionsStore {
+    record(input: AgentActionInput): Promise<AgentAction>;
+    /** Newest first; `agent` is a bot's name, such as `tg-mcp`. */
+    list(options?: {
+        tool?: string;
+        agent?: string;
+        limit?: number;
+    }): Promise<AgentAction[]>;
+}
+export declare const agentActionsStoreOver: (context: StoreContext, afterRecord?: () => void) => AgentActionsStore;
+//# sourceMappingURL=agent-actions.d.ts.map

package/dist/store/sqlite/agent-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-actions.d.ts","sourceRoot":"","sources":["../../../src/store/sqlite/agent-actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,KAAK,MAAM,EAAe,MAAM,eAAe,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAG7C,eAAO,MAAM,YAAY,YAAI,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,CAAU,CAAA;AAC/G,eAAO,MAAM,eAAe,YAAI,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAA;AAEnE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;IACnC,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,qDAAqD;IACrD,KAAK,EAAE;QAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC9B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC3C,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IACrD,+DAA+D;IAC/D,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;CAC1F;AAMD,eAAO,MAAM,qBAAqB,YAAa,YAAY,gBAAe,MAAM,IAAI,KAAc,iBA0DjG,CAAA"}