@wirecat/cli-core 0.575.0 → 0.577.0

package/CHANGELOG.md

@@ -7,6 +7,43 @@ shape of this file.
 
 ## Unreleased
 
+## 0.577.0 — 05.11.2026
+
+### Added
+
+- **Tasks keep their id in an outside service and the page they are about (store version 51).** `tasks.provider`
+  and `tasks.external_id` hold a task's id in a service such as Avito, Cian or hh.ru, given and shown as
+  `<service>:<id>` (`avito:4512345678`), so ids of two services never collide; several tasks may share one.
+  `tasks.source_url` and `orders.source_url` hold the http or https page a task or an order is about, such as an Avito
+  ad or an Amazon order; anything else is refused (`task.source-url`, `order.source-url`, `task.external-id`).
+  `TaskFields.externalId` and `sourceUrl` set them on create and edit, `null` clears them; `TaskDetails` and the
+  `task` entity carry `external_id` and `source_url`; `OrderInput` and `Order` carry `sourceUrl`. Mail findings take
+  `external_id` and `source_url` on a `task` and `source_url` on an `order`, and accepting keeps them. `minCompatible`
+  stays 34.
+- **The owner moves a holder's mail mark back: `messages reset`.** `--holder <name>` with `--since-time <time>` or
+  `--last <n>`, and `--dry-run` to count first; the answer (`mail_mark_reset`) says how many emails the holder reads
+  whole again, how many bulk ones come again as excerpts and how many are skipped again. It is owner only: no
+  proposal, refused under the read-only lock, for a scheduled holder and for an agent (`mail.reset-owner-only`); a
+  holder with no mark yet is `mail.no-mark`. `rewindMark` is the function under it, and `MailActivityStore` gets
+  `emailsBefore`.
+
+## 0.576.0 — 05.11.2026
+
+### Added
+
+- **`review --holder` gives an agent the bulk mail that is not surely a newsletter.** Shops, banks and site forms put
+  List-Unsubscribe on orders, invoices and lead forms too, and the holder read left all of it out. Now
+  `newsletterSorter` scores each bulk email by words in its subject and first lines (Russian, English, Spanish), its
+  sender's address, an emoji or an unsubscribe link: a newsletter is left out and counted under `missing` as
+  `newsletter`; an order word in the subject, an order's or a request's number, or a reply keeps it. A kept email
+  comes after the other mail, as its subject and first lines, with `email.bulk: true` and `email.excerpt_only: true`;
+  `messages show <ref>` reads it whole. At most 30 excerpts a read; the read then ends early and the next gives the
+  rest. `mailWaiting` and `advancePastSkipped` count and stop at excerpts the same way. A host sets it from its config
+  file: `MAIL_BULK_SETTINGS` (`mail_bulk_excerpts`, `mail_bulk_excerpts_per_read`, `mail_bulk_excerpt_chars`,
+  `mail_bulk_newsletter_score`, `mail_bulk_newsletter_words`, `mail_bulk_newsletter_senders`, `mail_bulk_order_words`),
+  read by `bulkTriageOf` into `MailReads.bulkTriage`, and passed to `mailWaiting` and `advancePastSkipped` as their
+  new last argument; without it the defaults apply.
+
 ## 0.575.0 — 05.11.2026
 
 ### Added

package/dist/cli/findings-input.js

