@wirecat/cli-core 0.395.0 → 0.397.0

package/dist/entities/contact-read.js

@@ -0,0 +1,50 @@
+import * as v from "valibot";
+import { chat } from "./chat.js";
+import { count, id, text, time } from "./fields.js";
+export const contactLookup = v.strictObject({ id, name: v.nullable(text), username: v.nullable(text) });
+export const contactSync = v.strictObject({ added: count, changed: count, known: count });
+export const contactProfile = v.strictObject({
+    id,
+    name: v.nullable(text),
+    usernames: v.array(text),
+    bio: v.nullable(text),
+    birthday: v.optional(v.nullable(text)),
+    phone: v.optional(v.nullable(text)),
+    flags: v.partial(v.strictObject({
+        bot: v.boolean(),
+        verified: v.boolean(),
+        premium: v.boolean(),
+        scam: v.boolean(),
+        fake: v.boolean(),
+        restricted: v.boolean(),
+        deleted: v.boolean(),
+        support: v.boolean(),
+    })),
+    seen: v.optional(text),
+    contact: v.optional(v.boolean()),
+    mutual_contact: v.optional(v.boolean()),
+    common_chats_count: v.optional(v.nullable(count)),
+    registered: v.optional(v.nullable(v.strictObject({
+        at: text,
+        source: v.picklist(["telegram", "max", "estimate"]),
+        precision: v.picklist(["day", "month"]),
+    }))),
+    has_photo: v.optional(v.boolean()),
+    chats: v.array(v.strictObject({
+        id,
+        title: v.nullable(text),
+        kind: chat.entries.kind,
+        their_messages: count,
+        first_at: v.nullable(time),
+        last_at: v.nullable(time),
+        complete: v.boolean(),
+    })),
+    aliases: v.array(v.strictObject({
+        name: v.optional(text),
+        username: v.optional(text),
+        link: v.optional(text),
+        first_seen_at: time,
+        last_seen_at: time,
+        source: v.picklist(["profile", "messages"]),
+    })),
+});

package/dist/entities/evidence.d.ts

