@wirecat/cli-core 0.554.0 → 0.555.0

package/CHANGELOG.md

@@ -7,6 +7,26 @@ shape of this file.
 
 ## Unreleased
 
+## 0.555.0 — 02.11.2026
+
+### Added
+
+- **`review` for mail CLIs** (`mailReadCommands`): every stored email, both sides, in threads that changed since a
+  point, in messenger `review`'s item shape plus `email` (people, labels, sender score and the marks `bulk`,
+  `list_id`, `rule_id`); `--new` keeps a point per mailbox, `--unanswered [duration]` keeps threads whose newest email
+  came to the owner in To or Cc with no answer, `--waiting [duration]` threads where the owner wrote last;
+  `bulk:false` leaves out mail sent to many. It reads the store only, cuts at the last finished sync and opens no
+  task. `reviewMail`, `mailTurn`, `isBulk`, `MAIL_REVIEW_STEPS`, `store.mail.threadActivity` and
+  `store.mail.emailMarks` are exported; `store.mail.threadHits` takes a received-time window; the `message` entity's
+  `email` gains optional `bulk`, `list_id` and `rule_id`, and its `summary` view may carry `email`.
+- **`tasks agenda` over an email account fills `owed`, `waiting` and `stale`** from its threads, with the same rule
+  of whose turn a thread is as mail `review`; before, they were empty and `stale` true.
+
+### Fixed
+
+- **A scheduled run's `inbox --new` and `review --new` keep their own point** (`schedule-<name>-review`), so a
+  schedule no longer moves the owner's. An agent over MCP keeps its own, as before.
+
 ## 0.554.0 — 02.11.2026
 
 ### Fixed

package/dist/cli/messenger/catch-up-answers.d.ts

@@ -1,5 +1,5 @@
 import type { Meta } from "@wirecat/cli-base/standards";
-import type { ChatKind, Inbox, Review } from "../../domain/models.js";
+import type { ChatKind, Inbox, Message, Review } from "../../domain/models.js";
 import { type Hearing } from "../../speech/hearing.js";
 import type { AccountKey } from "../../store/store.js";
 import { type QueryWords } from "../list-query.js";
@@ -14,6 +14,54 @@ export declare const catchUpQuery: (words: QueryWords, registry: typeof INBOX_QU
     kinds?: ChatKind[];
     meta?: Partial<Meta>;
 };
+type Read = Message & {
+    chatTitle?: string | null;
+};
+/** One message of a catch-up answer: the fields `inbox` and `review` show, for every messenger and for mail. */
+export declare const summaryOf: (message: Read, reader: AccountKey) => {
+    ref: string;
+    chat_id: string;
+    chat_title: string | null | undefined;
+    timestamp: string;
+    sender_name: string | null;
+    sender_is_me: boolean;
+    outgoing: boolean | null;
+    text: string;
+    transcript?: string | undefined;
+    attachments: {
+        message?: string | undefined;
+        kind: string;
+        position?: number | undefined;
+        url?: string | undefined;
+        name?: string | undefined;
+        title?: string | undefined;
+        mime?: string | undefined;
+        size?: number | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        duration?: number | undefined;
+        text?: string | undefined;
+        extraction?: {
+            origin: string;
+            extractor: string;
+            chars: number;
+            error?: string | undefined;
+        } | undefined;
+        local_path?: string | undefined;
+        contact?: {
+            name: string;
+            first_name?: string | undefined;
+            last_name?: string | undefined;
+            phone?: string | undefined;
+            user_id?: string | undefined;
+        } | undefined;
+        buttons?: {
+            kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
+            text: string;
+            url?: string | undefined;
+        }[][] | undefined;
+    }[];
+};
 export declare const inboxAnswer: (inbox: Inbox, hearing: Hearing | undefined, reader: AccountKey, transcribe: boolean, meta?: Partial<Meta>) => import("../envelope.js").ListBody<{
     ref: string;
     chat_id: string;
@@ -113,3 +161,4 @@ export declare const reviewAnswer: (found: Review, hearing: Hearing | undefined,
         }[][] | undefined;
     }[];
 }>;
