@wirecat/cli-core 0.554.0 → 0.556.0

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

@@ -219,6 +219,9 @@ export declare const messageThread: 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>;
@@ -460,6 +463,9 @@ export declare const messageContext: 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>, v.StrictObjectSchema<{
@@ -682,6 +688,9 @@ export declare const messageContext: 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/message-write.d.ts

@@ -215,6 +215,9 @@ export declare const messageWrite: 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>;
@@ -433,6 +436,9 @@ export declare const messageWrite: 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>, undefined>;
@@ -659,6 +665,9 @@ export declare const messageSend: 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>;
@@ -877,6 +886,9 @@ export declare const messageSend: 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>, undefined>;

package/dist/entities/message.d.ts

@@ -238,6 +238,12 @@ export declare const message: v.StrictObjectSchema<{
             readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
             readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
         }, undefined>, undefined>;
+        /** Mail `review`: filed in the mailbox of mail sent to many. */
+        readonly bulk: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        /** Mail `review`: its List-Id, `null` when it has none. */
+        readonly list_id: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        /** Mail `review`: the mail rule that decided how it is stored, by its id in `rules list`; `null` when none. */
+        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>;

package/dist/entities/message.js

@@ -103,6 +103,12 @@ export const message = v.strictObject({
         flagged: v.nullable(v.boolean()),
         /** How much the sender's mail looks like spam, a scam or a robot (memo's score), and why; absent when unscored. */
         sender_score: v.optional(v.strictObject({ score: v.number(), signals: v.array(text), demoted: v.optional(v.literal(true)) })),
+        /** Mail `review`: filed in the mailbox of mail sent to many. */
+        bulk: v.optional(v.boolean()),
+        /** Mail `review`: its List-Id, `null` when it has none. */
+        list_id: v.optional(v.nullable(text)),
+        /** Mail `review`: the mail rule that decided how it is stored, by its id in `rules list`; `null` when none. */
+        rule_id: v.optional(v.nullable(v.number())),
     })),
     provider_metadata: providerMetadata,
 });

package/dist/entities/store-records.d.ts

