@stigmer/react 3.1.4 → 3.1.5

package/session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"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"}

package/session/index.js

@@ -7,6 +7,7 @@ export { useSessionExecutions } from "./useSessionExecutions.js";
 export { useSessionConversation } from "./useSessionConversation.js";
 export { useSessionArtifacts, artifactKey } from "./useSessionArtifacts.js";
 export { useSessionWriteBacks } from "./useSessionWriteBacks.js";
+export { useWorkspaceReadRefs } from "./useWorkspaceReadRefs.js";
 export { useSessionFileChanges } from "./useSessionFileChanges.js";
 export { useSessionUsage } from "./useSessionUsage.js";
 export { useAgentRefFromSession } from "./useAgentRefFromSession.js";

package/session/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAMzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAMrE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAM5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAMjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,wDAAwD;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,oEAAoE;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,6EAA6E;AAC7E,uEAAuE;AACvE,4CAA4C;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,wEAAwE;AACxE,oEAAoE;AACpE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG/D,8EAA8E;AAC9E,yDAAyD;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAKpE,0EAA0E;AAC1E,qCAAqC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAM7C,oDAAoD;AACpD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAMzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAMrE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAM5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAMjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,wDAAwD;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,oEAAoE;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,6EAA6E;AAC7E,uEAAuE;AACvE,4CAA4C;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,wEAAwE;AACxE,oEAAoE;AACpE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG/D,8EAA8E;AAC9E,yDAAyD;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAKpE,0EAA0E;AAC1E,qCAAqC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAM7C,oDAAoD;AACpD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/session/useWorkspaceReadRefs.d.ts

@@ -0,0 +1,45 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import type { WorkspaceEntry } from "../workspace/useWorkspaceEntries.js";
+/**
+ * Pure derivation hook that projects the session's workspace write-backs onto
+ * its workspace entries as per-entry read refs.
+ *
+ * The agent's file changes land on a write-back branch (`stigmer/<id>`), not
+ * the branch the session was configured with — so read-side surfaces (file
+ * viewer, tree listing, name search) pointed at the configured branch would
+ * 404 on agent-created files and silently show stale content for modified
+ * ones. This hook returns the entries with `readRef` set to the latest
+ * write-back commit SHA, which those surfaces resolve in preference to
+ * `gitBranch`. A commit SHA (not the branch name) so reads are immutable-ref
+ * exact, immune to branch eventual-consistency.
+ *
+ * **Ref selection:** the latest write-back with a non-empty `commitSha` wins
+ * per workspace entry, across all executions in chronological order. FAILED
+ * write-back records carry no SHA and never regress the ref.
+ *
+ * **Entry matching** mirrors the runner's `WriteBackCoordinator.resolveEntry`:
+ * single-entry sessions provision with an empty `workspaceEntryName`, so when
+ * the session has exactly one git entry every write-back applies to it;
+ * multi-entry sessions match strictly by name.
+ *
+ * **Reference stability (DD-010):** the decorated array is memoized on the
+ * entries array and a value signature of the derived refs — streaming frames
+ * that don't change any write-back SHA return the identical array, so
+ * downstream listing/content effects never churn.
+ *
+ * @param executions - All executions for the session, in chronological order
+ *   (same input contract as {@link useSessionWriteBacks}).
+ * @param entries - The session's workspace entries. Returned as-is (same
+ *   reference) when no entry derives a ref.
+ *
+ * @example
+ * ```tsx
+ * const surfaceEntries = useWorkspaceReadRefs(flow.allExecutions, flow.workspace.entries);
+ * <WorkspaceSurface entries={surfaceEntries} ... />
+ * ```
+ *
+ * @see useSessionWriteBacks — the write-back list this projection derives from
+ * @see WorkspaceEntry.readRef — the field this hook populates
+ */
+export declare function useWorkspaceReadRefs(executions: readonly AgentExecution[], entries: readonly WorkspaceEntry[]): readonly WorkspaceEntry[];
+//# sourceMappingURL=useWorkspaceReadRefs.d.ts.map

