@happyvertical/smrt-chat 0.30.0

package/dist/smrt-knowledge.json

@@ -0,0 +1,1507 @@
+{
+  "schemaVersion": 1,
+  "generatedAt": "2026-06-23T01:12:05.520Z",
+  "packageName": "@happyvertical/smrt-chat",
+  "packageVersion": "0.30.0",
+  "sourceManifestPath": "dist/manifest.json",
+  "agentDocPath": "AGENTS.md",
+  "sourceHashes": {
+    "manifest": "60c8eb52b192ffae7154d85d461e13eb8bc29a577fb4348e4d1c7ecdd6c1363d",
+    "packageJson": "c390a11b1e803bc96928ec2700e460859b575a486289a78dcbe4fe4e8659226c",
+    "agents": "e0a8c6788fbd48c2619a353295d4538e9ff6863d483bcd354af522fb7c6a31bc"
+  },
+  "exports": [
+    ".",
+    "./internal/agent-runtime",
+    "./manifest",
+    "./manifest.json",
+    "./playground",
+    "./svelte",
+    "./ui"
+  ],
+  "dependencies": {
+    "@happyvertical/smrt-core": "workspace:*",
+    "@happyvertical/smrt-tenancy": "workspace:*",
+    "@happyvertical/smrt-types": "workspace:*",
+    "@happyvertical/smrt-ui": "workspace:*",
+    "@happyvertical/smrt-agents": "workspace:*",
+    "@happyvertical/smrt-profiles": "workspace:*",
+    "@happyvertical/smrt-vitest": "workspace:*",
+    "@sveltejs/package": "^2.5.7",
+    "@sveltejs/vite-plugin-svelte": "^6.2.4",
+    "@types/node": "25.0.9",
+    "fast-glob": "^3.3.3",
+    "svelte": "^5.18.0",
+    "svelte-check": "^4.3.5",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17"
+  },
+  "smrtDependencies": [
+    "@happyvertical/smrt-agents",
+    "@happyvertical/smrt-core",
+    "@happyvertical/smrt-profiles",
+    "@happyvertical/smrt-tenancy",
+    "@happyvertical/smrt-types",
+    "@happyvertical/smrt-ui",
+    "@happyvertical/smrt-vitest"
+  ],
+  "sdkDependencies": [],
+  "tags": [],
+  "risks": [],
+  "objects": [
+    {
+      "name": "AgentSessionCollection",
+      "qualifiedName": "@happyvertical/smrt-chat:AgentSessionCollection",
+      "collection": "agentsessions",
+      "tableName": "agent_sessions",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "expireStale",
+        "findActiveByParticipant",
+        "findActiveSession",
+        "findByAgent",
+        "findOrCreate"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ChatMessageCollection",
+      "qualifiedName": "@happyvertical/smrt-chat:ChatMessageCollection",
+      "collection": "chatmessages",
+      "tableName": "chat_messages",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "getByAgentSession",
+        "getByRoom",
+        "getByThread",
+        "getLatestPerRoom",
+        "getUnreadCount",
+        "search"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ChatParticipantCollection",
+      "qualifiedName": "@happyvertical/smrt-chat:ChatParticipantCollection",
+      "collection": "chatparticipants",
+      "tableName": "chat_participants",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "countInRoom",
+        "findActiveMembership",
+        "findMembership",
+        "getAdminsInRoom",
+        "getByProfile",
+        "getByRoom",
+        "getOnlineInRoom",
+        "isActiveMember"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ChatReactionCollection",
+      "qualifiedName": "@happyvertical/smrt-chat:ChatReactionCollection",
+      "collection": "chatreactions",
+      "tableName": "chat_reactions",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "getByMessage",
+        "getReactionCounts",
+        "toggle"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ChatRoomCollection",
+      "qualifiedName": "@happyvertical/smrt-chat:ChatRoomCollection",
+      "collection": "chatrooms",
+      "tableName": "chat_rooms",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "findAgentRooms",
+        "findByType",
+        "findDMs",
+        "findOrCreateDM",
+        "findPublic",
+        "search"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ChatThreadCollection",
+      "qualifiedName": "@happyvertical/smrt-chat:ChatThreadCollection",
+      "collection": "chatthreads",
+      "tableName": "chat_threads",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "getActive",
+        "getByRoom",
+        "getUnresolved"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "AgentSession",
+      "qualifiedName": "@happyvertical/smrt-chat:AgentSession",
+      "collection": "agentsessions",
+      "tableName": "agent_sessions",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "agentId",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "participantProfileId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "chatRoomId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ChatRoom",
+          "columnType": "UUID"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "allowedTools",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "sessionContext",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "systemPrompt",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "messageCount",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "totalTokensUsed",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "maxTokens",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "maxMessages",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "lastMessageAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "expiresAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "closedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "participantProfileId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "chatRoomId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ChatRoom",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "close",
+        "expire",
+        "getAllowedTools",
+        "getSessionContext",
+        "getSessionKey",
+        "isActive",
+        "isExpired",
+        "isToolAllowed",
+        "recordMessage",
+        "setAllowedTools",
+        "setSessionContext",
+        "updateSessionContext"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "agentsessions.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:AgentSession",
+          "path": "/agentsessions",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "agentsessions.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:AgentSession",
+          "path": "/agentsessions/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "agentsession_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:AgentSession"
+        },
+        {
+          "kind": "cli",
+          "name": "agentsession_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:AgentSession"
+        },
+        {
+          "kind": "cli",
+          "name": "agentsession_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-chat:AgentSession"
+        },
+        {
+          "kind": "cli",
+          "name": "agentsession_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-chat:AgentSession"
+        },
+        {
+          "kind": "cli",
+          "name": "agentsession_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-chat:AgentSession"
+        },
+        {
+          "kind": "mcp",
+          "name": "agentsession_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:AgentSession"
+        },
+        {
+          "kind": "mcp",
+          "name": "agentsession_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:AgentSession"
+        }
+      ],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ChatMessage",
+      "qualifiedName": "@happyvertical/smrt-chat:ChatMessage",
+      "collection": "chatmessages",
+      "tableName": "chat_messages",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "roomId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ChatRoom",
+          "columnType": "UUID"
+        },
+        {
+          "name": "threadId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ChatThread",
+          "columnType": "UUID"
+        },
+        {
+          "name": "senderProfileId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "agentSessionId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "AgentSession",
+          "columnType": "UUID"
+        },
+        {
+          "name": "content",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "messageType",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "role",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "isEdited",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN"
+        },
+        {
+          "name": "editedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "isDeleted",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN"
+        },
+        {
+          "name": "replyToMessageId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ChatMessage",
+          "columnType": "UUID"
+        },
+        {
+          "name": "metadata",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "toolCallData",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "attachments",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "roomId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ChatRoom",
+          "columnType": "UUID"
+        },
+        {
+          "name": "threadId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ChatThread",
+          "columnType": "UUID"
+        },
+        {
+          "name": "senderProfileId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "agentSessionId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "AgentSession",
+          "columnType": "UUID"
+        },
+        {
+          "name": "replyToMessageId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ChatMessage",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "edit",
+        "getAttachments",
+        "getMetadata",
+        "getPreview",
+        "getToolCallData",
+        "hasAttachments",
+        "isFromAgent",
+        "isSystemMessage",
+        "isToolCall",
+        "isToolResult",
+        "setAttachments",
+        "setMetadata",
+        "setToolCallData",
+        "softDelete"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "chatmessages.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatMessage",
+          "path": "/chatmessages",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "chatmessages.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatMessage",
+          "path": "/chatmessages/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "chatmessage_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatMessage"
+        },
+        {
+          "kind": "cli",
+          "name": "chatmessage_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatMessage"
+        },
+        {
+          "kind": "cli",
+          "name": "chatmessage_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-chat:ChatMessage"
+        },
+        {
+          "kind": "cli",
+          "name": "chatmessage_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-chat:ChatMessage"
+        },
+        {
+          "kind": "cli",
+          "name": "chatmessage_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-chat:ChatMessage"
+        },
+        {
+          "kind": "mcp",
+          "name": "chatmessage_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatMessage"
+        },
+        {
+          "kind": "mcp",
+          "name": "chatmessage_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatMessage"
+        }
+      ],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ChatParticipant",
+      "qualifiedName": "@happyvertical/smrt-chat:ChatParticipant",
+      "collection": "chatparticipants",
+      "tableName": "chat_participants",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "roomId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ChatRoom",
+          "columnType": "UUID"
+        },
+        {
+          "name": "profileId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "role",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "onlineStatus",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "lastReadMessageId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ChatMessage",
+          "columnType": "UUID"
+        },
+        {
+          "name": "lastSeenAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "joinedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "nickname",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "isMuted",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN"
+        },
+        {
+          "name": "isPinned",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "roomId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ChatRoom",
+          "columnType": "UUID"
+        },
+        {
+          "name": "profileId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "lastReadMessageId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ChatMessage",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "isActive",
+        "isAdmin",
+        "isOwner",
+        "leave",
+        "markRead",
+        "setOnline"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "chatparticipants.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatParticipant",
+          "path": "/chatparticipants",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "chatparticipants.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatParticipant",
+          "path": "/chatparticipants/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "chatparticipant_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+        },
+        {
+          "kind": "cli",
+          "name": "chatparticipant_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+        },
+        {
+          "kind": "cli",
+          "name": "chatparticipant_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+        },
+        {
+          "kind": "cli",
+          "name": "chatparticipant_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+        },
+        {
+          "kind": "cli",
+          "name": "chatparticipant_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+        },
+        {
+          "kind": "mcp",
+          "name": "chatparticipant_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+        },
+        {
+          "kind": "mcp",
+          "name": "chatparticipant_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+        }
+      ],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ChatReaction",
+      "qualifiedName": "@happyvertical/smrt-chat:ChatReaction",
+      "collection": "chatreactions",
+      "tableName": "chat_reactions",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "messageId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ChatMessage",
+          "columnType": "UUID"
+        },
+        {
+          "name": "profileId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "emoji",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "messageId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ChatMessage",
+          "columnType": "UUID"
+        },
+        {
+          "name": "profileId",
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "chatreactions.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatReaction",
+          "path": "/chatreactions",
+          "method": "GET"
+        },
+        {
+          "kind": "mcp",
+          "name": "chatreaction_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatReaction"
+        }
+      ],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ChatRoom",
+      "qualifiedName": "@happyvertical/smrt-chat:ChatRoom",
+      "collection": "chatrooms",
+      "tableName": "chat_rooms",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "name",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "description",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "roomType",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "topic",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "avatarUrl",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "isArchived",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN"
+        },
+        {
+          "name": "maxParticipants",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "metadata",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "createdByProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "lastMessageAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "createdByProfileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "archive",
+        "getMetadata",
+        "isActive",
+        "isAgentRoom",
+        "isDM",
+        "isPublic",
+        "setMetadata",
+        "unarchive",
+        "updateMetadata"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "chatrooms.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatRoom",
+          "path": "/chatrooms",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "chatrooms.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatRoom",
+          "path": "/chatrooms/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "chatroom_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatRoom"
+        },
+        {
+          "kind": "cli",
+          "name": "chatroom_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatRoom"
+        },
+        {
+          "kind": "cli",
+          "name": "chatroom_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-chat:ChatRoom"
+        },
+        {
+          "kind": "cli",
+          "name": "chatroom_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-chat:ChatRoom"
+        },
+        {
+          "kind": "cli",
+          "name": "chatroom_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-chat:ChatRoom"
+        },
+        {
+          "kind": "mcp",
+          "name": "chatroom_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatRoom"
+        },
+        {
+          "kind": "mcp",
+          "name": "chatroom_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatRoom"
+        }
+      ],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "ChatThread",
+      "qualifiedName": "@happyvertical/smrt-chat:ChatThread",
+      "collection": "chatthreads",
+      "tableName": "chat_threads",
+      "packageName": "@happyvertical/smrt-chat",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": true,
+          "columnType": "UUID"
+        },
+        {
+          "name": "roomId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ChatRoom",
+          "columnType": "UUID"
+        },
+        {
+          "name": "rootMessageId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ChatMessage",
+          "columnType": "UUID"
+        },
+        {
+          "name": "title",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "isResolved",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN"
+        },
+        {
+          "name": "messageCount",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "lastMessageAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "participantCount",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "roomId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "ChatRoom",
+          "columnType": "UUID"
+        },
+        {
+          "name": "rootMessageId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "ChatMessage",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "reopen",
+        "resolve"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "chatthreads.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatThread",
+          "path": "/chatthreads",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "chatthreads.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatThread",
+          "path": "/chatthreads/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "chatthread_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatThread"
+        },
+        {
+          "kind": "cli",
+          "name": "chatthread_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatThread"
+        },
+        {
+          "kind": "cli",
+          "name": "chatthread_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-chat:ChatThread"
+        },
+        {
+          "kind": "cli",
+          "name": "chatthread_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-chat:ChatThread"
+        },
+        {
+          "kind": "cli",
+          "name": "chatthread_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-chat:ChatThread"
+        },
+        {
+          "kind": "mcp",
+          "name": "chatthread_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-chat:ChatThread"
+        },
+        {
+          "kind": "mcp",
+          "name": "chatthread_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-chat:ChatThread"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    }
+  ],
+  "surfaces": [
+    {
+      "kind": "api",
+      "name": "agentsessions.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:AgentSession",
+      "path": "/agentsessions",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "agentsessions.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:AgentSession",
+      "path": "/agentsessions/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "agentsession_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:AgentSession"
+    },
+    {
+      "kind": "cli",
+      "name": "agentsession_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:AgentSession"
+    },
+    {
+      "kind": "cli",
+      "name": "agentsession_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-chat:AgentSession"
+    },
+    {
+      "kind": "cli",
+      "name": "agentsession_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-chat:AgentSession"
+    },
+    {
+      "kind": "cli",
+      "name": "agentsession_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-chat:AgentSession"
+    },
+    {
+      "kind": "mcp",
+      "name": "agentsession_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:AgentSession"
+    },
+    {
+      "kind": "mcp",
+      "name": "agentsession_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:AgentSession"
+    },
+    {
+      "kind": "api",
+      "name": "chatmessages.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatMessage",
+      "path": "/chatmessages",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "chatmessages.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatMessage",
+      "path": "/chatmessages/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "chatmessage_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatMessage"
+    },
+    {
+      "kind": "cli",
+      "name": "chatmessage_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatMessage"
+    },
+    {
+      "kind": "cli",
+      "name": "chatmessage_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-chat:ChatMessage"
+    },
+    {
+      "kind": "cli",
+      "name": "chatmessage_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-chat:ChatMessage"
+    },
+    {
+      "kind": "cli",
+      "name": "chatmessage_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-chat:ChatMessage"
+    },
+    {
+      "kind": "mcp",
+      "name": "chatmessage_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatMessage"
+    },
+    {
+      "kind": "mcp",
+      "name": "chatmessage_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatMessage"
+    },
+    {
+      "kind": "api",
+      "name": "chatparticipants.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatParticipant",
+      "path": "/chatparticipants",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "chatparticipants.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatParticipant",
+      "path": "/chatparticipants/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "chatparticipant_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+    },
+    {
+      "kind": "cli",
+      "name": "chatparticipant_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+    },
+    {
+      "kind": "cli",
+      "name": "chatparticipant_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+    },
+    {
+      "kind": "cli",
+      "name": "chatparticipant_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+    },
+    {
+      "kind": "cli",
+      "name": "chatparticipant_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+    },
+    {
+      "kind": "mcp",
+      "name": "chatparticipant_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+    },
+    {
+      "kind": "mcp",
+      "name": "chatparticipant_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatParticipant"
+    },
+    {
+      "kind": "api",
+      "name": "chatreactions.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatReaction",
+      "path": "/chatreactions",
+      "method": "GET"
+    },
+    {
+      "kind": "mcp",
+      "name": "chatreaction_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatReaction"
+    },
+    {
+      "kind": "api",
+      "name": "chatrooms.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatRoom",
+      "path": "/chatrooms",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "chatrooms.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatRoom",
+      "path": "/chatrooms/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "chatroom_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatRoom"
+    },
+    {
+      "kind": "cli",
+      "name": "chatroom_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatRoom"
+    },
+    {
+      "kind": "cli",
+      "name": "chatroom_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-chat:ChatRoom"
+    },
+    {
+      "kind": "cli",
+      "name": "chatroom_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-chat:ChatRoom"
+    },
+    {
+      "kind": "cli",
+      "name": "chatroom_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-chat:ChatRoom"
+    },
+    {
+      "kind": "mcp",
+      "name": "chatroom_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatRoom"
+    },
+    {
+      "kind": "mcp",
+      "name": "chatroom_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatRoom"
+    },
+    {
+      "kind": "api",
+      "name": "chatthreads.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatThread",
+      "path": "/chatthreads",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "chatthreads.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatThread",
+      "path": "/chatthreads/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "chatthread_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatThread"
+    },
+    {
+      "kind": "cli",
+      "name": "chatthread_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatThread"
+    },
+    {
+      "kind": "cli",
+      "name": "chatthread_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-chat:ChatThread"
+    },
+    {
+      "kind": "cli",
+      "name": "chatthread_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-chat:ChatThread"
+    },
+    {
+      "kind": "cli",
+      "name": "chatthread_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-chat:ChatThread"
+    },
+    {
+      "kind": "mcp",
+      "name": "chatthread_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-chat:ChatThread"
+    },
+    {
+      "kind": "mcp",
+      "name": "chatthread_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-chat:ChatThread"
+    }
+  ],
+  "prompts": [],
+  "relationshipsV2": {
+    "foreignKeyFields": 10,
+    "crossPackageRefFields": 5,
+    "junctionCollections": 0,
+    "hierarchicalObjects": 0,
+    "polymorphicAssociations": 0,
+    "uuidColumns": 33
+  },
+  "agentDoc": "# @happyvertical/smrt-chat\n\nChat rooms, threads, and agent sessions with app-controlled tool whitelisting.\n\n## Models\n\nInternal models — all mutations go through the membership/owner-checked `ChatService` (S5 #1392). EVERY `@smrt()` model in this package (ChatRoom, ChatMessage, ChatParticipant, ChatThread, ChatReaction, AgentSession) has a READ-ONLY generated REST/MCP surface (`list`/`get` only); `create`/`update`/`delete` are intentionally NOT generated so the raw collection routes cannot skip the service-layer authorization. A structural regression test enumerates the registry to assert no chat model exposes a mutating op.\n\n`ChatService` is a CLOSED FACADE (S5 #1392). The raw collections (`rooms`, `messages`, `participants`, `threads`, `agentSessions`, `reactions`) are ES `#private` fields — they are NOT on the public `ChatService` type and the package index does NOT export the collection classes, so a consumer cannot do `chat.messages.create({senderProfileId, role})` / `new ChatParticipantCollection(...)` to mutate around the authorization. The security-sensitive internals (`#writeMessage`, `#emitAgentReply`, `#enrollParticipant`, `#loadActiveSession`, `#requireActiveMembership`, `#requireRoomAdmin`, `#extractToolName`) are ES `#private` too, so they are unreachable at runtime — TypeScript `private` alone is erased and would leave them callable on the prototype. The agent-reply bridge is a `Symbol`-keyed static (not the old enumerable `_runAgentReply`), reachable only by the module-local `sendAgentReply` that holds the non-exported symbol.\n\n- **ChatRoom**: `roomType` (public/private/dm/agent), `status`, `topic`, `maxParticipants`, `lastMessageAt`. Tenant-scoped (required).\n- **ChatMessage**: shared by users + agents. `role` (user/assistant/system/tool), `messageType` (text/system/action/file/tool_call/tool_result), `toolCallData` JSON. Unified model — no separate agent message type. Tenant-scoped (required).\n- **ChatParticipant**: `role` (owner/admin/member/viewer), `onlineStatus`, `lastReadMessageId`, `isMuted`. Tenant-scoped (required).\n- **ChatThread**: `rootMessageId`, `isResolved`, `messageCount`. Created via `ChatService.startThread()` (member-checked). Tenant-scoped (required).\n- **ChatReaction**: `messageId`, `profileId`, `emoji`. Added/removed via `ChatService.addReaction()`/`removeReaction()` (member-checked, self-keyed). Tenant-scoped (required).\n- **AgentSession**: `agentId` (string ref, not FK), `allowedTools` (JSON string array), `sessionContext` (JSON), `systemPrompt`, limits (`maxTokens`/`maxMessages`/`expiresAt`). Optional tenancy.\n\n## ChatService\n\nEvery public write takes an explicit server-supplied `actorProfileId` (the authenticated principal the route injects) — never a caller-controlled `senderProfileId`/`role` (S5 #1392).\n\nFacade: `sendMessage()` (authors as the actor with `role: 'user'`; room-membership-checked; no caller-supplied sender/role and no public membership-skip), `createRoom()` (acting actor becomes owner — no caller-supplied `createdByProfileId`), `startThread()` (member-checked; optional `rootMessageId` bound to the same room+tenant), `addParticipant()`/`removeParticipant()` (owner/admin-checked; self-leave allowed), `updateRoom()` (owner/admin-checked), `addReaction()`/`removeReaction()` (member-checked, self-keyed), `getOrCreateDM()` (actor must be a DM participant), `createAgentSession()` (acting actor becomes the session participant — no caller-supplied `participantProfileId`; the existing-session room lookup is tenant-bound; optional `sessionKey` scopes session identity to a conversation subject so distinct keys get distinct sessions/rooms and a session opened for one subject is never reused/rewritten for another). Tenant-bound read facade (replaces raw-collection reach-ins; consumers apply their own ownership/context checks on the returned rows): `getAgentSession({agentSessionId, tenantId})`, `findActiveAgentSessions({tenantId, agentId, participantProfileId})`, `getThread({threadId, tenantId})`, `listRoomThreads({roomId, actorProfileId, tenantId})` (membership-gated), `getThreadMessages({threadId, actorProfileId, tenantId, limit?})` (membership-gated, chronological), `getRoomMessages({roomId, actorProfileId, tenantId})`/`getRoomForMember(roomId, actorProfileId, tenantId)` (membership-checked reads gated on the server-supplied `actorProfileId`, never a caller-controlled subject id — confused-deputy avoidance; `tenantId` required), `updateAgentSessionConfig()` (owner-checked; `tenantId` mandatory and bound into the lookup). Agent session messaging is split by authority: `sendAgentUserMessage()` (caller `actorProfileId` must be the session participant; always authored as the participant). The agent-authored reply path `sendAgentReply(service, params)` is an exported **function — NOT a `ChatService` method and NOT on the package index**; it is reachable only via the dedicated `@happyvertical/smrt-chat/internal/agent-runtime` subpath (S5 #1392), so only trusted in-process agent-runtime code that explicitly opts into that subpath can author as the agent. It authors as `session.agentId`, accepts an optional same-room/tenant `threadId`, and gates tool calls fail-closed against `allowedTools`. The shared internal persistence path (`writeMessage`) is private — it alone may author an arbitrary profile/role or skip the membership check, and is unreachable from any route; it also validates every supplied `threadId`/`agentSessionId`/`replyToMessageId` belongs to the SAME room AND tenant (tenant/room-bound lookups) before use, rejecting cross-room/cross-tenant references. Auto-creates rooms/sessions/participants via an internal `enrollParticipant`.\n\n## Agent Tool Whitelisting\n\n`allowedTools` is a JSON array controlled by the consuming app. Fail-closed: an empty/unparseable whitelist permits NO tools. The internal `sendAgentReply(service, params)` function enforces the whitelist before emitting any `tool`/`tool_call` message; a caller cannot supply a `senderProfileId`/`role` to post as the agent, and the function is not reachable from the package index.\n\n## Gotchas\n\n- **sessionContext, not context**: `context` is reserved for slug scoping. Use `getSessionContext()`/`updateSessionContext()` for agent memory.\n- **Agent rooms auto-created**: `roomType: 'agent'`, `maxParticipants` defaults to 2; the agent is enrolled as a member so its replies pass the membership check. `createAgentSession()` re-enrolls the participant AND the agent on the existing-session path, so legacy sessions created before the agent was enrolled self-heal.\n- **Per-subject sessions need `sessionKey`**: `createAgentSession()` reuses ANY active session for the same `(agentId, participantProfileId, tenantId)`. Callers that open separate conversations per subject (e.g. one content-editor session per content id) MUST pass a stable `sessionKey` (stored in `sessionContext.__sessionKey`, read via `AgentSession.getSessionKey()`); otherwise a session opened for one subject is reused and its context overwritten for another, surfacing the wrong room/threads (S5 #1392). A keyed create never reuses a keyless/legacy session.\n- **Session expiry**: check `isActive()` before allowing messages (expiresAt or limit-based)\n- **DM identity**: derived from the deterministic per-tenant `canonicalDmRoomId()` and the authoritative `chat_participants` join, not client metadata; concurrent creates upsert onto one row.\n- **Tenant-bound lookups**: membership/session/DM lookups REQUIRE `tenantId` and always bind it into the WHERE clause (`findActiveMembership`/`isActiveMember`/`findActiveSession` take a required `tenantId`; AgentSession's `null` tenant is an explicit bound scope, not \"any tenant\") so they can never resolve a row from another tenant.\n"
+}