@wirecat/cli-core 0.555.0 → 0.557.0

package/dist/mail/marks.js

@@ -0,0 +1,178 @@
+import { CliError } from "@wirecat/cli-base";
+/** A holder's name: what `--holder` takes and the mark's key ends with. */
+export const HOLDER = /^[a-z0-9][a-z0-9-]{0,39}$/;
+/** At most this many emails are read past the mark in one go; the rest come with the next read. */
+export const MARK_BATCH = 200;
+/** A partial email waits this long to be stored whole, then is skipped. */
+export const HOLD_PARTIAL_MS = 7 * 86_400_000;
+/** Held emails kept on one mark at most; past it the oldest are skipped as partial. */
+const MOST_HELD = 500;
+const PREFIX = "consumer:";
+const noneSkipped = () => ({ bulk: 0, envelope: 0, partial: 0, draft: 0 });
+const keyOf = (holder) => {
+    if (!HOLDER.test(holder))
+        throw new CliError("validation_error", `a holder is lower-case letters, digits and dashes, not "${holder}"`);
+    return `${PREFIX}${holder}`;
+};
+const parsed = (holder, value, at) => {
+    try {
+        const saved = JSON.parse(value);
+        if (typeof saved.throughId !== "number")
+            return undefined;
+        return {
+            holder,
+            throughId: saved.throughId,
+            throughAt: saved.throughAt ?? null,
+            held: Array.isArray(saved.held) ? saved.held.filter((id) => typeof id === "number") : [],
+            read: saved.read ?? 0,
+            skipped: { ...noneSkipped(), ...saved.skipped },
+            updatedAt: at,
+        };
+    }
+    catch {
+        return undefined;
+    }
+};
+const accountOf = async (store, mailbox) => store.accounts.storedAccount(mailbox).catch((error) => {
+    if (error instanceof CliError && error.code === "not_found")
+        return undefined;
+    throw error;
+});
+export const markOf = async (store, mailbox, holder) => {
+    const saved = await store.sync.syncState(mailbox, keyOf(holder));
+    return saved ? parsed(holder, saved.value, Date.parse(saved.at)) : undefined;
+};
+/** Every holder's mark on the mailbox, by name. */
+export const marksOf = async (store, mailbox) => {
+    const account = await accountOf(store, mailbox);
+    if (!account)
+        return [];
+    return (await store.mail.statesLike(account.id, PREFIX))
+        .flatMap(({ key, value, at }) => parsed(key.slice(PREFIX.length), value, at) ?? [])
+        .sort((a, b) => a.holder.localeCompare(b.holder));
+};
+/** Why an email is not for the holder, or `held` while it is partial and young, or `read`. */
+const verdict = (email, now) => {
+    if (email.draft)
+        return "draft";
+    if (email.envelope)
+        return "envelope";
+    if (email.bulk)
+        return "bulk";
+    if (email.partial)
+        return now - email.storedAt < HOLD_PARTIAL_MS ? "held" : "partial";
+    return "read";
+};
+/** The mark's state, as a cursor `acknowledge` takes back: the last id read, and when it was read. */
+export const cursorOf = (throughId, readAt) => `${throughId}.${readAt}`;
+const parseCursor = (cursor) => {
+    const match = /^(\d+)\.(\d+)$/.exec(cursor.trim());
+    if (!match)
+        throw new CliError("validation_error", `--cursor takes the cursor review gave, such as 9123.1762090000000`);
+    return { throughId: Number(match[1]), readAt: Number(match[2]) };
+};
+/**
+ * What the holder has not processed: the emails stored after its mark, and the held ones that are whole now. Reads
+ * only; the mark moves when the holder acknowledges. A holder with no mark starts from now: its first read is
+ * empty and gives the cursor of the newest stored email.
+ */
+export const readPastMark = async (store, mailbox, holder, { now = Date.now(), limit = MARK_BATCH } = {}) => {
+    const mark = await markOf(store, mailbox, holder);
+    const account = await accountOf(store, mailbox);
+    const empty = { emails: [], more: false, held: 0, skipped: noneSkipped(), mark };
+    if (!account)
+        return { ...empty, cursor: cursorOf(0, now) };
+    if (!mark)
+        return { ...empty, cursor: cursorOf(await store.mail.newestEmailId(account.id), now) };
+    const found = await store.mail.emailsAfter(account.id, mark.throughId, limit + 1, mark.held);
+    // Mail a running sync stored is read once that sync ended: it files bulk mail only at its end.
+    const settled = await store.sync.syncState(mailbox, "mail_coverage");
+    const settledAt = settled ? Date.parse(settled.at) : Number.POSITIVE_INFINITY;
+    const after = found.filter((email) => email.id > mark.throughId);
+    const unsettled = after.findIndex((email) => email.storedAt > settledAt);
+    const fresh = unsettled === -1 ? after : after.slice(0, unsettled);
+    const batch = fresh.slice(0, limit);
+    const examined = [...found.filter((email) => email.id <= mark.throughId), ...batch];
+    const skipped = noneSkipped();
+    const wanted = [];
+    let held = 0;
+    for (const email of examined) {
+        const said = verdict(email, now);
+        if (said === "read")
+            wanted.push(email.id);
+        else if (said === "held")
+            held += 1;
+        else if (email.id > mark.throughId)
+            skipped[said] += 1;
+    }
+    const emails = await store.mail.emailHits(wanted.sort((a, b) => a - b));
+    return {
+        emails,
+        cursor: cursorOf(batch.at(-1)?.id ?? mark.throughId, now),
+        more: after.length > batch.length,
+        held,
+        skipped,
+        mark,
+    };
+};
+/**
+ * Moves the holder's mark to the cursor its read gave, never back. An email whole when it was read counts read; one
+ * still partial, or changed after the read (it may have become whole since), is held and comes with the next read.
+ * The same cursor twice changes nothing more.
+ */
+export const acknowledgeMark = async (store, mailbox, holder, cursor, now = Date.now()) => {
+    const key = keyOf(holder);
+    const { throughId, readAt } = parseCursor(cursor);
+    const account = await accountOf(store, mailbox);
+    if (!account)
+        throw new CliError("not_found", `no mail of ${mailbox.account} is stored`);
+    const mark = await markOf(store, mailbox, holder);
+    const from = mark?.throughId ?? throughId;
+    if (throughId < from)
+        throw new CliError("validation_error", `${holder} is already past ${throughId}: its mark is at ${from}`);
+    const examined = [];
+    let after = from;
+    const held = new Set(mark?.held ?? []);
+    const again = await store.mail.emailsAfter(account.id, Number.MAX_SAFE_INTEGER, 0, [...held]);
+    examined.push(...again);
+    while (after < throughId) {
+        const page = (await store.mail.emailsAfter(account.id, after, MARK_BATCH)).filter((one) => one.id <= throughId);
+        if (page.length === 0)
+            break;
+        examined.push(...page);
+        after = page.at(-1)?.id ?? throughId;
+    }
+    const skipped = { ...(mark?.skipped ?? noneSkipped()) };
+    let read = mark?.read ?? 0;
+    const keep = [];
+    const live = new Set(again.map((one) => one.id));
+    for (const id of held)
+        if (!live.has(id))
+            held.delete(id);
+    for (const email of examined) {
+        const said = verdict(email, readAt);
+        const wasHeld = held.has(email.id);
+        if (said === "held" || (said === "read" && email.changedAt > readAt) || (wasHeld && email.changedAt > readAt)) {
+            if (email.partial && now - email.storedAt >= HOLD_PARTIAL_MS)
+                skipped.partial += 1;
+            else
+                keep.push(email.id);
+        }
+        else if (said === "read")
+            read += wasHeld || email.id > from ? 1 : 0;
+        else if (!wasHeld || said === "partial")
+            skipped[said] += 1;
+    }
+    const kept = [...new Set(keep)].sort((a, b) => a - b);
+    skipped.partial += Math.max(0, kept.length - MOST_HELD);
+    const through = examined.filter((one) => one.id <= throughId).at(-1);
+    const next = {
+        throughId,
+        throughAt: through?.id === throughId ? through.at : (mark?.throughAt ?? null),
+        held: kept.slice(-MOST_HELD),
+        read,
+        skipped,
+    };
+    await store.sync.setSyncState(mailbox, key, JSON.stringify(next));
+    return { holder, ...next, updatedAt: now };
+};

