@arinova-ai/agent-sdk 0.0.15 → 0.0.16-staging.1

package/dist/client.js

@@ -1,6 +1,7 @@
 const DEFAULT_RECONNECT_INTERVAL = 5_000;
 const DEFAULT_PING_INTERVAL = 30_000;
 const TASK_HEARTBEAT_INTERVAL = 60_000;
+const MAX_QUEUE_SIZE = 10;
 export class ArinovaAgent {
     serverUrl;
     botToken;
@@ -9,10 +10,14 @@ export class ArinovaAgent {
     pingInterval;
     ws = null;
     pingTimer = null;
+    commandHeartbeatTimer = null;
     reconnectTimer = null;
     stopped = false;
+    agentId = null;
     taskHandler = null;
     taskAbortControllers = new Map();
+    activeConversationTasks = new Map(); // conversationId → taskId
+    conversationQueues = new Map(); // conversationId → queued task data
     listeners = {
         connected: [],
         disconnected: [],
@@ -69,7 +74,7 @@ export class ArinovaAgent {
         const httpUrl = this.serverUrl
             .replace(/^ws:/, "http:")
             .replace(/^wss:/, "https:");
-        const res = await fetch(`${httpUrl}/api/agent/send`, {
+        const res = await fetch(`${httpUrl}/api/v1/messages/send`, {
             method: "POST",
             headers: {
                 "Authorization": `Bearer ${this.botToken}`,
@@ -82,6 +87,20 @@ export class ArinovaAgent {
             throw new Error(`sendMessage failed (${res.status}): ${body}`);
         }
     }
+    /**
+     * Send a telemetry event to the server.
+     * Silently no-ops if WebSocket is not connected.
+     */
+    sendTelemetry(event, data) {
+        this.send({ type: "agent_telemetry", event, data });
+    }
+    /**
+     * Send HUD data to the server for display in the office HUD bar.
+     * The server forwards this to the agent owner's frontend.
+     */
+    sendHud(data) {
+        this.send({ type: "hud_update", data });
+    }
     emit(event, ...args) {
         for (const listener of this.listeners[event] ?? []) {
             listener(...args);
@@ -97,6 +116,10 @@ export class ArinovaAgent {
             clearInterval(this.pingTimer);
             this.pingTimer = null;
         }
+        if (this.commandHeartbeatTimer) {
+            clearInterval(this.commandHeartbeatTimer);
+            this.commandHeartbeatTimer = null;
+        }
         if (this.reconnectTimer) {
             clearTimeout(this.reconnectTimer);
             this.reconnectTimer = null;
@@ -108,6 +131,14 @@ export class ArinovaAgent {
             catch { }
             this.ws = null;
         }
+        // Clear queues BEFORE aborting — abort triggers markFinished → processNextTask,
+        // which would dequeue and start tasks during disconnect if queues aren't empty.
+        this.conversationQueues.clear();
+        this.activeConversationTasks.clear();
+        for (const controller of this.taskAbortControllers.values()) {
+            controller.abort();
+        }
+        this.taskAbortControllers.clear();
     }
     scheduleReconnect() {
         if (this.stopped)
@@ -145,7 +176,27 @@ export class ArinovaAgent {
             try {
                 const data = JSON.parse(String(event.data));
                 if (data.type === "auth_ok") {
+                    this.agentId = data.agentId ?? null;
                     this.emit("connected");
+                    // Register SDK runtime commands from skills
+                    if (this.skills.length > 0 && this.agentId) {
+                        this.send({
+                            type: "register_commands",
+                            agentId: this.agentId,
+                            commands: this.skills.map((s) => ({
+                                name: s.id ?? s.name,
+                                description: s.description ?? "",
+                            })),
+                        });
+                    }
+                    // Start heartbeat to extend Redis TTL every 60s
+                    if (this.commandHeartbeatTimer)
+                        clearInterval(this.commandHeartbeatTimer);
+                    if (this.skills.length > 0 && this.agentId) {
+                        this.commandHeartbeatTimer = setInterval(() => {
+                            this.send({ type: "heartbeat_commands", agentId: this.agentId });
+                        }, 60_000);
+                    }
                     // Resolve the connect() promise on first successful auth
                     if (this.connectResolve) {
                         this.connectResolve();
@@ -177,6 +228,17 @@ export class ArinovaAgent {
                 }
                 if (data.type === "cancel_task") {
                     const taskId = data.taskId;
+                    // Check if the task is still queued (not yet started)
+                    for (const [convId, queue] of this.conversationQueues) {
+                        const idx = queue.findIndex((t) => t.taskId === taskId);
+                        if (idx !== -1) {
+                            queue.splice(idx, 1);
+                            if (queue.length === 0)
+                                this.conversationQueues.delete(convId);
+                            return;
+                        }
+                    }
+                    // Active task — abort it (processNextTask will be called via markFinished)
                     const controller = this.taskAbortControllers.get(taskId);
                     if (controller) {
                         controller.abort();
@@ -215,7 +277,7 @@ export class ArinovaAgent {
         formData.append("conversationId", conversationId);
         const blob = new Blob([new Uint8Array(file)], { type: mime });
         formData.append("file", blob, fileName);
-        const res = await fetch(`${httpUrl}/api/agent/upload`, {
+        const res = await fetch(`${httpUrl}/api/v1/files/upload`, {
             method: "POST",
             headers: {
                 Authorization: `Bearer ${this.botToken}`,
@@ -247,7 +309,7 @@ export class ArinovaAgent {
         if (options?.limit != null)
             params.set("limit", String(options.limit));
         const qs = params.toString();
-        const url = `${httpUrl}/api/agent/messages/${conversationId}${qs ? `?${qs}` : ""}`;
+        const url = `${httpUrl}/api/v1/messages/${conversationId}${qs ? `?${qs}` : ""}`;
         const res = await fetch(url, {
             method: "GET",
             headers: {
@@ -274,8 +336,12 @@ export class ArinovaAgent {
             params.set("before", options.before);
         if (options?.limit != null)
             params.set("limit", String(options.limit));
+        if (options?.tags?.length)
+            params.set("tags", options.tags.join(","));
+        if (options?.archived)
+            params.set("archived", "true");
         const qs = params.toString();
-        const url = `${httpUrl}/api/agent/conversations/${conversationId}/notes${qs ? `?${qs}` : ""}`;
+        const url = `${httpUrl}/api/v1/notes${qs ? `?${qs}` : ""}`;
         const res = await fetch(url, {
             method: "GET",
             headers: { Authorization: `Bearer ${this.botToken}` },
@@ -295,7 +361,7 @@ export class ArinovaAgent {
         const httpUrl = this.serverUrl
             .replace(/^ws:/, "http:")
             .replace(/^wss:/, "https:");
-        const res = await fetch(`${httpUrl}/api/agent/conversations/${conversationId}/notes`, {
+        const res = await fetch(`${httpUrl}/api/v1/notes`, {
             method: "POST",
             headers: {
                 Authorization: `Bearer ${this.botToken}`,
@@ -319,7 +385,7 @@ export class ArinovaAgent {
         const httpUrl = this.serverUrl
             .replace(/^ws:/, "http:")
             .replace(/^wss:/, "https:");
-        const res = await fetch(`${httpUrl}/api/agent/conversations/${conversationId}/notes/${noteId}`, {
+        const res = await fetch(`${httpUrl}/api/v1/notes/${noteId}`, {
             method: "PATCH",
             headers: {
                 Authorization: `Bearer ${this.botToken}`,
@@ -342,7 +408,7 @@ export class ArinovaAgent {
         const httpUrl = this.serverUrl
             .replace(/^ws:/, "http:")
             .replace(/^wss:/, "https:");
-        const res = await fetch(`${httpUrl}/api/agent/conversations/${conversationId}/notes/${noteId}`, {
+        const res = await fetch(`${httpUrl}/api/v1/notes/${noteId}`, {
             method: "DELETE",
             headers: { Authorization: `Bearer ${this.botToken}` },
         });
@@ -351,12 +417,621 @@ export class ArinovaAgent {
             throw new Error(`deleteNote failed (${res.status}): ${text}`);
         }
     }
+    // ── Kanban API ────────────────────────────────────────────────
+    /**
+     * List the owner's kanban boards.
+     * Returns an array of boards with id, name, and createdAt.
+     */
+    async listBoards() {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/boards`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`listBoards failed (${res.status}): ${body}`);
+        }
+        return res.json();
+    }
+    /**
+     * Create a kanban card on the owner's board.
+     * The card is automatically assigned to the calling agent.
+     * @param body - Card title and optional description, priority, column.
+     */
+    async createCard(body) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`createCard failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Update a kanban card.
+     * @param cardId - The card ID to update.
+     * @param body - Fields to update (title, description, priority, columnId, sortOrder).
+     */
+    async updateCard(cardId, body) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards/${cardId}`, {
+            method: "PATCH",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`updateCard failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Create a new kanban board.
+     * @param body - Board name and optional initial columns.
+     */
+    async createBoard(body) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/boards`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`createBoard failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Update a kanban board.
+     * @param boardId - The board ID to update.
+     * @param body - Fields to update.
+     */
+    async updateBoard(boardId, body) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/boards/${boardId}`, {
+            method: "PATCH",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`updateBoard failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Archive a kanban board.
+     * @param boardId - The board ID to archive.
+     */
+    async archiveBoard(boardId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/boards/${boardId}/archive`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`archiveBoard failed (${res.status}): ${text}`);
+        }
+    }
+    /**
+     * List columns for a board.
+     * @param boardId - The board ID.
+     */
+    async listColumns(boardId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/boards/${boardId}/columns`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`listColumns failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Create a column in a board.
+     * @param boardId - The board ID.
+     * @param body - Column name and optional sort order.
+     */
+    async createColumn(boardId, body) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/boards/${boardId}/columns`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`createColumn failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Update a column.
+     * @param columnId - The column ID to update.
+     * @param body - Fields to update (name, sortOrder).
+     */
+    async updateColumn(columnId, body) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/columns/${columnId}`, {
+            method: "PATCH",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`updateColumn failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Delete a column.
+     * @param columnId - The column ID to delete.
+     */
+    async deleteColumn(columnId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/columns/${columnId}`, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`deleteColumn failed (${res.status}): ${text}`);
+        }
+    }
+    /**
+     * Reorder columns in a board.
+     * @param boardId - The board ID.
+     * @param columnIds - Ordered array of column IDs.
+     */
+    async reorderColumns(boardId, columnIds) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/boards/${boardId}/columns/reorder`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ columnIds }),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`reorderColumns failed (${res.status}): ${text}`);
+        }
+    }
+    /**
+     * List all kanban cards for the agent's owner.
+     */
+    async listCards() {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`listCards failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Mark a card as complete (moves it to the Done column).
+     * @param cardId - The card ID to complete.
+     */
+    async completeCard(cardId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards/${cardId}/complete`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`completeCard failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * List archived cards for a board.
+     * @param boardId - The board ID.
+     * @param options - Pagination options (page, limit).
+     */
+    async listArchivedCards(boardId, options) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const params = new URLSearchParams();
+        if (options?.page != null)
+            params.set("page", String(options.page));
+        if (options?.limit != null)
+            params.set("limit", String(options.limit));
+        const qs = params.toString();
+        const url = `${httpUrl}/api/v1/kanban/boards/${boardId}/archived-cards${qs ? `?${qs}` : ""}`;
+        const res = await fetch(url, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`listArchivedCards failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Add a commit link to a card.
+     * @param cardId - The card ID.
+     * @param body - Commit hash and optional message.
+     */
+    async addCardCommit(cardId, body) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards/${cardId}/commits`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`addCardCommit failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * List commits linked to a card.
+     * @param cardId - The card ID.
+     */
+    async listCardCommits(cardId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards/${cardId}/commits`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`listCardCommits failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Link a note to a card.
+     * @param cardId - The card ID.
+     * @param noteId - The note ID to link.
+     */
+    async linkCardNote(cardId, noteId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards/${cardId}/notes`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ noteId }),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`linkCardNote failed (${res.status}): ${text}`);
+        }
+    }
+    /**
+     * Unlink a note from a card.
+     * @param cardId - The card ID.
+     * @param noteId - The note ID to unlink.
+     */
+    async unlinkCardNote(cardId, noteId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards/${cardId}/notes/${noteId}`, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`unlinkCardNote failed (${res.status}): ${text}`);
+        }
+    }
+    /**
+     * List notes linked to a card.
+     * @param cardId - The card ID.
+     */
+    async listCardNotes(cardId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards/${cardId}/notes`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`listCardNotes failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    // ── Label API ────────────────────────────────────────────────
+    /**
+     * List labels for a board.
+     * @param boardId - The board ID.
+     */
+    async listLabels(boardId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/boards/${boardId}/labels`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`listLabels failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Create a label on a board.
+     * @param boardId - The board ID.
+     * @param body - Label name and optional color.
+     */
+    async createLabel(boardId, body) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/boards/${boardId}/labels`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`createLabel failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Update a label.
+     * @param labelId - The label ID to update.
+     * @param body - Fields to update (name, color).
+     */
+    async updateLabel(labelId, body) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/labels/${labelId}`, {
+            method: "PATCH",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`updateLabel failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    /**
+     * Delete a label.
+     * @param labelId - The label ID to delete.
+     */
+    async deleteLabel(labelId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/labels/${labelId}`, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`deleteLabel failed (${res.status}): ${text}`);
+        }
+    }
+    /**
+     * Add a label to a card.
+     * @param cardId - The card ID.
+     * @param labelId - The label ID to add.
+     */
+    async addCardLabel(cardId, labelId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards/${cardId}/labels`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.botToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ labelId }),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`addCardLabel failed (${res.status}): ${text}`);
+        }
+    }
+    /**
+     * Remove a label from a card.
+     * @param cardId - The card ID.
+     * @param labelId - The label ID to remove.
+     */
+    async removeCardLabel(cardId, labelId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/kanban/cards/${cardId}/labels/${labelId}`, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`removeCardLabel failed (${res.status}): ${text}`);
+        }
+    }
+    // ── Memory API ───────────────────────────────────────────────
+    /**
+     * Search memories across all memory capsules granted to this agent.
+     * Uses hybrid search (embedding + text) to find relevant memories.
+     * @param options - Query string and optional limit.
+     */
+    async queryMemory(options) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const params = new URLSearchParams();
+        params.set("query", options.query);
+        if (options.limit != null)
+            params.set("limit", String(options.limit));
+        const res = await fetch(`${httpUrl}/api/v1/capsules?${params}`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`queryMemory failed (${res.status}): ${body}`);
+        }
+        // Server returns snake_case, map to camelCase
+        const raw = (await res.json());
+        return raw.map((r) => ({
+            content: r.content,
+            capsuleName: r.capsule_name,
+            capsuleId: r.capsule_id,
+            score: r.score,
+            importance: r.importance,
+        }));
+    }
+    // ── Skill Prompt API ─────────────────────────────────────────
+    /**
+     * Fetch the full prompt content for an installed skill by slug.
+     * Use this when the agent decides to trigger a skill from availableSkills.
+     * @param skillSlug - The skill slug (e.g. "draw", "proactive-agent").
+     */
+    async fetchSkillPrompt(skillSlug) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/skills/${encodeURIComponent(skillSlug)}/prompt`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`fetchSkillPrompt failed (${res.status}): ${body}`);
+        }
+        return (await res.json());
+    }
+    // ── Note Share API ───────────────────────────────────────────
+    /**
+     * Share a note as a message in a conversation.
+     * Creates a rich preview card visible to all conversation members.
+     * @param conversationId - The conversation to share into.
+     * @param noteId - The note ID to share.
+     */
+    async shareNote(conversationId, noteId) {
+        const httpUrl = this.serverUrl
+            .replace(/^ws:/, "http:")
+            .replace(/^wss:/, "https:");
+        const res = await fetch(`${httpUrl}/api/v1/notes/${noteId}/share`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${this.botToken}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`shareNote failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
     handleTask(data) {
+        if (!this.taskHandler)
+            return;
+        const conversationId = data.conversationId;
+        const activeTaskId = this.activeConversationTasks.get(conversationId);
+        // If this conversation already has an active task, queue the new one
+        if (activeTaskId && this.taskAbortControllers.has(activeTaskId)) {
+            let queue = this.conversationQueues.get(conversationId);
+            if (!queue) {
+                queue = [];
+                this.conversationQueues.set(conversationId, queue);
+            }
+            // Overflow: drop oldest queued task when queue is full
+            if (queue.length >= MAX_QUEUE_SIZE) {
+                const dropped = queue.shift();
+                this.send({ type: "agent_error", taskId: dropped.taskId, error: "queue_overflow" });
+            }
+            queue.push(data);
+            return;
+        }
+        this.executeTask(data);
+    }
+    executeTask(data) {
         if (!this.taskHandler)
             return;
         const taskId = data.taskId;
+        const conversationId = data.conversationId;
         const abortController = new AbortController();
         this.taskAbortControllers.set(taskId, abortController);
+        this.activeConversationTasks.set(conversationId, taskId);
         // Auto heartbeat: keep task alive while processing
         const heartbeatTimer = setInterval(() => {
             this.send({ type: "agent_heartbeat", taskId });
@@ -372,11 +1047,13 @@ export class ArinovaAgent {
             taskFinished = true;
             stopHeartbeat();
             this.taskAbortControllers.delete(taskId);
+            this.activeConversationTasks.delete(conversationId);
+            this.processNextTask(conversationId);
             return true;
         };
         const ctx = {
             taskId,
-            conversationId: data.conversationId,
+            conversationId,
             content: data.content,
             conversationType: data.conversationType,
             senderUserId: data.senderUserId,
@@ -406,8 +1083,8 @@ export class ArinovaAgent {
                 this.send({ type: "agent_error", taskId, error });
             },
             signal: abortController.signal,
-            uploadFile: (file, fileName, fileType) => this.uploadFile(data.conversationId, file, fileName, fileType),
-            fetchHistory: (options) => this.fetchHistory(data.conversationId, options),
+            uploadFile: (file, fileName, fileType) => this.uploadFile(conversationId, file, fileName, fileType),
+            fetchHistory: (options) => this.fetchHistory(conversationId, options),
         };
         // When task is aborted (user cancelled), immediately send cancellation
         // error so the server knows this agent is free for new tasks.
@@ -421,6 +1098,17 @@ export class ArinovaAgent {
             ctx.sendError(errorMsg);
         });
     }
+    processNextTask(conversationId) {
+        const queue = this.conversationQueues.get(conversationId);
+        if (!queue || queue.length === 0) {
+            this.conversationQueues.delete(conversationId);
+            return;
+        }
+        const nextTask = queue.shift();
+        if (queue.length === 0)
+            this.conversationQueues.delete(conversationId);
+        this.executeTask(nextTask);
+    }
 }
 const MIME_TYPES = {
     jpg: "image/jpeg",