@@ -21,6 +21,11 @@ export declare const contribution: v.StrictObjectSchema<{
         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>;
@@ -202,6 +207,11 @@ export declare const contribution: v.StrictObjectSchema<{
             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>;
@@ -421,6 +431,11 @@ export declare const contribution: v.StrictObjectSchema<{
         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>;
@@ -602,6 +617,11 @@ export declare const contribution: v.StrictObjectSchema<{
             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>;
@@ -857,6 +877,11 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
         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>;
@@ -1038,6 +1063,11 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
             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>;
@@ -1257,6 +1287,11 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
         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>;
@@ -1438,6 +1473,11 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
             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>;

package/dist/entities/index.d.ts

@@ -10,6 +10,7 @@ import { chatEvent } from "./chat-event.js";
 import { chatStats, taskStats } from "./chat-stats.js";
 import { contact } from "./contact.js";
 import { contactNote } from "./contact-note.js";
+import { contactLookup, contactProfile, contactSync } from "./contact-read.js";
 import { conversation } from "./conversation.js";
 import { counterRefresh, counters } from "./counters.js";
 import { document } from "./document.js";
@@ -47,7 +48,7 @@ import { topic } from "./topic.js";
  * subset of its fields, never a renamed one. Commands move onto these one by one; until then, a schema
  * is the target, not a description of today's output.
  */
-export { account, accountSession, adminReport, agenda, attachment, chart, chat, chatEvent, chatStats, contact, contactNote, conversation, counterRefresh, counters, document, evidence, fact, folder, hit, identity, inviteLink, job, joinRequest, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, message, messageCounts, messageLink, model, note, officialStats, person, pollVote, ranking, reference, relationship, retention, savedSearch, tagging, task, taskStats, topic, };
+export { account, accountSession, adminReport, agenda, attachment, chart, chat, chatEvent, chatStats, contact, contactLookup, contactNote, contactProfile, contactSync, conversation, counterRefresh, counters, document, evidence, fact, folder, hit, identity, inviteLink, job, joinRequest, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, message, messageCounts, messageLink, model, note, officialStats, person, pollVote, ranking, reference, relationship, retention, savedSearch, tagging, task, taskStats, topic, };
 export declare const ENTITIES: {
     readonly message: v.StrictObjectSchema<{
         readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
@@ -69,6 +70,11 @@ export declare const ENTITIES: {
         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>;
@@ -250,6 +256,11 @@ export declare const ENTITIES: {
         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>;
@@ -431,6 +442,11 @@ export declare const ENTITIES: {
             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>;
@@ -591,7 +607,7 @@ export declare const ENTITIES: {
                 }, undefined>, undefined>;
             }, undefined>, undefined>;
             readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
-        }, "chat_title" | "context" | "discovery" | "email" | "excerpt" | "found_in" | "matched_in" | "ref" | "score" | "sender_name" | "timestamp">;
+        }, "chat_title" | "context" | "corrections" | "discovery" | "email" | "excerpt" | "found_in" | "match" | "matched_in" | "ref" | "score" | "sender_name" | "timestamp">;
         readonly "~standard": v.StandardProps<{
             ref: string;
             chat_title?: string | null | undefined;
@@ -600,6 +616,11 @@ export declare const ENTITIES: {
             excerpt?: string | undefined;
             matched_in?: "context" | "file" | "filename" | "picture" | "text" | "transcript" | undefined;
             score?: number | undefined;
+            match?: "beginnings" | "corrected" | "words" | undefined;
+            corrections?: {
+                from: string;
+                to: string[];
+            }[] | undefined;
             found_in?: "archive" | "both" | "server" | undefined;
             discovery?: {
                 coverage: number;
@@ -658,6 +679,11 @@ export declare const ENTITIES: {
             excerpt?: string | undefined;
             matched_in?: "context" | "file" | "filename" | "picture" | "text" | "transcript" | undefined;
             score?: number | undefined;
+            match?: "beginnings" | "corrected" | "words" | undefined;
+            corrections?: {
+                from: string;
+                to: string[];
+            }[] | undefined;
             found_in?: "archive" | "both" | "server" | undefined;
             discovery?: {
                 coverage: number;
@@ -717,6 +743,11 @@ export declare const ENTITIES: {
             excerpt?: string | undefined;
             matched_in?: "context" | "file" | "filename" | "picture" | "text" | "transcript" | undefined;
             score?: number | undefined;
+            match?: "beginnings" | "corrected" | "words" | undefined;
+            corrections?: {
+                from: string;
+                to: string[];
+            }[] | undefined;
             found_in?: "archive" | "both" | "server" | undefined;
             discovery?: {
                 coverage: number;
@@ -777,6 +808,11 @@ export declare const ENTITIES: {
                 excerpt?: string | undefined;
                 matched_in?: "context" | "file" | "filename" | "picture" | "text" | "transcript" | undefined;
                 score?: number | undefined;
+                match?: "beginnings" | "corrected" | "words" | undefined;
+                corrections?: {
+                    from: string;
+                    to: string[];
+                }[] | undefined;
                 found_in?: "archive" | "both" | "server" | undefined;
                 discovery?: {
                     coverage: number;
@@ -836,6 +872,11 @@ export declare const ENTITIES: {
                 excerpt?: string | undefined;
                 matched_in?: "context" | "file" | "filename" | "picture" | "text" | "transcript" | undefined;
                 score?: number | undefined;
+                match?: "beginnings" | "corrected" | "words" | undefined;
+                corrections?: {
+                    from: string;
+                    to: string[];
+                }[] | undefined;
                 found_in?: "archive" | "both" | "server" | undefined;
                 discovery?: {
                     coverage: number;
@@ -910,6 +951,11 @@ export declare const ENTITIES: {
         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>;
@@ -1091,6 +1137,11 @@ export declare const ENTITIES: {
             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>;
@@ -1676,6 +1727,124 @@ export declare const ENTITIES: {
         readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
         readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
     }, undefined>;
+    readonly contact_lookup: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly username: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly contact_profile: v.StrictObjectSchema<{
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly usernames: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        readonly bio: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly birthday: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly phone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly flags: Omit<v.StrictObjectSchema<{
+            readonly bot: v.BooleanSchema<undefined>;
+            readonly verified: v.BooleanSchema<undefined>;
+            readonly premium: v.BooleanSchema<undefined>;
+            readonly scam: v.BooleanSchema<undefined>;
+            readonly fake: v.BooleanSchema<undefined>;
+            readonly restricted: v.BooleanSchema<undefined>;
+            readonly deleted: v.BooleanSchema<undefined>;
+            readonly support: v.BooleanSchema<undefined>;
+        }, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
+            readonly entries: {
+                readonly bot: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly verified: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly premium: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly scam: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly fake: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly restricted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly deleted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+                readonly support: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            };
+            readonly "~standard": v.StandardProps<{
+                bot?: boolean | undefined;
+                verified?: boolean | undefined;
+                premium?: boolean | undefined;
+                scam?: boolean | undefined;
+                fake?: boolean | undefined;
+                restricted?: boolean | undefined;
+                deleted?: boolean | undefined;
+                support?: boolean | undefined;
+            }, {
+                bot?: boolean | undefined;
+                verified?: boolean | undefined;
+                premium?: boolean | undefined;
+                scam?: boolean | undefined;
+                fake?: boolean | undefined;
+                restricted?: boolean | undefined;
+                deleted?: boolean | undefined;
+                support?: boolean | undefined;
+            }>;
+            readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+                bot?: boolean | undefined;
+                verified?: boolean | undefined;
+                premium?: boolean | undefined;
+                scam?: boolean | undefined;
+                fake?: boolean | undefined;
+                restricted?: boolean | undefined;
+                deleted?: boolean | undefined;
+                support?: boolean | undefined;
+            }, v.BooleanIssue | v.StrictObjectIssue>;
+            readonly "~types"?: {
+                readonly input: {
+                    bot?: boolean | undefined;
+                    verified?: boolean | undefined;
+                    premium?: boolean | undefined;
+                    scam?: boolean | undefined;
+                    fake?: boolean | undefined;
+                    restricted?: boolean | undefined;
+                    deleted?: boolean | undefined;
+                    support?: boolean | undefined;
+                };
+                readonly output: {
+                    bot?: boolean | undefined;
+                    verified?: boolean | undefined;
+                    premium?: boolean | undefined;
+                    scam?: boolean | undefined;
+                    fake?: boolean | undefined;
+                    restricted?: boolean | undefined;
+                    deleted?: boolean | undefined;
+                    support?: boolean | undefined;
+                };
+                readonly issue: v.BooleanIssue | v.StrictObjectIssue;
+            } | undefined;
+        };
+        readonly seen: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly contact: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly mutual_contact: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly common_chats_count: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, undefined>;
+        readonly registered: v.OptionalSchema<v.NullableSchema<v.StrictObjectSchema<{
+            readonly at: v.StringSchema<undefined>;
+            readonly source: v.PicklistSchema<["telegram", "max", "estimate"], undefined>;
+            readonly precision: v.PicklistSchema<["day", "month"], undefined>;
+        }, undefined>, undefined>, undefined>;
+        readonly has_photo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly chats: v.ArraySchema<v.StrictObjectSchema<{
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly kind: v.PicklistSchema<["dialog", "group", "channel", "saved", "unknown"], undefined>;
+            readonly their_messages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly first_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+            readonly last_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+            readonly complete: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly aliases: v.ArraySchema<v.StrictObjectSchema<{
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly username: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly link: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly first_seen_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+            readonly last_seen_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+            readonly source: v.PicklistSchema<["profile", "messages"], undefined>;
+        }, undefined>, undefined>;
+    }, undefined>;
+    readonly contact_sync: v.StrictObjectSchema<{
+        readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly changed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly known: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, undefined>;
     readonly account: v.StrictObjectSchema<{
         readonly provider: v.StringSchema<undefined>;
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
@@ -3264,6 +3433,11 @@ export declare const ENTITIES: {
             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>;
@@ -3445,6 +3619,11 @@ export declare const ENTITIES: {
                 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>;
@@ -3664,6 +3843,11 @@ export declare const ENTITIES: {
             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>;
@@ -3845,6 +4029,11 @@ export declare const ENTITIES: {
                 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>;

package/dist/entities/index.js

@@ -11,6 +11,7 @@ import { chatEvent } from "./chat-event.js";
 import { chatStats, taskStats } from "./chat-stats.js";
 import { contact } from "./contact.js";
 import { contactNote } from "./contact-note.js";
+import { contactLookup, contactProfile, contactSync } from "./contact-read.js";
 import { conversation } from "./conversation.js";
 import { counterRefresh, counters } from "./counters.js";
 import { document } from "./document.js";
@@ -50,7 +51,7 @@ import { topic } from "./topic.js";
  * subset of its fields, never a renamed one. Commands move onto these one by one; until then, a schema
  * is the target, not a description of today's output.
  */
-export { account, accountSession, adminReport, agenda, attachment, chart, chat, chatEvent, chatStats, contact, contactNote, conversation, counterRefresh, counters, document, evidence, fact, folder, hit, identity, inviteLink, job, joinRequest, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, message, messageCounts, messageLink, model, note, officialStats, person, pollVote, ranking, reference, relationship, retention, savedSearch, tagging, task, taskStats, topic, };
+export { account, accountSession, adminReport, agenda, attachment, chart, chat, chatEvent, chatStats, contact, contactLookup, contactNote, contactProfile, contactSync, conversation, counterRefresh, counters, document, evidence, fact, folder, hit, identity, inviteLink, job, joinRequest, meeting, meetingProjectCandidates, meetingSeriesInventory, member, memory, message, messageCounts, messageLink, model, note, officialStats, person, pollVote, ranking, reference, relationship, retention, savedSearch, tagging, task, taskStats, topic, };
 export const ENTITIES = {
     message,
     "message.hit": v.pick(message, [
@@ -61,6 +62,8 @@ export const ENTITIES = {
         "excerpt",
         "matched_in",
         "score",
+        "match",
+        "corrections",
         "found_in",
         "discovery",
         "context",
@@ -83,6 +86,9 @@ export const ENTITIES = {
     identity,
     contact,
     contact_note: contactNote,
+    contact_lookup: contactLookup,
+    contact_profile: contactProfile,
+    contact_sync: contactSync,
     account,
     account_session: accountSession,
     note,

package/dist/entities/message.d.ts

@@ -25,6 +25,15 @@ export declare const message: v.StrictObjectSchema<{
     /** `picture`: the picture search lane found it by what the picture shows; it follows the text hits. */
     readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
     readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    /**
+     * `corrected`: a query word matched only a spelling speech recognition garbled in a voice note's transcript,
+     * listed in `corrections`. `words` and `beginnings`: what a discovery search matched.
+     */
+    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>;
     /** Where a search found it: the local archive, the messenger's server, or both. */
     readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
     /** A discovery search's partial match: how much of the question it covers, and which words it lacks. */

package/dist/entities/message.js

@@ -37,6 +37,12 @@ export const message = v.strictObject({
     /** `picture`: the picture search lane found it by what the picture shows; it follows the text hits. */
     matched_in: v.optional(v.picklist(["text", "transcript", "filename", "file", "context", "picture"])),
     score: v.optional(v.number()),
+    /**
+     * `corrected`: a query word matched only a spelling speech recognition garbled in a voice note's transcript,
+     * listed in `corrections`. `words` and `beginnings`: what a discovery search matched.
+     */
+    match: v.optional(v.picklist(["words", "beginnings", "corrected"])),
+    corrections: v.optional(v.array(v.strictObject({ from: text, to: v.array(text) }))),
     /** Where a search found it: the local archive, the messenger's server, or both. */
     found_in: v.optional(v.picklist(["archive", "server", "both"])),
     /** A discovery search's partial match: how much of the question it covers, and which words it lacks. */

package/dist/errors/reasons.d.ts

@@ -1,5 +1,6 @@
 import type { FailureContext } from "@wirecat/cli-base";
 import type { ErrorReason } from "@wirecat/cli-base/standards";
+export declare const INPUT_FIELD_REASONS: ErrorReason[];
 /** Every reason this package raises; cli-base's own are known to the handler already. */
 export declare const REASONS: ErrorReason[];
 /**

package/dist/errors/reasons.js

@@ -78,9 +78,24 @@ const OTHERS = [
     validation("vocabulary.over-entry-budget", "the vocabulary has too many entries"),
     ["vocabulary.stale", "configuration_error", "the vocabulary changed meanwhile"],
 ];
+export const INPUT_FIELD_REASONS = defineReasons([
+    {
+        reason: "input.field-conflict",
+        code: "validation_error",
+        message: "the input fields conflict",
+        details: ["fields"],
+    },
+    {
+        reason: "input.field-unsupported",
+        code: "validation_error",
+        message: "the input field is not supported",
+        details: ["fields"],
+    },
+]);
 /** Every reason this package raises; cli-base's own are known to the handler already. */
 export const REASONS = defineReasons([
     ...QUERY_REASONS,
+    ...INPUT_FIELD_REASONS,
     ...[...QUERY, ...OTHERS].map(([reason, code, message]) => ({
         reason,
         code,