@almadar/std 16.243.0 → 16.244.1

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

@@ -123,6 +123,47 @@
             "name": "lastSize",
             "synonyms": "size, length",
             "type": "number"
+          },
+          {
+            "default": "",
+            "description": "The ephemeral conversation's own instructions, carried through a summarizing.",
+            "name": "pendingInstructions",
+            "type": "string"
+          },
+          {
+            "default": [],
+            "description": "The ephemeral conversation's own tools, carried through a summarizing.",
+            "items": {
+              "properties": {
+                "event": {
+                  "name": "event",
+                  "required": false,
+                  "type": "event"
+                },
+                "read": {
+                  "name": "read",
+                  "required": false,
+                  "type": "string"
+                },
+                "scope": {
+                  "name": "scope",
+                  "required": false,
+                  "type": "string",
+                  "values": [
+                    "declared"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "name": "pendingTools",
+            "type": "array"
+          },
+          {
+            "default": false,
+            "description": "The conversation being compacted is ephemeral.",
+            "name": "pendingEphemeral",
+            "type": "boolean"
           }
         ],
         "id": "ent_01M3TYMQJMGY8DD73YX22WEW07",
@@ -174,14 +215,26 @@
               "kind": "set",
               "resource": "@entity.lastSize"
             },
+            {
+              "kind": "set",
+              "resource": "@entity.pendingEphemeral"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.pendingInstructions"
+            },
             {
               "kind": "set",
               "resource": "@entity.pendingMessages"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.pendingTools"
             }
           ],
           "emits": [
             {
-              "description": "The conversation, bounded: recent turns verbatim, older turns as one summary note.",
+              "description": "The conversation, bounded: recent turns verbatim, older turns as one summary note. An ephemeral conversation's own `instructions`, `tools` and `ephemeral` flag pass through untouched.",
               "event": "COMPACTED",
               "eventId": "evt_01M3TYMQJM2ZA1HG90KARCHVXQ",
               "payloadSchema": [
@@ -201,6 +254,33 @@
                   ],
                   "required": true,
                   "type": "[object]"
+                },
+                {
+                  "name": "instructions",
+                  "type": "string"
+                },
+                {
+                  "entity": "AgentTool",
+                  "name": "tools",
+                  "properties": [
+                    {
+                      "name": "event",
+                      "type": "event"
+                    },
+                    {
+                      "name": "read",
+                      "type": "string"
+                    },
+                    {
+                      "name": "scope",
+                      "type": "string"
+                    }
+                  ],
+                  "type": "[object]"
+                },
+                {
+                  "name": "ephemeral",
+                  "type": "boolean"
                 }
               ],
               "scope": "external",
@@ -252,7 +332,7 @@
                 "name": "Initialize"
               },
               {
-                "description": "Bound this conversation for the model.",
+                "description": "Bound this conversation for the model. An ephemeral conversation's own `instructions`, `tools` and `ephemeral` flag ride along.",
                 "id": "evt_01M3TYMQJMSZDFZ983H5ZFRA80",
                 "key": "COMPACT",
                 "name": "Compact",
@@ -272,6 +352,32 @@
                     ],
                     "required": true,
                     "type": "[object]"
+                  },
+                  {
+                    "name": "instructions",
+                    "type": "string"
+                  },
+                  {
+                    "name": "tools",
+                    "properties": [
+                      {
+                        "name": "event",
+                        "type": "event"
+                      },
+                      {
+                        "name": "read",
+                        "type": "string"
+                      },
+                      {
+                        "name": "scope",
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  },
+                  {
+                    "name": "ephemeral",
+                    "type": "boolean"
                   }
                 ]
               },
@@ -304,7 +410,7 @@
                 "tier": "internal"
               },
               {
-                "description": "The conversation, bounded: recent turns verbatim, older turns as one summary note.",
+                "description": "The conversation, bounded: recent turns verbatim, older turns as one summary note. An ephemeral conversation's own `instructions`, `tools` and `ephemeral` flag pass through untouched.",
                 "id": "evt_01M3TYMQJM2ZA1HG90KARCHVXQ",
                 "key": "COMPACTED",
                 "name": "Compacted",
@@ -325,6 +431,33 @@
                     ],
                     "required": true,
                     "type": "[object]"
