@stigmer/react 3.1.3 → 3.1.5

package/internal/mermaid-theme-css.js

@@ -0,0 +1,179 @@
+/**
+ * Token-driven `themeCSS` for Mermaid diagram interiors.
+ *
+ * Mermaid's built-in `default`/`dark` themes color a diagram's SVG interior
+ * with a fixed palette that ignores the host's `--stgm-*` preset (Corporate,
+ * Fintech, ...). The obvious fix — feeding resolved tokens into Mermaid's
+ * `themeVariables` — is blocked: our tokens are authored in `oklch()`, and
+ * Mermaid's color engine (`khroma`) parses only hex/rgb/hsl/keyword, so it
+ * throws or NaNs on `oklch(...)`. (Mermaid also gates every `themeVariables`
+ * value through the allowlist `^[\d "#%(),.;A-Za-z]+$`, which excludes `-` and
+ * would blank any `var(--...)`.)
+ *
+ * Instead we hand Mermaid this CSS via `initialize({ themeCSS })`. Mermaid
+ * injects it into the diagram's own `<style>` block, scoped under the render
+ * id (`#stgm-mermaid-N`), *after* the theme palette it computes. Because every
+ * selector in that block is id-prefixed, our rules and the palette's rules sit
+ * at equal specificity, so ours win by source order — and `!important` makes
+ * that bulletproof against the few palette rules that are themselves important
+ * or inlined. Crucially, `themeCSS` never passes through khroma, so the
+ * `oklch()`-backed `var(--stgm-*)` references flow straight to the browser,
+ * which resolves them against the `.stgm` scope the SVG lives in. That is why
+ * interiors track the active preset *and* color mode live, with no JS color
+ * reading and no re-render on theme change.
+ *
+ * `initialize({ theme })` still selects the built-in `default`/`dark` theme as
+ * the base, so any element or diagram type we do not target here degrades to
+ * Mermaid's stock palette — never a blank or mis-colored diagram.
+ *
+ * Palette intent (subtle surfaces + brand accents — legibility over brand
+ * saturation): node/actor bodies sit on a muted surface with quiet
+ * token-colored borders and edges; labels use the standard foreground; the
+ * brand `--stgm-primary` is reserved for structural headers (subgraph/cluster
+ * titles, sequence loop/section titles, the sequence-number badge).
+ *
+ * Coverage is the two families agents emit overwhelmingly — flowchart and
+ * sequence — plus the shared marker/edge-label chrome. Both label render paths
+ * are handled: SVG `text`/`tspan` (via `fill`) and HTML labels inside
+ * `foreignObject` (via `color`).
+ */
+export const MERMAID_THEME_CSS = `
+  /* Shared: edge arrowheads / markers */
+  .marker {
+    fill: var(--stgm-border) !important;
+    stroke: var(--stgm-border) !important;
+  }
+  .marker.cross {
+    stroke: var(--stgm-border) !important;
+  }
+
+  /* Flowchart: node bodies */
+  .node rect,
+  .node circle,
+  .node ellipse,
+  .node polygon,
+  .node path {
+    fill: var(--stgm-muted) !important;
+    stroke: var(--stgm-border) !important;
+  }
+  .node .neo-node {
+    stroke: var(--stgm-border) !important;
+  }
+  .node .katex path {
+    fill: var(--stgm-foreground) !important;
+    stroke: var(--stgm-foreground) !important;
+  }
+
+  /* Flowchart: node labels (SVG text and HTML spans) */
+  .label {
+    color: var(--stgm-foreground) !important;
+  }
+  .label text,
+  .label span {
+    fill: var(--stgm-foreground) !important;
+    color: var(--stgm-foreground) !important;
+  }
+
+  /* Flowchart: edges */
+  .edgePath .path,
+  .flowchart-link {
+    stroke: var(--stgm-border) !important;
+  }
+  .arrowheadPath,
+  .root .anchor path {
+    fill: var(--stgm-border) !important;
+    stroke: var(--stgm-border) !important;
+  }
+
+  /* Flowchart: edge labels sit on the diagram surface for legibility */
+  .edgeLabel,
+  .edgeLabel p,
+  .edgeLabel rect,
+  .labelBkg {
+    background-color: var(--stgm-card) !important;
+    fill: var(--stgm-card) !important;
+  }
+
+  /* Flowchart: subgraph clusters — muted surface, brand-accent title */
+  .cluster rect {
+    fill: var(--stgm-muted-subtle) !important;
+    stroke: var(--stgm-border) !important;
+  }
+  .cluster-label text,
+  .cluster text {
+    fill: var(--stgm-primary) !important;
+  }
+  .cluster-label span,
+  .cluster span {
+    color: var(--stgm-primary) !important;
+  }
+
+  /* Sequence: actors and lifelines */
+  .actor {
+    fill: var(--stgm-muted) !important;
+    stroke: var(--stgm-border) !important;
+  }
+  text.actor > tspan {
+    fill: var(--stgm-foreground) !important;
+  }
+  .actor-line {
+    stroke: var(--stgm-border) !important;
+  }
+
+  /* Sequence: messages */
+  .messageLine0,
+  .messageLine1 {
+    stroke: var(--stgm-border) !important;
+  }
+  [id$="-arrowhead"] path,
+  [id$="-crosshead"] path {
+    fill: var(--stgm-border) !important;
+    stroke: var(--stgm-border) !important;
+  }
+  .messageText {
+    fill: var(--stgm-foreground) !important;
+  }
+
+  /* Sequence: number badge — brand accent with its paired foreground */
+  [id$="-sequencenumber"] {
+    fill: var(--stgm-primary) !important;
+  }
+  .sequenceNumber {
+    fill: var(--stgm-primary-foreground) !important;
+  }
+
+  /* Sequence: alt/opt/loop boxes and labels */
+  .labelBox {
+    fill: var(--stgm-muted-subtle) !important;
+    stroke: var(--stgm-border) !important;
+  }
+  .labelText,
+  .labelText > tspan {
+    fill: var(--stgm-foreground) !important;
+  }
+  .loopText,
+  .loopText > tspan,
+  .sectionTitle,
+  .sectionTitle > tspan {
+    fill: var(--stgm-primary) !important;
+  }
+  .loopLine {
+    stroke: var(--stgm-border) !important;
+  }
+
+  /* Sequence: notes and activations */
+  .note {
+    fill: var(--stgm-muted-subtle) !important;
+    stroke: var(--stgm-border) !important;
+  }
+  .noteText,
+  .noteText > tspan {
+    fill: var(--stgm-foreground) !important;
+  }
+  .activation0,
+  .activation1 {
+    fill: var(--stgm-muted) !important;
+    stroke: var(--stgm-border) !important;
+  }
+`;
+//# sourceMappingURL=mermaid-theme-css.js.map

