@desplega.ai/agent-swarm 2.4.4 → 2.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "2.4.4",
+  "version": "2.5.0",
   "description": "agent-swarm.dev — an open-source operating system for AI work: a lead agent breaks goals into tasks, routes them to specialized workers such as Claude Code or Codex, runs each worker in an isolated container, and preserves shared memory, tools, schedules, and review gates so delegated work compounds across sessions.",
   "keywords": [
     "agent-swarm.dev",
@@ -179,8 +179,8 @@
     "@desplega/model-catalog": "workspace:*",
     "@desplega/model-routing": "workspace:*",
     "@faker-js/faker": "^10.4.0",
-    "@opencode/plugin": "2.1.1",
-    "@opencode/sdk": "2.1.1",
+    "@opencode/plugin": "2.1.3",
+    "@opencode/sdk": "2.1.3",
     "@oxlint/plugins": "1.78.0",
     "@types/bun": "latest",
     "dependency-cruiser": "^18.0.0",
@@ -198,26 +198,26 @@
     "bun": ">=1.3.12"
   },
   "dependencies": {
-    "@agentclientprotocol/sdk": "2.0.0",
+    "@agentclientprotocol/sdk": "2.0.1",
     "@ai-sdk/openai": "^3.0.41",
-    "@anthropic-ai/claude-agent-sdk": "0.3.304",
-    "@anthropic-ai/sdk": "^0.135.0",
+    "@anthropic-ai/claude-agent-sdk": "0.3.308",
+    "@anthropic-ai/sdk": "^1.1.0",
     "@asteasolutions/zod-to-openapi": "^8.0.0",
     "@aws-sdk/client-bedrock": "3.1048.0",
     "@chat-adapter/discord": "4.41.1",
     "@chat-adapter/slack": "4.41.1",
     "@chat-adapter/teams": "4.41.1",
     "@chat-adapter/telegram": "4.41.1",
-    "@cursor/sdk": "1.0.38",
+    "@cursor/sdk": "1.0.40",
     "@desplega.ai/agent-fs-just-bash": "0.18.5",
     "@desplega.ai/business-use": "^0.4.2",
-    "@earendil-works/pi-agent-core": "^1.3.0",
-    "@earendil-works/pi-ai": "^1.3.0",
-    "@earendil-works/pi-coding-agent": "^1.3.0",
+    "@earendil-works/pi-agent-core": "^1.4.0",
+    "@earendil-works/pi-ai": "^1.4.0",
+    "@earendil-works/pi-coding-agent": "^1.4.0",
     "@inkjs/ui": "^2.0.0",
     "@jitl/quickjs-singlefile-mjs-release-sync": "0.32.0",
     "@linear/sdk": "^77.0.0",
-    "@modelcontextprotocol/sdk": "1.31.0",
+    "@modelcontextprotocol/sdk": "1.32.1",
     "@openai/codex": "0.163.0",
     "@openfort/openfort-node": "^0.9.1",
     "@opentelemetry/api": "^1.9.1",

package/src/apps/catalog.generated.json

@@ -13,6 +13,7 @@
     "Markdown",
     "SearchInput",
     "Select",
+    "NumberInput",
     "Button",
     "Metric",
     "Alert",
@@ -31,9 +32,11 @@
     "Form",
     "Drawer",
     "DetailList",
+    "CardGrid",
     "Kanban",
     "Calendar",
     "ContributionGraph",
+    "Tree",
     "ElementRef",
     "ElementSlot"
   ],