package/dist/meetings/mcp/index.d.ts

@@ -38,6 +38,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -53,11 +54,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -75,11 +76,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -101,7 +102,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -188,6 +188,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -203,11 +204,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -225,11 +226,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -251,7 +252,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -338,6 +338,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -353,11 +354,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -375,11 +376,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -401,7 +402,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -488,6 +488,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -503,11 +504,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -525,11 +526,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -551,7 +552,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -638,6 +638,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -653,11 +654,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -675,11 +676,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -701,7 +702,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;

package/dist/sends/permissions.js

@@ -276,6 +276,7 @@ const NAMED_WRITE_KEYS = [
     "mentions.reject",
     "tags.add",
     "tags.remove",
+    "tasks.acknowledge",
     "tasks.add",
     "tasks.claim",
     "tasks.close",

package/dist/services/proposals/kinds/finance.d.ts

@@ -0,0 +1,4 @@
+import type { MessageStore } from "../../../store/index.js";
+import type { ProposalKind } from "../types.js";
+export declare const invoiceKind: (store: Pick<MessageStore, "finance">) => ProposalKind;
+export declare const paymentKind: (store: Pick<MessageStore, "finance">) => ProposalKind;

package/dist/services/proposals/kinds/finance.js

@@ -0,0 +1,40 @@
+import { kept, proposerOfAuthor, pushed } from "./shared.js";
+const rowOf = (kind, entry) => ({
+    id: entry.ref,
+    kind,
+    status: entry.review,
+    project: entry.project,
+    subject: entry.ref,
+    object: "counterparty" in entry
+        ? entry.counterparty.ref
+        : ((entry.direction === "in" ? entry.payer : entry.payee)?.ref ?? null),
+    summary: entry.title,
+    proposedBy: proposerOfAuthor(entry.author),
+    reason: entry.reason,
+    evidence: [],
+    score: null,
+    signals: null,
+    parts: null,
+    createdAt: entry.createdAt,
+});
+/**
+ * An agent's or an import's invoice or payment. One kind per entity, because the registry routes an id by its prefix
+ * and the id is the entry's own ref (`payment:12`), as a fact's is. Only the owner decides money.
+ */
+const financeKind = (store, kind) => ({
+    kind,
+    prefix: kind,
+    list: async (filter) => {
+        const status = filter.status ?? "proposed";
+        const options = { ...pushed(filter), ...(status === "all" ? {} : { review: status }) };
+        const entries = kind === "invoice" ? await store.finance.invoices(options) : await store.finance.payments(options);
+        return kept(entries.map((entry) => rowOf(kind, entry)), filter);
+    },
+    get: async (id) => rowOf(kind, kind === "invoice" ? await store.finance.invoice(id) : await store.finance.payment(id)),
+    decide: async (id, { confirm, by, reason }) => {
+        const entry = confirm ? await store.finance.confirm(id, by, reason) : await store.finance.reject(id, by, reason);
+        return { id, kind, status: confirm ? "confirmed" : "rejected", made: confirm ? [entry.ref] : [] };
+    },
+});
+export const invoiceKind = (store) => financeKind(store, "invoice");
+export const paymentKind = (store) => financeKind(store, "payment");

package/dist/services/proposals/registry.js

@@ -2,6 +2,7 @@ import { CliError } from "@wirecat/cli-base";
 import { mayDecide } from "../../store/decisions.js";
 import { actionKind } from "./kinds/action.js";
 import { factKind } from "./kinds/fact.js";
+import { invoiceKind, paymentKind } from "./kinds/finance.js";
 import { findingsKind } from "./kinds/findings.js";
 import { keyDocumentKind } from "./kinds/key-document.js";
 import { memoryKind } from "./kinds/memory.js";
@@ -122,6 +123,8 @@ export const proposalRegistry = (store) => {
         relationshipUpdateKind(store),
         keyDocumentKind(store),
         factKind(store),
+        invoiceKind(store),
+        paymentKind(store),
         memoryKind(store),
         findingsKind(store),
     ])

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

