@wirecat/cli-core 0.530.0 → 0.532.0

package/dist/entities/index.js

@@ -8,7 +8,7 @@ import { accountSession } from "./account-session.js";
 import { adminReport } from "./admin-report.js";
 import { agenda } from "./agenda.js";
 import { analysisConsent, analysisConsentRevocation } from "./analysis-consent.js";
-import { attachment } from "./attachment.js";
+import { attachment, hitFile } from "./attachment.js";
 import { attachmentBytes, attachmentExtraction, attachmentTextChange } from "./attachment-results.js";
 import { chart } from "./chart.js";
 import { chat } from "./chat.js";
@@ -42,7 +42,7 @@ import { inviteLink } from "./invite-link.js";
 import { job } from "./job.js";
 import { joinRequest } from "./join-request.js";
 import { organization, project, reminder } from "./knowledge-lists.js";
-import { botAdmin, botMenuEntry, botProfile, botSeenChat, botTemplate, botWebhook, callRecord, scheduledJob, stickerInventory, } from "./list-results.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 { 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";
@@ -94,7 +94,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, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, 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, 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, taskCard, taskCategories, taskClosed, taskCreated, taskLinks, taskMerge, taskPair, taskScan, taskSimilar, taskStats, taskUnmerge, topic, topicIcon, trackedChat, trackedChatHistory, watchedMessage, watchItem, };
 export const ENTITIES = {
     sync_progress: syncProgress,
     ...MEETING_RESULT_ENTITIES,
@@ -120,6 +120,8 @@ export const ENTITIES = {
             "follow_ups",
             "email",
         ]).entries,