@@ -48,7 +51,7 @@
   ],
   "components": {
     "Stack": {
-      "description": "THE primary layout primitive — a flex column (default) or row of its children. `gap`/`padding` use the shared spacing scale (none|xs|sm|md|lg|xl, default gap md); `align` is the cross axis, `justify` the main axis, `wrap` lets a row reflow. For rows, set `collapseBelow` (sm|md|lg) so the row stacks vertically on narrow viewports — filter bars should always set it. `motion` (rise|fade|none, default rise) is the entrance of the direct children on first paint: a 200ms fade plus a 4px rise, staggered 30ms; it never replays on data polls, nested Stacks inherit the parent's entrance, and reduced-motion viewers get a short fade. Use this as the page root and for every section; `Container` is the legacy 2-prop alias kept for older pages.",
+      "description": "THE primary layout primitive — a flex column (default) or row of its children. `gap`/`padding` use the shared spacing scale (none|xs|sm|md|lg|xl, default gap md); `align` is the cross axis, `justify` the main axis, `wrap` lets a row reflow. For rows, set `collapseBelow` (sm|md|lg) so the row stacks vertically on narrow viewports — filter bars should always set it. `motion` (rise|fade|none, default rise) is the entrance of the direct children on first paint: a 200ms fade plus a 4px rise, staggered 30ms; it never replays on data polls, nested Stacks inherit the parent's entrance, and reduced-motion viewers get a short fade. Use this as the page root and for every section; `Container` is the legacy 2-prop alias kept for older pages. `fill: true` makes this Stack grow to fill the remaining height of a `fill`-aware parent instead of sizing to content — chain it from the page root down to a scrolling leaf to build a viewport-height layout with no page scroll; a non-`fill` sibling keeps its natural height and the `fill` sibling absorbs whatever is left.",
       "slots": ["default"],
       "props": {
         "$schema": "http://json-schema.org/draft-07/schema#",
@@ -84,6 +87,9 @@
           "motion": {
             "type": "string",
             "enum": ["rise", "fade", "none"]
+          },
+          "fill": {
+            "type": "boolean"
           }
         },
         "additionalProperties": false
@@ -144,7 +150,7 @@
       }
     },
     "Split": {
-      "description": "Two-pane layout. POSITIONAL children: the FIRST child is the left pane, the SECOND is the right pane, and any further children stack inside the right pane. `ratio` sizes them (1-1|1-2|2-1|1-3|3-1, default 2-1 = wide left). Below `collapseBelow` (sm|md|lg, default md) the panes stack vertically; `reverse` only flips that stacked order (right pane first on narrow screens).",
+      "description": "Two-pane layout. POSITIONAL children: the FIRST child is the left pane, the SECOND is the right pane, and any further children stack inside the right pane. `ratio` sizes them (1-1|1-2|2-1|1-3|3-1, default 2-1 = wide left). Below `collapseBelow` (sm|md|lg, default md) the panes stack vertically; `reverse` only flips that stacked order (right pane first on narrow screens). `fill: true` makes this Split grow to fill the remaining height of a `fill`-aware parent (same contract as `Stack.fill`) — both panes stretch to the full row height, so nesting a `fill` Split inside one pane of another `fill` Split is the standard way to build a 3+ column viewport-height layout (ratio is only ever 2 panes).",
       "slots": ["default"],
       "props": {
         "$schema": "http://json-schema.org/draft-07/schema#",
@@ -168,6 +174,9 @@
           "padding": {
             "type": "string",
             "enum": ["none", "xs", "sm", "md", "lg", "xl"]
+          },
+          "fill": {
+            "type": "boolean"
           }
         },
         "additionalProperties": false
@@ -385,7 +394,7 @@
       }
     },
     "Select": {
-      "description": "Dropdown filter/picker. `options` are plain strings or `{ value, label?, icon?, hint? }` objects. Writes the chosen value into state at `/ui/<id>/value` (clearing writes `null`); bind it into a Table with `\"filters\": { \"<column>\": { \"$state\": \"/ui/<id>/value\" } }`. `clearable` (default true) shows a clear button. `searchable` adds a type-to-filter field (on by default past 8 options; `searchPlaceholder` sets its hint). `multiple` picks several: the value is a string array (empty = nothing picked), which a Table filter reads as \"cell is one of\".",
+      "description": "Dropdown filter/picker. `options` are plain strings or `{ value, label?, icon?, hint? }` objects. Writes the chosen value into state at `/ui/<id>/value` (clearing writes `null`); bind it into a Table with `\"filters\": { \"<column>\": { \"$state\": \"/ui/<id>/value\" } }`. `clearable` (default true) shows a clear button. `searchable` adds a type-to-filter field (on by default past 8 options; `searchPlaceholder` sets its hint). `multiple` picks several: the value is a string array (empty = nothing picked), which a Table filter reads as \"cell is one of\". `defaultValue` seeds `/ui/<id>/value` the first time it is read, before any interaction (a one-entry array with `multiple`).",
       "props": {
         "$schema": "http://json-schema.org/draft-07/schema#",
         "type": "object",
@@ -482,12 +491,41 @@
           },
           "searchPlaceholder": {
             "type": "string"
+          },
+          "defaultValue": {
+            "type": "string"
           }
         },
         "required": ["id", "options"],
         "additionalProperties": false
       }
     },