@@ -0,0 +1,58 @@
+import type { ChatKind, Id, Message } from "../domain/models.js";
+import type { AccountKey, MessageStore, TaskAnalysisMark } from "../store/index.js";
+/** How many messages one read gives an agent: a page it can judge in one go. */
+export declare const ANALYSIS_PAGE = 100;
+export declare const ANALYSIS_PAGE_MAX = 1000;
+/** Where a chat never read for tasks starts, unless the caller names a time: older history is not new work. */
+export declare const defaultStart: (now: Date) => string;
+export interface ChatAnalysis {
+    chatId: Id;
+    title: string | null;
+    kind: ChatKind;
+    newestAt: string | null;
+    mark: TaskAnalysisMark | null;
+    /** Stored messages after the mark, or since the default start when the chat was never read for tasks. */
+    waiting: number;
+    /** Stored inside the read stretch after it was read: `--since <from>` reads the stretch again. */
+    late: number;
+}
+/**
+ * Every chat whose messages can hold the owner's tasks — not a channel or Saved Messages (owner, 2026-10-17) — with
+ * how far it was read for tasks and how much waits, newest chat first.
+ */
+export declare const taskAnalysisList: (store: MessageStore, account: AccountKey, now?: Date) => Promise<ChatAnalysis[]>;
+export interface UnanalysedPage {
+    mark: TaskAnalysisMark | null;
+    /** Where this read started: the mark, `since`, or the default start. */
+    from: string;
+    messages: Message[];
+    more: boolean;
+    late: number;
+}
+/**
+ * The stored messages of a chat not yet read for tasks, oldest first, from its mark; `since` reads from that time
+ * instead, to read a stretch again. Reading moves nothing: `acknowledgeTaskAnalysis` does, once the reader is done.
+ */
+export declare const unanalysedMessages: (store: MessageStore, account: AccountKey, chatId: Id, { limit, since, now }?: {
+    limit?: number;
+    since?: string;
+    now?: Date;
+}) => Promise<UnanalysedPage>;
+/**
+ * Records that the chat was read for tasks through `messageId`, from `since` when that read started there. The mark
+ * never moves back. A read that covered the whole stretch again also clears what arrived late inside it.
+ */
+export declare const acknowledgeTaskAnalysis: (store: MessageStore, account: AccountKey, chatId: Id, messageId: Id, { since, by, now }: {
+    since?: string;
+    by: string;
+    now?: Date;
+}) => Promise<{
+    mark: TaskAnalysisMark;
+    moved: boolean;
+}>;
+/**
+ * A read again of history the chat's task point already passed only updates and closes tasks (owner, 2026-11-03):
+ * a new task from such a message needs `--open-new`. A message that already has a task, or one after the point, is
+ * let through.
+ */
+export declare const refuseAlreadyRead: (store: MessageStore, account: AccountKey, source: string) => Promise<void>;