package/session/useWorkspaceReadRefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkspaceReadRefs.d.ts","sourceRoot":"","sources":["../../src/session/useWorkspaceReadRefs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,SAAS,cAAc,EAAE,EACrC,OAAO,EAAE,SAAS,cAAc,EAAE,GACjC,SAAS,cAAc,EAAE,CA0B3B"}

package/session/useWorkspaceReadRefs.js

@@ -0,0 +1,104 @@
+"use client";
+import { useMemo } from "react";
+/**
+ * Pure derivation hook that projects the session's workspace write-backs onto
+ * its workspace entries as per-entry read refs.
+ *
+ * The agent's file changes land on a write-back branch (`stigmer/<id>`), not
+ * the branch the session was configured with — so read-side surfaces (file
+ * viewer, tree listing, name search) pointed at the configured branch would
+ * 404 on agent-created files and silently show stale content for modified
+ * ones. This hook returns the entries with `readRef` set to the latest
+ * write-back commit SHA, which those surfaces resolve in preference to
+ * `gitBranch`. A commit SHA (not the branch name) so reads are immutable-ref
+ * exact, immune to branch eventual-consistency.
+ *
+ * **Ref selection:** the latest write-back with a non-empty `commitSha` wins
+ * per workspace entry, across all executions in chronological order. FAILED
+ * write-back records carry no SHA and never regress the ref.
+ *
+ * **Entry matching** mirrors the runner's `WriteBackCoordinator.resolveEntry`:
+ * single-entry sessions provision with an empty `workspaceEntryName`, so when
+ * the session has exactly one git entry every write-back applies to it;
+ * multi-entry sessions match strictly by name.
+ *
+ * **Reference stability (DD-010):** the decorated array is memoized on the
+ * entries array and a value signature of the derived refs — streaming frames
+ * that don't change any write-back SHA return the identical array, so
+ * downstream listing/content effects never churn.
+ *
+ * @param executions - All executions for the session, in chronological order
+ *   (same input contract as {@link useSessionWriteBacks}).
+ * @param entries - The session's workspace entries. Returned as-is (same
+ *   reference) when no entry derives a ref.
+ *
+ * @example
+ * ```tsx
+ * const surfaceEntries = useWorkspaceReadRefs(flow.allExecutions, flow.workspace.entries);
+ * <WorkspaceSurface entries={surfaceEntries} ... />
+ * ```
+ *
+ * @see useSessionWriteBacks — the write-back list this projection derives from
+ * @see WorkspaceEntry.readRef — the field this hook populates
+ */
+export function useWorkspaceReadRefs(executions, entries) {
+    // Cheap per-render pass; memoizing on `executions` would defeat the point —
+    // its identity changes every streaming frame while the SHAs rarely do. The
+    // signature collapses those frames into a stable memo key.
+    const refByName = collectLatestShas(executions);
+    const signature = [...refByName]
+        .map(([name, sha]) => `${name}\u0001${sha}`)
+        .join("\u0000");
+    return useMemo(() => {
+        if (refByName.size === 0)
+            return entries;
+        const gitEntries = entries.filter((entry) => entry.type === "git");
+        let decorated = false;
+        const next = entries.map((entry) => {
+            const readRef = resolveReadRef(entry, gitEntries.length, refByName);
+            if (!readRef || readRef === entry.readRef)
+                return entry;
+            decorated = true;
+            return { ...entry, readRef };
+        });
+        return decorated ? next : entries;
+        // `signature` is the value-equality key for `refByName` (rebuilt each
+        // render); the map itself must stay out of the deps.
+    }, [entries, signature]);
+}
+/** Latest non-empty write-back commit SHA per workspace entry name. */
+function collectLatestShas(executions) {
+    const refByName = new Map();
+    for (const execution of executions) {
+        for (const wb of execution.status?.workspaceWriteBacks ?? []) {
+            if (wb.commitSha)
+                refByName.set(wb.workspaceEntryName, wb.commitSha);
+        }
+    }
+    return refByName;
+}
+/**
+ * The write-back SHA for one entry, honoring the runner's single-entry
+ * convention: with exactly one git entry, any write-back applies to it
+ * (single-entry sessions write back under an empty entry name).
+ */
+function resolveReadRef(entry, gitEntryCount, refByName) {
+    if (entry.type !== "git")
+        return undefined;
+    const byName = refByName.get(entry.name);
+    if (byName)
+        return byName;
+    if (gitEntryCount === 1) {
+        // Single-entry sessions write back under an empty entry name; a lone
+        // unambiguous name is equally safe to claim. Anything else (multiple
+        // names against one entry) is malformed status data — decorate nothing
+        // rather than guess.
+        const unnamed = refByName.get("");
+        if (unnamed)
+            return unnamed;
+        if (refByName.size === 1)
+            return refByName.values().next().value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=useWorkspaceReadRefs.js.map

package/session/useWorkspaceReadRefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkspaceReadRefs.js","sourceRoot":"","sources":["../../src/session/useWorkspaceReadRefs.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAIhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAqC,EACrC,OAAkC;IAElC,4EAA4E;IAC5E,2EAA2E;IAC3E,2DAA2D;IAC3D,MAAM,SAAS,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,SAAS,GAAG,EAAE,CAAC;SAC3C,IAAI,CAAC,QAAQ,CAAC,CAAC;IAElB,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QAEzC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;QACnE,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACpE,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,KAAK,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAC;YACxD,SAAS,GAAG,IAAI,CAAC;YACjB,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAClC,sEAAsE;QACtE,qDAAqD;IACvD,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,uEAAuE;AACvE,SAAS,iBAAiB,CACxB,UAAqC;IAErC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,MAAM,EAAE,mBAAmB,IAAI,EAAE,EAAE,CAAC;YAC7D,IAAI,EAAE,CAAC,SAAS;gBAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CACrB,KAAqB,EACrB,aAAqB,EACrB,SAAsC;IAEtC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,qEAAqE;QACrE,qEAAqE;QACrE,uEAAuE;QACvE,qBAAqB;QACrB,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;IACnE,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/src/execution/FileReviewContext.ts

@@ -1,6 +1,10 @@
 import { createContext, useContext } from "react";
-import type { FileChangeSet } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/filereview_pb";
+import type {
+  CapturedFileChange,
+  FileChangeSet,
+} from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/filereview_pb";
 import {
+  fileReviewRowChange,
   fileReviewRowState,
   type FileReviewRowState,
 } from "./file-review-status.js";
@@ -51,3 +55,25 @@ export function useFileReviewRowState(
   if (!fileChangeSetId) return null;
   return fileReviewRowState(changeSetsById.get(fileChangeSetId), rowPath);
 }
+
+/**
+ * The captured change a stamped tool row should render as its inline diff, or
+ * `null` to keep the row's own content view (unstamped row, unknown set, path
+ * miss, or a non-reviewable change — see {@link fileReviewRowChange} for the
+ * honest-degradation rules).
+ *
+ * The diff sibling of {@link useFileReviewRowState}: both read the same
+ * context entry through the same path matcher, so a row's badge and its diff
+ * always describe the same captured artifact.
+ *
+ * @param fileChangeSetId The row's `ToolCall.file_change_set_id` (may be "").
+ * @param rowPath The row's file path (the presenter's primary arg).
+ */
+export function useFileReviewRowChange(
+  fileChangeSetId: string,
+  rowPath: string | null,
+): CapturedFileChange | null {
+  const { changeSetsById } = useContext(FileReviewContext);
+  if (!fileChangeSetId) return null;
+  return fileReviewRowChange(changeSetsById.get(fileChangeSetId), rowPath);
+}

package/src/execution/MessageThread.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { lazy, memo, Suspense, useCallback, useMemo, useState } from "react";
+import { lazy, memo, Suspense, useCallback, useMemo, useState, type ComponentType } from "react";
 import { create } from "@bufbuild/protobuf";
 import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
 import type { AgentMessage, ToolCall } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
@@ -21,18 +21,19 @@ import type { WorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/
 import { displayFileChangeSets } from "@stigmer/sdk";
 import { cn } from "@stigmer/theme";
 import { isTerminalPhase } from "./execution-phases.js";
-import { MessageEntry } from "./MessageEntry.js";
+import { MessageEntry, type MessageEntryProps } from "./MessageEntry.js";
 import { ToolCallGroup } from "./ToolCallGroup.js";
 import { SubAgentSection } from "./SubAgentSection.js";
 import { ExecutionPhaseBadge } from "./ExecutionPhaseBadge.js";
-import { SetupProgress } from "./SetupProgress.js";
-import { ApprovalCard } from "./ApprovalCard.js";
+import { SetupProgress, type SetupProgressProps } from "./SetupProgress.js";
+import { ApprovalCard, type ApprovalCardProps } from "./ApprovalCard.js";
 import { FileReviewCard } from "./FileReviewCard.js";
 import { SummarizationCard } from "./SummarizationCard.js";
-import { PlanCompletionCard } from "./PlanCompletionCard.js";
-import { PlanArtifactCard } from "./PlanArtifactCard.js";
-import { PlanStreamingCard } from "./PlanStreamingCard.js";
-import { TodoCard } from "./TodoCard.js";
+import { PlanCompletionCard, type PlanCompletionCardProps } from "./PlanCompletionCard.js";
+import { PlanArtifactCard, type PlanArtifactCardProps } from "./PlanArtifactCard.js";
+import { PlanStreamingCard, type PlanStreamingCardProps } from "./PlanStreamingCard.js";
+import { TodoCard, type TodoCardProps } from "./TodoCard.js";
+import type { TodoRowProps } from "./TodoList.js";
 import { findPlanArtifact } from "../library/detect-plan-artifact.js";
 import { findStreamingPlan } from "../library/detect-streaming-plan.js";
 import type { SummarizationEventView } from "./useContextWindow.js";
@@ -63,6 +64,49 @@ const EMPTY_APPROVALS: readonly PendingApproval[] = [];
 const EMPTY_SUBMITTING_IDS: ReadonlySet<string> = new Set();
 const EMPTY_APPROVAL_ERRORS: ReadonlyMap<string, Error> = new Map();
 
+/**
+ * Component overrides for the chrome {@link MessageThread} renders — the
+ * adaptation surface for hosts whose design system needs different
+ * *structure*, not just different `--stgm-*` token values (stigmer#187).
+ *
+ * Each slot is keyed by the built-in component it replaces and receives
+ * exactly that component's exported props interface, so an override can
+ * always delegate to the built-in for the cases it does not customize
+ * (e.g. a `MessageEntry` slot that restyles `MESSAGE_HUMAN` bubbles and
+ * renders the default `MessageEntry` for everything else).
+ *
+ * Define slot components at module level (or memoize them). The thread's
+ * rows rely on `React.memo` + structural sharing to skip re-renders during
+ * streaming (DD-009/DD-010); a slot component recreated on every host
+ * render defeats that for its rows.
+ */
+export interface MessageThreadSlots {
+  /**
+   * All message bubbles — human, assistant, thinking, and system entries.
+   * Also wraps the failed-send bubble (the inline Retry chrome around it
+   * stays built-in).
+   */
+  readonly MessageEntry?: ComponentType<MessageEntryProps>;
+  /** The HITL tool-approval gate card. */
+  readonly ApprovalCard?: ComponentType<ApprovalCardProps>;
+  /** The collapsible in-thread to-dos card. */
+  readonly TodoCard?: ComponentType<TodoCardProps>;
+  /**
+   * One to-do row inside the built-in {@link TodoCard}'s list. Ignored
+   * when `TodoCard` is also overridden (the replacement receives it via
+   * {@link TodoCardProps.TodoRow} and may forward or ignore it).
+   */
+  readonly TodoRow?: ComponentType<TodoRowProps>;
+  /** Completed Plan turn that published a plan artifact. */
+  readonly PlanArtifactCard?: ComponentType<PlanArtifactCardProps>;
+  /** Completed Plan turn without an artifact — the bare Implement CTA. */
+  readonly PlanCompletionCard?: ComponentType<PlanCompletionCardProps>;
+  /** Live stand-in card while a Plan turn is writing its document. */
+  readonly PlanStreamingCard?: ComponentType<PlanStreamingCardProps>;
+  /** Pre-first-token setup / "Thinking…" indicator. */
+  readonly SetupProgress?: ComponentType<SetupProgressProps>;
+}
+
 /** Props for {@link MessageThread}. */
 export interface MessageThreadProps {
   /** Completed executions in chronological order. */
@@ -261,6 +305,12 @@ export interface MessageThreadProps {
    * existing consumers see no layout change.
    */
   readonly contentColumn?: ThreadContentColumn;
+  /**
+   * Component overrides for the thread's chrome — see
+   * {@link MessageThreadSlots}. Omitted slots render the built-ins;
+   * omitting the prop entirely changes nothing (DD-011).
+   */
+  readonly slots?: MessageThreadSlots;
 }
 
 /** Reading-column alignment for {@link MessageThread} content. */
@@ -1020,6 +1070,7 @@ export function MessageThread({
   planActionsDisabled,
   planBuildPending,
   contentColumn,
+  slots,
 }: MessageThreadProps) {
   useRenderTracer("MessageThread", { executions, activeStreamExecution });
 
@@ -1124,6 +1175,7 @@ export function MessageThread({
             onRetrySend={onRetrySend}
             onRetryExecution={onRetryExecution}
             onEditMessage={onEditMessage}
+            slots={slots}
           />
         </Suspense>
       </div>
@@ -1152,6 +1204,7 @@ export function MessageThread({
       onRetrySend={onRetrySend}
       onRetryExecution={onRetryExecution}
       onEditMessage={onEditMessage}
+      slots={slots}
     />
   );
 }
@@ -1186,6 +1239,7 @@ interface NonVirtualizedThreadProps {
   readonly onRetrySend?: () => void;
   readonly onRetryExecution?: (message: string) => void;
   readonly onEditMessage?: (text: string) => void;
+  readonly slots?: MessageThreadSlots;
 }
 
 function NonVirtualizedThread({
@@ -1209,6 +1263,7 @@ function NonVirtualizedThread({
   onRetrySend,
   onRetryExecution,
   onEditMessage,
+  slots,
 }: NonVirtualizedThreadProps) {
   const { scrollRef, sentinelRef, contentRef, isFollowing, jumpToLatest } =
     useAutoScroll();
@@ -1252,6 +1307,7 @@ function NonVirtualizedThread({
                   onRetrySend={onRetrySend}
                   onRetryExecution={onRetryExecution}
                   onEditMessage={onEditMessage}
+                  slots={slots}
                 />
               </ThreadItemWrapper>
             ))}
@@ -1307,6 +1363,7 @@ export interface ThreadItemRendererProps {
   readonly onRetrySend?: () => void;
   readonly onRetryExecution?: (message: string) => void;
   readonly onEditMessage?: (text: string) => void;
+  readonly slots?: MessageThreadSlots;
 }
 
 /**
@@ -1314,6 +1371,11 @@ export interface ThreadItemRendererProps {
  * the non-virtualized `items.map()` path and the virtualized
  * `Virtuoso.itemContent` callback.
  *
+ * Slot resolution happens here, per case, as `slots?.X ?? X` — no merged
+ * defaults object, no allocation, and the memoized row wrappers below
+ * (`ApprovalCardRow`, `FileReviewRecordRow`) keep their DD-010 callback
+ * stabilization around whichever component renders inside them.
+ *
  * Does not receive a `key` prop — the caller is responsible for
  * keying (either via `items.map` or `computeItemKey`).
  *
@@ -1334,16 +1396,22 @@ export function ThreadItemRenderer({
   onRetrySend,
   onRetryExecution,
   onEditMessage,
+  slots,
 }: ThreadItemRendererProps) {
   switch (item.kind) {
-    case "message":
+    case "message": {
+      const Entry = slots?.MessageEntry ?? MessageEntry;
       if (item.isFailed) {
         return (
-          <FailedUserMessage message={item.message} onRetry={onRetrySend} />
+          <FailedUserMessage
+            message={item.message}
+            onRetry={onRetrySend}
+            MessageEntryComponent={Entry}
+          />
         );
       }
       return (
-        <MessageEntry
+        <Entry
           message={item.message}
           className={item.isPending ? "opacity-70" : undefined}
           isPlanDocument={item.isPlanDocument}
@@ -1355,6 +1423,7 @@ export function ThreadItemRenderer({
           }
         />
       );
+    }
     case "tool-group":
       return (
         <ToolCallGroup
@@ -1392,30 +1461,37 @@ export function ThreadItemRenderer({
           onApprovalSubmit={onApprovalSubmit!}
           isSubmitting={submittingApprovalIds?.has(item.pendingApproval.toolCallId) ?? false}
           error={approvalErrors?.get(item.pendingApproval.toolCallId) ?? null}
+          ApprovalCardComponent={slots?.ApprovalCard ?? ApprovalCard}
         />
       );
     case "file-review-record":
       return <FileReviewRecordRow fileChangeSet={item.fileChangeSet} />;
-    case "setup-progress":
+    case "setup-progress": {
+      const Setup = slots?.SetupProgress ?? SetupProgress;
       return (
-        <SetupProgress
+        <Setup
           workspaceEntries={item.workspaceEntries}
           serverPhase={item.serverPhase}
           isAwaitingResponse={item.isAwaitingResponse}
         />
       );
+    }
     case "context-compacted":
       return <SummarizationCard event={item.event} />;
-    case "todos":
-      return <TodoCard todos={item.todos} className="mx-4" />;
-    case "plan-completion":
+    case "todos": {
+      const Todos = slots?.TodoCard ?? TodoCard;
+      return <Todos todos={item.todos} className="mx-4" TodoRow={slots?.TodoRow} />;
+    }
+    case "plan-completion": {
       // When the plan was published as an artifact, show the richer reviewable
       // card (preview / copy / download / implement). Otherwise fall back to the
       // bare Implement CTA (older executions, or a plan that failed to publish).
       // Only the latest plan receives the build action — a superseded plan's
       // card is review-only, so a stale plan can never be implemented from it.
+      const Artifact = slots?.PlanArtifactCard ?? PlanArtifactCard;
+      const Completion = slots?.PlanCompletionCard ?? PlanCompletionCard;
       return item.planArtifact && item.executionId ? (
-        <PlanArtifactCard
+        <Artifact
           executionId={item.executionId}
           artifact={item.planArtifact}
           title={item.planTitle}
@@ -1432,17 +1508,19 @@ export function ThreadItemRenderer({
           buildPending={planBuildPending}
         />
       ) : (
-        <PlanCompletionCard
+        <Completion
           onImplement={item.isLatestPlan ? onBuildFromPlan : undefined}
           disabled={planActionsDisabled}
         />
       );
-    case "plan-writing":
+    }
+    case "plan-writing": {
       // The live stand-in for a plan the active turn is writing. Emitted only
       // when onOpenPlan is wired (see buildThreadItems' collapseStreamingPlan
       // gate), so the action is always available in practice.
+      const Streaming = slots?.PlanStreamingCard ?? PlanStreamingCard;
       return (
-        <PlanStreamingCard
+        <Streaming
           title={item.planTitle}
           sizeBytes={item.planSize}
           onOpenPlan={
@@ -1450,6 +1528,7 @@ export function ThreadItemRenderer({
           }
         />
       );
+    }
   }
 }
 
@@ -1462,17 +1541,22 @@ export function ThreadItemRenderer({
  * (so the typed text is never lost) with an inline, actionable error beneath
  * it. The error copy is intentionally short — the full reason is surfaced by
  * the consumer's send-error banner; this is the in-thread "Retry" affordance.
+ *
+ * The bubble renders through the caller-resolved MessageEntry slot so an
+ * overridden bubble style also applies to failed sends.
  */
 function FailedUserMessage({
   message,
   onRetry,
+  MessageEntryComponent,
 }: {
   message: AgentMessage;
   onRetry?: () => void;
+  MessageEntryComponent: ComponentType<MessageEntryProps>;
 }) {
   return (
     <div className="flex flex-col gap-1">
-      <MessageEntry message={message} />
+      <MessageEntryComponent message={message} />
       <div
         role="alert"
         className="mx-4 flex items-center gap-2 text-xs text-destructive"
@@ -1587,6 +1671,9 @@ interface ApprovalCardRowProps {
   // This gate's last failed decision, or null — a stable ref from the
   // approvalErrors map, so the row re-renders only when its error appears/clears.
   readonly error?: Error | null;
+  // The (possibly slotted) card component. The row's callback stabilization
+  // wraps whichever card renders, so a slot override keeps the memo behavior.
+  readonly ApprovalCardComponent: ComponentType<ApprovalCardProps>;
 }
 
 const ApprovalCardRow = memo(function ApprovalCardRow({
@@ -1594,6 +1681,7 @@ const ApprovalCardRow = memo(function ApprovalCardRow({
   onApprovalSubmit,
   isSubmitting,
   error = null,
+  ApprovalCardComponent,
 }: ApprovalCardRowProps) {
   const handleSubmit = useCallback(
     (action: ApprovalAction, comment?: string) => {
@@ -1603,7 +1691,7 @@ const ApprovalCardRow = memo(function ApprovalCardRow({
   );
 
   return (
-    <ApprovalCard
+    <ApprovalCardComponent
       pendingApproval={pendingApproval}
       onSubmit={handleSubmit}
       isSubmitting={isSubmitting}

package/src/execution/TodoCard.tsx

@@ -1,12 +1,17 @@
 "use client";
 
-import { memo, useMemo } from "react";
+import { memo, useMemo, type ComponentType } from "react";
 import type { TodoItem } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/todo_pb";
 import { TodoStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import { cn } from "@stigmer/theme";
 import { useRenderTracer } from "../internal/dev/index.js";
 import { useAutoDisclosure } from "../internal/useAutoDisclosure.js";
-import { TodoList, findActiveTodo, todoCompletionSummary } from "./TodoList.js";
+import {
+  TodoList,
+  findActiveTodo,
+  todoCompletionSummary,
+  type TodoRowProps,
+} from "./TodoList.js";
 
 /** Props for {@link TodoCard}. */
 export interface TodoCardProps {
@@ -18,6 +23,12 @@ export interface TodoCardProps {
   readonly todos: { readonly [key: string]: TodoItem };
   /** Additional CSS class names for the root container. */
   readonly className?: string;
+  /**
+   * Replacement row component, forwarded to the inner {@link TodoList}.
+   * Lets a host restyle individual rows while keeping the card's
+   * collapse/progress chrome. Defaults to the built-in {@link TodoRow}.
+   */
+  readonly TodoRow?: ComponentType<TodoRowProps>;
 }
 
 /**
@@ -52,6 +63,7 @@ export interface TodoCardProps {
 export const TodoCard = memo(function TodoCard({
   todos,
   className,
+  TodoRow,
 }: TodoCardProps) {
   useRenderTracer("TodoCard", { todos });
 
@@ -121,7 +133,7 @@ export const TodoCard = memo(function TodoCard({
 
       {expanded && (
         <div className="border-t border-border-muted px-2.5 py-2">
-          <TodoList todos={todos} />
+          <TodoList todos={todos} TodoRow={TodoRow} />
         </div>
       )}
     </div>
@@ -139,7 +151,11 @@ export function todoCardPropsEqual(
   prev: Readonly<TodoCardProps>,
   next: Readonly<TodoCardProps>,
 ): boolean {
-  return prev.todos === next.todos && prev.className === next.className;
+  return (
+    prev.todos === next.todos &&
+    prev.className === next.className &&
+    prev.TodoRow === next.TodoRow
+  );
 }
 
 // ---------------------------------------------------------------------------