@wirecat/cli-core 0.395.0 → 0.396.0

package/CHANGELOG.md

@@ -7,6 +7,36 @@ shape of this file.
 
 ## Unreleased
 
+## 0.396.0 — 23.10.2026
+
+### Changed — may break callers
+
+- **Command discovery uses `--json`.** `commands`, scoped discovery and `commands schema` refuse `--jsonl` with `output.one-object`, instead of printing a line with no stream end record. Use `--json` for the discovery document.
+
+- cli-core requires cli-base 0.50.1 or newer within the 0.50 line for profile-preserving command corrections and concise skill summaries.
+
+### Fixed
+
+- **Unknown-command explanations are separated.** The explanation of a word read as a profile follows the command error with a dash, keeping both parts readable on one line.
+
+- **Input-field errors name the command's flags.** Adapters can report unsupported or conflicting domain fields through `input.field-unsupported` or `input.field-conflict`. The CLI maps declared fields to flags in the human message and structured parameter, while SDK errors stay independent of command syntax. Unknown fields are kept without guessing.
+
+- **Joined command hints keep the chosen profile.** A command path passed as one argument is refused with a correction that preserves a separate explicit profile, including when global options come first.
+
+### Added
+
+- `SEARCHES_QUERY` (`@wirecat/cli-core/cli`): the query `searches list` takes, for another CLI's own saved searches.
+
+- **A voice note's transcript is found in any form of a word, and widened to the spellings speech recognition
+  garbles (store version 29).** «риелтор» finds a transcript saying «риелтору», and «реелтора»: always, not only when
+  nothing matched, by meeting search's rules — one stem edit from a word the Russian dictionary does not know, never
+  a number word, never a phrase or under `exact:`. A hit found only through a garbled spelling has `match:
+  "corrected"` and `corrections`, and the answer's `corrections` lists them. New tables `transcript_words`, its
+  vocabulary, `transcript_stems` and `transcript_index_pending`, filled before each search; existing transcripts are
+  queued on upgrade.
+
+- Attachment commands include concrete examples in help and command discovery.
+
 ## 0.395.0 — 23.10.2026
 
 ### Changed — may break callers

package/dist/cli/commands-command.js

