@almadar/std 16.236.0 → 16.238.0

package/behaviors/registry/agent/atoms/std-agent-session.orb

@@ -1,157 +1,121 @@
 {
-  "description": "Wraps session/read-spec + session/write-spec + session/read-history — orbital session data.",
+  "description": "std-agent-session — the persisted conversation with an in-app assistant. Owns AgentMessage rows (role, content, ownerId stamped with the real @user, createdAt). SEND stores the user's message, reloads the thread and emits CONVERSE with the whole conversation, oldest first, for std-agent-tool-loop to answer; REPLIED stores the assistant's reply and redraws; REPLY_FAILED redraws the conversation (the tool loop shows the error). Rows are meant to be private to their owner: owner-scoped access needs an [identity] roster, so the binding organism declares the @read/@create scoping on AgentMessage — this generic atom cannot.",
   "ledger": {
     "entries": {
-      "ent_01KXG04EKX39PHPB9ADMKRXVVH": {
-        "bakedName": "AgentSession",
-        "curName": "AgentSession",
-        "id": "ent_01KXG04EKX39PHPB9ADMKRXVVH",
+      "ent_01M3TYMQH8YF6HGJJVC3GRECJP": {
+        "bakedName": "AgentMessage",
+        "curName": "AgentMessage",
+        "id": "ent_01M3TYMQH8YF6HGJJVC3GRECJP",
         "kind": "entity",
         "owner": "workspace",
         "renames": []
       },
-      "evt_01KXG04EKX125KV7F4JQRFF8BC": {
-        "bakedName": "SPEC_READ",
-        "curName": "SPEC_READ",
-        "id": "evt_01KXG04EKX125KV7F4JQRFF8BC",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01KXG04EKX2J2G30B1BZS1XX5K",
-        "renames": []
-      },
-      "evt_01KXG04EKX1MSK9YFKZ9BEVMMM": {
-        "bakedName": "SPEC_LOAD_FAILED",
-        "curName": "SPEC_LOAD_FAILED",
-        "id": "evt_01KXG04EKX1MSK9YFKZ9BEVMMM",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01KXG04EKXM2CWDTW7V6A103HS",
-        "renames": []
-      },
-      "evt_01KXG04EKX1WXPHFMS8PDEP3V9": {
-        "bakedName": "HISTORY_LOADED",
-        "curName": "HISTORY_LOADED",
-        "id": "evt_01KXG04EKX1WXPHFMS8PDEP3V9",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01KXG04EKXM2CWDTW7V6A103HS",
-        "renames": []
-      },
-      "evt_01KXG04EKX22QYT3DTH7TFSBM3": {
+      "evt_01M3TYMQH81AV51TX8HBD3BVVY": {
         "bakedName": "INIT",
         "curName": "INIT",
-        "id": "evt_01KXG04EKX22QYT3DTH7TFSBM3",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01KXG04EKX2J2G30B1BZS1XX5K",
-        "renames": []
-      },
-      "evt_01KXG04EKX2TZBYC9HCBBPQS7G": {
-        "bakedName": "HISTORY_LOAD_FAILED",
-        "curName": "HISTORY_LOAD_FAILED",
-        "id": "evt_01KXG04EKX2TZBYC9HCBBPQS7G",
+        "id": "evt_01M3TYMQH81AV51TX8HBD3BVVY",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKXM2CWDTW7V6A103HS",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKX3EQVVA8QMNATFKHD": {
-        "bakedName": "RESET",
-        "curName": "RESET",
-        "id": "evt_01KXG04EKX3EQVVA8QMNATFKHD",
+      "evt_01M3TYMQH844NH7EYEBPA4XVG6": {
+        "bakedName": "REPLY_FAILED",
+        "curName": "REPLY_FAILED",
+        "id": "evt_01M3TYMQH844NH7EYEBPA4XVG6",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKX2J2G30B1BZS1XX5K",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKX3H1EN73B8HMFXN1P": {
-        "bakedName": "SPEC_LOADED",
-        "curName": "SPEC_LOADED",
-        "id": "evt_01KXG04EKX3H1EN73B8HMFXN1P",
+      "evt_01M3TYMQH87CAV0ETMWW6P6W6P": {
+        "bakedName": "SEND",
+        "curName": "SEND",
+        "id": "evt_01M3TYMQH87CAV0ETMWW6P6W6P",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKXM2CWDTW7V6A103HS",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKX5A8JT97Q39HC4E4K": {
-        "bakedName": "SPEC_READ",
-        "curName": "SPEC_READ",
-        "id": "evt_01KXG04EKX5A8JT97Q39HC4E4K",
+      "evt_01M3TYMQH87K7NK4H6DHKPYPM6": {
+        "bakedName": "AgentMessagesLoaded",
+        "curName": "AgentMessagesLoaded",
+        "id": "evt_01M3TYMQH87K7NK4H6DHKPYPM6",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKXM2CWDTW7V6A103HS",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKX5ASR4H9E1B20EQD4": {
-        "bakedName": "RESET",
-        "curName": "RESET",
-        "id": "evt_01KXG04EKX5ASR4H9E1B20EQD4",
+      "evt_01M3TYMQH8ACSRY02P4HWBHJWV": {
+        "bakedName": "AgentMessageSaved",
+        "curName": "AgentMessageSaved",
+        "id": "evt_01M3TYMQH8ACSRY02P4HWBHJWV",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKXJY0PEPEH24A09MN2",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKX5K2E6MVGTQ98DVX8": {
-        "bakedName": "INIT",
-        "curName": "INIT",
-        "id": "evt_01KXG04EKX5K2E6MVGTQ98DVX8",
+      "evt_01M3TYMQH8BHTWREJV617WFH68": {
+        "bakedName": "AgentMessagesLoadFailed",
+        "curName": "AgentMessagesLoadFailed",
+        "id": "evt_01M3TYMQH8BHTWREJV617WFH68",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKXJY0PEPEH24A09MN2",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKX8WQZEZJ0A6XFEAFH": {
-        "bakedName": "RESET",
-        "curName": "RESET",
-        "id": "evt_01KXG04EKX8WQZEZJ0A6XFEAFH",
+      "evt_01M3TYMQH8CEE16439Z6N25V08": {
+        "bakedName": "AgentMessageSaveFailed",
+        "curName": "AgentMessageSaveFailed",
+        "id": "evt_01M3TYMQH8CEE16439Z6N25V08",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKXM2CWDTW7V6A103HS",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKXADQDWCRA4DFQ1FTC": {
-        "bakedName": "READ_SPEC",
-        "curName": "READ_SPEC",
-        "id": "evt_01KXG04EKXADQDWCRA4DFQ1FTC",
+      "evt_01M3TYMQH8CS3YHB2R90D5J678": {
+        "bakedName": "CONVERSE",
+        "curName": "CONVERSE",
+        "id": "evt_01M3TYMQH8CS3YHB2R90D5J678",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKXM2CWDTW7V6A103HS",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKXGEKJBQ6QMY8GWE40": {
-        "bakedName": "SPEC_WRITTEN",
-        "curName": "SPEC_WRITTEN",
-        "id": "evt_01KXG04EKXGEKJBQ6QMY8GWE40",
+      "evt_01M3TYMQH8H65NTWP1KYX7WM6C": {
+        "bakedName": "AgentConversationLoaded",
+        "curName": "AgentConversationLoaded",
+        "id": "evt_01M3TYMQH8H65NTWP1KYX7WM6C",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKXJY0PEPEH24A09MN2",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKXGYJ1FH125MS53CJ6": {
-        "bakedName": "INIT",
-        "curName": "INIT",
-        "id": "evt_01KXG04EKXGYJ1FH125MS53CJ6",
+      "evt_01M3TYMQH8HHGS90VQR6Y0RK1K": {
+        "bakedName": "EDIT_MESSAGE",
+        "curName": "EDIT_MESSAGE",
+        "id": "evt_01M3TYMQH8HHGS90VQR6Y0RK1K",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKXM2CWDTW7V6A103HS",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKXQ3012NS749R8GSQS": {
-        "bakedName": "WRITE_SPEC",
-        "curName": "WRITE_SPEC",
-        "id": "evt_01KXG04EKXQ3012NS749R8GSQS",
+      "evt_01M3TYMQH8PJZ22902FWBBMMK4": {
+        "bakedName": "REPLIED",
+        "curName": "REPLIED",
+        "id": "evt_01M3TYMQH8PJZ22902FWBBMMK4",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKXJY0PEPEH24A09MN2",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
-      "evt_01KXG04EKXQ3CQQP3ZEY0K9CZD": {
-        "bakedName": "SPEC_WRITTEN",
-        "curName": "SPEC_WRITTEN",
-        "id": "evt_01KXG04EKXQ3CQQP3ZEY0K9CZD",
+      "evt_01M3TYMQH8RCRDSVZ3DQ6DZ2YF": {
+        "bakedName": "SEND_DRAFT",
+        "curName": "SEND_DRAFT",
+        "id": "evt_01M3TYMQH8RCRDSVZ3DQ6DZ2YF",
         "kind": "event",
         "owner": "workspace",
-        "parent": "trt_01KXG04EKX2J2G30B1BZS1XX5K",
+        "parent": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "renames": []
       },
       "orb_01KXG04EKXYAHSWY6RJPZ81FXF": {
@@ -170,26 +134,10 @@
         "owner": "workspace",
         "renames": []
       },
-      "trt_01KXG04EKX2J2G30B1BZS1XX5K": {
-        "bakedName": "SessionListener",
-        "curName": "SessionListener",
-        "id": "trt_01KXG04EKX2J2G30B1BZS1XX5K",
-        "kind": "trait",
-        "owner": "workspace",
-        "renames": []
-      },
-      "trt_01KXG04EKXJY0PEPEH24A09MN2": {
-        "bakedName": "SessionWriter",
-        "curName": "SessionWriter",
-        "id": "trt_01KXG04EKXJY0PEPEH24A09MN2",
-        "kind": "trait",
-        "owner": "workspace",
-        "renames": []
-      },
-      "trt_01KXG04EKXM2CWDTW7V6A103HS": {
-        "bakedName": "SessionReader",
-        "curName": "SessionReader",
-        "id": "trt_01KXG04EKXM2CWDTW7V6A103HS",
+      "trt_01M3TYMQH8QP9883EWJYRT49M8": {
+        "bakedName": "AgentThread",
+        "curName": "AgentThread",
+        "id": "trt_01M3TYMQH8QP9883EWJYRT49M8",
         "kind": "trait",
         "owner": "workspace",
         "renames": []
@@ -201,78 +149,56 @@
   "orbitals": [
     {
       "entity": {
+        "collection": "agentMessages",
         "fields": [
           {
-            "default": "",
-            "name": "orbitalName",
+            "name": "id",
+            "required": true,
             "type": "string"
           },
           {
-            "default": {},
-            "name": "spec",
-            "properties": {
-              "deltaPrompt": {
-                "name": "deltaPrompt",
-                "required": true,
-                "type": "string"
-              },
-              "method": {
-                "name": "method",
-                "required": true,
-                "type": "string"
-              },
-              "orbitalName": {
-                "name": "orbitalName",
-                "required": false,
-                "type": "string"
-              },
-              "organism": {
-                "name": "organism",
-                "required": true,
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "default": [],
-            "items": {
-              "properties": {
-                "content": {
-                  "name": "content",
-                  "required": true,
-                  "type": "string"
-                },
-                "role": {
-                  "name": "role",
-                  "required": true,
-                  "type": "string"
-                },
-                "timestamp": {
-                  "name": "timestamp",
-                  "required": false,
-                  "type": "number"
-                }
-              },
-              "type": "object"
-            },
-            "name": "history",
-            "type": "array"
+            "description": "Whose conversation this message belongs to (the real @user). The binding organism scopes @read to it.",
+            "name": "ownerId",
+            "required": true,
+            "synonyms": "user, owner, account",
+            "type": "string"
           },
           {
-            "default": "idle",
-            "name": "status",
+            "default": "user",
+            "description": "Who said it.",
+            "name": "role",
+            "synonyms": "speaker, author",
             "type": "string",
             "values": [
-              "idle",
-              "read",
-              "written"
+              "user",
+              "assistant"
             ]
+          },
+          {
+            "description": "What was said.",
+            "name": "content",
+            "required": true,
+            "synonyms": "text, message, body",
+            "type": "string"
+          },
+          {
+            "default": 0.0,
+            "description": "When it was said (ms).",
+            "name": "createdAt",
+            "synonyms": "time, timestamp",
+            "type": "number"
+          },
+          {
+            "default": "",
+            "description": "The message being typed.",
+            "intrinsic": true,
+            "name": "draft",
+            "type": "string"
           }
         ],
-        "id": "ent_01KXG04EKX39PHPB9ADMKRXVVH",
-        "name": "AgentSession",
-        "persistence": "runtime"
+        "id": "ent_01M3TYMQH8YF6HGJJVC3GRECJP",
+        "name": "AgentMessage",
+        "persistence": "persistent"
       },
       "id": "orb_01KXG04EKXYAHSWY6RJPZ81FXF",
       "name": "AgentSessionOrbital",
@@ -283,89 +209,122 @@
           "path": "/agent-session",
           "traits": [
             {
-              "ref": "SessionReader",
-              "refId": "trt_01KXG04EKXM2CWDTW7V6A103HS"
-            },
-            {
-              "ref": "SessionWriter",
-              "refId": "trt_01KXG04EKXJY0PEPEH24A09MN2"
-            },
-            {
-              "ref": "SessionListener",
-              "refId": "trt_01KXG04EKX2J2G30B1BZS1XX5K"
+              "ref": "AgentThread",
+              "refId": "trt_01M3TYMQH8QP9883EWJYRT49M8"
             }
           ]
         }
       ],
       "traits": [
         {
-          "category": "lifecycle",
-          "effectRow": [
-            {
-              "kind": "emit",
-              "resource": "SPEC_READ"
+          "category": "interaction",
+          "config": {
+            "links": {
+              "default": [],
+              "description": "Related pages (e.g. the run history), shown under the title.",
+              "items": {
+                "properties": {
+                  "href": {
+                    "name": "href",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Links above the conversation",
+              "tier": "presentation",
+              "type": "[AgentLink]"
             },
-            {
-              "kind": "session/read-history"
+            "placeholder": {
+              "default": "Ask the assistant…",
+              "label": "Message placeholder",
+              "tier": "presentation",
+              "type": "string"
             },
+            "title": {
+              "default": "Assistant",
+              "description": "Heading above the conversation.",
+              "label": "Title",
+              "tier": "presentation",
+              "type": "string"
+            }
+          },
+          "effectRow": [
             {
-              "kind": "session/read-spec"
+              "kind": "emit",
+              "resource": "CONVERSE"
             },
             {
-              "kind": "set",
-              "resource": "@entity.history"
+              "kind": "fetch",
+              "resource": "AgentMessage"
             },
             {
-              "kind": "set",
-              "resource": "@entity.orbitalName"
+              "kind": "persist",
+              "resource": "AgentMessage"
             },
             {
-              "kind": "set",
-              "resource": "@entity.spec"
+              "kind": "render-ui",
+              "resource": "main"
             },
             {
               "kind": "set",
-              "resource": "@entity.status"
+              "resource": "@entity.draft"
             }
           ],
           "emits": [
             {
-              "event": "SPEC_READ",
-              "eventId": "evt_01KXG04EKX5A8JT97Q39HC4E4K",
+              "description": "The conversation to answer, oldest first; the last turn is the request.",
+              "event": "CONVERSE",
+              "eventId": "evt_01M3TYMQH8CS3YHB2R90D5J678",
               "payloadSchema": [
                 {
-                  "name": "spec",
+                  "entity": "AgentChatMessage",
+                  "name": "messages",
                   "properties": [
                     {
-                      "name": "orbitalName",
+                      "name": "role",
                       "type": "string"
                     },
                     {
-                      "name": "organism",
+                      "name": "content",
                       "required": true,
                       "type": "string"
-                    },
+                    }
+                  ],
+                  "required": true,
+                  "type": "[object]"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "ask, converse, request",
+              "tier": "domain"
+            },
+            {
+              "event": "AgentConversationLoaded",
+              "eventId": "evt_01M3TYMQH8H65NTWP1KYX7WM6C",
+              "payloadSchema": [
+                {
+                  "entity": "AgentMessage",
+                  "name": "data",
+                  "properties": [
                     {
-                      "name": "method",
+                      "name": "id",
                       "required": true,
                       "type": "string"
                     },
                     {
-                      "name": "deltaPrompt",
+                      "name": "ownerId",
                       "required": true,
                       "type": "string"
-                    }
-                  ],
-                  "required": true,
-                  "type": "object"
-                },
-                {
-                  "entity": "HistoryEntry",
-                  "name": "history",
-                  "properties": [
+                    },
                     {
                       "name": "role",
-                      "required": true,
                       "type": "string"
                     },
                     {
@@ -374,58 +333,41 @@
                       "type": "string"
                     },
                     {
-                      "name": "timestamp",
+                      "name": "createdAt",
                       "type": "number"
+                    },
+                    {
+                      "name": "draft",
+                      "type": "string"
                     }
                   ],
-                  "required": true,
                   "type": "[object]"
                 }
-              ]
+              ],
+              "scope": "internal",
+              "tier": "internal"
             },
             {
-              "event": "SPEC_LOADED",
-              "eventId": "evt_01KXG04EKX3H1EN73B8HMFXN1P",
+              "description": "The conversation finished loading.",
+              "event": "AgentMessagesLoaded",
+              "eventId": "evt_01M3TYMQH87K7NK4H6DHKPYPM6",
               "payloadSchema": [
                 {
-                  "name": "result",
+                  "entity": "AgentMessage",
+                  "name": "data",
                   "properties": [
                     {
-                      "name": "orbitalName",
-                      "type": "string"
-                    },
-                    {
-                      "name": "organism",
+                      "name": "id",
                       "required": true,
                       "type": "string"
                     },
                     {
-                      "name": "method",
+                      "name": "ownerId",
                       "required": true,
                       "type": "string"
                     },
-                    {
-                      "name": "deltaPrompt",
-                      "required": true,
-                      "type": "string"
-                    }
-                  ],
-                  "required": true,
-                  "type": "object"
-                }
-              ]
-            },
-            {
-              "event": "HISTORY_LOADED",
-              "eventId": "evt_01KXG04EKX1WXPHFMS8PDEP3V9",
-              "payloadSchema": [
-                {
-                  "entity": "HistoryEntry",
-                  "name": "result",
-                  "properties": [
                     {
                       "name": "role",
-                      "required": true,
                       "type": "string"
                     },
                     {
@@ -434,755 +376,876 @@
                       "type": "string"
                     },
                     {
-                      "name": "timestamp",
+                      "name": "createdAt",
                       "type": "number"
+                    },
+                    {
+                      "name": "draft",
+                      "type": "string"
                     }
                   ],
-                  "required": true,
                   "type": "[object]"
                 }
-              ]
+              ],
+              "tier": "internal"
+            },
+            {
+              "event": "AgentMessagesLoadFailed",
+              "eventId": "evt_01M3TYMQH8BHTWREJV617WFH68",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "code",
+                  "type": "string"
+                }
+              ],
+              "tier": "internal"
+            },
+            {
+              "description": "A message persisted — payload is the created AgentMessage row itself.",
+              "event": "AgentMessageSaved",
+              "eventId": "evt_01M3TYMQH8ACSRY02P4HWBHJWV",
+              "payloadEntity": "AgentMessage",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "ownerId",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "role",
+                  "type": "string"
+                },
+                {
+                  "name": "content",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "number"
+                },
+                {
+                  "name": "draft",
+                  "type": "string"
+                }
+              ],
+              "scope": "internal",
+              "tier": "internal"
+            },
+            {
+              "event": "AgentMessageSaveFailed",
+              "eventId": "evt_01M3TYMQH8CEE16439Z6N25V08",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "code",
+                  "type": "string"
+                }
+              ],
+              "tier": "internal"
+            },
+            {
+              "description": "The message being typed changed.",
+              "event": "EDIT_MESSAGE",
+              "eventId": "evt_01M3TYMQH8HHGS90VQR6Y0RK1K",
+              "payloadSchema": [
+                {
+                  "name": "value",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "tier": "presentation"
+            },
+            {
+              "description": "Send the typed message.",
+              "event": "SEND_DRAFT",
+              "eventId": "evt_01M3TYMQH8RCRDSVZ3DQ6DZ2YF",
+              "synonyms": "send, ask, submit",
+              "tier": "domain"
             }
           ],
+          "entityContract": {
+            "provides": [
+              "draft"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
           "entityRefIds": {
-            "AgentSession": "ent_01KXG04EKX39PHPB9ADMKRXVVH"
+            "AgentMessage": "ent_01M3TYMQH8YF6HGJJVC3GRECJP"
           },
-          "id": "trt_01KXG04EKXM2CWDTW7V6A103HS",
-          "linkedEntity": "AgentSession",
-          "linkedEntityId": "ent_01KXG04EKX39PHPB9ADMKRXVVH",
-          "name": "SessionReader",
-          "scope": "instance",
+          "id": "trt_01M3TYMQH8QP9883EWJYRT49M8",
+          "linkedEntity": "AgentMessage",
+          "linkedEntityId": "ent_01M3TYMQH8YF6HGJJVC3GRECJP",
+          "name": "AgentThread",
+          "scope": "collection",
           "stateMachine": {
             "events": [
               {
-                "id": "evt_01KXG04EKXGYJ1FH125MS53CJ6",
+                "id": "evt_01M3TYMQH81AV51TX8HBD3BVVY",
                 "key": "INIT",
                 "name": "Initialize"
               },
               {
-                "id": "evt_01KXG04EKXADQDWCRA4DFQ1FTC",
-                "key": "READ_SPEC",
-                "name": "Read Spec",
-                "payloadSchema": [
-                  {
-                    "name": "orbitalName",
-                    "required": true,
-                    "type": "string"
-                  }
-                ]
-              },
-              {
-                "id": "evt_01KXG04EKX3H1EN73B8HMFXN1P",
-                "key": "SPEC_LOADED",
-                "name": "Spec Loaded",
+                "description": "The conversation finished loading.",
+                "id": "evt_01M3TYMQH87K7NK4H6DHKPYPM6",
+                "key": "AgentMessagesLoaded",
+                "name": "AgentMessage s loaded",
                 "payloadSchema": [
                   {
-                    "name": "result",
+                    "entity": "AgentMessage",
+                    "name": "data",
                     "properties": [
                       {
-                        "name": "orbitalName",
+                        "name": "id",
+                        "required": true,
                         "type": "string"
                       },
                       {
-                        "name": "organism",
+                        "name": "ownerId",
                         "required": true,
                         "type": "string"
                       },
                       {
-                        "name": "method",
-                        "required": true,
+                        "name": "role",
                         "type": "string"
                       },
                       {
-                        "name": "deltaPrompt",
+                        "name": "content",
                         "required": true,
                         "type": "string"
+                      },
+                      {
+                        "name": "createdAt",
+                        "type": "number"
+                      },
+                      {
+                        "name": "draft",
+                        "type": "string"
                       }
                     ],
+                    "type": "[object]"
+                  }
+                ],
+                "tier": "internal"
+              },
+              {
+                "id": "evt_01M3TYMQH8BHTWREJV617WFH68",
+                "key": "AgentMessagesLoadFailed",
+                "name": "AgentMessage s load failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "type": "string"
+                  },
+                  {
+                    "name": "code",
+                    "type": "string"
+                  }
+                ],
+                "tier": "internal"
+              },
+              {
+                "description": "The message being typed changed.",
+                "id": "evt_01M3TYMQH8HHGS90VQR6Y0RK1K",
+                "key": "EDIT_MESSAGE",
+                "name": "Edit Message",
+                "payloadSchema": [
+                  {
+                    "name": "value",
                     "required": true,
-                    "type": "object"
+                    "type": "string"
                   }
-                ]
+                ],
+                "tier": "presentation"
               },
               {
-                "id": "evt_01KXG04EKX1MSK9YFKZ9BEVMMM",
-                "key": "SPEC_LOAD_FAILED",
-                "name": "Spec Load Failed"
+                "description": "Send the typed message.",
+                "id": "evt_01M3TYMQH8RCRDSVZ3DQ6DZ2YF",
+                "key": "SEND_DRAFT",
+                "name": "Send Draft",
+                "synonyms": "send, ask, submit",
+                "tier": "domain"
               },
               {
-                "id": "evt_01KXG04EKX1WXPHFMS8PDEP3V9",
-                "key": "HISTORY_LOADED",
-                "name": "History Loaded",
+                "description": "Ask the assistant something.",
+                "id": "evt_01M3TYMQH87CAV0ETMWW6P6W6P",
+                "key": "SEND",
+                "name": "Send",
                 "payloadSchema": [
                   {
-                    "entity": "HistoryEntry",
-                    "name": "result",
-                    "properties": [
-                      {
-                        "name": "role",
-                        "required": true,
-                        "type": "string"
-                      },
-                      {
-                        "name": "content",
-                        "required": true,
-                        "type": "string"
-                      },
-                      {
-                        "name": "timestamp",
-                        "type": "number"
-                      }
-                    ],
+                    "name": "message",
                     "required": true,
-                    "type": "[object]"
+                    "type": "string"
                   }
-                ]
+                ],
+                "synonyms": "ask, message, chat"
               },
               {
-                "id": "evt_01KXG04EKX2TZBYC9HCBBPQS7G",
-                "key": "HISTORY_LOAD_FAILED",
-                "name": "History Load Failed"
+                "description": "The assistant answered.",
+                "id": "evt_01M3TYMQH8PJZ22902FWBBMMK4",
+                "key": "REPLIED",
+                "name": "Replied",
+                "payloadSchema": [
+                  {
+                    "name": "reply",
+                    "required": true,
+                    "type": "string"
+                  }
+                ]
               },
               {
-                "id": "evt_01KXG04EKX8WQZEZJ0A6XFEAFH",
-                "key": "RESET",
-                "name": "Reset"
+                "description": "The assistant could not answer.",
+                "id": "evt_01M3TYMQH844NH7EYEBPA4XVG6",
+                "key": "REPLY_FAILED",
+                "name": "Reply Failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ]
               },
               {
-                "id": "evt_01KXG04EKX5A8JT97Q39HC4E4K",
-                "key": "SPEC_READ",
-                "name": "Spec Read",
+                "description": "A message persisted — payload is the created AgentMessage row itself.",
+                "id": "evt_01M3TYMQH8ACSRY02P4HWBHJWV",
+                "key": "AgentMessageSaved",
+                "name": "AgentMessage saved",
+                "payloadEntity": "AgentMessage",
                 "payloadSchema": [
                   {
-                    "name": "spec",
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "ownerId",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "role",
+                    "type": "string"
+                  },
+                  {
+                    "name": "content",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "createdAt",
+                    "type": "number"
+                  },
+                  {
+                    "name": "draft",
+                    "type": "string"
+                  }
+                ],
+                "tier": "internal"
+              },
+              {
+                "id": "evt_01M3TYMQH8H65NTWP1KYX7WM6C",
+                "key": "AgentConversationLoaded",
+                "name": "Agent conversation loaded",
+                "payloadSchema": [
+                  {
+                    "entity": "AgentMessage",
+                    "name": "data",
                     "properties": [
                       {
-                        "name": "orbitalName",
+                        "name": "id",
+                        "required": true,
                         "type": "string"
                       },
                       {
-                        "name": "organism",
+                        "name": "ownerId",
                         "required": true,
                         "type": "string"
                       },
                       {
-                        "name": "method",
-                        "required": true,
+                        "name": "role",
                         "type": "string"
                       },
                       {
-                        "name": "deltaPrompt",
+                        "name": "content",
                         "required": true,
                         "type": "string"
+                      },
+                      {
+                        "name": "createdAt",
+                        "type": "number"
+                      },
+                      {
+                        "name": "draft",
+                        "type": "string"
                       }
                     ],
-                    "required": true,
-                    "type": "object"
+                    "type": "[object]"
+                  }
+                ],
+                "tier": "internal"
+              },
+              {
+                "id": "evt_01M3TYMQH8CEE16439Z6N25V08",
+                "key": "AgentMessageSaveFailed",
+                "name": "AgentMessage save failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "type": "string"
                   },
                   {
-                    "entity": "HistoryEntry",
-                    "name": "history",
+                    "name": "code",
+                    "type": "string"
+                  }
+                ],
+                "tier": "internal"
+              },
+              {
+                "description": "The conversation to answer, oldest first; the last turn is the request.",
+                "id": "evt_01M3TYMQH8CS3YHB2R90D5J678",
+                "key": "CONVERSE",
+                "name": "Converse",
+                "payloadSchema": [
+                  {
+                    "entity": "AgentChatMessage",
+                    "name": "messages",
                     "properties": [
                       {
                         "name": "role",
-                        "required": true,
                         "type": "string"
                       },
                       {
                         "name": "content",
                         "required": true,
                         "type": "string"
-                      },
-                      {
-                        "name": "timestamp",
-                        "type": "number"
                       }
                     ],
                     "required": true,
                     "type": "[object]"
                   }
-                ]
+                ],
+                "synonyms": "ask, converse, request",
+                "tier": "domain"
               }
             ],
             "states": [
               {
                 "isInitial": true,
-                "name": "idle"
-              },
-              {
-                "name": "reading"
+                "name": "loading"
               },
               {
-                "name": "loadingHistory"
+                "name": "chatting"
               },
               {
-                "name": "read"
+                "name": "waiting"
               }
             ],
             "transitions": [
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.orbitalName",
-                    ""
-                  ],
-                  [
-                    "set",
-                    "@entity.spec",
-                    {}
-                  ],
-                  [
-                    "set",
-                    "@entity.history",
-                    []
+                    "fetch",
+                    "AgentMessage",
+                    {
+                      "emit": {
+                        "failure": "AgentMessagesLoadFailed",
+                        "success": "AgentMessagesLoaded"
+                      }
+                    }
                   ],
                   [
-                    "set",
-                    "@entity.status",
-                    "idle"
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "type": "skeleton",
+                          "variant": "header"
+                        },
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "list"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "type": "stack"
+                    }
                   ]
                 ],
                 "event": "INIT",
-                "eventId": "evt_01KXG04EKXGYJ1FH125MS53CJ6",
-                "from": "idle",
-                "to": "idle"
+                "eventId": "evt_01M3TYMQH81AV51TX8HBD3BVVY",
+                "from": "loading",
+                "to": "loading"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.orbitalName",
-                    "@payload.orbitalName"
-                  ],
-                  [
-                    "session/read-spec",
-                    "@entity.orbitalName",
+                    "render-ui",
+                    "main",
                     {
-                      "emit": {
-                        "failure": "SPEC_LOAD_FAILED",
-                        "success": "SPEC_LOADED"
-                      }
+                      "children": [
+                        {
+                          "content": "@config.title",
+                          "type": "typography",
+                          "variant": "h4"
+                        },
+                        {
+                          "children": [
+                            "array/map",
+                            "@config.links",
+                            [
+                              "fn",
+                              "item",
+                              {
+                                "href": "@item.href",
+                                "label": "@item.label",
+                                "type": "button",
+                                "variant": "ghost"
+                              }
+                            ]
+                          ],
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "type": "stack"
+                        },
+                        {
+                          "entity": [
+                            "array/sort",
+                            "@payload.data",
+                            "createdAt",
+                            "asc"
+                          ],
+                          "fields": [],
+                          "gap": "sm",
+                          "renderItem": [
+                            "fn",
+                            "item",
+                            {
+                              "children": [
+                                {
+                                  "label": "@item.role",
+                                  "size": "sm",
+                                  "type": "badge",
+                                  "variant": "neutral"
+                                },
+                                {
+                                  "content": "@item.content",
+                                  "type": "typography",
+                                  "variant": "body"
+                                }
+                              ],
+                              "direction": "vertical",
+                              "gap": "xs",
+                              "type": "stack"
+                            }
+                          ],
+                          "type": "data-list"
+                        },
+                        {
+                          "children": [
+                            {
+                              "aria-label": "Message",
+                              "onChange": "EDIT_MESSAGE",
+                              "placeholder": "@config.placeholder",
+                              "type": "textarea"
+                            },
+                            {
+                              "action": "SEND_DRAFT",
+                              "icon": "send",
+                              "label": "Send",
+                              "type": "button",
+                              "variant": "primary"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "type": "stack"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
                     }
                   ]
                 ],
-                "event": "READ_SPEC",
-                "eventId": "evt_01KXG04EKXADQDWCRA4DFQ1FTC",
-                "from": "idle",
-                "to": "reading"
+                "event": "AgentMessagesLoaded",
+                "eventId": "evt_01M3TYMQH87K7NK4H6DHKPYPM6",
+                "from": "loading",
+                "to": "chatting"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.spec",
-                    "@payload.result"
-                  ],
-                  [
-                    "session/read-history",
-                    "@entity.orbitalName",
+                    "render-ui",
+                    "main",
                     {
-                      "emit": {
-                        "failure": "HISTORY_LOAD_FAILED",
-                        "success": "HISTORY_LOADED"
-                      }
+                      "message": "@payload.error",
+                      "type": "alert",
+                      "variant": "error"
                     }
                   ]
                 ],
-                "event": "SPEC_LOADED",
-                "eventId": "evt_01KXG04EKX3H1EN73B8HMFXN1P",
-                "from": "reading",
-                "to": "loadingHistory"
+                "event": "AgentMessagesLoadFailed",
+                "eventId": "evt_01M3TYMQH8BHTWREJV617WFH68",
+                "from": "loading",
+                "to": "chatting"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.status",
-                    "idle"
-                  ]
-                ],
-                "event": "SPEC_LOAD_FAILED",
-                "eventId": "evt_01KXG04EKX1MSK9YFKZ9BEVMMM",
-                "from": "reading",
-                "to": "idle"
-              },
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.history",
-                    "@payload.result"
-                  ],
-                  [
-                    "set",
-                    "@entity.status",
-                    "read"
+                    "fetch",
+                    "AgentMessage",
+                    {
+                      "emit": {
+                        "failure": "AgentMessagesLoadFailed",
+                        "success": "AgentMessagesLoaded"
+                      }
+                    }
                   ],
                   [
-                    "emit",
-                    "SPEC_READ",
+                    "render-ui",
+                    "main",
                     {
-                      "history": "@entity.history",
-                      "spec": "@entity.spec"
+                      "children": [
+                        {
+                          "type": "skeleton",
+                          "variant": "header"
+                        },
+                        {
+                          "rows": 6.0,
+                          "type": "skeleton",
+                          "variant": "list"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ],
-                "event": "HISTORY_LOADED",
-                "eventId": "evt_01KXG04EKX1WXPHFMS8PDEP3V9",
-                "from": "loadingHistory",
-                "to": "read"
+                "event": "INIT",
+                "eventId": "evt_01M3TYMQH81AV51TX8HBD3BVVY",
+                "from": "chatting",
+                "to": "loading"
               },
               {
                 "effects": [
                   [
                     "set",
-                    "@entity.status",
-                    "idle"
+                    "@entity.draft",
+                    "@payload.value"
                   ]
                 ],
-                "event": "HISTORY_LOAD_FAILED",
-                "eventId": "evt_01KXG04EKX2TZBYC9HCBBPQS7G",
-                "from": "loadingHistory",
-                "to": "idle"
+                "event": "EDIT_MESSAGE",
+                "eventId": "evt_01M3TYMQH8HHGS90VQR6Y0RK1K",
+                "from": "chatting",
+                "to": "chatting"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.status",
-                    "read"
-                  ]
-                ],
-                "event": "INIT",
-                "eventId": "evt_01KXG04EKXGYJ1FH125MS53CJ6",
-                "from": "read",
-                "to": "read"
-              },
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.spec",
-                    {}
-                  ],
-                  [
-                    "set",
-                    "@entity.history",
-                    []
+                    "persist",
+                    "create",
+                    "AgentMessage",
+                    {
+                      "content": "@entity.draft",
+                      "createdAt": "@now",
+                      "ownerId": "@user.id",
+                      "role": "user"
+                    },
+                    {
+                      "emit": {
+                        "failure": "AgentMessageSaveFailed",
+                        "success": "AgentMessageSaved"
+                      }
+                    }
                   ],
                   [
                     "set",
-                    "@entity.status",
-                    "idle"
+                    "@entity.draft",
+                    ""
                   ]
                 ],
-                "event": "RESET",
-                "eventId": "evt_01KXG04EKX8WQZEZJ0A6XFEAFH",
-                "from": "read",
-                "to": "idle"
-              }
-            ]
-          }
-        },
-        {
-          "category": "lifecycle",
-          "effectRow": [
-            {
-              "kind": "emit",
-              "resource": "SPEC_WRITTEN"
-            },
-            {
-              "kind": "session/write-spec"
-            },
-            {
-              "kind": "set",
-              "resource": "@entity.orbitalName"
-            },
-            {
-              "kind": "set",
-              "resource": "@entity.spec"
-            },
-            {
-              "kind": "set",
-              "resource": "@entity.status"
-            }
-          ],
-          "emits": [
-            {
-              "event": "SPEC_WRITTEN",
-              "eventId": "evt_01KXG04EKXGEKJBQ6QMY8GWE40",
-              "payloadSchema": [
-                {
-                  "name": "orbitalName",
-                  "required": true,
-                  "type": "string"
-                }
-              ]
-            }
-          ],
-          "entityRefIds": {
-            "AgentSession": "ent_01KXG04EKX39PHPB9ADMKRXVVH"
-          },
-          "id": "trt_01KXG04EKXJY0PEPEH24A09MN2",
-          "linkedEntity": "AgentSession",
-          "linkedEntityId": "ent_01KXG04EKX39PHPB9ADMKRXVVH",
-          "name": "SessionWriter",
-          "scope": "instance",
-          "stateMachine": {
-            "events": [
-              {
-                "id": "evt_01KXG04EKX5K2E6MVGTQ98DVX8",
-                "key": "INIT",
-                "name": "Initialize"
-              },
-              {
-                "id": "evt_01KXG04EKXQ3012NS749R8GSQS",
-                "key": "WRITE_SPEC",
-                "name": "Write Spec",
-                "payloadSchema": [
-                  {
-                    "name": "orbitalName",
-                    "required": true,
-                    "type": "string"
-                  },
-                  {
-                    "name": "spec",
-                    "properties": [
-                      {
-                        "name": "orbitalName",
-                        "type": "string"
-                      },
-                      {
-                        "name": "organism",
-                        "required": true,
-                        "type": "string"
-                      },
-                      {
-                        "name": "method",
-                        "required": true,
-                        "type": "string"
-                      },
-                      {
-                        "name": "deltaPrompt",
-                        "required": true,
-                        "type": "string"
-                      }
+                "event": "SEND_DRAFT",
+                "eventId": "evt_01M3TYMQH8RCRDSVZ3DQ6DZ2YF",
+                "from": "chatting",
+                "guard": [
+                  "not",
+                  [
+                    "=",
+                    [
+                      "str/default",
+                      "@entity.draft",
+                      ""
                     ],
-                    "required": true,
-                    "type": "object"
-                  }
-                ]
-              },
-              {
-                "id": "evt_01KXG04EKX5ASR4H9E1B20EQD4",
-                "key": "RESET",
-                "name": "Reset"
-              },
-              {
-                "id": "evt_01KXG04EKXGEKJBQ6QMY8GWE40",
-                "key": "SPEC_WRITTEN",
-                "name": "Spec Written",
-                "payloadSchema": [
-                  {
-                    "name": "orbitalName",
-                    "required": true,
-                    "type": "string"
-                  }
-                ]
-              }
-            ],
-            "states": [
-              {
-                "isInitial": true,
-                "name": "idle"
+                    ""
+                  ]
+                ],
+                "to": "waiting"
               },
-              {
-                "name": "written"
-              }
-            ],
-            "transitions": [
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.orbitalName",
-                    ""
-                  ],
-                  [
-                    "set",
-                    "@entity.spec",
-                    {}
-                  ],
+                    "persist",
+                    "create",
+                    "AgentMessage",
+                    {
+                      "content": "@payload.message",
+                      "createdAt": "@now",
+                      "ownerId": "@user.id",
+                      "role": "user"
+                    },
+                    {
+                      "emit": {
+                        "failure": "AgentMessageSaveFailed",
+                        "success": "AgentMessageSaved"
+                      }
+                    }
+                  ]
+                ],
+                "event": "SEND",
+                "eventId": "evt_01M3TYMQH87CAV0ETMWW6P6W6P",
+                "from": "chatting",
+                "guard": [
+                  "not",
                   [
-                    "set",
-                    "@entity.status",
-                    "idle"
+                    "=",
+                    [
+                      "str/default",
+                      "@payload.message",
+                      ""
+                    ],
+                    ""
                   ]
                 ],
-                "event": "INIT",
-                "eventId": "evt_01KXG04EKX5K2E6MVGTQ98DVX8",
-                "from": "idle",
-                "to": "idle"
+                "to": "waiting"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.orbitalName",
-                    "@payload.orbitalName"
-                  ],
-                  [
-                    "set",
-                    "@entity.spec",
-                    "@payload.spec"
-                  ],
-                  [
-                    "session/write-spec",
-                    "@entity.orbitalName",
-                    "@entity.spec"
-                  ],
-                  [
-                    "set",
-                    "@entity.status",
-                    "written"
+                    "persist",
+                    "create",
+                    "AgentMessage",
+                    {
+                      "content": "@payload.reply",
+                      "createdAt": "@now",
+                      "ownerId": "@user.id",
+                      "role": "assistant"
+                    }
                   ],
                   [
-                    "emit",
-                    "SPEC_WRITTEN",
+                    "fetch",
+                    "AgentMessage",
                     {
-                      "orbitalName": "@entity.orbitalName"
+                      "emit": {
+                        "failure": "AgentMessagesLoadFailed",
+                        "success": "AgentMessagesLoaded"
+                      }
                     }
                   ]
                 ],
-                "event": "WRITE_SPEC",
-                "eventId": "evt_01KXG04EKXQ3012NS749R8GSQS",
-                "from": "idle",
-                "to": "written"
+                "event": "REPLIED",
+                "eventId": "evt_01M3TYMQH8PJZ22902FWBBMMK4",
+                "from": "chatting",
+                "to": "loading"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.status",
-                    "written"
+                    "fetch",
+                    "AgentMessage",
+                    {
+                      "emit": {
+                        "failure": "AgentMessagesLoadFailed",
+                        "success": "AgentMessagesLoaded"
+                      }
+                    }
                   ]
                 ],
-                "event": "INIT",
-                "eventId": "evt_01KXG04EKX5K2E6MVGTQ98DVX8",
-                "from": "written",
-                "to": "written"
+                "event": "REPLY_FAILED",
+                "eventId": "evt_01M3TYMQH844NH7EYEBPA4XVG6",
+                "from": "chatting",
+                "to": "loading"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.spec",
-                    {}
+                    "fetch",
+                    "AgentMessage",
+                    {
+                      "emit": {
+                        "failure": "AgentMessagesLoadFailed",
+                        "success": "AgentConversationLoaded"
+                      }
+                    }
                   ],
                   [
-                    "set",
-                    "@entity.status",
-                    "idle"
-                  ]
-                ],
-                "event": "RESET",
-                "eventId": "evt_01KXG04EKX5ASR4H9E1B20EQD4",
-                "from": "written",
-                "to": "idle"
-              }
-            ]
-          }
-        },
-        {
-          "category": "lifecycle",
-          "effectRow": [
-            {
-              "kind": "set",
-              "resource": "@entity.status"
-            }
-          ],
-          "entityRefIds": {
-            "AgentSession": "ent_01KXG04EKX39PHPB9ADMKRXVVH"
-          },
-          "id": "trt_01KXG04EKX2J2G30B1BZS1XX5K",
-          "linkedEntity": "AgentSession",
-          "linkedEntityId": "ent_01KXG04EKX39PHPB9ADMKRXVVH",
-          "listens": [
-            {
-              "event": "SPEC_READ",
-              "eventId": "evt_01KXG04EKX5A8JT97Q39HC4E4K",
-              "source": {
-                "kind": "trait",
-                "trait": "SessionReader",
-                "traitId": "trt_01KXG04EKXM2CWDTW7V6A103HS"
-              },
-              "triggers": "SPEC_READ",
-              "triggersId": "evt_01KXG04EKX125KV7F4JQRFF8BC"
-            },
-            {
-              "event": "SPEC_WRITTEN",
-              "eventId": "evt_01KXG04EKXGEKJBQ6QMY8GWE40",
-              "source": {
-                "kind": "trait",
-                "trait": "SessionWriter",
-                "traitId": "trt_01KXG04EKXJY0PEPEH24A09MN2"
-              },
-              "triggers": "SPEC_WRITTEN",
-              "triggersId": "evt_01KXG04EKXQ3CQQP3ZEY0K9CZD"
-            }
-          ],
-          "name": "SessionListener",
-          "scope": "instance",
-          "stateMachine": {
-            "events": [
-              {
-                "id": "evt_01KXG04EKX22QYT3DTH7TFSBM3",
-                "key": "INIT",
-                "name": "Initialize"
-              },
-              {
-                "id": "evt_01KXG04EKX125KV7F4JQRFF8BC",
-                "key": "SPEC_READ",
-                "name": "Spec Read"
-              },
-              {
-                "id": "evt_01KXG04EKXQ3CQQP3ZEY0K9CZD",
-                "key": "SPEC_WRITTEN",
-                "name": "Spec Written"
-              },
-              {
-                "id": "evt_01KXG04EKX3EQVVA8QMNATFKHD",
-                "key": "RESET",
-                "name": "Reset"
-              }
-            ],
-            "states": [
-              {
-                "isInitial": true,
-                "name": "waiting"
-              },
-              {
-                "name": "active"
-              }
-            ],
-            "transitions": [
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.status",
-                    "idle"
+                    "render-ui",
+                    "main",
+                    {
+                      "size": "sm",
+                      "type": "spinner"
+                    }
                   ]
                 ],
-                "event": "INIT",
-                "eventId": "evt_01KXG04EKX22QYT3DTH7TFSBM3",
+                "event": "AgentMessageSaved",
+                "eventId": "evt_01M3TYMQH8ACSRY02P4HWBHJWV",
                 "from": "waiting",
                 "to": "waiting"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.status",
-                    "read"
+                    "emit",
+                    "CONVERSE",
+                    {
+                      "messages": [
+                        "array/map",
+                        [
+                          "array/sort",
+                          "@payload.data",
+                          "createdAt",
+                          "asc"
+                        ],
+                        [
+                          "fn",
+                          "item",
+                          {
+                            "content": "@item.content",
+                            "role": "@item.role"
+                          }
+                        ]
+                      ]
+                    }
                   ]
                 ],
-                "event": "SPEC_READ",
-                "eventId": "evt_01KXG04EKX125KV7F4JQRFF8BC",
+                "event": "AgentConversationLoaded",
+                "eventId": "evt_01M3TYMQH8H65NTWP1KYX7WM6C",
                 "from": "waiting",
-                "to": "active"
+                "to": "waiting"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.status",
-                    "written"
+                    "persist",
+                    "create",
+                    "AgentMessage",
+                    {
+                      "content": "@payload.reply",
+                      "createdAt": "@now",
+                      "ownerId": "@user.id",
+                      "role": "assistant"
+                    }
+                  ],
+                  [
+                    "fetch",
+                    "AgentMessage",
+                    {
+                      "emit": {
+                        "failure": "AgentMessagesLoadFailed",
+                        "success": "AgentMessagesLoaded"
+                      }
+                    }
                   ]
                 ],
-                "event": "SPEC_WRITTEN",
-                "eventId": "evt_01KXG04EKXQ3CQQP3ZEY0K9CZD",
+                "event": "REPLIED",
+                "eventId": "evt_01M3TYMQH8PJZ22902FWBBMMK4",
                 "from": "waiting",
-                "to": "active"
+                "to": "loading"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.status",
-                    "idle"
+                    "fetch",
+                    "AgentMessage",
+                    {
+                      "emit": {
+                        "failure": "AgentMessagesLoadFailed",
+                        "success": "AgentMessagesLoaded"
+                      }
+                    }
                   ]
                 ],
-                "event": "RESET",
-                "eventId": "evt_01KXG04EKX3EQVVA8QMNATFKHD",
+                "event": "REPLY_FAILED",
+                "eventId": "evt_01M3TYMQH844NH7EYEBPA4XVG6",
                 "from": "waiting",
-                "to": "waiting"
+                "to": "loading"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.status",
-                    "idle"
+                    "render-ui",
+                    "main",
+                    {
+                      "message": "@payload.error",
+                      "type": "alert",
+                      "variant": "error"
+                    }
                   ]
                 ],
