@wirecat/cli-core 0.400.0 → 0.402.0

package/dist/entities/index.js

@@ -42,7 +42,8 @@ import { job } from "./job.js";
 import { joinRequest } from "./join-request.js";
 import { messageEvent, serveSummary, watchedMessage, watchItem } from "./listener.js";
 import { mediaArchive, mediaArchiveCheck, mediaArchiveMove, mediaArchiveTimer } from "./media-archive.js";
-import { meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "./meeting.js";
+import { event, meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "./meeting.js";
+import { meetingEvidence, meetingPersonContext } from "./meeting-evidence.js";
 import { meetingFindings } from "./meeting-findings.js";
 import { meetingPreparation } from "./meeting-preparation.js";
 import { meetingProjectCandidates } from "./meeting-project-candidates.js";
@@ -212,6 +213,9 @@ export const ENTITIES = {
     meeting_findings: meetingFindings,
     meeting_transcript: meetingTranscript,
     meeting_summary: meetingSummary,
+    meeting_evidence: meetingEvidence,
+    meeting_person_context: meetingPersonContext,
+    event,
     meeting_review: meetingReview,
     meeting_link: meetingLink,
     meeting_stats: meetingStats,

package/dist/entities/meeting-evidence.d.ts

@@ -0,0 +1,86 @@
+import * as v from "valibot";
+/** `meetings evidence`: the stored lines behind a meeting reference, a page at a time. */
+export declare const meetingEvidence: v.StrictObjectSchema<{
+    readonly schema_version: v.LiteralSchema<1, undefined>;
+    readonly kind: v.LiteralSchema<"meeting", undefined>;
+    readonly source: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+    readonly fingerprint: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly limits: v.StrictObjectSchema<{
+        readonly cues: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly max_read_bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly max_transcript_pages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, undefined>;
+    readonly content_bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly coverage: v.StrictObjectSchema<{
+        readonly provided: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly included: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly omitted: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+        readonly provided_exact: v.BooleanSchema<undefined>;
+        readonly next_transcript_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly next_reference: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>, undefined>;
+        readonly transcript_pages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly skipped_unavailable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly has_more: v.BooleanSchema<undefined>;
+        readonly truncated_by: v.NullableSchema<v.PicklistSchema<["cues", "bytes", "transcripts"], undefined>, undefined>;
+        readonly input: v.LiteralSchema<"bounded-meeting-pages", undefined>;
+        readonly archive_completeness: v.LiteralSchema<"unknown", undefined>;
+    }, undefined>;
+    readonly items: v.ArraySchema<v.StrictObjectSchema<{
+        readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly fingerprint: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly transcript_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly content_hash: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        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>]>;
+        readonly end_ms: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly speaker_participant_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly speaker_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly text: v.StringSchema<undefined>;
+        readonly revision: v.PicklistSchema<["current", "superseded"], undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+/** `meetings context`: what the stored meetings say about one person, through their linked identities. */
+export declare const meetingPersonContext: v.StrictObjectSchema<{
+    readonly person: v.StrictObjectSchema<{
+        readonly uid: v.StringSchema<undefined>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly items: v.ArraySchema<v.StrictObjectSchema<{
+        readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+        readonly cues: v.ArraySchema<v.StrictObjectSchema<{
+            readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+            readonly fingerprint: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly transcript_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly content_hash: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            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>]>;
+            readonly end_ms: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly speaker_participant_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+            readonly speaker_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly text: v.StringSchema<undefined>;
+            readonly revision: v.PicklistSchema<["current", "superseded"], undefined>;
+        }, undefined>, undefined>;
+        readonly cue_coverage: v.StrictObjectSchema<{
+            readonly included: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+            readonly omitted: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+            readonly has_more: v.BooleanSchema<undefined>;
+        }, undefined>;
+    }, undefined>, undefined>;
+    readonly limits: v.StrictObjectSchema<{
+        readonly meetings: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly cues: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly scan_limit: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    }, undefined>;
+    readonly content_bytes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly coverage: v.StrictObjectSchema<{
+        readonly involvements_scanned: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly scan_limit_reached: v.BooleanSchema<undefined>;
+        readonly pending: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly truncated_by: v.NullableSchema<v.PicklistSchema<["meetings", "bytes"], undefined>, undefined>;
+        readonly skipped_unavailable: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly complete: v.LiteralSchema<false, undefined>;
+        readonly input: v.LiteralSchema<"bounded-meeting-pages", undefined>;
+    }, undefined>;
+}, undefined>;

package/dist/entities/meeting-evidence.js

@@ -0,0 +1,25 @@
+import { reference } from "@wirecat/cli-base/standards";
+import * as v from "valibot";
+import { preparationCount as count, preparationCue, preparationEvidence } from "./meeting-preparation-parts.js";
+/** `meetings evidence`: the stored lines behind a meeting reference, a page at a time. */
+export const meetingEvidence = preparationEvidence;
+/** `meetings context`: what the stored meetings say about one person, through their linked identities. */
+export const meetingPersonContext = v.strictObject({
+    person: v.strictObject({ uid: v.string(), name: v.nullable(v.string()) }),
+    items: v.array(v.strictObject({
+        ref: reference,
+        cues: v.array(preparationCue),
+        cue_coverage: v.strictObject({ included: count, omitted: v.nullable(count), has_more: v.boolean() }),
+    })),
+    limits: v.strictObject({ meetings: count, cues: count, bytes: count, scan_limit: count }),
+    content_bytes: count,
+    coverage: v.strictObject({
+        involvements_scanned: count,
+        scan_limit_reached: v.boolean(),
+        pending: count,
+        truncated_by: v.nullable(v.picklist(["meetings", "bytes"])),
+        skipped_unavailable: count,
+        complete: v.literal(false),
+        input: v.literal("bounded-meeting-pages"),
+    }),
+});

package/dist/entities/meeting-preparation-parts.d.ts

@@ -30,6 +30,20 @@ export declare const preparationUpcoming: v.StrictObjectSchema<{
         readonly missing: v.ArraySchema<v.PicklistSchema<["schedule-details", "occurrence-details"], undefined>, undefined>;
     }, undefined>;
 }, undefined>;
+/** One stored transcript line as evidence: where it is, who said it, and its text. */
+export declare const preparationCue: v.StrictObjectSchema<{
+    readonly ref: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a reference such as `note:42`">]>;
+    readonly fingerprint: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly transcript_id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly content_hash: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    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>]>;
+    readonly end_ms: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly speaker_participant_id: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    readonly speaker_name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly text: v.StringSchema<undefined>;
+    readonly revision: v.PicklistSchema<["current", "superseded"], undefined>;
+}, undefined>;
 export declare const preparationEvidence: v.StrictObjectSchema<{
     readonly schema_version: v.LiteralSchema<1, undefined>;
     readonly kind: v.LiteralSchema<"meeting", undefined>;

package/dist/entities/meeting-preparation-parts.js

@@ -32,6 +32,20 @@ export const preparationUpcoming = v.strictObject({
         missing: v.array(v.picklist(["schedule-details", "occurrence-details"])),
     }),
 });
+/** One stored transcript line as evidence: where it is, who said it, and its text. */
+export const preparationCue = v.strictObject({
+    ref: reference,
+    fingerprint: id,
+    transcript_id: id,
+    content_hash: text,
+    position: count,
+    offset_ms: count,
+    end_ms: count,
+    speaker_participant_id: v.nullable(id),
+    speaker_name: text,
+    text: v.string(),
+    revision: v.picklist(["current", "superseded"]),
+});
 export const preparationEvidence = v.strictObject({
     schema_version: v.literal(1),
     kind: v.literal("meeting"),
@@ -53,19 +67,7 @@ export const preparationEvidence = v.strictObject({
         input: v.literal("bounded-meeting-pages"),
         archive_completeness: v.literal("unknown"),
     }),
-    items: v.array(v.strictObject({
-        ref: reference,
-        fingerprint: id,
-        transcript_id: id,
-        content_hash: text,
-        position: count,
-        offset_ms: count,
-        end_ms: count,
-        speaker_participant_id: v.nullable(id),
-        speaker_name: text,
-        text: v.string(),
-        revision: v.picklist(["current", "superseded"]),
-    })),
+    items: v.array(preparationCue),
 });
 export const preparationContext = v.strictObject({
     participants: page(v.strictObject({ id, identity_id: id, display_name: text, person_uid: v.nullable(id) })),

package/dist/entities/meeting.d.ts

@@ -1 +1 @@
-export { meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "../meetings/index.js";
+export { event, meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "../meetings/index.js";

package/dist/entities/meeting.js

@@ -1 +1 @@
-export { meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "../meetings/index.js";
+export { event, meeting, meetingDetails, meetingHit, meetingLink, meetingParticipants, meetingPassage, meetingProjectEvidence, meetingReview, meetingSpeaker, meetingStats, meetingSummary, meetingTranscript, } from "../meetings/index.js";

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

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

package/dist/entities/message-write.js

@@ -4,5 +4,7 @@ import { message } from "./message.js";
 export const messageWrite = v.strictObject({
     operation_id: id,
     message,
+    /** An album's messages, in order; `message` is the first. Absent for a single message. */
+    messages: v.optional(v.array(message)),
     scheduled_for: v.optional(time),
 });

package/dist/errors/reasons.js

@@ -26,10 +26,12 @@ const OTHERS = [
     ["extraction.invalid-proposals", "invalid_response", "the model's memory proposals could not be used"],
     validation("extraction.text-too-long", "the text is too long for memory extraction"),
     validation("file.locked", "another process holds the file's lock"),
+    ["mirror.partial", "provider_error", "some mirrored files were not synced"],
     ["profile.wrong-account", "authentication_error", "the signed-in source account does not match this profile"],
     validation("push.too-many-files", "the folder holds more files than one push takes"),
     validation("push.unreadable", "the folder to push could not be read"),
     validation("spreadsheet.unreadable", "the workbook could not be read"),
+    ["state.invalid", "configuration_error", "the saved sync state is unreadable or invalid; it is kept, not reset"],
     validation("store.refused", "the local store refused the document text"),
     ["store.not-writable", "permission_error", "the message store cannot be written from this process"],
     validation("catalog.scope-limit", "the selected catalog exceeds its entry limit"),

package/dist/mcp/agent.js

@@ -6,7 +6,7 @@ import { VOCABULARY } from "@wirecat/cli-base/standards/tables";
 import * as v from "valibot";
 import { changesMessenger } from "../cli/effects.js";
 import { lentConnection } from "../cli/messenger/serve-relay.js";
-import { AUTHORITY_KEY, authorityAllowed, keyForCommand, levelFor, readKeysForCommand, } from "../sends/permissions.js";
+import { AUTHORITY_KEY, authorityAllowed, botApiAllowed, isBotApi, keyForCommand, levelFor, readKeysForCommand, } from "../sends/permissions.js";
 const TYPES = new Map(VOCABULARY.flags.map((flag) => [flag.name, flag.type]));
 // `<name|id>` is one argument: its field is `name_or_id`.
 const snake = (name) => name.replaceAll("|", "_or_").replace(/[^a-z0-9]+/gi, "_");
@@ -24,6 +24,8 @@ const optionKind = (option, long) => {
         return type;
     if (/<json>/.test(option.flags))
         return "json";
+    if (Array.isArray(option.default))
+        return "repeat";
     return /\.\.\.[>\]]/.test(option.flags) ? "variadic" : "text";
 };
 const optionField = (option, long, negatable = false) => {
@@ -38,8 +40,8 @@ const optionField = (option, long, negatable = false) => {
                     v.pipe(v.number(), v.integer(), v.minValue(0), v.description(about))
                 : kind === "number"
                     ? v.pipe(v.number(), v.description(about))
-                    : kind === "list"
-                        ? // The command line takes `a,b`; an agent may write it so, or as a list.
+                    : kind === "list" || kind === "repeat"
+                        ? // The command line takes `a,b` or the flag repeated; an agent may write one value, or a list.
                             v.pipe(v.union([v.pipe(v.array(text("one value")), v.minLength(1)), text(about)]), v.description(about))
                         : kind === "variadic"
                             ? v.pipe(v.array(text("one value")), v.minLength(1), v.description(about))
@@ -58,6 +60,8 @@ const optionField = (option, long, negatable = false) => {
                 return value === true ? [long] : negatable ? [`--no-${long.slice(2)}`] : [];
             if (kind === "variadic")
                 return value.map((one) => `${long}=${String(one)}`);
+            if (kind === "repeat")
+                return (Array.isArray(value) ? value : [value]).map((one) => `${long}=${String(one)}`);
             if (kind === "list")
                 return [`${long}=${Array.isArray(value) ? value.map(String).join(",") : String(value)}`];
             if (kind === "json")
@@ -138,7 +142,7 @@ export const toolsFromCommands = (commands, options = {}) => {
     const { root = [], exclude = [], levels, keyOf, authority, readOnly = false } = options;
     return flatten(commands)
         .filter((info) => 
-    // A group that also runs on its own declares effects: `tasks duplicates` lists, its subcommands decide.
+    // Only a group that declares effects can run without a leaf.
     (info.commands.length === 0 || info.effects !== undefined) &&
         info.path.length > root.length &&
         startsWith(info.path, root) &&
@@ -146,7 +150,8 @@ export const toolsFromCommands = (commands, options = {}) => {
         info.mcp !== false &&
         info.lifetime === undefined &&
         !(readOnly && (changesMessenger(info) || authority?.(info.path))) &&
-        (levels === undefined || refusal(info, levels, keyOf, authority) === undefined))
+        (levels === undefined ||
+            (refusal(info, levels, keyOf, authority) === undefined && (!isBotApi(info.path) || botApiAllowed(levels)))))
         .map((info) => ({
         command: info.path.slice(root.length).join(" "),
         path: info.path,
@@ -193,7 +198,7 @@ const argvOf = (info, input, profile, stdin) => {
 export const runCommandForAgent = async (program, path, input, ctx) => {
     try {
         const info = flatten(program.commands).find((one) => one.path.length === path.length && startsWith(one.path, path));
-        // A group runs when it declares effects of its own, as `toolsFromCommands` offers it: `tasks duplicates` lists.
+        // Runnable groups declare effects, as `toolsFromCommands` offers them.
         if (!info || (info.commands.length > 0 && info.effects === undefined))
             throw new CliError("validation_error", `no command "${path.join(" ")}" to run`);
         if (info.lifetime)
@@ -226,6 +231,7 @@ export const runCommandForAgent = async (program, path, input, ctx) => {
                 },
                 ...(ctx.overrides?.length ? { overrides: ctx.overrides } : {}),
                 authority: levels !== undefined && authorityAllowed(levels),
+                botApi: levels !== undefined && botApiAllowed(levels),
             },
             // Opened only when the command asks: a read the store answers never connects.
             ...(lend

package/dist/meetings/cli/index.js

@@ -5,6 +5,7 @@ import { exportMeeting } from "../export.js";
 import { importFiles } from "../import.js";
 import { MEETING_QUERY } from "../item.js";
 import { pull } from "../pull.js";
+import { eventItem } from "../read-answers.js";
 import { listed, MEETING_QUERY_GUIDE, MeetingError, meetingDetailsAnswer, meetingPeople, meetingSummaryAnswer, meetingsList, meetingsQuery, meetingTranscriptAnswer, } from "../reads.js";
 import { SAVE_HELP } from "../save-hints.js";
 import { queryWordsAfterOptions } from "./query-options.js";
@@ -137,8 +138,9 @@ export const addMeetingCommands = (program, deps) => {
     });
     output(annotate(program.command("events").description("the owner's stored events").command("list"), {
         effects: LOCAL_READ,
+        output: { entity: "event" },
     }).description("list stored events")).action(async (_opts, command) => {
-        print(listed(await deps.store.events()), command);
+        print(listed((await deps.store.events()).map(eventItem)), command);
     });
 };
 export { addMeetingPassageCommand, createMeetingPassageCommand, meetingPassageRequest, } from "./passage.js";

package/dist/meetings/index.d.ts

@@ -25,7 +25,7 @@ export { type MeetingProjectEvidenceAnswer, type MeetingProjectEvidenceItem, mee
 export { MEETING_PROJECT_EVIDENCE_QUERY, type MeetingProjectEvidenceRequest, prepareMeetingProjectEvidence, } from "./project-evidence-query.js";
 export { type MeetingProviderScope, snapshotMeetingScope } from "./provider.js";
 export { type PullOptions, pull, type RunReport } from "./pull.js";
-export { meetingLink, meetingLinkItem, meetingParticipants, meetingPassage, meetingReview, meetingReviewItem, meetingSpeaker, meetingSpeakerItem, meetingStats, meetingStatsItem, } from "./read-answers.js";
+export { event, eventItem, meetingLink, meetingLinkItem, meetingParticipants, meetingPassage, meetingReview, meetingReviewItem, meetingSpeaker, meetingSpeakerItem, meetingStats, meetingStatsItem, } from "./read-answers.js";
 export type { MeetingContextReadCapabilities, MeetingReadBudget, MeetingReadCapabilities, MeetingReadScope, TranscriptContextInput, TranscriptContextPage, TranscriptPage, TranscriptReadScope, TranscriptRowPage, } from "./read-store.js";
 export { listed, MeetingError, meetingDetailsAnswer, meetingPeople, meetingSummaryAnswer, meetingTranscriptAnswer, type TranscriptReadOptions, } from "./reads.js";
 export { installRecordingArchiveSchedule, parseRecordingArchiveSchedule, planRecordingArchiveSchedule, type RecordingArchiveSchedule, type RecordingArchiveScheduleInput, type RecordingArchiveScheduler, recordingArchiveScheduleWindow, } from "./recording-schedule.js";

package/dist/meetings/index.js

@@ -18,7 +18,7 @@ export { meetingProjectEvidence, meetingProjectEvidenceAnswer, } from "./project
 export { MEETING_PROJECT_EVIDENCE_QUERY, prepareMeetingProjectEvidence, } from "./project-evidence-query.js";
 export { snapshotMeetingScope } from "./provider.js";
 export { pull } from "./pull.js";
-export { meetingLink, meetingLinkItem, meetingParticipants, meetingPassage, meetingReview, meetingReviewItem, meetingSpeaker, meetingSpeakerItem, meetingStats, meetingStatsItem, } from "./read-answers.js";
+export { event, eventItem, meetingLink, meetingLinkItem, meetingParticipants, meetingPassage, meetingReview, meetingReviewItem, meetingSpeaker, meetingSpeakerItem, meetingStats, meetingStatsItem, } from "./read-answers.js";
 export { listed, MeetingError, meetingDetailsAnswer, meetingPeople, meetingSummaryAnswer, meetingTranscriptAnswer, } from "./reads.js";
 export { installRecordingArchiveSchedule, parseRecordingArchiveSchedule, planRecordingArchiveSchedule, recordingArchiveScheduleWindow, } from "./recording-schedule.js";
 export { parseRecordingSyncCheckpoint, RecordingSyncError, recordingAssetFingerprint, recordingWindows, syncRecordingArchive, } from "./recording-sync.js";