@desplega.ai/agent-swarm 2.4.3 → 2.4.5

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"],
@@ -2507,6 +2709,9 @@
               "type": "string"
             },
             "additionalProperties": {}
+          },
+          "parentTaskId": {
+            "type": "string"
           }
         },
         "required": ["name"],

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"],
 };
 
 /**
@@ -149,7 +161,10 @@ function isActionSentinel(value: unknown): boolean {
   if (!isPlainObject(value) || Object.keys(value).length !== 1) return false;
   if (typeof value.$row === "string") return true;
   if (value.$rowIndex === true) return true;
-  return typeof value.$form === "string";
+  if (typeof value.$form === "string") return true;
+  // Chain-derived scope published by a component that runs a task chain —
+  // see `action-params.ts`'s `$chain` sentinel.
+  return typeof value.$chain === "string";
 }
 
 function appendPath(path: string, part: string | number): string {
@@ -220,7 +235,10 @@ function validateSchema(
       ? { issues: [], stateRefs: [] }
       : {
           issues: [
-            issue(path, "$row, $rowIndex, and $form bindings are only allowed in action params"),
+            issue(
+              path,
+              "$row, $rowIndex, $form, and $chain bindings are only allowed in action params",
+            ),
           ],
           stateRefs: [],
         };

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/tasks/draft-text.ts

@@ -0,0 +1,15 @@
+import { getDbClient } from "../runtime";
+
+/**
+ * Append a block to a draft's task text (an uploaded voice note's transcript),
+ * as its own paragraph. Only a draft: nobody has read its text yet. One
+ * statement, so parallel uploads never drop each other's block. Returns
+ * whether the task was still a draft.
+ */
+export async function appendDraftTaskText(taskId: string, block: string): Promise<boolean> {
+  const result = await getDbClient().run(
+    "UPDATE agent_tasks SET task = task || ?, lastUpdatedAt = ? WHERE id = ? AND status = 'draft'",
+    [`\n\n${block}`, new Date().toISOString(), taskId],
+  );
+  return result.changes > 0;
+}

package/src/be/db/tasks/read.ts

@@ -18,6 +18,7 @@ import {
   parseModelTier,
   ReasoningEffortSchema,
   RoutingAffinitySchema,
+  TERMINAL_TASK_STATUSES,
 } from "../../../types";
 import { parseProviderMeta } from "../../../utils/provider-metadata";
 import { scrubSecrets } from "../../../utils/secret-scrubber";
@@ -1688,14 +1689,26 @@ export async function getLatestLeadTaskInThread(
 export async function getAgentWorkingOnContextKey(
   contextKey: string,
   source?: string,
+  /** ISO time: when set, only tasks still open or finished at or after it count. */
+  endedSince?: string,
 ): Promise<Agent | null> {
   const taskRow = await getDbClient().get<AgentTaskRow>(
     `SELECT agentId FROM agent_tasks
        WHERE contextKey = ?
        AND (? IS NULL OR source = ?)
+       AND (? IS NULL
+            OR status NOT IN (${TERMINAL_TASK_STATUSES.map(() => "?").join(", ")})
+            OR finishedAt >= ?)
        ORDER BY createdAt DESC, rowid DESC
        LIMIT 1`,
-    [contextKey, source ?? null, source ?? null],
+    [
+      contextKey,
+      source ?? null,
+      source ?? null,
+      endedSince ?? null,
+      ...TERMINAL_TASK_STATUSES,
+      endedSince ?? null,
+    ],
   );
 
   if (taskRow?.agentId) return getAgentById(taskRow.agentId);

package/src/be/db.ts

@@ -2676,7 +2676,11 @@ export async function createTaskExtended(
       }
 
       // Attribution
-      if (parent.requestedByUserId && !options.requestedByUserId) {
+      if (
+        parent.requestedByUserId &&
+        !options.requestedByUserId &&
+        options.inheritParentRequester !== false
+      ) {
         options.requestedByUserId = parent.requestedByUserId;
         requestedByUserIdInherited = true;
       }

package/src/be/memory/index-content.ts

@@ -37,6 +37,12 @@ export interface IndexMemoryContentParams {
    * out, the writer has no authority. Throws `MemoryKeyError`.
    */
   writer?: MemoryKeyWriter;
+  /**
+   * With `key`: replace this owner's existing document under the key (same
+   * scope and source) in the same transaction as the insert, instead of
+   * failing on the unique key index. A re-write may change the chunk count.
+   */
+  replaceExisting?: boolean;
 }
 
 export interface IndexMemoryContentResult {
@@ -48,6 +54,14 @@ export interface IndexMemoryContentResult {
   chunks: number;
 }
 
+/**
+ * Key shared by every chunk of one task's completion memory, so the chunks
+ * group as one document (access counting, chunk listing, search collapse).
+ */
+export function taskCompletionMemoryKey(taskId: string): string {
+  return `/task-completions/${taskId.toLowerCase().replace(/[^a-z0-9._-]/g, "-")}`;
+}
+
 export async function indexMemoryContent(
   params: IndexMemoryContentParams,
 ): Promise<IndexMemoryContentResult> {
@@ -111,23 +125,28 @@ export async function indexMemoryContent(
   }
 
   // Atomic batch insert: all chunks or none
-  const memories = await store.storeBatch(
-    contentChunks.map((chunk) => ({
-      agentId: agentId || null,
-      content: chunk.content,
-      name,
-      scope,
-      source,
-      sourcePath: sourcePath || null,
-      sourceTaskId: sourceTaskId || null,
-      chunkIndex: chunk.chunkIndex,
-      totalChunks: chunk.totalChunks,
-      tags: tags || [],
-      contextKey: params.contextKey ?? null,
-      intent: params.intent ?? "index memory content",
-      key: rowKey,
-    })),
-  );
+  const inputs = contentChunks.map((chunk) => ({
+    agentId: agentId || null,
+    content: chunk.content,
+    name,
+    scope,
+    source,
+    sourcePath: sourcePath || null,
+    sourceTaskId: sourceTaskId || null,
+    chunkIndex: chunk.chunkIndex,
+    totalChunks: chunk.totalChunks,
+    tags: tags || [],
+    contextKey: params.contextKey ?? null,
+    intent: params.intent ?? "index memory content",
+    key: rowKey,
+  }));
+  const memories =
+    params.replaceExisting && params.key
+      ? await store.replaceDocument(
+          { key: params.key, scope, agentId: agentId || null, source },
+          inputs,
+        )
+      : await store.storeBatch(inputs);
 
   // Resolve and store deterministic links (wikilinks, PR refs, agent-fs paths)
   if (agentId) {