@almadar/std 16.238.0 → 16.241.0

package/behaviors/lolo/agent/atoms/std-agent-tool-loop.lolo

@@ -1,5 +1,5 @@
 app std-agent-tool-loop "2.0.0"
-"std-agent-tool-loop — answers a conversation by operating the running app as the caller, through `call-service llm call-tools`. The `tools` allowlist names declared external 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. CONVERSE carries the conversation (and optionally what std-agent-memory recalled); REPLIED carries the reply, every tool step and the token usage; REPLY_FAILED carries the error. Compose with std-agent-session (the conversation) and std-agent-trace (the step record)."
+"std-agent-tool-loop — answers a conversation by operating the running app as the caller, through `call-service llm call-tools`. The `tools` allowlist names declared external 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. CONVERSE carries the conversation (and optionally what std-agent-memory recalled); STEP carries each step live while it works (a model call, a tool it used, what the app answered) to the asking tab; REPLIED carries the reply, every step and the token usage; REPLY_FAILED carries the error. Compose with std-agent-session (the conversation) and std-agent-trace (the step record)."
 
 type AgentTool = {
   event : event
@@ -9,13 +9,46 @@ type AgentChatMessage = {
   role : "user" | "assistant"
   content : string!
 }
-type AgentStep = {
-  kind : "input" | "read" | "invalid"
-  target : string!
-  args : string!
-  ok : boolean!
+type AgentToolKind = "input" | "read" | "invalid"
+type AgentToolCallActivity = {
+  type : "tool_call"!
+  tool : string!
+  kind : AgentToolKind
+  argsText : string!
+  timestamp : number!
+  isExecuting : boolean
+}
+type AgentToolResultActivity = {
+  type : "tool_result"!
+  tool : string!
+  kind : AgentToolKind
+  success : boolean!
   detail : string
+  rows : number
+  resultText : string!
+  timestamp : number!
+}
+type AgentLlmCall = {
+  service : string!
+  provider : string!
+  model : string!
+  systemPrompt : string!
+  userPrompt : string!
+  toolCallsJson : string
+  attempt : number
+  durationMs : number!
+  promptTokens : number
+  completionTokens : number
+  cachedPromptTokens : number
+  costUSD : number
+}
+type AgentLlmResponseActivity = {
+  type : "llm_response"!
+  content : string!
+  llm : AgentLlmCall
+  timestamp : number!
 }
+type AgentActivity = AgentToolCallActivity | AgentToolResultActivity | AgentLlmResponseActivity
 type AgentUsage = {
   promptTokens : number!
   completionTokens : number!
@@ -61,7 +94,7 @@ orbital AgentToolLoopOrbital {
           instructions: (if ["=", (str/default ?context ""), ""] @config.instructions (str/concat @config.instructions "\n\nWhat you remember that may be relevant:\n" ?context))
           maxSteps: @config.maxSteps
         } {
-          emit: { failure: ASK_FAILED, success: ANSWERED }
+          emit: { failure: ASK_FAILED, success: ANSWERED, onMessage: STEP }
         })
     }
 
@@ -82,9 +115,15 @@ orbital AgentToolLoopOrbital {
     }
 
     emits {
+      STEP -> external {
+        activity : AgentActivity!
+      }
+        @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"
       REPLIED -> external {
         reply : string!
-        steps : [AgentStep]!
+        steps : [AgentActivity]!
         usage : AgentUsage!
       }
         @description "The assistant answered; carries every tool step it took and the tokens it used."
@@ -98,7 +137,7 @@ orbital AgentToolLoopOrbital {
         @tier "domain"
       ANSWERED -> internal {
         reply : string!
-        steps : [AgentStep]!
+        steps : [AgentActivity]!
         usage : AgentUsage!
       }
         @tier "internal"

package/behaviors/lolo/agent/atoms/std-agent-trace.lolo

@@ -1,13 +1,46 @@
 app std-agent-trace "2.0.0"
-"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 tool step (which input or entity, the 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."
+"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."
 
-type AgentStep = {
-  kind : "input" | "read" | "invalid"
-  target : string!
-  args : string!
-  ok : boolean!
+type AgentToolKind = "input" | "read" | "invalid"
+type AgentToolCallActivity = {
+  type : "tool_call"!
+  tool : string!
+  kind : AgentToolKind
+  argsText : string!
+  timestamp : number!
+  isExecuting : boolean
+}
+type AgentToolResultActivity = {
+  type : "tool_result"!
+  tool : string!
+  kind : AgentToolKind
+  success : boolean!
   detail : string
+  rows : number
+  resultText : string!
+  timestamp : number!
+}
+type AgentLlmCall = {
+  service : string!
+  provider : string!
+  model : string!
+  systemPrompt : string!
+  userPrompt : string!
+  toolCallsJson : string
+  attempt : number
+  durationMs : number!
+  promptTokens : number
+  completionTokens : number
+  cachedPromptTokens : number
+  costUSD : number
 }
+type AgentLlmResponseActivity = {
+  type : "llm_response"!
+  content : string!
+  llm : AgentLlmCall
+  timestamp : number!
+}
+type AgentActivity = AgentToolCallActivity | AgentToolResultActivity | AgentLlmResponseActivity
 type AgentUsage = {
   promptTokens : number!
   completionTokens : number!
@@ -25,7 +58,7 @@ orbital AgentTraceOrbital {
     outcome : "answered" | "failed" @description "Whether the assistant answered." @synonyms "result, status" = answered
     reply : string @description "What the assistant said." @synonyms "answer, response" = ""
     error : string @description "Why the run failed." = ""
-    steps : [AgentStep] @description "Every tool use, in order." @synonyms "actions, tool calls, trace" = []
+    steps : [AgentActivity] @description "Every step, in order: each model call, each tool used and what the app answered." @synonyms "actions, tool calls, trace" = []
     promptTokens : number @description "Tokens sent to the model." = 0
     completionTokens : number @description "Tokens the model produced." = 0
     totalTokens : number @description "All tokens for the run." = 0
@@ -76,7 +109,7 @@ orbital AgentTraceOrbital {
     listens {
       REPLIED {
         reply : string!
-        steps : [AgentStep]!
+        steps : [AgentActivity]!
         usage : AgentUsage!
       }
         @description "Record an answered run."
@@ -116,6 +149,10 @@ orbital AgentTraceOrbital {
               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

package/behaviors/lolo/agent/organisms/std-agent-assistant.lolo

@@ -1,5 +1,5 @@
-app std-agent-assistant "1.0.0"
-"std-agent-assistant — an in-app assistant that operates the running app for the signed-in user. One request flows down a chain of std agent atoms on the bus: the conversation (std-agent-session) SENDs → CONVERSE → std-agent-context bounds it → std-agent-memory adds what it recalls → std-agent-tool-loop answers it through `call-service llm call-tools`, firing only the inputs and reading only the entities the `tools` allowlist names, as the signed-in user → REPLIED goes back to the conversation, to memory (remembered) and to std-agent-trace (the run record). Import the orbital and supply the allowlist: `orbital Assistant = Agent.orbitals.AgentAssistantOrbital { config { tools: [{ event: TaskOrbital.TaskPersistor.DO_CREATE }, { read: Task }], instructions: \"…\" } }`. The conversation, memory and run records live in AgentRecordsOrbital; retarget them onto your own owner-scoped entities (`ownerId` a relation to your [identity] roster, with @read/@create) with `entities { AgentMessage: …, AgentMemory: …, AgentRun: … }`."
+app std-agent-assistant "2.0.0"
+"std-agent-assistant — an in-app assistant that operates the running app for the signed-in user. A floating button opens it in a side panel docked beside the page (std-panel-launcher; a side sheet on small screens), where the conversation shows every step the assistant takes live as it works. List AssistantDock with the assistant's traits on each page that should carry the button. One request flows down a chain of std agent atoms on the bus: the conversation (std-agent-session) SENDs → CONVERSE → std-agent-context bounds it → std-agent-memory adds what it recalls → std-agent-tool-loop answers it through `call-service llm call-tools`, firing only the inputs and reading only the entities the `tools` allowlist names, as the signed-in user → REPLIED goes back to the conversation, to memory (remembered) and to std-agent-trace (the run record). Import the orbital and supply the allowlist: `orbital Assistant = Agent.orbitals.AgentAssistantOrbital { config { tools: [{ event: TaskOrbital.TaskPersistor.DO_CREATE }, { read: Task }], instructions: \"…\" } }`. The conversation, memory and run records live in AgentRecordsOrbital; retarget them onto your own owner-scoped entities (`ownerId` a relation to your [identity] roster, with @read/@create) with `entities { AgentMessage: …, AgentMemory: …, AgentRun: … }`."
 
 type AgentTool = {
   event : event
@@ -16,6 +16,7 @@ orbital AgentAssistantOrbital {
   uses Memory from "std/behaviors/std-agent-memory"
   uses Loop from "std/behaviors/std-agent-tool-loop"
   uses Trace from "std/behaviors/std-agent-trace"
+  uses Launcher from "std/behaviors/std-panel-launcher"
 
   config {
     tools : [AgentTool] = []
@@ -41,6 +42,13 @@ orbital AgentAssistantOrbital {
       @label "Links above the conversation"
       @description "The pages showing the assistant's run history and memory."
       @tier "presentation"
+    title : string = "Assistant"
+      @label "Panel title"
+      @tier "presentation"
+    buttonLabel : string = "Open the assistant"
+      @label "Button label"
+      @description "What the floating button does, read to screen readers and shown as its tooltip."
+      @tier "presentation"
   }
 
   entity AgentAssistant [runtime] {
@@ -48,21 +56,37 @@ orbital AgentAssistantOrbital {
   }
 
   trait AssistantThread = Session.traits.AgentThread -> AgentMessage {
-    config {
-      links: @config.links
-    }
     events {
       CONVERSE: REQUEST_CONTEXT
     }
     listens {
-      SEND {
-        message : string!
-      }
+      AssistantConversation.SEND -> SEND
+      AssistantLoop.REPLIED -> REPLIED
+    }
+  }
+
+  trait AssistantConversation = Session.traits.AgentConversation {
+    config {
+      links: @config.links
+    }
+    listens {
+      AssistantThread.AgentMessagesLoaded -> THREAD_LOADED
+      AssistantThread.THREAD_FAILED -> REPLY_FAILED
+      AssistantLoop.STEP -> STEP
       AssistantLoop.REPLIED -> REPLIED
       AssistantLoop.REPLY_FAILED -> REPLY_FAILED
     }
   }
 
+  trait AssistantDock = Launcher.traits.PanelLauncher {
+    config {
+      contentTrait: @trait.AssistantConversation
+      title: @config.title
+      label: @config.buttonLabel
+      icon: message-circle
+    }
+  }
+
   trait AssistantContext = Context.traits.AgentContextCompactor {
     config {
       keepMessages: @config.keepMessages
@@ -100,7 +124,7 @@ orbital AgentAssistantOrbital {
     }
   }
 
-  page "/assistant" as AssistantPage -> AssistantThread, AssistantContext, AssistantMemory, AssistantLoop, AssistantTrace
+  page "/assistant" as AssistantPage -> AssistantDock, AssistantThread, AssistantContext, AssistantMemory, AssistantLoop, AssistantTrace
 }
 
 ;; The assistant's records live outside AgentAssistantOrbital, so a consumer

package/behaviors/lolo/ui/avl/atoms/ui-avl-glyph.lolo

@@ -20,6 +20,7 @@ orbital AvlGlyphOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -47,7 +48,7 @@ orbital AvlGlyphOrbital {
         @label "Label"
         @description "Caption, and the drawn text for operator / literal / bindingRef symbols."
         @tier "presentation"
-      effectType : string
+      effectType : string = set
         @label "Effect Type"
         @description "Effect symbol variant. @default 'set'"
         @tier "presentation"
@@ -71,6 +72,10 @@ orbital AvlGlyphOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

package/behaviors/lolo/ui/avl/atoms/ui-avl-state-machine.lolo

@@ -60,6 +60,7 @@ orbital AvlStateMachineOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -161,6 +162,10 @@ orbital AvlStateMachineOrbital {
         @label "Enter Delay"
         @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
         @tier "presentation"
+      skeleton : "header" | "table" | "list" | "grid" | "detail" | "stats" | "form" | "card" | "text" | "none"
+        @label "Skeleton"
+        @description "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`."
+        @tier "presentation"
       ariaLabel : string
         @label "Aria-label"
         @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."

package/behaviors/lolo/ui/core/.hand-authored.json

@@ -79,10 +79,6 @@
     "signature": "b6d780174cc19310",
     "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-image-upload-multi.lolo"
   },
-  "std-list": {
-    "signature": "ece46e2df57db77d",
-    "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-list.lolo"
-  },
   "std-modal": {
     "signature": "e8718a24813236d8",
     "board": "packages/almadar-std/behaviors/lolo/ui/core/atoms/std-modal.lolo"

package/behaviors/lolo/ui/core/atoms/std-billable-hour.lolo

@@ -59,17 +59,26 @@ orbital BillableHourOrbital {
         })
       BillableHourLoaded -> browsing
         (render-ui main {
-          children: [{
-            align: center
-            children: [{ name: clock, size: lg, type: icon }, {
-              content: @config.title
-              type: typography
-              variant: h3
-            }]
-            direction: horizontal
-            gap: sm
+          children: [(if @config.showHeader {
+            children: [{
+              align: center
+              children: [{ name: clock, size: lg, type: icon }, {
+                content: @config.title
+                type: typography
+                variant: h3
+              }]
+              direction: horizontal
+              gap: sm
+              type: stack
+            }, { type: divider }]
+            direction: vertical
+            gap: md
             type: stack
-          }, { type: divider }, {
+          } {
+            children: []
+            gap: none
+            type: stack
+          }), {
             children: [@trait.DenseHoursTable]
             className: overflow-x-auto
             direction: vertical
@@ -367,6 +376,10 @@ orbital BillableHourOrbital {
     }
 
     config {
+      showHeader : boolean = true
+        @label "Show the list's own title row?"
+        @description "Off when the page already carries a page header naming the same thing, so the page shows one title."
+        @tier "presentation"
       title : string = "Time Entries"
         @label "Section title"
         @description "Heading shown above the time-entries list"

package/behaviors/lolo/ui/core/atoms/std-board.lolo

@@ -587,6 +587,11 @@ orbital BoardOrbital {
         @label "Group-by field"
         @description "Entity field whose value matches a column key — items are filtered into columns by it. Default 'stage'; set to 'status' (or any field) for entities that track state under a different name."
         @tier "presentation"
+      addPlacement : "floating" | "inline" = floating
+        @label "Add button placement"
+        @description "Where the add-item button sits: 'floating' (default) pins a floating action button to the screen corner; 'inline' renders an ordinary Add button above the columns, for a board embedded in a card or panel."
+        @synonyms "add button position, floating add, inline add, add item button placement. user phrases: 'put the add button inside the board' / 'no floating button' -> inline"
+        @tier "presentation"
       boardLook : "columns" | "kanban-classic" = columns
         @label "Board look"
         @description "Layer 3 body layout: default N-column data-grid ('columns'), or a Trello-style wide-column kanban with sticky column headers ('kanban-classic')."
@@ -647,7 +652,24 @@ orbital BoardOrbital {
         @description "Actions row of the open-card panel. Default is the Delete button only. Override to add consumer-wired actions — e.g. an Edit button with action: EDIT_CARD and actionPayload: { id: @entity.currentId, row: @entity.currentRow }, listened to by the organism's edit modal. Never leave a button here without a listener."
         @tier "presentation"
       bodyContent : render-ui = {
-        children: [(if @config.showHeader {
+        children: [(if ["=", @config.addPlacement, "inline"] {
+          children: [{
+            action: ADD_CARD
+            icon: plus
+            label: "Add item"
+            size: sm
+            type: button
+            variant: secondary
+          }]
+          direction: horizontal
+          gap: sm
+          justify: end
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), (if @config.showHeader {
           children: [{
             align: center
             children: [{ name: kanban-square, size: lg, type: icon }, {
@@ -770,13 +792,17 @@ orbital BoardOrbital {
             type: card
           })
           type: data-grid
-        }, {
+        }, (if ["=", @config.addPlacement, "floating"] {
           action: ADD_CARD
           icon: plus
           label: "Add item"
           type: floating-action-button
           variant: primary
-        }]
+        } {
+          children: []
+          gap: none
+          type: stack
+        })]
         direction: vertical
         gap: md
         type: stack
@@ -785,7 +811,24 @@ orbital BoardOrbital {
         @description "Render-ui SExpr rendered after the board loads for boardLook='columns' — the canonical column data-grid with nested per-column data-lists. boardLook='kanban-classic' renders kanbanClassicBodyContent instead; both share this trait's state machine, emits, and listens."
         @tier "internal"
       kanbanClassicBodyContent : render-ui = {
-        children: [(if @config.showHeader {
+        children: [(if ["=", @config.addPlacement, "inline"] {
+          children: [{
+            action: ADD_CARD
+            icon: plus
+            label: "Add card"
+            size: sm
+            type: button
+            variant: secondary
+          }]
+          direction: horizontal
+          gap: sm
+          justify: end
+          type: stack
+        } {
+          children: []
+          gap: none
+          type: stack
+        }), (if @config.showHeader {
           children: [{
             align: center
             children: [{ name: kanban-square, size: xl, type: icon }, {
@@ -931,13 +974,17 @@ orbital BoardOrbital {
           })
           scrollX: true
           type: data-grid
-        }, {
+        }, (if ["=", @config.addPlacement, "floating"] {
           action: ADD_CARD
           icon: plus
           label: "Add card"
           type: floating-action-button
           variant: primary
-        }]
+        } {
+          children: []
+          gap: none
+          type: stack
+        })]
         className: h-full
         direction: vertical
         gap: md