@wildo-ai/saas-frontend-lib 1.1.10 → 1.1.11

package/dist/esm/core/flows-actors/usePendingDecisions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePendingDecisions.d.ts","sourceRoot":"","sources":["../../../../src/core/flows-actors/usePendingDecisions.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAE9B,KAAK,+BAA+B,EAGrC,MAAM,uBAAuB,CAAC;AAwB/B,MAAM,WAAW,qBAAqB;IACpC,uGAAuG;IACvG,QAAQ,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,2GAA2G;IAC3G,QAAQ,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACpI,+GAA+G;IAC/G,QAAQ,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,+BAA+B,EAAE,CAAC,CAAC;CACnG;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,0BAA0B;IACzC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,qBAAqB,CA8DnG"}
+{"version":3,"file":"usePendingDecisions.d.ts","sourceRoot":"","sources":["../../../../../src/core/flows-actors/usePendingDecisions.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAE9B,KAAK,+BAA+B,EAGpC,KAAK,sCAAsC,EAE5C,MAAM,uBAAuB,CAAC;AAS/B;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,yBAAyB,EAAE,EAC3C,SAAS,EAAE,sCAAsC,GAChD,SAAS,yBAAyB,EAAE,CAItC;AAYD;;;GAGG;AACH,oBAAY,yBAAyB;IACnC,sFAAsF;IACtF,OAAO,YAAY;IACnB,sEAAsE;IACtE,KAAK,UAAU;IACf;;;OAGG;IACH,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,uGAAuG;IACvG,QAAQ,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACzD,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,gHAAgH;IAChH,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,2GAA2G;IAC3G,QAAQ,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACpI,+GAA+G;IAC/G,QAAQ,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,+BAA+B,EAAE,CAAC,CAAC;CACnG;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,IAAI,qBAAqB,CAyG3D"}

package/dist/esm/core/flows-actors/usePendingDecisions.js

@@ -1,14 +1,20 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { CoreWebSocketEvent, HumanDecision_ActOutcomeKind, MAIN_API_BASE_PATH, MANUAL_CONTROLLER_ROUTES_URLS, ManualControllerRouteKey, } from '@wildo-ai/saas-models';
+import { CoreWebSocketEvent, HumanDecision_ActOutcomeKind, MAIN_API_BASE_PATH, ManualControllerRouteKey, buildManualControllerRoutePath, } from '@wildo-ai/saas-models';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
 import { useApplication } from '../../core/runtime/useApplication.js';
 import { useWebSocket } from '../../core/requests/websockets/useWebSocket.js';
-const logDebug = LoggerFrontendService.getLogger().debugByType('FlowsActorsDecisions');
-/** A route template's `:param` segments, filled — encoded, so a decision id is never read as a path. */
-function fillRoute(template, params) {
-    return template.replace(/:([A-Za-z]+)/g, (_segment, name) => encodeURIComponent(params[name] ?? ''));
-}
+const logger = LoggerFrontendService.getLogger();
 const OUTCOME_KINDS = new Set(Object.values(HumanDecision_ActOutcomeKind));
+/**
+ * The cards a withdrawal leaves standing (#2569): every card but the one for that decision at a route version older
+ * than the one it moved to (any version, when it ended). A card already at the new version was re-read after the move
+ * and is current, so the person who claimed a decision keeps it while their colleagues lose it.
+ */
+export function cardsAfterWithdrawal(cards, withdrawn) {
+    const stale = (card) => card.decisionRef === withdrawn.decisionRef
+        && (withdrawn.routeVersion === undefined || card.routeVersion < withdrawn.routeVersion);
+    return cards.some(stale) ? cards.filter((card) => !stale(card)) : cards;
+}
 /**
  * The outcome a refusal carries. The act route answers a refusal with a non-2xx status AND the outcome as its
  * body (404 for "not yours, missing or settled", 409 for a lost race, 422 for a refused edit…), so the body is
@@ -18,53 +24,118 @@ function outcomeOfRefusal(error) {
     const data = error?.response?.data;
     return data && typeof data.kind === 'string' && OUTCOME_KINDS.has(data.kind) ? data : undefined;
 }
-export function usePendingDecisions(options = {}) {
-    const list = options.list ?? true;
+/**
+ * Where the inbox's read of the server list stands (#2526). Three states a reader must be able to tell apart, because each
+ * calls for something different from them: wait, retry, or nothing to do.
+ */
+export var PendingDecisionsReadState;
+(function (PendingDecisionsReadState) {
+    /** No read has settled yet. An inbox shows a placeholder, never "nothing pending". */
+    PendingDecisionsReadState["LOADING"] = "loading";
+    /** The last read succeeded: `decisions` is what the server listed. */
+    PendingDecisionsReadState["READY"] = "ready";
+    /**
+     * The last read failed. `decisions` keeps what an earlier read listed (empty when none succeeded), so an inbox can say
+     * the list may be out of date and offer `refresh`. Every act is re-checked by the server, so acting on it stays safe.
+     */
+    PendingDecisionsReadState["FAILED"] = "failed";
+})(PendingDecisionsReadState || (PendingDecisionsReadState = {}));
+/**
+ * The pending decisions the signed-in person may act on, read from the SERVER (#1594 D6, D12).
+ *
+ * The inbox used to be assembled from live socket announcements on this page alone, so a reload — or a
+ * decision routed to a reviewer who never saw the conversation — showed nothing. The server list is the
+ * one source: it covers every conversation, it re-checks each card with the rule an act is checked with,
+ * and it survives a reload.
+ *
+ * Refreshed when the server announces a decision routed to this person (`flows-actors:decision-routed`: to their own
+ * room for one assigned to them or raised by them, to their role's room for one waiting on a role they hold) and after
+ * every act this hook sends. When the server announces a decision LEFT this
+ * person (`flows-actors:decision-withdrawn`, #2569: claimed by a colleague, moved, answered, stopped or lapsed), its
+ * card goes at once — before the re-read, so nobody acts on it in between — and the list is re-read. Except while this
+ * hook is acting on that decision itself: the act re-reads when it returns, and the person acting keeps their card.
+ *
+ * It had a `list: false` mode for a component that answered one named-option or free-text decision it held. Both
+ * such components were folded into the inbox (#2526), which answers a named-option decision from its own card, and
+ * the mode went with them.
+ */
+export function usePendingDecisions() {
     const { httpClient } = useApplication();
     const { on } = useWebSocket();
     const [decisions, setDecisions] = useState([]);
     const [isLoading, setIsLoading] = useState(false);
+    const [readState, setReadState] = useState(PendingDecisionsReadState.LOADING);
     const mounted = useRef(true);
+    /** The decisions an act from this hook is in flight on: their withdrawal is this person's own act, read back after it. */
+    const actingOn = useRef(new Set());
+    /** The cards as last set, so a withdrawal can tell whether it dropped anything before it asks the server again. */
+    const shown = useRef(decisions);
+    /**
+     * Which read is the latest (#2569 review A-6). Several reads can be out at once — after an act, and after each
+     * announcement — and only the one asked LAST may set the list, so an earlier answer arriving late cannot put back a
+     * card a later read or a withdrawal took away.
+     */
+    const readGeneration = useRef(0);
+    /** How many reads are out. A withdrawal that drops nothing still re-reads while one is, so it cannot answer stale. */
+    const readsInFlight = useRef(0);
+    const showDecisions = useCallback((next) => {
+        shown.current = next;
+        setDecisions(next);
+    }, []);
     const refresh = useCallback(async () => {
-        if (!httpClient || !list)
+        if (!httpClient)
             return;
+        const generation = ++readGeneration.current;
+        readsInFlight.current += 1;
         setIsLoading(true);
         try {
-            const path = `${MAIN_API_BASE_PATH}${MANUAL_CONTROLLER_ROUTES_URLS[ManualControllerRouteKey.FLOWS_ACTORS_DECISIONS]}`;
+            const path = `${MAIN_API_BASE_PATH}${buildManualControllerRoutePath(ManualControllerRouteKey.FLOWS_ACTORS_DECISIONS)}`;
             const data = await httpClient.get(path, { silent: true });
-            if (mounted.current)
-                setDecisions(data?.decisions ?? []);
+            if (mounted.current && generation === readGeneration.current) {
+                showDecisions(data?.decisions ?? []);
+                setReadState(PendingDecisionsReadState.READY);
+            }
         }
         catch (error) {
-            // No list is shown as no list, and logged: a failure here must not look like an empty inbox forever.
-            logDebug('Pending decisions could not be read', { error: error instanceof Error ? error.message : 'unknown' });
+            // A failed read is a state the inbox SHOWS (#2526): it used to be logged at debug level and rendered exactly like an
+            // empty inbox, so a reviewer with decisions waiting was told there were none.
+            logger.warn('Pending decisions could not be read', { error: error instanceof Error ? error.message : 'unknown' });
+            if (mounted.current && generation === readGeneration.current)
+                setReadState(PendingDecisionsReadState.FAILED);
         }
         finally {
-            if (mounted.current)
+            readsInFlight.current -= 1;
+            if (mounted.current && generation === readGeneration.current)
                 setIsLoading(false);
         }
-    }, [httpClient, list]);
+    }, [httpClient, showDecisions]);
     const act = useCallback(async (decisionRef, act, request) => {
         if (!httpClient)
             return { kind: HumanDecision_ActOutcomeKind.NOT_ACTIONABLE };
-        const path = `${MAIN_API_BASE_PATH}${fillRoute(MANUAL_CONTROLLER_ROUTES_URLS[ManualControllerRouteKey.FLOWS_ACTORS_DECISION_ACT], { decisionRef, act })}`;
+        const path = `${MAIN_API_BASE_PATH}${buildManualControllerRoutePath(ManualControllerRouteKey.FLOWS_ACTORS_DECISION_ACT, { decisionRef, act })}`;
         let outcome;
+        actingOn.current.add(decisionRef);
         try {
-            outcome = await httpClient.post(path, request, { silent: true });
+            try {
+                outcome = await httpClient.post(path, request, { silent: true });
+            }
+            catch (error) {
+                const refused = outcomeOfRefusal(error);
+                if (!refused)
+                    throw error;
+                outcome = refused;
+            }
+            await refresh();
         }
-        catch (error) {
-            const refused = outcomeOfRefusal(error);
-            if (!refused)
-                throw error;
-            outcome = refused;
+        finally {
+            actingOn.current.delete(decisionRef);
         }
-        await refresh();
         return outcome;
     }, [httpClient, refresh]);
     const candidates = useCallback(async (decisionRef) => {
         if (!httpClient)
             return [];
-        const path = `${MAIN_API_BASE_PATH}${fillRoute(MANUAL_CONTROLLER_ROUTES_URLS[ManualControllerRouteKey.FLOWS_ACTORS_DECISION_CANDIDATES], { decisionRef })}`;
+        const path = `${MAIN_API_BASE_PATH}${buildManualControllerRoutePath(ManualControllerRouteKey.FLOWS_ACTORS_DECISION_CANDIDATES, { decisionRef })}`;
         try {
             const data = await httpClient.get(path, { silent: true });
             return data?.candidates ?? [];
@@ -77,15 +148,29 @@ export function usePendingDecisions(options = {}) {
     }, [httpClient]);
     useEffect(() => {
         mounted.current = true;
-        if (!list)
-            return () => { mounted.current = false; };
         void refresh();
         const unsubscribe = on(CoreWebSocketEvent.FLOWS_ACTORS_DECISION_ROUTED, () => { void refresh(); });
+        const unsubscribeWithdrawn = on(CoreWebSocketEvent.FLOWS_ACTORS_DECISION_WITHDRAWN, (withdrawn) => {
+            if (!withdrawn?.decisionRef || actingOn.current.has(withdrawn.decisionRef))
+                return;
+            // Nothing of it was shown, so there is nothing to take back and nothing to ask: every holder of a role gets this,
+            // and a re-read by each of them for a card they never had would be load for nothing. Unless a read is OUT: asked
+            // before the withdrawal, it may answer with the card, so a read asked after it supersedes it (#2528 review F6).
+            const remaining = cardsAfterWithdrawal(shown.current, withdrawn);
+            if (remaining === shown.current) {
+                if (readsInFlight.current > 0)
+                    void refresh();
+                return;
+            }
+            showDecisions(remaining);
+            void refresh();
+        });
         return () => {
             mounted.current = false;
             unsubscribe?.();
+            unsubscribeWithdrawn?.();
         };
-    }, [on, refresh, list]);
-    return { decisions, isLoading, refresh, act, candidates };
+    }, [on, refresh, showDecisions]);
+    return { decisions, isLoading, readState, refresh, act, candidates };
 }
 //# sourceMappingURL=usePendingDecisions.js.map

