@stigmer/react 3.1.16 → 3.2.0

package/execution/agent-execution-document.js

@@ -0,0 +1,48 @@
+// Identity of agent-execution transcript tabs in the workspace surface's
+// editor group. Domain: execution (the transcript renderer and the
+// AgentExecution data model are execution-domain; the workflow panel is the
+// first host, and a future session-side consumer — e.g. sub-agent expansion —
+// would share this identity rather than minting a divergent one).
+//
+// Kept in its own module (not in a component file) so behavior-only
+// consumers — the panel controller opens the tabs, the viewer routes them —
+// depend on the identity without pulling the transcript renderer into their
+// module graph (DD-003 headless-first). Mirrors artifact-document.ts and
+// file-change-document.ts.
+import { virtualEntryId } from "../internal/store/index.js";
+/**
+ * Virtual entry id of the agent-execution transcript document FAMILY. Like
+ * artifacts and file changes (and unlike the session's single plan tab),
+ * transcripts are many: every opened child AgentExecution shares this one
+ * entry id and is distinguished by its id-derived tab path, so
+ * `editorKey(AGENT_EXECUTION_DOCUMENT_ENTRY_ID, path)` yields one tab per
+ * child execution — the VS Code "each file is a tab" model. The
+ * NUL-namespaced virtual id can never alias a real workspace entry, and its
+ * distinct `"agentexec"` kind can never collide with the
+ * `"artifact"`/`"filechange"`/`"plan"` families.
+ */
+export const AGENT_EXECUTION_DOCUMENT_ENTRY_ID = virtualEntryId("agentexec");
+/**
+ * The identity of a child AgentExecution's transcript tab within the family.
+ *
+ * The path deliberately CARRIES the child execution id (unlike artifact tabs,
+ * which need an owner-level record map to resolve content): a transcript
+ * needs only the id to fetch/stream itself, so the viewer parses it straight
+ * back out with {@link parseAgentExecutionTabPath} — no lookup map to keep in
+ * sync. The suffix is the AGENT_CALL task name because the editor tab's LABEL
+ * is the path's basename: the task name correlates the tab with the DAG node
+ * the user opened it from, and keeps two calls to the same agent distinct.
+ */
+export function agentExecutionTabPath(childExecutionId, taskName) {
+    return `${childExecutionId}/${taskName}`;
+}
+/**
+ * Recovers the child execution id from a transcript tab's path — the inverse
+ * of {@link agentExecutionTabPath}. Splits on the FIRST separator: execution
+ * ids never contain `/`, so a task name that does still round-trips.
+ */
+export function parseAgentExecutionTabPath(path) {
+    const separator = path.indexOf("/");
+    return separator === -1 ? path : path.slice(0, separator);
+}
+//# sourceMappingURL=agent-execution-document.js.map

package/execution/agent-execution-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-execution-document.js","sourceRoot":"","sources":["../../src/execution/agent-execution-document.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,mEAAmE;AACnE,4EAA4E;AAC5E,8EAA8E;AAC9E,kEAAkE;AAClE,EAAE;AACF,oEAAoE;AACpE,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,2BAA2B;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAE7E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CACnC,gBAAwB,EACxB,QAAgB;IAEhB,OAAO,GAAG,gBAAgB,IAAI,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAC5D,CAAC"}

package/{session → execution}/artifact-document.d.ts

@@ -1,13 +1,12 @@
 /**
  * Virtual entry id of the artifact document FAMILY. Unlike the plan (one tab
  * per session), artifacts are many: every opened artifact shares this one
- * entry id and is distinguished by its {@link artifactKey}-derived `path`, so
+ * entry id and is distinguished by its identity-derived `path` (the session's
+ * `artifactKey`, the workflow's `Artifact` id), so
  * `editorKey(ARTIFACT_DOCUMENT_ENTRY_ID, path)` yields one tab per artifact —
  * the VS Code "each file is a tab" model. The NUL-namespaced virtual id can
  * never alias a real workspace entry, and its distinct `"artifact"` kind can
  * never collide with the plan tab's `"plan"` kind.
- *
- * @see artifactKey — the `path` component (an artifact's stable identity)
  */
 export declare const ARTIFACT_DOCUMENT_ENTRY_ID: string;
 //# sourceMappingURL=artifact-document.d.ts.map

