@wirecat/cli-core 0.396.0 → 0.398.0

package/dist/entities/index.d.ts

@@ -10,6 +10,7 @@ import { chatEvent } from "./chat-event.js";
 import { chatStats, taskStats } from "./chat-stats.js";
 import { contact } from "./contact.js";
 import { contactNote } from "./contact-note.js";
+import { contactLookup, contactProfile, contactSync } from "./contact-read.js";
 import { conversation } from "./conversation.js";
 import { counterRefresh, counters } from "./counters.js";
 import { document } from "./document.js";
@@ -47,7 +48,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, accountSession, adminReport, agenda, attachment, chart, chat, chatEvent, chatStats, contact, contactNote, conversation, counterRefresh, counters, document, evidence, fact, folder, hit, identity, inviteLink, job, joinRequest, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, message, messageCounts, messageLink, model, note, officialStats, person, pollVote, ranking, reference, relationship, retention, savedSearch, tagging, task, taskStats, topic, };
+export { account, accountSession, adminReport, agenda, attachment, chart, chat, chatEvent, chatStats, contact, contactLookup, contactNote, contactProfile, contactSync, conversation, counterRefresh, counters, document, evidence, fact, folder, hit, identity, inviteLink, job, joinRequest, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, message, messageCounts, messageLink, model, note, officialStats, person, pollVote, ranking, reference, relationship, retention, savedSearch, tagging, task, taskStats, topic, };
 export declare const ENTITIES: {
     readonly message: v.StrictObjectSchema<{
         readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
@@ -1726,6 +1727,124 @@ export declare const ENTITIES: {
         readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
         readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
     }, undefined>;
+    readonly contact_lookup: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly username: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly contact_profile: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly usernames: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        readonly bio: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly birthday: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly phone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly flags: Omit<v.StrictObjectSchema<{
+            readonly bot: v.BooleanSchema<undefined>;
+            readonly verified: v.BooleanSchema<undefined>;
+            readonly premium: v.BooleanSchema<undefined>;
+            readonly scam: v.BooleanSchema<undefined>;
+            readonly fake: v.BooleanSchema<undefined>;
+            readonly restricted: v.BooleanSchema<undefined>;
+            readonly deleted: v.BooleanSchema<undefined>;
+            readonly support: v.BooleanSchema<undefined>;
+        }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
+            readonly entries: {
+                readonly bot: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly verified: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly premium: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly scam: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly fake: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly restricted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly deleted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly support: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            };
+            readonly "~standard": v.StandardProps<{
+                bot?: boolean | undefined;
+                verified?: boolean | undefined;
+                premium?: boolean | undefined;
+                scam?: boolean | undefined;
+                fake?: boolean | undefined;
+                restricted?: boolean | undefined;
+                deleted?: boolean | undefined;
+                support?: boolean | undefined;
+            }, {
+                bot?: boolean | undefined;
+                verified?: boolean | undefined;
+                premium?: boolean | undefined;
+                scam?: boolean | undefined;
+                fake?: boolean | undefined;
+                restricted?: boolean | undefined;
+                deleted?: boolean | undefined;
+                support?: boolean | undefined;
+            }>;
+            readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+                bot?: boolean | undefined;
+                verified?: boolean | undefined;
+                premium?: boolean | undefined;
+                scam?: boolean | undefined;
+                fake?: boolean | undefined;
+                restricted?: boolean | undefined;
+                deleted?: boolean | undefined;
+                support?: boolean | undefined;
+            }, v.BooleanIssue | v.StrictObjectIssue>;
+            readonly "~types"?: {
+                readonly input: {
+                    bot?: boolean | undefined;
+                    verified?: boolean | undefined;
+                    premium?: boolean | undefined;
+                    scam?: boolean | undefined;
+                    fake?: boolean | undefined;
+                    restricted?: boolean | undefined;
+                    deleted?: boolean | undefined;
+                    support?: boolean | undefined;
+                };
+                readonly output: {
+                    bot?: boolean | undefined;
+                    verified?: boolean | undefined;
+                    premium?: boolean | undefined;
+                    scam?: boolean | undefined;
+                    fake?: boolean | undefined;
+                    restricted?: boolean | undefined;
+                    deleted?: boolean | undefined;
+                    support?: boolean | undefined;
+                };
+                readonly issue: v.BooleanIssue | v.StrictObjectIssue;
+            } | undefined;
+        };
+        readonly seen: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly contact: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly mutual_contact: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly common_chats_count: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+        readonly registered: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
+            readonly at: v.StringSchema<undefined>;
+            readonly source: v.PicklistSchema<["telegram", "max", "estimate"], undefined>;
+            readonly precision: v.PicklistSchema<["day", "month"], undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly has_photo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly chats: v.ArraySchema<v.StrictObjectSchema<{
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly kind: v.PicklistSchema<["dialog", "group", "channel", "saved", "unknown"], undefined>;
+            readonly their_messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly first_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 last_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 complete: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly aliases: v.ArraySchema<v.StrictObjectSchema<{
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly username: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly link: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly first_seen_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+            readonly last_seen_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+            readonly source: v.PicklistSchema<["profile", "messages"], undefined>;
+        }, undefined>, undefined>;
+    }, undefined>;
+    readonly contact_sync: v.StrictObjectSchema<{
+        readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly changed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly known: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, undefined>;
     readonly account: v.StrictObjectSchema<{
         readonly provider: v.StringSchema<undefined>;
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;

package/dist/entities/index.js

@@ -11,6 +11,7 @@ import { chatEvent } from "./chat-event.js";
 import { chatStats, taskStats } from "./chat-stats.js";
 import { contact } from "./contact.js";
 import { contactNote } from "./contact-note.js";
+import { contactLookup, contactProfile, contactSync } from "./contact-read.js";
 import { conversation } from "./conversation.js";
 import { counterRefresh, counters } from "./counters.js";
 import { document } from "./document.js";
@@ -50,7 +51,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, accountSession, adminReport, agenda, attachment, chart, chat, chatEvent, chatStats, contact, contactNote, conversation, counterRefresh, counters, document, evidence, fact, folder, hit, identity, inviteLink, job, joinRequest, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, message, messageCounts, messageLink, model, note, officialStats, person, pollVote, ranking, reference, relationship, retention, savedSearch, tagging, task, taskStats, topic, };
+export { account, accountSession, adminReport, agenda, attachment, chart, chat, chatEvent, chatStats, contact, contactLookup, contactNote, contactProfile, contactSync, conversation, counterRefresh, counters, document, evidence, fact, folder, hit, identity, inviteLink, job, joinRequest, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, message, messageCounts, messageLink, model, note, officialStats, person, pollVote, ranking, reference, relationship, retention, savedSearch, tagging, task, taskStats, topic, };
 export const ENTITIES = {
     message,
     "message.hit": v.pick(message, [
@@ -85,6 +86,9 @@ export const ENTITIES = {
     identity,
     contact,
     contact_note: contactNote,
+    contact_lookup: contactLookup,
+    contact_profile: contactProfile,
+    contact_sync: contactSync,
     account,
     account_session: accountSession,
     note,

package/dist/meetings/mcp/index.d.ts

@@ -38,6 +38,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -53,11 +54,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -75,11 +76,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -101,7 +102,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -188,6 +188,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -203,11 +204,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -225,11 +226,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -251,7 +252,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -338,6 +338,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -353,11 +354,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -375,11 +376,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -401,7 +402,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -488,6 +488,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -503,11 +504,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -525,11 +526,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -551,7 +552,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -638,6 +638,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -653,11 +654,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -675,11 +676,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -701,7 +702,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;

package/dist/parity/catalogue.js

@@ -16,7 +16,7 @@ export const renderCatalogue = (manifest) => {
         add(name, `every command${where(entry)}`);
     for (const [path, row] of Object.entries(manifest.commands))
         for (const [name, entry] of Object.entries(row.options ?? {}))
-            add(name, `\`${path}\`${where(entry)}`);
+            add(name, `\`${path}\`${where(entry)}${typeof entry !== "string" && entry.wording ? ` — ${cell(entry.wording)}` : ""}`);
     const rows = Object.entries(manifest.options).map(([name, option]) => {
         const meaning = option.note ? `${option.meaning}. **${option.note}**` : option.meaning;
         return `| \`${name}\` | ${option.value ? `\`${cell(option.value)}\`` : ""} | ${cell(meaning)} | ${option.default === undefined ? "" : `\`${cell(option.default)}\``} | ${(commands.get(name) ?? []).join(", ")} |`;

package/dist/parity/manifest.d.ts

@@ -11,7 +11,9 @@ export interface Presence {
     planned?: Record<Cli, string>;
 }
 /** An option: `"all"` alone, or where it is and why not elsewhere. */
-export type Entry = "all" | Presence;
+export type Entry = "all" | (Presence & {
+    wording?: string;
+});
 export interface CommandRow extends Presence {
     /** On a planned row: it stands for every path below it, which then have no rows of their own. */
     subtree?: boolean;

package/dist/parity/manifest.js

@@ -18,6 +18,8 @@ const entryProblems = (clis, where, entry) => {
     const names = entry.in === "all" ? [] : Array.isArray(entry.in) ? entry.in : undefined;
     if (names === undefined)
         return [`${where}: "in" is neither "all" nor a list of CLIs`];
+    if ("wording" in entry && (typeof entry.wording !== "string" || entry.wording.trim() === ""))
+        problems.push(`${where}: a wording exception needs its reason`);
     const planned = Object.entries(entry.planned ?? {});
     for (const name of [...names, ...planned.map(([name]) => name)])
         if (!clis.includes(name))

package/dist/parity/wording.js

@@ -49,6 +49,8 @@ export const wordingProblems = (manifest, programs) => {
         const sentences = clis.map((cli) => said.get(cli)?.get(where));
         if (sentences.every((sentence) => sentence === sentences[0]))
             return [];
+        if (typeof entry !== "string" && entry.wording && sentences.every((sentence) => sentence !== undefined))
+            return [];
         return [`${where}: ${clis.map((cli, index) => `${cli} says "${sentences[index]}"`).join(", ")}`];
     });
 };

package/dist/sends/permissions.js

@@ -271,6 +271,7 @@ const NAMED_WRITE_KEYS = [
     "stats.contacts.top.sync-first",
     "account.sessions.list",
     "attachments.extract",
+    "attachments.move",
     "attachments.text.set",
     "bot.callbacks.answer",
     "bot.chats.action",
@@ -388,6 +389,8 @@ export const readKeysForCommand = (path) => {
     const key = keyForCommand(path);
     if (!key)
         return [];
+    if (path[0] === "attachments" && path[1] === "download")
+        return [key, "messages", "chats"];
     if (path[0] === "attachments" && (path[1] === "extract" || path[1] === "show"))
         return [key, "messages"];
     if (path[0] === "store" && path[1] === "gaps" && path[2] === "repair")
@@ -430,6 +433,10 @@ export const keyForCommand = (path) => {
     // Picture models moved from `models image` (0.270.0); a model is housekeeping wherever it is listed.
     if (top === "images" && next === "models")
         return null;
+    if (top === "attachments" && (next === "check" || next === "jobs"))
+        return null;
+    if (top === "attachments" && next === "download")
+        return "messages";
     if (top === "store" && next !== undefined && STORE_MAINTENANCE.has(next))
         return null;
     // The agent's answers write only to the local store: their own key, so read-only messages can still link (phase 4 A10).

package/dist/services/deps.d.ts

@@ -70,7 +70,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` and `contacts list|show`";
+export declare const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context`, `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` and `contacts list|show`";
+export const OFFLINE = "--offline answers only from what is kept locally: `chats list|show`, `messages list|show|context`, `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/inbox.js

@@ -234,7 +234,7 @@ export const reviewIn = async (adapter, { since, points, chat, kinds, all = fals
 };
 export const inboxService = (deps) => {
     const reader = async () => {
-        if (deps.reads === "store")
+        if (deps.reads === "store" || deps.offline)
             return storeReader(deps, await deps.store(), await deps.account());
         const connection = await deps.connection();
         return {
@@ -256,9 +256,7 @@ export const inboxService = (deps) => {
                 : newIn(from, { since, limit, all, ...only, ...(points === undefined ? {} : { points }) });
         },
         review: async (options) => {
-            if (deps.offline && deps.reads !== "store") {
-                throw new CliError("validation_error", "`review` asks the messenger what changed; with `--offline` nothing did");
-            }
+            const synced = deps.offline && deps.reads !== "store";
             let tasks;
             const found = await reviewIn(await reader(), {
                 ...options,
@@ -272,7 +270,9 @@ export const inboxService = (deps) => {
                         });
                 },
             });
-            return tasks ? { ...found, tasks } : found;
+            // What was never synced may sit before `until`, so the next review must not start there.
+            const offline = synced ? { complete: false, offline: true } : {};
+            return { ...found, ...offline, ...(tasks ? { tasks } : {}) };
         },
     };
 };

package/dist/services/index.d.ts

@@ -2,6 +2,11 @@ import { type BotCheckService } from "../botcheck/service.js";
 export type { ContextEvidenceItem, ContextEvidencePage, ContextEvidenceReader, ContextEvidenceRequest, ContextIndex, ContextReadLimits, ContextReadUsage, ContextRecordReader, ContextSource, ScopedContextEvidenceReader, } from "./context-evidence.js";
 export { contextEvidenceFingerprint, createContextEvidenceReader } from "./context-evidence.js";
 export { excerpt } from "./excerpt.js";
+export type { MediaArchiveOptions, MediaArchivePorts } from "./media-archive.js";
+export { archiveMedia, checkMediaArchive } from "./media-archive.js";
+export type { MediaArchiveEntry, MediaIdentity } from "./media-archive-manifest.js";
+export type { MoveMediaArchiveOptions } from "./media-archive-move.js";
+export { moveMediaArchive } from "./media-archive-move.js";
 export { type DownloadedModel, downloadImageModel, downloadTextModel, type ModelDownloadOptions, } from "./model-downloads.js";
 export type { ProjectEvidenceContext, ProjectEvidenceItem, ProjectGathering, ProjectGatheringPorts, ProjectGatheringStop, ProjectIndexCatchUp, ProjectSourceFetcher, } from "./project-gathering.js";
 export { gatherProjectEvidence } from "./project-gathering.js";

package/dist/services/index.js

@@ -1,6 +1,8 @@
 import { botCheckService } from "../botcheck/service.js";
 export { contextEvidenceFingerprint, createContextEvidenceReader } from "./context-evidence.js";
 export { excerpt } from "./excerpt.js";
+export { archiveMedia, checkMediaArchive } from "./media-archive.js";
+export { moveMediaArchive } from "./media-archive-move.js";
 export { downloadImageModel, downloadTextModel, } from "./model-downloads.js";
 export { gatherProjectEvidence } from "./project-gathering.js";
 export { documentPassage, storedMessageNeighbours, storedNeighbours } from "./project-gathering-around.js";

package/dist/services/media-archive-files.d.ts

@@ -0,0 +1,10 @@
+import type { RemoteFile } from "../ports/messenger.js";
+import { type MediaArchiveEntry, type MediaIdentity } from "./media-archive-manifest.js";
+export declare const archiveMediaFile: (root: string, identity: MediaIdentity, kind: string, file: () => Promise<RemoteFile>, beforeWrite: () => Promise<void>, signal?: AbortSignal, metadata?: {
+    messageTime?: string;
+    mime?: string;
+    expected?: {
+        size: number;
+        sha256: string;
+    };
+}) => Promise<MediaArchiveEntry>;

package/dist/services/media-archive-files.js

@@ -0,0 +1,110 @@
+import { lstat } from "node:fs/promises";
+import { CliError } from "@wirecat/cli-base";
+import { NativeRecordingPartialStore, NativeRecordingPublication } from "../persistence/native/index.js";
+import { commitMediaEntry, mediaKey, missingMediaFile, parseMediaEntry, } from "./media-archive-manifest.js";
+const validator = '"media-completed-v1"';
+const maximumFileBytes = 64 * 1024 * 1024 * 1024;
+export const archiveMediaFile = async (root, identity, kind, file, beforeWrite, signal, metadata = {}) => {
+    const key = mediaKey(identity);
+    const locator = {
+        provider: identity.provider,
+        account: identity.account,
+        occurrenceId: mediaKey({ ...identity, position: 0 }),
+        assetId: key,
+    };
+    const storage = new NativeRecordingPartialStore(root, locator, {
+        prefix: ".media-partial-",
+        persistent: true,
+        maxBytes: maximumFileBytes,
+        signal,
+    });
+    const publication = new NativeRecordingPublication(root, locator, {
+        prefix: ".media-publication-",
+        filename: `${key}.bin`,
+        maxBytes: maximumFileBytes,
+        metadataLimit: 16384,
+        codec: {
+            encode: JSON.stringify,
+            decode: (value) => {
+                const one = parseMediaEntry(value);
+                if (mediaKey(one) !== key || one.kind !== kind)
+                    throw new CliError("validation_error", "media recovery identity mismatch");
+                if (metadata.expected && (one.size !== metadata.expected.size || one.sha256 !== metadata.expected.sha256))
+                    throw new CliError("validation_error", "media recovery checksum differs from the source");
+                if (metadata.expected && (one.messageTime !== metadata.messageTime || one.mime !== metadata.mime))
+                    throw new CliError("validation_error", "media recovery metadata differs from the source");
+                return one;
+            },
+        },
+        evidence: (one) => ({ size: one.size, sha256: one.sha256, validator }),
+        signal,
+    });
+    const commit = async (one) => {
+        await beforeWrite();
+        await commitMediaEntry(root, one, beforeWrite);
+    };
+    let exists = false;
+    try {
+        await lstat(publication.finalPath);
+        exists = true;
+    }
+    catch (error) {
+        if (!missingMediaFile(error))
+            throw error;
+    }
+    const intent = await publication.read();
+    if (exists) {
+        await beforeWrite();
+        return publication.recover(storage.path, () => storage.load(locator), commit);
+    }
+    if (intent) {
+        const partial = await storage.load(locator);
+        if (!partial ||
+            partial.offset !== intent.size ||
+            partial.sha256 !== intent.sha256 ||
+            partial.validator !== validator)
+            throw new CliError("validation_error", "completed media recovery evidence is missing; choose a new destination");
+        await beforeWrite();
+        await publication.publish(storage.path, intent, () => commit(intent));
+        return intent;
+    }
+    const remote = await file();
+    if (remote.size !== undefined &&
+        (!Number.isSafeInteger(remote.size) || remote.size < 0 || remote.size > maximumFileBytes))
+        throw new CliError("validation_error", "invalid media download size");
+    await beforeWrite();
+    // No range validators are exposed by messenger streams. A cut download restarts; only finish writes a checkpoint.
+    const writer = await storage.open(locator, { validator, total: remote.size ?? null });
+    let proof;
+    try {
+        let received = 0;
+        for await (const chunk of remote.bytes()) {
+            await beforeWrite();
+            await writer.write(chunk);
+            received += chunk.length;
+        }
+        if (remote.size !== undefined && received !== remote.size)
+            throw new CliError("invalid_response", "media download ended with a different size");
+        proof = await writer.finish();
+    }
+    finally {
+        await writer.close();
+    }
+    if (metadata.expected && (proof.size !== metadata.expected.size || proof.sha256 !== metadata.expected.sha256))
+        throw new CliError("validation_error", "media source changed while copying; nothing was published");
+    const mime = (metadata.mime ?? remote.mime)?.split(";", 1)[0]?.trim().toLowerCase();
+    const entry = parseMediaEntry({
+        ...identity,
+        version: 1,
+        kind,
+        path: `${key}.bin`,
+        ...proof,
+        ...(metadata.messageTime ? { messageTime: metadata.messageTime } : {}),
+        ...(mime && mime.length <= 127 && /^[a-z0-9.+-]+\/[a-z0-9.+-]+$/.test(mime) ? { mime } : {}),
+    });
+    await beforeWrite();
+    await publication.write(entry);
+    await beforeWrite();
+    await publication.publish(storage.path, entry, () => commit(entry));
+    return entry;
+};

package/dist/services/media-archive-locks.d.ts

@@ -0,0 +1,6 @@
+/** Acquire in canonical path order, then recheck the graph before trusting relocation records. */
+export declare const withMediaArchiveLocks: <T>(directory: string, signal: AbortSignal | undefined, run: (root: string, beforeWrite: () => Promise<void>) => Promise<T>, options?: {
+    create?: boolean;
+    additional?: readonly string[];
+    createAdditional?: boolean;
+}) => Promise<T>;