@stigmer/ink 3.1.1 → 3.1.2

package/index.d.ts

@@ -8,6 +8,9 @@ export { ToolCallGroup, type ToolCallGroupProps } from "./components/ToolCallGro
 export { SubAgentBlock, type SubAgentBlockProps } from "./components/SubAgentBlock.js";
 export { TodoList, type TodoListProps } from "./components/TodoList.js";
 export { ApprovalPrompt, type ApprovalPromptProps } from "./components/ApprovalPrompt.js";
+export { FileReviewPrompt, type FileReviewPromptProps } from "./components/FileReviewPrompt.js";
+export { FileReviewRecord, type FileReviewRecordProps } from "./components/FileReviewRecord.js";
+export { kindLetter, changeDisplayPath, blockReasonNote, settledCounts, settledSummary, type SettledCounts, } from "./file-review.js";
 export { ExecutionProgress, type ExecutionProgressProps } from "./components/ExecutionProgress.js";
 export { FollowUpInput, type FollowUpInputProps } from "./components/FollowUpInput.js";
 export { UsageWidget, type UsageWidgetProps } from "./components/UsageWidget.js";

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGpF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGhG,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,cAAc,EACd,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGpF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/index.js

@@ -12,6 +12,10 @@ export { ToolCallGroup } from "./components/ToolCallGroup.js";
 export { SubAgentBlock } from "./components/SubAgentBlock.js";
 export { TodoList } from "./components/TodoList.js";
 export { ApprovalPrompt } from "./components/ApprovalPrompt.js";
+export { FileReviewPrompt } from "./components/FileReviewPrompt.js";
+export { FileReviewRecord } from "./components/FileReviewRecord.js";
+// File-review pure helpers (kind letters, paths, block reasons, settled counts)
+export { kindLetter, changeDisplayPath, blockReasonNote, settledCounts, settledSummary, } from "./file-review.js";
 export { ExecutionProgress } from "./components/ExecutionProgress.js";
 export { FollowUpInput } from "./components/FollowUpInput.js";
 export { UsageWidget } from "./components/UsageWidget.js";

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAgC,MAAM,eAAe,CAAC;AAEjF,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,aAAa;AACb,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAA+B,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AAEpF,0CAA0C;AAC1C,OAAO,EAAE,cAAc,EAA6C,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AAEvF,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAA+C,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAwB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAgC,MAAM,eAAe,CAAC;AAEjF,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC;AAE3B,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,aAAa;AACb,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAA8B,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAA8B,MAAM,kCAAkC,CAAC;AAEhG,gFAAgF;AAChF,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,cAAc,GAEf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAA+B,MAAM,mCAAmC,CAAC;AACnG,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,YAAY,EAA0B,MAAM,8BAA8B,CAAC;AAEpF,0CAA0C;AAC1C,OAAO,EAAE,cAAc,EAA6C,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AAEvF,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAA+C,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,UAAU,EAAwB,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stigmer/ink",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "description": "Ink (React for terminals) components for rendering Stigmer agent sessions in the terminal",
   "license": "Apache-2.0",
   "type": "module",
@@ -35,7 +35,7 @@
   },
   "dependencies": {
     "@connectrpc/connect-node": "^2.1.1",
-    "@stigmer/react": "3.1.1",
+    "@stigmer/react": "3.1.2",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "marked": "^15.0.7",
@@ -43,8 +43,8 @@
   },
   "peerDependencies": {
     "@bufbuild/protobuf": "^2.0.0",
-    "@stigmer/protos": "3.1.1",
-    "@stigmer/sdk": "3.1.1",
+    "@stigmer/protos": "3.1.2",
+    "@stigmer/sdk": "3.1.2",
     "ink": "^7.0.0",
     "react": ">=19.0.0"
   }

package/src/__tests__/file-review.test.tsx

