@ai-ecoverse/pi-audio 1.13.0 → 1.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -23,8 +23,11 @@ pi-audio does not apply that patch. Hosts such as slicc-agent record monkeypatch
23
23
 
24
24
  `@ai-ecoverse/pi-audio/durable` appends a `voice.truncate` entry for a `VoiceCut`. The entry has no model messages. Its `edits` replace the target assistant message with the text heard so far and keep tool calls. The stored entry stays intact, and pi-durable derives the shorter message for the next model request. `@earendil-works/pi-durable` is an optional peer (`^1.1.0`); the root package does not import it. `VoiceCut.entryId` is the decimal string of pi-durable's numeric entry id.
25
25
 
26
+ `@ai-ecoverse/pi-audio/mistral` registers Mistral speech adapters when `registerMistral()` is called. `voxtral-mini-latest` posts multipart audio to `/audio/transcriptions` ($0.003 per minute, diarization on). `voxtral-mini-transcribe-realtime-2602` streams base64 PCM on `wss://…/audio/transcriptions/realtime` after `session.created` ($0.006 per minute). Realtime has no server endpointing, so `turnDetection` is `none` and the registry VAD wrapper applies. `voxtral-mini-tts-2603` posts JSON to `/audio/speech` and reads SSE `speech.audio.delta` float32 PCM at 24 kHz ($0.016 per thousand characters). Hosted voice ids such as `en_paul_neutral` differ from the open-weight presets. `textStreaming` is false.
27
+
26
28
  `@ai-ecoverse/pi-audio/elevenlabs` registers ElevenLabs speech adapters when `registerElevenLabs()` is called. `scribe_v2` posts multipart audio to `/speech-to-text`. `scribe_v2_realtime` streams base64 audio on `wss://…/speech-to-text/realtime` and commits turns with `turn_prediction` (`turnDetection: 'semantic'`). `eleven_flash_v2_5` and `eleven_multilingual_v2` post JSON to `/text-to-speech/{voice}/with-timestamps` for a string and stream text on `stream-input` for an async iterable, with character alignment. `eleven_v3` and `eleven_v4` stay on the HTTP path (`textStreaming: false`). Scribe prices are $0.22 per hour for batch and $0.39 per hour for realtime.
27
29
 
30
+ `voiceTurns` captions include `agent_spoken`. `upTo` follows `AudioSink` playback: per character when the chunk has alignment, and evenly across the sentence when it does not. `captionsFromHistory(entries)` rebuilds user captions from entries whose `data.source` is `voice`, and agent captions from the assistant text. A `voice.truncate` entry adds `agent_spoken` and `agent_cut` at `heardUpTo`, so the rest of the original text stays available as unheard.
28
31
  `@ai-ecoverse/pi-audio/xai` registers xAI speech adapters when `registerXAI()` is called. `grok-voice-transcribe-2.0` posts multipart audio to `/stt` (fields before `file`) and streams raw binary frames on `wss://…/stt` after `transcript.created`, with Smart Turn (`turnDetection: 'semantic'`). The catalog id is shared, so `audioCost` uses the streaming rate of $0.20 per hour. `grok-voice-tts-1.0` posts JSON to `/tts` for a string and streams `text.delta` / `audio.delta` on `wss://…/tts` for an async iterable (`textStreaming: true`). Voices are eve, ara, rex, sal, and leo. Codecs are mp3, pcm, wav, mulaw, and alaw.
29
32
 
30
33
  `@ai-ecoverse/pi-audio/openai` registers OpenAI and OpenRouter speech adapters when `registerOpenAI()` is called. Batch transcription posts multipart audio to `/audio/transcriptions`. OpenRouter (`provider` `openrouter`, or a base URL on `openrouter.ai`) posts JSON `input_audio` instead. Speech posts JSON to `/audio/speech` and reads the raw audio response. OpenAI can return pcm, mp3, wav, opus, or flac. OpenRouter returns pcm or mp3. Realtime transcription uses a WebSocket at `/realtime?intent=transcription` for `gpt-realtime-whisper` and `gpt-live-transcribe`. The catalog key is type, provider, and id, so the batch model keeps the id `gpt-4o-transcribe`.
