@wirecat/cli-core 0.562.0 → 0.563.0

package/dist/cli/shared-command-exports.d.ts

@@ -8,6 +8,8 @@ export declare const appDoctorCommand: (app: import("./entry.js").AppIdentity, c
         kind?: import("./settings.js").ProfileKind | undefined;
         root?: boolean;
     }) => unknown;
+    migrate: (path: string) => string[];
+    declaredSettings: import("./setting-defaults.js").DeclaredSetting[];
     allSettings: string[];
     defaultsOnlyKeys: string[];
     schema: import("valibot").StrictObjectSchema<{
@@ -188,6 +190,8 @@ export declare const appMcpCommand: (app: import("./entry.js").AppIdentity, conf
         kind?: import("./settings.js").ProfileKind | undefined;
         root?: boolean;
     }) => unknown;
+    migrate: (path: string) => string[];
+    declaredSettings: import("./setting-defaults.js").DeclaredSetting[];
     allSettings: string[];
     defaultsOnlyKeys: string[];
     schema: import("valibot").StrictObjectSchema<{
@@ -375,6 +379,8 @@ export declare const configCommand: (app: import("./entry.js").AppIdentity, conf
         kind?: import("./settings.js").ProfileKind | undefined;
         root?: boolean;
     }) => unknown;
+    migrate: (path: string) => string[];
+    declaredSettings: import("./setting-defaults.js").DeclaredSetting[];
     allSettings: string[];
     defaultsOnlyKeys: string[];
     schema: import("valibot").StrictObjectSchema<{
@@ -590,6 +596,8 @@ export declare const completeCommand: (messenger: import("./index.js").Messenger
         kind?: import("./settings.js").ProfileKind | undefined;
         root?: boolean;
     }) => unknown;
+    migrate: (path: string) => string[];
+    declaredSettings: import("./setting-defaults.js").DeclaredSetting[];
     allSettings: string[];
     defaultsOnlyKeys: string[];
     schema: import("valibot").StrictObjectSchema<{

package/dist/domain/admin-statistics.d.ts

@@ -75,4 +75,9 @@ export interface AdminCalculated {
     graph: ReturnType<typeof rankReplyGraph>["quality"];
 }
 export declare const adminEntityKey: (row: Pick<AdminRow, "account" | "id">) => string;
+/** Median and nearest-rank p90 of reply delays, the numbers every response-time answer reports. */
+export declare const delayStats: (delays: number[]) => {
+    medianMilliseconds: number | null;
+    p90Milliseconds: number | null;
+};
 export declare const calculateAdminStatistics: (nodes: AdminNode[], stays: AdminStay[], options: AdminOptions, inspect: () => void) => AdminCalculated;

package/dist/domain/admin-statistics.js

@@ -6,7 +6,8 @@ import { rankingQuestion } from "./rankings-options.js";
 export const adminEntityKey = (row) => JSON.stringify([row.account.provider, row.account.account, row.id]);
 const personKey = (node) => JSON.stringify([node.account.provider, node.account.account, node.sender]);
 const locator = (node) => formatLocator({ ...node.account, chat: node.chatId, message: node.id });
-const stats = (delays) => {
+/** Median and nearest-rank p90 of reply delays, the numbers every response-time answer reports. */
+export const delayStats = (delays) => {
     const sorted = delays.toSorted((a, b) => a - b);
     const middle = Math.floor(sorted.length / 2);
     return {
@@ -103,7 +104,7 @@ export const calculateAdminStatistics = (nodes, stays, options, inspect) => {
                 account: { provider: person.provider, account: person.account },
                 questions: eligible.filter((node) => node.account.provider === person.provider && node.account.account === person.account).length,
                 answered: rows.length,
-                ...stats(rows.map((row) => row.contribution)),
+                ...delayStats(rows.map((row) => row.contribution)),
                 status: "observed",
             }, rows);
         }
@@ -154,7 +155,7 @@ export const calculateAdminStatistics = (nodes, stays, options, inspect) => {
                 pending: end > options.cutoff,
                 questions: held.length,
                 answered: delays.length,
-                ...stats(delays),
+                ...delayStats(delays),
                 status: "partial",
             }, contributions);
         }

package/dist/entities/index.d.ts

