@wildo-ai/saas-frontend-lib 1.1.5 → 1.1.7

package/dist/esm/components/flows-actors/approval.js

@@ -2,31 +2,90 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { AI_ApprovalRequest, AI_ApprovalQueue, AI_DecisionRequest, AI_HumanInputRequest, } from "../../components/ai-elements/decision/approval.js";
+import { AGENT_WORK_REASON_CODE_VOCABULARY, ApplicationConfigVocabulary, HumanDecision_Act, HumanDecision_ActOutcomeKind, HumanDecision_Plane, HumanDecision_RefusalReason, HumanDecision_RouteKind, HumanDecision_ToolApprovalOption, ReviewDeadlineKind, ServiceProviderExpertApprovalOption, } from "@wildo-ai/saas-models";
+import { usePendingDecisions } from "../../core/flows-actors/usePendingDecisions.js";
 import { useFlowsActors } from "../../core/flows-actors/useFlowsActors.js";
-import { FlowsActorsExecutionStatus } from "../../core/flows-actors/FlowsActorsContext.js";
-import { FrontendComponentType } from "@wildo-ai/presets-components-models";
+import { FrontendComponentType, LabellingTypes } from "@wildo-ai/presets-components-models";
 import { useI18n } from "../../core/i18n/useI18n.js";
 import { describeApprovalModificationRefusal } from "../../components/flows-actors/approval-modification-refusal.utils.js";
