@onlive.ai/common-121 0.2.70 → 0.2.179

package/services/conversation/mock/actor/agent.d.cts

@@ -0,0 +1,202 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+import { MockAgentConfig, MockAgentStatus, MockAgentMessage, MockAgentResponseStrategy } from '../types.cjs';
+
+/**
+ * @file Mock AI Agent implementation.
+ *
+ * @description Provides a mock AI agent that can simulate responses in conversations.
+ * Supports multiple response strategies and conversation history tracking.
+ */
+
+/**
+ * Custom response handler type.
+ */
+type MockAgentResponseHandler = (agentId: string, userMessage: string, history: MockAgentMessage[]) => string | Promise<string>;
+/**
+ * Agent event types.
+ */
+type MockAgentEvent = {
+    type: "started";
+    agentId: string;
+} | {
+    type: "stopped";
+    agentId: string;
+} | {
+    type: "message_received";
+    agentId: string;
+    message: string;
+} | {
+    type: "response_sent";
+    agentId: string;
+    response: string;
+} | {
+    type: "error";
+    agentId: string;
+    error: Error;
+};
+/**
+ * Agent event listener.
+ */
+type MockAgentEventListener = (event: MockAgentEvent) => void;
+/**
+ * Mock AI Agent for simulating conversational responses.
+ *
+ * @description Simulates an AI agent that responds to user messages using configurable
+ * strategies. Maintains conversation history and supports custom response handlers.
+ *
+ * @example
+ * ```typescript
+ * const agent = new MockAgent("agent_1", "AI Assistant", {
+ *   responseStrategy: "sequential",
+ *   cannedResponses: ["Hello!", "How can I help?", "Goodbye!"],
+ * });
+ *
+ * await agent.start("room_123");
+ * const response = await agent.processMessage("Hi there");
+ * console.log(response); // "Hello!"
+ * ```
+ */
+declare class MockAgent {
+    /** Agent ID */
+    readonly id: string;
+    /** Agent name */
+    readonly name: string;
+    /** Room ID this agent is assigned to */
+    roomId?: string;
+    /** Agent configuration */
+    private config;
+    /** Current state */
+    private _state;
+    /** Conversation history */
+    private conversationHistory;
+    /** Response index for sequential strategy */
+    private responseIndex;
+    /** Custom response handler */
+    private customHandler?;
+    /** Event listeners */
+    private eventListeners;
+    /** Random function for deterministic testing */
+    private randomFn;
+    /** Message count for maxMessages limit */
+    private messageCount;
+    /**
+     * Creates a new MockAgent.
+     *
+     * @param id - Agent ID.
+     * @param name - Agent display name.
+     * @param config - Agent configuration.
+     */
+    constructor(id: string, name: string, config?: Partial<MockAgentConfig>);
+    /**
+     * Gets the current agent state.
+     */
+    get state(): MockAgentStatus;
+    /**
+     * Gets whether the agent is running.
+     */
+    get isRunning(): boolean;
+    /**
+     * Gets the conversation history.
+     */
+    get history(): ReadonlyArray<MockAgentMessage>;
+    /**
+     * Gets the agent configuration.
+     */
+    getConfig(): MockAgentConfig;
+    /**
+     * Updates the agent configuration.
+     *
+     * @param config - Partial configuration to merge.
+     */
+    updateConfig(config: Partial<MockAgentConfig>): void;
+    /**
+     * Sets the response strategy.
+     *
+     * @param strategy - Response strategy.
+     */
+    setStrategy(strategy: MockAgentResponseStrategy): void;
+    /**
+     * Sets canned responses.
+     *
+     * @param responses - Array of canned responses.
+     */
+    setCannedResponses(responses: string[]): void;
+    /**
+     * Sets a custom response handler.
+     *
+     * @param handler - Custom handler function.
+     */
+    setCustomHandler(handler: MockAgentResponseHandler): void;
+    /**
+     * Sets the random function for deterministic testing.
+     *
+     * @param fn - Random function.
+     */
+    setRandomFunction(fn: () => number): void;
+    /**
+     * Starts the agent in a room.
+     *
+     * @param roomId - Room ID to join.
+     */
+    start(roomId: string): Promise<void>;
+    /**
+     * Stops the agent.
+     */
+    stop(): Promise<void>;
+    /**
+     * Processes a user message and generates a response.
+     *
+     * @param message - User message.
+     * @returns Agent response (empty string if silent).
+     */
+    processMessage(message: string): Promise<string>;
+    /**
+     * Adds an event listener.
+     *
+     * @param listener - Event listener function.
+     * @returns Unsubscribe function.
+     */
+    addEventListener(listener: MockAgentEventListener): () => void;
+    /**
+     * Clears the conversation history.
+     */
+    clearHistory(): void;
+    /**
+     * Resets the agent to initial state.
+     */
+    reset(): void;
+    /**
+     * Serializes agent state for debugging.
+     */
+    toJSON(): object;
+    private addMessage;
+    private emitEvent;
+    private delay;
+}
+/**
+ * Creates a mock agent with common presets.
+ */
+declare const MockAgentPresets: {
+    /**
+     * Creates an echo agent.
+     */
+    echo(name?: string): MockAgent;
+    /**
+     * Creates a silent agent.
+     */
+    silent(name?: string): MockAgent;
+    /**
+     * Creates an agent with sequential responses.
+     */
+    sequential(name: string, responses: string[]): MockAgent;
+    /**
+     * Creates an AI assistant agent.
+     */
+    aiAssistant(name?: string): MockAgent;
+    /**
+     * Creates a customer support agent.
+     */
+    customerSupport(name?: string): MockAgent;
+};
+
+export { MockAgent, type MockAgentEvent, type MockAgentEventListener, MockAgentPresets, type MockAgentResponseHandler };

