@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/meetings/recording-transfer.js

@@ -0,0 +1,196 @@
+import { CliError } from "@wirecat/cli-base";
+import { snapshotMeetingScope } from "./provider.js";
+export class RecordingTransferError extends CliError {
+    constructor(message, code = "invalid_response") {
+        super(code, message);
+        this.name = "RecordingTransferError";
+    }
+}
+export const strongRecordingValidator = (value) => typeof value === "string" && value.length <= 1024 && /^"[\x21\x23-\x7e\x80-\xff]*"$/.test(value);
+const fail = (message, code = "invalid_response") => {
+    throw new RecordingTransferError(message, code);
+};
+const integer = (value) => {
+    if (value === null)
+        return null;
+    if (typeof value !== "string" || !/^\d+$/.test(value) || !Number.isSafeInteger(Number(value)))
+        return fail("invalid recording content length");
+    return Number(value);
+};
+const cancelled = (signal) => {
+    if (!signal?.aborted)
+        return;
+    if (signal.reason instanceof CliError)
+        throw signal.reason;
+    throw new RecordingTransferError("recording transfer cancelled", "cancelled");
+};
+const sameLocator = (a, b) => a.provider === b.provider && a.account === b.account && a.occurrenceId === b.occurrenceId && a.assetId === b.assetId;
+const receipt = (value, expectedSize, expectedHash) => {
+    if (typeof value !== "object" || value === null)
+        return fail("invalid recording storage receipt");
+    const { size, sha256 } = value;
+    if (size !== expectedSize ||
+        typeof sha256 !== "string" ||
+        !/^[a-f0-9]{64}$/.test(sha256) ||
+        (expectedHash !== undefined && sha256 !== expectedHash))
+        return fail("invalid recording storage receipt");
+    return { size, sha256 };
+};
+export const transferRecording = async (source, storage, options) => {
+    const { maxBytes, signal, expectedSize } = options;
+    const inputLocator = options.locator;
+    const fixedScope = snapshotMeetingScope(inputLocator);
+    const locator = Object.freeze({
+        provider: fixedScope.provider,
+        account: fixedScope.account,
+        occurrenceId: inputLocator.occurrenceId,
+        assetId: inputLocator.assetId,
+    });
+    if (!Number.isSafeInteger(maxBytes) ||
+        maxBytes <= 0 ||
+        [locator.occurrenceId, locator.assetId].some((value) => typeof value !== "string" || !value.trim() || value.length > 512 || /[\0\r\n]/.test(value)) ||
+        (expectedSize != null && (!Number.isSafeInteger(expectedSize) || expectedSize < 0 || expectedSize > maxBytes)))
+        fail("invalid recording transfer options", "validation_error");
+    cancelled(signal);
+    const loaded = await storage.load(locator);
+    const loadedLocator = loaded?.locator;
+    let partial = loaded && loadedLocator
+        ? Object.freeze({
+            locator: Object.freeze({
+                provider: loadedLocator.provider,
+                account: loadedLocator.account,
+                occurrenceId: loadedLocator.occurrenceId,
+                assetId: loadedLocator.assetId,
+            }),
+            offset: loaded.offset,
+            sha256: loaded.sha256,
+            validator: loaded.validator,
+            total: loaded.total,
+        })
+        : null;
+    if (partial &&
+        (!sameLocator(partial.locator, locator) ||
+            !strongRecordingValidator(partial.validator) ||
+            !Number.isSafeInteger(partial.offset) ||
+            partial.offset <= 0 ||
+            partial.offset > maxBytes ||
+            !/^[a-f0-9]{64}$/.test(partial.sha256) ||
+            (partial.total !== null &&
+                (!Number.isSafeInteger(partial.total) || partial.total < partial.offset || partial.total > maxBytes)) ||
+            (expectedSize != null && partial.total !== expectedSize)))
+        partial = null;
+    cancelled(signal);
+    const openResponse = async (request) => {
+        const opened = await source.open(request);
+        const close = opened.close.bind(opened);
+        try {
+            return Object.freeze({
+                status: opened.status,
+                etag: opened.etag,
+                contentRange: opened.contentRange,
+                contentLength: opened.contentLength,
+                body: opened.body,
+                close,
+            });
+        }
+        catch (error) {
+            await close();
+            throw error;
+        }
+    };
+    let response = await openResponse({
+        locator,
+        ...(partial ? { offset: partial.offset, validator: partial.validator } : {}),
+        ...(signal ? { signal } : {}),
+    });
+    try {
+        cancelled(signal);
+        if (partial && response.status === 416) {
+            const match = /^bytes \*\/(\d+)$/.exec(response.contentRange ?? "");
+            if (match &&
+                Number(match[1]) === partial.offset &&
+                partial.total === partial.offset &&
+                response.etag === partial.validator) {
+                const writer = await storage.open(locator, {
+                    resume: partial,
+                    validator: partial.validator,
+                    total: partial.total,
+                });
+                try {
+                    cancelled(signal);
+                    return { ...receipt(await writer.finish(), partial.offset, partial.sha256), resumedBytes: partial.offset };
+                }
+                finally {
+                    await writer.close();
+                }
+            }
+            await response.close();
+            partial = null;
+            response = await openResponse({ locator, ...(signal ? { signal } : {}) });
+        }
+        if (partial && response.status === 206 && response.etag !== partial.validator) {
+            await response.close();
+            partial = null;
+            response = await openResponse({ locator, ...(signal ? { signal } : {}) });
+            cancelled(signal);
+        }
+        let total = null;
+        const length = integer(response.contentLength);
+        if (response.status === 206 && partial) {
+            const match = /^bytes (\d+)-(\d+)\/(\d+)$/.exec(response.contentRange ?? "");
+            if (!match)
+                return fail("invalid recording content range");
+            const start = Number(match[1]);
+            const end = Number(match[2]);
+            const size = Number(match[3]);
+            if (!Number.isSafeInteger(size) ||
+                start !== partial.offset ||
+                end < start ||
+                end !== size - 1 ||
+                (partial.total !== null && size !== partial.total) ||
+                (length !== null && length !== end - start + 1))
+                fail("recording range does not match its verified prefix");
+            total = size;
+        }
+        else if (response.status === 200) {
+            partial = null;
+            if (response.contentRange !== null)
+                fail("unexpected recording content range");
+            total = length ?? expectedSize ?? null;
+        }
+        else
+            fail("recording transfer requires a complete response or validated range");
+        if (total !== null && (total > maxBytes || (expectedSize != null && total !== expectedSize)))
+            fail("recording size does not match transfer limits");
+        const writer = await storage.open(locator, {
+            ...(partial ? { resume: partial } : {}),
+            validator: strongRecordingValidator(response.etag) ? response.etag : null,
+            total,
+        });
+        const resumedBytes = partial?.offset ?? 0;
+        let size = resumedBytes;
+        try {
+            for await (const bytes of response.body) {
+                cancelled(signal);
+                if (!(bytes instanceof Uint8Array) ||
+                    bytes.byteLength > maxBytes - size ||
+                    (total !== null && bytes.byteLength > total - size))
+                    fail("recording exceeds transfer size");
+                await writer.write(bytes);
+                size += bytes.byteLength;
+                await writer.checkpoint();
+            }
+            cancelled(signal);
+            if ((total !== null && size !== total) || (expectedSize != null && size !== expectedSize))
+                fail("recording body was truncated");
+            return { ...receipt(await writer.finish(), size), resumedBytes };
+        }
+        finally {
+            await writer.close();
+        }
+    }
+    finally {
+        await response.close();
+    }
+};
+//# sourceMappingURL=recording-transfer.js.map

