@ragwalla/agents-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ragwalla
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,332 @@
+# Ragwalla Agents SDK - TypeScript
+
+The official TypeScript SDK for the Ragwalla Agents API. Build powerful AI applications with agents, real-time chat, vector search, and more.
+
+## Installation
+
+```bash
+npm install @ragwalla/agents-sdk
+```
+
+## Quick Start
+
+```typescript
+import { Ragwalla } from '@ragwalla/agents-sdk';
+
+const ragwalla = new Ragwalla({
+  apiKey: process.env.RAGWALLA_API_KEY!
+});
+
+// Create an agent
+const agent = await ragwalla.agents.create({
+  name: 'My Assistant',
+  instructions: 'You are a helpful AI assistant.'
+});
+
+// Chat with the agent
+const response = await ragwalla.agents.createChatCompletion(agent.id, {
+  messages: [{ role: 'user', content: 'Hello!' }]
+});
+
+console.log(response.choices[0].message.content);
+```
+
+## Features
+
+- ✅ **Agent Management** - Create, update, and manage AI agents
+- ✅ **Chat Completions** - Both streaming and non-streaming
+- ✅ **Real-time WebSocket** - Live chat with automatic reconnection
+- ✅ **Vector Search** - Semantic search across knowledge bases
+- ✅ **Tool Management** - Attach functions and assistants to agents
+- ✅ **Quota Management** - Track usage and limits
+- ✅ **TypeScript Native** - Full type safety and IntelliSense
+- ✅ **Error Handling** - Comprehensive error types
+- ✅ **Automatic Retries** - Built-in retry logic for failed requests
+
+## Configuration
+
+```typescript
+const ragwalla = new Ragwalla({
+  apiKey: 'your-api-key',           // Required
+  baseURL: 'https://api.ragwalla.com', // Optional, defaults to this
+  timeout: 30000                    // Optional, request timeout in ms
+});
+```
+
+## Agent Management
+
+### Create an Agent
+
+```typescript
+const agent = await ragwalla.agents.create({
+  name: 'Customer Support Agent',
+  description: 'Handles customer inquiries',
+  model: 'gpt-4',
+  instructions: 'You are a helpful customer support representative.',
+  tools: ['tool_id_1', 'tool_id_2'],
+  metadata: {
+    department: 'support',
+    version: '1.0'
+  }
+});
+```
+
+### List Agents
+
+```typescript
+const agents = await ragwalla.agents.list({
+  limit: 10,
+  order: 'desc'
+});
+
+console.log(agents.data); // Array of agents
+```
+
+### Update an Agent
+
+```typescript
+const updatedAgent = await ragwalla.agents.update(agent.id, {
+  instructions: 'Updated instructions for the agent'
+});
+```
+
+### Delete an Agent
+
+```typescript
+await ragwalla.agents.delete(agent.id);
+```
+
+## Chat Completions
+
+### Non-streaming Chat
+
+```typescript
+const response = await ragwalla.agents.createChatCompletion(agent.id, {
+  messages: [
+    { role: 'user', content: 'What is the weather like?' }
+  ],
+  max_tokens: 150,
+  temperature: 0.7
+});
+
+console.log(response.choices[0].message.content);
+```
+
+### Streaming Chat
+
+```typescript
+const stream = await ragwalla.agents.createChatCompletionStream(agent.id, {
+  messages: [
+    { role: 'user', content: 'Write a story about AI' }
+  ],
+  stream: true,
+  max_tokens: 500
+});
+
+const reader = stream.getReader();
+while (true) {
+  const { done, value } = await reader.read();
+  if (done) break;
+  
+  if (value.choices?.[0]?.message?.content) {
+    process.stdout.write(value.choices[0].message.content);
+  }
+}
+```
+
+## Real-time WebSocket Chat
+
+### Basic WebSocket Usage
+
+```typescript
+// Get connection token
+const tokenResponse = await ragwalla.agents.getToken({
+  agent_id: agent.id,
+  expires_in: 3600
+});
+
+// Create WebSocket connection
+const ws = ragwalla.createWebSocket();
+
+// Set up event listeners
+ws.on('connected', () => {
+  console.log('Connected to agent');
+});
+
+ws.on('message', (message) => {
+  console.log('Agent:', message.content);
+});
+
+ws.on('error', (error) => {
+  console.error('Error:', error);
+});
+
+// Connect and send message
+await ws.connect(agent.id, 'main', tokenResponse.token);
+ws.sendMessage({
+  role: 'user',
+  content: 'Hello via WebSocket!'
+});
+```
+
+### WebSocket Events
+
+The WebSocket client emits the following events:
+
+- `connected` - Successfully connected to agent
+- `message` - New message from agent
+- `tokenUsage` - Token usage information
+- `error` - Error occurred
+- `disconnected` - Connection closed
+- `reconnectFailed` - Reconnection attempts failed
+
+## Vector Search
+
+### Simple Search
+
+```typescript
+const results = await ragwalla.vectorStores.search('vector_store_id', {
+  query: 'How to use the API?',
+  top_k: 5,
+  include_metadata: true
+});
+
+results.data.forEach(result => {
+  console.log(`Score: ${result.score}`);
+  console.log(`Content: ${result.content}`);
+});
+```
+
+### Advanced Search with Filters
+
+```typescript
+const results = await ragwalla.vectorStores.searchExtended('vector_store_id', {
+  query: 'JavaScript examples',
+  top_k: 3,
+  filter: {
+    language: 'javascript',
+    category: 'tutorial'
+  },
+  extended_query: 'Find JavaScript SDK usage examples',
+  search_type: 'similarity_score_threshold',
+  search_kwargs: {
+    score_threshold: 0.8
+  }
+});
+```
+
+## Tool Management
+
+### List Agent Tools
+
+```typescript
+const tools = await ragwalla.agents.listTools(agent.id);
+console.log(tools.data);
+```
+
+### Attach a Tool
+
+```typescript
+const tool = await ragwalla.agents.attachTool(agent.id, {
+  type: 'function',
+  function: {
+    name: 'get_weather',
+    description: 'Get current weather for a location',
+    parameters: {
+      type: 'object',
+      properties: {
+        location: {
+          type: 'string',
+          description: 'The city and state'
+        }
+      },
+      required: ['location']
+    }
+  }
+});
+```
+
+### Detach a Tool
+
+```typescript
+await ragwalla.agents.detachTool(agent.id, tool.id);
+```
+
+## Quota Management
+
+### Check Quota
+
+```typescript
+const quotaCheck = await ragwalla.quota.check({
+  userId: 'user_123',
+  action: 'chat_completion'
+});
+
+if (quotaCheck.allowed) {
+  // Proceed with action
+} else {
+  console.log('Quota exceeded');
+}
+```
+
+### Send Quota Event
+
+```typescript
+await ragwalla.quota.sendEvent('worker_id', {
+  action: 'message_sent',
+  metadata: {
+    tokens_used: 150,
+    model: 'gpt-4'
+  }
+});
+```
+
+## Error Handling
+
+The SDK throws `RagwallaAPIError` for API-related errors:
+
+```typescript
+import { RagwallaAPIError } from '@ragwalla/agents-sdk';
+
+try {
+  const agent = await ragwalla.agents.retrieve('invalid_id');
+} catch (error) {
+  if (error instanceof RagwallaAPIError) {
+    console.log('API Error:', error.message);
+    console.log('Status:', error.status);
+    console.log('Type:', error.type);
+    console.log('Code:', error.code);
+  }
+}
+```
+
+## Examples
+
+Check the `examples/` directory for complete usage examples:
+
+- `basic-usage.ts` - Basic agent operations
+- `streaming-chat.ts` - Streaming chat completions
+- `websocket-chat.ts` - Real-time WebSocket communication
+- `vector-search.ts` - Vector store search examples
+
+## Environment Variables
+
+Set your API key as an environment variable:
+
+```bash
+export RAGWALLA_API_KEY=your_api_key_here
+```
+
+## TypeScript Support
+
+The SDK is written in TypeScript and provides full type definitions. All API responses and request parameters are fully typed for the best development experience.
+
+## Support
+
+For issues and questions:
+- GitHub Issues: [ragwalla-agents-sdk issues](https://github.com/ragwalla/agents-sdk/issues)
+- Documentation: [Ragwalla Docs](https://docs.ragwalla.com)
+
+## License
+
+MIT License

package/dist/client/http-client.d.ts

@@ -0,0 +1,22 @@
+import { RagwallaConfig, RagwallaError } from '../types';
+export declare class HTTPClient {
+    private apiKey;
+    private baseURL;
+    private timeout;
+    constructor(config: RagwallaConfig);
+    private getHeaders;
+    private handleResponse;
+    get<T>(path: string, params?: Record<string, any>): Promise<T>;
+    post<T>(path: string, data?: any): Promise<T>;
+    put<T>(path: string, data?: any): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+    postEventStream<T>(path: string, data?: any): Promise<ReadableStream<T>>;
+}
+export declare class RagwallaAPIError extends Error implements RagwallaError {
+    readonly type: string;
+    readonly code?: string;
+    readonly param?: string;
+    readonly status?: number;
+    constructor(message: string, status?: number, type?: string, code?: string, param?: string);
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/client/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/client/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,cAAc;IAMlC,OAAO,CAAC,UAAU;YAQJ,cAAc;IAoBtB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA0B9D,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAmB7C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAmB5C,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBnC,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CA8C/E;AAED,qBAAa,gBAAiB,SAAQ,KAAM,YAAW,aAAa;IAClE,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAG9B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM;CASjB"}

package/dist/client/http-client.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RagwallaAPIError = exports.HTTPClient = void 0;
+class HTTPClient {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseURL = config.baseURL || 'https://api.ragwalla.com';
+        this.timeout = config.timeout || 30000;
+    }
+    getHeaders() {
+        return {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+            'User-Agent': 'ragwalla-agents-sdk-typescript/1.0.0'
+        };
+    }
+    async handleResponse(response) {
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({}));
+            throw new RagwallaAPIError(error.message || `HTTP ${response.status}`, response.status, error.type, error.code, error.param);
+        }
+        const contentType = response.headers.get('content-type');
+        if (contentType && contentType.includes('application/json')) {
+            return response.json();
+        }
+        return response.text();
+    }
+    async get(path, params) {
+        const url = new URL(path, this.baseURL);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.append(key, String(value));
+                }
+            });
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url.toString(), {
+                method: 'GET',
+                headers: this.getHeaders(),
+                signal: controller.signal
+            });
+            return this.handleResponse(response);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async post(path, data) {
+        const url = new URL(path, this.baseURL);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url.toString(), {
+                method: 'POST',
+                headers: this.getHeaders(),
+                body: data ? JSON.stringify(data) : undefined,
+                signal: controller.signal
+            });
+            return this.handleResponse(response);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async put(path, data) {
+        const url = new URL(path, this.baseURL);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url.toString(), {
+                method: 'PUT',
+                headers: this.getHeaders(),
+                body: data ? JSON.stringify(data) : undefined,
+                signal: controller.signal
+            });
+            return this.handleResponse(response);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async delete(path) {
+        const url = new URL(path, this.baseURL);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url.toString(), {
+                method: 'DELETE',
+                headers: this.getHeaders(),
+                signal: controller.signal
+            });
+            return this.handleResponse(response);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async postEventStream(path, data) {
+        const url = new URL(path, this.baseURL);
+        const response = await fetch(url.toString(), {
+            method: 'POST',
+            headers: {
+                ...this.getHeaders(),
+                'Accept': 'text/event-stream',
+            },
+            body: data ? JSON.stringify(data) : undefined,
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({}));
+            throw new RagwallaAPIError(error.message || `HTTP ${response.status}`, response.status, error.type, error.code, error.param);
+        }
+        if (!response.body) {
+            throw new Error('No response body');
+        }
+        return response.body.pipeThrough(new TransformStream({
+            transform(chunk, controller) {
+                const decoder = new TextDecoder();
+                const text = decoder.decode(chunk);
+                const lines = text.split('\n');
+                for (const line of lines) {
+                    if (line.startsWith('data: ')) {
+                        try {
+                            const data = JSON.parse(line.slice(6));
+                            controller.enqueue(data);
+                        }
+                        catch (e) {
+                            // Skip invalid JSON
+                        }
+                    }
+                }
+            }
+        }));
+    }
+}
+exports.HTTPClient = HTTPClient;
+class RagwallaAPIError extends Error {
+    constructor(message, status, type, code, param) {
+        super(message);
+        this.name = 'RagwallaAPIError';
+        this.status = status;
+        this.type = type || 'api_error';
+        this.code = code;
+        this.param = param;
+    }
+}
+exports.RagwallaAPIError = RagwallaAPIError;
+//# sourceMappingURL=http-client.js.map

