@wirecat/cli-core 0.550.0 → 0.552.0

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

@@ -202,6 +202,8 @@ export declare const messageSyncChat: v.StrictObjectSchema<{
     readonly reached_since: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     readonly reached_last: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     readonly stopped: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+    /** The history limits stopped the read: a group too large to read, or the window's start reached. */
+    readonly limited: v.OptionalSchema<v.PicklistSchema<["group_too_large", "older_than_window"], undefined>, undefined>;
     readonly tasks: v.OptionalSchema<v.StrictObjectSchema<{
         readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         readonly closed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -250,6 +252,12 @@ export declare const messageSyncAll: v.StrictObjectSchema<{
             readonly retryable: v.BooleanSchema<undefined>;
             readonly retry_after_ms: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         }, v.UnknownSchema, undefined>, undefined>;
+        readonly limited: v.OptionalSchema<v.PicklistSchema<["group_too_large", "older_than_window"], undefined>, undefined>;
+    }, undefined>, undefined>;
+    /** How many chats the history limits left unread (big groups) or read only to the window's start. */
+    readonly limited: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly group_too_large: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly older_than_window: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
     }, undefined>, undefined>;
     readonly tasks: v.OptionalSchema<v.StrictObjectSchema<{
         readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -328,6 +336,8 @@ export declare const messageSync: v.UnionSchema<[v.StrictObjectSchema<{
     readonly reached_since: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     readonly reached_last: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     readonly stopped: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+    /** The history limits stopped the read: a group too large to read, or the window's start reached. */
+    readonly limited: v.OptionalSchema<v.PicklistSchema<["group_too_large", "older_than_window"], undefined>, undefined>;
     readonly tasks: v.OptionalSchema<v.StrictObjectSchema<{
         readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         readonly closed: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -375,6 +385,12 @@ export declare const messageSync: v.UnionSchema<[v.StrictObjectSchema<{
             readonly retryable: v.BooleanSchema<undefined>;
             readonly retry_after_ms: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         }, v.UnknownSchema, undefined>, undefined>;
+        readonly limited: v.OptionalSchema<v.PicklistSchema<["group_too_large", "older_than_window"], undefined>, undefined>;
+    }, undefined>, undefined>;
+    /** How many chats the history limits left unread (big groups) or read only to the window's start. */
+    readonly limited: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly group_too_large: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly older_than_window: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
     }, undefined>, undefined>;
     readonly tasks: v.OptionalSchema<v.StrictObjectSchema<{
         readonly added: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;

package/dist/entities/message-transfer.js

@@ -46,6 +46,7 @@ const tasks = v.optional(v.strictObject({
     held: v.optional(count),
     held_chats: v.optional(count),
 }));
+const historyLimited = v.picklist(["group_too_large", "older_than_window"]);
 export const messageSyncChat = v.strictObject({
     issue: v.optional(actionableError),
     resume: v.optional(v.strictObject({ before: v.optional(text) })),
@@ -59,6 +60,8 @@ export const messageSyncChat = v.strictObject({
     reached_since: v.optional(v.literal(true)),
     reached_last: v.optional(v.literal(true)),
     stopped: v.optional(v.literal(true)),
+    /** The history limits stopped the read: a group too large to read, or the window's start reached. */
+    limited: v.optional(historyLimited),
     tasks,
     /** `--full-history`: the chat's pushed history is now kept in full; `false` when the store does not know the chat. */
     history_included: v.optional(v.boolean()),
@@ -78,7 +81,10 @@ export const messageSyncAll = v.strictObject({
         stopped: v.optional(v.literal(true)),
         error: v.optional(text),
         issue: v.optional(actionableError),
+        limited: v.optional(historyLimited),
     })),
+    /** How many chats the history limits left unread (big groups) or read only to the window's start. */
+    limited: v.optional(v.strictObject({ group_too_large: count, older_than_window: count })),
     tasks,
 });
 export const messageSyncStarted = v.strictObject({ job: id, pid: count, chat: text, log: text });

package/dist/errors/reasons.js

@@ -33,6 +33,7 @@ const SIGN_IN = [
     ["sign-in.client-file-invalid", "configuration_error", "the file is not a Desktop app OAuth client JSON"],
 ];
 const OTHERS = [
+    ["query.time-limit", "timeout", "the search took longer than its time limit; the query itself is valid"],
     ["model.offline", "permission_error", "downloading a model needs the network; --offline was requested"],
     [
         "contract.unacknowledged-override",

package/dist/mcp/app-server.js

@@ -144,6 +144,7 @@ export const serveAppOverHttp = async (command, context, options, http) => {
     const listening = await serveOverHttp(build, {
         ...http,
         appName: app.command,
+        reaches: `your ${options.name}`,
         onCode: (code, expires) => context.renderer.note(context.env[mcpHttpMarker(app.envPrefix)] === undefined
             ? `login code for a new browser app: ${code} (until ${expires.toTimeString().slice(0, 5)}; a new one after each login)`
             : `a new login code for a browser app: \`${app.command} ${context.settings.profile} mcp server status\``),

package/dist/mcp/http/oauth.d.ts

@@ -14,11 +14,12 @@ export interface OwnerLogin {
  * the browser apps need dynamic registration — but nobody gets a token without the one-time code
  * printed in the owner's terminal. Five wrong codes delay further attempts for thirty seconds.
  */
-export declare const ownerLogin: ({ issuer, resource, file, appName, onCode, now, }: {
+export declare const ownerLogin: ({ issuer, resource, file, appName, reaches, onCode, now, }: {
     issuer: URL;
     resource: URL;
     file: string;
     appName: string;
+    reaches?: string;
     /** The code for the next login, for the owner's eyes only: their terminal, or the server's status file. */
     onCode: (code: string, expires: Date) => void;
     now?: () => number;

package/dist/mcp/http/oauth.js

@@ -51,7 +51,7 @@ const redirectAllowed = (uri) => {
  * the browser apps need dynamic registration — but nobody gets a token without the one-time code
  * printed in the owner's terminal. Five wrong codes delay further attempts for thirty seconds.
  */
-export const ownerLogin = ({ issuer, resource, file, appName, onCode, now = () => Date.now(), }) => {
+export const ownerLogin = ({ issuer, resource, file, appName, reaches = `your ${appName} data`, onCode, now = () => Date.now(), }) => {
     const store = tokenFile(file);
     const codes = new Map();
     let login = { value: "", expires: 0 };
@@ -153,7 +153,7 @@ export const ownerLogin = ({ issuer, resource, file, appName, onCode, now = () =
             .join("");
         const who = escapeHtml(client.name ?? "an application");
         const target = new URL(params.get("redirect_uri") ?? "");
-        const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapeHtml(appName)} login</title><style>body{font:16px system-ui,sans-serif;max-width:28rem;margin:3rem auto;padding:0 1rem;color:#1d2430}input[type=text]{font:20px ui-monospace,monospace;letter-spacing:.1em;width:100%;padding:.5rem;margin:.5rem 0 1rem;box-sizing:border-box}button{font:inherit;padding:.5rem 1rem}.error{color:#b42318}</style></head><body><h1>${escapeHtml(appName)}</h1><p>An app that calls itself <strong>${who}</strong> asks to reach your messages through <code>${escapeHtml(appName)} mcp --http</code>.</p><p>After you allow it, the login goes to <strong>${escapeHtml(target.host)}</strong>. Allow only if that is the app you are connecting, such as chatgpt.com or claude.ai.</p><p>Type the code shown in WireCat Desktop, or in the terminal where the server runs. If you did not start this login, close this page.</p>${message ? `<p class="error">${escapeHtml(message)}</p>` : ""}<form method="post" action="${escapeHtml(`${base}/authorize`)}">${hidden}<label>Login code<input type="text" name="login_code" autocomplete="off" autofocus required></label><button type="submit">Allow</button></form></body></html>`;
+        const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapeHtml(appName)} login</title><style>body{font:16px system-ui,sans-serif;max-width:28rem;margin:3rem auto;padding:0 1rem;color:#1d2430}input[type=text]{font:20px ui-monospace,monospace;letter-spacing:.1em;width:100%;padding:.5rem;margin:.5rem 0 1rem;box-sizing:border-box}button{font:inherit;padding:.5rem 1rem}.error{color:#b42318}</style></head><body><h1>${escapeHtml(appName)}</h1><p>An app that calls itself <strong>${who}</strong> asks to reach ${escapeHtml(reaches)} through <code>${escapeHtml(appName)} mcp serve --http</code>.</p><p>After you allow it, the login goes to <strong>${escapeHtml(target.host)}</strong>. Allow only if that is the app you are connecting, such as chatgpt.com or claude.ai.</p><p>Type the code shown in WireCat Desktop, or in the terminal where the server runs. If you did not start this login, close this page.</p>${message ? `<p class="error">${escapeHtml(message)}</p>` : ""}<form method="post" action="${escapeHtml(`${base}/authorize`)}">${hidden}<label>Login code<input type="text" name="login_code" autocomplete="off" autofocus required></label><button type="submit">Allow</button></form></body></html>`;
         return new Response(html, {
             status: message ? 400 : 200,
             headers: {

package/dist/mcp/http/serve.d.ts

@@ -13,6 +13,8 @@ export interface HttpOptions {
     /** Where the hashes of issued tokens and registered clients are kept. */
     tokenFile: string;
     appName: string;
+    /** What the browser login page says an app asks to reach: `your messages`, `your Google Calendar`. */
+    reaches?: string;
     onCode: (code: string, expires: Date) => void;
     onError?: (error: Error) => void;
     now?: () => number;

package/dist/mcp/http/serve.js

@@ -91,7 +91,7 @@ const toolsIn = async (request) => {
  * the owner's browser cannot reach the port through a rebound DNS name.
  */
 export const serveOverHttp = async (build, options) => {
-    const { publicUrl, port, tokenFile, appName, onCode, onError, now, lockFile, version } = options;
+    const { publicUrl, port, tokenFile, appName, reaches, onCode, onError, now, lockFile, version } = options;
     const lock = lockFile
         ? httpLock(lockFile, {
             pid: process.pid,
@@ -114,6 +114,7 @@ export const serveOverHttp = async (build, options) => {
         resource,
         file: tokenFile,
         appName,
+        ...(reaches ? { reaches } : {}),
         onCode: (code, expires) => {
             lock?.update({ loginCode: code, loginCodeExpiresAt: expires.toISOString() });
             onCode(code, expires);

package/dist/mcp/meeting-preparation.d.ts

@@ -376,6 +376,9 @@ export declare const callMeetingPreparationTool: (read: MeetingPreparationReader
                     id: string;
                     excerpt: string;
                     offset_ms: number | null;
+                    language?: string | null | undefined;
+                    line?: number | undefined;
+                    lines_total?: number | undefined;
                     match?: "corrected" | "words" | undefined;
                     corrections?: {
                         from: string;

package/dist/mcp/server.js

@@ -417,6 +417,7 @@ export const serveOverHttpUntilStopped = async (command, context, messenger, opt
     const listening = await serveOverHttp(build, {
         ...http,
         appName,
+        reaches: "your messages",
         // In the background its log is a file; the code goes only to the lock that `mcp server status` reads.
         onCode: (code, expires) => context.renderer.note(context.env[mcpHttpMarker(appEnvPrefix)] === undefined
             ? `login code for a new browser app: ${code} (until ${expires.toTimeString().slice(0, 5)}; a new one after each login)`

package/dist/mcp/surface.js

@@ -46,7 +46,7 @@ const runnableOnly = (result, offered) => {
     const body = result.structuredContent;
     if (result.isError || !Array.isArray(body?.next))
         return result;
-    const next = body.next.filter((step) => offered(step.command));
+    const next = body.next.filter((step) => step.command === undefined || offered(step.command));
     const { next: _, ...rest } = body;
     const kept = next.length > 0 ? { ...rest, next } : rest;
     return {

package/dist/meetings/answers.d.ts

@@ -15,6 +15,11 @@ export declare const meetingHit: v.StrictObjectSchema<{
     readonly excerpt: v.StringSchema<undefined>;
     /** How far into the meeting the passage is. */
     readonly offset_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    /** A transcript passage's transcript language (`ru`, `en`…), `null` when unknown. */
+    readonly language: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** A transcript passage's line, from 1, of `lines_total`. */
+    readonly line: v.OptionalSchema<v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MinValueAction<number, 1, undefined>]>, undefined>;
+    readonly lines_total: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     /** `corrected`: a query word matched only a garbled form of itself, listed in `corrections`. */
     readonly match: v.OptionalSchema<v.PicklistSchema<["words", "corrected"], undefined>, undefined>;
     readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{

package/dist/meetings/answers.js

@@ -16,6 +16,11 @@ export const meetingHit = v.strictObject({
     excerpt: text,
     /** How far into the meeting the passage is. */
     offset_ms: v.nullable(count),
+    /** A transcript passage's transcript language (`ru`, `en`…), `null` when unknown. */
+    language: v.optional(v.nullable(text)),
+    /** A transcript passage's line, from 1, of `lines_total`. */
+    line: v.optional(v.pipe(count, v.minValue(1))),
+    lines_total: v.optional(count),
     /** `corrected`: a query word matched only a garbled form of itself, listed in `corrections`. */
     match: v.optional(v.picklist(["words", "corrected"])),
     corrections: v.optional(v.array(v.strictObject({ from: text, to: v.array(text) }))),
@@ -190,6 +195,9 @@ export const meetingHitItem = (hit) => ({
     id: String(hit.id),
     excerpt: hit.text,
     offset_ms: hit.startMs,
+    ...(hit.language === undefined ? {} : { language: hit.language }),
+    ...(hit.line === undefined ? {} : { line: hit.line }),
+    ...(hit.linesTotal === undefined ? {} : { lines_total: hit.linesTotal }),
     untrusted: hit.source === undefined ? ["excerpt"] : ["excerpt", "source.title"],
     ...(hit.match === undefined ? {} : { match: hit.match }),
     ...(hit.corrections === undefined ? {} : { corrections: hit.corrections }),

package/dist/meetings/cli/index.js

@@ -146,6 +146,20 @@ const addMeetingCommandsDefinition = (program, deps) => {
             throw new MeetingError("validation_error", "file account differs from selected account");
         print(await importFiles(files, deps.store, deps.now?.()), command);
     });
+    output(annotate(group.command("repair"), {
+        effects: LOCAL_WRITE,
+        output: { entity: "meeting_repair" },
+    }).description("preview filling in what older builds left out of stored transcripts (their language); --yes stores it"))
+        .option("--yes", "store the detected languages; otherwise only preview")
+        .action(async (opts, command) => {
+        if (!deps.store.fillTranscriptLanguages)
+            throw new MeetingError("configuration_error", "this store cannot fill transcript languages");
+        print(await deps.store.fillTranscriptLanguages({
+            accountId: deps.accountId,
+            apply: opts.yes === true,
+            now: deps.now?.() ?? Date.now(),
+        }), command);
+    });
     const eventList = queryWordsAfterOptions(annotate(program.command("events").description("the owner's stored events"), {
         effects: { remote: "none", local: "none" },
     }).command("list"))

package/dist/meetings/findings-rules.d.ts

@@ -1,4 +1,4 @@
-import { MEETING_FACT_TYPES as FACT_TYPES } from "./meeting-context.js";
+import { FACT_TYPES, type Payment } from "./payment.js";
 declare const TASK_TYPES: readonly ["bug", "feature", "chore"];
 export interface FindingEvidence {
     reference: string;
@@ -14,9 +14,18 @@ interface FindingBase {
 }
 export interface FactFinding extends FindingBase {
     kind: "fact";
-    type: (typeof FACT_TYPES)[number];
+    type: Exclude<(typeof FACT_TYPES)[number], "payment">;
     statement: string;
 }
+/** A payment an agent read; confirming it records a `payment` fact. A paid one supersedes the expected one. */
+export interface PaymentFinding extends FindingBase {
+    kind: "payment";
+    /** The fact's full sentence; without one, the payment's title. */
+    statement?: string;
+    payment: Payment;
+    /** The `fact:` of the expected payment this one replaces, once it is paid or cancelled. */
+    supersedes?: string;
+}
 export interface TaskFinding extends FindingBase {
     kind: "task";
     type: (typeof TASK_TYPES)[number];
@@ -28,7 +37,7 @@ export interface TaskFinding extends FindingBase {
     assignee?: string;
     assigneeEvidence?: string[];
 }
-export type Finding = FactFinding | TaskFinding;
+export type Finding = FactFinding | TaskFinding | PaymentFinding;
 export interface FindingsInput {
     schemaVersion: 1;
     key: string;
@@ -59,6 +68,8 @@ export interface FindingsRules {
     reference: (raw: string) => string;
     /** A fact finding may name no project, and any finding may name a subject. */
     anySubject?: boolean;
+    /** Payment findings are staged on a project's evidence, not from a meeting. */
+    payments?: boolean;
 }
 export declare const validateFindings: (input: FindingsInput, rules: FindingsRules) => FindingsInput;
 export declare const findingFingerprint: ({ id: _id, ...finding }: Finding) => string;

package/dist/meetings/findings-rules.js

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 import { CliError } from "@wirecat/cli-base";
-import { MEETING_FACT_TYPES as FACT_TYPES } from "./meeting-context.js";
+import { FACT_TYPES, validatePayment } from "./payment.js";
 import { meetingTimestamp } from "./timestamp.js";
 const TASK_TYPES = ["bug", "feature", "chore"];
 const invalid = (message) => {
@@ -69,12 +69,26 @@ export const validateFindings = (input, rules) => {
         };
         if (finding.kind === "fact") {
             fields(finding, ["id", "project", "subject", "evidence", "kind", "type", "statement"], rules.singular);
+            if (finding.type === "payment")
+                return invalid("a payment is a finding of kind payment");
             if (!FACT_TYPES.includes(finding.type))
                 return invalid("unknown fact finding type");
             return { ...base, kind: "fact", type: finding.type, statement: text(finding.statement, 2000) };
         }
+        if (finding.kind === "payment" && rules.payments) {
+            fields(finding, ["id", "project", "subject", "evidence", "kind", "statement", "payment", "supersedes"], rules.singular);
+            if (finding.supersedes !== undefined && !/^fact:[1-9]\d*$/.test(String(finding.supersedes)))
+                return invalid("a payment finding supersedes a fact: reference");
+            return {
+                ...base,
+                kind: "payment",
+                ...(finding.statement === undefined ? {} : { statement: text(finding.statement, 2000) }),
+                payment: validatePayment(finding.payment),
+                ...(finding.supersedes === undefined ? {} : { supersedes: finding.supersedes }),
+            };
+        }
         if (finding.kind !== "task")
-            return invalid("a finding is a fact or task");
+            return invalid(`a finding is a fact${rules.payments ? ", payment" : ""} or task`);
         fields(finding, [
             "id",
             "project",

package/dist/meetings/index.d.ts

@@ -9,17 +9,19 @@ export { entryInWindow, eventChange } from "./event-store.js";
 export { linkEvent } from "./events.js";
 export { exportMeeting, type MeetingExport, type MeetingExportFormat, type MeetingExportOptions, serializeVtt, } from "./export.js";
 export { type FindingEvidence, type FindingOutcome, findingHash, MEETING_FINDINGS_KIND, type MeetingFactFinding, type MeetingFinding, type MeetingFindingsInput, type MeetingFindingsReceipt, type MeetingTaskFinding, meetingFindingFingerprint, validateMeetingFindings, } from "./findings.js";
-export { type Finding, type FindingsInput, type FindingsReceipt, type FindingsRules, findingFingerprint, validateFindings, } from "./findings-rules.js";
+export { type Finding, type FindingsInput, type FindingsReceipt, type FindingsRules, findingFingerprint, type PaymentFinding, validateFindings, } from "./findings-rules.js";
 export { liftMeetingFields, MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQuery } from "./hit-query.js";
 export { type ImportFile, importFiles } from "./import.js";
 export { MEETING_ISSUES, MEETING_QUERY, type MeetingIssue, type MeetingItem, type MeetingOwner, meeting, meetingIssuesOf, meetingItem, } from "./item.js";
 export { joinKeyOf, joinUrlWithoutQuery } from "./join-key.js";
+export { transcriptLanguage } from "./language.js";
 export { CHAT_MESSAGES_READ, type MeetingChatLine, type MeetingChatLinesInput, type MeetingChatLinesStore, type MeetingLink, } from "./links.js";
-export { createMeetingContext, MEETING_FACT_TYPES, type MeetingContextAction, type MeetingContextChange, type MeetingContextOperation, type MeetingContextPorts, type MeetingContextReceipt, validateMeetingContextChange, } from "./meeting-context.js";
+export { createMeetingContext, type MeetingContextAction, type MeetingContextChange, type MeetingContextOperation, type MeetingContextPorts, type MeetingContextReceipt, validateMeetingContextChange, } from "./meeting-context.js";
 export { createMeetingManagement, dispatchMeetingMutation, type ManagedMeeting, type ManagedMeetingChange, type MeetingManagement, type MeetingManagementPorts, type MeetingMutationOptions, type MeetingMutationProposal, type MeetingMutationReceipt, type MeetingOperationOptions, type MeetingProviderContext, validateMeetingChange, } from "./meeting-management.js";
 export type { Attachment, ChatLine, Event, EventSeries, JsonValue, Meeting, MeetingSeries, Metadata, Occurrence, Participant, RecordTimes, SourceChatLine, SourceMeeting, Summary, SummaryContent, Transcript, TranscriptLine, TranscriptRow, } from "./model.js";
 export { type MeetingParticipantCandidate, type MeetingParticipantPage, type MeetingParticipantReader, type MeetingParticipantSearchOptions, type MeetingParticipantSearchStore, normalizeMeetingParticipantQuery, validateMeetingParticipantSearch, } from "./participant-search.js";
 export { type MeetingContextCue, type MeetingHitContextOptions, type MeetingHitContextPacket, type MeetingPassageOutputFormat, type MeetingPassageReader, type MeetingPassageRequest, type MeetingPassageResult, meetingHitContextLimits, validateMeetingPassage, } from "./passage.js";
+export { FACT_TYPES, PAYMENT_DIRECTIONS, PAYMENT_STATES, type Payment, paymentTitle, validatePayment, } from "./payment.js";
 export { type MeetingPreparationContext, type MeetingPreparationContextRequest, type MeetingPreparationContextStore, type PreparationPage, validateMeetingPreparationContext, } from "./preparation-context.js";
 export type { MeetingPreparationFact, MeetingPreparationKnowledgeRequest, MeetingPreparationKnowledgeStore, } from "./preparation-knowledge.js";
 export type { MeetingPreparationNote, MeetingPreparationNotesSelection, MeetingPreparationNotesStore, } from "./preparation-notes.js";
@@ -50,7 +52,7 @@ export type { MeetingSeriesCandidate, MeetingSeriesInventoryPage, MeetingSeriesI
 export { validateMeetingSeriesInventoryCursor } from "./series-inventory-validation.js";
 export type { MeetingSource, SourceParticipant } from "./source.js";
 export { aggregateMeetingStats, type MeetingSpeakerStats, type MeetingStats, type MeetingStatsInput, type MeetingStatsRow, type MeetingStatsSelection, type MeetingStatsStore, type MeetingWeekStats, } from "./stats.js";
-export type { ChatInput, ContractCase, EventCandidateFilter, IdentityInput, MeetingDetails, MeetingFilter, MeetingHitSource, MeetingInput, MeetingSave, MeetingStore, NewRecord, ParticipantInput, SearchHit, TranscriptInput, TranscriptRowInput, } from "./store.js";
+export type { ChatInput, ContractCase, EventCandidateFilter, IdentityInput, MeetingDetails, MeetingFilter, MeetingHitSource, MeetingInput, MeetingSave, MeetingStore, NewRecord, ParticipantInput, SearchHit, TranscriptInput, TranscriptLanguageFill, TranscriptRowInput, } from "./store.js";
 export type { MeetingTranscriptReceiptStore, MeetingTranscriptStore, TranscriptAppend, TranscriptAppendReceipt, UnlinkedTranscriptInput, } from "./transcript-store.js";
 export { parseTranscriptText, TranscriptTextError, type TranscriptTextHeader } from "./transcript-text.js";
 export { type MeetingMediaDescriptor, type MeetingRecognitionSegment, type MeetingTranscriptionContext, type MeetingTranscriptionOptions, type MeetingTranscriptionReceipt, type MeetingTranscriptionSource, transcribeMeeting, } from "./transcription.js";

package/dist/meetings/index.js

@@ -11,11 +11,13 @@ export { liftMeetingFields, MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQu
 export { importFiles } from "./import.js";
 export { MEETING_ISSUES, MEETING_QUERY, meeting, meetingIssuesOf, meetingItem, } from "./item.js";
 export { joinKeyOf, joinUrlWithoutQuery } from "./join-key.js";
+export { transcriptLanguage } from "./language.js";
 export { CHAT_MESSAGES_READ, } from "./links.js";
-export { createMeetingContext, MEETING_FACT_TYPES, validateMeetingContextChange, } from "./meeting-context.js";
+export { createMeetingContext, validateMeetingContextChange, } from "./meeting-context.js";
 export { createMeetingManagement, dispatchMeetingMutation, validateMeetingChange, } from "./meeting-management.js";
 export { normalizeMeetingParticipantQuery, validateMeetingParticipantSearch, } from "./participant-search.js";
 export { meetingHitContextLimits, validateMeetingPassage, } from "./passage.js";
+export { FACT_TYPES, PAYMENT_DIRECTIONS, PAYMENT_STATES, paymentTitle, validatePayment, } from "./payment.js";
 export { validateMeetingPreparationContext, } from "./preparation-context.js";
 export { readMeetingProjectEvidence } from "./project-evidence.js";
 export { meetingProjectEvidence, meetingProjectEvidenceAnswer, } from "./project-evidence-answer.js";

package/dist/meetings/ingest.js

@@ -1,3 +1,4 @@
+import { transcriptLanguage } from "./language.js";
 export const contentHash = async (text) => {
     const bytes = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(text));
     return Array.from(new Uint8Array(bytes), (byte) => byte.toString(16).padStart(2, "0")).join("");
@@ -11,7 +12,7 @@ export const speakerPosition = (name, participants) => {
 export const transcriptInput = async (lines, participants, source, hashText = JSON.stringify(lines), format = null) => ({
     source,
     format,
-    language: null,
+    language: transcriptLanguage(lines.map((line) => line.text)),
     contentHash: await contentHash(hashText),
     externalCreatedAt: null,
     metadata: null,

package/dist/meetings/language.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The language most of a transcript is in, from its letters: Cyrillic is Russian (Ukrainian when its own letters
+ * show), Latin is decided by frequent words. `null` when the text is too short, mixed, or in neither script.
+ */
+export declare const transcriptLanguage: (texts: Iterable<string>) => string | null;

package/dist/meetings/language.js

@@ -0,0 +1,57 @@
+/**
+ * Words frequent in one Latin-script language and rare in the others here. Letters alone cannot tell Spanish from
+ * English, and calling a Spanish meeting English is worse than calling it nothing.
+ */
+const LATIN_WORDS = {
+    en: ["the", "and", "is", "that", "you", "this", "what", "have", "with", "are"],
+    es: ["el", "los", "las", "por", "pero", "para", "está", "muy", "también", "hay"],
+    de: ["der", "und", "ist", "nicht", "das", "ich", "wir", "mit", "auch", "ein"],
+    fr: ["le", "les", "est", "une", "pas", "je", "vous", "nous", "avec", "mais"],
+    it: ["gli", "della", "sono", "perché", "anche", "questo", "molto", "che", "di", "è"],
+    pt: ["não", "você", "isso", "muito", "então", "com", "uma", "também", "mas", "eu"],
+};
+const LATIN_LANGUAGE = new Map(Object.entries(LATIN_WORDS).flatMap(([language, words]) => words.map((word) => [word, language])));
+/** Letters Ukrainian writes and Russian does not. */
+const UKRAINIAN = /[іїєґ]/giu;
+const CYRILLIC = /\p{Script=Cyrillic}/gu;
+const LATIN = /\p{Script=Latin}/gu;
+const MIN_LETTERS = 20;
+/** A meeting in one language keeps a few lines of another; a share below this is a mixed meeting. */
+const DOMINANT = 0.75;
+const countOf = (text, pattern) => text.match(pattern)?.length ?? 0;
+const latinLanguage = (texts) => {
+    const votes = new Map();
+    for (const text of texts)
+        for (const word of text.toLowerCase().split(/[^\p{L}]+/u)) {
+            const language = LATIN_LANGUAGE.get(word);
+            if (language)
+                votes.set(language, (votes.get(language) ?? 0) + 1);
+        }
+    const [first, second] = [...votes].sort((a, b) => b[1] - a[1]);
+    if (!first || first[1] < 3 || (second && first[1] < 2 * second[1]))
+        return null;
+    return first[0];
+};
+/**
+ * The language most of a transcript is in, from its letters: Cyrillic is Russian (Ukrainian when its own letters
+ * show), Latin is decided by frequent words. `null` when the text is too short, mixed, or in neither script.
+ */
+export const transcriptLanguage = (texts) => {
+    const all = [...texts];
+    let cyrillic = 0;
+    let latin = 0;
+    let ukrainian = 0;
+    for (const text of all) {
+        cyrillic += countOf(text, CYRILLIC);
+        latin += countOf(text, LATIN);
+        ukrainian += countOf(text, UKRAINIAN);
+    }
+    const letters = cyrillic + latin;
+    if (letters < MIN_LETTERS)
+        return null;
+    if (cyrillic / letters >= DOMINANT)
+        return ukrainian / cyrillic >= 0.01 ? "uk" : "ru";
+    if (latin / letters >= DOMINANT)
+        return latinLanguage(all);
+    return null;
+};

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

@@ -139,6 +139,9 @@ export declare const callMeetingSearchTool: (search: MeetingHitSearch, input: un
         id: string;
         excerpt: string;
         offset_ms: number | null;
+        language?: string | null | undefined;
+        line?: number | undefined;
+        lines_total?: number | undefined;
         match?: "corrected" | "words" | undefined;
         corrections?: {
             from: string;

package/dist/meetings/meeting-context.d.ts

@@ -1,7 +1,6 @@
 import { type MeetingMutationOptions } from "./meeting-management.js";
+import { FACT_TYPES } from "./payment.js";
 import { type MeetingProviderScope } from "./provider.js";
-/** Mirrors the store's fact types; the store checks the type again when it writes. */
-export declare const MEETING_FACT_TYPES: readonly ["fact", "statement", "question", "decision", "promise"];
 export type MeetingContextChange = {
     action: "note.add";
     text: string;
@@ -19,7 +18,7 @@ export type MeetingContextChange = {
 } | {
     action: "fact.add";
     statement: string;
-    type: (typeof MEETING_FACT_TYPES)[number];
+    type: (typeof FACT_TYPES)[number];
     scope: "personal" | "work";
     evidence: readonly string[];
     subject?: string;

package/dist/meetings/meeting-context.js

@@ -1,8 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { dispatchMeetingMutation } from "./meeting-management.js";
+import { FACT_TYPES } from "./payment.js";
 import { snapshotMeetingScope } from "./provider.js";
-/** Mirrors the store's fact types; the store checks the type again when it writes. */
-export const MEETING_FACT_TYPES = ["fact", "statement", "question", "decision", "promise"];
 const id = (value) => {
     if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1)
         throw new CliError("validation_error", "meeting context identifiers must be positive integers");
@@ -63,8 +62,8 @@ export const validateMeetingContextChange = (change) => {
             });
         }
         case "fact.add": {
-            if (!MEETING_FACT_TYPES.includes(change.type) || !["personal", "work"].includes(change.scope))
-                throw new CliError("validation_error", `fact type (${MEETING_FACT_TYPES.join(", ")}) and explicit personal/work scope are required`);
+            if (!FACT_TYPES.includes(change.type) || !["personal", "work"].includes(change.scope))
+                throw new CliError("validation_error", `fact type (${FACT_TYPES.join(", ")}) and explicit personal/work scope are required`);
             return Object.freeze({
                 action: change.action,
                 statement: text(change.statement, 20_000),

package/dist/meetings/payment.d.ts

@@ -0,0 +1,27 @@
+/** Every fact type the store takes; findings and meeting changes check against the same list. */
+export declare const FACT_TYPES: readonly ["fact", "statement", "question", "decision", "promise", "payment"];
+export declare const PAYMENT_DIRECTIONS: readonly ["to_us", "from_us"];
+export declare const PAYMENT_STATES: readonly ["expected", "paid", "cancelled"];
+/** A payment fact's fields, kept in `facts.metadata.payment`. */
+export interface Payment {
+    /** A decimal as text with two places, "50000.00": money is never a float. */
+    amount: string;
+    /** ISO 4217, "RUB". */
+    currency: string;
+    direction: (typeof PAYMENT_DIRECTIONS)[number];
+    /** `person:`, `organization:` or `project:`; `null` when only a name is known. */
+    counterparty: string | null;
+    counterparty_name: string | null;
+    /** An ISO date. */
+    due_at: string | null;
+    /** A change of state is a new fact that supersedes this one, so the history and its evidence stay. */
+    state: (typeof PAYMENT_STATES)[number];
+    /** What it is for, short: "support, September". The fact's statement is the full sentence. */
+    item: string | null;
+}
+/** A payment as stored: the amount with two decimals, the currency upper case; refuses what is not one. */
+export declare const validatePayment: (input: unknown) => Payment;
+/** One line for a payment, as a list or an inbox shows it: "1 200 EUR to us from Ana, due 31.10 (expected)". */
+export declare const paymentTitle: (fact: {
+    payment: Payment | null;
+}) => string;

package/dist/meetings/payment.js

@@ -0,0 +1,81 @@
+import { CliError } from "@wirecat/cli-base";
+/** Every fact type the store takes; findings and meeting changes check against the same list. */
+export const FACT_TYPES = ["fact", "statement", "question", "decision", "promise", "payment"];
+export const PAYMENT_DIRECTIONS = ["to_us", "from_us"];
+export const PAYMENT_STATES = ["expected", "paid", "cancelled"];
+const invalid = (message) => {
+    throw new CliError("validation_error", message);
+};
+const CURRENCIES = new Set(Intl.supportedValuesOf("currency"));
+const AMOUNT = /^(\d{1,15})(?:\.(\d{1,2}))?$/;
+const COUNTERPARTY = /^(person|organization|project):[1-9]\d*$/;
+const amountOf = (value) => {
+    const match = AMOUNT.exec(typeof value === "number" ? String(value) : typeof value === "string" ? value.trim() : "");
+    if (!match)
+        return invalid("a payment's amount is a positive number with at most 2 decimals, such as 1200.50");
+    const amount = `${BigInt(match[1] ?? "0")}.${(match[2] ?? "").padEnd(2, "0")}`;
+    if (amount === "0.00")
+        return invalid("a payment's amount is more than 0");
+    return amount;
+};
+const dateOf = (value) => {
+    const date = typeof value === "string" ? value.trim() : "";
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(date) || new Date(`${date}T00:00:00Z`).toISOString().slice(0, 10) !== date)
+        return invalid("a payment's due date is an ISO date, such as 2026-10-31");
+    return date;
+};
+const optionalText = (value, what, limit) => {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== "string" || !value.trim() || value.length > limit || value.includes("\0"))
+        return invalid(`a payment's ${what} takes 1–${limit} characters`);
+    return value.trim();
+};
+const oneOf = (value, allowed, what) => {
+    if (typeof value !== "string" || !allowed.includes(value))
+        return invalid(`a payment's ${what} is one of ${allowed.join(", ")}`);
+    return value;
+};
+const FIELDS = ["amount", "currency", "direction", "counterparty", "counterparty_name", "due_at", "state", "item"];
+/** A payment as stored: the amount with two decimals, the currency upper case; refuses what is not one. */
+export const validatePayment = (input) => {
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        return invalid("a payment is an object");
+    const raw = input;
+    const unknown = Object.keys(raw).filter((key) => !FIELDS.includes(key));
+    if (unknown.length)
+        return invalid(`a payment has no field ${unknown.join(", ")}; its fields are ${FIELDS.join(", ")}`);
+    const currency = typeof raw.currency === "string" ? raw.currency.trim().toUpperCase() : "";
+    if (!/^[A-Z]{3}$/.test(currency) || !CURRENCIES.has(currency))
+        return invalid("a payment's currency is an ISO 4217 code, such as EUR or RUB");
+    const counterparty = optionalText(raw.counterparty, "counterparty", 80);
+    if (counterparty !== null && !COUNTERPARTY.test(counterparty))
+        return invalid("a payment's counterparty is a person:, organization: or project: reference");
+    return {
+        amount: amountOf(raw.amount),
+        currency,
+        direction: oneOf(raw.direction, PAYMENT_DIRECTIONS, "direction"),
+        counterparty,
+        counterparty_name: optionalText(raw.counterparty_name, "counterparty name", 200),
+        due_at: raw.due_at === undefined || raw.due_at === null ? null : dateOf(raw.due_at),
+        state: oneOf(raw.state, PAYMENT_STATES, "state"),
+        item: optionalText(raw.item, "item", 200),
+    };
+};
+const grouped = (amount) => {
+    const [whole = "0", cents = "00"] = amount.split(".");
+    const digits = whole.replace(/\B(?=(\d{3})+(?!\d))/g, " ");
+    return cents === "00" ? digits : `${digits}.${cents}`;
+};
+/** One line for a payment, as a list or an inbox shows it: "1 200 EUR to us from Ana, due 31.10 (expected)". */
+export const paymentTitle = (fact) => {
+    const payment = fact.payment;
+    if (!payment)
+        return "";
+    const who = payment.counterparty_name ?? payment.counterparty;
+    const way = payment.direction === "to_us" ? "to us" : "from us";
+    const party = who === null ? "" : payment.direction === "to_us" ? ` from ${who}` : ` to ${who}`;
+    const due = payment.due_at === null ? "" : `, due ${payment.due_at.slice(8, 10)}.${payment.due_at.slice(5, 7)}`;
+    const item = payment.item === null ? "" : ` for ${payment.item}`;
+    return `${grouped(payment.amount)} ${payment.currency} ${way}${party}${item}${due} (${payment.state})`;
+};