@wirecat/cli-core 0.403.0 → 0.405.0

package/dist/entities/index.js

@@ -59,7 +59,7 @@ import { messageCounts } from "./message-counts.js";
 import { messageLink } from "./message-link.js";
 import { evidencePacket, messageLinks, messageTranscript } from "./message-read.js";
 import { messageDownload, messageSync } from "./message-transfer.js";
-import { messageWrite } from "./message-write.js";
+import { messageSend, messageWrite } from "./message-write.js";
 import { model } from "./model.js";
 import { modelKey, removedModelKey, storedModelKey } from "./model-key.js";
 import { note } from "./note.js";
@@ -123,6 +123,7 @@ export const ENTITIES = {
     ]),
     message_link: messageLink,
     message_write: messageWrite,
+    message_send: messageSend,
     message_pin: messagePin,
     message_star: messageStar,
     message_deletion: messageDeletion,

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

@@ -376,3 +376,389 @@ export declare const messageWrite: 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>;
 }, undefined>;
+export declare const draftWrite: v.StrictObjectSchema<{
+    readonly operation_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly chat_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly saved: v.LiteralSchema<true, undefined>;
+}, undefined>;
+export declare const messageSend: v.UnionSchema<[v.StrictObjectSchema<{
+    readonly operation_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly message: v.StrictObjectSchema<{
+        readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly provider: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly account: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly chat_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly chat_title: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly sender_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly sender_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly sender_username: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly sender_is_chat: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly mentions: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, undefined>;
+        readonly timestamp: 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 edited_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 text: v.StringSchema<undefined>;
+        readonly transcript: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly anchor: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
+        readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+        readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.StringSchema<undefined>;
+            readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
+        readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly coverage: v.NumberSchema<undefined>;
+            readonly matched_terms: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly missing_terms: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly parent: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        }, undefined>, undefined>;
+        readonly context: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+            readonly timestamp: 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 sender_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly text: v.StringSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly outgoing: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly attachments: v.ArraySchema<v.StrictObjectSchema<{
+            readonly message: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            readonly kind: v.StringSchema<undefined>;
+            readonly position: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly size: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly width: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly height: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly text: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly extraction: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly origin: v.StringSchema<undefined>;
+                readonly extractor: v.StringSchema<undefined>;
+                readonly chars: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
+                readonly text: v.StringSchema<undefined>;
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly reply_to: v.NullableSchema<v.StrictObjectSchema<{
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly sender_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+            readonly sender_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly timestamp: 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 text: v.StringSchema<undefined>;
+            readonly attachments: v.ArraySchema<v.StrictObjectSchema<{
+                readonly message: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+                readonly kind: v.StringSchema<undefined>;
+                readonly position: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly size: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly width: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly height: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly text: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly extraction: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly origin: v.StringSchema<undefined>;
+                    readonly extractor: v.StringSchema<undefined>;
+                    readonly chars: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                    readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>;
+                readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
+                    readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
+                    readonly text: v.StringSchema<undefined>;
+                    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>, undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly outgoing: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly reply_to_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly forwarded_from: v.NullableSchema<v.StrictObjectSchema<{
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly sender_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+            readonly sender_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly timestamp: 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 text: v.StringSchema<undefined>;
+            readonly attachments: v.ArraySchema<v.StrictObjectSchema<{
+                readonly message: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+                readonly kind: v.StringSchema<undefined>;
+                readonly position: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly size: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly width: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly height: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly text: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly extraction: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly origin: v.StringSchema<undefined>;
+                    readonly extractor: v.StringSchema<undefined>;
+                    readonly chars: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                    readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>;
+                readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
+                    readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
+                    readonly text: v.StringSchema<undefined>;
+                    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>, undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly outgoing: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly thread_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly thread_root_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly reactions: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
+            readonly counts: v.ArraySchema<v.StrictObjectSchema<{
+                readonly reaction: v.StringSchema<undefined>;
+                readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            }, undefined>, undefined>;
+            readonly mine: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        }, 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<{
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.StringSchema<undefined>;
+                readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            }, undefined>, undefined>;
+            readonly to: v.ArraySchema<v.StrictObjectSchema<{
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.StringSchema<undefined>;
+                readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            }, undefined>, undefined>;
+            readonly cc: v.ArraySchema<v.StrictObjectSchema<{
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.StringSchema<undefined>;
+                readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            }, undefined>, undefined>;
+            readonly bcc: v.ArraySchema<v.StrictObjectSchema<{
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.StringSchema<undefined>;
+                readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            }, undefined>, undefined>;
+            readonly reply_addresses: v.ArraySchema<v.StrictObjectSchema<{
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.StringSchema<undefined>;
+                readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            }, undefined>, undefined>;
+            readonly labels: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly thread: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+            readonly read: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly flagged: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly sender_score: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly score: v.NumberSchema<undefined>;
+                readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+    }, undefined>;
+    /** An album's messages, in order; `message` is the first. Absent for a single message. */
+    readonly messages: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+        readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly provider: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly account: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly chat_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly chat_title: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly sender_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly sender_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly sender_username: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly sender_is_chat: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly mentions: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, undefined>;
+        readonly timestamp: 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 edited_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 text: v.StringSchema<undefined>;
+        readonly transcript: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly anchor: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
+        readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+        readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.StringSchema<undefined>;
+            readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
+        readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly coverage: v.NumberSchema<undefined>;
+            readonly matched_terms: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly missing_terms: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly parent: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        }, undefined>, undefined>;
+        readonly context: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+            readonly timestamp: 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 sender_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly text: v.StringSchema<undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly outgoing: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly attachments: v.ArraySchema<v.StrictObjectSchema<{
+            readonly message: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            readonly kind: v.StringSchema<undefined>;
+            readonly position: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly size: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly width: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly height: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly text: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly extraction: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly origin: v.StringSchema<undefined>;
+                readonly extractor: v.StringSchema<undefined>;
+                readonly chars: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
+                readonly text: v.StringSchema<undefined>;
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly reply_to: v.NullableSchema<v.StrictObjectSchema<{
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly sender_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+            readonly sender_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly timestamp: 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 text: v.StringSchema<undefined>;
+            readonly attachments: v.ArraySchema<v.StrictObjectSchema<{
+                readonly message: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+                readonly kind: v.StringSchema<undefined>;
+                readonly position: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly size: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly width: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly height: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly text: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly extraction: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly origin: v.StringSchema<undefined>;
+                    readonly extractor: v.StringSchema<undefined>;
+                    readonly chars: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                    readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>;
+                readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
+                    readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
+                    readonly text: v.StringSchema<undefined>;
+                    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>, undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly outgoing: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly reply_to_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly forwarded_from: v.NullableSchema<v.StrictObjectSchema<{
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly sender_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+            readonly sender_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly timestamp: 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 text: v.StringSchema<undefined>;
+            readonly attachments: v.ArraySchema<v.StrictObjectSchema<{
+                readonly message: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+                readonly kind: v.StringSchema<undefined>;
+                readonly position: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly size: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly width: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly height: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+                readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly text: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly extraction: v.OptionalSchema<v.StrictObjectSchema<{
+                    readonly origin: v.StringSchema<undefined>;
+                    readonly extractor: v.StringSchema<undefined>;
+                    readonly chars: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+                    readonly error: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>;
+                readonly local_path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly buttons: v.OptionalSchema<v.ArraySchema<v.ArraySchema<v.StrictObjectSchema<{
+                    readonly kind: v.PicklistSchema<["callback", "link", "message", "chat", "contact", "location", "app", "clipboard", "other"], undefined>;
+                    readonly text: v.StringSchema<undefined>;
+                    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>, undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly outgoing: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly thread_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly thread_root_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly reactions: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
+            readonly counts: v.ArraySchema<v.StrictObjectSchema<{
+                readonly reaction: v.StringSchema<undefined>;
+                readonly count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            }, undefined>, undefined>;
+            readonly mine: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly total: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        }, 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<{
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.StringSchema<undefined>;
+                readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            }, undefined>, undefined>;
+            readonly to: v.ArraySchema<v.StrictObjectSchema<{
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.StringSchema<undefined>;
+                readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            }, undefined>, undefined>;
+            readonly cc: v.ArraySchema<v.StrictObjectSchema<{
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.StringSchema<undefined>;
+                readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            }, undefined>, undefined>;
+            readonly bcc: v.ArraySchema<v.StrictObjectSchema<{
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.StringSchema<undefined>;
+                readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            }, undefined>, undefined>;
+            readonly reply_addresses: v.ArraySchema<v.StrictObjectSchema<{
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.StringSchema<undefined>;
+                readonly ref: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+            }, undefined>, undefined>;
+            readonly labels: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly thread: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+            readonly read: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly flagged: v.NullableSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly sender_score: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly score: v.NumberSchema<undefined>;
+                readonly signals: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                readonly demoted: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+    }, 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>;
+}, undefined>, v.StrictObjectSchema<{
+    readonly operation_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly chat_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly saved: v.LiteralSchema<true, undefined>;
+}, undefined>], undefined>;

package/dist/entities/message-write.js

@@ -8,3 +8,9 @@ export const messageWrite = v.strictObject({
     messages: v.optional(v.array(message)),
     scheduled_for: v.optional(time),
 });
+export const draftWrite = v.strictObject({
+    operation_id: id,
+    chat_id: id,
+    saved: v.literal(true),
+});
+export const messageSend = v.union([messageWrite, draftWrite]);

package/dist/ports/messenger.d.ts

@@ -110,6 +110,8 @@ export interface MessengerCore {
     chat(chat: string): Promise<ChatCard>;
     /** An option the messenger has no way to honour is refused, never dropped. */
     send(chatId: Id, text: string, options: SendOptions): Promise<Sent>;
+    /** Save a nonempty draft for the owner to review and send; never sends a message. */
+    saveDraft?(chatId: Id, text: string, options: Pick<SendOptions, "replyTo" | "threadId" | "formatting" | "noPreview">): Promise<void>;
     logout(): Promise<void>;
     close(): Promise<void>;
 }

package/dist/ports/traits.d.ts

@@ -24,6 +24,8 @@ export interface Fetching {
 export type MediaOption = "spoiler" | "captionAbove" | "fileName";
 /** What a messenger is and can do, as the services read it; the CLI's `Messenger` adds how its commands run. */
 export interface MessengerTraits {
+    /** Opt in to `messages send --draft` only when the adapter implements `saveDraft`. */
+    drafts?: boolean;
     counterFields?: readonly CounterField[];
     app: AppIdentity;
     provider: Provider;

package/dist/sends/index.d.ts

@@ -3,7 +3,7 @@ export { type FloodDeadline, FloodMemory, type FloodState, FROZEN_HOLD_MS, flood
 export { type Asker, type GuardRequest, guardFor, type SendGuard, type SendGuardOptions, sendGuard, sharedJournal, } from "./guard.js";
 export { currentOperation, guardedWrite, type Operated } from "./guarded.js";
 export { type AccountAction, type ChatAction, type SendEntry, SendJournal, type SendKind, type SendOutcome, sendsPathFor, } from "./journal.js";
-export { assertStatsPermissionsCurrent, DEFAULT_PERMISSIONS, keyForCommand, keyForWrite, LEVELS, type Level, layerPermissions, levelFor, PERMISSIONS, type Permission, type PermissionKey, permissionFor, permissionOverrides, readKeysForCommand, skipFlagFor, WRITE_KEYS, } from "./permissions.js";
+export { assertStatsPermissionsCurrent, CEILING_KEY, DEFAULT_PERMISSIONS, keyForCommand, keyForWrite, LEVELS, type Level, layerPermissions, levelFor, PERMISSIONS, type Permission, type PermissionKey, permissionFor, permissionOverrides, readKeysForCommand, skipFlagFor, WRITE_KEYS, } from "./permissions.js";
 export { type Recipient, RecipientList, recipientsPathFor } from "./recipients.js";
 export { newOperationId, newSendId } from "./send-id.js";
 export { MAX_BUFFERED_UPLOAD_BYTES, readUpload, refusedPlace, uploadBlob, uploadBytes, uploadSize, } from "./upload.js";

package/dist/sends/index.js

@@ -2,7 +2,7 @@ export { FloodMemory, FROZEN_HOLD_MS, floodPathFor, LIMITED_HOLD_MS, } from "./f
 export { guardFor, sendGuard, sharedJournal, } from "./guard.js";
 export { currentOperation, guardedWrite } from "./guarded.js";
 export { SendJournal, sendsPathFor, } from "./journal.js";
-export { assertStatsPermissionsCurrent, DEFAULT_PERMISSIONS, keyForCommand, keyForWrite, LEVELS, layerPermissions, levelFor, PERMISSIONS, permissionFor, permissionOverrides, readKeysForCommand, skipFlagFor, WRITE_KEYS, } from "./permissions.js";
+export { assertStatsPermissionsCurrent, CEILING_KEY, DEFAULT_PERMISSIONS, keyForCommand, keyForWrite, LEVELS, layerPermissions, levelFor, PERMISSIONS, permissionFor, permissionOverrides, readKeysForCommand, skipFlagFor, WRITE_KEYS, } from "./permissions.js";
 export { RecipientList, recipientsPathFor } from "./recipients.js";
 export { newOperationId, newSendId } from "./send-id.js";
 export { MAX_BUFFERED_UPLOAD_BYTES, readUpload, refusedPlace, uploadBlob, uploadBytes, uploadSize, } from "./upload.js";

package/dist/sends/permissions.d.ts

@@ -31,7 +31,7 @@ export declare const isBotApi: (path: readonly string[]) => boolean;
  */
 export declare const botApiAllowed: (levels: Readonly<Record<PermissionKey, Level>>) => boolean;
 /** The resources at the top of the command tree, which `readOnly` and `allow` turn read-only as a whole. */
-export declare const RESOURCES: readonly ["messages", "reactions", "polls", "topics", "chats", "contacts", "account", "bot", "conversations", "tags", "mentions", "search", "searches", "tasks", "replies", "attachments", "stats", "store", "metadata", "mcp", "server", "models", "schedule", "doctor", "images"];
+export declare const RESOURCES: readonly ["messages", "drafts", "reactions", "polls", "topics", "chats", "contacts", "account", "bot", "conversations", "tags", "mentions", "search", "searches", "tasks", "replies", "attachments", "stats", "store", "metadata", "mcp", "server", "models", "schedule", "doctor", "images"];
 /** The command path an old `allow` word stood for, as one key — what an MCP tool's `permission` is checked against. */
 export declare const keyOfWord: (word: Permission) => PermissionKey;
 /**

package/dist/sends/permissions.js

@@ -122,6 +122,7 @@ export const botApiAllowed = (levels) => {
 /** The resources at the top of the command tree, which `readOnly` and `allow` turn read-only as a whole. */
 export const RESOURCES = [
     "messages",
+    "drafts",
     "reactions",
     "polls",
     "topics",
@@ -316,6 +317,7 @@ export const writeOfKey = (key) => {
 };
 /** Write keys written out where a write is checked; `permission-keys.test.ts` keeps this list whole. */
 const NAMED_WRITE_KEYS = [
+    "drafts",
     "store.gaps.repair",
     "messages.sync-first",
     "messages.server-search",

package/dist/services/messages.d.ts

@@ -159,6 +159,7 @@ export interface SendRequest {
     /** A post of `chat`, a channel: the message goes to the post's discussion as a reply to it. */
     commentTo?: Id;
 }
+export type DraftRequest = Pick<SendRequest, "chat" | "text" | "replyTo" | "threadId" | "markdown" | "html" | "noPreview">;
 /** One message in a chat, as typed. */
 export interface MessageTarget {
     chat: string;
@@ -214,6 +215,10 @@ export interface MessagesService {
     stats(query: SearchQuery & {
         by: StatsGrouping;
     }): Promise<MessageStats>;
+    saveDraft?(request: DraftRequest): Promise<Operated<{
+        chatId: Id;
+        saved: true;
+    }>>;
     /** A reply is a send with `replyTo`. */
     send(request: SendRequest): Promise<Operated<Sent>>;
     /** With `markdown` or `html`, the marks are taken out as a send takes them. */

package/dist/services/messages.js

@@ -250,6 +250,29 @@ export const messagesService = (deps) => {
             await remember(store, "stats", query);
             return withRefresh(stats, refreshed);
         }),
+        saveDraft: async ({ chat, text: typed, replyTo, threadId: typedThread, markdown, html, noPreview }) => {
+            if (typed.trim() === "")
+                throw new CliError("validation_error", "a draft needs nonempty text; clearing a draft is not supported");
+            const connection = await deps.connection();
+            const save = capability(connection, "saveDraft", "save a draft");
+            const prepared = await formatted(connection, typed, { markdown, html });
+            const { text, spans } = deps.agentText ? visibleFormattedText(prepared) : prepared;
+            if (text.trim() === "")
+                throw new CliError("validation_error", "a draft needs nonempty text after formatting");
+            const threadId = threadIdOf(typedThread);
+            const validate = threadId === undefined ? undefined : capability(connection, "validateThread", "save a draft in a forum topic");
+            const { id: chatId } = await connection.resolve(chat);
+            const operationId = newOperationId();
+            await guardedWrite(guard, { operationId, chatId, kind: "edit", key: "drafts", length: text.length }, () => save(chatId, text, {
+                ...(replyTo === undefined ? {} : { replyTo }),
+                ...(threadId === undefined ? {} : { threadId }),
+                ...(spans.length === 0 ? {} : { formatting: spans }),
+                ...(noPreview ? { noPreview } : {}),
+            }), undefined, validate === undefined || threadId === undefined
+                ? undefined
+                : () => validate(chatId, threadId, { ...(replyTo === undefined ? {} : { replyTo }) }));
+            return { operationId, chatId, saved: true };
+        },
         send: async ({ chat, text: typed, sendId, replyTo: typedReplyTo, threadId: typedThread, silent, noPreview, markdown, html, at, attachments = [], key, origin, spoiler, captionAbove, sendAs, commentTo, sticker, stickerFile, }) => {
             const stickers = (sticker === undefined ? 0 : 1) + (stickerFile === undefined ? 0 : 1);
             if (stickers > 0 && (stickers > 1 || typed.trim() !== "" || attachments.length > 0 || markdown || html))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.403.0",
+  "version": "0.405.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",