@wirecat/cli-core 0.20.0 → 0.263.0

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

@@ -0,0 +1,11 @@
+import type { Event } from "../model.js";
+import type { ChatInput, MeetingSave, NewRecord, ParticipantInput, TranscriptInput, TranscriptRowInput } from "../store.js";
+export declare const sampleEvent: () => NewRecord<Event>;
+export declare const sampleMeeting: () => MeetingSave & {
+    participants: [ParticipantInput];
+    transcripts: [TranscriptInput & {
+        rows: [TranscriptRowInput, ...TranscriptRowInput[]];
+    }];
+    chat: [ChatInput];
+};
+//# sourceMappingURL=samples.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"samples.d.ts","sourceRoot":"","sources":["../../../src/meetings/testing/samples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EACnB,MAAM,aAAa,CAAA;AAEpB,eAAO,MAAM,WAAW,QAAO,SAAS,CAAC,KAAK,CAU5C,CAAA;AACF,eAAO,MAAM,aAAa,QAAO,WAAW,GAAG;IAC7C,YAAY,EAAE,CAAC,gBAAgB,CAAC,CAAA;IAChC,WAAW,EAAE,CAAC,eAAe,GAAG;QAAE,IAAI,EAAE,CAAC,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAAC,CAAA;KAAE,CAAC,CAAA;IACxF,IAAI,EAAE,CAAC,SAAS,CAAC,CAAA;CA0HjB,CAAA"}

package/dist/meetings/testing/samples.js

@@ -0,0 +1,134 @@
+export const sampleEvent = () => ({
+    eventSeriesId: null,
+    title: "Example planning",
+    description: null,
+    location: null,
+    startsAt: 1000,
+    endsAt: 2000,
+    timezone: "UTC",
+    origin: "auto",
+    deletedAt: null,
+});
+export const sampleMeeting = () => ({
+    now: 3000,
+    meeting: {
+        accountId: 1,
+        externalId: "example-occurrence",
+        title: "Example planning",
+        description: "Invented agenda",
+        location: "Online",
+        joinUrl: "https://example.com/room",
+        startedAt: 1000,
+        endedAt: 2000,
+        durationMs: 1000,
+        timezone: "UTC",
+        hostIdentityId: null,
+        participantsCount: 1,
+        metadata: null,
+        deletedAt: null,
+        series: {
+            externalId: "example-series",
+            title: "Example planning",
+            description: null,
+            kind: "recurring",
+            recurrence: null,
+            hostIdentityId: null,
+            joinUrl: "https://example.com/room",
+            metadata: null,
+            deletedAt: null,
+        },
+    },
+    participants: [
+        {
+            identity: {
+                provider: "example",
+                externalId: "alice-example",
+                name: "Alice Example",
+                metadata: null,
+                associatePerson: true,
+            },
+            displayName: "Alice Example",
+            email: "alice@example.com",
+            role: "host",
+            joinedAt: 1000,
+            leftAt: 2000,
+            durationMs: 1000,
+            sessions: null,
+            externalId: "alice-example",
+            metadata: null,
+        },
+    ],
+    transcripts: [
+        {
+            source: "api",
+            format: "vtt",
+            language: "en",
+            contentHash: "invented-hash",
+            externalCreatedAt: null,
+            metadata: null,
+            deletedAt: null,
+            rows: [
+                {
+                    position: 0,
+                    startMs: 0,
+                    endMs: 1000,
+                    speakerParticipantPosition: 0,
+                    speakerName: "Alice Example",
+                    text: "Ship the example plan.",
+                    normalizedText: null,
+                    metadata: null,
+                },
+            ],
+        },
+    ],
+    chat: [
+        {
+            externalId: "example-chat",
+            sentAt: 1500,
+            senderParticipantPosition: 0,
+            senderName: "Alice Example",
+            recipient: "everyone",
+            text: "Example chat",
+            normalizedText: null,
+            metadata: null,
+        },
+    ],
+    summaries: [
+        {
+            source: "example-ai",
+            title: "Example summary",
+            overview: "Example overview",
+            sections: [{ label: "Plan", text: "Example section" }],
+            nextSteps: ["Example next step"],
+            content: "Example content",
+            docUrl: null,
+            externalCreatedAt: null,
+            externalUpdatedAt: null,
+            metadata: null,
+        },
+    ],
+    attachments: [
+        {
+            position: 0,
+            kind: "file",
+            mime: "text/plain",
+            name: "example.txt",
+            title: null,
+            url: "https://example.com/file",
+            size: 10,
+            width: null,
+            height: null,
+            duration: null,
+            providerRef: null,
+            localPath: null,
+            text: null,
+            normalizedText: null,
+            extraction: null,
+            extractor: null,
+            extractionError: null,
+            contentSha256: null,
+            extractedAt: null,
+        },
+    ],
+});
+//# sourceMappingURL=samples.js.map

