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

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

@@ -1 +1 @@
-{"version":3,"file":"useFeatureAvailability.js","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureAvailability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,6BAA6B,EAC7B,2BAA2B,GAG5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,4DAA4D,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,MAAM,uEAAuE,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EACL,uBAAuB,EACvB,oCAAoC,GACrC,MAAM,yCAAyC,CAAC;AAEjD,kDAAkD;AAClD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;AA+B3C;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,MAAM,EACJ,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,GACV,GAAG,WAAW,EAAE,CAAC;IAElB,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAAC;IACtC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAwB,EAAE;QAC/C,+EAA+E;QAC/E,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,6BAA6B,CAAC,OAAO,EAAE,CAAC;QAChF,CAAC;QAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAErD,0CAA0C;QAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,oCAAoC,CAAC;gBACpE,MAAM,EAAE,2BAA2B,CAAC,cAAc;gBAClD,UAAU,EAAE,SAAS;gBACrB,MAAM,EAAE,oBAAoB;gBAC5B,SAAS,EAAE,EAAE;gBACb,cAAc,EAAE,OAAO,EAAE,SAAS,IAAI,KAAK;aAC5C,CAAC,CAAC;YACH,OAAO;gBACL,WAAW,EAAE,KAAK;gBAClB,MAAM,EAAE,2BAA2B,CAAC,cAAc;gBAClD,QAAQ;gBACR,eAAe,EAAE,CAAC,SAAS,CAAC;gBAC5B,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;aAC/D,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,MAAM,SAAS,GAAG,uBAAuB,CACvC,WAAW,EACX,QAAQ,EAAE,qBAAqB,IAAI,IAAI,CACxC,CAAC;QAEF,8BAA8B;QAC9B,IAAI,UAAU,CAAC,SAAS,KAAK,gBAAgB,CAAC,OAAO,EAAE,CAAC;YACtD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC7C,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,6BAA6B,CAAC,OAAO,EAAE,CAAC;YAChF,CAAC;YAED,iCAAiC;YACjC,MAAM,MAAM,GAAG,2BAA2B,CAAC,mBAAmB,CAAC;YAC/D,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,oCAAoC,CAAC;gBAC7G,MAAM;gBACN,UAAU;gBACV,MAAM,EAAE,oBAAoB;gBAC5B,SAAS;gBACT,cAAc,EAAE,OAAO,EAAE,SAAS,IAAI,KAAK;aAC5C,CAAC,CAAC;YAEH,4CAA4C;YAC5C,MAAM,cAAc,GAAG,wBAAwB,EAAE,cAAc,EAAE,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;YAE3F,OAAO;gBACL,WAAW,EAAE,KAAK;gBAClB,MAAM;gBACN,QAAQ;gBACR,eAAe,EAAE,CAAC,SAAS,CAAC;gBAC5B,cAAc;gBACd,mBAAmB;gBACnB,kBAAkB;gBAClB,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;aAC/D,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,IAAI,UAAU,CAAC,SAAS,KAAK,gBAAgB,CAAC,KAAK,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAEjD,uDAAuD;YACvD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,6BAA6B,CAAC,OAAO,EAAE,CAAC;YAChF,CAAC;YAED,+BAA+B;YAC/B,IAAI,KAAK,KAAK,kBAAkB,EAAE,CAAC;gBACjC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,6BAA6B,CAAC,OAAO,EAAE,CAAC;YAChF,CAAC;YAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAEnE,8BAA8B;YAC9B,IAAI,YAAY,GAAG,KAAK,EAAE,CAAC;gBACzB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,6BAA6B,CAAC,OAAO,EAAE,CAAC;YAChF,CAAC;YAED,sCAAsC;YACtC,MAAM,MAAM,GAAG,2BAA2B,CAAC,cAAc,CAAC;YAC1D,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,oCAAoC,CAAC;gBAC7G,MAAM;gBACN,UAAU;gBACV,MAAM,EAAE,oBAAoB;gBAC5B,SAAS;gBACT,cAAc,EAAE,OAAO,EAAE,SAAS,IAAI,KAAK;aAC5C,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,wBAAwB,EAAE,cAAc,EAAE,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;YAE3F,OAAO;gBACL,WAAW,EAAE,KAAK;gBAClB,MAAM;gBACN,QAAQ;gBACR,SAAS,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE;gBACtD,cAAc;gBACd,mBAAmB;gBACnB,kBAAkB;gBAClB,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;aAC/D,CAAC;QACJ,CAAC;QAED,sDAAsD;QACtD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,6BAA6B,CAAC,OAAO,EAAE,CAAC;IAChF,CAAC,EAAE;QACD,SAAS;QACT,SAAS;QACT,gBAAgB;QAChB,wBAAwB;QACxB,kBAAkB;QAClB,oBAAoB;QACpB,WAAW;QACX,QAAQ,EAAE,qBAAqB;QAC/B,OAAO,EAAE,SAAS;KACnB,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACtD,IAAI,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO;QAC3C,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/B,KAAK,CAAC,cAAc,EAAE;YACpB,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,KAAK,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["/**\n * useFeatureAvailability Hook\n * \n * Resolves \"is this feature available, and if not, what to do about it\" for a single feature.\n * Uses the FeaturesContext (resolved features + definitions + unavailability policy) and\n * UserOrgsContext (for role) to resolve the complete availability state.\n * \n * Policy cascade (first match wins):\n *   1. Per-feature override → feature.unavailability.behavior\n *   2. Per-feature role override → feature.unavailability.byRole[role]\n *   3. Global role default → policy.roleDefaults[role]\n *   4. Global reason default → policy.reasonDefaults[reason]\n *   5. Global default → policy.defaultBehavior\n * \n * Includes dev-only debugTrace for debugging policy resolution.\n */\n\nimport { useEffect, useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  type FeatureDefinition,\n  type FeatureUpgradeOption,\n} from '@wildo-ai/saas-models';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useAnalytics } from '~wildo-frontend-lib/core/monitoring/analytics/useAnalytics';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\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// Cross-instance dedup for feature gate analytics\nconst reportedFeatures = new Set<string>();\n\n// ================================\n// FeatureAvailability Type\n// ================================\n\nexport interface FeatureAvailability {\n  /** Whether the feature is available for the current context */\n  isAvailable: boolean;\n\n  // ── When not available ──\n  /** Why the feature is unavailable */\n  reason?: FeatureUnavailabilityReason;\n  /** What behavior the UI should adopt */\n  behavior: FeatureUnavailabilityBehavior;\n  /** Which feature(s) are missing (for boolean OR/AND modes) */\n  missingFeatures?: string[];\n  /** Limit information (for limit features) */\n  limitInfo?: { featureId: string; current: number; limit: number };\n  /** Upgrade options from the backend (from resolved features response) */\n  upgradeOptions?: FeatureUpgradeOption[];\n  /** Suggested product reference (from per-feature override) */\n  suggestedProductRef?: string;\n  /** Component reference for CUSTOM behaviour (from the feature's unavailability config). */\n  customComponentRef?: string;\n\n  // ── Debug (dev only) ──\n  /** Policy resolution trace — only populated in development mode */\n  debugTrace?: string[];\n}\n\n/**\n * Resolve availability + behavior for a single feature.\n * \n * @param featureId - The feature identifier to check\n * @returns FeatureAvailability — the resolved availability, behavior, and metadata\n */\nexport function useFeatureAvailability(featureId: string): FeatureAvailability {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const { track, isActive } = useAnalytics();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  const result = useMemo((): FeatureAvailability => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n    }\n\n    const featureDef = featureDefinitions.get(featureId);\n\n    // Feature not registered → NOT_CONFIGURED\n    if (!featureDef) {\n      const { behavior, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        featureDef: undefined,\n        policy: unavailabilityPolicy,\n        userRoles: [],\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n      return {\n        isAvailable: false,\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        behavior,\n        missingFeatures: [featureId],\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Build user roles array for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    // ── Boolean feature check ──\n    if (featureDef.valueType === FeatureValueType.BOOLEAN) {\n      const resolvedSet = new Set(resolvedFeatures.features);\n      const isEnabled = resolvedSet.has(featureId);\n      if (isEnabled) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Not enabled → resolve behavior\n      const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n      const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      // Get upgrade options from backend response\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        missingFeatures: [featureId],\n        upgradeOptions,\n        suggestedProductRef,\n        customComponentRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // ── Limit feature check ──\n    if (featureDef.valueType === FeatureValueType.LIMIT) {\n      const limit = resolvedFeatures.limits[featureId];\n\n      // No limit set → available (no restriction configured)\n      if (limit === undefined) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Unlimited → always available\n      if (limit === FEATURES_UNLIMITED) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      const currentUsage = resolvedFeatures.currentUsage[featureId] ?? 0;\n\n      // Under the limit → available\n      if (currentUsage < limit) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // At or over limit → resolve behavior\n      const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n      const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        limitInfo: { featureId, current: currentUsage, limit },\n        upgradeOptions,\n        suggestedProductRef,\n        customComponentRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Unknown value type → treat as available (defensive)\n    return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n  }, [\n    featureId,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n\n  useEffect(() => {\n    if (!isActive) return;\n    const dedupKey = `${featureId}:${result.isAvailable}`;\n    if (reportedFeatures.has(dedupKey)) return;\n    reportedFeatures.add(dedupKey);\n    track('feature_gate', {\n      featureRef: featureId,\n      isAvailable: result.isAvailable,\n      reason: result.reason,\n    });\n    if (result.isAvailable) {\n      track('feature_accessed', { featureId });\n    }\n  }, [featureId, result.isAvailable, result.reason, isActive, track]);\n\n  return result;\n}\n"]}
+{"version":3,"file":"useFeatureAvailability.js","sourceRoot":"","sources":["../../../../src/core/features/useFeatureAvailability.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useFeatureAvailability Hook\n * \n * Resolves \"is this feature available, and if not, what to do about it\" for a single feature.\n * Uses the FeaturesContext (resolved features + definitions + unavailability policy) and\n * UserOrgsContext (for role) to resolve the complete availability state.\n * \n * Policy cascade (first match wins):\n *   1. Per-feature override → feature.unavailability.behavior\n *   2. Per-feature role override → feature.unavailability.byRole[role]\n *   3. Global role default → policy.roleDefaults[role]\n *   4. Global reason default → policy.reasonDefaults[reason]\n *   5. Global default → policy.defaultBehavior\n * \n * Includes dev-only debugTrace for debugging policy resolution.\n */\n\nimport { useEffect, useMemo } from 'react';\nimport {\n  FEATURES_UNLIMITED,\n  FeatureValueType,\n  FeatureUnavailabilityBehavior,\n  FeatureUnavailabilityReason,\n  type FeatureDefinition,\n  type FeatureUpgradeOption,\n} from '@wildo-ai/saas-models';\nimport { useFeatures } from './useFeatures';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useAnalytics } from '~wildo-frontend-lib/core/monitoring/analytics/useAnalytics';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\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// Cross-instance dedup for feature gate analytics\nconst reportedFeatures = new Set<string>();\n\n// ================================\n// FeatureAvailability Type\n// ================================\n\nexport interface FeatureAvailability {\n  /** Whether the feature is available for the current context */\n  isAvailable: boolean;\n\n  // ── When not available ──\n  /** Why the feature is unavailable */\n  reason?: FeatureUnavailabilityReason;\n  /** What behavior the UI should adopt */\n  behavior: FeatureUnavailabilityBehavior;\n  /** Which feature(s) are missing (for boolean OR/AND modes) */\n  missingFeatures?: string[];\n  /** Limit information (for limit features) */\n  limitInfo?: { featureId: string; current: number; limit: number };\n  /** Upgrade options from the backend (from resolved features response) */\n  upgradeOptions?: FeatureUpgradeOption[];\n  /** Suggested product reference (from per-feature override) */\n  suggestedProductRef?: string;\n  /** Component reference for CUSTOM behaviour (from the feature's unavailability config). */\n  customComponentRef?: string;\n\n  // ── Debug (dev only) ──\n  /** Policy resolution trace — only populated in development mode */\n  debugTrace?: string[];\n}\n\n/**\n * Resolve availability + behavior for a single feature.\n * \n * @param featureId - The feature identifier to check\n * @returns FeatureAvailability — the resolved availability, behavior, and metadata\n */\nexport function useFeatureAvailability(featureId: string): FeatureAvailability {\n  const {\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    isLoading,\n  } = useFeatures();\n\n  const { permissions } = useUserOrgs();\n  const { track, isActive } = useAnalytics();\n  const billing = useBillingSafe();\n  const appScope = useAppScopeSafe();\n\n  const result = useMemo((): FeatureAvailability => {\n    // While loading, treat as available (optimistic — prevents flash of locked UI)\n    if (isLoading) {\n      return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n    }\n\n    const featureDef = featureDefinitions.get(featureId);\n\n    // Feature not registered → NOT_CONFIGURED\n    if (!featureDef) {\n      const { behavior, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        featureDef: undefined,\n        policy: unavailabilityPolicy,\n        userRoles: [],\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n      return {\n        isAvailable: false,\n        reason: FeatureUnavailabilityReason.NOT_CONFIGURED,\n        behavior,\n        missingFeatures: [featureId],\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Build user roles array for policy resolution\n    const userRoles = buildFeaturePolicyRoles(\n      permissions,\n      appScope?.currentOrganizationId ?? null,\n    );\n\n    // ── Boolean feature check ──\n    if (featureDef.valueType === FeatureValueType.BOOLEAN) {\n      const resolvedSet = new Set(resolvedFeatures.features);\n      const isEnabled = resolvedSet.has(featureId);\n      if (isEnabled) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Not enabled → resolve behavior\n      const reason = FeatureUnavailabilityReason.FEATURE_NOT_ENABLED;\n      const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      // Get upgrade options from backend response\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        missingFeatures: [featureId],\n        upgradeOptions,\n        suggestedProductRef,\n        customComponentRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // ── Limit feature check ──\n    if (featureDef.valueType === FeatureValueType.LIMIT) {\n      const limit = resolvedFeatures.limits[featureId];\n\n      // No limit set → available (no restriction configured)\n      if (limit === undefined) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // Unlimited → always available\n      if (limit === FEATURES_UNLIMITED) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      const currentUsage = resolvedFeatures.currentUsage[featureId] ?? 0;\n\n      // Under the limit → available\n      if (currentUsage < limit) {\n        return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n      }\n\n      // At or over limit → resolve behavior\n      const reason = FeatureUnavailabilityReason.LIMIT_EXCEEDED;\n      const { behavior, suggestedProductRef, customComponentRef, debugTrace } = resolveFeatureUnavailabilityBehavior({\n        reason,\n        featureDef,\n        policy: unavailabilityPolicy,\n        userRoles,\n        billingEnabled: billing?.isEnabled ?? false,\n      });\n\n      const upgradeOptions = resolvedFeaturesResponse?.upgradeOptions?.[featureId]?.availableVia;\n\n      return {\n        isAvailable: false,\n        reason,\n        behavior,\n        limitInfo: { featureId, current: currentUsage, limit },\n        upgradeOptions,\n        suggestedProductRef,\n        customComponentRef,\n        debugTrace: envLoader.isDevelopment() ? debugTrace : undefined,\n      };\n    }\n\n    // Unknown value type → treat as available (defensive)\n    return { isAvailable: true, behavior: FeatureUnavailabilityBehavior.DISABLE };\n  }, [\n    featureId,\n    isLoading,\n    resolvedFeatures,\n    resolvedFeaturesResponse,\n    featureDefinitions,\n    unavailabilityPolicy,\n    permissions,\n    appScope?.currentOrganizationId,\n    billing?.isEnabled,\n  ]);\n\n  useEffect(() => {\n    if (!isActive) return;\n    const dedupKey = `${featureId}:${result.isAvailable}`;\n    if (reportedFeatures.has(dedupKey)) return;\n    reportedFeatures.add(dedupKey);\n    track('feature_gate', {\n      featureRef: featureId,\n      isAvailable: result.isAvailable,\n      reason: result.reason,\n    });\n    if (result.isAvailable) {\n      track('feature_accessed', { featureId });\n    }\n  }, [featureId, result.isAvailable, result.reason, isActive, track]);\n\n  return result;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useFeatureGate.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAErE"}
+{"version":3,"file":"useFeatureGate.d.ts","sourceRoot":"","sources":["../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAErE"}

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

@@ -1 +1 @@
-{"version":3,"file":"useFeatureGate.js","sourceRoot":"","sources":["../../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAA4B,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/**\n * useFeatureGate Hook\n * \n * Separated from FeatureGate.tsx for React Fast Refresh compatibility.\n */\n\nimport { useFeatureAvailability, type FeatureAvailability } from './useFeatureAvailability';\n\n/**\n * Programmatic hook for checking a single feature's availability.\n * Equivalent to useFeatureAvailability — provides both the availability state and\n * a convenience `isAvailable` boolean.\n */\nexport function useFeatureGate(featureId: string): FeatureAvailability {\n  return useFeatureAvailability(featureId);\n}\n"]}
+{"version":3,"file":"useFeatureGate.js","sourceRoot":"","sources":["../../../../src/core/features/useFeatureGate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAA4B,MAAM,0BAA0B,CAAC;AAE5F;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/**\n * useFeatureGate Hook\n * \n * Separated from FeatureGate.tsx for React Fast Refresh compatibility.\n */\n\nimport { useFeatureAvailability, type FeatureAvailability } from './useFeatureAvailability';\n\n/**\n * Programmatic hook for checking a single feature's availability.\n * Equivalent to useFeatureAvailability — provides both the availability state and\n * a convenience `isAvailable` boolean.\n */\nexport function useFeatureGate(featureId: string): FeatureAvailability {\n  return useFeatureAvailability(featureId);\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useFeatures.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAO,mBAM9B,CAAC"}
+{"version":3,"file":"useFeatures.d.ts","sourceRoot":"","sources":["../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAO,mBAM9B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useFeatures.js","sourceRoot":"","sources":["../../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,eAAe,EAA4B,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAwB,EAAE;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/**\n * useFeatures Hook\n * \n * Separated from FeaturesContext.tsx for React Fast Refresh compatibility.\n * Provides access to the feature context: resolved features, definitions, policy, and convenience methods.\n */\n\nimport { useContext } from 'react';\nimport { FeaturesContext, type FeaturesContextType } from './FeaturesContext';\n\n/**\n * Hook to access the Features context.\n * @returns FeaturesContextType with resolved features, definitions, policy, and convenience methods.\n * @throws Error if used outside of FeaturesProvider.\n */\nexport const useFeatures = (): FeaturesContextType => {\n  const context = useContext(FeaturesContext);\n  if (!context) {\n    throw new Error('useFeatures must be used within a FeaturesProvider');\n  }\n  return context;\n};\n"]}
+{"version":3,"file":"useFeatures.js","sourceRoot":"","sources":["../../../../src/core/features/useFeatures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,eAAe,EAA4B,MAAM,mBAAmB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAwB,EAAE;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC","sourcesContent":["/**\n * useFeatures Hook\n * \n * Separated from FeaturesContext.tsx for React Fast Refresh compatibility.\n * Provides access to the feature context: resolved features, definitions, policy, and convenience methods.\n */\n\nimport { useContext } from 'react';\nimport { FeaturesContext, type FeaturesContextType } from './FeaturesContext';\n\n/**\n * Hook to access the Features context.\n * @returns FeaturesContextType with resolved features, definitions, policy, and convenience methods.\n * @throws Error if used outside of FeaturesProvider.\n */\nexport const useFeatures = (): FeaturesContextType => {\n  const context = useContext(FeaturesContext);\n  if (!context) {\n    throw new Error('useFeatures must be used within a FeaturesProvider');\n  }\n  return context;\n};\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,CAyIjC;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.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\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,5 +1,5 @@
 import React, { ReactNode } from 'react';
-import { FlowActorSystem_FrontendInfo, type FlowsActors_ConversationHistoryResponse, type WS_FlowsActorsApprovalModificationRefusal } from '@wildo-ai/saas-models';
+import { FlowActorSystem_FrontendInfo, type FlowsActors_AutonomousAgent_FrontendInfo, type FlowsActors_ConversationHistoryResponse, type WS_FlowsActorsApprovalModificationRefusal, type HumanDecision_RouteKind, type WorkUnitRef } from '@wildo-ai/saas-models';
 import type { SerializableZodSchema } from '@wildo-ai/zod-decorators';
 /**
  * FlowsActors Execution Status
@@ -71,11 +71,26 @@ export interface FlowsActorsExecution {
         rejectedToolArgs?: Record<string, unknown>;
         requestedAt?: Date;
         /**
-         * ECHOED back on the decision. Dropping it filters the resume against the default-instance
-         * sentinel, so an approval raised on a named agent instance matches no row and is discarded
-         * silently, leaving the turn paused forever.
+         * The decision's one id (#1594), ECHOED back on the answer. The server addresses the decision by
+         * it and reads everything else — owner, credential, agent instance — off the row.
          */
-        resourceServerInstanceRef?: string;
+        decisionRef?: string;
+        /**
+         * Who answers it (#1594). Anything but OWNER is answered by a reviewer from their inbox, and the person
+         * whose conversation this is may not answer it — so a surface shows it as waiting rather than offering
+         * buttons the server would refuse. Absent means OWNER (a pause raised before routes existed).
+         */
+        routeKind?: HumanDecision_RouteKind;
+        /**
+         * The reason codes the answer may carry (#1921) — the application's declared vocabulary, offered when the approver
+         * changes or rejects the call. Absent when the application declares none.
+         */
+        reasonCodes?: readonly string[];
+        /**
+         * Set when the server refused the last answer's reason code (#1921): the pause stands, the approval is back on
+         * screen, and the card says the reason was not one the application offers. Cleared by the next answer.
+         */
+        reasonCodeRefused?: boolean;
     };
     /** Set when the last error is recoverable (UI can offer a retry action) */
     recoverable?: boolean;
@@ -101,6 +116,22 @@ export interface FlowsActorsExecution {
 export interface FlowsActorsContextType {
     /** Available frontend-visible FlowActorSystems */
     systems: FlowActorSystem_FrontendInfo[];
+    /**
+     * The autonomous agents the application declares (#1611), in declaration order — the closed set an
+     * organization OAuth client may be bound to, so a binding form offers these rather than free text (#1812).
+     * Empty until the first fetch settles, and when the application declares none.
+     */
+    autonomousAgents: FlowsActors_AutonomousAgent_FrontendInfo[];
+    /**
+     * Ask for {@link autonomousAgents} 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.
+     */
+    requestAutonomousAgents: () => void;
     /** Loading state */
     isLoading: boolean;
     /** Error state */
@@ -111,15 +142,22 @@ export interface FlowsActorsContextType {
     /**
      * Send a turn. A new `executionId` opens a thread; an existing one continues it. The optional
      * identifiers are folded into the thread's `contextRef` on open (see `fetchConversationHistory`).
+     *
+     * `options.caseRef` (#1598) names the case the thread works on — a row of a resource declared `workUnit: true` —
+     * 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>) => string | null;
+    startExecution: (systemRef: string, initialInput?: Record<string, unknown>, existingExecutionId?: string, extraContextResourceIdentifiers?: Record<string, string>, options?: {
+        caseRef?: WorkUnitRef;
+    }) => string | null;
     /** Respond to an approval request (fire-and-forget via WebSocket) */
     /**
      * `modifiedToolArgs` (#566) replaces the arguments the agent proposed. Absent means "run the call
      * as proposed"; the server validates the edit against the tool's own schema and refuses through
      * `FLOWS_ACTORS_ERROR` with the approval left pending.
      */
-    respondToApproval: (executionId: string, approvalId: string, approved: boolean, comment?: string, modifiedToolArgs?: Record<string, unknown>) => void;
+    /** `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;
     /** 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) */

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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"}

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

@@ -57,6 +57,31 @@ export var FlowsActorsExecutionStatus;
     FlowsActorsExecutionStatus["COMPLETED"] = "completed";
     FlowsActorsExecutionStatus["ERROR"] = "error";
 })(FlowsActorsExecutionStatus || (FlowsActorsExecutionStatus = {}));
+/**
+ * The one mapping from a server approval announcement to the client's pending decision — shared by the
+ * live socket handler and the history seeding (#1601), so a decision reached either way renders and
+ * answers identically.
+ *
+ * `actionDescription` is the SERVER's sentence (the PROGRESS text, or the history's `description`),
+ * never composed here from `toolName`: that would invent display text no i18n tree owns.
+ */
+function pendingApprovalFromAnnouncement(announcement, actionDescription) {
+    const { approvalId, decisionRef, routeKind, toolName, toolArgs, toolInputSchema, requestedAt, expiresAt, reasonCodes } = announcement;
+    return {
+        approvalId,
+        actionDescription,
+        toolName,
+        toolArgs,
+        // A descriptor the transport does not re-validate (#587) — typed here for the editor, which falls
+        // back to raw JSON for any shape it cannot render as fields.
+        toolInputSchema: toolInputSchema,
+        requestedAt: new Date(requestedAt),
+        expiresAt: expiresAt ? new Date(expiresAt) : undefined,
+        decisionRef,
+        routeKind,
+        ...(reasonCodes && reasonCodes.length > 0 ? { reasonCodes } : {}),
+    };
+}
 /**
  * FlowsActors Context
  * @internal - Use useFlowsActors() hook instead of accessing this directly
@@ -78,6 +103,7 @@ export const FlowsActorsProvider = ({ children }) => {
     const hasInitializedRef = useRef(false);
     const hasConfiguredFlowsActorsViews = (frontendConfiguration?.flowsActorsViews?.length ?? 0) > 0;
     const [systems, setSystems] = useState([]);
+    const [autonomousAgents, setAutonomousAgents] = useState([]);
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
     const [executions, setExecutions] = useState(new Map());
@@ -124,6 +150,7 @@ export const FlowsActorsProvider = ({ children }) => {
             // registers with) so both sides stay in lockstep under MAIN_API_BASE_PATH.
             const data = await httpClient.get(`${MAIN_API_BASE_PATH}${MANUAL_CONTROLLER_ROUTES_URLS[ManualControllerRouteKey.FLOWS_ACTORS_FRONTEND_INFO]}`);
             setSystems(data.systems);
+            setAutonomousAgents(data.autonomousAgents);
             setHasCompletedFetch(true);
             logDebug('Systems refreshed', { count: data.systems.length });
         }
@@ -131,6 +158,7 @@ export const FlowsActorsProvider = ({ children }) => {
             if (errorManagement.isNotFoundError(err)) {
                 logDebug('FlowsActors backend support not available - skipping systems bootstrap');
                 setSystems([]);
+                setAutonomousAgents([]);
                 setError(null);
                 setHasCompletedFetch(true);
                 return;
@@ -165,6 +193,35 @@ export const FlowsActorsProvider = ({ children }) => {
             const query = `?systemRef=${encodeURIComponent(systemRef)}${contextRef === undefined ? '' : `&contextRef=${encodeURIComponent(contextRef)}`}`;
             const data = await httpClient.get(`${basePath}${query}`);
             logDebug('Conversation history fetched', { systemRef, count: data.executions.length });
+            /*
+             * A thread whose turn is paused on a decision becomes an execution here, carrying that
+             * decision (#1601). The pause is announced only over the live socket, so a page that loaded
+             * after it — a reload, a second tab, a restart — had a thread waiting on an answer and nothing
+             * to answer it with: the creator saw their message sit unanswered. The history route now
+             * returns the same announcement the socket carried, and it is folded through the same mapping.
+             *
+             * A live entry is never replaced: the socket is the fresher source for a turn this page is
+             * watching, and a seeded copy could revive a decision this client just answered.
+             */
+            const paused = data.executions.filter((row) => row.pendingApproval !== undefined);
+            if (paused.length > 0) {
+                setExecutions((prev) => {
+                    let next;
+                    for (const row of paused) {
+                        if (prev.has(row.executionId) || row.pendingApproval === undefined)
+                            continue;
+                        next ??= new Map(prev);
+                        next.set(row.executionId, {
+                            executionId: row.executionId,
+                            systemRef: row.systemRef,
+                            status: FlowsActorsExecutionStatus.AWAITING_APPROVAL,
+                            messages: [],
+                            pendingApproval: pendingApprovalFromAnnouncement(row.pendingApproval, row.pendingApproval.description),
+                        });
+                    }
+                    return next ?? prev;
+                });
+            }
             return data.executions;
         }
         catch (err) {
@@ -193,7 +250,7 @@ export const FlowsActorsProvider = ({ children }) => {
      * Start a new execution via WebSocket (fire-and-forget).
      * Errors are delivered asynchronously via FLOWS_ACTORS_STARTED / FLOWS_ACTORS_ERROR events.
      */
-    const startExecution = useCallback((systemRef, initialInput, existingExecutionId, extraContextResourceIdentifiers) => {
+    const startExecution = useCallback((systemRef, initialInput, existingExecutionId, extraContextResourceIdentifiers, options) => {
         if (!isConnected) {
             logDebug('Cannot start execution — WebSocket not connected', { systemRef });
             return null;
@@ -232,6 +289,7 @@ export const FlowsActorsProvider = ({ children }) => {
             executionId,
             contextResourceIdentifiers,
             initialInput,
+            ...(options?.caseRef ? { caseRef: options.caseRef } : {}),
         });
         return executionId;
     }, [isConnected, emit, appScope?.currentOrganizationId]);
@@ -239,7 +297,7 @@ export const FlowsActorsProvider = ({ children }) => {
      * Respond to an approval request via WebSocket (fire-and-forget).
      * Backend confirms via FLOWS_ACTORS_STATUS_UPDATE / FLOWS_ACTORS_ERROR events.
      */
-    const respondToApproval = useCallback((executionId, approvalId, approved, comment, modifiedToolArgs) => {
+    const respondToApproval = useCallback((executionId, approvalId, approved, comment, modifiedToolArgs, reasonCode) => {
         const execution = executionsRef.current.get(executionId);
         if (!execution) {
             logDebug('Cannot respond to approval — execution not found', { executionId, approvalId });
@@ -257,13 +315,11 @@ export const FlowsActorsProvider = ({ children }) => {
             approved,
             comment,
             /*
-             * Echoed, never omitted. The resume filters on owner FK + machine credential + AGENT
-             * INSTANCE; without this axis the read is filtered against the default-instance sentinel, so
-             * a decision on an approval raised by a NAMED agent matches no row and is dropped silently —
-             * logged as "no pending approval matches", with the turn paused forever. The server sends it
-             * unconditionally for exactly this reason.
+             * The decision's id, echoed (#1594). The server addresses the answer by it and reads the owner,
+             * credential and agent instance off the row — so nothing here can point the answer at a different
+             * conversation, and a reviewer answering someone else's decision reaches it.
              */
-            resourceServerInstanceRef: execution.pendingApproval?.resourceServerInstanceRef,
+            ...(execution.pendingApproval?.decisionRef ? { decisionRef: execution.pendingApproval.decisionRef } : {}),
             /*
              * The arguments the approver AUTHORED (#566), when they edited the proposed call.
              *
@@ -272,6 +328,9 @@ export const FlowsActorsProvider = ({ children }) => {
              * refusal — the mirror of the defect that made this field necessary.
              */
             ...(modifiedToolArgs ? { modifiedToolArgs } : {}),
+            // Why the approver changed or rejected the call (#1921), one of the application's declared codes. The server
+            // checks it against the same vocabulary and refuses an undeclared one, leaving the pause standing.
+            ...(reasonCode ? { reasonCode } : {}),
         });
         updateExecution(executionId, exec => ({
             ...exec,
@@ -314,9 +373,20 @@ export const FlowsActorsProvider = ({ children }) => {
         }
         hasInitializedRef.current = false;
         setSystems([]);
+        setAutonomousAgents([]);
         setError(null);
         setExecutions(new Map());
     }, [userOrgs]);
+    const requestAutonomousAgents = useCallback(() => {
+        if (hasInitializedRef.current
+            || !appConfig?.runtime?.endPoints?.main_backend_api
+            || !httpClient
+            || !userOrgs.isAuthenticated()) {
+            return;
+        }
+        hasInitializedRef.current = true;
+        void refreshSystems();
+    }, [appConfig?.runtime?.endPoints?.main_backend_api, httpClient, userOrgs, refreshSystems]);
     useEffect(() => {
         if (!hasInitializedRef.current
             && hasConfiguredFlowsActorsViews
@@ -409,28 +479,16 @@ export const FlowsActorsProvider = ({ children }) => {
              */
             const announcement = WS_FlowsActorsApprovalAnnouncementDataSchema.safeParse(payload.data);
             if (announcement.success) {
-                const { approvalId, toolName, toolArgs, toolInputSchema, requestedAt, expiresAt, resourceServerInstanceRef } = announcement.data;
+                const { approvalId, toolName } = announcement.data;
                 logDebug('Approval requested', { executionId: payload.executionId, approvalId, toolName });
                 updateExecution(payload.executionId, exec => ({
                     ...exec,
                     status: FlowsActorsExecutionStatus.AWAITING_APPROVAL,
                     // A new pause supersedes whatever this client answered before it.
                     answeredApproval: undefined,
-                    pendingApproval: {
-                        approvalId,
-                        // The server's own PROGRESS text, reused rather than composed here: manufacturing
-                        // display text from `toolName` in the browser would invent wording that no i18n
-                        // tree owns.
-                        actionDescription: payload.content,
-                        toolName,
-                        toolArgs,
-                        // A descriptor the transport does not re-validate (#587) — typed here for the editor,
-                        // which falls back to raw JSON for any shape it cannot render as fields.
-                        toolInputSchema: toolInputSchema,
-                        requestedAt: new Date(requestedAt),
-                        expiresAt: expiresAt ? new Date(expiresAt) : undefined,
-                        resourceServerInstanceRef,
-                    },
+                    // The server's own PROGRESS text, reused rather than composed here: manufacturing
+                    // display text from `toolName` in the browser would invent wording that no i18n tree owns.
+                    pendingApproval: pendingApprovalFromAnnouncement(announcement.data, payload.content),
                 }));
             }
             updateExecution(payload.executionId, exec => ({
@@ -454,9 +512,8 @@ export const FlowsActorsProvider = ({ children }) => {
          * withdrawn is a decision recorded on #528, not something to settle by deleting the listener:
          * if it is ever emitted, an approval must still be observable here.
          *
-         * Note it cannot supply `resourceServerInstanceRef` — its payload has no such field — so a
-         * decision answered from this path alone would still be unresumable on a named agent instance.
-         * That is another reason the payload's fate needs deciding rather than assuming.
+         * Note it carries no `decisionRef`, so a decision answered from this path is resolved by the
+         * server from `executionId` + `approvalId`.
          */
         const unsubApproval = on(CoreWebSocketEvent.FLOWS_ACTORS_APPROVAL_REQUEST, (payload) => {
             logDebug('Approval requested', { executionId: payload.executionId, approvalId: payload.approvalId, riskLevel: payload.riskLevel });
@@ -520,6 +577,30 @@ export const FlowsActorsProvider = ({ children }) => {
                             ...exec.answeredApproval.approval,
                             modificationRefusal: payload.approvalModificationRefusal ?? { reason: '' },
                             rejectedToolArgs: exec.answeredApproval.submittedToolArgs,
+                            // A refusal of THIS answer, not the reason code of an earlier one (#1921).
+                            reasonCodeRefused: undefined,
+                        },
+                        answeredApproval: undefined,
+                    };
+                }
+                /*
+                 * A reason code the application does not declare is refused while the pause stands (#1921). The approval goes
+                 * back on screen as it was asked, and the card says why in its own labels — the server's English sentence is
+                 * not appended to the conversation, because words a reader sees come from the label tree.
+                 */
+                if (payload.recoverable
+                    && payload.errorCode === FlowsActors_ExecutionErrorCode.APPROVAL_REASON_CODE_REJECTED
+                    && exec.answeredApproval) {
+                    return {
+                        ...exec,
+                        status: FlowsActorsExecutionStatus.AWAITING_APPROVAL,
+                        recoverable: payload.recoverable,
+                        errorCode: payload.errorCode,
+                        pendingApproval: {
+                            ...exec.answeredApproval.approval,
+                            modificationRefusal: undefined,
+                            rejectedToolArgs: undefined,
+                            reasonCodeRefused: true,
                         },
                         answeredApproval: undefined,
                     };
@@ -544,6 +625,7 @@ export const FlowsActorsProvider = ({ children }) => {
                             ...exec.answeredApproval.approval,
                             modificationRefusal: undefined,
                             rejectedToolArgs: exec.answeredApproval.submittedToolArgs,
+                            reasonCodeRefused: undefined,
                         },
                         answeredApproval: undefined,
                         messages: appendMessages(exec.messages, {
@@ -579,6 +661,8 @@ export const FlowsActorsProvider = ({ children }) => {
     }, [isConnected, on, updateExecution]);
     const contextValue = useMemo(() => ({
         systems,
+        autonomousAgents,
+        requestAutonomousAgents,
         isLoading,
         error,
         executions,
@@ -590,7 +674,7 @@ export const FlowsActorsProvider = ({ children }) => {
         refreshSystems,
         fetchConversationHistory,
         deleteConversation,
-    }), [systems, isLoading, error, executions, startExecution, respondToApproval, clearExecution, getExecution, getSystem, refreshSystems, fetchConversationHistory, deleteConversation]);
+    }), [systems, autonomousAgents, requestAutonomousAgents, isLoading, error, executions, startExecution, respondToApproval, clearExecution, getExecution, getSystem, refreshSystems, fetchConversationHistory, deleteConversation]);
     return (_jsx(FlowsActorsContext.Provider, { value: contextValue, children: children }));
 };
 //# sourceMappingURL=FlowsActorsContext.js.map