package/execution/artifact-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-document.d.ts","sourceRoot":"","sources":["../../src/execution/artifact-document.ts"],"names":[],"mappings":"AAaA;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,QAA6B,CAAC"}

package/execution/artifact-document.js

@@ -0,0 +1,23 @@
+// Identity of artifact document tabs in the workspace surface's editor group.
+// Domain: execution (shared — both the session and workflow panels open
+// artifact tabs, and a single identity source prevents the two viewers from
+// minting divergent virtual ids for the same tab family).
+//
+// Kept in its own module (not in a component file) so behavior-only
+// consumers — the session/workflow panel controllers open artifact tabs, the
+// viewers route to them — depend on the identity without pulling a component
+// (and its content renderer) into their module graph (DD-003 headless-first).
+// Mirrors session/plan-document.ts.
+import { virtualEntryId } from "../internal/store/index.js";
+/**
+ * Virtual entry id of the artifact document FAMILY. Unlike the plan (one tab
+ * per session), artifacts are many: every opened artifact shares this one
+ * entry id and is distinguished by its identity-derived `path` (the session's
+ * `artifactKey`, the workflow's `Artifact` id), so
+ * `editorKey(ARTIFACT_DOCUMENT_ENTRY_ID, path)` yields one tab per artifact —
+ * the VS Code "each file is a tab" model. The NUL-namespaced virtual id can
+ * never alias a real workspace entry, and its distinct `"artifact"` kind can
+ * never collide with the plan tab's `"plan"` kind.
+ */
+export const ARTIFACT_DOCUMENT_ENTRY_ID = virtualEntryId("artifact");
+//# sourceMappingURL=artifact-document.js.map

package/execution/artifact-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-document.js","sourceRoot":"","sources":["../../src/execution/artifact-document.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wEAAwE;AACxE,4EAA4E;AAC5E,0DAA0D;AAC1D,EAAE;AACF,oEAAoE;AACpE,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,oCAAoC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC"}

package/execution/artifact-row-item.d.ts

@@ -0,0 +1,56 @@
+import type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/artifact_pb";
+import type { Artifact } from "@stigmer/protos/ai/stigmer/agentic/artifact/v1/api_pb";
+/**
+ * What an artifact row displays, independent of which artifact data model
+ * produced it.
+ *
+ * Two artifact models exist and are deliberately unified ONLY at this
+ * presentational layer, never at the data layer: the session's
+ * `ExecutionArtifact` (embedded in `AgentExecution.status.artifacts`) and the
+ * workflow's first-class `Artifact` resource. Their identity, provenance, and
+ * download mechanics differ — so the view-model carries no identity; list
+ * keys and open/download behavior stay with the domain-specific hosts.
+ */
+export interface ArtifactRowItem {
+    /** Display label (file or directory name). */
+    readonly name: string;
+    /** Hover title — the fullest location/name known for the artifact. */
+    readonly tooltip: string;
+    /**
+     * Disambiguation subtitle rendered after the name when another row shares
+     * the same display name: the parent directory for sandbox-backed artifacts,
+     * the producing task for workflow artifacts. `null` when not needed.
+     */
+    readonly subtitlePath: string | null;
+    /** Content size in bytes (protobuf `int64` is `bigint`). */
+    readonly sizeBytes: bigint | number;
+    /** Directory artifacts render a folder icon, a `/` suffix, and ZIP download copy. */
+    readonly isDirectory: boolean;
+}
+/**
+ * Adapts a session `ExecutionArtifact` to a row item.
+ *
+ * @param hasNameCollision - When `true`, the artifact's parent directory (from
+ *   `sandbox_path`) becomes the disambiguation subtitle. Typically supplied
+ *   from `SessionArtifactEntry.hasNameCollision`.
+ */
+export declare function fromExecutionArtifact(artifact: ExecutionArtifact, hasNameCollision?: boolean): ArtifactRowItem;
+/**
+ * Adapts a workflow `Artifact` resource to a row item.
+ *
+ * A workflow artifact is always a single content-typed blob — the resource
+ * model has no directory concept — so `isDirectory` is always `false`. Name
+ * collisions disambiguate by the producing task (`source.task_name`), the
+ * workflow analog of the session's parent-directory subtitle.
+ *
+ * @param hasNameCollision - When `true` and the artifact has a source task,
+ *   that task name becomes the disambiguation subtitle.
+ */
+export declare function fromArtifact(artifact: Artifact, hasNameCollision?: boolean): ArtifactRowItem;
+/**
+ * Extracts a human-readable parent directory label from a sandbox path.
+ * Given `/workspace/configs/agent.yaml` returns `configs/`.
+ * Returns `null` when the path has no meaningful parent segment.
+ */
+export declare function parentDirectory(sandboxPath: string): string | null;
+//# sourceMappingURL=artifact-row-item.d.ts.map