package/dist/services/task-analysis.js

@@ -0,0 +1,125 @@
+import { CliError } from "@wirecat/cli-base";
+import { isLocator, parseLocator } from "../domain/locator.js";
+import { FIRST_PASS_DAYS, RULES_IN, taskAccount } from "./task-rules.js";
+/** How many messages one read gives an agent: a page it can judge in one go. */
+export const ANALYSIS_PAGE = 100;
+export const ANALYSIS_PAGE_MAX = 1000;
+/** Where a chat never read for tasks starts, unless the caller names a time: older history is not new work. */
+export const defaultStart = (now) => new Date(now.getTime() - FIRST_PASS_DAYS * 86_400_000).toISOString();
+const after = (iso) => new Date(Date.parse(iso) + 1).toISOString();
+/** Messages saved or edited after the mark was last checked, sent inside the stretch it had read. */
+const lateOf = async (store, account, mark) => {
+    const { messages } = await store.messages.changes(account, mark.chatId, mark.checkedAt);
+    return messages.filter((one) => one.timestamp >= mark.from && one.timestamp <= mark.checkedThrough);
+};
+/**
+ * Every chat whose messages can hold the owner's tasks — not a channel or Saved Messages (owner, 2026-10-17) — with
+ * how far it was read for tasks and how much waits, newest chat first.
+ */
+export const taskAnalysisList = async (store, account, now = new Date()) => {
+    const marks = new Map((await store.sync.taskAnalysisMarks(account)).map((mark) => [mark.chatId, mark]));
+    const start = defaultStart(now);
+    const chats = [];
+    for (const chat of await store.chats.chatStats(account)) {
+        if (RULES_IN[chat.kind] === "none")
+            continue;
+        const mark = marks.get(chat.chatId) ?? null;
+        chats.push({
+            chatId: chat.chatId,
+            title: chat.title,
+            kind: chat.kind,
+            newestAt: chat.newestAt,
+            mark,
+            waiting: await store.messages.countMessages(account, chat.chatId, { since: mark ? after(mark.through) : start }),
+            late: mark ? (await lateOf(store, account, mark)).length : 0,
+        });
+    }
+    return chats.sort((a, b) => (b.newestAt ?? "").localeCompare(a.newestAt ?? ""));
+};
+/**
+ * The stored messages of a chat not yet read for tasks, oldest first, from its mark; `since` reads from that time
+ * instead, to read a stretch again. Reading moves nothing: `acknowledgeTaskAnalysis` does, once the reader is done.
+ */
+export const unanalysedMessages = async (store, account, chatId, { limit = ANALYSIS_PAGE, since, now = new Date() } = {}) => {
+    const mark = (await store.sync.taskAnalysisMark(account, chatId)) ?? null;
+    const from = since ?? mark?.through ?? defaultStart(now);
+    const byTime = { time: Date.parse(from) - (since === undefined && mark ? 0 : 1) };
+    const read = (start) => store.messages.messages(account, chatId, { limit, after: start });
+    let page;
+    if (since === undefined && mark) {
+        try {
+            page = await read({ id: mark.throughId });
+        }
+        catch (error) {
+            if (!(error instanceof CliError && error.code === "not_found"))
+                throw error;
+            page = await read(byTime);
+        }
+    }
+    else
+        page = await read(byTime);
+    return {
+        mark,
+        from,
+        messages: page.items,
+        more: page.hasMore,
+        late: mark ? (await lateOf(store, account, mark)).length : 0,
+    };
+};
+/**
+ * Records that the chat was read for tasks through `messageId`, from `since` when that read started there. The mark
+ * never moves back. A read that covered the whole stretch again also clears what arrived late inside it.
+ */
+export const acknowledgeTaskAnalysis = async (store, account, chatId, messageId, { since, by, now = new Date() }) => {
+    const message = await store.messages.message(account, messageId, { chatId });
+    if (!message)
+        throw new CliError("not_found", `message ${messageId} is not in the local copy of chat ${chatId}`);
+    const mark = await store.sync.taskAnalysisMark(account, chatId);
+    const start = since ?? mark?.from ?? defaultStart(now);
+    if (message.timestamp < start)
+        throw new CliError("validation_error", `message ${messageId} was sent before the read started (${start})`);
+    if (mark && message.timestamp < mark.from)
+        throw new CliError("validation_error", `message ${messageId} ends before the stretch already read (${mark.from}): read on to it, then acknowledge`);
+    const ahead = !mark || message.timestamp > mark.through || (since !== undefined && message.timestamp >= mark.through);
+    if (mark && !ahead && start >= mark.from)
+        return { mark, moved: false };
+    const reread = mark !== undefined && since !== undefined && since <= mark.from && ahead;
+    const checked = !mark || reread || (since === undefined && (await lateOf(store, account, mark)).length === 0);
+    const through = mark && !ahead ? mark : { through: message.timestamp, throughId: message.id };
+    const next = {
+        chatId,
+        from: mark && mark.from < start ? mark.from : start,
+        through: through.through,
+        throughId: through.throughId,
+        by,
+        checked,
+        checkedThrough: checked || !mark ? through.through : mark.checkedThrough,
+    };
+    await store.sync.setTaskAnalysisMark(account, next);
+    const saved = await store.sync.taskAnalysisMark(account, chatId);
+    if (!saved)
+        throw new Error(`the task analysis mark of chat ${chatId} was not saved`);
+    return { mark: saved, moved: true };
+};
+/**
+ * A read again of history the chat's task point already passed only updates and closes tasks (owner, 2026-11-03):
+ * a new task from such a message needs `--open-new`. A message that already has a task, or one after the point, is
+ * let through.
+ */
+export const refuseAlreadyRead = async (store, account, source) => {
+    if (!isLocator(source))
+        return;
+    const { provider, account: owner, chat, message } = parseLocator(source);
+    if (provider !== account.provider || owner !== account.account)
+        return;
+    const mark = await store.sync.taskAnalysisMark(account, chat);
+    if (!mark)
+        return;
+    const stored = await store.messages.message(account, message, { chatId: chat });
+    if (!stored || stored.timestamp > mark.through)
+        return;
+    if ((await store.tasks.findBySource(taskAccount(account), source)).length > 0)
+        return;
+    throw new CliError("validation_error", `${source} was already read for tasks (the point is at ${mark.through}): a read again only updates and closes ` +
+        "tasks; add --open-new to open a task from it anyway", { reason: "task.already-read" });
+};