package/services/conversation/mock/actor/agent.d.ts

@@ -0,0 +1,202 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+import { MockAgentConfig, MockAgentStatus, MockAgentMessage, MockAgentResponseStrategy } from '../types.js';
+
+/**
+ * @file Mock AI Agent implementation.
+ *
+ * @description Provides a mock AI agent that can simulate responses in conversations.
+ * Supports multiple response strategies and conversation history tracking.
+ */
+
+/**
+ * Custom response handler type.
+ */
+type MockAgentResponseHandler = (agentId: string, userMessage: string, history: MockAgentMessage[]) => string | Promise<string>;
+/**
+ * Agent event types.
+ */
+type MockAgentEvent = {
+    type: "started";
+    agentId: string;
+} | {
+    type: "stopped";
+    agentId: string;
+} | {
+    type: "message_received";
+    agentId: string;
+    message: string;
+} | {
+    type: "response_sent";
+    agentId: string;
+    response: string;
+} | {
+    type: "error";
+    agentId: string;
+    error: Error;
+};
+/**
+ * Agent event listener.
+ */
+type MockAgentEventListener = (event: MockAgentEvent) => void;
+/**
+ * Mock AI Agent for simulating conversational responses.
+ *
+ * @description Simulates an AI agent that responds to user messages using configurable
+ * strategies. Maintains conversation history and supports custom response handlers.
+ *
+ * @example
+ * ```typescript
+ * const agent = new MockAgent("agent_1", "AI Assistant", {
+ *   responseStrategy: "sequential",
+ *   cannedResponses: ["Hello!", "How can I help?", "Goodbye!"],
+ * });
+ *
+ * await agent.start("room_123");
+ * const response = await agent.processMessage("Hi there");
+ * console.log(response); // "Hello!"
+ * ```
+ */
+declare class MockAgent {
+    /** Agent ID */
+    readonly id: string;
+    /** Agent name */
+    readonly name: string;
+    /** Room ID this agent is assigned to */
+    roomId?: string;
+    /** Agent configuration */
+    private config;
+    /** Current state */
+    private _state;
+    /** Conversation history */
+    private conversationHistory;
+    /** Response index for sequential strategy */
+    private responseIndex;
+    /** Custom response handler */
+    private customHandler?;
+    /** Event listeners */
+    private eventListeners;
+    /** Random function for deterministic testing */
+    private randomFn;
+    /** Message count for maxMessages limit */
+    private messageCount;
+    /**
+     * Creates a new MockAgent.
+     *
+     * @param id - Agent ID.
+     * @param name - Agent display name.
+     * @param config - Agent configuration.
+     */
+    constructor(id: string, name: string, config?: Partial<MockAgentConfig>);
+    /**
+     * Gets the current agent state.
+     */
+    get state(): MockAgentStatus;
+    /**
+     * Gets whether the agent is running.
+     */
+    get isRunning(): boolean;
+    /**
+     * Gets the conversation history.
+     */
+    get history(): ReadonlyArray<MockAgentMessage>;
+    /**
+     * Gets the agent configuration.
+     */
+    getConfig(): MockAgentConfig;
+    /**
+     * Updates the agent configuration.
+     *
+     * @param config - Partial configuration to merge.
+     */
+    updateConfig(config: Partial<MockAgentConfig>): void;
+    /**
+     * Sets the response strategy.
+     *
+     * @param strategy - Response strategy.
+     */
+    setStrategy(strategy: MockAgentResponseStrategy): void;
+    /**
+     * Sets canned responses.
+     *
+     * @param responses - Array of canned responses.
+     */
+    setCannedResponses(responses: string[]): void;
+    /**
+     * Sets a custom response handler.
+     *
+     * @param handler - Custom handler function.
+     */
+    setCustomHandler(handler: MockAgentResponseHandler): void;
+    /**
+     * Sets the random function for deterministic testing.
+     *
+     * @param fn - Random function.
+     */
+    setRandomFunction(fn: () => number): void;
+    /**
+     * Starts the agent in a room.
+     *
+     * @param roomId - Room ID to join.
+     */
+    start(roomId: string): Promise<void>;
+    /**
+     * Stops the agent.
+     */
+    stop(): Promise<void>;
+    /**
+     * Processes a user message and generates a response.
+     *
+     * @param message - User message.
+     * @returns Agent response (empty string if silent).
+     */
+    processMessage(message: string): Promise<string>;
+    /**
+     * Adds an event listener.
+     *
+     * @param listener - Event listener function.
+     * @returns Unsubscribe function.
+     */
+    addEventListener(listener: MockAgentEventListener): () => void;
+    /**
+     * Clears the conversation history.
+     */
+    clearHistory(): void;
+    /**
+     * Resets the agent to initial state.
+     */
+    reset(): void;
+    /**
+     * Serializes agent state for debugging.
+     */
+    toJSON(): object;
+    private addMessage;
+    private emitEvent;
+    private delay;
+}
+/**
+ * Creates a mock agent with common presets.
+ */
+declare const MockAgentPresets: {
+    /**
+     * Creates an echo agent.
+     */
+    echo(name?: string): MockAgent;
+    /**
+     * Creates a silent agent.
+     */
+    silent(name?: string): MockAgent;
+    /**
+     * Creates an agent with sequential responses.
+     */
+    sequential(name: string, responses: string[]): MockAgent;
+    /**
+     * Creates an AI assistant agent.
+     */
+    aiAssistant(name?: string): MockAgent;
+    /**
+     * Creates a customer support agent.
+     */
+    customerSupport(name?: string): MockAgent;
+};
+
+export { MockAgent, type MockAgentEvent, type MockAgentEventListener, MockAgentPresets, type MockAgentResponseHandler };