package/dist/meetings/testing/samples.js.map

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

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

@@ -0,0 +1,3 @@
+import type { MeetingSource } from "../source.js";
+export declare const fakeMeetingSource: (overrides?: Partial<MeetingSource>) => MeetingSource;
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/meetings/testing/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,eAAO,MAAM,iBAAiB,eAAe,OAAO,CAAC,aAAa,CAAC,KAAQ,aAiCzE,CAAA"}

package/dist/meetings/testing/source.js

@@ -0,0 +1,35 @@
+export const fakeMeetingSource = (overrides = {}) => ({
+    provider: "example",
+    name: "api",
+    async participants() {
+        return null;
+    },
+    async files() {
+        return null;
+    },
+    async meetings() {
+        return [
+            {
+                series: { id: "example-series", provider: "example", title: "Example planning" },
+                occurrence: {
+                    id: "example-occurrence",
+                    seriesId: "example-series",
+                    title: "Example planning",
+                    startedAt: "1970-01-01T00:00:01.000Z",
+                    endedAt: "1970-01-01T00:00:02.000Z",
+                },
+            },
+        ];
+    },
+    async transcript() {
+        return [{ startMs: 0, endMs: 1000, speaker: "Alice Example", text: "Ship the example plan." }];
+    },
+    async chat() {
+        return null;
+    },
+    async summary() {
+        return null;
+    },
+    ...overrides,
+});
+//# sourceMappingURL=source.js.map

package/dist/meetings/testing/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/meetings/testing/source.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,GAA2B,EAAE,EAAiB,EAAE,CAAC,CAAC;IAC3F,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,KAAK;IACX,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAA;IACb,CAAC;IACD,KAAK,CAAC,QAAQ;QACZ,OAAO;YACL;gBACE,MAAM,EAAE,EAAE,EAAE,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE;gBAChF,UAAU,EAAE;oBACV,EAAE,EAAE,oBAAoB;oBACxB,QAAQ,EAAE,gBAAgB;oBAC1B,KAAK,EAAE,kBAAkB;oBACzB,SAAS,EAAE,0BAA0B;oBACrC,OAAO,EAAE,0BAA0B;iBACpC;aACF;SACF,CAAA;IACH,CAAC;IACD,KAAK,CAAC,UAAU;QACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAA;IAChG,CAAC;IACD,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAA;IACb,CAAC;IACD,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAA;IACb,CAAC;IACD,GAAG,SAAS;CACb,CAAC,CAAA"}

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

@@ -0,0 +1,5 @@
+import type { ContractCase, MeetingStore } from "../store.js";
+import type { MeetingTranscriptStore } from "../transcript-store.js";
+/** Optional capability cases; factory must also provide the unchanged meeting port. */
+export declare const meetingTranscriptStoreContract: (make: () => (MeetingStore & MeetingTranscriptStore) | Promise<MeetingStore & MeetingTranscriptStore>) => ContractCase[];
+//# sourceMappingURL=transcript-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-contract.d.ts","sourceRoot":"","sources":["../../../src/meetings/testing/transcript-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAA6C,MAAM,wBAAwB,CAAA;AAmB/G,uFAAuF;AACvF,eAAO,MAAM,8BAA8B,SACnC,MAAM,CAAC,YAAY,GAAG,sBAAsB,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,sBAAsB,CAAC,KACnG,YAAY,EAsId,CAAA"}