package/internal/mermaid-theme-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-theme-css.js","sourceRoot":"","sources":["../../src/internal/mermaid-theme-css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0IhC,CAAC"}

package/internal/slug.d.ts

@@ -7,17 +7,21 @@
  *
  * Rules (applied in order):
  * 1. Convert to lowercase
- * 2. Replace spaces with hyphens
+ * 2. Replace spaces and dots (namespace separators) with hyphens
  * 3. Strip everything except `a-z`, `0-9`, and `-`
  * 4. Collapse consecutive hyphens into one
  * 5. Trim leading / trailing hyphens
  *
+ * Dots are treated as namespace separators (e.g. `platform.sara` → `platform-sara`),
+ * matching the backend generators, so namespace-scoped names stay readable.
+ *
  * @example
  * ```ts
- * generateSlug("My Cool Agent")  // "my-cool-agent"
- * generateSlug("Acme Corp!")     // "acme-corp"
- * generateSlug("  --hello-- ")   // "hello"
- * generateSlug("")               // ""
+ * generateSlug("My Cool Agent")             // "my-cool-agent"
+ * generateSlug("Acme Corp!")                // "acme-corp"
+ * generateSlug("  --hello-- ")              // "hello"
+ * generateSlug("platform.planton-arch")     // "platform-planton-arch"
+ * generateSlug("")                          // ""
  * ```
  */
 export declare function generateSlug(name: string): string;

package/internal/slug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/internal/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/internal/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/internal/slug.js

@@ -7,23 +7,27 @@
  *
  * Rules (applied in order):
  * 1. Convert to lowercase
- * 2. Replace spaces with hyphens
+ * 2. Replace spaces and dots (namespace separators) with hyphens
  * 3. Strip everything except `a-z`, `0-9`, and `-`
  * 4. Collapse consecutive hyphens into one
  * 5. Trim leading / trailing hyphens
  *