package/dist/store/exports.d.ts

@@ -23,7 +23,7 @@ export { storeClients } from "./sqlite/clients.js";
 export { CHAT_LIST_KEY, type ChatCompleteness, fetchedKey, historyStartKey } from "./sqlite/completeness.js";
 export { CONVERSATION_COLUMNS } from "./sqlite/conversations.js";
 export type { CounterTarget } from "./sqlite/counters.js";
-export { type EmailMarks, MAIL_AGENDA_COLUMNS, type NewestEmail, type ThreadActivity, } from "./sqlite/email-activity.js";
+export { type EmailMarks, MAIL_AGENDA_COLUMNS, type MarkedEmail, type NewestEmail, type ThreadActivity, } from "./sqlite/email-activity.js";
 export { messageOfEmail, threadConversation } from "./sqlite/emails.js";
 export { orphanPointers } from "./sqlite/entity-types.js";
 export { involvementStoreOver } from "./sqlite/involvements.js";
@@ -61,5 +61,5 @@ export type { MatchPlace, ScoredHit } from "./sqlite/words.js";
 export type { TaskDetails } from "./sqlite/work-tasks.js";
 export type { SyncStore } from "./sync.js";
 export type { TagsStore } from "./tags.js";
-export type { AccountKey, AccountMessageFilter, AgentAnswer, BatchMessage, ChatActivity, ChatStats, ConversationBuild, ConversationHit, ConversationSummary, DeletionScope, Delta, IdentityRef, IngestedVia, LinkBatch, LinkedIdentity, LinkOptions, MessageFilter, PersonFacts, PersonRecord, PictureInput, Range, SenderChatStats, StoredAccount, StoredChatFilter, StoredHit, StoredLink, StoredReadiness, } from "./types.js";
+export type { AccountKey, AccountMessageFilter, AgentAnswer, BatchMessage, ChatActivity, ChatStats, ConversationBuild, ConversationHit, ConversationSummary, DeletionScope, Delta, IdentityRef, IngestedVia, LinkBatch, LinkedIdentity, LinkOptions, MessageFilter, PersonFacts, PersonRecord, PictureInput, Range, SenderChatStats, StoredAccount, StoredChatFilter, StoredHit, StoredLink, StoredReadiness, TaskAnalysisMark, TaskAnalysisMarkWrite, } from "./types.js";
 export type { AccountVectors, VectorsStore } from "./vectors.js";

