@teneo-protocol/sdk 1.0.1 → 2.0.0

package/dist/handlers/message-handlers/unsubscribe-response-handler.d.ts

@@ -37,45 +37,67 @@ export declare class UnsubscribeResponseHandler extends BaseMessageHandler<Unsub
             success: boolean;
             subscriptions?: string[] | undefined;
         }>;
-    }, "strip", import("zod").ZodTypeAny, {
-        type: "unsubscribe";
-        data: {
+    }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+        content: import("zod").ZodOptional<import("zod").ZodAny>;
+        content_type: import("zod").ZodOptional<import("zod").ZodEnum<["text/plain", "text/markdown", "text/html", "application/json", "image/*", "STRING", "JSON", "MD", "ARRAY"]>>;
+        from: import("zod").ZodOptional<import("zod").ZodString>;
+        to: import("zod").ZodOptional<import("zod").ZodString>;
+        room: import("zod").ZodOptional<import("zod").ZodString>;
+        timestamp: import("zod").ZodOptional<import("zod").ZodString>;
+        signature: import("zod").ZodOptional<import("zod").ZodString>;
+        publicKey: import("zod").ZodOptional<import("zod").ZodString>;
+        reasoning: import("zod").ZodOptional<import("zod").ZodString>;
+        task_id: import("zod").ZodOptional<import("zod").ZodString>;
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+    } & {
+        type: import("zod").ZodLiteral<"unsubscribe">;
+        data: import("zod").ZodObject<{
+            room_id: import("zod").ZodString;
+            success: import("zod").ZodBoolean;
+            message: import("zod").ZodString;
+            subscriptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, "strip", import("zod").ZodTypeAny, {
+            message: string;
+            room_id: string;
+            success: boolean;
+            subscriptions?: string[] | undefined;
+        }, {
+            message: string;
+            room_id: string;
+            success: boolean;
+            subscriptions?: string[] | undefined;
+        }>;
+    }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+        content: import("zod").ZodOptional<import("zod").ZodAny>;
+        content_type: import("zod").ZodOptional<import("zod").ZodEnum<["text/plain", "text/markdown", "text/html", "application/json", "image/*", "STRING", "JSON", "MD", "ARRAY"]>>;
+        from: import("zod").ZodOptional<import("zod").ZodString>;
+        to: import("zod").ZodOptional<import("zod").ZodString>;
+        room: import("zod").ZodOptional<import("zod").ZodString>;
+        timestamp: import("zod").ZodOptional<import("zod").ZodString>;
+        signature: import("zod").ZodOptional<import("zod").ZodString>;
+        publicKey: import("zod").ZodOptional<import("zod").ZodString>;
+        reasoning: import("zod").ZodOptional<import("zod").ZodString>;
+        task_id: import("zod").ZodOptional<import("zod").ZodString>;
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+    } & {
+        type: import("zod").ZodLiteral<"unsubscribe">;
+        data: import("zod").ZodObject<{
+            room_id: import("zod").ZodString;
+            success: import("zod").ZodBoolean;
+            message: import("zod").ZodString;
+            subscriptions: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        }, "strip", import("zod").ZodTypeAny, {
             message: string;
             room_id: string;
             success: boolean;
             subscriptions?: string[] | undefined;
-        };
-        id?: string | undefined;
-        room?: string | undefined;
-        content?: any;
-        content_type?: "text/plain" | "text/markdown" | "text/html" | "application/json" | "image/*" | "STRING" | "JSON" | "MD" | "ARRAY" | undefined;
-        from?: string | undefined;
-        to?: string | undefined;
-        timestamp?: string | undefined;
-        signature?: string | undefined;
-        publicKey?: string | undefined;
-        reasoning?: string | undefined;
-        task_id?: string | undefined;
-    }, {
-        type: "unsubscribe";
-        data: {
+        }, {
             message: string;
             room_id: string;
             success: boolean;
             subscriptions?: string[] | undefined;
-        };
-        id?: string | undefined;
-        room?: string | undefined;
-        content?: any;
-        content_type?: "text/plain" | "text/markdown" | "text/html" | "application/json" | "image/*" | "STRING" | "JSON" | "MD" | "ARRAY" | undefined;
-        from?: string | undefined;
-        to?: string | undefined;
-        timestamp?: string | undefined;
-        signature?: string | undefined;
-        publicKey?: string | undefined;
-        reasoning?: string | undefined;
-        task_id?: string | undefined;
-    }>;
+        }>;
+    }, import("zod").ZodTypeAny, "passthrough">>;
     protected handleValidated(message: UnsubscribeResponse, context: HandlerContext): void;
 }
 //# sourceMappingURL=unsubscribe-response-handler.d.ts.map

