@stigmer/react 3.0.9-dev.20260616060535 → 3.1.0

package/execution/file-review-status.d.ts

@@ -0,0 +1,127 @@
+import type { CapturedFileChange, FileChangeSet } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/filereview_pb";
+import { FileDecisionAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/**
+ * Why an `"unavailable"` file cannot be reviewed — the honest per-file cause the
+ * runner records on `CapturedFileChange.blocked_reason` (design doc 15).
+ *
+ * - `"secret"` — the path looks like a secret; the bytes were deliberately never
+ *   captured (there is nothing to review, by design).
+ * - `"size"` — the diff was captured but its bodies were dropped to keep the
+ *   persisted status under its size limit.
+ * - `"unknown"` — incomplete for a reason the wire does not name (a defensive
+ *   catch-all; historical rows and future/unmapped causes land here).
+ */
+export type FileBlockReason = "secret" | "size" | "unknown";
+/**
+ * How completely a single captured file change can be reviewed before a decision
+ * is made — the classification that decides whether a file can be kept. A
+ * discriminated union so every consumer handles each case exhaustively and reads
+ * the block reason from one place (no "classify, then separately look up why").
+ *
+ * - `{ kind: "reviewable" }` — the full before/after diff is available; the
+ *   reviewer can see exactly what changed and Keep or Discard it.
+ * - `{ kind: "binary" }` — a binary file changed; there is no text diff to
+ *   review (the bytes are captured and flagged, but a byte diff is not
+ *   human-reviewable). Binary is proven by `FileContent.is_binary`, not by the
+ *   block reason.
+ * - `{ kind: "unavailable"; reason }` — the diff is not available to review at
+ *   all, with the honest {@link FileBlockReason} the runner recorded.
+ *
+ * Both `"binary"` and `"unavailable"` are non-reviewable: the file cannot be
+ * approved (kept), only discarded. This mirrors the server, which blocks
+ * approval of any change set that is not fully complete.
+ */
+export type FileReviewability = {
+    readonly kind: "reviewable";
+} | {
+    readonly kind: "binary";
+} | {
+    readonly kind: "unavailable";
+    readonly reason: FileBlockReason;
+};
+/**
+ * Classify a {@link CapturedFileChange} by how completely it can be reviewed,
+ * from the signals the runner authors onto the change (see the file-review
+ * producer in the runner's `shared/filereview`).
+ *
+ * The mapping is derived from three proto signals, in order:
+ *
+ * 1. `diff_complete === true` → `"reviewable"`. The change set can only be
+ *    `COMPLETE` when every file is complete, so a complete file is always
+ *    reviewable.
+ * 2. otherwise, a binary side (`before.is_binary` or `after.is_binary`) →
+ *    `"binary"`. The runner marks a git-tracked file incomplete precisely
+ *    because a side is binary (`diff_complete = !binary`); a CAS file carries
+ *    `is_binary` on its blob ref. `is_binary` is preserved when a large body is
+ *    offloaded from an inline value to a storage ref, so this holds regardless
+ *    of offload. Binary is therefore derived here, never duplicated onto the
+ *    block reason (doc 15).
+ * 3. otherwise → `"unavailable"` with the honest cause from
+ *    `blocked_reason`: `SECRET_WITHHELD → "secret"`, `SIZE_ELIDED → "size"`,
+ *    else `"unknown"`. Before doc 15 this bucket was cause-agnostic (the wire
+ *    could not prove secret-withheld vs size-dropped); the runner now records
+ *    the cause at capture time, so the UI can say *why* rather than only *that*
+ *    the diff is unavailable.
+ */
+export declare function fileReviewability(change: CapturedFileChange): FileReviewability;
+/**
+ * How completely a whole {@link FileChangeSet} can be reviewed — the set-level
+ * sibling of {@link FileReviewability} that decides whether the set can be kept
+ * in one action. Drives the card's bulk affordance and keeps headless builders
+ * on the same classification.
+ *
+ * - `"complete"` — every file is reviewable; the set can be approved as-is.
+ * - `"binary-only"` — the set's ONLY blocker is binary files (every non-binary
+ *   file is fully reviewable). No text diff for the binaries, but their exact
+ *   bytes are captured and reconcilable, so the whole set can be KEPT in one
+ *   acknowledged action ("Keep all"). Includes mixed sets (text edits + images).
+ * - `"blocked"` — at least one file is unavailable to review with no keepable
+ *   bytes (secret-withheld / size-elided / uncapturable), so the set cannot be
+ *   approved at once; it must be resolved per file.
+ */
+export type ChangeSetReviewability = "complete" | "binary-only" | "blocked";
+/**
+ * Classify a {@link FileChangeSet} from its server-derived `diff_completeness`
+ * rollup (the field exists precisely so clients need not re-fold the per-file
+ * signals). The runner and the size backstop both derive that value from the
+ * same rule the backend gate re-checks, so this classification, the per-file
+ * {@link fileReviewability} fold, and the server gate agree by construction.
+ */
+export declare function changeSetReviewability(set: FileChangeSet): ChangeSetReviewability;
+/**
+ * Each file's EFFECTIVE verdict for a settled set, folding the decisions the
+ * way the runner reconcile does (most-specific-wins): the last CHANGE_SET
+ * decision is the baseline for every file, and a later-or-earlier FILE decision
+ * overrides it for that file (FILE > CHANGE_SET regardless of ledger order;
+ * within a scope, last write wins).
+ *
+ * This is the fold for DISPLAYING history — a set decided via "Keep all"
+ * correctly reads every file as kept. The interactive per-file selected state
+ * deliberately uses the FILE-only fold instead (a CHANGE_SET decision cannot
+ * coexist with an open review, so it never pre-selects anything there).
+ */
+export declare function deriveEffectiveVerdicts(set: FileChangeSet): ReadonlyMap<string, FileDecisionAction>;
+/**
+ * The captured change a transcript row's file path refers to, or `null`. The
+ * row's path may be absolute (harness tool args) while captured paths are
+ * workspace-root-relative, so the match accepts an exact match or a
+ * `/`-boundary suffix. Presentation-only — never a correlation key.
+ */
+export declare function changeForRowPath(set: FileChangeSet, rowPath: string): CapturedFileChange | null;
+/**
+ * The review state a stamped transcript row should badge — how this file edit
+ * stands in its change set's review lifecycle. `null` means "show no badge",
+ * chosen over guessing: a missing set (not yet projected), a CAPTURING set, or
+ * a row whose file is absent from the set (its edit was superseded or fully
+ * reverted within the turn) renders unbadged, never mislabeled.
+ *
+ * - `"pending"` — the set is AWAITING_REVIEW; this edit's net result is on the
+ *   decision surface now.
+ * - `"kept"` / `"discarded"` — the set is decided/reconciled and this file's
+ *   effective verdict is known ({@link deriveEffectiveVerdicts}).
+ * - `"failed"` — the set's reconcile failed; the workspace outcome for this
+ *   edit is not the reviewed one.
+ */
+export type FileReviewRowState = "pending" | "kept" | "discarded" | "failed";
+export declare function fileReviewRowState(set: FileChangeSet | undefined, rowPath: string | null): FileReviewRowState | null;
+//# sourceMappingURL=file-review-status.d.ts.map

package/execution/file-review-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-review-status.d.ts","sourceRoot":"","sources":["../../src/execution/file-review-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EAEd,MAAM,oEAAoE,CAAC;AAC5E,OAAO,EAGL,kBAAkB,EAGnB,MAAM,8DAA8D,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CAI/E;AAcD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAE5E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,sBAAsB,CASjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,aAAa,GACjB,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAezC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,GACd,kBAAkB,GAAG,IAAI,CAU3B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7E,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,kBAAkB,GAAG,IAAI,CAoB3B"}

package/execution/file-review-status.js

@@ -0,0 +1,135 @@
+import { DiffCompleteness, FileChangeSetStatus, FileDecisionAction, FileDecisionScope, FileReviewBlockReason, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/**
+ * Classify a {@link CapturedFileChange} by how completely it can be reviewed,
+ * from the signals the runner authors onto the change (see the file-review
+ * producer in the runner's `shared/filereview`).
+ *
+ * The mapping is derived from three proto signals, in order:
+ *
+ * 1. `diff_complete === true` → `"reviewable"`. The change set can only be
+ *    `COMPLETE` when every file is complete, so a complete file is always
+ *    reviewable.
+ * 2. otherwise, a binary side (`before.is_binary` or `after.is_binary`) →
+ *    `"binary"`. The runner marks a git-tracked file incomplete precisely
+ *    because a side is binary (`diff_complete = !binary`); a CAS file carries
+ *    `is_binary` on its blob ref. `is_binary` is preserved when a large body is
+ *    offloaded from an inline value to a storage ref, so this holds regardless
+ *    of offload. Binary is therefore derived here, never duplicated onto the
+ *    block reason (doc 15).
+ * 3. otherwise → `"unavailable"` with the honest cause from
+ *    `blocked_reason`: `SECRET_WITHHELD → "secret"`, `SIZE_ELIDED → "size"`,
+ *    else `"unknown"`. Before doc 15 this bucket was cause-agnostic (the wire
+ *    could not prove secret-withheld vs size-dropped); the runner now records
+ *    the cause at capture time, so the UI can say *why* rather than only *that*
+ *    the diff is unavailable.
+ */
+export function fileReviewability(change) {
+    if (change.diffComplete)
+        return { kind: "reviewable" };
+    if (change.before?.isBinary || change.after?.isBinary)
+        return { kind: "binary" };
+    return { kind: "unavailable", reason: blockReasonOf(change.blockedReason) };
+}
+/** Map the proto {@link FileReviewBlockReason} to the UI {@link FileBlockReason}. */
+function blockReasonOf(reason) {
+    switch (reason) {
+        case FileReviewBlockReason.SECRET_WITHHELD:
+            return "secret";
+        case FileReviewBlockReason.SIZE_ELIDED:
+            return "size";
+        default:
+            return "unknown";
+    }
+}
+/**
+ * Classify a {@link FileChangeSet} from its server-derived `diff_completeness`
+ * rollup (the field exists precisely so clients need not re-fold the per-file
+ * signals). The runner and the size backstop both derive that value from the
+ * same rule the backend gate re-checks, so this classification, the per-file
+ * {@link fileReviewability} fold, and the server gate agree by construction.
+ */
+export function changeSetReviewability(set) {
+    switch (set.diffCompleteness) {
+        case DiffCompleteness.COMPLETE:
+            return "complete";
+        case DiffCompleteness.BINARY_SUMMARY_ONLY:
+            return "binary-only";
+        default:
+            return "blocked";
+    }
+}
+/**
+ * Each file's EFFECTIVE verdict for a settled set, folding the decisions the
+ * way the runner reconcile does (most-specific-wins): the last CHANGE_SET
+ * decision is the baseline for every file, and a later-or-earlier FILE decision
+ * overrides it for that file (FILE > CHANGE_SET regardless of ledger order;
+ * within a scope, last write wins).
+ *
+ * This is the fold for DISPLAYING history — a set decided via "Keep all"
+ * correctly reads every file as kept. The interactive per-file selected state
+ * deliberately uses the FILE-only fold instead (a CHANGE_SET decision cannot
+ * coexist with an open review, so it never pre-selects anything there).
+ */
+export function deriveEffectiveVerdicts(set) {
+    let bulk = null;
+    const byFileId = new Map();
+    for (const d of set.decisions) {
+        if (d.scope === FileDecisionScope.CHANGE_SET)
+            bulk = d.action;
+        else if (d.scope === FileDecisionScope.FILE && d.fileChangeId) {
+            byFileId.set(d.fileChangeId, d.action);
+        }
+    }
+    const effective = new Map();
+    for (const c of set.changes) {
+        const verdict = byFileId.get(c.id) ?? bulk;
+        if (verdict != null)
+            effective.set(c.id, verdict);
+    }
+    return effective;
+}
+/**
+ * The captured change a transcript row's file path refers to, or `null`. The
+ * row's path may be absolute (harness tool args) while captured paths are
+ * workspace-root-relative, so the match accepts an exact match or a
+ * `/`-boundary suffix. Presentation-only — never a correlation key.
+ */
+export function changeForRowPath(set, rowPath) {
+    if (!rowPath)
+        return null;
+    const normalized = rowPath.replace(/\\/g, "/");
+    for (const c of set.changes) {
+        const path = c.pathAfter || c.pathBefore;
+        if (path && (normalized === path || normalized.endsWith(`/${path}`))) {
+            return c;
+        }
+    }
+    return null;
+}
+export function fileReviewRowState(set, rowPath) {
+    if (!set)
+        return null;
+    switch (set.status) {
+        case FileChangeSetStatus.AWAITING_REVIEW:
+            return "pending";
+        case FileChangeSetStatus.FAILED:
+            return "failed";
+        case FileChangeSetStatus.DECIDED:
+        case FileChangeSetStatus.RECONCILED: {
+            if (!rowPath)
+                return null;
+            const change = changeForRowPath(set, rowPath);
+            if (!change)
+                return null;
+            const verdict = deriveEffectiveVerdicts(set).get(change.id);
+            if (verdict === FileDecisionAction.APPROVE)
+                return "kept";
+            if (verdict === FileDecisionAction.REJECT)
+                return "discarded";
+            return null;
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=file-review-status.js.map

package/execution/file-review-status.js.map

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

package/execution/index.d.ts

@@ -23,11 +23,23 @@ export { useExecutionArtifacts } from "./useExecutionArtifacts";
 export type { UseExecutionArtifactsReturn } from "./useExecutionArtifacts";
 export { useArtifactContent } from "./useArtifactContent";
 export type { UseArtifactContentReturn } from "./useArtifactContent";
+export { useArtifactDownloadUrl } from "./useArtifactDownloadUrl";
+export type { UseArtifactDownloadUrlReturn, UseArtifactDownloadUrlOptions, } from "./useArtifactDownloadUrl";
+export { useArtifactDownload } from "./useArtifactDownload";
+export type { UseArtifactDownloadReturn } from "./useArtifactDownload";
+export { useToolOutputContent } from "./useToolOutputContent";
+export type { UseToolOutputContentReturn, ToolOutputRefLike, } from "./useToolOutputContent";
+export { useFileChangeContent, execIdFromStorageKey } from "./useFileChangeContent";
+export type { UseFileChangeContentReturn } from "./useFileChangeContent";
 export { useWorkspaceWriteBacks } from "./useWorkspaceWriteBacks";
 export type { UseWorkspaceWriteBacksReturn } from "./useWorkspaceWriteBacks";
 export { WriteBackCard } from "./WriteBackCard";
 export type { WriteBackCardProps } from "./WriteBackCard";
-export { isTextArtifact, isArtifactExpired, formatArtifactSize, getArtifactExtension, getFileExtension, getArtifactRenderMode, } from "./artifact-utils";
+export { FileChangesView, FileChangeDiff } from "./FileChangesView";
+export type { FileChangesViewProps, FileChangeDiffProps } from "./FileChangesView";
+export { EmptyChangeNotice } from "./EmptyChangeNotice";
+export type { EmptyChangeNoticeProps, EmptyChangeKind } from "./EmptyChangeNotice";
+export { isTextArtifact, formatArtifactSize, getArtifactExtension, getFileExtension, getArtifactRenderMode, } from "./artifact-utils";
 export type { ArtifactRenderMode } from "./artifact-utils";
 export { ExecutionPhaseBadge } from "./ExecutionPhaseBadge";
 export type { ExecutionPhaseBadgeProps } from "./ExecutionPhaseBadge";
@@ -37,14 +49,21 @@ export { SetupProgress } from "./SetupProgress";
 export type { SetupProgressProps } from "./SetupProgress";
 export { ToolCallGroup } from "./ToolCallGroup";
 export type { ToolCallGroupProps } from "./ToolCallGroup";
+export { ToolRunGroup } from "./ToolRunGroup";
+export type { ToolRunGroupProps } from "./ToolRunGroup";
+export { segmentToolCalls } from "./segment-tool-calls";
+export type { ToolSegment } from "./segment-tool-calls";
 export { ToolCallDetail, formatDuration } from "./ToolCallDetail";
 export type { ToolCallDetailProps } from "./ToolCallDetail";
+export { describeApprovalPolicySource } from "./approval-provenance";
 export { McpToolDetail, McpArgsView, McpMetadataRow, parseMcpResult } from "./McpToolDetail";
 export type { McpToolDetailProps, McpArgsViewProps, McpMetadataRowProps, } from "./McpToolDetail";
 export { ToolArgsView } from "./ToolArgsView";
 export type { ToolArgsViewProps } from "./ToolArgsView";
 export { ResultView, summarizeResultView } from "./ResultView";
 export type { ResultViewProps } from "./ResultView";
+export { TerminalSession } from "./TerminalSession";
+export type { TerminalSessionProps } from "./TerminalSession";
 export { useToolPresentation, registerToolPresenter, getToolPresenter, } from "./tool-presenter";
 export type { ToolPresentation, ToolPresenter } from "./tool-presenter";
 export { CollapsibleCode, CollapsiblePre, CollapsibleJsonBlock, FilePathIcon, McpServerIcon, TRUNCATION_LINE_LIMIT, formatJson, formatResult, isScalar, humanizeArgKey, } from "./tool-rendering-primitives";
@@ -65,10 +84,25 @@ export { ExecutionProgress } from "./ExecutionProgress";
 export type { ExecutionProgressProps } from "./ExecutionProgress";
 export { TodoList, TodoInProgressIcon, findActiveTodo, todoCompletionSummary, } from "./TodoList";
 export type { TodoListProps } from "./TodoList";
+export { TodoCard } from "./TodoCard";
+export type { TodoCardProps } from "./TodoCard";
 export { useSubmitApproval } from "./useSubmitApproval";
 export type { UseSubmitApprovalReturn } from "./useSubmitApproval";
-export { ApprovalCard } from "./ApprovalCard";
-export type { ApprovalCardProps } from "./ApprovalCard";
+export { useFileReview, fileDecisionKey } from "./useFileReview";
+export type { UseFileReviewReturn, FileDecisionOptions } from "./useFileReview";
+export { fileReviewability, changeSetReviewability, deriveEffectiveVerdicts, changeForRowPath, fileReviewRowState, } from "./file-review-status";
+export type { FileReviewability, FileBlockReason, ChangeSetReviewability, FileReviewRowState, } from "./file-review-status";
+export { foldFileReviewEventStream, displayFileChangeSets, toDisplayFileChange, } from "@stigmer/sdk";
+export { ApprovalCard, ApprovalCardHeader, ApprovalCardBody } from "./ApprovalCard";
+export type { ApprovalCardProps, ApprovalCardHeaderProps, ApprovalCardBodyProps, } from "./ApprovalCard";
+export { FileReviewCard } from "./FileReviewCard";
+export type { FileReviewCardProps } from "./FileReviewCard";
+export { FileReviewDock } from "./FileReviewDock";
+export type { FileReviewDockProps } from "./FileReviewDock";
+export { ApprovalContext, useApproval } from "./ApprovalContext";
+export type { ApprovalContextValue, UseApprovalResult } from "./ApprovalContext";
+export { FileReviewContext, useFileReviewRowState } from "./FileReviewContext";
+export type { FileReviewContextValue } from "./FileReviewContext";
 export { ArtifactCard } from "./ArtifactCard";
 export type { ArtifactCardProps } from "./ArtifactCard";
 export { ArtifactContentRenderer } from "./ArtifactContentRenderer";
@@ -79,8 +113,8 @@ export { ArtifactsWidget } from "./ArtifactsWidget";
 export type { ArtifactsWidgetProps } from "./ArtifactsWidget";
 export { WriteBacksWidget } from "./WriteBacksWidget";
 export type { WriteBacksWidgetProps } from "./WriteBacksWidget";
-export { resolveToolCategory, resolveToolCategoryFromCall, resolveToolCategoryFromKind, toolKindToCategoryInfo, extractPrimaryArg, extractPrimaryArgFromPreview, humanizeToolName, } from "./tool-categories";
-export type { ToolCategory, ToolCategoryInfo } from "./tool-categories";
+export { resolveToolCategory, resolveToolCategoryFromCall, resolveToolCategoryFromKind, toolKindToCategoryInfo, extractPrimaryArg, extractPrimaryArgFromPreview, humanizeToolName, defaultDisclosureForCategory, isRunGroupableCategory, } from "./tool-categories";
+export type { ToolCategory, ToolCategoryInfo, ToolDisclosure } from "./tool-categories";
 export { FilePathLink } from "./FilePathLink";
 export type { FilePathLinkProps } from "./FilePathLink";
 export { FilePathContext } from "./FilePathContext";

package/execution/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7F,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAExE,OAAO,EACL,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACtF,YAAY,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAErG,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,iBAAiB,EACjB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"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"}

package/execution/index.js

@@ -11,17 +11,27 @@ export { PlanCompletionCard } from "./PlanCompletionCard";
 export { PlanArtifactCard } from "./PlanArtifactCard";
 export { useExecutionArtifacts } from "./useExecutionArtifacts";
 export { useArtifactContent } from "./useArtifactContent";
+export { useArtifactDownloadUrl } from "./useArtifactDownloadUrl";
+export { useArtifactDownload } from "./useArtifactDownload";
+export { useToolOutputContent } from "./useToolOutputContent";
+export { useFileChangeContent, execIdFromStorageKey } from "./useFileChangeContent";
 export { useWorkspaceWriteBacks } from "./useWorkspaceWriteBacks";
 export { WriteBackCard } from "./WriteBackCard";
-export { isTextArtifact, isArtifactExpired, formatArtifactSize, getArtifactExtension, getFileExtension, getArtifactRenderMode, } from "./artifact-utils";
+export { FileChangesView, FileChangeDiff } from "./FileChangesView";
+export { EmptyChangeNotice } from "./EmptyChangeNotice";
+export { isTextArtifact, formatArtifactSize, getArtifactExtension, getFileExtension, getArtifactRenderMode, } from "./artifact-utils";
 export { ExecutionPhaseBadge } from "./ExecutionPhaseBadge";
 export { InteractionModeBadge } from "./InteractionModeBadge";
 export { SetupProgress } from "./SetupProgress";
 export { ToolCallGroup } from "./ToolCallGroup";
+export { ToolRunGroup } from "./ToolRunGroup";
+export { segmentToolCalls } from "./segment-tool-calls";
 export { ToolCallDetail, formatDuration } from "./ToolCallDetail";
+export { describeApprovalPolicySource } from "./approval-provenance";
 export { McpToolDetail, McpArgsView, McpMetadataRow, parseMcpResult } from "./McpToolDetail";
 export { ToolArgsView } from "./ToolArgsView";
 export { ResultView, summarizeResultView } from "./ResultView";
+export { TerminalSession } from "./TerminalSession";
 export { useToolPresentation, registerToolPresenter, getToolPresenter, } from "./tool-presenter";
 export { CollapsibleCode, CollapsiblePre, CollapsibleJsonBlock, FilePathIcon, McpServerIcon, TRUNCATION_LINE_LIMIT, formatJson, formatResult, isScalar, humanizeArgKey, } from "./tool-rendering-primitives";
 export { ToolCallItem } from "./ToolCallItem";
@@ -32,14 +42,24 @@ export { ThreadSkeleton } from "./ThreadSkeleton";
 export { FollowUpInput } from "./FollowUpInput";
 export { ExecutionProgress } from "./ExecutionProgress";
 export { TodoList, TodoInProgressIcon, findActiveTodo, todoCompletionSummary, } from "./TodoList";
+export { TodoCard } from "./TodoCard";
 export { useSubmitApproval } from "./useSubmitApproval";
-export { ApprovalCard } from "./ApprovalCard";
+export { useFileReview, fileDecisionKey } from "./useFileReview";
+export { fileReviewability, changeSetReviewability, deriveEffectiveVerdicts, changeForRowPath, fileReviewRowState, } from "./file-review-status";
+// Settled/historical file-review display: the ledger fold + its read seam +
+// the display-projection adapter, re-exported from @stigmer/sdk (pure, shared).
+export { foldFileReviewEventStream, displayFileChangeSets, toDisplayFileChange, } from "@stigmer/sdk";
+export { ApprovalCard, ApprovalCardHeader, ApprovalCardBody } from "./ApprovalCard";
+export { FileReviewCard } from "./FileReviewCard";
+export { FileReviewDock } from "./FileReviewDock";
+export { ApprovalContext, useApproval } from "./ApprovalContext";
+export { FileReviewContext, useFileReviewRowState } from "./FileReviewContext";
 export { ArtifactCard } from "./ArtifactCard";
 export { ArtifactContentRenderer } from "./ArtifactContentRenderer";
 export { ArtifactPreviewContent, ArtifactPreviewModal } from "./ArtifactPreviewModal";
 export { ArtifactsWidget } from "./ArtifactsWidget";
 export { WriteBacksWidget } from "./WriteBacksWidget";
-export { resolveToolCategory, resolveToolCategoryFromCall, resolveToolCategoryFromKind, toolKindToCategoryInfo, extractPrimaryArg, extractPrimaryArgFromPreview, humanizeToolName, } from "./tool-categories";
+export { resolveToolCategory, resolveToolCategoryFromCall, resolveToolCategoryFromKind, toolKindToCategoryInfo, extractPrimaryArg, extractPrimaryArgFromPreview, humanizeToolName, defaultDisclosureForCategory, isRunGroupableCategory, } from "./tool-categories";
 export { FilePathLink } from "./FilePathLink";
 export { FilePathContext } from "./FilePathContext";
 export { normalizeSandboxPaths } from "./sandbox-path-normalizer";

package/execution/index.js.map

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

package/execution/segment-tool-calls.d.ts

@@ -0,0 +1,46 @@
+import type { ToolCall } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import type { ToolCategory } from "./tool-categories";
+/**
+ * One renderable unit of a turn's tool activity.
+ *
+ * - `row` — a single tool call rendered as a persistent timeline row.
+ * - `run` — a maximal run of >= {@link MIN_RUN_LENGTH} consecutive low-signal
+ *   same-category calls (e.g. reads), folded into one collapsible chip.
+ */
+export type ToolSegment = {
+    readonly kind: "row";
+    readonly toolCall: ToolCall;
+    readonly key: string;
+} | {
+    readonly kind: "run";
+    readonly category: ToolCategory;
+    readonly toolCalls: readonly ToolCall[];
+    readonly key: string;
+};
+/**
+ * Partitions a turn's tool calls into a chronological sequence of {@link
+ * ToolSegment}s: maximal runs of consecutive low-signal same-category calls
+ * (read / list / search) fold into one `run` chip, while every other call —
+ * and any groupable call that has no same-kind neighbour — stays a persistent
+ * `row`.
+ *
+ * This is the layout pass behind the "persistent-row timeline": instead of
+ * hiding a whole turn behind one collapse, only repetitive noise is compressed,
+ * and high-signal rows (edits, shell, MCP, sub-agents) always remain visible.
+ * Chronology is preserved — a run never reorders calls, and an interleaving of
+ * categories (read, search, read) yields three separate segments, not one.
+ *
+ * Pure and dependency-light so it can be unit-tested exhaustively and memoized
+ * by the caller; groupability is resolved through {@link resolveRunGroupable},
+ * so a consumer's registry override is honoured here exactly as in the
+ * component layer.
+ *
+ * @example
+ * ```ts
+ * // read, read, read, edit  ->  [run(read x3), row(edit)]
+ * // read, search, read      ->  [row(read), row(search), row(read)]
+ * const segments = segmentToolCalls(message.toolCalls);
+ * ```
+ */
+export declare function segmentToolCalls(toolCalls: readonly ToolCall[]): ToolSegment[];
+//# sourceMappingURL=segment-tool-calls.d.ts.map

package/execution/segment-tool-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-tool-calls.d.ts","sourceRoot":"","sources":["../../src/execution/segment-tool-calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iEAAiE,CAAC;AAEhG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWtD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3E;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAON;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,WAAW,EAAE,CAuCf"}

package/execution/segment-tool-calls.js

@@ -0,0 +1,71 @@
+import { resolveToolCategoryFromCall } from "./tool-categories";
+import { resolveRunGroupable } from "./tool-presenter";
+/**
+ * Minimum number of consecutive same-category groupable calls before they fold
+ * into a chip. A lone groupable call (e.g. a single `Read foo.ts`) reads better
+ * as its own row than as a one-item "Read 1 file" chip, so grouping only kicks
+ * in at two or more.
+ */
+const MIN_RUN_LENGTH = 2;
+/** Stable key for a single tool-call row (mirrors the prior group keying). */
+function rowKey(toolCall) {
+    return toolCall.id || toolCall.name;
+}
+/**
+ * Partitions a turn's tool calls into a chronological sequence of {@link
+ * ToolSegment}s: maximal runs of consecutive low-signal same-category calls
+ * (read / list / search) fold into one `run` chip, while every other call —
+ * and any groupable call that has no same-kind neighbour — stays a persistent
+ * `row`.
+ *
+ * This is the layout pass behind the "persistent-row timeline": instead of
+ * hiding a whole turn behind one collapse, only repetitive noise is compressed,
+ * and high-signal rows (edits, shell, MCP, sub-agents) always remain visible.
+ * Chronology is preserved — a run never reorders calls, and an interleaving of
+ * categories (read, search, read) yields three separate segments, not one.
+ *
+ * Pure and dependency-light so it can be unit-tested exhaustively and memoized
+ * by the caller; groupability is resolved through {@link resolveRunGroupable},
+ * so a consumer's registry override is honoured here exactly as in the
+ * component layer.
+ *
+ * @example
+ * ```ts
+ * // read, read, read, edit  ->  [run(read x3), row(edit)]
+ * // read, search, read      ->  [row(read), row(search), row(read)]
+ * const segments = segmentToolCalls(message.toolCalls);
+ * ```
+ */
+export function segmentToolCalls(toolCalls) {
+    const segments = [];
+    // Resolve category + groupability once per call so the scan below is a cheap
+    // index walk rather than repeated kind resolution.
+    const categories = toolCalls.map((tc) => resolveToolCategoryFromCall(tc).category);
+    const groupable = toolCalls.map((tc) => resolveRunGroupable(tc));
+    let i = 0;
+    while (i < toolCalls.length) {
+        const category = categories[i];
+        if (groupable[i]) {
+            // Extend the run while the next call is the same groupable category.
+            let j = i + 1;
+            while (j < toolCalls.length && groupable[j] && categories[j] === category) {
+                j++;
+            }
+            if (j - i >= MIN_RUN_LENGTH) {
+                const run = toolCalls.slice(i, j);
+                segments.push({
+                    kind: "run",
+                    category,
+                    toolCalls: run,
+                    key: `run-${category}-${rowKey(run[0])}`,
+                });
+                i = j;
+                continue;
+            }
+        }
+        segments.push({ kind: "row", toolCall: toolCalls[i], key: rowKey(toolCalls[i]) });
+        i++;
+    }
+    return segments;
+}
+//# sourceMappingURL=segment-tool-calls.js.map

package/execution/segment-tool-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-tool-calls.js","sourceRoot":"","sources":["../../src/execution/segment-tool-calls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,cAAc,GAAG,CAAC,CAAC;AAkBzB,8EAA8E;AAC9E,SAAS,MAAM,CAAC,QAAkB;IAChC,OAAO,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAA8B;IAE9B,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,6EAA6E;IAC7E,mDAAmD;IACnD,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAC9B,CAAC,EAAE,EAAE,EAAE,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC,QAAQ,CACjD,CAAC;IACF,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC;IAEjE,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAE/B,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,qEAAqE;YACrE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC1E,CAAC,EAAE,CAAC;YACN,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,IAAI,cAAc,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,KAAK;oBACX,QAAQ;oBACR,SAAS,EAAE,GAAG;oBACd,GAAG,EAAE,OAAO,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;iBACzC,CAAC,CAAC;gBACH,CAAC,GAAG,CAAC,CAAC;gBACN,SAAS;YACX,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC,EAAE,CAAC;IACN,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}