@wirecat/cli-core 0.381.0 → 0.383.0

package/dist/documents/push-model.d.ts

@@ -0,0 +1,89 @@
+/** A local file a push mirrors: its path relative to the mirrored folder, with `/` separators. */
+export interface LocalDocument {
+    path: string;
+    absolute: string;
+    hash: string;
+    kind: string;
+}
+export interface Pushed<S> {
+    id: string;
+    url: string;
+    /** What the provider reads back after its own write; the next push compares the remote against it. */
+    snapshot: S;
+}
+/**
+ * What an update found before writing. Only `write` reaches the remote, so a conflict or a file with nothing to
+ * change never counts as a write.
+ */
+export type Prepared<S> = {
+    conflict: string;
+} | {
+    missing: true;
+} | {
+    unchanged: Pushed<S>;
+} | {
+    write(): Promise<Pushed<S>>;
+};
+/**
+ * A provider that writes local files as its own native documents. Every write is one provider call per
+ * file (or one all-or-nothing batch): a write cut in half would read back as somebody else's edit.
+ */
+export interface DocumentTarget<S> {
+    identity(): Promise<string>;
+    /** The provider's document kind for a local path, or undefined when the path is not pushed. */
+    kindOf(path: string): string | undefined;
+    /** Finds the folder carrying `origin` or creates it: a crash between create and save must not duplicate it. */
+    ensureFolder(input: {
+        parent: string;
+        name: string;
+        origin: string;
+    }): Promise<string>;
+    findByOrigin(origin: string): Promise<Pushed<S> | undefined>;
+    create(input: {
+        file: LocalDocument;
+        name: string;
+        parent: string;
+        origin: string;
+        operationId: string;
+        signal?: AbortSignal;
+    }): Promise<Pushed<S>>;
+    /** Reads the remote and compares it with `recorded`; a conflict instead of a write unless `force`. */
+    prepare(input: {
+        id: string;
+        file: LocalDocument;
+        recorded: S;
+        force: boolean;
+        signal?: AbortSignal;
+    }): Promise<Prepared<S>>;
+}
+export interface PushEntry<S> {
+    id: string;
+    url: string;
+    kind: string;
+    hash: string;
+    snapshot: S;
+    pushedAt: string;
+}
+export interface PushState<S> {
+    version: 1;
+    principal: string;
+    root: string;
+    target: string;
+    folders: Record<string, string>;
+    entries: Record<string, PushEntry<S>>;
+    /** Saved before a create, so a crash after the provider wrote but before this state was saved finds the file. */
+    pending: Record<string, {
+        origin: string;
+        operationId: string;
+    }>;
+}
+export interface PushStatePort<S> {
+    read(): PushState<S>;
+    save(state: PushState<S>): void;
+}
+export interface PushPlan {
+    create: LocalDocument[];
+    update: LocalDocument[];
+    unchanged: LocalDocument[];
+    orphans: string[];
+}

package/dist/documents/push-model.js

@@ -0,0 +1 @@
+export {};

package/dist/documents.d.ts

@@ -1,3 +1,4 @@
+export { readSpreadsheet } from "./attachments/documents.js";
 export type { Engine, Extraction, FileHint, LoadEngine } from "./attachments/extract.js";
 export { extractText, importEngine, MAX_FILE_BYTES, MAX_TEXT_CHARS } from "./attachments/extract.js";
 export { attachmentMaxBytes } from "./attachments/limits.js";

package/dist/documents.js

@@ -1,3 +1,4 @@
+export { readSpreadsheet } from "./attachments/documents.js";
 export { extractText, importEngine, MAX_FILE_BYTES, MAX_TEXT_CHARS } from "./attachments/extract.js";
 export { attachmentMaxBytes } from "./attachments/limits.js";
 export { columnName, sheetText } from "./attachments/sheets.js";

package/dist/domain/models.d.ts