+    "NumberInput": {
+      "description": "Labelled numeric text field (decimal keyboard on touch devices, no debounce). Writes the parsed number into state at `/ui/<id>/value` on every change, or `null` when the field is empty; non-numeric text (a bare '-' mid-edit, letters) leaves the stored value untouched until it parses. `min`/`max` clamp the stored value, and the visible text snaps to that clamped value when the field loses focus.",
+      "props": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "placeholder": {
+            "type": "string"
+          },
+          "min": {
+            "type": "number"
+          },
+          "max": {
+            "type": "number"
+          }
+        },
+        "required": ["id"],
+        "additionalProperties": false
+      }
+    },
     "Button": {
       "description": "Interactive button. Wire to actions via `on.press`. `variant: \"destructive-outline\"` is the canonical red-outlined destructive look (standalone deletes should use it, not solid red). `disabled` accepts a constant or a bound boolean; `busyWith: \"<actionName>\"` swaps the label for a spinner (presses ignored) while that custom action is running, then shows a check plus `successLabel` for ~1.5s when it finishes ok. `icon` + `iconPosition` (start|end) add an icon from the curated set; `size` sm|default|lg. `shortcut` (one key, e.g. `\"n\"`) shows a keycap inside the button and presses it from anywhere on the page (not while typing in a field, not with Ctrl/Cmd/Alt). `hint` is a hover tooltip.",
       "props": {
@@ -1243,7 +1281,7 @@
       }
     },
     "Table": {
-      "description": "Data table. Bind `data`/`loading`/`error` to a named query (`/queries/<name>/...`). `rowActions` chains receive `{ \"$row\": \"<col>\" }` (or `{ \"$row\": \"\" }` for the whole row) and `{ \"$rowIndex\": true }`. Destructive row actions always confirm via a dialog; override the copy with `confirm: { title, description, confirmLabel }`. `search` (case-insensitive substring across every listed column) and `filters` (per-column equality, `null`/`\"\"` disables one; an array means \"one of\", which is what a multiple `Chips` writes, and an empty array disables it) narrow the polled rows client-side — bind them to a `SearchInput` / `Select` via `/ui/<id>/value`, or pin a constant (e.g. `\"filters\": { \"pinned\": true }`). Columns take `pinned: \"left\"|\"right\"` to survive horizontal scroll; `pagination` pages large row sets (auto past 200 rows); `density: \"compact\"` tightens row height. Column kinds: `status` (lifecycle values like pending/in_progress/completed/failed get the dashboard status icon, anything else a `tones` pill), `user` / `agent` (avatar + name), `relative` (smart time with the exact time on hover), `duration` (ms → 1m 23s), `progress` (bar, `max` default 100), `copy` (value + copy button), `switch` (runs the column's `onChange` chain with `$row` set to the new value; read-only without it), `link` (http(s) URL, opens in a new tab), `json` (compact single-line `JSON.stringify` preview, truncated). Columns also take `align`, `truncate: \"middle\"` (ids, paths), a header `icon` and `tooltip` (a row field shown on hover). `onRowClick` runs a chain with `$row` when a row is clicked — pair it with `app.navigate` + a Drawer and bind `selectedId` to the drawer param to highlight the open row. `rowId` names the id field (default `id`). Below 768px the table renders as a phone list (`mobile: \"list\"`, fields picked by `mobileFields: { title, subtitle?, meta?, status? }`); `mobile: \"scroll\"` keeps the grid. `emptyState: { icon?, title, body? }` replaces the empty message. Row actions take `icon` and `placement: \"menu\"` (collected into a More menu).",
+      "description": "Data table. Bind `data`/`loading`/`error` to a named query (`/queries/<name>/...`). `rowActions` chains receive `{ \"$row\": \"<col>\" }` (or `{ \"$row\": \"\" }` for the whole row) and `{ \"$rowIndex\": true }`. Destructive row actions always confirm via a dialog; override the copy with `confirm: { title, description, confirmLabel }`. `search` (case-insensitive substring across every listed column) and `filters` (per-column equality, `null`/`\"\"` disables one; an array means \"one of\", which is what a multiple `Chips` writes, and an empty array disables it) narrow the polled rows client-side — bind them to a `SearchInput` / `Select` via `/ui/<id>/value`, or pin a constant (e.g. `\"filters\": { \"pinned\": true }`). Columns take `pinned: \"left\"|\"right\"` to survive horizontal scroll; `pagination` pages large row sets (auto past 200 rows); `density: \"compact\"` tightens row height. Column kinds: `status` (lifecycle values like pending/in_progress/completed/failed get the dashboard status icon, anything else a `tones` pill), `user` / `agent` (avatar + name), `relative` (smart time with the exact time on hover), `duration` (ms → 1m 23s), `progress` (bar, `max` default 100), `copy` (value + copy button), `switch` (runs the column's `onChange` chain with `$row` set to the new value; read-only without it), `link` (http(s) URL, opens in a new tab), `json` (compact single-line `JSON.stringify` preview, truncated). Columns also take `align`, `truncate: \"middle\"` (ids, paths), a header `icon` and `tooltip` (a row field shown on hover), and `format` — a `{{field}}` template (e.g. `\"{{name}} · v{{version}}\"`) that combines several row fields into one cell and overrides `key`/`kind` rendering on desktop and in the phone list (placeholder names match `[w.]+`, no hyphens or spaces; sorting uses the composed text; `search` and `filters` still read the column's `key`). `onRowClick` runs a chain with `$row` when a row is clicked — pair it with `app.navigate` + a Drawer and bind `selectedId` to the drawer param to highlight the open row. `rowId` names the id field (default `id`). Below 768px the table renders as a phone list (`mobile: \"list\"`, fields picked by `mobileFields: { title, subtitle?, meta?, status? }`); `mobile: \"scroll\"` keeps the grid. `emptyState: { icon?, title, body? }` replaces the empty message. Row actions take `icon` and `placement: \"menu\"` (collected into a More menu).",
       "props": {
         "$schema": "http://json-schema.org/draft-07/schema#",
         "type": "object",
@@ -1317,6 +1355,9 @@
                   "type": "string",
                   "enum": ["left", "right"]
                 },
+                "format": {
+                  "type": "string"
+                },
                 "align": {
                   "type": "string",
                   "enum": ["start", "end"]
@@ -2037,6 +2078,140 @@
         "additionalProperties": false
       }
     },
