@elizaos/plugin-local-inference 2.0.0-beta.1 → 2.0.3-beta.2

package/src/services/voice/transcript-knowledge.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Transcript → knowledge (documents store) mapping (#8789 transcripts).
+ *
+ * A finished transcript is mirrored into the documents/knowledge store as a
+ * private, searchable text item so it is parsable/readable from the Knowledge
+ * view, surfaced by the documents provider, and found by the document `search`
+ * action — exactly as a user would expect "search my transcripts" to work. The
+ * structured record (audio + word timings + diarization) stays the source of
+ * truth in the transcript store; this is the denormalized search copy, linked
+ * back by `metadata.transcriptId`.
+ *
+ * Pure: it builds the documents-store *fields* from a shared `Transcript`; the
+ * service combines them with the runtime UUIDs (world/room/entity/client ids)
+ * and `addedFrom` to call `DocumentService.addDocument`.
+ */
+import type { Transcript, TranscriptScope } from "@elizaos/shared/transcripts";
+/** The documents-store fields derived from a transcript (sans runtime UUIDs). */
+export interface TranscriptKnowledgePayload {
+    /** Plain, speaker-labeled transcript text — the searchable + chunked body. */
+    content: string;
+    /** Suggested filename (slugified title + `.txt`). */
+    filename: string;
+    contentType: string;
+    scope: TranscriptScope;
+    /** Metadata merged onto the document — tags + the link back to the record. */
+    metadata: Record<string, unknown>;
+}
+/** Tag every mirrored transcript carries so it's filterable as a transcript. */
+export declare const TRANSCRIPT_DOCUMENT_TAG = "transcript";
+/**
+ * Build the documents-store fields for mirroring a transcript into knowledge.
+ * The body is the speaker-labeled plain text (what gets embedded + searched);
+ * `metadata.transcriptId` links the knowledge item back to the rich record so a
+ * Knowledge-view consumer can open it in the player.
+ */
+export declare function transcriptKnowledgePayload(transcript: Transcript): TranscriptKnowledgePayload;
+//# sourceMappingURL=transcript-knowledge.d.ts.map

package/src/services/voice/transcript-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-knowledge.d.ts","sourceRoot":"","sources":["transcript-knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG/E,iFAAiF;AACjF,MAAM,WAAW,0BAA0B;IAC1C,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,eAAe,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAYpD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,UAAU,GACpB,0BAA0B,CAsB5B"}

package/src/services/voice/transcript-knowledge.test.ts

@@ -0,0 +1,68 @@
+import type { Transcript } from "@elizaos/shared/transcripts";
+import { describe, expect, it } from "vitest";
+import {
+	TRANSCRIPT_DOCUMENT_TAG,
+	transcriptKnowledgePayload,
+} from "./transcript-knowledge";
+
+const transcript: Transcript = {
+	id: "t-123",
+	title: "Standup — June 20",
+	createdAt: 1000,
+	endedAt: 5000,
+	durationMs: 4000,
+	audioUrl: "/api/media/abc.wav",
+	source: "voice-session",
+	scope: "owner-private",
+	status: "ready",
+	speakerCount: 2,
+	segments: [
+		{
+			id: "s1",
+			speakerLabel: "Alice",
+			startMs: 0,
+			endMs: 1000,
+			text: "ship the build",
+			words: [],
+		},
+		{
+			id: "s2",
+			speakerLabel: "Bob",
+			startMs: 1200,
+			endMs: 2000,
+			text: "on it",
+			words: [],
+		},
+	],
+};
+
+describe("transcriptKnowledgePayload", () => {
+	it("builds a searchable text document linked back to the transcript", () => {
+		const p = transcriptKnowledgePayload(transcript);
+		// Body is the speaker-labeled plain text (what gets embedded + searched).
+		expect(p.content).toBe("Alice: ship the build\nBob: on it");
+		expect(p.contentType).toBe("text/plain");
+		expect(p.scope).toBe("owner-private");
+		// Slugified filename.
+		expect(p.filename).toBe("standup-june-20.txt");
+		// Tagged + linked back to the rich record.
+		expect(p.metadata.tags).toEqual([TRANSCRIPT_DOCUMENT_TAG]);
+		expect(p.metadata.source).toBe(TRANSCRIPT_DOCUMENT_TAG);
+		expect(p.metadata.transcriptId).toBe("t-123");
+		expect(p.metadata.title).toBe("Standup — June 20");
+		expect(p.metadata.audioUrl).toBe("/api/media/abc.wav");
+		expect(p.metadata.durationMs).toBe(4000);
+		expect(p.metadata.speakerCount).toBe(2);
+		expect(p.metadata.textBacked).toBe(true);
+	});
+
+	it("omits audioUrl when the transcript has no audio, and slugs an empty title", () => {
+		const p = transcriptKnowledgePayload({
+			...transcript,
+			title: "  ",
+			audioUrl: undefined,
+		});
+		expect(p.metadata.audioUrl).toBeUndefined();
+		expect(p.filename).toBe("transcript.txt");
+	});
+});

package/src/services/voice/transcript-knowledge.ts

@@ -0,0 +1,75 @@
+/**
+ * Transcript → knowledge (documents store) mapping (#8789 transcripts).
+ *
+ * A finished transcript is mirrored into the documents/knowledge store as a
+ * private, searchable text item so it is parsable/readable from the Knowledge
+ * view, surfaced by the documents provider, and found by the document `search`
+ * action — exactly as a user would expect "search my transcripts" to work. The
+ * structured record (audio + word timings + diarization) stays the source of
+ * truth in the transcript store; this is the denormalized search copy, linked
+ * back by `metadata.transcriptId`.
+ *
+ * Pure: it builds the documents-store *fields* from a shared `Transcript`; the
+ * service combines them with the runtime UUIDs (world/room/entity/client ids)
+ * and `addedFrom` to call `DocumentService.addDocument`.
+ */
+
+import type { Transcript, TranscriptScope } from "@elizaos/shared/transcripts";
+import { transcriptPlainText } from "@elizaos/shared/transcripts";
+
+/** The documents-store fields derived from a transcript (sans runtime UUIDs). */
+export interface TranscriptKnowledgePayload {
+	/** Plain, speaker-labeled transcript text — the searchable + chunked body. */
+	content: string;
+	/** Suggested filename (slugified title + `.txt`). */
+	filename: string;
+	contentType: string;
+	scope: TranscriptScope;
+	/** Metadata merged onto the document — tags + the link back to the record. */
+	metadata: Record<string, unknown>;
+}
+
+/** Tag every mirrored transcript carries so it's filterable as a transcript. */
+export const TRANSCRIPT_DOCUMENT_TAG = "transcript";
+
+/** Lowercase ascii slug for a filename (fallback "transcript"). */
+function slugify(title: string): string {
+	const slug = title
+		.toLowerCase()
+		.replace(/[^a-z0-9]+/g, "-")
+		.replace(/^-+|-+$/g, "")
+		.slice(0, 64);
+	return slug || "transcript";
+}
+
+/**
+ * Build the documents-store fields for mirroring a transcript into knowledge.
+ * The body is the speaker-labeled plain text (what gets embedded + searched);
+ * `metadata.transcriptId` links the knowledge item back to the rich record so a
+ * Knowledge-view consumer can open it in the player.
+ */
+export function transcriptKnowledgePayload(
+	transcript: Transcript,
+): TranscriptKnowledgePayload {
+	const metadata: Record<string, unknown> = {
+		source: TRANSCRIPT_DOCUMENT_TAG,
+		tags: [TRANSCRIPT_DOCUMENT_TAG],
+		transcriptId: transcript.id,
+		title: transcript.title,
+		durationMs: transcript.durationMs,
+		speakerCount: transcript.speakerCount,
+		createdAt: transcript.createdAt,
+		// Mark as text-backed so the documents UI treats it as editable/previewable
+		// text rather than an opaque binary upload.
+		textBacked: true,
+	};
+	if (transcript.audioUrl) metadata.audioUrl = transcript.audioUrl;
+
+	return {
+		content: transcriptPlainText(transcript.segments),
+		filename: `${slugify(transcript.title)}.txt`,
+		contentType: "text/plain",
+		scope: transcript.scope,
+		metadata,
+	};
+}

package/src/services/voice/transcript-service.d.ts

@@ -0,0 +1,41 @@
+/**
+ * TranscriptService (#8789) — orchestrates a finished recording into both homes:
+ * the rich {@link TranscriptStore} record (source of truth: audio + word-timed
+ * diarized segments) AND a searchable knowledge/documents mirror, linked by
+ * `knowledgeDocumentId`. Create mirrors first (best-effort — a search-index
+ * failure must not lose the recording), then persists the record carrying the
+ * link. Delete removes the mirror too.
+ */
+import { type UUID } from "@elizaos/core";
+import type { Transcript, TranscriptSummary } from "@elizaos/shared/transcripts";
+import { type TranscriptStoreRuntime } from "./transcript-store";
+/** Store runtime + service resolution (the real IAgentRuntime satisfies it). */
+export interface TranscriptServiceRuntime extends TranscriptStoreRuntime {
+    getService<T>(name: string): T | null;
+}
+export interface CreateTranscriptInput {
+    worldId: UUID;
+    roomId: UUID;
+    /** The owner/speaker entity the recording is attributed to. */
+    entityId: UUID;
+    transcript: Transcript;
+}
+export declare class TranscriptService {
+    private readonly runtime;
+    private readonly store;
+    constructor(runtime: TranscriptServiceRuntime);
+    /** Mirror the transcript text into knowledge, then persist the record. */
+    create(input: CreateTranscriptInput): Promise<Transcript>;
+    list(roomId?: UUID, limit?: number): Promise<TranscriptSummary[]>;
+    get(id: UUID): Promise<Transcript | null>;
+    /** Delete the record + its knowledge mirror (mirror removal best-effort). */
+    delete(id: UUID): Promise<void>;
+    /**
+     * Best-effort mirror into the documents store. Returns the stored document id
+     * to link, or undefined when no documents service is loaded or the mirror
+     * fails — the recording still persists either way (the link is a secondary
+     * search index, never the source of truth).
+     */
+    private mirrorToKnowledge;
+}
+//# sourceMappingURL=transcript-service.d.ts.map

package/src/services/voice/transcript-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-service.d.ts","sourceRoot":"","sources":["transcript-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EACX,UAAU,EAEV,iBAAiB,EACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,oBAAoB,CAAC;AAkB5B,gFAAgF;AAChF,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACvE,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,IAAI,CAAC;IACb,+DAA+D;IAC/D,QAAQ,EAAE,IAAI,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAGjB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;gBAEX,OAAO,EAAE,wBAAwB;IAI9D,0EAA0E;IACpE,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAc/D,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIjE,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIzC,6EAA6E;IACvE,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrC;;;;;OAKG;YACW,iBAAiB;CAkC/B"}

package/src/services/voice/transcript-service.test.ts

@@ -0,0 +1,137 @@
+import type { Memory, UUID } from "@elizaos/core";
+import type { Transcript } from "@elizaos/shared/transcripts";
+import { describe, expect, it, vi } from "vitest";
+import {
+	type CreateTranscriptInput,
+	TranscriptService,
+	type TranscriptServiceRuntime,
+} from "./transcript-service";
+
+const WORLD = "00000000-0000-0000-0000-0000000000ww" as UUID;
+const ROOM = "11111111-1111-1111-1111-111111111111" as UUID;
+const ENTITY = "22222222-2222-2222-2222-222222222222" as UUID;
+
+function makeTranscript(): Transcript {
+	return {
+		id: "aaaaaaaa-0000-0000-0000-000000000001",
+		title: "Standup",
+		createdAt: 1000,
+		durationMs: 2000,
+		audioUrl: "/api/media/x.wav",
+		source: "voice-session",
+		scope: "owner-private",
+		status: "ready",
+		speakerCount: 1,
+		segments: [
+			{
+				id: "s1",
+				speakerLabel: "Alice",
+				startMs: 0,
+				endMs: 2000,
+				text: "hi",
+				words: [],
+			},
+		],
+	};
+}
+
+function fakeRuntime(opts: {
+	withDocuments: boolean;
+}): TranscriptServiceRuntime & {
+	rows: Map<string, Memory>;
+	addDocument: ReturnType<typeof vi.fn>;
+} {
+	const rows = new Map<string, Memory>();
+	const addDocument = vi.fn(async () => ({
+		storedDocumentMemoryId: "dddddddd-0000-0000-0000-000000000001" as UUID,
+	}));
+	return {
+		rows,
+		addDocument,
+		agentId: "agent-1" as UUID,
+		async createMemory(memory) {
+			rows.set(memory.id as string, memory);
+			return memory.id as UUID;
+		},
+		async getMemories() {
+			return [...rows.values()];
+		},
+		async getMemoryById(id) {
+			return rows.get(id) ?? null;
+		},
+		async deleteMemory(id) {
+			rows.delete(id);
+		},
+		getService<T>(name: string): T | null {
+			if (name === "documents" && opts.withDocuments) {
+				return { addDocument } as unknown as T;
+			}
+			return null;
+		},
+	};
+}
+
+const input = (transcript: Transcript): CreateTranscriptInput => ({
+	worldId: WORLD,
+	roomId: ROOM,
+	entityId: ENTITY,
+	transcript,
+});
+
+describe("TranscriptService", () => {
+	it("mirrors the transcript into knowledge and links the document id", async () => {
+		const rt = fakeRuntime({ withDocuments: true });
+		const svc = new TranscriptService(rt);
+		const t = makeTranscript();
+		const saved = await svc.create(input(t));
+
+		// Mirror called with the searchable text + transcript link metadata.
+		expect(rt.addDocument).toHaveBeenCalledTimes(1);
+		const opts = rt.addDocument.mock.calls[0][0];
+		expect(opts.content).toBe("Alice: hi");
+		expect(opts.scope).toBe("owner-private");
+		expect(opts.clientDocumentId).toBe(t.id);
+		expect((opts.metadata as { transcriptId: string }).transcriptId).toBe(t.id);
+
+		// The stored record carries the knowledge link.
+		expect(saved.knowledgeDocumentId).toBe(
+			"dddddddd-0000-0000-0000-000000000001",
+		);
+		const got = await svc.get(t.id as UUID);
+		expect(got?.knowledgeDocumentId).toBe(
+			"dddddddd-0000-0000-0000-000000000001",
+		);
+	});
+
+	it("still persists the record when no documents service is loaded", async () => {
+		const rt = fakeRuntime({ withDocuments: false });
+		const svc = new TranscriptService(rt);
+		const t = makeTranscript();
+		const saved = await svc.create(input(t));
+		expect(rt.addDocument).not.toHaveBeenCalled();
+		expect(saved.knowledgeDocumentId).toBeUndefined();
+		expect(await svc.get(t.id as UUID)).toEqual(t);
+	});
+
+	it("persists the record even if the mirror throws (recording is never lost)", async () => {
+		const rt = fakeRuntime({ withDocuments: true });
+		rt.addDocument.mockRejectedValueOnce(new Error("docs down"));
+		const svc = new TranscriptService(rt);
+		const t = makeTranscript();
+		const saved = await svc.create(input(t));
+		expect(saved.knowledgeDocumentId).toBeUndefined();
+		expect(await svc.get(t.id as UUID)).not.toBeNull();
+	});
+
+	it("removes the knowledge mirror on delete", async () => {
+		const rt = fakeRuntime({ withDocuments: true });
+		const svc = new TranscriptService(rt);
+		const t = makeTranscript();
+		await svc.create(input(t));
+		const docId = "dddddddd-0000-0000-0000-000000000001";
+		rt.rows.set(docId, { id: docId } as Memory); // stand-in for the doc row
+		await svc.delete(t.id as UUID);
+		expect(rt.rows.has(t.id)).toBe(false);
+		expect(rt.rows.has(docId)).toBe(false);
+	});
+});

package/src/services/voice/transcript-service.ts

@@ -0,0 +1,141 @@
+/**
+ * TranscriptService (#8789) — orchestrates a finished recording into both homes:
+ * the rich {@link TranscriptStore} record (source of truth: audio + word-timed
+ * diarized segments) AND a searchable knowledge/documents mirror, linked by
+ * `knowledgeDocumentId`. Create mirrors first (best-effort — a search-index
+ * failure must not lose the recording), then persists the record carrying the
+ * link. Delete removes the mirror too.
+ */
+
+import { logger, type UUID } from "@elizaos/core";
+import type {
+	Transcript,
+	TranscriptScope,
+	TranscriptSummary,
+} from "@elizaos/shared/transcripts";
+import { transcriptKnowledgePayload } from "./transcript-knowledge";
+import {
+	TranscriptStore,
+	type TranscriptStoreRuntime,
+} from "./transcript-store";
+
+/** The documents/knowledge service surface the mirror needs (structural). */
+interface DocumentsLike {
+	addDocument(options: {
+		worldId: UUID;
+		roomId: UUID;
+		entityId: UUID;
+		clientDocumentId: UUID;
+		contentType: string;
+		originalFilename: string;
+		content: string;
+		scope?: TranscriptScope;
+		addedFrom?: string;
+		metadata?: Record<string, unknown>;
+	}): Promise<{ storedDocumentMemoryId: UUID }>;
+}
+
+/** Store runtime + service resolution (the real IAgentRuntime satisfies it). */
+export interface TranscriptServiceRuntime extends TranscriptStoreRuntime {
+	getService<T>(name: string): T | null;
+}
+
+export interface CreateTranscriptInput {
+	worldId: UUID;
+	roomId: UUID;
+	/** The owner/speaker entity the recording is attributed to. */
+	entityId: UUID;
+	transcript: Transcript;
+}
+
+export class TranscriptService {
+	private readonly store: TranscriptStore;
+
+	constructor(private readonly runtime: TranscriptServiceRuntime) {
+		this.store = new TranscriptStore(runtime);
+	}
+
+	/** Mirror the transcript text into knowledge, then persist the record. */
+	async create(input: CreateTranscriptInput): Promise<Transcript> {
+		const { worldId, roomId, entityId, transcript } = input;
+		const knowledgeDocumentId = await this.mirrorToKnowledge(
+			worldId,
+			roomId,
+			entityId,
+			transcript,
+		);
+		const record = knowledgeDocumentId
+			? { ...transcript, knowledgeDocumentId }
+			: transcript;
+		return this.store.create({ roomId, entityId, transcript: record });
+	}
+
+	list(roomId?: UUID, limit?: number): Promise<TranscriptSummary[]> {
+		return this.store.list(roomId, limit);
+	}
+
+	get(id: UUID): Promise<Transcript | null> {
+		return this.store.get(id);
+	}
+
+	/** Delete the record + its knowledge mirror (mirror removal best-effort). */
+	async delete(id: UUID): Promise<void> {
+		const existing = await this.store.get(id);
+		if (existing?.knowledgeDocumentId) {
+			try {
+				await this.runtime.deleteMemory(existing.knowledgeDocumentId as UUID);
+			} catch (err) {
+				logger.warn(
+					{
+						transcriptId: id,
+						knowledgeDocumentId: existing.knowledgeDocumentId,
+						error: err instanceof Error ? err.message : String(err),
+					},
+					"[TranscriptService] failed to remove knowledge mirror",
+				);
+			}
+		}
+		await this.store.delete(id);
+	}
+
+	/**
+	 * Best-effort mirror into the documents store. Returns the stored document id
+	 * to link, or undefined when no documents service is loaded or the mirror
+	 * fails — the recording still persists either way (the link is a secondary
+	 * search index, never the source of truth).
+	 */
+	private async mirrorToKnowledge(
+		worldId: UUID,
+		roomId: UUID,
+		entityId: UUID,
+		transcript: Transcript,
+	): Promise<string | undefined> {
+		const documents = this.runtime.getService<DocumentsLike>("documents");
+		if (!documents) return undefined;
+		try {
+			const payload = transcriptKnowledgePayload(transcript);
+			const res = await documents.addDocument({
+				worldId,
+				roomId,
+				entityId,
+				clientDocumentId: transcript.id as UUID,
+				contentType: payload.contentType,
+				originalFilename: payload.filename,
+				content: payload.content,
+				scope: payload.scope,
+				addedFrom: "runtime-internal",
+				metadata: payload.metadata,
+			});
+			return res.storedDocumentMemoryId;
+		} catch (err) {
+			logger.warn(
+				{
+					transcriptId: transcript.id,
+					error: err instanceof Error ? err.message : String(err),
+				},
+				"[TranscriptService] knowledge mirror failed",
+			);
+			return undefined;
+		}
+	}
+}

package/src/services/voice/transcript-store.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Transcript store (#8789 transcripts) — persistence for the rich transcript
+ * record (audio URL + word-timed diarized segments).
+ *
+ * Reuses the runtime's proven `memories` partition mechanism (exactly how the
+ * documents store works) rather than a new table/migration: each transcript is
+ * one memory row in the `"transcripts"` partition, with the full {@link Transcript}
+ * in `content.transcript`. The player loads a whole record by id and the list
+ * reads recent rows — no querying INSIDE segments is needed, because search is
+ * served by the knowledge mirror (see `transcript-knowledge.ts`). A custom
+ * `metadata.type` keeps it clear of the document/fragment CHECK constraints.
+ */
+import type { Memory, UUID } from "@elizaos/core";
+import type { Transcript, TranscriptSummary } from "@elizaos/shared/transcripts";
+/** The `type` column partition transcripts live in (sibling to "messages"). */
+export declare const TRANSCRIPTS_TABLE = "transcripts";
+/** `metadata.type` marker — NOT "document"/"fragment", so no CHECK fires. */
+export declare const TRANSCRIPT_METADATA_TYPE = "transcript";
+/** The subset of `IAgentRuntime` the store needs (real runtime satisfies it). */
+export interface TranscriptStoreRuntime {
+    agentId: UUID;
+    createMemory(memory: Memory, tableName: string, unique?: boolean): Promise<UUID>;
+    getMemories(params: {
+        tableName: string;
+        roomId?: UUID;
+        count?: number;
+        orderBy?: "createdAt";
+        orderDirection?: "asc" | "desc";
+    }): Promise<Memory[]>;
+    getMemoryById(id: UUID): Promise<Memory | null>;
+    deleteMemory(id: UUID): Promise<void>;
+}
+export interface CreateTranscriptInput {
+    roomId: UUID;
+    /** The owner/speaker entity the recording is attributed to. */
+    entityId: UUID;
+    /** The fully-built transcript record (audio + segments + words). */
+    transcript: Transcript;
+}
+/** CRUD for transcript records over the runtime memory partition. */
+export declare class TranscriptStore {
+    private readonly runtime;
+    constructor(runtime: TranscriptStoreRuntime);
+    /** Persist a transcript record; returns it unchanged. */
+    create(input: CreateTranscriptInput): Promise<Transcript>;
+    /** List recent transcripts (newest first) as compact summaries. */
+    list(roomId?: UUID, limit?: number): Promise<TranscriptSummary[]>;
+    /** Load one full transcript record by id. */
+    get(id: UUID): Promise<Transcript | null>;
+    /** Delete a transcript record (the knowledge mirror is removed separately). */
+    delete(id: UUID): Promise<void>;
+}
+//# sourceMappingURL=transcript-store.d.ts.map

package/src/services/voice/transcript-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-store.d.ts","sourceRoot":"","sources":["transcript-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EACX,UAAU,EACV,iBAAiB,EACjB,MAAM,6BAA6B,CAAC;AAMrC,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C,6EAA6E;AAC7E,eAAO,MAAM,wBAAwB,eAAe,CAAC;AAErD,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,IAAI,CAAC;IACd,YAAY,CACX,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,WAAW,CAAC,MAAM,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,WAAW,CAAC;QACtB,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KAChC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtB,aAAa,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChD,YAAY,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,IAAI,CAAC;IACb,+DAA+D;IAC/D,QAAQ,EAAE,IAAI,CAAC;IACf,oEAAoE;IACpE,UAAU,EAAE,UAAU,CAAC;CACvB;AAeD,qEAAqE;AACrE,qBAAa,eAAe;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,sBAAsB;IAE5D,yDAAyD;IACnD,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IA+B/D,mEAAmE;IAC7D,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAgBpE,6CAA6C;IACvC,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAK/C,+EAA+E;IACzE,MAAM,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrC"}