+                  },
+                  {
+                    "name": "instructions",
+                    "type": "string"
+                  },
+                  {
+                    "entity": "AgentTool",
+                    "name": "tools",
+                    "properties": [
+                      {
+                        "name": "event",
+                        "type": "event"
+                      },
+                      {
+                        "name": "read",
+                        "type": "string"
+                      },
+                      {
+                        "name": "scope",
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  },
+                  {
+                    "name": "ephemeral",
+                    "type": "boolean"
                   }
                 ],
                 "synonyms": "compacted, trimmed, bounded",
@@ -368,7 +501,24 @@
                     "emit",
                     "COMPACTED",
                     {
-                      "messages": "@payload.messages"
+                      "ephemeral": [
+                        "if",
+                        "@payload.ephemeral",
+                        true,
+                        false
+                      ],
+                      "instructions": [
+                        "str/default",
+                        "@payload.instructions",
+                        ""
+                      ],
+                      "messages": "@payload.messages",
+                      "tools": [
+                        "object/get",
+                        "@payload",
+                        "tools",
+                        []
+                      ]
                     }
                   ]
                 ],
@@ -400,6 +550,35 @@
                     "@entity.pendingMessages",
                     "@payload.messages"
                   ],
+                  [
+                    "set",
+                    "@entity.pendingInstructions",
+                    [
+                      "str/default",
+                      "@payload.instructions",
+                      ""
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.pendingTools",
+                    [
+                      "object/get",
+                      "@payload",
+                      "tools",
+                      []
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.pendingEphemeral",
+                    [
+                      "if",
+                      "@payload.ephemeral",
+                      true,
+                      false
+                    ]
+                  ],
                   [
                     "call-service",
                     "llm",
@@ -455,6 +634,8 @@
                     "emit",
                     "COMPACTED",
                     {
+                      "ephemeral": "@entity.pendingEphemeral",
+                      "instructions": "@entity.pendingInstructions",
                       "messages": [
                         "array/prepend",
                         [
@@ -470,7 +651,8 @@
                           ],
                           "role": "assistant"
                         }
-                      ]
+                      ],
+                      "tools": "@entity.pendingTools"
                     }
                   ]
                 ],
@@ -485,11 +667,14 @@
                     "emit",
                     "COMPACTED",
                     {
+                      "ephemeral": "@entity.pendingEphemeral",
+                      "instructions": "@entity.pendingInstructions",
                       "messages": [
                         "array/takeLast",
                         "@entity.pendingMessages",
                         "@config.keepMessages"
-                      ]
+                      ],
+                      "tools": "@entity.pendingTools"
                     }
                   ],
                   [
@@ -522,6 +707,20 @@
             "required": true,
             "type": "string"
           }
+        ],
+        "AgentTool": [
+          {
+            "name": "event",
+            "type": "event"
+          },
+          {
+            "name": "read",
+            "type": "string"
+          },
+          {
+            "name": "scope",
+            "type": "string"
+          }
         ]
       }
     }

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

@@ -369,7 +369,7 @@
           ],
           "emits": [
             {
-              "description": "The conversation, with what the assistant remembers that is closest to its last turn.",
+              "description": "The conversation, with what the assistant remembers that is closest to its last turn. An ephemeral conversation is never recalled for: empty `context`, its own `instructions`, `tools` and `ephemeral` flag pass through.",
               "event": "RECALLED",
               "eventId": "evt_01M3TYMQKZGPZ3GDV9SZ5ZSC80",
               "payloadSchema": [
@@ -393,6 +393,33 @@
                 {
                   "name": "context",
                   "type": "string"
+                },
+                {
+                  "name": "instructions",
+                  "type": "string"
+                },
+                {
+                  "entity": "AgentTool",
+                  "name": "tools",
+                  "properties": [
+                    {
+                      "name": "event",
+                      "type": "event"
+                    },
+                    {
+                      "name": "read",
+                      "type": "string"
+                    },
+                    {
+                      "name": "scope",
+                      "type": "string"
+                    }
+                  ],
+                  "type": "[object]"
+                },
+                {
+                  "name": "ephemeral",
+                  "type": "boolean"
                 }
               ],
               "scope": "external",
@@ -756,7 +783,7 @@
                 "tier": "internal"
               },
               {
-                "description": "Recall what is relevant to this conversation's last turn.",
+                "description": "Recall what is relevant to this conversation's last turn. An ephemeral conversation skips the recall.",
                 "id": "evt_01M3TYMQKZXAVRV1YVNJS591F0",
                 "key": "RECALL",
                 "name": "Recall",
@@ -776,11 +803,37 @@
                     ],
                     "required": true,
                     "type": "[object]"
+                  },
+                  {
+                    "name": "instructions",
+                    "type": "string"
+                  },
+                  {
+                    "name": "tools",
+                    "properties": [
+                      {
+                        "name": "event",
+                        "type": "event"
+                      },
+                      {
+                        "name": "read",
+                        "type": "string"
+                      },
+                      {
+                        "name": "scope",
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  },
+                  {
+                    "name": "ephemeral",
+                    "type": "boolean"
                   }
                 ]
               },
               {
-                "description": "Remember the exchange just answered.",
+                "description": "Remember the exchange just answered. An ephemeral conversation is never remembered.",
                 "id": "evt_01M3TYMQKZQ5TXMDMH5X7V7VQ4",
                 "key": "REMEMBER",
                 "name": "Remember",
@@ -789,6 +842,10 @@
                     "name": "reply",
                     "required": true,
                     "type": "string"
+                  },
+                  {
+                    "name": "ephemeral",
+                    "type": "boolean"
                   }
                 ]
               },