package/services/conversation/mock/actor/agent.js

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+var a=0;function r(s){return a++,`mock_${s}_${a}_${Date.now().toString(36)}`}var g={responseStrategy:"echo",responseDelayMs:100,cannedResponses:[],type:"text",nature:"ai",simulateTyping:!1,typingDelayPerChar:20};function c(s,e,n=[],t=0,p=Math.random){switch(s){case"echo":return{response:`Echo: ${e}`,nextIndex:t};case"canned":return{response:n[0]||"Default response",nextIndex:t};case"sequential":return{response:n[t]||"No more responses",nextIndex:(t+1)%Math.max(1,n.length)};case"random":{if(n.length===0)return{response:"Random response",nextIndex:t};let i=Math.floor(p()*n.length);return{response:n[i],nextIndex:t}}case"silent":return{response:"",nextIndex:t};case"error":throw new Error("Agent error");case"custom":return{response:"",nextIndex:t};default:return{response:"Default agent response",nextIndex:t}}}var o=class{constructor(e,n,t={}){this._state="idle";this.conversationHistory=[];this.responseIndex=0;this.eventListeners=new Set;this.randomFn=Math.random;this.messageCount=0;this.id=e,this.name=n,this.config={...g,...t}}get state(){return this._state}get isRunning(){return this._state==="running"}get history(){return[...this.conversationHistory]}getConfig(){return{...this.config}}updateConfig(e){this.config={...this.config,...e}}setStrategy(e){this.config.responseStrategy=e}setCannedResponses(e){this.config.cannedResponses=e,this.responseIndex=0}setCustomHandler(e){this.customHandler=e,this.config.responseStrategy="custom"}setRandomFunction(e){this.randomFn=e}async start(e){this._state!=="running"&&(this._state="starting",this.roomId=e,this.conversationHistory=[],this.responseIndex=0,this.messageCount=0,await this.delay(50),this._state="running",this.emitEvent({type:"started",agentId:this.id}))}async stop(){this._state==="running"&&(this._state="stopping",await this.delay(50),this._state="stopped",this.roomId=void 0,this.emitEvent({type:"stopped",agentId:this.id}))}async processMessage(e){if(this._state!=="running")throw new Error("Agent is not running");if(this.config.maxMessages&&this.messageCount>=this.config.maxMessages)return await this.stop(),"";this.addMessage(e,"user"),this.emitEvent({type:"message_received",agentId:this.id,message:e});let n;try{if(this.config.responseStrategy==="custom"&&this.customHandler)n=await this.customHandler(this.id,e,this.conversationHistory);else{if(this.config.responseStrategy==="silent")return"";if(this.config.responseStrategy==="error"){let t=new Error("Agent error");throw this.emitEvent({type:"error",agentId:this.id,error:t}),t}else{let t=c(this.config.responseStrategy,e,this.config.cannedResponses,this.responseIndex,this.randomFn);n=t.response,this.responseIndex=t.nextIndex}}}catch(t){throw this._state="error",t}return this.config.simulateTyping&&this.config.typingDelayPerChar&&await this.delay(n.length*this.config.typingDelayPerChar),this.config.responseDelayMs&&await this.delay(this.config.responseDelayMs),this.addMessage(n,"agent"),this.messageCount++,this.emitEvent({type:"response_sent",agentId:this.id,response:n}),n}addEventListener(e){return this.eventListeners.add(e),()=>this.eventListeners.delete(e)}clearHistory(){this.conversationHistory=[],this.responseIndex=0}reset(){this._state="idle",this.roomId=void 0,this.conversationHistory=[],this.responseIndex=0,this.messageCount=0}toJSON(){return{id:this.id,name:this.name,state:this._state,roomId:this.roomId,config:this.config,historyLength:this.conversationHistory.length,messageCount:this.messageCount}}addMessage(e,n){let t={id:r("msg"),content:e,role:n,timestamp:Date.now()};return this.conversationHistory.push(t),t}emitEvent(e){for(let n of this.eventListeners)try{n(e)}catch(t){console.error("Error in agent event listener:",t)}}delay(e){return new Promise(n=>setTimeout(n,e))}},m={echo(s="Echo Agent"){return new o(r("agent"),s,{responseStrategy:"echo"})},silent(s="Silent Agent"){return new o(r("agent"),s,{responseStrategy:"silent"})},sequential(s,e){return new o(r("agent"),s,{responseStrategy:"sequential",cannedResponses:e})},aiAssistant(s="AI Assistant"){return new o(r("agent"),s,{responseStrategy:"sequential",responseDelayMs:150,simulateTyping:!0,typingDelayPerChar:10,cannedResponses:["Hello! How can I help you today?","I understand. Let me help you with that.","Is there anything else I can assist you with?","Thank you for your question. Here's what I found...","I'm happy to help! What would you like to know?"]})},customerSupport(s="Support Agent"){return new o(r("agent"),s,{responseStrategy:"sequential",responseDelayMs:200,cannedResponses:["Thank you for contacting support. How may I assist you?","I apologize for any inconvenience. Let me look into that for you.","I've found a solution. Here's what you need to do...","Is there anything else I can help you with today?","Thank you for contacting us. Have a great day!"]})}};export{o as MockAgent,m as MockAgentPresets};