@@ -71,6 +71,7 @@ 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";
@@ -88,7 +89,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, 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, 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 declare const ENTITIES: {
     readonly meeting_ingestion: v.StrictObjectSchema<{
         readonly meetings: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -10860,6 +10861,35 @@ export declare const ENTITIES: {
             readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         }, undefined>, undefined>;
     }, undefined>;
+    readonly response_times: 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>;
+        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>;
+    readonly waiting_chats: 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>;
     readonly ranking: v.StrictObjectSchema<{
         readonly target: v.PicklistSchema<["messages", "contacts"], undefined>;
         readonly measure: v.StringSchema<undefined>;

package/dist/entities/index.js

@@ -78,6 +78,7 @@ 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";
@@ -95,7 +96,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, 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, 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,
@@ -348,6 +349,8 @@ export const ENTITIES = {
     topic,
     folder,
     message_counts: messageCounts,
+    response_times: responseTimes,
+    waiting_chats: waitingChats,
     ranking,
     admin_report: adminReport,
     analysis_consent: analysisConsent,

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/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"],
@@ -218,8 +219,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 +300,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,6 +29,7 @@ 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;
 }

package/dist/mail/cli/index.js

@@ -21,7 +21,7 @@ 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")

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";

package/dist/mail/cli/review.js

@@ -29,31 +29,44 @@ export const MAIL_REVIEW_QUERY = defineQuery({
         nativeField({ name: "bulk", type: "kw", operators: ["term"], example: "bulk:false" }),
     ],
 });
-/** The mail review's steps; a host lists them beside its own so its step checks know them. */
-export const MAIL_REVIEW_STEPS = defineSteps([
-    {
-        id: "mail-messages.acknowledge",
-        command: "messages acknowledge",
-        args: [
-            { name: "holder", required: true },
-            { name: "cursor", required: true },
-        ],
-        why: "once these are processed, this moves the holder's mark past them",
-    },
-    {
-        id: "mail-review.next",
-        command: "review",
-        args: [{ name: "query", required: true }],
-        why: "the next review starts where this one ended",
-    },
-    {
-        id: "mail-conversations.show",
-        command: "conversations show",
-        args: [{ name: "conversation", required: true }],
-        why: "only the newest emails of the thread were read here; this reads it whole",
-    },
-]);
-const step = (id) => MAIL_REVIEW_STEPS.find((one) => one.id === id);
+/** The mail review's steps where a host mounted them; a host lists them beside its own so its step checks know them. */
+export const mailReviewSteps = (mount = {}) => {
+    const mailbox = mount.mailbox ? [{ name: mount.mailbox.option, required: true }] : [];
+    return defineSteps([
+        {
+            id: "mail-messages.acknowledge",
+            command: mount.acknowledge ?? "messages acknowledge",
+            args: [{ name: "holder", required: true }, { name: "cursor", required: true }, ...mailbox],
+            why: "once these are processed, this moves the holder's mark past them",
+        },
+        {
+            id: "mail-review.next",
+            command: mount.review ?? "review",
+            args: [{ name: "query", required: true }, ...mailbox],
+            why: "the next review starts where this one ended",
+        },
+        ...(mount.conversation === null
+            ? []
+            : [
+                {
+                    id: "mail-conversations.show",
+                    command: mount.conversation ?? "conversations show",
+                    args: [{ name: "conversation", required: true }, ...mailbox],
+                    why: "only the newest emails of the thread were read here; this reads it whole",
+                },
+            ]),
+    ]);
+};
+/** The steps of a mail CLI, whose profile names the mailbox. */
+export const MAIL_REVIEW_STEPS = mailReviewSteps();
+const stepsFor = (mount, mailbox) => {
+    const definitions = mailReviewSteps(mount);
+    const where = mount?.mailbox ? { [mount.mailbox.option]: mount.mailbox.value(mailbox) } : {};
+    return (id, args) => {
+        const definition = definitions.find((one) => one.id === id);
+        return definition ? [stepOf(definition, { args: { ...args, ...where } })] : [];
+    };
+};
 const waitingHours = (value) => value === true ? AGENDA_DEFAULTS.waiting / 3_600_000 : parseDuration(String(value), "--waiting") / 3_600_000;
 const quoted = (value) => `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
 /** A file name for the mailbox's points: they describe the mailbox, whichever profile reads it. */
@@ -67,20 +80,21 @@ const markText = (marks) => {
     const shown = said.filter(Boolean).join(" · ");
     return shown ? `\n  [${shown}]` : "";
 };
-const reviewAnswer = (found, mailbox, fresh) => {
+const reviewAnswer = (found, mailbox, fresh, step) => {
     const read = found.chats
         .flatMap((chat) => chat.messages.map((message) => ({ ...message, chatTitle: chat.title })))
         .sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
     const cut = found.chats.filter((chat) => chat.more);
     const ref = (thread) => formatReference({ type: "chat", ...mailbox, chat: thread });
     const turns = found.unanswered !== undefined || found.waiting !== undefined;
+    const wholeThreads = cut.flatMap((chat) => step("mail-conversations.show", { conversation: ref(chat.id) }));
     const missing = [
         ...(cut.length > 0
             ? [
                 {
                     field: "items",
                     why: `only the newest emails of ${cut.length} thread(s)`,
-                    step: "mail-conversations.show",
+                    ...(wholeThreads.length ? { step: "mail-conversations.show" } : {}),
                 },
             ]
             : []),
@@ -98,13 +112,9 @@ const reviewAnswer = (found, mailbox, fresh) => {
     ];
     const next = [
         ...(!fresh && !turns
-            ? [
-                stepOf(step("mail-review.next"), {
-                    args: { query: `date>${quoted(found.complete ? found.until : found.since)}` },
-                }),
-            ]
+            ? step("mail-review.next", { query: `date>${quoted(found.complete ? found.until : found.since)}` })
             : []),
-        ...cut.map((chat) => stepOf(step("mail-conversations.show"), { args: { conversation: ref(chat.id) } })),
+        ...wholeThreads,
     ];
     return listOf("review", {
         items: read.map((message) => ({
@@ -165,12 +175,10 @@ const holderReview = async (command, mail, holder, query) => {
         partial: false,
         quiet: 0,
     };
-    const answer = reviewAnswer(found, mailbox, true);
+    const step = stepsFor(mail.mount, mailbox);
+    const answer = reviewAnswer(found, mailbox, true, step);
     const skipped = Object.entries(read.skipped).filter(([, count]) => count > 0);
-    answer.next = [
-        stepOf(step("mail-messages.acknowledge"), { args: { holder, cursor: read.cursor } }),
-        ...(answer.next ?? []),
-    ];
+    answer.next = [...step("mail-messages.acknowledge", { holder, cursor: read.cursor }), ...(answer.next ?? [])];
     answer.missing = [
         ...(answer.missing ?? []),
         ...(read.held > 0 ? [{ field: "items", why: `${read.held} partial emails held until they are whole` }] : []),
@@ -254,7 +262,7 @@ an agent over MCP, and each scheduled run.`)
         return { found, mailbox, saved };
     });
     const output = outputFor(this);