@@ -14,6 +14,8 @@ const keys = {
     supplier_name: "supplierName",
     order_date: "orderDate",
     fulfilled_date: "fulfilledDate",
+    external_id: "externalId",
+    source_url: "sourceUrl",
 };
 const parseFindingsJson = (text, label, validate) => {
     if (Buffer.byteLength(text, "utf8") > 65536)

package/dist/cli/messenger/tasks-command.js

@@ -41,6 +41,8 @@ const card = (task) => [
     `due ${when(task.dueAt)}  next check ${when(task.nextCheckAt)}  source ${task.source ?? "—"}`,
     ...(task.priorityLabel === null ? [] : [`priority ${task.priorityLabel}`]),
     ...(task.agent === null ? [] : [`agent ${task.agent}`]),
+    ...(task.externalId === null ? [] : [`external id ${task.externalId}`]),
+    ...(task.sourceUrl === null ? [] : [`page ${task.sourceUrl}`]),
     ...(task.claimedBy === null ? [] : [`claimed by ${task.claimedBy} until ${when(task.claimedUntil)}`]),
     ...task.assignments.filter((one) => one.role === "assignee").map((one) => `assignee ${one.to}`),
     ...(task.closeSuggestion === null ? [] : [suggestionLine(task.closeSuggestion)]),

package/dist/domain/external-links.d.ts

@@ -0,0 +1,13 @@
+/** The outside service an external id belongs to: `avito`, `cian`, `amazon`, `hh`. */
+export declare const EXTERNAL_SERVICE: RegExp;
+export declare const EXTERNAL_ID_CHARS = 200;
+export declare const SOURCE_URL_CHARS = 2000;
+export interface ExternalId {
+    provider: string;
+    id: string;
+}
+/** `avito:4512345678` → the service and its id; the id is everything after the first colon. */
+export declare const externalIdOf: (value: string) => ExternalId;
+export declare const externalIdText: (provider: unknown, id: unknown) => string | null;
+/** An http or https address, as given; anything else is refused, so a stored link always opens a web page. */
+export declare const sourceUrlOf: (value: string, reason?: string) => string;

package/dist/domain/external-links.js

@@ -0,0 +1,30 @@
+import { CliError } from "@wirecat/cli-base";
+/** The outside service an external id belongs to: `avito`, `cian`, `amazon`, `hh`. */
+export const EXTERNAL_SERVICE = /^[a-z][a-z0-9-]{0,31}$/;
+export const EXTERNAL_ID_CHARS = 200;
+export const SOURCE_URL_CHARS = 2000;
+/** `avito:4512345678` → the service and its id; the id is everything after the first colon. */
+export const externalIdOf = (value) => {
+    const text = value.trim();
+    const colon = text.indexOf(":");
+    const provider = colon === -1 ? "" : text.slice(0, colon).toLowerCase();
+    const id = colon === -1 ? "" : text.slice(colon + 1).trim();
+    if (!EXTERNAL_SERVICE.test(provider) || id.length === 0 || id.length > EXTERNAL_ID_CHARS || /\s/.test(id))
+        throw new CliError("validation_error", `an external id is <service>:<id>, such as avito:4512345678, at most ${EXTERNAL_ID_CHARS} characters after the colon and no spaces, not "${value}"`, { reason: "task.external-id" });
+    return { provider, id };
+};
+export const externalIdText = (provider, id) => provider == null || id == null ? null : `${String(provider)}:${String(id)}`;
+/** An http or https address, as given; anything else is refused, so a stored link always opens a web page. */
+export const sourceUrlOf = (value, reason = "task.source-url") => {
+    const text = value.trim();
+    let url;
+    try {
+        url = new URL(text);
+    }
+    catch {
+        url = undefined;
+    }
+    if (!url || (url.protocol !== "http:" && url.protocol !== "https:") || text.length > SOURCE_URL_CHARS)
+        throw new CliError("validation_error", `a source URL is an http or https address of at most ${SOURCE_URL_CHARS} characters, not "${value}"`, { reason });
+    return text;
+};

package/dist/entities/index.d.ts

@@ -4303,6 +4303,8 @@ export declare const ENTITIES: {
         readonly account: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly chat: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;
         readonly source_message: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;
+        readonly external_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly source_url: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly priority: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
         readonly priority_label: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<readonly ["low", "medium", "high", "critical"], undefined>, undefined>, undefined>;
         readonly agent: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
@@ -4386,6 +4388,8 @@ export declare const ENTITIES: {
         readonly revision: v.NumberSchema<undefined>;
         readonly parent: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
         readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly source_url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly due_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly next_check_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly closed_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
@@ -4500,6 +4504,8 @@ export declare const ENTITIES: {
             readonly revision: v.NumberSchema<undefined>;
             readonly parent: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
             readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly source_url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly due_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly next_check_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly closed_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
@@ -4615,6 +4621,8 @@ export declare const ENTITIES: {
         readonly revision: v.NumberSchema<undefined>;
         readonly parent: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
         readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly source_url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly due_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly next_check_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly closed_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
@@ -4758,6 +4766,8 @@ export declare const ENTITIES: {
             readonly revision: v.NumberSchema<undefined>;
             readonly parent: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
             readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly source_url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly due_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly next_check_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly closed_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
@@ -4866,6 +4876,8 @@ export declare const ENTITIES: {
             readonly revision: v.NumberSchema<undefined>;
             readonly parent: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
             readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly source_url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly due_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly next_check_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly closed_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
@@ -5911,6 +5923,8 @@ export declare const ENTITIES: {
                 readonly due_evidence: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;
                 readonly assignee: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
                 readonly assignee_evidence: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;
+                readonly external_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly source_url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             }, undefined>, v.StrictObjectSchema<{
                 readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
                 readonly evidence: v.ArraySchema<v.StrictObjectSchema<{
@@ -6028,6 +6042,7 @@ export declare const ENTITIES: {
                 readonly invoice: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
                 readonly payment: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
                 readonly project: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+                readonly source_url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly reason: v.StringSchema<undefined>;
             }, undefined>, v.StrictObjectSchema<{
                 readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;

package/dist/entities/mail-findings.d.ts

@@ -26,6 +26,10 @@ export declare const mailFindings: v.StrictObjectSchema<{
             readonly due_evidence: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;
             readonly assignee: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
             readonly assignee_evidence: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;
+            /** `<service>:<id>` in the outside service the mail came from, such as `avito:4512345678`. */
+            readonly external_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /** The http or https page the task is about, such as the conversation the mail links to. */
+            readonly source_url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         }, undefined>, v.StrictObjectSchema<{
             readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
             readonly evidence: v.ArraySchema<v.StrictObjectSchema<{
@@ -143,6 +147,8 @@ export declare const mailFindings: v.StrictObjectSchema<{
             readonly invoice: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
             readonly payment: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
             readonly project: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            /** The order's page at the shop, http or https. */
+            readonly source_url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly reason: v.StringSchema<undefined>;
         }, undefined>, v.StrictObjectSchema<{
             readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;

package/dist/entities/mail-findings.js

@@ -18,6 +18,10 @@ const finding = v.variant("kind", [
         due_evidence: v.optional(v.array(reference)),
         assignee: v.optional(reference),
         assignee_evidence: v.optional(v.array(reference)),
+        /** `<service>:<id>` in the outside service the mail came from, such as `avito:4512345678`. */
+        external_id: v.optional(text),
+        /** The http or https page the task is about, such as the conversation the mail links to. */
+        source_url: v.optional(text),
     }),
     v.strictObject({
         ...base,
@@ -96,6 +100,8 @@ const finding = v.variant("kind", [
         invoice: v.optional(reference),
         payment: v.optional(reference),
         project: v.optional(reference),
+        /** The order's page at the shop, http or https. */
+        source_url: v.optional(text),
         reason: text,
     }),
     v.strictObject({

package/dist/entities/task-results.d.ts

@@ -22,6 +22,10 @@ export declare const taskCard: v.StrictObjectSchema<{
     readonly revision: v.NumberSchema<undefined>;
     readonly parent: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
     readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** `<service>:<id>`, its id in an outside service, such as `avito:4512345678`. */
+    readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** The http or https page it is about, such as an Avito ad. */
+    readonly source_url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly due_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     readonly next_check_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     readonly closed_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
@@ -136,6 +140,10 @@ export declare const taskCreated: v.StrictObjectSchema<{
         readonly revision: v.NumberSchema<undefined>;
         readonly parent: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
         readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /** `<service>:<id>`, its id in an outside service, such as `avito:4512345678`. */
+        readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /** The http or https page it is about, such as an Avito ad. */
+        readonly source_url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly due_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly next_check_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly closed_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
@@ -251,6 +259,10 @@ export declare const taskLinks: v.UnionSchema<[v.StrictObjectSchema<{
     readonly revision: v.NumberSchema<undefined>;
     readonly parent: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
     readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** `<service>:<id>`, its id in an outside service, such as `avito:4512345678`. */
+    readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** The http or https page it is about, such as an Avito ad. */
+    readonly source_url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly due_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     readonly next_check_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     readonly closed_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
@@ -394,6 +406,10 @@ export declare const taskMerge: v.StrictObjectSchema<{
         readonly revision: v.NumberSchema<undefined>;
         readonly parent: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
         readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /** `<service>:<id>`, its id in an outside service, such as `avito:4512345678`. */
+        readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /** The http or https page it is about, such as an Avito ad. */
+        readonly source_url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly due_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly next_check_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly closed_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
@@ -502,6 +518,10 @@ export declare const taskUnmerge: v.StrictObjectSchema<{
         readonly revision: v.NumberSchema<undefined>;
         readonly parent: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
         readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /** `<service>:<id>`, its id in an outside service, such as `avito:4512345678`. */
+        readonly external_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /** The http or https page it is about, such as an Avito ad. */
+        readonly source_url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly due_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly next_check_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly closed_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;

package/dist/entities/task-results.js

@@ -39,6 +39,10 @@ export const taskCard = v.strictObject({
     revision: v.number(),
     parent: v.nullable(reference),
     source: v.nullable(text),
+    /** `<service>:<id>`, its id in an outside service, such as `avito:4512345678`. */
+    external_id: v.nullable(text),
+    /** The http or https page it is about, such as an Avito ad. */
+    source_url: v.nullable(text),
     due_at: nullableTime,
     next_check_at: nullableTime,
     closed_at: nullableTime,

package/dist/entities/task.d.ts

@@ -34,6 +34,10 @@ export declare const task: v.StrictObjectSchema<{
     readonly chat: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;
     /** The message it came from. */
     readonly source_message: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;
+    /** `<service>:<id>`, its id in an outside service, such as `avito:4512345678`. */
+    readonly external_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** The http or https page it is about, such as an Avito ad. */
+    readonly source_url: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     /** 0 to 1, higher first; `priority_label` reads it as low, medium, high or critical. */
     readonly priority: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
     readonly priority_label: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<readonly ["low", "medium", "high", "critical"], undefined>, undefined>, undefined>;

package/dist/entities/task.js

@@ -32,6 +32,10 @@ export const task = v.strictObject({
     chat: v.optional(v.nullable(reference)),
     /** The message it came from. */
     source_message: v.optional(v.nullable(reference)),
+    /** `<service>:<id>`, its id in an outside service, such as `avito:4512345678`. */
+    external_id: v.optional(v.nullable(text)),
+    /** The http or https page it is about, such as an Avito ad. */
+    source_url: v.optional(v.nullable(text)),
     /** 0 to 1, higher first; `priority_label` reads it as low, medium, high or critical. */
     priority: v.optional(v.nullable(v.number())),
     priority_label: v.optional(v.nullable(v.picklist(PRIORITY_LABELS))),

package/dist/errors/reasons.js

@@ -69,6 +69,8 @@ const OTHERS = [
     validation("file.locked", "another process holds the file's lock"),
     validation("mail.cursor-ahead", "an acknowledge cursor is past the newest stored email"),
     ["mail.holder-not-yours", "permission_error", "a run moves only the mark of the holder its schedule names"],
+    ["mail.no-mark", "not_found", "the holder has no mark in the mailbox yet; its first review starts it"],
+    ["mail.reset-owner-only", "permission_error", "only the owner moves a holder's mark back"],
     ["mail.source-failed", "provider_error", "the mail server refused or did not complete a request"],
     ["mail.search-refused", "provider_error", "the mail server refused to search a folder"],
     [
@@ -199,6 +201,7 @@ const OTHERS = [
     validation("money.quantity", "the quantity is not a decimal above 0"),
     validation("order.duplicate", "the shop's order with this number is already stored; change its status instead"),
     validation("order.field", "a field of the order is not valid"),
+    validation("order.source-url", "an order's source URL is not an http or https address"),
     ["order.not-found", "not_found", "no stored order of that shop has that number"],
     validation("order.ref", "the reference names no order, or a shop's number names more than one"),
     validation("order.status", "a rejected or deleted order's status does not change"),
@@ -246,6 +249,8 @@ const OTHERS = [
     validation("tag.invalid", "the tag is not valid"),
     ["reactions.list-hidden", "permission_error", "the chat does not let its members see who reacted"],
     ["reactions.broadcast", "permission_error", "a channel does not show who reacted to its posts"],
+    validation("task.external-id", "an external id is <service>:<id>, such as avito:4512345678"),
+    validation("task.source-url", "a task's source URL is not an http or https address"),
     validation("task.category-unknown", "the category is not in the task category list"),
     validation("task.claimed", "someone else holds the task"),
     validation("task.closed", "the task is already closed"),

package/dist/mail/cli/bulk-settings.d.ts

@@ -0,0 +1,6 @@
+import type { DeclaredSetting } from "../../cli/setting-defaults.js";
+import { type BulkTriage } from "../newsletter.js";
+/** The bulk-mail settings a host that mounts `review --holder` writes into its config file's top level (WC-CMD-30). */
+export declare const MAIL_BULK_SETTINGS: readonly DeclaredSetting[];
+/** `MAIL_BULK_SETTINGS` as the config file gives them; a missing or unusable value is left to the default. */
+export declare const bulkTriageOf: (config: Record<string, unknown>) => BulkTriage;

package/dist/mail/cli/bulk-settings.js

@@ -0,0 +1,65 @@
+import { BULK_TRIAGE_DEFAULTS, NEWSLETTER_DEFAULTS, NEWSLETTER_SENDERS, NEWSLETTER_WORDS, ORDER_WORDS, } from "../newsletter.js";
+const listed = (words) => words.join(", ");
+/** The bulk-mail settings a host that mounts `review --holder` writes into its config file's top level (WC-CMD-30). */
+export const MAIL_BULK_SETTINGS = [
+    {
+        key: "mail_bulk_excerpts",
+        default: BULK_TRIAGE_DEFAULTS.excerpts,
+        description: "review --holder gives an agent bulk mail that is not surely a newsletter as its subject and first lines; " +
+            "false leaves all bulk mail out",
+    },
+    {
+        key: "mail_bulk_excerpts_per_read",
+        default: BULK_TRIAGE_DEFAULTS.perRead,
+        description: "the most bulk excerpts one review --holder gives; the rest come with the next read",
+    },
+    {
+        key: "mail_bulk_excerpt_chars",
+        default: NEWSLETTER_DEFAULTS.excerptChars,
+        description: "how many characters of a bulk email's own text an excerpt shows",
+    },
+    {
+        key: "mail_bulk_newsletter_score",
+        default: NEWSLETTER_DEFAULTS.threshold,
+        description: "bulk mail scoring this or more is left out as a newsletter: a newsletter word counts 2 in the subject, 1 in " +
+            "the first lines, a newsletter's address 2, an emoji in the subject 1, an unsubscribe link at the top 1, " +
+            "an order word in the first lines -2",
+    },
+    {
+        key: "mail_bulk_newsletter_words",
+        default: listed(NEWSLETTER_WORDS),
+        description: "comma-separated words that say advertising; each matches at the start of a word, any case",
+    },
+    {
+        key: "mail_bulk_newsletter_senders",
+        default: listed(NEWSLETTER_SENDERS),
+        description: "comma-separated parts of a sender's address (news, digest) or domains (substack.com) of newsletters",
+    },
+    {
+        key: "mail_bulk_order_words",
+        default: listed(ORDER_WORDS),
+        description: "comma-separated words of orders, invoices and requests: one in the subject keeps a bulk email for the agent",
+    },
+];
+const wordsOf = (value) => typeof value === "string"
+    ? value
+        .split(",")
+        .map((word) => word.trim())
+        .filter(Boolean)
+    : undefined;
+const countOf = (value, least) => typeof value === "number" && Number.isSafeInteger(value) && value >= least ? value : undefined;
+/** `MAIL_BULK_SETTINGS` as the config file gives them; a missing or unusable value is left to the default. */
+export const bulkTriageOf = (config) => {
+    const { cues } = BULK_TRIAGE_DEFAULTS;
+    return {
+        excerpts: typeof config.mail_bulk_excerpts === "boolean" ? config.mail_bulk_excerpts : BULK_TRIAGE_DEFAULTS.excerpts,
+        perRead: countOf(config.mail_bulk_excerpts_per_read, 1) ?? BULK_TRIAGE_DEFAULTS.perRead,
+        cues: {
+            threshold: countOf(config.mail_bulk_newsletter_score, 1) ?? cues.threshold,
+            excerptChars: countOf(config.mail_bulk_excerpt_chars, 40) ?? cues.excerptChars,
+            newsletterWords: wordsOf(config.mail_bulk_newsletter_words) ?? cues.newsletterWords,
+            newsletterSenders: wordsOf(config.mail_bulk_newsletter_senders) ?? cues.newsletterSenders,
+            orderWords: wordsOf(config.mail_bulk_order_words) ?? cues.orderWords,
+        },
+    };
+};

package/dist/mail/cli/index.d.ts

@@ -1,7 +1,9 @@
 import { Command } from "commander";
+import type { BulkTriage } from "../../mail/newsletter.js";
 import { type MailServerAccess } from "../../mail/server-search.js";
 import type { AppIdentity } from "../../ports/app.js";
 import { type AccountKey, type MessageStore } from "../../store/store.js";
+export { bulkTriageOf, MAIL_BULK_SETTINGS } from "./bulk-settings.js";
 export { mailMark, markItem, markText } from "./marks.js";
 export { MAIL_REVIEW_QUERY, MAIL_REVIEW_STEPS, mailReviewSteps } from "./review.js";
 /**
@@ -37,6 +39,8 @@ export interface MailReads {
      * With it, `messages show` reads an email whose attachment a sync's policy left unread before it answers.
      */
     whole?: (command: Command, store: MessageStore, mailbox: AccountKey, emailId: string) => Promise<void>;
+    /** How `review --holder` treats bulk mail, from the host's config file (`MAIL_BULK_SETTINGS`); defaults without it. */
+    bulkTriage?: (command: Command) => BulkTriage;
 }
 export declare const THREAD_QUERY: {
     readonly entity: "mail_thread";

package/dist/mail/cli/index.js

@@ -19,8 +19,9 @@ import { searchMailServer } from "../../mail/server-search.js";
 import { atDetail } from "../../output-detail.js";
 import { sourceKey } from "../../services/server-search.js";
 import { queryFilter, THREAD_COLUMNS } from "../../store/store.js";
-import { acknowledgeCommand } from "./marks.js";
+import { acknowledgeCommand, resetMarkCommand } from "./marks.js";
 import { mailReviewCommand } from "./review.js";
+export { bulkTriageOf, MAIL_BULK_SETTINGS } from "./bulk-settings.js";
 export { mailMark, markItem, markText } from "./marks.js";
 export { MAIL_REVIEW_QUERY, MAIL_REVIEW_STEPS, mailReviewSteps } from "./review.js";
 /** A locked or broken store must fail the command, not read as "nothing stored yet". */
@@ -253,6 +254,7 @@ const messagesCommand = (mail) => {
             : itemOf(shown.find((_, at) => emails[at]?.anchor) ?? shown[0], unread ? { meta: { complete: false, issues: [unread] } } : undefined), () => shownText(emails));
     });
     messages.addCommand(acknowledgeCommand(mail));
+    messages.addCommand(resetMarkCommand(mail));
     return messages;
 };
 const mailThread = v.strictObject({

package/dist/mail/cli/marks.d.ts

@@ -26,3 +26,9 @@ export declare const markText: (mark: MailMark) => string;
  * schedule names only: an email that talks its reader into acknowledging would otherwise silence another pipeline.
  */
 export declare const acknowledgeCommand: (mail: MailReads) => Command;
+/**
+ * `messages reset`: the owner moves a holder's mark back, so its next reviews give it that mail again — after its
+ * rules changed, say. An agent never does: a holder that could move its own mark back could be talked by an email
+ * into reading the whole mailbox again, so this is no proposal and the read-only lock refuses it.
+ */
+export declare const resetMarkCommand: (mail: MailReads) => Command;

package/dist/mail/cli/marks.js

@@ -8,7 +8,8 @@ import { environmentOf, outputFor } from "../../cli/context.js";
 import { LOCAL_WRITE, proposesOnly } from "../../cli/effects.js";
 import { itemOf, renderAnswer } from "../../cli/envelope.js";
 import { mailHolderVariable, readOnlyLockOf } from "../../ports/app.js";
-import { acknowledgeMark } from "../marks.js";
+import { momentOf } from "../../services/moment.js";
+import { acknowledgeMark, rewindMark } from "../marks.js";
 const iso = (ms) => (ms === null ? null : new Date(ms).toISOString());
 /** A holder's mark as `--json`, `mail status` and MCP show it. */
 export const mailMark = v.strictObject({
@@ -67,3 +68,70 @@ export const acknowledgeCommand = (mail) => answerEntity(proposesOnly(annotate(n
     const mark = await mail.read(this, (store, mailbox) => acknowledgeMark(store, mailbox, holder, cursor));
     renderAnswer(this, outputFor(this), itemOf(markItem(mark)), () => markText(mark));
 });
+const mailMarkReset = v.strictObject({
+    mark: mailMark,
+    /** Where the mark was before. */
+    from_id: v.number(),
+    /** Emails the holder reads whole again. */
+    again: v.number(),
+    /** Bulk emails it gets again as excerpts, unless they are surely newsletters. */
+    bulk: v.number(),
+    /** Emails between the two marks it skips again: drafts, envelopes, suspicious senders, partial mail. */
+    skipped: v.number(),
+    /** Nothing moved: `--dry-run` only counts. */
+    dry_run: v.boolean(),
+});
+const wholeNumber = (value) => {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 1)
+        throw new CliError("validation_error", `--last takes a whole number of emails, 1 or more — got ${value}`);
+    return parsed;
+};
+/**
+ * `messages reset`: the owner moves a holder's mark back, so its next reviews give it that mail again — after its
+ * rules changed, say. An agent never does: a holder that could move its own mark back could be talked by an email
+ * into reading the whole mailbox again, so this is no proposal and the read-only lock refuses it.
+ */
+export const resetMarkCommand = (mail) => answerEntity(annotate(new Command("reset"), {
+    effects: LOCAL_WRITE,
+    examples: [
+        `${mail.app.command} personal messages reset --holder mail-triage --last 8 --dry-run`,
+        `${mail.app.command} personal messages reset --holder mail-triage --since-time 2026-11-04T00:00:00Z`,
+    ],
+}), "mail_mark_reset", mailMarkReset)
+    .summary("move a holder's processing mark back, so it reads that mail again (owner only)")
+    .description("the owner moves a holder's mark back past the mail received since --since-time, or past the last --last " +
+    "emails it was given; its next reviews give that mail again. The answer says how many emails it reads " +
+    "again. An agent cannot: a holder only moves its own mark forward, with `messages acknowledge`")
+    .requiredOption("--holder <name>", "whose mark: lower-case letters, digits and dashes, such as mail-triage")
+    .option("--since-time <time>", "read again what was received since this ISO 8601 time, or 2d ago")
+    .option("--last <n>", "read again the last n emails the holder was given", wholeNumber)
+    .option("--dry-run", "count what would be read again, and move nothing")
+    .action(async function () {
+    const { holder, sinceTime, last, dryRun } = this.opts();
+    if ((sinceTime === undefined) === (last === undefined))
+        throw new CliError("validation_error", "give --since-time or --last, one of them");
+    const env = environmentOf(this).env ?? process.env;
+    if (env[mailHolderVariable(mail.app)]?.trim() || actorOf(this) !== "owner" || readOnlyLockOf(mail.app, env))
+        throw new CliError("permission_error", "only the owner moves a holder's mark back; an agent only acknowledges", {
+            reason: "mail.reset-owner-only",
+        });
+    const now = Date.now();
+    const to = last === undefined ? { since: momentOf(sinceTime, "--since-time", now) } : { last };
+    const reset = await mail.read(this, (store, mailbox) => rewindMark(store, mailbox, holder, to, { now, dry: dryRun === true }));
+    const item = {
+        mark: markItem(reset.mark),
+        from_id: reset.fromId,
+        again: reset.again,
+        bulk: reset.bulk,
+        skipped: reset.skipped,
+        dry_run: reset.dry,
+    };
+    renderAnswer(this, outputFor(this), itemOf(item), () => {
+        const mark = reset.mark.throughId === reset.fromId
+            ? `the mark stays at ${reset.fromId}`
+            : `the mark ${reset.dry ? "would move" : "moved"} from ${reset.fromId} to ${reset.mark.throughId}`;
+        return (`${holder} ${reset.dry ? "would read" : "reads"} ${reset.again} emails again, and ${reset.bulk} bulk ` +
+            `ones as excerpts unless they are newsletters; ${reset.skipped} are skipped again; ${mark}\n`);
+    });
+});