package/services/conversation/mock/actor/index.cjs

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+"use strict";var c=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var l=(s,e)=>{for(var n in e)c(s,n,{get:e[n],enumerable:!0})},f=(s,e,n,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of y(e))!m.call(s,o)&&o!==n&&c(s,o,{get:()=>e[o],enumerable:!(t=u(e,o))||t.enumerable});return s};var M=s=>f(c({},"__esModule",{value:!0}),s);var k={};l(k,{DEFAULT_AGENT_CONFIG:()=>a,MockAgent:()=>r,MockAgentPresets:()=>h,generateStrategyResponse:()=>g});module.exports=M(k);var d=0;function i(s){return d++,`mock_${s}_${d}_${Date.now().toString(36)}`}var a={responseStrategy:"echo",responseDelayMs:100,cannedResponses:[],type:"text",nature:"ai",simulateTyping:!1,typingDelayPerChar:20};function g(s,e,n=[],t=0,o=Math.random){switch(s){case"echo":return{response:`Echo: ${e}`,nextIndex:t};case"canned":return{response:n[0]||"Default response",nextIndex:t};case"sequential":return{response:n[t]||"No more responses",nextIndex:(t+1)%Math.max(1,n.length)};case"random":{if(n.length===0)return{response:"Random response",nextIndex:t};let p=Math.floor(o()*n.length);return{response:n[p],nextIndex:t}}case"silent":return{response:"",nextIndex:t};case"error":throw new Error("Agent error");case"custom":return{response:"",nextIndex:t};default:return{response:"Default agent response",nextIndex:t}}}var r=class{constructor(e,n,t={}){this._state="idle";this.conversationHistory=[];this.responseIndex=0;this.eventListeners=new Set;this.randomFn=Math.random;this.messageCount=0;this.id=e,this.name=n,this.config={...a,...t}}get state(){return this._state}get isRunning(){return this._state==="running"}get history(){return[...this.conversationHistory]}getConfig(){return{...this.config}}updateConfig(e){this.config={...this.config,...e}}setStrategy(e){this.config.responseStrategy=e}setCannedResponses(e){this.config.cannedResponses=e,this.responseIndex=0}setCustomHandler(e){this.customHandler=e,this.config.responseStrategy="custom"}setRandomFunction(e){this.randomFn=e}async start(e){this._state!=="running"&&(this._state="starting",this.roomId=e,this.conversationHistory=[],this.responseIndex=0,this.messageCount=0,await this.delay(50),this._state="running",this.emitEvent({type:"started",agentId:this.id}))}async stop(){this._state==="running"&&(this._state="stopping",await this.delay(50),this._state="stopped",this.roomId=void 0,this.emitEvent({type:"stopped",agentId:this.id}))}async processMessage(e){if(this._state!=="running")throw new Error("Agent is not running");if(this.config.maxMessages&&this.messageCount>=this.config.maxMessages)return await this.stop(),"";this.addMessage(e,"user"),this.emitEvent({type:"message_received",agentId:this.id,message:e});let n;try{if(this.config.responseStrategy==="custom"&&this.customHandler)n=await this.customHandler(this.id,e,this.conversationHistory);else{if(this.config.responseStrategy==="silent")return"";if(this.config.responseStrategy==="error"){let t=new Error("Agent error");throw this.emitEvent({type:"error",agentId:this.id,error:t}),t}else{let t=g(this.config.responseStrategy,e,this.config.cannedResponses,this.responseIndex,this.randomFn);n=t.response,this.responseIndex=t.nextIndex}}}catch(t){throw this._state="error",t}return this.config.simulateTyping&&this.config.typingDelayPerChar&&await this.delay(n.length*this.config.typingDelayPerChar),this.config.responseDelayMs&&await this.delay(this.config.responseDelayMs),this.addMessage(n,"agent"),this.messageCount++,this.emitEvent({type:"response_sent",agentId:this.id,response:n}),n}addEventListener(e){return this.eventListeners.add(e),()=>this.eventListeners.delete(e)}clearHistory(){this.conversationHistory=[],this.responseIndex=0}reset(){this._state="idle",this.roomId=void 0,this.conversationHistory=[],this.responseIndex=0,this.messageCount=0}toJSON(){return{id:this.id,name:this.name,state:this._state,roomId:this.roomId,config:this.config,historyLength:this.conversationHistory.length,messageCount:this.messageCount}}addMessage(e,n){let t={id:i("msg"),content:e,role:n,timestamp:Date.now()};return this.conversationHistory.push(t),t}emitEvent(e){for(let n of this.eventListeners)try{n(e)}catch(t){console.error("Error in agent event listener:",t)}}delay(e){return new Promise(n=>setTimeout(n,e))}},h={echo(s="Echo Agent"){return new r(i("agent"),s,{responseStrategy:"echo"})},silent(s="Silent Agent"){return new r(i("agent"),s,{responseStrategy:"silent"})},sequential(s,e){return new r(i("agent"),s,{responseStrategy:"sequential",cannedResponses:e})},aiAssistant(s="AI Assistant"){return new r(i("agent"),s,{responseStrategy:"sequential",responseDelayMs:150,simulateTyping:!0,typingDelayPerChar:10,cannedResponses:["Hello! How can I help you today?","I understand. Let me help you with that.","Is there anything else I can assist you with?","Thank you for your question. Here's what I found...","I'm happy to help! What would you like to know?"]})},customerSupport(s="Support Agent"){return new r(i("agent"),s,{responseStrategy:"sequential",responseDelayMs:200,cannedResponses:["Thank you for contacting support. How may I assist you?","I apologize for any inconvenience. Let me look into that for you.","I've found a solution. Here's what you need to do...","Is there anything else I can help you with today?","Thank you for contacting us. Have a great day!"]})}};0&&(module.exports={DEFAULT_AGENT_CONFIG,MockAgent,MockAgentPresets,generateStrategyResponse});

