car-runtime 0.4.9 → 0.5.1

package/index.d.ts

@@ -143,6 +143,8 @@ export class CarRuntime {
     context?: string | null,
     toolsJson?: string | null,
     messagesJson?: string | null,
+    toolChoice?: string | null,
+    parallelToolCalls?: boolean | null,
   ): Promise<string>;
 
   /** Generate text grounded with memory context from this runtime's memgine. */
@@ -285,8 +287,173 @@ export function inferStream(
   context: string | null | undefined,
   toolsJson: string | null | undefined,
   onEvent: (eventJson: string) => void,
+  toolChoice?: string | null,
+  parallelToolCalls?: boolean | null,
 ): Promise<string>;
 
+// --- Voice streaming (stored-callback pattern) ---
+
+export type AudioSourceSpec =
+  | { kind: 'mic' }
+  | { kind: 'system' }
+  | { kind: 'file'; path: string }
+  | { kind: 'fifo'; path: string }
+  | { kind: 'pcm_push'; sample_rate: number; channels?: 1 | 2 };
+
+export interface TranscribeStreamOptions {
+  model?: string;
+  language?: string;
+  prompt?: string;
+  emit_audio_meta?: boolean;
+  /**
+   * Enable native streaming partials. Today only takes effect for
+   * `mic` sources when the runtime was compiled with the `parakeet`
+   * feature; the listener uses Parakeet TDT for transcription and
+   * emits `partial` events per non-blank token before each canonical
+   * `transcript` event. Without the feature or for non-Mic sources
+   * this flag is silently ignored.
+   */
+  streaming?: boolean;
+  /**
+   * Attach the prepared speaker diarizer to this session so
+   * `transcript` events carry `role: "other:speaker_N"` rather than
+   * `"unknown"`. Caller must `prepareDiarizer()` first. Silently
+   * ignored if no diarizer has been prepared, or if the source isn't
+   * `mic`.
+   */
+  diarizer?: boolean;
+  /**
+   * Attach the enrollment-based speaker pipeline so segments matching
+   * an enrolled voiceprint get `role: "enrolled_user"`. Pipeline is
+   * built lazily from `~/.car/voiceprints/`.
+   */
+  enrolled?: boolean;
+}
+
+export type VoiceStreamEvent =
+  | { type: 'speech_start' }
+  | { type: 'speech_end' }
+  | { type: 'transcript'; text: string; duration_ms: number; role: string }
+  | { type: 'partial'; text: string; duration_ms: number }
+  | { type: 'audio_chunk'; sample_rate: number; frame_count: number }
+  | { type: 'barge_in' }
+  | { type: 'enrollment_captured'; label: string; save_path: string }
+  | { type: 'enrollment_failed'; reason: string }
+  | { type: 'done' }
+  | { type: 'error'; message: string };
+
+export function registerVoiceEventHandler(
+  onEvent: (sessionId: string, eventJson: string) => void,
+): void;
+
+export function transcribeStream(
+  rt: CarRuntime,
+  sessionId: string,
+  audioSourceJson: string,
+  optionsJson?: string | null,
+): Promise<string>;
+
+export function transcribeStreamStop(rt: CarRuntime, sessionId: string): Promise<string>;
+
+export function transcribeStreamPush(
+  rt: CarRuntime,
+  sessionId: string,
+  pcmFrame: Buffer,
+): Promise<string>;
+
+export function listVoiceSessions(rt: CarRuntime): string;
+
+// --- Meeting capture ---
+
+export interface StartMeetingRequest {
+  id?: string;
+  sources: Array<'mic' | 'system'>;
+  title?: string;
+  model?: string;
+  language?: string;
+  persist_audio?: boolean;
+  root?: string;
+  /**
+   * Enable native streaming partials on the mic source. Effective
+   * only when the runtime was built with `--features parakeet`;
+   * silently ignored otherwise. `transcript` events still arrive at
+   * segment end — `partial` events are emitted incrementally per
+   * non-blank token in between.
+   */
+  streaming?: boolean;
+  /**
+   * Attach the prepared diarizer to the mic source so transcripts
+   * carry per-speaker roles. Call `prepareDiarizer()` first.
+   */
+  diarizer?: boolean;
+  /**
+   * Attach the enrollment-based pipeline so segments matching an
+   * enrolled voiceprint get `role: "enrolled_user"`.
+   */
+  enrolled?: boolean;
+}
+
+/** Eagerly download + load the Parakeet TDT model (~600 MB). Idempotent. */
+export function prepareParakeet(rt: CarRuntime): Promise<string>;
+
+/** Eagerly download + load the speaker diarizer (~28 MB). Idempotent. */
+export function prepareDiarizer(rt: CarRuntime): Promise<string>;
+
+/**
+ * Enroll a speaker. `audioJson` shape:
+ * - `{"kind":"wav","path":"/abs/path.wav"}` — decoded via hound
+ * - `{"kind":"pcm","sample_rate":48000,"channels":1,"data_b64":"<base64>"}`
+ *
+ * Saves to `~/.car/voiceprints/<label>.toml`. Returns
+ * `{"label":...,"path":...,"model_id":...}`.
+ */
+export function enrollSpeaker(
+  rt: CarRuntime,
+  label: string,
+  audioJson: string,
+): Promise<string>;
+
+/** List saved enrollments. Returns `{"enrollments":[{label,path,model_id},...]}`. */
+export function listEnrollments(rt: CarRuntime): string;
+
+/** Delete a saved enrollment by label. Idempotent. */
+export function removeEnrollment(rt: CarRuntime, label: string): string;
+
+// --- Workflow ---
+
+/**
+ * Run a multi-stage workflow definition. Reuses the agent runner
+ * registered via `registerAgentRunner` for any agent stages in the
+ * workflow.
+ */
+export function runWorkflow(workflowJson: string): Promise<string>;
+
+/** Static analysis on a workflow definition. Returns verification report JSON. */
+export function verifyWorkflow(workflowJson: string): string;
+
+export interface StartMeetingResponse {
+  id: string;
+  title: string;
+  started_at: string;
+  voice_session_ids: string[];
+}
+
+export function startMeeting(rt: CarRuntime, requestJson: string): Promise<string>;
+
+export function stopMeeting(
+  rt: CarRuntime,
+  meetingId: string,
+  summarize?: boolean | null,
+): Promise<string>;
+
+export function listMeetings(rt: CarRuntime, rootOverride?: string | null): string;
+
+export function getMeeting(
+  rt: CarRuntime,
+  meetingId: string,
+  rootOverride?: string | null,
+): string;
+
 // --- Verification (stateless) ---
 
 export function verify(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "car-runtime",
-  "version": "0.4.9",
+  "version": "0.5.1",
   "description": "Common Agent Runtime — a deterministic execution layer for AI agents",
   "main": "index.js",
   "types": "index.d.ts",