@stigmer/react 3.0.9-dev.20260615153829 → 3.1.0

package/execution/FilePathLink.js.map

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

package/execution/FileReviewCard.d.ts

@@ -0,0 +1,111 @@
+import type { FileChangeSet } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/filereview_pb";
+import { FileDecisionAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { type FileDecisionOptions } from "./useFileReview";
+/** Props for {@link FileReviewCard}. */
+export interface FileReviewCardProps {
+    /** The captured change set awaiting review (status AWAITING_REVIEW). */
+    readonly fileChangeSet: FileChangeSet;
+    /**
+     * Called when the user makes a decision. The consumer (typically
+     * {@link MessageThread} or a platform builder's surface) handles the RPC via
+     * {@link useFileReview}. A whole-set Approve/Reject sends `CHANGE_SET` scope;
+     * a per-file Keep/Discard sends `FILE` scope with the file's id. Optional and
+     * ignored when {@link FileReviewCardProps.interactive} is `false`.
+     */
+    readonly onSubmit?: (action: FileDecisionAction, options?: FileDecisionOptions) => void;
+    /**
+     * Whether the card presents decision controls. Defaults to `true` (the live
+     * review surface). Set to `false` to render a **settled** change set read-only:
+     * the per-file diffs and each file's committed verdict are shown, but the
+     * decision controls, bulk footer, and error affordances are omitted. Used for a
+     * decided/reconciled set, or any set on a terminal execution — a historical
+     * record of what changed and how it was decided, not an actionable gate.
+     */
+    readonly interactive?: boolean;
+    /**
+     * Whether the expanded body renders each file's diff. Defaults to `true` —
+     * the right default wherever this card is the *only* review surface (the
+     * workflow file-review list, standalone platform-builder embeds).
+     *
+     * `MessageThread` passes `false`: the transcript's stamped edit rows already
+     * show every diff in place, so the expanded body collapses to a compact file
+     * list (kind letter + path + per-file controls) and the card stays purely
+     * the decision surface. Decision semantics — digests, scopes,
+     * acknowledgments — are identical in both modes; this is presentation only
+     * (opt-in with a backward-compatible default, DD-011).
+     */
+    readonly showDiffs?: boolean;
+    /**
+     * The decision keys currently being submitted — exactly the set
+     * {@link useFileReview} returns as `submittingDecisionKeys`. A card has more
+     * than one decision target (the whole set plus each file), so it takes the
+     * keyed set rather than a single boolean and derives each control's in-flight
+     * state via {@link fileDecisionKey}.
+     */
+    readonly submittingDecisionKeys?: ReadonlySet<string>;
+    /**
+     * Per-decision failures, keyed exactly like {@link submittingDecisionKeys}
+     * (via {@link fileDecisionKey}) — the set's id for a whole-set decision, the
+     * `setId:fileChangeId` for a per-file one. A failed decision is surfaced
+     * in-card, beside the control that failed (and the optimistic verdict reverts),
+     * so the reviewer sees *which* action did not take and why. Supply
+     * {@link useFileReview}'s `decisionErrors`.
+     */
+    readonly decisionErrors?: ReadonlyMap<string, Error>;
+    /** Additional CSS class names for the root container. */
+    readonly className?: string;
+}
+/**
+ * Renders a captured {@link FileChangeSet} as a **compact decision bar**: one
+ * line carrying the set summary and the whole-set decision controls, with the
+ * per-file detail behind an expander. What the expander holds depends on
+ * {@link FileReviewCardProps.showDiffs}: the diff-rich body (default — for
+ * surfaces where this card is the only review surface) or a compact file list
+ * (the session thread, whose stamped edit rows already show every diff in
+ * place). A set that needs per-file attention (binary acknowledgment, blocked
+ * files, mid-review) starts expanded.
+ *
+ * File edits are reviewed as a captured workspace delta, not tool calls, so this
+ * is a dedicated decision surface distinct from the message transcript and the
+ * tool-approval {@link ApprovalCard}. The reviewer can decide each file
+ * individually (Keep / Discard, a `FILE`-scoped decision) or act on the whole
+ * set at once (Approve / Reject, a `CHANGE_SET` decision). Either way the runner
+ * reconciles the exact approved bytes with hash verification.
+ *
+ * The unified HITL gate clears only when EVERY file has a verdict — one
+ * `CHANGE_SET` decision, or a `FILE` decision per file — so a partially-decided
+ * set stays actionable and deciding the last file is what resumes the turn. A
+ * per-file verdict is changeable while the set is still open: clicking the other
+ * option records a new decision (the backend reconcile is last-write-wins).
+ *
+ * A `binary-only` set (binary files are the only blocker) can be kept in one
+ * action: the bulk button reads "Keep all" and carries the acknowledgment
+ * (DD-17). A `blocked` set (something unavailable to review) cannot be approved
+ * as a whole — the Approve button is disabled with an explanation, and the
+ * per-file path is the escape: keep the reviewable files and discard the rest.
+ *
+ * Each non-reviewable file is labeled honestly by {@link fileReviewability}: a
+ * `binary` change has no text diff to review; an `unavailable` change is one
+ * whose diff isn't available at all, with the honest cause the runner recorded
+ * (a secret path whose bytes were never captured, or a diff dropped to bound the
+ * status — doc 15). Both are discard-only, and their Keep affordance is disabled
+ * with the reason associated via `aria-describedby`. Files captured outside
+ * normal git tracking (gitignored / non-git CAS) carry a small provenance badge
+ * so the reviewer knows the change is not part of the repo's tracked history.
+ *
+ * Wrapped in `React.memo` — the streamed `FileChangeSet` reference is preserved
+ * by structural sharing when unchanged, so review cards skip re-renders during
+ * unrelated stream updates.
+ *
+ * @example
+ * ```tsx
+ * const { submitFileDecision, submittingDecisionKeys } = useFileReview();
+ * <FileReviewCard
+ *   fileChangeSet={changeSet}
+ *   onSubmit={(action, opts) => submitFileDecision(executionId, changeSet.id, action, opts)}
+ *   submittingDecisionKeys={submittingDecisionKeys}
+ * />
+ * ```
+ */
+export declare const FileReviewCard: import("react").NamedExoticComponent<FileReviewCardProps>;
+//# sourceMappingURL=FileReviewCard.d.ts.map

package/execution/FileReviewCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileReviewCard.d.ts","sourceRoot":"","sources":["../../src/execution/FileReviewCard.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,aAAa,EAEd,MAAM,oEAAoE,CAAC;AAC5E,OAAO,EAGL,kBAAkB,EAGnB,MAAM,8DAA8D,CAAC;AAQtE,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAc5E,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACxF;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtD;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrD,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,cAAc,2DAmTzB,CAAC"}