package/dist/client/http-client.js.map

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

package/dist/client/websocket-client.d.ts

@@ -0,0 +1,51 @@
+import { ChatMessage } from '../types';
+export interface WebSocketConfig {
+    baseURL?: string;
+    reconnectAttempts?: number;
+    reconnectDelay?: number;
+}
+export declare class RagwallaWebSocket {
+    private ws;
+    private baseURL;
+    private reconnectAttempts;
+    private reconnectDelay;
+    private currentAttempts;
+    private isManuallyDisconnected;
+    private listeners;
+    constructor(config?: WebSocketConfig);
+    /**
+     * Connect to an agent's WebSocket endpoint
+     */
+    connect(agentId: string, connectionId: string, token: string): Promise<void>;
+    /**
+     * Disconnect from the WebSocket
+     */
+    disconnect(): void;
+    /**
+     * Send a chat message to the agent
+     */
+    sendMessage(message: ChatMessage): void;
+    /**
+     * Send raw data to the WebSocket
+     */
+    send(data: any): void;
+    /**
+     * Check if WebSocket is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Add event listener
+     */
+    on(event: string, listener: Function): void;
+    /**
+     * Remove event listener
+     */
+    off(event: string, listener: Function): void;
+    /**
+     * Remove all listeners for an event
+     */
+    removeAllListeners(event?: string): void;
+    private emit;
+    private handleMessage;
+}
+//# sourceMappingURL=websocket-client.d.ts.map

package/dist/client/websocket-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-client.d.ts","sourceRoot":"","sources":["../../src/client/websocket-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,SAAS,CAAyC;gBAE9C,MAAM,GAAE,eAAoB;IAMxC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4ClF;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAcvC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAQrB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAO3C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAO5C;;OAEG;IACH,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAQxC,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,aAAa;CAkBtB"}