+ * Dots are treated as namespace separators (e.g. `platform.sara` → `platform-sara`),
+ * matching the backend generators, so namespace-scoped names stay readable.
+ *
  * @example
  * ```ts
- * generateSlug("My Cool Agent")  // "my-cool-agent"
- * generateSlug("Acme Corp!")     // "acme-corp"
- * generateSlug("  --hello-- ")   // "hello"
- * generateSlug("")               // ""
+ * generateSlug("My Cool Agent")             // "my-cool-agent"
+ * generateSlug("Acme Corp!")                // "acme-corp"
+ * generateSlug("  --hello-- ")              // "hello"
+ * generateSlug("platform.planton-arch")     // "platform-planton-arch"
+ * generateSlug("")                          // ""
  * ```
  */
 export function generateSlug(name) {
     return name
         .toLowerCase()
-        .replace(/ /g, "-")
+        .replace(/[ .]/g, "-")
         .replace(/[^a-z0-9-]/g, "")
         .replace(/-{2,}/g, "-")
         .replace(/^-+|-+$/g, "");

package/internal/slug.js.map

@@ -1 +1 @@
-{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/internal/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/internal/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/react",
-  "version": "3.1.3",
+  "version": "3.1.5",
   "description": "React provider and client hook for the Stigmer platform SDK",
   "license": "Apache-2.0",
   "type": "module",
@@ -37,7 +37,7 @@
   "dependencies": {
     "@bufbuild/protovalidate": "^1.1.1",
     "@dagrejs/dagre": "^1.1.4",
-    "@stigmer/theme": "3.1.3",
+    "@stigmer/theme": "3.1.5",
     "diff": "^8.0.3",
     "fflate": "^0.8.2",
     "hast-util-to-jsx-runtime": "^2.3.6",
@@ -60,12 +60,13 @@
     "@codemirror/state": "^6.0.0",
     "@codemirror/view": "^6.0.0",
     "@lezer/highlight": "^1.0.0",
-    "@stigmer/protos": "3.1.3",
-    "@stigmer/sdk": "3.1.3",
+    "@stigmer/protos": "3.1.5",
+    "@stigmer/sdk": "3.1.5",
     "@tanstack/react-table": "^8.20.0",
     "@xyflow/react": "^12.0.0",
     "elkjs": "^0.9.0",
     "lucide-react": ">=0.400.0",
+    "mermaid": "^11.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "react-virtuoso": "^4.0.0",

package/session/SessionViewer.d.ts

@@ -4,6 +4,7 @@ import type { WorkspaceFileLister } from "../workspace/WorkspaceFileLister.js";
 import type { WorkspaceFileReader } from "../workspace/WorkspaceFileReader.js";
 import type { WorkspaceContentSearcher } from "../workspace/WorkspaceContentSearcher.js";
 import type { ApplyResourceResult } from "../library/useApplyResource.js";
+import { type MessageThreadSlots } from "../execution/MessageThread.js";
 import type { RuntimeEnvProvider } from "./runtime-env.js";
 import type { SessionAudience } from "./audience.js";
 /** Props for {@link SessionViewer}. */
@@ -98,6 +99,15 @@ export interface SessionViewerProps {
     readonly accessSlot?: ReactNode;
     /** Called after a resource is applied from the Artifacts tab. */
     readonly onApplied?: (result: ApplyResourceResult) => void;
+    /**
+     * Component overrides for the conversation thread's chrome (message
+     * bubbles, approval card, to-dos card, plan cards, thinking indicator) —
+     * forwarded to the inner {@link MessageThread}. See
+     * {@link MessageThreadSlots}. Define the object and its components at
+     * module level (or memoize) so thread rows keep their streaming
+     * re-render guarantees.
+     */
+    readonly threadSlots?: MessageThreadSlots;
     /** Additional CSS classes for the root container. */
     readonly className?: string;
 }
@@ -143,5 +153,5 @@ export interface SessionViewerProps {
  * />
  * ```
  */
-export declare function SessionViewer({ sessionId, org, gitHubConnection, enableGitHub, enableLocal, onBrowseLocalFolder, workspaceFileLister, workspaceFileReader, workspaceContentSearcher, getRuntimeEnv, audience, headerActions, accessSlot, onApplied, className, }: SessionViewerProps): import("react/jsx-runtime").JSX.Element;
+export declare function SessionViewer({ sessionId, org, gitHubConnection, enableGitHub, enableLocal, onBrowseLocalFolder, workspaceFileLister, workspaceFileReader, workspaceContentSearcher, getRuntimeEnv, audience, headerActions, accessSlot, onApplied, threadSlots, className, }: SessionViewerProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=SessionViewer.d.ts.map

package/session/SessionViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionViewer.d.ts","sourceRoot":"","sources":["../../src/session/SessionViewer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA2D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAQhG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAOzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAoC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA2ErD,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IACtD;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACnD;;;;;;OAMG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IAC7D;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAC5C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAChC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC3D,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,GAAG,EACH,gBAAgB,EAChB,YAAmB,EACnB,WAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,QAAuB,EACvB,aAAa,EACb,UAAU,EACV,SAAS,EACT,SAAS,GACV,EAAE,kBAAkB,2CAkSpB"}
+{"version":3,"file":"SessionViewer.d.ts","sourceRoot":"","sources":["../../src/session/SessionViewer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA2D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAQhG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAOzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAM1E,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAqCvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA2ErD,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IACtD;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACnD;;;;;;OAMG;IACH,QAAQ,CAAC,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IAC7D;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAC5C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAChC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC3D;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,GAAG,EACH,gBAAgB,EAChB,YAAmB,EACnB,WAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,QAAuB,EACvB,aAAa,EACb,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,GACV,EAAE,kBAAkB,2CA2TpB"}

package/session/SessionViewer.js

@@ -28,11 +28,14 @@ import { usePlanDraft, planDraftKey } from "./usePlanDraft.js";
 import { PlanEditor } from "./PlanEditor.js";
 import { PlanStreamingDocument } from "./PlanStreamingDocument.js";
 import { PLAN_DOCUMENT_ENTRY_ID, PLAN_DOCUMENT_PATH } from "./plan-document.js";
+import { ARTIFACT_DOCUMENT_ENTRY_ID } from "./artifact-document.js";
+import { ArtifactDocument } from "../execution/ArtifactDocument.js";
 import { useSessionRailViews } from "./useSessionRailViews.js";
 import { useSessionPanel } from "./useSessionPanel.js";
 import { SessionPanelChip } from "./SessionPanelChip.js";
 import { useSessionWriteBacks } from "./useSessionWriteBacks.js";
-import { useSessionArtifacts } from "./useSessionArtifacts.js";
+import { useWorkspaceReadRefs } from "./useWorkspaceReadRefs.js";
+import { useSessionArtifacts, artifactKey, } from "./useSessionArtifacts.js";
 import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 /**
  * Where the approved plan mounts in the implement execution's workspace —
@@ -126,7 +129,7 @@ const CONVERSATION_COLUMN_CLASS = "mx-auto w-full max-w-3xl";
  * />
  * ```
  */
-export function SessionViewer({ sessionId, org, gitHubConnection, enableGitHub = true, enableLocal = false, onBrowseLocalFolder, workspaceFileLister, workspaceFileReader, workspaceContentSearcher, getRuntimeEnv, audience = "integrator", headerActions, accessSlot, onApplied, className, }) {
+export function SessionViewer({ sessionId, org, gitHubConnection, enableGitHub = true, enableLocal = false, onBrowseLocalFolder, workspaceFileLister, workspaceFileReader, workspaceContentSearcher, getRuntimeEnv, audience = "integrator", headerActions, accessSlot, onApplied, threadSlots, className, }) {
     const flow = useSessionPageFlow({ sessionId, org, getRuntimeEnv });
     const { conv } = flow;
     const isEndUser = audience === "endUser";
@@ -271,6 +274,20 @@ export function SessionViewer({ sessionId, org, gitHubConnection, enableGitHub =
             : executionId);
         panel.openPlanDocument();
     }, [sessionPlan, panel.openPlanDocument]);
+    // "Open artifact" (an Artifacts-facet row) → an editor-pane document tab.
+    // Writing the editors store re-renders only the panel subtree (which
+    // subscribes), never this streaming column. Plan artifacts are routed to the
+    // plan tab upstream (in ArtifactsTab), so they never reach here.
+    const handleOpenArtifact = useCallback((entry) => {
+        panel.openArtifact(entry.artifact);
+    }, [panel.openArtifact]);
+    // Double-click an artifact row → pin its tab (the leading single click already
+    // opened the preview via `handleOpenArtifact`). Mirrors the file tree's
+    // preview/pin split; plan artifacts are routed to the plan tab upstream (in
+    // ArtifactsTab) and never reach here.
+    const handleActivateArtifact = useCallback((entry) => {
+        panel.pinArtifact(entry.artifact);
+    }, [panel.pinArtifact]);
     // Open a transcript tool-call file path in the panel's read-only editor.
     // Resolves the (possibly absolute / subdir-prefixed) path to a
     // repo/root-relative selection the editor can fetch; on a definite hit it
@@ -294,9 +311,9 @@ export function SessionViewer({ sessionId, org, gitHubConnection, enableGitHub =
     if (!conv.session && !conv.isLoading) {
         return _jsx(SessionStarting, {});
     }
-    return (_jsxs("div", { className: cn("relative flex h-full w-full flex-col", className), children: [_jsxs("div", { className: "absolute top-2 right-6 z-10 flex items-center gap-2", children: [headerActions, _jsx(SessionPanelChip, { isOpen: panel.isOpen, onToggle: panel.isOpen ? panel.closePanel : panel.openPanel, badgeCount: writeBackCount + artifactCount })] }), _jsx(ThreadSelectionContext.Provider, { value: selectionStore, children: _jsx(ResizableSplit, { resizablePane: "primary", collapsedPane: panel.isOpen ? "none" : "secondary", defaultSize: 420, minSize: 320, maxSize: 640, storageKey: "stgm-session-chat-width", responsiveCollapse: panel.isOpen ? "primary" : "none", ariaLabel: "Resize chat panel", className: "min-h-0 flex-1", primary: _jsx(ConversationColumn, { flow: flow, modelId: modelId, setModelId: setModelId, interactionMode: interactionMode, setInteractionMode: setInteractionMode, composerRef: composerRef, org: org, gitHubConnection: gitHubConnection, enableGitHub: enableGitHub, enableLocal: enableLocal, onBrowseLocalFolder: onBrowseLocalFolder, onBuildFromPlan: handleBuildFromPlan, onOpenPlan: handleOpenPlan, isBuildingFromPlan: isBuildingFromPlan, planAttachFailed: planAttachFailed, onDismissPlanAttachFailed: () => setPlanAttachFailed(false), onFilePathClick: handleTranscriptFilePathClick, isEndUser: isEndUser }), secondary: panel.isOpen ? (_jsx(SessionPanelRegion, { flow: flow, org: org, panel: panel, accessSlot: accessSlot, onApplied: onApplied, onImplementPlan: handleBuildFromPlan, implementPlanDisabled: !conv.canSendFollowUp || isBuildingFromPlan, sessionPlan: sessionPlan, streamingPlan: streamingPlan, planDraft: planDraft, openPlanExecutionId: openPlanExecutionId, onOpenPlan: handleOpenPlan, enableLocal: enableLocal, onBrowseLocalFolder: onBrowseLocalFolder, workspaceFileLister: workspaceFileLister, workspaceFileReader: workspaceFileReader, workspaceContentSearcher: workspaceContentSearcher, isEndUser: isEndUser })) : null }) })] }));
+    return (_jsxs("div", { className: cn("relative flex h-full w-full flex-col", className), children: [_jsxs("div", { className: "absolute top-2 right-6 z-10 flex items-center gap-2", children: [headerActions, _jsx(SessionPanelChip, { isOpen: panel.isOpen, onToggle: panel.isOpen ? panel.closePanel : panel.openPanel, badgeCount: writeBackCount + artifactCount })] }), _jsx(ThreadSelectionContext.Provider, { value: selectionStore, children: _jsx(ResizableSplit, { resizablePane: "primary", collapsedPane: panel.isOpen ? "none" : "secondary", defaultSize: 420, minSize: 320, maxSize: 640, storageKey: "stgm-session-chat-width", responsiveCollapse: panel.isOpen ? "primary" : "none", ariaLabel: "Resize chat panel", className: "min-h-0 flex-1", primary: _jsx(ConversationColumn, { flow: flow, modelId: modelId, setModelId: setModelId, interactionMode: interactionMode, setInteractionMode: setInteractionMode, composerRef: composerRef, org: org, gitHubConnection: gitHubConnection, enableGitHub: enableGitHub, enableLocal: enableLocal, onBrowseLocalFolder: onBrowseLocalFolder, onBuildFromPlan: handleBuildFromPlan, onOpenPlan: handleOpenPlan, isBuildingFromPlan: isBuildingFromPlan, planAttachFailed: planAttachFailed, onDismissPlanAttachFailed: () => setPlanAttachFailed(false), onFilePathClick: handleTranscriptFilePathClick, isEndUser: isEndUser, threadSlots: threadSlots }), secondary: panel.isOpen ? (_jsx(SessionPanelRegion, { flow: flow, org: org, panel: panel, accessSlot: accessSlot, onApplied: onApplied, onImplementPlan: handleBuildFromPlan, implementPlanDisabled: !conv.canSendFollowUp || isBuildingFromPlan, sessionPlan: sessionPlan, streamingPlan: streamingPlan, planDraft: planDraft, openPlanExecutionId: openPlanExecutionId, onOpenPlan: handleOpenPlan, onOpenArtifact: handleOpenArtifact, onActivateArtifact: handleActivateArtifact, enableLocal: enableLocal, onBrowseLocalFolder: onBrowseLocalFolder, workspaceFileLister: workspaceFileLister, workspaceFileReader: workspaceFileReader, workspaceContentSearcher: workspaceContentSearcher, isEndUser: isEndUser })) : null }) })] }));
 }
-const ConversationColumn = memo(function ConversationColumn({ flow, modelId, setModelId, interactionMode, setInteractionMode, composerRef, org, gitHubConnection, enableGitHub, enableLocal, onBrowseLocalFolder, onBuildFromPlan, onOpenPlan, isBuildingFromPlan, planAttachFailed, onDismissPlanAttachFailed, onFilePathClick, isEndUser, }) {
+const ConversationColumn = memo(function ConversationColumn({ flow, modelId, setModelId, interactionMode, setInteractionMode, composerRef, org, gitHubConnection, enableGitHub, enableLocal, onBrowseLocalFolder, onBuildFromPlan, onOpenPlan, isBuildingFromPlan, planAttachFailed, onDismissPlanAttachFailed, onFilePathClick, isEndUser, threadSlots, }) {
     const { conv } = flow;
     // Approval failures are NOT folded into this banner: they now surface in-card,
     // beside the exact gate that failed (see MessageThread's approvalErrors →
@@ -314,16 +331,37 @@ const ConversationColumn = memo(function ConversationColumn({ flow, modelId, set
     const handleStop = useCallback(() => {
         void conv.stop();
     }, [conv.stop]);
-    // Edit-and-resubmit: stop the in-flight turn and pre-fill the composer with
-    // the original text. The append-only execution log can't be rewritten, so
-    // the user reviews the prefilled message and resubmits it as a NEW execution
-    // through the normal Send pipeline. The cancelled turn stays in history with
-    // its phase badge — an honest record rather than a silent edit.
+    // Edit-and-resubmit: stop the in-flight turn, pre-fill the composer with
+    // the original text, and remember which execution is being edited. The
+    // append-only execution log is never rewritten — submitting while editing
+    // creates a NEW execution that carries `supersedesExecutionId`, and the
+    // conversation read model hides the superseded turn so the edited message
+    // replaces the original in place (Cursor-style, stigmer/stigmer#181).
+    //
+    // The editing state is explicit (banner + cancel in the composer) so the
+    // supersede link only attaches when the user actually resubmits the edit.
+    // Cancelling drops the link — a subsequent unrelated message appends
+    // normally without hiding any history.
+    const [editingExecutionId, setEditingExecutionId] = useState(null);
+    const activeExecutionId = conv.activeStreamExecution?.metadata?.id ?? null;
     const handleEditMessage = useCallback((text) => {
         void conv.stop();
+        setEditingExecutionId(activeExecutionId);
         composerRef.current?.setMessage(text);
         composerRef.current?.focus();
-    }, [conv.stop, composerRef]);
+    }, [conv.stop, activeExecutionId, composerRef]);
+    const handleCancelEdit = useCallback(() => {
+        setEditingExecutionId(null);
+        composerRef.current?.setMessage("");
+    }, [composerRef]);
+    // Submit wrapper that attaches the supersede link while editing, then
+    // exits editing mode. Ordinary (non-editing) submits pass through as-is.
+    const handleComposerSubmit = useCallback((message, modelName, context) => {
+        void flow.handleSubmit(message, modelName, editingExecutionId
+            ? { ...context, supersedesExecutionId: editingExecutionId }
+            : context);
+        setEditingExecutionId(null);
+    }, [flow.handleSubmit, editingExecutionId]);
     // The composer-docked FileReviewDock sits OUTSIDE MessageThread, so the
     // thread's own FilePathContext provider does not reach it. This provider
     // gives the dock's file list the same path resolution and click routing
@@ -334,11 +372,14 @@ const ConversationColumn = memo(function ConversationColumn({ flow, modelId, set
         workspaceEntries: conv.workspaceEntries ?? [],
         onFilePathClick,
     }), [conv.workspaceEntries, onFilePathClick]);
-    return (_jsxs("div", { className: "flex h-full min-w-0 flex-col", children: [_jsx(MessageThread, { executions: conv.completedExecutions, activeStreamExecution: conv.activeStreamExecution, pendingUserMessage: conv.pendingUserMessage, pendingMessageFailed: !!conv.sendError && !!conv.pendingUserMessage, onRetrySend: conv.retryLastSend, onRetryExecution: onRetryExecution, onApprovalSubmit: flow.submitApproval, submittingApprovalIds: conv.submittingApprovalIds, approvalErrors: conv.approvalErrors, showFileReviewRecords: true, onEditMessage: conv.isStoppable ? handleEditMessage : undefined, workspaceEntries: conv.workspaceEntries, onFilePathClick: onFilePathClick, sandboxWorkspaceRoot: flow.sandboxWorkspaceRoot, onBuildFromPlan: onBuildFromPlan, onOpenPlan: onOpenPlan, org: org, planActionsDisabled: !conv.canSendFollowUp || isBuildingFromPlan, planBuildPending: isBuildingFromPlan, contentColumn: "center", className: "flex-1" }), _jsxs("div", { className: CONVERSATION_COLUMN_CLASS, children: [planAttachFailed && (_jsx(PlanAttachFailedNotice, { onDismiss: onDismissPlanAttachFailed })), conv.isReconnecting && _jsx(ReconnectingIndicator, {}), conv.connectTimedOut && (_jsx(ConnectTimedOutBanner, { onRetry: conv.reconnectStream })), conv.isSlow && !conv.connectTimedOut && _jsx(SlowIndicator, {}), conv.streamError && (_jsx(StreamErrorBanner, { error: conv.streamError, onReconnect: conv.reconnectStream })), sendError && _jsx(SendErrorBanner, { error: sendError }), flow.autoApproveAll && (_jsx(AutoApproveIndicator, { onTurnOff: () => flow.setAutoApproveAll(false) })), _jsxs(FilePathContext.Provider, { value: dockFilePathCtx, children: [_jsx(FileChangeProgressBar, { progress: conv.fileChangeProgress }), _jsx(FileReviewDock, { changeSets: conv.fileChangeSets, onSubmit: conv.submitFileDecision, submittingDecisionKeys: conv.submittingFileDecisionKeys, decisionErrors: conv.fileDecisionErrors })] }), _jsx(SessionComposer, { ref: composerRef, onSubmit: flow.handleSubmit, isSubmitting: conv.isSending, disabled: !conv.canSendFollowUp, onStop: conv.isStoppable ? handleStop : undefined, isStopping: conv.isStopping, org: org, harness: flow.harness, defaultModelId: modelId, onModelChange: setModelId, interactionMode: interactionMode, onInteractionModeChange: setInteractionMode, showInteractionModePicker: true, workspace: flow.workspace, gitHubConnection: gitHubConnection, enableGitHub: enableGitHub, enableLocal: enableLocal, onBrowseLocalFolder: onBrowseLocalFolder, agentRef: flow.agentRef, onAgentRefChange: flow.setAgentRef, onAgentResolutionChange: flow.setResolution, isDefaultAgent: flow.isDefaultAgent, lockAgent: isEndUser, mcpServerUsages: isEndUser ? undefined : flow.mcpServerUsages, onMcpServerUsagesChange: isEndUser ? undefined : flow.setMcpServerUsages, skillRefs: isEndUser ? undefined : flow.skillRefs, onSkillRefsChange: isEndUser ? undefined : flow.setSkillRefs, sessionVariables: isEndUser ? undefined : flow.sessionVariables, className: "px-4 py-3" })] })] }));
+    return (_jsxs("div", { className: "flex h-full min-w-0 flex-col", children: [_jsx(MessageThread, { executions: conv.completedExecutions, activeStreamExecution: conv.activeStreamExecution, pendingUserMessage: conv.pendingUserMessage, pendingMessageFailed: !!conv.sendError && !!conv.pendingUserMessage, onRetrySend: conv.retryLastSend, onRetryExecution: onRetryExecution, onApprovalSubmit: flow.submitApproval, submittingApprovalIds: conv.submittingApprovalIds, approvalErrors: conv.approvalErrors, showFileReviewRecords: true, onEditMessage: conv.isStoppable ? handleEditMessage : undefined, workspaceEntries: conv.workspaceEntries, onFilePathClick: onFilePathClick, sandboxWorkspaceRoot: flow.sandboxWorkspaceRoot, onBuildFromPlan: onBuildFromPlan, onOpenPlan: onOpenPlan, org: org, planActionsDisabled: !conv.canSendFollowUp || isBuildingFromPlan, planBuildPending: isBuildingFromPlan, contentColumn: "center", slots: threadSlots, className: "flex-1" }), _jsxs("div", { className: CONVERSATION_COLUMN_CLASS, children: [planAttachFailed && (_jsx(PlanAttachFailedNotice, { onDismiss: onDismissPlanAttachFailed })), conv.isReconnecting && _jsx(ReconnectingIndicator, {}), conv.connectTimedOut && (_jsx(ConnectTimedOutBanner, { onRetry: conv.reconnectStream })), conv.isSlow && !conv.connectTimedOut && _jsx(SlowIndicator, {}), conv.streamError && (_jsx(StreamErrorBanner, { error: conv.streamError, onReconnect: conv.reconnectStream })), sendError && _jsx(SendErrorBanner, { error: sendError }), flow.autoApproveAll && (_jsx(AutoApproveIndicator, { onTurnOff: () => flow.setAutoApproveAll(false) })), _jsxs(FilePathContext.Provider, { value: dockFilePathCtx, children: [_jsx(FileChangeProgressBar, { progress: conv.fileChangeProgress }), _jsx(FileReviewDock, { changeSets: conv.fileChangeSets, onSubmit: conv.submitFileDecision, submittingDecisionKeys: conv.submittingFileDecisionKeys, decisionErrors: conv.fileDecisionErrors })] }), _jsx(SessionComposer, { ref: composerRef, onSubmit: handleComposerSubmit, isSubmitting: conv.isSending, disabled: !conv.canSendFollowUp, onStop: conv.isStoppable ? handleStop : undefined, isStopping: conv.isStopping, isEditing: editingExecutionId != null, onCancelEdit: handleCancelEdit, org: org, harness: flow.harness, defaultModelId: modelId, onModelChange: setModelId, interactionMode: interactionMode, onInteractionModeChange: setInteractionMode, showInteractionModePicker: true, workspace: flow.workspace, gitHubConnection: gitHubConnection, enableGitHub: enableGitHub, enableLocal: enableLocal, onBrowseLocalFolder: onBrowseLocalFolder, agentRef: flow.agentRef, onAgentRefChange: flow.setAgentRef, onAgentResolutionChange: flow.setResolution, isDefaultAgent: flow.isDefaultAgent, lockAgent: isEndUser, mcpServerUsages: isEndUser ? undefined : flow.mcpServerUsages, onMcpServerUsagesChange: isEndUser ? undefined : flow.setMcpServerUsages, skillRefs: isEndUser ? undefined : flow.skillRefs, onSkillRefsChange: isEndUser ? undefined : flow.setSkillRefs, sessionVariables: isEndUser ? undefined : flow.sessionVariables, className: "px-4 py-3" })] })] }));
 });
-function SessionPanelRegion({ flow, org, panel, accessSlot, onApplied, onImplementPlan, implementPlanDisabled, sessionPlan, streamingPlan, planDraft, openPlanExecutionId, onOpenPlan, enableLocal, onBrowseLocalFolder, workspaceFileLister, workspaceFileReader, workspaceContentSearcher, isEndUser, }) {
+function SessionPanelRegion({ flow, org, panel, accessSlot, onApplied, onImplementPlan, implementPlanDisabled, sessionPlan, streamingPlan, planDraft, openPlanExecutionId, onOpenPlan, onOpenArtifact, onActivateArtifact, enableLocal, onBrowseLocalFolder, workspaceFileLister, workspaceFileReader, workspaceContentSearcher, isEndUser, }) {
     const selectedItem = useSelectedThreadItem();
     const { editors, activeKey, activeFile, reveal } = useWorkspaceEditors(panel.editorsStore);
+    // Session artifacts, deduped by identity — the source both the Artifacts
+    // rail-view badge and the open artifact document tabs resolve against.
+    const { artifacts: sessionArtifacts } = useSessionArtifacts(flow.allExecutions);
     // Honor a pending jump-to-line reveal only while it targets the active editor
     // (an EditorReveal is structurally a RevealTarget). Switching tabs changes
     // activeKey, so a stale reveal for another tab is naturally ignored.
@@ -379,14 +420,12 @@ function SessionPanelRegion({ flow, org, panel, accessSlot, onApplied, onImpleme
     // tab and its turn then ended without publishing, with no earlier plan to
     // fall back to.
     const openPlanIsLatest = openPlan?.executionId === sessionPlan?.executionId;
-    const virtualDocuments = useMemo(() => {
-        return [
-            {
-                entryId: PLAN_DOCUMENT_ENTRY_ID,
-                path: PLAN_DOCUMENT_PATH,
-                content: streamingPlan ? (_jsx(PlanStreamingDocument, { displayText: streamingPlan.displayText }, `streaming-${streamingPlan.executionId}`)) : openPlan ? (_jsx(PlanEditor, { plan: openPlan, draft: openPlanIsLatest ? planDraft : undefined, onBuildFromPlan: openPlanIsLatest ? onImplementPlan : undefined, buildDisabled: implementPlanDisabled, readOnly: !openPlanIsLatest }, planDraftKey(openPlan))) : (_jsx(PlanUnavailableNotice, {})),
-            },
-        ];
+    const planVirtualDocument = useMemo(() => {
+        return {
+            entryId: PLAN_DOCUMENT_ENTRY_ID,
+            path: PLAN_DOCUMENT_PATH,
+            content: streamingPlan ? (_jsx(PlanStreamingDocument, { displayText: streamingPlan.displayText }, `streaming-${streamingPlan.executionId}`)) : openPlan ? (_jsx(PlanEditor, { plan: openPlan, draft: openPlanIsLatest ? planDraft : undefined, onBuildFromPlan: openPlanIsLatest ? onImplementPlan : undefined, buildDisabled: implementPlanDisabled, readOnly: !openPlanIsLatest }, planDraftKey(openPlan))) : (_jsx(PlanUnavailableNotice, {})),
+        };
     }, [
         streamingPlan,
         openPlan,
@@ -395,6 +434,30 @@ function SessionPanelRegion({ flow, org, panel, accessSlot, onApplied, onImpleme
         onImplementPlan,
         implementPlanDisabled,
     ]);
+    // The open artifact document tabs (the artifact virtual-document FAMILY).
+    // Built in a SEPARATE memo from the plan doc so artifact-tab churn never
+    // recreates the plan doc (and vice versa). Bounded to what is actually open:
+    // one document per editor whose entry id is the artifact family's, resolved
+    // back to its `SessionArtifactEntry` by the same `artifactKey` used to open
+    // it (single source of truth for artifact identity). Only the ACTIVE doc's
+    // `content` is mounted by the surface, so building these elements is cheap;
+    // keying on `contentHash` remounts a tab whose artifact was overwritten by a
+    // later execution. A tab whose artifact no longer exists degrades to an
+    // honest notice rather than vanishing.
+    const artifactByKey = useMemo(() => new Map(sessionArtifacts.map((entry) => [artifactKey(entry.artifact), entry])), [sessionArtifacts]);
+    const artifactVirtualDocuments = useMemo(() => {
+        return editors
+            .filter((editor) => editor.entryId === ARTIFACT_DOCUMENT_ENTRY_ID)
+            .map((editor) => {
+            const entry = artifactByKey.get(editor.path);
+            return {
+                entryId: ARTIFACT_DOCUMENT_ENTRY_ID,
+                path: editor.path,
+                content: entry ? (_jsx(ArtifactDocument, { artifact: entry.artifact, executionId: entry.executionId, org: org, isTerminal: entry.isTerminal, onApplied: onApplied }, entry.artifact.contentHash || editor.path)) : (_jsx(ArtifactUnavailableNotice, {})),
+            };
+        });
+    }, [editors, artifactByKey, org, onApplied]);
+    const virtualDocuments = useMemo(() => [planVirtualDocument, ...artifactVirtualDocuments], [planVirtualDocument, artifactVirtualDocuments]);
     const handleRemoveAgent = useCallback(() => {
         flow.setAgentRef(null);
         flow.setResolution(null);
@@ -440,6 +503,8 @@ function SessionPanelRegion({ flow, org, panel, accessSlot, onApplied, onImpleme
         onApplied,
         onImplementPlan,
         onOpenPlan,
+        onOpenArtifact,
+        onActivateArtifact,
     });
     // Explorer-footer folder attach (desktop only — needs the native picker).
     // Same wiring the retired Workspace tab used.
@@ -449,7 +514,13 @@ function SessionPanelRegion({ flow, org, panel, accessSlot, onApplied, onImpleme
         if (path)
             flow.workspace.addLocalPath(path);
     }, [onBrowseLocalFolder, flow.workspace.addLocalPath]);
-    return (_jsx(WorkspaceSurface, { entries: flow.workspace.entries, lister: workspaceFileLister, reader: workspaceFileReader, searcher: workspaceContentSearcher, view: panel.view, onViewChange: panel.setView, extraViews: railViews, virtualDocuments: virtualDocuments, onRemoveEntry: flow.workspace.remove, onAddLocalFolder: canAddLocalFolder ? handleAddLocalFolder : undefined, editors: editors, selectedFile: activeFile, onOpenFile: panel.openFile, onActivateEditor: panel.activateEditor, onPinEditor: panel.pinEditor, onCloseEditor: panel.closeEditor, onCollapse: panel.closePanel, change: openFileChange ?? undefined, reveal: activeReveal, className: "h-full" }));
+    // Entries decorated with per-entry read refs (the latest write-back commit
+    // SHA), so the surface's read-side capabilities — file viewer, tree listing,
+    // name search — resolve at the ref the agent's changes actually live on. A
+    // read-side projection only: `flow.workspace.entries` stays undecorated for
+    // setup and session input.
+    const surfaceEntries = useWorkspaceReadRefs(flow.allExecutions, flow.workspace.entries);
+    return (_jsx(WorkspaceSurface, { entries: surfaceEntries, lister: workspaceFileLister, reader: workspaceFileReader, searcher: workspaceContentSearcher, view: panel.view, onViewChange: panel.setView, extraViews: railViews, virtualDocuments: virtualDocuments, onRemoveEntry: flow.workspace.remove, onAddLocalFolder: canAddLocalFolder ? handleAddLocalFolder : undefined, editors: editors, selectedFile: activeFile, onOpenFile: panel.openFile, onActivateEditor: panel.activateEditor, onPinEditor: panel.pinEditor, onCloseEditor: panel.closeEditor, onCollapse: panel.closePanel, change: openFileChange ?? undefined, reveal: activeReveal, className: "h-full" }));
 }
 // ---------------------------------------------------------------------------
 // Local sub-components (error states)
@@ -479,6 +550,15 @@ function AutoApproveIndicator({ onTurnOff }) {
 function PlanUnavailableNotice() {
     return (_jsxs("div", { role: "status", className: "mx-auto flex w-full max-w-3xl flex-col items-center gap-1 px-4 py-8 text-center", children: [_jsx("p", { className: "text-xs font-medium text-foreground", children: "This turn ended before a plan was completed." }), _jsx("p", { className: "text-xs text-muted-foreground", children: "Any partial plan text remains in the conversation." })] }));
 }
+/**
+ * Shown in an artifact document tab whose artifact is no longer among the
+ * session's outputs (an edge only reachable if the executions backing the tab
+ * changed underneath it). The tab stays closable; the content is honest rather
+ * than blank.
+ */
+function ArtifactUnavailableNotice() {
+    return (_jsxs("div", { role: "status", className: "mx-auto flex w-full max-w-3xl flex-col items-center gap-1 px-4 py-8 text-center", children: [_jsx("p", { className: "text-xs font-medium text-foreground", children: "This artifact is no longer available." }), _jsx("p", { className: "text-xs text-muted-foreground", children: "It may have been replaced by a newer version of this session." })] }));
+}
 /**
  * Non-blocking notice for a build that fell back to message-only implement
  * (the approved plan.md could not be uploaded/attached). The build itself