package/execution/artifact-row-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-row-item.d.ts","sourceRoot":"","sources":["../../src/execution/artifact-row-item.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAE1G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAEtF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,qFAAqF;IACrF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,gBAAgB,UAAQ,GACvB,eAAe,CAWjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,UAAQ,GACvB,eAAe,CAWjB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlE"}

package/execution/artifact-row-item.js

@@ -0,0 +1,57 @@
+// Type-agnostic view-model for artifact list rows, with adapters from both
+// artifact data models. Domain: execution (shared by session + workflow).
+import { ExecutionArtifactKind } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/**
+ * Adapts a session `ExecutionArtifact` to a row item.
+ *
+ * @param hasNameCollision - When `true`, the artifact's parent directory (from
+ *   `sandbox_path`) becomes the disambiguation subtitle. Typically supplied
+ *   from `SessionArtifactEntry.hasNameCollision`.
+ */
+export function fromExecutionArtifact(artifact, hasNameCollision = false) {
+    return {
+        name: artifact.name,
+        tooltip: artifact.sandboxPath || artifact.name,
+        subtitlePath: hasNameCollision && artifact.sandboxPath
+            ? parentDirectory(artifact.sandboxPath)
+            : null,
+        sizeBytes: artifact.sizeBytes,
+        isDirectory: artifact.kind === ExecutionArtifactKind.DIRECTORY,
+    };
+}
+/**
+ * Adapts a workflow `Artifact` resource to a row item.
+ *
+ * A workflow artifact is always a single content-typed blob — the resource
+ * model has no directory concept — so `isDirectory` is always `false`. Name
+ * collisions disambiguate by the producing task (`source.task_name`), the
+ * workflow analog of the session's parent-directory subtitle.
+ *
+ * @param hasNameCollision - When `true` and the artifact has a source task,
+ *   that task name becomes the disambiguation subtitle.
+ */
+export function fromArtifact(artifact, hasNameCollision = false) {
+    const name = artifact.spec?.displayName || artifact.metadata?.name || "Unnamed";
+    const taskName = artifact.spec?.source?.taskName ?? "";
+    return {
+        name,
+        tooltip: name,
+        subtitlePath: hasNameCollision && taskName ? taskName : null,
+        sizeBytes: artifact.status?.sizeBytes ?? BigInt(0),
+        isDirectory: false,
+    };
+}
+/**
+ * Extracts a human-readable parent directory label from a sandbox path.
+ * Given `/workspace/configs/agent.yaml` returns `configs/`.
+ * Returns `null` when the path has no meaningful parent segment.
+ */
+export function parentDirectory(sandboxPath) {
+    const lastSlash = sandboxPath.lastIndexOf("/");
+    if (lastSlash <= 0)
+        return null;
+    const parent = sandboxPath.slice(0, lastSlash);
+    const segment = parent.slice(parent.lastIndexOf("/") + 1);
+    return segment ? `${segment}/` : null;
+}
+//# sourceMappingURL=artifact-row-item.js.map

package/execution/artifact-row-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-row-item.js","sourceRoot":"","sources":["../../src/execution/artifact-row-item.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0EAA0E;AAG1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8DAA8D,CAAC;AA+BrG;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAA2B,EAC3B,gBAAgB,GAAG,KAAK;IAExB,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,IAAI;QAC9C,YAAY,EACV,gBAAgB,IAAI,QAAQ,CAAC,WAAW;YACtC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,WAAW,CAAC;YACvC,CAAC,CAAC,IAAI;QACV,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,WAAW,EAAE,QAAQ,CAAC,IAAI,KAAK,qBAAqB,CAAC,SAAS;KAC/D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAkB,EAClB,gBAAgB,GAAG,KAAK;IAExB,MAAM,IAAI,GACR,QAAQ,CAAC,IAAI,EAAE,WAAW,IAAI,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,SAAS,CAAC;IACrE,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC;IACvD,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,gBAAgB,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QAC5D,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC;QAClD,WAAW,EAAE,KAAK;KACnB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC"}

