@arinova-ai/agent-sdk 0.0.1

package/README.md

@@ -0,0 +1,129 @@
+# @arinova-ai/agent-sdk
+
+TypeScript SDK for connecting AI agents to [Arinova Chat](https://chat.arinova.ai) via WebSocket. Handles authentication, streaming responses, and automatic reconnection.
+
+## Install
+
+```bash
+npm install @arinova-ai/agent-sdk
+```
+
+## Quick Start
+
+```ts
+import { ArinovaAgent } from "@arinova-ai/agent-sdk";
+
+const agent = new ArinovaAgent({
+  serverUrl: "wss://chat.arinova.ai",
+  botToken: "your-bot-token",
+});
+
+agent.onTask(async (task) => {
+  // Stream chunks to the user
+  task.sendChunk("Hello, ");
+  task.sendChunk("I'm processing your request...\n\n");
+
+  // Do your work here (call an LLM, run a tool, etc.)
+  const result = await doSomething(task.content);
+
+  // Send the final complete response
+  task.sendComplete(result);
+});
+
+agent.on("connected", () => {
+  console.log("Agent connected to Arinova Chat");
+});
+
+agent.on("disconnected", () => {
+  console.log("Agent disconnected");
+});
+
+agent.on("error", (err) => {
+  console.error("Agent error:", err.message);
+});
+
+await agent.connect();
+```
+
+## API Reference
+
+### `new ArinovaAgent(options)`
+
+Creates a new agent instance.
+
+| Option | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `serverUrl` | `string` | Yes | -- | WebSocket server URL (e.g. `wss://chat.arinova.ai` or `ws://localhost:3501`) |
+| `botToken` | `string` | Yes | -- | Bot token from the Arinova dashboard |
+| `reconnectInterval` | `number` | No | `5000` | Milliseconds to wait before reconnecting after a disconnect |
+| `pingInterval` | `number` | No | `30000` | Milliseconds between keep-alive pings |
+
+### `agent.onTask(handler)`
+
+Registers the task handler. Called each time a user sends a message to your agent. The handler receives a `TaskContext` object and may return a `Promise`.
+
+```ts
+agent.onTask(async (task: TaskContext) => {
+  // handle the task
+});
+```
+
+### `agent.on(event, listener)`
+
+Subscribes to lifecycle events.
+
+| Event | Listener Signature | Description |
+|---|---|---|
+| `"connected"` | `() => void` | Fired after successful authentication |
+| `"disconnected"` | `() => void` | Fired when the WebSocket connection closes |
+| `"error"` | `(error: Error) => void` | Fired on authentication failure, connection errors, or message parse errors |
+
+### `agent.connect()`
+
+Connects to the server and authenticates with the bot token. Returns a `Promise<void>` that resolves on successful authentication or rejects on auth failure.
+
+```ts
+try {
+  await agent.connect();
+} catch (err) {
+  console.error("Failed to connect:", err);
+}
+```
+
+The agent automatically reconnects on unexpected disconnects. It does **not** reconnect on authentication errors.
+
+### `agent.disconnect()`
+
+Closes the WebSocket connection and stops automatic reconnection.
+
+```ts
+agent.disconnect();
+```
+
+### `TaskContext`
+
+The object passed to your `onTask` handler.
+
+| Property | Type | Description |
+|---|---|---|
+| `taskId` | `string` | Unique task ID assigned by the server |
+| `conversationId` | `string` | ID of the conversation this task belongs to |
+| `content` | `string` | The user's message text |
+| `sendChunk(chunk)` | `(chunk: string) => void` | Send a streaming text chunk to the user |
+| `sendComplete(content)` | `(content: string) => void` | Mark the task as complete with the full response |
+| `sendError(error)` | `(error: string) => void` | Mark the task as failed with an error message |
+
+If your `onTask` handler throws, the SDK automatically calls `sendError` with the error message.
+
+## Getting a Bot Token
+
+1. Open the [Arinova Chat](https://chat.arinova.ai) dashboard.
+2. Navigate to your bot settings (or create a new bot).
+3. Copy the bot token from the settings page.
+4. Pass the token as `botToken` when creating your `ArinovaAgent`.
+
+Keep your bot token secret. Do not commit it to version control -- use environment variables instead.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,34 @@
+import type { ArinovaAgentOptions, TaskHandler, AgentEvent, AgentEventListener } from "./types.js";
+export declare class ArinovaAgent {
+    private readonly serverUrl;
+    private readonly botToken;
+    private readonly reconnectInterval;
+    private readonly pingInterval;
+    private ws;
+    private pingTimer;
+    private reconnectTimer;
+    private stopped;
+    private taskHandler;
+    private listeners;
+    private connectResolve;
+    private connectReject;
+    constructor(options: ArinovaAgentOptions);
+    /** Register a task handler. Called when the server sends a task. */
+    onTask(handler: TaskHandler): this;
+    /** Register an event listener. */
+    on<T extends AgentEvent>(event: T, listener: AgentEventListener<T>): this;
+    /**
+     * Connect to the Arinova server.
+     * Returns a promise that resolves on successful auth, or rejects on auth failure.
+     */
+    connect(): Promise<void>;
+    /** Disconnect and stop reconnecting. */
+    disconnect(): void;
+    private emit;
+    private send;
+    private cleanup;
+    private scheduleReconnect;
+    private doConnect;
+    private handleTask;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAEnB,WAAW,EACX,UAAU,EACV,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAKpB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;IAE/C,OAAO,CAAC,SAAS,CAIf;IAGF,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,aAAa,CAAuC;gBAEhD,OAAO,EAAE,mBAAmB;IAOxC,oEAAoE;IACpE,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKlC,kCAAkC;IAClC,EAAE,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;IAKzE;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxB,wCAAwC;IACxC,UAAU,IAAI,IAAI;IAKlB,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,OAAO;IAiBf,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,SAAS;IA6EjB,OAAO,CAAC,UAAU;CAiBnB"}

package/dist/client.js

@@ -0,0 +1,174 @@
+const DEFAULT_RECONNECT_INTERVAL = 5_000;
+const DEFAULT_PING_INTERVAL = 30_000;
+export class ArinovaAgent {
+    serverUrl;
+    botToken;
+    reconnectInterval;
+    pingInterval;
+    ws = null;
+    pingTimer = null;
+    reconnectTimer = null;
+    stopped = false;
+    taskHandler = null;
+    listeners = {
+        connected: [],
+        disconnected: [],
+        error: [],
+    };
+    // Used to resolve/reject the connect() promise on first auth
+    connectResolve = null;
+    connectReject = null;
+    constructor(options) {
+        this.serverUrl = options.serverUrl.replace(/\/$/, "");
+        this.botToken = options.botToken;
+        this.reconnectInterval = options.reconnectInterval ?? DEFAULT_RECONNECT_INTERVAL;
+        this.pingInterval = options.pingInterval ?? DEFAULT_PING_INTERVAL;
+    }
+    /** Register a task handler. Called when the server sends a task. */
+    onTask(handler) {
+        this.taskHandler = handler;
+        return this;
+    }
+    /** Register an event listener. */
+    on(event, listener) {
+        this.listeners[event]?.push(listener);
+        return this;
+    }
+    /**
+     * Connect to the Arinova server.
+     * Returns a promise that resolves on successful auth, or rejects on auth failure.
+     */
+    connect() {
+        this.stopped = false;
+        return new Promise((resolve, reject) => {
+            this.connectResolve = resolve;
+            this.connectReject = reject;
+            this.doConnect();
+        });
+    }
+    /** Disconnect and stop reconnecting. */
+    disconnect() {
+        this.stopped = true;
+        this.cleanup();
+    }
+    emit(event, ...args) {
+        for (const listener of this.listeners[event] ?? []) {
+            listener(...args);
+        }
+    }
+    send(event) {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(event));
+        }
+    }
+    cleanup() {
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            try {
+                this.ws.close();
+            }
+            catch { }
+            this.ws = null;
+        }
+    }
+    scheduleReconnect() {
+        if (this.stopped)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            if (!this.stopped)
+                this.doConnect();
+        }, this.reconnectInterval);
+    }
+    doConnect() {
+        if (this.stopped)
+            return;
+        this.cleanup();
+        const wsUrl = `${this.serverUrl}/ws/agent`;
+        try {
+            this.ws = new WebSocket(wsUrl);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit("error", error);
+            this.scheduleReconnect();
+            return;
+        }
+        this.ws.onopen = () => {
+            this.send({ type: "agent_auth", botToken: this.botToken });
+            this.pingTimer = setInterval(() => {
+                this.send({ type: "ping" });
+            }, this.pingInterval);
+        };
+        this.ws.onmessage = (event) => {
+            try {
+                const data = JSON.parse(String(event.data));
+                if (data.type === "auth_ok") {
+                    this.emit("connected");
+                    // Resolve the connect() promise on first successful auth
+                    if (this.connectResolve) {
+                        this.connectResolve();
+                        this.connectResolve = null;
+                        this.connectReject = null;
+                    }
+                    return;
+                }
+                if (data.type === "auth_error") {
+                    const error = new Error(`Agent auth failed: ${data.error}`);
+                    this.emit("error", error);
+                    // Don't reconnect on auth error
+                    this.stopped = true;
+                    this.cleanup();
+                    // Reject the connect() promise
+                    if (this.connectReject) {
+                        this.connectReject(error);
+                        this.connectResolve = null;
+                        this.connectReject = null;
+                    }
+                    return;
+                }
+                if (data.type === "pong") {
+                    return;
+                }
+                if (data.type === "task") {
+                    this.handleTask(data.taskId, data.conversationId, data.content);
+                    return;
+                }
+            }
+            catch (err) {
+                this.emit("error", err instanceof Error ? err : new Error(String(err)));
+            }
+        };
+        this.ws.onerror = () => {
+            // WebSocket errors are followed by close events
+        };
+        this.ws.onclose = () => {
+            this.cleanup();
+            this.emit("disconnected");
+            this.scheduleReconnect();
+        };
+    }
+    handleTask(taskId, conversationId, content) {
+        if (!this.taskHandler)
+            return;
+        const ctx = {
+            taskId,
+            conversationId,
+            content,
+            sendChunk: (chunk) => this.send({ type: "agent_chunk", taskId, chunk }),
+            sendComplete: (fullContent) => this.send({ type: "agent_complete", taskId, content: fullContent }),
+            sendError: (error) => this.send({ type: "agent_error", taskId, error }),
+        };
+        Promise.resolve(this.taskHandler(ctx)).catch((err) => {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            ctx.sendError(errorMsg);
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { ArinovaAgent } from "./client.js";
+export type { ArinovaAgentOptions, TaskContext, TaskHandler, AgentEvent, AgentEventListener, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,UAAU,EACV,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { ArinovaAgent } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+/** Options for creating an ArinovaAgent. */
+export interface ArinovaAgentOptions {
+    /** WebSocket server URL (e.g. "wss://chat.arinova.ai" or "ws://localhost:3501"). */
+    serverUrl: string;
+    /** Bot token from the Arinova dashboard. */
+    botToken: string;
+    /** Reconnect interval in ms (default: 5000). */
+    reconnectInterval?: number;
+    /** Ping interval in ms (default: 30000). */
+    pingInterval?: number;
+}
+/** Context passed to the task handler. */
+export interface TaskContext {
+    /** Unique task ID assigned by the server. */
+    taskId: string;
+    /** Conversation ID this task belongs to. */
+    conversationId: string;
+    /** The user's message content. */
+    content: string;
+    /** Send a streaming chunk to the user. */
+    sendChunk: (chunk: string) => void;
+    /** Mark the task as complete with the full response content. */
+    sendComplete: (content: string) => void;
+    /** Mark the task as failed with an error message. */
+    sendError: (error: string) => void;
+}
+/** Task handler function. */
+export type TaskHandler = (task: TaskContext) => void | Promise<void>;
+/** Agent lifecycle event types. */
+export type AgentEvent = "connected" | "disconnected" | "error";
+/** Event listener signatures. */
+export type AgentEventListener<T extends AgentEvent> = T extends "error" ? (error: Error) => void : () => void;
+//# 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":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,gEAAgE;IAChE,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,qDAAqD;IACrD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE,mCAAmC;AACnC,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;AAEhE,iCAAiC;AACjC,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,SAAS,OAAO,GACpE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GACtB,MAAM,IAAI,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@arinova-ai/agent-sdk",
+  "version": "0.0.1",
+  "description": "SDK for connecting AI agents to Arinova Chat",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "arinova",
+    "agent",
+    "sdk",
+    "websocket",
+    "streaming",
+    "ai"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5"
+  }
+}