@llm4ts/runner 2.52.0 → 2.54.0

package/src/AgentTree.ts

@@ -26,8 +26,12 @@ export type TreeInput =
 
 export type LaneStatus = "running" | "done" | "failed"
 
+/** What a lane stands for: a story's coder (ADR 0022), a roundtable attendee (ADR 0046), or a taskforce specialist (ADR 0047). */
+export type LaneKind = "story" | "attendee" | "specialist"
+
 export interface TreeLane {
   readonly id: string
+  readonly kind: LaneKind
   /** The lane's open stages below `story <id>`, innermost last. */
   readonly stages: ReadonlyArray<string>
   readonly executor: string | undefined
@@ -68,6 +72,24 @@ export interface TreeLane {
   readonly pause: { readonly label: string; readonly since: number } | undefined
   /** Tasks running beside the lane's coder, each on a coder of its own (ADR 0034). */
   readonly taskCoders: ReadonlyArray<TreeTaskCoder>
+  /** A specialist's last report (ADR 0047); other lanes have none. */
+  readonly report:
+    | {
+        readonly brief: string
+        readonly status: string
+        readonly summary: string
+        readonly attempt: number
+      }
+    | undefined
+  /** An attendee's last turn (ADR 0046); a story lane has none. */
+  readonly turn:
+    | {
+        readonly id: number
+        readonly kind: string
+        readonly summary: string
+        readonly blocking: boolean
+      }
+    | undefined
 }
 
 /** A task running beside a story's coder, in its own worktree (ADR 0034). */
@@ -257,7 +279,8 @@ const logged = (state: TreeState, entry: TreeLogEntry): TreeState => ({
   log: [...state.log, entry]
 })
 
-const storyStage = /^story (\S+)$/u
+/** The stage that opens a lane: a story's, a roundtable attendee's or a taskforce specialist's (names may hold spaces). */
+const laneStage = /^(story|attendee|specialist) (.+)$/u
 const expandedTools = 20
 
 const updateLane = (
@@ -401,10 +424,18 @@ const reduceEvent = (state: TreeState, at: number, event: FlowEvent): TreeState
         }
   switch (event._tag) {
     case "StageStarted": {
-      const story = storyStage.exec(event.stage)?.[1]
+      const opened = laneStage.exec(event.stage)
+      const story = opened?.[2]
       if (story !== undefined && event.lane === story) {
+        const kind: LaneKind =
+          opened?.[1] === "attendee"
+            ? "attendee"
+            : opened?.[1] === "specialist"
+              ? "specialist"
+              : "story"
         const fresh: TreeLane = {
           id: story,
+          kind,
           stages: [],
           executor: event.executor,
           startedAt: at,
@@ -423,7 +454,9 @@ const reduceEvent = (state: TreeState, at: number, event: FlowEvent): TreeState
           task: undefined,
           children: [],
           pause: undefined,
-          taskCoders: []
+          taskCoders: [],
+          report: undefined,
+          turn: undefined
         }
         return {
           ...current,
@@ -444,7 +477,7 @@ const reduceEvent = (state: TreeState, at: number, event: FlowEvent): TreeState
     }
     case "StageCompleted":
     case "StageFailed": {
-      if (lane !== undefined && event.stage === `story ${lane.id}`) {
+      if (lane !== undefined && event.stage === `${lane.kind} ${lane.id}`) {
         const status: LaneStatus = event._tag === "StageFailed" ? "failed" : "done"
         const closed = updateLane(current, lane.id, (open) => ({
           ...open,
@@ -542,6 +575,43 @@ const reduceEvent = (state: TreeState, at: number, event: FlowEvent): TreeState
               : {})
           }))
     }
+    case "RoundtableTurn": {
+      const what = `#${event.turn} ${event.kind}${event.blocking ? " (blocking)" : ""}${
+        event.answers.length === 0 ? "" : ` → ${event.answers.map((id) => `#${id}`).join(", ")}`
+      }: ${event.summary}`
+      if (lane === undefined) {
+        // The Chair and the Owner have no seat at the table: their words are the run's.
+        return logged(current, { at, source: "run", who: event.lane, what })
+      }
+      const spoken = updateLane(current, lane.id, (open) => ({
+        ...open,
+        stages: [`item ${event.item} r${event.round}`],
+        turn: {
+          id: event.turn,
+          kind: event.kind,
+          summary: event.summary,
+          blocking: event.blocking
+        }
+      }))
+      return logged(spoken, { at, source: "lane", who: lane.id, what })
+    }
+    case "BriefReported": {
+      const what = `${event.brief} ${event.status}${event.attempt > 1 ? ` (attempt ${event.attempt})` : ""}: ${event.summary}`
+      if (lane === undefined) {
+        // A name without a lane of its own: its report is the run's.
+        return logged(current, { at, source: "run", who: event.lane, what })
+      }
+      const handed = updateLane(current, lane.id, (open) => ({
+        ...open,
+        report: {
+          brief: event.brief,
+          status: event.status,
+          summary: event.summary,
+          attempt: event.attempt
+        }
+      }))
+      return logged(handed, { at, source: "lane", who: lane.id, what })
+    }
     case "StoryJudged": {
       const verdict: TreeVerdict = {
         lane: event.lane,
@@ -1266,6 +1336,21 @@ const statusMark = (lane: TreeLane, now: number | undefined, idleAfterMs: number
 }
 
 /** `3/5 wire session cookie`, or `2/5 tasks` between tasks, or nothing before the plan. */
+/** An attendee's last turn as one line: `#4 objection (blocking): …`. */
+const turnText = (lane: TreeLane): string =>
+  lane.turn === undefined
+    ? ""
+    : `#${lane.turn.id} ${lane.turn.kind}${lane.turn.blocking ? " (blocking)" : ""}: ${lane.turn.summary}`
+
+/** A specialist's last report as one line: `B3 PASS: …`. */
+const reportText = (lane: TreeLane): string =>
+  lane.report === undefined
+    ? ""
+    : `${lane.report.brief} ${lane.report.status}${lane.report.attempt > 1 ? ` (attempt ${lane.report.attempt})` : ""}: ${lane.report.summary}`
+
+/** A lane without a coder of its own: an attendee borrows the room's seat, a specialist its role's. */
+const seatless = (lane: TreeLane): boolean => lane.kind === "attendee" || lane.kind === "specialist"
+
 const taskText = (lane: TreeLane): string =>
   lane.task !== undefined
     ? `${lane.task.index}/${lane.task.count} ${lane.task.title}`
@@ -1287,14 +1372,22 @@ const laneLine = (
   selected: boolean,
   idleAfterMs: number
 ): Line => {
-  const task = taskText(lane)
-  const stage = lane.stages.at(-1) ?? "starting"
+  const task =
+    lane.kind === "attendee"
+      ? turnText(lane)
+      : lane.kind === "specialist"
+        ? reportText(lane)
+        : taskText(lane)
+  const stage =
+    lane.stages.at(-1) ??
+    (lane.kind === "attendee" ? "listening" : lane.kind === "specialist" ? "idle" : "starting")
   const head: Line = [
     span(selected ? "▸ " : "  "),
     statusMark(lane, now, idleAfterMs),
     span(" "),
     span(lane.id, "bold"),
-    span(` ${cloneName(lane.executor ?? "(leasing)", lane.clone)}`),
+    // An attendee borrows the room's one seat, a specialist its role's: no executor of its own to show.
+    ...(seatless(lane) ? [] : [span(` ${cloneName(lane.executor ?? "(leasing)", lane.clone)}`)]),
     ...(task.length === 0 ? [] : [span(" · "), span(task)]),
     // A task is a stage of its own name: say it once.
     ...(stage === lane.task?.title ? [] : [span(" · "), span(stage, "dim")]),
@@ -1416,8 +1509,9 @@ const detailBox = (
   expanded: boolean
 ): Array<Line> => {
   const inner = width - 4
-  const checklist: Array<Line> =
-    lane.tasks.length === 0
+  const checklist: Array<Line> = seatless(lane)
+    ? []
+    : lane.tasks.length === 0
       ? [[span("no task plan yet", "dim")]]
       : lane.tasks.map((task): Line => {
           const beside = lane.taskCoders.find((coder) => coder.index === task.index)
@@ -1447,9 +1541,14 @@ const detailBox = (
     : lane.tools.length === 0
       ? []
       : [[span("tools  "), span(lane.tools.slice(-3).join(" · "), "dim")]]
-  const title = `${lane.id} · ${cloneName(lane.executor ?? "(leasing)", lane.clone)}${
-    lane.task === undefined ? "" : ` · task ${lane.task.index}/${lane.task.count}`
-  }`
+  const title =
+    lane.kind === "attendee"
+      ? `${lane.id} · ${lane.turn === undefined ? "listening" : turnText(lane)}`
+      : lane.kind === "specialist"
+        ? `${lane.id} · ${lane.report === undefined ? "idle" : reportText(lane)}`
+        : `${lane.id} · ${cloneName(lane.executor ?? "(leasing)", lane.clone)}${
+            lane.task === undefined ? "" : ` · task ${lane.task.index}/${lane.task.count}`
+          }`
   return box(
     width,
     "running",

package/src/Terminal.ts

@@ -42,6 +42,8 @@ export const rendersEvent = (verbosity: Verbosity, event: FlowEvent): boolean =>
     case "UsageProgress":
     case "ExecutorReleased":
     case "StoryJudged":
+    case "RoundtableTurn":
+    case "BriefReported":
     case "Timed":
     case "TasksPlanned":
     case "TaskStarted":
@@ -253,6 +255,8 @@ export const terminalLine = (
     case "BlackboardRun":
     case "UsageProgress":
     case "StoryJudged":
+    case "RoundtableTurn":
+    case "BriefReported":
     case "Timed":
     case "TasksPlanned":
     case "TaskStarted":

package/src/index.ts

@@ -42,6 +42,6 @@ export { makeChat } from "@llm4ts/flow/Chat"
 export { makePlanStore } from "@llm4ts/flow/Persistence"
 export { defaultPlanInstructions, planFrom, writeBrief } from "@llm4ts/flow/Planner"
 export { defaultPlanPath, parsePlan, Plan } from "@llm4ts/flow/Plan"
-export { AssistantMessage, Info } from "@llm4ts/flow/FlowEvents"
+export { AssistantMessage, BriefReported, Info, RoundtableTurn } from "@llm4ts/flow/FlowEvents"
 export { FlowAborted, FlowLlmError } from "@llm4ts/flow/FlowError"
 export { loadPack } from "@llm4ts/flow/Pack"