@@ -0,0 +1,496 @@
+import React from "react";
+import { describe, it, expect, vi } from "vitest";
+import { render } from "ink-testing-library";
+import { create } from "@bufbuild/protobuf";
+import { FileReviewContext } from "@stigmer/react";
+import {
+  ToolCallSchema,
+  FileContentSchema,
+  AgentMessageSchema,
+} from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import type { ToolCall } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import {
+  FileChangeSetSchema,
+  CapturedFileChangeSchema,
+  FileDecisionSchema,
+} from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/filereview_pb";
+import type { FileChangeSet } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/filereview_pb";
+import { AgentExecutionSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import {
+  FileChangeKind,
+  FileChangeSetStatus,
+  FileDecisionAction,
+  FileDecisionScope,
+  FileReviewBlockReason,
+  DiffCompleteness,
+  MessageType,
+  ToolCallStatus,
+} from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { ToolCallItem } from "../components/ToolCallItem.js";
+import { ToolCallGroup } from "../components/ToolCallGroup.js";
+import { FileReviewPrompt } from "../components/FileReviewPrompt.js";
+import { FileReviewRecord } from "../components/FileReviewRecord.js";
+import { MessageThread } from "../components/MessageThread.js";
+
+// --- fixtures -------------------------------------------------------------
+
+interface ChangeOpts {
+  readonly id: string;
+  readonly path: string;
+  readonly kind?: FileChangeKind;
+  readonly diffComplete?: boolean;
+  readonly binary?: boolean;
+  readonly blockedReason?: FileReviewBlockReason;
+}
+
+function makeChange(opts: ChangeOpts) {
+  return create(CapturedFileChangeSchema, {
+    id: opts.id,
+    pathAfter: opts.kind === FileChangeKind.DELETE ? "" : opts.path,
+    pathBefore: opts.kind === FileChangeKind.DELETE ? opts.path : "",
+    kind: opts.kind ?? FileChangeKind.MODIFY,
+    diffComplete: opts.diffComplete ?? true,
+    fileDigest: `fd-${opts.id}`,
+    blockedReason: opts.blockedReason ?? FileReviewBlockReason.UNSPECIFIED,
+    before: opts.binary ? create(FileContentSchema, { isBinary: true }) : undefined,
+    after: opts.binary ? create(FileContentSchema, { isBinary: true }) : undefined,
+  });
+}
+
+interface SetOpts {
+  readonly id?: string;
+  readonly status: FileChangeSetStatus;
+  readonly changes: ReturnType<typeof makeChange>[];
+  readonly diffCompleteness?: DiffCompleteness;
+  readonly decisions?: {
+    readonly scope: FileDecisionScope;
+    readonly action: FileDecisionAction;
+    readonly fileChangeId?: string;
+  }[];
+}
+
+function makeSet(opts: SetOpts): FileChangeSet {
+  return create(FileChangeSetSchema, {
+    id: opts.id ?? "cs-1",
+    status: opts.status,
+    changes: opts.changes,
+    aggregateDigest: "agg-1",
+    diffCompleteness: opts.diffCompleteness ?? DiffCompleteness.COMPLETE,
+    decisions: (opts.decisions ?? []).map((d) =>
+      create(FileDecisionSchema, {
+        scope: d.scope,
+        action: d.action,
+        fileChangeId: d.fileChangeId ?? "",
+      }),
+    ),
+  });
+}
+
+function stampedTool(path: string, setId: string): ToolCall {
+  return create(ToolCallSchema, {
+    id: `tc-${path}`,
+    name: "write_file",
+    status: ToolCallStatus.TOOL_CALL_COMPLETED,
+    args: { path },
+    fileChangeSetId: setId,
+  });
+}
+
+function renderRow(toolCall: ToolCall, set: FileChangeSet | null) {
+  const changeSetsById = set ? new Map([[set.id, set]]) : new Map();
+  return render(
+    <FileReviewContext.Provider value={{ changeSetsById }}>
+      <ToolCallItem toolCall={toolCall} />
+    </FileReviewContext.Provider>,
+  );
+}
+
+// --- FileReviewPrompt: bulk ----------------------------------------------
+
+describe("FileReviewPrompt — bulk", () => {
+  const completeSet = makeSet({
+    status: FileChangeSetStatus.AWAITING_REVIEW,
+    diffCompleteness: DiffCompleteness.COMPLETE,
+    changes: [
+      makeChange({ id: "a", path: "one.ts" }),
+      makeChange({ id: "b", path: "two.ts" }),
+    ],
+  });
+
+  it("shows the summary and complete-set bulk actions", () => {
+    const { lastFrame } = render(
+      <FileReviewPrompt changeSet={completeSet} onSubmit={() => {}} />,
+    );
+    const out = lastFrame() ?? "";
+    expect(out).toContain("2 files awaiting review");
+    expect(out).toContain("[a] Approve all");
+    expect(out).toContain("[r] Reject all");
+    expect(out).toContain("[f] Review files");
+  });
+
+  it("approves the whole set with the aggregate digest (no acknowledge)", () => {
+    const onSubmit = vi.fn();
+    const { stdin } = render(
+      <FileReviewPrompt changeSet={completeSet} onSubmit={onSubmit} />,
+    );
+    stdin.write("a");
+    expect(onSubmit).toHaveBeenCalledWith("cs-1", FileDecisionAction.APPROVE, {
+      scope: FileDecisionScope.CHANGE_SET,
+      expectedDigest: "agg-1",
+      acknowledgeUnreviewable: false,
+    });
+  });
+
+  it("rejects the whole set", () => {
+    const onSubmit = vi.fn();
+    const { stdin } = render(
+      <FileReviewPrompt changeSet={completeSet} onSubmit={onSubmit} />,
+    );
+    stdin.write("r");
+    expect(onSubmit).toHaveBeenCalledWith("cs-1", FileDecisionAction.REJECT, {
+      scope: FileDecisionScope.CHANGE_SET,
+      expectedDigest: "agg-1",
+      acknowledgeUnreviewable: false,
+    });
+  });
+
+  it("labels a binary-only set 'Keep all' and acknowledges on keep", () => {
+    const binarySet = makeSet({
+      status: FileChangeSetStatus.AWAITING_REVIEW,
+      diffCompleteness: DiffCompleteness.BINARY_SUMMARY_ONLY,
+      changes: [
+        makeChange({ id: "img", path: "logo.png", kind: FileChangeKind.BINARY_CHANGE, diffComplete: false, binary: true }),
+        makeChange({ id: "txt", path: "readme.md" }),
+      ],
+    });
+    const onSubmit = vi.fn();
+    const { stdin, lastFrame } = render(
+      <FileReviewPrompt changeSet={binarySet} onSubmit={onSubmit} />,
+    );
+    expect(lastFrame() ?? "").toContain("[a] Keep all");
+    stdin.write("a");
+    expect(onSubmit).toHaveBeenCalledWith("cs-1", FileDecisionAction.APPROVE, {
+      scope: FileDecisionScope.CHANGE_SET,
+      expectedDigest: "agg-1",
+      acknowledgeUnreviewable: true,
+    });
+  });
+
+  it("hides bulk keep for a blocked set (no [a]); reject + review only", () => {
+    const blockedSet = makeSet({
+      status: FileChangeSetStatus.AWAITING_REVIEW,
+      diffCompleteness: DiffCompleteness.PARTIAL_BLOCKED,
+      changes: [
+        makeChange({ id: "s", path: ".env", diffComplete: false, blockedReason: FileReviewBlockReason.SECRET_WITHHELD }),
+        makeChange({ id: "ok", path: "app.ts" }),
+      ],
+    });
+    const onSubmit = vi.fn();
+    const { stdin, lastFrame } = render(
+      <FileReviewPrompt changeSet={blockedSet} onSubmit={onSubmit} />,
+    );
+    const out = lastFrame() ?? "";
+    expect(out).not.toContain("[a]");
+    expect(out).toContain("[r] Reject all");
+    expect(out).toContain("[f] Review files");
+    stdin.write("a"); // no bulk-approve option → ignored
+    expect(onSubmit).not.toHaveBeenCalled();
+  });
+});
+
+// --- FileReviewPrompt: per-file ------------------------------------------
+
+/** Let ink/React flush a state transition between keystrokes. */
+const tick = () => new Promise<void>((resolve) => setTimeout(resolve, 20));
+
+describe("FileReviewPrompt — per-file", () => {
+  const blockedSet = makeSet({
+    status: FileChangeSetStatus.AWAITING_REVIEW,
+    diffCompleteness: DiffCompleteness.PARTIAL_BLOCKED,
+    changes: [
+      makeChange({ id: "ok", path: "app.ts" }),
+      makeChange({ id: "s", path: ".env", diffComplete: false, blockedReason: FileReviewBlockReason.SECRET_WITHHELD }),
+    ],
+  });
+
+  it("enters per-file mode and keeps a reviewable file with its file digest", async () => {
+    const onSubmit = vi.fn();
+    const { stdin, lastFrame } = render(
+      <FileReviewPrompt changeSet={blockedSet} onSubmit={onSubmit} />,
+    );
+    stdin.write("f");
+    await tick();
+    const out = lastFrame() ?? "";
+    expect(out).toContain("app.ts");
+    expect(out).toContain(".env");
+    expect(out).toContain("keep"); // hint line
+    stdin.write("k"); // keep the selected (first) file
+    expect(onSubmit).toHaveBeenCalledWith("cs-1", FileDecisionAction.APPROVE, {
+      scope: FileDecisionScope.FILE,
+      fileChangeId: "ok",
+      expectedDigest: "fd-ok",
+      acknowledgeUnreviewable: false,
+    });
+  });
+
+  it("refuses to keep an unavailable file but allows discard", async () => {
+    const onSubmit = vi.fn();
+    const { stdin } = render(
+      <FileReviewPrompt changeSet={blockedSet} onSubmit={onSubmit} />,
+    );
+    stdin.write("f");
+    await tick();
+    stdin.write("\u001B[B"); // down → select the secret file
+    await tick();
+    stdin.write("k"); // keep refused for unavailable
+    expect(onSubmit).not.toHaveBeenCalled();
+    stdin.write("d"); // discard allowed
+    expect(onSubmit).toHaveBeenCalledWith("cs-1", FileDecisionAction.REJECT, {
+      scope: FileDecisionScope.FILE,
+      fileChangeId: "s",
+      expectedDigest: "fd-s",
+      acknowledgeUnreviewable: false,
+    });
+  });
+
+  it("keeps a binary file with an acknowledgement", async () => {
+    const binarySet = makeSet({
+      status: FileChangeSetStatus.AWAITING_REVIEW,
+      diffCompleteness: DiffCompleteness.BINARY_SUMMARY_ONLY,
+      changes: [
+        makeChange({ id: "img", path: "logo.png", kind: FileChangeKind.BINARY_CHANGE, diffComplete: false, binary: true }),
+      ],
+    });
+    const onSubmit = vi.fn();
+    const { stdin } = render(
+      <FileReviewPrompt changeSet={binarySet} onSubmit={onSubmit} />,
+    );
+    stdin.write("f");
+    await tick();
+    stdin.write("k");
+    expect(onSubmit).toHaveBeenCalledWith("cs-1", FileDecisionAction.APPROVE, {
+      scope: FileDecisionScope.FILE,
+      fileChangeId: "img",
+      expectedDigest: "fd-img",
+      acknowledgeUnreviewable: true,
+    });
+  });
+});
+
+// --- FileReviewPrompt: state ---------------------------------------------
+
+describe("FileReviewPrompt — state", () => {
+  const set = makeSet({
+    status: FileChangeSetStatus.AWAITING_REVIEW,
+    changes: [makeChange({ id: "a", path: "one.ts" })],
+  });
+
+  it("shows submitting and ignores input while a decision is in flight", () => {
+    const onSubmit = vi.fn();
+    const { stdin, lastFrame } = render(
+      <FileReviewPrompt
+        changeSet={set}
+        onSubmit={onSubmit}
+        submittingDecisionKeys={new Set(["cs-1"])}
+      />,
+    );
+    expect(lastFrame() ?? "").toContain("Submitting");
+    stdin.write("a");
+    expect(onSubmit).not.toHaveBeenCalled();
+  });
+
+  it("renders a decision error", () => {
+    const { lastFrame } = render(
+      <FileReviewPrompt
+        changeSet={set}
+        onSubmit={() => {}}
+        decisionErrors={new Map([["cs-1", new Error("digest mismatch")]])}
+      />,
+    );
+    expect(lastFrame() ?? "").toContain("digest mismatch");
+  });
+
+  it("is inert and hints when isActive is false", () => {
+    const onSubmit = vi.fn();
+    const { stdin, lastFrame } = render(
+      <FileReviewPrompt changeSet={set} onSubmit={onSubmit} isActive={false} />,
+    );
+    stdin.write("a");
+    expect(onSubmit).not.toHaveBeenCalled();
+    expect(lastFrame() ?? "").toContain("Resolve the pending approval first");
+  });
+});
+
+// --- Row badges -----------------------------------------------------------
+
+describe("ToolCallItem — file-review badge", () => {
+  it("badges a pending set as 'Pending review'", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.AWAITING_REVIEW,
+      changes: [makeChange({ id: "a", path: "notes.md" })],
+    });
+    const { lastFrame } = renderRow(stampedTool("notes.md", "cs-1"), set);
+    expect(lastFrame() ?? "").toContain("Pending review");
+  });
+
+  it("badges a kept file as 'Kept' and a discarded one as 'Discarded'", () => {
+    const kept = makeSet({
+      status: FileChangeSetStatus.RECONCILED,
+      changes: [makeChange({ id: "a", path: "notes.md" })],
+      decisions: [{ scope: FileDecisionScope.FILE, action: FileDecisionAction.APPROVE, fileChangeId: "a" }],
+    });
+    expect(renderRow(stampedTool("notes.md", "cs-1"), kept).lastFrame() ?? "").toContain("Kept");
+
+    const discarded = makeSet({
+      status: FileChangeSetStatus.RECONCILED,
+      changes: [makeChange({ id: "a", path: "notes.md" })],
+      decisions: [{ scope: FileDecisionScope.FILE, action: FileDecisionAction.REJECT, fileChangeId: "a" }],
+    });
+    expect(renderRow(stampedTool("notes.md", "cs-1"), discarded).lastFrame() ?? "").toContain("Discarded");
+  });
+
+  it("badges a failed set as 'Review failed'", () => {
+    const failed = makeSet({
+      status: FileChangeSetStatus.FAILED,
+      changes: [makeChange({ id: "a", path: "notes.md" })],
+    });
+    expect(renderRow(stampedTool("notes.md", "cs-1"), failed).lastFrame() ?? "").toContain("Review failed");
+  });
+
+  it("shows no badge for an unstamped row", () => {
+    const tc = create(ToolCallSchema, {
+      id: "tc-1",
+      name: "write_file",
+      status: ToolCallStatus.TOOL_CALL_COMPLETED,
+      args: { path: "notes.md" },
+    });
+    const out = renderRow(tc, null).lastFrame() ?? "";
+    expect(out).not.toContain("Pending review");
+    expect(out).not.toContain("Kept");
+  });
+
+  it("shows no badge when the set is still CAPTURING", () => {
+    const capturing = makeSet({
+      status: FileChangeSetStatus.CAPTURING,
+      changes: [makeChange({ id: "a", path: "notes.md" })],
+    });
+    const out = renderRow(stampedTool("notes.md", "cs-1"), capturing).lastFrame() ?? "";
+    expect(out).not.toContain("Pending review");
+    expect(out).not.toContain("Kept");
+  });
+
+  it("shows no badge when the stamped path is absent from the set", () => {
+    const decided = makeSet({
+      status: FileChangeSetStatus.RECONCILED,
+      changes: [makeChange({ id: "a", path: "other.md" })],
+      decisions: [{ scope: FileDecisionScope.CHANGE_SET, action: FileDecisionAction.APPROVE }],
+    });
+    const out = renderRow(stampedTool("notes.md", "cs-1"), decided).lastFrame() ?? "";
+    expect(out).not.toContain("Kept");
+  });
+});
+
+// --- Collapsed-group aggregate cue ---------------------------------------
+
+describe("ToolCallGroup — aggregate review cue", () => {
+  it("surfaces a pending edit on the collapsed summary", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.AWAITING_REVIEW,
+      changes: [makeChange({ id: "a", path: "notes.md" })],
+    });
+    const { lastFrame } = render(
+      <FileReviewContext.Provider value={{ changeSetsById: new Map([[set.id, set]]) }}>
+        <ToolCallGroup toolCalls={[stampedTool("notes.md", "cs-1")]} />
+      </FileReviewContext.Provider>,
+    );
+    expect(lastFrame() ?? "").toContain("1 pending review");
+  });
+
+  it("shows no cue when no row is stamped", () => {
+    const tc = create(ToolCallSchema, { id: "t", name: "read_file", status: ToolCallStatus.TOOL_CALL_COMPLETED });
+    const { lastFrame } = render(<ToolCallGroup toolCalls={[tc]} />);
+    const out = lastFrame() ?? "";
+    expect(out).not.toContain("pending review");
+  });
+});
+
+// --- Settled record -------------------------------------------------------
+
+describe("FileReviewRecord", () => {
+  it("summarizes kept/discarded and lists files", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.RECONCILED,
+      changes: [
+        makeChange({ id: "a", path: "one.ts" }),
+        makeChange({ id: "b", path: "two.ts" }),
+        makeChange({ id: "c", path: "three.ts" }),
+      ],
+      decisions: [
+        { scope: FileDecisionScope.FILE, action: FileDecisionAction.APPROVE, fileChangeId: "a" },
+        { scope: FileDecisionScope.FILE, action: FileDecisionAction.APPROVE, fileChangeId: "b" },
+        { scope: FileDecisionScope.FILE, action: FileDecisionAction.REJECT, fileChangeId: "c" },
+      ],
+    });
+    const { lastFrame } = render(<FileReviewRecord fileChangeSet={set} />);
+    const out = lastFrame() ?? "";
+    expect(out).toContain("2 kept · 1 discarded");
+    expect(out).toContain("one.ts");
+    expect(out).toContain("(discarded)");
+  });
+
+  it("reports a failed reconcile", () => {
+    const set = makeSet({
+      status: FileChangeSetStatus.FAILED,
+      changes: [makeChange({ id: "a", path: "one.ts" })],
+    });
+    expect(render(<FileReviewRecord fileChangeSet={set} />).lastFrame() ?? "").toContain("review failed");
+  });
+});
+
+// --- MessageThread integration -------------------------------------------
+
+describe("MessageThread — file-review integration", () => {
+  function execWithStampedEdit(status: FileChangeSetStatus, decided: boolean) {
+    const set = makeSet({
+      id: "cs-1",
+      status,
+      changes: [makeChange({ id: "a", path: "notes.md" })],
+      decisions: decided
+        ? [{ scope: FileDecisionScope.FILE, action: FileDecisionAction.APPROVE, fileChangeId: "a" }]
+        : [],
+    });
+    const aiMsg = create(AgentMessageSchema, {
+      type: MessageType.MESSAGE_AI,
+      content: "Editing notes",
+      toolCalls: [stampedTool("notes.md", "cs-1")],
+    });
+    return create(AgentExecutionSchema, {
+      metadata: { id: "aex-1" },
+      status: {
+        phase: undefined,
+        messages: [aiMsg],
+        fileChangeSets: [set],
+      },
+    });
+  }
+
+  it("badges a settled row and appends a settled record for a completed execution", () => {
+    const exec = execWithStampedEdit(FileChangeSetStatus.RECONCILED, true);
+    const { lastFrame } = render(
+      <MessageThread executions={[exec]} showFileReviewRecords expandToolCalls />,
+    );
+    const out = lastFrame() ?? "";
+    expect(out).toContain("Kept"); // per-row badge
+    expect(out).toContain("File review — 1 kept"); // settled record
+  });
+
+  it("does not render a settled record for an AWAITING set (that is the prompt's job)", () => {
+    const exec = execWithStampedEdit(FileChangeSetStatus.AWAITING_REVIEW, false);
+    const { lastFrame } = render(
+      <MessageThread executions={[]} activeStreamExecution={exec} showFileReviewRecords expandToolCalls />,
+    );
+    const out = lastFrame() ?? "";
+    expect(out).toContain("Pending review"); // the row still badges
+    expect(out).not.toContain("File review —"); // but no settled record
+  });
+});

