@spottoai/types-package 1.0.2-beta.99 → 1.0.2-dev1138.12

package/dist/azure/recommendations.d.ts

@@ -1,7 +1,23 @@
-import { Comment, RecommendationHistory } from './recommendationState';
+import type { Comment, CommentScope, RecommendationHistory } from './recommendationState';
+import type { ProviderScope } from '../common/provider';
 import { SecurityAssessmentStatus, SecurityImpact, SubscriptionSecurityStatus } from './security';
 import { SubscriptionSummaryLite } from './subscriptions';
-import { SavingsPotential } from './views';
+import type { CostSavingsAggregationPolicy, CostSavingsSpendBasis, CostSavingsSummary, CurrencySavingsGroup, SavingsPotential, VmPricePerformanceInsights } from './views';
+import type { HaloRoutingOverrides } from '../integrations/halo';
+import type { AutotaskShareOverrides } from '../integrations/autotask';
+import type { AzureDevOpsShareOverrides } from '../integrations/azureDevOps';
+import type { GitHubShareOverrides } from '../integrations/github';
+import type { Tags } from '../tags';
+import type { AzurePortalVersionedArtifact } from './portalArtifacts';
+import type { RecommendationSystemTrackClassification } from './recommendationTracks';
+import type { LicensingRecommendationRenderData } from './licensing';
+import type { ResourceSimpleOptimizationProfile } from './resourceOptimization';
+import type { CostComposition, EstimateLens } from './costComposition.js';
+import type { PortfolioSavingsContributionV2, SavingsAggregateV2, ScenarioSavingsPotentialV2 } from './savings.js';
+import type { FinancialSavingsQuerySelectionV1, FinancialSavingsSurfaceProjectionV1 } from './financialSavingsSurfaceProjection.js';
+import type { FinancialEvidenceCoverageProjectionV1 } from './financialEvidenceCoverage.js';
+import type { FinancialResourceSurfaceProjectionV1 } from './financialResourceSurfaceProjection.js';
+import type { MetricAggregationType } from './metrics.js';
 export declare enum RecommendationCategory {
     Cost = "Cost",
     Performance = "Performance",
@@ -11,14 +27,241 @@ export declare enum RecommendationCategory {
     OperationalExcellence = "OperationalExcellence",
     OperationalExcellenceAlternative = "Operational Excellence"
 }
+export type RecommendationPriorityTier = 'must_do' | 'normal';
+export type RecommendationCostImpactUnit = 'percent';
+export type EffortEstimateProfileName = 'clickops' | 'devops' | 'enterprise';
+export interface RecommendationBaseScores {
+    cost_optimization: number;
+    security: number;
+    performance: number;
+    reliability: number;
+    compliance: number;
+    operational_excellence: number;
+}
+export interface RecommendationEffortEstimateBreakdown {
+    discovery: number;
+    implementation: number;
+    validation: number;
+    rollbackPlanning: number;
+    coordination: number;
+}
+export interface RecommendationEffortEstimateProfile {
+    effortHours: number;
+    breakdown: RecommendationEffortEstimateBreakdown;
+    reason: string;
+}
+export interface RecommendationEffortEstimateProfiles {
+    clickops: RecommendationEffortEstimateProfile;
+    devops: RecommendationEffortEstimateProfile;
+    enterprise: RecommendationEffortEstimateProfile;
+}
+export interface RecommendationBulkEffortEstimateProfile {
+    setupHours: number;
+    perResourceHours: number;
+    validationHours: number;
+}
+export interface RecommendationBulkEffortEstimateProfiles {
+    clickops: RecommendationBulkEffortEstimateProfile;
+    devops: RecommendationBulkEffortEstimateProfile;
+    enterprise: RecommendationBulkEffortEstimateProfile;
+}
+export interface RecommendationBulkEffortEstimates {
+    supported: boolean;
+    threshold: number;
+    profiles: RecommendationBulkEffortEstimateProfiles;
+}
+export interface RecommendationEffortEstimates {
+    profiles: RecommendationEffortEstimateProfiles;
+    bulk: RecommendationBulkEffortEstimates;
+    overridden?: boolean;
+    lastUpdatedAt?: string;
+    notes?: string;
+}
+export interface RecommendationActionImpactAssessment {
+    downtime: string;
+    dataLoss: string;
+    accessImpact: string;
+    dependencies: string;
+}
+export type RecommendationActionRiskLevel = 'low' | 'medium' | 'high';
+export interface RecommendationActionRollback {
+    supported: boolean;
+    description: string;
+    limitations: string[];
+}
+export interface RecommendationActionCheck {
+    label: string;
+    description: string;
+}
+export interface RecommendationActionLink {
+    label: string;
+    url: string;
+}
+export interface RecommendationActionPostValidation {
+    label: string;
+    description: string;
+    expectedResult: string;
+    links?: RecommendationActionLink[];
+}
+export type RecommendationActionPermissionProvider = 'azure-rbac';
+export type RecommendationActionPermissionScope = 'targetResource' | 'resourceGroup' | 'subscription' | 'tenant';
+export interface RecommendationActionPermissionRequirement {
+    label: string;
+    name: string;
+    reason: string;
+    links?: RecommendationActionLink[];
+}
+export interface RecommendationActionLeastPrivilegeRole {
+    label: string;
+    description: string;
+}
+export interface RecommendationActionSuggestedRole {
+    label: string;
+    roleName: string;
+    roleDefinitionId?: string;
+    reason: string;
+}
+export interface RecommendationActionRequiredPermissions {
+    provider: RecommendationActionPermissionProvider;
+    scope: RecommendationActionPermissionScope;
+    actions: RecommendationActionPermissionRequirement[];
+    dataActions: RecommendationActionPermissionRequirement[];
+    leastPrivilegeRole?: RecommendationActionLeastPrivilegeRole;
+    suggestedRoles?: RecommendationActionSuggestedRole[];
+}
+export interface RecommendationActionDefinition {
+    verified: boolean;
+    actionDefinitionId?: string;
+    title: string;
+    description: string;
+    estimatedDuration: string;
+    riskLevel: RecommendationActionRiskLevel;
+    requiredPermissions?: RecommendationActionRequiredPermissions;
+    impactAssessment: RecommendationActionImpactAssessment;
+    rollback: RecommendationActionRollback;
+    humanPreChecks: RecommendationActionCheck[];
+    postValidation: RecommendationActionPostValidation[];
+}
+export type RecommendationActionMetadata = RecommendationActionDefinition;
+export type RecommendationImplementActionImpactAssessment = RecommendationActionImpactAssessment;
+export type RecommendationImplementAction = RecommendationActionMetadata;
 export interface RecommendationResources {
     recommendation: CustomAzureRecommendation;
     resourceIds: string[];
 }
+export type HddSsdMigrationTargetTier = 'standardSsd' | 'premiumSsd';
+export type HddDiskPricingRedundancy = 'LRS' | 'ZRS';
+export interface HddOsRetirementCurrentDiskPricing {
+    storageTier: 'standardHdd';
+    skuName: string;
+    pricingRedundancy?: HddDiskPricingRedundancy;
+    sizeGiB: number;
+    monthlyActual: number;
+    monthlyRetail: number;
+}
+export interface HddOsRetirementTargetDiskPricing {
+    storageTier: HddSsdMigrationTargetTier;
+    skuName: string;
+    pricingRedundancy?: HddDiskPricingRedundancy;
+    sizeGiB: number;
+    monthlyRetail: number;
+}
+export interface HddOsRetirementDiskRenderItem {
+    resourceId: string;
+    resourceName: string;
+    resourceType: string;
+    /** Canonical location key used for pricing lookup, e.g. "westus". */
+    pricingLocation?: string;
+    current: HddOsRetirementCurrentDiskPricing;
+    standardSsd: HddOsRetirementTargetDiskPricing & {
+        storageTier: 'standardSsd';
+    };
+    premiumSsd: HddOsRetirementTargetDiskPricing & {
+        storageTier: 'premiumSsd';
+    };
+    defaultSelection?: HddSsdMigrationTargetTier;
+}
+export interface HddOsRetirementRenderStrategyPayload {
+    retirementDate: string;
+    retirementLink: string;
+    currencyCode?: string;
+    currencySymbol?: string;
+    defaultTargetTier?: HddSsdMigrationTargetTier;
+    impactedDiskCount: number;
+    currentMonthlyActual: number;
+    currentMonthlyRetail: number;
+    standardSsdMonthlyRetail: number;
+    premiumSsdMonthlyRetail: number;
+    standardSsdMonthlyDelta: number;
+    premiumSsdMonthlyDelta: number;
+    disks: HddOsRetirementDiskRenderItem[];
+}
+/**
+ * One reservation-purchase compatibility group within the currently loaded
+ * recommendation scope. The key includes the provider scope so independently
+ * actionable Azure subscriptions never collapse into one purchase group.
+ */
+export interface ReservedInstanceRecommendationCompatibilityGroup {
+    key: string;
+    providerScopeId: string;
+    sourceRecommendationIds: string[];
+    resourceIds: string[];
+    location: string;
+    skuName: string;
+    resourceType: string;
+    vmSizeFlexibilityGroup?: string;
+    platform?: 'linux' | 'windows' | 'unknown';
+}
+/**
+ * Presentation-family evidence for resource-specific Reserved Instance
+ * recommendations. Source IDs remain authoritative for resource-level joins;
+ * familyId is only the stable identity of the grouped recommendation surface
+ * and must not be used for recommendation state, audit, sharing or actions.
+ */
+export interface ReservedInstanceRecommendationRenderData {
+    kind: 'reserved-instance-opportunity';
+    familyId: 'benefits-resource-ri';
+    sourceRecommendationIds: string[];
+    compatibilityGroups: ReservedInstanceRecommendationCompatibilityGroup[];
+}
+export type RecommendationKnownRenderData = HddOsRetirementRenderStrategyPayload | VmPricePerformanceInsights | LicensingRecommendationRenderData | ReservedInstanceRecommendationRenderData;
+export type AnyRecommendationRenderData = Record<string, unknown>;
+export type RecommendationDecisionRelationshipKind = 'review_first' | 'alternative' | 'trade_off' | 'follow_up' | 'unlocks' | 'conflicts_with';
+export type RecommendationDecisionContextRole = 'primary' | 'alternative' | 'trade_off' | 'follow_up' | 'supporting';
+export type RecommendationDecisionReviewPriority = 'review_first' | 'normal';
+/**
+ * Resource-specific relationship from one recommendation to another.
+ * Used by UIs to explain alternatives and follow-ups without changing recommendation state.
+ */
+export interface RecommendationDecisionLink {
+    recommendationId: string;
+    kind: RecommendationDecisionRelationshipKind;
+    label?: string;
+    reason?: string;
+    condition?: string;
+}
+/**
+ * Resource-specific decision context for an existing recommendation.
+ * The recommendation remains independently visible and actionable by recommendationId.
+ */
+export interface RecommendationDecisionContext {
+    recommendationId: string;
+    role?: RecommendationDecisionContextRole;
+    reviewPriority?: RecommendationDecisionReviewPriority;
+    groupId?: string;
+    title?: string;
+    explanation?: string;
+    links: RecommendationDecisionLink[];
+    selectedLens?: EstimateLens;
+    costComposition?: CostComposition;
+}
 export interface Recommendation {
+    /** Business identity of a recommendation record (routing/state/sharing/dedupe). */
     id: string;
     name: string;
     category: RecommendationCategory;
+    subCategory?: string;
+    aggregateDescription?: string;
     /** custom */
     type?: string;
     description?: string;
@@ -30,30 +273,49 @@ export interface Recommendation {
         url: string;
     }[];
     considerations?: string;
+    currency?: string;
     potentialBenefits?: string;
+    potentialMonthlySavings?: number;
+    /** Canonical savings projection attached by completed view producers. */
+    savings?: SavingsPotential;
     effort?: string;
     effortReason?: string;
     /** e.g. 10 hours */
     effortHours?: number;
+    /** Detailed implementation estimates by delivery profile and bulk rollout mode. */
+    effortEstimates?: RecommendationEffortEstimates;
     risk?: string;
     riskReason?: string;
-    /** Could deprecate later */
+    severity?: string;
+    /** Relative cost percentage, e.g. -40 means a 40% reduction. Never a currency amount. */
     costImpact?: number;
+    /** Explicit discriminator for new payloads while legacy percentage-only payloads remain readable. */
+    costImpactUnit?: RecommendationCostImpactUnit;
     costImpactReason?: string;
-    costImpactDetails?: CostImpactDetails;
+    /*** costImpactDetails is deprecated **/
     performanceImpact?: number;
     performanceImpactReason?: string;
     confidencePercentage?: number;
     confidenceReason?: string;
     /** array of resources that have this recommendation */
     resources?: ResourceReference[];
+    /** Compact resource references for resource-specific detail payloads. */
+    resourceIds?: string[];
+    /** Total affected resources when resourceIds is trimmed or sampled. */
+    resourcesCount?: number;
     /** only for security recommendations */
     securityImpactDetails?: SecurityImpact;
     /** whether the recommendation has been resolved or not, eg, Security Assessment is "Healthy" should be true */
     resolved?: boolean;
     securityAssessmentStatuses?: SecurityAssessmentStatus[];
+    /** Complete assessment counts retained by compact report evidence. */
+    securityAssessmentSummary?: {
+        unhealthyCount: number;
+        totalCount: number;
+    };
+    /** Reporting projection clipped editorial context; use the source finding instead of an inferred theme. */
+    reportingTextTruncated?: boolean;
     /** Deprecated fields, kept for compatibility */
-    subcategory?: string;
     solution?: string;
     source?: string;
     service?: string;
@@ -64,7 +326,42 @@ export interface Recommendation {
     createdTime?: string;
     /** Avoids conflict with RecommendationWithState.updatedAt */
     lastUpdatedTime?: string;
+    /** Business story properties */
+    title?: string;
+    headline?: string;
+    bottomLine?: string;
+    plainSummary?: string;
+    quickSteps?: string[];
+    businessOwner?: string;
+    keyConstraint?: string;
+    validationEvidence?: string;
+    read?: boolean;
+    /** Technical playbook (only for multi-step implementations) */
+    technicalPlaybook?: string;
+    /** Static recommendation scoring metadata (library-level). */
+    baseScores?: RecommendationBaseScores;
+    overallBaseScore?: number;
+    overallBaseReason?: string;
+    priorityTier?: RecommendationPriorityTier;
+    /** Runtime scoring metadata (per company/tenant). */
+    adjustedScore?: number;
+    objectiveMultiplier?: number;
+    finalScore?: number;
+    /** UI display-only normalized score (0-100). */
+    normalizedScore?: number;
+    /** Optional system-track classification emitted from the checked-in recommendation registry. */
+    systemTrackClassification?: RecommendationSystemTrackClassification;
+    /** Cross-feature linkage IDs used for deep links and related views. */
+    linkingIds?: RecommendationLinkingIds;
+    /** Optional UI render payload consumed by recommendation-specific components. */
+    renderData?: RecommendationKnownRenderData | AnyRecommendationRenderData;
+    /** Optional action definition for implement-capable recommendations. */
+    action?: RecommendationActionMetadata;
+}
+export interface RecommendationLinkingIds {
+    serviceRetirementIds?: string[];
 }
+/** Deprecated **/
 export interface CostImpactDetails {
     /** e.g. "Saving Plan", "Reserved Instance", "Windows migration to Linux" */
     name: string;
@@ -84,25 +381,248 @@ export interface RecommendationSummary {
 }
 export interface RecommendationWithResources {
     recommendation: Recommendation;
+    /** Total affected resources when the resources array is trimmed or sampled. */
+    resourcesCount?: number;
     resources: RecommendationResource[];
+    /** Homogeneous-currency savings only. Omit for mixed-currency projections. */
     savings?: SavingsPotential;
+    /** Standalone recommendation scenario. This value is not portfolio-additive. */
+    scenarioSavings?: ScenarioSavingsPotentialV2;
+    /** Canonical producer-attributed contribution. This value is portfolio-additive. */
+    portfolioContribution?: PortfolioSavingsContributionV2;
+    /**
+     * @deprecated No Azure producer owns this compatibility field. Use
+     * `portfolioContribution` for additive recommendation attribution.
+     */
+    savingsByCurrency?: CurrencySavingsGroup[];
+    /** Canonical resource ID that owns this recommendation savings amount for aggregation */
+    savingsOwnerResourceId?: string;
+    /** Resource IDs that may display this recommendation savings amount as context */
+    savingsDisplayResourceIds?: string[];
+    /** Billable component key used with the owner ID to prevent double counting */
+    billableComponentKey?: string;
+    /** Aggregation rule for this recommendation savings amount */
+    savingsAggregationPolicy?: CostSavingsAggregationPolicy;
+}
+export interface RecommendationLifecycleStateProjectionV1 {
+    recommendationId: string;
+    scope: 'resource' | 'providerScope';
+    resourceId?: string;
+    providerScopeId: string;
+    status: 'Active' | 'Prioritized' | 'Dismissed' | 'Archived' | 'Implementing' | 'Implemented' | 'Failed';
+    statusStartAt?: string;
+    statusEndAt?: string;
+    updatedAt?: string;
+}
+export declare const RECOMMENDATION_LIFECYCLE_OVERLAY_SCHEMA_VERSION_V2: 2;
+export declare const RECOMMENDATION_LIFECYCLE_OVERLAY_CONTRACT_VERSION_V2: "recommendation-lifecycle-overlay/v2";
+export interface RecommendationLifecycleOverlayStateV2 {
+    recommendationId: string;
+    scope: 'resource' | 'providerScope';
+    resourceId?: string;
+    status: RecommendationLifecycleStateProjectionV1['status'];
+    statusStartAt?: string;
+    statusEndAt?: string;
+    updatedAt: string;
+    revision: string;
+}
+interface RecommendationLifecycleOverlayCommonV2 {
+    schemaVersion: typeof RECOMMENDATION_LIFECYCLE_OVERLAY_SCHEMA_VERSION_V2;
+    contractVersion: typeof RECOMMENDATION_LIFECYCLE_OVERLAY_CONTRACT_VERSION_V2;
+    overlayId: string;
+    companyId: string;
+    provider: 'azure';
+    providerScopeId: string;
+    revision: string;
+    generatedAt: string;
+}
+export interface CompleteRecommendationLifecycleOverlayV2 extends RecommendationLifecycleOverlayCommonV2 {
+    status: 'complete';
+    states: RecommendationLifecycleOverlayStateV2[];
+    reasonCodes?: never;
+}
+export interface PartialRecommendationLifecycleOverlayV2 extends RecommendationLifecycleOverlayCommonV2 {
+    status: 'partial';
+    states: RecommendationLifecycleOverlayStateV2[];
+    reasonCodes: [string, ...string[]];
+}
+export interface UnavailableRecommendationLifecycleOverlayV2 extends RecommendationLifecycleOverlayCommonV2 {
+    status: 'unavailable';
+    states: [];
+    reasonCodes: [string, ...string[]];
+}
+/** Company/provider-scope control evidence. This document deliberately owns no money. */
+export type RecommendationLifecycleOverlayV2 = CompleteRecommendationLifecycleOverlayV2 | PartialRecommendationLifecycleOverlayV2 | UnavailableRecommendationLifecycleOverlayV2;
+export type RecommendationLifecycleOverlayIdentityPreimageV2 = RecommendationLifecycleOverlayV2 extends infer Overlay ? Overlay extends RecommendationLifecycleOverlayV2 ? Omit<Overlay, 'overlayId'> : never : never;
+/**
+ * Contextual links from one recommendation row to other resources.
+ * Used to model "this disk belongs to that VM" style associations
+ * without changing which resource owns savings totals.
+ */
+export interface RecommendationResourceAssociation {
+    id: string;
+    name?: string;
+    type?: string;
+    relationship?: ResourceRelationship;
+}
+export type RecommendationSavingsCalculationBasis = 'actual-billing' | 'projected-monthly' | 'projected-runtime' | 'target-pricing' | 'commitment-pricing';
+export interface ResourceRecommendationSavingsDetails {
+    headlineScenario: {
+        id: string;
+        label: string;
+        action: string;
+        monthlySavings: number;
+        targetMonthlyCost: number;
+    };
+    affectedCost: {
+        label: string;
+        currentMonthlyCost: number;
+        savingsPercentage: number;
+    };
+    resourceSpend?: {
+        last30Days: number;
+        savingsPercentage: number;
+    };
+    calculationBasis: {
+        type: RecommendationSavingsCalculationBasis;
+        windowStart?: string;
+        windowEnd?: string;
+    };
+}
+export type RecommendationMetricEvidencePurpose = 'eligibility' | 'sizing' | 'validation' | 'risk' | 'cost-driver';
+export type RecommendationMetricEvidenceStatistic = 'average' | 'p95' | 'p99' | 'maximum' | 'minimum';
+export type RecommendationMetricEvidenceThresholdRole = 'target' | 'gate' | 'limit';
+export type RecommendationMetricEvidenceDisplayMode = 'inline-chart' | 'stat-strip';
+export interface RecommendationMetricEvidenceWindow {
+    /** ISO-8601 timestamp when the producer requires a fixed evidence window. */
+    start?: string;
+    /** ISO-8601 timestamp when the producer requires a fixed evidence window. */
+    end?: string;
+    /** ISO-8601 duration, such as P30D, when a relative window is sufficient. */
+    duration?: string;
+}
+export interface RecommendationMetricEvidenceThreshold {
+    value: number;
+    unit?: string;
+    label: string;
+    role: RecommendationMetricEvidenceThresholdRole;
+}
+export interface RecommendationMetricEvidenceDisplay {
+    mode: RecommendationMetricEvidenceDisplayMode;
+    title?: string;
+    description?: string;
+}
+/**
+ * Logical reference to metric evidence already available for one resource.
+ * It intentionally contains no time-series samples, storage URLs or authorization data.
+ */
+export interface RecommendationMetricEvidenceHint {
+    schemaVersion: 1;
+    kind: 'metric';
+    /** Stable identity for this hint within the recommendation. */
+    id: string;
+    /** Canonical Azure resource ID used to prevent cross-resource resolution. */
+    resourceId: string;
+    /** Preferred exact match for an existing MetricPlot.name when one is stable. */
+    plotName?: string;
+    /** Semantic metric identity used by the resolver and displayed to the user. */
+    metricName: string;
+    /** Collected metric group used to disambiguate repeated Azure metric names. */
+    sourceCollection?: string;
+    /** Azure Monitor metric namespace when available. */
+    metricNamespace?: string;
+    aggregation: MetricAggregationType;
+    purpose: RecommendationMetricEvidencePurpose;
+    preferredWindow?: RecommendationMetricEvidenceWindow;
+    statistics?: RecommendationMetricEvidenceStatistic[];
+    thresholds?: RecommendationMetricEvidenceThreshold[];
+    display?: RecommendationMetricEvidenceDisplay;
+}
+/** Versioned evidence-reference union; additional evidence kinds can be added without changing metric hints. */
+export type RecommendationEvidenceHint = RecommendationMetricEvidenceHint;
+/** A recommendation carrying a financial scenario scoped to one detailed resource artifact. */
+export interface ResourceScopedRecommendation extends Recommendation {
+    savingsDetails?: ResourceRecommendationSavingsDetails;
+    /** Optional logical references to evidence already present in this resource's detail artifacts. */
+    evidenceHints?: RecommendationEvidenceHint[];
 }
 export interface RecommendationResource {
     id: string;
     name: string;
     type: string;
-    spend: number;
-    spendAmortized: number;
+    resourceGroup?: string;
+    location?: string;
+    subscriptionId?: string;
+    subscriptionName?: string;
+    tags?: Record<string, string>;
+    spottoTags?: Tags;
+    createdTime?: string;
+    typeInfo?: {
+        name: string;
+        icon: string;
+        description: string;
+        product: string;
+        aliases?: string[];
+    };
+    /** Billed spend for this recommendation resource when the billed basis is available. */
+    spend?: number;
+    /** Amortized spend for this recommendation resource when the amortized basis is available. */
+    spendAmortized?: number | null;
+    /** Rolling 30-day source partition used to present proved Azure-native resource spend. */
+    financialChargeSpend?: import('./financialChargePolicy.js').AzureResourceFinancialChargeSpendBreakdownV1;
+    /** Spend basis used to calculate this recommendation resource's savings. */
+    savingsBasis?: CostSavingsSpendBasis;
+    optimizationProfile?: ResourceSimpleOptimizationProfile;
     savings?: SavingsPotential;
+    /** Standalone recommendation scenario for this resource. This value is not portfolio-additive. */
+    scenarioSavings?: ScenarioSavingsPotentialV2;
+    /** Canonical producer-attributed contribution for this resource row. */
+    portfolioContribution?: PortfolioSavingsContributionV2;
+    /** Standalone saving for this recommendation on this resource. */
+    savingsDetails?: ResourceRecommendationSavingsDetails;
+    /** Canonical resource ID that owns this resource savings amount for aggregation */
+    savingsOwnerResourceId?: string;
+    /** Resource IDs that may display this resource savings amount as context */
+    savingsDisplayResourceIds?: string[];
+    /** Billable component key used with the owner ID to prevent double counting */
+    billableComponentKey?: string;
+    /** Aggregation rule for this resource savings amount */
+    savingsAggregationPolicy?: CostSavingsAggregationPolicy;
     currency?: string;
     currencySymbol?: string;
+    relationship?: ResourceRelationship;
+    associations?: RecommendationResourceAssociation[];
 }
-export interface RecommendationsView {
+export interface RecommendationsView extends AzurePortalVersionedArtifact {
     recommendations: RecommendationWithResources[];
+    /** Company-scoped workflow state joined by the API; immutable portal artifacts remain company-neutral. */
+    lifecycleStates?: RecommendationLifecycleStateProjectionV1[];
     securityImpactDetails?: SecurityImpact[];
     subscriptionSecurityStatus?: SubscriptionSecurityStatus;
+    /** Homogeneous-currency savings only. Omit for mixed-currency projections. */
     savings?: SavingsPotential;
+    /**
+     * @deprecated Use `financialSavingsProjection.savingsByCurrency`; this field
+     * has no authoritative Azure producer.
+     */
+    savingsByCurrency?: CurrencySavingsGroup[];
     subscription: SubscriptionSummaryLite;
+    costSavingsSummary?: CostSavingsSummary;
+    /** Authoritative additive savings total for this complete recommendation scope. */
+    savingsAggregate?: SavingsAggregateV2;
+    savingsLifecycleFreshness?: import('./savings.js').SavingsLifecycleFreshnessV1;
+    /** Compact generation-bound projection of the canonical Resources financial savings authority. */
+    financialSavingsProjection?: FinancialSavingsSurfaceProjectionV1;
+    /** Compact resource spend/scenario values used by recommendation filters and detail context. */
+    financialResourceProjection?: FinancialResourceSurfaceProjectionV1;
+    /** API-selected non-monetary membership; composed into query totals only by the UI Financial Domain/shared Kernel. */
+    financialSavingsQuerySelection?: FinancialSavingsQuerySelectionV1;
+    /** API-projected, generation-bound evidence qualification; never a monetary authority. */
+    financialEvidenceCoverage?: FinancialEvidenceCoverageProjectionV1;
+    /** Fixed Marketplace-excluding authority for newly generated formal financial reports. */
+    formalFinancialAuthority?: import('./financialChargePolicy.js').AzurePolicyBoundSavingsAggregateV1;
+    /** Strict billing input; unavailable rather than numeric when source coverage is partial. */
+    chargeableSavings?: import('./financialChargePolicy.js').AzureChargeableSavingsV1;
 }
 export interface ResourceId {
     id: string;
@@ -110,10 +630,20 @@ export interface ResourceId {
 export interface ResourceReference {
     id: string;
     name: string;
+    type?: string;
+    subscriptionName?: string;
     savings?: SavingsPotential;
     currency?: string;
     currencySymbol?: string;
+    relationship?: ResourceRelationship;
+    associations?: RecommendationResourceAssociation[];
 }
+export type ResourceRelationship = {
+    role?: 'primary' | 'related';
+    type?: string;
+    allocationId?: string;
+    metadata?: Record<string, string>;
+};
 export interface ReliabilityRecommendation extends Recommendation {
     referenceID: string;
     resourceType: string;
@@ -121,7 +651,6 @@ export interface ReliabilityRecommendation extends Recommendation {
     service: string;
 }
 export interface CustomAzureRecommendation extends Recommendation {
-    subcategory: string;
     service: string;
     source: string;
     fileName: string;
@@ -150,7 +679,7 @@ export interface RecommendationStats {
 }
 /** Recommendation with state information, name "ExtendedRecommendation" in the portal at the moment */
 export interface RecommendationWithState extends Recommendation {
-    status?: 'Active' | 'Prioritized' | 'Postponed' | 'Dismissed' | 'Completed' | 'Archived';
+    status?: 'Active' | 'Prioritized' | 'Postponed' | 'Dismissed' | 'Completed' | 'Archived' | 'Implementing' | 'Implemented' | 'Failed';
     read?: boolean;
     scheduledAt?: Date;
     createdAt?: Date;
@@ -163,25 +692,59 @@ export interface DismissRecommendationRequest extends RecommendationActionReques
     dismissReason: string;
 }
 export interface ShareRecommendationRequest extends RecommendationActionRequest {
-    shareType: 'email' | 'slack' | 'teams' | 'jira' | 'halo' | 'connectwise';
+    shareType: 'email' | 'slack' | 'teams' | 'jira' | 'halo' | 'connectwise' | 'autotask' | 'azuredevops' | 'github';
     email?: string;
+    halo?: HaloRoutingOverrides;
+    connectwise?: ConnectWiseRoutingFields;
+    autotask?: AutotaskShareOverrides;
+    azuredevops?: AzureDevOpsShareOverrides;
+    github?: GitHubShareOverrides;
 }
-export interface RecommendationActionRequest {
+export type RecommendationActionTargetSelection = 'selectedResources' | 'allAffectedResources';
+export interface RecommendationActionRequest extends ProviderScope {
+    /** `providerScope` maps to subscription identity for Azure providers. */
+    scope?: CommentScope;
+    /** Optional cloud-account identity enriched by trusted server-side callers before queue publish. */
+    cloudAccountId?: string;
+    /** Optional user-provided reason for queue-backed actions such as implement. */
+    reason?: string;
+    /** Optional action permission metadata passed into API preflight before queue publish. */
+    requiredPermissions?: RecommendationActionRequiredPermissions;
     recommendationId: string;
     recommendationTitle?: string;
-    subscriptionId: string;
     resourceIds: string[];
+    /** Whether resourceIds are the exact selected targets or a sampled display subset for an all-affected action. */
+    targetSelection?: RecommendationActionTargetSelection;
     resourceGroupName?: string;
     companyId: string;
     byUserId?: string;
+    byUserDisplayName?: string;
 }
 export interface RecommendationActionResponse {
     success: boolean;
     message?: string;
     affectedResources?: string[];
+    eventId?: string;
+}
+export type RecommendationActionPermissionFailureStatus = 'missing' | 'unknown' | 'unsupported';
+export interface RecommendationActionPermissionFailure {
+    resourceId: string;
+    azureScope: string;
+    status: RecommendationActionPermissionFailureStatus;
+    message: string;
+    missingActions: string[];
+    missingDataActions: string[];
+}
+export interface RecommendationActionPermissionErrorResponse {
+    error: 'AzurePermissionMissing';
+    message: string;
+    action: 'implement';
+    providerName: string;
+    providerScopeId: string;
+    failures: RecommendationActionPermissionFailure[];
 }
 export interface ServiceRetirementRecommendation {
-    Id: number;
+    Id: string;
     ServiceName: string;
     RetiringFeature: string;
     RetirementDate: string;
@@ -195,6 +758,8 @@ export interface ServiceRetirementRecommendation {
     confidencePercentage: number;
     confidenceReason: string;
     lastProcessedAt: string;
+    /** Related recommendation IDs for cross-navigation from retirement tracker. */
+    linkedRecommendationIds?: string[];
 }
 export interface JiraShareDetails {
     projectKey?: string;
@@ -230,4 +795,96 @@ export interface JiraEntity {
 export interface JiraLabel {
     name: string;
 }
+export interface ConnectWiseIntegrationRequestBase {
+    siteUrl: string;
+    companyId: string;
+    publicKey: string;
+    secret?: string;
+    useStoredSecret?: boolean;
+    credentialOwnerCompanyId?: string;
+}
+export type ConnectWiseId = string | number;
+export interface ConnectWiseRoutingFields {
+    boardId?: ConnectWiseId;
+    boardName?: string;
+    statusId?: ConnectWiseId;
+    statusName?: string;
+    customerId?: ConnectWiseId;
+    customerName?: string;
+    projectId?: ConnectWiseId;
+    projectName?: string;
+    typeId?: ConnectWiseId;
+    typeName?: string;
+    subTypeId?: ConnectWiseId;
+    subTypeName?: string;
+    itemId?: ConnectWiseId;
+    itemName?: string;
+    priorityId?: ConnectWiseId;
+    priorityName?: string;
+    contactId?: ConnectWiseId;
+    contactName?: string;
+    agreementId?: ConnectWiseId;
+    agreementName?: string;
+    slaId?: ConnectWiseId;
+    slaName?: string;
+    source?: string;
+}
+export interface ConnectWiseIntegrationTestPayload extends ConnectWiseIntegrationRequestBase, ConnectWiseRoutingFields {
+}
+export type ConnectWiseBoardsPayload = ConnectWiseIntegrationRequestBase;
+export type ConnectWiseCompaniesPayload = ConnectWiseIntegrationRequestBase;
+export type ConnectWiseProjectsPayload = ConnectWiseIntegrationRequestBase;
+export interface ConnectWiseStatusesPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+}
+export interface ConnectWiseTypesPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+}
+export interface ConnectWiseSubTypesPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+    typeId?: string;
+    typeName?: string;
+}
+export interface ConnectWiseItemsPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+    typeId?: string;
+    typeName?: string;
+    subTypeId?: string;
+    subTypeName?: string;
+}
+export interface ConnectWiseTypeSubTypeItemAssociationsPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+}
+export interface ConnectWisePrioritiesPayload extends ConnectWiseIntegrationRequestBase {
+    boardId?: string;
+    boardName?: string;
+}
+export interface ConnectWiseContactsPayload extends ConnectWiseIntegrationRequestBase {
+    searchQuery?: string;
+}
+export type ConnectWiseSourcesPayload = ConnectWiseIntegrationRequestBase;
+export type ConnectWiseAgreementsPayload = ConnectWiseIntegrationRequestBase;
+export type ConnectWiseSlasPayload = ConnectWiseIntegrationRequestBase;
+export interface ConnectWiseEntity {
+    id: string | number;
+    name: string;
+}
+export interface ConnectWiseTypeSubTypeItemAssociation {
+    type?: ConnectWiseEntity;
+    subType?: ConnectWiseEntity;
+    item?: ConnectWiseEntity;
+}
+export interface ConnectWiseContact extends ConnectWiseEntity {
+    email?: string;
+}
+export interface ConnectWiseTicketMetadata extends ConnectWiseRoutingFields {
+    ticketId: ConnectWiseId;
+    ticketUrl?: string;
+}
+export {};
 //# sourceMappingURL=recommendations.d.ts.map