@applica-software-guru/persona-chat-sdk 0.1.102

package/dist/tools.d.ts

@@ -0,0 +1,72 @@
+export type ToolParameterType = 'string' | 'number' | 'boolean' | 'object' | 'array';
+export interface ToolParameter {
+    type: ToolParameterType;
+    description: string;
+    required?: boolean;
+    properties?: Record<string, ToolParameter>;
+    items?: ToolParameter;
+}
+export interface ToolSchema {
+    type: 'local';
+    name: string;
+    description: string;
+    config: {
+        timeout: number;
+        parameters: {
+            type: 'object';
+            title: string;
+            required: string[];
+            properties: Record<string, ToolParameter>;
+        };
+        output: {
+            type: 'object';
+            title: string;
+            properties: Record<string, ToolParameter>;
+        };
+    };
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    title?: string;
+    timeout?: number;
+    parameters: Record<string, ToolParameter>;
+    output: Record<string, ToolParameter>;
+    implementation: (...args: any[]) => any;
+}
+/**
+ * Create a tool parameter definition
+ */
+export declare function createParameter(type: ToolParameterType, description: string, options?: {
+    required?: boolean;
+    properties?: Record<string, ToolParameter>;
+    items?: ToolParameter;
+}): ToolParameter;
+/**
+ * Generate a tool schema from a tool definition
+ */
+export declare function generateToolSchema(definition: ToolDefinition): ToolSchema;
+export type ToolInstance = {
+    schema: ToolSchema;
+    implementation: (...args: any[]) => any;
+};
+/**
+ * Create a complete tool definition with schema and implementation
+ */
+export declare function createTool(definition: ToolDefinition): ToolInstance;
+/**
+ * Extract function signature and generate schema from a JavaScript function
+ * This is a utility to help convert existing functions to tool schemas
+ */
+export declare function createToolFromFunction(name: string, description: string, fn: (...args: any[]) => any, parameterTypes: Record<string, ToolParameter>, outputTypes: Record<string, ToolParameter>, options?: {
+    title?: string;
+    timeout?: number;
+}): ToolInstance;
+export declare const sumTool: ToolInstance;
+export declare const navigateToToolExample: ToolInstance;
+export declare function createToolRegistry(tools: ToolDefinition[]): {
+    schemas: ToolSchema[];
+    implementations: Record<string, (...args: any[]) => any>;
+};
+export declare function validateToolParameters(parameters: Record<string, any>, schema: ToolSchema): boolean;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,237 @@
+import { PersonaTools } from 'src/protocol';
+import { ReactNode } from 'react';
+import type { ToolInstance } from './tools';
+import type { PersonaLogger } from './logging';
+import type { SessionStorage } from './storage';
+export type { PersonaLogger, SessionStorage };
+export type ReadonlyJSONObject = {
+    readonly [key: string]: string | number | boolean | null | ReadonlyJSONObject | ReadonlyArray<ReadonlyJSONObject>;
+};
+export type FunctionCall = {
+    id?: string;
+    name: string;
+    args: ReadonlyJSONObject;
+};
+export type FunctionResponse = {
+    name: string;
+    result: unknown;
+    function_call_id: string;
+};
+export type PersonaFile = {
+    name: string;
+    url?: string;
+    base64?: string;
+    contentType: string;
+};
+export type PersonaSession = {
+    id: string;
+    code: string;
+    projectId: string;
+    agentId: string;
+    currentAgentId: string;
+    userId: string;
+    status: 'active' | 'finished';
+    type: 'realtime' | 'async';
+    createdAt: string;
+    finishedAt: string | null;
+};
+export type PersonaProjectSubscription = {
+    id: string;
+    projectId?: string | null;
+    owner?: string | null;
+    planType: 'free' | 'baby' | 'junior' | 'pro' | 'mentor';
+    status: 'creating' | 'active' | 'inactive' | 'cancelled';
+    startDate?: string | null;
+    planCredits: number;
+    extraCredits: number;
+    keepCreditsOnRenew: boolean;
+    endDate?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+    stripeCustomerId?: string | null;
+    stripeSubscriptionId?: string | null;
+};
+export type PersonaAgentContext = {
+    data: Record<string, unknown>;
+    files?: PersonaFile[];
+    session?: PersonaSession;
+};
+export type PersonaTransaction = {
+    id: string;
+    projectId: string;
+    sessionId: string;
+    status: 'pending' | 'completed' | 'failed';
+    error: string | null;
+    functionCall: FunctionCall | null;
+    context: PersonaAgentContext;
+};
+export type PersonaReasoning = {
+    thought: string;
+    imageUrl?: string;
+};
+export type PersonaImage = {
+    content: string;
+    contentType: string;
+};
+export type PersonaSourceChunk = {
+    start: number;
+    end: number;
+};
+export type PersonaSource = {
+    type: 'web' | 'document';
+    url?: string;
+    documentId?: string;
+    pageId?: string;
+    pageNumber?: number;
+    chunks?: PersonaSourceChunk[];
+    mostRelevant?: boolean;
+};
+export type PersonaCommand = {
+    command: 'get_mcp_assets' | 'set_initial_context' | 'set_local_tools';
+    arguments: Record<string, unknown>;
+};
+export type PersonaRequest = PersonaMessage | Array<PersonaMessage> | string;
+export type PersonaPacketPayload = PersonaRequest | PersonaCommand | PersonaReasoning | PersonaTransaction;
+export type PersonaPacket = {
+    type: 'request' | 'message' | 'command' | 'reasoning' | 'mcp_assets' | 'transaction';
+    payload?: PersonaPacketPayload;
+};
+export type PersonaMessage = {
+    id?: string | null;
+    protocol?: string;
+    thought?: string;
+    text: string;
+    image?: PersonaImage;
+    type: 'reasoning' | 'text' | 'transaction' | 'command';
+    role: 'user' | 'assistant' | 'function';
+    file?: PersonaFile;
+    sources?: PersonaSource[];
+    sessionId?: string;
+    finishReason?: 'stop' | 'function_call';
+    functionCalls?: FunctionCall[];
+    functionResponse?: FunctionResponse;
+    status?: {
+        type: 'running' | 'complete' | 'incomplete';
+    };
+    createdAt?: Date;
+    metadata?: {
+        custom?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+};
+export type ModelResponse = {
+    messages: PersonaMessage[];
+};
+export type PersonaResponse = {
+    sessionId: string;
+    response: ModelResponse;
+};
+export type PersonaBaseConfig = {
+    logger?: PersonaLogger;
+};
+export type PersonaWebRTCConfig = PersonaBaseConfig & {
+    webrtcUrl: string;
+    iceServers?: RTCIceServer[];
+    onDataMessage?: (msg: MessageEvent) => void;
+};
+export type Session = string | null | undefined;
+export type TransformMessages = (messages: PersonaMessage[]) => PersonaMessage[];
+export type ThreadData = {
+    threadId: string;
+    title?: string;
+    status: 'regular' | 'archived';
+};
+export type MessageListenerCallback = (message: PersonaPacket) => void;
+export type StatusChangeCallback = (status: ProtocolStatus) => void;
+export type ProtocolStatus = 'disconnected' | 'connecting' | 'connected';
+export type PersonaProtocolBaseConfig = {
+    logger?: PersonaLogger;
+    apiKey: string;
+    agentId: string;
+    userId?: string;
+};
+export interface PersonaProtocol {
+    status: ProtocolStatus;
+    autostart: boolean;
+    getName: () => string;
+    getPriority: () => number;
+    connect: (session?: Session) => Promise<Session>;
+    disconnect: () => Promise<void>;
+    onTransaction: (transaction: PersonaTransaction) => void;
+    setSession: (session: Session) => Promise<void>;
+    sendPacket: (packet: PersonaPacket) => Promise<void>;
+    setAgentContext: (context: PersonaAgentContext) => Promise<void>;
+    clearListeners: () => void;
+    addStatusChangeListener: (callback: StatusChangeCallback) => void;
+    addPacketListener: (callback: MessageListenerCallback) => void;
+}
+export type PersonaConfig = PersonaBaseConfig & PersonaProtocolBaseConfig & {
+    /**
+     * In 'dev' mode the endpoint is set to localhost:8000,
+     * use it only for development purposes.
+     */
+    dev?: boolean;
+    /**
+     * The base URL of the API.
+     * @default 'persona.applica.guru/api'
+     */
+    baseUrl?: string;
+    session?: Session;
+    children: ReactNode;
+    context?: PersonaAgentContext;
+    protocols: PersonaProtocol[] | {
+        rest?: PersonaProtocolBaseConfig | boolean;
+        webrtc?: PersonaProtocolBaseConfig | boolean;
+        websocket?: PersonaProtocolBaseConfig | boolean;
+    };
+    /**
+     * Tools can be provided as an object (legacy) or as an array of { schema, implementation } (recommended)
+     */
+    tools?: PersonaTools | ToolInstance[];
+    /**
+     * Optional message transform function that processes messages before they are displayed
+     */
+    transformMessages?: TransformMessages;
+    /**
+     * Enable thread management support
+     */
+    threads?: boolean;
+    /**
+     * Session storage implementation
+     * If not provided, defaults to PersonaSessionStorage
+     */
+    sessionStorage?: SessionStorage;
+    /**
+     * Initial thread list (if thread management is enabled)
+     */
+    initialThreads?: ThreadData[];
+    /**
+     * Callback when a new thread is created
+     */
+    onThreadCreate?: (threadId: string) => void;
+    /**
+     * Callback when switching to a thread
+     */
+    onThreadSwitch?: (threadId: string) => void;
+    /**
+     * Callback when a thread is renamed
+     */
+    onThreadRename?: (threadId: string, newTitle: string) => void;
+    /**
+     * Callback when a thread is archived
+     */
+    onThreadArchive?: (threadId: string) => void;
+    /**
+     * Callback when a thread is unarchived
+     */
+    onThreadUnarchive?: (threadId: string) => void;
+    /**
+     * Callback when a thread is deleted
+     */
+    onThreadDelete?: (threadId: string) => void;
+    /**
+     * Enable file attachments (images, PDFs, text files) in the composer
+     */
+    enableAttachments?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/docs/README.md

@@ -0,0 +1,13 @@
+# Persona Chat SDK Documentation
+
+Welcome to the Persona Chat SDK documentation.
+
+- [Features](features.md)
+- [Installation](installation.md)
+- [Usage](usage.md)
+- [Messages and Storage](messages.md)
+- [Protocols](protocols.md)
+- [API Reference](api-reference.md)
+- [Transactions and Tools](transactions.md)
+- [Customization](customization.md)
+- [Contributing](contributing.md)

package/docs/api-reference.md

@@ -0,0 +1,16 @@
+# API Reference
+
+## Props for `PersonaRuntimeProvider`
+
+| Prop            | Type          | Default Value                                   | Description                                                                                         |
+| --------------- | ------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| `dev`           | boolean       | `false`                                         | Enable development mode for local Persona API usage.                                                |
+| `logger`        | function      | `console.log`                                   | Custom logger for debugging and logging messages.                                                   |
+| `protocols`     | object        | `{ rest: true, webrtc: true, websocket: true }` | Protocols to use for the chat. Can be enabled/disabled using boolean values.                        |
+| `session`       | string        | `undefined`                                     | Session ID for the chat. Required for the chat to function.                                         |
+| `apiKey`        | string        | `toolkit-test`                                  | API key for authentication. Required for the chat to function.                                      |
+| `agentId`       | string        | `default`                                       | Agent ID for the chat. Required for the chat to function.                                           |
+| `messageFilter` | MessageFilter | `undefined`                                     | Optional function to filter and transform messages before they are displayed in the chat interface. |
+| `messageStorage`| MessageStorage| `InMemoryMessageStorage`                        | Optional storage implementation for persisting messages.                                            |
+| `threads`       | boolean       | `false`                                         | Enable thread management.                                                                           |
+| `tools`         | object\|array  | `undefined`                                     | Custom tools for the Transaction Protocol.                                                          |

package/docs/contributing.md

@@ -0,0 +1,21 @@
+# Contributing
+
+We welcome contributions! To get started:
+
+1. Fork the repository.
+2. Create a new branch for your feature or bugfix.
+3. Submit a pull request with a detailed description of your changes.
+
+Please ensure your code adheres to the existing style and passes all linting and testing checks.
+
+## Support
+
+For questions or support, contact us at [info@applica.guru](mailto:info@applica.guru).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+This SDK is built on top of [assistant-ui](https://www.assistant-ui.com/), a powerful framework for building conversational interfaces.

package/docs/customization.md

@@ -0,0 +1,74 @@
+# Customization
+
+The Persona Chat SDK allows you to extend its functionality by creating custom protocols and loggers.
+
+## Custom Protocols
+
+You can implement your own protocol by extending the `PersonaProtocolBase` class. For example:
+
+```typescript
+import { PersonaProtocolBase } from '@applica-software-guru/persona-chat-sdk';
+
+class CustomProtocol extends PersonaProtocolBase {
+  // Implement required methods like connect, disconnect, send, etc.
+}
+```
+
+### Example: Custom Protocol Implementation
+
+Here’s an example of a custom protocol named `CustomProtocol`:
+
+```typescript
+import { PersonaProtocolBase } from '@applica-software-guru/persona-chat-sdk';
+
+class CustomProtocol extends PersonaProtocolBase {
+  public getName(): string {
+    return 'custom';
+  }
+
+  public async connect(): Promise<void> {
+    console.log('[CustomProtocol] Connecting...');
+    this.setStatus('connected');
+  }
+
+  public async disconnect(): Promise<void> {
+    console.log('[CustomProtocol] Disconnecting...');
+    this.setStatus('disconnected');
+  }
+
+  public async send(message: string): Promise<void> {
+    console.log(`[CustomProtocol] Sending message: ${message}`);
+    this.notifyMessage({ role: 'assistant', type: 'text', text: `Echo: ${message}` });
+  }
+}
+```
+
+## Custom Loggers
+
+You can create a custom logger by implementing the `PersonaLogger` interface:
+
+```typescript
+import { PersonaLogger } from '@applica-software-guru/persona-chat-sdk';
+
+class CustomLogger implements PersonaLogger {
+  log(message: string, ...args: unknown[]): void {
+    console.log(`[CustomLogger] ${message}`, ...args);
+  }
+
+  info(message: string, ...args: unknown[]): void {
+    console.info(`[CustomLogger] ${message}`, ...args);
+  }
+
+  warn(message: string, ...args: unknown[]): void {
+    console.warn(`[CustomLogger] ${message}`, ...args);
+  }
+
+  error(message: string, ...args: unknown[]): void {
+    console.error(`[CustomLogger] ${message}`, ...args);
+  }
+
+  debug(message: string, ...args: unknown[]): void {
+    console.debug(`[CustomLogger] ${message}`, ...args);
+  }
+}
+```

package/docs/features.md

@@ -0,0 +1,7 @@
+# Features
+
+- **Custom Runtime Provider**: Easily integrate the Persona API with assistant-ui chat.
+- **Local Runtime Support**: Run the assistant-ui chat locally using the Persona API.
+- **Multiple Protocols**: Supports REST, WebSocket, and WebRTC protocols.
+- **WebRTC Optimization**: Communicate with AI agents in real-time using the fastest protocol available.
+- **Customizable**: Extend functionality with custom protocols and loggers.

package/docs/installation.md

@@ -0,0 +1,9 @@
+# Installation
+
+To get started, install the Persona Chat SDK using npm or yarn:
+
+```bash
+npm install @applica-software-guru/persona-chat-sdk
+```
+
+If you don't already have an assistant-ui-based project, you can create one using the [Assistant UI Getting Started Guide](https://www.assistant-ui.com/docs/getting-started).