package/dist/meetings/recording-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-transfer.js","sourceRoot":"","sources":["../../src/meetings/recording-transfer.ts"],"names":[],"mappings":"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"}

package/dist/meetings/save-hints.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The writes live in memo, a separate server and CLI, so the hint names them as optional: an agent
+ * without memo connected must be able to ignore it.
+ */
+export declare const SAVE_NEXT_STEPS: string;
+export declare const SAVE_HELP = "Worth keeping \u2014 a decision, a promise, a preference? Record it with `memo facts add` or\n`memo memories add`, citing the msg: locator or meeting: reference as --evidence.";
+//# sourceMappingURL=save-hints.d.ts.map

package/dist/meetings/save-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-hints.d.ts","sourceRoot":"","sources":["../../src/meetings/save-hints.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,QAEsF,CAAA;AAElH,eAAO,MAAM,SAAS,oLAC8D,CAAA"}

package/dist/meetings/save-hints.js

@@ -0,0 +1,9 @@
+/**
+ * The writes live in memo, a separate server and CLI, so the hint names them as optional: an agent
+ * without memo connected must be able to ignore it.
+ */
+export const SAVE_NEXT_STEPS = "If this shows something worth keeping — a decision, a promise, a preference — and memo's server is connected, " +
+    "propose it with facts_add or memories_add, citing the msg: locator or meeting: reference. Otherwise skip this.";
+export const SAVE_HELP = `Worth keeping — a decision, a promise, a preference? Record it with \`memo facts add\` or
+\`memo memories add\`, citing the msg: locator or meeting: reference as --evidence.`;
+//# sourceMappingURL=save-hints.js.map