@@ -20,6 +20,12 @@ export const CONTRACT = 3;
 export const commandsCommand = (app) => {
     const command = annotate(new Command("commands"), { effects: NO_EFFECTS })
         .description("every command by section, one line each; --json: the contract, one path per call")
+        .hook("preAction", (_command, action) => {
+        if (action.optsWithGlobals().jsonl)
+            throw new CliError("validation_error", "command discovery is one JSON object — use --json", {
+                reason: "output.one-object",
+            });
+    })
         .argument("[path...]", "one command path, for example: search messages; inspect other groups in separate calls")
         .action(function (path) {
         const root = rootOf(this);

package/dist/cli/index.d.ts

@@ -108,7 +108,7 @@ export { reviewCommand } from "./messenger/review.js";
 export { scheduleCommand } from "./messenger/schedule-command.js";
 export { allHitItem, type HitItem, type MessageHitItem, messageHitItem, type NoteHitItem, noteHitItem, } from "./messenger/search-answers.js";
 export { searchCommand } from "./messenger/search-command.js";
-export { searchesCommand } from "./messenger/searches-command.js";
+export { SEARCHES_QUERY, searchesCommand } from "./messenger/searches-command.js";
 export { serveCommand, servingProfiles } from "./messenger/serve-command.js";
 export { DAY_MS, FIRST_FETCH_MS, type MemberFetches, memberFetches } from "./messenger/serve-members.js";
 export { STEMS_EVERY_MS, STEMS_SLICE_MS, type StemFills, stemFills } from "./messenger/serve-stems.js";

package/dist/cli/index.js

@@ -103,7 +103,7 @@ export { reviewCommand } from "./messenger/review.js";
 export { scheduleCommand } from "./messenger/schedule-command.js";
 export { allHitItem, messageHitItem, noteHitItem, } from "./messenger/search-answers.js";
 export { searchCommand } from "./messenger/search-command.js";
-export { searchesCommand } from "./messenger/searches-command.js";
+export { SEARCHES_QUERY, searchesCommand } from "./messenger/searches-command.js";
 export { serveCommand, servingProfiles } from "./messenger/serve-command.js";
 export { DAY_MS, FIRST_FETCH_MS, memberFetches } from "./messenger/serve-members.js";
 export { STEMS_EVERY_MS, STEMS_SLICE_MS, stemFills } from "./messenger/serve-stems.js";

package/dist/cli/input-fields.d.ts

@@ -0,0 +1,3 @@
+import type { errorObjectOf } from "@wirecat/cli-base";
+import type { Command } from "commander";
+export declare const showInputFields: (object: ReturnType<typeof errorObjectOf>, command: Command) => void;

package/dist/cli/input-fields.js

@@ -0,0 +1,27 @@
+import { INPUT_FIELD_REASONS } from "../errors/reasons.js";
+export const showInputFields = (object, command) => {
+    if (!INPUT_FIELD_REASONS.some((reason) => reason.reason === object.error.reason))
+        return;
+    const fields = object.error.details?.fields;
+    if (!Array.isArray(fields) || fields.length === 0 || !fields.every((field) => typeof field === "string"))
+        return;
+    const options = new Map();
+    for (let at = command; at; at = at.parent)
+        for (const option of at.options)
+            if (!option.hidden && option.long && !options.has(option.attributeName()))
+                options.set(option.attributeName(), option.long);
+    const flags = [];
+    for (const field of fields) {
+        const flag = options.get(field);
+        if (!flag)
+            return;
+        if (!flags.includes(flag))
+            flags.push(flag);
+    }
+    const first = flags[0];
+    if (first === undefined)
+        return;
+    object.error.message = `${flags.join(", ")}: ${object.error.message}`;
+    object.error.param = first;
+    object.error.details = { ...object.error.details, fields: flags };
+};

package/dist/cli/messenger/attachments-command.js

@@ -34,7 +34,10 @@ const summary = (run) => [
 ]
     .filter(Boolean)
     .join(", ");
-const extractCommand = (messenger) => annotate(new Command("extract"), { effects: FETCH })
+const extractCommand = (messenger) => annotate(new Command("extract"), {
+    effects: FETCH,
+    examples: [`${messenger.app.command} personal attachments extract --chat "Book club" --limit 10`],
+})
     .description("read the text of downloaded files — text, PDF/DOCX text layers, ODT/ODS/XLSX/PPTX/EPUB — into the local store, where search finds them")
     .option("--chat <chat>", `only this chat's files; ${messenger.chatArgument}`)
     .option("--from-dir <dir>", "match files in this nonrecursive directory; needs --chat")
@@ -121,13 +124,19 @@ const extractCommand = (messenger) => annotate(new Command("extract"), { effects
 });
 const row = ({ message, position, name, local_path, extraction }) => `${message} #${position}  ${name ?? ""}  ${extraction ? `${extraction.origin} ${extraction.chars}` : "no text"}  ` +
     (local_path ?? "not downloaded");
-const listCommand = (messenger) => withQuery(withPaging(annotate(new Command("list"), { effects: REMOTE_READ }).description("files of stored messages, newest first: where each was saved and whether its text is held — never the text")), ATTACHMENT_QUERY).action(async function (words) {
+const listCommand = (messenger) => withQuery(withPaging(annotate(new Command("list"), {
+    effects: REMOTE_READ,
+    examples: [`${messenger.app.command} personal attachments list --limit 10`],
+}).description("files of stored messages, newest first: where each was saved and whether its text is held — never the text")), ATTACHMENT_QUERY).action(async function (words) {
     const context = messengerContext(this, messenger);
     const query = listQuery(typedQuery(words), ATTACHMENT_QUERY, "attachments list");
     const found = await context.withServices((services) => services.attachments.list({ ...pageOf(context.settings), ...(query ? { query } : {}) }));
     renderAnswer(this, context, pagedList("attachments list", context.settings, found), () => found.items.length === 0 ? "" : `${found.items.map(row).join("\n")}\n`);
 });
-const showCommand = (messenger) => annotate(new Command("show"), { effects: REMOTE_READ })
+const showCommand = (messenger) => annotate(new Command("show"), {
+    effects: REMOTE_READ,
+    examples: [`${messenger.app.command} personal attachments show "Book club" 101 --attachment 1`],
+})
     .description("read a bounded chunk of one retained attachment; JSON includes base64 bytes")
     .argument("<chat>", `${messenger.chatArgument}; or a msg: locator alone`)
     .argument("[message]", "the message id")
@@ -159,7 +168,10 @@ const showCommand = (messenger) => annotate(new Command("show"), { effects: REMO
 });
 const textCommand = (messenger) => {
     const text = new Command("text").description("the text of one file, as an agent read it");
-    readsStdin(annotate(text.command("set"), { effects: LOCAL_WRITE }), {
+    readsStdin(annotate(text.command("set"), {
+        effects: LOCAL_WRITE,
+        examples: [`${messenger.app.command} personal attachments text set "Book club" 101 --text-file ./transcript.txt`],
+    }), {
         name: "text",
         description: "the text of the file",
     })

package/dist/cli/messenger/conversation-answers.d.ts

@@ -54,6 +54,11 @@ export declare const conversationShown: (account: AccountKey, { summary, message
         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;

package/dist/cli/messenger/message-answers.d.ts

@@ -31,6 +31,11 @@ export declare const threadAnswer: ({ items, ...thread }: ThreadContext, reader:
         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;

package/dist/cli/messenger/message-writes.d.ts

@@ -33,6 +33,11 @@ export declare const writtenAnswer: ({ operationId, sendId, message, scheduledFo
         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;

package/dist/cli/messenger/search-answers.js

@@ -21,6 +21,8 @@ export const messageHitItem = (hit, query = "") => {
         excerpt: hit.excerpt ?? excerpt(hit.text, query),
         matched_in: hit.matchedIn,
         score: hit.score ?? undefined,
+        match: hit.match,
+        corrections: hit.corrections,
         found_in: hit.source,
         discovery: hit.discovery
             ? defined({

package/dist/cli/messenger/searches-command.d.ts

@@ -1,4 +1,6 @@
 import { Command } from "commander";
 import { type Messenger } from "./context.js";
+/** `searches list` takes a query over the saved search fields, none of them a filter: the list is short and whole. */
+export declare const SEARCHES_QUERY: import("@wirecat/cli-base/query").QueryRegistry;
 /** Saved searches and the history of `search messages` and `stats messages show`, in the local store only. */
 export declare const searchesCommand: (messenger: Messenger) => Command;

package/dist/cli/messenger/searches-command.js

@@ -20,7 +20,8 @@ const line = ({ id, name, command, params, runs, lastRunAt }) => [
     `${runs} runs`,
     lastRunAt?.slice(0, 16).replace("T", " ") ?? "never run",
 ].join("  ");
-const SEARCHES_QUERY = unfilteredQuery("saved_search", savedSearch);
+/** `searches list` takes a query over the saved search fields, none of them a filter: the list is short and whole. */
+export const SEARCHES_QUERY = unfilteredQuery("saved_search", savedSearch);
 /** Saved searches and the history of `search messages` and `stats messages show`, in the local store only. */
 export const searchesCommand = (messenger) => {
     const searches = new Command("searches").description("saved searches and the history of search messages and stats messages show, kept in the local store; --saved runs one");

package/dist/cli/messenger/store-maintenance-command.d.ts

@@ -2,9 +2,9 @@ import { Command } from "commander";
 import type { Messenger } from "./context.js";
 /** `doctor`'s short summary of the store. Must answer for a broken file, so an error is a field. */
 export declare const storeSummary: (env: NodeJS.ProcessEnv) => Promise<{
+    error?: undefined;
     path: string;
     exists: boolean;
-    error?: undefined;
 } | {
     path: string;
     exists: boolean;

package/dist/cli/program.js

@@ -20,6 +20,7 @@ import { changesAuthorityNow, isLogin, isStoreChange, judgedEffects, judgedTarge
 import { itemOf, renderAnswer, snakeKeys } from "./envelope.js";
 import { byteCount, DEFAULT_COMMAND_MS, DEFAULT_OUTPUT_BYTES, execution } from "./execution.js";
 import { installHelp } from "./help/first-screen.js";
+import { showInputFields } from "./input-fields.js";
 import { MAX_BUFFERED_INPUT, provideInputPolicy } from "./input-policy.js";
 import { checkJson, liftJson } from "./json-fields.js";
 import { movedPath, movedPointer } from "./moved.js";
@@ -354,7 +355,7 @@ const runOnce = async (argv, definition, options) => {
         // Only before `--`: what follows is a positional, an agent's text among them, never a command word.
         const end = lifted.indexOf("--");
         for (const words of [flags, end < 0 ? lifted : lifted.slice(0, end)])
-            refuseJoinedPath(program, words.filter((word) => !word.startsWith("-")));
+            refuseJoinedPath(program, words.filter((word) => !word.startsWith("-")), profile !== undefined && !/\s/.test(profile) ? [profile] : []);
     }
     catch (failure) {
         const settled = await settleFailure(failure, { definition, program, rest: lifted, profile, options });
@@ -420,7 +421,8 @@ const runOnce = async (argv, definition, options) => {
                 error.code === "commander.unknownCommand" &&
                 rest[0] !== undefined &&
                 !commandWords(program).has(rest[0])) {
-                message += ` "${profile}" is not a command, so it was read as a profile name — which left "${rest[0]}" to be one.`;
+                message = message.trimEnd();
+                message += ` — "${profile}" is not a command, so it was read as a profile name — which left "${rest[0]}" to be one.`;
             }
             const failure = new CliError("validation_error", message);
             const settled = await settleFailure(failure, { definition, program, rest, profile, options });
@@ -577,6 +579,7 @@ const failed = ({ app }, program, rest, error, settled, debug) => {
         targets: judgedTargets(program),
         ...(effects ? { effects } : {}),
     });
+    showInputFields(object, (path && commandAt(program, path)) || program);
     const command = path || app.command;
     return {
         object,

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

@@ -69,6 +69,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 +255,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 +441,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 +606,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 +615,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 +678,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 +742,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 +807,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 +871,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 +950,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 +1136,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>;
@@ -3264,6 +3314,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 +3500,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 +3724,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 +3910,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

@@ -61,6 +61,8 @@ export const ENTITIES = {
         "excerpt",
         "matched_in",
         "score",
+        "match",
+        "corrections",
         "found_in",
         "discovery",
         "context",

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,