@elizaos/shared 2.0.0-beta.1 → 2.0.3-beta.3

package/transcripts.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Transcripts — the canonical contract for a recorded + transcribed session.
+ *
+ * One shape, shared across every layer: the ASR/diarization pipeline that
+ * PRODUCES a transcript (plugin-local-inference), the service that STORES it and
+ * mirrors its text into the knowledge/documents store, the API route + client
+ * that TRANSPORT it, and the Transcripts view that PLAYS it back with
+ * word-synced highlighting. Keeping the shape here (pure, browser- + node-safe)
+ * means the word-timing model is defined exactly once.
+ *
+ * Timing convention: every `startMs`/`endMs` is milliseconds from the START of
+ * the recording's audio (0 = first sample), so the same numbers drive both the
+ * stored record and the `<audio>.currentTime`-based player highlight.
+ */
+/** A single transcribed word with playback-synced timing (ms from audio start). */
+export interface TranscriptWord {
+    text: string;
+    startMs: number;
+    endMs: number;
+    /** ASR confidence 0..1, when the backend reports it. */
+    confidence?: number;
+}
+/**
+ * One diarized, word-timed span — a single speaker's contiguous utterance.
+ * `words` is empty only when the ASR backend supplied no per-word timing (the
+ * player then falls back to segment-level highlighting).
+ */
+export interface TranscriptSegment {
+    id: string;
+    /** Stable speaker label within this transcript (e.g. "Speaker 1" or a name). */
+    speakerLabel?: string;
+    /** Resolved elizaOS entity id when the voice was recognized (evidence-linked). */
+    speakerEntityId?: string;
+    startMs: number;
+    endMs: number;
+    /** Segment text (the join of `words`, or raw ASR text when words are absent). */
+    text: string;
+    words: TranscriptWord[];
+    confidence?: number;
+}
+export type TranscriptSource = "voice-session" | "import" | "call" | "unknown";
+/** Visibility scope — mirrors the documents store's `DocumentVisibilityScope`. */
+export type TranscriptScope = "owner-private" | "user-private" | "global" | "agent-private";
+export type TranscriptStatus = "recording" | "processing" | "ready" | "failed";
+/** A recorded + transcribed session: audio + word-timed diarized segments. */
+export interface Transcript {
+    id: string;
+    title: string;
+    /** Epoch ms when recording started. */
+    createdAt: number;
+    /** Epoch ms when the session ended; absent while still recording. */
+    endedAt?: number;
+    /** Epoch ms of the most recent user edit to the transcript text. */
+    editedAt?: number;
+    durationMs: number;
+    /** Served audio URL (content-addressed media store); absent if not retained. */
+    audioUrl?: string;
+    audioContentType?: string;
+    segments: TranscriptSegment[];
+    source: TranscriptSource;
+    scope: TranscriptScope;
+    status: TranscriptStatus;
+    /** The mirrored documents/knowledge item id (the searchable text copy). */
+    knowledgeDocumentId?: string;
+    /** Distinct speaker count across segments. */
+    speakerCount: number;
+    metadata?: Record<string, unknown>;
+}
+/** Compact list-row projection for the transcripts index. */
+export interface TranscriptSummary {
+    id: string;
+    title: string;
+    createdAt: number;
+    durationMs: number;
+    speakerCount: number;
+    status: TranscriptStatus;
+    /** First slice of the transcript text, for the list row. */
+    preview: string;
+    hasAudio: boolean;
+}
+/** Default characters of transcript text kept for a list-row preview. */
+export declare const TRANSCRIPT_PREVIEW_CHARS = 160;
+/** Distinct speaker labels across the segments (unlabeled segments ignored). */
+export declare function transcriptSpeakerCount(segments: ReadonlyArray<TranscriptSegment>): number;
+/** Recording length in ms — the largest segment end (0 when empty). */
+export declare function transcriptDurationMs(segments: ReadonlyArray<TranscriptSegment>): number;
+/**
+ * Render the transcript as plain, speaker-labeled lines — the exact text that is
+ * mirrored into the knowledge/documents store (so search + the provider read
+ * the same words a human sees) and used for previews. One line per segment:
+ * `Speaker: text` (label omitted when unknown).
+ */
+export declare function transcriptPlainText(segments: ReadonlyArray<TranscriptSegment>): string;
+/** A one-line preview of the transcript text, capped to `max` chars. */
+export declare function transcriptPreview(segments: ReadonlyArray<TranscriptSegment>, max?: number): string;
+/** Project a full transcript to its list-row summary. */
+export declare function summarizeTranscript(transcript: Transcript): TranscriptSummary;
+/** A word flattened across segments, carrying its origin indices for the UI. */
+export interface FlatTranscriptWord extends TranscriptWord {
+    segmentIndex: number;
+    wordIndex: number;
+}
+/** Flatten all segments' words into one time-ordered array (for player sync). */
+export declare function flattenTranscriptWords(segments: ReadonlyArray<TranscriptSegment>): FlatTranscriptWord[];
+/**
+ * Index of the word active at playback time `ms` within a flattened, ascending
+ * word list, via binary search (cheap enough to call every `timeupdate`/frame).
+ * Returns the last word whose `startMs <= ms`; -1 before the first word starts.
+ * A word stays "active" until the next word begins, so gaps between words keep
+ * the previous word lit rather than flickering off.
+ */
+export declare function activeWordIndex(words: ReadonlyArray<FlatTranscriptWord>, ms: number): number;
+/** A single invariant violation found by {@link validateAsrWordTimings}. */
+export interface WordTimingViolation {
+    index: number;
+    word: string;
+    reason: string;
+}
+/** Result of validating a word-timed sequence against the player contract. */
+export interface WordTimingValidation {
+    ok: boolean;
+    violations: WordTimingViolation[];
+}
+/**
+ * Validate per-word timings against the contract the transcript player relies
+ * on — and that the fused ASR v12 (`eliza_inference_asr_transcribe_timed`) MUST
+ * satisfy for its output to be playable:
+ *
+ *   - every word has non-empty text and finite `0 <= startMs <= endMs`,
+ *   - spans are ordered and non-overlapping (each word starts no earlier than
+ *     the previous word ends, within `toleranceMs`),
+ *   - every span lies within `[0, audioDurationMs]` (the exact decoded audio
+ *     length, `1000 * n_samples / sample_rate`).
+ *
+ * Pass `audioDurationMs = 0` to skip the upper-bound check. `toleranceMs`
+ * absorbs the integer rounding the native char-proportional timing applies at
+ * word boundaries. The same function gates the player highlight, the ASR bench,
+ * and the real-audio FFI test so all three agree on what "well-formed" means.
+ */
+export declare function validateAsrWordTimings(words: ReadonlyArray<TranscriptWord>, audioDurationMs?: number, toleranceMs?: number): WordTimingValidation;
+//# sourceMappingURL=transcripts.d.ts.map

