@d-id/client-sdk 2.0.6 → 2.0.7-staging.404

package/dist/src/services/agent-manager/connect-to-manager.d.ts

@@ -1,5 +1,5 @@
 import { StreamingManager } from '../streaming-manager';
-import { Agent, AgentManagerOptions, AgentsAPI, AudioDetectionMetrics, Chat, ChatProgressCallback, CreateSessionV2Options, CreateStreamOptions } from '../../types';
+import { Agent, AgentManagerOptions, AgentsAPI, AudioDetectionMetrics, Chat, ChatProgressCallback, CreateSessionV2Options, CreateStreamOptions, StreamingManagerOptions } from '../../types';
 import { Analytics } from '../analytics/mixpanel';
 
 type ConnectToManagerOptions = AgentManagerOptions & {
@@ -10,6 +10,7 @@ type ConnectToManagerOptions = AgentManagerOptions & {
         onFirstAudioDetected?: (metrics: AudioDetectionMetrics) => void;
     };
     chatId?: string;
+    rpcMethods?: StreamingManagerOptions['rpcMethods'];
 };
 export declare function initializeStreamAndChat(agent: Agent, options: ConnectToManagerOptions, agentsApi: AgentsAPI, analytics: Analytics, chat?: Chat): Promise<{
     chat?: Chat;

package/dist/src/services/socket-manager/message-queue.d.ts

@@ -6,7 +6,7 @@ export interface ChatEventQueue {
     [sequence: number]: string;
     answer?: string;
 }
-export declare function createMessageEventQueue(analytics: Analytics, items: AgentManagerItems, options: AgentManagerOptions, agentEntity: Agent, onStreamDone: () => void): {
+export declare function createMessageEventQueue(analytics: Analytics, items: AgentManagerItems, options: AgentManagerOptions, agentEntity: Agent, onStreamDone: (reason?: string) => void): {
     clearQueue: () => void;
     onMessage: (event: ChatProgress | StreamEvents, data: any) => void;
 };

package/dist/src/services/streaming-manager/advanced.test.d.ts

@@ -1,5 +1 @@
-/**
- * Advanced functionality tests for streaming manager
- * Tests complex scenarios, edge cases, and advanced features
- */
 export {};

package/dist/src/services/streaming-manager/common.d.ts

@@ -1,4 +1,5 @@
 import { CreateSessionV2Options, CreateStreamOptions, Interrupt, PayloadType, StreamType } from '../../types';
+import { DataChannelTopic } from '../../types/stream/data-channel';
 
 export declare const createStreamingLogger: (debug: boolean, prefix: string) => (message: string, extra?: any) => false | void;
 /**
@@ -16,16 +17,13 @@ export type StreamingManager<T extends CreateStreamOptions | CreateSessionV2Opti
      */
     disconnect(): Promise<void>;
     /**
-     * Method to send data channel messages to the server
-     * @param payload The message payload to send
+     * The single send primitive: every message leaving the client goes out through here.
+     * V2 routes on the topic; V1 has no topic concept and ignores it.
+     * The promise tracks the send attempt and never rejects - failures go to `callbacks.onError`.
+     * @param topic Data-channel topic to send on
+     * @param payload The message payload to send, already serialized
      */
-    sendDataChannelMessage(payload: string): void;
-    /**
-     * Method to send text messages to the server
-     * @param payload The message payload to send
-     * supported only for livekit manager
-     */
-    sendTextMessage?(payload: string): Promise<void>;
+    sendDataChannelMessage(topic: DataChannelTopic, payload: string): Promise<void>;
     /**
      * Publish a microphone stream to the DataChannel
      * Can be called after connection to add microphone input
@@ -81,19 +79,9 @@ export type StreamingManager<T extends CreateStreamOptions | CreateSessionV2Opti
      */
     isInterruptible: boolean;
     /**
-     * Send an interrupt for the current stream segment.
-     * Each implementation owns the validation/transport details (e.g. V1
-     * sends a `stream/interrupt` payload over the data channel; V2 sends
-     * `did.interrupt` and ignores `text` interrupts to avoid races).
+     * Send an interrupt for the current stream segment
      */
     interrupt(type: Interrupt['type']): void;
-    /**
-     * Switch the STT language mid-session.
-     * Only available for Expressive (V4) agents.
-     * supported only for livekit manager
-     * @param language Language name or BCP-47 code (e.g. "English" or "en-US")
-     */
-    setSttLanguage?(language: string): Promise<void>;
     /**
      * Register an RPC method handler on the LiveKit room.
      * Used internally by the agent-manager for client tool delegation.

package/dist/src/services/streaming-manager/edge-cases.test.d.ts

@@ -1,5 +1 @@
-/**
- * Edge cases and branch coverage tests for streaming manager
- * Tests detailed edge cases, error conditions, and branch coverage scenarios
- */
 export {};

package/dist/src/services/streaming-manager/livekit-manager.d.ts

@@ -1,12 +1,6 @@
 import { CreateSessionV2Options, CreateStreamOptions, StreamingManagerOptions } from '../../types';
 import { StreamingManager } from './common';
 
-export declare enum DataChannelTopic {
-    Chat = "lk.chat",
-    Speak = "did.speak",
-    Interrupt = "did.interrupt",
-    SttLanguage = "did.stt-language"
-}
 export declare function handleInitError(error: unknown, log: (message?: any, ...optionalParams: any[]) => void, callbacks: StreamingManagerOptions['callbacks']): void;
 export declare function createLiveKitStreamingManager<T extends CreateSessionV2Options>(agentId: string, sessionOptions: CreateSessionV2Options, options: StreamingManagerOptions): Promise<StreamingManager<T> & {
     reconnect(): Promise<void>;

package/dist/src/services/streaming-manager/webrtc-core.test.d.ts

@@ -1,5 +1 @@
-/**
- * Core functionality tests for streaming manager
- * Tests basic streaming manager creation, connection, and operations
- */
 export {};

package/dist/src/types/entities/agents/agent.d.ts

@@ -41,6 +41,11 @@ export interface Agent {
         vm_account_id?: string;
         closed_captions_enabled?: boolean;
     };
+    ld_context?: {
+        key: string;
+        hash_key: string;
+        plan_group: string;
+    };
 }
 export interface AgentsAPI {
     getRuntimeById(id: string, options?: RequestInit): Promise<Agent>;

package/dist/src/types/entities/agents/manager.d.ts

@@ -1,6 +1,6 @@
 import { STTTokenResponse } from '../..';
 import { Auth } from '../../auth';
-import { AgentActivityState, ClientToolHandler, CompatibilityMode, ConnectionState, ConnectivityState, SendStreamPayloadResponse, StreamEvents, StreamType, StreamingState } from '../../stream';
+import { AgentActivityState, ClientToolHandler, CompatibilityMode, ConnectionState, ConnectivityState, PublicDataChannelTopic, SendStreamPayloadResponse, StreamEvents, StreamType, StreamingState } from '../../stream';
 import { SupportedStreamScript } from '../../stream-script';
 import { ManagerCallbacks as StreamManagerCallbacks } from '../../stream/stream';
 import { Agent } from './agent';
@@ -42,8 +42,9 @@ interface ManagerCallbacks {
     /**
      * Optional callback will be triggered each time the RTC connection changes state
      * @param state
+     * @param reason - a `StreamEndReason` when the server ended the stream, otherwise a diagnostic string
      */
-    onConnectionStateChange?(state: ConnectionState): void;
+    onConnectionStateChange?(state: ConnectionState, reason?: string): void;
     /**
      * Optional callback function that will be triggered each time video events happen
      * @param state
@@ -292,6 +293,13 @@ export interface AgentManager {
      * @param language - Language name or BCP-47 code (e.g. "English" or "en-US")
      */
     setSttLanguage: (language: string) => Promise<void>;
+    /**
+     * Send a JSON payload to the agent over a data-channel topic
+     * Only available for Expressive (V4) agents
+     * @param topic - Data-channel topic to send on (see `PublicDataChannelTopic`)
+     * @param payload - Plain object, serialized as JSON
+     */
+    sendDataChannelMessage: (topic: PublicDataChannelTopic, payload: Record<string, unknown>) => Promise<void>;
     /**
      * Register a handler for a client tool. When the agent's LLM calls this tool,
      * the handler executes on the client and returns the result to the LLM.

package/dist/src/types/entities/knowledge/document.d.ts

@@ -1,8 +1,18 @@
-import { KnowledgeType } from './knowledge';
+import { DocumentType, KnowledgeType } from './knowledge';
 
+/**
+ * Lifecycle status of a document, as served by the knowledge API. The API stores the
+ * status as a prefixed event subject (`document/done`) but strips the prefix on read,
+ * so the wire value is always bare.
+ */
+export type DocumentStatus = 'created' | 'processed' | 'done' | 'rejected' | 'error';
+/**
+ * @deprecated The knowledge API has never served these prefixed values — it strips the
+ * subject prefix on read. Use `DocumentStatus` instead. Kept for backwards compatibility
+ * and will be removed in the next major.
+ */
 export declare enum Subject {
     KnowledgeProcessing = "knowledge/processing",
-    KnowledgeIndexing = "knowledge/indexing",
     KnowledgeFailed = "knowledge/error",
     KnowledgeDone = "knowledge/done"
 }
@@ -12,7 +22,7 @@ export interface DocumentData {
     owner_id: string;
     id: string;
     created_by: string;
-    status: Subject;
+    status: DocumentStatus;
     documentType: DocumentType;
     type: KnowledgeType;
     source_url: string;

package/dist/src/types/stream/data-channel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Data-channel topics messages can be sent on.
+ * V2 (LiveKit) routes by topic; V1 (WebRTC) has no topic concept and ignores it.
+ *
+ * Internal on purpose: this module is deliberately left out of the `stream`
+ * barrel so the topics driven by dedicated methods (`chat`, `speak`,
+ * `interrupt`, `setSttLanguage`) never reach the package's public API.
+ * Customers get `PublicDataChannelTopic` instead.
+ */
+export declare enum DataChannelTopic {
+    Chat = "lk.chat",
+    Speak = "did.speak",
+    Interrupt = "did.interrupt",
+    SttLanguage = "did.stt-language",
+    Presentation = "did.presentation"
+}

package/dist/src/types/stream/stream.d.ts

@@ -3,6 +3,7 @@ import { VideoRTCStatsReport } from '../../services/streaming-manager/stats/repo
 import { Auth } from '../auth';
 import { ChatProgressCallback } from '../entities/agents/manager';
 import { CreateClipStreamRequest, CreateTalkStreamRequest, SendClipStreamPayload, SendTalkStreamPayload } from './api';
+import { DataChannelTopic } from './data-channel';
 import { ICreateStreamRequestResponse, IceCandidate, SendStreamPayloadResponse, Status } from './rtc';
 
 export type CompatibilityMode = 'on' | 'off' | 'auto';
@@ -41,6 +42,20 @@ export declare enum StreamEvents {
     TurnStarted = "turn/started",
     TurnEnded = "turn/ended"
 }
+/**
+ * Topics a customer can send on via `agentManager.sendDataChannelMessage`.
+ * The remaining `DataChannelTopic` members are driven by their own methods
+ * (`chat`, `speak`, `interrupt`, `setSttLanguage`), which own the payload shape
+ * and bookkeeping those topics expect, so they stay internal.
+ *
+ * A const object rather than a second enum: it borrows the value from
+ * `DataChannelTopic`, so there is one source of truth for the wire string and
+ * no cast is needed where the topic reaches the transport.
+ */
+export declare const PublicDataChannelTopic: {
+    readonly Presentation: DataChannelTopic.Presentation;
+};
+export type PublicDataChannelTopic = (typeof PublicDataChannelTopic)[keyof typeof PublicDataChannelTopic];
 export declare enum ConnectionState {
     New = "new",
     Fail = "fail",
@@ -55,6 +70,10 @@ export declare enum StreamType {
     Legacy = "legacy",
     Fluent = "fluent"
 }
+/** @internal */
+export type RpcMethodHandler = (data: {
+    payload: string;
+}) => Promise<string>;
 export interface ManagerCallbacks {
     onMessage?: ChatProgressCallback;
     onConnectionStateChange?: (state: ConnectionState, reason?: string) => void;
@@ -113,6 +132,12 @@ export interface StreamingManagerOptions {
      * Supported by LiveKit streaming managers.
      */
     microphoneStream?: MediaStream;
+    /**
+     * RPC methods to register on the room before it connects, so the agent can
+     * call them from the moment this participant joins.
+     * @internal
+     */
+    rpcMethods?: ReadonlyMap<string, RpcMethodHandler>;
 }
 export interface SlimRTCStatsReport {
     index: number;
@@ -225,6 +250,15 @@ export type ToolEventPayload = ToolCallStartedPayload | ToolCallDonePayload | To
 export interface TurnEventPayload {
     turn_id: number | null;
 }
+export declare enum StreamEndReason {
+    Ok = "ok",
+    UnknownError = "unknown_error",
+    NetworkIssue = "network_issue",
+    MessageLimit = "message_limit",
+    TimeLimit = "time_limit",
+    Inactivity = "inactivity",
+    EndedByAgent = "ended_by_agent"
+}
 export type ToolEventCallback = {
     (event: StreamEvents.ToolCallStarted, data: ToolCallStartedPayload): void;
     (event: StreamEvents.ToolCallDone, data: ToolCallDonePayload): void;

package/dist/src/utils/stream-end.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Legacy streams report the session end as `stream/done` with a `close_reason`.
+ * A reason we do not recognise is forwarded as-is rather than reported as an error.
+ */
+export declare function toStreamEndReason(data: any): string | undefined;

package/dist/src/utils/stream-end.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d-id/client-sdk",
   "private": false,
-  "version": "2.0.6",
+  "version": "2.0.7-staging.404",
   "type": "module",
   "description": "d-id client sdk",
   "repository": {