+//===============================================================
+//  Flows-Actors Approval Wrappers
+//
+//  Thin context-wired wrappers over the preset decision components.
+//
+//  - FlowsActors_ApprovalRequest answers a decision IN its conversation, over the socket the turn runs on.
+//  - FlowsActors_ApprovalQueue is the person's INBOX: every decision they may act on, read from the server
+//    (#1594 D6), answered and moved over REST.
+//  - FlowsActors_DecisionRequest / FlowsActors_HumanInputRequest answer in the one answer shape,
+//    `HumanDecision_Answer` (#1594 D12). They used to send a comment prefixed `[DECISION]` / `[INPUT]` as a
+//    tool DENIAL, which nothing on the server read: the choice was dropped and the call refused.
+//===============================================================
+/**
+ * What an act came to, in the approval's own labels. Total over the outcome vocabulary, so an outcome added
+ * tomorrow is a compile error here rather than a silent act.
+ */
+function noticeOfOutcome(outcome, t) {
+    const byKind = {
+        [HumanDecision_ActOutcomeKind.APPLIED]: undefined,
+        // An admitted person's refused clock act names why (#1628); anything else stays one undisclosing notice.
+        [HumanDecision_ActOutcomeKind.NOT_ACTIONABLE]: outcome.reason === HumanDecision_RefusalReason.CLOCK_ALREADY_PAUSED ? t("noticeClockAlreadyPaused")
+            : outcome.reason === HumanDecision_RefusalReason.CLOCK_NOT_PAUSED ? t("noticeClockNotPaused")
+                : outcome.reason === HumanDecision_RefusalReason.PAUSE_STATE_NOT_DECLARED ? t("noticePauseStateNotDeclared")
+                    : t("noticeNotActionable"),
+        [HumanDecision_ActOutcomeKind.LAPSED]: t("noticeLapsed"),
+        [HumanDecision_ActOutcomeKind.REQUESTER_AUTHORITY_LAPSED]: t("noticeRequesterAuthorityLapsed"),
+        [HumanDecision_ActOutcomeKind.MODIFICATION_REJECTED]: t("noticeModificationRejected"),
+        [HumanDecision_ActOutcomeKind.REASON_CODE_REJECTED]: t("noticeReasonCodeRejected"),
+        [HumanDecision_ActOutcomeKind.CONSENT_REQUIRED]: t("noticeConsentRequired"),
+        [HumanDecision_ActOutcomeKind.TARGET_REFUSED]: outcome.reason === HumanDecision_RefusalReason.NO_TARGET ? t("noticeNoEscalationTarget") : t("noticeTargetRefused"),
+        [HumanDecision_ActOutcomeKind.SUPERSEDED]: t("noticeSuperseded"),
+    };
+    return byKind[outcome.kind];
+}
+/**
+ * The reason picker's options (#1921): each declared code with its word from `system_enums.AgentWorkReasonCode.<code>`.
+ *
+ * The codes are the APPLICATION's (`agentWorkReview.reasonCodes`); their words live under the framework's named
+ * vocabulary, where the labelling pipeline plans one key per declared code. A code nobody has worded yet shows as the
+ * code itself — `tSystemEnum` answers the raw value on a miss — which is a missing label that looks missing, never words
+ * invented from the identifier. Exported for the pin that holds that fallback.
+ */
+export function describeReasonCodeOptions(reasonCodes, tSystemEnum) {
+    if (!reasonCodes || reasonCodes.length === 0)
+        return undefined;
+    return reasonCodes.map((code) => ({ value: code, label: tSystemEnum(AGENT_WORK_REASON_CODE_VOCABULARY, code) }));
+}
+/**
+ * A gate's pause states as the words a reviewer reads (#1864): each state's word under the framework's named vocabulary
+ * `system_enums.HumanDecisionPauseState.<state>`, which the labelling pipeline plans from every gate's declared
+ * `pauseStates`. A state nobody has worded yet shows as itself — `tSystemEnum` answers the raw value on a miss — a
+ * missing label that looks missing. Exported for the pin that holds it.
+ */
+export function describePauseState(pauseState, tSystemEnum) {
+    return tSystemEnum(ApplicationConfigVocabulary.HUMAN_DECISION_PAUSE_STATE, pauseState);
+}
+/** The label namespaces the approval wrappers read beyond their own component: the reason codes' (#1921) and pause states' (#1864) words. */
+const APPROVAL_LABEL_NAMESPACES = [LabellingTypes.SYSTEM_ENUMS];
 export function FlowsActors_ApprovalRequest({ executionId, ...props }) {
     const { executions, respondToApproval } = useFlowsActors();
-    const { tComponent } = useI18n({ component: FrontendComponentType.LOW_LEVEL_AI_APPROVAL });
+    const { tComponent, tSystemEnum } = useI18n({ component: FrontendComponentType.LOW_LEVEL_AI_APPROVAL, keys: APPROVAL_LABEL_NAMESPACES });
     const [processingId, setProcessingId] = React.useState(null);
     const execution = executions.get(executionId);
     const pendingApproval = execution?.pendingApproval;
     // Every hook runs BEFORE the early return below. React requires the same hooks on every render, and the render
     // that clears `pendingApproval` — the moment a decision is answered — used to run three fewer (#534 fourth
     // review F1).
-    const handleApprove = React.useCallback((id, comment, modifiedToolArgs) => {
-        setProcessingId(id);
-        respondToApproval(executionId, id, true, comment, modifiedToolArgs);
-    }, [executionId, respondToApproval]);
-    const handleDeny = React.useCallback((id, comment) => {
+    const handleApprove = React.useCallback((id, comment, modifiedToolArgs, reasonCode) => {
         setProcessingId(id);
-        respondToApproval(executionId, id, false, comment);
+        // The reason rides only when given, so an answer without one keeps the call shape it always had.
+        respondToApproval(executionId, id, true, comment, modifiedToolArgs, ...(reasonCode ? [reasonCode] : []));
     }, [executionId, respondToApproval]);
-    const handleEscalate = React.useCallback((id, comment) => {
+    const handleDeny = React.useCallback((id, comment, reasonCode) => {
         setProcessingId(id);
-        respondToApproval(executionId, id, false, `[ESCALATED] ${comment ?? ""}`);
+        if (reasonCode)
+            respondToApproval(executionId, id, false, comment, undefined, reasonCode);
+        else
+            respondToApproval(executionId, id, false, comment);
     }, [executionId, respondToApproval]);
     // A decision answered and then handed BACK arrives as a new pending approval — a refused edit (#587), or a
     // decision the consent requirement refused (#534). Whatever this component recorded as in flight has been
@@ -36,119 +95,190 @@ export function FlowsActors_ApprovalRequest({ executionId, ...props }) {
     }, [pendingApproval]);
     if (!execution || !pendingApproval)
         return null;
-    const { approvalId, actionDescription, riskLevel, expiresAt, requiredRoles, toolName, toolArgs, toolInputSchema, modificationRefusal, rejectedToolArgs, } = pendingApproval;
-    return (_jsx(AI_ApprovalRequest, { approvalId: approvalId, actionDescription: actionDescription, riskLevel: riskLevel, executionId: executionId, systemRef: execution.systemRef, expiresAt: expiresAt, requiredRoles: requiredRoles, 
+    const { approvalId, actionDescription, riskLevel, expiresAt, requiredRoles, toolName, toolArgs, toolInputSchema, modificationRefusal, rejectedToolArgs, routeKind, reasonCodes, reasonCodeRefused, } = pendingApproval;
+    /*
+     * Only an OWNER-routed decision is answered here. One routed to an assignee or a role is answered by a
+     * reviewer from their inbox, and the person whose conversation this is may not answer it (separation of
+     * duties, #1594) — so it shows as waiting, with nothing to press that the server would refuse.
+     *
+     * There is no Escalate here either. It used to send a DENIAL prefixed `[ESCALATED]`, which refused the call
+     * and escalated nothing; an OWNER route cannot be escalated at all, and a reviewer escalates from the inbox.
+     */
+    const answerable = routeKind === undefined || routeKind === HumanDecision_RouteKind.OWNER;
+    return (_jsx(AI_ApprovalRequest, { approvalId: approvalId, actionDescription: actionDescription, riskLevel: riskLevel, executionId: executionId, systemRef: execution.systemRef, expiresAt: expiresAt, requiredRoles: requiredRoles, answerable: answerable, 
+        // A refused reason code leaves the approval standing (#1921): it is back on screen, and says why in its own labels.
+        actionNotice: !answerable
+            ? tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, "awaitingReview")
+            : reasonCodeRefused ? tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, "noticeReasonCodeRejected") : undefined, reasonCodeOptions: answerable ? describeReasonCodeOptions(reasonCodes, tSystemEnum) : undefined, 
         /*
          * The tool call is WHAT is being approved, and until #528 it did not reach the browser at all.
          * `toolArgs` are the proposed arguments — a person approving "rename this record" is approving
          * a specific new title, and an approval surface that hides them is asking for a signature on an
          * unread document.
          *
-         * They were DISPLAYED and never edited, because the response payload had no field to carry a
-         * modification and an editable form would have collected changes the protocol then dropped.
-         * #566 built the carrier: the payload takes `modifiedToolArgs`, the server re-validates them
-         * against the tool's own `inputSchema`, re-signs the approval over them and records on the
-         * audit trail that what executed was not what was proposed. So the editor is offered here.
-         *
-         * `allowArgumentModification` is not defaulted by the preset and IS defaulted on by this
-         * wrapper: the preset cannot know whether its decision path carries the result, whereas this
-         * one is the path, and it does. A caller who wants a read-only surface passes `false`.
+         * #566 built the carrier for an edited call: the payload takes `modifiedToolArgs`, the server
+         * re-validates them against the tool's own `inputSchema`, re-signs the approval over them and
+         * records that the decider changed them. So the editor is offered here, where the decision is
+         * answered — never where it is only shown.
          */
-        allowArgumentModification: true, toolName: toolName, executionContext: toolArgs, argumentsSchema: toolInputSchema, 
+        allowArgumentModification: answerable, toolName: toolName, executionContext: toolArgs, argumentsSchema: toolInputSchema, 
         // The refusal in the approval's own labels, naming the tool and the offending arguments (#1186).
         argumentModificationError: modificationRefusal
             ? describeApprovalModificationRefusal(modificationRefusal, (labelRef, params) => tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, labelRef, params))
-            : undefined, rejectedArguments: rejectedToolArgs, onApprove: handleApprove, onDeny: handleDeny, onEscalate: handleEscalate, 
+            : undefined, rejectedArguments: rejectedToolArgs, onApprove: handleApprove, onDeny: handleDeny, 
         // Released by the effect above whenever the approval is handed back. Not released while the socket is
         // disconnected: `respondToApproval` then sends nothing and leaves the approval exactly as it was, so its
         // identity never changes — a stuck state that predates #534 and is cured by the view remounting.
         isProcessing: processingId === approvalId, ...props }));
 }
+//===============================================================
+//  FlowsActors_ApprovalQueue
+//
+//  The person's inbox: every decision they may act on, from the server.
+//===============================================================
+/**
+ * What one inbox card SAYS, per plane. A tool approval names the tool (an identifier, travelling as a parameter)
+ * and shows its proposed arguments; an expert admission (#1612) says which firm asks to admit which person, in the
+ * approval's own words, and shows no argument table — there is no tool, and the client's own data is not on the card.
+ */
+function describeInboxCard(card, t, roleLabel = (roleKey) => roleKey) {
+    const admission = card.plane === HumanDecision_Plane.SERVICE_PROVIDER_EXPERT_ADMISSION ? card.serviceProviderExpertAdmission : undefined;
+    if (admission) {
+        // Names and email are DATA the firm and its expert supplied; the firm's id and the expert's id stand in when unreadable.
+        // The role and the scope are what the approver is granting, so the line names both (#1612 review L3). The role is
+        // worded by the roles label tree (`tRole`), never shown as its identifier; the scope by its own label.
+        const unitCount = admission.organizationUnitIds?.length ?? 0;
+        return {
+            actionDescription: t("inboxExpertAdmission", {
+                firm: admission.providerOrganizationName ?? admission.providerOrganizationId,
+                expert: admission.expertName ?? admission.expertEmail ?? admission.expertUserId,
+                email: admission.expertEmail ?? admission.expertUserId,
+                role: roleLabel(admission.role),
+                scope: unitCount > 0 ? t("inboxExpertAdmissionScopeUnits", { count: String(unitCount) }) : t("inboxExpertAdmissionScopeOrganization"),
+            }),
+        };
+    }
+    return {
+        // The words are the approval's own label; the tool name is an identifier and travels as a parameter.
+        actionDescription: t("inboxToolCall", { toolName: card.toolName }),
+        toolName: card.toolName,
+        executionContext: card.toolArgs,
+    };
+}
 export function FlowsActors_ApprovalQueue(props) {
-    const { executions, respondToApproval } = useFlowsActors();
+    const { decisions, act, candidates } = usePendingDecisions();
+    const { tComponent, tRole, tSystemEnum, formatDateTime } = useI18n({ component: FrontendComponentType.LOW_LEVEL_AI_APPROVAL, keys: APPROVAL_LABEL_NAMESPACES });
+    const t = React.useCallback((labelRef, params) => tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, labelRef, params), [tComponent]);
+    // Keyed by decisionRef: a decision is in flight from the act until its outcome returns.
+    const [processing, setProcessing] = React.useState(() => new Set());
+    const [notices, setNotices] = React.useState(() => new Map());
+    const [reassignCandidates, setReassignCandidates] = React.useState(() => new Map());
+    const run = React.useCallback(async (decisionRef, decisionAct, request) => {
+        setProcessing((previous) => new Set(previous).add(decisionRef));
+        try {
+            const outcome = await act(decisionRef, decisionAct, request);
+            const notice = noticeOfOutcome(outcome, t);
+            setNotices((previous) => {
+                const next = new Map(previous);
+                if (notice === undefined)
+                    next.delete(decisionRef);
+                else
+                    next.set(decisionRef, notice);
+                return next;
+            });
+        }
+        catch {
+            // Not an outcome the server reported (a network failure): say it did not take, and leave it answerable.
+            setNotices((previous) => new Map(previous).set(decisionRef, t("noticeNotActionable")));
+        }
+        finally {
+            setProcessing((previous) => {
+                const next = new Set(previous);
+                next.delete(decisionRef);
+                return next;
+            });
+        }
+    }, [act, t]);
+    const items = React.useMemo(() => decisions.map((card) => ({
+        approvalId: card.decisionRef,
+        executionId: card.executionId,
+        systemRef: card.systemRef,
+        ...describeInboxCard(card, t, (roleKey) => (tRole ? tRole(roleKey, 'label') : roleKey)),
+        expiresAt: card.expiresAt ? new Date(card.expiresAt) : undefined,
+        createdAt: new Date(card.requestedAt),
+        // Only the acts the server says this person may perform — computed with the rule every act is checked by.
+        // The inbox's Escalate names nobody, so it is offered only where the gate declares where escalations go;
+        // handing it to a person of the reviewer's choosing is Reassign.
+        canEscalate: card.permittedActs.includes(HumanDecision_Act.ESCALATE) && card.declaresEscalationTarget,
+        canClaim: card.permittedActs.includes(HumanDecision_Act.CLAIM),
+        canUnclaim: card.permittedActs.includes(HumanDecision_Act.UNCLAIM),
+        canReassign: card.permittedActs.includes(HumanDecision_Act.REASSIGN),
+        reassignCandidates: reassignCandidates.get(card.decisionRef),
+        actionNotice: notices.get(card.decisionRef),
+        // #1628 — the next deadline, or why its deadlines are paused; Pause only with a declared reason to name.
+        canPauseClock: card.permittedActs.includes(HumanDecision_Act.PAUSE_CLOCK) && !card.clockPause && card.pauseStates.length > 0,
+        canResumeClock: card.permittedActs.includes(HumanDecision_Act.RESUME_CLOCK) && !!card.clockPause,
+        // A pause state is the APPLICATION's identifier, shown as its word (#1864) — see `describePauseState`.
+        pauseStateOptions: card.pauseStates.map((pauseState) => ({ value: pauseState, label: describePauseState(pauseState, tSystemEnum) })),
+        deadlineNotice: card.nextDeadline
+            ? t(card.nextDeadline.kind === ReviewDeadlineKind.CLAIM ? "deadlineClaimBy" : "deadlineDecisionBy", { when: formatDateTime(card.nextDeadline.dueAt) })
+            : undefined,
+        clockPausedNotice: card.clockPause ? t("clockPausedIn", { pauseState: describePauseState(card.clockPause.pauseStateRef, tSystemEnum) }) : undefined,
+        // #1921 — the reviewer may give a reason from the application's vocabulary when correcting the agent, and may
+        // CORRECT it by editing the call: the act request carries `modifiedToolArgs`, which the server re-validates against
+        // the tool's own schema. Only on a tool approval — an expert admission has no call to edit and no agent to correct.
+        reasonCodeOptions: describeReasonCodeOptions(card.reasonCodes, tSystemEnum),
+        allowArgumentModification: card.plane === HumanDecision_Plane.CONVERSATIONAL,
+        argumentsSchema: card.toolInputSchema,
+    })), [decisions, reassignCandidates, notices, t, tRole, tSystemEnum, formatDateTime]);
     /**
-     * Each answered approval, keyed by id, mapped to the pending-approval OBJECT that was answered.
-     *
-     * An id alone cannot tell "still waiting for the server" from "handed back": a refused edit (#587) or a decision
-     * the consent requirement refused (#534) returns under the SAME `approvalId`. What differs is the object — the
-     * context clears the approval when it is answered and restores a new one when it is handed back — so an id counts
-     * as in flight only while the current pending approval for it is still the very object that was answered (#534
-     * fifth review M1). Until then the item stays disabled, which is what stops a double submit.
-     *
-     * Not released while the socket is disconnected: `respondToApproval` then sends nothing and leaves the approval
-     * exactly as it was, so its object never changes and the item stays disabled until the component remounts — the
-     * same pre-existing stuck state the chat view's wrapper documents.
-     *
-     * DERIVED on every render rather than pruned by an effect: an effect keyed on `executions` would depend on the
-     * context replacing its map on every change, and a release that silently stops working when that changes is the
-     * defect this exists to remove.
+     * An answer in the one answer shape: the option chosen, and no values. Which option refs "approve" and "deny" mean
+     * depends on the decision's plane — a tool approval's, or an expert admission's (#1612) — so the card decides.
      */
-    const [answered, setAnswered] = React.useState(() => new Map());
-    const items = React.useMemo(() => {
-        const result = [];
-        executions.forEach((execution) => {
-            if (execution.status === FlowsActorsExecutionStatus.AWAITING_APPROVAL &&
-                execution.pendingApproval) {
-                result.push({
-                    approvalId: execution.pendingApproval.approvalId,
-                    executionId: execution.executionId,
-                    systemRef: execution.systemRef,
-                    actionDescription: execution.pendingApproval.actionDescription,
-                    riskLevel: execution.pendingApproval.riskLevel,
-                    expiresAt: execution.pendingApproval.expiresAt,
-                    requiredRoles: execution.pendingApproval.requiredRoles,
-                });
-            }
+    const answer = React.useCallback((decisionRef, approve, comment, modifiedToolArgs, reasonCode) => {
+        const plane = decisions.find((card) => card.decisionRef === decisionRef)?.plane;
+        const optionRef = plane === HumanDecision_Plane.SERVICE_PROVIDER_EXPERT_ADMISSION
+            ? (approve ? ServiceProviderExpertApprovalOption.APPROVE : ServiceProviderExpertApprovalOption.REJECT)
+            : (approve ? HumanDecision_ToolApprovalOption.APPROVE : HumanDecision_ToolApprovalOption.DENY);
+        void run(decisionRef, HumanDecision_Act.ANSWER, {
+            answer: { decisionId: decisionRef, optionRef, values: [] },
+            ...(comment ? { reason: comment } : {}),
+            // Only when the reviewer edited the call: an absent field means "run it as proposed" (#566).
+            ...(modifiedToolArgs ? { modifiedToolArgs } : {}),
+            // Why the reviewer corrected the agent (#1921); refused with REASON_CODE_REJECTED unless the application declares it.
+            ...(reasonCode ? { reasonCode } : {}),
         });
-        return result;
-    }, [executions]);
-    const currentPending = new Map();
-    executions.forEach((execution) => {
-        if (execution.pendingApproval)
-            currentPending.set(execution.pendingApproval.approvalId, execution.pendingApproval);
-    });
-    const processingIds = new Set();
-    for (const [approvalId, answeredApproval] of answered) {
-        if (currentPending.get(approvalId) === answeredApproval)
-            processingIds.add(approvalId);
-    }
-    const respond = React.useCallback((approvalId, approved, comment) => {
-        const item = items.find((i) => i.approvalId === approvalId);
-        if (!item)
-            return;
-        const answeredApproval = executions.get(item.executionId)?.pendingApproval;
-        // Entries whose approval has since moved on are dropped here, so the map never outgrows the queue.
-        setAnswered((previous) => {
-            const next = new Map();
-            previous.forEach((value, id) => { if (currentPending.get(id) === value)
-                next.set(id, value); });
-            return next.set(approvalId, answeredApproval);
+    }, [run, decisions]);
+    const handleReassignOpen = React.useCallback((decisionRef) => {
+        setReassignCandidates((previous) => {
+            const next = new Map(previous);
+            next.delete(decisionRef);
+            return next;
         });
-        respondToApproval(item.executionId, approvalId, approved, comment);
-    }, [items, executions, respondToApproval]);
-    const handleApprove = React.useCallback((approvalId, comment) => {
-        respond(approvalId, true, comment);
-    }, [respond]);
-    const handleDeny = React.useCallback((approvalId, comment) => {
-        respond(approvalId, false, comment);
-    }, [respond]);
-    const handleEscalate = React.useCallback((approvalId, comment) => {
-        respond(approvalId, false, `[ESCALATED] ${comment ?? ""}`);
-    }, [respond]);
-    return (_jsx(AI_ApprovalQueue, { items: items, onApprove: handleApprove, onDeny: handleDeny, onEscalate: handleEscalate, processingIds: processingIds, ...props }));
+        void candidates(decisionRef)
+            .then((people) => setReassignCandidates((previous) => new Map(previous).set(decisionRef, 
+        // The membership's email is how a same-organization reviewer tells people apart; it is data, not a label.
+        people.map((person) => ({ value: person.userId, label: person.email ?? person.userId })))))
+            .catch(() => setReassignCandidates((previous) => new Map(previous).set(decisionRef, [])));
+    }, [candidates]);
+    return (_jsx(AI_ApprovalQueue, { items: items, onApprove: (decisionRef, comment, modifiedToolArgs, reasonCode) => answer(decisionRef, true, comment, modifiedToolArgs, reasonCode), onDeny: (decisionRef, comment, reasonCode) => answer(decisionRef, false, comment, undefined, reasonCode), onEscalate: (decisionRef, comment) => void run(decisionRef, HumanDecision_Act.ESCALATE, comment ? { reason: comment } : {}), onClaim: (decisionRef) => void run(decisionRef, HumanDecision_Act.CLAIM, {}), onUnclaim: (decisionRef) => void run(decisionRef, HumanDecision_Act.UNCLAIM, {}), onReassignOpen: handleReassignOpen, onReassign: (decisionRef, targetUserId, comment) => void run(decisionRef, HumanDecision_Act.REASSIGN, { targetUserId, ...(comment ? { reason: comment } : {}) }), onPauseClock: (decisionRef, pauseStateRef) => void run(decisionRef, HumanDecision_Act.PAUSE_CLOCK, { pauseStateRef }), onResumeClock: (decisionRef) => void run(decisionRef, HumanDecision_Act.RESUME_CLOCK, {}), processingIds: processing, ...props }));
 }
-export function FlowsActors_DecisionRequest({ executionId, ...props }) {
-    const { respondToApproval } = useFlowsActors();
+export function FlowsActors_DecisionRequest({ onOutcome, ...props }) {
+    const { act } = usePendingDecisions({ list: false });
+    const { tComponent } = useI18n({ component: FrontendComponentType.LOW_LEVEL_AI_APPROVAL });
     const handleSelect = React.useCallback((decisionId, optionId) => {
-        respondToApproval(executionId, decisionId, true, `[DECISION] ${optionId}`);
-    }, [executionId, respondToApproval]);
-    return (_jsx(AI_DecisionRequest, { ...props, onSelect: handleSelect }));
+        void act(decisionId, HumanDecision_Act.ANSWER, { answer: { decisionId, optionRef: optionId, values: [] } })
+            .then((outcome) => onOutcome?.(noticeOfOutcome(outcome, (ref) => tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, ref))));
+    }, [act, onOutcome, tComponent]);
+    return _jsx(AI_DecisionRequest, { ...props, onSelect: handleSelect });
 }
-export function FlowsActors_HumanInputRequest({ executionId, ...props }) {
-    const { respondToApproval } = useFlowsActors();
+export function FlowsActors_HumanInputRequest({ optionRef, fieldRef, onOutcome, ...props }) {
+    const { act } = usePendingDecisions({ list: false });
+    const { tComponent } = useI18n({ component: FrontendComponentType.LOW_LEVEL_AI_APPROVAL });
     const handleSubmit = React.useCallback((requestId, value) => {
-        respondToApproval(executionId, requestId, true, `[INPUT] ${value}`);
-    }, [executionId, respondToApproval]);
-    return (_jsx(AI_HumanInputRequest, { ...props, onSubmit: handleSubmit }));
+        void act(requestId, HumanDecision_Act.ANSWER, { answer: { decisionId: requestId, optionRef, values: [{ ref: fieldRef, value }] } })
+            .then((outcome) => onOutcome?.(noticeOfOutcome(outcome, (ref) => tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, ref))));
+    }, [act, optionRef, fieldRef, onOutcome, tComponent]);
+    return _jsx(AI_HumanInputRequest, { ...props, onSubmit: handleSubmit });
 }
 //# sourceMappingURL=approval.js.map

package/dist/esm/components/flows-actors/approval.js.map

@@ -1 +1 @@
-{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../../../src/components/flows-actors/approval.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport {\n  AI_ApprovalRequest,\n  AI_ApprovalQueue,\n  AI_DecisionRequest,\n  AI_HumanInputRequest,\n  type AI_ApprovalQueueItem,\n  type AI_ApprovalRequestProps,\n  type AI_ApprovalQueueProps,\n  type AI_DecisionRequestProps,\n  type AI_HumanInputRequestProps,\n} from \"~wildo-frontend-lib/components/ai-elements/decision/approval\";\nimport { useFlowsActors } from \"~wildo-frontend-lib/core/flows-actors/useFlowsActors\";\nimport { FlowsActorsExecutionStatus, type FlowsActorsExecution } from \"~wildo-frontend-lib/core/flows-actors/FlowsActorsContext\";\nimport type { ComponentProps } from \"react\";\nimport { FrontendComponentType } from \"@wildo-ai/presets-components-models\"\nimport { useI18n } from \"~wildo-frontend-lib/core/i18n/useI18n\";\nimport { describeApprovalModificationRefusal } from \"~wildo-frontend-lib/components/flows-actors/approval-modification-refusal.utils\";\n\n//===============================================================\n//  Flows-Actors Approval Wrappers\n//\n//  Thin context-wired wrappers that:\n//  1. Import generic preset components (AI_ApprovalRequest, etc.)\n//  2. Inject useFlowsActors() to get executions + respondToApproval()\n//  3. Aggregate pending approvals across all executions into the queue\n//  4. Wire onApprove/onDeny/onEscalate callbacks to respondToApproval()\n//===============================================================\n\n//===============================================================\n//  FlowsActors_ApprovalRequest\n//\n//  Wraps AI_ApprovalRequest with context-wired callbacks.\n//  Accepts executionId — pulls pendingApproval from context.\n//===============================================================\n\nexport type FlowsActors_ApprovalRequestProps = Omit<\n  AI_ApprovalRequestProps,\n  \"approvalId\" | \"actionDescription\" | \"riskLevel\" | \"onApprove\" | \"onDeny\" | \"onEscalate\"\n> & {\n  executionId: string;\n};\n\nexport function FlowsActors_ApprovalRequest({\n  executionId,\n  ...props\n}: FlowsActors_ApprovalRequestProps): React.JSX.Element | null {\n  const { executions, respondToApproval } = useFlowsActors();\n  const { tComponent } = useI18n({ component: FrontendComponentType.LOW_LEVEL_AI_APPROVAL });\n  const [processingId, setProcessingId] = React.useState<string | null>(null);\n  const execution = executions.get(executionId);\n  const pendingApproval = execution?.pendingApproval;\n\n  // Every hook runs BEFORE the early return below. React requires the same hooks on every render, and the render\n  // that clears `pendingApproval` — the moment a decision is answered — used to run three fewer (#534 fourth\n  // review F1).\n  const handleApprove = React.useCallback((id: string, comment?: string, modifiedToolArgs?: Record<string, unknown>) => {\n    setProcessingId(id);\n    respondToApproval(executionId, id, true, comment, modifiedToolArgs);\n  }, [executionId, respondToApproval]);\n\n  const handleDeny = React.useCallback((id: string, comment?: string) => {\n    setProcessingId(id);\n    respondToApproval(executionId, id, false, comment);\n  }, [executionId, respondToApproval]);\n\n  const handleEscalate = React.useCallback((id: string, comment?: string) => {\n    setProcessingId(id);\n    respondToApproval(executionId, id, false, `[ESCALATED] ${comment ?? \"\"}`);\n  }, [executionId, respondToApproval]);\n\n  // A decision answered and then handed BACK arrives as a new pending approval — a refused edit (#587), or a\n  // decision the consent requirement refused (#534). Whatever this component recorded as in flight has been\n  // answered, so the decision is answerable again instead of staying disabled until the view remounts.\n  React.useEffect(() => {\n    setProcessingId(null);\n  }, [pendingApproval]);\n\n  if (!execution || !pendingApproval) return null;\n\n  const {\n    approvalId, actionDescription, riskLevel, expiresAt, requiredRoles, toolName, toolArgs, toolInputSchema, modificationRefusal,\n    rejectedToolArgs,\n  } = pendingApproval;\n\n  return (\n    <AI_ApprovalRequest\n      approvalId={approvalId}\n      actionDescription={actionDescription}\n      riskLevel={riskLevel}\n      executionId={executionId}\n      systemRef={execution.systemRef}\n      expiresAt={expiresAt}\n      requiredRoles={requiredRoles}\n      /*\n       * The tool call is WHAT is being approved, and until #528 it did not reach the browser at all.\n       * `toolArgs` are the proposed arguments — a person approving \"rename this record\" is approving\n       * a specific new title, and an approval surface that hides them is asking for a signature on an\n       * unread document.\n       *\n       * They were DISPLAYED and never edited, because the response payload had no field to carry a\n       * modification and an editable form would have collected changes the protocol then dropped.\n       * #566 built the carrier: the payload takes `modifiedToolArgs`, the server re-validates them\n       * against the tool's own `inputSchema`, re-signs the approval over them and records on the\n       * audit trail that what executed was not what was proposed. So the editor is offered here.\n       *\n       * `allowArgumentModification` is not defaulted by the preset and IS defaulted on by this\n       * wrapper: the preset cannot know whether its decision path carries the result, whereas this\n       * one is the path, and it does. A caller who wants a read-only surface passes `false`.\n       */\n      allowArgumentModification\n      toolName={toolName}\n      executionContext={toolArgs}\n      argumentsSchema={toolInputSchema}\n      // The refusal in the approval's own labels, naming the tool and the offending arguments (#1186).\n      argumentModificationError={modificationRefusal\n        ? describeApprovalModificationRefusal(modificationRefusal, (labelRef, params) => tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, labelRef, params))\n        : undefined}\n      rejectedArguments={rejectedToolArgs}\n      onApprove={handleApprove}\n      onDeny={handleDeny}\n      onEscalate={handleEscalate}\n      // Released by the effect above whenever the approval is handed back. Not released while the socket is\n      // disconnected: `respondToApproval` then sends nothing and leaves the approval exactly as it was, so its\n      // identity never changes — a stuck state that predates #534 and is cured by the view remounting.\n      isProcessing={processingId === approvalId}\n      {...props}\n    />\n  );\n}\n\n//===============================================================\n//  FlowsActors_ApprovalQueue\n//\n//  Aggregates all pending approvals from all active executions\n//  into a single queue. Auto-refreshes via WebSocket events.\n//===============================================================\n\nexport type FlowsActors_ApprovalQueueProps = Omit<\n  AI_ApprovalQueueProps,\n  \"items\" | \"onApprove\" | \"onDeny\" | \"onEscalate\" | \"processingIds\"\n>;\n\nexport function FlowsActors_ApprovalQueue(props: FlowsActors_ApprovalQueueProps): React.JSX.Element {\n  const { executions, respondToApproval } = useFlowsActors();\n  /**\n   * Each answered approval, keyed by id, mapped to the pending-approval OBJECT that was answered.\n   *\n   * An id alone cannot tell \"still waiting for the server\" from \"handed back\": a refused edit (#587) or a decision\n   * the consent requirement refused (#534) returns under the SAME `approvalId`. What differs is the object — the\n   * context clears the approval when it is answered and restores a new one when it is handed back — so an id counts\n   * as in flight only while the current pending approval for it is still the very object that was answered (#534\n   * fifth review M1). Until then the item stays disabled, which is what stops a double submit.\n   *\n   * Not released while the socket is disconnected: `respondToApproval` then sends nothing and leaves the approval\n   * exactly as it was, so its object never changes and the item stays disabled until the component remounts — the\n   * same pre-existing stuck state the chat view's wrapper documents.\n   *\n   * DERIVED on every render rather than pruned by an effect: an effect keyed on `executions` would depend on the\n   * context replacing its map on every change, and a release that silently stops working when that changes is the\n   * defect this exists to remove.\n   */\n  const [answered, setAnswered] = React.useState<ReadonlyMap<string, unknown>>(() => new Map());\n\n  const items: AI_ApprovalQueueItem[] = React.useMemo(() => {\n    const result: AI_ApprovalQueueItem[] = [];\n    executions.forEach((execution) => {\n      if (\n        execution.status === FlowsActorsExecutionStatus.AWAITING_APPROVAL &&\n        execution.pendingApproval\n      ) {\n        result.push({\n          approvalId: execution.pendingApproval.approvalId,\n          executionId: execution.executionId,\n          systemRef: execution.systemRef,\n          actionDescription: execution.pendingApproval.actionDescription,\n          riskLevel: execution.pendingApproval.riskLevel,\n          expiresAt: execution.pendingApproval.expiresAt,\n          requiredRoles: execution.pendingApproval.requiredRoles,\n        });\n      }\n    });\n    return result;\n  }, [executions]);\n\n  const currentPending = new Map<string, unknown>();\n  executions.forEach((execution) => {\n    if (execution.pendingApproval) currentPending.set(execution.pendingApproval.approvalId, execution.pendingApproval);\n  });\n  const processingIds = new Set<string>();\n  for (const [approvalId, answeredApproval] of answered) {\n    if (currentPending.get(approvalId) === answeredApproval) processingIds.add(approvalId);\n  }\n\n  const respond = React.useCallback((approvalId: string, approved: boolean, comment?: string) => {\n    const item = items.find((i) => i.approvalId === approvalId);\n    if (!item) return;\n\n    const answeredApproval = executions.get(item.executionId)?.pendingApproval;\n    // Entries whose approval has since moved on are dropped here, so the map never outgrows the queue.\n    setAnswered((previous) => {\n      const next = new Map<string, unknown>();\n      previous.forEach((value, id) => { if (currentPending.get(id) === value) next.set(id, value); });\n      return next.set(approvalId, answeredApproval);\n    });\n    respondToApproval(item.executionId, approvalId, approved, comment);\n  }, [items, executions, respondToApproval]);\n\n  const handleApprove = React.useCallback((approvalId: string, comment?: string) => {\n    respond(approvalId, true, comment);\n  }, [respond]);\n\n  const handleDeny = React.useCallback((approvalId: string, comment?: string) => {\n    respond(approvalId, false, comment);\n  }, [respond]);\n\n  const handleEscalate = React.useCallback((approvalId: string, comment?: string) => {\n    respond(approvalId, false, `[ESCALATED] ${comment ?? \"\"}`);\n  }, [respond]);\n\n  return (\n    <AI_ApprovalQueue\n      items={items}\n      onApprove={handleApprove}\n      onDeny={handleDeny}\n      onEscalate={handleEscalate}\n      processingIds={processingIds}\n      {...props}\n    />\n  );\n}\n\n//===============================================================\n//  FlowsActors_DecisionRequest\n//\n//  Wraps AI_DecisionRequest — selection is forwarded to\n//  respondToApproval() using the optionId as the comment.\n//===============================================================\n\nexport type FlowsActors_DecisionRequestProps = Omit<\n  AI_DecisionRequestProps,\n  \"onSelect\"\n> & {\n  executionId: string;\n};\n\nexport function FlowsActors_DecisionRequest({\n  executionId,\n  ...props\n}: FlowsActors_DecisionRequestProps): React.JSX.Element {\n  const { respondToApproval } = useFlowsActors();\n\n  const handleSelect = React.useCallback((decisionId: string, optionId: string) => {\n    respondToApproval(executionId, decisionId, true, `[DECISION] ${optionId}`);\n  }, [executionId, respondToApproval]);\n\n  return (\n    <AI_DecisionRequest\n      {...props}\n      onSelect={handleSelect}\n    />\n  );\n}\n\n//===============================================================\n//  FlowsActors_HumanInputRequest\n//\n//  Wraps AI_HumanInputRequest — submitted value is forwarded to\n//  respondToApproval() as the comment.\n//===============================================================\n\nexport type FlowsActors_HumanInputRequestProps = Omit<\n  AI_HumanInputRequestProps,\n  \"onSubmit\"\n> & {\n  executionId: string;\n};\n\nexport function FlowsActors_HumanInputRequest({\n  executionId,\n  ...props\n}: FlowsActors_HumanInputRequestProps): React.JSX.Element {\n  const { respondToApproval } = useFlowsActors();\n\n  const handleSubmit = React.useCallback((requestId: string, value: string) => {\n    respondToApproval(executionId, requestId, true, `[INPUT] ${value}`);\n  }, [executionId, respondToApproval]);\n\n  return (\n    <AI_HumanInputRequest\n      {...props}\n      onSubmit={handleSubmit}\n    />\n  );\n}\n"]}
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../../src/components/flows-actors/approval.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport {\n  AI_ApprovalRequest,\n  AI_ApprovalQueue,\n  AI_DecisionRequest,\n  AI_HumanInputRequest,\n  type AI_ApprovalQueueItem,\n  type AI_ApprovalReasonCodeOption,\n  type AI_ApprovalReassignCandidate,\n  type AI_ApprovalRequestProps,\n  type AI_ApprovalQueueProps,\n  type AI_DecisionRequestProps,\n  type AI_HumanInputRequestProps,\n} from \"~wildo-frontend-lib/components/ai-elements/decision/approval\";\nimport {\n  AGENT_WORK_REASON_CODE_VOCABULARY,\n  ApplicationConfigVocabulary,\n  HumanDecision_Act,\n  HumanDecision_ActOutcomeKind,\n  HumanDecision_Plane,\n  HumanDecision_RefusalReason,\n  HumanDecision_RouteKind,\n  HumanDecision_ToolApprovalOption,\n  ReviewDeadlineKind,\n  ServiceProviderExpertApprovalOption,\n  type HumanDecision_ActOutcome,\n  type HumanDecision_ActRequest,\n  type HumanDecision_PendingCard,\n} from \"@wildo-ai/saas-models\";\nimport { usePendingDecisions } from \"~wildo-frontend-lib/core/flows-actors/usePendingDecisions\";\nimport { useFlowsActors } from \"~wildo-frontend-lib/core/flows-actors/useFlowsActors\";\nimport type { ComponentProps } from \"react\";\nimport type { SerializableZodSchema } from \"@wildo-ai/zod-decorators\";\nimport { FrontendComponentType, LabellingTypes } from \"@wildo-ai/presets-components-models\"\nimport { useI18n } from \"~wildo-frontend-lib/core/i18n/useI18n\";\nimport { describeApprovalModificationRefusal } from \"~wildo-frontend-lib/components/flows-actors/approval-modification-refusal.utils\";\n\n//===============================================================\n//  Flows-Actors Approval Wrappers\n//\n//  Thin context-wired wrappers over the preset decision components.\n//\n//  - FlowsActors_ApprovalRequest answers a decision IN its conversation, over the socket the turn runs on.\n//  - FlowsActors_ApprovalQueue is the person's INBOX: every decision they may act on, read from the server\n//    (#1594 D6), answered and moved over REST.\n//  - FlowsActors_DecisionRequest / FlowsActors_HumanInputRequest answer in the one answer shape,\n//    `HumanDecision_Answer` (#1594 D12). They used to send a comment prefixed `[DECISION]` / `[INPUT]` as a\n//    tool DENIAL, which nothing on the server read: the choice was dropped and the call refused.\n//===============================================================\n\n/**\n * What an act came to, in the approval's own labels. Total over the outcome vocabulary, so an outcome added\n * tomorrow is a compile error here rather than a silent act.\n */\nfunction noticeOfOutcome(\n  outcome: HumanDecision_ActOutcome,\n  t: (labelRef: string) => string,\n): string | undefined {\n  const byKind: Readonly<Record<HumanDecision_ActOutcomeKind, string | undefined>> = {\n    [HumanDecision_ActOutcomeKind.APPLIED]: undefined,\n    // An admitted person's refused clock act names why (#1628); anything else stays one undisclosing notice.\n    [HumanDecision_ActOutcomeKind.NOT_ACTIONABLE]: outcome.reason === HumanDecision_RefusalReason.CLOCK_ALREADY_PAUSED ? t(\"noticeClockAlreadyPaused\")\n      : outcome.reason === HumanDecision_RefusalReason.CLOCK_NOT_PAUSED ? t(\"noticeClockNotPaused\")\n        : outcome.reason === HumanDecision_RefusalReason.PAUSE_STATE_NOT_DECLARED ? t(\"noticePauseStateNotDeclared\")\n          : t(\"noticeNotActionable\"),\n    [HumanDecision_ActOutcomeKind.LAPSED]: t(\"noticeLapsed\"),\n    [HumanDecision_ActOutcomeKind.REQUESTER_AUTHORITY_LAPSED]: t(\"noticeRequesterAuthorityLapsed\"),\n    [HumanDecision_ActOutcomeKind.MODIFICATION_REJECTED]: t(\"noticeModificationRejected\"),\n    [HumanDecision_ActOutcomeKind.REASON_CODE_REJECTED]: t(\"noticeReasonCodeRejected\"),\n    [HumanDecision_ActOutcomeKind.CONSENT_REQUIRED]: t(\"noticeConsentRequired\"),\n    [HumanDecision_ActOutcomeKind.TARGET_REFUSED]: outcome.reason === HumanDecision_RefusalReason.NO_TARGET ? t(\"noticeNoEscalationTarget\") : t(\"noticeTargetRefused\"),\n    [HumanDecision_ActOutcomeKind.SUPERSEDED]: t(\"noticeSuperseded\"),\n  };\n  return byKind[outcome.kind];\n}\n\n/**\n * The reason picker's options (#1921): each declared code with its word from `system_enums.AgentWorkReasonCode.<code>`.\n *\n * The codes are the APPLICATION's (`agentWorkReview.reasonCodes`); their words live under the framework's named\n * vocabulary, where the labelling pipeline plans one key per declared code. A code nobody has worded yet shows as the\n * code itself — `tSystemEnum` answers the raw value on a miss — which is a missing label that looks missing, never words\n * invented from the identifier. Exported for the pin that holds that fallback.\n */\nexport function describeReasonCodeOptions(\n  reasonCodes: readonly string[] | undefined,\n  tSystemEnum: (enumName: typeof AGENT_WORK_REASON_CODE_VOCABULARY, enumValue: string) => string,\n): AI_ApprovalReasonCodeOption[] | undefined {\n  if (!reasonCodes || reasonCodes.length === 0) return undefined;\n  return reasonCodes.map((code) => ({ value: code, label: tSystemEnum(AGENT_WORK_REASON_CODE_VOCABULARY, code) }));\n}\n\n/**\n * A gate's pause states as the words a reviewer reads (#1864): each state's word under the framework's named vocabulary\n * `system_enums.HumanDecisionPauseState.<state>`, which the labelling pipeline plans from every gate's declared\n * `pauseStates`. A state nobody has worded yet shows as itself — `tSystemEnum` answers the raw value on a miss — a\n * missing label that looks missing. Exported for the pin that holds it.\n */\nexport function describePauseState(\n  pauseState: string,\n  tSystemEnum: (enumName: ApplicationConfigVocabulary.HUMAN_DECISION_PAUSE_STATE, enumValue: string) => string,\n): string {\n  return tSystemEnum(ApplicationConfigVocabulary.HUMAN_DECISION_PAUSE_STATE, pauseState);\n}\n\n/** The label namespaces the approval wrappers read beyond their own component: the reason codes' (#1921) and pause states' (#1864) words. */\nconst APPROVAL_LABEL_NAMESPACES = [LabellingTypes.SYSTEM_ENUMS];\n\n//===============================================================\n//  FlowsActors_ApprovalRequest\n//\n//  A decision answered in the conversation it was raised in.\n//===============================================================\n\nexport type FlowsActors_ApprovalRequestProps = Omit<\n  AI_ApprovalRequestProps,\n  \"approvalId\" | \"actionDescription\" | \"riskLevel\" | \"onApprove\" | \"onDeny\" | \"onEscalate\" | \"answerable\"\n> & {\n  executionId: string;\n};\n\nexport function FlowsActors_ApprovalRequest({\n  executionId,\n  ...props\n}: FlowsActors_ApprovalRequestProps): React.JSX.Element | null {\n  const { executions, respondToApproval } = useFlowsActors();\n  const { tComponent, tSystemEnum } = useI18n({ component: FrontendComponentType.LOW_LEVEL_AI_APPROVAL, keys: APPROVAL_LABEL_NAMESPACES });\n  const [processingId, setProcessingId] = React.useState<string | null>(null);\n  const execution = executions.get(executionId);\n  const pendingApproval = execution?.pendingApproval;\n\n  // Every hook runs BEFORE the early return below. React requires the same hooks on every render, and the render\n  // that clears `pendingApproval` — the moment a decision is answered — used to run three fewer (#534 fourth\n  // review F1).\n  const handleApprove = React.useCallback((id: string, comment?: string, modifiedToolArgs?: Record<string, unknown>, reasonCode?: string) => {\n    setProcessingId(id);\n    // The reason rides only when given, so an answer without one keeps the call shape it always had.\n    respondToApproval(executionId, id, true, comment, modifiedToolArgs, ...(reasonCode ? [reasonCode] : []));\n  }, [executionId, respondToApproval]);\n\n  const handleDeny = React.useCallback((id: string, comment?: string, reasonCode?: string) => {\n    setProcessingId(id);\n    if (reasonCode) respondToApproval(executionId, id, false, comment, undefined, reasonCode);\n    else respondToApproval(executionId, id, false, comment);\n  }, [executionId, respondToApproval]);\n\n  // A decision answered and then handed BACK arrives as a new pending approval — a refused edit (#587), or a\n  // decision the consent requirement refused (#534). Whatever this component recorded as in flight has been\n  // answered, so the decision is answerable again instead of staying disabled until the view remounts.\n  React.useEffect(() => {\n    setProcessingId(null);\n  }, [pendingApproval]);\n\n  if (!execution || !pendingApproval) return null;\n\n  const {\n    approvalId, actionDescription, riskLevel, expiresAt, requiredRoles, toolName, toolArgs, toolInputSchema, modificationRefusal,\n    rejectedToolArgs, routeKind, reasonCodes, reasonCodeRefused,\n  } = pendingApproval;\n  /*\n   * Only an OWNER-routed decision is answered here. One routed to an assignee or a role is answered by a\n   * reviewer from their inbox, and the person whose conversation this is may not answer it (separation of\n   * duties, #1594) — so it shows as waiting, with nothing to press that the server would refuse.\n   *\n   * There is no Escalate here either. It used to send a DENIAL prefixed `[ESCALATED]`, which refused the call\n   * and escalated nothing; an OWNER route cannot be escalated at all, and a reviewer escalates from the inbox.\n   */\n  const answerable = routeKind === undefined || routeKind === HumanDecision_RouteKind.OWNER;\n\n  return (\n    <AI_ApprovalRequest\n      approvalId={approvalId}\n      actionDescription={actionDescription}\n      riskLevel={riskLevel}\n      executionId={executionId}\n      systemRef={execution.systemRef}\n      expiresAt={expiresAt}\n      requiredRoles={requiredRoles}\n      answerable={answerable}\n      // A refused reason code leaves the approval standing (#1921): it is back on screen, and says why in its own labels.\n      actionNotice={!answerable\n        ? tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, \"awaitingReview\")\n        : reasonCodeRefused ? tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, \"noticeReasonCodeRejected\") : undefined}\n      reasonCodeOptions={answerable ? describeReasonCodeOptions(reasonCodes, tSystemEnum) : undefined}\n      /*\n       * The tool call is WHAT is being approved, and until #528 it did not reach the browser at all.\n       * `toolArgs` are the proposed arguments — a person approving \"rename this record\" is approving\n       * a specific new title, and an approval surface that hides them is asking for a signature on an\n       * unread document.\n       *\n       * #566 built the carrier for an edited call: the payload takes `modifiedToolArgs`, the server\n       * re-validates them against the tool's own `inputSchema`, re-signs the approval over them and\n       * records that the decider changed them. So the editor is offered here, where the decision is\n       * answered — never where it is only shown.\n       */\n      allowArgumentModification={answerable}\n      toolName={toolName}\n      executionContext={toolArgs}\n      argumentsSchema={toolInputSchema}\n      // The refusal in the approval's own labels, naming the tool and the offending arguments (#1186).\n      argumentModificationError={modificationRefusal\n        ? describeApprovalModificationRefusal(modificationRefusal, (labelRef, params) => tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, labelRef, params))\n        : undefined}\n      rejectedArguments={rejectedToolArgs}\n      onApprove={handleApprove}\n      onDeny={handleDeny}\n      // Released by the effect above whenever the approval is handed back. Not released while the socket is\n      // disconnected: `respondToApproval` then sends nothing and leaves the approval exactly as it was, so its\n      // identity never changes — a stuck state that predates #534 and is cured by the view remounting.\n      isProcessing={processingId === approvalId}\n      {...props}\n    />\n  );\n}\n\n//===============================================================\n//  FlowsActors_ApprovalQueue\n//\n//  The person's inbox: every decision they may act on, from the server.\n//===============================================================\n\n/**\n * What one inbox card SAYS, per plane. A tool approval names the tool (an identifier, travelling as a parameter)\n * and shows its proposed arguments; an expert admission (#1612) says which firm asks to admit which person, in the\n * approval's own words, and shows no argument table — there is no tool, and the client's own data is not on the card.\n */\nfunction describeInboxCard(\n  card: HumanDecision_PendingCard,\n  t: (labelRef: string, params?: Record<string, string>) => string,\n  roleLabel: (roleKey: string) => string = (roleKey) => roleKey,\n): Pick<AI_ApprovalQueueItem, 'actionDescription' | 'toolName' | 'executionContext'> {\n  const admission = card.plane === HumanDecision_Plane.SERVICE_PROVIDER_EXPERT_ADMISSION ? card.serviceProviderExpertAdmission : undefined;\n  if (admission) {\n    // Names and email are DATA the firm and its expert supplied; the firm's id and the expert's id stand in when unreadable.\n    // The role and the scope are what the approver is granting, so the line names both (#1612 review L3). The role is\n    // worded by the roles label tree (`tRole`), never shown as its identifier; the scope by its own label.\n    const unitCount = admission.organizationUnitIds?.length ?? 0;\n    return {\n      actionDescription: t(\"inboxExpertAdmission\", {\n        firm: admission.providerOrganizationName ?? admission.providerOrganizationId,\n        expert: admission.expertName ?? admission.expertEmail ?? admission.expertUserId,\n        email: admission.expertEmail ?? admission.expertUserId,\n        role: roleLabel(admission.role),\n        scope: unitCount > 0 ? t(\"inboxExpertAdmissionScopeUnits\", { count: String(unitCount) }) : t(\"inboxExpertAdmissionScopeOrganization\"),\n      }),\n    };\n  }\n  return {\n    // The words are the approval's own label; the tool name is an identifier and travels as a parameter.\n    actionDescription: t(\"inboxToolCall\", { toolName: card.toolName }),\n    toolName: card.toolName,\n    executionContext: card.toolArgs,\n  };\n}\n\nexport type FlowsActors_ApprovalQueueProps = Omit<\n  AI_ApprovalQueueProps,\n  \"items\" | \"onApprove\" | \"onDeny\" | \"onEscalate\" | \"onClaim\" | \"onUnclaim\" | \"onReassignOpen\" | \"onReassign\" | \"onPauseClock\" | \"onResumeClock\" | \"processingIds\"\n>;\n\nexport function FlowsActors_ApprovalQueue(props: FlowsActors_ApprovalQueueProps): React.JSX.Element {\n  const { decisions, act, candidates } = usePendingDecisions();\n  const { tComponent, tRole, tSystemEnum, formatDateTime } = useI18n({ component: FrontendComponentType.LOW_LEVEL_AI_APPROVAL, keys: APPROVAL_LABEL_NAMESPACES });\n  const t = React.useCallback(\n    (labelRef: string, params?: Record<string, string>) => tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, labelRef as never, params),\n    [tComponent],\n  );\n  // Keyed by decisionRef: a decision is in flight from the act until its outcome returns.\n  const [processing, setProcessing] = React.useState<ReadonlySet<string>>(() => new Set());\n  const [notices, setNotices] = React.useState<ReadonlyMap<string, string>>(() => new Map());\n  const [reassignCandidates, setReassignCandidates] = React.useState<ReadonlyMap<string, readonly AI_ApprovalReassignCandidate[]>>(() => new Map());\n\n  const run = React.useCallback(async (decisionRef: string, decisionAct: HumanDecision_Act, request: HumanDecision_ActRequest) => {\n    setProcessing((previous) => new Set(previous).add(decisionRef));\n    try {\n      const outcome = await act(decisionRef, decisionAct, request);\n      const notice = noticeOfOutcome(outcome, t);\n      setNotices((previous) => {\n        const next = new Map(previous);\n        if (notice === undefined) next.delete(decisionRef); else next.set(decisionRef, notice);\n        return next;\n      });\n    } catch {\n      // Not an outcome the server reported (a network failure): say it did not take, and leave it answerable.\n      setNotices((previous) => new Map(previous).set(decisionRef, t(\"noticeNotActionable\")));\n    } finally {\n      setProcessing((previous) => {\n        const next = new Set(previous);\n        next.delete(decisionRef);\n        return next;\n      });\n    }\n  }, [act, t]);\n\n  const items: AI_ApprovalQueueItem[] = React.useMemo(() => decisions.map((card) => ({\n    approvalId: card.decisionRef,\n    executionId: card.executionId,\n    systemRef: card.systemRef,\n    ...describeInboxCard(card, t, (roleKey) => (tRole ? tRole(roleKey, 'label') : roleKey)),\n    expiresAt: card.expiresAt ? new Date(card.expiresAt) : undefined,\n    createdAt: new Date(card.requestedAt),\n    // Only the acts the server says this person may perform — computed with the rule every act is checked by.\n    // The inbox's Escalate names nobody, so it is offered only where the gate declares where escalations go;\n    // handing it to a person of the reviewer's choosing is Reassign.\n    canEscalate: card.permittedActs.includes(HumanDecision_Act.ESCALATE) && card.declaresEscalationTarget,\n    canClaim: card.permittedActs.includes(HumanDecision_Act.CLAIM),\n    canUnclaim: card.permittedActs.includes(HumanDecision_Act.UNCLAIM),\n    canReassign: card.permittedActs.includes(HumanDecision_Act.REASSIGN),\n    reassignCandidates: reassignCandidates.get(card.decisionRef),\n    actionNotice: notices.get(card.decisionRef),\n    // #1628 — the next deadline, or why its deadlines are paused; Pause only with a declared reason to name.\n    canPauseClock: card.permittedActs.includes(HumanDecision_Act.PAUSE_CLOCK) && !card.clockPause && card.pauseStates.length > 0,\n    canResumeClock: card.permittedActs.includes(HumanDecision_Act.RESUME_CLOCK) && !!card.clockPause,\n    // A pause state is the APPLICATION's identifier, shown as its word (#1864) — see `describePauseState`.\n    pauseStateOptions: card.pauseStates.map((pauseState) => ({ value: pauseState, label: describePauseState(pauseState, tSystemEnum) })),\n    deadlineNotice: card.nextDeadline\n      ? t(card.nextDeadline.kind === ReviewDeadlineKind.CLAIM ? \"deadlineClaimBy\" : \"deadlineDecisionBy\", { when: formatDateTime(card.nextDeadline.dueAt) })\n      : undefined,\n    clockPausedNotice: card.clockPause ? t(\"clockPausedIn\", { pauseState: describePauseState(card.clockPause.pauseStateRef, tSystemEnum) }) : undefined,\n    // #1921 — the reviewer may give a reason from the application's vocabulary when correcting the agent, and may\n    // CORRECT it by editing the call: the act request carries `modifiedToolArgs`, which the server re-validates against\n    // the tool's own schema. Only on a tool approval — an expert admission has no call to edit and no agent to correct.\n    reasonCodeOptions: describeReasonCodeOptions(card.reasonCodes, tSystemEnum),\n    allowArgumentModification: card.plane === HumanDecision_Plane.CONVERSATIONAL,\n    argumentsSchema: card.toolInputSchema as SerializableZodSchema | undefined,\n  })), [decisions, reassignCandidates, notices, t, tRole, tSystemEnum, formatDateTime]);\n\n  /**\n   * An answer in the one answer shape: the option chosen, and no values. Which option refs \"approve\" and \"deny\" mean\n   * depends on the decision's plane — a tool approval's, or an expert admission's (#1612) — so the card decides.\n   */\n  const answer = React.useCallback((decisionRef: string, approve: boolean, comment?: string, modifiedToolArgs?: Record<string, unknown>, reasonCode?: string) => {\n    const plane = decisions.find((card) => card.decisionRef === decisionRef)?.plane;\n    const optionRef = plane === HumanDecision_Plane.SERVICE_PROVIDER_EXPERT_ADMISSION\n      ? (approve ? ServiceProviderExpertApprovalOption.APPROVE : ServiceProviderExpertApprovalOption.REJECT)\n      : (approve ? HumanDecision_ToolApprovalOption.APPROVE : HumanDecision_ToolApprovalOption.DENY);\n    void run(decisionRef, HumanDecision_Act.ANSWER, {\n      answer: { decisionId: decisionRef, optionRef, values: [] },\n      ...(comment ? { reason: comment } : {}),\n      // Only when the reviewer edited the call: an absent field means \"run it as proposed\" (#566).\n      ...(modifiedToolArgs ? { modifiedToolArgs } : {}),\n      // Why the reviewer corrected the agent (#1921); refused with REASON_CODE_REJECTED unless the application declares it.\n      ...(reasonCode ? { reasonCode } : {}),\n    });\n  }, [run, decisions]);\n\n  const handleReassignOpen = React.useCallback((decisionRef: string) => {\n    setReassignCandidates((previous) => {\n      const next = new Map(previous);\n      next.delete(decisionRef);\n      return next;\n    });\n    void candidates(decisionRef)\n      .then((people) => setReassignCandidates((previous) => new Map(previous).set(\n        decisionRef,\n        // The membership's email is how a same-organization reviewer tells people apart; it is data, not a label.\n        people.map((person) => ({ value: person.userId, label: person.email ?? person.userId })),\n      )))\n      .catch(() => setReassignCandidates((previous) => new Map(previous).set(decisionRef, [])));\n  }, [candidates]);\n\n  return (\n    <AI_ApprovalQueue\n      items={items}\n      onApprove={(decisionRef, comment, modifiedToolArgs, reasonCode) => answer(decisionRef, true, comment, modifiedToolArgs, reasonCode)}\n      onDeny={(decisionRef, comment, reasonCode) => answer(decisionRef, false, comment, undefined, reasonCode)}\n      onEscalate={(decisionRef, comment) => void run(decisionRef, HumanDecision_Act.ESCALATE, comment ? { reason: comment } : {})}\n      onClaim={(decisionRef) => void run(decisionRef, HumanDecision_Act.CLAIM, {})}\n      onUnclaim={(decisionRef) => void run(decisionRef, HumanDecision_Act.UNCLAIM, {})}\n      onReassignOpen={handleReassignOpen}\n      onReassign={(decisionRef, targetUserId, comment) => void run(decisionRef, HumanDecision_Act.REASSIGN, { targetUserId, ...(comment ? { reason: comment } : {}) })}\n      onPauseClock={(decisionRef, pauseStateRef) => void run(decisionRef, HumanDecision_Act.PAUSE_CLOCK, { pauseStateRef })}\n      onResumeClock={(decisionRef) => void run(decisionRef, HumanDecision_Act.RESUME_CLOCK, {})}\n      processingIds={processing as Set<string>}\n      {...props}\n    />\n  );\n}\n\n//===============================================================\n//  FlowsActors_DecisionRequest\n//\n//  A decision with named options, answered in the one answer shape (#1594 D12).\n//===============================================================\n\nexport type FlowsActors_DecisionRequestProps = Omit<AI_DecisionRequestProps, \"onSelect\"> & {\n  /** Told what the answer came to — nothing on success, a localized notice otherwise. */\n  onOutcome?: (notice: string | undefined) => void;\n};\n\nexport function FlowsActors_DecisionRequest({ onOutcome, ...props }: FlowsActors_DecisionRequestProps): React.JSX.Element {\n  const { act } = usePendingDecisions({ list: false });\n  const { tComponent } = useI18n({ component: FrontendComponentType.LOW_LEVEL_AI_APPROVAL });\n\n  const handleSelect = React.useCallback((decisionId: string, optionId: string) => {\n    void act(decisionId, HumanDecision_Act.ANSWER, { answer: { decisionId, optionRef: optionId, values: [] } })\n      .then((outcome) => onOutcome?.(noticeOfOutcome(outcome, (ref) => tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, ref as never))));\n  }, [act, onOutcome, tComponent]);\n\n  return <AI_DecisionRequest {...props} onSelect={handleSelect} />;\n}\n\n//===============================================================\n//  FlowsActors_HumanInputRequest\n//\n//  A free-text question, answered in the one answer shape: the option that proceeds with the value, and the\n//  value under the field it answers.\n//===============================================================\n\nexport type FlowsActors_HumanInputRequestProps = Omit<AI_HumanInputRequestProps, \"onSubmit\"> & {\n  /** The decision's option that proceeds WITH values — the one a submitted answer chooses. */\n  optionRef: string;\n  /** The decision's field this input answers. */\n  fieldRef: string;\n  onOutcome?: (notice: string | undefined) => void;\n};\n\nexport function FlowsActors_HumanInputRequest({ optionRef, fieldRef, onOutcome, ...props }: FlowsActors_HumanInputRequestProps): React.JSX.Element {\n  const { act } = usePendingDecisions({ list: false });\n  const { tComponent } = useI18n({ component: FrontendComponentType.LOW_LEVEL_AI_APPROVAL });\n\n  const handleSubmit = React.useCallback((requestId: string, value: string) => {\n    void act(requestId, HumanDecision_Act.ANSWER, { answer: { decisionId: requestId, optionRef, values: [{ ref: fieldRef, value }] } })\n      .then((outcome) => onOutcome?.(noticeOfOutcome(outcome, (ref) => tComponent(FrontendComponentType.LOW_LEVEL_AI_APPROVAL, ref as never))));\n  }, [act, optionRef, fieldRef, onOutcome, tComponent]);\n\n  return <AI_HumanInputRequest {...props} onSubmit={handleSubmit} />;\n}\n"]}