-                "event": "INIT",
-                "eventId": "evt_01KXG04EKX22QYT3DTH7TFSBM3",
-                "from": "active",
-                "to": "active"
+                "event": "AgentMessageSaveFailed",
+                "eventId": "evt_01M3TYMQH8CEE16439Z6N25V08",
+                "from": "waiting",
+                "to": "chatting"
               },
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.status",
-                    "idle"
+                    "render-ui",
+                    "main",
+                    {
+                      "message": "@payload.error",
+                      "type": "alert",
+                      "variant": "error"
+                    }
                   ]
                 ],
-                "event": "RESET",
-                "eventId": "evt_01KXG04EKX3EQVVA8QMNATFKHD",
-                "from": "active",
-                "to": "waiting"
+                "event": "AgentMessagesLoadFailed",
+                "eventId": "evt_01M3TYMQH8BHTWREJV617WFH68",
+                "from": "waiting",
+                "to": "chatting"
               }
             ]
           }
         }
       ],
       "types": {
-        "HistoryEntry": [
+        "AgentChatMessage": [
           {
             "name": "role",
-            "required": true,
             "type": "string"
           },
           {
             "name": "content",
             "required": true,
             "type": "string"
-          },
-          {
-            "name": "timestamp",
-            "type": "number"
           }
         ],
-        "OrbitalSpec": [
-          {
-            "name": "orbitalName",
-            "type": "string"
-          },
-          {
-            "name": "organism",
-            "required": true,
-            "type": "string"
-          },
+        "AgentLink": [
           {
-            "name": "method",
+            "name": "label",
             "required": true,
             "type": "string"
           },
           {
-            "name": "deltaPrompt",
+            "name": "href",
             "required": true,
             "type": "string"
           }
@@ -1191,5 +1254,5 @@
     }
   ],
   "schemaVersion": 1,
-  "version": "1.0.0"
+  "version": "2.0.0"
 }