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

package/dist/esm/core/features/FeaturesContext.js

@@ -7,7 +7,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * Responsibilities:
  * - Receives the merged FeatureConfiguration (core + custom) from app initialization
  * - Builds a definitions map for fast lookup
- * - Fetches resolved features from backend API: GET /api/v1/features/resolved
+ * - Fetches resolved features from backend API: GET /api/v1/features/resolved, FOR the organization the
+ *   person is currently in (`?organizationId=`, see `fetchResolvedFeatures`)
  * - Caches resolved features in context state
  * - Invalidates on WebSocket events (FEATURES_CHANGED, BILLING_STATUS_CHANGED, etc.)
  * - Exposes raw resolved features + definitions + unavailability policy
@@ -53,10 +54,13 @@ export const FeaturesContext = createContext(undefined);
 export function FeaturesProvider({ featureConfiguration, children }) {
     // ── State ──
     const [resolvedFeaturesResponse, setResolvedFeaturesResponse] = useState(null);
+    const [resolvedForOrganizationId, setResolvedForOrganizationId] = useState(null);
     const [isLoading, setIsLoading] = useState(true);
     const [error, setError] = useState(null);
     // ── Refs for stable callbacks ──
-    const fetchInFlightRef = useRef(false);
+    // Sequence of the most recent fetch. Only the LATEST fetch may write state: an answer for an organization the
+    // person has since left must never land over the answer for the one they are in (see `fetchResolvedFeatures`).
+    const latestFetchSequenceRef = useRef(0);
     const mountedRef = useRef(true);
     const debounceTimerRef = useRef(null);
     // ── Auth — features are user-scoped, only fetch when authenticated ──
@@ -96,21 +100,42 @@ export function FeaturesProvider({ featureConfiguration, children }) {
         };
     }, [resolvedFeaturesResponse]);
     const clearResolvedFeatures = useCallback(() => {
+        // Supersede any fetch still in flight, so an answer for the session that just ended cannot land after it.
+        latestFetchSequenceRef.current += 1;
         setResolvedFeaturesResponse(null);
+        setResolvedForOrganizationId(null);
         setError(null);
         setIsLoading(false);
     }, []);
     // ── Fetch resolved features from backend ──