+    "CardGrid": {
+      "description": "Responsive grid of data-bound cards, one per row — the visual counterpart to `Table` for record browsers (projects, documents, media). Bind `data`/`loading`/`error` to a named query like Table. `titleKey` picks the row field shown as the card title. `imageKey` picks a row field holding an absolute http(s) image URL and adds an image tile to every card (a non-URL value or a failed load shows a placeholder); omit it for text-only cards. `fields` render as an unlabeled `·`-joined meta line under the title; each field's `kind` is one of `text`, `string`, `enum`, `number`, `boolean`, `date`, `badge` (with `tones`) or `json`. `onClick` is an action chain (params may use `$row` / `$rowIndex`) dispatched on card click or Enter/Space, commonly `app.navigate` into a detail page. `columns` is the same responsive shorthand as `Grid.columns` (default `{ base: 1, sm: 2, md: 3 }`). Renders 200 cards at a time with a Show more button.",
+      "props": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {}
+            }
+          },
+          "titleKey": {
+            "type": "string"
+          },
+          "imageKey": {
+            "type": "string"
+          },
+          "fields": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "key": {
+                  "type": "string"
+                },
+                "kind": {
+                  "type": "string",
+                  "enum": ["text", "string", "number", "boolean", "date", "badge", "enum", "json"]
+                },
+                "tones": {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "string",
+                    "enum": [
+                      "neutral",
+                      "success",
+                      "active",
+                      "error",
+                      "info",
+                      "pending",
+                      "warning",
+                      "paused"
+                    ]
+                  }
+                }
+              },
+              "required": ["key"],
+              "additionalProperties": false
+            }
+          },
+          "columns": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 6
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "base": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 6
+                  },
+                  "sm": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 6
+                  },
+                  "md": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 6
+                  },
+                  "lg": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 6
+                  }
+                },
+                "additionalProperties": false
+              }
+            ]
+          },
+          "onClick": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "action": {
+                  "type": "string"
+                },
+                "params": {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {}
+                }
+              },
+              "required": ["action"],
+              "additionalProperties": false
+            }
+          },
+          "loading": {
+            "type": "boolean"
+          },
+          "error": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "emptyMessage": {
+            "type": "string"
+          }
+        },
+        "required": ["titleKey"],
+        "additionalProperties": false
+      }
+    },
     "Kanban": {
       "description": "Kanban board: one card per row, grouped into `columns` by the row's `columnField`. Bind `data`/`loading` to a named query. `titleField` is the card title; `cardFields` add label/value lines with the DetailList field kinds (badge tones, status, user, relative, copy, ...). Dragging a card to another column runs `onMove` with `$row` = the moved row, `columnField` already set to the new column — typically `[{ \"action\": \"app.mutate\", \"params\": { \"model\": \"<m>\", \"op\": \"update\", \"rowId\": { \"$row\": \"id\" }, \"values\": { \"<columnField>\": { \"$row\": \"<columnField>\" } } } }]`. Without `onMove` the board is read-only. `onCardClick` runs with `$row` (e.g. an `app.navigate` that opens a Drawer).",
       "props": {
@@ -2277,6 +2452,33 @@
         "additionalProperties": false
       }
     },