package/dist/esm/core/flows-actors/usePendingDecisions.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePendingDecisions.js","sourceRoot":"","sources":["../../../../../src/core/flows-actors/usePendingDecisions.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport {\n  CoreWebSocketEvent,\n  HumanDecision_ActOutcomeKind,\n  MAIN_API_BASE_PATH,\n  MANUAL_CONTROLLER_ROUTES_URLS,\n  ManualControllerRouteKey,\n  type HumanDecision_Act,\n  type HumanDecision_ActOutcome,\n  type HumanDecision_ActRequest,\n  type HumanDecision_PendingCard,\n  type HumanDecision_PendingListResponse,\n  type HumanDecision_ReassignCandidate,\n  type HumanDecision_ReassignCandidatesResponse,\n  type WS_FlowsActorsDecisionRoutedPayload,\n} from '@wildo-ai/saas-models';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useWebSocket } from '~wildo-frontend-lib/core/requests/websockets/useWebSocket';\n\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = LoggerFrontendService.getLogger().debugByType('FlowsActorsDecisions');\n\n/** A route template's `:param` segments, filled — encoded, so a decision id is never read as a path. */\nfunction fillRoute(template: string, params: Readonly<Record<string, string>>): string {\n  return template.replace(/:([A-Za-z]+)/g, (_segment, name: string) => encodeURIComponent(params[name] ?? ''));\n}\n\nconst OUTCOME_KINDS: ReadonlySet<string> = new Set(Object.values(HumanDecision_ActOutcomeKind));\n\n/**\n * The outcome a refusal carries. The act route answers a refusal with a non-2xx status AND the outcome as its\n * body (404 for \"not yours, missing or settled\", 409 for a lost race, 422 for a refused edit…), so the body is\n * read from the error rather than the status being turned into a guess.\n */\nfunction outcomeOfRefusal(error: unknown): HumanDecision_ActOutcome | undefined {\n  const data = (error as { response?: { data?: unknown } } | null)?.response?.data as { kind?: unknown } | undefined;\n  return data && typeof data.kind === 'string' && OUTCOME_KINDS.has(data.kind) ? (data as HumanDecision_ActOutcome) : undefined;\n}\n\nexport interface PendingDecisionsState {\n  /** The decisions the signed-in person may act on, soonest deadline first, as the server lists them. */\n  readonly decisions: readonly HumanDecision_PendingCard[];\n  readonly isLoading: boolean;\n  /** Re-read the list — after an act, and whenever a decision is routed to this person. */\n  readonly refresh: () => Promise<void>;\n  /** One act on one decision. Resolves to what it came to; a refusal is an outcome, never a thrown error. */\n  readonly act: (decisionRef: string, act: HumanDecision_Act, request: HumanDecision_ActRequest) => Promise<HumanDecision_ActOutcome>;\n  /** Who a decision may be moved to — only people who could answer it. Empty when the caller may not move it. */\n  readonly candidates: (decisionRef: string) => Promise<readonly HumanDecision_ReassignCandidate[]>;\n}\n\n/**\n * The pending decisions the signed-in person may act on, read from the SERVER (#1594 D6, D12).\n *\n * The inbox used to be assembled from live socket announcements on this page alone, so a reload — or a\n * decision routed to a reviewer who never saw the conversation — showed nothing. The server list is the\n * one source: it covers every conversation, it re-checks each card with the rule an act is checked with,\n * and it survives a reload.\n *\n * Refreshed when the server announces a decision routed to this person (`flows-actors:decision-routed`,\n * sent to their own room only) and after every act this hook sends.\n *\n * `list: false` is for a component that ANSWERS one decision it already holds (a named-option decision, a\n * free-text question): it acts, and neither reads nor subscribes to the inbox it does not show.\n */\nexport interface UsePendingDecisionsOptions {\n  /** Read and follow the inbox list. Defaults to true. */\n  readonly list?: boolean;\n}\n\nexport function usePendingDecisions(options: UsePendingDecisionsOptions = {}): PendingDecisionsState {\n  const list = options.list ?? true;\n  const { httpClient } = useApplication();\n  const { on } = useWebSocket();\n  const [decisions, setDecisions] = useState<readonly HumanDecision_PendingCard[]>([]);\n  const [isLoading, setIsLoading] = useState(false);\n  const mounted = useRef(true);\n\n  const refresh = useCallback(async (): Promise<void> => {\n    if (!httpClient || !list) return;\n    setIsLoading(true);\n    try {\n      const path = `${MAIN_API_BASE_PATH}${MANUAL_CONTROLLER_ROUTES_URLS[ManualControllerRouteKey.FLOWS_ACTORS_DECISIONS]}`;\n      const data = await httpClient.get<HumanDecision_PendingListResponse>(path, { silent: true });\n      if (mounted.current) setDecisions(data?.decisions ?? []);\n    } catch (error) {\n      // No list is shown as no list, and logged: a failure here must not look like an empty inbox forever.\n      logDebug('Pending decisions could not be read', { error: error instanceof Error ? error.message : 'unknown' });\n    } finally {\n      if (mounted.current) setIsLoading(false);\n    }\n  }, [httpClient, list]);\n\n  const act = useCallback(async (decisionRef: string, act: HumanDecision_Act, request: HumanDecision_ActRequest): Promise<HumanDecision_ActOutcome> => {\n    if (!httpClient) return { kind: HumanDecision_ActOutcomeKind.NOT_ACTIONABLE };\n    const path = `${MAIN_API_BASE_PATH}${fillRoute(MANUAL_CONTROLLER_ROUTES_URLS[ManualControllerRouteKey.FLOWS_ACTORS_DECISION_ACT], { decisionRef, act })}`;\n    let outcome: HumanDecision_ActOutcome;\n    try {\n      outcome = await httpClient.post<HumanDecision_ActOutcome>(path, request, { silent: true });\n    } catch (error) {\n      const refused = outcomeOfRefusal(error);\n      if (!refused) throw error;\n      outcome = refused;\n    }\n    await refresh();\n    return outcome;\n  }, [httpClient, refresh]);\n\n  const candidates = useCallback(async (decisionRef: string): Promise<readonly HumanDecision_ReassignCandidate[]> => {\n    if (!httpClient) return [];\n    const path = `${MAIN_API_BASE_PATH}${fillRoute(MANUAL_CONTROLLER_ROUTES_URLS[ManualControllerRouteKey.FLOWS_ACTORS_DECISION_CANDIDATES], { decisionRef })}`;\n    try {\n      const data = await httpClient.get<HumanDecision_ReassignCandidatesResponse>(path, { silent: true });\n      return data?.candidates ?? [];\n    } catch (error) {\n      if (outcomeOfRefusal(error)) return [];\n      throw error;\n    }\n  }, [httpClient]);\n\n  useEffect(() => {\n    mounted.current = true;\n    if (!list) return () => { mounted.current = false; };\n    void refresh();\n    const unsubscribe = on<WS_FlowsActorsDecisionRoutedPayload>(CoreWebSocketEvent.FLOWS_ACTORS_DECISION_ROUTED, () => { void refresh(); });\n    return () => {\n      mounted.current = false;\n      unsubscribe?.();\n    };\n  }, [on, refresh, list]);\n\n  return { decisions, isLoading, refresh, act, candidates };\n}\n"]}
+{"version":3,"file":"usePendingDecisions.js","sourceRoot":"","sources":["../../../../../src/core/flows-actors/usePendingDecisions.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport {\n  CoreWebSocketEvent,\n  HumanDecision_ActOutcomeKind,\n  MAIN_API_BASE_PATH,\n  ManualControllerRouteKey,\n  type HumanDecision_Act,\n  type HumanDecision_ActOutcome,\n  type HumanDecision_ActRequest,\n  type HumanDecision_PendingCard,\n  type HumanDecision_PendingListResponse,\n  type HumanDecision_ReassignCandidate,\n  type HumanDecision_ReassignCandidatesResponse,\n  type WS_FlowsActorsDecisionRoutedPayload,\n  type WS_FlowsActorsDecisionWithdrawnPayload,\n  buildManualControllerRoutePath,\n} from '@wildo-ai/saas-models';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useWebSocket } from '~wildo-frontend-lib/core/requests/websockets/useWebSocket';\n\nconst logger: ReturnType<typeof LoggerFrontendService.getLogger> = LoggerFrontendService.getLogger();\n\nconst OUTCOME_KINDS: ReadonlySet<string> = new Set(Object.values(HumanDecision_ActOutcomeKind));\n\n/**\n * The cards a withdrawal leaves standing (#2569): every card but the one for that decision at a route version older\n * than the one it moved to (any version, when it ended). A card already at the new version was re-read after the move\n * and is current, so the person who claimed a decision keeps it while their colleagues lose it.\n */\nexport function cardsAfterWithdrawal(\n  cards: readonly HumanDecision_PendingCard[],\n  withdrawn: WS_FlowsActorsDecisionWithdrawnPayload,\n): readonly HumanDecision_PendingCard[] {\n  const stale = (card: HumanDecision_PendingCard) => card.decisionRef === withdrawn.decisionRef\n    && (withdrawn.routeVersion === undefined || card.routeVersion < withdrawn.routeVersion);\n  return cards.some(stale) ? cards.filter((card) => !stale(card)) : cards;\n}\n\n/**\n * The outcome a refusal carries. The act route answers a refusal with a non-2xx status AND the outcome as its\n * body (404 for \"not yours, missing or settled\", 409 for a lost race, 422 for a refused edit…), so the body is\n * read from the error rather than the status being turned into a guess.\n */\nfunction outcomeOfRefusal(error: unknown): HumanDecision_ActOutcome | undefined {\n  const data = (error as { response?: { data?: unknown } } | null)?.response?.data as { kind?: unknown } | undefined;\n  return data && typeof data.kind === 'string' && OUTCOME_KINDS.has(data.kind) ? (data as HumanDecision_ActOutcome) : undefined;\n}\n\n/**\n * Where the inbox's read of the server list stands (#2526). Three states a reader must be able to tell apart, because each\n * calls for something different from them: wait, retry, or nothing to do.\n */\nexport enum PendingDecisionsReadState {\n  /** No read has settled yet. An inbox shows a placeholder, never \"nothing pending\". */\n  LOADING = 'loading',\n  /** The last read succeeded: `decisions` is what the server listed. */\n  READY = 'ready',\n  /**\n   * The last read failed. `decisions` keeps what an earlier read listed (empty when none succeeded), so an inbox can say\n   * the list may be out of date and offer `refresh`. Every act is re-checked by the server, so acting on it stays safe.\n   */\n  FAILED = 'failed',\n}\n\nexport interface PendingDecisionsState {\n  /** The decisions the signed-in person may act on, soonest deadline first, as the server lists them. */\n  readonly decisions: readonly HumanDecision_PendingCard[];\n  /** Whether a read is in flight — any read, including a refresh while a list is already shown. */\n  readonly isLoading: boolean;\n  /** Where the last read stands (#2526). */\n  readonly readState: PendingDecisionsReadState;\n  /** Re-read the list — after an act, and whenever a decision is routed to this person or leaves them (#2569). */\n  readonly refresh: () => Promise<void>;\n  /** One act on one decision. Resolves to what it came to; a refusal is an outcome, never a thrown error. */\n  readonly act: (decisionRef: string, act: HumanDecision_Act, request: HumanDecision_ActRequest) => Promise<HumanDecision_ActOutcome>;\n  /** Who a decision may be moved to — only people who could answer it. Empty when the caller may not move it. */\n  readonly candidates: (decisionRef: string) => Promise<readonly HumanDecision_ReassignCandidate[]>;\n}\n\n/**\n * The pending decisions the signed-in person may act on, read from the SERVER (#1594 D6, D12).\n *\n * The inbox used to be assembled from live socket announcements on this page alone, so a reload — or a\n * decision routed to a reviewer who never saw the conversation — showed nothing. The server list is the\n * one source: it covers every conversation, it re-checks each card with the rule an act is checked with,\n * and it survives a reload.\n *\n * Refreshed when the server announces a decision routed to this person (`flows-actors:decision-routed`: to their own\n * room for one assigned to them or raised by them, to their role's room for one waiting on a role they hold) and after\n * every act this hook sends. When the server announces a decision LEFT this\n * person (`flows-actors:decision-withdrawn`, #2569: claimed by a colleague, moved, answered, stopped or lapsed), its\n * card goes at once — before the re-read, so nobody acts on it in between — and the list is re-read. Except while this\n * hook is acting on that decision itself: the act re-reads when it returns, and the person acting keeps their card.\n *\n * It had a `list: false` mode for a component that answered one named-option or free-text decision it held. Both\n * such components were folded into the inbox (#2526), which answers a named-option decision from its own card, and\n * the mode went with them.\n */\nexport function usePendingDecisions(): PendingDecisionsState {\n  const { httpClient } = useApplication();\n  const { on } = useWebSocket();\n  const [decisions, setDecisions] = useState<readonly HumanDecision_PendingCard[]>([]);\n  const [isLoading, setIsLoading] = useState(false);\n  const [readState, setReadState] = useState<PendingDecisionsReadState>(PendingDecisionsReadState.LOADING);\n  const mounted = useRef(true);\n  /** The decisions an act from this hook is in flight on: their withdrawal is this person's own act, read back after it. */\n  const actingOn = useRef(new Set<string>());\n  /** The cards as last set, so a withdrawal can tell whether it dropped anything before it asks the server again. */\n  const shown = useRef<readonly HumanDecision_PendingCard[]>(decisions);\n  /**\n   * Which read is the latest (#2569 review A-6). Several reads can be out at once — after an act, and after each\n   * announcement — and only the one asked LAST may set the list, so an earlier answer arriving late cannot put back a\n   * card a later read or a withdrawal took away.\n   */\n  const readGeneration = useRef(0);\n  /** How many reads are out. A withdrawal that drops nothing still re-reads while one is, so it cannot answer stale. */\n  const readsInFlight = useRef(0);\n\n  const showDecisions = useCallback((next: readonly HumanDecision_PendingCard[]) => {\n    shown.current = next;\n    setDecisions(next);\n  }, []);\n\n  const refresh = useCallback(async (): Promise<void> => {\n    if (!httpClient) return;\n    const generation = ++readGeneration.current;\n    readsInFlight.current += 1;\n    setIsLoading(true);\n    try {\n      const path = `${MAIN_API_BASE_PATH}${buildManualControllerRoutePath(ManualControllerRouteKey.FLOWS_ACTORS_DECISIONS)}`;\n      const data = await httpClient.get<HumanDecision_PendingListResponse>(path, { silent: true });\n      if (mounted.current && generation === readGeneration.current) {\n        showDecisions(data?.decisions ?? []);\n        setReadState(PendingDecisionsReadState.READY);\n      }\n    } catch (error) {\n      // A failed read is a state the inbox SHOWS (#2526): it used to be logged at debug level and rendered exactly like an\n      // empty inbox, so a reviewer with decisions waiting was told there were none.\n      logger.warn('Pending decisions could not be read', { error: error instanceof Error ? error.message : 'unknown' });\n      if (mounted.current && generation === readGeneration.current) setReadState(PendingDecisionsReadState.FAILED);\n    } finally {\n      readsInFlight.current -= 1;\n      if (mounted.current && generation === readGeneration.current) setIsLoading(false);\n    }\n  }, [httpClient, showDecisions]);\n\n  const act = useCallback(async (decisionRef: string, act: HumanDecision_Act, request: HumanDecision_ActRequest): Promise<HumanDecision_ActOutcome> => {\n    if (!httpClient) return { kind: HumanDecision_ActOutcomeKind.NOT_ACTIONABLE };\n    const path = `${MAIN_API_BASE_PATH}${buildManualControllerRoutePath(ManualControllerRouteKey.FLOWS_ACTORS_DECISION_ACT, { decisionRef, act })}`;\n    let outcome: HumanDecision_ActOutcome;\n    actingOn.current.add(decisionRef);\n    try {\n      try {\n        outcome = await httpClient.post<HumanDecision_ActOutcome>(path, request, { silent: true });\n      } catch (error) {\n        const refused = outcomeOfRefusal(error);\n        if (!refused) throw error;\n        outcome = refused;\n      }\n      await refresh();\n    } finally {\n      actingOn.current.delete(decisionRef);\n    }\n    return outcome;\n  }, [httpClient, refresh]);\n\n  const candidates = useCallback(async (decisionRef: string): Promise<readonly HumanDecision_ReassignCandidate[]> => {\n    if (!httpClient) return [];\n    const path = `${MAIN_API_BASE_PATH}${buildManualControllerRoutePath(ManualControllerRouteKey.FLOWS_ACTORS_DECISION_CANDIDATES, { decisionRef })}`;\n    try {\n      const data = await httpClient.get<HumanDecision_ReassignCandidatesResponse>(path, { silent: true });\n      return data?.candidates ?? [];\n    } catch (error) {\n      if (outcomeOfRefusal(error)) return [];\n      throw error;\n    }\n  }, [httpClient]);\n\n  useEffect(() => {\n    mounted.current = true;\n    void refresh();\n    const unsubscribe = on<WS_FlowsActorsDecisionRoutedPayload>(CoreWebSocketEvent.FLOWS_ACTORS_DECISION_ROUTED, () => { void refresh(); });\n    const unsubscribeWithdrawn = on<WS_FlowsActorsDecisionWithdrawnPayload>(CoreWebSocketEvent.FLOWS_ACTORS_DECISION_WITHDRAWN, (withdrawn) => {\n      if (!withdrawn?.decisionRef || actingOn.current.has(withdrawn.decisionRef)) return;\n      // Nothing of it was shown, so there is nothing to take back and nothing to ask: every holder of a role gets this,\n      // and a re-read by each of them for a card they never had would be load for nothing. Unless a read is OUT: asked\n      // before the withdrawal, it may answer with the card, so a read asked after it supersedes it (#2528 review F6).\n      const remaining = cardsAfterWithdrawal(shown.current, withdrawn);\n      if (remaining === shown.current) {\n        if (readsInFlight.current > 0) void refresh();\n        return;\n      }\n      showDecisions(remaining);\n      void refresh();\n    });\n    return () => {\n      mounted.current = false;\n      unsubscribe?.();\n      unsubscribeWithdrawn?.();\n    };\n  }, [on, refresh, showDecisions]);\n\n  return { decisions, isLoading, readState, refresh, act, candidates };\n}\n"]}

package/dist/esm/core/guidance/GuidanceContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GuidanceContext.d.ts","sourceRoot":"","sources":["../../../../src/core/guidance/GuidanceContext.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"GuidanceContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/GuidanceContext.tsx"],"names":[],"mappings":"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"}

package/dist/esm/core/guidance/GuidanceContext.js

@@ -86,8 +86,7 @@ function findApiCallOperation(registry, resourceType, operationId) {
     return config.operations.find((o) => o.operationIdentifier === operationId
         && o.isOperationDefault === true
         && o.isBulkOperation !== true
-        && (o.variantType === ResourceOperationVariantType.API_CALL
-            || o.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK)) ?? null;
+        && (o.variantType === ResourceOperationVariantType.API_CALL)) ?? null;
 }
 /**
  * What a guidance-state read established — three outcomes that must never be collapsed.