package/transcripts.d.ts.map

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

package/transcripts.js

@@ -0,0 +1,162 @@
+/**
+ * Transcripts — the canonical contract for a recorded + transcribed session.
+ *
+ * One shape, shared across every layer: the ASR/diarization pipeline that
+ * PRODUCES a transcript (plugin-local-inference), the service that STORES it and
+ * mirrors its text into the knowledge/documents store, the API route + client
+ * that TRANSPORT it, and the Transcripts view that PLAYS it back with
+ * word-synced highlighting. Keeping the shape here (pure, browser- + node-safe)
+ * means the word-timing model is defined exactly once.
+ *
+ * Timing convention: every `startMs`/`endMs` is milliseconds from the START of
+ * the recording's audio (0 = first sample), so the same numbers drive both the
+ * stored record and the `<audio>.currentTime`-based player highlight.
+ */
+/** Default characters of transcript text kept for a list-row preview. */
+export const TRANSCRIPT_PREVIEW_CHARS = 160;
+/** Distinct speaker labels across the segments (unlabeled segments ignored). */
+export function transcriptSpeakerCount(segments) {
+    const labels = new Set();
+    for (const s of segments)
+        if (s.speakerLabel)
+            labels.add(s.speakerLabel);
+    return labels.size;
+}
+/** Recording length in ms — the largest segment end (0 when empty). */
+export function transcriptDurationMs(segments) {
+    let max = 0;
+    for (const s of segments)
+        if (s.endMs > max)
+            max = s.endMs;
+    return max;
+}
+/**
+ * Render the transcript as plain, speaker-labeled lines — the exact text that is
+ * mirrored into the knowledge/documents store (so search + the provider read
+ * the same words a human sees) and used for previews. One line per segment:
+ * `Speaker: text` (label omitted when unknown).
+ */
+export function transcriptPlainText(segments) {
+    return segments
+        .map((s) => {
+        const text = s.text.trim();
+        if (!text)
+            return "";
+        return s.speakerLabel ? `${s.speakerLabel}: ${text}` : text;
+    })
+        .filter((line) => line.length > 0)
+        .join("\n");
+}
+/** A one-line preview of the transcript text, capped to `max` chars. */
+export function transcriptPreview(segments, max = TRANSCRIPT_PREVIEW_CHARS) {
+    const flat = segments
+        .map((s) => s.text.trim())
+        .filter(Boolean)
+        .join(" ")
+        .replace(/\s+/g, " ")
+        .trim();
+    return flat.length > max ? `${flat.slice(0, max - 1).trimEnd()}…` : flat;
+}
+/** Project a full transcript to its list-row summary. */
+export function summarizeTranscript(transcript) {
+    return {
+        id: transcript.id,
+        title: transcript.title,
+        createdAt: transcript.createdAt,
+        durationMs: transcript.durationMs,
+        speakerCount: transcript.speakerCount,
+        status: transcript.status,
+        preview: transcriptPreview(transcript.segments),
+        hasAudio: Boolean(transcript.audioUrl),
+    };
+}
+/** Flatten all segments' words into one time-ordered array (for player sync). */
+export function flattenTranscriptWords(segments) {
+    const out = [];
+    segments.forEach((segment, segmentIndex) => {
+        segment.words.forEach((word, wordIndex) => {
+            out.push({ ...word, segmentIndex, wordIndex });
+        });
+    });
+    return out;
+}
+/**
+ * Index of the word active at playback time `ms` within a flattened, ascending
+ * word list, via binary search (cheap enough to call every `timeupdate`/frame).
+ * Returns the last word whose `startMs <= ms`; -1 before the first word starts.
+ * A word stays "active" until the next word begins, so gaps between words keep
+ * the previous word lit rather than flickering off.
+ */
+export function activeWordIndex(words, ms) {
+    let lo = 0;
+    let hi = words.length - 1;
+    let found = -1;
+    while (lo <= hi) {
+        const mid = (lo + hi) >> 1;
+        if (words[mid].startMs <= ms) {
+            found = mid;
+            lo = mid + 1;
+        }
+        else {
+            hi = mid - 1;
+        }
+    }
+    return found;
+}
+/**
+ * Validate per-word timings against the contract the transcript player relies
+ * on — and that the fused ASR v12 (`eliza_inference_asr_transcribe_timed`) MUST
+ * satisfy for its output to be playable:
+ *
+ *   - every word has non-empty text and finite `0 <= startMs <= endMs`,
+ *   - spans are ordered and non-overlapping (each word starts no earlier than
+ *     the previous word ends, within `toleranceMs`),
+ *   - every span lies within `[0, audioDurationMs]` (the exact decoded audio
+ *     length, `1000 * n_samples / sample_rate`).
+ *
+ * Pass `audioDurationMs = 0` to skip the upper-bound check. `toleranceMs`
+ * absorbs the integer rounding the native char-proportional timing applies at
+ * word boundaries. The same function gates the player highlight, the ASR bench,
+ * and the real-audio FFI test so all three agree on what "well-formed" means.
+ */
+export function validateAsrWordTimings(words, audioDurationMs = 0, toleranceMs = 1) {
+    const violations = [];
+    let prevEndMs = 0;
+    words.forEach((w, index) => {
+        const word = w.text;
+        if (typeof word !== "string" || word.trim().length === 0) {
+            violations.push({ index, word: String(word), reason: "empty word text" });
+        }
+        if (!Number.isFinite(w.startMs) || !Number.isFinite(w.endMs)) {
+            violations.push({ index, word, reason: "non-finite timing" });
+            return;
+        }
+        if (w.startMs < -toleranceMs) {
+            violations.push({ index, word, reason: `startMs ${w.startMs} < 0` });
+        }
+        if (w.endMs < w.startMs - toleranceMs) {
+            violations.push({
+                index,
+                word,
+                reason: `endMs ${w.endMs} precedes startMs ${w.startMs}`,
+            });
+        }
+        if (w.startMs < prevEndMs - toleranceMs) {
+            violations.push({
+                index,
+                word,
+                reason: `startMs ${w.startMs} overlaps previous end ${prevEndMs}`,
+            });
+        }
+        if (audioDurationMs > 0 && w.endMs > audioDurationMs + toleranceMs) {
+            violations.push({
+                index,
+                word,
+                reason: `endMs ${w.endMs} exceeds audio duration ${audioDurationMs}`,
+            });
+        }
+        prevEndMs = Math.max(prevEndMs, w.endMs);
+    });
+    return { ok: violations.length === 0, violations };
+}
+//# sourceMappingURL=transcripts.js.map

package/transcripts.js.map

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

package/type-guards.d.ts

@@ -0,0 +1,7 @@
+export type UnknownRecord = Record<string, unknown>;
+export declare function isPlainObject(value: unknown): value is UnknownRecord;
+export declare function asRecord(value: unknown): UnknownRecord | null;
+export declare function asRecordOrUndefined(value: unknown): UnknownRecord | undefined;
+export declare function asObjectArray(value: unknown): UnknownRecord[];
+export declare function asNonEmptyString(value: unknown): string | undefined;
+//# sourceMappingURL=type-guards.d.ts.map

package/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../src/type-guards.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOpE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAK7D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAE7E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,EAAE,CAM7D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAInE"}

package/type-guards.js

@@ -0,0 +1,27 @@
+export function isPlainObject(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.prototype.toString.call(value) === "[object Object]");
+}
+export function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+export function asRecordOrUndefined(value) {
+    return asRecord(value) ?? undefined;
+}
+export function asObjectArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item));
+}
+export function asNonEmptyString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+//# sourceMappingURL=type-guards.js.map

package/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../src/type-guards.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,CACjB,CAAC,IAAI,EAAyB,EAAE,CAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}