package/services/conversation/mock/actor/index.d.cts

@@ -0,0 +1,4 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+export { MockAgent, MockAgentEvent, MockAgentEventListener, MockAgentPresets, MockAgentResponseHandler } from './agent.cjs';
+export { DEFAULT_AGENT_CONFIG, generateStrategyResponse } from './strategies.cjs';
+export { MockAgentConfig, MockAgentMessage, MockAgentResponseStrategy } from '../types.cjs';

package/services/conversation/mock/actor/index.d.ts

@@ -0,0 +1,4 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+export { MockAgent, MockAgentEvent, MockAgentEventListener, MockAgentPresets, MockAgentResponseHandler } from './agent.js';
+export { DEFAULT_AGENT_CONFIG, generateStrategyResponse } from './strategies.js';
+export { MockAgentConfig, MockAgentMessage, MockAgentResponseStrategy } from '../types.js';

package/services/conversation/mock/actor/index.js

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+var c=0;function o(s){return c++,`mock_${s}_${c}_${Date.now().toString(36)}`}var i={responseStrategy:"echo",responseDelayMs:100,cannedResponses:[],type:"text",nature:"ai",simulateTyping:!1,typingDelayPerChar:20};function a(s,e,n=[],t=0,p=Math.random){switch(s){case"echo":return{response:`Echo: ${e}`,nextIndex:t};case"canned":return{response:n[0]||"Default response",nextIndex:t};case"sequential":return{response:n[t]||"No more responses",nextIndex:(t+1)%Math.max(1,n.length)};case"random":{if(n.length===0)return{response:"Random response",nextIndex:t};let g=Math.floor(p()*n.length);return{response:n[g],nextIndex:t}}case"silent":return{response:"",nextIndex:t};case"error":throw new Error("Agent error");case"custom":return{response:"",nextIndex:t};default:return{response:"Default agent response",nextIndex:t}}}var r=class{constructor(e,n,t={}){this._state="idle";this.conversationHistory=[];this.responseIndex=0;this.eventListeners=new Set;this.randomFn=Math.random;this.messageCount=0;this.id=e,this.name=n,this.config={...i,...t}}get state(){return this._state}get isRunning(){return this._state==="running"}get history(){return[...this.conversationHistory]}getConfig(){return{...this.config}}updateConfig(e){this.config={...this.config,...e}}setStrategy(e){this.config.responseStrategy=e}setCannedResponses(e){this.config.cannedResponses=e,this.responseIndex=0}setCustomHandler(e){this.customHandler=e,this.config.responseStrategy="custom"}setRandomFunction(e){this.randomFn=e}async start(e){this._state!=="running"&&(this._state="starting",this.roomId=e,this.conversationHistory=[],this.responseIndex=0,this.messageCount=0,await this.delay(50),this._state="running",this.emitEvent({type:"started",agentId:this.id}))}async stop(){this._state==="running"&&(this._state="stopping",await this.delay(50),this._state="stopped",this.roomId=void 0,this.emitEvent({type:"stopped",agentId:this.id}))}async processMessage(e){if(this._state!=="running")throw new Error("Agent is not running");if(this.config.maxMessages&&this.messageCount>=this.config.maxMessages)return await this.stop(),"";this.addMessage(e,"user"),this.emitEvent({type:"message_received",agentId:this.id,message:e});let n;try{if(this.config.responseStrategy==="custom"&&this.customHandler)n=await this.customHandler(this.id,e,this.conversationHistory);else{if(this.config.responseStrategy==="silent")return"";if(this.config.responseStrategy==="error"){let t=new Error("Agent error");throw this.emitEvent({type:"error",agentId:this.id,error:t}),t}else{let t=a(this.config.responseStrategy,e,this.config.cannedResponses,this.responseIndex,this.randomFn);n=t.response,this.responseIndex=t.nextIndex}}}catch(t){throw this._state="error",t}return this.config.simulateTyping&&this.config.typingDelayPerChar&&await this.delay(n.length*this.config.typingDelayPerChar),this.config.responseDelayMs&&await this.delay(this.config.responseDelayMs),this.addMessage(n,"agent"),this.messageCount++,this.emitEvent({type:"response_sent",agentId:this.id,response:n}),n}addEventListener(e){return this.eventListeners.add(e),()=>this.eventListeners.delete(e)}clearHistory(){this.conversationHistory=[],this.responseIndex=0}reset(){this._state="idle",this.roomId=void 0,this.conversationHistory=[],this.responseIndex=0,this.messageCount=0}toJSON(){return{id:this.id,name:this.name,state:this._state,roomId:this.roomId,config:this.config,historyLength:this.conversationHistory.length,messageCount:this.messageCount}}addMessage(e,n){let t={id:o("msg"),content:e,role:n,timestamp:Date.now()};return this.conversationHistory.push(t),t}emitEvent(e){for(let n of this.eventListeners)try{n(e)}catch(t){console.error("Error in agent event listener:",t)}}delay(e){return new Promise(n=>setTimeout(n,e))}},d={echo(s="Echo Agent"){return new r(o("agent"),s,{responseStrategy:"echo"})},silent(s="Silent Agent"){return new r(o("agent"),s,{responseStrategy:"silent"})},sequential(s,e){return new r(o("agent"),s,{responseStrategy:"sequential",cannedResponses:e})},aiAssistant(s="AI Assistant"){return new r(o("agent"),s,{responseStrategy:"sequential",responseDelayMs:150,simulateTyping:!0,typingDelayPerChar:10,cannedResponses:["Hello! How can I help you today?","I understand. Let me help you with that.","Is there anything else I can assist you with?","Thank you for your question. Here's what I found...","I'm happy to help! What would you like to know?"]})},customerSupport(s="Support Agent"){return new r(o("agent"),s,{responseStrategy:"sequential",responseDelayMs:200,cannedResponses:["Thank you for contacting support. How may I assist you?","I apologize for any inconvenience. Let me look into that for you.","I've found a solution. Here's what you need to do...","Is there anything else I can help you with today?","Thank you for contacting us. Have a great day!"]})}};export{i as DEFAULT_AGENT_CONFIG,r as MockAgent,d as MockAgentPresets,a as generateStrategyResponse};