@@ -238,6 +238,9 @@ export declare const storeExport: 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>, v.StrictObjectSchema<{

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

@@ -587,3 +587,75 @@ export declare const taskScan: v.StrictObjectSchema<{
         readonly category: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>, undefined>;
 }, undefined>;
+export declare const taskAnalysisMark: v.StrictObjectSchema<{
+    readonly chat: v.StringSchema<undefined>;
+    readonly from: 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`">]>;
+    readonly through: 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`">]>;
+    readonly through_id: v.StringSchema<undefined>;
+    readonly by: v.StringSchema<undefined>;
+    readonly checked_at: 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`">]>;
+    readonly checked_through: 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`">]>;
+    readonly at: 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>;
+export declare const taskAnalysisMarkMoved: v.StrictObjectSchema<{
+    readonly chat: v.StringSchema<undefined>;
+    readonly from: 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`">]>;
+    readonly through: 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`">]>;
+    readonly through_id: v.StringSchema<undefined>;
+    readonly by: v.StringSchema<undefined>;
+    readonly checked_at: 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`">]>;
+    readonly checked_through: 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`">]>;
+    readonly at: 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`">]>;
+    readonly moved: v.BooleanSchema<undefined>;
+}, undefined>;
+export declare const taskAnalysis: v.StrictObjectSchema<{
+    readonly chat: v.StringSchema<undefined>;
+    readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly kind: v.StringSchema<undefined>;
+    readonly newest_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 mark: v.NullableSchema<v.StrictObjectSchema<{
+        readonly chat: v.StringSchema<undefined>;
+        readonly from: 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`">]>;
+        readonly through: 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`">]>;
+        readonly through_id: v.StringSchema<undefined>;
+        readonly by: v.StringSchema<undefined>;
+        readonly checked_at: 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`">]>;
+        readonly checked_through: 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`">]>;
+        readonly at: 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>, undefined>;
+    readonly waiting: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly late: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly untrusted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+export declare const taskReview: v.StrictObjectSchema<{
+    readonly chat: v.StringSchema<undefined>;
+    readonly from: 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`">]>;
+    readonly mark: v.NullableSchema<v.StrictObjectSchema<{
+        readonly chat: v.StringSchema<undefined>;
+        readonly from: 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`">]>;
+        readonly through: 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`">]>;
+        readonly through_id: v.StringSchema<undefined>;
+        readonly by: v.StringSchema<undefined>;
+        readonly checked_at: 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`">]>;
+        readonly checked_through: 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`">]>;
+        readonly at: 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>, undefined>;
+    readonly late: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly has_more: v.BooleanSchema<undefined>;
+    readonly through: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+    readonly messages: v.ArraySchema<v.StrictObjectSchema<{
+        readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly at: 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`">]>;
+        readonly sender: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly outgoing: v.BooleanSchema<undefined>;
+        readonly reply_to: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly text: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+    readonly open_tasks: v.ArraySchema<v.StrictObjectSchema<{
+        readonly key: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly kind: v.StringSchema<undefined>;
+        readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly source: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly untrusted: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+}, undefined>;

package/dist/entities/task-results.js

@@ -2,7 +2,7 @@ import * as v from "valibot";
 import { TASK_TYPES } from "../domain/knowledge.js";
 import { LINK_KINDS, LINK_SOURCES } from "../store/sqlite/link-kinds.js";
 import { PRIORITY_LABELS, TASK_KINDS, TASK_ORIGINS, TASK_STATES, TASK_VERDICTS } from "../tasks/index.js";
-import { count, id, reference, text, time } from "./fields.js";
+import { count, id, reference, text, time, untrusted } from "./fields.js";
 import { closeSuggestion } from "./task.js";
 import { taskPair } from "./task-pair.js";
 const nullableTime = v.nullable(time);
@@ -135,3 +135,42 @@ export const taskScan = v.strictObject({
     held_chats: v.optional(count),
     tasks: v.array(v.strictObject({ source: text, kind: v.picklist(TASK_KINDS), category: v.nullable(text) })),
 });
+export const taskAnalysisMark = v.strictObject({
+    chat: text,
+    from: time,
+    through: time,
+    through_id: text,
+    by: text,
+    checked_at: time,
+    checked_through: time,
+    at: time,
+});
+export const taskAnalysisMarkMoved = v.strictObject({ ...taskAnalysisMark.entries, moved: v.boolean() });
+export const taskAnalysis = v.strictObject({
+    chat: text,
+    title: v.nullable(text),
+    kind: text,
+    newest_at: nullableTime,
+    mark: v.nullable(taskAnalysisMark),
+    waiting: count,
+    late: count,
+    untrusted,
+});
+export const taskReview = v.strictObject({
+    chat: text,
+    from: time,
+    mark: v.nullable(taskAnalysisMark),
+    late: count,
+    has_more: v.boolean(),
+    through: v.nullable(reference),
+    messages: v.array(v.strictObject({
+        ref: reference,
+        at: time,
+        sender: v.nullable(text),
+        outgoing: v.boolean(),
+        reply_to: v.nullable(text),
+        text,
+    })),
+    open_tasks: v.array(v.strictObject({ key: v.nullable(text), kind: text, title: v.nullable(text), source: v.nullable(text) })),
+    untrusted,
+});

package/dist/errors/reasons.d.ts

@@ -7,7 +7,7 @@ export declare const REASONS: ErrorReason[];
  * Detail keys an error from this package may carry, until each is registered on its own reason. Not `cause`:
  * that can hold a provider's or SQLite's raw text.
  */
-export declare const DETAILS: readonly ["contracts", "calendars", "allowed", "alternative", "arguments", "at", "available", "batch", "budget", "built", "candidates", "chat", "chat_id", "cli", "complete", "emitted_bytes", "exact", "forum", "guide", "hint", "id", "index", "kind", "limit", "limit_source", "max_bytes", "model", "name", "operation_id", "operation_ids", "text_limit", "store_refused_in", "subtasks", "partial_output", "parent", "path", "permission", "person_ids", "previous_chat_id", "profiles", "provider_error", "provider", "recovery", "reference", "remembered", "retry_at", "retry_after_ms", "runtime", "saved", "scheduled_for", "script", "sent", "sent_count", "settlement_failed", "span", "sqlite", "stage", "standing", "state", "stderr", "term", "total", "upgraded", "wanted"];
+export declare const DETAILS: readonly ["contracts", "calendars", "allowed", "alternative", "arguments", "at", "available", "batch", "budget", "built", "candidates", "chat", "chat_id", "cli", "column", "complete", "emitted_bytes", "exact", "file", "forum", "guide", "hint", "id", "index", "kind", "limit", "limit_source", "line", "max_bytes", "model", "name", "operation_id", "operation_ids", "text_limit", "store_refused_in", "subtasks", "partial_output", "parent", "path", "permission", "person_ids", "previous_chat_id", "profiles", "provider_error", "provider", "recovery", "reference", "remembered", "retry_at", "retry_after_ms", "runtime", "saved", "scheduled_for", "script", "sent", "sent_count", "settlement_failed", "span", "sqlite", "stage", "standing", "state", "stderr", "term", "total", "upgraded", "wanted"];
 /** What a CLI adds to the shared registry: its own reasons, and the detail keys its adapters raise. */
 export interface AppErrors {
     reasons?: readonly ErrorReason[];

package/dist/errors/reasons.js

@@ -57,6 +57,11 @@ const OTHERS = [
     validation("push.too-many-files", "the folder holds more files than one push takes"),
     validation("push.unreadable", "the folder to push could not be read"),
     validation("spreadsheet.unreadable", "the workbook could not be read"),
+    [
+        "config.unrepairable",
+        "configuration_error",
+        "the settings file's damage has more than one reading; nothing was changed, so it is fixed by hand",
+    ],
     ["state.invalid", "configuration_error", "the saved sync state is unreadable or invalid; it is kept, not reset"],
     ["sync.partial", "provider_error", "some calendars did not sync; the next sync retries them"],
     validation("event.conflict", "the event changed at the provider since the last sync; sync and try again"),
@@ -188,6 +193,7 @@ const OTHERS = [
     validation("task.has-subtasks", "the task has subtasks; move or detach them before it moves to another project"),
     validation("task.is-subtask", "a subtask moves to another project only when it is detached from its parent in the same write"),
     validation("task.duplicate-candidates", "open tasks may be the same job: attach to one, or add it as new"),
+    validation("task.already-read", "the message was already read for tasks: a read again only updates and closes tasks unless --open-new"),
     validation("task.certainty-required", "an agent closes a task with its certainty, 0 to 1"),
     ["task.pair-decided", "permission_error", "the owner already decided the pair; an agent does not change it"],
     validation("task.no-close-suggestion", "the task has no agent's close waiting on the owner"),
@@ -245,9 +251,11 @@ export const DETAILS = [
     "chat",
     "chat_id",
     "cli",
+    "column",
     "complete",
     "emitted_bytes",
     "exact",
+    "file",
     "forum",
     "guide",
     "hint",
@@ -256,6 +264,7 @@ export const DETAILS = [
     "kind",
     "limit",
     "limit_source",
+    "line",
     "max_bytes",
     "model",
     "name",

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

@@ -2,6 +2,8 @@ import { Command } from "commander";
 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 { mailMark, markItem, markText } from "./marks.js";
+export { MAIL_REVIEW_QUERY, MAIL_REVIEW_STEPS } from "./review.js";
 /** What a mail CLI hands the shared commands: how to open the store for one run, and whose mail it reads. */
 export interface MailReads {
     app: AppIdentity;
@@ -21,7 +23,7 @@ export declare const THREAD_QUERY: {
     readonly fields: import("@wirecat/cli-base/query").FieldSpec[];
 };
 /**
- * `search messages`, `messages show` and `conversations list|show` over the mail a mail CLI stored: the same
+ * `search messages`, `review`, `messages show` and `conversations list|show` over the mail a mail CLI stored: the same
  * query language, ranking and answers as memo's mail search, read only, scoped to the profile's mailbox.
  */
 export declare const mailReadCommands: (mail: MailReads) => Command[];

package/dist/mail/cli/index.js

@@ -18,6 +18,10 @@ 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 { mailReviewCommand } from "./review.js";
+export { mailMark, markItem, markText } from "./marks.js";
+export { MAIL_REVIEW_QUERY, MAIL_REVIEW_STEPS } from "./review.js";
 /** A locked or broken store must fail the command, not read as "nothing stored yet". */
 const absentAccount = (error) => {
     if (error instanceof CliError && error.code === "not_found")
@@ -224,6 +228,7 @@ const messagesCommand = (mail) => {
             ? listOf("messages show", { items: shown, limit: Math.max(1, shown.length), has_more: false })
             : itemOf(shown.find((_, at) => emails[at]?.anchor) ?? shown[0]), () => shownText(emails));
     });
+    messages.addCommand(acknowledgeCommand(mail));
     return messages;
 };
 const mailThread = v.strictObject({
@@ -323,11 +328,12 @@ const conversationsCommand = (mail) => {
     return conversations;
 };
 /**
- * `search messages`, `messages show` and `conversations list|show` over the mail a mail CLI stored: the same
+ * `search messages`, `review`, `messages show` and `conversations list|show` over the mail a mail CLI stored: the same
  * query language, ranking and answers as memo's mail search, read only, scoped to the profile's mailbox.
  */
 export const mailReadCommands = sharedCommand((mail) => [
     searchCommand(mail),
+    mailReviewCommand(mail),
     messagesCommand(mail),
     conversationsCommand(mail),
 ]);

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

@@ -0,0 +1,26 @@
+import { Command } from "commander";
+import * as v from "valibot";
+import { type MailMark } from "../marks.js";
+import type { MailReads } from "./index.js";
+/** A holder's mark as `--json`, `mail status` and MCP show it. */
+export declare const mailMark: v.StrictObjectSchema<{
+    readonly holder: v.StringSchema<undefined>;
+    readonly through_id: v.NumberSchema<undefined>;
+    readonly through_received_at: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly held: v.NumberSchema<undefined>;
+    readonly read: v.NumberSchema<undefined>;
+    readonly skipped: v.StrictObjectSchema<{
+        readonly bulk: v.NumberSchema<undefined>;
+        readonly envelope: v.NumberSchema<undefined>;
+        readonly partial: v.NumberSchema<undefined>;
+        readonly draft: v.NumberSchema<undefined>;
+    }, undefined>;
+    readonly updated_at: v.StringSchema<undefined>;
+}, undefined>;
+export declare const markItem: (mark: MailMark) => v.InferOutput<typeof mailMark>;
+export declare const markText: (mark: MailMark) => string;
+/**
+ * `messages acknowledge`: a holder says it is done with what `review --holder` gave it, and its mark moves there. It
+ * only moves the holder's own bookkeeping forward, so a read-only scheduled run may do it.
+ */
+export declare const acknowledgeCommand: (mail: MailReads) => Command;

package/dist/mail/cli/marks.js

@@ -0,0 +1,51 @@
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import * as v from "valibot";
+import { answerEntity } from "../../cli/answer-entity.js";
+import { outputFor } from "../../cli/context.js";
+import { destroysNothing, LOCAL_WRITE } from "../../cli/effects.js";
+import { itemOf, renderAnswer } from "../../cli/envelope.js";
+import { acknowledgeMark } 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({
+    holder: v.string(),
+    through_id: v.number(),
+    through_received_at: v.nullable(v.string()),
+    held: v.number(),
+    read: v.number(),
+    skipped: v.strictObject({ bulk: v.number(), envelope: v.number(), partial: v.number(), draft: v.number() }),
+    updated_at: v.string(),
+});
+export const markItem = (mark) => ({
+    holder: mark.holder,
+    through_id: mark.throughId,
+    through_received_at: iso(mark.throughAt),
+    held: mark.held.length,
+    read: mark.read,
+    skipped: mark.skipped,
+    updated_at: iso(mark.updatedAt),
+});
+export const markText = (mark) => `${mark.holder}  through ${mark.throughId}${mark.throughAt === null ? "" : ` (${iso(mark.throughAt)})`}  ` +
+    `read ${mark.read}  held ${mark.held.length}  skipped bulk ${mark.skipped.bulk}, envelope ${mark.skipped.envelope}, ` +
+    `partial ${mark.skipped.partial}, draft ${mark.skipped.draft}  updated ${iso(mark.updatedAt)}\n`;
+/**
+ * `messages acknowledge`: a holder says it is done with what `review --holder` gave it, and its mark moves there. It
+ * only moves the holder's own bookkeeping forward, so a read-only scheduled run may do it.
+ */
+export const acknowledgeCommand = (mail) => answerEntity(destroysNothing(annotate(new Command("acknowledge"), {
+    effects: LOCAL_WRITE,
+    examples: [
+        `${mail.app.command} personal messages acknowledge --holder mail-triage --cursor 9123.1762090000000`,
+    ],
+})), "mail_mark", mailMark)
+    .summary("move a holder's processing mark to what it has read")
+    .description("record that a holder — an agent or a pipeline — processed the mail `review --holder` gave it, with the cursor " +
+    "that review gave; the mark only moves forward, and mail still partial waits for the next review")
+    .requiredOption("--holder <name>", "whose mark: lower-case letters, digits and dashes, such as mail-triage")
+    .requiredOption("--cursor <cursor>", "the cursor `review --holder` gave")
+    .action(async function () {
+    const { holder, cursor } = this.opts();
+    const mark = await mail.read(this, (store, mailbox) => acknowledgeMark(store, mailbox, holder, cursor));
+    renderAnswer(this, outputFor(this), itemOf(markItem(mark)), () => markText(mark));
+});

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

@@ -0,0 +1,24 @@
+import { Command } from "commander";
+import type { MailReads } from "./index.js";
+/** Where a mail review starts: a time only; one thread is `conversations show`. */
+export declare const MAIL_REVIEW_QUERY: import("@wirecat/cli-base/query").QueryRegistry;
+/** The mail review's steps; a host lists them beside its own so its step checks know them. */
+export declare const MAIL_REVIEW_STEPS: ({
+    id: string;
+    kind: "command";
+    command: string;
+    args: {
+        name: string;
+        required: boolean;
+    }[];
+    why: string;
+} | {
+    id: string;
+    kind: "user_action";
+    why: string;
+})[];
+/**
+ * `review` over the stored mail of the profile's mailbox, with tg's words: what is new, what the owner owes, what
+ * waits for an answer. It reads the store only and opens no task.
+ */
+export declare const mailReviewCommand: (mail: MailReads) => Command;