-    const answer = reviewAnswer(found, mailbox, saved !== undefined);
+    const answer = reviewAnswer(found, mailbox, saved !== undefined, stepsFor(mail.mount, mailbox));
     if (meta)
         answer.meta = { ...meta, ...answer.meta };
     renderAnswer(this, output, answer, () => {

package/dist/mail/index.d.ts

@@ -1,4 +1,5 @@
 export { mailAccountKey } from "./account-key.js";
+export { DEFAULT_ATTACHMENT_POLICY, type MailAttachmentPolicy, POLICY_SKIPS } from "./attachments.js";
 export { BULK, bulkBox } from "./bulk.js";
 export { factsOf } from "./facts.js";
 export { MAIL_FINDINGS_KIND, MAIL_FINDINGS_PER_RUN, MAIL_FINDINGS_PER_SENDER, type MailFinding, type MailFindingsInput, mailFindingFingerprint, validateMailFindings, } from "./findings.js";
@@ -29,3 +30,4 @@ export type { Listed, MailSource, Quick, Searched } from "./source.js";
 export { SEARCH_REFUSED, searchRefused } from "./source.js";
 export { listedOf, type StoredMail } from "./stored.js";
 export { MAX_ATTACHMENT_CHARS, type MailAccount, type MailIndexed, type MailSyncOptions, type MailSyncResult, RETRYABLE_ATTACHMENTS, syncMail, } from "./sync.js";
+export { readEmailWhole, type WholeAttachment } from "./whole.js";

package/dist/mail/index.js

@@ -1,4 +1,5 @@
 export { mailAccountKey } from "./account-key.js";
+export { DEFAULT_ATTACHMENT_POLICY, POLICY_SKIPS } from "./attachments.js";
 export { BULK, bulkBox } from "./bulk.js";
 export { factsOf } from "./facts.js";
 export { MAIL_FINDINGS_KIND, MAIL_FINDINGS_PER_RUN, MAIL_FINDINGS_PER_SENDER, mailFindingFingerprint, validateMailFindings, } from "./findings.js";
@@ -28,3 +29,4 @@ export { searchMailServer } from "./server-search.js";
 export { SEARCH_REFUSED, searchRefused } from "./source.js";
 export { listedOf } from "./stored.js";
 export { MAX_ATTACHMENT_CHARS, RETRYABLE_ATTACHMENTS, syncMail, } from "./sync.js";
+export { readEmailWhole } from "./whole.js";

package/dist/mail/partial.d.ts

@@ -1,6 +1,7 @@
 import type { BudgetStop } from "../background/budget.js";
 import type { LoadEngine } from "../readers/types.js";
 import type { MessageStore } from "../store/index.js";
+import { type MailAttachmentPolicy } from "./attachments.js";
 import type { MailSource } from "./source.js";
 /** The `emails.metadata` key of an email stored from its first bytes: `{ bytes }` read of its `size`. */
 export declare const PARTIAL = "partial";
@@ -23,7 +24,7 @@ export interface PartialOutcome {
  * `identify` gives the stored id for the bytes read there. Each failed read is counted, and after `PARTIAL_TRIES`, or
  * at once when the place holds another message, the email is left partial for good.
  */
-export declare const completePartial: ({ store, source, accountId, address, folders, maxBodyChars, maxAttachmentChars, loadEngine, now, take, signal, }: {
+export declare const completePartial: ({ store, source, accountId, address, folders, maxBodyChars, maxAttachmentChars, policy, loadEngine, now, take, signal, }: {
     store: MessageStore;
     source: MailSource;
     accountId: number;
@@ -32,6 +33,7 @@ export declare const completePartial: ({ store, source, accountId, address, fold
     folders: () => Promise<readonly string[]>;
     maxBodyChars: number;
     maxAttachmentChars: number;
+    policy?: MailAttachmentPolicy;
     loadEngine: LoadEngine;
     now: number;
     /** A budgeted run's next request, or why there is none. */

package/dist/mail/partial.js

@@ -15,7 +15,7 @@ export const PARTIAL_TRIES = 3;
  * `identify` gives the stored id for the bytes read there. Each failed read is counted, and after `PARTIAL_TRIES`, or
  * at once when the place holds another message, the email is left partial for good.
  */
-export const completePartial = async ({ store, source, accountId, address, folders, maxBodyChars, maxAttachmentChars, loadEngine, now, take, signal, }) => {
+export const completePartial = async ({ store, source, accountId, address, folders, maxBodyChars, maxAttachmentChars, policy, loadEngine, now, take, signal, }) => {
     const { emails, total, stuck } = await store.mail.partialEmails(accountId, PARTIAL_PER_RUN);
     if (emails.length === 0)
         return { completed: 0, left: 0, stuck };
@@ -89,7 +89,7 @@ export const completePartial = async ({ store, source, accountId, address, folde
             }
             try {
                 const mail = await parseMail(raw, maxBodyChars);
-                const files = await readAttachments(mail, email.externalId, { loadEngine, maxAttachmentChars, at: now, ...(signal ? { signal } : {}) }, attachments);
+                const files = await readAttachments(mail, email.externalId, { loadEngine, maxAttachmentChars, at: now, ...(policy ? { policy } : {}), ...(signal ? { signal } : {}) }, attachments);
                 const { [PARTIAL]: _partial, ...metadata } = email.metadata ?? {};
                 const whole = { ...item, messageId: email.externalId, threadId: email.threadExternalId };
                 await store.mail.saveThread({