@wirecat/cli-core 0.562.0 → 0.564.0

package/dist/entities/index.js

@@ -44,9 +44,10 @@ import { joinRequest } from "./join-request.js";
 import { organization, project, reminder } from "./knowledge-lists.js";
 import { botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, callRecord, scheduledJob, stickerInventory, topicIcon, } from "./list-results.js";
 import { messageEvent, serveSummary, watchedMessage, watchItem } from "./listener.js";
+import { mailCounts } from "./mail-counts.js";
 import { mailFindings } from "./mail-findings.js";
 import { mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer } from "./media-archive.js";
-import { event, meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "./meeting.js";
+import { event, meeting, meetingCounts, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "./meeting.js";
 import { meetingEvidence, meetingPersonContext } from "./meeting-evidence.js";
 import { meetingFindings } from "./meeting-findings.js";
 import { meetingPreparation } from "./meeting-preparation.js";
@@ -78,11 +79,12 @@ import { reactionChange } from "./reaction-change.js";
 import { recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved } from "./recipient.js";
 import { recordedRun, runDetails, runHit, runLocation } from "./recorded-run.js";
 import { relationship } from "./relationship.js";
+import { responseTimes, waitingChats } from "./reply-stats.js";
 import { retention } from "./retention.js";
 import { savedSearch, searchHistoryClear } from "./saved-search.js";
 import { sendAttempt } from "./send-attempt.js";
 import { storeBackup, storeCheck, storeCopyRemoval, storeDecrypt, storeInfo, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, } from "./store-maintenance.js";
-import { storeChatStatus, storeClear, storeExport, storeGapPlan, storeGapRepair, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, syncProgress, } from "./store-records.js";
+import { chatCoverage, storeChatStatus, storeClear, storeExport, storeGapPlan, storeGapRepair, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, syncProgress, } from "./store-records.js";
 import { storeTable } from "./store-table.js";
 import { automaticTags, tagChange } from "./tag-change.js";
 import { tagging } from "./tagging.js";
@@ -95,7 +97,7 @@ import { topic } from "./topic.js";
  * subset of its fields, never a renamed one. Commands move onto these one by one; until then, a schema
  * is the target, not a description of today's output.
  */
-export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, organization, person, place, poll, pollChange, pollVote, project, ranking, reaction, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, reminder, removedModelKey, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, storeTable, tagChange, tagging, task, taskAnalysis, taskAnalysisMark, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, topicIcon, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
+export { account, accountChange, accountPrivacy, accountPrivacyChange, accountProfile, accountSession, adminReport, agenda, analysisConsent, analysisConsentRevocation, attachment, attachmentBytes, attachmentExtraction, attachmentTextChange, automaticTags, botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, cachedChatMetadata, callRecord, chart, chat, chatAdminChange, chatArchive, chatCoverage, chatEvent, chatFolderChange, chatFolderOrder, chatFolderRemoval, chatGroupChange, chatInspection, chatInvite, chatInviteChange, chatMembersChange, chatMembersFetch, chatMetadata, chatMetadataRefresh, chatModeration, chatMuting, chatPin, chatRead, chatRemoval, chatRequestChange, chatRules, chatSender, chatStats, chatTracking, chatUnread, contact, contactActivity, contactAlias, contactCheck, contactContext, contactImport, contactLookup, contactNote, contactNoteRemoval, contactPreparation, contactStateChange, contactSync, contactUpdate, conversation, conversationBatch, conversationBatchStatus, conversationBuildResult, conversationChange, conversationDetails, conversationEmbedding, conversationEmbeddingStatus, conversationHit, conversationPreparation, conversationReadiness, counterRefresh, counters, document, documentLink, endedAccountSessions, evidence, evidencePacket, fact, folder, hit, identity, imageEmbedding, inviteLink, job, joinRequest, linkedPerson, mailCounts, mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, mention, mentionDecision, mentionDetails, mentionDomain, mentionRebuild, message, messageContext, messageCounts, messageDeletion, messageDownload, messageEvent, messageLink, messageLinks, messagePin, messageStar, messageSync, messageTranscript, messageWrite, model, modelKey, note, officialStats, organization, person, place, poll, pollChange, pollVote, project, ranking, reaction, reactionChange, recipient, recipientAdded, recipientChange, recipientOff, recipientRemoved, recordedRun, reference, relationship, reminder, removedModelKey, responseTimes, retention, runDetails, runHit, runLocation, savedSearch, scheduledJob, searchHistoryClear, sendAttempt, serveSummary, stickerInventory, storeBackup, storeChatStatus, storeCheck, storeClear, storeCopyRemoval, storeDecrypt, storedModelKey, storeExport, storeGapPlan, storeGapRepair, storeInfo, storeJobCancel, storeJobClear, storeJobDetails, storeJobRetry, storeMigration, storeReindex, storeRepair, storeReset, storeRestore, storeTable, tagChange, tagging, task, taskAnalysis, taskAnalysisMark, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, topicIcon, trackedChat, trackedChatHistory, waitingChats, watchedMessage, watchItem, };
 export const ENTITIES = {
     sync_progress: syncProgress,
     ...MEETING_RESULT_ENTITIES,
@@ -125,19 +127,22 @@ export const ENTITIES = {
         attachments: v.optional(v.array(hitFile)),
         untrusted,
     }),
-    "message.summary": v.pick(message, [
-        "ref",
-        "chat_id",
-        "chat_title",
-        "timestamp",
-        "sender_name",
-        "sender_is_me",
-        "outgoing",
-        "text",
-        "transcript",
-        "attachments",
-        "email",
-    ]),
+    "message.summary": v.strictObject({
+        ...v.pick(message, [
+            "ref",
+            "chat_id",
+            "chat_title",
+            "timestamp",
+            "sender_name",
+            "sender_is_me",
+            "outgoing",
+            "text",
+            "transcript",
+            "attachments",
+            "email",
+        ]).entries,
+        untrusted,
+    }),
     message_link: messageLink,
     message_write: messageWrite,
     message_send: messageSend,
@@ -256,6 +261,7 @@ export const ENTITIES = {
     meeting_review: meetingReview,
     meeting_link: meetingLink,
     meeting_stats: meetingStats,
+    meeting_counts: meetingCounts,
     meeting_speaker: meetingSpeaker,
     meeting_participants: meetingParticipants,
     meeting_passage: meetingPassage,
@@ -293,6 +299,7 @@ export const ENTITIES = {
     job,
     store_chat_status: storeChatStatus,
     store_clear: storeClear,
+    chat_coverage: chatCoverage,
     store_export: storeExport,
     store_gap_plan: storeGapPlan,
     store_gap_repair: storeGapRepair,
@@ -348,6 +355,9 @@ export const ENTITIES = {
     topic,
     folder,
     message_counts: messageCounts,
+    response_times: responseTimes,
+    waiting_chats: waitingChats,
+    mail_counts: mailCounts,
     ranking,
     admin_report: adminReport,
     analysis_consent: analysisConsent,

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

@@ -0,0 +1,15 @@
+import * as v from "valibot";
+/** Stored mail received and sent, one row per calendar day, week (by its Monday) or sender. */
+export declare const mailCounts: v.StrictObjectSchema<{
+    readonly by: v.PicklistSchema<["day", "week", "sender"], undefined>;
+    readonly received: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly sent: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly rows: v.ArraySchema<v.StrictObjectSchema<{
+        /** `YYYY-MM-DD`, or the sender's address. */
+        readonly key: v.StringSchema<undefined>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly received: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        /** Always 0 by sender: the owner sends that mail. */
+        readonly sent: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, undefined>, undefined>;
+}, undefined>;

package/dist/entities/mail-counts.js

@@ -0,0 +1,16 @@
+import * as v from "valibot";
+import { count, text } from "./fields.js";
+/** Stored mail received and sent, one row per calendar day, week (by its Monday) or sender. */
+export const mailCounts = v.strictObject({
+    by: v.picklist(["day", "week", "sender"]),
+    received: count,
+    sent: count,
+    rows: v.array(v.strictObject({
+        /** `YYYY-MM-DD`, or the sender's address. */
+        key: text,
+        name: v.nullable(text),
+        received: count,
+        /** Always 0 by sender: the owner sends that mail. */
+        sent: count,
+    })),
+});

package/dist/entities/meeting.d.ts

@@ -1 +1 @@
-export { event, meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "../meetings/index.js";
+export { event, meeting, meetingCounts, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "../meetings/index.js";

package/dist/entities/meeting.js

@@ -1 +1 @@
-export { event, meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "../meetings/index.js";
+export { event, meeting, meetingCounts, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "../meetings/index.js";

package/dist/entities/reply-stats.d.ts

@@ -0,0 +1,33 @@
+import * as v from "valibot";
+/** How long replies took in one-to-one chats: the owner's (`me`) or the other side's (`others`). */
+export declare const responseTimes: v.StrictObjectSchema<{
+    readonly replies: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly median_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    readonly p90_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    readonly mean_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    readonly who: v.PicklistSchema<["me", "others"], undefined>;
+    readonly buckets: v.StrictObjectSchema<{
+        readonly under_5m: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly under_1h: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly under_1d: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly over_1d: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, undefined>;
+    /** One row per calendar day of the reply; empty with `--by total`. */
+    readonly rows: v.ArraySchema<v.StrictObjectSchema<{
+        readonly replies: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly median_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+        readonly p90_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+        readonly mean_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+        readonly key: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+/** Chats whose newest message asks the owner something, and how much waits there. */
+export declare const waitingChats: v.StrictObjectSchema<{
+    readonly chats: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly oldest_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 by_kind: v.StrictObjectSchema<{
+        readonly private: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly group: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, undefined>;
+}, undefined>;

package/dist/entities/reply-stats.js

@@ -0,0 +1,19 @@
+import * as v from "valibot";
+import { count, text, time } from "./fields.js";
+const milliseconds = v.nullable(v.pipe(v.number(), v.minValue(0)));
+const figures = { replies: count, median_ms: milliseconds, p90_ms: milliseconds, mean_ms: milliseconds };
+/** How long replies took in one-to-one chats: the owner's (`me`) or the other side's (`others`). */
+export const responseTimes = v.strictObject({
+    who: v.picklist(["me", "others"]),
+    ...figures,
+    buckets: v.strictObject({ under_5m: count, under_1h: count, under_1d: count, over_1d: count }),
+    /** One row per calendar day of the reply; empty with `--by total`. */
+    rows: v.array(v.strictObject({ key: text, ...figures })),
+});
+/** Chats whose newest message asks the owner something, and how much waits there. */
+export const waitingChats = v.strictObject({
+    chats: count,
+    messages: count,
+    oldest_at: v.nullable(time),
+    by_kind: v.strictObject({ private: count, group: count }),
+});

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

@@ -12,6 +12,14 @@ export declare const storeChatStatus: v.StrictObjectSchema<{
         readonly to: v.NumberSchema<undefined>;
     }, undefined>, undefined>;
 }, undefined>;
+/** `store chats status`: chats = fetched + partial + never, over the account's searchable chats of every kind. */
+export declare const chatCoverage: v.StrictObjectSchema<{
+    readonly chats: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly fetched: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly partial: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly never: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly oldest_message_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>;
+}, undefined>;
 export declare const storeClear: v.StrictObjectSchema<{
     readonly cleared: v.BooleanSchema<undefined>;
     readonly dry_run: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;

package/dist/entities/store-records.js

@@ -17,6 +17,14 @@ export const storeChatStatus = v.strictObject({
     last_stored_at: v.nullable(time),
     held: v.array(range),
 });
+/** `store chats status`: chats = fetched + partial + never, over the account's searchable chats of every kind. */
+export const chatCoverage = v.strictObject({
+    chats: count,
+    fetched: count,
+    partial: count,
+    never: count,
+    oldest_message_at: v.nullable(time),
+});
 export const storeClear = v.strictObject({
     cleared: v.boolean(),
     dry_run: v.optional(v.literal(true)),

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", "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"];
+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", "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

@@ -47,6 +47,7 @@ const OTHERS = [
     validation("mail-findings.stale", "mail findings cite mail that changed since it was read; stage a new batch"),
     validation("mail-findings.partial", "a cited email is not stored whole yet; cite it once it is"),
     validation("evidence-findings.dedicated-review", "review evidence findings through the dedicated findings command"),
+    validation("mail-findings.dedicated-review", "review mail findings through the dedicated findings command"),
     validation("document.changed", "the document changed while it was read; nothing was saved"),
     ["document.not-imported", "not_found", "the document is not imported in this source account"],
     ["extraction.invalid-proposals", "invalid_response", "the model's memory proposals could not be used"],
@@ -54,6 +55,11 @@ const OTHERS = [
     validation("file.locked", "another process holds the file's lock"),
     ["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"],
+    [
+        "mail.attachments-unread",
+        "provider_unavailable",
+        "the email could not be read again, so its skipped attachments have no text",
+    ],
     ["mirror.partial", "provider_error", "some mirrored files were not synced"],
     ["profile.wrong-account", "authentication_error", "the signed-in source account does not match this profile"],
     validation("push.too-many-files", "the folder holds more files than one push takes"),
@@ -218,8 +224,7 @@ const OTHERS = [
     ["task.stale", "configuration_error", "the task changed since it was read; read it again"],
     validation("task.column", "the task beside which it moves is in another column than the status asked for"),
     validation("task.dependency-cycle", "the task would depend on itself"),
-    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.is-subtask", "a subtask moves to another project alone 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"),
@@ -300,7 +305,6 @@ export const DETAILS = [
     "operation_ids",
     "text_limit",
     "store_refused_in",
-    "subtasks",
     "partial_output",
     "parent",
     "path",

package/dist/mail/attachments.d.ts

@@ -3,14 +3,27 @@ import type { AttachmentInput, EmailAddress } from "../store/index.js";
 import type { Address, ParsedMail } from "./parse.js";
 import type { MailSyncResult } from "./sync.js";
 export declare const MAX_ATTACHMENT_CHARS = 200000;
+/** Whether a sync reads an email's attachments into the index, and the largest file it reads. */
+export interface MailAttachmentPolicy {
+    read: boolean;
+    maxBytes: number;
+}
+/** On, up to 10 MB a file: ordinary documents and scans are read, a large archive or video is not. */
+export declare const DEFAULT_ATTACHMENT_POLICY: MailAttachmentPolicy;
+/** Why a policy left an attachment unread; `readEmailWhole` reads it anyway. */
+export declare const POLICY_SKIPS: readonly ["not-read", "too-large"];
 /** One chunk of raw mail is held in memory at a time. */
 export declare const FETCH_CHUNK = 50;
 export declare const addressOf: ({ email, name }: Address) => EmailAddress;
 export type AttachmentLog = NonNullable<MailSyncResult["attachments"]>;
-/** A parsed email's attachments as the store keeps them, each with its text or why it has none. */
-export declare const readAttachments: (mail: ParsedMail, messageId: string, { loadEngine, maxAttachmentChars, at, signal, }: {
+/**
+ * A parsed email's attachments as the store keeps them, each with its text or why it has none. Without `policy` every
+ * attachment is read, whatever its size.
+ */
+export declare const readAttachments: (mail: ParsedMail, messageId: string, { loadEngine, maxAttachmentChars, at, signal, policy, }: {
     loadEngine: LoadEngine;
     maxAttachmentChars: number;
     at: number;
     signal?: AbortSignal;
+    policy?: MailAttachmentPolicy;
 }, log: AttachmentLog) => Promise<AttachmentInput[]>;

package/dist/mail/attachments.js

@@ -1,17 +1,33 @@
 import { extractText } from "../attachments/extract.js";
 export const MAX_ATTACHMENT_CHARS = 200_000;
+/** On, up to 10 MB a file: ordinary documents and scans are read, a large archive or video is not. */
+export const DEFAULT_ATTACHMENT_POLICY = { read: true, maxBytes: 10 * 1024 * 1024 };
+/** Why a policy left an attachment unread; `readEmailWhole` reads it anyway. */
+export const POLICY_SKIPS = ["not-read", "too-large"];
 /** One chunk of raw mail is held in memory at a time. */
 export const FETCH_CHUNK = 50;
 export const addressOf = ({ email, name }) => ({ address: email, name });
-/** A parsed email's attachments as the store keeps them, each with its text or why it has none. */
-export const readAttachments = async (mail, messageId, { loadEngine, maxAttachmentChars, at, signal, }, log) => {
+/**
+ * A parsed email's attachments as the store keeps them, each with its text or why it has none. Without `policy` every
+ * attachment is read, whatever its size.
+ */
+export const readAttachments = async (mail, messageId, { loadEngine, maxAttachmentChars, at, signal, policy, }, log) => {
     const files = [];
     for (const [position, part] of mail.attachments.entries()) {
         if (signal?.aborted)
             throw signal.reason;
+        const skipped = part.bytes === null || policy === undefined
+            ? undefined
+            : !policy.read
+                ? "not-read"
+                : part.bytes.byteLength > policy.maxBytes
+                    ? "too-large"
+                    : undefined;
         const extraction = part.bytes === null
             ? { status: "unavailable" }
-            : await extractText(part.bytes, { kind: "file", name: part.name, mime: part.mime, path: part.name }, loadEngine, signal);
+            : skipped
+                ? { status: skipped }
+                : await extractText(part.bytes, { kind: "file", name: part.name, mime: part.mime, path: part.name }, loadEngine, signal);
         log.push({ message: messageId, part: part.id, status: extraction.status });
         const extracted = extraction.status === "extracted" ? extraction : undefined;
         files.push({

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

@@ -3,7 +3,22 @@ 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";
+export { MAIL_REVIEW_QUERY, MAIL_REVIEW_STEPS, mailReviewSteps } from "./review.js";
+/**
+ * Where a host mounted `review`, `messages acknowledge` and `conversations show`, and the option that names one
+ * mailbox, so the steps a review hands on run there. A mail CLI leaves it out: its profile names the mailbox.
+ */
+export interface MailMount {
+    review?: string;
+    acknowledge?: string;
+    /** `null`: the host mounts no thread read, so a review offers none. */
+    conversation?: string | null;
+    /** In snake_case, as a step names it: memo's `source`, with `email:<account>`. */
+    mailbox?: {
+        option: string;
+        value: (mailbox: AccountKey) => string;
+    };
+}
 /** 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;
@@ -14,8 +29,14 @@ export interface MailReads {
     read: <T>(command: Command, work: (store: MessageStore, mailbox: AccountKey) => Promise<T>) => Promise<T>;
     /** The mailbox's server, for `search messages --backend`; without it the search reads the store only. */
     server?: (command: Command) => MailServerAccess;
+    mount?: MailMount;
     /** How `--server-time` help states its default when a provider's own differs (`MailServerAccess.timeMs`). */
     serverTimeDefault?: string;
+    /**
+     * Reads one stored email again from the mailbox's server, every attachment whatever its size (`readEmailWhole`).
+     * 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>;
 }
 export declare const THREAD_QUERY: {
     readonly entity: "mail_thread";

package/dist/mail/cli/index.js

@@ -5,7 +5,7 @@ import { Command, InvalidArgumentError } from "commander";
 import * as v from "valibot";
 import { answerEntity } from "../../cli/answer-entity.js";
 import { environmentOf, outputFor } from "../../cli/context.js";
-import { LOCAL_READ, REMOTE_READ } from "../../cli/effects.js";
+import { FETCH, LOCAL_READ, REMOTE_READ } from "../../cli/effects.js";
 import { itemOf, listOf, renderAnswer, snakeKeys } from "../../cli/envelope.js";
 import { listQuery, typedQuery, withQuery } from "../../cli/list-query.js";
 import { messagesAnswer, offsetOf, shownOf } from "../../cli/messenger/search-answers.js";
@@ -13,6 +13,7 @@ import { backendRequest, noteServer, serverSearchOptions } from "../../cli/messe
 import { positiveCount } from "../../cli/paging.js";
 import { formatReference, parseReference } from "../../domain/references.js";
 import { count, reference, text, time, untrusted } from "../../entities/fields.js";
+import { POLICY_SKIPS } from "../../mail/attachments.js";
 import { attachmentsText, hitText, searchMail, showMail, withAttachmentText } from "../../mail/read.js";
 import { searchMailServer } from "../../mail/server-search.js";
 import { atDetail } from "../../output-detail.js";
@@ -21,13 +22,21 @@ 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";
+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". */
 const absentAccount = (error) => {
     if (error instanceof CliError && error.code === "not_found")
         return undefined;
     throw error;
 };
+/** The shown email whose attachment a sync's policy left without text, if any. */
+const policySkipped = (emails) => {
+    const shown = emails.find((email) => email.anchor) ?? emails[0];
+    const skips = POLICY_SKIPS;
+    return shown?.attachments?.some((file) => skips.includes(String(file.extraction)))
+        ? shown
+        : undefined;
+};
 const DEFAULT_LIMIT = 20;
 const MAX_LIMIT = 100;
 const limitOf = (value) => {
@@ -203,7 +212,7 @@ const shownText = (emails) => `${emails.map((email) => [hitText(email, "full"),
 const messagesCommand = (mail) => {
     const messages = new Command("messages").summary("read stored emails").description("read the emails sync stored");
     annotate(messages.command("show"), {
-        effects: LOCAL_READ,
+        effects: mail.whole ? FETCH : LOCAL_READ,
         examples: [
             `${mail.app.command} personal messages show 'msg:email/me%40example.com/thread-1/%3Cid%40example.com%3E'`,
             `${mail.app.command} personal messages show 'msg:email/me%40example.com/thread-1/%3Cid%40example.com%3E' --before-n 2`,
@@ -218,15 +227,30 @@ const messagesCommand = (mail) => {
         .action(async function (reference) {
         const { beforeN, afterN } = this.opts();
         const full = detailOf(this) === "full";
+        let unread;
         const emails = await mail.read(this, async (store, mailbox) => {
             threadOf(mailbox, reference);
+            const shown = await showMail(store, reference, { before: beforeN, after: afterN, full });
+            const skipped = mail.whole ? policySkipped(shown) : undefined;
+            if (!skipped || !mail.whole)
+                return shown;
+            try {
+                await mail.whole(this, store, mailbox, skipped.id);
+            }
+            catch (error) {
+                if (!(error instanceof CliError))
+                    throw error;
+                // The stored email is still worth showing; the answer says its attachments were not read.
+                unread = { code: error.code, reason: "mail.attachments-unread", source: "server" };
+                return shown;
+            }
             return showMail(store, reference, { before: beforeN, after: afterN, full });
         });
         const output = outputFor(this);
         const shown = emails.map((email) => snakeKeys(atDetail(email)));
         renderAnswer(this, output, beforeN || afterN
             ? 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));
+            : itemOf(shown.find((_, at) => emails[at]?.anchor) ?? shown[0], unread ? { meta: { complete: false, issues: [unread] } } : undefined), () => shownText(emails));
     });
     messages.addCommand(acknowledgeCommand(mail));
     return messages;

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

@@ -1,8 +1,11 @@
+import { type StepDefinition } from "@wirecat/cli-base/standards";
 import { Command } from "commander";
-import type { MailReads } from "./index.js";
+import type { MailMount, 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. */
+/** The mail review's steps where a host mounted them; a host lists them beside its own so its step checks know them. */
+export declare const mailReviewSteps: (mount?: MailMount) => StepDefinition[];
+/** The steps of a mail CLI, whose profile names the mailbox. */
 export declare const MAIL_REVIEW_STEPS: ({
     id: string;
     kind: "command";