package/src/app/SessionView.tsx

@@ -7,6 +7,7 @@ import { TodoList } from "../components/TodoList.js";
 import { FollowUpInput } from "../components/FollowUpInput.js";
 import { UsageWidget } from "../components/UsageWidget.js";
 import { ExecutionProgress } from "../components/ExecutionProgress.js";
+import { FileReviewPrompt } from "../components/FileReviewPrompt.js";
 
 /** Interaction mode type used for follow-up executions. */
 export type InteractionMode = "agent" | "plan";
@@ -135,9 +136,15 @@ export function SessionView({ sessionId, org, mode }: SessionViewProps) {
         </Box>
       )}
 
-      {conv.activePhase != null && conv.activePhase !== 0 && (
-        <ExecutionProgress phase={conv.activePhase} />
-      )}
+      {conv.activePhase != null &&
+        conv.activePhase !== 0 &&
+        conv.fileChangeSets.length === 0 && (
+          // Suppressed while a set awaits review: there is no execution phase
+          // for review (it lives on FileChangeSet.status), so the phase would
+          // otherwise read as an active "Running" spinner while the agent is
+          // idle awaiting the reviewer — the FileReviewPrompt is the honest cue.
+          <ExecutionProgress phase={conv.activePhase} />
+        )}
 
       <MessageThread
         executions={conv.completedExecutions}