package/dist/handlers/message-handlers/unsubscribe-response-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unsubscribe-response-handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/message-handlers/unsubscribe-response-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAA6B,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,qBAAa,0BAA2B,SAAQ,kBAAkB,CAAC,mBAAmB,CAAC;IACrF,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA6B;IAE5C,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;CAiCvF"}
+{"version":3,"file":"unsubscribe-response-handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/message-handlers/unsubscribe-response-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAA6B,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,qBAAa,0BAA2B,SAAQ,kBAAkB,CAAC,mBAAmB,CAAC;IACrF,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAA6B;IAE5C,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;CAiCvF"}

package/dist/managers/agent-room-manager.d.ts

@@ -0,0 +1,222 @@
+/**
+ * AgentRoomManager - Manages agent-room associations (v2.0.0)
+ * Allows room owners to control which agents are available in their rooms
+ * Implements caching with 5-minute TTL for performance
+ */
+import { EventEmitter } from "eventemitter3";
+import { WebSocketClient } from "../core/websocket-client";
+import { Logger } from "../types";
+import { SDKEvents } from "../types/events";
+import { RoomManagementManager } from "./room-management-manager";
+export interface AgentRoomInfo {
+    agent_id: string;
+    agent_name?: string;
+    description?: string;
+    capabilities?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    commands?: Array<{
+        trigger: string;
+        argument?: string;
+        description?: string;
+    }>;
+    image?: string;
+    status?: string;
+    added_by?: string;
+    added_at?: string;
+}
+export declare class AgentRoomManager extends EventEmitter<SDKEvents> {
+    private readonly wsClient;
+    private readonly logger;
+    private readonly roomManagementManager;
+    private readonly roomAgentsCache;
+    private readonly availableAgentsCache;
+    private readonly roomAgentsCacheTime;
+    private readonly availableAgentsCacheTime;
+    constructor(wsClient: WebSocketClient, logger: Logger, roomManagementManager: RoomManagementManager);
+    /**
+     * Adds an agent to a room, making it available for interactions in that room.
+     * User must own the room to perform this operation.
+     *
+     * @param roomId - ID of the room to add agent to
+     * @param agentId - ID of the agent to add
+     * @returns Promise that resolves when agent is added
+     * @throws {SDKError} If not connected, not room owner, or operation fails
+     *
+     * @example
+     * ```typescript
+     * await sdk.addAgentToRoom('room-123', 'agent-456');
+     * console.log('Agent added to room');
+     * ```
+     */
+    addAgentToRoom(roomId: string, agentId: string): Promise<void>;
+    /**
+     * Removes an agent from a room.
+     * User must own the room to perform this operation.
+     *
+     * @param roomId - ID of the room to remove agent from
+     * @param agentId - ID of the agent to remove
+     * @returns Promise that resolves when agent is removed
+     * @throws {SDKError} If not connected, not room owner, or operation fails
+     *
+     * @example
+     * ```typescript
+     * await sdk.removeAgentFromRoom('room-123', 'agent-456');
+     * console.log('Agent removed from room');
+     * ```
+     */
+    removeAgentFromRoom(roomId: string, agentId: string): Promise<void>;
+    /**
+     * Lists all agents currently in a room.
+     * Results are cached for 5 minutes for performance.
+     *
+     * @param roomId - ID of the room to list agents for
+     * @param useCache - Whether to use cached data (default: true)
+     * @returns Promise that resolves with array of agents
+     * @throws {SDKError} If not connected or operation fails
+     *
+     * @example
+     * ```typescript
+     * const agents = await sdk.listRoomAgents('room-123');
+     * console.log(`Room has ${agents.length} agents`);
+     *
+     * // Force fresh data
+     * const freshAgents = await sdk.listRoomAgents('room-123', false);
+     * ```
+     */
+    listRoomAgents(roomId: string, useCache?: boolean): Promise<AgentRoomInfo[]>;
+    /**
+     * Lists all agents available to add to a room (not yet in the room).
+     * Results are cached for 5 minutes for performance.
+     *
+     * @param roomId - ID of the room to check available agents for
+     * @param useCache - Whether to use cached data (default: true)
+     * @returns Promise that resolves with array of available agents
+     * @throws {SDKError} If not connected or operation fails
+     *
+     * @example
+     * ```typescript
+     * const availableAgents = await sdk.listAvailableAgents('room-123');
+     * console.log(`${availableAgents.length} agents can be added`);
+     * ```
+     */
+    listAvailableAgents(roomId: string, useCache?: boolean): Promise<AgentRoomInfo[]>;
+    /**
+     * Gets agents currently in a room from cache (synchronous).
+     * Returns undefined if not cached or cache expired.
+     *
+     * @param roomId - Room ID to query
+     * @returns Array of agents or undefined if not cached
+     *
+     * @example
+     * ```typescript
+     * const agents = sdk.getRoomAgents('room-123');
+     * if (agents) {
+     *   console.log(`Found ${agents.length} agents in cache`);
+     * }
+     * ```
+     */
+    getRoomAgents(roomId: string): AgentRoomInfo[] | undefined;
+    /**
+     * Gets available agents for a room from cache (synchronous).
+     * Returns undefined if not cached or cache expired.
+     *
+     * @param roomId - Room ID to query
+     * @returns Array of available agents or undefined if not cached
+     *
+     * @example
+     * ```typescript
+     * const available = sdk.getAvailableAgents('room-123');
+     * if (available) {
+     *   console.log(`${available.length} agents can be added`);
+     * }
+     * ```
+     */
+    getAvailableAgents(roomId: string): AgentRoomInfo[] | undefined;
+    /**
+     * Checks if an agent is currently in a room (from cache).
+     * Returns undefined if cache is invalid.
+     *
+     * @param roomId - Room ID to check
+     * @param agentId - Agent ID to check
+     * @returns True if agent in room, false if not, undefined if cache invalid
+     *
+     * @example
+     * ```typescript
+     * const isInRoom = sdk.isAgentInRoom('room-123', 'agent-456');
+     * if (isInRoom === true) {
+     *   console.log('Agent is in this room');
+     * }
+     * ```
+     */
+    isAgentInRoom(roomId: string, agentId: string): boolean | undefined;
+    /**
+     * Gets the count of agents in a room (from cache).
+     * Returns undefined if cache is invalid.
+     *
+     * @param roomId - Room ID to count agents for
+     * @returns Number of agents or undefined if cache invalid
+     *
+     * @example
+     * ```typescript
+     * const count = sdk.getRoomAgentCount('room-123');
+     * if (count !== undefined) {
+     *   console.log(`Room has ${count} agents`);
+     * }
+     * ```
+     */
+    getRoomAgentCount(roomId: string): number | undefined;
+    /**
+     * Manually invalidates all caches for a specific room.
+     * Useful after operations that might have changed agent assignments.
+     *
+     * @param roomId - Room ID to invalidate cache for
+     *
+     * @example
+     * ```typescript
+     * // After bulk operations
+     * sdk.invalidateCache('room-123');
+     * const freshAgents = await sdk.listRoomAgents('room-123', false);
+     * ```
+     */
+    invalidateCache(roomId: string): void;
+    /**
+     * Clears all caches for all rooms.
+     * Called automatically on disconnect.
+     * @internal
+     */
+    clearAllCaches(): void;
+    /**
+     * Handles agent status updates from server.
+     * Invalidates cache when agent status changes.
+     * @internal
+     */
+    handleStatusUpdate(roomId: string, agentId: string, status: string): void;
+    /**
+     * Called by handlers to cache room agents.
+     * @internal
+     */
+    cacheRoomAgents(roomId: string, agents: AgentRoomInfo[]): void;
+    /**
+     * Called by handlers to cache available agents.
+     * @internal
+     */
+    cacheAvailableAgents(roomId: string, agents: AgentRoomInfo[]): void;
+    /**
+     * Checks if cache is still valid (within TTL)
+     */
+    private isCacheValid;
+    /**
+     * Invalidates all caches for a specific room
+     */
+    private invalidateRoomCaches;
+    /**
+     * Verifies user owns the room
+     */
+    private validateRoomId;
+    private validateAgentId;
+    private roomExists;
+    private verifyOwnership;
+}
+//# sourceMappingURL=agent-room-manager.d.ts.map

package/dist/managers/agent-room-manager.d.ts.map

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