package/dist/meetings/testing/transcript-contract.js

@@ -0,0 +1,143 @@
+import assert from "node:assert/strict";
+import { sampleEvent, sampleMeeting } from "./samples.js";
+const transcript = (source = "example-asset", hash = "example-hash") => {
+    const original = sampleMeeting().transcripts[0];
+    return {
+        ...original,
+        source,
+        contentHash: hash,
+        rows: original.rows.map(({ speakerParticipantPosition: _position, ...row }) => row),
+    };
+};
+const request = (transcripts = [transcript()]) => ({
+    accountId: 1,
+    externalId: "example-occurrence",
+    transcripts,
+    now: 5000,
+});
+/** Optional capability cases; factory must also provide the unchanged meeting port. */
+export const meetingTranscriptStoreContract = (make) => {
+    const test = (name, check) => ({
+        name,
+        async run() {
+            await check(await make());
+        },
+    });
+    return [
+        test("append requires an existing occurrence or explicit real start", async (store) => {
+            await assert.rejects(store.appendTranscripts(request()));
+            assert.deepEqual(await store.meetings(), []);
+            const appended = await store.appendTranscripts({
+                ...request(),
+                create: { title: "Example archive", startedAt: 1000, timezone: "UTC" },
+            });
+            assert.equal(appended.meeting.externalId, "example-occurrence");
+            assert.equal(appended.meeting.accountId, 1);
+            assert.equal(appended.meeting.startedAt, 1000);
+            assert.equal(appended.meeting.eventId, null);
+            assert.equal(appended.series, null);
+            assert.deepEqual(appended.participants, []);
+            assert.equal(appended.transcripts[0]?.rows[0]?.speakerParticipantId, null);
+            assert.equal(appended.transcripts[0]?.rows[0]?.speakerName, "Alice Example");
+            assert.deepEqual(await store.events(), []);
+            assert.equal(await store.cursor(1), null);
+        }),
+        test("append preserves owner scalars, links, other parts and cursor", async (store) => {
+            const original = await store.saveMeeting(sampleMeeting());
+            const event = await store.createEvent(sampleEvent(), 4000);
+            await store.linkMeeting(original.meeting.id, event.id, 4000, "owner");
+            await store.setCursor(1, "owner-cursor", 4000);
+            const before = await store.meeting(original.meeting.id);
+            assert.ok(before);
+            const appended = await store.appendTranscripts({
+                ...request(),
+                create: { title: "Stale provider title", startedAt: 1, timezone: null },
+            });
+            assert.deepEqual(appended.meeting, before.meeting);
+            assert.deepEqual(appended.series, before.series);
+            for (const field of ["participants", "chat", "summaries", "attachments"])
+                assert.deepEqual(appended[field], before[field]);
+            assert.deepEqual(appended.transcripts[0], before.transcripts[0]);
+            assert.equal(appended.transcripts.length, 2);
+            assert.equal(await store.cursor(1), "owner-cursor");
+            assert.deepEqual(await store.events(), [event]);
+        }),
+        test("source hashes are idempotent and sibling revisions remain independent", async (store) => {
+            await store.saveMeeting(sampleMeeting());
+            const first = await store.appendTranscripts(request([transcript("asset-one"), transcript("asset-two")]));
+            assert.equal(first.transcripts.length, 3);
+            const repeat = await store.appendTranscripts({
+                ...request([transcript("asset-one"), transcript("asset-two")]),
+                now: 6000,
+            });
+            assert.deepEqual(repeat, first);
+            const corrected = transcript("asset-one", "corrected-hash");
+            const correctedRow = corrected.rows[0];
+            assert.ok(correctedRow);
+            correctedRow.text = "Corrected example";
+            const changed = await store.appendTranscripts({ ...request([corrected]), now: 7000 });
+            assert.equal(changed.transcripts.length, 4);
+            assert.equal(changed.transcripts.find((item) => item.transcript.source === "asset-one")?.transcript.supersededAt, 7000);
+            assert.equal(changed.transcripts.find((item) => item.transcript.source === "asset-two")?.transcript.supersededAt, null);
+            assert.equal(changed.transcripts[0]?.transcript.supersededAt, null);
+            assert.equal(changed.transcripts.at(-1)?.rows[0]?.text, "Corrected example");
+            const historicalReplay = await store.appendTranscripts(request([transcript("asset-one")]));
+            assert.deepEqual(historicalReplay, changed);
+        }),
+        test("matching UUIDs remain isolated across accounts and deleted targets stay deleted", async (store) => {
+            const original = sampleMeeting();
+            const first = await store.saveMeeting(original);
+            original.meeting.accountId = 2;
+            const other = await store.saveMeeting(original);
+            await store.appendTranscripts(request());
+            assert.deepEqual(await store.meeting(other.meeting.id), other);
+            original.meeting.accountId = 1;
+            original.meeting.deletedAt = 6000;
+            await store.saveMeeting(original);
+            const deleted = await store.meeting(first.meeting.id);
+            await assert.rejects(store.appendTranscripts({ ...request(), create: { title: null, startedAt: 1, timezone: null } }));
+            assert.deepEqual(await store.meeting(first.meeting.id), deleted);
+        }),
+        test("a later invalid asset rolls back the whole batch", async (store) => {
+            const original = await store.saveMeeting(sampleMeeting());
+            const bad = transcript("bad-asset");
+            const badRow = bad.rows[0];
+            assert.ok(badRow);
+            badRow.position = -1;
+            await assert.rejects(store.appendTranscripts(request([transcript(), bad])));
+            assert.deepEqual(await store.meeting(original.meeting.id), original);
+            const after = await store.appendTranscripts(request());
+            assert.equal(after.transcripts.length, 2);
+        }),
+        test("extra creation fields cannot redirect occurrence identity", async (store) => {
+            const foreign = sampleMeeting();
+            foreign.meeting.accountId = 2;
+            const existing = await store.saveMeeting(foreign);
+            const create = {
+                title: "Example archive",
+                startedAt: 1000,
+                timezone: "UTC",
+                accountId: 2,
+                externalId: existing.meeting.externalId,
+            };
+            const appended = await store.appendTranscripts({ ...request(), externalId: "new-occurrence", create });
+            assert.equal(appended.meeting.accountId, 1);
+            assert.equal(appended.meeting.externalId, "new-occurrence");
+            assert.deepEqual(await store.meeting(existing.meeting.id), existing);
+        }),
+        test("inputs and returned snapshots cannot mutate stored parts", async (store) => {
+            await store.saveMeeting(sampleMeeting());
+            const input = request();
+            const result = await store.appendTranscripts(input);
+            const inputRow = input.transcripts[0]?.rows[0];
+            const resultRow = result.transcripts[1]?.rows[0];
+            assert.ok(inputRow);
+            assert.ok(resultRow);
+            inputRow.text = "Mutated input";
+            resultRow.text = "Mutated result";
+            const stored = await store.meeting(result.meeting.id);
+            assert.equal(stored?.transcripts[1]?.rows[0]?.text, "Ship the example plan.");
+        }),
+    ];
+};
+//# sourceMappingURL=transcript-contract.js.map