@@ -146,6 +153,7 @@ export function SessionView({ sessionId, org, mode }: SessionViewProps) {
         onApprovalSubmit={conv.submitApproval}
         submittingApprovalIds={conv.submittingApprovalIds}
         expandToolCalls={expandTools}
+        showFileReviewRecords
       />
 
       {activeTodos && Object.keys(activeTodos).length > 0 && (
@@ -172,6 +180,34 @@ export function SessionView({ sessionId, org, mode }: SessionViewProps) {
 
       <UsageWidget executions={allExecutions} />
 
+      {conv.fileChangeSets.length > 0 && (
+        <Box flexDirection="column">
+          <FileReviewPrompt
+            changeSet={conv.fileChangeSets[0]}
+            onSubmit={conv.submitFileDecision}
+            submittingDecisionKeys={conv.submittingFileDecisionKeys}
+            decisionErrors={conv.fileDecisionErrors}
+            // Single active decision surface: yield to a pending tool approval.
+            isActive={conv.pendingApprovals.length === 0}
+          />
+          {conv.fileChangeSets.length > 1 && (
+            <Box paddingLeft={2}>
+              <Text dimColor>
+                {conv.fileChangeSets.length - 1} more awaiting review
+              </Text>
+            </Box>
+          )}
+        </Box>
+      )}
+
+      {conv.fileReviewError && (
+        <Box paddingLeft={1}>
+          <Text color="red">
+            File review error: {conv.fileReviewError.message}
+          </Text>
+        </Box>
+      )}
+
       {conv.canSendFollowUp && (
         <Box paddingLeft={1}>
           <Text color={activeMode === "plan" ? "yellow" : "cyan"} dimColor>