@@ -0,0 +1,150 @@
1
+ function spokenOffset(clock, offsetMs) {
2
+ const length = clock.end - clock.start;
3
+ if (length <= 0) return clock.start;
4
+ const alignment = clock.alignment;
5
+ if (alignment && alignment.startMs.length === length && alignment.durationMs.length === length) {
6
+ return clock.start + alignedHeard(alignment, offsetMs, length);
7
+ }
8
+ if (clock.durationMs <= 0) {
9
+ if (offsetMs <= 0) return clock.start;
10
+ return clock.end;
11
+ }
12
+ const ratio = offsetMs <= 0 ? 0 : offsetMs / clock.durationMs;
13
+ const fraction = ratio > 1 ? 1 : ratio;
14
+ return clock.start + Math.round(fraction * length);
15
+ }
16
+ function alignedHeard(alignment, offsetMs, length) {
17
+ const first = alignment.startMs[0];
18
+ let origin = 0;
19
+ if (first !== void 0) origin = first;
20
+ const at = origin + offsetMs;
21
+ let heard = 0;
22
+ for (let index = 0; index < length; index += 1) {
23
+ const start = alignment.startMs[index];
24
+ if (start !== void 0 && start <= at) heard = index + 1;
25
+ }
26
+ return heard;
27
+ }
28
+ function utteranceIndex(feedPos, maps) {
29
+ let upTo = 0;
30
+ for (const map of maps) {
31
+ if (map.kind !== "answer") continue;
32
+ if (feedPos <= map.spokenStart) break;
33
+ const end = feedPos < map.spokenEnd ? feedPos : map.spokenEnd;
34
+ upTo += end - map.spokenStart;
35
+ }
36
+ return upTo;
37
+ }
38
+ function captionsFromHistory(entries) {
39
+ const captions = [];
40
+ const agents = /* @__PURE__ */ new Map();
41
+ for (const entry of entries) {
42
+ if (entry.kind === "voice.truncate") {
43
+ noteCut(captions, agents, entry.data);
44
+ continue;
45
+ }
46
+ const message = firstMessage(entry);
47
+ if (!message) continue;
48
+ const voice = voiceMeta(entry.data);
49
+ if (message.role === "user" && voice) {
50
+ pushUser(captions, entry, message, voice);
51
+ continue;
52
+ }
53
+ if (message.role !== "assistant") continue;
54
+ const blocks = textBlocks(message.content);
55
+ const turnId = String(entry.id);
56
+ const utteranceId = `${turnId}:agent`;
57
+ agents.set(turnId, { turnId, utteranceId, blocks });
58
+ captions.push({
59
+ type: "agent_generated",
60
+ turnId,
61
+ utteranceId,
62
+ text: blocks.join("")
63
+ });
64
+ }
65
+ return captions;
66
+ }
67
+ function firstMessage(entry) {
68
+ const model = entry.model;
69
+ if (!model) return void 0;
70
+ return model[0];
71
+ }
72
+ function pushUser(captions, entry, message, voice) {
73
+ const turnId = String(entry.id);
74
+ const text = textBlocks(message.content).join("");
75
+ if (voice.confidence === void 0) {
76
+ captions.push({ type: "user_final", turnId, segmentId: "turn", text });
77
+ return;
78
+ }
79
+ captions.push({
80
+ type: "user_final",
81
+ turnId,
82
+ segmentId: "turn",
83
+ text,
84
+ confidence: voice.confidence
85
+ });
86
+ }
87
+ function noteCut(captions, agents, data) {
88
+ const cut = cutData(data);
89
+ if (!cut) return;
90
+ const agent = agents.get(cut.entryId);
91
+ if (!agent) return;
92
+ const heard = heardInBlocks(agent.blocks, cut.contentIndex, cut.heardUpTo);
93
+ captions.push({
94
+ type: "agent_spoken",
95
+ turnId: agent.turnId,
96
+ utteranceId: agent.utteranceId,
97
+ upTo: heard
98
+ });
99
+ captions.push({
100
+ type: "agent_cut",
101
+ turnId: agent.turnId,
102
+ utteranceId: agent.utteranceId,
103
+ heardUpTo: heard
104
+ });
105
+ }
106
+ function heardInBlocks(blocks, contentIndex, heardUpTo) {
107
+ let prior = 0;
108
+ let index = 0;
109
+ for (const block of blocks) {
110
+ if (index === contentIndex) return prior + clampHeard(block, heardUpTo);
111
+ prior += block.length;
112
+ index += 1;
113
+ }
114
+ return prior;
115
+ }
116
+ function clampHeard(block, heardUpTo) {
117
+ if (heardUpTo <= 0) return 0;
118
+ if (heardUpTo >= block.length) return block.length;
119
+ return heardUpTo;
120
+ }
121
+ function textBlocks(content) {
122
+ if (typeof content === "string") return [content];
123
+ if (!content) return [];
124
+ const blocks = [];
125
+ for (const block of content) {
126
+ if (block.type === "text" && typeof block.text === "string") blocks.push(block.text);
127
+ }
128
+ return blocks;
129
+ }
130
+ function voiceMeta(data) {
131
+ if (typeof data !== "object" || data === null) return void 0;
132
+ if (!("source" in data) || data.source !== "voice") return void 0;
133
+ if ("confidence" in data && typeof data.confidence === "number") {
134
+ return { confidence: data.confidence };
135
+ }
136
+ return {};
137
+ }
138
+ function cutData(data) {
139
+ if (typeof data !== "object" || data === null) return void 0;
140
+ if (!("entryId" in data) || typeof data.entryId !== "string") return void 0;
141
+ if (!("contentIndex" in data) || typeof data.contentIndex !== "number") return void 0;
142
+ if (!("heardUpTo" in data) || typeof data.heardUpTo !== "number") return void 0;
143
+ return { entryId: data.entryId, contentIndex: data.contentIndex, heardUpTo: data.heardUpTo };
144
+ }
145
+ export {
146
+ captionsFromHistory,
147
+ spokenOffset,
148
+ utteranceIndex
149
+ };
150
+ //# sourceMappingURL=captions.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/captions.ts"],
4
+ "sourcesContent": ["import type { CharAlignment } from './audio.ts';\nimport type { CaptionEvent } from './turns.ts';\n\nexport interface SpokenClock {\n start: number;\n end: number;\n durationMs: number;\n alignment?: CharAlignment;\n}\n\nexport interface UtteranceMap {\n spokenStart: number;\n spokenEnd: number;\n kind: string;\n}\n\nexport interface CaptionHistoryEntry {\n id: string | number;\n kind: string;\n model?: readonly HistoryMessage[];\n data?: unknown;\n}\n\ninterface HistoryMessage {\n role?: string;\n content?: string | readonly HistoryBlock[];\n}\n\ninterface HistoryBlock {\n type?: string;\n text?: string;\n}\n\ninterface StoredAgent {\n turnId: string;\n utteranceId: string;\n blocks: string[];\n}\n\nexport function spokenOffset(clock: SpokenClock, offsetMs: number): number {\n const length = clock.end - clock.start;\n if (length <= 0) return clock.start;\n const alignment = clock.alignment;\n if (alignment && alignment.startMs.length === length && alignment.durationMs.length === length) {\n return clock.start + alignedHeard(alignment, offsetMs, length);\n }\n if (clock.durationMs <= 0) {\n if (offsetMs <= 0) return clock.start;\n return clock.end;\n }\n const ratio = offsetMs <= 0 ? 0 : offsetMs / clock.durationMs;\n const fraction = ratio > 1 ? 1 : ratio;\n return clock.start + Math.round(fraction * length);\n}\n\nfunction alignedHeard(alignment: CharAlignment, offsetMs: number, length: number): number {\n const first = alignment.startMs[0];\n let origin = 0;\n if (first !== undefined) origin = first;\n const at = origin + offsetMs;\n let heard = 0;\n for (let index = 0; index < length; index += 1) {\n const start = alignment.startMs[index];\n if (start !== undefined && start <= at) heard = index + 1;\n }\n return heard;\n}\n\nexport function utteranceIndex(feedPos: number, maps: readonly UtteranceMap[]): number {\n let upTo = 0;\n for (const map of maps) {\n if (map.kind !== 'answer') continue;\n if (feedPos <= map.spokenStart) break;\n const end = feedPos < map.spokenEnd ? feedPos : map.spokenEnd;\n upTo += end - map.spokenStart;\n }\n return upTo;\n}\n\nexport function captionsFromHistory(entries: readonly CaptionHistoryEntry[]): CaptionEvent[] {\n const captions: CaptionEvent[] = [];\n const agents = new Map<string, StoredAgent>();\n for (const entry of entries) {\n if (entry.kind === 'voice.truncate') {\n noteCut(captions, agents, entry.data);\n continue;\n }\n const message = firstMessage(entry);\n if (!message) continue;\n const voice = voiceMeta(entry.data);\n if (message.role === 'user' && voice) {\n pushUser(captions, entry, message, voice);\n continue;\n }\n if (message.role !== 'assistant') continue;\n const blocks = textBlocks(message.content);\n const turnId = String(entry.id);\n const utteranceId = `${turnId}:agent`;\n agents.set(turnId, { turnId, utteranceId, blocks });\n captions.push({\n type: 'agent_generated',\n turnId,\n utteranceId,\n text: blocks.join(''),\n });\n }\n return captions;\n}\n\nfunction firstMessage(entry: CaptionHistoryEntry): HistoryMessage | undefined {\n const model = entry.model;\n if (!model) return undefined;\n return model[0];\n}\n\nfunction pushUser(\n captions: CaptionEvent[],\n entry: CaptionHistoryEntry,\n message: HistoryMessage,\n voice: { confidence?: number }\n): void {\n const turnId = String(entry.id);\n const text = textBlocks(message.content).join('');\n if (voice.confidence === undefined) {\n captions.push({ type: 'user_final', turnId, segmentId: 'turn', text });\n return;\n }\n captions.push({\n type: 'user_final',\n turnId,\n segmentId: 'turn',\n text,\n confidence: voice.confidence,\n });\n}\n\nfunction noteCut(captions: CaptionEvent[], agents: Map<string, StoredAgent>, data: unknown): void {\n const cut = cutData(data);\n if (!cut) return;\n const agent = agents.get(cut.entryId);\n if (!agent) return;\n const heard = heardInBlocks(agent.blocks, cut.contentIndex, cut.heardUpTo);\n captions.push({\n type: 'agent_spoken',\n turnId: agent.turnId,\n utteranceId: agent.utteranceId,\n upTo: heard,\n });\n captions.push({\n type: 'agent_cut',\n turnId: agent.turnId,\n utteranceId: agent.utteranceId,\n heardUpTo: heard,\n });\n}\n\nfunction heardInBlocks(blocks: readonly string[], contentIndex: number, heardUpTo: number): number {\n let prior = 0;\n let index = 0;\n for (const block of blocks) {\n if (index === contentIndex) return prior + clampHeard(block, heardUpTo);\n prior += block.length;\n index += 1;\n }\n return prior;\n}\n\nfunction clampHeard(block: string, heardUpTo: number): number {\n if (heardUpTo <= 0) return 0;\n if (heardUpTo >= block.length) return block.length;\n return heardUpTo;\n}\n\nfunction textBlocks(content: HistoryMessage['content']): string[] {\n if (typeof content === 'string') return [content];\n if (!content) return [];\n const blocks: string[] = [];\n for (const block of content) {\n if (block.type === 'text' && typeof block.text === 'string') blocks.push(block.text);\n }\n return blocks;\n}\n\nfunction voiceMeta(data: unknown): { confidence?: number } | undefined {\n if (typeof data !== 'object' || data === null) return undefined;\n if (!('source' in data) || data.source !== 'voice') return undefined;\n if ('confidence' in data && typeof data.confidence === 'number') {\n return { confidence: data.confidence };\n }\n return {};\n}\n\nfunction cutData(\n data: unknown\n): { entryId: string; contentIndex: number; heardUpTo: number } | undefined {\n if (typeof data !== 'object' || data === null) return undefined;\n if (!('entryId' in data) || typeof data.entryId !== 'string') return undefined;\n if (!('contentIndex' in data) || typeof data.contentIndex !== 'number') return undefined;\n if (!('heardUpTo' in data) || typeof data.heardUpTo !== 'number') return undefined;\n return { entryId: data.entryId, contentIndex: data.contentIndex, heardUpTo: data.heardUpTo };\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
package/dist/index.js CHANGED
@@ -1,5 +1,6 @@
1
1
  import { resolveVoiceAuth } from "./auth.js";
2
2
  import { blankUsage } from "./blank-usage.js";
3
+ import { captionsFromHistory } from "./captions.js";
3
4
  import {
4
5
  convertAudio,
5
6
  convertAudioSource,
@@ -38,6 +39,7 @@ export {
38
39
  askAgent,
39
40
  bindThinker,
40
41
  blankUsage,
42
+ captionsFromHistory,
41
43
  connectRealtime,
42
44
  convertAudio,
43
45
  convertAudioSource,
package/dist/index.js.map CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../src/index.ts"],
4
- "sourcesContent": ["export type {\n AudioChunk,\n AudioEncoding,\n AudioFormat,\n AudioSink,\n AudioSource,\n AudioTag,\n CharAlignment,\n TextSpan,\n} from './audio.ts';\nexport { resolveVoiceAuth } from './auth.ts';\nexport { blankUsage } from './blank-usage.ts';\nexport {\n convertAudio,\n convertAudioSource,\n decodeAudioBase64,\n encodeAudioBase64,\n} from './convert.ts';\nexport { VoiceRequestError } from './errors.ts';\nexport type {\n Delivery,\n DeliverySupport,\n KnownRealtimeApi,\n KnownSpeechApi,\n KnownTranscriptionApi,\n RealtimeApi,\n RealtimeModel,\n SpeechApi,\n SpeechModel,\n TranscriptionApi,\n TranscriptionModel,\n VoiceInfo,\n VoiceModel,\n VoiceModelType,\n} from './models.ts';\nexport {\n getVoiceModel,\n listVoiceModels,\n registerVoiceModel,\n} from './models.ts';\nexport type {\n DeliveryPlan,\n RealtimeApiProvider,\n RealtimeContext,\n RealtimeEvent,\n RealtimeOptions,\n RealtimeSession,\n RealtimeSocket,\n RealtimeToken,\n TruncationPlan,\n} from './realtime.ts';\nexport { planDelivery, planTruncation, RealtimeLedger, realtimeSocket } from './realtime.ts';\nexport {\n connectRealtime,\n listen,\n registerRealtimeApiProvider,\n registerSpeechApiProvider,\n registerTranscriptionApiProvider,\n speak,\n transcribe,\n} from './registry.ts';\nexport type { SpeechApiProvider, SpeechEvent, SpeechInput } from './speech.ts';\nexport { SpeechEventStream } from './speech.ts';\nexport type { VoiceAgentEvent, VoiceMessageChange } from './spoken.ts';\nexport type {\n BindThinkerOptions,\n BoundThinker,\n Thinker,\n ThinkerCaption,\n ThinkerPhase,\n ThinkerUpdate,\n} from './talker.ts';\nexport { askAgent, bindThinker, talkerTools } from './talker.ts';\nexport type { RealtimeConstraints } from './tokens.ts';\nexport { mintRealtimeToken } from './tokens.ts';\nexport type {\n AudioInput,\n ListenOptions,\n Transcript,\n TranscriptionApiProvider,\n TranscriptionEvent,\n TranscriptSegment,\n} from './transcription.ts';\nexport { TranscriptionEventStream } from './transcription.ts';\nexport type {\n BargeIn,\n CaptionEvent,\n EchoRecommendation,\n VoiceConversation,\n VoiceCut,\n VoiceModels,\n VoicePhase,\n VoiceSession,\n VoiceTurnMeta,\n VoiceTurnOptions,\n} from './turns.ts';\nexport { voiceTurns } from './turns.ts';\nexport type {\n AudioCost,\n AudioCounters,\n AudioUsage,\n RealtimeAudioCost,\n SpeechAudioCost,\n TranscriptionAudioCost,\n} from './usage.ts';\nexport { addAudioCounters, priceAudio } from './usage.ts';\nexport type { VadHook, VadUpdate } from './vad.ts';\nexport { energyVad } from './vad.ts';\n"],
5
- "mappings": "AAUA,SAAS,wBAAwB;AACjC,SAAS,kBAAkB;AAC3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,yBAAyB;AAiBlC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAYP,SAAS,cAAc,gBAAgB,gBAAgB,sBAAsB;AAC7E;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,yBAAyB;AAUlC,SAAS,UAAU,aAAa,mBAAmB;AAEnD,SAAS,yBAAyB;AASlC,SAAS,gCAAgC;AAazC,SAAS,kBAAkB;AAS3B,SAAS,kBAAkB,kBAAkB;AAE7C,SAAS,iBAAiB;",
4
+ "sourcesContent": ["export type {\n AudioChunk,\n AudioEncoding,\n AudioFormat,\n AudioSink,\n AudioSource,\n AudioTag,\n CharAlignment,\n TextSpan,\n} from './audio.ts';\nexport { resolveVoiceAuth } from './auth.ts';\nexport { blankUsage } from './blank-usage.ts';\nexport type { CaptionHistoryEntry } from './captions.ts';\nexport { captionsFromHistory } from './captions.ts';\nexport {\n convertAudio,\n convertAudioSource,\n decodeAudioBase64,\n encodeAudioBase64,\n} from './convert.ts';\nexport { VoiceRequestError } from './errors.ts';\nexport type {\n Delivery,\n DeliverySupport,\n KnownRealtimeApi,\n KnownSpeechApi,\n KnownTranscriptionApi,\n RealtimeApi,\n RealtimeModel,\n SpeechApi,\n SpeechModel,\n TranscriptionApi,\n TranscriptionModel,\n VoiceInfo,\n VoiceModel,\n VoiceModelType,\n} from './models.ts';\nexport {\n getVoiceModel,\n listVoiceModels,\n registerVoiceModel,\n} from './models.ts';\nexport type {\n DeliveryPlan,\n RealtimeApiProvider,\n RealtimeContext,\n RealtimeEvent,\n RealtimeOptions,\n RealtimeSession,\n RealtimeSocket,\n RealtimeToken,\n TruncationPlan,\n} from './realtime.ts';\nexport { planDelivery, planTruncation, RealtimeLedger, realtimeSocket } from './realtime.ts';\nexport {\n connectRealtime,\n listen,\n registerRealtimeApiProvider,\n registerSpeechApiProvider,\n registerTranscriptionApiProvider,\n speak,\n transcribe,\n} from './registry.ts';\nexport type { SpeechApiProvider, SpeechEvent, SpeechInput } from './speech.ts';\nexport { SpeechEventStream } from './speech.ts';\nexport type { VoiceAgentEvent, VoiceMessageChange } from './spoken.ts';\nexport type {\n BindThinkerOptions,\n BoundThinker,\n Thinker,\n ThinkerCaption,\n ThinkerPhase,\n ThinkerUpdate,\n} from './talker.ts';\nexport { askAgent, bindThinker, talkerTools } from './talker.ts';\nexport type { RealtimeConstraints } from './tokens.ts';\nexport { mintRealtimeToken } from './tokens.ts';\nexport type {\n AudioInput,\n ListenOptions,\n Transcript,\n TranscriptionApiProvider,\n TranscriptionEvent,\n TranscriptSegment,\n} from './transcription.ts';\nexport { TranscriptionEventStream } from './transcription.ts';\nexport type {\n BargeIn,\n CaptionEvent,\n EchoRecommendation,\n VoiceConversation,\n VoiceCut,\n VoiceModels,\n VoicePhase,\n VoiceSession,\n VoiceTurnMeta,\n VoiceTurnOptions,\n} from './turns.ts';\nexport { voiceTurns } from './turns.ts';\nexport type {\n AudioCost,\n AudioCounters,\n AudioUsage,\n RealtimeAudioCost,\n SpeechAudioCost,\n TranscriptionAudioCost,\n} from './usage.ts';\nexport { addAudioCounters, priceAudio } from './usage.ts';\nexport type { VadHook, VadUpdate } from './vad.ts';\nexport { energyVad } from './vad.ts';\n"],
5
+ "mappings": "AAUA,SAAS,wBAAwB;AACjC,SAAS,kBAAkB;AAE3B,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,yBAAyB;AAiBlC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAYP,SAAS,cAAc,gBAAgB,gBAAgB,sBAAsB;AAC7E;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,yBAAyB;AAUlC,SAAS,UAAU,aAAa,mBAAmB;AAEnD,SAAS,yBAAyB;AASlC,SAAS,gCAAgC;AAazC,SAAS,kBAAkB;AAS3B,SAAS,kBAAkB,kBAAkB;AAE7C,SAAS,iBAAiB;",
6
6
  "names": []
7
7
  }
@@ -0,0 +1,109 @@
1
+ import {
2
+ registerVoiceModel
3
+ } from "../models.js";
4
+ import { registerSpeechApiProvider, registerTranscriptionApiProvider } from "../registry.js";
5
+ import { listenMistral } from "./listen.js";
6
+ import { speakMistral } from "./speak.js";
7
+ import { transcribeMistral } from "./transcribe.js";
8
+ const tokenCost = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
9
+ const mistral = "https://api.mistral.ai/v1";
10
+ const languages = ["en", "zh", "hi", "es", "ar", "fr", "pt", "ru", "de", "ja", "ko", "it", "nl"];
11
+ const pcm16 = (sampleRate) => ({
12
+ encoding: "pcm16",
13
+ sampleRate,
14
+ channels: 1
15
+ });
16
+ const container = (encoding, sampleRate) => ({
17
+ encoding,
18
+ sampleRate,
19
+ channels: 1
20
+ });
21
+ const voices = [
22
+ { id: "en_paul_neutral", name: "Paul", languages: ["en"] },
23
+ { id: "gb_jane_neutral", name: "Jane", languages: ["en"] },
24
+ { id: "gb_oliver_neutral", name: "Oliver", languages: ["en"] },
25
+ { id: "fr_marie_neutral", name: "Marie", languages: ["fr"] }
26
+ ];
27
+ function mistralCatalog() {
28
+ const batch = {
29
+ id: "voxtral-mini-latest",
30
+ name: "voxtral-mini-latest",
31
+ api: "mistral-transcriptions",
32
+ provider: "mistral",
33
+ baseUrl: mistral,
34
+ type: "transcription",
35
+ streaming: false,
36
+ turnDetection: "none",
37
+ inputFormats: [
38
+ container("wav", 16e3),
39
+ container("mp3", 16e3),
40
+ container("flac", 16e3),
41
+ pcm16(16e3)
42
+ ],
43
+ languages,
44
+ diarization: true,
45
+ cost: tokenCost,
46
+ audioCost: { perInputMinute: 3e-3 }
47
+ };
48
+ const realtime = {
49
+ id: "voxtral-mini-transcribe-realtime-2602",
50
+ name: "voxtral-mini-transcribe-realtime-2602",
51
+ api: "mistral-transcriptions",
52
+ provider: "mistral",
53
+ baseUrl: mistral,
54
+ type: "transcription",
55
+ streaming: true,
56
+ turnDetection: "none",
57
+ inputFormats: [pcm16(16e3)],
58
+ languages,
59
+ diarization: false,
60
+ cost: tokenCost,
61
+ audioCost: { perInputMinute: 6e-3 }
62
+ };
63
+ const speech = {
64
+ id: "voxtral-mini-tts-2603",
65
+ name: "voxtral-mini-tts-2603",
66
+ api: "mistral-speech",
67
+ provider: "mistral",
68
+ baseUrl: mistral,
69
+ type: "speech",
70
+ textStreaming: false,
71
+ outputFormats: [
72
+ container("pcmf32", 24e3),
73
+ container("mp3", 24e3),
74
+ container("wav", 24e3),
75
+ container("flac", 24e3),
76
+ container("opus", 24e3)
77
+ ],
78
+ voices,
79
+ cloning: true,
80
+ cost: tokenCost,
81
+ audioCost: { perThousandChars: 0.016 }
82
+ };
83
+ return [batch, realtime, speech];
84
+ }
85
+ function registerMistral() {
86
+ const models = mistralCatalog();
87
+ const unregisterModels = models.map((model) => registerVoiceModel(model));
88
+ const unregisterTranscription = registerTranscriptionApiProvider({
89
+ api: "mistral-transcriptions",
90
+ transcribe: transcribeMistral,
91
+ listen: listenMistral
92
+ });
93
+ const unregisterSpeech = registerSpeechApiProvider({
94
+ api: "mistral-speech",
95
+ speak: speakMistral
96
+ });
97
+ let released = false;
98
+ return () => {
99
+ if (released) return;
100
+ released = true;
101
+ for (const unregister of unregisterModels) unregister();
102
+ unregisterTranscription();
103
+ unregisterSpeech();
104
+ };
105
+ }
106
+ export {
107
+ registerMistral
108
+ };
109
+ //# sourceMappingURL=catalog.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/mistral/catalog.ts"],
4
+ "sourcesContent": ["import type { AudioFormat } from '../audio.ts';\nimport {\n registerVoiceModel,\n type SpeechModel,\n type TranscriptionModel,\n type VoiceInfo,\n} from '../models.ts';\nimport { registerSpeechApiProvider, registerTranscriptionApiProvider } from '../registry.ts';\nimport { listenMistral } from './listen.ts';\nimport { speakMistral } from './speak.ts';\nimport { transcribeMistral } from './transcribe.ts';\n\nconst tokenCost = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };\nconst mistral = 'https://api.mistral.ai/v1';\nconst languages = ['en', 'zh', 'hi', 'es', 'ar', 'fr', 'pt', 'ru', 'de', 'ja', 'ko', 'it', 'nl'];\n\nconst pcm16 = (sampleRate: number): AudioFormat => ({\n encoding: 'pcm16',\n sampleRate,\n channels: 1,\n});\n\nconst container = (\n encoding: 'wav' | 'mp3' | 'flac' | 'opus' | 'pcmf32',\n sampleRate: number\n): AudioFormat => ({\n encoding,\n sampleRate,\n channels: 1,\n});\n\nconst voices: VoiceInfo[] = [\n { id: 'en_paul_neutral', name: 'Paul', languages: ['en'] },\n { id: 'gb_jane_neutral', name: 'Jane', languages: ['en'] },\n { id: 'gb_oliver_neutral', name: 'Oliver', languages: ['en'] },\n { id: 'fr_marie_neutral', name: 'Marie', languages: ['fr'] },\n];\n\nfunction mistralCatalog(): Array<TranscriptionModel<string> | SpeechModel<string>> {\n const batch: TranscriptionModel<string> = {\n id: 'voxtral-mini-latest',\n name: 'voxtral-mini-latest',\n api: 'mistral-transcriptions',\n provider: 'mistral',\n baseUrl: mistral,\n type: 'transcription',\n streaming: false,\n turnDetection: 'none',\n inputFormats: [\n container('wav', 16000),\n container('mp3', 16000),\n container('flac', 16000),\n pcm16(16000),\n ],\n languages,\n diarization: true,\n cost: tokenCost,\n audioCost: { perInputMinute: 0.003 },\n };\n const realtime: TranscriptionModel<string> = {\n id: 'voxtral-mini-transcribe-realtime-2602',\n name: 'voxtral-mini-transcribe-realtime-2602',\n api: 'mistral-transcriptions',\n provider: 'mistral',\n baseUrl: mistral,\n type: 'transcription',\n streaming: true,\n turnDetection: 'none',\n inputFormats: [pcm16(16000)],\n languages,\n diarization: false,\n cost: tokenCost,\n audioCost: { perInputMinute: 0.006 },\n };\n const speech: SpeechModel<string> = {\n id: 'voxtral-mini-tts-2603',\n name: 'voxtral-mini-tts-2603',\n api: 'mistral-speech',\n provider: 'mistral',\n baseUrl: mistral,\n type: 'speech',\n textStreaming: false,\n outputFormats: [\n container('pcmf32', 24000),\n container('mp3', 24000),\n container('wav', 24000),\n container('flac', 24000),\n container('opus', 24000),\n ],\n voices,\n cloning: true,\n cost: tokenCost,\n audioCost: { perThousandChars: 0.016 },\n };\n return [batch, realtime, speech];\n}\n\nexport function registerMistral(): () => void {\n const models = mistralCatalog();\n const unregisterModels = models.map((model) => registerVoiceModel(model));\n const unregisterTranscription = registerTranscriptionApiProvider({\n api: 'mistral-transcriptions',\n transcribe: transcribeMistral,\n listen: listenMistral,\n });\n const unregisterSpeech = registerSpeechApiProvider({\n api: 'mistral-speech',\n speak: speakMistral,\n });\n let released = false;\n return () => {\n if (released) return;\n released = true;\n for (const unregister of unregisterModels) unregister();\n unregisterTranscription();\n unregisterSpeech();\n };\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,5 @@
1
+ import { registerMistral } from "./catalog.js";
2
+ export {
3
+ registerMistral
4
+ };
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/mistral/index.ts"],
4
+ "sourcesContent": ["export { registerMistral } from './catalog.ts';\n"],
5
+ "mappings": "AAAA,SAAS,uBAAuB;",
6
+ "names": []
7
+ }
@@ -0,0 +1,260 @@
1
+ import { chunkSeconds } from "../audio.js";
2
+ import { encodeAudioBase64 } from "../convert.js";
3
+ import { asVoiceError, isRecord, numberField, stringField } from "../openai/wire.js";
4
+ import {
5
+ TranscriptionEventStream
6
+ } from "../transcription.js";
7
+ import { priceAudio } from "../usage.js";
8
+ import {
9
+ awaitOpen,
10
+ bearerHeaders,
11
+ connectSocket,
12
+ messageText,
13
+ realtimeEncoding,
14
+ sameFormat,
15
+ socketUrl
16
+ } from "./wire.js";
17
+ function textOr(event) {
18
+ const text = stringField(event, "text");
19
+ if (text === void 0) return "";
20
+ return text;
21
+ }
22
+ function secondsOf(word, key) {
23
+ const value = numberField(word, key);
24
+ if (value === void 0) return 0;
25
+ return value;
26
+ }
27
+ function segmentFrom(word) {
28
+ const text = textOr(word);
29
+ if (text === "") return void 0;
30
+ const speaker = stringField(word, "speaker_id");
31
+ const segment = {
32
+ text,
33
+ start: secondsOf(word, "start"),
34
+ end: secondsOf(word, "end")
35
+ };
36
+ if (speaker !== void 0) segment.speaker = speaker;
37
+ return segment;
38
+ }
39
+ function listenError(event) {
40
+ const direct = stringField(event, "error");
41
+ if (direct !== void 0) return direct;
42
+ const error = event.error;
43
+ if (!isRecord(error)) return "Mistral transcription failed";
44
+ const message = error.message;
45
+ if (typeof message === "string") return message;
46
+ if (isRecord(message)) {
47
+ const detail = stringField(message, "detail");
48
+ if (detail !== void 0) return detail;
49
+ }
50
+ return "Mistral transcription failed";
51
+ }
52
+ function spokenText(partial, doneText) {
53
+ if (partial !== "") return partial;
54
+ return doneText;
55
+ }
56
+ function sttUrl(model, options) {
57
+ const url = socketUrl(model.baseUrl, "audio/transcriptions/realtime");
58
+ const params = new URLSearchParams();
59
+ params.set("model", model.id);
60
+ if (options?.language) params.set("language", options.language);
61
+ url.search = params.toString();
62
+ return url.toString();
63
+ }
64
+ function chosenFormat(model, chunk) {
65
+ const format = chunk === void 0 ? model.inputFormats[0] : chunk.format;
66
+ if (!format) throw new Error("No input format");
67
+ realtimeEncoding(format);
68
+ const known = model.inputFormats.some((item) => sameFormat(item, format));
69
+ if (!known) throw new Error(`Unsupported audio format ${format.encoding}`);
70
+ return format;
71
+ }
72
+ function addSegment(word, state) {
73
+ const segment = segmentFrom(word);
74
+ if (segment) state.segments.push(segment);
75
+ }
76
+ function addSegments(value, state) {
77
+ if (!Array.isArray(value)) return;
78
+ for (const word of value) {
79
+ if (!isRecord(word)) continue;
80
+ addSegment(word, state);
81
+ }
82
+ }
83
+ function emitFinal(spoken, state, push) {
84
+ if (spoken === "") return;
85
+ if (!state.started) {
86
+ state.started = true;
87
+ push({ type: "speech_start", at: 0 });
88
+ }
89
+ const segmentId = String(state.segment);
90
+ state.segment += 1;
91
+ state.turns.push(spoken);
92
+ push({ type: "final", segmentId, text: spoken });
93
+ state.started = false;
94
+ push({ type: "turn_end", text: spoken, at: 0 });
95
+ }
96
+ function applyListen(event, state, push) {
97
+ const type = stringField(event, "type");
98
+ if (type === "session.created" || type === "session.updated") {
99
+ state.ready = true;
100
+ return;
101
+ }
102
+ if (type === "transcription.text.delta") {
103
+ state.partial += textOr(event);
104
+ if (!state.started) {
105
+ state.started = true;
106
+ push({ type: "speech_start", at: 0 });
107
+ }
108
+ push({ type: "partial", segmentId: String(state.segment), text: state.partial });
109
+ return;
110
+ }
111
+ if (type === "transcription.segment") {
112
+ addSegment(event, state);
113
+ return;
114
+ }
115
+ if (type === "transcription.done") {
116
+ const language = stringField(event, "language");
117
+ if (language !== void 0) state.language = language;
118
+ addSegments(event.segments, state);
119
+ const spoken = spokenText(state.partial, textOr(event));
120
+ state.partial = "";
121
+ state.sawDone = true;
122
+ emitFinal(spoken, state, push);
123
+ return;
124
+ }
125
+ if (type === "error") {
126
+ state.failed = true;
127
+ push({ type: "error", reason: "error", error: listenError(event) });
128
+ }
129
+ }
130
+ function finish(model, format, state, push) {
131
+ if (state.failed || state.completed) return;
132
+ state.completed = true;
133
+ const heard = chunkSeconds({ data: new Uint8Array(state.bytes), format, timestamp: 0 });
134
+ push({
135
+ type: "done",
136
+ transcript: {
137
+ text: state.turns.join(" "),
138
+ ...state.language !== void 0 ? { language: state.language } : {},
139
+ ...state.segments.length > 0 ? { segments: state.segments } : {},
140
+ usage: priceAudio(model.audioCost, { inputSeconds: heard })
141
+ }
142
+ });
143
+ }
144
+ function listenMistral(model, audio, options) {
145
+ const stream = new TranscriptionEventStream();
146
+ void pumpListen(model, audio, options, stream);
147
+ return stream;
148
+ }
149
+ async function pumpListen(model, audio, options, stream) {
150
+ const state = {
151
+ turns: [],
152
+ segments: [],
153
+ segment: 0,
154
+ started: false,
155
+ bytes: 0,
156
+ opened: false,
157
+ ready: false,
158
+ clientDone: false,
159
+ sawDone: false,
160
+ failed: false,
161
+ completed: false,
162
+ partial: "",
163
+ language: void 0
164
+ };
165
+ let settled = false;
166
+ const push = (event) => {
167
+ if (settled) return;
168
+ if (event.type === "done" || event.type === "error") settled = true;
169
+ stream.push(event);
170
+ };
171
+ let socket;
172
+ const readyWait = Promise.withResolvers();
173
+ const doneWait = Promise.withResolvers();
174
+ const wake = (kind) => {
175
+ if (state.ready || state.failed) readyWait.resolve();
176
+ if (state.failed) doneWait.resolve();
177
+ if (!state.clientDone) return;
178
+ if (kind === "transcription.done") doneWait.resolve();
179
+ if (kind === "close") doneWait.resolve();
180
+ };
181
+ try {
182
+ if (options?.signal?.aborted) throw new DOMException("aborted", "AbortError");
183
+ const iterator = audio[Symbol.asyncIterator]();
184
+ const first = await iterator.next();
185
+ const format = chosenFormat(model, first.done ? void 0 : first.value);
186
+ socket = connectSocket(sttUrl(model, options), bearerHeaders(model, options));
187
+ let incoming = Promise.resolve();
188
+ socket.addEventListener("message", (event) => {
189
+ incoming = incoming.then(() => onMessage(event.data, state, push, wake));
190
+ });
191
+ socket.addEventListener("close", () => {
192
+ if (state.opened && !state.failed && !state.completed && !state.clientDone) {
193
+ state.failed = true;
194
+ push({ type: "error", reason: "error", error: "Mistral transcription socket closed" });
195
+ }
196
+ wake("close");
197
+ });
198
+ await awaitOpen(socket, "Mistral transcription", (message) => {
199
+ state.failed = true;
200
+ push({ type: "error", reason: "error", error: message });
201
+ wake("fail");
202
+ });
203
+ if (state.failed) return;
204
+ state.opened = true;
205
+ if (!state.ready) await readyWait.promise;
206
+ if (state.failed) return;
207
+ socket.send(
208
+ JSON.stringify({
209
+ type: "session.update",
210
+ session: {
211
+ audio_format: { encoding: realtimeEncoding(format), sample_rate: format.sampleRate }
212
+ }
213
+ })
214
+ );
215
+ if (!first.done) sendChunk(socket, first.value, format, state);
216
+ while (!state.failed) {
217
+ if (options?.signal?.aborted) throw new DOMException("aborted", "AbortError");
218
+ const next = await iterator.next();
219
+ if (next.done) break;
220
+ sendChunk(socket, next.value, format, state);
221
+ }
222
+ if (state.failed) return;
223
+ socket.send(JSON.stringify({ type: "input_audio.flush" }));
224
+ socket.send(JSON.stringify({ type: "input_audio.end" }));
225
+ state.clientDone = true;
226
+ if (state.sawDone) doneWait.resolve();
227
+ await doneWait.promise;
228
+ finish(model, format, state, push);
229
+ } catch (error) {
230
+ const voice = asVoiceError(error);
231
+ state.failed = true;
232
+ push({ type: "error", reason: voice.reason, error: voice.error });
233
+ } finally {
234
+ socket?.close();
235
+ }
236
+ }
237
+ function sendChunk(socket, chunk, format, state) {
238
+ if (!sameFormat(chunk.format, format)) {
239
+ throw new Error(`Unsupported audio format ${chunk.format.encoding}`);
240
+ }
241
+ state.bytes += chunk.data.byteLength;
242
+ socket.send(JSON.stringify({ type: "input_audio.append", audio: encodeAudioBase64(chunk.data) }));
243
+ }
244
+ async function onMessage(data, state, push, wake) {
245
+ try {
246
+ const parsed = JSON.parse(await messageText(data));
247
+ if (!isRecord(parsed)) throw new Error("Mistral transcription event was not JSON");
248
+ applyListen(parsed, state, push);
249
+ wake(stringField(parsed, "type"));
250
+ } catch (error) {
251
+ const voice = asVoiceError(error);
252
+ state.failed = true;
253
+ push({ type: "error", reason: voice.reason, error: voice.error });
254
+ wake("fail");
255
+ }
256
+ }
257
+ export {
258
+ listenMistral
259
+ };
260
+ //# sourceMappingURL=listen.js.map