package/dist/meetings/testing/transcript-contract.js.map

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

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

@@ -0,0 +1,38 @@
+import type { MeetingDetails, TranscriptInput, TranscriptRowInput } from "./store.js";
+export type UnlinkedTranscriptInput = Omit<TranscriptInput, "rows" | "contentHash"> & {
+    contentHash: string;
+    rows: Omit<TranscriptRowInput, "speakerParticipantPosition">[];
+};
+export interface TranscriptAppend {
+    accountId: number;
+    externalId: string;
+    /** Used only when the occurrence does not exist; never replaces existing meeting fields. */
+    create?: {
+        title: string | null;
+        startedAt: number;
+        timezone: string | null;
+    };
+    transcripts: UnlinkedTranscriptInput[];
+    now: number;
+}
+/** Optional adapter capability; the existing MeetingStore contract does not require it. */
+export interface MeetingTranscriptStore {
+    /**
+     * Atomic source/hash append preserving meeting fields and unrelated parts. Historical replays
+     * never reactivate superseded versions. Missing or deleted targets reject with not_found unless
+     * create supplies a new occurrence; deleted occurrences are never recreated.
+     */
+    appendTranscripts(input: TranscriptAppend): Promise<MeetingDetails>;
+}
+export interface TranscriptAppendReceipt {
+    meeting: MeetingDetails;
+    created: boolean;
+    insertedTranscripts: number;
+    replayedTranscripts: number;
+    supersededTranscripts: number;
+}
+/** Counts and writes share one transaction; preflight reads cannot establish these outcomes. */
+export interface MeetingTranscriptReceiptStore {
+    appendTranscriptsWithReceipt(input: TranscriptAppend): Promise<TranscriptAppendReceipt>;
+}
+//# sourceMappingURL=transcript-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-store.d.ts","sourceRoot":"","sources":["../../src/meetings/transcript-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAErF,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG;IACpF,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,4BAA4B,CAAC,EAAE,CAAA;CAC/D,CAAA;AACD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;IAC7E,WAAW,EAAE,uBAAuB,EAAE,CAAA;IACtC,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,2FAA2F;AAC3F,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CACpE;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,cAAc,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAED,gGAAgG;AAChG,MAAM,WAAW,6BAA6B;IAC5C,4BAA4B,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACxF"}

