@wirecat/cli-core 0.419.0 → 0.421.0

package/dist/meetings/calendar-text.js

@@ -0,0 +1,57 @@
+import { joinUrlWithoutQuery } from "./join-key.js";
+const ENTITIES = { amp: "&", lt: "<", gt: ">", quot: '"', "#39": "'", apos: "'", nbsp: " " };
+/**
+ * A line that gives a way into a meeting: a passcode, a password, a PIN or an access code. Bounded by letters and
+ * digits, not `\b`, which knows only ASCII and would never match a Cyrillic word.
+ */
+const SECRET_LINE = /(?<![\p{L}\p{N}])(pass ?codes?|passwords?|pwd|pins?|access ?codes?|meeting ?codes?|kennwort|пароль|пин-?код|код доступа)(?![\p{L}\p{N}])|pwd=/iu;
+const htmlToText = (html) => html
+    .replace(/<\s*br\s*\/?>/giu, "\n")
+    .replace(/<\/\s*(p|div|li|tr|h[1-6])\s*>/giu, "\n")
+    .replace(/<a\s[^>]*href\s*=\s*"([^"]*)"[^>]*>/giu, " $1 ")
+    .replace(/<[^>]+>/gu, "")
+    .replace(/&(amp|lt|gt|quot|#39|apos|nbsp);/gu, (_, name) => ENTITIES[name] ?? "");
+/** Every web link without its query string or fragment, which is where passcodes ride (`pwd=`). */
+export const withoutLinkQueries = (text) => text.replace(/https?:\/\/[^\s<>"')\]]+/giu, (url) => joinUrlWithoutQuery(url) ?? "");
+/**
+ * A calendar's text as the store keeps it: HTML reduced to text, links without their query strings, and each line
+ * naming a passcode, password or PIN dropped — except from a title, where "PIN reset review" is a meeting's name.
+ * `null` when nothing is left.
+ */
+export const calendarText = (text, { dropSecretLines = true } = {}) => {
+    if (!text)
+        return null;
+    const kept = htmlToText(text)
+        .split(/\r?\n/u)
+        .map((line) => withoutLinkQueries(line)
+        .replace(/[ \t]+/gu, " ")
+        .trim())
+        .filter((line) => !dropSecretLines || !SECRET_LINE.test(line));
+    const joined = kept
+        .join("\n")
+        .replace(/\n{3,}/gu, "\n\n")
+        .trim();
+    return joined || null;
+};
+/** The provider fields a calendar entry may keep in `metadata`: none of them can open a meeting. */
+export const ENTRY_METADATA_KEYS = [
+    "colorId",
+    "guestsCanInviteOthers",
+    "guestsCanModify",
+    "guestsCanSeeOtherGuests",
+    "hangoutLink",
+    "locked",
+    "privateCopy",
+    "recurring_event_id",
+];
+export const entryMetadata = (metadata) => {
+    const kept = {};
+    for (const key of ENTRY_METADATA_KEYS) {
+        const value = metadata?.[key];
+        if (typeof value === "string")
+            kept[key] = withoutLinkQueries(value);
+        else if (typeof value === "number" || typeof value === "boolean")
+            kept[key] = value;
+    }
+    return kept;
+};

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

@@ -0,0 +1,202 @@
+import type { Event } from "./model.js";
+/** One calendar as a provider lists it. */
+export interface CalendarInput {
+    externalId: string;
+    title: string | null;
+    timezone: string | null;
+    /** owner, writer, reader, freeBusyReader. A calendar the owner owns syncs by default. */
+    accessRole: string | null;
+    primary: boolean;
+}
+export interface StoredCalendar {
+    id: number;
+    accountId: number;
+    externalId: string;
+    title: string | null;
+    timezone: string | null;
+    accessRole: string | null;
+    primary: boolean;
+    synced: boolean;
+    seenAt: number | null;
+    deletedAt: number | null;
+}
+export interface EntryParticipantInput {
+    email: string;
+    name?: string | null;
+    response?: string | null;
+    optional?: boolean;
+    organizer?: boolean;
+    self?: boolean;
+    /** A room or a piece of equipment: listed, never a contact. */
+    resource?: boolean;
+}
+export type EntryKind = "single" | "series" | "occurrence";
+export type EntryStatus = "confirmed" | "tentative" | "cancelled";
+/**
+ * One calendar entry as the provider returns it. Times are epoch milliseconds, `endsAt` exclusive. Text is cleaned
+ * before it is stored; there is no field for a conference's entry points, so no passcode or PIN can be given.
+ */
+export interface EntryInput {
+    externalId: string;
+    kind: EntryKind;
+    /** An occurrence's series, by the series entry's `externalId` (Google's `recurringEventId`). */
+    seriesExternalId?: string | null;
+    icalUid?: string | null;
+    /** An occurrence's slot in its series (Google's `originalStartTime`). */
+    originalStartsAt?: number | null;
+    exception?: boolean;
+    status: EntryStatus;
+    title?: string | null;
+    description?: string | null;
+    location?: string | null;
+    startsAt?: number | null;
+    endsAt?: number | null;
+    allDay?: boolean;
+    startDate?: string | null;
+    endDate?: string | null;
+    timezone?: string | null;
+    recurrence?: string[] | null;
+    /** A series' last slot; `null` repeats indefinitely. */
+    recurrenceEndsAt?: number | null;
+    eventType?: string | null;
+    transparency?: string | null;
+    visibility?: string | null;
+    ownResponse?: string | null;
+    organizer?: {
+        email: string;
+        name?: string | null;
+    } | null;
+    participants?: EntryParticipantInput[];
+    joinUrl?: string | null;
+    conference?: string | null;
+    url?: string | null;
+    sequence?: number | null;
+    etag?: string | null;
+    externalUpdatedAt?: number | null;
+    /** Only the keys `ENTRY_METADATA_KEYS` names are kept. */
+    metadata?: Record<string, unknown> | null;
+}
+export interface StoredEntry {
+    id: number;
+    calendarId: number;
+    kind: EntryKind;
+    seriesEntryId: number | null;
+    eventId: number | null;
+    eventSeriesId: number | null;
+    externalId: string;
+    icalUid: string | null;
+    originalStartsAt: number | null;
+    exception: boolean;
+    status: EntryStatus;
+    title: string | null;
+    description: string | null;
+    location: string | null;
+    startsAt: number | null;
+    endsAt: number | null;
+    allDay: boolean;
+    startDate: string | null;
+    endDate: string | null;
+    timezone: string | null;
+    recurrence: string[] | null;
+    recurrenceEndsAt: number | null;
+    eventType: string | null;
+    ownResponse: string | null;
+    organizerIdentityId: number | null;
+    joinUrl: string | null;
+    joinKey: string | null;
+    url: string | null;
+    externalUpdatedAt: number | null;
+    seenAt: number | null;
+    deletedAt: number | null;
+}
+export interface StoredParticipant {
+    entryId: number;
+    identityId: number | null;
+    email: string;
+    name: string | null;
+    response: string | null;
+    optional: boolean;
+    organizer: boolean;
+    self: boolean;
+    resource: boolean;
+}
+/** An entry's tracked fields as they were before one change. */
+export interface EntryRevision {
+    entryId: number;
+    title: string | null;
+    startsAt: number | null;
+    endsAt: number | null;
+    location: string | null;
+    status: string | null;
+    recurrence: string[] | null;
+    recurrenceEndsAt: number | null;
+    externalUpdatedAt: number | null;
+    createdAt: number;
+}
+export interface EventDetails {
+    event: Event;
+    entries: StoredEntry[];
+    participants: StoredParticipant[];
+    revisions: EntryRevision[];
+}
+export interface EventFilter {
+    /** Events that end after this instant (exclusive end). */
+    from?: number;
+    /** Events that start before this instant. */
+    to?: number;
+    accountId?: number;
+    calendarId?: number;
+    /** Events whose entries list one of this person's contacts. */
+    personId?: number;
+    limit?: number;
+    offset?: number;
+}
+/** Pairs the rules left unlinked because two or more entities fit equally well (requirements 3.6). */
+export interface LinkReview {
+    id: number;
+    linkableType: string;
+    linkableId: number;
+    entityType: string;
+    candidates: number[];
+    reason: string;
+    status: "open" | "linked" | "apart";
+    chosenId: number | null;
+    decidedBy: string | null;
+    decidedAt: number | null;
+    createdAt: number;
+}
+export type ReviewDecision = {
+    choose: number;
+} | {
+    apart: true;
+};
+/**
+ * Calendars and their entries, the source records of events (requirements 3.4). Apart from `MeetingStore`: a
+ * calendar CLI implements this one, a meeting app the other. Every write is one transaction; an owner's link is never
+ * replaced by a rule, and two equally good candidates make no link and one review entry.
+ */
+export interface EventStore {
+    saveCalendars(accountId: number, calendars: CalendarInput[], now: number): Promise<StoredCalendar[]>;
+    calendars(accountId: number): Promise<StoredCalendar[]>;
+    setCalendarSynced(calendarId: number, synced: boolean, now: number): Promise<void>;
+    /** One sync page, matched by rules 1–5, in one transaction. */
+    saveEntries(calendarId: number, entries: EntryInput[], now: number): Promise<StoredEntry[]>;
+    /**
+     * After a full list (`410 Gone`): entries not seen since `seenBefore` get `deleted_at`. Plain occurrences come only
+     * from the window fetched, so only those inside it count. Events, series and links stay.
+     */
+    markUnseen(calendarId: number, seenBefore: number, window: {
+        from: number;
+        to: number;
+    }, now: number): Promise<number>;
+    events(filter?: EventFilter): Promise<Event[]>;
+    event(id: number): Promise<EventDetails | null>;
+    /** The owner's link of an entry to an event; no rule replaces it. */
+    linkEntry(entryId: number, eventId: number, now: number): Promise<void>;
+    /** The owner's unlink: the rules leave the entry alone after it. */
+    unlinkEntry(entryId: number, now: number): Promise<void>;
+    reviews(filter?: {
+        status?: LinkReview["status"];
+    }): Promise<LinkReview[]>;
+    resolveReview(id: number, decision: ReviewDecision, now: number): Promise<LinkReview>;
+}

package/dist/meetings/event-store.js

@@ -0,0 +1 @@
+export {};

package/dist/meetings/events.js

@@ -13,7 +13,11 @@ export const linkEvent = async (store, details, now = Date.now()) => {
             startsAt: meeting.startedAt,
             endsAt: meeting.endedAt ?? meeting.startedAt,
         });
-    let event = candidates.length === 1 ? candidates[0] : undefined;
+    if (candidates.length > 1) {
+        await store.reviewMeetingLink?.(meeting.id, candidates.map(({ id }) => id), now);
+        return null;
+    }
+    let event = candidates[0];
     if (!event) {
         let eventSeriesId = series?.eventSeriesId ?? null;
         if (series?.kind === "recurring" && eventSeriesId === null) {

package/dist/meetings/index.d.ts

@@ -1,8 +1,10 @@
 export { MEETING_STEPS, type MeetingDetailsItem, type MeetingHitItem, type MeetingItemBody, type MeetingListBody, type MeetingSummaryItem, type MeetingTranscriptItem, meetingDetails, meetingHit, meetingHitsList, meetingSummary, meetingTranscript, } from "./answers.js";
 export type { MeetingBatchReader } from "./batch.js";
+export { calendarText, ENTRY_METADATA_KEYS, entryMetadata, withoutLinkQueries } from "./calendar-text.js";
 export type { MeetingContextStore, MeetingEventLinkInput, MeetingEventLinkReceipt, ParticipantPerson, ParticipantPersonInput, ParticipantPersonLinkInput, ParticipantPersonLinkReceipt, } from "./context-store.js";
 export { type MeetingCueIdentity, meetingCueFingerprint } from "./cue-fingerprint.js";
 export { EVENT_QUERY } from "./event-query.js";
+export type { CalendarInput, EntryInput, EntryKind, EntryParticipantInput, EntryRevision, EntryStatus, EventDetails, EventFilter, EventStore, LinkReview, ReviewDecision, StoredCalendar, StoredEntry, StoredParticipant, } 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";
@@ -10,6 +12,7 @@ export { type Finding, type FindingsInput, type FindingsReceipt, type FindingsRu
 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 { 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 { 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";

package/dist/meetings/index.js

@@ -1,4 +1,5 @@
 export { MEETING_STEPS, meetingDetails, meetingHit, meetingHitsList, meetingSummary, meetingTranscript, } from "./answers.js";
+export { calendarText, ENTRY_METADATA_KEYS, entryMetadata, withoutLinkQueries } from "./calendar-text.js";
 export { meetingCueFingerprint } from "./cue-fingerprint.js";
 export { EVENT_QUERY } from "./event-query.js";
 export { linkEvent } from "./events.js";
@@ -8,6 +9,7 @@ export { findingFingerprint, validateFindings, } from "./findings-rules.js";
 export { liftMeetingFields, MEETING_HIT_QUERY, meetingWordsQuery, parseMeetingQuery } from "./hit-query.js";
 export { importFiles } from "./import.js";
 export { MEETING_ISSUES, MEETING_QUERY, meeting, meetingIssuesOf, meetingItem, } from "./item.js";
+export { joinKeyOf, joinUrlWithoutQuery } from "./join-key.js";
 export { CHAT_MESSAGES_READ, } from "./links.js";
 export { createMeetingContext, MEETING_FACT_TYPES, validateMeetingContextChange, } from "./meeting-context.js";
 export { createMeetingManagement, dispatchMeetingMutation, validateMeetingChange, } from "./meeting-management.js";

package/dist/meetings/join-key.d.ts

@@ -0,0 +1,7 @@
+/**
+ * What one meeting room is, whatever link it was shared by: `zoom:<number>`, `meet:<code>`, else the host and path.
+ * A query string carries passcodes (`pwd=`), so it never reaches the key or a stored link.
+ */
+export declare const joinKeyOf: (url: string | null | undefined) => string | null;
+/** The link without its query string or fragment, which may hold a passcode. */
+export declare const joinUrlWithoutQuery: (url: string | null | undefined) => string | null;

package/dist/meetings/join-key.js

@@ -0,0 +1,38 @@
+/**
+ * What one meeting room is, whatever link it was shared by: `zoom:<number>`, `meet:<code>`, else the host and path.
+ * A query string carries passcodes (`pwd=`), so it never reaches the key or a stored link.
+ */
+export const joinKeyOf = (url) => {
+    const parsed = urlOf(url);
+    if (!parsed)
+        return null;
+    const host = parsed.hostname.toLowerCase().replace(/^www\./u, "");
+    const path = parsed.pathname.replace(/\/+$/u, "");
+    if (host === "zoom.us" || host.endsWith(".zoom.us") || host === "zoomgov.com" || host.endsWith(".zoomgov.com")) {
+        const number = /^\/(?:j|w|s|wc\/join|wc)\/(\d{9,12})(?:\/|$)/u.exec(path)?.[1];
+        if (number)
+            return `zoom:${number}`;
+    }
+    if (host === "meet.google.com") {
+        const code = /^\/([a-z]{3}-[a-z]{4}-[a-z]{3})$/iu.exec(path)?.[1];
+        if (code)
+            return `meet:${code.toLowerCase()}`;
+    }
+    return `${host}${path}`;
+};
+/** The link without its query string or fragment, which may hold a passcode. */
+export const joinUrlWithoutQuery = (url) => {
+    const parsed = urlOf(url);
+    return parsed ? `${parsed.origin}${parsed.pathname}` : null;
+};
+const urlOf = (url) => {
+    if (!url?.trim())
+        return null;
+    try {
+        const parsed = new URL(url.trim());
+        return parsed.protocol === "https:" || parsed.protocol === "http:" ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+};

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

@@ -38,6 +38,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -53,11 +54,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -75,11 +76,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -101,7 +102,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -188,6 +188,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -203,11 +204,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -225,11 +226,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -251,7 +252,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -338,6 +338,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -353,11 +354,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -375,11 +376,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -401,7 +402,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -488,6 +488,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -503,11 +504,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -525,11 +526,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -551,7 +552,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
@@ -638,6 +638,7 @@ export declare const meetingTools: ({
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -653,11 +654,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -675,11 +676,11 @@ export declare const meetingTools: ({
             format?: undefined;
             transcript_id?: undefined;
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;
         } | {
+            limit?: undefined;
             event_id?: undefined;
             series_id?: undefined;
             page?: undefined;
@@ -701,7 +702,6 @@ export declare const meetingTools: ({
                 minimum: number;
             };
             query?: undefined;
-            limit?: undefined;
             scan_limit?: undefined;
             max_read_bytes?: undefined;
             cursor?: undefined;

package/dist/meetings/model.d.ts

@@ -13,7 +13,8 @@ export interface EventSeries extends RecordTimes {
     id: number;
     title: string | null;
     recurrence: string | null;
-    origin: "auto" | "owner";
+    /** `auto` from a meeting, `owner`, or `calendar` from a calendar's entries. */
+    origin: "auto" | "owner" | "calendar";
 }
 export interface Event extends RecordTimes {
     id: number;
@@ -24,8 +25,13 @@ export interface Event extends RecordTimes {
     startsAt: number | null;
     endsAt: number | null;
     timezone: string | null;
-    origin: "auto" | "owner";
+    origin: "auto" | "owner" | "calendar";
     deletedAt: number | null;
+    /** confirmed, tentative, cancelled: cancelled only when every live calendar entry of it is. */
+    status?: string | null;
+    allDay?: boolean | null;
+    /** When its calendar deleted it; a past event stays as a meeting that happened. */
+    sourceDeletedAt?: number | null;
 }
 export interface MeetingSeries extends RecordTimes {
     id: number;

package/dist/meetings/read-answers.d.ts

@@ -176,8 +176,12 @@ export declare const event: v.StrictObjectSchema<{
     readonly starts_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 ends_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 timezone: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    /** `auto`: made from a meeting; `owner`: made by hand. */
-    readonly origin: v.PicklistSchema<["auto", "owner"], undefined>;
+    /** `auto`: made from a meeting; `owner`: made by hand; `calendar`: from a calendar's entries. */
+    readonly origin: v.PicklistSchema<["auto", "owner", "calendar"], undefined>;
+    readonly status: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly all_day: v.BooleanSchema<undefined>;
+    /** When its calendar deleted it: shown as "deleted in Google", kept as history. */
+    readonly source_deleted_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 deleted_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 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`">]>;

package/dist/meetings/read-answers.js

@@ -191,8 +191,12 @@ export const event = v.strictObject({
     starts_at: v.nullable(isoTime),
     ends_at: v.nullable(isoTime),
     timezone: v.nullable(text),
-    /** `auto`: made from a meeting; `owner`: made by hand. */
-    origin: v.picklist(["auto", "owner"]),
+    /** `auto`: made from a meeting; `owner`: made by hand; `calendar`: from a calendar's entries. */
+    origin: v.picklist(["auto", "owner", "calendar"]),
+    status: v.nullable(text),
+    all_day: v.boolean(),
+    /** When its calendar deleted it: shown as "deleted in Google", kept as history. */
+    source_deleted_at: v.nullable(isoTime),
     deleted_at: v.nullable(isoTime),
     created_at: isoTime,
     updated_at: isoTime,
@@ -207,6 +211,9 @@ export const eventItem = (one) => ({
     ends_at: iso(one.endsAt),
     timezone: one.timezone,
     origin: one.origin,
+    status: one.status ?? null,
+    all_day: one.allDay === true,
+    source_deleted_at: iso(one.sourceDeletedAt ?? null),
     deleted_at: iso(one.deletedAt),
     created_at: new Date(one.createdAt).toISOString(),
     updated_at: new Date(one.updatedAt).toISOString(),

package/dist/meetings/store.d.ts

@@ -120,6 +120,8 @@ export interface MeetingStore {
     setEventSeries(meetingSeriesId: number, eventSeriesId: number, now: number): Promise<void>;
     /** Automatic linking must not replace an existing link. */
     linkMeeting(id: number, eventId: number, now: number, mode?: "auto" | "owner"): Promise<void>;
+    /** Two or more events fit a meeting equally: no link, and the pair goes to the owner's review list. */
+    reviewMeetingLink?(meetingId: number, eventIds: number[], now: number): Promise<void>;
     cursor(accountId: number): Promise<string | null>;
     setCursor(accountId: number, value: string, now: number): Promise<void>;
 }

package/dist/meetings/testing/event-store-contract.d.ts

@@ -0,0 +1,10 @@
+import type { EventStore } from "../event-store.js";
+import type { ContractCase } from "../store.js";
+/** A fresh, empty store and one calendar account in it. */
+export interface EventStoreFixture {
+    store: EventStore;
+    accountId: number;
+}
+/** "Now" in every case: entries before it have happened. */
+export declare const CONTRACT_NOW: number;
+export declare const eventStoreContract: (make: () => EventStoreFixture | Promise<EventStoreFixture>) => ContractCase[];