@@ -33,9 +33,16 @@ export interface Chat {
     /** ISO 8601, or `null` when the chat has never had a message. */
     lastMessageAt: string | null;
     participantsCount: number | null;
-    /** Absent where the messenger does not say. */
+    /** Absent where the messenger does not say. A mute that has ended reads as `false`. */
     muted?: boolean;
+    /**
+     * ISO 8601 UTC: when the mute ends. `null` or absent with `muted` is for good. Saving a chat: absent keeps the stored
+     * end, and `muted: false` clears it.
+     */
+    mutedUntil?: string | null;
     archived?: boolean;
+    /** The owner marked the chat unread, whatever its count; absent where the messenger does not say. */
+    markedUnread?: boolean;
     /** Unread messages that mention the owner or reply to them. */
     unreadMentions?: number;
     /** Absent where the messenger does not say. */
@@ -50,7 +57,8 @@ export interface Chat {
  * A chat as an adapter saves it. A `title`, `unreadCount`, `lastMessageAt`, `participantsCount` or `membershipState`
  * left out keeps the stored value; `null` stores none. So a push that knows only some of them, such as a notice that
  * a group left its community, leaves the rest out. `membershipState: "member"` says the owner is in the chat again: it
- * takes off a "left" mark and keeps any other state, such as "archived". It is never stored.
+ * takes off a "left" mark and keeps any other state, such as "archived". It is never stored. `muted`, `mutedUntil`,
+ * `archived` and `markedUnread` left out keep the stored value too.
  */
 export type ChatUpdate = Omit<Chat, KeptFields | "membershipState"> & Partial<Pick<Chat, KeptFields>> & {
     membershipState?: MembershipState | "member" | null;
@@ -332,7 +340,15 @@ export interface Message {
      * keeps what the store holds: a fetch, an edit or another messenger's message says nothing about it.
      */
     starred?: boolean;
+    /**
+     * How far the owner's own message got in a one-to-one chat, from the messenger's receipts: `read` once the other
+     * person opened it. Absent when no receipt came. On a save, absent keeps what the store holds, and a state never
+     * moves back: a late `delivered` after `read` changes nothing.
+     */
+    delivery?: Delivery;
 }
+/** `delivered` reached the other person's phone; `read` they opened it (a voice note or view-once file played counts). */
+export type Delivery = "delivered" | "read";
 /**
  * A message found by searching, carrying the chat's name as well as its id: a search spans every
  * chat, so an answer that named only the id would make the reader look each one up.
@@ -413,6 +429,16 @@ export interface MessageStarEvent {
     messageId: Id;
     starred: boolean;
 }
+/** A receipt for the owner's own message in a one-to-one chat; saved, it never moves the stored state back. */
+export interface MessageDeliveryEvent {
+    event: "delivery";
+    chatId: Id;
+    chatTitle: string | null;
+    messageId: Id;
+    delivery: Delivery;
+    /** ISO 8601 — when the receipt says it happened. */
+    at: string;
+}
 /** Who joined, left, was added, removed, promoted or demoted, or a new title, as it happens; saved for `chats events`. */
 export interface ChatEventNotice {
     event: "chat_event";
@@ -420,13 +446,14 @@ export interface ChatEventNotice {
     chatTitle: string | null;
     change: ChatEvent;
 }
-/** What a listening connection reports: a new message, a change to one, a vote, a reaction, a star, or a change to a chat. */
+/** What a listening connection reports: a message, a change to one, a vote, a reaction, a star, a receipt, a chat change. */
 export type MessageEvent = {
     event: "message";
     message: MessageHit;
-} | MessageChange | PollVoteEvent | PersonReactionEvent | MessageStarEvent | ChatEventNotice;
+} | MessageChange | PollVoteEvent | PersonReactionEvent | MessageStarEvent | MessageDeliveryEvent | ChatEventNotice;
 /** One chat's share of `inbox`: other people's messages since the last check, oldest first. */
 export interface InboxChat extends Pick<Chat, "id" | "title" | "kind" | "unreadCount"> {
+    /** A chat marked unread with nothing counted: its newest message from someone else. */
     messages: Message[];
     /** There are more than `--limit`; these are the newest of them. */
     more: boolean;

package/dist/entities/chat.d.ts

@@ -11,7 +11,11 @@ export declare const chat: v.StrictObjectSchema<{
     readonly last_message_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** When the mute ends; absent with `muted` true is for good. */
+    readonly muted_until: v.OptionalSchema<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 archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** The owner marked it unread, whatever `unread_count` says. */
+    readonly marked_unread: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     readonly membership_state: v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>;
     readonly parent_chat_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
     readonly scope: v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>;

package/dist/entities/chat.js

@@ -14,7 +14,11 @@ export const chat = v.strictObject({
     last_message_at: v.nullable(time),
     participants_count: v.nullable(count),
     muted: v.optional(v.boolean()),
+    /** When the mute ends; absent with `muted` true is for good. */
+    muted_until: v.optional(time),
     archived: v.optional(v.boolean()),
+    /** The owner marked it unread, whatever `unread_count` says. */
+    marked_unread: v.optional(v.boolean()),
     membership_state: v.optional(v.picklist(["joined", "left", "public", "imported", "archived", "external"])),
     parent_chat_id: v.optional(id),
     scope: v.optional(v.picklist(["personal", "work"])),

package/dist/entities/contact.d.ts

@@ -24,7 +24,9 @@ export declare const contact: v.StrictObjectSchema<{
         readonly last_message_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
         readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly muted_until: v.OptionalSchema<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 archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly marked_unread: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         readonly membership_state: v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>;
         readonly parent_chat_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
         readonly scope: v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>;
@@ -72,7 +74,9 @@ export declare const contact: v.StrictObjectSchema<{
             readonly last_message_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
             readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly muted_until: v.OptionalSchema<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 archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly marked_unread: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
             readonly membership_state: v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>;
             readonly parent_chat_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
             readonly scope: v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>;

package/dist/entities/evidence.d.ts

@@ -142,6 +142,7 @@ export declare const contribution: v.StrictObjectSchema<{
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -322,6 +323,7 @@ export declare const contribution: v.StrictObjectSchema<{
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -540,6 +542,7 @@ export declare const contribution: v.StrictObjectSchema<{
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -720,6 +723,7 @@ export declare const contribution: v.StrictObjectSchema<{
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -974,6 +978,7 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -1154,6 +1159,7 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -1372,6 +1378,7 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -1552,6 +1559,7 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{

package/dist/entities/index.d.ts

@@ -190,6 +190,7 @@ export declare const ENTITIES: {
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -370,6 +371,7 @@ export declare const ENTITIES: {
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -550,6 +552,7 @@ export declare const ENTITIES: {
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -1028,6 +1031,7 @@ export declare const ENTITIES: {
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -1208,6 +1212,7 @@ export declare const ENTITIES: {
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -1448,7 +1453,9 @@ export declare const ENTITIES: {
         readonly last_message_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
         readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly muted_until: v.OptionalSchema<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 archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly marked_unread: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         readonly membership_state: v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>;
         readonly parent_chat_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
         readonly scope: v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>;
@@ -1527,7 +1534,9 @@ export declare const ENTITIES: {
             readonly last_message_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
             readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly muted_until: v.OptionalSchema<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 archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly marked_unread: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
             readonly membership_state: v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>;
             readonly parent_chat_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
             readonly scope: v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>;
@@ -1575,7 +1584,9 @@ export declare const ENTITIES: {
                 readonly last_message_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
                 readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
                 readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly muted_until: v.OptionalSchema<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 archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly marked_unread: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
                 readonly membership_state: v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>;
                 readonly parent_chat_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
                 readonly scope: v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>;
@@ -2032,6 +2043,7 @@ export declare const ENTITIES: {
         readonly duration_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
         readonly timezone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+        readonly issues: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<readonly ["time_without_zone"], undefined>, undefined>, undefined>;
         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>;
@@ -2049,6 +2061,7 @@ export declare const ENTITIES: {
         readonly duration_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
         readonly timezone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+        readonly issues: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<readonly ["time_without_zone"], undefined>, undefined>, undefined>;
         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`">]>;
         readonly event_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
@@ -3372,6 +3385,7 @@ export declare const ENTITIES: {
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -3552,6 +3566,7 @@ export declare const ENTITIES: {
                 }, undefined>, undefined>, undefined>;
                 readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+                readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
                 readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                     readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                     readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -3770,6 +3785,7 @@ export declare const ENTITIES: {
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -3950,6 +3966,7 @@ export declare const ENTITIES: {
                 }, undefined>, undefined>, undefined>;
                 readonly scheduled_for: v.OptionalSchema<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 starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+                readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
                 readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                     readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                     readonly from: v.NullableSchema<v.StrictObjectSchema<{

package/dist/entities/message.d.ts

@@ -151,6 +151,8 @@ export declare const message: v.StrictObjectSchema<{
     readonly scheduled_for: v.OptionalSchema<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>;
     /** The owner starred it; only where the messenger has stars, and only when set. */
     readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+    /** The owner's own message in a one-to-one chat: `delivered`, or `read` once opened; absent when no receipt came. */
+    readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
     readonly email: v.OptionalSchema<v.StrictObjectSchema<{
         readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly from: v.NullableSchema<v.StrictObjectSchema<{

package/dist/entities/message.js

@@ -64,6 +64,8 @@ export const message = v.strictObject({
     scheduled_for: v.optional(time),
     /** The owner starred it; only where the messenger has stars, and only when set. */
     starred: v.optional(v.literal(true)),
+    /** The owner's own message in a one-to-one chat: `delivered`, or `read` once opened; absent when no receipt came. */
+    delivery: v.optional(v.picklist(["delivered", "read"])),
     email: v.optional(v.strictObject({
         subject: v.nullable(text),
         from: v.nullable(mailPerson),

package/dist/errors/reasons.js

@@ -26,6 +26,9 @@ const OTHERS = [
     validation("extraction.text-too-long", "the text is too long for memory extraction"),
     validation("file.locked", "another process holds the file's lock"),
     ["profile.wrong-account", "authentication_error", "the signed-in source account does not match this profile"],
+    validation("push.too-many-files", "the folder holds more files than one push takes"),
+    validation("push.unreadable", "the folder to push could not be read"),
+    validation("spreadsheet.unreadable", "the workbook could not be read"),
     validation("store.refused", "the local store refused the document text"),
     ["store.not-writable", "permission_error", "the message store cannot be written from this process"],
     validation("catalog.scope-limit", "the selected catalog exceeds its entry limit"),

package/dist/meetings/answers.d.ts

@@ -77,6 +77,7 @@ export declare const meetingDetails: v.StrictObjectSchema<{
     readonly duration_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly timezone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    readonly issues: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<readonly ["time_without_zone"], undefined>, undefined>, undefined>;
     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`">]>;
     /** The stored event and series it belongs to, as `meetings_list` takes them. */

package/dist/meetings/index.d.ts

@@ -8,7 +8,7 @@ export { type FindingEvidence, type FindingOutcome, findingHash, MEETING_FINDING
 export { type Finding, type FindingsInput, type FindingsReceipt, type FindingsRules, findingFingerprint, validateFindings, } from "./findings-rules.js";
 export { MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQuery } from "./hit-query.js";
 export { type ImportFile, importFiles } from "./import.js";
-export { MEETING_QUERY, type MeetingItem, type MeetingOwner, meeting, meetingItem } from "./item.js";
+export { MEETING_ISSUES, MEETING_QUERY, type MeetingIssue, type MeetingItem, type MeetingOwner, meeting, meetingIssuesOf, meetingItem, } from "./item.js";
 export { createMeetingContext, MEETING_FACT_TYPES, type MeetingContextAction, type MeetingContextChange, type MeetingContextOperation, type MeetingContextPorts, type MeetingContextReceipt, validateMeetingContextChange, } from "./meeting-context.js";
 export { createMeetingManagement, dispatchMeetingMutation, type ManagedMeeting, type ManagedMeetingChange, type MeetingManagement, type MeetingManagementPorts, type MeetingMutationOptions, type MeetingMutationProposal, type MeetingMutationReceipt, type MeetingOperationOptions, type MeetingProviderContext, validateMeetingChange, } from "./meeting-management.js";
 export type { Attachment, ChatLine, Event, EventSeries, JsonValue, Meeting, MeetingSeries, Metadata, Occurrence, Participant, RecordTimes, SourceChatLine, SourceMeeting, Summary, SummaryContent, Transcript, TranscriptLine, TranscriptRow, } from "./model.js";

package/dist/meetings/index.js

@@ -6,7 +6,7 @@ export { findingHash, MEETING_FINDINGS_KIND, meetingFindingFingerprint, validate
 export { findingFingerprint, validateFindings, } from "./findings-rules.js";
 export { MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQuery } from "./hit-query.js";
 export { importFiles } from "./import.js";
-export { MEETING_QUERY, meeting, meetingItem } from "./item.js";
+export { MEETING_ISSUES, MEETING_QUERY, meeting, meetingIssuesOf, meetingItem, } from "./item.js";
 export { createMeetingContext, MEETING_FACT_TYPES, validateMeetingContextChange, } from "./meeting-context.js";
 export { createMeetingManagement, dispatchMeetingMutation, validateMeetingChange, } from "./meeting-management.js";
 export { normalizeMeetingParticipantQuery, validateMeetingParticipantSearch, } from "./participant-search.js";

package/dist/meetings/item.d.ts

@@ -1,5 +1,13 @@
 import * as v from "valibot";
 import type { Meeting } from "./model.js";
+/**
+ * Why a stored meeting's facts may be off, kept so the data stays but a reader knows to doubt it.
+ * `time_without_zone`: the provider sent a time with no zone, and it was read in the computer's zone.
+ */
+export declare const MEETING_ISSUES: readonly ["time_without_zone"];
+export type MeetingIssue = (typeof MEETING_ISSUES)[number];
+/** The issues a provider adapter put in `metadata.issues`, the known ones only, in their listed order. */
+export declare const meetingIssuesOf: (metadata: Meeting["metadata"]) => MeetingIssue[];
 /** A stored meeting as every command and tool answers it; `src/entities/` registers it as `meeting`. */
 export declare const meeting: v.StrictObjectSchema<{
     readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
@@ -16,6 +24,8 @@ export declare const meeting: v.StrictObjectSchema<{
     readonly duration_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly timezone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    /** Present only when something about this meeting is doubtful. */
+    readonly issues: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<readonly ["time_without_zone"], undefined>, undefined>, undefined>;
     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>;

package/dist/meetings/item.js

@@ -4,6 +4,16 @@ import * as v from "valibot";
 import { formatMeetingReference } from "./reference.js";
 const text = v.string();
 const count = v.pipe(v.number(), v.integer(), v.minValue(0));
+/**
+ * Why a stored meeting's facts may be off, kept so the data stays but a reader knows to doubt it.
+ * `time_without_zone`: the provider sent a time with no zone, and it was read in the computer's zone.
+ */
+export const MEETING_ISSUES = ["time_without_zone"];
+/** The issues a provider adapter put in `metadata.issues`, the known ones only, in their listed order. */
+export const meetingIssuesOf = (metadata) => {
+    const listed = metadata?.issues;
+    return Array.isArray(listed) ? MEETING_ISSUES.filter((issue) => listed.includes(issue)) : [];
+};
 /** A stored meeting as every command and tool answers it; `src/entities/` registers it as `meeting`. */
 export const meeting = v.strictObject({
     ref: reference,
@@ -20,33 +30,39 @@ export const meeting = v.strictObject({
     duration_ms: v.nullable(count),
     timezone: v.optional(v.nullable(text)),
     participants_count: v.nullable(count),
+    /** Present only when something about this meeting is doubtful. */
+    issues: v.optional(v.array(v.picklist(MEETING_ISSUES))),
     created_at: isoTime,
     updated_at: isoTime,
 });
 const iso = (ms) => (ms === null ? null : new Date(ms).toISOString());
-export const meetingItem = (row, owner) => ({
-    ref: formatMeetingReference({ type: "meeting", accountId: row.accountId, meetingId: row.id }),
-    id: String(row.id),
-    provider: owner.provider,
-    account: owner.account,
-    title: row.title,
-    description: row.description,
-    location: row.location,
-    url: row.joinUrl,
-    started_at: iso(row.startedAt),
-    ended_at: iso(row.endedAt),
-    duration_ms: row.durationMs,
-    timezone: row.timezone,
-    participants_count: row.participantsCount,
-    created_at: new Date(row.createdAt).toISOString(),
-    updated_at: new Date(row.updatedAt).toISOString(),
-});
+export const meetingItem = (row, owner) => {
+    const issues = meetingIssuesOf(row.metadata);
+    return {
+        ref: formatMeetingReference({ type: "meeting", accountId: row.accountId, meetingId: row.id }),
+        id: String(row.id),
+        provider: owner.provider,
+        account: owner.account,
+        title: row.title,
+        description: row.description,
+        location: row.location,
+        url: row.joinUrl,
+        started_at: iso(row.startedAt),
+        ended_at: iso(row.endedAt),
+        duration_ms: row.durationMs,
+        timezone: row.timezone,
+        participants_count: row.participantsCount,
+        ...(issues.length ? { issues } : {}),
+        created_at: new Date(row.createdAt).toISOString(),
+        updated_at: new Date(row.updatedAt).toISOString(),
+    };
+};
 /** `meetings list` fields: what the meetings table holds of the meeting itself. */
 export const MEETING_QUERY = {
     entity: "meeting",
     backend: "sql",
     fields: queryFieldsOf(meeting, {
-        exclude: ["ref", "provider", "account", "description", "location", "url", "timezone"],
+        exclude: ["ref", "provider", "account", "description", "location", "url", "timezone", "issues"],
         examples: {
             id: "id:12",
             title: "title:*standup*",

package/dist/ports/traits.d.ts

@@ -72,6 +72,12 @@ export interface MessengerTraits {
      * adapter's `history` — `messages sync <chat>`. `--all` stays refused: there is no chat list to walk. No when unset.
      */
     historyOnDemand?: boolean;
+    /**
+     * Who keeps a chat's unread count. `messenger` when unset: the store holds what the messenger last said. `store`: the
+     * messenger says it only now and then (a history push, a read on the phone), so each message from someone else that
+     * `watch` or `listen` saves for the first time, sent after the last count, adds one.
+     */
+    unreadCounts?: "messenger" | "store";
     /**
      * Whether `search messages --backend` is offered: the adapter has `searchMessages`. `chat` when its server
      * searches one chat at a time, so only a query that names one chat asks it. No when unset.