+export {};

package/dist/cli/messenger/catch-up-answers.js

@@ -33,7 +33,8 @@ export const catchUpQuery = (words, registry, command) => {
         ...(meta === undefined ? {} : { meta }),
     };
 };
-const summaryOf = (message, reader) => {
+/** One message of a catch-up answer: the fields `inbox` and `review` show, for every messenger and for mail. */
+export const summaryOf = (message, reader) => {
     const { ref, chat_id, chat_title, timestamp, sender_name, sender_is_me, outgoing, text, transcript, attachments } = messageItem(message, reader);
     return {
         ref,

package/dist/cli/messenger/catch-up.d.ts

@@ -1,3 +1,7 @@
 import type { Command } from "commander";
-/** Whose `--new` points a run moves: an agent's are its own, so the owner's `inbox --new` still shows everything. */
-export declare const pointsOf: <N extends "inbox" | "review">(command: Command, name: N) => N | `mcp-${N}`;
+import type { AppIdentity } from "../../ports/app.js";
+/**
+ * Whose `--new` points a run moves. A scheduled run (`<PREFIX>_SCHEDULED`) keeps one per schedule, an agent over MCP
+ * one of its own, and the owner the plain one: no reader moves another's point past what it never showed.
+ */
+export declare const pointsOf: (command: Command, name: string, app: Pick<AppIdentity, "envPrefix">) => string;

package/dist/cli/messenger/catch-up.js

@@ -1,3 +1,12 @@
 import { environmentOf } from "../context.js";
-/** Whose `--new` points a run moves: an agent's are its own, so the owner's `inbox --new` still shows everything. */
-export const pointsOf = (command, name) => environmentOf(command).agent ? `mcp-${name}` : name;
+/**
+ * Whose `--new` points a run moves. A scheduled run (`<PREFIX>_SCHEDULED`) keeps one per schedule, an agent over MCP
+ * one of its own, and the owner the plain one: no reader moves another's point past what it never showed.
+ */
+export const pointsOf = (command, name, app) => {
+    const { agent, env } = environmentOf(command);
+    const scheduled = (env ?? process.env)[`${app.envPrefix}_SCHEDULED`]?.trim();
+    if (scheduled)
+        return `schedule-${scheduled.replace(/[^a-z0-9-]/gi, "_")}-${name}`;
+    return agent ? `mcp-${name}` : name;
+};

package/dist/cli/messenger/conversation-answers.d.ts

@@ -248,6 +248,9 @@ export declare const conversationShown: (account: AccountKey, { summary, message
                 signals: string[];
                 demoted?: true | undefined;
             } | undefined;
+            bulk?: boolean | undefined;
+            list_id?: string | null | undefined;
+            rule_id?: number | null | undefined;
         } | undefined;
         provider_metadata?: {
             [x: string]: unknown;

package/dist/cli/messenger/inbox.js

@@ -53,7 +53,7 @@ export const inboxCommand = (messenger) => annotate(new Command("inbox"), {
         throw new CliError("validation_error", "--new keeps its own point — not with a date in the query");
     const saved = fresh && since === undefined
         ? checkPoints(app, {
-            command: pointsOf(this, "inbox"),
+            command: pointsOf(this, "inbox", app),
             profile: settings.profile,
             env,
             firstLookMs: FIRST_LOOK_MS,

package/dist/cli/messenger/message-answers.d.ts

@@ -225,6 +225,9 @@ export declare const threadAnswer: ({ items, ...thread }: ThreadContext, reader:
                 signals: string[];
                 demoted?: true | undefined;
             } | undefined;
+            bulk?: boolean | undefined;
+            list_id?: string | null | undefined;
+            rule_id?: number | null | undefined;
         } | undefined;
         provider_metadata?: {
             [x: string]: unknown;

package/dist/cli/messenger/message-writes.d.ts

@@ -229,6 +229,9 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                 signals: string[];
                 demoted?: true | undefined;
             } | undefined;
+            bulk?: boolean | undefined;
+            list_id?: string | null | undefined;
+            rule_id?: number | null | undefined;
         } | undefined;
         provider_metadata?: {
             [x: string]: unknown;
@@ -448,6 +451,9 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                 signals: string[];
                 demoted?: true | undefined;
             } | undefined;
+            bulk?: boolean | undefined;
+            list_id?: string | null | undefined;
+            rule_id?: number | null | undefined;
         } | undefined;
         provider_metadata?: {
             [x: string]: unknown;

package/dist/cli/messenger/points.d.ts

@@ -5,16 +5,21 @@ export interface CheckPoints {
     first: number;
     /** ms, per chat: where its next check starts. */
     chats: ReadonlyMap<Id, number>;
-    /** Moves the chats checked; the rest keep their point. */
-    save(checked: Record<Id, string>): void;
+    /**
+     * Moves the chats checked; the rest keep their point. With `through`, everything up to it was read: the start for
+     * a chat never checked moves there, and the points it passes are dropped, so the file stays small.
+     */
+    save(checked: Record<Id, string>, options?: {
+        through?: string;
+    }): void;
 }
 /**
  * Where `<command> --new` stopped, per chat and profile, beside the remembered account. `inbox` and
  * `review` keep a file each: sharing one, an `inbox` run would move `review` past what it never showed.
- * The MCP tools keep their own too, so an agent's run never moves the owner's `--new`.
+ * Each reader keeps its own too (`pointsOf`), so an agent's or a schedule's run never moves the owner's `--new`.
  */
 export declare const checkPoints: (app: AppIdentity, { command, profile, env, firstLookMs, }: {
-    command: "inbox" | "review" | "mcp-inbox" | "mcp-review";
+    command: string;
     profile: string;
     env: NodeJS.ProcessEnv;
     firstLookMs: number;

package/dist/cli/messenger/points.js

@@ -4,7 +4,7 @@ import { resolvePaths, writeSecurely } from "@wirecat/cli-base";
 /**
  * Where `<command> --new` stopped, per chat and profile, beside the remembered account. `inbox` and
  * `review` keep a file each: sharing one, an `inbox` run would move `review` past what it never showed.
- * The MCP tools keep their own too, so an agent's run never moves the owner's `--new`.
+ * Each reader keeps its own too (`pointsOf`), so an agent's or a schedule's run never moves the owner's `--new`.
  */
 export const checkPoints = (app, { command, profile, env, firstLookMs, }) => {
     const file = join(resolvePaths({ appName: app.appName, prefix: app.envPrefix, env }).state, command, `${profile}.json`);
@@ -13,10 +13,16 @@ export const checkPoints = (app, { command, profile, env, firstLookMs, }) => {
     return {
         first: Date.parse(first),
         chats: new Map(Object.entries(saved.chats ?? {}).map(([chat, at]) => [chat, Date.parse(at)])),
-        save: (checked) => {
-            if (Object.keys(checked).length === 0)
+        save: (checked, { through } = {}) => {
+            if (Object.keys(checked).length === 0 && through === undefined)
                 return;
-            const kept = { lastCheckAt: first, chats: { ...saved.chats, ...checked } };
+            const chats = { ...saved.chats, ...checked };
+            const kept = through === undefined
+                ? { lastCheckAt: first, chats }
+                : {
+                    lastCheckAt: through,
+                    chats: Object.fromEntries(Object.entries(chats).filter(([, at]) => Date.parse(at) > Date.parse(through))),
+                };
             writeSecurely(file, `${JSON.stringify(kept)}\n`, 0o600);
         },
     };

package/dist/cli/messenger/review.js

@@ -52,7 +52,7 @@ export const reviewCommand = (messenger) => annotate(new Command("review"), {
     }
     const saved = options.new
         ? checkPoints(messenger.app, {
-            command: pointsOf(this, "review"),
+            command: pointsOf(this, "review", messenger.app),
             profile: settings.profile,
             env,
             firstLookMs: REVIEW_DAYS * 86_400_000,

package/dist/domain/models.d.ts

@@ -519,6 +519,10 @@ export interface Review {
     unanswered?: {
         olderThanHours: number;
     };
+    /** `--waiting` (mail): only threads where the owner wrote last and nobody answered for this many hours. */
+    waiting?: {
+        olderThanHours: number;
+    };
     /** With saved points: each chat read whole, and the time its next check starts from. */
     checked?: Record<Id, string>;
     /** Tasks the review opened and closed in the store, by the rules; absent when the store was not open. */

package/dist/entities/contact-context.d.ts

@@ -346,6 +346,9 @@ export declare const contactMessages: v.StrictObjectSchema<{
                     readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                     readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
                 }, undefined>, undefined>;
+                readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
                 readonly reply_to: v.ArraySchema<v.StrictObjectSchema<{
                     readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                     readonly address: v.StringSchema<undefined>;
@@ -1118,6 +1121,9 @@ export declare const contactContext: v.UnionSchema<[v.StrictObjectSchema<{
                     readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                     readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
                 }, undefined>, undefined>;
+                readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
                 readonly reply_to: v.ArraySchema<v.StrictObjectSchema<{
                     readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                     readonly address: v.StringSchema<undefined>;

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

@@ -224,6 +224,9 @@ export declare const conversationDetails: v.UnionSchema<[v.StrictObjectSchema<{
                 readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                 readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
             }, undefined>, undefined>;
+            readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
         }, undefined>, undefined>;
         readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
     }, undefined>, undefined>;
@@ -441,6 +444,9 @@ export declare const conversationDetails: v.UnionSchema<[v.StrictObjectSchema<{
             readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
             readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
     }, undefined>, undefined>;
     readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
 }, undefined>], undefined>;

package/dist/entities/evidence.d.ts

@@ -215,6 +215,9 @@ export declare const contribution: v.StrictObjectSchema<{
                 readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                 readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
             }, undefined>, undefined>;
+            readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
         }, undefined>, undefined>;
         readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
     }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
@@ -432,6 +435,9 @@ export declare const contribution: v.StrictObjectSchema<{
                     readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                     readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
                 }, undefined>, undefined>;
+                readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
             }, undefined>, undefined>;
             readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
         }, "chat_title" | "ref" | "sender_name" | "text" | "timestamp">;
@@ -687,6 +693,9 @@ export declare const contribution: v.StrictObjectSchema<{
                 readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                 readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
             }, undefined>, undefined>;
+            readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
         }, undefined>, undefined>;
         readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
     }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
@@ -904,6 +913,9 @@ export declare const contribution: v.StrictObjectSchema<{
                     readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                     readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
                 }, undefined>, undefined>;
+                readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
             }, undefined>, undefined>;
             readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
         }, "chat_title" | "ref" | "sender_name" | "text" | "timestamp">;
@@ -1195,6 +1207,9 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
                 readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                 readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
             }, undefined>, undefined>;
+            readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
         }, undefined>, undefined>;
         readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
     }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
@@ -1412,6 +1427,9 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
                     readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                     readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
                 }, undefined>, undefined>;
+                readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
             }, undefined>, undefined>;
             readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
         }, "chat_title" | "ref" | "sender_name" | "text" | "timestamp">;
@@ -1667,6 +1685,9 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
                 readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                 readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
             }, undefined>, undefined>;
+            readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+            readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
         }, undefined>, undefined>;
         readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
     }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
@@ -1884,6 +1905,9 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
                     readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
                     readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
                 }, undefined>, undefined>;
+                readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+                readonly rule_id: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
             }, undefined>, undefined>;
             readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
         }, "chat_title" | "ref" | "sender_name" | "text" | "timestamp">;