npm - @almadar/std - Versions diffs - 16.252.0 → 16.254.0 - Mend

@almadar/std 16.252.0 → 16.254.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (453) hide show

package/behaviors/registry/agent/atoms/std-agent-tool-call.orb CHANGED Viewed

	@@ -1 +1 @@
1	- {"name":"std-agent-tool-call","version":"1.0.0","description":"Wraps llm/call-tools — takes messages + tools, returns tool-call result.","orbitals":[{"name":"AgentToolCallOrbital","id":"orb_3F0B6P7SBYWNZCA7S2EQSZ5XV1","entity":{"name":"ToolCall","id":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00","persistence":"runtime","fields":[{"name":"messages","type":"array","default":[],"items":{"type":"object","properties":{"content":{"name":"content","type":"string","required":true},"toolCalls":{"name":"toolCalls","type":"array","required":false,"items":{"type":"object","properties":{"function":{"name":"function","type":"object","required":false,"properties":{"name":{"name":"name","type":"string","required":true},"arguments":{"name":"arguments","type":"string","required":true}}},"id":{"name":"id","type":"string","required":true},"type":{"name":"type","type":"string","required":false,"values":["function"]}}}},"toolCallId":{"name":"toolCallId","type":"string","required":false},"role":{"name":"role","type":"string","required":true}}}},{"name":"tools","type":"array","default":[],"items":{"type":"object","properties":{"description":{"name":"description","type":"string","required":true},"schema":{"name":"schema","type":"object","required":false,"properties":{"type":{"name":"type","type":"string","required":false},"description":{"name":"description","type":"string","required":false}}},"name":{"name":"name","type":"string","required":true}}}},{"name":"response","type":"string","default":""},{"name":"status","type":"string","default":"idle","values":["idle","done"]}]},"traits":[{"name":"ToolCallExecution","id":"trt_KA2DR48C2T61D05FEFT2KK77EB","effectRow":[{"kind":"llm/call-tools"},{"kind":"set","resource":"@entity.messages"},{"kind":"set","resource":"@entity.response"},{"kind":"set","resource":"@entity.status"},{"kind":"set","resource":"@entity.tools"}],"category":"lifecycle","linkedEntity":"ToolCall","linkedEntityId":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00","entityRefIds":{"ToolCall":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00"},"emits":[{"event":"TOOLS_CALLED","eventId":"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS","payloadSchema":[{"name":"result","type":"string","required":true}]}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"calling"},{"name":"done"}],"events":[{"key":"INIT","id":"evt_4BAB2324KB29NVZ6SJCQ55JA1G","name":"Initialize"},{"key":"CALL_TOOLS","id":"evt_Z6C6EEJ7J43S2B5CHTSD224FZN","name":"Call Tools","payloadSchema":[{"name":"messages","type":"[object]","required":true,"properties":[{"name":"role","type":"string","required":true},{"name":"content","type":"string","required":true},{"name":"toolCalls","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"type","type":"string","values":["function"]},{"name":"function","type":"object","properties":[{"name":"name","type":"string","required":true},{"name":"arguments","type":"string","required":true}]}]},{"name":"toolCallId","type":"string"}]},{"name":"tools","type":"[object]","required":true,"properties":[{"name":"name","type":"string","required":true},{"name":"description","type":"string","required":true},{"name":"schema","type":"object","properties":[{"name":"type","type":"string"},{"name":"description","type":"string"}]}]}],"listened":true},{"key":"TOOLS_CALLED","id":"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS","name":"Tools Called","payloadSchema":[{"name":"result","type":"string","required":true}]},{"key":"TOOLS_FAILED","id":"evt_KVQ7S2CS5ZCJZRHYMJ5A78K5MP","name":"Tools Failed"},{"key":"RESET","id":"evt_YT8KDP0CFV67XR0RE28XGGBRPS","name":"Reset"}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_4BAB2324KB29NVZ6SJCQ55JA1G","effects":[["set","@entity.messages",[]],["set","@entity.tools",[]],["set","@entity.response",""],["set","@entity.status","idle"]]},{"from":"idle","to":"calling","event":"CALL_TOOLS","eventId":"evt_Z6C6EEJ7J43S2B5CHTSD224FZN","effects":[["set","@entity.messages","@payload.messages"],["set","@entity.tools","@payload.tools"],["llm/call-tools","@entity.messages","@entity.tools",{"emit":{"success":"TOOLS_CALLED","failure":"TOOLS_FAILED"}}]]},{"from":"calling","to":"idle","event":"INIT","eventId":"evt_4BAB2324KB29NVZ6SJCQ55JA1G","effects":[["set","@entity.messages",[]],["set","@entity.tools",[]],["set","@entity.response",""],["set","@entity.status","idle"]]},{"from":"calling","to":"done","event":"TOOLS_CALLED","eventId":"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS","effects":[["set","@entity.response","@payload.result"],["set","@entity.status","done"]]},{"from":"calling","to":"done","event":"TOOLS_FAILED","eventId":"evt_KVQ7S2CS5ZCJZRHYMJ5A78K5MP","effects":[["set","@entity.response",""],["set","@entity.status","done"]]},{"from":"done","to":"done","event":"INIT","eventId":"evt_4BAB2324KB29NVZ6SJCQ55JA1G","effects":[["set","@entity.status","done"]]},{"from":"done","to":"idle","event":"RESET","eventId":"evt_YT8KDP0CFV67XR0RE28XGGBRPS","effects":[["set","@entity.response",""],["set","@entity.messages",[]],["set","@entity.tools",[]],["set","@entity.status","idle"]]}]},"scope":"instance"},{"name":"ToolCallReady","id":"trt_4ZV009393KMHSTW54E5ZH608KP","effectRow":[{"kind":"set","resource":"@entity.status"}],"category":"lifecycle","linkedEntity":"ToolCall","linkedEntityId":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00","entityRefIds":{"ToolCall":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00"},"listens":[{"event":"TOOLS_CALLED","eventId":"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS","triggers":"TOOLS_CALLED","triggersId":"evt_S8W1YQ82BK15SVY7XXYEA8TEYB","source":{"kind":"trait","trait":"ToolCallExecution","traitId":"trt_KA2DR48C2T61D05FEFT2KK77EB"}}],"stateMachine":{"states":[{"name":"waiting","isInitial":true},{"name":"ready"}],"events":[{"key":"INIT","id":"evt_GT5K3ZC82V41DW2X7AF12QYSRB","name":"Initialize"},{"key":"TOOLS_CALLED","id":"evt_S8W1YQ82BK15SVY7XXYEA8TEYB","name":"Tools Called"},{"key":"RESET","id":"evt_EAG3HVKWGRY8CEWWZARW0CXMNF","name":"Reset","listened":true}],"transitions":[{"from":"waiting","to":"waiting","event":"INIT","eventId":"evt_GT5K3ZC82V41DW2X7AF12QYSRB","effects":[["set","@entity.status","idle"]]},{"from":"waiting","to":"ready","event":"TOOLS_CALLED","eventId":"evt_S8W1YQ82BK15SVY7XXYEA8TEYB","effects":[["set","@entity.status","done"]]},{"from":"ready","to":"ready","event":"INIT","eventId":"evt_GT5K3ZC82V41DW2X7AF12QYSRB","effects":[["set","@entity.status","done"]]},{"from":"ready","to":"waiting","event":"RESET","eventId":"evt_EAG3HVKWGRY8CEWWZARW0CXMNF","effects":[["set","@entity.status","idle"]]}]},"scope":"instance"}],"pages":[{"name":"AgentToolCallPage","id":"pag_NME6YNZF56QJK2YJ98219EWRWG","path":"/agent-tool-call","traits":[{"ref":"ToolCallExecution","refId":"trt_KA2DR48C2T61D05FEFT2KK77EB"},{"ref":"ToolCallReady","refId":"trt_4ZV009393KMHSTW54E5ZH608KP"}]}],"types":{"LlmMessage":[{"name":"role","type":"string","required":true},{"name":"content","type":"string","required":true},{"name":"toolCalls","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"type","type":"string","values":["function"]},{"name":"function","type":"object","properties":[{"name":"name","type":"string","required":true},{"name":"arguments","type":"string","required":true}]}]},{"name":"toolCallId","type":"string"}],"LlmToolCall":[{"name":"id","type":"string","required":true},{"name":"type","type":"string","values":["function"]},{"name":"function","type":"object","properties":[{"name":"name","type":"string","required":true},{"name":"arguments","type":"string","required":true}]}],"LlmToolDef":[{"name":"name","type":"string","required":true},{"name":"description","type":"string","required":true},{"name":"schema","type":"object","properties":[{"name":"type","type":"string"},{"name":"description","type":"string"}]}],"LlmToolSchema":[{"name":"type","type":"string"},{"name":"description","type":"string"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_A0PSVSPTN0DAGAD3RPM4NP1K00":{"id":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00","kind":"entity","bakedName":"ToolCall","curName":"ToolCall","renames":[],"owner":"workspace"},"evt_4BAB2324KB29NVZ6SJCQ55JA1G":{"id":"evt_4BAB2324KB29NVZ6SJCQ55JA1G","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_KA2DR48C2T61D05FEFT2KK77EB"},"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS":{"id":"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS","kind":"event","bakedName":"TOOLS_CALLED","curName":"TOOLS_CALLED","renames":[],"owner":"workspace","parent":"trt_KA2DR48C2T61D05FEFT2KK77EB"},"evt_EAG3HVKWGRY8CEWWZARW0CXMNF":{"id":"evt_EAG3HVKWGRY8CEWWZARW0CXMNF","kind":"event","bakedName":"RESET","curName":"RESET","renames":[],"owner":"workspace","parent":"trt_4ZV009393KMHSTW54E5ZH608KP"},"evt_GT5K3ZC82V41DW2X7AF12QYSRB":{"id":"evt_GT5K3ZC82V41DW2X7AF12QYSRB","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_4ZV009393KMHSTW54E5ZH608KP"},"evt_KVQ7S2CS5ZCJZRHYMJ5A78K5MP":{"id":"evt_KVQ7S2CS5ZCJZRHYMJ5A78K5MP","kind":"event","bakedName":"TOOLS_FAILED","curName":"TOOLS_FAILED","renames":[],"owner":"workspace","parent":"trt_KA2DR48C2T61D05FEFT2KK77EB"},"evt_S8W1YQ82BK15SVY7XXYEA8TEYB":{"id":"evt_S8W1YQ82BK15SVY7XXYEA8TEYB","kind":"event","bakedName":"TOOLS_CALLED","curName":"TOOLS_CALLED","renames":[],"owner":"workspace","parent":"trt_4ZV009393KMHSTW54E5ZH608KP"},"evt_YT8KDP0CFV67XR0RE28XGGBRPS":{"id":"evt_YT8KDP0CFV67XR0RE28XGGBRPS","kind":"event","bakedName":"RESET","curName":"RESET","renames":[],"owner":"workspace","parent":"trt_KA2DR48C2T61D05FEFT2KK77EB"},"evt_Z6C6EEJ7J43S2B5CHTSD224FZN":{"id":"evt_Z6C6EEJ7J43S2B5CHTSD224FZN","kind":"event","bakedName":"CALL_TOOLS","curName":"CALL_TOOLS","renames":[],"owner":"workspace","parent":"trt_KA2DR48C2T61D05FEFT2KK77EB"},"orb_3F0B6P7SBYWNZCA7S2EQSZ5XV1":{"id":"orb_3F0B6P7SBYWNZCA7S2EQSZ5XV1","kind":"orbital","bakedName":"AgentToolCallOrbital","curName":"AgentToolCallOrbital","renames":[],"owner":"workspace"},"pag_NME6YNZF56QJK2YJ98219EWRWG":{"id":"pag_NME6YNZF56QJK2YJ98219EWRWG","kind":"page","bakedName":"AgentToolCallPage","curName":"AgentToolCallPage","renames":[],"owner":"workspace"},"trt_4ZV009393KMHSTW54E5ZH608KP":{"id":"trt_4ZV009393KMHSTW54E5ZH608KP","kind":"trait","bakedName":"ToolCallReady","curName":"ToolCallReady","renames":[],"owner":"workspace"},"trt_KA2DR48C2T61D05FEFT2KK77EB":{"id":"trt_KA2DR48C2T61D05FEFT2KK77EB","kind":"trait","bakedName":"ToolCallExecution","curName":"ToolCallExecution","renames":[],"owner":"workspace"}}}}
1	+ {"name":"std-agent-tool-call","version":"1.0.0","description":"Wraps llm/call-tools — takes messages + tools, returns tool-call result.","orbitals":[{"name":"AgentToolCallOrbital","id":"orb_3F0B6P7SBYWNZCA7S2EQSZ5XV1","entity":{"name":"ToolCall","id":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00","persistence":"runtime","fields":[{"name":"messages","type":"array","default":[],"items":{"type":"object","properties":{"role":{"name":"role","type":"string","required":true},"toolCalls":{"name":"toolCalls","type":"array","required":false,"items":{"type":"object","properties":{"function":{"name":"function","type":"object","required":false,"properties":{"arguments":{"name":"arguments","type":"string","required":true},"name":{"name":"name","type":"string","required":true}}},"id":{"name":"id","type":"string","required":true},"type":{"name":"type","type":"string","required":false,"values":["function"]}}}},"toolCallId":{"name":"toolCallId","type":"string","required":false},"content":{"name":"content","type":"string","required":true}}}},{"name":"tools","type":"array","default":[],"items":{"type":"object","properties":{"name":{"name":"name","type":"string","required":true},"description":{"name":"description","type":"string","required":true},"schema":{"name":"schema","type":"object","required":false,"properties":{"type":{"name":"type","type":"string","required":false},"description":{"name":"description","type":"string","required":false}}}}}},{"name":"response","type":"string","default":""},{"name":"status","type":"string","default":"idle","values":["idle","done"]}]},"traits":[{"name":"ToolCallExecution","id":"trt_KA2DR48C2T61D05FEFT2KK77EB","effectRow":[{"kind":"llm/call-tools"},{"kind":"set","resource":"@entity.messages"},{"kind":"set","resource":"@entity.response"},{"kind":"set","resource":"@entity.status"},{"kind":"set","resource":"@entity.tools"}],"category":"lifecycle","linkedEntity":"ToolCall","linkedEntityId":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00","entityRefIds":{"ToolCall":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00"},"emits":[{"event":"TOOLS_CALLED","eventId":"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS","payloadSchema":[{"name":"result","type":"string","required":true}]}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"calling"},{"name":"done"}],"events":[{"key":"INIT","id":"evt_4BAB2324KB29NVZ6SJCQ55JA1G","name":"Initialize"},{"key":"CALL_TOOLS","id":"evt_Z6C6EEJ7J43S2B5CHTSD224FZN","name":"Call Tools","payloadSchema":[{"name":"messages","type":"[object]","required":true,"properties":[{"name":"role","type":"string","required":true},{"name":"content","type":"string","required":true},{"name":"toolCalls","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"type","type":"string","values":["function"]},{"name":"function","type":"object","properties":[{"name":"name","type":"string","required":true},{"name":"arguments","type":"string","required":true}]}]},{"name":"toolCallId","type":"string"}]},{"name":"tools","type":"[object]","required":true,"properties":[{"name":"name","type":"string","required":true},{"name":"description","type":"string","required":true},{"name":"schema","type":"object","properties":[{"name":"type","type":"string"},{"name":"description","type":"string"}]}]}],"listened":true},{"key":"TOOLS_CALLED","id":"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS","name":"Tools Called","payloadSchema":[{"name":"result","type":"string","required":true}]},{"key":"TOOLS_FAILED","id":"evt_KVQ7S2CS5ZCJZRHYMJ5A78K5MP","name":"Tools Failed"},{"key":"RESET","id":"evt_YT8KDP0CFV67XR0RE28XGGBRPS","name":"Reset"}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_4BAB2324KB29NVZ6SJCQ55JA1G","effects":[["set","@entity.messages",[]],["set","@entity.tools",[]],["set","@entity.response",""],["set","@entity.status","idle"]]},{"from":"idle","to":"calling","event":"CALL_TOOLS","eventId":"evt_Z6C6EEJ7J43S2B5CHTSD224FZN","effects":[["set","@entity.messages","@payload.messages"],["set","@entity.tools","@payload.tools"],["llm/call-tools","@entity.messages","@entity.tools",{"emit":{"success":"TOOLS_CALLED","failure":"TOOLS_FAILED"}}]]},{"from":"calling","to":"idle","event":"INIT","eventId":"evt_4BAB2324KB29NVZ6SJCQ55JA1G","effects":[["set","@entity.messages",[]],["set","@entity.tools",[]],["set","@entity.response",""],["set","@entity.status","idle"]]},{"from":"calling","to":"done","event":"TOOLS_CALLED","eventId":"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS","effects":[["set","@entity.response","@payload.result"],["set","@entity.status","done"]]},{"from":"calling","to":"done","event":"TOOLS_FAILED","eventId":"evt_KVQ7S2CS5ZCJZRHYMJ5A78K5MP","effects":[["set","@entity.response",""],["set","@entity.status","done"]]},{"from":"done","to":"done","event":"INIT","eventId":"evt_4BAB2324KB29NVZ6SJCQ55JA1G","effects":[["set","@entity.status","done"]]},{"from":"done","to":"idle","event":"RESET","eventId":"evt_YT8KDP0CFV67XR0RE28XGGBRPS","effects":[["set","@entity.response",""],["set","@entity.messages",[]],["set","@entity.tools",[]],["set","@entity.status","idle"]]}]},"scope":"instance"},{"name":"ToolCallReady","id":"trt_4ZV009393KMHSTW54E5ZH608KP","effectRow":[{"kind":"set","resource":"@entity.status"}],"category":"lifecycle","linkedEntity":"ToolCall","linkedEntityId":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00","entityRefIds":{"ToolCall":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00"},"listens":[{"event":"TOOLS_CALLED","eventId":"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS","triggers":"TOOLS_CALLED","triggersId":"evt_S8W1YQ82BK15SVY7XXYEA8TEYB","source":{"kind":"trait","trait":"ToolCallExecution","traitId":"trt_KA2DR48C2T61D05FEFT2KK77EB"}}],"stateMachine":{"states":[{"name":"waiting","isInitial":true},{"name":"ready"}],"events":[{"key":"INIT","id":"evt_GT5K3ZC82V41DW2X7AF12QYSRB","name":"Initialize"},{"key":"TOOLS_CALLED","id":"evt_S8W1YQ82BK15SVY7XXYEA8TEYB","name":"Tools Called"},{"key":"RESET","id":"evt_EAG3HVKWGRY8CEWWZARW0CXMNF","name":"Reset","listened":true}],"transitions":[{"from":"waiting","to":"waiting","event":"INIT","eventId":"evt_GT5K3ZC82V41DW2X7AF12QYSRB","effects":[["set","@entity.status","idle"]]},{"from":"waiting","to":"ready","event":"TOOLS_CALLED","eventId":"evt_S8W1YQ82BK15SVY7XXYEA8TEYB","effects":[["set","@entity.status","done"]]},{"from":"ready","to":"ready","event":"INIT","eventId":"evt_GT5K3ZC82V41DW2X7AF12QYSRB","effects":[["set","@entity.status","done"]]},{"from":"ready","to":"waiting","event":"RESET","eventId":"evt_EAG3HVKWGRY8CEWWZARW0CXMNF","effects":[["set","@entity.status","idle"]]}]},"scope":"instance"}],"pages":[{"name":"AgentToolCallPage","id":"pag_NME6YNZF56QJK2YJ98219EWRWG","path":"/agent-tool-call","traits":[{"ref":"ToolCallExecution","refId":"trt_KA2DR48C2T61D05FEFT2KK77EB"},{"ref":"ToolCallReady","refId":"trt_4ZV009393KMHSTW54E5ZH608KP"}]}],"types":{"LlmMessage":[{"name":"role","type":"string","required":true},{"name":"content","type":"string","required":true},{"name":"toolCalls","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"type","type":"string","values":["function"]},{"name":"function","type":"object","properties":[{"name":"name","type":"string","required":true},{"name":"arguments","type":"string","required":true}]}]},{"name":"toolCallId","type":"string"}],"LlmToolCall":[{"name":"id","type":"string","required":true},{"name":"type","type":"string","values":["function"]},{"name":"function","type":"object","properties":[{"name":"name","type":"string","required":true},{"name":"arguments","type":"string","required":true}]}],"LlmToolDef":[{"name":"name","type":"string","required":true},{"name":"description","type":"string","required":true},{"name":"schema","type":"object","properties":[{"name":"type","type":"string"},{"name":"description","type":"string"}]}],"LlmToolSchema":[{"name":"type","type":"string"},{"name":"description","type":"string"}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_A0PSVSPTN0DAGAD3RPM4NP1K00":{"id":"ent_A0PSVSPTN0DAGAD3RPM4NP1K00","kind":"entity","bakedName":"ToolCall","curName":"ToolCall","renames":[],"owner":"workspace"},"evt_4BAB2324KB29NVZ6SJCQ55JA1G":{"id":"evt_4BAB2324KB29NVZ6SJCQ55JA1G","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_KA2DR48C2T61D05FEFT2KK77EB"},"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS":{"id":"evt_DHZQQJW1CQ0PBXS7XA1DTHSZRS","kind":"event","bakedName":"TOOLS_CALLED","curName":"TOOLS_CALLED","renames":[],"owner":"workspace","parent":"trt_KA2DR48C2T61D05FEFT2KK77EB"},"evt_EAG3HVKWGRY8CEWWZARW0CXMNF":{"id":"evt_EAG3HVKWGRY8CEWWZARW0CXMNF","kind":"event","bakedName":"RESET","curName":"RESET","renames":[],"owner":"workspace","parent":"trt_4ZV009393KMHSTW54E5ZH608KP"},"evt_GT5K3ZC82V41DW2X7AF12QYSRB":{"id":"evt_GT5K3ZC82V41DW2X7AF12QYSRB","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_4ZV009393KMHSTW54E5ZH608KP"},"evt_KVQ7S2CS5ZCJZRHYMJ5A78K5MP":{"id":"evt_KVQ7S2CS5ZCJZRHYMJ5A78K5MP","kind":"event","bakedName":"TOOLS_FAILED","curName":"TOOLS_FAILED","renames":[],"owner":"workspace","parent":"trt_KA2DR48C2T61D05FEFT2KK77EB"},"evt_S8W1YQ82BK15SVY7XXYEA8TEYB":{"id":"evt_S8W1YQ82BK15SVY7XXYEA8TEYB","kind":"event","bakedName":"TOOLS_CALLED","curName":"TOOLS_CALLED","renames":[],"owner":"workspace","parent":"trt_4ZV009393KMHSTW54E5ZH608KP"},"evt_YT8KDP0CFV67XR0RE28XGGBRPS":{"id":"evt_YT8KDP0CFV67XR0RE28XGGBRPS","kind":"event","bakedName":"RESET","curName":"RESET","renames":[],"owner":"workspace","parent":"trt_KA2DR48C2T61D05FEFT2KK77EB"},"evt_Z6C6EEJ7J43S2B5CHTSD224FZN":{"id":"evt_Z6C6EEJ7J43S2B5CHTSD224FZN","kind":"event","bakedName":"CALL_TOOLS","curName":"CALL_TOOLS","renames":[],"owner":"workspace","parent":"trt_KA2DR48C2T61D05FEFT2KK77EB"},"orb_3F0B6P7SBYWNZCA7S2EQSZ5XV1":{"id":"orb_3F0B6P7SBYWNZCA7S2EQSZ5XV1","kind":"orbital","bakedName":"AgentToolCallOrbital","curName":"AgentToolCallOrbital","renames":[],"owner":"workspace"},"pag_NME6YNZF56QJK2YJ98219EWRWG":{"id":"pag_NME6YNZF56QJK2YJ98219EWRWG","kind":"page","bakedName":"AgentToolCallPage","curName":"AgentToolCallPage","renames":[],"owner":"workspace"},"trt_4ZV009393KMHSTW54E5ZH608KP":{"id":"trt_4ZV009393KMHSTW54E5ZH608KP","kind":"trait","bakedName":"ToolCallReady","curName":"ToolCallReady","renames":[],"owner":"workspace"},"trt_KA2DR48C2T61D05FEFT2KK77EB":{"id":"trt_KA2DR48C2T61D05FEFT2KK77EB","kind":"trait","bakedName":"ToolCallExecution","curName":"ToolCallExecution","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/agent/atoms/std-agent-tool-loop.orb CHANGED Viewed

	@@ -1 +1 @@
1	- {"name":"std-agent-tool-loop","version":"2.0.0","description":"std-agent-tool-loop — answers a conversation by operating the running app as the caller, through `call-service llm call-tools`. Its `tools` are `{ scope: declared }` (every declared external input plus a read over every persisted entity), or named declared inputs (addressed like a listens source: `Trait.EVENT`, `Orbital.Trait.EVENT`) and entities to read; each input fires as the signed-in user through the ordinary dispatch (guards and entity policies apply) and each read returns only the rows the caller may read. Headless: the conversation UI (std-agent-session) shows the reply; a failure shows as a toast, unless `quiet` is on (a background run nobody is watching: no live steps and no toast). CONVERSE carries the conversation (and optionally what std-agent-memory recalled); ASSISTANT_STEP carries each step live while it works (a model call, a tool it used, what the app answered) to the asking tab; ASSISTANT_REPLIED carries the reply, every step and the token usage; ASSISTANT_REPLY_FAILED carries the error. These names are the assistant contract std-agent-session's conversation hears from any orbital. Compose with std-agent-session (the conversation) and std-agent-trace (the step record).","orbitals":[{"name":"AgentToolLoopOrbital","id":"orb_B4FJ4MABN35THR8C5KF605CGH6","entity":{"name":"AgentTurn","id":"ent_Q1714QZNJBTS5XKW3MMX6A5W5R","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"status","type":"string","default":"idle","values":["idle","thinking","answered","failed"],"description":"Where the current turn is."},{"name":"reply","type":"string","default":"","description":"The last reply."},{"name":"error","type":"string","default":"","description":"Why the last turn failed."},{"name":"ephemeral","type":"boolean","default":false,"description":"The current turn belongs to an ephemeral conversation."}]},"traits":[{"name":"AgentToolLoop","id":"trt_905GG00P1YB0ZBV5QE54DKSQ79","effectRow":[{"kind":"call-service","resource":"llm.call-tools"},{"kind":"cancel-call"},{"kind":"emit","resource":"ASSISTANT_REPLIED"},{"kind":"emit","resource":"ASSISTANT_REPLY_FAILED"},{"kind":"render-ui","resource":"toast"},{"kind":"set","resource":"@entity.ephemeral"},{"kind":"set","resource":"@entity.error"},{"kind":"set","resource":"@entity.reply"},{"kind":"set","resource":"@entity.status"}],"category":"interaction","linkedEntity":"AgentTurn","linkedEntityId":"ent_Q1714QZNJBTS5XKW3MMX6A5W5R","entityRefIds":{"AgentTurn":"ent_Q1714QZNJBTS5XKW3MMX6A5W5R"},"emits":[{"event":"ASSISTANT_STEP","eventId":"evt_RRK9X3KSCJWP9AHCWNX7231S78","description":"One thing the assistant just did, live while it works: a model call, a tool it used, or what the app answered. Delivered to the asking tab only.","synonyms":"progress, activity, trace step, working","tier":"domain","scope":"external","payloadSchema":[{"name":"activity","type":"union","required":true,"properties":[{"name":"AgentToolCallActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}]},{"name":"AgentToolResultActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}]},{"name":"AgentLlmResponseActivity","type":"object","properties":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}]}]}]},{"event":"ASSISTANT_REPLIED","eventId":"evt_GXSYKR5S2TWHDCG7E2CN06MBKE","description":"The assistant answered; carries every tool step it took and the tokens it used. `ephemeral` echoes the conversation's: an ephemeral reply is not stored or remembered, and only an ephemeral conversation shows it.","synonyms":"answered, responded, done","tier":"domain","scope":"external","payloadSchema":[{"name":"reply","type":"string","required":true},{"name":"steps","type":"[AgentActivity]","required":true},{"name":"usage","type":"object","required":true,"properties":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]},{"name":"ephemeral","type":"boolean"}]},{"event":"ASSISTANT_REPLY_FAILED","eventId":"evt_M34HSMFYJPZ9B7HVZPEFDBTQ76","description":"The assistant could not answer (model unavailable, or out of steps).","synonyms":"failed, error, gave up","tier":"domain","scope":"external","payloadSchema":[{"name":"error","type":"string","required":true},{"name":"ephemeral","type":"boolean"}]},{"event":"ANSWERED","eventId":"evt_NZ8B06SCC4P62AWYPEN9YSDSSF","tier":"internal","scope":"internal","payloadSchema":[{"name":"reply","type":"string","required":true},{"name":"steps","type":"[AgentActivity]","required":true},{"name":"usage","type":"object","required":true,"properties":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]}]},{"event":"ASK_FAILED","eventId":"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q","tier":"internal","scope":"internal","payloadSchema":[{"name":"error","type":"string","required":true}]}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"thinking"}],"events":[{"key":"INIT","id":"evt_EX4BEGBES8QCM9GV67CZSGPSG4","name":"Initialize"},{"key":"CONVERSE","id":"evt_RK84DWY67W33YC6T1NPH1TBZDV","name":"Converse","description":"Answer this conversation; the last turn is the request. `context` is what the assistant remembers that may be relevant. An `ephemeral` conversation runs under its own `instructions` (empty: the configured ones) and exactly its own `tools` (absent or `[]`: none, never the configured ones), streams no live steps and shows no failure toast.","synonyms":"ask, chat, request","payloadSchema":[{"name":"messages","type":"[object]","required":true,"properties":[{"name":"role","type":"string","values":["user","assistant"]},{"name":"content","type":"string","required":true}]},{"name":"context","type":"string"},{"name":"instructions","type":"string"},{"name":"tools","type":"[AgentTool]"},{"name":"ephemeral","type":"boolean"}],"listened":true},{"key":"CANCEL","id":"evt_ZK1B49GVH6DRK08NC79T1161B0","name":"Cancel","description":"Abort the request in flight; nothing is replied and no failure is reported.","synonyms":"stop, abort, cancel","listened":true},{"key":"ANSWERED","id":"evt_NZ8B06SCC4P62AWYPEN9YSDSSF","name":"Answered","tier":"internal","payloadSchema":[{"name":"reply","type":"string","required":true},{"name":"steps","type":"[AgentActivity]","required":true},{"name":"usage","type":"object","required":true,"properties":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]}]},{"key":"ASK_FAILED","id":"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q","name":"Ask Failed","tier":"internal","payloadSchema":[{"name":"error","type":"string","required":true}]},{"key":"ASSISTANT_STEP","id":"evt_RRK9X3KSCJWP9AHCWNX7231S78","name":"Assistant Step","description":"One thing the assistant just did, live while it works: a model call, a tool it used, or what the app answered. Delivered to the asking tab only.","synonyms":"progress, activity, trace step, working","tier":"domain","payloadSchema":[{"name":"activity","type":"union","required":true,"properties":[{"name":"AgentToolCallActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}]},{"name":"AgentToolResultActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}]},{"name":"AgentLlmResponseActivity","type":"object","properties":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}]}]}]},{"key":"ASSISTANT_REPLIED","id":"evt_GXSYKR5S2TWHDCG7E2CN06MBKE","name":"Assistant Replied","description":"The assistant answered; carries every tool step it took and the tokens it used. `ephemeral` echoes the conversation's: an ephemeral reply is not stored or remembered, and only an ephemeral conversation shows it.","synonyms":"answered, responded, done","tier":"domain","payloadSchema":[{"name":"reply","type":"string","required":true},{"name":"steps","type":"[AgentActivity]","required":true},{"name":"usage","type":"object","required":true,"properties":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]},{"name":"ephemeral","type":"boolean"}]},{"key":"ASSISTANT_REPLY_FAILED","id":"evt_M34HSMFYJPZ9B7HVZPEFDBTQ76","name":"Assistant Reply Failed","description":"The assistant could not answer (model unavailable, or out of steps).","synonyms":"failed, error, gave up","tier":"domain","payloadSchema":[{"name":"error","type":"string","required":true},{"name":"ephemeral","type":"boolean"}]}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_EX4BEGBES8QCM9GV67CZSGPSG4","effects":[["set","@entity.status","idle"]]},{"from":"idle","to":"thinking","event":"CONVERSE","eventId":"evt_RK84DWY67W33YC6T1NPH1TBZDV","guard":["and",["not","@config.quiet"],["not","@payload.ephemeral"]],"effects":[["set","@entity.status","thinking"],["set","@entity.ephemeral",false],["call-service","llm","call-tools",{"messages":"@payload.messages","tools":"@config.tools","instructions":["if",["=",["str/default","@payload.context",""],""],"@config.instructions",["str/concat","@config.instructions","\n\nWhat you remember that may be relevant:\n","@payload.context"]],"maxSteps":"@config.maxSteps"},{"key":"@config.cancelKey","emit":{"failure":"ASK_FAILED","success":"ANSWERED","onMessage":"ASSISTANT_STEP"}}]]},{"from":"idle","to":"thinking","event":"CONVERSE","eventId":"evt_RK84DWY67W33YC6T1NPH1TBZDV","guard":["and","@config.quiet",["not","@payload.ephemeral"]],"effects":[["set","@entity.status","thinking"],["set","@entity.ephemeral",false],["call-service","llm","call-tools",{"messages":"@payload.messages","tools":"@config.tools","instructions":["if",["=",["str/default","@payload.context",""],""],"@config.instructions",["str/concat","@config.instructions","\n\nWhat you remember that may be relevant:\n","@payload.context"]],"maxSteps":"@config.maxSteps"},{"key":"@config.cancelKey","emit":{"failure":"ASK_FAILED","success":"ANSWERED"}}]]},{"from":"idle","to":"thinking","event":"CONVERSE","eventId":"evt_RK84DWY67W33YC6T1NPH1TBZDV","guard":"@payload.ephemeral","effects":[["set","@entity.status","thinking"],["set","@entity.ephemeral",true],["call-service","llm","call-tools",{"messages":"@payload.messages","tools":["object/get","@payload","tools",[]],"instructions":["if",["=",["str/default","@payload.instructions",""],""],"@config.instructions","@payload.instructions"],"maxSteps":"@config.maxSteps"},{"key":"@config.cancelKey","emit":{"failure":"ASK_FAILED","success":"ANSWERED"}}]]},{"from":"thinking","to":"idle","event":"INIT","eventId":"evt_EX4BEGBES8QCM9GV67CZSGPSG4","effects":[["set","@entity.status","idle"]]},{"from":"thinking","to":"idle","event":"CANCEL","eventId":"evt_ZK1B49GVH6DRK08NC79T1161B0","effects":[["cancel-call","@config.cancelKey"],["set","@entity.status","idle"]]},{"from":"thinking","to":"idle","event":"ANSWERED","eventId":"evt_NZ8B06SCC4P62AWYPEN9YSDSSF","effects":[["set","@entity.status","answered"],["set","@entity.reply","@payload.reply"],["emit","ASSISTANT_REPLIED",{"reply":"@payload.reply","steps":"@payload.steps","usage":"@payload.usage","ephemeral":"@entity.ephemeral"}]]},{"from":"thinking","to":"idle","event":"ASK_FAILED","eventId":"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q","guard":["or","@config.quiet","@entity.ephemeral"],"effects":[["set","@entity.status","failed"],["set","@entity.error","@payload.error"],["emit","ASSISTANT_REPLY_FAILED",{"error":"@payload.error","ephemeral":"@entity.ephemeral"}]]},{"from":"thinking","to":"idle","event":"ASK_FAILED","eventId":"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q","guard":["and",["not","@config.quiet"],["not","@entity.ephemeral"]],"effects":[["set","@entity.status","failed"],["set","@entity.error","@payload.error"],["emit","ASSISTANT_REPLY_FAILED",{"error":"@payload.error","ephemeral":"@entity.ephemeral"}],["render-ui","toast",{"message":"@payload.error","type":"alert","variant":"error"}]]}]},"config":{"tools":{"type":"[AgentTool]","default":[],"label":"What may the assistant do?","description":"The declared inputs it may fire (`{ event: Trait.EVENT }`) and the entities it may read (`{ read: Entity }`), as the signed-in user.","synonyms":"allowlist, abilities, actions, permissions","tier":"domain","items":{"type":"union","values":["AgentToolScope","AgentToolInput","AgentToolRead"],"properties":{"AgentToolInput":{"name":"AgentToolInput","type":"object","properties":{"payload":{"name":"payload","type":"array","required":false,"items":{"type":"object","properties":{"properties":{"name":"properties","type":"array","required":false,"items":{"type":"union","values":["AgentToolField"]}},"type":{"name":"type","type":"string","required":true},"name":{"name":"name","type":"string","required":true},"values":{"name":"values","type":"array","required":false,"items":{"type":"string"}},"description":{"name":"description","type":"string","required":false},"required":{"name":"required","type":"boolean","required":false}}}},"event":{"name":"event","type":"EventAddress","required":true}}},"AgentToolScope":{"name":"AgentToolScope","type":"object","properties":{"scope":{"name":"scope","type":"string","required":true,"values":["declared"]}}},"AgentToolRead":{"name":"AgentToolRead","type":"object","properties":{"read":{"name":"read","type":"string","required":true}}}}}},"instructions":{"type":"string","default":"You operate this app for the signed-in user. Use the tools to act and to look things up; when a tool reports that something was refused or denied, say so plainly.","label":"How should the assistant behave?","description":"Standing instructions sent with every conversation.","synonyms":"system prompt, persona, guidance","tier":"domain"},"quiet":{"type":"boolean","default":false,"label":"Run in the background?","description":"No live ASSISTANT_STEP stream and no failure toast: the request is reported only through ASSISTANT_REPLIED and ASSISTANT_REPLY_FAILED. For a run nobody is watching, such as one the app starts on its own.","synonyms":"silent, background, no toast, suppress errors, headless run","tier":"policy"},"cancelKey":{"type":"string","default":"agent-tool-loop","label":"Cancel key","description":"The key this instance's model call runs under, so CANCEL aborts it. Give each instance of the loop in one app its own.","synonyms":"call key, abort key","tier":"internal"},"maxSteps":{"type":"number","default":8,"label":"Model round-trips per request","description":"How many model calls one request may take before it fails.","tier":"policy"}},"scope":"instance"}],"pages":[{"name":"AgentToolLoopPage","id":"pag_TD83PWPF757KJMDYZ13RBQC57R","path":"/agent-tool-loop","traits":[{"ref":"AgentToolLoop","refId":"trt_905GG00P1YB0ZBV5QE54DKSQ79"}]}],"types":{"AgentActivity":[{"name":"","type":"union","properties":[{"name":"AgentToolCallActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}]},{"name":"AgentToolResultActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}]},{"name":"AgentLlmResponseActivity","type":"object","properties":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}]}]}],"AgentChatMessage":[{"name":"role","type":"string","values":["user","assistant"]},{"name":"content","type":"string","required":true}],"AgentLlmCall":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}],"AgentLlmResponseActivity":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}],"AgentTool":[{"name":"","type":"union","properties":[{"name":"AgentToolScope","type":"object","properties":[{"name":"scope","type":"string","values":["declared"],"required":true}]},{"name":"AgentToolInput","type":"object","properties":[{"name":"event","type":"EventAddress","required":true},{"name":"payload","type":"[object]","properties":[{"name":"name","type":"string","required":true},{"name":"type","type":"string","required":true},{"name":"required","type":"boolean"},{"name":"values","type":"[string]"},{"name":"properties","type":"[AgentToolField]","properties":[]},{"name":"description","type":"string"}]}]},{"name":"AgentToolRead","type":"object","properties":[{"name":"read","type":"string","required":true}]}]}],"AgentToolCallActivity":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}],"AgentToolField":[{"name":"name","type":"string","required":true},{"name":"type","type":"string","required":true},{"name":"required","type":"boolean"},{"name":"values","type":"[string]"},{"name":"properties","type":"[object]","properties":[{"name":"name","type":"string","required":true},{"name":"type","type":"string","required":true},{"name":"required","type":"boolean"},{"name":"values","type":"[string]"},{"name":"properties","type":"[AgentToolField]","properties":[]},{"name":"description","type":"string"}]},{"name":"description","type":"string"}],"AgentToolInput":[{"name":"event","type":"EventAddress","required":true},{"name":"payload","type":"[object]","properties":[{"name":"name","type":"string","required":true},{"name":"type","type":"string","required":true},{"name":"required","type":"boolean"},{"name":"values","type":"[string]"},{"name":"properties","type":"[AgentToolField]","properties":[]},{"name":"description","type":"string"}]}],"AgentToolRead":[{"name":"read","type":"string","required":true}],"AgentToolResultActivity":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}],"AgentToolScope":[{"name":"scope","type":"string","values":["declared"],"required":true}],"AgentUsage":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_Q1714QZNJBTS5XKW3MMX6A5W5R":{"id":"ent_Q1714QZNJBTS5XKW3MMX6A5W5R","kind":"entity","bakedName":"AgentTurn","curName":"AgentTurn","renames":[],"owner":"workspace"},"evt_EX4BEGBES8QCM9GV67CZSGPSG4":{"id":"evt_EX4BEGBES8QCM9GV67CZSGPSG4","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_GXSYKR5S2TWHDCG7E2CN06MBKE":{"id":"evt_GXSYKR5S2TWHDCG7E2CN06MBKE","kind":"event","bakedName":"ASSISTANT_REPLIED","curName":"ASSISTANT_REPLIED","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q":{"id":"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q","kind":"event","bakedName":"ASK_FAILED","curName":"ASK_FAILED","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_M34HSMFYJPZ9B7HVZPEFDBTQ76":{"id":"evt_M34HSMFYJPZ9B7HVZPEFDBTQ76","kind":"event","bakedName":"ASSISTANT_REPLY_FAILED","curName":"ASSISTANT_REPLY_FAILED","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_NZ8B06SCC4P62AWYPEN9YSDSSF":{"id":"evt_NZ8B06SCC4P62AWYPEN9YSDSSF","kind":"event","bakedName":"ANSWERED","curName":"ANSWERED","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_RK84DWY67W33YC6T1NPH1TBZDV":{"id":"evt_RK84DWY67W33YC6T1NPH1TBZDV","kind":"event","bakedName":"CONVERSE","curName":"CONVERSE","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_RRK9X3KSCJWP9AHCWNX7231S78":{"id":"evt_RRK9X3KSCJWP9AHCWNX7231S78","kind":"event","bakedName":"ASSISTANT_STEP","curName":"ASSISTANT_STEP","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_ZK1B49GVH6DRK08NC79T1161B0":{"id":"evt_ZK1B49GVH6DRK08NC79T1161B0","kind":"event","bakedName":"CANCEL","curName":"CANCEL","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"orb_B4FJ4MABN35THR8C5KF605CGH6":{"id":"orb_B4FJ4MABN35THR8C5KF605CGH6","kind":"orbital","bakedName":"AgentToolLoopOrbital","curName":"AgentToolLoopOrbital","renames":[],"owner":"workspace"},"pag_TD83PWPF757KJMDYZ13RBQC57R":{"id":"pag_TD83PWPF757KJMDYZ13RBQC57R","kind":"page","bakedName":"AgentToolLoopPage","curName":"AgentToolLoopPage","renames":[],"owner":"workspace"},"trt_905GG00P1YB0ZBV5QE54DKSQ79":{"id":"trt_905GG00P1YB0ZBV5QE54DKSQ79","kind":"trait","bakedName":"AgentToolLoop","curName":"AgentToolLoop","renames":[],"owner":"workspace"}}}}
1	+ {"name":"std-agent-tool-loop","version":"2.0.0","description":"std-agent-tool-loop — answers a conversation by operating the running app as the caller, through `call-service llm call-tools`. Its `tools` are `{ scope: declared }` (every declared external input plus a read over every persisted entity), or named declared inputs (addressed like a listens source: `Trait.EVENT`, `Orbital.Trait.EVENT`) and entities to read; each input fires as the signed-in user through the ordinary dispatch (guards and entity policies apply) and each read returns only the rows the caller may read. Headless: the conversation UI (std-agent-session) shows the reply; a failure shows as a toast, unless `quiet` is on (a background run nobody is watching: no live steps and no toast). CONVERSE carries the conversation (and optionally what std-agent-memory recalled); ASSISTANT_STEP carries each step live while it works (a model call, a tool it used, what the app answered) to the asking tab; ASSISTANT_REPLIED carries the reply, every step and the token usage; ASSISTANT_REPLY_FAILED carries the error. These names are the assistant contract std-agent-session's conversation hears from any orbital. Compose with std-agent-session (the conversation) and std-agent-trace (the step record).","orbitals":[{"name":"AgentToolLoopOrbital","id":"orb_B4FJ4MABN35THR8C5KF605CGH6","entity":{"name":"AgentTurn","id":"ent_Q1714QZNJBTS5XKW3MMX6A5W5R","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"status","type":"string","default":"idle","values":["idle","thinking","answered","failed"],"description":"Where the current turn is."},{"name":"reply","type":"string","default":"","description":"The last reply."},{"name":"error","type":"string","default":"","description":"Why the last turn failed."},{"name":"ephemeral","type":"boolean","default":false,"description":"The current turn belongs to an ephemeral conversation."}]},"traits":[{"name":"AgentToolLoop","id":"trt_905GG00P1YB0ZBV5QE54DKSQ79","effectRow":[{"kind":"call-service","resource":"llm.call-tools"},{"kind":"cancel-call"},{"kind":"emit","resource":"ASSISTANT_REPLIED"},{"kind":"emit","resource":"ASSISTANT_REPLY_FAILED"},{"kind":"render-ui","resource":"toast"},{"kind":"set","resource":"@entity.ephemeral"},{"kind":"set","resource":"@entity.error"},{"kind":"set","resource":"@entity.reply"},{"kind":"set","resource":"@entity.status"}],"category":"interaction","linkedEntity":"AgentTurn","linkedEntityId":"ent_Q1714QZNJBTS5XKW3MMX6A5W5R","entityRefIds":{"AgentTurn":"ent_Q1714QZNJBTS5XKW3MMX6A5W5R"},"emits":[{"event":"ASSISTANT_STEP","eventId":"evt_RRK9X3KSCJWP9AHCWNX7231S78","description":"One thing the assistant just did, live while it works: a model call, a tool it used, or what the app answered. Delivered to the asking tab only.","synonyms":"progress, activity, trace step, working","tier":"domain","scope":"external","payloadSchema":[{"name":"activity","type":"union","required":true,"properties":[{"name":"AgentToolCallActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}]},{"name":"AgentToolResultActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}]},{"name":"AgentLlmResponseActivity","type":"object","properties":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}]}]}]},{"event":"ASSISTANT_REPLIED","eventId":"evt_GXSYKR5S2TWHDCG7E2CN06MBKE","description":"The assistant answered; carries every tool step it took and the tokens it used. `ephemeral` echoes the conversation's: an ephemeral reply is not stored or remembered, and only an ephemeral conversation shows it.","synonyms":"answered, responded, done","tier":"domain","scope":"external","payloadSchema":[{"name":"reply","type":"string","required":true},{"name":"steps","type":"[AgentActivity]","required":true},{"name":"usage","type":"object","required":true,"properties":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]},{"name":"ephemeral","type":"boolean"}]},{"event":"ASSISTANT_REPLY_FAILED","eventId":"evt_M34HSMFYJPZ9B7HVZPEFDBTQ76","description":"The assistant could not answer (model unavailable, or out of steps).","synonyms":"failed, error, gave up","tier":"domain","scope":"external","payloadSchema":[{"name":"error","type":"string","required":true},{"name":"ephemeral","type":"boolean"}]},{"event":"ANSWERED","eventId":"evt_NZ8B06SCC4P62AWYPEN9YSDSSF","tier":"internal","scope":"internal","payloadSchema":[{"name":"reply","type":"string","required":true},{"name":"steps","type":"[AgentActivity]","required":true},{"name":"usage","type":"object","required":true,"properties":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]}]},{"event":"ASK_FAILED","eventId":"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q","tier":"internal","scope":"internal","payloadSchema":[{"name":"error","type":"string","required":true}]}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"thinking"}],"events":[{"key":"INIT","id":"evt_EX4BEGBES8QCM9GV67CZSGPSG4","name":"Initialize"},{"key":"CONVERSE","id":"evt_RK84DWY67W33YC6T1NPH1TBZDV","name":"Converse","description":"Answer this conversation; the last turn is the request. `context` is what the assistant remembers that may be relevant. An `ephemeral` conversation runs under its own `instructions` (empty: the configured ones) and exactly its own `tools` (absent or `[]`: none, never the configured ones), streams no live steps and shows no failure toast.","synonyms":"ask, chat, request","payloadSchema":[{"name":"messages","type":"[object]","required":true,"properties":[{"name":"role","type":"string","values":["user","assistant"]},{"name":"content","type":"string","required":true}]},{"name":"context","type":"string"},{"name":"instructions","type":"string"},{"name":"tools","type":"[AgentTool]"},{"name":"ephemeral","type":"boolean"}],"listened":true},{"key":"CANCEL","id":"evt_ZK1B49GVH6DRK08NC79T1161B0","name":"Cancel","description":"Abort the request in flight; nothing is replied and no failure is reported.","synonyms":"stop, abort, cancel","listened":true},{"key":"ANSWERED","id":"evt_NZ8B06SCC4P62AWYPEN9YSDSSF","name":"Answered","tier":"internal","payloadSchema":[{"name":"reply","type":"string","required":true},{"name":"steps","type":"[AgentActivity]","required":true},{"name":"usage","type":"object","required":true,"properties":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]}]},{"key":"ASK_FAILED","id":"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q","name":"Ask Failed","tier":"internal","payloadSchema":[{"name":"error","type":"string","required":true}]},{"key":"ASSISTANT_STEP","id":"evt_RRK9X3KSCJWP9AHCWNX7231S78","name":"Assistant Step","description":"One thing the assistant just did, live while it works: a model call, a tool it used, or what the app answered. Delivered to the asking tab only.","synonyms":"progress, activity, trace step, working","tier":"domain","payloadSchema":[{"name":"activity","type":"union","required":true,"properties":[{"name":"AgentToolCallActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}]},{"name":"AgentToolResultActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}]},{"name":"AgentLlmResponseActivity","type":"object","properties":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}]}]}]},{"key":"ASSISTANT_REPLIED","id":"evt_GXSYKR5S2TWHDCG7E2CN06MBKE","name":"Assistant Replied","description":"The assistant answered; carries every tool step it took and the tokens it used. `ephemeral` echoes the conversation's: an ephemeral reply is not stored or remembered, and only an ephemeral conversation shows it.","synonyms":"answered, responded, done","tier":"domain","payloadSchema":[{"name":"reply","type":"string","required":true},{"name":"steps","type":"[AgentActivity]","required":true},{"name":"usage","type":"object","required":true,"properties":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]},{"name":"ephemeral","type":"boolean"}]},{"key":"ASSISTANT_REPLY_FAILED","id":"evt_M34HSMFYJPZ9B7HVZPEFDBTQ76","name":"Assistant Reply Failed","description":"The assistant could not answer (model unavailable, or out of steps).","synonyms":"failed, error, gave up","tier":"domain","payloadSchema":[{"name":"error","type":"string","required":true},{"name":"ephemeral","type":"boolean"}]}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_EX4BEGBES8QCM9GV67CZSGPSG4","effects":[["set","@entity.status","idle"]]},{"from":"idle","to":"thinking","event":"CONVERSE","eventId":"evt_RK84DWY67W33YC6T1NPH1TBZDV","guard":["and",["not","@config.quiet"],["not","@payload.ephemeral"]],"effects":[["set","@entity.status","thinking"],["set","@entity.ephemeral",false],["call-service","llm","call-tools",{"messages":"@payload.messages","tools":"@config.tools","instructions":["if",["=",["str/default","@payload.context",""],""],"@config.instructions",["str/concat","@config.instructions","\n\nWhat you remember that may be relevant:\n","@payload.context"]],"maxSteps":"@config.maxSteps"},{"key":"@config.cancelKey","emit":{"failure":"ASK_FAILED","success":"ANSWERED","onMessage":"ASSISTANT_STEP"}}]]},{"from":"idle","to":"thinking","event":"CONVERSE","eventId":"evt_RK84DWY67W33YC6T1NPH1TBZDV","guard":["and","@config.quiet",["not","@payload.ephemeral"]],"effects":[["set","@entity.status","thinking"],["set","@entity.ephemeral",false],["call-service","llm","call-tools",{"messages":"@payload.messages","tools":"@config.tools","instructions":["if",["=",["str/default","@payload.context",""],""],"@config.instructions",["str/concat","@config.instructions","\n\nWhat you remember that may be relevant:\n","@payload.context"]],"maxSteps":"@config.maxSteps"},{"key":"@config.cancelKey","emit":{"failure":"ASK_FAILED","success":"ANSWERED"}}]]},{"from":"idle","to":"thinking","event":"CONVERSE","eventId":"evt_RK84DWY67W33YC6T1NPH1TBZDV","guard":"@payload.ephemeral","effects":[["set","@entity.status","thinking"],["set","@entity.ephemeral",true],["call-service","llm","call-tools",{"messages":"@payload.messages","tools":["object/get","@payload","tools",[]],"instructions":["if",["=",["str/default","@payload.instructions",""],""],"@config.instructions","@payload.instructions"],"maxSteps":"@config.maxSteps"},{"key":"@config.cancelKey","emit":{"failure":"ASK_FAILED","success":"ANSWERED"}}]]},{"from":"thinking","to":"idle","event":"INIT","eventId":"evt_EX4BEGBES8QCM9GV67CZSGPSG4","effects":[["set","@entity.status","idle"]]},{"from":"thinking","to":"idle","event":"CANCEL","eventId":"evt_ZK1B49GVH6DRK08NC79T1161B0","effects":[["cancel-call","@config.cancelKey"],["set","@entity.status","idle"]]},{"from":"thinking","to":"idle","event":"ANSWERED","eventId":"evt_NZ8B06SCC4P62AWYPEN9YSDSSF","effects":[["set","@entity.status","answered"],["set","@entity.reply","@payload.reply"],["emit","ASSISTANT_REPLIED",{"reply":"@payload.reply","steps":"@payload.steps","usage":"@payload.usage","ephemeral":"@entity.ephemeral"}]]},{"from":"thinking","to":"idle","event":"ASK_FAILED","eventId":"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q","guard":["or","@config.quiet","@entity.ephemeral"],"effects":[["set","@entity.status","failed"],["set","@entity.error","@payload.error"],["emit","ASSISTANT_REPLY_FAILED",{"error":"@payload.error","ephemeral":"@entity.ephemeral"}]]},{"from":"thinking","to":"idle","event":"ASK_FAILED","eventId":"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q","guard":["and",["not","@config.quiet"],["not","@entity.ephemeral"]],"effects":[["set","@entity.status","failed"],["set","@entity.error","@payload.error"],["emit","ASSISTANT_REPLY_FAILED",{"error":"@payload.error","ephemeral":"@entity.ephemeral"}],["render-ui","toast",{"message":"@payload.error","type":"alert","variant":"error"}]]}]},"config":{"tools":{"type":"[AgentTool]","default":[],"label":"What may the assistant do?","description":"The declared inputs it may fire (`{ event: Trait.EVENT }`) and the entities it may read (`{ read: Entity }`), as the signed-in user.","synonyms":"allowlist, abilities, actions, permissions","tier":"domain","items":{"type":"union","values":["AgentToolScope","AgentToolInput","AgentToolRead"],"properties":{"AgentToolScope":{"name":"AgentToolScope","type":"object","properties":{"scope":{"name":"scope","type":"string","required":true,"values":["declared"]}}},"AgentToolInput":{"name":"AgentToolInput","type":"object","properties":{"event":{"name":"event","type":"EventAddress","required":true},"payload":{"name":"payload","type":"array","required":false,"items":{"type":"object","properties":{"description":{"name":"description","type":"string","required":false},"type":{"name":"type","type":"string","required":true},"name":{"name":"name","type":"string","required":true},"required":{"name":"required","type":"boolean","required":false},"values":{"name":"values","type":"array","required":false,"items":{"type":"string"}},"properties":{"name":"properties","type":"array","required":false,"items":{"type":"union","values":["AgentToolField"]}}}}}}},"AgentToolRead":{"name":"AgentToolRead","type":"object","properties":{"read":{"name":"read","type":"string","required":true}}}}}},"quiet":{"type":"boolean","default":false,"label":"Run in the background?","description":"No live ASSISTANT_STEP stream and no failure toast: the request is reported only through ASSISTANT_REPLIED and ASSISTANT_REPLY_FAILED. For a run nobody is watching, such as one the app starts on its own.","synonyms":"silent, background, no toast, suppress errors, headless run","tier":"policy"},"maxSteps":{"type":"number","default":8,"label":"Model round-trips per request","description":"How many model calls one request may take before it fails.","tier":"policy"},"cancelKey":{"type":"string","default":"agent-tool-loop","label":"Cancel key","description":"The key this instance's model call runs under, so CANCEL aborts it. Give each instance of the loop in one app its own.","synonyms":"call key, abort key","tier":"internal"},"instructions":{"type":"string","default":"You operate this app for the signed-in user. Use the tools to act and to look things up; when a tool reports that something was refused or denied, say so plainly.","label":"How should the assistant behave?","description":"Standing instructions sent with every conversation.","synonyms":"system prompt, persona, guidance","tier":"domain"}},"scope":"instance"}],"pages":[{"name":"AgentToolLoopPage","id":"pag_TD83PWPF757KJMDYZ13RBQC57R","path":"/agent-tool-loop","traits":[{"ref":"AgentToolLoop","refId":"trt_905GG00P1YB0ZBV5QE54DKSQ79"}]}],"types":{"AgentActivity":[{"name":"","type":"union","properties":[{"name":"AgentToolCallActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}]},{"name":"AgentToolResultActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}]},{"name":"AgentLlmResponseActivity","type":"object","properties":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}]}]}],"AgentChatMessage":[{"name":"role","type":"string","values":["user","assistant"]},{"name":"content","type":"string","required":true}],"AgentLlmCall":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}],"AgentLlmResponseActivity":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}],"AgentTool":[{"name":"","type":"union","properties":[{"name":"AgentToolScope","type":"object","properties":[{"name":"scope","type":"string","values":["declared"],"required":true}]},{"name":"AgentToolInput","type":"object","properties":[{"name":"event","type":"EventAddress","required":true},{"name":"payload","type":"[object]","properties":[{"name":"name","type":"string","required":true},{"name":"type","type":"string","required":true},{"name":"required","type":"boolean"},{"name":"values","type":"[string]"},{"name":"properties","type":"[AgentToolField]","properties":[]},{"name":"description","type":"string"}]}]},{"name":"AgentToolRead","type":"object","properties":[{"name":"read","type":"string","required":true}]}]}],"AgentToolCallActivity":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}],"AgentToolField":[{"name":"name","type":"string","required":true},{"name":"type","type":"string","required":true},{"name":"required","type":"boolean"},{"name":"values","type":"[string]"},{"name":"properties","type":"[object]","properties":[{"name":"name","type":"string","required":true},{"name":"type","type":"string","required":true},{"name":"required","type":"boolean"},{"name":"values","type":"[string]"},{"name":"properties","type":"[AgentToolField]","properties":[]},{"name":"description","type":"string"}]},{"name":"description","type":"string"}],"AgentToolInput":[{"name":"event","type":"EventAddress","required":true},{"name":"payload","type":"[object]","properties":[{"name":"name","type":"string","required":true},{"name":"type","type":"string","required":true},{"name":"required","type":"boolean"},{"name":"values","type":"[string]"},{"name":"properties","type":"[AgentToolField]","properties":[]},{"name":"description","type":"string"}]}],"AgentToolRead":[{"name":"read","type":"string","required":true}],"AgentToolResultActivity":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}],"AgentToolScope":[{"name":"scope","type":"string","values":["declared"],"required":true}],"AgentUsage":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_Q1714QZNJBTS5XKW3MMX6A5W5R":{"id":"ent_Q1714QZNJBTS5XKW3MMX6A5W5R","kind":"entity","bakedName":"AgentTurn","curName":"AgentTurn","renames":[],"owner":"workspace"},"evt_EX4BEGBES8QCM9GV67CZSGPSG4":{"id":"evt_EX4BEGBES8QCM9GV67CZSGPSG4","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_GXSYKR5S2TWHDCG7E2CN06MBKE":{"id":"evt_GXSYKR5S2TWHDCG7E2CN06MBKE","kind":"event","bakedName":"ASSISTANT_REPLIED","curName":"ASSISTANT_REPLIED","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q":{"id":"evt_J6FY2VSG4HR28V4EMK9KTGTQ5Q","kind":"event","bakedName":"ASK_FAILED","curName":"ASK_FAILED","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_M34HSMFYJPZ9B7HVZPEFDBTQ76":{"id":"evt_M34HSMFYJPZ9B7HVZPEFDBTQ76","kind":"event","bakedName":"ASSISTANT_REPLY_FAILED","curName":"ASSISTANT_REPLY_FAILED","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_NZ8B06SCC4P62AWYPEN9YSDSSF":{"id":"evt_NZ8B06SCC4P62AWYPEN9YSDSSF","kind":"event","bakedName":"ANSWERED","curName":"ANSWERED","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_RK84DWY67W33YC6T1NPH1TBZDV":{"id":"evt_RK84DWY67W33YC6T1NPH1TBZDV","kind":"event","bakedName":"CONVERSE","curName":"CONVERSE","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_RRK9X3KSCJWP9AHCWNX7231S78":{"id":"evt_RRK9X3KSCJWP9AHCWNX7231S78","kind":"event","bakedName":"ASSISTANT_STEP","curName":"ASSISTANT_STEP","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"evt_ZK1B49GVH6DRK08NC79T1161B0":{"id":"evt_ZK1B49GVH6DRK08NC79T1161B0","kind":"event","bakedName":"CANCEL","curName":"CANCEL","renames":[],"owner":"workspace","parent":"trt_905GG00P1YB0ZBV5QE54DKSQ79"},"orb_B4FJ4MABN35THR8C5KF605CGH6":{"id":"orb_B4FJ4MABN35THR8C5KF605CGH6","kind":"orbital","bakedName":"AgentToolLoopOrbital","curName":"AgentToolLoopOrbital","renames":[],"owner":"workspace"},"pag_TD83PWPF757KJMDYZ13RBQC57R":{"id":"pag_TD83PWPF757KJMDYZ13RBQC57R","kind":"page","bakedName":"AgentToolLoopPage","curName":"AgentToolLoopPage","renames":[],"owner":"workspace"},"trt_905GG00P1YB0ZBV5QE54DKSQ79":{"id":"trt_905GG00P1YB0ZBV5QE54DKSQ79","kind":"trait","bakedName":"AgentToolLoop","curName":"AgentToolLoop","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/agent/atoms/std-agent-trace.orb CHANGED Viewed

	@@ -1 +1 @@
1	- {"name":"std-agent-trace","version":"2.0.0","description":"std-agent-trace — the persisted record of what an in-app assistant did. Each REPLIED (from std-agent-tool-loop) stores one AgentRun row: the reply, every step (each model call, each tool used with its arguments, whether it took effect and why not), the tokens and the model calls; each REPLY_FAILED stores a failed run with its error. The record verification grades and later optimisation reads, in one format for tests and production. AgentTraceRecorder is headless; AgentRunBrowse is the run list. Rows carry ownerId (the real @user); the binding organism scopes @read.","orbitals":[{"name":"AgentTraceOrbital","id":"orb_GDG26AT4SW2CYDBVC7ANMC5H46","entity":{"name":"AgentRun","id":"ent_TBERVGMJWP9EBB64Q92Y49SBJP","collection":"agentRuns","persistence":"persistent","fields":[{"name":"id","type":"string","required":true},{"name":"ownerId","type":"string","required":true,"description":"Whose request this run answered (the real @user). The binding organism scopes @read to it.","synonyms":"user, owner, account"},{"name":"outcome","type":"string","default":"answered","values":["answered","failed"],"description":"Whether the assistant answered.","synonyms":"result, status"},{"name":"reply","type":"string","default":"","description":"What the assistant said.","synonyms":"answer, response"},{"name":"error","type":"string","default":"","description":"Why the run failed."},{"name":"steps","type":"array","default":[],"items":{"type":"union","values":["AgentToolCallActivity","AgentToolResultActivity","AgentLlmResponseActivity"],"properties":{"AgentToolResultActivity":{"name":"AgentToolResultActivity","type":"object","properties":{"success":{"name":"success","type":"boolean","required":true},"detail":{"name":"detail","type":"string","required":false},"tool":{"name":"tool","type":"string","required":true},"type":{"name":"type","type":"string","required":true,"values":["tool_result"]},"resultText":{"name":"resultText","type":"string","required":true},"kind":{"name":"kind","type":"string","required":false,"values":["input","read","invalid"]},"timestamp":{"name":"timestamp","type":"number","required":true},"rows":{"name":"rows","type":"number","required":false}}},"AgentToolCallActivity":{"name":"AgentToolCallActivity","type":"object","properties":{"tool":{"name":"tool","type":"string","required":true},"kind":{"name":"kind","type":"string","required":false,"values":["input","read","invalid"]},"type":{"name":"type","type":"string","required":true,"values":["tool_call"]},"argsText":{"name":"argsText","type":"string","required":true},"isExecuting":{"name":"isExecuting","type":"boolean","required":false},"timestamp":{"name":"timestamp","type":"number","required":true}}},"AgentLlmResponseActivity":{"name":"AgentLlmResponseActivity","type":"object","properties":{"content":{"name":"content","type":"string","required":true},"type":{"name":"type","type":"string","required":true,"values":["llm_response"]},"llm":{"name":"llm","type":"object","required":false,"properties":{"completionTokens":{"name":"completionTokens","type":"number","required":false},"costUSD":{"name":"costUSD","type":"number","required":false},"attempt":{"name":"attempt","type":"number","required":false},"cachedPromptTokens":{"name":"cachedPromptTokens","type":"number","required":false},"userPrompt":{"name":"userPrompt","type":"string","required":true},"systemPrompt":{"name":"systemPrompt","type":"string","required":true},"service":{"name":"service","type":"string","required":true},"model":{"name":"model","type":"string","required":true},"toolCallsJson":{"name":"toolCallsJson","type":"string","required":false},"durationMs":{"name":"durationMs","type":"number","required":true},"provider":{"name":"provider","type":"string","required":true},"promptTokens":{"name":"promptTokens","type":"number","required":false}}},"timestamp":{"name":"timestamp","type":"number","required":true}}}}},"description":"Every step, in order: each model call, each tool used and what the app answered.","synonyms":"actions, tool calls, trace"},{"name":"promptTokens","type":"number","default":0,"description":"Tokens sent to the model."},{"name":"completionTokens","type":"number","default":0,"description":"Tokens the model produced."},{"name":"totalTokens","type":"number","default":0,"description":"All tokens for the run."},{"name":"modelCalls","type":"number","default":0,"description":"Model round-trips.","synonyms":"turns, calls"},{"name":"recordedAt","type":"number","default":0,"description":"When the run finished (ms).","synonyms":"time, timestamp"}]},"traits":[{"name":"AgentTraceRecorder","id":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D","entityRebindable":true,"entityContract":{"requires":[],"provides":["outcome"]},"effectRow":[{"kind":"persist","resource":"AgentRun"},{"kind":"set","resource":"@entity.outcome"}],"category":"lifecycle","linkedEntity":"AgentRun","linkedEntityId":"ent_TBERVGMJWP9EBB64Q92Y49SBJP","entityRefIds":{"AgentRun":"ent_TBERVGMJWP9EBB64Q92Y49SBJP"},"emits":[{"event":"RUN_RECORDED","eventId":"evt_WBNEQMEG4G8285WPW53HW1FTZB","description":"A run was recorded — payload is the created AgentRun row itself.","synonyms":"recorded, logged, traced","tier":"domain","scope":"external"}],"stateMachine":{"states":[{"name":"recording","isInitial":true}],"events":[{"key":"INIT","id":"evt_6NRB88R9574JKQJ6W61C242SME","name":"Initialize"},{"key":"REPLIED","id":"evt_YZPXER44E3271WJT8SSVMWCNEC","name":"Replied","description":"Record an answered run.","payloadSchema":[{"name":"reply","type":"string","required":true},{"name":"steps","type":"[AgentActivity]","required":true},{"name":"usage","type":"object","required":true,"properties":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]}],"listened":true},{"key":"REPLY_FAILED","id":"evt_CWH29R6B2Q5HBP46443DYYHT43","name":"Reply Failed","description":"Record a failed run.","payloadSchema":[{"name":"error","type":"string","required":true}],"listened":true},{"key":"RUN_RECORDED","id":"evt_WBNEQMEG4G8285WPW53HW1FTZB","name":"Run Recorded","description":"A run was recorded — payload is the created AgentRun row itself.","synonyms":"recorded, logged, traced","tier":"domain"}],"transitions":[{"from":"recording","to":"recording","event":"INIT","eventId":"evt_6NRB88R9574JKQJ6W61C242SME","effects":[["set","@entity.outcome","answered"]]},{"from":"recording","to":"recording","event":"REPLIED","eventId":"evt_YZPXER44E3271WJT8SSVMWCNEC","effects":[["persist","create","AgentRun",{"ownerId":"@user.id","outcome":"answered","reply":"@payload.reply","steps":"@payload.steps","promptTokens":"@payload.usage.promptTokens","completionTokens":"@payload.usage.completionTokens","totalTokens":"@payload.usage.totalTokens","modelCalls":"@payload.usage.modelCalls","recordedAt":"@now"},{"emit":{"success":"RUN_RECORDED"}}]]},{"from":"recording","to":"recording","event":"REPLY_FAILED","eventId":"evt_CWH29R6B2Q5HBP46443DYYHT43","effects":[["persist","create","AgentRun",{"ownerId":"@user.id","outcome":"failed","error":"@payload.error","recordedAt":"@now"},{"emit":{"success":"RUN_RECORDED"}}]]},{"from":"recording","to":"recording","event":"RUN_RECORDED","eventId":"evt_WBNEQMEG4G8285WPW53HW1FTZB","effects":[["set","@entity.outcome","answered"]]}]},"scope":"instance"},{"name":"AgentRunBrowse","id":"trt_EFJMQN61BD0NPV9T7JK69M606Y","entityRebindable":true,"entityContract":{"requires":[],"provides":[]},"effectRow":[{"kind":"fetch","resource":"AgentRun"},{"kind":"render-ui","resource":"main"}],"category":"interaction","linkedEntity":"AgentRun","linkedEntityId":"ent_TBERVGMJWP9EBB64Q92Y49SBJP","entityRefIds":{"AgentRun":"ent_TBERVGMJWP9EBB64Q92Y49SBJP"},"emits":[{"event":"AgentRunsLoaded","eventId":"evt_3EFS9F08QV4BXTXB2ZWHSFQCPF","description":"The run record finished loading.","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"ownerId","type":"string","required":true},{"name":"outcome","type":"string","values":["answered","failed"]},{"name":"reply","type":"string"},{"name":"error","type":"string"},{"name":"steps","type":"[AgentActivity]"},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"totalTokens","type":"number"},{"name":"modelCalls","type":"number"},{"name":"recordedAt","type":"number"}],"entity":"AgentRun"}]},{"event":"AgentRunsLoadFailed","eventId":"evt_65Y1YPFYHTZ8X81TR2GADQQ1GB","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}]}],"listens":[{"event":"RUN_RECORDED","eventId":"evt_WBNEQMEG4G8285WPW53HW1FTZB","triggers":"RUN_RECORDED","triggersId":"evt_891F6DWTQ4DBJA50D5VFDXK373","source":{"kind":"trait","trait":"AgentTraceRecorder","traitId":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"}}],"stateMachine":{"states":[{"name":"browsing","isInitial":true}],"events":[{"key":"INIT","id":"evt_3YYVY554EDJ76V69Z2YBPEH355","name":"Initialize"},{"key":"AgentRunsLoaded","id":"evt_3EFS9F08QV4BXTXB2ZWHSFQCPF","name":"AgentRun s loaded","description":"The run record finished loading.","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"ownerId","type":"string","required":true},{"name":"outcome","type":"string","values":["answered","failed"]},{"name":"reply","type":"string"},{"name":"error","type":"string"},{"name":"steps","type":"[AgentActivity]"},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"totalTokens","type":"number"},{"name":"modelCalls","type":"number"},{"name":"recordedAt","type":"number"}],"entity":"AgentRun"}]},{"key":"AgentRunsLoadFailed","id":"evt_65Y1YPFYHTZ8X81TR2GADQQ1GB","name":"AgentRun s load failed","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}]},{"key":"RUN_RECORDED","id":"evt_891F6DWTQ4DBJA50D5VFDXK373","name":"Run Recorded","description":"A run was recorded; the history reloads. The importer routes its assistant's recorder here.","tier":"domain","listened":true}],"transitions":[{"from":"browsing","to":"browsing","event":"INIT","eventId":"evt_3YYVY554EDJ76V69Z2YBPEH355","effects":[["fetch","AgentRun",{"emit":{"failure":"AgentRunsLoadFailed","success":"AgentRunsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"list","rows":6}]]},{"from":"browsing","to":"browsing","event":"AgentRunsLoaded","eventId":"evt_3EFS9F08QV4BXTXB2ZWHSFQCPF","effects":[["render-ui","main",{"emptyTitle":"No runs yet","entity":["array/sort","@payload.data","recordedAt","desc"],"fields":[],"gap":"sm","renderItem":["fn","item",{"children":[{"label":"@item.outcome","size":"sm","type":"badge","variant":"neutral"},{"content":"@item.reply","type":"typography","variant":"body"},{"content":["str/concat","@item.modelCalls"," model calls, ","@item.totalTokens"," tokens"],"type":"typography","variant":"caption"},{"activities":"@item.steps","followLatest":false,"type":"agent-activity-feed"}],"direction":"vertical","gap":"xs","type":"stack"}],"type":"data-list"}]]},{"from":"browsing","to":"browsing","event":"AgentRunsLoadFailed","eventId":"evt_65Y1YPFYHTZ8X81TR2GADQQ1GB","effects":[["render-ui","main",{"message":"@payload.error","type":"alert","variant":"error"}]]},{"from":"browsing","to":"browsing","event":"RUN_RECORDED","eventId":"evt_891F6DWTQ4DBJA50D5VFDXK373","effects":[["fetch","AgentRun",{"emit":{"failure":"AgentRunsLoadFailed","success":"AgentRunsLoaded"}}]]}]},"scope":"collection"}],"pages":[{"name":"AgentTracePage","id":"pag_1GM7EQ71S7GWKGZVR1HXF22FP6","path":"/agent-trace","traits":[{"ref":"AgentRunBrowse","refId":"trt_EFJMQN61BD0NPV9T7JK69M606Y"},{"ref":"AgentTraceRecorder","refId":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"}]}],"types":{"AgentActivity":[{"name":"","type":"union","properties":[{"name":"AgentToolCallActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}]},{"name":"AgentToolResultActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}]},{"name":"AgentLlmResponseActivity","type":"object","properties":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}]}]}],"AgentLlmCall":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}],"AgentLlmResponseActivity":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}],"AgentToolCallActivity":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}],"AgentToolResultActivity":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}],"AgentUsage":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_TBERVGMJWP9EBB64Q92Y49SBJP":{"id":"ent_TBERVGMJWP9EBB64Q92Y49SBJP","kind":"entity","bakedName":"AgentRun","curName":"AgentRun","renames":[],"owner":"workspace"},"evt_3EFS9F08QV4BXTXB2ZWHSFQCPF":{"id":"evt_3EFS9F08QV4BXTXB2ZWHSFQCPF","kind":"event","bakedName":"AgentRunsLoaded","curName":"AgentRunsLoaded","renames":[],"owner":"workspace","parent":"trt_EFJMQN61BD0NPV9T7JK69M606Y"},"evt_3YYVY554EDJ76V69Z2YBPEH355":{"id":"evt_3YYVY554EDJ76V69Z2YBPEH355","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_EFJMQN61BD0NPV9T7JK69M606Y"},"evt_65Y1YPFYHTZ8X81TR2GADQQ1GB":{"id":"evt_65Y1YPFYHTZ8X81TR2GADQQ1GB","kind":"event","bakedName":"AgentRunsLoadFailed","curName":"AgentRunsLoadFailed","renames":[],"owner":"workspace","parent":"trt_EFJMQN61BD0NPV9T7JK69M606Y"},"evt_6NRB88R9574JKQJ6W61C242SME":{"id":"evt_6NRB88R9574JKQJ6W61C242SME","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"},"evt_891F6DWTQ4DBJA50D5VFDXK373":{"id":"evt_891F6DWTQ4DBJA50D5VFDXK373","kind":"event","bakedName":"RUN_RECORDED","curName":"RUN_RECORDED","renames":[],"owner":"workspace","parent":"trt_EFJMQN61BD0NPV9T7JK69M606Y"},"evt_CWH29R6B2Q5HBP46443DYYHT43":{"id":"evt_CWH29R6B2Q5HBP46443DYYHT43","kind":"event","bakedName":"REPLY_FAILED","curName":"REPLY_FAILED","renames":[],"owner":"workspace","parent":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"},"evt_WBNEQMEG4G8285WPW53HW1FTZB":{"id":"evt_WBNEQMEG4G8285WPW53HW1FTZB","kind":"event","bakedName":"RUN_RECORDED","curName":"RUN_RECORDED","renames":[],"owner":"workspace","parent":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"},"evt_YZPXER44E3271WJT8SSVMWCNEC":{"id":"evt_YZPXER44E3271WJT8SSVMWCNEC","kind":"event","bakedName":"REPLIED","curName":"REPLIED","renames":[],"owner":"workspace","parent":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"},"orb_GDG26AT4SW2CYDBVC7ANMC5H46":{"id":"orb_GDG26AT4SW2CYDBVC7ANMC5H46","kind":"orbital","bakedName":"AgentTraceOrbital","curName":"AgentTraceOrbital","renames":[],"owner":"workspace"},"pag_1GM7EQ71S7GWKGZVR1HXF22FP6":{"id":"pag_1GM7EQ71S7GWKGZVR1HXF22FP6","kind":"page","bakedName":"AgentTracePage","curName":"AgentTracePage","renames":[],"owner":"workspace"},"trt_EFJMQN61BD0NPV9T7JK69M606Y":{"id":"trt_EFJMQN61BD0NPV9T7JK69M606Y","kind":"trait","bakedName":"AgentRunBrowse","curName":"AgentRunBrowse","renames":[],"owner":"workspace"},"trt_Z0PS7BN5GSJRCYS648TD6DBS7D":{"id":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D","kind":"trait","bakedName":"AgentTraceRecorder","curName":"AgentTraceRecorder","renames":[],"owner":"workspace"}}}}
1	+ {"name":"std-agent-trace","version":"2.0.0","description":"std-agent-trace — the persisted record of what an in-app assistant did. Each REPLIED (from std-agent-tool-loop) stores one AgentRun row: the reply, every step (each model call, each tool used with its arguments, whether it took effect and why not), the tokens and the model calls; each REPLY_FAILED stores a failed run with its error. The record verification grades and later optimisation reads, in one format for tests and production. AgentTraceRecorder is headless; AgentRunBrowse is the run list. Rows carry ownerId (the real @user); the binding organism scopes @read.","orbitals":[{"name":"AgentTraceOrbital","id":"orb_GDG26AT4SW2CYDBVC7ANMC5H46","entity":{"name":"AgentRun","id":"ent_TBERVGMJWP9EBB64Q92Y49SBJP","collection":"agentRuns","persistence":"persistent","fields":[{"name":"id","type":"string","required":true},{"name":"ownerId","type":"string","required":true,"description":"Whose request this run answered (the real @user). The binding organism scopes @read to it.","synonyms":"user, owner, account"},{"name":"outcome","type":"string","default":"answered","values":["answered","failed"],"description":"Whether the assistant answered.","synonyms":"result, status"},{"name":"reply","type":"string","default":"","description":"What the assistant said.","synonyms":"answer, response"},{"name":"error","type":"string","default":"","description":"Why the run failed."},{"name":"steps","type":"array","default":[],"items":{"type":"union","values":["AgentToolCallActivity","AgentToolResultActivity","AgentLlmResponseActivity"],"properties":{"AgentLlmResponseActivity":{"name":"AgentLlmResponseActivity","type":"object","properties":{"type":{"name":"type","type":"string","required":true,"values":["llm_response"]},"timestamp":{"name":"timestamp","type":"number","required":true},"llm":{"name":"llm","type":"object","required":false,"properties":{"cachedPromptTokens":{"name":"cachedPromptTokens","type":"number","required":false},"toolCallsJson":{"name":"toolCallsJson","type":"string","required":false},"userPrompt":{"name":"userPrompt","type":"string","required":true},"model":{"name":"model","type":"string","required":true},"attempt":{"name":"attempt","type":"number","required":false},"promptTokens":{"name":"promptTokens","type":"number","required":false},"systemPrompt":{"name":"systemPrompt","type":"string","required":true},"provider":{"name":"provider","type":"string","required":true},"durationMs":{"name":"durationMs","type":"number","required":true},"completionTokens":{"name":"completionTokens","type":"number","required":false},"service":{"name":"service","type":"string","required":true},"costUSD":{"name":"costUSD","type":"number","required":false}}},"content":{"name":"content","type":"string","required":true}}},"AgentToolCallActivity":{"name":"AgentToolCallActivity","type":"object","properties":{"timestamp":{"name":"timestamp","type":"number","required":true},"tool":{"name":"tool","type":"string","required":true},"isExecuting":{"name":"isExecuting","type":"boolean","required":false},"argsText":{"name":"argsText","type":"string","required":true},"kind":{"name":"kind","type":"string","required":false,"values":["input","read","invalid"]},"type":{"name":"type","type":"string","required":true,"values":["tool_call"]}}},"AgentToolResultActivity":{"name":"AgentToolResultActivity","type":"object","properties":{"kind":{"name":"kind","type":"string","required":false,"values":["input","read","invalid"]},"timestamp":{"name":"timestamp","type":"number","required":true},"rows":{"name":"rows","type":"number","required":false},"type":{"name":"type","type":"string","required":true,"values":["tool_result"]},"tool":{"name":"tool","type":"string","required":true},"resultText":{"name":"resultText","type":"string","required":true},"detail":{"name":"detail","type":"string","required":false},"success":{"name":"success","type":"boolean","required":true}}}}},"description":"Every step, in order: each model call, each tool used and what the app answered.","synonyms":"actions, tool calls, trace"},{"name":"promptTokens","type":"number","default":0,"description":"Tokens sent to the model."},{"name":"completionTokens","type":"number","default":0,"description":"Tokens the model produced."},{"name":"totalTokens","type":"number","default":0,"description":"All tokens for the run."},{"name":"modelCalls","type":"number","default":0,"description":"Model round-trips.","synonyms":"turns, calls"},{"name":"recordedAt","type":"number","default":0,"description":"When the run finished (ms).","synonyms":"time, timestamp"}]},"traits":[{"name":"AgentTraceRecorder","id":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D","entityRebindable":true,"entityContract":{"requires":[],"provides":["outcome"]},"effectRow":[{"kind":"persist","resource":"AgentRun"},{"kind":"set","resource":"@entity.outcome"}],"category":"lifecycle","linkedEntity":"AgentRun","linkedEntityId":"ent_TBERVGMJWP9EBB64Q92Y49SBJP","entityRefIds":{"AgentRun":"ent_TBERVGMJWP9EBB64Q92Y49SBJP"},"emits":[{"event":"RUN_RECORDED","eventId":"evt_WBNEQMEG4G8285WPW53HW1FTZB","description":"A run was recorded — payload is the created AgentRun row itself.","synonyms":"recorded, logged, traced","tier":"domain","scope":"external"}],"stateMachine":{"states":[{"name":"recording","isInitial":true}],"events":[{"key":"INIT","id":"evt_6NRB88R9574JKQJ6W61C242SME","name":"Initialize"},{"key":"REPLIED","id":"evt_YZPXER44E3271WJT8SSVMWCNEC","name":"Replied","description":"Record an answered run.","payloadSchema":[{"name":"reply","type":"string","required":true},{"name":"steps","type":"[AgentActivity]","required":true},{"name":"usage","type":"object","required":true,"properties":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]}],"listened":true},{"key":"REPLY_FAILED","id":"evt_CWH29R6B2Q5HBP46443DYYHT43","name":"Reply Failed","description":"Record a failed run.","payloadSchema":[{"name":"error","type":"string","required":true}],"listened":true},{"key":"RUN_RECORDED","id":"evt_WBNEQMEG4G8285WPW53HW1FTZB","name":"Run Recorded","description":"A run was recorded — payload is the created AgentRun row itself.","synonyms":"recorded, logged, traced","tier":"domain"}],"transitions":[{"from":"recording","to":"recording","event":"INIT","eventId":"evt_6NRB88R9574JKQJ6W61C242SME","effects":[["set","@entity.outcome","answered"]]},{"from":"recording","to":"recording","event":"REPLIED","eventId":"evt_YZPXER44E3271WJT8SSVMWCNEC","effects":[["persist","create","AgentRun",{"ownerId":"@user.id","outcome":"answered","reply":"@payload.reply","steps":"@payload.steps","promptTokens":"@payload.usage.promptTokens","completionTokens":"@payload.usage.completionTokens","totalTokens":"@payload.usage.totalTokens","modelCalls":"@payload.usage.modelCalls","recordedAt":"@now"},{"emit":{"success":"RUN_RECORDED"}}]]},{"from":"recording","to":"recording","event":"REPLY_FAILED","eventId":"evt_CWH29R6B2Q5HBP46443DYYHT43","effects":[["persist","create","AgentRun",{"ownerId":"@user.id","outcome":"failed","error":"@payload.error","recordedAt":"@now"},{"emit":{"success":"RUN_RECORDED"}}]]},{"from":"recording","to":"recording","event":"RUN_RECORDED","eventId":"evt_WBNEQMEG4G8285WPW53HW1FTZB","effects":[["set","@entity.outcome","answered"]]}]},"scope":"instance"},{"name":"AgentRunBrowse","id":"trt_EFJMQN61BD0NPV9T7JK69M606Y","entityRebindable":true,"entityContract":{"requires":[],"provides":[]},"effectRow":[{"kind":"fetch","resource":"AgentRun"},{"kind":"render-ui","resource":"main"}],"category":"interaction","linkedEntity":"AgentRun","linkedEntityId":"ent_TBERVGMJWP9EBB64Q92Y49SBJP","entityRefIds":{"AgentRun":"ent_TBERVGMJWP9EBB64Q92Y49SBJP"},"emits":[{"event":"AgentRunsLoaded","eventId":"evt_3EFS9F08QV4BXTXB2ZWHSFQCPF","description":"The run record finished loading.","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"ownerId","type":"string","required":true},{"name":"outcome","type":"string","values":["answered","failed"]},{"name":"reply","type":"string"},{"name":"error","type":"string"},{"name":"steps","type":"[AgentActivity]"},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"totalTokens","type":"number"},{"name":"modelCalls","type":"number"},{"name":"recordedAt","type":"number"}],"entity":"AgentRun"}]},{"event":"AgentRunsLoadFailed","eventId":"evt_65Y1YPFYHTZ8X81TR2GADQQ1GB","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}]}],"listens":[{"event":"RUN_RECORDED","eventId":"evt_WBNEQMEG4G8285WPW53HW1FTZB","triggers":"RUN_RECORDED","triggersId":"evt_891F6DWTQ4DBJA50D5VFDXK373","source":{"kind":"trait","trait":"AgentTraceRecorder","traitId":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"}}],"stateMachine":{"states":[{"name":"browsing","isInitial":true}],"events":[{"key":"INIT","id":"evt_3YYVY554EDJ76V69Z2YBPEH355","name":"Initialize"},{"key":"AgentRunsLoaded","id":"evt_3EFS9F08QV4BXTXB2ZWHSFQCPF","name":"AgentRun s loaded","description":"The run record finished loading.","tier":"internal","payloadSchema":[{"name":"data","type":"[object]","properties":[{"name":"id","type":"string","required":true},{"name":"ownerId","type":"string","required":true},{"name":"outcome","type":"string","values":["answered","failed"]},{"name":"reply","type":"string"},{"name":"error","type":"string"},{"name":"steps","type":"[AgentActivity]"},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"totalTokens","type":"number"},{"name":"modelCalls","type":"number"},{"name":"recordedAt","type":"number"}],"entity":"AgentRun"}]},{"key":"AgentRunsLoadFailed","id":"evt_65Y1YPFYHTZ8X81TR2GADQQ1GB","name":"AgentRun s load failed","tier":"internal","payloadSchema":[{"name":"error","type":"string"},{"name":"code","type":"string"}]},{"key":"RUN_RECORDED","id":"evt_891F6DWTQ4DBJA50D5VFDXK373","name":"Run Recorded","description":"A run was recorded; the history reloads. The importer routes its assistant's recorder here.","tier":"domain","listened":true}],"transitions":[{"from":"browsing","to":"browsing","event":"INIT","eventId":"evt_3YYVY554EDJ76V69Z2YBPEH355","effects":[["fetch","AgentRun",{"emit":{"failure":"AgentRunsLoadFailed","success":"AgentRunsLoaded"}}],["render-ui","main",{"type":"skeleton","variant":"list","rows":6}]]},{"from":"browsing","to":"browsing","event":"AgentRunsLoaded","eventId":"evt_3EFS9F08QV4BXTXB2ZWHSFQCPF","effects":[["render-ui","main",{"emptyTitle":"No runs yet","entity":["array/sort","@payload.data","recordedAt","desc"],"fields":[],"gap":"sm","renderItem":["fn","item",{"children":[{"label":"@item.outcome","size":"sm","type":"badge","variant":"neutral"},{"content":"@item.reply","type":"typography","variant":"body"},{"content":["str/concat","@item.modelCalls"," model calls, ","@item.totalTokens"," tokens"],"type":"typography","variant":"caption"},{"activities":"@item.steps","followLatest":false,"type":"agent-activity-feed"}],"direction":"vertical","gap":"xs","type":"stack"}],"type":"data-list"}]]},{"from":"browsing","to":"browsing","event":"AgentRunsLoadFailed","eventId":"evt_65Y1YPFYHTZ8X81TR2GADQQ1GB","effects":[["render-ui","main",{"message":"@payload.error","type":"alert","variant":"error"}]]},{"from":"browsing","to":"browsing","event":"RUN_RECORDED","eventId":"evt_891F6DWTQ4DBJA50D5VFDXK373","effects":[["fetch","AgentRun",{"emit":{"failure":"AgentRunsLoadFailed","success":"AgentRunsLoaded"}}]]}]},"scope":"collection"}],"pages":[{"name":"AgentTracePage","id":"pag_1GM7EQ71S7GWKGZVR1HXF22FP6","path":"/agent-trace","traits":[{"ref":"AgentRunBrowse","refId":"trt_EFJMQN61BD0NPV9T7JK69M606Y"},{"ref":"AgentTraceRecorder","refId":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"}]}],"types":{"AgentActivity":[{"name":"","type":"union","properties":[{"name":"AgentToolCallActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}]},{"name":"AgentToolResultActivity","type":"object","properties":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}]},{"name":"AgentLlmResponseActivity","type":"object","properties":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}]}]}],"AgentLlmCall":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}],"AgentLlmResponseActivity":[{"name":"type","type":"string","values":["llm_response"],"required":true},{"name":"content","type":"string","required":true},{"name":"llm","type":"object","properties":[{"name":"service","type":"string","required":true},{"name":"provider","type":"string","required":true},{"name":"model","type":"string","required":true},{"name":"systemPrompt","type":"string","required":true},{"name":"userPrompt","type":"string","required":true},{"name":"toolCallsJson","type":"string"},{"name":"attempt","type":"number"},{"name":"durationMs","type":"number","required":true},{"name":"promptTokens","type":"number"},{"name":"completionTokens","type":"number"},{"name":"cachedPromptTokens","type":"number"},{"name":"costUSD","type":"number"}]},{"name":"timestamp","type":"number","required":true}],"AgentToolCallActivity":[{"name":"type","type":"string","values":["tool_call"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"argsText","type":"string","required":true},{"name":"timestamp","type":"number","required":true},{"name":"isExecuting","type":"boolean"}],"AgentToolResultActivity":[{"name":"type","type":"string","values":["tool_result"],"required":true},{"name":"tool","type":"string","required":true},{"name":"kind","type":"string","values":["input","read","invalid"]},{"name":"success","type":"boolean","required":true},{"name":"detail","type":"string"},{"name":"rows","type":"number"},{"name":"resultText","type":"string","required":true},{"name":"timestamp","type":"number","required":true}],"AgentUsage":[{"name":"promptTokens","type":"number","required":true},{"name":"completionTokens","type":"number","required":true},{"name":"totalTokens","type":"number","required":true},{"name":"modelCalls","type":"number","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_TBERVGMJWP9EBB64Q92Y49SBJP":{"id":"ent_TBERVGMJWP9EBB64Q92Y49SBJP","kind":"entity","bakedName":"AgentRun","curName":"AgentRun","renames":[],"owner":"workspace"},"evt_3EFS9F08QV4BXTXB2ZWHSFQCPF":{"id":"evt_3EFS9F08QV4BXTXB2ZWHSFQCPF","kind":"event","bakedName":"AgentRunsLoaded","curName":"AgentRunsLoaded","renames":[],"owner":"workspace","parent":"trt_EFJMQN61BD0NPV9T7JK69M606Y"},"evt_3YYVY554EDJ76V69Z2YBPEH355":{"id":"evt_3YYVY554EDJ76V69Z2YBPEH355","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_EFJMQN61BD0NPV9T7JK69M606Y"},"evt_65Y1YPFYHTZ8X81TR2GADQQ1GB":{"id":"evt_65Y1YPFYHTZ8X81TR2GADQQ1GB","kind":"event","bakedName":"AgentRunsLoadFailed","curName":"AgentRunsLoadFailed","renames":[],"owner":"workspace","parent":"trt_EFJMQN61BD0NPV9T7JK69M606Y"},"evt_6NRB88R9574JKQJ6W61C242SME":{"id":"evt_6NRB88R9574JKQJ6W61C242SME","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"},"evt_891F6DWTQ4DBJA50D5VFDXK373":{"id":"evt_891F6DWTQ4DBJA50D5VFDXK373","kind":"event","bakedName":"RUN_RECORDED","curName":"RUN_RECORDED","renames":[],"owner":"workspace","parent":"trt_EFJMQN61BD0NPV9T7JK69M606Y"},"evt_CWH29R6B2Q5HBP46443DYYHT43":{"id":"evt_CWH29R6B2Q5HBP46443DYYHT43","kind":"event","bakedName":"REPLY_FAILED","curName":"REPLY_FAILED","renames":[],"owner":"workspace","parent":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"},"evt_WBNEQMEG4G8285WPW53HW1FTZB":{"id":"evt_WBNEQMEG4G8285WPW53HW1FTZB","kind":"event","bakedName":"RUN_RECORDED","curName":"RUN_RECORDED","renames":[],"owner":"workspace","parent":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"},"evt_YZPXER44E3271WJT8SSVMWCNEC":{"id":"evt_YZPXER44E3271WJT8SSVMWCNEC","kind":"event","bakedName":"REPLIED","curName":"REPLIED","renames":[],"owner":"workspace","parent":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D"},"orb_GDG26AT4SW2CYDBVC7ANMC5H46":{"id":"orb_GDG26AT4SW2CYDBVC7ANMC5H46","kind":"orbital","bakedName":"AgentTraceOrbital","curName":"AgentTraceOrbital","renames":[],"owner":"workspace"},"pag_1GM7EQ71S7GWKGZVR1HXF22FP6":{"id":"pag_1GM7EQ71S7GWKGZVR1HXF22FP6","kind":"page","bakedName":"AgentTracePage","curName":"AgentTracePage","renames":[],"owner":"workspace"},"trt_EFJMQN61BD0NPV9T7JK69M606Y":{"id":"trt_EFJMQN61BD0NPV9T7JK69M606Y","kind":"trait","bakedName":"AgentRunBrowse","curName":"AgentRunBrowse","renames":[],"owner":"workspace"},"trt_Z0PS7BN5GSJRCYS648TD6DBS7D":{"id":"trt_Z0PS7BN5GSJRCYS648TD6DBS7D","kind":"trait","bakedName":"AgentTraceRecorder","curName":"AgentTraceRecorder","renames":[],"owner":"workspace"}}}}

package/behaviors/registry/agent/evals/eval-agent-builder.orb ADDED Viewed

@@ -0,0 +1 @@

+ {"name":"eval-agent-builder","version":"1.0.0","description":"Eval of std-agent-builder's ladder over std-agent-pool. RUN_CASE { index } builds the case's request through the ladder (the pool first, adopted at or above its threshold; otherwise a std learning instrument filled by the model with its knobs and a one-line hint), pools what was built, and records an EvalCase: the tier that served it, the behavior, the hint, the latency and the verdict against the tier the case expects. Driven from outside, one case at a time.","orbitals":[{"name":"EvalPool","id":"orb_GDCH3NDAA2N517XFESF0M0EQDB","uses":[{"from":"std/behaviors/std-agent-builder","as":"Builder"},{"from":"std/behaviors/std-agent-pool","as":"Pool"}],"entity":"Pool.orbitals.AgentPoolOrbital.entity","traits":[],"reference":{"ref":"Pool.orbitals.AgentPoolOrbital","config":{"pool":{"type":"unknown","default":"eval-agent-builder"}},"listens":[{"trait":"AgentPoolSearch","event":"POOL_SEARCH","triggers":"SEARCH","source":{"kind":"orbital","orbital":"EvalBuilder","trait":"BuilderPipeline"}},{"trait":"AgentPoolWriter","event":"POOL_WRITE","triggers":"WRITE","source":{"kind":"orbital","orbital":"EvalRun","trait":"EvalDriver"}}]}},{"name":"EvalBuilder","id":"orb_B4CBBR7ZCZZPFQ9VQ4DHNSGH0H","uses":[{"from":"std/behaviors/std-agent-builder","as":"Builder"},{"from":"std/behaviors/std-agent-pool","as":"Pool"}],"entity":"Builder.orbitals.AgentBuilderOrbital.entity","traits":[],"reference":{"ref":"Builder.orbitals.AgentBuilderOrbital","traits":{"BuilderPipeline":{"config":{"ladder":{"type":"unknown","default":[{"name":"pool","source":"pool","scope":[],"threshold":0.85,"action":"adopt","take":5},{"name":"instrument","source":"catalog","scope":["almadar-std/ui/learning/atoms"],"threshold":0,"action":"fill","take":1}]},"fillEvent":{"type":"unknown","default":"EvalBuilder.EvalBuilderBuilderPipeline.FILL"},"fillFields":{"type":"unknown","default":[{"name":"hint","type":"string","required":true,"description":"One short line telling the learner how to play it."}]}}}},"listens":[{"trait":"BuilderPipeline","event":"START_BUILD","triggers":"START","source":{"kind":"orbital","orbital":"EvalRun","trait":"EvalDriver"}},{"trait":"BuilderPipeline","event":"POOL_FOUND","triggers":"POOL_FOUND","source":{"kind":"orbital","orbital":"EvalPool","trait":"AgentPoolSearch"}}]}},{"name":"EvalRun","id":"orb_1RBTNWSYP4ZB2DS8HR46T4SYHD","uses":[{"from":"std/behaviors/std-agent-builder","as":"Builder"},{"from":"std/behaviors/std-agent-pool","as":"Pool"}],"entity":{"name":"EvalRunView","id":"ent_0W4WPKTQQGBVRA1D212XSPFR40","persistence":"runtime","fields":[{"name":"id","type":"string","required":true},{"name":"index","type":"number","default":0},{"name":"startedAt","type":"number","default":0}]},"auxiliaryEntities":[{"name":"EvalCase","id":"ent_9QYRWNCR34C1J921N566HF0TJD","collection":"evalCases","persistence":"persistent","fields":[{"name":"id","type":"string","required":true},{"name":"caseId","type":"string","default":""},{"name":"request","type":"string","default":""},{"name":"expectTier","type":"string","default":""},{"name":"tier","type":"string","default":""},{"name":"behavior","type":"string","default":""},{"name":"hint","type":"string","default":""},{"name":"latencyMs","type":"number","default":0},{"name":"verdict","type":"string","default":"fail","values":["pass","fail"]},{"name":"error","type":"string","default":""}]}],"traits":[{"name":"EvalDriver","id":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2","effectRow":[{"kind":"emit","resource":"POOL_WRITE"},{"kind":"emit","resource":"START_BUILD"},{"kind":"fetch","resource":"EvalCase"},{"kind":"persist","resource":"EvalCase"},{"kind":"render-ui","resource":"main"},{"kind":"render-ui","resource":"toast"},{"kind":"set","resource":"@entity.index"},{"kind":"set","resource":"@entity.startedAt"}],"category":"lifecycle","linkedEntity":"EvalRunView","linkedEntityId":"ent_0W4WPKTQQGBVRA1D212XSPFR40","entityRefIds":{"EvalCase":"ent_9QYRWNCR34C1J921N566HF0TJD","EvalRunView":"ent_0W4WPKTQQGBVRA1D212XSPFR40"},"emits":[{"event":"CASES_READ","eventId":"evt_GB5DZ969124GH9PNTQMTFF9EQM","description":"Every case recorded so far.","tier":"domain","scope":"external","payloadSchema":[{"name":"data","type":"[object]","required":true,"properties":[{"name":"id","type":"string","required":true},{"name":"caseId","type":"string"},{"name":"request","type":"string"},{"name":"expectTier","type":"string"},{"name":"tier","type":"string"},{"name":"behavior","type":"string"},{"name":"hint","type":"string"},{"name":"latencyMs","type":"number"},{"name":"verdict","type":"string","values":["pass","fail"]},{"name":"error","type":"string"}],"entity":"EvalCase"}]},{"event":"CASES_FAILED","eventId":"evt_XT3KRZ6K299H4MC7CC6BEM71TR","tier":"internal","payloadSchema":[{"name":"error","type":"string","required":true}]},{"event":"START_BUILD","eventId":"evt_S5EP9P8MPJAB96NZVV9KYZHCDZ","tier":"internal","scope":"external","payloadSchema":[{"name":"request","type":"string","required":true},{"name":"orbitalName","type":"string","required":true}]},{"event":"POOL_WRITE","eventId":"evt_651JQR2FBF7NQPVNRX8CFAHEG5","tier":"internal","scope":"external","payloadSchema":[{"name":"value","type":"behavior","required":true},{"name":"name","type":"string","required":true},{"name":"kind","type":"string","required":true},{"name":"topic","type":"string"},{"name":"hint","type":"string"},{"name":"description","type":"string","required":true}]}],"listens":[{"event":"BUILD_COMPLETE","triggers":"BUILD_DONE","triggersId":"evt_XBS22GY0AB055QR1P810PD159G","source":{"kind":"orbital","orbital":"EvalBuilder","trait":"BuilderPipeline"}},{"event":"BUILD_REJECTED","triggers":"BUILD_FAILED_CASE","triggersId":"evt_NT1DC5HPY0VF02A4ZHTQS1MVPG","source":{"kind":"orbital","orbital":"EvalBuilder","trait":"BuilderPipeline"}}],"stateMachine":{"states":[{"name":"idle","isInitial":true},{"name":"running"}],"events":[{"key":"INIT","id":"evt_5EFBX5R1FP0QV2H97KM0GB6C4Q","name":"Initialize"},{"key":"RUN_CASE","id":"evt_A7X6435064G325MY8AN65R2JVD","name":"Run Case","description":"Run one case of the eval.","payloadSchema":[{"name":"index","type":"number","required":true}],"external":true,"listened":true},{"key":"READ_CASES","id":"evt_DYCZ69DKP1SV0Y6QAXK74SF2QE","name":"Read Cases","description":"Read back every case recorded so far.","external":true,"listened":true},{"key":"CASES_READ","id":"evt_GB5DZ969124GH9PNTQMTFF9EQM","name":"Cases Read","description":"Every case recorded so far.","tier":"domain","payloadSchema":[{"name":"data","type":"[object]","required":true,"properties":[{"name":"id","type":"string","required":true},{"name":"caseId","type":"string"},{"name":"request","type":"string"},{"name":"expectTier","type":"string"},{"name":"tier","type":"string"},{"name":"behavior","type":"string"},{"name":"hint","type":"string"},{"name":"latencyMs","type":"number"},{"name":"verdict","type":"string","values":["pass","fail"]},{"name":"error","type":"string"}],"entity":"EvalCase"}]},{"key":"CASES_FAILED","id":"evt_XT3KRZ6K299H4MC7CC6BEM71TR","name":"Cases Failed","tier":"internal","payloadSchema":[{"name":"error","type":"string","required":true}]},{"key":"BUILD_DONE","id":"evt_XBS22GY0AB055QR1P810PD159G","name":"Build Done","payloadSchema":[{"name":"orbitalName","type":"string","required":true},{"name":"behavior","type":"string","required":true},{"name":"value","type":"behavior","required":true},{"name":"tier","type":"string","required":true},{"name":"fields","type":"Map<string,string>"}],"listened":true},{"key":"BUILD_FAILED_CASE","id":"evt_NT1DC5HPY0VF02A4ZHTQS1MVPG","name":"Build Failed Case","payloadSchema":[{"name":"error","type":"string","required":true}],"listened":true},{"key":"START_BUILD","id":"evt_S5EP9P8MPJAB96NZVV9KYZHCDZ","name":"Start Build","tier":"internal","payloadSchema":[{"name":"request","type":"string","required":true},{"name":"orbitalName","type":"string","required":true}]},{"key":"POOL_WRITE","id":"evt_651JQR2FBF7NQPVNRX8CFAHEG5","name":"Pool Write","tier":"internal","payloadSchema":[{"name":"value","type":"behavior","required":true},{"name":"name","type":"string","required":true},{"name":"kind","type":"string","required":true},{"name":"topic","type":"string"},{"name":"hint","type":"string"},{"name":"description","type":"string","required":true}]}],"transitions":[{"from":"idle","to":"idle","event":"INIT","eventId":"evt_5EFBX5R1FP0QV2H97KM0GB6C4Q","effects":[["render-ui","main",{"type":"stack","direction":"horizontal","gap":"sm","children":[{"type":"button","variant":"ghost","label":"Cases","href":"/"},{"type":"button","variant":"ghost","label":"Builder","href":"/agent-builder"},{"type":"button","variant":"ghost","label":"Pool","href":"/agent-pool"}]}]]},{"from":"idle","to":"running","event":"RUN_CASE","eventId":"evt_A7X6435064G325MY8AN65R2JVD","guard":["<","@payload.index",["array/len","@config.cases"]],"effects":[["set","@entity.index","@payload.index"],["set","@entity.startedAt","@now"],["emit","START_BUILD",{"request":["object/get",["array/nth","@config.cases","@payload.index"],"request"],"orbitalName":["str/concat","EvalCard",["object/get",["array/nth","@config.cases","@payload.index"],"id"]]}]]},{"from":"idle","to":"idle","event":"RUN_CASE","eventId":"evt_A7X6435064G325MY8AN65R2JVD","guard":[">=","@payload.index",["array/len","@config.cases"]]},{"from":"idle","to":"idle","event":"READ_CASES","eventId":"evt_DYCZ69DKP1SV0Y6QAXK74SF2QE","effects":[["fetch","EvalCase",{"emit":{"failure":"CASES_FAILED","success":"CASES_READ"}}]]},{"from":"idle","to":"idle","event":"CASES_READ","eventId":"evt_GB5DZ969124GH9PNTQMTFF9EQM"},{"from":"idle","to":"idle","event":"CASES_FAILED","eventId":"evt_XT3KRZ6K299H4MC7CC6BEM71TR","effects":[["render-ui","toast",{"message":"@payload.error","type":"alert","variant":"warning"}]]},{"from":"running","to":"idle","event":"INIT","eventId":"evt_5EFBX5R1FP0QV2H97KM0GB6C4Q"},{"from":"running","to":"idle","event":"BUILD_DONE","eventId":"evt_XBS22GY0AB055QR1P810PD159G","guard":["=","@payload.tier","pool"],"effects":[["persist","create","EvalCase",{"caseId":["object/get",["array/nth","@config.cases","@entity.index"],"id"],"request":["object/get",["array/nth","@config.cases","@entity.index"],"request"],"expectTier":["object/get",["array/nth","@config.cases","@entity.index"],"expectTier"],"tier":"@payload.tier","behavior":"@payload.behavior","hint":["object/get","@payload.fields","hint",""],"latencyMs":["-","@now","@entity.startedAt"],"verdict":["if",["=","@payload.tier",["object/get",["array/nth","@config.cases","@entity.index"],"expectTier"]],"pass","fail"]}]]},{"from":"running","to":"idle","event":"BUILD_DONE","eventId":"evt_XBS22GY0AB055QR1P810PD159G","guard":["!=","@payload.tier","pool"],"effects":[["persist","create","EvalCase",{"caseId":["object/get",["array/nth","@config.cases","@entity.index"],"id"],"request":["object/get",["array/nth","@config.cases","@entity.index"],"request"],"expectTier":["object/get",["array/nth","@config.cases","@entity.index"],"expectTier"],"tier":"@payload.tier","behavior":"@payload.behavior","hint":["object/get","@payload.fields","hint",""],"latencyMs":["-","@now","@entity.startedAt"],"verdict":["if",["=","@payload.tier",["object/get",["array/nth","@config.cases","@entity.index"],"expectTier"]],"pass","fail"]}],["emit","POOL_WRITE",{"value":"@payload.value","name":"@payload.orbitalName","kind":"instrument","topic":"","hint":["object/get","@payload.fields","hint",""],"description":["str/concat",["object/get",["array/nth","@config.cases","@entity.index"],"request"]," — ",["object/get","@payload.fields","hint",""]]}]]},{"from":"running","to":"idle","event":"BUILD_FAILED_CASE","eventId":"evt_NT1DC5HPY0VF02A4ZHTQS1MVPG","effects":[["persist","create","EvalCase",{"caseId":["object/get",["array/nth","@config.cases","@entity.index"],"id"],"request":["object/get",["array/nth","@config.cases","@entity.index"],"request"],"expectTier":["object/get",["array/nth","@config.cases","@entity.index"],"expectTier"],"latencyMs":["-","@now","@entity.startedAt"],"verdict":"fail","error":"@payload.error"}]]}]},"config":{"cases":{"type":"[EvalCaseSpec]","default":[{"id":"sort-animals","request":"A quick game sorting animals into mammals, birds and reptiles","expectTier":"instrument"},{"id":"sort-animals-again","request":"Sort some animals into mammals, birds and reptiles","expectTier":"pool"},{"id":"water-cycle","request":"Put the stages of the water cycle in order","expectTier":"instrument"}],"label":"Cases","tier":"domain","items":{"type":"object","properties":{"id":{"name":"id","type":"string","required":true},"request":{"name":"request","type":"string","required":true},"expectTier":{"name":"expectTier","type":"string","required":true}}}}},"scope":"instance"}],"pages":[{"name":"EvalAgentBuilderPage","id":"pag_J1XBYFW1150GJW70DZQ06DFSB3","path":"/","isInitial":true,"traits":[{"ref":"EvalDriver","refId":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2"},{"ref":"EvalBuilderBuilderPipeline"},{"ref":"EvalBuilderBuilderTools"},{"ref":"EvalPoolAgentPoolWriter"},{"ref":"EvalPoolAgentPoolSearch"},{"ref":"EvalPoolAgentPoolSignal"}]}],"types":{"EvalCaseSpec":[{"name":"id","type":"string","required":true},{"name":"request","type":"string","required":true},{"name":"expectTier","type":"string","required":true}]}}],"schemaVersion":1,"ledger":{"schemaVersion":1,"entries":{"ent_0W4WPKTQQGBVRA1D212XSPFR40":{"id":"ent_0W4WPKTQQGBVRA1D212XSPFR40","kind":"entity","bakedName":"EvalRunView","curName":"EvalRunView","renames":[],"owner":"workspace"},"ent_9QYRWNCR34C1J921N566HF0TJD":{"id":"ent_9QYRWNCR34C1J921N566HF0TJD","kind":"entity","bakedName":"EvalCase","curName":"EvalCase","renames":[],"owner":"workspace"},"evt_5EFBX5R1FP0QV2H97KM0GB6C4Q":{"id":"evt_5EFBX5R1FP0QV2H97KM0GB6C4Q","kind":"event","bakedName":"INIT","curName":"INIT","renames":[],"owner":"workspace","parent":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2"},"evt_651JQR2FBF7NQPVNRX8CFAHEG5":{"id":"evt_651JQR2FBF7NQPVNRX8CFAHEG5","kind":"event","bakedName":"POOL_WRITE","curName":"POOL_WRITE","renames":[],"owner":"workspace","parent":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2"},"evt_A7X6435064G325MY8AN65R2JVD":{"id":"evt_A7X6435064G325MY8AN65R2JVD","kind":"event","bakedName":"RUN_CASE","curName":"RUN_CASE","renames":[],"owner":"workspace","parent":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2"},"evt_DYCZ69DKP1SV0Y6QAXK74SF2QE":{"id":"evt_DYCZ69DKP1SV0Y6QAXK74SF2QE","kind":"event","bakedName":"READ_CASES","curName":"READ_CASES","renames":[],"owner":"workspace","parent":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2"},"evt_GB5DZ969124GH9PNTQMTFF9EQM":{"id":"evt_GB5DZ969124GH9PNTQMTFF9EQM","kind":"event","bakedName":"CASES_READ","curName":"CASES_READ","renames":[],"owner":"workspace","parent":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2"},"evt_NT1DC5HPY0VF02A4ZHTQS1MVPG":{"id":"evt_NT1DC5HPY0VF02A4ZHTQS1MVPG","kind":"event","bakedName":"BUILD_FAILED_CASE","curName":"BUILD_FAILED_CASE","renames":[],"owner":"workspace","parent":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2"},"evt_S5EP9P8MPJAB96NZVV9KYZHCDZ":{"id":"evt_S5EP9P8MPJAB96NZVV9KYZHCDZ","kind":"event","bakedName":"START_BUILD","curName":"START_BUILD","renames":[],"owner":"workspace","parent":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2"},"evt_XBS22GY0AB055QR1P810PD159G":{"id":"evt_XBS22GY0AB055QR1P810PD159G","kind":"event","bakedName":"BUILD_DONE","curName":"BUILD_DONE","renames":[],"owner":"workspace","parent":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2"},"evt_XT3KRZ6K299H4MC7CC6BEM71TR":{"id":"evt_XT3KRZ6K299H4MC7CC6BEM71TR","kind":"event","bakedName":"CASES_FAILED","curName":"CASES_FAILED","renames":[],"owner":"workspace","parent":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2"},"orb_1RBTNWSYP4ZB2DS8HR46T4SYHD":{"id":"orb_1RBTNWSYP4ZB2DS8HR46T4SYHD","kind":"orbital","bakedName":"EvalRun","curName":"EvalRun","renames":[],"owner":"workspace"},"orb_B4CBBR7ZCZZPFQ9VQ4DHNSGH0H":{"id":"orb_B4CBBR7ZCZZPFQ9VQ4DHNSGH0H","kind":"orbital","bakedName":"EvalBuilder","curName":"EvalBuilder","renames":[],"owner":"workspace"},"orb_GDCH3NDAA2N517XFESF0M0EQDB":{"id":"orb_GDCH3NDAA2N517XFESF0M0EQDB","kind":"orbital","bakedName":"EvalPool","curName":"EvalPool","renames":[],"owner":"workspace"},"pag_J1XBYFW1150GJW70DZQ06DFSB3":{"id":"pag_J1XBYFW1150GJW70DZQ06DFSB3","kind":"page","bakedName":"EvalAgentBuilderPage","curName":"EvalAgentBuilderPage","renames":[],"owner":"workspace"},"trt_XGZ1Z6WT64D32FDRC6CN36X6C2":{"id":"trt_XGZ1Z6WT64D32FDRC6CN36X6C2","kind":"trait","bakedName":"EvalDriver","curName":"EvalDriver","renames":[],"owner":"workspace"}}}}