+    /**
+     * Ask the backend which features the person has IN THE ORGANIZATION THEY ARE IN (#2061).
+     *
+     * `/features/resolved` is a manual route: no organization in its URL, so the backend resolves one from the
+     * `organizationId` query parameter, checked against the caller's memberships, and otherwise infers it ONLY
+     * when the caller belongs to exactly one organization (`resolveManualControllerOrganizationId`). Before this
+     * the request carried none, so a member of several organizations — an administrator, typically — was answered
+     * for no organization at all: `["M2M_WEBHOOK_DELIVERY"]` instead of a set holding `SINGLE_SIGN_ON`,
+     * `DIRECTORY_PROVISIONING` and `SECURITY_EVENT_EXPORT`. The launcher's availability is derived from this set,
+     * so the organization's SSO, SCIM and SIEM settings disappeared from its own settings rail.
+     *
+     * At application scope (no current organization) the parameter is omitted on purpose: that is a genuine
+     * question about no organization, and the backend's single-membership inference is the right answer to it.
+     *
+     * The latest fetch wins, by sequence. The previous guard SKIPPED a fetch while another was in flight, so the
+     * organization arriving shortly after sign-in — the common order — was dropped and the stale answer kept.
+     * Identical concurrent requests are still one network call: the HTTP client shares identical in-flight GETs.
+     */
     const fetchResolvedFeatures = useCallback(async () => {
-        if (fetchInFlightRef.current)
-            return;
-        fetchInFlightRef.current = true;
+        const sequence = ++latestFetchSequenceRef.current;
+        const isLatest = () => mountedRef.current && sequence === latestFetchSequenceRef.current;
         try {
-            logDebug('Fetching resolved features from backend');
+            logDebug('Fetching resolved features from backend', { organizationId: currentOrganizationId });
             const httpClient = getManualCallsHttpClient();
-            const response = await httpClient.get(FEATURES_API_URL);
-            if (mountedRef.current) {
+            const response = await httpClient.get(FEATURES_API_URL, currentOrganizationId ? { params: { organizationId: currentOrganizationId } } : undefined);
+            if (isLatest()) {
                 setResolvedFeaturesResponse(response);
+                setResolvedForOrganizationId(currentOrganizationId ?? null);
                 setError(null);
                 logDebug('Resolved features fetched', {
                     featureCount: response.features.length,
@@ -120,18 +145,17 @@ export function FeaturesProvider({ featureConfiguration, children }) {
             }
         }
         catch (err) {
-            if (mountedRef.current) {
+            if (isLatest()) {
                 setError(err instanceof Error ? err : new Error(err?.message ?? 'Failed to fetch features'));
                 logDebug('Failed to fetch resolved features', { error: err?.message });
             }
         }
         finally {
-            if (mountedRef.current) {
+            if (isLatest()) {
                 setIsLoading(false);
             }
-            fetchInFlightRef.current = false;
         }
-    }, []);
+    }, [currentOrganizationId]);
     // ── Fetch when authenticated (and refetch on auth change) ──
     useEffect(() => {
         mountedRef.current = true;
@@ -234,6 +258,7 @@ export function FeaturesProvider({ featureConfiguration, children }) {
     const contextValue = useMemo(() => ({
         resolvedFeatures,
         resolvedFeaturesResponse,
+        resolvedForOrganizationId,
         featureDefinitions,
         unavailabilityPolicy,
         isFeatureEnabled,
@@ -247,6 +272,7 @@ export function FeaturesProvider({ featureConfiguration, children }) {
     }), [
         resolvedFeatures,
         resolvedFeaturesResponse,
+        resolvedForOrganizationId,
         featureDefinitions,
         unavailabilityPolicy,
         isFeatureEnabled,

package/dist/esm/core/features/FeaturesContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeaturesContext.js","sourceRoot":"","sources":["../../../../../src/core/features/FeaturesContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * FeaturesContext\n *\n * Central context for feature gating on the frontend.\n *\n * Responsibilities:\n * - Receives the merged FeatureConfiguration (core + custom) from app initialization\n * - Builds a definitions map for fast lookup\n * - Fetches resolved features from backend API: GET /api/v1/features/resolved\n * - Caches resolved features in context state\n * - Invalidates on WebSocket events (FEATURES_CHANGED, BILLING_STATUS_CHANGED, etc.)\n * - Exposes raw resolved features + definitions + unavailability policy\n *\n * Frontend limit checking is ADVISORY — backend gate is authoritative.\n * Stale usage data means the frontend might allow a click that the backend rejects\n * (which is acceptable — the error is caught and displayed).\n */\n\nimport React, { createContext, useContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';\nimport {\n  CoreResourceType,\n  CoreWebSocketEvent,\n  FEATURES_UNLIMITED,\n  MAIN_API_BASE_PATH,\n  type FeatureConfiguration,\n  type FeatureDefinition,\n  type ResolvedFeaturesResponse,\n  type ResolvedFeaturesWithUsage,\n} from '@wildo-ai/saas-models';\nimport { useWebSocket } from '~wildo-frontend-lib/core/requests/websockets/useWebSocket';\nimport { EventBusContext } from '~wildo-frontend-lib/core/events/EventBusContext';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useResourceReachability } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useAuthSession } from '~wildo-frontend-lib/core/security/useAuthSession';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\n\n// ================================\n// Logger\n// ================================\n\nconst featuresLogger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = featuresLogger.debugByType('FeaturesContext');\nfeaturesLogger.setDebugTypeLogging('FeaturesContext', false);\n\n// ================================\n// Constants\n// ================================\n\nconst FEATURES_API_URL = `${MAIN_API_BASE_PATH}/features/resolved`;\n\n/** WebSocket events that trigger a refetch of resolved features */\nconst INVALIDATION_EVENTS = [\n  CoreWebSocketEvent.BILLING_STATUS_CHANGED,\n  CoreWebSocketEvent.BILLING_SUBSCRIPTION_UPDATED,\n  CoreWebSocketEvent.BILLING_ACCOUNT_CHANGED,\n  CoreWebSocketEvent.BILLING_FEATURES_UPDATED,\n] as const;\n\n// ================================\n// Context Type\n// ================================\n\nexport interface FeaturesContextType {\n  // ── Resolved features from backend ──\n  /** Raw resolved features with usage data (from backend API) */\n  resolvedFeatures: ResolvedFeaturesWithUsage;\n  /** Full response including upgrade options */\n  resolvedFeaturesResponse: ResolvedFeaturesResponse | null;\n\n  // ── Feature definitions (from configuration) ──\n  /** Feature definitions map (built from featureConfiguration.definitions) */\n  featureDefinitions: Map<string, FeatureDefinition>;\n\n  // ── Policy ──\n  /** The unavailability policy (from featureConfiguration.unavailabilityPolicy) */\n  unavailabilityPolicy: FeatureConfiguration['unavailabilityPolicy'];\n\n  // ── Convenience accessors ──\n  /** Check if a boolean feature is ENTITLED for the current scope (plan/profile). */\n  isFeatureEnabled: (featureId: string) => boolean;\n  /**\n   * Check if the app OFFERS a feature for the current scope — entitled now, or\n   * reachable via an upgrade/add-on. Plan-independent survival signal, distinct\n   * from `isFeatureEnabled` (entitlement). See the impl for the two-axis rationale.\n   */\n  isFeatureOffered: (featureId: string) => boolean;\n  /** Get a limit value (FEATURES_UNLIMITED = unlimited). Returns undefined if feature not found. */\n  getLimit: (featureId: string) => number | undefined;\n  /** Get current usage for a limit feature. undefined if no usage data. */\n  getCurrentUsage: (featureId: string) => number | undefined;\n  /** Get remaining capacity (limit - current). undefined if unlimited or no counting. */\n  getRemainingCapacity: (featureId: string) => number | undefined;\n\n  // ── State ──\n  isLoading: boolean;\n  error: Error | null;\n\n  // ── Actions ──\n  /** Force refetch of resolved features (e.g., after a mutation on a counted resource) */\n  refetch: () => void;\n}\n\n// ── Default empty state ──\nconst EMPTY_RESOLVED: ResolvedFeaturesWithUsage = {\n  features: [],\n  limits: {},\n  currentUsage: {},\n};\n\nexport const FeaturesContext: React.Context<FeaturesContextType | undefined> = createContext<FeaturesContextType | undefined>(undefined);\n\n// ================================\n// Provider\n// ================================\n\ninterface FeaturesProviderProps {\n  /** Merged FeatureConfiguration (core + custom) — passed from app initialization */\n  featureConfiguration: FeatureConfiguration;\n  children: React.ReactNode;\n}\n\nexport function FeaturesProvider({ featureConfiguration, children }: FeaturesProviderProps): React.ReactElement {\n  // ── State ──\n  const [resolvedFeaturesResponse, setResolvedFeaturesResponse] = useState<ResolvedFeaturesResponse | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  // ── Refs for stable callbacks ──\n  const fetchInFlightRef = useRef<boolean>(false);\n  const mountedRef = useRef<boolean>(true);\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // ── Auth — features are user-scoped, only fetch when authenticated ──\n  const { isAuthenticated } = useAuthSession();\n  // Fetch only when this consumer can REACH the features route: configured-and-authenticated is half\n  // the answer (#1069, the #268 rule). The resolved features are derived from the per-user ledger, so\n  // a consumer whose registry excludes it — the application-creation workbench — has no route to ask.\n  const featuresReachable = useResourceReachability(CoreResourceType.USER_FEATURES);\n  const authenticated = isAuthenticated() && featuresReachable;\n  const appScope = useAppScopeSafe();\n  const currentOrganizationId = appScope?.currentOrganizationId ?? null;\n\n  // ── WebSocket ──\n  const { on } = useWebSocket();\n\n  // ── Frontend event bus (preference changes) ──\n  // Read from the context directly: `useEventBus().bus` is typed as the React context object, not the bus.\n  const bus = useContext(EventBusContext);\n  const errorRef = useRef<Error | null>(null);\n\n  // ── Build definitions map from configuration ──\n  const featureDefinitions = useMemo(() => {\n    const map = new Map<string, FeatureDefinition>();\n    for (const def of featureConfiguration.definitions) {\n      map.set(def.identifier, def);\n    }\n    logDebug('Feature definitions map built', { count: map.size });\n    return map;\n  }, [featureConfiguration.definitions]);\n\n  // ── Unavailability policy ──\n  const unavailabilityPolicy = useMemo(\n    () => featureConfiguration.unavailabilityPolicy,\n    [featureConfiguration.unavailabilityPolicy],\n  );\n\n  // ── Derived resolved features ──\n  const resolvedFeatures: ResolvedFeaturesWithUsage = useMemo(() => {\n    if (!resolvedFeaturesResponse) return EMPTY_RESOLVED;\n    return {\n      features: resolvedFeaturesResponse.features,\n      limits: resolvedFeaturesResponse.limits,\n      currentUsage: resolvedFeaturesResponse.currentUsage,\n    };\n  }, [resolvedFeaturesResponse]);\n\n  const clearResolvedFeatures = useCallback(() => {\n    setResolvedFeaturesResponse(null);\n    setError(null);\n    setIsLoading(false);\n  }, []);\n\n  // ── Fetch resolved features from backend ──\n  const fetchResolvedFeatures = useCallback(async () => {\n    if (fetchInFlightRef.current) return;\n    fetchInFlightRef.current = true;\n\n    try {\n      logDebug('Fetching resolved features from backend');\n      const httpClient = getManualCallsHttpClient();\n      const response = await httpClient.get<ResolvedFeaturesResponse>(FEATURES_API_URL);\n\n      if (mountedRef.current) {\n        setResolvedFeaturesResponse(response);\n        setError(null);\n        logDebug('Resolved features fetched', {\n          featureCount: response.features.length,\n          limitCount: Object.keys(response.limits).length,\n          usageCount: Object.keys(response.currentUsage).length,\n        });\n      }\n    } catch (err: any) {\n      if (mountedRef.current) {\n        setError(err instanceof Error ? err : new Error(err?.message ?? 'Failed to fetch features'));\n        logDebug('Failed to fetch resolved features', { error: err?.message });\n      }\n    } finally {\n      if (mountedRef.current) {\n        setIsLoading(false);\n      }\n      fetchInFlightRef.current = false;\n    }\n  }, []);\n\n  // ── Fetch when authenticated (and refetch on auth change) ──\n  useEffect(() => {\n    mountedRef.current = true;\n    if (authenticated) {\n      setIsLoading(true);\n      fetchResolvedFeatures();\n    } else {\n      clearResolvedFeatures();\n    }\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [authenticated, currentOrganizationId, fetchResolvedFeatures, clearResolvedFeatures]);\n\n  useEffect(() => {\n    errorRef.current = error;\n  }, [error]);\n\n  // ── Retry a FAILED fetch when the person's preferences change (#534) ──\n  // A declared service consent requirement refuses this read until the person grants it, so the fetch that ran at\n  // sign-in can fail — and while the organization stays the same nothing else would retry it, leaving features\n  // unresolved until a reload. A preferences change is how a consent decision reaches the rest of the application,\n  // so it retries a failed fetch. Only a failed one: a theme or language change does not invalidate a good set.\n  useEffect(() => {\n    if (!authenticated) return;\n    return bus.on(FrontendEvents.USER_PREFERENCES_CHANGED, () => {\n      if (errorRef.current) fetchResolvedFeatures();\n    });\n  }, [authenticated, bus, fetchResolvedFeatures]);\n\n  // ── WebSocket invalidation (debounced to coalesce rapid events) ──\n  useEffect(() => {\n    if (!authenticated) return;\n\n    const unsubscribers: Array<() => void> = [];\n\n    const debouncedRefetch = () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = null;\n        fetchResolvedFeatures();\n      }, 300);\n    };\n\n    for (const event of INVALIDATION_EVENTS) {\n      const unsub = on(event, () => {\n        logDebug('WebSocket invalidation event received, scheduling refetch', { event });\n        debouncedRefetch();\n      });\n      unsubscribers.push(unsub);\n    }\n\n    return () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      for (const unsub of unsubscribers) {\n        unsub();\n      }\n    };\n  }, [authenticated, on, fetchResolvedFeatures]);\n\n  // ── Derived features set for O(1) lookups ──\n  const resolvedFeaturesSet = useMemo(\n    () => new Set(resolvedFeatures.features),\n    [resolvedFeatures.features],\n  );\n\n  // ── Convenience accessors ──\n  const isFeatureEnabled = useCallback(\n    (featureId: string): boolean => {\n      return resolvedFeaturesSet.has(featureId);\n    },\n    [resolvedFeaturesSet],\n  );\n\n  const isFeatureOffered = useCallback(\n    (featureId: string): boolean => {\n      // \"Offered\" = the app makes this feature available for the current scope,\n      // INDEPENDENT of whether the current plan/profile currently ENTITLES it:\n      //  - entitled now (in `resolvedFeatures`), OR\n      //  - not entitled but reachable via an upgrade/add-on the backend surfaced\n      //    in `upgradeOptions`.\n      // This is the plan-independent \"does this app offer feature X\" axis, distinct\n      // from `isFeatureEnabled` (the entitlement axis). Consumers gate SURVIVAL\n      // (should the surface exist at all) on `isFeatureOffered`, then render the\n      // entitlement state via {@link FeatureGate} (content vs upgrade/add-on prompt).\n      // Billing OFF → `upgradeOptions` is empty, so offered == entitled (no\n      // \"offered-but-locked\" state exists without a plan to upgrade to). Billing ON\n      // → `upgradeOptions` carries the sellable-but-not-yet-owned features.\n      if (resolvedFeaturesSet.has(featureId)) return true;\n      return Boolean(resolvedFeaturesResponse?.upgradeOptions?.[featureId]);\n    },\n    [resolvedFeaturesSet, resolvedFeaturesResponse],\n  );\n\n  const getLimit = useCallback(\n    (featureId: string): number | undefined => {\n      return resolvedFeatures.limits[featureId];\n    },\n    [resolvedFeatures.limits],\n  );\n\n  const getCurrentUsage = useCallback(\n    (featureId: string): number | undefined => {\n      return resolvedFeatures.currentUsage[featureId];\n    },\n    [resolvedFeatures.currentUsage],\n  );\n\n  const getRemainingCapacity = useCallback(\n    (featureId: string): number | undefined => {\n      const limit = resolvedFeatures.limits[featureId];\n      if (limit === undefined) return undefined;\n      if (limit === FEATURES_UNLIMITED) return undefined; // unlimited → no meaningful remaining\n      const usage = resolvedFeatures.currentUsage[featureId] ?? 0;\n      return Math.max(0, limit - usage);\n    },\n    [resolvedFeatures.limits, resolvedFeatures.currentUsage],\n  );\n\n  // ── Context value (memoized for stable reference) ──\n  const contextValue: FeaturesContextType = useMemo(\n    () => ({\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      isFeatureEnabled,\n      isFeatureOffered,\n      getLimit,\n      getCurrentUsage,\n      getRemainingCapacity,\n      isLoading,\n      error,\n      refetch: fetchResolvedFeatures,\n    }),\n    [\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      isFeatureEnabled,\n      isFeatureOffered,\n      getLimit,\n      getCurrentUsage,\n      getRemainingCapacity,\n      isLoading,\n      error,\n      fetchResolvedFeatures,\n    ],\n  );\n\n  return (\n    <FeaturesContext.Provider value={contextValue}>\n      {children}\n    </FeaturesContext.Provider>\n  );\n}\n\n// Note: useFeatures hook is in a separate file (useFeatures.ts) for React Fast Refresh compatibility.\n"]}
+{"version":3,"file":"FeaturesContext.js","sourceRoot":"","sources":["../../../../../src/core/features/FeaturesContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * FeaturesContext\n *\n * Central context for feature gating on the frontend.\n *\n * Responsibilities:\n * - Receives the merged FeatureConfiguration (core + custom) from app initialization\n * - Builds a definitions map for fast lookup\n * - Fetches resolved features from backend API: GET /api/v1/features/resolved, FOR the organization the\n *   person is currently in (`?organizationId=`, see `fetchResolvedFeatures`)\n * - Caches resolved features in context state\n * - Invalidates on WebSocket events (FEATURES_CHANGED, BILLING_STATUS_CHANGED, etc.)\n * - Exposes raw resolved features + definitions + unavailability policy\n *\n * Frontend limit checking is ADVISORY — backend gate is authoritative.\n * Stale usage data means the frontend might allow a click that the backend rejects\n * (which is acceptable — the error is caught and displayed).\n */\n\nimport React, { createContext, useContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';\nimport {\n  CoreResourceType,\n  CoreWebSocketEvent,\n  FEATURES_UNLIMITED,\n  MAIN_API_BASE_PATH,\n  type FeatureConfiguration,\n  type FeatureDefinition,\n  type ResolvedFeaturesResponse,\n  type ResolvedFeaturesWithUsage,\n} from '@wildo-ai/saas-models';\nimport { useWebSocket } from '~wildo-frontend-lib/core/requests/websockets/useWebSocket';\nimport { EventBusContext } from '~wildo-frontend-lib/core/events/EventBusContext';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { useResourceReachability } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useAuthSession } from '~wildo-frontend-lib/core/security/useAuthSession';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\n\n// ================================\n// Logger\n// ================================\n\nconst featuresLogger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = featuresLogger.debugByType('FeaturesContext');\nfeaturesLogger.setDebugTypeLogging('FeaturesContext', false);\n\n// ================================\n// Constants\n// ================================\n\nconst FEATURES_API_URL = `${MAIN_API_BASE_PATH}/features/resolved`;\n\n/** WebSocket events that trigger a refetch of resolved features */\nconst INVALIDATION_EVENTS = [\n  CoreWebSocketEvent.BILLING_STATUS_CHANGED,\n  CoreWebSocketEvent.BILLING_SUBSCRIPTION_UPDATED,\n  CoreWebSocketEvent.BILLING_ACCOUNT_CHANGED,\n  CoreWebSocketEvent.BILLING_FEATURES_UPDATED,\n] as const;\n\n// ================================\n// Context Type\n// ================================\n\nexport interface FeaturesContextType {\n  // ── Resolved features from backend ──\n  /** Raw resolved features with usage data (from backend API) */\n  resolvedFeatures: ResolvedFeaturesWithUsage;\n  /** Full response including upgrade options */\n  resolvedFeaturesResponse: ResolvedFeaturesResponse | null;\n  /**\n   * The organization the CURRENT response was resolved for, `null` for one resolved at application scope or none yet\n   * (#2464 review L1). The response is kept across an organization switch until the next one lands, so features do not\n   * flicker; a surface showing a number ABOUT one organization (usage beside a limit) compares this, not the current\n   * organization, or it shows the previous organization's numbers for one fetch.\n   */\n  resolvedForOrganizationId: string | null;\n\n  // ── Feature definitions (from configuration) ──\n  /** Feature definitions map (built from featureConfiguration.definitions) */\n  featureDefinitions: Map<string, FeatureDefinition>;\n\n  // ── Policy ──\n  /** The unavailability policy (from featureConfiguration.unavailabilityPolicy) */\n  unavailabilityPolicy: FeatureConfiguration['unavailabilityPolicy'];\n\n  // ── Convenience accessors ──\n  /** Check if a boolean feature is ENTITLED for the current scope (plan/profile). */\n  isFeatureEnabled: (featureId: string) => boolean;\n  /**\n   * Check if the app OFFERS a feature for the current scope — entitled now, or\n   * reachable via an upgrade/add-on. Plan-independent survival signal, distinct\n   * from `isFeatureEnabled` (entitlement). See the impl for the two-axis rationale.\n   */\n  isFeatureOffered: (featureId: string) => boolean;\n  /** Get a limit value (FEATURES_UNLIMITED = unlimited). Returns undefined if feature not found. */\n  getLimit: (featureId: string) => number | undefined;\n  /** Get current usage for a limit feature. undefined if no usage data. */\n  getCurrentUsage: (featureId: string) => number | undefined;\n  /** Get remaining capacity (limit - current). undefined if unlimited or no counting. */\n  getRemainingCapacity: (featureId: string) => number | undefined;\n\n  // ── State ──\n  isLoading: boolean;\n  error: Error | null;\n\n  // ── Actions ──\n  /** Force refetch of resolved features (e.g., after a mutation on a counted resource) */\n  refetch: () => void;\n}\n\n// ── Default empty state ──\nconst EMPTY_RESOLVED: ResolvedFeaturesWithUsage = {\n  features: [],\n  limits: {},\n  currentUsage: {},\n};\n\nexport const FeaturesContext: React.Context<FeaturesContextType | undefined> = createContext<FeaturesContextType | undefined>(undefined);\n\n// ================================\n// Provider\n// ================================\n\ninterface FeaturesProviderProps {\n  /** Merged FeatureConfiguration (core + custom) — passed from app initialization */\n  featureConfiguration: FeatureConfiguration;\n  children: React.ReactNode;\n}\n\nexport function FeaturesProvider({ featureConfiguration, children }: FeaturesProviderProps): React.ReactElement {\n  // ── State ──\n  const [resolvedFeaturesResponse, setResolvedFeaturesResponse] = useState<ResolvedFeaturesResponse | null>(null);\n  const [resolvedForOrganizationId, setResolvedForOrganizationId] = useState<string | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  // ── Refs for stable callbacks ──\n  // Sequence of the most recent fetch. Only the LATEST fetch may write state: an answer for an organization the\n  // person has since left must never land over the answer for the one they are in (see `fetchResolvedFeatures`).\n  const latestFetchSequenceRef = useRef<number>(0);\n  const mountedRef = useRef<boolean>(true);\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // ── Auth — features are user-scoped, only fetch when authenticated ──\n  const { isAuthenticated } = useAuthSession();\n  // Fetch only when this consumer can REACH the features route: configured-and-authenticated is half\n  // the answer (#1069, the #268 rule). The resolved features are derived from the per-user ledger, so\n  // a consumer whose registry excludes it — the application-creation workbench — has no route to ask.\n  const featuresReachable = useResourceReachability(CoreResourceType.USER_FEATURES);\n  const authenticated = isAuthenticated() && featuresReachable;\n  const appScope = useAppScopeSafe();\n  const currentOrganizationId = appScope?.currentOrganizationId ?? null;\n\n  // ── WebSocket ──\n  const { on } = useWebSocket();\n\n  // ── Frontend event bus (preference changes) ──\n  // Read from the context directly: `useEventBus().bus` is typed as the React context object, not the bus.\n  const bus = useContext(EventBusContext);\n  const errorRef = useRef<Error | null>(null);\n\n  // ── Build definitions map from configuration ──\n  const featureDefinitions = useMemo(() => {\n    const map = new Map<string, FeatureDefinition>();\n    for (const def of featureConfiguration.definitions) {\n      map.set(def.identifier, def);\n    }\n    logDebug('Feature definitions map built', { count: map.size });\n    return map;\n  }, [featureConfiguration.definitions]);\n\n  // ── Unavailability policy ──\n  const unavailabilityPolicy = useMemo(\n    () => featureConfiguration.unavailabilityPolicy,\n    [featureConfiguration.unavailabilityPolicy],\n  );\n\n  // ── Derived resolved features ──\n  const resolvedFeatures: ResolvedFeaturesWithUsage = useMemo(() => {\n    if (!resolvedFeaturesResponse) return EMPTY_RESOLVED;\n    return {\n      features: resolvedFeaturesResponse.features,\n      limits: resolvedFeaturesResponse.limits,\n      currentUsage: resolvedFeaturesResponse.currentUsage,\n    };\n  }, [resolvedFeaturesResponse]);\n\n  const clearResolvedFeatures = useCallback(() => {\n    // Supersede any fetch still in flight, so an answer for the session that just ended cannot land after it.\n    latestFetchSequenceRef.current += 1;\n    setResolvedFeaturesResponse(null);\n    setResolvedForOrganizationId(null);\n    setError(null);\n    setIsLoading(false);\n  }, []);\n\n  // ── Fetch resolved features from backend ──\n  /**\n   * Ask the backend which features the person has IN THE ORGANIZATION THEY ARE IN (#2061).\n   *\n   * `/features/resolved` is a manual route: no organization in its URL, so the backend resolves one from the\n   * `organizationId` query parameter, checked against the caller's memberships, and otherwise infers it ONLY\n   * when the caller belongs to exactly one organization (`resolveManualControllerOrganizationId`). Before this\n   * the request carried none, so a member of several organizations — an administrator, typically — was answered\n   * for no organization at all: `[\"M2M_WEBHOOK_DELIVERY\"]` instead of a set holding `SINGLE_SIGN_ON`,\n   * `DIRECTORY_PROVISIONING` and `SECURITY_EVENT_EXPORT`. The launcher's availability is derived from this set,\n   * so the organization's SSO, SCIM and SIEM settings disappeared from its own settings rail.\n   *\n   * At application scope (no current organization) the parameter is omitted on purpose: that is a genuine\n   * question about no organization, and the backend's single-membership inference is the right answer to it.\n   *\n   * The latest fetch wins, by sequence. The previous guard SKIPPED a fetch while another was in flight, so the\n   * organization arriving shortly after sign-in — the common order — was dropped and the stale answer kept.\n   * Identical concurrent requests are still one network call: the HTTP client shares identical in-flight GETs.\n   */\n  const fetchResolvedFeatures = useCallback(async () => {\n    const sequence = ++latestFetchSequenceRef.current;\n    const isLatest = (): boolean => mountedRef.current && sequence === latestFetchSequenceRef.current;\n\n    try {\n      logDebug('Fetching resolved features from backend', { organizationId: currentOrganizationId });\n      const httpClient = getManualCallsHttpClient();\n      const response = await httpClient.get<ResolvedFeaturesResponse>(\n        FEATURES_API_URL,\n        currentOrganizationId ? { params: { organizationId: currentOrganizationId } } : undefined,\n      );\n\n      if (isLatest()) {\n        setResolvedFeaturesResponse(response);\n        setResolvedForOrganizationId(currentOrganizationId ?? null);\n        setError(null);\n        logDebug('Resolved features fetched', {\n          featureCount: response.features.length,\n          limitCount: Object.keys(response.limits).length,\n          usageCount: Object.keys(response.currentUsage).length,\n        });\n      }\n    } catch (err: any) {\n      if (isLatest()) {\n        setError(err instanceof Error ? err : new Error(err?.message ?? 'Failed to fetch features'));\n        logDebug('Failed to fetch resolved features', { error: err?.message });\n      }\n    } finally {\n      if (isLatest()) {\n        setIsLoading(false);\n      }\n    }\n  }, [currentOrganizationId]);\n\n  // ── Fetch when authenticated (and refetch on auth change) ──\n  useEffect(() => {\n    mountedRef.current = true;\n    if (authenticated) {\n      setIsLoading(true);\n      fetchResolvedFeatures();\n    } else {\n      clearResolvedFeatures();\n    }\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [authenticated, currentOrganizationId, fetchResolvedFeatures, clearResolvedFeatures]);\n\n  useEffect(() => {\n    errorRef.current = error;\n  }, [error]);\n\n  // ── Retry a FAILED fetch when the person's preferences change (#534) ──\n  // A declared service consent requirement refuses this read until the person grants it, so the fetch that ran at\n  // sign-in can fail — and while the organization stays the same nothing else would retry it, leaving features\n  // unresolved until a reload. A preferences change is how a consent decision reaches the rest of the application,\n  // so it retries a failed fetch. Only a failed one: a theme or language change does not invalidate a good set.\n  useEffect(() => {\n    if (!authenticated) return;\n    return bus.on(FrontendEvents.USER_PREFERENCES_CHANGED, () => {\n      if (errorRef.current) fetchResolvedFeatures();\n    });\n  }, [authenticated, bus, fetchResolvedFeatures]);\n\n  // ── WebSocket invalidation (debounced to coalesce rapid events) ──\n  useEffect(() => {\n    if (!authenticated) return;\n\n    const unsubscribers: Array<() => void> = [];\n\n    const debouncedRefetch = () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = null;\n        fetchResolvedFeatures();\n      }, 300);\n    };\n\n    for (const event of INVALIDATION_EVENTS) {\n      const unsub = on(event, () => {\n        logDebug('WebSocket invalidation event received, scheduling refetch', { event });\n        debouncedRefetch();\n      });\n      unsubscribers.push(unsub);\n    }\n\n    return () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      for (const unsub of unsubscribers) {\n        unsub();\n      }\n    };\n  }, [authenticated, on, fetchResolvedFeatures]);\n\n  // ── Derived features set for O(1) lookups ──\n  const resolvedFeaturesSet = useMemo(\n    () => new Set(resolvedFeatures.features),\n    [resolvedFeatures.features],\n  );\n\n  // ── Convenience accessors ──\n  const isFeatureEnabled = useCallback(\n    (featureId: string): boolean => {\n      return resolvedFeaturesSet.has(featureId);\n    },\n    [resolvedFeaturesSet],\n  );\n\n  const isFeatureOffered = useCallback(\n    (featureId: string): boolean => {\n      // \"Offered\" = the app makes this feature available for the current scope,\n      // INDEPENDENT of whether the current plan/profile currently ENTITLES it:\n      //  - entitled now (in `resolvedFeatures`), OR\n      //  - not entitled but reachable via an upgrade/add-on the backend surfaced\n      //    in `upgradeOptions`.\n      // This is the plan-independent \"does this app offer feature X\" axis, distinct\n      // from `isFeatureEnabled` (the entitlement axis). Consumers gate SURVIVAL\n      // (should the surface exist at all) on `isFeatureOffered`, then render the\n      // entitlement state via {@link FeatureGate} (content vs upgrade/add-on prompt).\n      // Billing OFF → `upgradeOptions` is empty, so offered == entitled (no\n      // \"offered-but-locked\" state exists without a plan to upgrade to). Billing ON\n      // → `upgradeOptions` carries the sellable-but-not-yet-owned features.\n      if (resolvedFeaturesSet.has(featureId)) return true;\n      return Boolean(resolvedFeaturesResponse?.upgradeOptions?.[featureId]);\n    },\n    [resolvedFeaturesSet, resolvedFeaturesResponse],\n  );\n\n  const getLimit = useCallback(\n    (featureId: string): number | undefined => {\n      return resolvedFeatures.limits[featureId];\n    },\n    [resolvedFeatures.limits],\n  );\n\n  const getCurrentUsage = useCallback(\n    (featureId: string): number | undefined => {\n      return resolvedFeatures.currentUsage[featureId];\n    },\n    [resolvedFeatures.currentUsage],\n  );\n\n  const getRemainingCapacity = useCallback(\n    (featureId: string): number | undefined => {\n      const limit = resolvedFeatures.limits[featureId];\n      if (limit === undefined) return undefined;\n      if (limit === FEATURES_UNLIMITED) return undefined; // unlimited → no meaningful remaining\n      const usage = resolvedFeatures.currentUsage[featureId] ?? 0;\n      return Math.max(0, limit - usage);\n    },\n    [resolvedFeatures.limits, resolvedFeatures.currentUsage],\n  );\n\n  // ── Context value (memoized for stable reference) ──\n  const contextValue: FeaturesContextType = useMemo(\n    () => ({\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      resolvedForOrganizationId,\n      featureDefinitions,\n      unavailabilityPolicy,\n      isFeatureEnabled,\n      isFeatureOffered,\n      getLimit,\n      getCurrentUsage,\n      getRemainingCapacity,\n      isLoading,\n      error,\n      refetch: fetchResolvedFeatures,\n    }),\n    [\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      resolvedForOrganizationId,\n      featureDefinitions,\n      unavailabilityPolicy,\n      isFeatureEnabled,\n      isFeatureOffered,\n      getLimit,\n      getCurrentUsage,\n      getRemainingCapacity,\n      isLoading,\n      error,\n      fetchResolvedFeatures,\n    ],\n  );\n\n  return (\n    <FeaturesContext.Provider value={contextValue}>\n      {children}\n    </FeaturesContext.Provider>\n  );\n}\n\n// Note: useFeatures hook is in a separate file (useFeatures.ts) for React Fast Refresh compatibility.\n"]}

package/dist/esm/core/features/useOperationFeatureAvailability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationFeatureAvailability.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAML,KAAK,sBAAsB,EAE3B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAC7H,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AASpE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAMD;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD,gBAAgB,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC/G,wBAAwB,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,EAAE,oBAAoB,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9G,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACnD,oBAAoB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,sBAAsB,CAAC,CAAC;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,EACrE,GAAG,EAAE,0CAA0C,GAC9C,mBAAmB,GAAG,SAAS,CAyIjC;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,GACpE,mBAAmB,GAAG,SAAS,CA8CjC"}
+{"version":3,"file":"useOperationFeatureAvailability.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAML,KAAK,sBAAsB,EAE3B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAC7H,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AASpE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAMD;;;GAGG;AACH,MAAM,WAAW,0CAA0C;IACzD,gBAAgB,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC/G,wBAAwB,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,EAAE,oBAAoB,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9G,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACnD,oBAAoB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,sBAAsB,CAAC,CAAC;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,EACrE,GAAG,EAAE,0CAA0C,GAC9C,mBAAmB,GAAG,SAAS,CA4IjC;AAMD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,uCAAuC,GAAG,IAAI,GAAG,SAAS,GACpE,mBAAmB,GAAG,SAAS,CA8CjC"}

package/dist/esm/core/features/useOperationFeatureAvailability.js

@@ -40,6 +40,10 @@ export function resolveOperationFeatureAvailability(operation, ctx) {
     const normalized = Array.isArray(raw)
         ? { features: raw, mode: 'OR' }
         : raw;
+    // A conditional requirement depends on the request body, which does not exist until the form is submitted, so it
+    // never makes an action unavailable here: the backend gate decides when the request arrives (`appliesWhen`).
+    if (normalized.appliesWhen)
+        return undefined;
     const { resolvedFeatures, resolvedFeaturesResponse, featureDefinitions, unavailabilityPolicy, userRoles, billingEnabled, } = ctx;
     const resolvedSet = new Set(resolvedFeatures.features);
     // ── Phase 1: Boolean features ──

package/dist/esm/core/features/useOperationFeatureAvailability.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOperationFeatureAvailability.js","sourceRoot":"","sources":["../../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useOperationFeatureAvailability Hook\n * \n * Resolves feature availability for an operation's `requiredFeatures` config.\n * Evaluates both boolean features (OR/AND mode) and limit checks.\n * \n * For boolean features:\n *   - OR mode: any single enabled feature is enough\n *   - AND mode: all features must be enabled\n * \n * For limit features:\n *   - CREATE operations: checks currentUsage + 1 <= limit\n *   - CREATE_MANY: checks currentUsage < limit (conservative — backend does exact check)\n *   - Other operations: increment = 0, so limits are not checked\n * \n * Returns the \"worst\" availability result (boolean failure takes precedence over limit failure).\n */\n\nimport { useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  CoreResourceOperation,\n  type RequiredFeaturesConfig,\n  type RequiredFeaturesFullConfig,\n  type FeatureUpgradeOption,\n  type FeatureDefinition,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport type { FeatureAvailability } from './useFeatureAvailability';\nimport { useBillingSafe } from '~wildo-frontend-lib/core/billing/useBilling';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport {\n  buildFeaturePolicyRoles,\n  resolveFeatureUnavailabilityBehavior,\n} from './feature-unavailability.frontend.utils';\n\n// Re-export the FeatureAvailability type for convenience\nexport type { FeatureAvailability };\n\n/**\n * Minimal operation-like shape accepted by resolveOperationFeatureAvailability.\n * Used to wrap view-level requiredFeatures or standalone feature checks\n * without needing the full FrontendResourceConfiguration_Operation type.\n * \n * Cast to FrontendResourceConfiguration_Operation when calling resolveOperationFeatureAvailability:\n *   `viewCheckable as RequiredFeaturesCheckable as FrontendResourceConfiguration_Operation`\n */\nexport interface RequiredFeaturesCheckable {\n  requiredFeatures: RequiredFeaturesConfig;\n  operationIdentifier: string;\n}\n\n// ================================\n// Pure Resolution Function (for batch + hook use)\n// ================================\n\n/**\n * Parameters for the pure resolution function.\n * Contains all the context needed to resolve feature availability without hooks.\n */\nexport interface ResolveOperationFeatureAvailabilityContext {\n  resolvedFeatures: { features: string[]; limits: Record<string, number>; currentUsage: Record<string, number> };\n  resolvedFeaturesResponse: { upgradeOptions: Record<string, { availableVia: FeatureUpgradeOption[] }> } | null;\n  featureDefinitions: Map<string, FeatureDefinition>;\n  unavailabilityPolicy: ReturnType<typeof useFeatures>['unavailabilityPolicy'];\n  userRoles: string[];\n  billingEnabled: boolean;\n}\n\n/**\n * Pure function to resolve feature availability for an operation's requiredFeatures.\n * Can be called from hooks (via useMemo) or from batch evaluation effects.\n * \n * @param operation - The frontend resource operation configuration\n * @param ctx - Resolution context (resolved features, definitions, policy, roles)\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function resolveOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n  ctx: ResolveOperationFeatureAvailabilityContext,\n): FeatureAvailability | undefined {\n  if (!operation) return undefined;\n\n  // Normalize requiredFeatures (may be string[] or RequiredFeaturesFullConfig)\n  const raw = operation.requiredFeatures;\n  if (!raw) return undefined;\n\n  const normalized: RequiredFeaturesFullConfig = Array.isArray(raw)\n    ? { features: raw, mode: 'OR' }\n    : raw;\n\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    userRoles,\n    billingEnabled,\n  } = ctx;\n  const resolvedSet = new Set(resolvedFeatures.features);\n\n  // ── Phase 1: Boolean features ──\n  if (normalized.features && normalized.features.length > 0) {\n    const mode = normalized.mode ?? 'OR';\n\n    if (mode === 'OR') {\n      // OR: at least one boolean feature must be enabled\n      const booleanFeatures = normalized.features.filter(fId => {\n        const def = featureDefinitions.get(fId);\n        return !def || def.valueType === FeatureValueType.BOOLEAN;\n      });\n\n      const anyEnabled = booleanFeatures.some(fId => resolvedSet.has(fId));\n      if (booleanFeatures.length > 0 && !anyEnabled) {\n        const missingFeatures = booleanFeatures.filter(fId => !resolvedSet.has(fId));\n        const firstMissing = featureDefinitions.get(missingFeatures[0]);\n        const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef: firstMissing,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[missingFeatures[0]]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          missingFeatures,\n          upgradeOptions,\n          suggestedProductRef: firstMissing?.unavailability?.suggestedProductRef,\n        };\n      }\n    } else {\n      // AND: all boolean features must be enabled\n      for (const featureId of normalized.features) {\n        const def = featureDefinitions.get(featureId);\n        if (def && def.valueType !== FeatureValueType.BOOLEAN) continue;\n\n        if (!resolvedSet.has(featureId)) {\n          const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n          const { behavior } = resolveFeatureUnavailabilityBehavior({\n            reason,\n            featureDef: def,\n            policy: unavailabilityPolicy,\n            userRoles,\n            billingEnabled,\n          });\n          const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n          return {\n            isAvailable: false,\n            reason,\n            behavior,\n            missingFeatures: [featureId],\n            upgradeOptions,\n            suggestedProductRef: def?.unavailability?.suggestedProductRef,\n          };\n        }\n      }\n    }\n  }\n\n  // ── Phase 2: Limit checks ──\n  if (normalized.limitChecks && normalized.limitChecks.length > 0) {\n    const operationId = operation.operationIdentifier as string;\n\n    for (const check of normalized.limitChecks) {\n      const limit = resolvedFeatures.limits[check.featureId];\n\n      // No limit or unlimited → pass\n      if (limit === undefined || limit === FEATURES_UNLIMITED) continue;\n\n      const currentUsage = resolvedFeatures.currentUsage[check.featureId] ?? 0;\n\n      // Infer increment (frontend-side: same logic as backend, conservative for CREATE_MANY)\n      let increment: number;\n      if (check.increment !== undefined) {\n        increment = check.increment;\n      } else if (operationId === CoreResourceOperation.CREATE) {\n        increment = 1;\n      } else if (operationId === CoreResourceOperation.CREATE_MANY) {\n        increment = 1; // Conservative — backend does exact check\n      } else {\n        increment = 0;\n      }\n\n      if (increment === 0) continue;\n\n      if (currentUsage + increment > limit) {\n        const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n        const featureDef = featureDefinitions.get(check.featureId);\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[check.featureId]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          limitInfo: { featureId: check.featureId, current: currentUsage, limit },\n          upgradeOptions,\n          suggestedProductRef: featureDef?.unavailability?.suggestedProductRef,\n        };\n      }\n    }\n  }\n\n  // All checks passed\n  return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n}\n\n// ================================\n// Hook (convenience wrapper over pure function)\n// ================================\n\n/**\n * Resolve feature availability for an operation's requiredFeatures.\n * \n * @param operation - The frontend resource operation configuration\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function useOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n): FeatureAvailability | undefined {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  return useMemo((): FeatureAvailability | undefined => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return operation?.requiredFeatures\n        ? { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE }\n        : undefined;\n    }\n\n    // Build user roles for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    return resolveOperationFeatureAvailability(operation, {\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      userRoles,\n      billingEnabled: billing?.isEnabled ?? false,\n    });\n  }, [\n    operation,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n}\n"]}
+{"version":3,"file":"useOperationFeatureAvailability.js","sourceRoot":"","sources":["../../../../../src/core/features/useOperationFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useOperationFeatureAvailability Hook\n * \n * Resolves feature availability for an operation's `requiredFeatures` config.\n * Evaluates both boolean features (OR/AND mode) and limit checks.\n * \n * For boolean features:\n *   - OR mode: any single enabled feature is enough\n *   - AND mode: all features must be enabled\n * \n * For limit features:\n *   - CREATE operations: checks currentUsage + 1 <= limit\n *   - CREATE_MANY: checks currentUsage < limit (conservative — backend does exact check)\n *   - Other operations: increment = 0, so limits are not checked\n * \n * Returns the \"worst\" availability result (boolean failure takes precedence over limit failure).\n */\n\nimport { useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  CoreResourceOperation,\n  type RequiredFeaturesConfig,\n  type RequiredFeaturesFullConfig,\n  type FeatureUpgradeOption,\n  type FeatureDefinition,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport type { FeatureAvailability } from './useFeatureAvailability';\nimport { useBillingSafe } from '~wildo-frontend-lib/core/billing/useBilling';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport {\n  buildFeaturePolicyRoles,\n  resolveFeatureUnavailabilityBehavior,\n} from './feature-unavailability.frontend.utils';\n\n// Re-export the FeatureAvailability type for convenience\nexport type { FeatureAvailability };\n\n/**\n * Minimal operation-like shape accepted by resolveOperationFeatureAvailability.\n * Used to wrap view-level requiredFeatures or standalone feature checks\n * without needing the full FrontendResourceConfiguration_Operation type.\n * \n * Cast to FrontendResourceConfiguration_Operation when calling resolveOperationFeatureAvailability:\n *   `viewCheckable as RequiredFeaturesCheckable as FrontendResourceConfiguration_Operation`\n */\nexport interface RequiredFeaturesCheckable {\n  requiredFeatures: RequiredFeaturesConfig;\n  operationIdentifier: string;\n}\n\n// ================================\n// Pure Resolution Function (for batch + hook use)\n// ================================\n\n/**\n * Parameters for the pure resolution function.\n * Contains all the context needed to resolve feature availability without hooks.\n */\nexport interface ResolveOperationFeatureAvailabilityContext {\n  resolvedFeatures: { features: string[]; limits: Record<string, number>; currentUsage: Record<string, number> };\n  resolvedFeaturesResponse: { upgradeOptions: Record<string, { availableVia: FeatureUpgradeOption[] }> } | null;\n  featureDefinitions: Map<string, FeatureDefinition>;\n  unavailabilityPolicy: ReturnType<typeof useFeatures>['unavailabilityPolicy'];\n  userRoles: string[];\n  billingEnabled: boolean;\n}\n\n/**\n * Pure function to resolve feature availability for an operation's requiredFeatures.\n * Can be called from hooks (via useMemo) or from batch evaluation effects.\n * \n * @param operation - The frontend resource operation configuration\n * @param ctx - Resolution context (resolved features, definitions, policy, roles)\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function resolveOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n  ctx: ResolveOperationFeatureAvailabilityContext,\n): FeatureAvailability | undefined {\n  if (!operation) return undefined;\n\n  // Normalize requiredFeatures (may be string[] or RequiredFeaturesFullConfig)\n  const raw = operation.requiredFeatures;\n  if (!raw) return undefined;\n\n  const normalized: RequiredFeaturesFullConfig = Array.isArray(raw)\n    ? { features: raw, mode: 'OR' }\n    : raw;\n  // A conditional requirement depends on the request body, which does not exist until the form is submitted, so it\n  // never makes an action unavailable here: the backend gate decides when the request arrives (`appliesWhen`).\n  if (normalized.appliesWhen) return undefined;\n\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    userRoles,\n    billingEnabled,\n  } = ctx;\n  const resolvedSet = new Set(resolvedFeatures.features);\n\n  // ── Phase 1: Boolean features ──\n  if (normalized.features && normalized.features.length > 0) {\n    const mode = normalized.mode ?? 'OR';\n\n    if (mode === 'OR') {\n      // OR: at least one boolean feature must be enabled\n      const booleanFeatures = normalized.features.filter(fId => {\n        const def = featureDefinitions.get(fId);\n        return !def || def.valueType === FeatureValueType.BOOLEAN;\n      });\n\n      const anyEnabled = booleanFeatures.some(fId => resolvedSet.has(fId));\n      if (booleanFeatures.length > 0 && !anyEnabled) {\n        const missingFeatures = booleanFeatures.filter(fId => !resolvedSet.has(fId));\n        const firstMissing = featureDefinitions.get(missingFeatures[0]);\n        const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef: firstMissing,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[missingFeatures[0]]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          missingFeatures,\n          upgradeOptions,\n          suggestedProductRef: firstMissing?.unavailability?.suggestedProductRef,\n        };\n      }\n    } else {\n      // AND: all boolean features must be enabled\n      for (const featureId of normalized.features) {\n        const def = featureDefinitions.get(featureId);\n        if (def && def.valueType !== FeatureValueType.BOOLEAN) continue;\n\n        if (!resolvedSet.has(featureId)) {\n          const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n          const { behavior } = resolveFeatureUnavailabilityBehavior({\n            reason,\n            featureDef: def,\n            policy: unavailabilityPolicy,\n            userRoles,\n            billingEnabled,\n          });\n          const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n          return {\n            isAvailable: false,\n            reason,\n            behavior,\n            missingFeatures: [featureId],\n            upgradeOptions,\n            suggestedProductRef: def?.unavailability?.suggestedProductRef,\n          };\n        }\n      }\n    }\n  }\n\n  // ── Phase 2: Limit checks ──\n  if (normalized.limitChecks && normalized.limitChecks.length > 0) {\n    const operationId = operation.operationIdentifier as string;\n\n    for (const check of normalized.limitChecks) {\n      const limit = resolvedFeatures.limits[check.featureId];\n\n      // No limit or unlimited → pass\n      if (limit === undefined || limit === FEATURES_UNLIMITED) continue;\n\n      const currentUsage = resolvedFeatures.currentUsage[check.featureId] ?? 0;\n\n      // Infer increment (frontend-side: same logic as backend, conservative for CREATE_MANY)\n      let increment: number;\n      if (check.increment !== undefined) {\n        increment = check.increment;\n      } else if (operationId === CoreResourceOperation.CREATE) {\n        increment = 1;\n      } else if (operationId === CoreResourceOperation.CREATE_MANY) {\n        increment = 1; // Conservative — backend does exact check\n      } else {\n        increment = 0;\n      }\n\n      if (increment === 0) continue;\n\n      if (currentUsage + increment > limit) {\n        const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n        const featureDef = featureDefinitions.get(check.featureId);\n        const { behavior } = resolveFeatureUnavailabilityBehavior({\n          reason,\n          featureDef,\n          policy: unavailabilityPolicy,\n          userRoles,\n          billingEnabled,\n        });\n        const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[check.featureId]?.availableVia;\n\n        return {\n          isAvailable: false,\n          reason,\n          behavior,\n          limitInfo: { featureId: check.featureId, current: currentUsage, limit },\n          upgradeOptions,\n          suggestedProductRef: featureDef?.unavailability?.suggestedProductRef,\n        };\n      }\n    }\n  }\n\n  // All checks passed\n  return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n}\n\n// ================================\n// Hook (convenience wrapper over pure function)\n// ================================\n\n/**\n * Resolve feature availability for an operation's requiredFeatures.\n * \n * @param operation - The frontend resource operation configuration\n * @returns FeatureAvailability — undefined if no requiredFeatures on the operation\n */\nexport function useOperationFeatureAvailability(\n  operation: FrontendResourceConfiguration_Operation | null | undefined,\n): FeatureAvailability | undefined {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  return useMemo((): FeatureAvailability | undefined => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return operation?.requiredFeatures\n        ? { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE }\n        : undefined;\n    }\n\n    // Build user roles for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    return resolveOperationFeatureAvailability(operation, {\n      resolvedFeatures,\n      resolvedFeaturesResponse,\n      featureDefinitions,\n      unavailabilityPolicy,\n      userRoles,\n      billingEnabled: billing?.isEnabled ?? false,\n    });\n  }, [\n    operation,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n}\n"]}

package/dist/esm/core/flows-actors/FlowsActorsContext.d.ts

@@ -1,8 +1,13 @@
 import React, { ReactNode } from 'react';
-import { FlowActorSystem_FrontendInfo, type FlowsActors_AutonomousAgent_FrontendInfo, type FlowsActors_ConversationHistoryResponse, type WS_FlowsActorsApprovalModificationRefusal, type HumanDecision_RouteKind, type WorkUnitRef } from '@wildo-ai/saas-models';
+import { FlowActorSystem_FrontendInfo, type FlowsActors_AutonomousAgent_FrontendInfo, type FlowsActors_ChatAgent_FrontendInfo, type FlowsActors_ConversationHistoryResponse, type WS_FlowsActorsApprovalModificationRefusal, type WS_FlowsActorsTurnUsage, FlowsActors_Status, type FlowsActors_MessageContentType, type HumanDecision_RouteKind, type HumanDecision_Presentation, type HumanDecision_Request, type HumanDecision_AnswerValue, type WorkUnitRef, type ResourceOperationRiskLevel } from '@wildo-ai/saas-models';
 import type { SerializableZodSchema } from '@wildo-ai/zod-decorators';
 /**
- * FlowsActors Execution Status
+ * How a turn stands in THIS CLIENT — its view of a turn, which is not the server's run status.
+ *
+ * Kept distinct on purpose (#2524): the client knows states the server never holds — STARTING (the start is sent and
+ * not yet acknowledged), and an ERROR it detects itself when the socket drops — and the server knows states the
+ * client never shows (READY, ABORTED). The WIRE speaks the server's vocabulary (`FlowsActors_Status` on
+ * `FLOWS_ACTORS_COMPLETED`), and {@link turnStatusFromServer} is the ONE place that reads it into this one.
  */
 export declare enum FlowsActorsExecutionStatus {
     IDLE = "idle",
@@ -10,8 +15,12 @@ export declare enum FlowsActorsExecutionStatus {
     RUNNING = "running",
     AWAITING_APPROVAL = "awaiting_approval",
     COMPLETED = "completed",
+    /** The person stopped the turn (#2524). Not an error: nothing failed, and the turn's thread continues. */
+    CANCELLED = "cancelled",
     ERROR = "error"
 }
+/** Read a server run status into the client's turn status — the one mapping (#2524). */
+export declare function turnStatusFromServer(status: FlowsActors_Status): FlowsActorsExecutionStatus;
 /**
  * Active Execution State
  */
@@ -19,10 +28,9 @@ export interface FlowsActorsExecution {
     executionId: string;
     systemRef: string;
     status: FlowsActorsExecutionStatus;
-    progress?: number;
-    currentStep?: string;
     messages: Array<{
-        type: 'text' | 'markdown' | 'progress' | 'data';
+        /** The message vocabulary's VALUE (`FlowsActors_MessageContentType`), the wire's `messageType`. */
+        type: `${FlowsActors_MessageContentType}`;
         content: string;
         data?: Record<string, unknown>;
         timestamp: Date;
@@ -35,20 +43,19 @@ export interface FlowsActorsExecution {
         messageId?: string;
     }>;
     /**
-     * The decision a paused turn is waiting on.
-     *
-     * `riskLevel` and `requiredRoles` are OPTIONAL because nothing populates them: they belong to
-     * `WS_FlowsActorsApprovalRequestPayload`, a payload no code has ever emitted. What the server
-     * actually announces is `WS_FlowsActorsApprovalAnnouncementData`, carried in the `data` bag of a
-     * PROGRESS message — tool name, tool arguments, timing, and the isolation axis (#528). Typing
-     * them as required would let a surface render a risk claim nothing declared.
+     * The decision a paused turn is waiting on, read from `WS_FlowsActorsApprovalAnnouncementData` — carried in the `data`
+     * bag of a PROGRESS message: tool name, tool arguments, timing, the isolation axis (#528), and the risk the call's
+     * approval gate declares (#2526).
      */
     pendingApproval?: {
         approvalId: string;
         actionDescription: string;
-        riskLevel?: 'low' | 'medium' | 'high' | 'critical';
+        /**
+         * The risk the call's approval gate DECLARES (`humanApproval.riskLevel`), as the decision's inbox card carries it
+         * (#2526). Absent when the gate declares none; a surface then shows no risk claim, because nothing declared one.
+         */
+        riskLevel?: ResourceOperationRiskLevel;
         expiresAt?: Date;
-        requiredRoles?: string[];
         /** The tool call being gated, and its arguments — the structured thing being approved. */
         toolName?: string;
         toolArgs?: Record<string, unknown>;
@@ -69,6 +76,13 @@ export interface FlowsActorsExecution {
         modificationRefusal?: WS_FlowsActorsApprovalModificationRefusal;
         /** The arguments the approver submitted in that refused edit, so the editor reopens on them (#587). */
         rejectedToolArgs?: Record<string, unknown>;
+        /**
+         * What the server built for the person to read (#2903): the arguments as strings it already projected, which the card
+         * renders verbatim. Absent on a turn paused before decisions were routed.
+         */
+        presentation?: HumanDecision_Presentation;
+        /** The presentation's id, echoed on the answer: the server refuses an answer that does not name what it was given on. */
+        presentationId?: string;
         requestedAt?: Date;
         /**
          * The decision's one id (#1594), ECHOED back on the answer. The server addresses the decision by
@@ -91,6 +105,11 @@ export interface FlowsActorsExecution {
          * screen, and the card says the reason was not one the application offers. Cleared by the next answer.
          */
         reasonCodeRefused?: boolean;
+        /**
+         * The QUESTION, when the paused call is the agent asking its person (#2720): its questions, its two answers and the
+         * form they are asked through. Answered with `answerQuestion`, never approved.
+         */
+        question?: HumanDecision_Request;
     };
     /** Set when the last error is recoverable (UI can offer a retry action) */
     recoverable?: boolean;
@@ -106,8 +125,9 @@ export interface FlowsActorsExecution {
         approval: NonNullable<FlowsActorsExecution['pendingApproval']>;
         submittedToolArgs?: Record<string, unknown>;
     };
-    result?: Record<string, unknown>;
     duration?: number;
+    /** The tokens the turn spent — present only for a person who may read model cost (#2524). */
+    usage?: WS_FlowsActorsTurnUsage;
     errorCode?: string;
 }
 /**
@@ -123,15 +143,26 @@ export interface FlowsActorsContextType {
      */
     autonomousAgents: FlowsActors_AutonomousAgent_FrontendInfo[];
     /**
-     * Ask for {@link autonomousAgents} to be loaded, whatever else this application renders.
+     * The chat agents the application declares (#2665), in declaration order — the closed set an organization's chat
+     * setting may name. Empty until the first fetch settles, and when the application declares none.
+     */
+    chatAgents: FlowsActors_ChatAgent_FrontendInfo[];
+    /**
+     * The chat connections an organization may choose an agent for (#2665): the application's providers enabled here
+     * with a chat endpoint (`slack`, `microsoft-teams-bot`). Empty until the first fetch settles, and when there is none.
+     */
+    chatConnectionRefs: string[];
+    /**
+     * Ask for the agent declarations — {@link autonomousAgents}, {@link chatAgents} and {@link chatConnectionRefs} — to be
+     * loaded, whatever else this application renders.
      *
      * The provider bootstraps `/flows-actors/frontend-info` only when the application configures a flows/actors
-     * VIEW (pinned: an application with no chat surface makes no such request). An autonomous agent needs no view —
-     * it runs unattended — so a surface that needs the declared agents (the OAuth client binding form, #1812) calls
-     * this instead. It fetches once per sign-in, and does nothing when a fetch already ran or cannot run yet
-     * (signed out, no backend endpoint, no http client). Idempotent, so call it from an effect.
+     * VIEW (pinned: an application with no chat surface makes no such request). Neither an autonomous agent nor a chat
+     * agent needs a view, so a surface that needs the declarations (the OAuth client binding form, #1812; the chat
+     * settings form, #2665) calls this instead. It fetches once per sign-in, and does nothing when a fetch already ran or
+     * cannot run yet (signed out, no backend endpoint, no http client). Idempotent, so call it from an effect.
      */
-    requestAutonomousAgents: () => void;
+    requestAgentDeclarations: () => void;
     /** Loading state */
     isLoading: boolean;
     /** Error state */
@@ -147,8 +178,14 @@ export interface FlowsActorsContextType {
      * so the model calls it makes are attributed to that case. Read when the thread OPENS; a later turn keeps the
      * thread's case. The server admits it only if the caller can read that row.
      */
-    startExecution: (systemRef: string, initialInput?: Record<string, unknown>, existingExecutionId?: string, extraContextResourceIdentifiers?: Record<string, string>, options?: {
+    startExecution: (systemRef: string, initialInput?: Record<string, unknown>, existingExecutionId?: string, extraContextResourceIdentifiers?: Record<string, string>, 
+    /**
+     * `messageId`: the id the person's message is stored under (#2525 review N1). A page drawing the message before the
+     * record holds it mints one, and recognises the stored message by it.
+     */
+    options?: {
         caseRef?: WorkUnitRef;
+        messageId?: string;
     }) => string | null;
     /** Respond to an approval request (fire-and-forget via WebSocket) */
     /**
@@ -158,6 +195,21 @@ export interface FlowsActorsContextType {
      */
     /** `reasonCode` is one of the approval's `reasonCodes` (#1921), given when the approver changes or rejects the call. */
     respondToApproval: (executionId: string, approvalId: string, approved: boolean, comment?: string, modifiedToolArgs?: Record<string, unknown>, reasonCode?: string) => void;
+    /**
+     * Answer the paused turn's QUESTION (#2720): the option chosen and, when it sends answers, one value per question as
+     * its JSON (what `HumanDecisionForm` reads). The server checks the values with the question's own form and refuses
+     * through `FLOWS_ACTORS_ERROR` with the question left pending.
+     */
+    answerQuestion: (executionId: string, optionRef: string, values: readonly {
+        ref: string;
+        value: HumanDecision_AnswerValue;
+    }[], comment?: string) => void;
+    /**
+     * Stop the person's own running turn (#2524). The server ends it CANCELLED, keeping what it had produced, and the
+     * turn settles on `FLOWS_ACTORS_COMPLETED` like any other — nothing is settled here, so a stop that races the turn's
+     * own end cannot leave the two disagreeing.
+     */
+    cancelExecution: (executionId: string) => void;
     /** Remove a completed/errored execution from state */
     clearExecution: (executionId: string) => void;
     /** Get execution by ID (reads from ref; consume `executions` to re-render on changes) */
@@ -167,18 +219,23 @@ export interface FlowsActorsContextType {
     /** Refresh systems from backend */
     refreshSystems: () => Promise<void>;
     /**
-     * Fetch the caller's OWN persisted conversation history for a system (chat
-     * threads), most recent last. Server-authoritative (the executions resource,
-     * USER_SELF-scoped to the caller) — this is what repopulates the discussions
-     * sidebar + transcripts on a fresh page load. Returns `[]` when the backend has
-     * no flows-actors history surface (feature absent).
-     */
-    /**
-     * The caller's own threads for a system. With `contextResourceIdentifiers`, only the threads
-     * opened in that context — the same identifiers passed to `startExecution`, canonicalised the
-     * same way — which is how a surface hosting one system for several subjects keeps them apart.
+     * The caller's OWN persisted threads for a system, server-authoritative (the executions resource, USER_SELF-scoped to
+     * the caller): what repopulates the discussion list and the transcripts on a fresh page load. With
+     * `contextResourceIdentifiers`, only the threads opened in that context — the same identifiers passed to
+     * `startExecution`, canonicalised the same way — which is how a surface hosting one system for several subjects keeps
+     * them apart.
+     *
+     * Reads a PAGE (#2528): the newest threads, or with `before` (the oldest `createdAt` a host already holds) the ones
+     * before it, inclusive — so a host keeps each `executionId` once. `hasOlder` says whether another page remains.
+     *
+     * Resolves an empty page when there are none, or when the backend has no flows-actors history surface (feature
+     * absent), and `undefined` when the read FAILED (#2525 review M4). The two must not look alike: a host re-reads after
+     * every turn, and treating a failure as "no threads" emptied its discussion list and transcript — under the very
+     * outage that had just ended the turn. Keep the last good list on `undefined`.
      */
-    fetchConversationHistory: (systemRef: string, contextResourceIdentifiers?: Record<string, string>) => Promise<FlowsActors_ConversationHistoryResponse['executions']>;
+    fetchConversationHistory: (systemRef: string, contextResourceIdentifiers?: Record<string, string>, page?: {
+        readonly before?: string;
+    }) => Promise<FlowsActors_ConversationHistoryResponse | undefined>;
     /**
      * Delete ONE of the caller's own persisted conversations (a discussion). Runs
      * under the caller's auth, so the executions resource's USER_SELF owner filter

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

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