@xalia/agent 0.6.9 → 0.6.11

package/src/chat/server/README.md

@@ -1,127 +0,0 @@
-# Chat Server Design
-
-## 3-Layer Design
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    Transport Layer                          │
-│  ConnectionManager: WebSocket lifecycle, protocol routing   │
-│  - Physical connection management (1 connection = 1 client) │
-│  - User authentication and client-to-user mapping           │
-│  - Message delivery to specific connection sets             │
-└─────────────────────────────────────────────────────────────┘
-                               │
-                               ▼
-┌─────────────────────────────────────────────────────────────┐
-│                   Session Layer                             │
-│  SessionRegistry: User membership and session coordination  │
-│  - User-session membership (Set<userId> per session)        │
-│  - Session instance creation and lifecycle                  │
-│  - Cross-layer message routing and coordination             │
-└─────────────────────────────────────────────────────────────┘
-                               │
-                               ▼
-┌─────────────────────────────────────────────────────────────┐
-│                  Business Logic Layer                       │
-│  Session: Agent interaction and conversation processing     │
-│  - AI Agent and conversation management                     │
-│  - MCP server integration and tool approvals                │
-│  - All communication via MessageBroker interface            │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## Message Flow
-
-**User sends message:**
-
-```
-Client → ConnectionManager → SessionRegistry → Session → MessageBroker → All users' clients
-```
-
-**User joins session:**
-
-```
-Client → ConnectionManager → SessionRegistry.addUserToSession() → Session.onUserJoined() → MessageBroker
-```
-
-## Design Sketch
-
-1. ConnectionManager (Transport Layer)
-
-```typescript
-class ConnectionManager {
-  private connections: Map<connectionId, WebSocketConnection>;
-  private userClients: Map<userId, Set<connectionId>>;
-
-  // Core responsibilities:
-  handleConnection(ws: WebSocket, apiKey: string): Promise<void>;
-  routeMessage(connectionId: string, message: ClientToServer): void;
-  getUserConnections(userId: string): connectionId[];
-  broadcastToConnections(
-    connectionIds: connectionId[],
-    message: ServerToClient,
-  ): void;
-
-  // Delegates session-level messages to SessionRegistry
-}
-```
-
-2. SessionRegistry (Session Layer)
-
-```typescript
-class SessionRegistry {
-  private sessions: Map<sessionId, Session>;
-  private userSessions: Map<userId, Set<sessionId>>;
-  private sessionUsers: Map<sessionId, Set<userId>>;
-
-  // Core responsibilities:
-  createSession(
-    sessionId: string,
-    ownerId: string,
-    agentProfile: AgentProfile,
-  ): Session;
-  addUserToSession(userId: string, sessionId: string): void;
-  removeUserFromSession(userId: string, sessionId: string): void;
-  getSessionUsers(sessionId: string): Set<userId>;
-  processSessionMessage(
-    sessionId: string,
-    userId: string,
-    message: ClientSessionMessage,
-  ): void;
-
-  // Creates and manages Session instances
-  // Single source of truth for user-session membership
-}
-```
-
-3. Session (Business Logic Layer)
-
-```ts
-class Session {
-  private agent: Agent;
-  private messageQueue: AsyncQueue;
-  private messageBroker: MessageBroker; // Injected interface
-
-  // Core responsibilities:
-  processMessage(userId: string, message: ClientToServer): Promise<void>;
-  onUserJoined(userId: string): void;
-  onUserLeft(userId: string): void;
-
-  // All external communication via messageBroker:
-  // - messageBroker.sendToUser()
-  // - messageBroker.queueUserMessageForAgent()
-}
-```
-
-4.  Key Interface: MessageBroker
-
-```ts
-interface MessageBroker {
-  sendToUser(userId: string, message: ServerToClient): void;
-  queueUserMessageForAgent(
-    sessionId: string,
-    userId: string,
-    message: ClientMessage,
-  ): void;
-}
-```