@voicelayer/sdk 0.4.1 → 0.5.0

package/dist/types-KqrAfY85.d.ts

@@ -0,0 +1,47 @@
+interface BrainMessage {
+    readonly role: 'system' | 'user' | 'assistant';
+    readonly content: string;
+}
+interface BrainCallMetadata {
+    readonly channel: 'voice' | 'text';
+    readonly callId?: string;
+    readonly projectId?: string;
+}
+interface BrainRequest {
+    readonly messages: readonly BrainMessage[];
+    /** Upstream model id / alias. Omitted → the brain's own default. */
+    readonly model?: string;
+    readonly temperature?: number;
+    readonly metadata: BrainCallMetadata;
+}
+/** One streamed piece of the brain's reply. */
+interface BrainChunk {
+    readonly content?: string;
+}
+interface BrainCapabilities {
+    readonly reachable: boolean;
+    readonly streaming: boolean;
+}
+interface BrainTransport {
+    readonly kind: 'callback' | 'http' | 'tunnel';
+    /** Stream the reply token-by-token (the voice path: first sentence → TTS ASAP). */
+    stream(req: BrainRequest, signal: AbortSignal): AsyncIterable<BrainChunk>;
+    /** Non-streaming convenience (the text path). */
+    complete(req: BrainRequest, signal: AbortSignal): Promise<string>;
+}
+/** Context handed to a customer's in-process `onQuery` brain. */
+interface OnQueryContext {
+    /** Full conversation so far (system + prior turns + latest user message). */
+    readonly messages: readonly BrainMessage[];
+    /** Aborts when the caller barges in / the turn is cancelled. */
+    readonly signal: AbortSignal;
+}
+type OnQueryResult = string | AsyncIterable<string>;
+/**
+ * Bring-your-own brain, in-process. Receives the latest user utterance (and the
+ * full history via `ctx.messages`) and returns the reply — either a string or an
+ * async-iterable of string pieces for token streaming.
+ */
+type OnQuery = (text: string, ctx: OnQueryContext) => OnQueryResult | Promise<OnQueryResult>;
+
+export type { BrainTransport as B, OnQuery as O, BrainCallMetadata as a, BrainCapabilities as b, BrainChunk as c, BrainMessage as d, BrainRequest as e, OnQueryContext as f, OnQueryResult as g };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voicelayer/sdk",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Official SDK for VoiceLayer — define, run, and orchestrate voice AI agents on the VoiceLayer control plane.",
   "license": "Apache-2.0",
   "author": "VoiceLayer",
@@ -80,15 +80,15 @@
     "vitest": "^4.1.5",
     "@voicelayer/contracts": "0.1.0",
     "@voicelayer/llm-client": "0.1.0",
+    "@voicelayer/primitive-audio-experience": "0.1.0",
     "@voicelayer/observability": "0.1.0",
     "@voicelayer/primitive-audio-routing": "0.1.0",
-    "@voicelayer/primitive-audio-experience": "0.1.0",
     "@voicelayer/primitive-process-schema": "0.1.0",
     "@voicelayer/primitive-security": "0.1.0",
     "@voicelayer/agents-plugin-deepgram": "1.0.1",
-    "@voicelayer/agents-plugin-openai": "1.0.1",
+    "@voicelayer/agents-plugin-livekit": "1.0.1",
     "@voicelayer/agents-plugin-silero": "1.0.1",
-    "@voicelayer/agents-plugin-livekit": "1.0.1"
+    "@voicelayer/agents-plugin-openai": "1.0.1"
   },
   "scripts": {
     "typecheck": "tsc -b --pretty false",