+    "Tree": {
+      "description": "Collapsible tree view of a json-render flat element map. Bind `nodes` to a doc-shaped value (`{ root: string | string[], elements: Record<key,{type,children?}> }`) — usually `{ \"$state\": \"/queries/<name>/data/0/<jsonColumn>\" }`. Each row shows `key — type`; clicking one writes the node key to `/ui/<id>/value`, and the row bound to that path renders selected. A malformed or absent `nodes` value renders an empty state. Rows scroll inside a fixed-height viewport — `maxHeight` overrides the default `480px` — or set `fill: true` to grow inside a `fill`-aware parent and scroll within whatever height that gives it instead (ignores `maxHeight`). Outlines are cut at 2,000 rows with a notice; branches deeper than 32 levels keep a disabled chevron.",
+      "props": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "nodes": {
+            "description": "json-render flat element map: { root: string | string[], elements: Record<key,{type,children?}> } — usually a {$state} binding to a query row's json column"
+          },
+          "label": {
+            "type": "string"
+          },
+          "maxHeight": {
+            "description": "CSS max-height for the scrollable row list, e.g. '480px' (default '480px')",
+            "type": "string"
+          },
+          "fill": {
+            "type": "boolean"
+          }
+        },
+        "required": ["id", "nodes"],
+        "additionalProperties": false
+      }
+    },
     "ElementRef": {
       "description": "Reference a reusable element from this app or an exported element from another app. Consumer children are inserted at the target's ElementSlot.",
       "slots": ["default"],

package/src/apps/page-validator.ts

@@ -14,6 +14,9 @@ interface JsonSchema {
   const?: unknown;
   items?: JsonSchema;
   anyOf?: JsonSchema[];
+  // A bare `z.unknown()` prop (e.g. Tree.nodes) serializes to a schema carrying
+  // only `description` and no `type` — a valid, type-less JSON Schema.
+  description?: string;
 }
 
 export interface AppCatalog {
@@ -42,7 +45,15 @@ export const ELEMENT_KEYS = new Set([
   "repeat",
   "watch",
 ]);
-const UI_STATE_COMPONENTS = new Set(["SearchInput", "Select", "Tabs", "Chips"]);
+// Components whose `id` claims a `/ui/<id>/...` state slot.
+const UI_STATE_COMPONENTS = new Set([
+  "SearchInput",
+  "Select",
+  "NumberInput",
+  "Tabs",
+  "Chips",
+  "Tree",
+]);
 
 /**
  * Props that hold a plain action chain (an array of `{ action, params }`),
@@ -54,6 +65,7 @@ const PROP_ACTION_CHAINS: Record<string, readonly string[]> = {
   Form: ["onSubmit"],
   Kanban: ["onMove", "onCardClick"],
   Calendar: ["onSelect"],
+  CardGrid: ["onClick"],
 };
 
 /**

package/src/assets/key.ts

@@ -83,6 +83,23 @@ export function defaultAssetKey(resource: AssetKeyResource, id: string): string
   return normalizeAssetKey(`shared/${resource}:${id}/`);
 }
 
+/** Bounds for an indexed, literal prefix lookup on canonical asset keys. */
+export function keyPrefixRange(prefix: string): { lo: string; hi: string } {
+  const lo = normalizeAssetKey(prefix);
+  return { lo, hi: `${lo.slice(0, -1)}${String.fromCharCode(lo.charCodeAt(lo.length - 1) + 1)}` };
+}
+
+export const SESSION_LEAF_KINDS = ["task", "thread", "schedule", "workflow"] as const;
+const sessionLeafPattern = new RegExp(`/(?:${SESSION_LEAF_KINDS.join("|")}):[^/]+/$`);
+
+/** Remove only a resource leaf, preserving user groups that contain a colon. */
+export function sessionGroupKey(key: string): string {
+  const normalized = normalizeAssetKey(key);
+  const namespace = parseAssetKey(normalized);
+  if (namespace.relativeSegments.length === 0) return normalized;
+  return normalized.replace(sessionLeafPattern, "/");
+}
+
 export function parseAssetKey(input: string): AssetNamespace {
   const key = normalizeAssetKey(input);
   const segments = key.slice(0, -1).split("/");

package/src/azure-devops/handlers.ts

@@ -394,7 +394,7 @@ export async function handlePullRequestCommented(
   );
 
   // Check if there's already an active task for this PR
-  const existingTask = await findTaskByVcs(repo, pr.pullRequestId);
+  const existingTask = await findTaskByVcs(repo, pr.pullRequestId, "azure-devops");
   const existingTaskNote = existingTask
     ? `\n\n_Note: There's an active task (${existingTask.id}) for this PR #${pr.pullRequestId}._`
     : "";

package/src/be/chunking.ts

@@ -42,20 +42,53 @@ export function chunkContent(text: string): MemoryChunk[] {
     }
   }
 
-  // Filter out trivially small chunks and build final result
-  const filtered = rawChunks.filter((c) => c.content.trim().length >= MIN_CHUNK_SIZE);
-  if (filtered.length === 0) {
-    return [{ content: trimmed, chunkIndex: 0, totalChunks: 1, headings: [] }];
-  }
-
-  return filtered.map((c, i) => ({
-    content: c.headings.length > 0 ? `${c.headings.join(" > ")}\n\n${c.content}` : c.content,
+  const packed = packSmallSections(rawChunks);
+  return packed.map((c, i) => ({
+    content: c.content,
     chunkIndex: i,
-    totalChunks: filtered.length,
+    totalChunks: packed.length,
     headings: c.headings,
   }));
 }
 
+function renderSection(section: Section): string {
+  return section.headings.length > 0
+    ? `${section.headings.join(" > ")}\n\n${section.content}`
+    : section.content;
+}
+
+/**
+ * Render each section with its heading path. A section below MIN_CHUNK_SIZE
+ * is too small to embed on its own, so consecutive small sections share a
+ * chunk up to MAX_CHUNK_SIZE. No section content is dropped.
+ */
+function packSmallSections(sections: Section[]): Section[] {
+  const out: Section[] = [];
+  let pending: { parts: string[]; length: number; headings: string[] } | null = null;
+  const flush = () => {
+    if (pending) out.push({ content: pending.parts.join("\n\n"), headings: pending.headings });
+    pending = null;
+  };
+
+  for (const section of sections) {
+    const rendered = renderSection(section);
+    if (section.content.trim().length >= MIN_CHUNK_SIZE) {
+      flush();
+      out.push({ content: rendered, headings: section.headings });
+      continue;
+    }
+    if (pending && pending.length + 2 + rendered.length > MAX_CHUNK_SIZE) flush();
+    if (pending) {
+      pending.parts.push(rendered);
+      pending.length += 2 + rendered.length;
+    } else {
+      pending = { parts: [rendered], length: rendered.length, headings: section.headings };
+    }
+  }
+  flush();
+  return out;
+}
+
 interface Section {
   content: string;
   headings: string[];

package/src/be/db/approvals.ts

@@ -144,3 +144,21 @@ export function scrubApprovalVotesJson(approvals: ApprovalVote[]): ScrubbedText
   if (!breaksJsonValidity(raw, scrubbed)) return scrubbed;
   return JSON.stringify(scrubObject(approvals)) as ScrubbedText;
 }
+
+/** Pending approval summaries for an already loaded session chain. */
+export async function getPendingApprovalsForTasks(taskIds: string[]): Promise<
+  {
+    id: string;
+    status: "pending";
+    sourceTaskId: string;
+    title: string;
+  }[]
+> {
+  if (!taskIds.length) return [];
+  return getDbClient().query(
+    `SELECT id, status, sourceTaskId, title FROM approval_requests
+     WHERE sourceTaskId IN (${taskIds.map(() => "?").join(",")}) AND status = 'pending'
+     ORDER BY createdAt, id`,
+    taskIds,
+  );
+}