package/dist/meetings/save-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-hints.js","sourceRoot":"","sources":["../../src/meetings/save-hints.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,gHAAgH;IAChH,gHAAgH,CAAA;AAElH,MAAM,CAAC,MAAM,SAAS,GAAG;oFAC2D,CAAA"}

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

@@ -0,0 +1,59 @@
+import type { SearchHit } from "./store.js";
+export interface MeetingSearchOptions {
+    accountId: number;
+    meetingId?: number;
+    /** Observed participant identity; filters meetings, not who spoke a hit. */
+    participantIdentityId?: number;
+    /** Only explicit identity-to-person links are followed. */
+    personId?: number;
+    /** Confirmed, unanchored meeting membership in a live owner project. */
+    projectId?: number;
+    /** An explicit meeting label (tag or topic). */
+    tagId?: number;
+    /** A stored calendar event the meeting is linked to. */
+    eventId?: number;
+    meetingSeriesId?: number;
+    since?: number;
+    until?: number;
+    limit?: number;
+    /** Opaque continuation, bound by the adapter to the account, query and filters. */
+    after?: string;
+    maxReadBytes?: number;
+    signal?: AbortSignal;
+}
+export interface MeetingSearchPage {
+    items: SearchHit[];
+    hasMore: boolean;
+    nextCursor: string | null;
+    coverage: {
+        archiveCompleteness: "unknown";
+        currentRevisions: true;
+        indexing: "ready" | "pending";
+        indexCompleteness: "unknown";
+    };
+}
+/** Optional bounded read capability; paging reaches inside a single large transcript. */
+export interface MeetingSearchStore {
+    searchHits(query: string, options: MeetingSearchOptions): Promise<MeetingSearchPage>;
+}
+export interface MeetingSearchIndexInput {
+    accountId: number;
+    limit?: number;
+    maxReadBytes?: number;
+    signal?: AbortSignal;
+}
+export interface MeetingSearchIndexReceipt {
+    indexed: number;
+    remaining: number;
+}
+/** Explicit bounded index maintenance, independent of read-only hit paging. */
+export interface MeetingSearchIndexStore {
+    indexSearch(input: MeetingSearchIndexInput): Promise<MeetingSearchIndexReceipt>;
+}
+export interface MeetingHitSearchRequest extends MeetingSearchOptions {
+    /** Exact canonical name, project key or explicit alias; never a fuzzy match. */
+    project?: string;
+    tag?: string;
+    topic?: string;
+}
+//# sourceMappingURL=search-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-store.d.ts","sourceRoot":"","sources":["../../src/meetings/search-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE;QACR,mBAAmB,EAAE,SAAS,CAAA;QAC9B,gBAAgB,EAAE,IAAI,CAAA;QACtB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,iBAAiB,EAAE,SAAS,CAAA;KAC7B,CAAA;CACF;AAED,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACrF;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,+EAA+E;AAC/E,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAA;CAChF;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/meetings/search-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-store.js.map

package/dist/meetings/search-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-store.js","sourceRoot":"","sources":["../../src/meetings/search-store.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,5 @@
+import type { MeetingHitSearchRequest, MeetingSearchPage } from "./search-store.js";
+export type MeetingHitSearchOptions = Omit<MeetingHitSearchRequest, "accountId">;
+export type MeetingHitSearch = (query: string, options: MeetingHitSearchOptions) => Promise<MeetingSearchPage>;
+export declare const validateMeetingHitSearch: (query: string, options?: MeetingHitSearchOptions) => void;
+//# sourceMappingURL=search-validation.d.ts.map

package/dist/meetings/search-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-validation.d.ts","sourceRoot":"","sources":["../../src/meetings/search-validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAEnF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAA;AAChF,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;AAC9G,eAAO,MAAM,wBAAwB,UAAW,MAAM,YAAW,uBAAuB,SAyCvF,CAAA"}

package/dist/meetings/search-validation.js

