@wirecat/cli-core 0.378.0 → 0.380.0

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

@@ -376,6 +376,11 @@ export declare const callMeetingPreparationTool: (read: MeetingPreparationReader
                     id: string;
                     excerpt: string;
                     offset_ms: number | null;
+                    match?: "corrected" | "words" | undefined;
+                    corrections?: {
+                        from: string;
+                        to: string[];
+                    }[] | undefined;
                     source?: {
                         ref: string;
                         title: string | null;

package/dist/mcp/tools/stats.js

@@ -7,7 +7,7 @@ import { chartRenderer } from "../../charts/render.js";
 import { sealed } from "../../cli/envelope.js";
 import { chartAnswer } from "../../cli/messenger/stats-answers.js";
 import { servicesFor, storedDeps } from "../../services/index.js";
-import { momentOf } from "../../services/moment.js";
+import { dateWindow } from "../../services/moment.js";
 import { chatOf, Picture, READ, tool } from "../tool.js";
 export const statsTools = (messenger) => ({
     stats_charts: tool({
@@ -29,16 +29,21 @@ export const statsTools = (messenger) => ({
         stored: async (store, account, args, defaults) => {
             const timezone = timezoneOf(args.timezone);
             const by = args.by ?? "day";
+            const window = dateWindow({
+                ...(args.since_time === undefined ? {} : { sinceTime: args.since_time }),
+                zone: timezone,
+                names: ["since_time", "until_time"],
+            });
             const stats = await servicesFor(storedDeps(messenger, store, account, defaults.guard)).chats.stats(args.chat, {
                 by,
                 timezone,
-                ...(args.since_time === undefined ? {} : { since: momentOf(args.since_time, "since_time") }),
+                ...(window.since === undefined ? {} : { since: window.since }),
             });
             const chart = chatChart(stats, { kind: args.chart_kind ?? "messages", by, timezone });
             if (args.format !== "png")
-                return chartAnswer(chart);
+                return chartAnswer(chart, undefined, window.meta);
             const image = await chartPng(await (await chartRenderer()).render(chart, CHART_SIZE));
-            return new Picture(image.bytes, image.mimeType, sealed(chartAnswer(chart)));
+            return new Picture(image.bytes, image.mimeType, sealed(chartAnswer(chart, undefined, window.meta)));
         },
     }),
 });

package/dist/meetings/answers.d.ts

@@ -15,10 +15,16 @@ 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>;
+    /** `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<{
+        readonly from: v.StringSchema<undefined>;
+        readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
     readonly source: v.OptionalSchema<v.StrictObjectSchema<{
         readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
         readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-        readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+        readonly started_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 url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>, undefined>;
 }, undefined>;
@@ -29,8 +35,8 @@ export declare const meetingTranscript: v.StrictObjectSchema<{
     readonly source: v.StringSchema<undefined>;
     readonly language: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     /** When a newer transcript of the same source replaced it; `meetings transcript --history` shows those too. */
-    readonly superseded_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
-    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+    readonly superseded_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 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 lines: v.ArraySchema<v.StrictObjectSchema<{
         readonly position: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
         readonly offset_ms: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -53,8 +59,8 @@ export declare const meetingSummary: v.StrictObjectSchema<{
     readonly next_steps: v.ArraySchema<v.StringSchema<undefined>, undefined>;
     readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
-    readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+    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>;
 /** `meetings show`: the meeting with who took part, what was said in its chat, and what it holds. */
 export declare const meetingDetails: v.StrictObjectSchema<{
@@ -66,13 +72,13 @@ export declare const meetingDetails: v.StrictObjectSchema<{
     readonly description: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly location: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
-    readonly ended_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+    readonly started_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 ended_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 duration_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly timezone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
-    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
-    readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
+    readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>;
     /** The stored event and series it belongs to, as `meetings_list` takes them. */
     readonly event_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     readonly series_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
@@ -81,8 +87,8 @@ export declare const meetingDetails: v.StrictObjectSchema<{
         readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly email: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly role: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-        readonly joined_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
-        readonly left_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+        readonly joined_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 left_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 duration_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     }, undefined>, undefined>;
     readonly transcripts: v.ArraySchema<v.StrictObjectSchema<{
@@ -92,7 +98,7 @@ export declare const meetingDetails: v.StrictObjectSchema<{
         readonly lines_count: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
     }, undefined>, undefined>;
     readonly chat: v.ArraySchema<v.StrictObjectSchema<{
-        readonly sent_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+        readonly sent_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 sender: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly recipient: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly text: v.StringSchema<undefined>;
@@ -110,8 +116,8 @@ export declare const meetingDetails: v.StrictObjectSchema<{
         readonly next_steps: v.ArraySchema<v.StringSchema<undefined>, undefined>;
         readonly content: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-        readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
-        readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+        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>, undefined>;
     readonly attachments: v.ArraySchema<v.StrictObjectSchema<{
         readonly position: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;

package/dist/meetings/answers.js

@@ -16,6 +16,9 @@ export const meetingHit = v.strictObject({
     excerpt: text,
     /** How far into the meeting the passage is. */
     offset_ms: v.nullable(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) }))),
     source: v.optional(v.strictObject({
         ref: reference,
         title: v.nullable(text),
@@ -185,6 +188,8 @@ export const meetingHitItem = (hit) => ({
     id: String(hit.id),
     excerpt: hit.text,
     offset_ms: hit.startMs,
+    ...(hit.match === undefined ? {} : { match: hit.match }),
+    ...(hit.corrections === undefined ? {} : { corrections: hit.corrections }),
     ...(hit.source === undefined
         ? {}
         : {

package/dist/meetings/cli/index.d.ts

@@ -7,6 +7,8 @@ export interface MeetingCommandDeps {
     accountId: number;
     source?: MeetingSource;
     readFiles?: (folder: string) => Promise<ImportFile[]>;
+    /** The host's file names and how it reads their time, shown in `meetings import --help`. */
+    importHelp?: string;
     writeFile?: (path: string, content: string) => Promise<void>;
     write: (value: unknown, format: "json" | "jsonl" | "text") => void;
     now?: () => number;

package/dist/meetings/cli/index.js

@@ -1,5 +1,5 @@
 import { annotate } from "@wirecat/cli-base/commands";
-import { defineQuery, fieldsHelp } from "@wirecat/cli-base/query";
+import { defineQuery, fieldsHelp, timezoneOf, zonedMoment } from "@wirecat/cli-base/query";
 import { InvalidArgumentError, Option } from "commander";
 import { exportMeeting } from "../export.js";
 import { importFiles } from "../import.js";
@@ -19,9 +19,12 @@ const lookbackDays = (text) => {
     return Number(text);
 };
 const date = (text) => {
-    if (!Number.isFinite(Date.parse(text)))
-        throw new InvalidArgumentError("expected an ISO date or timestamp");
-    return Date.parse(text);
+    try {
+        return zonedMoment(text, timezoneOf(), { start: 0, end: text.length });
+    }
+    catch {
+        throw new InvalidArgumentError("expected an ISO date, or a time with or without an offset");
+    }
 };
 const LOCAL_READ = { remote: "none", local: "read" };
 const LOCAL_WRITE = { remote: "none", local: "write" };
@@ -119,9 +122,12 @@ export const addMeetingCommands = (program, deps) => {
             lookbackMs: opts.lookbackDays * 86400000,
         }), command);
     });
-    output(annotate(group.command("import"), { effects: LOCAL_WRITE })
+    const importCommand = annotate(group.command("import"), { effects: LOCAL_WRITE })
         .description("import downloaded meeting transcripts")
-        .argument("<folder>", "folder of transcripts downloaded from the provider")).action(async (folder, _opts, command) => {
+        .argument("<folder>", "folder of transcripts downloaded from the provider");
+    if (deps.importHelp)
+        importCommand.addHelpText("after", `\n${deps.importHelp}`);
+    output(importCommand).action(async (folder, _opts, command) => {
         if (!deps.readFiles)
             throw new MeetingError("configuration_error", "file reader is unavailable");
         const files = await deps.readFiles(folder);

package/dist/meetings/cli/search.js

@@ -1,25 +1,23 @@
 import { CliError } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
+import { timezoneOf, zonedMoment } from "@wirecat/cli-base/query";
 import { Command } from "commander";
 import { meetingHitsList } from "../answers.js";
 import { validateMeetingHitSearch } from "../search-validation.js";
 export { validateMeetingHitSearch } from "../search-validation.js";
+const moment = (flag, end) => (value) => {
+    try {
+        return zonedMoment(value, timezoneOf(), { start: 0, end: value.length }, { end });
+    }
+    catch {
+        throw new CliError("validation_error", `${flag} takes an ISO date, or a time with or without an offset`);
+    }
+};
 const integer = (value) => {
     if (!/^[1-9]\d*$/.test(value) || !Number.isSafeInteger(Number(value)))
         throw new CliError("validation_error", "expected a positive safe integer");
     return Number(value);
 };
-const timestamp = (value) => {
-    const parsed = Date.parse(value);
-    const date = value.slice(0, 10);
-    const day = Date.parse(`${date}T00:00:00Z`);
-    if (!/^\d{4}-\d{2}-\d{2}(?:T.+(?:Z|[+-]\d{2}:\d{2}))?$/.test(value) ||
-        !Number.isFinite(parsed) ||
-        !Number.isFinite(day) ||
-        new Date(day).toISOString().slice(0, 10) !== date)
-        throw new CliError("validation_error", "meeting search dates require a real ISO date or timestamp with offset");
-    return parsed;
-};
 /** Shared grammar without an action: a host with other source reports supplies their transport routing. */
 export const createMeetingSearchCommand = (program) => {
     let search = program.commands.find((command) => command.name() === "search");
@@ -30,7 +28,7 @@ export const createMeetingSearchCommand = (program) => {
     const command = search
         .command("meetings")
         .description("find words in stored meetings, indexing new ones first")
-        .argument("<query>", "words to find; each also matches its other word forms")
+        .argument("<query>", 'words, OR, (groups), -word, "a phrase", "a b"~N (within N lines), exact:word, from:"Name" (who said the line); a word also matches its other forms and spellings speech recognition garbled')
         .option("--meeting-id <id>", "only this stored meeting", integer)
         .option("--identity-id <id>", "meetings with this participant identity; does not say who spoke a hit", integer)
         .option("--person-id <id>", "meetings with a participant linked to this person", integer)
@@ -39,8 +37,8 @@ export const createMeetingSearchCommand = (program) => {
         .option("--project <name>", "meetings confirmed in this project, by name, key or alias")
         .option("--tag <name>", "meetings with this tag, by name or alias")
         .option("--topic <name>", "meetings with this topic, by name or alias")
-        .option("--since-time <time>", "meetings starting at or after this ISO 8601 date or time", timestamp)
-        .option("--until-time <time>", "meetings starting at or before this ISO 8601 date or time", timestamp)
+        .option("--since-time <time>", "meetings starting at or after this ISO 8601 date or time", moment("--since-time", false))
+        .option("--until-time <time>", "meetings starting at or before this ISO 8601 date or time; a date alone covers that whole local day", moment("--until-time", true))
         .option("--limit <n>", "how many hits, 1 through 1000 (default 100)", integer)
         .option("--cursor <cursor>", "continue from the previous page's page.next_cursor, with the same query and filters")
         .option("--max-read-bytes <bytes>", "most stored bytes to read, 1 through 67108864 (default 4194304)", integer);

package/dist/meetings/hit-query.d.ts

@@ -0,0 +1,12 @@
+import { type QueryAst } from "@wirecat/cli-base/query";
+/** A transcript line holds a sentence or two; further than this is a different part of the meeting. */
+export declare const MOST_LINES_APART = 20;
+/** The messages query language over meeting text: the same fields, a narrower set of operators. */
+export declare const MEETING_HIT_QUERY: import("@wirecat/cli-base/query").QueryRegistry;
+/** What a person typed: the CLI, MCP and batch queries. */
+export declare const parseMeetingQuery: (query: string) => QueryAst;
+/**
+ * Words from a name or a note, never parsed: a project called «C++ (beta)» must not become syntax. Each word is
+ * required, in any form.
+ */
+export declare const meetingWordsQuery: (text: string) => QueryAst;

package/dist/meetings/hit-query.js

@@ -0,0 +1,58 @@
+import { defineQuery, parseLucene, queryError, validateQuery, } from "@wirecat/cli-base/query";
+const context = {
+    command: "search meetings",
+    guide: "https://github.com/WireCatLabs/cli-core/blob/main/docs/search/query-language.md#встречи",
+};
+const words = ["term", "phrase"];
+/** A transcript line holds a sentence or two; further than this is a different part of the meeting. */
+export const MOST_LINES_APART = 20;
+const near = (node) => {
+    if (node.slop !== undefined && node.slop > MOST_LINES_APART)
+        queryError("query.invalid-number", node.span, `words at most ${MOST_LINES_APART} lines apart: "a b"~${MOST_LINES_APART}`, context);
+};
+/** The messages query language over meeting text: the same fields, a narrower set of operators. */
+export const MEETING_HIT_QUERY = defineQuery({
+    entity: "meeting_hit",
+    backend: "sql",
+    fields: [
+        {
+            name: "text",
+            type: "txt",
+            operators: words,
+            example: "text:budget",
+            relation: "a passage with the word in any form, or a spelling speech recognition garbled",
+            validate: near,
+        },
+        {
+            name: "exact",
+            type: "txt",
+            operators: words,
+            example: "exact:budget",
+            relation: "a passage with the word as typed: no other forms, no garbled spellings",
+            validate: near,
+        },
+        {
+            name: "from",
+            type: "kw",
+            operators: words,
+            example: 'from:"Alice Synthetic"',
+            relation: "a line said or a chat message written by this person; attendance is --identity-id",
+        },
+    ],
+});
+/** What a person typed: the CLI, MCP and batch queries. */
+export const parseMeetingQuery = (query) => validateQuery(parseLucene(query, { defaultField: "text", proximity: true, ...context }), MEETING_HIT_QUERY, context);
+/**
+ * Words from a name or a note, never parsed: a project called «C++ (beta)» must not become syntax. Each word is
+ * required, in any form.
+ */
+export const meetingWordsQuery = (text) => {
+    const found = text.match(/[\p{L}\p{N}\p{M}]+/gu) ?? [];
+    const span = { start: 0, end: text.length };
+    const clauses = found.map((value) => ({
+        occur: "must",
+        node: { kind: "predicate", field: "text", operator: "term", value, span },
+    }));
+    const root = clauses.length === 1 && clauses[0] ? clauses[0].node : { kind: "boolean", clauses, span };
+    return { version: 1, language: "lucene-v1", root };
+};

package/dist/meetings/import.d.ts

@@ -5,6 +5,8 @@ export interface ImportFile {
     content: string;
     participants?: ParticipantInput[];
     source?: string;
+    /** `vtt` (the default) or `text`, the form `parseTranscriptText` reads. */
+    format?: "vtt" | "text";
 }
 /** The caller reads files and supplies provider-neutral occurrence metadata. */
 export declare const importFiles: (files: ImportFile[], store: MeetingStore, now?: number) => Promise<RunReport>;

package/dist/meetings/import.js

@@ -1,17 +1,19 @@
 import { linkEvent } from "./events.js";
 import { transcriptInput } from "./ingest.js";
+import { parseTranscriptText } from "./transcript-text.js";
 import { parseVtt } from "./vtt.js";
 /** The caller reads files and supplies provider-neutral occurrence metadata. */
 export const importFiles = async (files, store, now = Date.now()) => {
     const report = { meetings: 0, participants: 0, transcriptRows: 0, summaries: 0, warnings: [] };
     for (const file of files) {
         try {
-            const lines = parseVtt(file.content);
+            const format = file.format ?? "vtt";
+            const lines = format === "text" ? parseTranscriptText(file.content).lines : parseVtt(file.content);
             const participants = file.participants ?? [];
             const details = await store.saveMeeting({
                 meeting: file.meeting,
                 participants: file.participants,
-                transcripts: [await transcriptInput(lines, participants, file.source ?? "file", file.content, "vtt")],
+                transcripts: [await transcriptInput(lines, participants, file.source ?? "file", file.content, format)],
                 now,
             });
             await linkEvent(store, details, now);
@@ -26,5 +28,9 @@ export const importFiles = async (files, store, now = Date.now()) => {
             });
         }
     }
+    const zones = new Set(files.map((file) => file.meeting.timezone).filter((zone) => zone !== null && zone !== undefined));
+    const [zone] = zones;
+    if (zones.size === 1 && zone)
+        report.timezone = zone;
     return report;
 };

package/dist/meetings/index.d.ts

@@ -6,6 +6,7 @@ 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 { MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQuery } from "./hit-query.js";
 export { type ImportFile, importFiles } from "./import.js";
 export { MEETING_QUERY, type MeetingItem, type MeetingOwner, meeting, meetingItem } from "./item.js";
 export { createMeetingContext, MEETING_FACT_TYPES, type MeetingContextAction, type MeetingContextChange, type MeetingContextOperation, type MeetingContextPorts, type MeetingContextReceipt, validateMeetingContextChange, } from "./meeting-context.js";
@@ -41,6 +42,7 @@ export { validateMeetingSeriesInventoryCursor } from "./series-inventory-validat
 export type { MeetingSource, SourceParticipant } from "./source.js";
 export type { ChatInput, ContractCase, EventCandidateFilter, IdentityInput, MeetingDetails, MeetingFilter, MeetingHitSource, MeetingInput, MeetingSave, MeetingStore, NewRecord, ParticipantInput, SearchHit, TranscriptInput, 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";
 export { createUpcomingMeetingReader } from "./upcoming.js";
 export type { MeetingOccurrence, MeetingOccurrencePort, MeetingOccurrenceRead, MeetingOccurrenceSchedule, UpcomingMeetingRequest, UpcomingMeetingResult, } from "./upcoming-types.js";

package/dist/meetings/index.js

@@ -4,6 +4,7 @@ export { linkEvent } from "./events.js";
 export { exportMeeting, serializeVtt, } from "./export.js";
 export { findingHash, MEETING_FINDINGS_KIND, meetingFindingFingerprint, validateMeetingFindings, } from "./findings.js";
 export { findingFingerprint, validateFindings, } from "./findings-rules.js";
+export { MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQuery } from "./hit-query.js";
 export { importFiles } from "./import.js";
 export { MEETING_QUERY, meeting, meetingItem } from "./item.js";
 export { createMeetingContext, MEETING_FACT_TYPES, validateMeetingContextChange, } from "./meeting-context.js";
@@ -27,6 +28,7 @@ export { validateMeetingHitSearch } from "./search-validation.js";
 export { validateMeetingSeriesHistory, } from "./series-history.js";
 export { createMeetingSeriesInventoryReader } from "./series-inventory.js";
 export { validateMeetingSeriesInventoryCursor } from "./series-inventory-validation.js";
+export { parseTranscriptText, TranscriptTextError } from "./transcript-text.js";
 export { transcribeMeeting, } from "./transcription.js";
 export { createUpcomingMeetingReader } from "./upcoming.js";
 export { parseVtt, VttError } from "./vtt.js";

package/dist/meetings/item.d.ts

@@ -11,13 +11,13 @@ export declare const meeting: v.StrictObjectSchema<{
     readonly location: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     /** The link that joins it. */
     readonly url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
-    readonly ended_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+    readonly started_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 ended_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 duration_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly timezone: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
-    readonly created_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
-    readonly updated_at: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>;
+    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>;
 export type MeetingItem = v.InferOutput<typeof meeting>;
 /** Which provider and account a stored meeting account is, as `MeetingStore.account` answers it. */

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

@@ -15,6 +15,7 @@ export declare const meetingSearchTool: {
             query: {
                 type: string;
                 minLength: number;
+                description: string;
             };
             meeting_id: {
                 type: string;
@@ -138,6 +139,11 @@ export declare const callMeetingSearchTool: (search: MeetingHitSearch, input: un
         id: string;
         excerpt: string;
         offset_ms: number | null;
+        match?: "corrected" | "words" | undefined;
+        corrections?: {
+            from: string;
+            to: string[];
+        }[] | undefined;
         source?: {
             ref: string;
             title: string | null;

package/dist/meetings/mcp/search.js

@@ -11,7 +11,11 @@ export const meetingSearchTool = {
     inputSchema: {
         type: "object",
         properties: {
-            query: { type: "string", minLength: 1 },
+            query: {
+                type: "string",
+                minLength: 1,
+                description: 'The messages query language: words (all required), OR, (groups), NOT or -word, "a phrase", "a b"~N for words within N transcript lines (at most 20), exact:word, from:"Name" for who said the line',
+            },
             meeting_id: integer,
             identity_id: integer,
             person_id: integer,

package/dist/meetings/project-evidence-answer.d.ts

@@ -24,10 +24,15 @@ export declare const meetingProjectEvidence: v.StrictObjectSchema<{
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
         readonly excerpt: v.StringSchema<undefined>;
         readonly offset_ms: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "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 source: v.OptionalSchema<v.StrictObjectSchema<{
             readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
             readonly title: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-            readonly started_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+            readonly started_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 url: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         }, undefined>, undefined>;
     }, undefined>, undefined>;
@@ -40,8 +45,8 @@ export declare const meetingProjectEvidence: v.StrictObjectSchema<{
         readonly tag_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
         readonly event_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
         readonly series_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
-        readonly since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
-        readonly until: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time with a zone">]>, undefined>;
+        readonly since: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
+        readonly until: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     }, undefined>;
     readonly limits: v.StrictObjectSchema<{
         readonly limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;

package/dist/meetings/pull.d.ts

@@ -9,6 +9,8 @@ export interface RunReport {
         externalId: string;
         message: string;
     }[];
+    /** An import whose files all read their start time in one zone names it; files carry no zone of their own. */
+    timezone?: string;
 }
 export interface PullOptions {
     accountId: number;

package/dist/meetings/recording-schedule.js

@@ -12,6 +12,8 @@ const clock = (now) => {
     return new Date(now);
 };
 const day = (instant) => instant.toISOString().slice(0, 10);
+/** The calendar day it is at `instant` in the schedule's own zone: the day the owner's daily run belongs to. */
+const localDay = (instant, timeZone) => new Intl.DateTimeFormat("en-CA", { timeZone, year: "numeric", month: "2-digit", day: "2-digit" }).format(instant);
 const identity = (schedule) => createHash("sha256").update(JSON.stringify(schedule)).digest("hex");
 export const planRecordingArchiveSchedule = (input, options) => {
     const now = clock(options.now);
@@ -29,8 +31,8 @@ export const planRecordingArchiveSchedule = (input, options) => {
         fail("archive schedule requires a valid IANA time zone");
     }
     recordingWindows(input.from, input.from);
-    if (input.from <= day(now))
-        recordingWindows(input.from, day(now));
+    if (input.from <= localDay(now, input.timeZone))
+        recordingWindows(input.from, localDay(now, input.timeZone));
     const lookbackDays = input.lookbackDays ?? 7;
     const maxBytes = input.maxBytes ?? 20 * 1024 ** 3;
     if (!Number.isSafeInteger(lookbackDays) || lookbackDays < 0 || lookbackDays > 31)
@@ -76,11 +78,10 @@ export const parseRecordingArchiveSchedule = (value) => {
 export const recordingArchiveScheduleWindow = (value, options) => {
     const schedule = parseRecordingArchiveSchedule(value);
     const now = clock(options.now);
-    const through = day(now);
+    const through = localDay(now, schedule.timeZone);
     if (schedule.from > through)
         return null;
-    const floor = new Date(now);
-    floor.setUTCHours(0, 0, 0, 0);
+    const floor = new Date(`${through}T00:00:00Z`);
     // A running job ages beyond its original ten-year discovery interval; saved pending work survives separately.
     const month = floor.getUTCMonth();
     const date = floor.getUTCDate();

package/dist/meetings/search-store.d.ts

@@ -1,3 +1,4 @@
+import type { QueryAst } from "@wirecat/cli-base/query";
 import type { SearchHit } from "./store.js";
 export interface MeetingSearchOptions {
     accountId: number;
@@ -37,7 +38,8 @@ export interface MeetingSearchPage {
 }
 /** Optional bounded read capability; paging reaches inside a single large transcript. */
 export interface MeetingSearchStore {
-    searchHits(query: string, options: MeetingSearchOptions): Promise<MeetingSearchPage>;
+    /** A string is what a person typed, parsed as a query; text that must not become syntax comes as `meetingWordsQuery`. */
+    searchHits(query: string | QueryAst, options: MeetingSearchOptions): Promise<MeetingSearchPage>;
 }
 export interface MeetingSearchIndexInput {
     accountId: number;

package/dist/meetings/store.d.ts

@@ -82,6 +82,13 @@ export interface SearchHit {
     id: number;
     text: string;
     startMs: number | null;
+    /** `corrected` when a query word matched only as a stored word recognition may have garbled. */
+    match?: "words" | "corrected";
+    /** For a `corrected` hit, the stored words each such query word matched in this passage. */
+    corrections?: {
+        from: string;
+        to: string[];
+    }[];
 }
 export interface ContractCase {
     name: string;

package/dist/meetings/transcript-text.d.ts

@@ -0,0 +1,20 @@
+import type { TranscriptLine } from "./model.js";
+export declare class TranscriptTextError extends Error {
+    name: string;
+}
+/** What the header of a text transcript says, as written; the caller reads the date in its zone. */
+export interface TranscriptTextHeader {
+    title: string | null;
+    date: string | null;
+    meetingId: string | null;
+    speakers: string[];
+}
+/**
+ * A transcript in the text form zoom-searcher wrote: a header (`Встреча:`, `Дата:`, `Zoom ID:`, `Говорят:`),
+ * a rule, then `[hh:mm:ss] Speaker: text` blocks apart by a blank line. A block may run over several lines.
+ * A line ends where the next begins: the file keeps start times only.
+ */
+export declare const parseTranscriptText: (input: string) => {
+    header: TranscriptTextHeader;
+    lines: TranscriptLine[];
+};