package/services/conversation/mock/actor/strategies.cjs

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+"use strict";var s=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var u=(n,t)=>{for(var r in t)s(n,r,{get:t[r],enumerable:!0})},i=(n,t,r,e)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of c(t))!p.call(n,o)&&o!==r&&s(n,o,{get:()=>t[o],enumerable:!(e=g(t,o))||e.enumerable});return n};var x=n=>i(s({},"__esModule",{value:!0}),n);var m={};u(m,{DEFAULT_AGENT_CONFIG:()=>y,generateStrategyResponse:()=>l});module.exports=x(m);var y={responseStrategy:"echo",responseDelayMs:100,cannedResponses:[],type:"text",nature:"ai",simulateTyping:!1,typingDelayPerChar:20};function l(n,t,r=[],e=0,o=Math.random){switch(n){case"echo":return{response:`Echo: ${t}`,nextIndex:e};case"canned":return{response:r[0]||"Default response",nextIndex:e};case"sequential":return{response:r[e]||"No more responses",nextIndex:(e+1)%Math.max(1,r.length)};case"random":{if(r.length===0)return{response:"Random response",nextIndex:e};let a=Math.floor(o()*r.length);return{response:r[a],nextIndex:e}}case"silent":return{response:"",nextIndex:e};case"error":throw new Error("Agent error");case"custom":return{response:"",nextIndex:e};default:return{response:"Default agent response",nextIndex:e}}}0&&(module.exports={DEFAULT_AGENT_CONFIG,generateStrategyResponse});

package/services/conversation/mock/actor/strategies.d.cts

@@ -0,0 +1,31 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+import { MockAgentConfig, MockAgentResponseStrategy } from '../types.cjs';
+export { MockAgentMessage } from '../types.cjs';
+
+/**
+ * @file Mock Agent response strategies.
+ *
+ * @description Defines response strategies for mock AI agents.
+ * These strategies determine how agents respond to user messages.
+ */
+
+/**
+ * Default agent configuration.
+ */
+declare const DEFAULT_AGENT_CONFIG: MockAgentConfig;
+/**
+ * Generates a response based on strategy.
+ *
+ * @param strategy - Response strategy.
+ * @param userMessage - User's message.
+ * @param cannedResponses - Available canned responses.
+ * @param responseIndex - Current index for sequential strategy.
+ * @param randomFn - Random function for deterministic testing.
+ * @returns Generated response and next index.
+ */
+declare function generateStrategyResponse(strategy: MockAgentResponseStrategy, userMessage: string, cannedResponses?: string[], responseIndex?: number, randomFn?: () => number): {
+    response: string;
+    nextIndex: number;
+};
+
+export { DEFAULT_AGENT_CONFIG, MockAgentConfig, MockAgentResponseStrategy, generateStrategyResponse };