package/execution/deriveExecutionFileChanges.d.ts

@@ -0,0 +1,55 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import type { FileChange } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import type { DiffHunk, FileDiffEntry } from "../version-history/types.js";
+/**
+ * Collapses the file changes captured across `executions` into one *net*
+ * {@link FileChange} per path, ordered for a file list (modified, then
+ * created/renamed, then deleted; alphabetical within each group).
+ *
+ * **Source (ledger-first).** Under apply-then-review the changes live in the
+ * file-review ledger; {@link displayFileChangeSets} reads the server's live
+ * projection or folds the durable ledger for a terminal execution (whose
+ * projection is nil), and each captured change is projected onto the display
+ * {@link FileChange} via {@link toDisplayFileChange}. The execution-scoped
+ * ledger already includes sub-agent captures (DD-19), so one pass per
+ * execution suffices.
+ *
+ * **Net-diff (not latest-wins).** A {@link FileChange} is a *delta* — an
+ * agent often rewrites the same file several times, and showing only the last
+ * edit's diff would misrepresent what changed. So changes to the same path
+ * are reduced to a single net change: `before` from the first change, `after`
+ * from the last. Because a WHOLE_FILE `after` is a complete file snapshot,
+ * `first.before → last.after` is exactly the net change. A group with one
+ * change (the common case) is passed through untouched; multi-edit groups
+ * synthesize a net {@link FileChange} so every consumer speaks one proto
+ * type (DD-007).
+ *
+ * **Ordering is a correctness input.** `executions` MUST be chronological:
+ * the net collapse anchors on each path's first and last change, so two
+ * executions touching the same path (a session's follow-up turns; two
+ * workflow agent-call tasks) produce a wrong net diff if visited out of
+ * order.
+ *
+ * Counts and unified diffs for whole-file captures stay derivable by the
+ * presentation layer (the runner emits 0/"" sentinels), matching the
+ * contract the SDK `tool-view` established.
+ */
+export declare function deriveExecutionFileChanges(executions: readonly AgentExecution[]): readonly FileChange[];
+/**
+ * Projects a {@link FileChange} into a {@link FileDiffEntry} for a file list
+ * (`DiffFileList`).
+ *
+ * Counts: hunk-only uses the runner's authoritative numbers; whole-file inline
+ * is derived from the content (identical to the runner's capture-time counts by
+ * construction — same diff algorithm). A whole-file side with no synchronous
+ * content (offloaded / binary) falls back to the runner's capture-time
+ * `linesAdded`/`linesRemoved` — zero when no count exists, which the list
+ * renders as no stat.
+ */
+export declare function toFileDiffEntry(change: FileChange): FileDiffEntry;
+/** Sums added/removed line counts across rendered diff hunks. */
+export declare function countHunks(hunks: readonly DiffHunk[]): {
+    additions: number;
+    deletions: number;
+};
+//# sourceMappingURL=deriveExecutionFileChanges.d.ts.map

package/execution/deriveExecutionFileChanges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveExecutionFileChanges.d.ts","sourceRoot":"","sources":["../../src/execution/deriveExecutionFileChanges.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iEAAiE,CAAC;AAQlG,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,SAAS,cAAc,EAAE,GACpC,SAAS,UAAU,EAAE,CAsBvB;AA4FD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CA8BjE;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAUA"}

package/execution/deriveExecutionFileChanges.js