package/dist/esm/components/flows-actors/approval.labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval.labels.d.ts","sourceRoot":"","sources":["../../../../../src/components/flows-actors/approval.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,wBAAwB,EAAE,mBAAmB,EA8DzD,CAAC"}
+{"version":3,"file":"approval.labels.d.ts","sourceRoot":"","sources":["../../../../src/components/flows-actors/approval.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,wBAAwB,EAAE,mBAAmB,EAuHzD,CAAC"}

package/dist/esm/components/flows-actors/approval.labels.js

@@ -7,6 +7,63 @@ export const LowLevelAiApprovalLabels = [
     { ref: 'deny', kind: LabelKind.BUTTON, purpose: 'Button to deny the pending request' },
     { ref: 'escalate', kind: LabelKind.BUTTON, purpose: 'Button to escalate the request to a higher approver' },
     { ref: 'queueTitle', kind: LabelKind.HEADING, purpose: 'Heading for the approval queue' },
+    // #1594 — moving a decision between people, and what an act came to.
+    { ref: 'claim', kind: LabelKind.BUTTON, purpose: 'Button taking a request routed to a role the person holds, so it is theirs to answer' },
+    { ref: 'unclaim', kind: LabelKind.BUTTON, purpose: 'Button giving a request the person claimed back to everyone holding its role' },
+    { ref: 'reassign', kind: LabelKind.BUTTON, purpose: 'Button opening a choice of who else this request should go to' },
+    { ref: 'reassignTarget', kind: LabelKind.PLACEHOLDER, purpose: 'Placeholder of the list of people this request can be handed to' },
+    { ref: 'reassignConfirm', kind: LabelKind.BUTTON, purpose: 'Button handing the request to the person chosen' },
+    { ref: 'reassignNoCandidates', kind: LabelKind.MESSAGE, purpose: 'Shown when nobody else can answer this request, so it cannot be handed on' },
+    // #1628 — a request's deadlines, and stopping its clocks while the reviewer waits on something outside their control.
+    { ref: 'deadlineClaimBy', kind: LabelKind.MESSAGE, purpose: 'Line on a waiting request saying by when someone should take it on', params: [{ key: 'when', meaning: 'the date and time it should be taken by, already formatted for the reader' }] },
+    { ref: 'deadlineDecisionBy', kind: LabelKind.MESSAGE, purpose: 'Line on a waiting request saying by when it should be answered', params: [{ key: 'when', meaning: 'the date and time it should be answered by, already formatted for the reader' }] },
+    { ref: 'clockPausedIn', kind: LabelKind.MESSAGE, purpose: 'Line on a waiting request whose deadlines are paused, naming why; the request still expires at its original time', params: [{ key: 'pauseState', meaning: 'the reason the deadlines are paused, as the application names it' }] },
+    { ref: 'pauseClock', kind: LabelKind.BUTTON, purpose: 'Button stopping the request\'s deadlines while the reviewer waits on something outside their control; it does not stop the request expiring' },
+    { ref: 'pauseClockState', kind: LabelKind.PLACEHOLDER, purpose: 'Placeholder of the list of reasons the deadlines can be paused for' },
+    { ref: 'pauseClockConfirm', kind: LabelKind.BUTTON, purpose: 'Button confirming the pause for the reason chosen' },
+    { ref: 'resumeClock', kind: LabelKind.BUTTON, purpose: 'Button restarting the request\'s paused deadlines; the paused time is added to them' },
+    { ref: 'noticeClockAlreadyPaused', kind: LabelKind.MESSAGE, purpose: 'Shown when the deadlines were already paused, so this pause did nothing' },
+    { ref: 'noticeClockNotPaused', kind: LabelKind.MESSAGE, purpose: 'Shown when the deadlines were not paused, so there was nothing to restart' },
+    { ref: 'noticePauseStateNotDeclared', kind: LabelKind.MESSAGE, purpose: 'Shown when the reason chosen for pausing is not one this request allows' },
+    {
+        ref: 'inboxToolCall',
+        kind: LabelKind.MESSAGE,
+        purpose: 'One line describing a request waiting in the inbox: an assistant is waiting for approval to run an action',
+        params: [{ key: 'toolName', meaning: 'name of the action the assistant wants to run, as the system names it' }],
+    },
+    {
+        ref: 'inboxExpertAdmission',
+        kind: LabelKind.MESSAGE,
+        purpose: 'One line describing a request waiting in an administrator\'s inbox: a service firm assigned one of its people to work inside this organization with a given role and scope, and they are admitted only if an administrator approves. Must name the role and the scope: they are what the approver grants',
+        params: [
+            { key: 'firm', meaning: 'name of the service firm that assigned the person' },
+            { key: 'expert', meaning: 'name of the person the firm assigned' },
+            { key: 'email', meaning: 'email address of the person the firm assigned' },
+            { key: 'role', meaning: 'the name of the role the person would hold in this organization (already worded)' },
+            { key: 'scope', meaning: 'where in this organization the person would work: the whole organization, or a number of teams (already worded)' },
+        ],
+    },
+    { ref: 'inboxExpertAdmissionScopeOrganization', kind: LabelKind.MESSAGE, purpose: 'Noun phrase, no leading preposition, filling the scope of the inbox line for a firm\'s person: the whole organization (for example "the whole organization")' },
+    {
+        ref: 'inboxExpertAdmissionScopeUnits',
+        kind: LabelKind.MESSAGE,
+        purpose: 'Noun phrase, no leading preposition, filling the scope of the inbox line for a firm\'s person: only some of the organization\'s teams (for example "3 teams")',
+        params: [{ key: 'count', meaning: 'how many teams' }],
+    },
+    { ref: 'awaitingReview', kind: LabelKind.MESSAGE, purpose: 'Shown on a request in the conversation it came from when a reviewer answers it, not the person in the conversation' },
+    { ref: 'noticeNotActionable', kind: LabelKind.MESSAGE, purpose: 'Shown when the request can no longer be acted on by this person: it was settled, or is no longer theirs' },
+    { ref: 'noticeSuperseded', kind: LabelKind.MESSAGE, purpose: 'Shown when someone else answered or moved the request a moment earlier, so this action did nothing' },
+    { ref: 'noticeLapsed', kind: LabelKind.MESSAGE, purpose: 'Shown when the request expired before it was answered, so it is closed and the action did not run' },
+    { ref: 'noticeRequesterAuthorityLapsed', kind: LabelKind.MESSAGE, purpose: 'Shown when the person the work was for no longer has the access it needs, so it was not run and the request is closed' },
+    { ref: 'noticeTargetRefused', kind: LabelKind.MESSAGE, purpose: 'Shown when the person chosen cannot answer this request, so it stays where it was' },
+    { ref: 'noticeNoEscalationTarget', kind: LabelKind.MESSAGE, purpose: 'Shown when there is nobody defined to escalate this request to, so it stays where it was; hand it to someone instead' },
+    { ref: 'noticeConsentRequired', kind: LabelKind.MESSAGE, purpose: 'Shown when the person the work was for has not agreed to something this work needs; the request is still waiting' },
+    { ref: 'noticeModificationRejected', kind: LabelKind.MESSAGE, purpose: 'Shown when edited arguments were refused; the request is still waiting and can be answered as proposed' },
+    { ref: 'noticeReasonCodeRejected', kind: LabelKind.MESSAGE, purpose: 'Shown when the reason given is not one the application offers; the request is still waiting and can be answered again' },
+    // #1921 — why the approver changed or rejected an assistant's proposed action, chosen from the application's own reasons.
+    { ref: 'reasonCode', kind: LabelKind.PLACEHOLDER, purpose: 'Placeholder of the optional list of reasons for changing or rejecting the assistant\'s proposed action, as the application defines them' },
+    { ref: 'reasonCodeClear', kind: LabelKind.BUTTON, purpose: 'Button removing the reason chosen, so the answer is given without one' },
+    { ref: 'denyConfirm', kind: LabelKind.BUTTON, purpose: 'Button rejecting the proposed action, with the reason chosen if any' },
     { ref: 'riskLow', kind: LabelKind.MESSAGE, purpose: 'Risk badge for a low-risk approval request' },
     { ref: 'riskMedium', kind: LabelKind.MESSAGE, purpose: 'Risk badge for a medium-risk approval request' },
     { ref: 'riskHigh', kind: LabelKind.MESSAGE, purpose: 'Risk badge for a high-risk approval request' },