package/services/conversation/mock/actor/strategies.d.ts

@@ -0,0 +1,31 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+import { MockAgentConfig, MockAgentResponseStrategy } from '../types.js';
+export { MockAgentMessage } from '../types.js';
+
+/**
+ * @file Mock Agent response strategies.
+ *
+ * @description Defines response strategies for mock AI agents.
+ * These strategies determine how agents respond to user messages.
+ */
+
+/**
+ * Default agent configuration.
+ */
+declare const DEFAULT_AGENT_CONFIG: MockAgentConfig;
+/**
+ * Generates a response based on strategy.
+ *
+ * @param strategy - Response strategy.
+ * @param userMessage - User's message.
+ * @param cannedResponses - Available canned responses.
+ * @param responseIndex - Current index for sequential strategy.
+ * @param randomFn - Random function for deterministic testing.
+ * @returns Generated response and next index.
+ */
+declare function generateStrategyResponse(strategy: MockAgentResponseStrategy, userMessage: string, cannedResponses?: string[], responseIndex?: number, randomFn?: () => number): {
+    response: string;
+    nextIndex: number;
+};
+
+export { DEFAULT_AGENT_CONFIG, MockAgentConfig, MockAgentResponseStrategy, generateStrategyResponse };

package/services/conversation/mock/actor/strategies.js

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+var a={responseStrategy:"echo",responseDelayMs:100,cannedResponses:[],type:"text",nature:"ai",simulateTyping:!1,typingDelayPerChar:20};function g(n,o,t=[],e=0,s=Math.random){switch(n){case"echo":return{response:`Echo: ${o}`,nextIndex:e};case"canned":return{response:t[0]||"Default response",nextIndex:e};case"sequential":return{response:t[e]||"No more responses",nextIndex:(e+1)%Math.max(1,t.length)};case"random":{if(t.length===0)return{response:"Random response",nextIndex:e};let r=Math.floor(s()*t.length);return{response:t[r],nextIndex:e}}case"silent":return{response:"",nextIndex:e};case"error":throw new Error("Agent error");case"custom":return{response:"",nextIndex:e};default:return{response:"Default agent response",nextIndex:e}}}export{a as DEFAULT_AGENT_CONFIG,g as generateStrategyResponse};

package/services/conversation/mock/errors.cjs

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+"use strict";var T=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var R=(s,t)=>{for(var e in t)T(s,e,{get:t[e],enumerable:!0})},w=(s,t,e,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of m(t))!l.call(s,r)&&r!==e&&T(s,r,{get:()=>t[r],enumerable:!(o=g(t,r))||o.enumerable});return s};var M=s=>w(T({},"__esModule",{value:!0}),s);var h={};R(h,{AgentNotFoundError:()=>E,InvalidOperationError:()=>k,MockLiveKitError:()=>n,NetworkError:()=>p,ParticipantAlreadyJoinedError:()=>i,ParticipantNotFoundError:()=>u,RoomEndedError:()=>a,RoomNotFoundError:()=>c,TimeoutError:()=>N,TrackNotFoundError:()=>d,UnauthorizedError:()=>O,createErrorFromMockError:()=>x,isMockError:()=>_,isMockLiveKitError:()=>A});module.exports=M(h);var n=class s extends Error{constructor(t,e,o){super(e),this.name="MockLiveKitError",this.code=t,this.details=o,typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,s)}toMockError(){return{code:this.code,message:this.message,details:this.details}}static fromMockError(t){return new s(t.code,t.message,t.details)}},c=class extends n{constructor(t){super("ROOM_NOT_FOUND",`Room not found: ${t}`,{roomId:t}),this.name="RoomNotFoundError"}},a=class extends n{constructor(t){super("ROOM_ENDED",`Room has ended: ${t}`,{roomId:t}),this.name="RoomEndedError"}},i=class extends n{constructor(t,e){super("PARTICIPANT_ALREADY_JOINED",`Participant ${t} is already in room ${e}`,{identity:t,roomId:e}),this.name="ParticipantAlreadyJoinedError"}},u=class extends n{constructor(t){super("PARTICIPANT_NOT_FOUND",`Participant not found: ${t}`,{identity:t}),this.name="ParticipantNotFoundError"}},d=class extends n{constructor(t){super("TRACK_NOT_FOUND",`Track not found: ${t}`,{trackId:t}),this.name="TrackNotFoundError"}},E=class extends n{constructor(t){super("AGENT_NOT_FOUND",`Agent not found: ${t}`,{agentId:t}),this.name="AgentNotFoundError"}},O=class extends n{constructor(t="Unauthorized"){super("UNAUTHORIZED",t),this.name="UnauthorizedError"}},p=class extends n{constructor(t="Network error occurred"){super("NETWORK_ERROR",t),this.name="NetworkError"}},k=class extends n{constructor(t,e){super("INVALID_OPERATION",t,e),this.name="InvalidOperationError"}},N=class extends n{constructor(t,e){super("TIMEOUT",`Operation timed out: ${t}`,{operation:t,timeoutMs:e}),this.name="TimeoutError"}};function x(s){switch(s.code){case"ROOM_NOT_FOUND":return new c(s.details?.roomId??"unknown");case"ROOM_ENDED":return new a(s.details?.roomId??"unknown");case"PARTICIPANT_ALREADY_JOINED":return new i(s.details?.identity??"unknown",s.details?.roomId??"unknown");case"PARTICIPANT_NOT_FOUND":return new u(s.details?.identity??"unknown");case"TRACK_NOT_FOUND":return new d(s.details?.trackId??"unknown");case"AGENT_NOT_FOUND":return new E(s.details?.agentId??"unknown");case"UNAUTHORIZED":return new O(s.message);case"NETWORK_ERROR":return new p(s.message);case"INVALID_OPERATION":return new k(s.message,s.details);case"TIMEOUT":return new N(s.details?.operation??"unknown",s.details?.timeoutMs??0);default:return n.fromMockError(s)}}function _(s){return typeof s=="object"&&s!==null&&"code"in s&&"message"in s&&typeof s.code=="string"&&typeof s.message=="string"}function A(s){return s instanceof n}0&&(module.exports={AgentNotFoundError,InvalidOperationError,MockLiveKitError,NetworkError,ParticipantAlreadyJoinedError,ParticipantNotFoundError,RoomEndedError,RoomNotFoundError,TimeoutError,TrackNotFoundError,UnauthorizedError,createErrorFromMockError,isMockError,isMockLiveKitError});