@@ -898,7 +955,7 @@
                 "tier": "internal"
               },
               {
-                "description": "The conversation, with what the assistant remembers that is closest to its last turn.",
+                "description": "The conversation, with what the assistant remembers that is closest to its last turn. An ephemeral conversation is never recalled for: empty `context`, its own `instructions`, `tools` and `ephemeral` flag pass through.",
                 "id": "evt_01M3TYMQKZGPZ3GDV9SZ5ZSC80",
                 "key": "RECALLED",
                 "name": "Recalled",
@@ -923,6 +980,33 @@
                   {
                     "name": "context",
                     "type": "string"
+                  },
+                  {
+                    "name": "instructions",
+                    "type": "string"
+                  },
+                  {
+                    "entity": "AgentTool",
+                    "name": "tools",
+                    "properties": [
+                      {
+                        "name": "event",
+                        "type": "event"
+                      },
+                      {
+                        "name": "read",
+                        "type": "string"
+                      },
+                      {
+                        "name": "scope",
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  },
+                  {
+                    "name": "ephemeral",
+                    "type": "boolean"
                   }
                 ],
                 "synonyms": "recalled, remembered, context ready",
@@ -1074,6 +1158,35 @@
                 "from": "ready",
                 "to": "ready"
               },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "RECALLED",
+                    {
+                      "context": "",
+                      "ephemeral": true,
+                      "instructions": [
+                        "str/default",
+                        "@payload.instructions",
+                        ""
+                      ],
+                      "messages": "@payload.messages",
+                      "tools": [
+                        "object/get",
+                        "@payload",
+                        "tools",
+                        []
+                      ]
+                    }
+                  ]
+                ],
+                "event": "RECALL",
+                "eventId": "evt_01M3TYMQKZXAVRV1YVNJS591F0",
+                "from": "ready",
+                "guard": "@payload.ephemeral",
+                "to": "ready"
+              },
               {
                 "effects": [
                   [
@@ -1120,8 +1233,19 @@
                 "event": "RECALL",
                 "eventId": "evt_01M3TYMQKZXAVRV1YVNJS591F0",
                 "from": "ready",
+                "guard": [
+                  "not",
+                  "@payload.ephemeral"
+                ],
                 "to": "recalling"
               },
+              {
+                "event": "REMEMBER",
+                "eventId": "evt_01M3TYMQKZQ5TXMDMH5X7V7VQ4",
+                "from": "ready",
+                "guard": "@payload.ephemeral",
+                "to": "ready"
+              },
               {
                 "effects": [
                   [
@@ -1161,6 +1285,10 @@
                 "event": "REMEMBER",
                 "eventId": "evt_01M3TYMQKZQ5TXMDMH5X7V7VQ4",
                 "from": "ready",
+                "guard": [
+                  "not",
+                  "@payload.ephemeral"
+                ],
                 "to": "remembering"
               },
               {
@@ -1716,6 +1844,20 @@
             "name": "createdAt",
             "type": "number"
           }
+        ],
+        "AgentTool": [
+          {
+            "name": "event",
+            "type": "event"
+          },
+          {
+            "name": "read",
+            "type": "string"
+          },
+          {
+            "name": "scope",
+            "type": "string"
+          }
         ]
       }
     }