@applica-software-guru/persona-sdk 0.1.63 → 0.1.65

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,kBAAkB,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACnH,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,kBAAkB,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,mBAAmB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,gBAAgB,GAAG,qBAAqB,GAAG,iBAAiB,CAAC;IACtE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,cAAc,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAE3G,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,aAAa,CAAC;IACrF,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACvD,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IACxC,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;IACxC,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAEhD,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;AACvE,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC;AAEzE,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IAEnB,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC,aAAa,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAEzD,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,UAAU,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,uBAAuB,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAClE,iBAAiB,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAChE;AAED,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAC3C,yBAAyB,GAAG;IAC1B;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,SAAS,EACL,eAAe,EAAE,GACjB;QACE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;QAC3C,MAAM,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;QAC7C,SAAS,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;KACjD,CAAC;IAEN;;OAEG;IACH,KAAK,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;CACvC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@applica-software-guru/persona-sdk",
   "private": false,
-  "version": "0.1.63",
+  "version": "0.1.65",
   "type": "module",
   "scripts": {
     "dev": "vite",

package/playground/src/chat.tsx

@@ -3,6 +3,8 @@ import { PersonaRuntimeProvider, PersonaConsoleLogger, Session, usePersonaRuntim
 import { useMemo } from 'react';
 import _ from 'lodash';
 import { TooltipProvider } from './components/ui/tooltip';
+import { tools } from '@/tools';
+
 const logger = new PersonaConsoleLogger();
 
 function generateSID() {
@@ -58,7 +60,8 @@ function MessageLogger() {
 }
 
 function Chat() {
-  const agent = getQueryParam('agentId');
+  const agentId = getQueryParam('agentId');
+  const apiKey = getQueryParam('apiKey');
   const sid = getQueryParam('sid');
 
   const session = useMemo((): Session => {
@@ -74,26 +77,19 @@ function Chat() {
       logger={logger}
       context={{
         data: {
-          username: 'Bruno Trimone Agent',
-          userAgent: navigator.userAgent,
-        },
-      }}
-      tools={{
-        get_user_agent: () => {
-          const userAgent = 'Bruno Trimone Agent';
-          return { userAgent };
-        },
-        get_client_date: () => {
-          const date = new Date();
-          return { date: date.toISOString() };
+          username: 'Roberto',
+          userAgent: 'Google Tridroid 14',
         },
       }}
+      tools={tools}
       protocols={{
-        rest: true,
+        rest: false,
+        websocket: true,
+        webrtc: true,
       }}
       session={session}
-      apiKey="2398utf8g$9pahwv8#93q8.h8349q*!ty89w4uefghwqh849tg934yg894hq3g89q34h9"
-      agentId={(agent as string) || 'default'}
+      apiKey={apiKey!}
+      agentId={agentId!}
     >
       <div className="h-dvh w-full">
         <TooltipProvider>

package/playground/src/tools.ts

@@ -0,0 +1,127 @@
+/**
+ * Example Tool Library
+ *
+ * This file demonstrates how to define and export a library of example tools
+ * using the Persona SDK's createTool utility. These tools can be imported
+ * and used in PersonaRuntimeProvider or other parts of the application to
+ * showcase or test tool integration.
+ */
+
+import { createTool, PersonaTools } from '@applica-software-guru/persona-sdk';
+
+const toolLibrary = [
+  createTool({
+    name: 'sum',
+    title: 'Sum two numbers',
+    description: 'Sums two numbers and returns the result.',
+    parameters: {
+      a: { type: 'number', description: 'First number to sum', required: true },
+      b: { type: 'number', description: 'Second number to sum', required: true },
+    },
+    output: {
+      result: { type: 'number', description: 'Sum of the two numbers' },
+    },
+    implementation: async (a: number, b: number) => {
+      const result = a + b;
+      return { result };
+    },
+  }),
+  createTool({
+    name: 'concat',
+    title: 'Concatenate two strings',
+    description: 'Concatenates two strings and returns the result.',
+    parameters: {
+      str1: { type: 'string', description: 'First string to concatenate', required: true },
+      str2: { type: 'string', description: 'Second string to concatenate', required: true },
+    },
+    output: {
+      result: { type: 'string', description: 'Concatenated result of the two strings' },
+    },
+    implementation: async (str1: string, str2: string) => {
+      const result = str1 + str2;
+      return { result };
+    },
+  }),
+  // User agent tool:
+  createTool({
+    name: 'userAgent',
+    title: 'Get User Agent',
+    description: 'Retrieves the user agent string from the client.',
+    parameters: {},
+    output: {
+      result: { type: 'string', description: 'User agent string' },
+    },
+    implementation: async () => {
+      return { result: navigator.userAgent };
+    },
+  }),
+  // Navigate to URL tool:
+  createTool({
+    name: 'navigateTo',
+    title: 'Navigate to URL',
+    description: 'Navigates the browser to a specified URL.',
+    parameters: {
+      url: { type: 'string', description: 'The URL to navigate to', required: true },
+    },
+    output: {
+      success: { type: 'boolean', description: 'Indicates if navigation was successful' },
+    },
+    implementation: async (url: string) => {
+      window.location.href = url;
+      return { success: true };
+    },
+  }),
+  // Get current URL tool:
+  createTool({
+    name: 'getCurrentUrl',
+    title: 'Get Current URL',
+    description: 'Retrieves the current browser URL.',
+    parameters: {},
+    output: {
+      url: { type: 'string', description: 'Current browser URL' },
+    },
+    implementation: async () => {
+      return { url: window.location.href };
+    },
+  }),
+
+  // Current client date and time tool:
+  createTool({
+    name: 'getCurrentDateTime',
+    title: 'Get Current Date and Time',
+    description: 'Retrieves the current date and time from the client.',
+    parameters: {},
+    output: {
+      dateTime: { type: 'string', description: 'Current date and time in ISO format' },
+    },
+    implementation: async () => {
+      return { dateTime: new Date().toISOString() };
+    },
+  }),
+];
+
+const tools: PersonaTools = {
+  sum: function (a: number, b: number) {
+    const result = a + b;
+    return { result };
+  },
+  concat: function (str1: string, str2: string) {
+    const result = str1 + str2;
+    return { result };
+  },
+  navigateTo: function (url: string) {
+    window.location.href = url;
+    return { success: true };
+  },
+  getUserAgent: function () {
+    return { result: navigator.userAgent };
+  },
+  getCurrentUrl: function () {
+    return { url: window.location.href };
+  },
+  getCurrentDateTime: function () {
+    return { dateTime: new Date().toISOString() };
+  },
+};
+
+export { toolLibrary, tools };

package/src/index.ts

@@ -2,3 +2,4 @@ export * from './runtime';
 export * from './logging';
 export * from './protocol';
 export * from './types';
+export * from './tools';

package/src/protocol/rest.ts

@@ -8,6 +8,7 @@ import {
   PersonaPacket,
   PersonaCommand,
 } from '../types';
+import { ToolInstance } from '../tools';
 
 type PersonaRESTProtocolConfig = PersonaProtocolBaseConfig & {
   apiUrl: string;
@@ -20,6 +21,7 @@ class PersonaRESTProtocol extends PersonaProtocolBase {
   config: PersonaRESTProtocolConfig;
   notify: boolean = true;
   context: Record<string, any> = {};
+  tools: ToolInstance[] = [];
 
   constructor(config: PersonaRESTProtocolConfig) {
     super();
@@ -56,23 +58,45 @@ class PersonaRESTProtocol extends PersonaProtocolBase {
     if (packet.type === 'command' && (packet?.payload as PersonaCommand)?.command == 'set_initial_context') {
       this.context = (packet?.payload as PersonaCommand)?.arguments;
       return;
+    } else if (packet.type === 'command' && (packet?.payload as PersonaCommand)?.command == 'set_local_tools') {
+      this.notifyPacket({
+        type: 'message',
+        payload: {
+          type: 'text',
+          role: 'assistant',
+          text: 'Local tools with rest protocol are not supported.',
+        },
+      });
+      return;
     }
     const input = packet.payload as PersonaMessage;
-    const response = await fetch(`${apiUrl}/sessions/${sessionId}/messages`, {
-      body: JSON.stringify({ agentId, userMessage: input, initial_context: this.context }),
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'x-persona-apikey': apiKey,
-      },
-    });
-    const personaResponse = (await response.json()) as PersonaResponse;
-    this.notifyPackets(
-      personaResponse.response.messages.map((payload) => ({
+    try {
+      const response = await fetch(`${apiUrl}/sessions/${sessionId}/messages`, {
+        body: JSON.stringify({ agentId, userMessage: input, initialContext: this.context, tools: this.tools }),
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-persona-apikey': apiKey,
+        },
+      });
+      const personaResponse = (await response.json()) as PersonaResponse;
+      this.notifyPackets(
+        personaResponse.response.messages.map((payload) => ({
+          type: 'message',
+          payload,
+        })),
+      );
+    } catch (error) {
+      this.notifyPacket({
         type: 'message',
-        payload,
-      })),
-    );
+        payload: {
+          role: 'assistant',
+          type: 'text',
+          text: 'An error occurred while processing your request. Please try again later.',
+        },
+      });
+      this.config.logger?.error('Error sending packet:', error);
+    }
   }
 }
 

package/src/protocol/transaction.ts

@@ -1,13 +1,6 @@
 import { PersonaProtocolBase } from './base';
-import {
-  Session,
-  ProtocolStatus,
-  PersonaProtocolBaseConfig,
-  PersonaTransaction,
-  FunctionCall,
-  ReadonlyJSONObject,
-  PersonaPacket,
-} from '../types';
+import { Session, ProtocolStatus, PersonaProtocolBaseConfig, PersonaTransaction, FunctionCall, PersonaPacket } from '../types';
+import { ToolInstance } from '../tools';
 
 type FinishTransactionRequest = {
   success: boolean;
@@ -45,7 +38,7 @@ class PersonaTransactionsManager {
   }
 }
 
-export type PersonaToolCallback = (args: ReadonlyJSONObject | undefined) => void;
+export type PersonaToolCallback = (...args: any[]) => void | Record<string, any> | Promise<void | Record<string, any>>;
 export type PersonaTools = {
   [key: string]: PersonaToolCallback;
 };
@@ -77,7 +70,7 @@ class PersonaPersistableTransaction {
       return;
     }
     try {
-      const result = await tool(functionArgs);
+      const result = await tool.apply(null, Object.values(functionArgs));
       await this.complete(result);
     } catch (error) {
       await this.fail(`Error executing tool ${functionName}: ${error}`);
@@ -95,7 +88,8 @@ type PersonaTransactionCallback = (transaction: PersonaPersistableTransaction) =
 
 type PersonaTransactionProtocolConfig = PersonaProtocolBaseConfig & {
   apiUrl: string;
-  onTransaction: PersonaTransactionCallback;
+  tools: PersonaTools | ToolInstance[];
+  onTransaction?: PersonaTransactionCallback;
 };
 
 class PersonaTransactionProtocol extends PersonaProtocolBase {
@@ -104,12 +98,23 @@ class PersonaTransactionProtocol extends PersonaProtocolBase {
   session: Session;
   config: PersonaTransactionProtocolConfig;
   notify: boolean = true;
+  private _tools: PersonaTools;
 
   constructor(config: PersonaTransactionProtocolConfig) {
     super();
     this.config = config;
     this.status = 'disconnected';
     this.autostart = true;
+    if (Array.isArray(config.tools)) {
+      this._tools = {};
+      for (const tool of config.tools as ToolInstance[]) {
+        if (tool.schema && tool.implementation) {
+          this._tools[tool.schema.name] = tool.implementation;
+        }
+      }
+    } else {
+      this._tools = config.tools as PersonaTools;
+    }
   }
 
   public getName(): string {
@@ -137,13 +142,18 @@ class PersonaTransactionProtocol extends PersonaProtocolBase {
   public async sendPacket(_: PersonaPacket): Promise<void> {}
 
   public onTransaction(transaction: PersonaTransaction): void {
-    if (!this.config.onTransaction) {
-      this.config.logger?.error('Transaction protocol config is not set');
-      return;
-    }
+    console.log('transaction received:', transaction);
     const manager = new PersonaTransactionsManager(this.config);
     const persistable = new PersonaPersistableTransaction(transaction, manager);
-    this.config.onTransaction(persistable);
+    if (this.config.onTransaction) {
+      this.config.onTransaction(persistable);
+    } else {
+      persistable.invoke(this._tools);
+    }
+  }
+
+  public getTools(): PersonaTools {
+    return this._tools;
   }
 }
 

package/src/protocol/webrtc.ts

@@ -10,6 +10,8 @@ type AudioVisualizerCallback = (data: AudioAnalysisData) => void;
 
 type PersonaWebRTCMessageCallback = (data: MessageEvent) => void;
 
+type PersonaWebRTCErrorCallback = (error: string) => void;
+
 type PersonaWebRTCConfig = PersonaProtocolBaseConfig & {
   webrtcUrl: string;
   iceServers?: RTCIceServer[];
@@ -31,6 +33,8 @@ class PersonaWebRTCClient {
   private isConnected: boolean = false;
   private visualizerCallbacks: AudioVisualizerCallback[] = [];
   private messageCallbacks: PersonaWebRTCMessageCallback[] = [];
+  private errorCallbacks: PersonaWebRTCErrorCallback[] = [];
+  private queuedMessages: PersonaPacket[] = [];
 
   constructor(config: PersonaWebRTCConfig) {
     this.config = config;
@@ -100,6 +104,15 @@ class PersonaWebRTCClient {
           callback(msg);
         });
       };
+      channel.onopen = () => {
+        while (this.queuedMessages.length > 0) {
+          const packet = this.queuedMessages.shift();
+          if (packet) {
+            channel.send(JSON.stringify(packet));
+            this.config.logger?.info('Sent queued message:', packet);
+          }
+        }
+      };
     };
 
     const url = this.config.webrtcUrl || 'wss://persona.applica.guru/api/webrtc';
@@ -144,7 +157,12 @@ class PersonaWebRTCClient {
       }
     };
 
-    this.ws.onclose = () => {
+    this.ws.onclose = (event: CloseEvent) => {
+      if (event.code !== 1000) {
+        this.errorCallbacks.forEach((callback) => {
+          callback('Oops! The connection to the server was lost. Please try again later.');
+        });
+      }
       this._stopAnalyzers();
     };
   }
@@ -176,10 +194,23 @@ class PersonaWebRTCClient {
     this.messageCallbacks.push(callback);
   }
 
+  public addErrorCallback(callback: PersonaWebRTCErrorCallback): void {
+    this.errorCallbacks.push(callback);
+  }
+
   public createDataChannel(label = 'messages'): void {
     if (!this.pc) return;
     this.dataChannel = this.pc.createDataChannel(label);
-    this.dataChannel.onopen = () => this.config.logger?.info('Data channel opened');
+    this.dataChannel.onopen = () => {
+      this.config.logger?.info('Data channel opened');
+      while (this.queuedMessages.length > 0) {
+        const packet = this.queuedMessages.shift();
+        if (packet) {
+          this.dataChannel!.send(JSON.stringify(packet));
+          this.config.logger?.info('Sent queued message:', packet);
+        }
+      }
+    };
     this.dataChannel.onmessage = (msg: MessageEvent) => {
       this.messageCallbacks.forEach((callback) => {
         callback(msg);
@@ -188,8 +219,8 @@ class PersonaWebRTCClient {
   }
 
   public sendPacket(packet: PersonaPacket): void {
-    if (!this.dataChannel) {
-      this.config.logger?.warn('Data channel is not open, cannot send message');
+    if (!this.dataChannel || this.dataChannel.readyState !== 'open') {
+      this.queuedMessages.push(packet);
       return;
     }
 
@@ -277,6 +308,17 @@ class PersonaWebRTCProtocol extends PersonaProtocolBase {
       const data = JSON.parse(msg.data) as PersonaPacket;
       this.notifyPacket(data);
     });
+    this.webRTCClient.addErrorCallback((error: string) => {
+      this.config.logger?.error('WebRTC error:', error);
+      this.notifyPacket({
+        type: 'message',
+        payload: {
+          type: 'text',
+          role: 'assistant',
+          text: error,
+        },
+      });
+    });
   }
 
   public getName(): string {

package/src/protocol/websocket.ts

@@ -59,18 +59,26 @@ class PersonaWebSocketProtocol extends PersonaProtocolBase {
       const data = JSON.parse(event.data) as PersonaPacket;
       this.notifyPacket(data);
     });
-    this.webSocket.addEventListener('close', () => {
+    this.webSocket.addEventListener('close', (event: CloseEvent) => {
       this.setStatus('disconnected');
       this.webSocket = null;
-      this.config.logger?.warn('WebSocket connection closed');
+      if (event.code !== 1000) {
+        this.notifyPacket({
+          type: 'message',
+          payload: {
+            role: 'assistant',
+            type: 'text',
+            text: 'Oops! The connection to the server was lost. Please try again later.',
+          },
+        });
+        this.config.logger?.warn('WebSocket connection closed');
+      }
     });
 
-    this.webSocket.addEventListener('error', (error) => {
+    this.webSocket.addEventListener('error', () => {
       this.setStatus('disconnected');
       this.webSocket = null;
-      this.config.logger?.error('WebSocket error', error);
-
-      // TODO: Implement reconnection logic
+      this.config.logger?.error('WebSocket connection error');
     });
 
     return Promise.resolve(sid);

package/src/runtime.tsx

@@ -20,7 +20,6 @@ import {
 } from './types';
 import { parseMessages, convertMessage } from './messages';
 import {
-  PersonaPersistableTransaction,
   PersonaRESTProtocol,
   PersonaRESTProtocolConfig,
   PersonaTransactionProtocol,
@@ -137,9 +136,7 @@ function PersonaRuntimeProviderInner({
             apiUrl: `${baseEndpointProtocol}://${baseEndpoint}`,
             apiKey: config.apiKey,
             agentId: config.agentId,
-            onTransaction: async (transaction: PersonaPersistableTransaction) => {
-              await transaction.invoke(config.tools!);
-            },
+            tools: config.tools, // Pass raw tools
             logger,
           }),
         );
@@ -163,14 +160,27 @@ function PersonaRuntimeProviderInner({
       protocol.addStatusChangeListener((status: ProtocolStatus) => {
         logger?.debug(`${protocol.getName()} has notified new status: ${status}`);
         protocolsStatus.set(protocol.getName(), status);
-        if (status === 'connected' && config.context) {
-          protocol.sendPacket({
-            type: 'command',
-            payload: {
-              command: 'set_initial_context',
-              arguments: config.context,
-            },
-          });
+        if (status === 'connected') {
+          if (config.context) {
+            protocol.sendPacket({
+              type: 'command',
+              payload: {
+                command: 'set_initial_context',
+                arguments: config.context,
+              },
+            });
+          }
+          if (config.tools && Array.isArray(config.tools)) {
+            protocol.sendPacket({
+              type: 'command',
+              payload: {
+                command: 'set_local_tools',
+                arguments: {
+                  tools: config.tools.map((tool) => tool.schema),
+                },
+              },
+            });
+          }
         }
         setProtocolsStatus(new Map(protocolsStatus));
       });