@@ -0,0 +1,216 @@
+// Pure derivation of net file changes across a chronological list of agent
+// executions, plus the FileChange → FileDiffEntry projection for file lists.
+// Domain: execution (shared — the session's Changes surface and the workflow
+// panel's Changes facet both collapse per-execution captures into one net
+// change per path, and a single core prevents the two from drifting on the
+// non-trivial net-diff semantics below).
+//
+// Not a hook: callers memoize on their executions reference
+// (`useSessionFileChanges` for sessions; `useWorkflowExecutionFileChanges`
+// aggregates a workflow's AGENT_CALL children).
+import { create } from "@bufbuild/protobuf";
+import { FileChangeSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import { FileChangeCaptureLevel, FileChangeType, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { displayFileChangeSets, toDisplayFileChange } from "@stigmer/sdk";
+import { computeDiff } from "../version-history/computeDiff.js";
+/**
+ * Collapses the file changes captured across `executions` into one *net*
+ * {@link FileChange} per path, ordered for a file list (modified, then
+ * created/renamed, then deleted; alphabetical within each group).
+ *
+ * **Source (ledger-first).** Under apply-then-review the changes live in the
+ * file-review ledger; {@link displayFileChangeSets} reads the server's live
+ * projection or folds the durable ledger for a terminal execution (whose
+ * projection is nil), and each captured change is projected onto the display
+ * {@link FileChange} via {@link toDisplayFileChange}. The execution-scoped
+ * ledger already includes sub-agent captures (DD-19), so one pass per
+ * execution suffices.
+ *
+ * **Net-diff (not latest-wins).** A {@link FileChange} is a *delta* — an
+ * agent often rewrites the same file several times, and showing only the last
+ * edit's diff would misrepresent what changed. So changes to the same path
+ * are reduced to a single net change: `before` from the first change, `after`
+ * from the last. Because a WHOLE_FILE `after` is a complete file snapshot,
+ * `first.before → last.after` is exactly the net change. A group with one
+ * change (the common case) is passed through untouched; multi-edit groups
+ * synthesize a net {@link FileChange} so every consumer speaks one proto
+ * type (DD-007).
+ *
+ * **Ordering is a correctness input.** `executions` MUST be chronological:
+ * the net collapse anchors on each path's first and last change, so two
+ * executions touching the same path (a session's follow-up turns; two
+ * workflow agent-call tasks) produce a wrong net diff if visited out of
+ * order.
+ *
+ * Counts and unified diffs for whole-file captures stay derivable by the
+ * presentation layer (the runner emits 0/"" sentinels), matching the
+ * contract the SDK `tool-view` established.
+ */
+export function deriveExecutionFileChanges(executions) {
+    // Path -> chronological list of raw changes to that path.
+    const groups = new Map();
+    // Preserve first-seen path order as a stable tiebreaker before sorting.
+    const collect = (change) => {
+        const key = change.path || change.absolutePath;
+        if (!key)
+            return;
+        const list = groups.get(key);
+        if (list)
+            list.push(change);
+        else
+            groups.set(key, [change]);
+    };
+    for (const execution of executions) {
+        const capturedChanges = displayFileChangeSets(execution.status).flatMap((set) => set.changes);
+        for (const captured of capturedChanges)
+            collect(toDisplayFileChange(captured));
+    }
+    const fileChanges = Array.from(groups.values(), netChange);
+    fileChanges.sort(fileChangeComparator);
+    return fileChanges;
+}
+/**
+ * Reduces a path's chronological change list to a single net change.
+ * A one-change group is returned as-is (the common path, no allocation);
+ * multi-edit groups synthesize a net {@link FileChange}.
+ */
+function netChange(changes) {
+    if (changes.length === 1)
+        return changes[0];
+    const first = changes[0];
+    const last = changes[changes.length - 1];
+    const changeType = netChangeType(first, last);
+    // Whole-file only when both chosen sides come from whole-file captures;
+    // otherwise fall back to the last change's hunk diff. A path edited by a
+    // single harness won't mix levels — this just stays honest if it ever does.
+    const wholeFile = first.captureLevel === FileChangeCaptureLevel.WHOLE_FILE &&
+        last.captureLevel === FileChangeCaptureLevel.WHOLE_FILE;
+    if (wholeFile) {
+        return create(FileChangeSchema, {
+            path: last.path,
+            absolutePath: last.absolutePath,
+            changeType,
+            captureLevel: FileChangeCaptureLevel.WHOLE_FILE,
+            before: first.before,
+            after: last.after,
+            renameFrom: changeType === FileChangeType.RENAME ? first.renameFrom : "",
+        });
+    }
+    return create(FileChangeSchema, {
+        path: last.path,
+        absolutePath: last.absolutePath,
+        changeType,
+        captureLevel: FileChangeCaptureLevel.HUNK_ONLY,
+        unifiedDiff: last.unifiedDiff,
+        linesAdded: last.linesAdded,
+        linesRemoved: last.linesRemoved,
+        renameFrom: changeType === FileChangeType.RENAME ? first.renameFrom : "",
+    });
+}
+/**
+ * Reconciles the net `change_type` of a path from its first and last change.
+ *
+ * Intent: the badge should describe the file's journey across the *whole*
+ * span of executions, anchored on its two endpoints, in this precedence:
+ *
+ * 1. Ends deleted (`last` is DELETE) → DELETE. The file is gone, regardless of
+ *    how it got there — this includes create-then-delete, which we deliberately
+ *    surface as DELETE rather than hiding the path. (`before` then comes from
+ *    the first change, which for a created-then-deleted file is empty, so the
+ *    diff reads as the removal of whatever briefly existed.)
+ * 2. Started created (`first` is CREATE) and still exists → CREATE. A file born
+ *    in this span and later modified is, on net, a new file.
+ * 3. Started renamed (`first` is RENAME) and still exists → RENAME, carrying the
+ *    original `rename_from` so the move is preserved across later edits.
+ * 4. Otherwise → MODIFY (the common multi-edit case).
+ */
+function netChangeType(first, last) {
+    if (last.changeType === FileChangeType.DELETE)
+        return FileChangeType.DELETE;
+    if (first.changeType === FileChangeType.CREATE)
+        return FileChangeType.CREATE;
+    if (first.changeType === FileChangeType.RENAME)
+        return FileChangeType.RENAME;
+    return FileChangeType.MODIFY;
+}
+// Most-actionable first (modified), then additions (create/rename), then
+// deletions — mirroring GitHub's file-list convention — alphabetical within
+// each group so the list is stable and scannable.
+const CHANGE_TYPE_ORDER = {
+    [FileChangeType.MODIFY]: 0,
+    [FileChangeType.CREATE]: 1,
+    [FileChangeType.RENAME]: 1,
+    [FileChangeType.DELETE]: 2,
+    [FileChangeType.UNSPECIFIED]: 3,
+};
+function fileChangeComparator(a, b) {
+    const order = (CHANGE_TYPE_ORDER[a.changeType] ?? 3) -
+        (CHANGE_TYPE_ORDER[b.changeType] ?? 3);
+    if (order !== 0)
+        return order;
+    return a.path.localeCompare(b.path, undefined, { sensitivity: "base" });
+}
+// ---------------------------------------------------------------------------
+// FileChange → FileDiffEntry projection (file lists)
+// ---------------------------------------------------------------------------
+/**
+ * Projects a {@link FileChange} into a {@link FileDiffEntry} for a file list
+ * (`DiffFileList`).
+ *
+ * Counts: hunk-only uses the runner's authoritative numbers; whole-file inline
+ * is derived from the content (identical to the runner's capture-time counts by
+ * construction — same diff algorithm). A whole-file side with no synchronous
+ * content (offloaded / binary) falls back to the runner's capture-time
+ * `linesAdded`/`linesRemoved` — zero when no count exists, which the list
+ * renders as no stat.
+ */
+export function toFileDiffEntry(change) {
+    const changeType = change.changeType === FileChangeType.CREATE
+        ? "added"
+        : change.changeType === FileChangeType.DELETE
+            ? "removed"
+            : "modified";
+    if (change.captureLevel === FileChangeCaptureLevel.HUNK_ONLY) {
+        return {
+            path: change.path,
+            changeType,
+            additions: change.linesAdded,
+            deletions: change.linesRemoved,
+        };
+    }
+    const before = inlineSide(change.before);
+    const after = inlineSide(change.after);
+    if (before !== null && after !== null) {
+        const { additions, deletions } = countHunks(computeDiff(before, after));
+        return { path: change.path, changeType, additions, deletions };
+    }
+    return {
+        path: change.path,
+        changeType,
+        additions: change.linesAdded,
+        deletions: change.linesRemoved,
+    };
+}
+/** Sums added/removed line counts across rendered diff hunks. */
+export function countHunks(hunks) {
+    let additions = 0;
+    let deletions = 0;
+    for (const hunk of hunks) {
+        for (const line of hunk.lines) {
+            if (line.type === "added")
+                additions++;
+            else if (line.type === "removed")
+                deletions++;
+        }
+    }
+    return { additions, deletions };
+}
+/** Inline text of a side, or null when absent/offloaded/binary. */
+function inlineSide(side) {
+    if (!side)
+        return "";
+    if (side.isBinary)
+        return null;
+    return side.body.case === "inline" ? side.body.value : null;
+}
+//# sourceMappingURL=deriveExecutionFileChanges.js.map

package/execution/deriveExecutionFileChanges.js.map

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

package/execution/file-change-document.d.ts

@@ -0,0 +1,22 @@
+import type { FileChange } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+/**
+ * Virtual entry id of the file-change diff document FAMILY. Like artifacts
+ * (and unlike the session's single plan tab), file changes are many: every
+ * opened diff shares this one entry id and is distinguished by its
+ * change-path-derived tab path, so
+ * `editorKey(FILE_CHANGE_DOCUMENT_ENTRY_ID, path)` yields one tab per changed
+ * file — the VS Code "each file is a tab" model. The NUL-namespaced virtual
+ * id can never alias a real workspace entry, and its distinct `"filechange"`
+ * kind can never collide with the `"artifact"`/`"plan"` families.
+ */
+export declare const FILE_CHANGE_DOCUMENT_ENTRY_ID: string;
+/**
+ * The identity of a file change's diff tab within the family. The net rollup
+ * carries at most one {@link FileChange} per path, so the change's path IS
+ * the identity — and, as the tab path, its basename is exactly the tab label
+ * (no prefixing needed, unlike artifact tabs whose ids are opaque).
+ * `absolutePath` is the fallback for captures without a workspace-relative
+ * path, matching the keying inside the net-collapse core.
+ */
+export declare function fileChangeTabPath(change: FileChange): string;
+//# sourceMappingURL=file-change-document.d.ts.map

package/execution/file-change-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-change-document.d.ts","sourceRoot":"","sources":["../../src/execution/file-change-document.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iEAAiE,CAAC;AAGlG;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B,QAA+B,CAAC;AAE1E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE5D"}

package/execution/file-change-document.js

@@ -0,0 +1,34 @@
+// Identity of file-change diff document tabs in the workspace surface's
+// editor group. Domain: execution (the diff renderer and the FileChange data
+// model are execution-domain; the workflow panel is the first host, and a
+// future session-side consumer would share this identity rather than minting
+// a divergent one).
+//
+// Kept in its own module (not in a component file) so behavior-only
+// consumers — the panel controller opens the tabs, the viewer routes them —
+// depend on the identity without pulling the diff renderer into their module
+// graph (DD-003 headless-first). Mirrors artifact-document.ts.
+import { virtualEntryId } from "../internal/store/index.js";
+/**
+ * Virtual entry id of the file-change diff document FAMILY. Like artifacts
+ * (and unlike the session's single plan tab), file changes are many: every
+ * opened diff shares this one entry id and is distinguished by its
+ * change-path-derived tab path, so
+ * `editorKey(FILE_CHANGE_DOCUMENT_ENTRY_ID, path)` yields one tab per changed
+ * file — the VS Code "each file is a tab" model. The NUL-namespaced virtual
+ * id can never alias a real workspace entry, and its distinct `"filechange"`
+ * kind can never collide with the `"artifact"`/`"plan"` families.
+ */
+export const FILE_CHANGE_DOCUMENT_ENTRY_ID = virtualEntryId("filechange");
+/**
+ * The identity of a file change's diff tab within the family. The net rollup
+ * carries at most one {@link FileChange} per path, so the change's path IS
+ * the identity — and, as the tab path, its basename is exactly the tab label
+ * (no prefixing needed, unlike artifact tabs whose ids are opaque).
+ * `absolutePath` is the fallback for captures without a workspace-relative
+ * path, matching the keying inside the net-collapse core.
+ */
+export function fileChangeTabPath(change) {
+    return change.path || change.absolutePath;
+}
+//# sourceMappingURL=file-change-document.js.map

package/execution/file-change-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-change-document.js","sourceRoot":"","sources":["../../src/execution/file-change-document.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,oBAAoB;AACpB,EAAE;AACF,oEAAoE;AACpE,4EAA4E;AAC5E,6EAA6E;AAC7E,+DAA+D;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,CAAC;AAC5C,CAAC"}

package/execution/index.d.ts

@@ -3,6 +3,8 @@ export type { BootstrapSessionSpec, CreateAgentExecutionInput, CreateAgentExecut
 export { isTerminalPhase } from "./execution-phases.js";
 export { useExecutionStream } from "./useExecutionStream.js";
 export type { UseExecutionStreamReturn } from "./useExecutionStream.js";
+export { useLiveAgentExecution } from "./useLiveAgentExecution.js";
+export type { UseLiveAgentExecutionReturn } from "./useLiveAgentExecution.js";
 export { useAgentExecutionActions } from "./useAgentExecutionActions.js";
 export type { UseAgentExecutionActionsOptions, UseAgentExecutionActionsReturn, } from "./useAgentExecutionActions.js";
 export { UsageWidget, formatCost, formatTokenCount } from "./UsageWidget.js";
@@ -27,6 +29,8 @@ export { useExecutionArtifacts } from "./useExecutionArtifacts.js";
 export type { UseExecutionArtifactsReturn } from "./useExecutionArtifacts.js";
 export { useArtifactContent } from "./useArtifactContent.js";
 export type { UseArtifactContentReturn } from "./useArtifactContent.js";
+export { useArtifactContentById } from "./useArtifactContentById.js";
+export type { UseArtifactContentByIdReturn } from "./useArtifactContentById.js";
 export { useArtifactDownloadUrl } from "./useArtifactDownloadUrl.js";
 export type { UseArtifactDownloadUrlReturn, UseArtifactDownloadUrlOptions, } from "./useArtifactDownloadUrl.js";
 export { useArtifactDownload } from "./useArtifactDownload.js";
@@ -45,6 +49,7 @@ export { parseDiffStatSummary, trailingDiffStatLine, writeBackDisplayName, } fro
 export type { DiffStatSummary } from "./write-back-utils.js";
 export { FileChangesView, FileChangeDiff } from "./FileChangesView.js";
 export type { FileChangesViewProps, FileChangeDiffProps } from "./FileChangesView.js";
+export { deriveExecutionFileChanges, toFileDiffEntry, } from "./deriveExecutionFileChanges.js";
 export { EmptyChangeNotice } from "./EmptyChangeNotice.js";
 export type { EmptyChangeNoticeProps, EmptyChangeKind } from "./EmptyChangeNotice.js";
 export { isTextArtifact, formatArtifactSize, getArtifactExtension, getFileExtension, getArtifactRenderMode, } from "./artifact-utils.js";
@@ -115,8 +120,17 @@ export { FileReviewContext, useFileReviewRowState, useFileReviewRowChange, } fro
 export type { FileReviewContextValue } from "./FileReviewContext.js";
 export { ArtifactRow } from "./ArtifactRow.js";
 export type { ArtifactRowProps } from "./ArtifactRow.js";
+export { ArtifactRowView } from "./ArtifactRowView.js";
+export type { ArtifactRowViewProps } from "./ArtifactRowView.js";
+export { fromExecutionArtifact, fromArtifact, } from "./artifact-row-item.js";
+export type { ArtifactRowItem } from "./artifact-row-item.js";
+export { ARTIFACT_DOCUMENT_ENTRY_ID } from "./artifact-document.js";
+export { FILE_CHANGE_DOCUMENT_ENTRY_ID, fileChangeTabPath, } from "./file-change-document.js";
+export { AGENT_EXECUTION_DOCUMENT_ENTRY_ID, agentExecutionTabPath, parseAgentExecutionTabPath, } from "./agent-execution-document.js";
 export { ArtifactContentRenderer } from "./ArtifactContentRenderer.js";
 export type { ArtifactContentRendererProps } from "./ArtifactContentRenderer.js";
+export { ArtifactFileContent } from "./ArtifactFileContent.js";
+export type { ArtifactFileContentProps } from "./ArtifactFileContent.js";
 export { ArtifactContentBody } from "./ArtifactContentBody.js";
 export type { ArtifactContentBodyProps } from "./ArtifactContentBody.js";
 export { ArtifactDocument } from "./ArtifactDocument.js";