@@ -0,0 +1,32 @@
+import { CliError } from "@wirecat/cli-base";
+export const validateMeetingHitSearch = (query, options = {}) => {
+    const integer = (value, low, high) => Number.isSafeInteger(value) && value >= low && value <= high;
+    if (typeof query !== "string" ||
+        !query.trim() ||
+        query.includes("\0") ||
+        new TextEncoder().encode(query).byteLength > 65536 ||
+        !integer(options.limit ?? 100, 1, 1000) ||
+        !integer(options.maxReadBytes ?? 4194304, 1, 67108864) ||
+        [
+            options.meetingId,
+            options.participantIdentityId,
+            options.personId,
+            options.projectId,
+            options.tagId,
+            options.eventId,
+            options.meetingSeriesId,
+        ].some((value) => value !== undefined && !integer(value, 1, Number.MAX_SAFE_INTEGER)) ||
+        [options.since, options.until].some((value) => value !== undefined && !integer(value, -8640000000000000, 8640000000000000)) ||
+        (options.since !== undefined && options.until !== undefined && options.since > options.until) ||
+        (options.after !== undefined &&
+            (typeof options.after !== "string" || !/^[A-Za-z0-9_-]{1,1000}$/.test(options.after))))
+        throw new CliError("validation_error", "invalid bounded meeting search query, cursor or limits");
+    for (const name of [options.project, options.tag, options.topic])
+        if (name !== undefined &&
+            (typeof name !== "string" || !name.trim() || name.length > 200 || /[\p{Cc}\p{Cf}]/u.test(name)))
+            throw new CliError("validation_error", "a meeting vocabulary name takes 1–200 characters without control characters");
+    if ((options.project !== undefined && options.projectId !== undefined) ||
+        [options.tag, options.topic, options.tagId].filter((value) => value !== undefined).length > 1)
+        throw new CliError("validation_error", "choose one project selector and one tag or topic selector");
+};
+//# sourceMappingURL=search-validation.js.map

package/dist/meetings/search-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-validation.js","sourceRoot":"","sources":["../../src/meetings/search-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAK5C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAa,EAAE,OAAO,GAA4B,EAAE,EAAE,EAAE;IAC/F,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,IAAY,EAAE,EAAE,CAC3D,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,IAAI,CAAA;IAC9D,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,IAAI,EAAE;QACb,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,KAAK;QAClD,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC;QACvC,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,EAAE,CAAC,EAAE,QAAQ,CAAC;QACtD;YACE,OAAO,CAAC,SAAS;YACjB,OAAO,CAAC,qBAAqB;YAC7B,OAAO,CAAC,QAAQ;YAChB,OAAO,CAAC,SAAS;YACjB,OAAO,CAAC,KAAK;YACb,OAAO,CAAC,OAAO;YACf,OAAO,CAAC,eAAe;SACxB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACrF,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CACjC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CACvF;QACD,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7F,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAC1B,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAExF,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,wDAAwD,CAAC,CAAA;IAClG,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC;QAC9D,IACE,IAAI,KAAK,SAAS;YAClB,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE/F,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,6EAA6E,CAC9E,CAAA;IACL,IACE,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC;QAClE,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC;QAE7F,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,2DAA2D,CAAC,CAAA;AACvG,CAAC,CAAA"}

package/dist/meetings/source.d.ts

@@ -0,0 +1,27 @@
+import type { Metadata, SourceChatLine, SourceMeeting, SummaryContent, TranscriptLine } from "./model.js";
+import type { MeetingSave } from "./store.js";
+export interface SourceParticipant {
+    identityExternalId: string | null;
+    email: string | null;
+    displayName: string | null;
+    externalId: string | null;
+    role: string | null;
+    joinedAt: number | null;
+    leftAt: number | null;
+    durationMs: number | null;
+    sessions: import("./model.js").JsonValue;
+    metadata: Metadata;
+}
+/** Null means unavailable; it never requests deletion of previously saved data. */
+export interface MeetingSource {
+    readonly provider: string;
+    readonly name: string;
+    readonly transcriptFormat?: string;
+    meetings(since: string): Promise<SourceMeeting[]>;
+    participants(occurrenceId: string): Promise<SourceParticipant[] | null>;
+    transcript(occurrenceId: string): Promise<TranscriptLine[] | null>;
+    chat(occurrenceId: string): Promise<SourceChatLine[] | null>;
+    summary(occurrenceId: string): Promise<SummaryContent | null>;
+    files(occurrenceId: string): Promise<NonNullable<MeetingSave["attachments"]> | null>;
+}
+//# sourceMappingURL=source.d.ts.map

package/dist/meetings/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/meetings/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AACzG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,OAAO,YAAY,EAAE,SAAS,CAAA;IACxC,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IACjD,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,CAAA;IACvE,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAAA;IAClE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAAA;IAC5D,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC7D,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;CACrF"}

package/dist/meetings/source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=source.js.map

package/dist/meetings/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/meetings/source.ts"],"names":[],"mappings":""}

package/dist/meetings/store.d.ts

