@craftedxp/sdk-node 0.5.0 → 0.9.0

package/dist/index.d.mts

@@ -34,6 +34,21 @@ interface AgentVoice {
     provider: TtsProvider;
     voiceId?: string;
     language?: string;
+    /**
+     * Per-utterance variation, 0.0–1.0. Honoured by Fish Audio and
+     * Chatterbox (passed through to each provider's synthesis API).
+     * Other providers ignore the field. Lower = more deterministic /
+     * consistent delivery, higher = more expressive / lively.
+     * Undefined = provider default.
+     */
+    temperature?: number;
+    /**
+     * Emotion-intensity knob, 0.0–1.0. Honoured only by Chatterbox today
+     * (its `exaggeration` parameter). Other providers ignore it. 0.5 is
+     * neutral; 0.7–0.8 noticeably more expressive; >0.85 risks theatrical
+     * delivery. Undefined = provider default.
+     */
+    exaggeration?: number;
 }
 interface AgentTranscriber {
     provider: SttProvider;
@@ -74,7 +89,14 @@ interface Agent {
     orgId: string;
     name: string;
     systemPrompt: string;
-    firstMessage: string;
+    /**
+     * When `true` (default), the agent kicks off the conversation as soon
+     * as the call connects — the platform sends the LLM a synthetic
+     * `[CALL_START]` user turn so the model produces a greeting from the
+     * system prompt. When `false`, the agent stays silent until the
+     * caller speaks first.
+     */
+    agentSpeaksFirst?: boolean;
     voice: AgentVoice;
     transcriber: AgentTranscriber;
     model: AgentModel;
@@ -106,7 +128,7 @@ interface Agent {
 interface AgentCreateInput {
     name: string;
     systemPrompt: string;
-    firstMessage?: string;
+    agentSpeaksFirst?: boolean;
     voice?: AgentVoice;
     transcriber?: AgentTranscriber;
     model?: AgentModel;
@@ -308,6 +330,20 @@ interface CallTokenMintResult {
     agentId: string;
     expiresAt: number;
     allowedOrigins?: string[];
+    /**
+     * Transport the agent is configured for. Forward this to the client
+     * SDK's `fetchToken` (rich return form) so it can dispatch correctly
+     * without a second round-trip. Always present in the response;
+     * defaults to `'ws'` for legacy agent docs missing the field.
+     */
+    transport?: 'ws' | 'webrtc';
+    /**
+     * Signaling gateway base URL when `transport === 'webrtc'` AND the
+     * server has `WEBRTC_GATEWAY_BASE` configured. Forward alongside
+     * `transport` so the client SDK reaches the gateway directly instead
+     * of falling back to the Phase-1 routes on the API base (local dev).
+     */
+    webrtcGatewayBase?: string;
 }
 interface CallTokenSummary {
     tokenId: string;

package/dist/index.d.ts

@@ -34,6 +34,21 @@ interface AgentVoice {
     provider: TtsProvider;
     voiceId?: string;
     language?: string;
+    /**
+     * Per-utterance variation, 0.0–1.0. Honoured by Fish Audio and
+     * Chatterbox (passed through to each provider's synthesis API).
+     * Other providers ignore the field. Lower = more deterministic /
+     * consistent delivery, higher = more expressive / lively.
+     * Undefined = provider default.
+     */
+    temperature?: number;
+    /**
+     * Emotion-intensity knob, 0.0–1.0. Honoured only by Chatterbox today
+     * (its `exaggeration` parameter). Other providers ignore it. 0.5 is
+     * neutral; 0.7–0.8 noticeably more expressive; >0.85 risks theatrical
+     * delivery. Undefined = provider default.
+     */
+    exaggeration?: number;
 }
 interface AgentTranscriber {
     provider: SttProvider;
@@ -74,7 +89,14 @@ interface Agent {
     orgId: string;
     name: string;
     systemPrompt: string;
-    firstMessage: string;
+    /**
+     * When `true` (default), the agent kicks off the conversation as soon
+     * as the call connects — the platform sends the LLM a synthetic
+     * `[CALL_START]` user turn so the model produces a greeting from the
+     * system prompt. When `false`, the agent stays silent until the
+     * caller speaks first.
+     */
+    agentSpeaksFirst?: boolean;
     voice: AgentVoice;
     transcriber: AgentTranscriber;
     model: AgentModel;
@@ -106,7 +128,7 @@ interface Agent {
 interface AgentCreateInput {
     name: string;
     systemPrompt: string;
-    firstMessage?: string;
+    agentSpeaksFirst?: boolean;
     voice?: AgentVoice;
     transcriber?: AgentTranscriber;
     model?: AgentModel;
@@ -308,6 +330,20 @@ interface CallTokenMintResult {
     agentId: string;
     expiresAt: number;
     allowedOrigins?: string[];
+    /**
+     * Transport the agent is configured for. Forward this to the client
+     * SDK's `fetchToken` (rich return form) so it can dispatch correctly
+     * without a second round-trip. Always present in the response;
+     * defaults to `'ws'` for legacy agent docs missing the field.
+     */
+    transport?: 'ws' | 'webrtc';
+    /**
+     * Signaling gateway base URL when `transport === 'webrtc'` AND the
+     * server has `WEBRTC_GATEWAY_BASE` configured. Forward alongside
+     * `transport` so the client SDK reaches the gateway directly instead
+     * of falling back to the Phase-1 routes on the API base (local dev).
+     */
+    webrtcGatewayBase?: string;
 }
 interface CallTokenSummary {
     tokenId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craftedxp/sdk-node",
-  "version": "0.5.0",
+  "version": "0.9.0",
   "description": "Node.js / TypeScript SDK for the voice agent platform. Server-side API client — mint call tokens, manage agents, query calls, upload knowledge-base docs.",
   "author": "Crafted XP",
   "license": "MIT",