@kivox/client 0.1.0-beta.14 → 0.1.0-beta.16

package/dist/index.d.ts

@@ -69,6 +69,7 @@ type Agent = {
 	template_id: string
 	config: AgentConfig
 	blueprint: AgentBlueprint
+	variables: AgentVariable[]
 	status: AgentStatus
 	created_at: Date
 	updated_at: Date
@@ -89,30 +90,15 @@ type AgentBlueprint<
 	nodes: NodeType[]
 	edges: EdgeType[]
 };
-type AgentCreate = Partial<Pick<Agent, "config" | "blueprint" | "status" | "template_id">>;
-type AgentUpdate = Partial<Pick<AgentCreate, "config" | "blueprint">>;
-type NodeType = "entry" | "thread" | "tool" | "exit";
-type Node = {
-	id: string
-	type: NodeType
-	position: NodePosition
-	measured: NodeDimensions
-	data: Record<string, unknown>
-};
-type NodePosition = {
-	x: number
-	y: number
-};
-type NodeDimensions = {
-	width: number
-	height: number
-};
-type Edge = {
-	id: string
-	source: string
-	target: string
-	label: string
+type AgentVariable = {
+	key: string
+	value: string
+	kind: "static" | "dynamic"
+	is_secret: boolean
+	description: string
 };
+type AgentCreate = Partial<Pick<Agent, "config" | "blueprint" | "variables" | "status" | "template_id">>;
+type AgentUpdate = Partial<Pick<AgentCreate, "config" | "blueprint" | "variables">>;
 /**
 * Configuration for listing agents.
 */
@@ -251,197 +237,157 @@ declare class WebSocketTransport {
 	connect(path: string): WebSocket;
 }
 /**
-* Represents a handshake offer initiated by the client.
+* Initializes a new conversational session.
+* It must be the first message sent after connection establishment.
 */
-type ClientSessionHandshakeOffer = {
-	type: "session.handshake.offer"
+type ClientHandshake = {
+	type: "handshake"
 	agent_id: string
 };
 /**
-* Signals that the client has ended the session.
-*/
-type ClientSessionEnd = {
-	type: "session.end"
-	conversation_id: string
-};
-/**
-* Sends a text input from the client to the server.
+* Carries a single user text message.
 */
 type ClientInputText = {
-	type: "input.text"
-	conversation_id: string
+	type: "input_text"
 	text: string
 };
 /**
-* Indicates that the client is starting an audio input.
+* Signals that audio input will begin.
+* Typically followed by one or more binary WebSocket frames.
 */
 type ClientInputAudio = {
-	type: "input.audio"
-	conversation_id: string
+	type: "input_audio"
 };
 /**
-* Represents a continuous stream of audio data from the client.
+* Signals that a streamed audio chunk will follow in the next binary frame.
 */
 type ClientInputAudioStream = {
-	type: "input.audio.stream"
-	conversation_id: string
-};
-/**
-* Signals that the client has cancelled a request.
-*/
-type ClientRequestCancel = {
-	type: "request.cancel"
-	conversation_id: string
-};
-/**
-* Union type for all messages sent from the client to the server.
-*/
-type ClientMessage = ClientSessionHandshakeOffer | ClientSessionEnd | ClientInputText | ClientInputAudio | ClientInputAudioStream | ClientRequestCancel;
-/**
-* Sent by the server when a handshake offer is accepted.
-*/
-type ServerSessionHandshakeAccept = {
-	type: "session.handshake.accept"
-	agent_id: string
-	conversation_id: string
-};
-/**
-* Sent by the server when a handshake offer is rejected.
-*/
-type ServerSessionHandshakeReject = {
-	type: "session.handshake.reject"
-	reason: string
+	type: "input_audio_stream"
 };
 /**
-* Signals that the session has officially started.
+* Requests interruption of the current streaming response.
 */
-type ServerSessionStart = {
-	type: "session.start"
-	conversation_id: string
-	start_time: number
-	end_time: number
-	max_duration_ms: number
+type ClientCancel = {
+	type: "cancel"
 };
 /**
-* Signals that the server has ended the session.
+* Requests graceful session termination.
 */
-type ServerSessionEnd = {
-	type: "session.end"
-	conversation_id: string
+type ClientEndSession = {
+	type: "end"
 };
 /**
-* Periodic update from the server regarding session timing.
+* Union type for all JSON messages sent from the client to the server.
 */
-type ServerSessionTick = {
-	type: "session.tick"
-	conversation_id: string
-	max_duration_ms: number
-	remaining_time_ms: number
-	elapsed_time_ms: number
-};
+type ClientMessage = ClientHandshake | ClientInputText | ClientInputAudio | ClientInputAudioStream | ClientCancel | ClientEndSession;
 /**
-* Sent when a session ends due to inactivity or exceeding max duration.
+* Confirms successful session initialization.
 */
-type ServerSessionTimeout = {
-	type: "session.timeout"
+type ServerHandshakeOK = {
+	type: "handshake_ok"
 	conversation_id: string
 };
 /**
-* Signals that the server has detected the start of speech.
+* Indicates that the session could not be created.
 */
-type ServerSpeechStart = {
-	type: "speech.start"
-	conversation_id: string
+type ServerHandshakeError = {
+	type: "handshake_error"
+	reason: string
 };
 /**
-* Signals that the server has detected the end of speech.
+* Carries a full text message generated by the runtime.
 */
-type ServerSpeechEnd = {
-	type: "speech.end"
-	conversation_id: string
+type ServerTextFull = {
+	type: "text_full"
+	content: string
 };
 /**
-* A partial text response chunk sent by the server.
+* Carries a streamed text fragment generated by the runtime.
 */
-type ServerResponseDeltaText = {
-	type: "response.delta.text"
-	conversation_id: string
+type ServerTextDelta = {
+	type: "text_delta"
 	chunk: string
 };
 /**
-* A partial audio response chunk sent by the server.
+* Carries metadata for a streamed audio fragment generated by the runtime.
+* The actual binary audio data is delivered in the immediately following binary frame
+* and merged into this object by the transport layer.
 */
-type ServerResponseDeltaAudio = {
-	type: "response.delta.audio"
-	conversation_id: string
+type ServerAudioDelta = {
+	type: "audio_delta"
+	/** Expected size of the incoming binary payload in bytes */
 	size: number
+	/** The binary audio data attached dynamically by the transport layer */
 	audio: Blob
 };
 /**
-* Signals that the full response (text or audio) has been delivered.
+* Signals that the runtime has completed its turn and is awaiting further user input.
 */
-type ServerResponseComplete = {
-	type: "response.complete"
-	conversation_id: string
+type ServerTurnComplete = {
+	type: "turn_complete"
 };
 /**
-* Sent when an ongoing response is cancelled successfully.
+* Signals that the conversation flow reached its exit node.
+* The session will close shortly after this event.
 */
-type ServerResponseCancel = {
-	type: "response.cancel"
-	conversation_id: string
+type ServerFlowComplete = {
+	type: "flow_complete"
 };
 /**
-* Sent when an error occurs during processing a request.
+* Represents a non-fatal execution or protocol error.
+* The session remains active unless followed by a SessionClosed event.
 */
-type ServerResponseError = {
-	type: "response.error"
-	conversation_id: string
+type ServerError = {
+	type: "error"
 	code: string
 	message: string
 };
 /**
-* Union type for all messages sent from the server to the client.
+* Provides periodic timing information for the active session.
 */
-type ServerMessage = ServerSessionHandshakeAccept | ServerSessionHandshakeReject | ServerSessionStart | ServerSessionEnd | ServerSessionTick | ServerSessionTimeout | ServerSpeechStart | ServerSpeechEnd | ServerResponseDeltaText | ServerResponseDeltaAudio | ServerResponseComplete | ServerResponseCancel | ServerResponseError;
+type ServerTick = {
+	type: "tick"
+	/** Milliseconds until the session times out */
+	remaining_ms: number
+	/** Milliseconds elapsed since the session started */
+	elapsed_ms: number
+};
 /**
-* Union type for all messages sent from the client to the server before the session is established.
+* Indicates that the session is closing.
 */
-type ServerConnectionMessage = ServerSessionHandshakeAccept | ServerSessionHandshakeReject | ServerSessionStart;
+type ServerSessionClosed = {
+	type: "session_closed"
+	reason: "flow_complete" | "ended_by_agent" | "ended_by_user" | "timeout" | "connection_closed" | "error"
+};
 /**
-* Union type for all messages sent from the server to the client during the session lifecycle.
+* Union type for all messages sent from the server to the client.
 */
-type ServerSessionLifecycleMessage = ServerSessionEnd | ServerSessionTick | ServerSessionTimeout;
+type ServerMessage = ServerHandshakeOK | ServerHandshakeError | ServerTextFull | ServerTextDelta | ServerAudioDelta | ServerTurnComplete | ServerFlowComplete | ServerError | ServerTick | ServerSessionClosed;
 /**
-* Union type for all messages sent from the server to the client during the session activity.
+* Messages related to the initial connection phase.
 */
-type ServerSessionActivityMessage = ServerSpeechStart | ServerSpeechEnd | ServerResponseDeltaText | ServerResponseDeltaAudio | ServerResponseComplete | ServerResponseCancel | ServerResponseError;
+type ServerConnectionMessage = ServerHandshakeOK | ServerHandshakeError;
 /**
-* Synthetic event emitted when the connection to the server is lost.
+* Synthetic event emitted when the WebSocket connection to the server drops unexpectedly.
 */
 type SessionConnectionLostEvent = {
-	type: "session.connection.lost"
-	conversation_id: string
+	type: "connection_lost"
 	reason: "socket_closed" | "socket_error"
 };
 /**
-* Events emitted during an active session
-*
-* @remarks
-* Connection messages are handled internally during connection establishment
-* and are not exposed through the session's `onEvent` callback.
+* Union type of all events that can be emitted during an active conversation session.
 */
-type ServerSessionEvent = ServerSessionLifecycleMessage | ServerSessionActivityMessage | SessionConnectionLostEvent;
+type ServerSessionEvent = ServerTextFull | ServerTextDelta | ServerAudioDelta | ServerTurnComplete | ServerFlowComplete | ServerError | ServerTick | ServerSessionClosed | SessionConnectionLostEvent;
 /**
-* Error thrown by the transport layer.
+* Error thrown by the transport layer when connection or state issues occur.
 */
 declare class ConversationTransportError extends Error {
 	readonly code: string;
 	constructor(message: string, code?: string);
 }
 /**
-* Low-level WebSocket transport for conversation protocol.
-* Handles connection lifecycle and binary/JSON message routing.
+* Low-level WebSocket transport for the conversation protocol.
+* Handles connection lifecycle and distinct routing for JSON and binary messages.
 */
 declare class ConversationTransport {
 	private;
@@ -451,108 +397,139 @@ declare class ConversationTransport {
 	private _onBinary;
 	private _onError;
 	private _onClose;
+	/**
+	* Creates a new ConversationTransport.
+	* @param _ws The underlying WebSocket instance to wrap.
+	*/
 	constructor(_ws: WebSocket);
 	/**
-	* Waits for WebSocket to open.
-	* @throws {ConversationTransportError} If already connected or connection fails
+	* Waits for the WebSocket connection to fully open.
+	* @throws {ConversationTransportError} If the socket is already connected, closing, or fails to connect.
 	*/
 	connect(): Promise<void>;
 	/**
-	* Sends a JSON message to the server.
-	* @throws {ConversationTransportError} If not connected
+	* Sends a structured JSON message to the server.
+	* @param message The client message to send.
+	* @throws {ConversationTransportError} If the WebSocket is not currently open.
 	*/
 	send(message: ClientMessage): void;
 	/**
-	* Sends binary data (audio) to the server.
-	* @throws {ConversationTransportError} If not connected
+	* Sends binary data (like raw audio) to the server via a pure binary WebSocket frame.
+	* @param data The Blob representing the binary data.
+	* @throws {ConversationTransportError} If the WebSocket is not currently open.
 	*/
 	sendBinary(data: Blob): Promise<void>;
 	/**
-	* Registers a callback for incoming JSON messages.
+	* Registers a callback to be invoked when a JSON message is received from the server.
+	* @param handler The callback function.
 	*/
 	onMessage(handler: (msg: ServerMessage) => void): void;
 	/**
-	* Registers a callback for incoming binary data.
+	* Registers a callback to be invoked when a pure binary frame is received from the server.
+	* @param handler The callback function.
 	*/
 	onBinary(handler: (blob: Blob) => void): void;
 	/**
-	* Registers a callback for connection errors.
+	* Registers a callback to be invoked if a WebSocket error occurs.
+	* @param handler The callback function.
 	*/
 	onError(handler: (error: Error) => void): void;
 	/**
-	* Registers a callback for connection closure.
+	* Registers a callback to be invoked when the WebSocket connection is closed.
+	* @param handler The callback function.
 	*/
 	onClose(handler: () => void): void;
 	/**
-	* Closes the WebSocket connection and cleans up resources.
+	* Closes the underlying WebSocket connection and cleans up resources.
 	*/
 	close(): void;
 }
 /**
-* Configuration for a conversation session.
+* Configuration options provided when establishing a conversation session.
 */
 type ConversationSessionConfig = {
 	/**
-	* Event handler for all server messages.
+	* A callback function invoked whenever an event is emitted by the server during the session.
 	*
 	* @remarks
-	* Important: `response.delta.audio` events combine the audio `Blob` and the metadata.
+	* For `audio_delta` events, the SDK automatically waits for the subsequent binary WebSocket frame
+	* and attaches the resulting `Blob` to the event object before triggering this callback.
 	*/
 	onEvent?: (event: ServerSessionEvent) => void
 };
 /**
-* Represents an active conversation session with a KIVOX agent.
-* Provides methods to send messages and audio, and a callback to handle all server events.
+* Represents an active, real-time conversation session with a KIVOX agent.
+* Provides methods to dispatch user inputs and lifecycle commands, as well as tracking basic session state.
 */
 declare class ConversationSession {
 	private;
 	private _transport;
 	private _conversationId;
-	private _maxDurationMs;
-	private _startTime;
-	private _endTime;
 	private _closed;
-	private _pendingAudioMetadata;
 	private _onEvent;
-	/** The unique conversation identifier */
+	private _pendingAudioMetadata;
+	private _remainingMs;
+	private _elapsedMs;
+	/**
+	* The unique server-generated ID for this active conversation.
+	*/
 	get conversationId(): string;
-	/** Maximum session duration in milliseconds */
-	get maxDurationMs(): number;
-	/** Unix timestamp when session started */
-	get startTime(): number;
-	/** Unix timestamp when session will end */
-	get endTime(): number;
-	/** Whether the session has been closed */
+	/**
+	* The number of milliseconds remaining until the engine enforces a session timeout.
+	* This value is periodically synced via server 'tick' events.
+	*/
+	get remainingMs(): number;
+	/**
+	* The number of milliseconds elapsed since the session was initiated.
+	* This value is periodically synced via server 'tick' events.
+	*/
+	get elapsedMs(): number;
+	/**
+	* Indicates whether the session has been permanently closed.
+	*/
 	get closed(): boolean;
-	constructor(transport: ConversationTransport, conversationId: string, maxDurationMs: number, startTime: number, endTime: number, config: ConversationSessionConfig);
 	/**
-	* Sends a text message to the agent.
-	* @param text The message text to send
+	* Constructs a new active ConversationSession.
+	* Normally called internally by `ConversationClient.connect()`.
+	*
+	* @param transport The underlying active WebSocket transport.
+	* @param conversationId The ID assigned by the server during the handshake.
+	* @param config User-provided configuration options (e.g., event handlers).
+	*/
+	constructor(transport: ConversationTransport, conversationId: string, config: ConversationSessionConfig);
+	/**
+	* Sends a single textual user input to the agent.
+	*
+	* @param text The textual payload provided by the user.
 	*/
 	sendText(text: string): void;
 	/**
-	* Sends a complete audio message to the agent.
-	* @param audio Audio blob to send
+	* Sends a complete, recorded audio buffer to the agent.
+	* First sends an `input_audio` header, then dispatches the binary frame.
+	*
+	* @param audio The raw binary audio file/buffer.
 	*/
 	sendAudio(audio: Blob): void;
 	/**
-	* Streams an audio chunk to the agent (for real-time audio input).
-	* @param chunk Audio chunk to stream
+	* Streams a fragment of real-time audio to the agent.
+	* First sends an `input_audio_stream` header, then dispatches the binary frame.
+	*
+	* @param chunk The raw binary audio fragment.
 	*/
 	streamAudio(chunk: Blob): void;
 	/**
-	* Requests the session to be cancelled.
-	* The 'session.cancel' event will be triggered when complete.
+	* Requests that the server immediately halt the currently streaming assistant response.
+	* The session remains open and the agent will await the next user input.
 	*/
 	cancelRequest(): void;
 	/**
-	* Requests the session to end gracefully.
-	* The 'session.end' event will be triggered when complete.
+	* Instructs the server to gracefully terminate the conversation.
+	* Wait for the resulting `session_closed` event to confirm termination.
 	*/
 	end(): void;
 	/**
-	* Immediately closes the session and transport.
-	* No further events will be received.
+	* Immediately tears down the underlying WebSocket transport and marks the session closed locally.
+	* Does not wait for a graceful server acknowledgment.
 	*/
 	close(): void;
 }
@@ -563,49 +540,43 @@ type Conversation = {
 	ended_at?: Date
 };
 /**
-* Configuration for listing conversations.
+* Configuration parameters for fetching a list of past conversations.
 */
 type ConversationListParams = {
-	/** Agent ID to filter by */
+	/** Agent ID to filter the conversations by */
 	agentId: string
-	/** Number of results per page */
+	/** Number of results per page (defaults to 20) */
 	limit?: number
-	/** Page number (1-indexed) */
+	/** Page number, 1-indexed (defaults to 1) */
 	page?: number
 };
 /**
-* Extended configuration for the connect method.
+* Configuration parameters for connecting to an agent and establishing a session.
 */
 type ConversationConnectParams = ConversationSessionConfig & {
-	/** Agent ID to connect to */
+	/** The unique ID of the agent to connect to */
 	agentId: string
 	/**
-	* Optional callback for connection events.
-	* Called during connection establishment, before the session is created.
+	* Optional callback invoked during the initial handshake phase.
+	* Can be used to hook into successful or failed connection attempts before the session object is returned.
 	*/
 	onConnection?: (event: ServerConnectionMessage) => void
 };
 /**
-* Client for managing conversations and establishing sessions.
+* Client service for managing conversational records and establishing real-time WebSocket sessions.
 *
 * @example
 * ```ts
-* // List past conversations
-* const conversations = await kivox.conversations.list();
-*
-* // Connect to an agent
+* // Connect to a KIVOX agent
 * const session = await kivox.conversations.connect({
-*   agentId: 'agent-123',
-*   onEvent: (event) => {
-*     switch (event.type) {
-*       case 'response.delta.text':
-*         console.log(event.chunk);
-*         break;
-*       case 'response.delta.audio':
-*         audioPlayer.enqueue(event.audio);
-*         break;
-*     }
-*   }
+* agentId: 'agent-123',
+* onEvent: (event) => {
+* if (event.type === 'text_delta') {
+* console.log(event.chunk);
+* } else if (event.type === 'audio_delta') {
+* audioPlayer.enqueue(event.audio);
+* }
+* }
 * });
 *
 * session.sendText('Hello!');
@@ -614,27 +585,33 @@ type ConversationConnectParams = ConversationSessionConfig & {
 declare class ConversationClient {
 	private readonly http;
 	private readonly ws;
+	/**
+	* Instantiates a new ConversationClient.
+	* @param http The HTTP transport for REST endpoints.
+	* @param ws The WebSocket transport factory.
+	*/
 	constructor(http: HttpTransport, ws: WebSocketTransport);
 	/**
-	* Lists conversations with optional filtering and pagination.
+	* Retrieves a paginated list of past conversations for a specific agent.
 	*
-	* @param params List configuration
-	* @returns Paginated list of conversations
+	* @param params Query parameters for pagination and filtering.
+	* @returns A promise resolving to a paginated list of conversations.
 	*/
 	list(params: ConversationListParams): Promise<Paginated<Conversation[]>>;
 	/**
-	* Gets a single conversation by ID.
+	* Retrieves the details of a single conversation by its ID.
 	*
-	* @param id Conversation ID
-	* @returns Conversation details
+	* @param id The unique identifier of the conversation.
+	* @returns A promise resolving to the conversation data.
 	*/
 	get(id: string): Promise<Conversation>;
 	/**
-	* Connects to an agent and establishes a conversation session.
+	* Establishes a real-time WebSocket session with an agent.
+	* Handles the handshake protocol and returns an active session instance.
 	*
-	* @param params Connection configuration
-	* @returns Active conversation session
-	* @throws {Error} If handshake fails or connection is lost
+	* @param params Configuration for the connection and subsequent session.
+	* @returns A promise resolving to an active `ConversationSession`.
+	* @throws {Error} If the handshake fails or the connection drops during negotiation.
 	*/
 	connect(params: ConversationConnectParams): Promise<ConversationSession>;
 }
@@ -803,4 +780,18 @@ declare class KivoxClient {
 	readonly messages: MessageClient;
 	constructor(config: KivoxConfig);
 }
-export { TemplateUpdate, TemplateCreate, Template, SessionConnectionLostEvent, ServerSpeechStart, ServerSpeechEnd, ServerSessionTimeout, ServerSessionTick, ServerSessionStart, ServerSessionLifecycleMessage, ServerSessionHandshakeReject, ServerSessionHandshakeAccept, ServerSessionEvent, ServerSessionEnd, ServerSessionActivityMessage, ServerResponseError, ServerResponseDeltaText, ServerResponseDeltaAudio, ServerResponseComplete, ServerResponseCancel, ServerMessage, ServerConnectionMessage, Paginated, NodeType, NodePosition, NodeDimensions, Node, MessageRole, Message, KivoxConfig, KivoxClient, HttpTransportError, Edge, ConversationTransportError, ConversationSessionConfig, ConversationSession, Conversation, ClientSessionHandshakeOffer, ClientSessionEnd, ClientRequestCancel, ClientMessage, ClientInputText, ClientInputAudioStream, ClientInputAudio, AgentUpdate, AgentStatus, AgentCreate, AgentConfig, AgentBlueprint, Agent };
+import { AgentBlueprint as AgentBlueprint2, AgentConfig as AgentConfig2, AgentVariable as AgentVariable2 } from "@kivox/client";
+declare const REGEX_VARIABLE: RegExp;
+/**
+* Extracts all variable references from config and blueprint.
+*/
+declare function extractAllVariables(config: AgentConfig2, blueprint: AgentBlueprint2<Record<string, unknown>, Record<string, unknown>>): string[];
+/**
+* Replaces variable references with their values
+*/
+declare function interpolateVariables(text: string, variables: AgentVariable2[]): string;
+/**
+* Checks if a string contains any variable references.
+*/
+declare function hasVariables(text: string): boolean;
+export { interpolateVariables, hasVariables, extractAllVariables, TemplateUpdate, TemplateCreate, Template, SessionConnectionLostEvent, ServerTurnComplete, ServerTick, ServerTextFull, ServerTextDelta, ServerSessionEvent, ServerSessionClosed, ServerMessage, ServerHandshakeOK, ServerHandshakeError, ServerFlowComplete, ServerError, ServerConnectionMessage, ServerAudioDelta, REGEX_VARIABLE, Paginated, MessageRole, Message, KivoxConfig, KivoxClient, HttpTransportError, ConversationTransportError, ConversationSessionConfig, ConversationSession, Conversation, ClientMessage, ClientInputText, ClientInputAudioStream, ClientInputAudio, ClientHandshake, ClientEndSession, ClientCancel, AgentVariable, AgentUpdate, AgentStatus, AgentCreate, AgentConfig, AgentBlueprint, Agent };

package/dist/index.js

@@ -1 +1 @@
-class J{http;constructor(x){this.http=x}async list(x={}){let K={limit:(x.limit??10).toString(),page:(x.page??1).toString()};if(x.search)K.search=x.search;let B=await this.http.get("/agents",K);return{...B,items:J.parseAgents(B.items)}}async listLive(x={}){let K={limit:(x.limit??10).toString(),page:(x.page??1).toString()};if(x.search)K.search=x.search;let B=await this.http.get("/agents/live",K);return{...B,items:J.parseAgents(B.items)}}async listDraft(x={}){let K={limit:(x.limit??10).toString(),page:(x.page??1).toString()};if(x.search)K.search=x.search;let B=await this.http.get("/agents/draft",K);return{...B,items:J.parseAgents(B.items)}}async listArchived(x={}){let K={limit:(x.limit??10).toString(),page:(x.page??1).toString()};if(x.search)K.search=x.search;let B=await this.http.get("/agents/archived",K);return{...B,items:J.parseAgents(B.items)}}async get(x){let K=await this.http.get(`/agents/${x}`);return J.parseAgent(K)}async create(x){let K=await this.http.post("/agents",x);return J.parseAgent(K)}async update(x,K){let B=await this.http.put(`/agents/${x}`,K);return J.parseAgent(B)}async markAsLive(x){let K=await this.http.patch(`/agents/${x}/live`);return J.parseAgent(K)}async markAsDraft(x){let K=await this.http.patch(`/agents/${x}/draft`);return J.parseAgent(K)}async markAsArchived(x){let K=await this.http.patch(`/agents/${x}/archived`);return J.parseAgent(K)}async delete(x){let K=await this.http.delete(`/agents/${x}`);return J.parseAgent(K)}static parseAgents(x){return x.map(J.parseAgent)}static parseAgent(x){return{...x,config:JSON.parse(x.config),blueprint:JSON.parse(x.blueprint)}}}class _{_transport;_conversationId;_maxDurationMs;_startTime;_endTime;_closed=!1;_pendingAudioMetadata=null;_onEvent;get conversationId(){return this._conversationId}get maxDurationMs(){return this._maxDurationMs}get startTime(){return this._startTime}get endTime(){return this._endTime}get closed(){return this._closed}constructor(x,K,B,F,Q,Y){this._transport=x,this._conversationId=K,this._maxDurationMs=B,this._startTime=F,this._endTime=Q,this._onEvent=Y.onEvent,this.#x()}sendText(x){if(this._closed){console.warn("Cannot send text: session is closed");return}this._transport.send({type:"input.text",conversation_id:this._conversationId,text:x})}sendAudio(x){if(this._closed){console.warn("Cannot send audio: session is closed");return}this._transport.send({type:"input.audio",conversation_id:this._conversationId}),this._transport.sendBinary(x)}streamAudio(x){if(this._closed){console.warn("Cannot stream audio: session is closed");return}this._transport.send({type:"input.audio.stream",conversation_id:this._conversationId}),this._transport.sendBinary(x)}cancelRequest(){if(this._closed){console.warn("Cannot cancel session: session is closed");return}this._transport.send({type:"request.cancel",conversation_id:this._conversationId})}end(){if(this._closed){console.warn("Cannot end session: session is closed");return}this._transport.send({type:"session.end",conversation_id:this._conversationId})}close(){if(this._closed)return;this._closed=!0,this._transport.close()}#x(){this._transport.onMessage((x)=>{let K=x;if(K.type==="response.delta.audio"){this._pendingAudioMetadata={conversation_id:K.conversation_id,size:K.size};return}if(K.type==="session.end"||K.type==="session.timeout"||K.type==="session.connection.lost")this._closed=!0;this._onEvent?.(K)}),this._transport.onBinary((x)=>{if(this._pendingAudioMetadata){let K={type:"response.delta.audio",conversation_id:this._pendingAudioMetadata.conversation_id,size:this._pendingAudioMetadata.size,audio:x};this._pendingAudioMetadata=null,this._onEvent?.(K)}}),this._transport.onClose(()=>{if(this._closed)return;this._closed=!0,this._onEvent?.({type:"session.connection.lost",conversation_id:this._conversationId,reason:"socket_closed"})}),this._transport.onError(()=>{if(this._closed)return;this._closed=!0,this._onEvent?.({type:"session.connection.lost",conversation_id:this._conversationId,reason:"socket_error"})})}}class Z extends Error{code;constructor(x,K="TRANSPORT_ERROR"){super(x);this.code=K;this.name="ConversationTransportError"}}class ${_ws;_closed=!1;_onMessage=null;_onBinary=null;_onError=null;_onClose=null;constructor(x){this._ws=x}async connect(){if(this._ws.readyState===WebSocket.OPEN)throw new Z("Already connected","ALREADY_CONNECTED");if(this._ws.readyState===WebSocket.CLOSING||this._ws.readyState===WebSocket.CLOSED)throw new Z("Socket is closing or closed","SOCKET_CLOSED");return new Promise((x,K)=>{let B=()=>{this._ws.removeEventListener("open",B),this._ws.removeEventListener("error",F),this.#x(),x()},F=()=>{this._ws.removeEventListener("open",B),this._ws.removeEventListener("error",F),K(new Z("Connection failed","CONNECTION_FAILED"))};this._ws.addEventListener("open",B),this._ws.addEventListener("error",F)})}send(x){if(this._ws.readyState!==WebSocket.OPEN)throw new Z("Not connected","NOT_CONNECTED");this._ws.send(JSON.stringify(x))}async sendBinary(x){if(this._ws.readyState!==WebSocket.OPEN)throw new Z("Not connected","NOT_CONNECTED");let K=await x.arrayBuffer();this._ws.send(K)}onMessage(x){this._onMessage=x}onBinary(x){this._onBinary=x}onError(x){this._onError=x}onClose(x){this._onClose=x}close(){if(this._closed)return;if(this._closed=!0,this._ws.readyState===WebSocket.OPEN||this._ws.readyState===WebSocket.CONNECTING)this._ws.close();this._onClose?.()}#x(){this._ws.addEventListener("message",(x)=>{if(x.data instanceof Blob)this._onBinary?.(x.data);else if(x.data instanceof ArrayBuffer)this._onBinary?.(new Blob([x.data]));else try{let K=JSON.parse(x.data);this._onMessage?.(K)}catch(K){console.warn("Failed to parse message:",x.data,K)}}),this._ws.addEventListener("error",()=>{if(this._closed)return;this._onError?.(new Z("WebSocket error")),this.close()}),this._ws.addEventListener("close",()=>{if(this._closed)return;this.close()})}}class z{http;ws;constructor(x,K){this.http=x;this.ws=K}async list(x){let K={limit:(x.limit??20).toString(),page:(x.page??1).toString()};return this.http.get(`/agents/${x.agentId}/conversations`,K)}async get(x){return this.http.get(`/conversations/${x}`)}async connect(x){let K=this.ws.connect("/conversations/websocket"),B=new $(K);return await B.connect(),B.send({type:"session.handshake.offer",agent_id:x.agentId}),new Promise((F,Q)=>{let Y=!1;B.onMessage((N)=>{switch(N.type){case"session.handshake.accept":x.onConnection?.(N);break;case"session.handshake.reject":Y=!0,x.onConnection?.(N),B.close(),Q(Error(`Handshake rejected: ${N.reason}`));break;case"session.start":{Y=!0,x.onConnection?.(N);let W=new _(B,N.conversation_id,N.max_duration_ms,N.start_time,N.end_time,x);F(W);break}default:break}}),B.onError((N)=>{if(!Y)Q(N)}),B.onClose(()=>{if(!Y)Q(Error("WebSocket connection lost during handshake"))})})}}function O(x){let K=new URL(x),B=K.protocol==="https:"?"wss:":"ws:";return{rest:`${K.origin}/v1`,ws:`${B}//${K.host}/v1`}}class G extends Error{status;statusText;body;constructor(x,K,B,F){super(x);this.status=K;this.statusText=B;this.body=F;this.name="HttpTransportError"}}class V{config;constructor(x){this.config=x}async request(x,K){let B=`${this.config.baseUrl}${x}`,F=await fetch(B,{...K,headers:{"Content-Type":"application/json",...this.config.headers,...K?.headers}});if(!F.ok){let Q=await F.text();throw new G(`HTTP ${F.status}: ${F.statusText}`,F.status,F.statusText,Q)}return F.json()}async get(x,K){let B=new URL(`${this.config.baseUrl}${x}`);if(K){let F=Object.entries(K);for(let[Q,Y]of F)B.searchParams.set(Q,Y)}return this.request(x+B.search,{method:"GET"})}async post(x,K){return this.request(x,{method:"POST",body:K?JSON.stringify(K):void 0})}async put(x,K){return this.request(x,{method:"PUT",body:K?JSON.stringify(K):void 0})}async patch(x,K){return this.request(x,{method:"PATCH",body:K?JSON.stringify(K):void 0})}async delete(x){return this.request(x,{method:"DELETE"})}}class X{config;constructor(x){this.config=x}connect(x){let K=`${this.config.baseUrl}${x}`;return new WebSocket(K)}}class L{http;constructor(x){this.http=x}async list(x={}){let K={limit:(x.limit??50).toString(),page:(x.page??1).toString()};if(x.conversationId)K.conversation_id=x.conversationId;return this.http.get("/messages",K)}async get(x){return this.http.get(`/messages/${x}`)}}class H{http;constructor(x){this.http=x}async list(x={}){let K={limit:(x.limit??10).toString(),page:(x.page??1).toString()};return this.http.get("/templates",K)}async get(x){return this.http.get(`/templates/${x}`)}async create(x){return this.http.post("/templates",x)}async update(x,K){return this.http.put(`/templates/${x}`,K)}async delete(x){return this.http.delete(`/templates/${x}`)}}class U{agents;conversations;templates;messages;constructor(x){let K=O(x.baseUrl),B=new V({baseUrl:K.rest,headers:x.headers}),F=new X({baseUrl:K.ws,headers:x.headers});this.agents=new J(B),this.templates=new H(B),this.conversations=new z(B,F),this.messages=new L(B)}}export{U as KivoxClient,G as HttpTransportError,Z as ConversationTransportError,_ as ConversationSession};
+class Z{http;constructor(K){this.http=K}async list(K={}){let J={limit:(K.limit??10).toString(),page:(K.page??1).toString()};if(K.search)J.search=K.search;let Q=await this.http.get("/agents",J);return{...Q,items:Z.parseAgents(Q.items)}}async listLive(K={}){let J={limit:(K.limit??10).toString(),page:(K.page??1).toString()};if(K.search)J.search=K.search;let Q=await this.http.get("/agents/live",J);return{...Q,items:Z.parseAgents(Q.items)}}async listDraft(K={}){let J={limit:(K.limit??10).toString(),page:(K.page??1).toString()};if(K.search)J.search=K.search;let Q=await this.http.get("/agents/draft",J);return{...Q,items:Z.parseAgents(Q.items)}}async listArchived(K={}){let J={limit:(K.limit??10).toString(),page:(K.page??1).toString()};if(K.search)J.search=K.search;let Q=await this.http.get("/agents/archived",J);return{...Q,items:Z.parseAgents(Q.items)}}async get(K){let J=await this.http.get(`/agents/${K}`);return Z.parseAgent(J)}async create(K){let J=await this.http.post("/agents",K);return Z.parseAgent(J)}async update(K,J){let Q=await this.http.put(`/agents/${K}`,J);return Z.parseAgent(Q)}async markAsLive(K){let J=await this.http.patch(`/agents/${K}/live`);return Z.parseAgent(J)}async markAsDraft(K){let J=await this.http.patch(`/agents/${K}/draft`);return Z.parseAgent(J)}async markAsArchived(K){let J=await this.http.patch(`/agents/${K}/archived`);return Z.parseAgent(J)}async delete(K){let J=await this.http.delete(`/agents/${K}`);return Z.parseAgent(J)}static parseAgents(K){return K.map(Z.parseAgent)}static parseAgent(K){return{...K,config:JSON.parse(K.config),blueprint:JSON.parse(K.blueprint),variables:JSON.parse(K.variables)}}}class O{_transport;_conversationId;_closed=!1;_onEvent;_pendingAudioMetadata=null;_remainingMs=0;_elapsedMs=0;get conversationId(){return this._conversationId}get remainingMs(){return this._remainingMs}get elapsedMs(){return this._elapsedMs}get closed(){return this._closed}constructor(K,J,Q){this._transport=K,this._conversationId=J,this._onEvent=Q.onEvent,this.#K()}sendText(K){if(this._closed){console.warn("Cannot send text: session is closed");return}this._transport.send({type:"input_text",text:K})}sendAudio(K){if(this._closed){console.warn("Cannot send audio: session is closed");return}this._transport.send({type:"input_audio"}),this._transport.sendBinary(K)}streamAudio(K){if(this._closed){console.warn("Cannot stream audio: session is closed");return}this._transport.send({type:"input_audio_stream"}),this._transport.sendBinary(K)}cancelRequest(){if(this._closed){console.warn("Cannot cancel request: session is closed");return}this._transport.send({type:"cancel"})}end(){if(this._closed){console.warn("Cannot end session: session is closed");return}this._transport.send({type:"end"})}close(){if(this._closed)return;this._closed=!0,this._transport.close()}#K(){this._transport.onMessage((K)=>{let J=K;if(J.type==="audio_delta"){this._pendingAudioMetadata={size:J.size};return}if(J.type==="tick")this._remainingMs=J.remaining_ms,this._elapsedMs=J.elapsed_ms;if(J.type==="session_closed")this._closed=!0;this._onEvent?.(J)}),this._transport.onBinary((K)=>{if(this._pendingAudioMetadata){let J={type:"audio_delta",size:this._pendingAudioMetadata.size,audio:K};this._pendingAudioMetadata=null,this._onEvent?.(J)}}),this._transport.onClose(()=>{if(this._closed)return;this._closed=!0,this._onEvent?.({type:"connection_lost",reason:"socket_closed"})}),this._transport.onError(()=>{if(this._closed)return;this._closed=!0,this._onEvent?.({type:"connection_lost",reason:"socket_error"})})}}class z extends Error{code;constructor(K,J="TRANSPORT_ERROR"){super(K);this.code=J;this.name="ConversationTransportError"}}class X{_ws;_closed=!1;_onMessage=null;_onBinary=null;_onError=null;_onClose=null;constructor(K){this._ws=K}async connect(){if(this._ws.readyState===WebSocket.OPEN)throw new z("Already connected","ALREADY_CONNECTED");if(this._ws.readyState===WebSocket.CLOSING||this._ws.readyState===WebSocket.CLOSED)throw new z("Socket is closing or closed","SOCKET_CLOSED");return new Promise((K,J)=>{let Q=()=>{this._ws.removeEventListener("open",Q),this._ws.removeEventListener("error",Y),this.#K(),K()},Y=()=>{this._ws.removeEventListener("open",Q),this._ws.removeEventListener("error",Y),J(new z("Connection failed","CONNECTION_FAILED"))};this._ws.addEventListener("open",Q),this._ws.addEventListener("error",Y)})}send(K){if(this._ws.readyState!==WebSocket.OPEN)throw new z("Not connected","NOT_CONNECTED");this._ws.send(JSON.stringify(K))}async sendBinary(K){if(this._ws.readyState!==WebSocket.OPEN)throw new z("Not connected","NOT_CONNECTED");let J=await K.arrayBuffer();this._ws.send(J)}onMessage(K){this._onMessage=K}onBinary(K){this._onBinary=K}onError(K){this._onError=K}onClose(K){this._onClose=K}close(){if(this._closed)return;if(this._closed=!0,this._ws.readyState===WebSocket.OPEN||this._ws.readyState===WebSocket.CONNECTING)this._ws.close();this._onClose?.()}#K(){this._ws.addEventListener("message",(K)=>{if(K.data instanceof Blob)this._onBinary?.(K.data);else if(K.data instanceof ArrayBuffer)this._onBinary?.(new Blob([K.data]));else if(typeof K.data==="string")try{let J=JSON.parse(K.data);this._onMessage?.(J)}catch(J){console.warn("Failed to parse JSON message:",K.data,J)}}),this._ws.addEventListener("error",()=>{if(this._closed)return;this._onError?.(new z("WebSocket error")),this.close()}),this._ws.addEventListener("close",()=>{if(this._closed)return;this.close()})}}class _{http;ws;constructor(K,J){this.http=K;this.ws=J}async list(K){let J={limit:(K.limit??20).toString(),page:(K.page??1).toString()};return this.http.get(`/agents/${K.agentId}/conversations`,J)}async get(K){return this.http.get(`/conversations/${K}`)}async connect(K){let J=this.ws.connect("/conversations/websocket"),Q=new X(J);return await Q.connect(),Q.send({type:"handshake",agent_id:K.agentId}),new Promise((Y,$)=>{let B=!1;Q.onMessage((N)=>{switch(N.type){case"handshake_ok":B=!0,K.onConnection?.(N),Y(new O(Q,N.conversation_id,K));break;case"handshake_error":B=!0,K.onConnection?.(N),Q.close(),$(Error(`Handshake rejected: ${N.reason}`));break;default:break}}),Q.onError((N)=>{if(!B)$(N)}),Q.onClose(()=>{if(!B)$(Error("WebSocket connection lost during handshake"))})})}}function M(K){let J=new URL(K),Q=J.protocol==="https:"?"wss:":"ws:";return{rest:`${J.origin}/v1`,ws:`${Q}//${J.host}/v1`}}class x extends Error{status;statusText;body;constructor(K,J,Q,Y){super(K);this.status=J;this.statusText=Q;this.body=Y;this.name="HttpTransportError"}}class D{config;constructor(K){this.config=K}async request(K,J){let Q=`${this.config.baseUrl}${K}`,Y=await fetch(Q,{...J,headers:{"Content-Type":"application/json",...this.config.headers,...J?.headers}});if(!Y.ok){let $=await Y.text();throw new x(`HTTP ${Y.status}: ${Y.statusText}`,Y.status,Y.statusText,$)}return Y.json()}async get(K,J){let Q=new URL(`${this.config.baseUrl}${K}`);if(J){let Y=Object.entries(J);for(let[$,B]of Y)Q.searchParams.set($,B)}return this.request(K+Q.search,{method:"GET"})}async post(K,J){return this.request(K,{method:"POST",body:J?JSON.stringify(J):void 0})}async put(K,J){return this.request(K,{method:"PUT",body:J?JSON.stringify(J):void 0})}async patch(K,J){return this.request(K,{method:"PATCH",body:J?JSON.stringify(J):void 0})}async delete(K){return this.request(K,{method:"DELETE"})}}class H{config;constructor(K){this.config=K}connect(K){let J=`${this.config.baseUrl}${K}`;return new WebSocket(J)}}class U{http;constructor(K){this.http=K}async list(K={}){let J={limit:(K.limit??50).toString(),page:(K.page??1).toString()};if(K.conversationId)J.conversation_id=K.conversationId;return this.http.get("/messages",J)}async get(K){return this.http.get(`/messages/${K}`)}}class F{http;constructor(K){this.http=K}async list(K={}){let J={limit:(K.limit??10).toString(),page:(K.page??1).toString()};return this.http.get("/templates",J)}async get(K){return this.http.get(`/templates/${K}`)}async create(K){return this.http.post("/templates",K)}async update(K,J){return this.http.put(`/templates/${K}`,J)}async delete(K){return this.http.delete(`/templates/${K}`)}}class W{agents;conversations;templates;messages;constructor(K){let J=M(K.baseUrl),Q=new D({baseUrl:J.rest,headers:K.headers}),Y=new H({baseUrl:J.ws,headers:K.headers});this.agents=new Z(Q),this.templates=new F(Q),this.conversations=new _(Q,Y),this.messages=new U(Q)}}var L=/\{\{([a-zA-Z_][a-zA-Z0-9_]*)\}\}/g;function j(K){let J=new Set,Q;while((Q=L.exec(K))!==null){let Y=Q[1];if(!Y)continue;J.add(Y)}return J}function G(K,J){if(typeof K==="string"){let Q=j(K);for(let Y of Q)J.add(Y)}else if(Array.isArray(K))for(let Q of K)G(Q,J);else if(typeof K==="object"&&K!==null){let Q=Object.values(K);for(let Y of Q)G(Y,J)}}function v(K,J){let Q=new Set;G(K,Q);for(let Y of J.nodes)if(Y.data)G(Y.data,Q);for(let Y of J.edges)if(Y.data)G(Y.data,Q);return Array.from(Q).toSorted()}function d(K,J){let Q=new Map(J.map((Y)=>[Y.key,Y.value]));return K.replace(L,(Y,$)=>{return Q.get($)??Y})}function m(K){return L.test(K)}export{d as interpolateVariables,m as hasVariables,v as extractAllVariables,L as REGEX_VARIABLE,W as KivoxClient,x as HttpTransportError,z as ConversationTransportError,O as ConversationSession};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kivox/client",
-  "version": "0.1.0-beta.14",
+  "version": "0.1.0-beta.16",
   "description": "JavaScript/TypeScript client for KIVOX",
   "homepage": "https://github.com/ekisa-team/kivox#readme",
   "bugs": {