package/dist/meetings/transcript-store.js

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

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

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

package/dist/meetings/transcription.d.ts

@@ -0,0 +1,53 @@
+import { type MeetingMutationOptions } from "./meeting-management.js";
+import type { MeetingTranscriptReceiptStore, TranscriptAppendReceipt } from "./transcript-store.js";
+export interface MeetingMediaDescriptor {
+    id: string;
+    contentHash: string;
+    size: number;
+    durationMs: number;
+    format: string;
+    sampleRate: number;
+    channels: number;
+    recognition: {
+        engine: string;
+        model: string;
+        version?: string;
+        timing?: "fixed-windows" | "recognition-segments";
+    };
+}
+export interface MeetingRecognitionSegment {
+    startMs: number;
+    endMs: number;
+    text: string;
+}
+export interface MeetingTranscriptionContext {
+    maxBytes: number;
+    maxDurationMs: number;
+    signal?: AbortSignal;
+}
+/** Native hosts own media decoding and installed models; description must never install a model. */
+export interface MeetingTranscriptionSource {
+    describe(context: MeetingTranscriptionContext): Promise<MeetingMediaDescriptor>;
+    segments(media: Readonly<MeetingMediaDescriptor>, context: MeetingTranscriptionContext): AsyncIterable<MeetingRecognitionSegment>;
+}
+export interface MeetingTranscriptionOptions extends MeetingMutationOptions {
+    maxBytes?: number;
+    maxDurationMs?: number;
+    maxSegments?: number;
+    maxTextBytes?: number;
+}
+export interface MeetingTranscriptionReceipt {
+    media: Readonly<MeetingMediaDescriptor>;
+    accountId: number;
+    externalId: string;
+    applied: boolean;
+    segments: number;
+    append?: TranscriptAppendReceipt;
+}
+/** Preview describes the media; recognition and one atomic append require explicit apply. */
+export declare const transcribeMeeting: (source: MeetingTranscriptionSource, store: MeetingTranscriptReceiptStore, target: {
+    accountId: number;
+    externalId: string;
+    now: number;
+}, options?: MeetingTranscriptionOptions) => Promise<MeetingTranscriptionReceipt>;
+//# sourceMappingURL=transcription.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcription.d.ts","sourceRoot":"","sources":["../../src/meetings/transcription.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAC9F,OAAO,KAAK,EACV,6BAA6B,EAC7B,uBAAuB,EAExB,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,GAAG,sBAAsB,CAAA;KAAE,CAAA;CACpH;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,oGAAoG;AACpG,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAC/E,QAAQ,CACN,KAAK,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EACvC,OAAO,EAAE,2BAA2B,GACnC,aAAa,CAAC,yBAAyB,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,uBAAuB,CAAA;CACjC;AAoBD,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,WACpB,0BAA0B,SAC3B,6BAA6B,UAC5B;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,YACrD,2BAA2B,KACnC,OAAO,CAAC,2BAA2B,CAwIrC,CAAA"}