package/services/conversation/mock/errors.d.cts

@@ -0,0 +1,125 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+import { MockErrorCode, MockError } from './types.cjs';
+
+/**
+ * @summary Custom error classes for the mock LiveKit service.
+ *
+ * @description Provides typed error classes that match LiveKit error patterns
+ * for consistent error handling in tests.
+ */
+
+/**
+ * @summary Base error class for mock LiveKit errors.
+ *
+ * @description Extends the standard Error class with mock-specific properties.
+ */
+declare class MockLiveKitError extends Error {
+    /** Error code for programmatic handling */
+    readonly code: MockErrorCode;
+    /** Additional error details */
+    readonly details?: Record<string, unknown>;
+    /**
+     * Creates a new MockLiveKitError.
+     *
+     * @param {MockErrorCode} code - Error code.
+     * @param {string} message - Error message.
+     * @param {Record<string, unknown>} [details] - Additional details.
+     */
+    constructor(code: MockErrorCode, message: string, details?: Record<string, unknown>);
+    /**
+     * Converts the error to a MockError object.
+     *
+     * @returns {MockError} Plain error object.
+     */
+    toMockError(): MockError;
+    /**
+     * Creates a MockLiveKitError from a MockError object.
+     *
+     * @param {MockError} error - Error object.
+     * @returns {MockLiveKitError} Error instance.
+     */
+    static fromMockError(error: MockError): MockLiveKitError;
+}
+/**
+ * Room not found error.
+ */
+declare class RoomNotFoundError extends MockLiveKitError {
+    constructor(roomId: string);
+}
+/**
+ * Room ended error.
+ */
+declare class RoomEndedError extends MockLiveKitError {
+    constructor(roomId: string);
+}
+/**
+ * Participant already joined error.
+ */
+declare class ParticipantAlreadyJoinedError extends MockLiveKitError {
+    constructor(identity: string, roomId: string);
+}
+/**
+ * Participant not found error.
+ */
+declare class ParticipantNotFoundError extends MockLiveKitError {
+    constructor(identity: string);
+}
+/**
+ * Track not found error.
+ */
+declare class TrackNotFoundError extends MockLiveKitError {
+    constructor(trackId: string);
+}
+/**
+ * Agent not found error.
+ */
+declare class AgentNotFoundError extends MockLiveKitError {
+    constructor(agentId: string);
+}
+/**
+ * Unauthorized error.
+ */
+declare class UnauthorizedError extends MockLiveKitError {
+    constructor(message?: string);
+}
+/**
+ * Network error.
+ */
+declare class NetworkError extends MockLiveKitError {
+    constructor(message?: string);
+}
+/**
+ * Invalid operation error.
+ */
+declare class InvalidOperationError extends MockLiveKitError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Timeout error.
+ */
+declare class TimeoutError extends MockLiveKitError {
+    constructor(operation: string, timeoutMs: number);
+}
+/**
+ * Creates an appropriate error instance from a MockError object.
+ *
+ * @param {MockError} error - Error object.
+ * @returns {MockLiveKitError} Typed error instance.
+ */
+declare function createErrorFromMockError(error: MockError): MockLiveKitError;
+/**
+ * Type guard to check if a value is a MockError.
+ *
+ * @param {unknown} value - Value to check.
+ * @returns {boolean} True if value is a MockError.
+ */
+declare function isMockError(value: unknown): value is MockError;
+/**
+ * Type guard to check if a value is a MockLiveKitError.
+ *
+ * @param {unknown} value - Value to check.
+ * @returns {boolean} True if value is a MockLiveKitError.
+ */
+declare function isMockLiveKitError(value: unknown): value is MockLiveKitError;
+
+export { AgentNotFoundError, InvalidOperationError, MockLiveKitError, NetworkError, ParticipantAlreadyJoinedError, ParticipantNotFoundError, RoomEndedError, RoomNotFoundError, TimeoutError, TrackNotFoundError, UnauthorizedError, createErrorFromMockError, isMockError, isMockLiveKitError };