@almadar/std 16.238.0 → 16.239.0

package/behaviors/lolo/ui/core/atoms/ui-theme-toggle.lolo

@@ -17,6 +17,7 @@ orbital ThemeToggleOrbital {
           showLabel: @config.showLabel
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -56,6 +57,10 @@ orbital ThemeToggleOrbital {
         @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/atoms/ui-time-slot-cell.lolo

@@ -25,6 +25,7 @@ orbital TimeSlotCellOrbital {
           onPointerLeave: @config.onPointerLeave
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -55,6 +56,7 @@ orbital TimeSlotCellOrbital {
           onPointerLeave: @config.onPointerLeave
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -144,6 +146,10 @@ orbital TimeSlotCellOrbital {
         @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/atoms/ui-trend-indicator.lolo

@@ -21,6 +21,7 @@ orbital TrendIndicatorOrbital {
           size: @config.size
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -76,6 +77,10 @@ orbital TrendIndicatorOrbital {
         @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/atoms/ui-typewriter-text.lolo

@@ -19,6 +19,7 @@ orbital TypewriterTextOrbital {
           onComplete: @config.onComplete
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -72,6 +73,10 @@ orbital TypewriterTextOrbital {
         @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/atoms/ui-typography.lolo

@@ -27,6 +27,7 @@ orbital TypographyOrbital {
           children: @config.children
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -106,6 +107,10 @@ orbital TypographyOrbital {
         @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/atoms/ui-vstack.lolo

@@ -26,6 +26,7 @@ orbital VstackOrbital {
           responsive: @config.responsive
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -107,6 +108,10 @@ orbital VstackOrbital {
         @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/molecules/ui-accordion.lolo

@@ -27,10 +27,12 @@ orbital AccordionOrbital {
           defaultOpen: @config.defaultOpen
           openItems: @config.openItems
           onItemToggle: @config.onItemToggle
+          surface: @config.surface
           className: @config.className
           toggleEvent: @config.toggleEvent
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -89,6 +91,10 @@ orbital AccordionOrbital {
         @label "On Item Toggle"
         @description "Callback when item opens/closes"
         @tier "presentation"
+      surface : "auto" | "none" = auto
+        @label "Surface"
+        @description "Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out."
+        @tier "presentation"
       className : string
         @label "Class Name"
         @description "Additional CSS classes"
@@ -105,6 +111,10 @@ orbital AccordionOrbital {
         @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/molecules/ui-activation-block.lolo

@@ -18,6 +18,7 @@ orbital ActivationBlockOrbital {
           className: @config.className
           enter: @config.enter
           enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
           aria-label: @config.ariaLabel
           aria-labelledby: @config.ariaLabelledby
           aria-describedby: @config.ariaDescribedby
@@ -61,6 +62,10 @@ orbital ActivationBlockOrbital {
         @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/molecules/ui-agent-activity-feed.lolo

@@ -0,0 +1,249 @@
+app ui-agent-activity-feed "1.0.0"
+"AgentActivityFeed — UI factory (1:1 with the @almadar/ui agent-activity-feed pattern)."
+;; @pattern "agent-activity-feed"
+orbital AgentActivityFeedOrbital {
+  type AgentActivityFeedActivitiesItem = AgentActivityFeedActivitiesItemMessage | AgentActivityFeedActivitiesItemToolCall | AgentActivityFeedActivitiesItemToolResult | AgentActivityFeedActivitiesItemFileOperation | AgentActivityFeedActivitiesItemSchemaDiff | AgentActivityFeedActivitiesItemError | AgentActivityFeedActivitiesItemCoordinatorDecision | AgentActivityFeedActivitiesItemPlanCommitted | AgentActivityFeedActivitiesItemPendingQuestion | AgentActivityFeedActivitiesItemClarificationQuestion | AgentActivityFeedActivitiesItemAnalysis | AgentActivityFeedActivitiesItemOrbitalStarted | AgentActivityFeedActivitiesItemOrbitalDone | AgentActivityFeedActivitiesItemSchemaChange | AgentActivityFeedActivitiesItemDone | AgentActivityFeedActivitiesItemCancelled | AgentActivityFeedActivitiesItemLlmResponse
+  type AgentActivityFeedActivitiesItemMessage = {
+    type : "message"!
+    role : "user" | "assistant" | "system"!
+    content : string!
+    timestamp : number!
+    isStreaming : boolean
+  }
+  type AgentActivityFeedActivitiesItemToolCall = {
+    type : "tool_call"!
+    tool : string!
+    kind : "input" | "read" | "invalid"
+    argsText : string!
+    timestamp : number!
+    isExecuting : boolean
+  }
+  type AgentActivityFeedActivitiesItemToolResult = {
+    type : "tool_result"!
+    tool : string!
+    kind : "input" | "read" | "invalid"
+    success : boolean!
+    detail : string
+    rows : number
+    resultText : string!
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemFileOperation = {
+    type : "file_operation"!
+    operation : "ls" | "read_file" | "write_file" | "edit_file"!
+    path : string!
+    success : boolean
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemSchemaDiff = {
+    type : "schema_diff"!
+    filePath : string!
+    hunks : [AgentActivityFeedActivitiesItemSchemaDiffHunksItem]!
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemSchemaDiffHunksItem = {
+    oldStart : number!
+    oldLines : number!
+    newStart : number!
+    newLines : number!
+    lines : [AgentActivityFeedActivitiesItemSchemaDiffHunksItemLinesItem]!
+  }
+  type AgentActivityFeedActivitiesItemSchemaDiffHunksItemLinesItem = {
+    type : "add" | "remove" | "context"!
+    content : string!
+  }
+  type AgentActivityFeedActivitiesItemError = {
+    type : "error"!
+    message : string!
+    code : string
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemCoordinatorDecision = {
+    type : "coordinator_decision"!
+    organism : string!
+    reason : string!
+    priorOrganism : string
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemPlanCommitted = {
+    type : "plan_committed"!
+    orbitals : [string]!
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemPendingQuestion = {
+    type : "pending_question"!
+    questionId : string!
+    question : string!
+    orbitalName : string
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemClarificationQuestion = {
+    type : "clarification_question"!
+    level : "organism" | "molecule" | "atom_trait"!
+    scope : AgentActivityFeedActivitiesItemClarificationQuestionScope!
+    question : string!
+    candidates : [AgentActivityFeedActivitiesItemClarificationQuestionCandidatesItem]!
+    skipDefault : string!
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemClarificationQuestionScope = {
+    orbitalName : string
+    traitName : string
+  }
+  type AgentActivityFeedActivitiesItemClarificationQuestionCandidatesItem = {
+    id : string!
+    label : string!
+    description : string!
+    whyThisFits : string!
+  }
+  type AgentActivityFeedActivitiesItemAnalysis = {
+    type : "analysis"!
+    organism : string!
+    organismReason : string
+    complexity : AgentActivityFeedActivitiesItemAnalysisComplexity
+    renames : [AgentActivityFeedActivitiesItemAnalysisRenamesItem]!
+    deletes : [string]!
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemAnalysisComplexity = {
+    category : string!
+    reasoning : string!
+  }
+  type AgentActivityFeedActivitiesItemAnalysisRenamesItem = {
+    from : string!
+    to : string!
+  }
+  type AgentActivityFeedActivitiesItemOrbitalStarted = {
+    type : "orbital_started"!
+    orbitalName : string!
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemOrbitalDone = {
+    type : "orbital_done"!
+    orbitalName : string!
+    traitCount : number
+    transitionCount : number
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemSchemaChange = {
+    type : "schema_change"!
+    changeKind : "orbital-added" | "orbital-removed" | "entity-fields-changed" | "trait-added" | "trait-removed" | "trait-config-changed" | "state-machine-changed" | "guard-changed" | "effect-changed" | "render-ui-changed" | "event-wiring-changed" | "page-changed" | "theme-changed" | "behavior-composed"!
+    orbitalName : string!
+    traitName : string
+    transitionEvent : string
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemDone = {
+    type : "done"!
+    orbitalCount : number!
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemCancelled = {
+    type : "cancelled"!
+    message : string!
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemLlmResponse = {
+    type : "llm_response"!
+    content : string!
+    llm : AgentActivityFeedActivitiesItemLlmResponseLlm
+    timestamp : number!
+  }
+  type AgentActivityFeedActivitiesItemLlmResponseLlm = {
+    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 AgentActivityFeedJUMPTarget = {
+    orbital : string!
+    trait : string
+    transition : string
+  }
+
+  entity AgentActivityFeedItem [runtime] {
+    id : string!
+  }
+
+  trait AgentActivityFeedRender -> @rebindable AgentActivityFeedItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          activities: @config.activities
+          working: @config.working
+          onJump: @config.onJump
+          emptyTitle: @config.emptyTitle
+          emptyDescription: @config.emptyDescription
+          followLatest: @config.followLatest
+          className: @config.className
+          enter: @config.enter
+          enterDelay: @config.enterDelay
+          skeleton: @config.skeleton
+          type: agent-activity-feed
+        })
+    }
+
+    emits {
+      @config.onJump -> external {
+        target : AgentActivityFeedJUMPTarget
+      }
+        @description "onJump prop"
+        @tier "essential"
+    }
+
+    config {
+      activities : [AgentActivityFeedActivitiesItem] = []
+        @label "Activities"
+        @description "activities prop"
+        @tier "presentation"
+      working : boolean = false
+        @label "Working"
+        @description "The agent is running: show the thinking row after the last activity."
+        @tier "presentation"
+      onJump : event = "JUMP"
+        @label "On Jump"
+        @description "onJump prop"
+        @tier "presentation"
+      emptyTitle : string
+        @label "Empty Title"
+        @description "emptyTitle prop"
+        @tier "presentation"
+      emptyDescription : string
+        @label "Empty Description"
+        @description "emptyDescription prop"
+        @tier "presentation"
+      followLatest : boolean = true
+        @label "Follow Latest"
+        @description "Scroll the latest row into view as rows arrive. Off for a list of feeds (a run history). @default true"
+        @tier "presentation"
+      className : string
+        @label "Class Name"
+        @description "className prop"
+        @tier "presentation"
+      enter : "none" | "fade" | "rise" | "scale" | "slide"
+        @label "Enter"
+        @description "How this element animates in when it mounts (theme-styled); overrides the theme's default slot entry. `none` opts out."
+        @tier "presentation"
+      enterDelay : number
+        @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"
+    }
+  }
+
+  page "/agent-activity-feed" as AgentActivityFeedPage -> AgentActivityFeedRender
+}

package/behaviors/lolo/ui/core/molecules/ui-agent-activity-row.lolo

@@ -0,0 +1,218 @@
+app ui-agent-activity-row "1.0.0"
+"AgentActivityRow — UI factory (1:1 with the @almadar/ui agent-activity-row pattern)."
+;; @pattern "agent-activity-row"
+orbital AgentActivityRowOrbital {
+  type AgentActivityRowActivity = AgentActivityRowActivityMessage | AgentActivityRowActivityToolCall | AgentActivityRowActivityToolResult | AgentActivityRowActivityFileOperation | AgentActivityRowActivitySchemaDiff | AgentActivityRowActivityError | AgentActivityRowActivityCoordinatorDecision | AgentActivityRowActivityPlanCommitted | AgentActivityRowActivityPendingQuestion | AgentActivityRowActivityClarificationQuestion | AgentActivityRowActivityAnalysis | AgentActivityRowActivityOrbitalStarted | AgentActivityRowActivityOrbitalDone | AgentActivityRowActivitySchemaChange | AgentActivityRowActivityDone | AgentActivityRowActivityCancelled | AgentActivityRowActivityLlmResponse
+  type AgentActivityRowActivityMessage = {
+    type : "message"!
+    role : "user" | "assistant" | "system"!
+    content : string!
+    timestamp : number!
+    isStreaming : boolean
+  }
+  type AgentActivityRowActivityToolCall = {
+    type : "tool_call"!
+    tool : string!
+    kind : "input" | "read" | "invalid"
+    argsText : string!
+    timestamp : number!
+    isExecuting : boolean
+  }
+  type AgentActivityRowActivityToolResult = {
+    type : "tool_result"!
+    tool : string!
+    kind : "input" | "read" | "invalid"
+    success : boolean!
+    detail : string
+    rows : number
+    resultText : string!
+    timestamp : number!
+  }
+  type AgentActivityRowActivityFileOperation = {
+    type : "file_operation"!
+    operation : "ls" | "read_file" | "write_file" | "edit_file"!
+    path : string!
+    success : boolean
+    timestamp : number!
+  }
+  type AgentActivityRowActivitySchemaDiff = {
+    type : "schema_diff"!
+    filePath : string!
+    hunks : [AgentActivityRowActivitySchemaDiffHunksItem]!
+    timestamp : number!
+  }
+  type AgentActivityRowActivitySchemaDiffHunksItem = {
+    oldStart : number!
+    oldLines : number!
+    newStart : number!
+    newLines : number!
+    lines : [AgentActivityRowActivitySchemaDiffHunksItemLinesItem]!
+  }
+  type AgentActivityRowActivitySchemaDiffHunksItemLinesItem = {
+    type : "add" | "remove" | "context"!
+    content : string!
+  }
+  type AgentActivityRowActivityError = {
+    type : "error"!
+    message : string!
+    code : string
+    timestamp : number!
+  }
+  type AgentActivityRowActivityCoordinatorDecision = {
+    type : "coordinator_decision"!
+    organism : string!
+    reason : string!
+    priorOrganism : string
+    timestamp : number!
+  }
+  type AgentActivityRowActivityPlanCommitted = {
+    type : "plan_committed"!
+    orbitals : [string]!
+    timestamp : number!
+  }
+  type AgentActivityRowActivityPendingQuestion = {
+    type : "pending_question"!
+    questionId : string!
+    question : string!
+    orbitalName : string
+    timestamp : number!
+  }
+  type AgentActivityRowActivityClarificationQuestion = {
+    type : "clarification_question"!
+    level : "organism" | "molecule" | "atom_trait"!
+    scope : AgentActivityRowActivityClarificationQuestionScope!
+    question : string!
+    candidates : [AgentActivityRowActivityClarificationQuestionCandidatesItem]!
+    skipDefault : string!
+    timestamp : number!
+  }
+  type AgentActivityRowActivityClarificationQuestionScope = {
+    orbitalName : string
+    traitName : string
+  }
+  type AgentActivityRowActivityClarificationQuestionCandidatesItem = {
+    id : string!
+    label : string!
+    description : string!
+    whyThisFits : string!
+  }
+  type AgentActivityRowActivityAnalysis = {
+    type : "analysis"!
+    organism : string!
+    organismReason : string
+    complexity : AgentActivityRowActivityAnalysisComplexity
+    renames : [AgentActivityRowActivityAnalysisRenamesItem]!
+    deletes : [string]!
+    timestamp : number!
+  }
+  type AgentActivityRowActivityAnalysisComplexity = {
+    category : string!
+    reasoning : string!
+  }
+  type AgentActivityRowActivityAnalysisRenamesItem = {
+    from : string!
+    to : string!
+  }
+  type AgentActivityRowActivityOrbitalStarted = {
+    type : "orbital_started"!
+    orbitalName : string!
+    timestamp : number!
+  }
+  type AgentActivityRowActivityOrbitalDone = {
+    type : "orbital_done"!
+    orbitalName : string!
+    traitCount : number
+    transitionCount : number
+    timestamp : number!
+  }
+  type AgentActivityRowActivitySchemaChange = {
+    type : "schema_change"!
+    changeKind : "orbital-added" | "orbital-removed" | "entity-fields-changed" | "trait-added" | "trait-removed" | "trait-config-changed" | "state-machine-changed" | "guard-changed" | "effect-changed" | "render-ui-changed" | "event-wiring-changed" | "page-changed" | "theme-changed" | "behavior-composed"!
+    orbitalName : string!
+    traitName : string
+    transitionEvent : string
+    timestamp : number!
+  }
+  type AgentActivityRowActivityDone = {
+    type : "done"!
+    orbitalCount : number!
+    timestamp : number!
+  }
+  type AgentActivityRowActivityCancelled = {
+    type : "cancelled"!
+    message : string!
+    timestamp : number!
+  }
+  type AgentActivityRowActivityLlmResponse = {
+    type : "llm_response"!
+    content : string!
+    llm : AgentActivityRowActivityLlmResponseLlm
+    timestamp : number!
+  }
+  type AgentActivityRowActivityLlmResponseLlm = {
+    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 AgentActivityRowFacts = {
+    settled : boolean!
+    readyCount : number!
+  }
+  type AgentActivityRowJUMPTarget = {
+    orbital : string!
+    trait : string
+    transition : string
+  }
+
+  entity AgentActivityRowItem [runtime] {
+    id : string!
+  }
+
+  trait AgentActivityRowRender -> @rebindable AgentActivityRowItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          activity: @config.activity
+          onJump: @config.onJump
+          facts: @config.facts
+          type: agent-activity-row
+        })
+    }
+
+    emits {
+      @config.onJump -> external {
+        target : AgentActivityRowJUMPTarget
+      }
+        @description "'Jump to' affordance — rendered only when supplied and the activity names an orbital."
+        @tier "essential"
+    }
+
+    config {
+      activity : AgentActivityRowActivity = {}
+        @label "Activity"
+        @description "activity prop"
+        @tier "presentation"
+      onJump : event = "JUMP"
+        @label "On Jump"
+        @description "'Jump to' affordance — rendered only when supplied and the activity names an orbital."
+        @tier "presentation"
+      facts : AgentActivityRowFacts = { settled: false, readyCount: 1 }
+        @label "Facts"
+        @description "What the row knows from its list (`activityRowFacts`)."
+        @tier "presentation"
+    }
+  }
+
+  page "/agent-activity-row" as AgentActivityRowPage -> AgentActivityRowRender
+}