package/dist/meetings/transcription.js

@@ -0,0 +1,157 @@
+import { CliError } from "@wirecat/cli-base";
+import { contentHash } from "./ingest.js";
+import { dispatchMeetingMutation } from "./meeting-management.js";
+const bounded = (value, max, name) => {
+    if (!Number.isSafeInteger(value) || value < 1 || value > max)
+        throw new CliError("validation_error", `${name} must be an integer from 1 to ${max}`);
+    return value;
+};
+const identifier = (value) => {
+    if (typeof value !== "string" || !value.trim() || value.length > 1000 || /[\0\r\n]/.test(value))
+        throw new CliError("validation_error", "transcription identifiers must be bounded nonempty strings");
+    return value;
+};
+const cancelled = (signal) => {
+    if (signal?.aborted) {
+        if (signal.reason instanceof CliError)
+            throw signal.reason;
+        const timeout = signal.reason instanceof Error && signal.reason.name === "TimeoutError";
+        throw new CliError(timeout ? "timeout" : "cancelled", "meeting transcription was interrupted");
+    }
+};
+/** Preview describes the media; recognition and one atomic append require explicit apply. */
+export const transcribeMeeting = async (source, store, target, options = {}) => {
+    const accountId = bounded(target.accountId, Number.MAX_SAFE_INTEGER, "account ID");
+    const externalId = identifier(target.externalId);
+    const now = target.now;
+    const mutation = { apply: options.apply, dryRun: options.dryRun, signal: options.signal };
+    if (!Number.isSafeInteger(now) || now < 0)
+        throw new CliError("validation_error", "invalid transcription timestamp");
+    const context = Object.freeze({
+        maxBytes: bounded(options.maxBytes ?? 1024 ** 3, 4 * 1024 ** 3, "media byte limit"),
+        maxDurationMs: bounded(options.maxDurationMs ?? 4 * 3600_000, 24 * 3600_000, "media duration limit"),
+        ...(options.signal ? { signal: options.signal } : {}),
+    });
+    const maxSegments = bounded(options.maxSegments ?? 10_000, 100_000, "segment limit");
+    const maxTextBytes = bounded(options.maxTextBytes ?? 4 * 1024 ** 2, 64 * 1024 ** 2, "transcript byte limit");
+    cancelled(context.signal);
+    const raw = await source.describe(context);
+    cancelled(context.signal);
+    const recognition = raw.recognition;
+    const engine = recognition.engine;
+    const model = recognition.model;
+    const version = recognition.version;
+    const timing = recognition.timing ?? "recognition-segments";
+    if (timing !== "fixed-windows" && timing !== "recognition-segments")
+        throw new CliError("invalid_response", "unsupported recognition timing");
+    const media = Object.freeze({
+        id: identifier(raw.id),
+        contentHash: raw.contentHash,
+        size: bounded(raw.size, context.maxBytes, "media size"),
+        durationMs: bounded(raw.durationMs, context.maxDurationMs, "media duration"),
+        format: identifier(raw.format),
+        sampleRate: bounded(raw.sampleRate, 384_000, "sample rate"),
+        channels: bounded(raw.channels, 32, "channel count"),
+        recognition: Object.freeze({
+            engine: identifier(engine),
+            model: identifier(model),
+            ...(version === undefined ? {} : { version: identifier(version) }),
+            timing,
+        }),
+    });
+    if (!/^[a-f0-9]{64}$/.test(media.contentHash))
+        throw new CliError("invalid_response", "media needs a SHA-256 content hash");
+    const outcome = await dispatchMeetingMutation(mutation, async () => {
+        const rows = [];
+        let textBytes = 0;
+        let end = 0;
+        let provided = 0;
+        for await (const segment of source.segments(media, context)) {
+            cancelled(context.signal);
+            provided++;
+            if (provided > maxSegments ||
+                !Number.isSafeInteger(segment.startMs) ||
+                !Number.isSafeInteger(segment.endMs) ||
+                segment.startMs < end ||
+                segment.endMs <= segment.startMs ||
+                segment.endMs > media.durationMs ||
+                typeof segment.text !== "string" ||
+                segment.text.includes("\0"))
+                throw new CliError("invalid_response", "invalid or excessive recognition segments");
+            end = segment.endMs;
+            const text = segment.text.trim();
+            if (text.length > maxTextBytes - textBytes)
+                throw new CliError("validation_error", "transcript exceeds its byte limit");
+            textBytes += new TextEncoder().encode(text).byteLength;
+            if (textBytes > maxTextBytes)
+                throw new CliError("validation_error", "transcript exceeds its byte limit");
+            if (text)
+                rows.push({
+                    position: rows.length,
+                    startMs: segment.startMs,
+                    endMs: segment.endMs,
+                    speakerName: null,
+                    text,
+                    normalizedText: null,
+                    metadata: null,
+                });
+        }
+        cancelled(context.signal);
+        if (!rows.length)
+            throw new CliError("not_found", "no speech was recognized");
+        const provenance = {
+            mediaSha256: media.contentHash,
+            engine: media.recognition.engine,
+            model: media.recognition.model,
+            modelVersion: media.recognition.version ?? null,
+            timing: media.recognition.timing,
+        };
+        const hash = await contentHash(JSON.stringify({ provenance, rows }));
+        cancelled(context.signal);
+        const append = await store.appendTranscriptsWithReceipt({
+            accountId,
+            externalId,
+            now,
+            transcripts: [
+                {
+                    source: `local/${encodeURIComponent(media.recognition.engine)}/${encodeURIComponent(media.recognition.model)}`,
+                    format: "local-transcription",
+                    language: null,
+                    contentHash: hash,
+                    externalCreatedAt: null,
+                    metadata: provenance,
+                    deletedAt: null,
+                    rows,
+                },
+            ],
+        });
+        let valid = false;
+        try {
+            const meeting = append?.meeting?.meeting;
+            valid =
+                meeting?.accountId === accountId &&
+                    meeting.externalId === externalId &&
+                    meeting.deletedAt === null &&
+                    Number.isSafeInteger(meeting.id) &&
+                    meeting.id > 0 &&
+                    append.created === false &&
+                    [append.insertedTranscripts, append.replayedTranscripts, append.supersededTranscripts].every((count) => Number.isSafeInteger(count) && count >= 0) &&
+                    append.insertedTranscripts + append.replayedTranscripts === 1;
+        }
+        catch {
+            valid = false;
+        }
+        if (!valid)
+            throw new CliError("outcome_unknown", "transcription append acknowledgement is invalid; verify stored state before retrying");
+        return { append, segments: rows.length };
+    });
+    return {
+        media,
+        accountId,
+        externalId,
+        applied: outcome.applied,
+        segments: outcome.value?.segments ?? 0,
+        ...(outcome.value ? { append: outcome.value.append } : {}),
+    };
+};
+//# sourceMappingURL=transcription.js.map