package/dist/store/index.d.ts

@@ -38,6 +38,7 @@ export { EVENT_FIELDS, type EventChunkToEmbed, type EventHit, type EventQuery, t
 export type { EvidenceSource } from "./sqlite/evidence-sources.js";
 export type { Fact, FactInput, FactsStore, PaymentFilter } from "./sqlite/facts.js";
 export type { FileListQuery, FilesStore, StoredFile } from "./sqlite/files.js";
+export type { Allocation, FinanceStore, Invoice, InvoiceDetail, InvoiceInput, InvoiceLine, InvoiceLineInput, OpenTotal, Party, Payment as FinancePayment, PaymentDetail as FinancePaymentDetail, PaymentInput as FinancePaymentInput, } from "./sqlite/finance.js";
 export { IMPORTED_DOCUMENT_QUERY, type ImportedDocuments } from "./sqlite/imported-documents.js";
 export type { Involvement, InvolvementStore } from "./sqlite/involvements.js";
 export type { Annotation, KnowledgeRelation, KnowledgeStore, KnowledgeTarget, LabelledType, Organization, Project, Reminder, } from "./sqlite/knowledge.js";
@@ -71,4 +72,4 @@ export type { StoreTaskStore } from "./sqlite/tasks.js";
 export type { TagPreflight, VocabularyAlias, VocabularyAliasReceipt, VocabularyAudit, VocabularyAuditOptions, VocabularyCatalog, VocabularyEntry, VocabularyKind, VocabularyOptions, VocabularyResolution, VocabularyStore, VocabularyTarget, } from "./sqlite/vocabulary.js";
 export type { BoardCounts, BoardOptions, NewWorkTask, RevisionCheck, TaskAssignment, TaskDetails, TaskEvent, TaskFields, TaskMove, TaskMoved, TaskRole, TaskType, WorkTaskType, } from "./sqlite/work-tasks.js";
 export { TASK_EVENT_KINDS, TASK_ROLES } from "./sqlite/work-tasks.js";
-export { type AccountAccounts, type AccountAttachments, type AccountCounters, type AccountKey, type AccountMentions, type AccountMessageFilter, type AccountMessages, type AccountPeople, type AccountsStore, type AccountVectors, type AttachmentsStore, type AttachmentTextEntry, type AttachmentView, type ChatStats, type ChatsStore, type ConversationsStore, type CountersStore, type DeletionScope, type Delta, type FileAttachment, type IdentityRef, type IngestedVia, type LinkedIdentity, type LinkOptions, MENTION_QUERY, MENTION_STATUSES, type MentionsStore, type MessageFilter, type MessageStore, type MessagesStore, OTHER_SOURCES, openStore, type PeopleStore, type PersonFacts, type PersonRecord, type QueriesStore, type Range, type RankedEvidence, type RankedStoreFound, type RankedStoreRow, type RankingEvidenceItem, type RankingEvidenceRequest, type RankingRequest, type RosterStore, type SearchCommand, type SearchesStore, type SearchIndexStore, type SearchRecord, type StoredAccount, type StoredChatFilter, type StoredHit, type StoredSearch, type StoredTag, type StoreOptions, type SyncStore, type TagFilter, type TagsStore, type TagTarget, type TaskTagTarget, type TextOrigin, type VectorsStore, } from "./store.js";
+export { type AccountAccounts, type AccountAttachments, type AccountCounters, type AccountKey, type AccountMentions, type AccountMessageFilter, type AccountMessages, type AccountPeople, type AccountsStore, type AccountVectors, type AttachmentsStore, type AttachmentTextEntry, type AttachmentView, type ChatStats, type ChatsStore, type ConversationsStore, type CountersStore, type DeletionScope, type Delta, type FileAttachment, type IdentityRef, type IngestedVia, type LinkedIdentity, type LinkOptions, MENTION_QUERY, MENTION_STATUSES, type MentionsStore, type MessageFilter, type MessageStore, type MessagesStore, OTHER_SOURCES, openStore, type PeopleStore, type PersonFacts, type PersonRecord, type QueriesStore, type Range, type RankedEvidence, type RankedStoreFound, type RankedStoreRow, type RankingEvidenceItem, type RankingEvidenceRequest, type RankingRequest, type RosterStore, type SearchCommand, type SearchesStore, type SearchIndexStore, type SearchRecord, type StoredAccount, type StoredChatFilter, type StoredHit, type StoredSearch, type StoredTag, type StoreOptions, type SyncStore, type TagFilter, type TagsStore, type TagTarget, type TaskAnalysisMark, type TaskAnalysisMarkWrite, type TaskTagTarget, type TextOrigin, type VectorsStore, } from "./store.js";