@@ -0,0 +1,96 @@
+import type { Attachment, ChatLine, Event, EventSeries, Meeting, MeetingSeries, Metadata, Participant, Summary, Transcript, TranscriptRow } from "./model.js";
+export type NewRecord<T> = Omit<T, "id" | "createdAt" | "updatedAt">;
+export interface IdentityInput {
+    /** Explicit stable provider key; false or absent must not create a person association. */
+    associatePerson?: boolean;
+    provider: string;
+    externalId: string;
+    name: string | null;
+    metadata: Metadata;
+}
+export interface ParticipantInput extends Omit<NewRecord<Participant>, "meetingId" | "identityId"> {
+    identity: IdentityInput;
+}
+export interface TranscriptRowInput extends Omit<NewRecord<TranscriptRow>, "meetingTranscriptId" | "speakerParticipantId"> {
+    /** Index in this save's participants; null for absent or ambiguous speakers. */
+    speakerParticipantPosition: number | null;
+}
+export interface TranscriptInput extends Omit<NewRecord<Transcript>, "meetingId" | "supersededAt"> {
+    rows: TranscriptRowInput[];
+}
+export interface ChatInput extends Omit<NewRecord<ChatLine>, "meetingId" | "senderParticipantId"> {
+    senderParticipantPosition: number | null;
+}
+export interface MeetingInput extends Omit<NewRecord<Meeting>, "meetingSeriesId" | "eventId"> {
+    series?: Omit<NewRecord<MeetingSeries>, "accountId" | "eventSeriesId">;
+}
+export interface MeetingSave {
+    meeting: MeetingInput;
+    participants?: ParticipantInput[];
+    transcripts?: TranscriptInput[];
+    chat?: ChatInput[];
+    summaries?: Omit<NewRecord<Summary>, "meetingId">[];
+    attachments?: Omit<NewRecord<Attachment>, "attachableType" | "attachableId">[];
+    now: number;
+}
+export interface MeetingDetails {
+    meeting: Meeting;
+    series: MeetingSeries | null;
+    participants: Participant[];
+    transcripts: {
+        transcript: Transcript;
+        rows: TranscriptRow[];
+    }[];
+    chat: ChatLine[];
+    summaries: Summary[];
+    attachments: Attachment[];
+}
+export interface MeetingFilter {
+    accountId?: number;
+    eventId?: number;
+    meetingSeriesId?: number;
+    since?: number;
+    until?: number;
+    includeDeleted?: boolean;
+    limit?: number;
+    offset?: number;
+}
+export interface EventCandidateFilter {
+    meetingSeriesId: number | null;
+    joinUrl: string | null;
+    startsAt: number;
+    endsAt: number;
+}
+export interface SearchHit {
+    /** A retained cue reference for transcript hits, or the parent meeting for other sources. */
+    ref?: string;
+    meetingId: number;
+    scope: "transcript" | "chat" | "summary";
+    id: number;
+    text: string;
+    startMs: number | null;
+}
+export interface ContractCase {
+    name: string;
+    run(): Promise<void>;
+}
+/** Missing parts are unknown, never a request to delete previously saved data. */
+export interface MeetingStore {
+    /** Atomic, keyed by account + external id. Preserves event links and transcript history. */
+    saveMeeting(input: MeetingSave): Promise<MeetingDetails>;
+    meetings(filter?: MeetingFilter): Promise<Meeting[]>;
+    meeting(id: number): Promise<MeetingDetails | null>;
+    participants(query: string, accountId?: number): Promise<Participant[]>;
+    search(query: string, filter?: MeetingFilter): Promise<SearchHit[]>;
+    events(): Promise<Event[]>;
+    /** Inclusive overlap; an event with a start but no end occupies its start instant. */
+    eventCandidates(filter: EventCandidateFilter): Promise<Event[]>;
+    createEvent(input: NewRecord<Event>, now: number): Promise<Event>;
+    createEventSeries(input: NewRecord<EventSeries>, now: number): Promise<EventSeries>;
+    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>;
+    cursor(accountId: number): Promise<string | null>;
+    setCursor(accountId: number, value: string, now: number): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/meetings/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/meetings/store.ts"],"names":[],"mappings":"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"}

package/dist/meetings/store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.js.map

package/dist/meetings/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/meetings/store.ts"],"names":[],"mappings":""}

package/dist/meetings/testing/contract.d.ts

@@ -0,0 +1,4 @@
+import type { ContractCase, MeetingStore } from "../store.js";
+/** Each case gets a fresh, empty store. The runner owns cleanup after run(). */
+export declare const meetingStoreContract: (make: () => MeetingStore | Promise<MeetingStore>) => ContractCase[];
+//# sourceMappingURL=contract.d.ts.map

package/dist/meetings/testing/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/meetings/testing/contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG7D,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,SAAU,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,KAAG,YAAY,EAiRnG,CAAA"}