+        /** The files the message carries; absent when it has none. */
+        attachments: v.optional(v.array(hitFile)),
         untrusted,
     }),
     "message.summary": v.pick(message, [
@@ -183,6 +185,7 @@ export const ENTITIES = {
     bot_seen_chat: botSeenChat,
     bot_admin: botAdmin,
     bot_menu_entry: botMenuEntry,
+    topic_icon: topicIcon,
     bot_webhook: botWebhook,
     scheduled_job: scheduledJob,
     call_record: callRecord,

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

@@ -37,6 +37,9 @@ export declare const botMenuEntry: v.StrictObjectSchema<{
     readonly name: v.StringSchema<undefined>;
     readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
 }, undefined>;
+export declare const topicIcon: v.StrictObjectSchema<{
+    readonly emoji: v.StringSchema<undefined>;
+}, undefined>;
 export declare const botWebhook: v.StrictObjectSchema<{
     readonly url: v.StringSchema<undefined>;
     readonly types: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;

package/dist/entities/list-results.js

@@ -26,6 +26,7 @@ export const botAdmin = v.strictObject({
     title: v.nullable(text),
 });
 export const botMenuEntry = v.strictObject({ name: text, description: v.nullable(text) });
+export const topicIcon = v.strictObject({ emoji: text });
 export const botWebhook = v.strictObject({ url: text, types: v.optional(v.array(text)) });
 export const scheduledJob = v.strictObject({
     name: text,

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

@@ -6,4 +6,12 @@ export declare const messageLink: v.StrictObjectSchema<{
     readonly access: v.PicklistSchema<["public", "restricted", "unknown", "unavailable"], undefined>;
     /** Why there is no link. */
     readonly reason: v.NullableSchema<v.PicklistSchema<["unsupported_chat", "unsupported_provider", "offline"], undefined>, undefined>;
+    /** The message's files, each with its own link where the messenger gives one; absent when it has none. */
+    readonly files: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+        readonly position: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly kind: v.StringSchema<undefined>;
+        readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly reason: v.NullableSchema<v.PicklistSchema<["unsupported_provider"], undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
 }, undefined>;

package/dist/entities/message-link.js

@@ -1,5 +1,5 @@
 import * as v from "valibot";
-import { reference, text } from "./fields.js";
+import { count, reference, text } from "./fields.js";
 /** Where a message can be opened: its locator always, a provider link when there is one and who that link reaches. */
 export const messageLink = v.strictObject({
     ref: reference,
@@ -7,4 +7,12 @@ export const messageLink = v.strictObject({
     access: v.picklist(["public", "restricted", "unknown", "unavailable"]),
     /** Why there is no link. */
     reason: v.nullable(v.picklist(["unsupported_chat", "unsupported_provider", "offline"])),
+    /** The message's files, each with its own link where the messenger gives one; absent when it has none. */
+    files: v.optional(v.array(v.strictObject({
+        position: count,
+        kind: text,
+        name: v.optional(text),
+        url: v.nullable(text),
+        reason: v.nullable(v.picklist(["unsupported_provider"])),
+    }))),
 });

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

@@ -6,6 +6,12 @@ export declare const taskCard: v.StrictObjectSchema<{
     readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
     readonly project_key: v.StringSchema<undefined>;
     readonly project_name: v.StringSchema<undefined>;
+    readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+        readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly owner: v.BooleanSchema<undefined>;
+    }, undefined>, undefined>;
     readonly title: v.StringSchema<undefined>;
     readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -112,6 +118,12 @@ export declare const taskCreated: v.StrictObjectSchema<{
         readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly project_key: v.StringSchema<undefined>;
         readonly project_name: v.StringSchema<undefined>;
+        readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
         readonly title: v.StringSchema<undefined>;
         readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -219,6 +231,12 @@ export declare const taskLinks: v.UnionSchema<[v.StrictObjectSchema<{
     readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
     readonly project_key: v.StringSchema<undefined>;
     readonly project_name: v.StringSchema<undefined>;
+    readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+        readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly owner: v.BooleanSchema<undefined>;
+    }, undefined>, undefined>;
     readonly title: v.StringSchema<undefined>;
     readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -354,6 +372,12 @@ export declare const taskMerge: v.StrictObjectSchema<{
         readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly project_key: v.StringSchema<undefined>;
         readonly project_name: v.StringSchema<undefined>;
+        readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
         readonly title: v.StringSchema<undefined>;
         readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;
@@ -454,6 +478,12 @@ export declare const taskUnmerge: v.StrictObjectSchema<{
         readonly project: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly project_key: v.StringSchema<undefined>;
         readonly project_name: v.StringSchema<undefined>;
+        readonly created_by: v.NullableSchema<v.StrictObjectSchema<{
+            readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly owner: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
         readonly title: v.StringSchema<undefined>;
         readonly description: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly type: v.PicklistSchema<readonly ["bug", "feature", "chore", "question", "request", "mention", "promise"], undefined>;

package/dist/entities/task-results.js

@@ -27,6 +27,7 @@ export const taskCard = v.strictObject({
     project: reference,
     project_key: text,
     project_name: text,
+    created_by: v.nullable(v.strictObject({ type: v.picklist(["person", "bot"]), id, name: v.nullable(text), owner: v.boolean() })),
     title: text,
     description: v.nullable(text),
     type: v.picklist(TASK_TYPES),

package/dist/entities/task.d.ts

@@ -22,6 +22,13 @@ export declare const task: v.StrictObjectSchema<{
     /** The project's key and name, as `tasks counts` names it. */
     readonly project_key: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly project_name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** Who added it: the owner, or an agent by its bot name. */
+    readonly created_by: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
+        readonly type: v.PicklistSchema<["person", "bot"], undefined>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly owner: v.BooleanSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
     readonly account: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     /** The chat it came from, as a `chat:` reference. */
     readonly chat: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>, undefined>;

package/dist/entities/task.js

@@ -25,6 +25,8 @@ export const task = v.strictObject({
     /** The project's key and name, as `tasks counts` names it. */
     project_key: v.optional(v.nullable(text)),
     project_name: v.optional(v.nullable(text)),
+    /** Who added it: the owner, or an agent by its bot name. */
+    created_by: v.optional(v.nullable(v.strictObject({ type: v.picklist(["person", "bot"]), id, name: v.nullable(text), owner: v.boolean() }))),
     account: v.optional(text),
     /** The chat it came from, as a `chat:` reference. */
     chat: v.optional(v.nullable(reference)),

package/dist/errors/reasons.js

@@ -133,6 +133,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.duplicate-candidates", "open tasks may be the same job: attach to one, or add it as 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"],

package/dist/mail/account-key.d.ts

@@ -0,0 +1,2 @@
+import type { AccountKey } from "../store/index.js";
+export declare const mailAccountKey: (address: string) => AccountKey;

package/dist/mail/account-key.js

@@ -0,0 +1 @@
+export const mailAccountKey = (address) => ({ provider: "email", account: address.toLowerCase() });

package/dist/mail/cli/index.js

@@ -84,9 +84,9 @@ const searchCommand = (mail) => {
         partial: true,
         output: { entity: "message", view: "hit" },
         examples: [
-            `${mail.app.command} ya search messages invoice`,
-            `${mail.app.command} ya search messages 'from:ann@example.com has:attachment date>30d'`,
-            `${mail.app.command} ya search messages 'list:github.com is:unread' --newest`,
+            `${mail.app.command} personal search messages invoice`,
+            `${mail.app.command} personal search messages 'from:ann@example.com has:attachment date>30d'`,
+            `${mail.app.command} personal search messages 'list:github.com is:unread' --newest`,
         ],
     })
         .summary(mail.server ? "find emails by words and fields" : "find stored emails by words and fields")
@@ -103,7 +103,7 @@ const searchCommand = (mail) => {
         .option("--timezone <zone>", "the IANA timezone for calendar date boundaries")
         .addHelpText("after", `
 Fields: from: to: cc: bcc: subject: body: mailbox: (or label:) list: (a List-Id or its domain) is:unread|read|starred
-has:attachment, filename:, content: (the text of attachments), size>, date: — \`${mail.app.command} ya search messages 'content:invoice'\`.
+has:attachment, filename:, content: (the text of attachments), size>, date: — \`${mail.app.command} personal search messages 'content:invoice'\`.
 chat: names a thread by its subject. Mail sent to many is in the mailbox bulk; NOT mailbox:bulk leaves it out.
 Mail from senders with signs of fraud comes after the rest of the page; --plain-order keeps it in place.
 --json: the list is items; each hit's reference is ref (msg:email/…), which messages show reads.${mail.server
@@ -194,8 +194,8 @@ const messagesCommand = (mail) => {
     annotate(messages.command("show"), {
         effects: LOCAL_READ,
         examples: [
-            `${mail.app.command} ya messages show 'msg:email/me%40example.com/thread-1/%3Cid%40example.com%3E'`,
-            `${mail.app.command} ya messages show 'msg:email/me%40example.com/thread-1/%3Cid%40example.com%3E' --before-n 2`,
+            `${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`,
         ],
     })
         .summary("one stored email whole, with the text of its attachments")
@@ -243,8 +243,8 @@ const conversationsCommand = (mail) => {
     const list = withQuery(annotate(conversations.command("list"), {
         effects: LOCAL_READ,
         examples: [
-            `${mail.app.command} ya conversations list`,
-            `${mail.app.command} ya conversations list subject:invoice emails_count>1`,
+            `${mail.app.command} personal conversations list`,
+            `${mail.app.command} personal conversations list subject:invoice emails_count>1`,
         ],
     })
         .summary("stored email threads, newest first")
@@ -291,8 +291,8 @@ const conversationsCommand = (mail) => {
     annotate(conversations.command("show"), {
         effects: LOCAL_READ,
         examples: [
-            `${mail.app.command} ya conversations show 'chat:email/me%40example.com/thread-1'`,
-            `${mail.app.command} ya conversations show 'msg:email/me%40example.com/thread-1/%3Cid%40example.com%3E'`,
+            `${mail.app.command} personal conversations show 'chat:email/me%40example.com/thread-1'`,
+            `${mail.app.command} personal conversations show 'msg:email/me%40example.com/thread-1/%3Cid%40example.com%3E'`,
         ],
     })
         .summary("one email thread, every email oldest first")

package/dist/mail/index.d.ts

@@ -1,3 +1,4 @@
+export { mailAccountKey } from "./account-key.js";
 export { BULK, bulkBox } from "./bulk.js";
 export { factsOf } from "./facts.js";
 export { GMAIL_ALL_MAIL, mailFolders } from "./folders.js";

package/dist/mail/index.js

@@ -1,3 +1,4 @@
+export { mailAccountKey } from "./account-key.js";
 export { BULK, bulkBox } from "./bulk.js";
 export { factsOf } from "./facts.js";
 export { GMAIL_ALL_MAIL, mailFolders } from "./folders.js";

package/dist/mail/retry.js

@@ -1,4 +1,5 @@
 import { CliError } from "@wirecat/cli-base";
+import { mailAccountKey } from "./account-key.js";
 import { addressOf, FETCH_CHUNK, readAttachments } from "./attachments.js";
 import { mailFolders } from "./folders.js";
 import { mailHeadersOf } from "./headers.js";
@@ -12,7 +13,7 @@ export const RETRYABLE_ATTACHMENTS = ["engine-missing"];
  */
 export const retryUnread = async ({ store, source, account, since, max, maxBodyChars, maxAttachmentChars, now, loadEngine, index, }) => {
     const startedAt = now();
-    const key = { provider: "email", account: account.address.toLowerCase() };
+    const key = mailAccountKey(account.address);
     const find = source.find;
     if (find === undefined)
         throw new CliError("validation_error", "--retry-attachments reads mail again by its Gmail id; an mbox file or a plain IMAP account has none");

package/dist/mail/rule-stored.js

@@ -1,4 +1,5 @@
 import { CliError } from "@wirecat/cli-base";
+import { mailAccountKey } from "./account-key.js";
 import { PRESET_NAMES } from "./presets.js";
 const ACTION_OF = { full: "keep", envelope: "envelope", skip: "skip" };
 const KINDS = {
@@ -56,7 +57,7 @@ export const storedMailRule = (stored) => {
 export const storedMailRuleSet = async (store, account, query) => {
     let stored;
     try {
-        const { id } = await store.accounts.storedAccount({ provider: "email", account: account.address.toLowerCase() });
+        const { id } = await store.accounts.storedAccount(mailAccountKey(account.address));
         stored = await store.mail.rules.list(id, query);
     }
     catch (error) {

package/dist/mail/sender-scores.js

@@ -1,4 +1,5 @@
 import { CliError } from "@wirecat/cli-base";
+import { mailAccountKey } from "./account-key.js";
 import { domainsToAge, groupKey, probeMail } from "./probe.js";
 import { decide } from "./rules.js";
 import { FRAUD_SIGNALS, FREE_MAIL, registrableOf, WEIGHTS } from "./score.js";
@@ -18,7 +19,7 @@ const RECENT = 2 * 365 * DAY;
  * looked up first, for senders heard from in the last two years.
  */
 export const scoreSenders = async (store, address, ages, now = Date.now(), rules = []) => {
-    const key = { provider: "email", account: address.toLowerCase() };
+    const key = mailAccountKey(address);
     const last = (await store.sync.syncState(key, SCORED))?.value;
     const done = last === undefined ? undefined : JSON.parse(last);
     if (done !== undefined && done.version === SCORE_VERSION && now - done.at < DAY)

package/dist/mail/sync.js

@@ -2,6 +2,7 @@ import { setTimeout } from "node:timers/promises";
 import { CliError } from "@wirecat/cli-base";
 import { importEngine } from "../attachments/extract.js";
 import { isBusy } from "../store/sqlite/transaction.js";
+import { mailAccountKey } from "./account-key.js";
 import { FETCH_CHUNK, MAX_ATTACHMENT_CHARS, readAttachments } from "./attachments.js";
 import { BULK, bulkBox } from "./bulk.js";
 import { parsedEmail } from "./email-input.js";
@@ -108,7 +109,7 @@ export const syncMail = async (source, store, options) => {
         })),
     ];
     const complete = last.complete && plan.stopped === null && unreadable.length === 0 && remaining === 0;
-    const account = { provider: "email", account: options.account.address.toLowerCase() };
+    const account = mailAccountKey(options.account.address);
     const indexed = plan.stopped === null ? await index?.(store, account) : undefined;
     const deletionsSkipped = rounds.map((round) => round.deletionsSkipped).findLast((text) => text !== undefined);
     const { unreadable: _unreadable, ...rest } = last;
@@ -155,7 +156,7 @@ const syncRound = async (source, store, { account, since, max = 200, maxBodyChar
             index,
         });
     const startedAt = now();
-    const key = { provider: "email", account: account.address.toLowerCase() };
+    const key = mailAccountKey(account.address);
     const accountId = await store.accounts.saveAccount(key, { name: account.address });
     const folders = await mailFolders(account, source);
     if (folders.length < 1 || folders.length > 50)

package/dist/ports/messenger.d.ts

@@ -272,6 +272,7 @@ export interface ForumControl {
     enableForum(chatId: Id): Promise<ForumState>;
     createTopic(chatId: Id, title: string, options: {
         sendId: string;
+        icon?: string;
     }): Promise<Topic>;
 }
 export interface TopicEditing {
@@ -281,6 +282,8 @@ export interface TopicEditing {
     orderPinnedTopics(chatId: Id, topicIds: Id[]): Promise<void>;
     /** Deletes the topic and every message in it, for everyone; it cannot be undone. A topic that is gone is `not_found`. */
     deleteTopic?(chatId: Id, topicId: Id): Promise<void>;
+    /** The emojis any account may give a topic as its icon. */
+    topicIcons?(): Promise<string[]>;
 }
 export interface ThreadAddressing {
     validateThread(chatId: Id, threadId: Id, options: {

package/dist/services/attachments.d.ts

@@ -9,6 +9,7 @@ import { attachment as attachmentEntity } from "../entities/attachment.js";
 import { type TextOrigin } from "../store/store.js";
 import { batchProgress } from "./batch.js";
 import { type ServiceDeps } from "./deps.js";
+import { type Saved } from "./file-download.js";
 export type ExtractStatus = "extracted" | "needs-agent" | "unreadable" | "engine-missing" | "too-large" | "missing";
 /** One file looked at. Never its text: the text stays in the local store. */
 export interface ExtractItem {
@@ -114,6 +115,16 @@ export interface AttachmentsService {
         items: AttachmentItem[];
         has_more: boolean;
     }>;
+    /**
+     * Copies files the store already holds to `output`, never over a file there, and never asks the messenger: one
+     * not held locally is an error before anything is written. The store keeps pointing at its own copy.
+     */
+    saveHeld(target: {
+        chat: string;
+        message?: string;
+        attachment?: number;
+        output: string;
+    }): Promise<Saved[]>;
     /** Keeps text an agent read from a file — a scan, a photo — replacing whatever was there. Sends nothing. */
     setText(target: {
         chat: string;

package/dist/services/attachments.js

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
-import { constants } from "node:fs";
-import { open, readFile, stat } from "node:fs/promises";
+import { constants, mkdirSync } from "node:fs";
+import { lstat, open, readFile, stat } from "node:fs/promises";
 import { CliError } from "@wirecat/cli-base";
 import { queryFieldsOf, walkQuery } from "@wirecat/cli-base/query";
 import { directoryPaths } from "../attachments/directory.js";
@@ -18,6 +18,7 @@ import { refusedPlace } from "../sends/upload.js";
 import { attachmentColumns, queryFilter, } from "../store/store.js";
 import { batchProgress } from "./batch.js";
 import { accountStore } from "./deps.js";
+import { save } from "./file-download.js";
 import { chatIdIn } from "./message-resolution.js";
 export const ATTACHMENT_QUERY = {
     entity: "attachment",
@@ -407,6 +408,48 @@ export const attachmentsService = (deps) => ({
             ...preview,
         };
     },
+    saveHeld: async ({ chat, message, attachment, output }) => {
+        if (attachment !== undefined && (!Number.isSafeInteger(attachment) || attachment < 1))
+            throw new CliError("validation_error", "attachment must be a position from 1");
+        const store = await accountStore(deps);
+        const { account } = store;
+        const { chatId, messageId } = await messageOf(deps, store, chat, message);
+        const ref = formatLocator({ ...account, chat: chatId, message: messageId });
+        const files = (await store.attachments.attachments({ chatId, messageId, limit: 1000 })).filter(({ kind }) => !NOT_FILES.has(kind));
+        if (files.length === 0)
+            throw new CliError("not_found", `the local store holds no file of ${ref}`);
+        const chosen = attachment === undefined ? files : files.filter(({ position }) => position === attachment - 1);
+        if (chosen.length === 0)
+            throw new CliError("not_found", `${ref} has no file at position ${attachment}; its files are at ${files.map(({ position }) => position + 1).join(", ")}`);
+        const env = deps.env ?? process.env;
+        const held = await Promise.all(chosen.map(async (file) => {
+            const missing = new CliError("not_found", `file ${file.position + 1} of ${ref} is not saved on this computer; run messages download without --offline`);
+            if (file.localPath === null)
+                throw missing;
+            if (refusedPlace(file.localPath, deps.messenger.app, env))
+                throw new CliError("validation_error", "cannot copy known credential files, the WireCat apps' own files or the message store");
+            const found = await lstat(file.localPath).catch(() => undefined);
+            if (!found)
+                throw missing;
+            if (!found.isFile())
+                throw new CliError("validation_error", "the saved attachment must be a regular file");
+            return { file, path: file.localPath };
+        }));
+        mkdirSync(output, { recursive: true });
+        const saved = [];
+        for (const { file, path } of held)
+            saved.push(await save({
+                kind: file.kind,
+                ...(file.name === null ? {} : { name: file.name }),
+                ...(file.mime === null ? {} : { mime: file.mime }),
+                position: file.position,
+                bytes: async function* () {
+                    const handle = await open(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+                    yield* handle.createReadStream();
+                },
+            }, output, `${messageId}-${file.position + 1}`));
+        return saved;
+    },
     setText: async ({ chat, message, attachment, text }) => {
         if (text.trim() === "")
             throw new CliError("validation_error", "the text is empty — nothing to keep");

package/dist/services/deps.d.ts

@@ -72,7 +72,7 @@ export declare const fromStore: (deps: Pick<ServiceDeps, "offline" | "reads">) =
 export declare const nothingStored: (messenger: MessengerTraits) => string;
 /** Where a store-mode messenger's history comes from, for what it cannot do. */
 export declare const PUSHED = "this messenger's history is read from the local store";
-export declare const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context`, `contacts list|show` and `review`";
+export declare const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context|download`, `contacts list|show` and `review`";
 /** Over a connection that is already open — an MCP session holds one for minutes. */
 export declare const onlineDeps: (messenger: ServiceMessenger, adapter: MessengerAdapter, guard: SendGuard, where?: {
     profile?: string;

package/dist/services/deps.js

@@ -55,7 +55,7 @@ export const fromStore = (deps) => deps.offline || deps.reads === "store";
 export const nothingStored = (messenger) => `nothing stored for this chat yet — keep \`${typedCommand(messenger.app.command, "serve")}\` running`;
 /** Where a store-mode messenger's history comes from, for what it cannot do. */
 export const PUSHED = "this messenger's history is read from the local store";
-export const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context`, `contacts list|show` and `review`";
+export const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context|download`, `contacts list|show` and `review`";
 /** Over a connection that is already open — an MCP session holds one for minutes. */
 export const onlineDeps = (messenger, adapter, guard, where = {}) => ({
     messenger,

package/dist/services/messages.d.ts

@@ -197,7 +197,6 @@ export interface Reacted {
 }
 /** max-cli's: many at once is what a ban for automation looks like. */
 export declare const DELETE_AT_ONCE = 10;
-/** Every write goes through the guard: asked before it goes, told after, on every outcome. */
 export interface MessagesService {
     /** The account these messages are read as, which names each one's locator. */
     reader(): Promise<AccountKey>;
@@ -212,8 +211,8 @@ export interface MessagesService {
     }): Promise<Page<Message> & {
         discussion: Discussion;
     }>;
-    /** The files of one message. Always from the messenger, whatever its history is read from. */
-    download(chat: string, message: Id): Promise<Download>;
+    /** The files of one message, `chat` and its id or a `msg:` locator alone. Always from the messenger. */
+    download(chat: string, message?: Id): Promise<Download>;
     /**
      * Records in the local store where the files went, so their text can be read later. Only a
      * message the store holds; answers how many attachments it recorded.

package/dist/services/messages.js

@@ -1,7 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { validateFormattedText, visibleFormattedText } from "../domain/formatting.js";
 import { formatLocator } from "../domain/locator.js";
-import { messageLinkTarget, validatePermalink } from "../domain/message-link.js";
+import { fileLinks, messageLinkTarget, validatePermalink } from "../domain/message-link.js";
 import { pinDurationsText } from "../domain/pin-duration.js";
 import { threadIdOf } from "../domain/thread.js";
 import { capability } from "../ports/messenger.js";
@@ -22,6 +22,12 @@ import { searchServer, sourceKey, } from "./server-search.js";
 import { readThreadContext, threadBounds } from "./thread-context.js";
 /** max-cli's: many at once is what a ban for automation looks like. */
 export const DELETE_AT_ONCE = 10;
+/** Every write goes through the guard: asked before it goes, told after, on every outcome. */
+/** Only a message with files says what can be linked of them. */
+const filesOf = ({ attachments }) => {
+    const files = fileLinks(attachments);
+    return files.length > 0 ? { files } : {};
+};
 export const messagesService = (deps) => {
     const { guard } = deps;
     const inStore = async (read) => read(await deps.store(), await deps.account());
@@ -185,13 +191,15 @@ export const messagesService = (deps) => {
                 const store = await deps.store();
                 const chat = await readChatId(deps, target.chat, store, account);
                 const found = await store.messages.around(account, chat, target.message, { before: 0, after: 0 });
-                if (!found.some((item) => item.id === target.message && item.chatId === chat))
+                const held = found.find((item) => item.id === target.message && item.chatId === chat);
+                if (!held)
                     throw new CliError("not_found", "no such message in this account's stored chat");
                 return {
                     locator: formatLocator({ ...account, chat, message: target.message }),
                     url: null,
                     access: "unavailable",
                     reason: deps.offline ? "offline" : "unsupported_provider",
+                    ...filesOf(held),
                 };
             }
             const connection = await deps.connection();
@@ -199,20 +207,31 @@ export const messagesService = (deps) => {
                 throw new CliError("authentication_error", "the connected account differs from the recorded profile; refresh the session before linking");
             const { id: chat } = await connection.resolve(target.chat);
             const locator = formatLocator({ ...account, chat, message: target.message });
-            if (connection.permalink)
-                return { locator, ...validatePermalink(await connection.permalink(chat, target.message)) };
+            if (connection.permalink) {
+                const permalink = validatePermalink(await connection.permalink(chat, target.message));
+                const held = await deps
+                    .store()
+                    .then((store) => store.messages.around(account, chat, target.message, { before: 0, after: 0 }))
+                    .then((found) => found.find((item) => item.id === target.message && item.chatId === chat))
+                    .catch(() => undefined);
+                return { locator, ...permalink, ...(held ? filesOf(held) : {}) };
+            }
             const found = await capability(connection, "around", "read a message")(chat, target.message, {
                 before: 0,
                 after: 0,
             });
-            if (!found.some((item) => item.id === target.message && item.chatId === chat))
+            const held = found.find((item) => item.id === target.message && item.chatId === chat);
+            if (!held)
                 throw new CliError("not_found", "no such message in this chat");
-            return { locator, url: null, access: "unavailable", reason: "unsupported_provider" };
+            return { locator, url: null, access: "unavailable", reason: "unsupported_provider", ...filesOf(held) };
         },
-        download: async (chat, message) => {
+        download: async (reference, message) => {
+            const target = messageLinkTarget(reference, message, deps.messenger.provider);
+            if (target.account !== undefined && target.account !== (await deps.account()).account)
+                throw new CliError("validation_error", "that locator belongs to another account; select its profile first");
             const connection = await deps.connection();
             const download = capability(connection, "download", "download attachments");
-            return download((await connection.resolve(chat)).id, message);
+            return download((await connection.resolve(target.chat)).id, target.message);
         },
         keepDownloaded: (chat, message, files) => inStore(async (store, account) => {
             const chatId = (await storedChatId(deps.messenger, chat, store, account).catch(() => undefined)) ??

package/dist/services/search-all.d.ts

@@ -1,4 +1,5 @@
 import { type ErrorCode } from "@wirecat/cli-base";
+import { type HitFile } from "../domain/attachments.js";
 import { type MailFields } from "../domain/models.js";
 import type { MessengerTraits } from "../ports/traits.js";
 import type { AccountKey, MessageStore } from "../store/store.js";
@@ -30,6 +31,8 @@ export interface SearchAllItem {
     senderIsMe?: boolean;
     /** A mail's people, labels and thread, as `search mail` gives them. */
     email?: MailFields;
+    /** A message's or a mail's files, as `search messages` names them. */
+    attachments?: HitFile[];
     /** Which search found it: words, meaning or both. */
     foundBy: ("title" | "words" | "meaning")[];
 }