@spottoai/types-package 1.0.2-beta.36 → 1.0.2-beta.361

package/dist/events/actionGroups.d.ts

@@ -0,0 +1,85 @@
+export interface ActionGroupEmailAction {
+    name?: string;
+    email: string;
+}
+export interface ActionGroupSlackOrTeamsAction {
+    name: string;
+    webhookUrl: string;
+}
+export interface ActionGroupWebhookAction {
+    name: string;
+    url: string;
+    auth?: {
+        type: 'bearer';
+        tokenRef?: string;
+    };
+}
+export interface ActionGroupJiraAction {
+    enabled: true;
+    projectKey: string;
+    issueType: string;
+    labels?: string[];
+    epicKey?: string;
+}
+export interface ActionGroupActions {
+    emails?: ActionGroupEmailAction[];
+    slack?: ActionGroupSlackOrTeamsAction[];
+    teams?: ActionGroupSlackOrTeamsAction[];
+    webhooks?: ActionGroupWebhookAction[];
+    jira?: ActionGroupJiraAction;
+}
+export interface ActionGroup {
+    id: string;
+    companyId: string;
+    name: string;
+    actions: ActionGroupActions;
+    createdAt: string;
+    createdByUserId: string;
+    updatedAt: string;
+    updatedByUserId: string;
+}
+export interface ActionGroupCounts {
+    emails: number;
+    slack: number;
+    teams: number;
+    webhooks: number;
+    jira: number;
+    total: number;
+}
+export interface ActionGroupSummary {
+    id: string;
+    companyId: string;
+    name: string;
+    counts: ActionGroupCounts;
+    usageCount: number;
+    alertUsageCount: number;
+    notificationUsageCount: number;
+    createdAt: string;
+    createdByUserId: string;
+    updatedAt: string;
+    updatedByUserId: string;
+}
+export interface ActionGroupRecipientPreview {
+    emails: Array<Pick<ActionGroupEmailAction, 'name' | 'email'>>;
+    slack: Array<Pick<ActionGroupSlackOrTeamsAction, 'name'>>;
+    teams: Array<Pick<ActionGroupSlackOrTeamsAction, 'name'>>;
+    webhooks: Array<Pick<ActionGroupWebhookAction, 'name'>>;
+    hasJira: boolean;
+}
+export interface ActionGroupPreview extends ActionGroupSummary {
+    recipients: ActionGroupRecipientPreview;
+}
+export interface ActionGroupDestinationPreview {
+    type: 'email' | 'slack' | 'teams' | 'webhook' | 'jira';
+    label: string;
+}
+export interface ActionGroupListItem extends ActionGroupSummary {
+    destinationPreviews: ActionGroupDestinationPreview[];
+    remainingDestinationCount: number;
+}
+export interface ActionGroupListResponse {
+    results: ActionGroupListItem[];
+}
+export type CreateActionGroupInput = Pick<ActionGroup, 'name' | 'actions'>;
+export type UpdateActionGroupInput = Pick<ActionGroup, 'name' | 'actions'>;
+//# sourceMappingURL=actionGroups.d.ts.map

package/dist/events/actionGroups.d.ts.map

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

package/dist/events/actionGroups.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=actionGroups.js.map

package/dist/events/actionGroups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionGroups.js","sourceRoot":"","sources":["../../src/events/actionGroups.ts"],"names":[],"mappings":""}

package/dist/events/alertDefinitionRun.d.ts

@@ -0,0 +1,23 @@
+export type AlertDefinitionRunStatus = 'running' | 'success' | 'failed';
+/**
+ * Runtime metadata for alert definition evaluation runs.
+ * Stored as a blob so the API scheduler can decide when to enqueue the next run.
+ */
+export interface AlertDefinitionRunState {
+    companyId: string;
+    definitionId: string;
+    lastStartedAt?: string;
+    lastCompletedAt?: string;
+    lastStatus?: AlertDefinitionRunStatus;
+    lastDurationMs?: number;
+    lastError?: string;
+    lastCorrelationId?: string;
+    /**
+     * Optional debug: what subscriptions the definition scope resolved to.
+     * This is useful for tag-scoped definitions where subscription discovery can fail.
+     */
+    lastScopeResolvedAt?: string;
+    lastScopeSubscriptionIdsCount?: number;
+    lastScopeSubscriptionIdsSample?: string[];
+}
+//# sourceMappingURL=alertDefinitionRun.d.ts.map

package/dist/events/alertDefinitionRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alertDefinitionRun.d.ts","sourceRoot":"","sources":["../../src/events/alertDefinitionRun.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IAErB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,wBAAwB,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,8BAA8B,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3C"}

package/dist/events/alertDefinitionRun.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=alertDefinitionRun.js.map

package/dist/events/alertDefinitionRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alertDefinitionRun.js","sourceRoot":"","sources":["../../src/events/alertDefinitionRun.ts"],"names":[],"mappings":""}

package/dist/events/baseAlert.d.ts

@@ -0,0 +1,140 @@
+import type { PaginationParams } from '../common/pagination.js';
+export type AlertSeverity = 'info' | 'warning' | 'critical';
+export type AlertStatus = 'open' | 'acknowledged' | 'resolved';
+export type AlertLifecycleEvent = 'open' | 'acknowledged' | 'resolved';
+export type AlertCategory = 'cost' | 'performance' | 'other';
+export type TagMatchMode = 'any' | 'all';
+export interface BaseAlertTag {
+    key: string;
+    value: string;
+}
+export interface BaseAlertScope {
+    subscriptionIds?: string[];
+    tags?: BaseAlertTag[];
+    tagMatch?: TagMatchMode;
+}
+export interface BaseAlertDestinationSlackOrTeams {
+    name: string;
+    webhookUrl?: string | null;
+}
+export interface BaseAlertDestinationWebhook {
+    name: string;
+    url?: string | null;
+    /**
+     * v1 defaults to sending only 'open'; when unspecified, treat as ['open'].
+     */
+    events?: AlertLifecycleEvent[];
+    auth?: {
+        type: 'bearer';
+        tokenRef?: string | null;
+    };
+}
+export interface BaseAlertDestinationJira {
+    enabled: boolean;
+    projectKey: string;
+    issueType: string;
+    labels?: string[];
+    epicKey?: string;
+}
+export interface BaseAlertDestinations {
+    slack?: BaseAlertDestinationSlackOrTeams[];
+    teams?: BaseAlertDestinationSlackOrTeams[];
+    webhooks?: BaseAlertDestinationWebhook[];
+    jira?: BaseAlertDestinationJira;
+    emails?: BaseAlertDestinationEmail[];
+}
+export interface BaseAlertDestinationEmail {
+    name?: string;
+    email?: string | null;
+    events?: AlertLifecycleEvent[];
+}
+export interface BaseAlertDefinition<TCriteria = unknown, TDestinations = BaseAlertDestinations, TScope = BaseAlertScope, TType extends string = string> {
+    id: string;
+    companyId: string;
+    name: string;
+    enabled: boolean;
+    category: AlertCategory;
+    type: TType;
+    scope: TScope;
+    criteria?: TCriteria;
+    actionGroupId?: string;
+    notifyOn?: AlertLifecycleEvent[];
+    destinations?: TDestinations;
+    /**
+     * Server-authored audit fields. Optional on create/update requests; always present on persisted records.
+     */
+    createdAt?: string;
+    createdByUserId?: string;
+    updatedAt?: string;
+    updatedByUserId?: string;
+}
+type AlertDefinitionServerAuthoredKey = 'id' | 'companyId' | 'createdAt' | 'createdByUserId' | 'updatedAt' | 'updatedByUserId';
+export type CreateAlertDefinitionInput<TDefinition extends BaseAlertDefinition = BaseAlertDefinition> = TDefinition extends BaseAlertDefinition ? Omit<TDefinition, AlertDefinitionServerAuthoredKey> : never;
+export type UpdateAlertDefinitionInput<TDefinition extends BaseAlertDefinition = BaseAlertDefinition, TCriteria = TDefinition['criteria']> = TDefinition extends BaseAlertDefinition ? Pick<TDefinition, 'name' | 'enabled' | 'scope' | 'actionGroupId' | 'notifyOn' | 'destinations'> & {
+    criteria?: TCriteria;
+} : never;
+export type BaseAlertSummary = Record<string, unknown>;
+export interface BaseAlertComment {
+    id: string;
+    userId: string;
+    userName?: string;
+    message: string;
+    createdAt: string;
+    /**
+     * Optional edit tracking; omit if edits are not supported.
+     */
+    updatedAt?: string;
+    editedByUserId?: string;
+}
+export interface BaseAlertInstance<TSummary = BaseAlertSummary, TScope = BaseAlertScope, TType extends string = string, TBreakdown = unknown> {
+    id: string;
+    companyId: string;
+    companyName: string;
+    definitionId: string;
+    category: AlertCategory;
+    type: TType;
+    status: AlertStatus;
+    severity: AlertSeverity;
+    scope: TScope;
+    discriminator?: {
+        kind: string;
+        value: string;
+    };
+    scopeSignature?: string;
+    createdAt: string;
+    /**
+     * If not yet updated, set equal to createdAt.
+     */
+    lastSeenAt?: string;
+    acknowledgedAt?: string | null;
+    acknowledgedByUserId?: string | null;
+    acknowledgedByUserName?: string | null;
+    /**
+     * Optional freeform note captured when acknowledging an alert.
+     */
+    acknowledgedNote?: string | null;
+    resolvedAt?: string | null;
+    resolvedByUserId?: string | null;
+    resolvedByUserName?: string | null;
+    /**
+     * Optional freeform note captured when resolving an alert.
+     */
+    resolvedNote?: string | null;
+    jiraIssueKey?: string;
+    comments?: BaseAlertComment[];
+    summary?: TSummary;
+    breakdown?: TBreakdown;
+    detailPath?: string;
+    /** Internal definition snapshot used to keep history readable after definition deletion. */
+    definitionSnapshot?: string;
+}
+export interface ListAlertsParams<TType extends string = string> extends PaginationParams {
+    status?: AlertStatus;
+    type?: TType;
+    definitionId?: string;
+    since?: string;
+    until?: string;
+}
+export type ListAlertDefinitionsParams = PaginationParams;
+export {};
+//# sourceMappingURL=baseAlert.d.ts.map

package/dist/events/baseAlert.d.ts.map

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

package/dist/events/baseAlert.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=baseAlert.js.map

package/dist/events/baseAlert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseAlert.js","sourceRoot":"","sources":["../../src/events/baseAlert.ts"],"names":[],"mappings":""}

package/dist/events/cost.d.ts

@@ -0,0 +1,371 @@
+import { AlertSeverity, AlertStatus, AlertLifecycleEvent, TagMatchMode, BaseAlertScope, BaseAlertDestinationSlackOrTeams, BaseAlertDestinationWebhook, BaseAlertDestinationJira, BaseAlertDestinationEmail, BaseAlertDestinations, BaseAlertComment, BaseAlertDefinition, BaseAlertInstance, ListAlertsParams, ListAlertDefinitionsParams } from './baseAlert.js';
+export type CostAlertSeverity = AlertSeverity;
+export type CostAlertCategory = 'cost';
+export type CostAlertType = 'costAnomaly' | 'budget';
+export type CostAlertStatus = AlertStatus;
+export type { TagMatchMode };
+export interface CostAlertTag {
+    key: string;
+    value: string;
+}
+export interface CostAlertScope extends BaseAlertScope {
+    tags?: CostAlertTag[];
+}
+export type CostAlertTriggerType = 'threshold' | 'baseline' | 'pricing_missing' | 'missing_metrics' | 'default';
+export interface CostAlertContext {
+    triggerType?: CostAlertTriggerType;
+    trigger?: {
+        label?: string;
+        value?: number;
+        source?: string;
+        overPct?: number;
+        severity?: CostAlertSeverity;
+    };
+    estimate?: {
+        amount?: number;
+        currency?: string;
+        source?: string;
+    };
+    baseline?: {
+        lastDay?: number;
+        prevDay?: number;
+        avg7?: number;
+        avg14?: number;
+        tokenLastDay?: number;
+        tokenPrevDay?: number;
+        tokenAvg7?: number;
+        tokenAvg14?: number;
+        dodPct?: number;
+        tokenDodPct?: number;
+    };
+    reason?: string;
+}
+export interface CostAlert {
+    id: string;
+    severity: CostAlertSeverity;
+    title: string;
+    description: string;
+    eventId: string;
+    eventTimestamp: string;
+    resourceId: string;
+    resourceType: string;
+    serviceCategory?: string;
+    subscriptionId?: string;
+    resourceGroup?: string;
+    estimatedCost?: number;
+    createdAt: string;
+    context?: CostAlertContext;
+}
+export interface CostAlertFile {
+    generatedAt: string;
+    items: CostAlert[];
+}
+/**
+ * New Alert Definition (Table Storage row / API DTO).
+ */
+export interface CostAlertDefinition extends BaseAlertDefinition<CostAlertCriteria, CostAlertDestinations, CostAlertScope, CostAlertType> {
+    type: CostAlertType;
+    scope: CostAlertScope;
+    criteria?: CostAlertCriteria;
+    destinations?: CostAlertDestinations;
+    /** Whether the current user has permission to edit this alert definition. Added by API. */
+    canEdit?: boolean;
+    /** Whether the current user has permission to delete this alert definition. Added by API. */
+    canDelete?: boolean;
+}
+export type ListCostAlertDefinitionsParams = ListAlertDefinitionsParams;
+export type ListCostAlertsParams = ListAlertsParams<CostAlertType>;
+export interface CostAlertCriteria {
+    confidence?: Array<'High' | 'Medium' | 'Low'>;
+    minDelta?: number;
+    minPercentChange?: number;
+    minCost?: number;
+    tagRelevance?: {
+        minScopeSharePercent?: number;
+    };
+    /**
+     * Data source selection:
+     * - auto: use actual billing if available, else estimated
+     * - actual: billing artifacts only
+     * - estimated: metrics/pricing estimation only
+     */
+    dataSource?: 'auto' | 'actual' | 'estimated';
+    period?: 'monthly' | 'last_30_days';
+    budgetAmount?: number;
+    budgetCurrency?: string;
+    budgetThresholdPercents?: number[];
+    budgetThresholdAmounts?: number[];
+    forecastThresholdPercents?: number[];
+    forecastThresholdAmounts?: number[];
+    /**
+     * Optional day-over-day / month-over-month thresholds (cost anomaly extensions).
+     * These are additive to minDelta/minPercentChange when compare window is DoD/MoM.
+     */
+    dodThresholdPercents?: number[];
+    dodThresholdAmounts?: number[];
+    momThresholdPercents?: number[];
+    momThresholdAmounts?: number[];
+}
+/**
+ * Destination types for cost alerts are used for both:
+ * - API request payloads (create/update), where secrets are required by validation
+ * - API responses, where secrets may be redacted/omitted for non-admin readers
+ *
+ * For that reason, secret-bearing fields are optional at the type level.
+ */
+export interface CostAlertDestinationSlackOrTeams extends Omit<BaseAlertDestinationSlackOrTeams, 'webhookUrl'> {
+    webhookUrl?: string | null;
+}
+export interface CostAlertDestinationWebhook extends Omit<BaseAlertDestinationWebhook, 'url' | 'auth'> {
+    url?: string | null;
+    auth?: {
+        type: 'bearer';
+        tokenRef?: string | null;
+    };
+    events?: AlertLifecycleEvent[];
+}
+export interface CostAlertDestinationEmail extends Omit<BaseAlertDestinationEmail, 'email'> {
+    email?: string | null;
+}
+export type CostAlertDestinationJira = BaseAlertDestinationJira;
+export interface CostAlertDestinations extends BaseAlertDestinations {
+    slack?: CostAlertDestinationSlackOrTeams[];
+    teams?: CostAlertDestinationSlackOrTeams[];
+    webhooks?: CostAlertDestinationWebhook[];
+    jira?: CostAlertDestinationJira;
+    emails?: CostAlertDestinationEmail[];
+}
+export interface CostAlertDiscriminator {
+    kind: 'anomalyDate' | 'periodStart' | string;
+    value: string;
+}
+export type CostAlertComment = BaseAlertComment;
+export interface CostAlertSummary {
+    currencyCode?: string;
+    confidence?: 'High' | 'Medium' | 'Low';
+    delta?: number;
+    percentChange?: number;
+    amount?: number;
+    budgetAmount?: number;
+    forecastAmount?: number;
+    /**
+     * Time window for the computed amount (ISO date).
+     * This represents the period for current cost (from periodStart to today).
+     */
+    periodStart?: string;
+    periodEnd?: string;
+    /**
+     * Optional window size for estimated spend (days).
+     * This represents the number of days in the forecast window.
+     */
+    windowDays?: number;
+    /**
+     * Forecast period start date (ISO date).
+     * Forecast is projected from this date to forecastPeriodEnd.
+     */
+    forecastPeriodStart?: string;
+    /**
+     * Forecast period end date (ISO date).
+     * Forecast is projected until this date.
+     */
+    forecastPeriodEnd?: string;
+    /**
+     * Full period start date (ISO date).
+     * This represents the start of the entire period (e.g., month start for monthly budgets).
+     */
+    fullPeriodStart?: string;
+    /**
+     * Full period end date (ISO date).
+     * This represents the end of the entire period (e.g., month end for monthly budgets).
+     */
+    fullPeriodEnd?: string;
+    /**
+     * actual | estimated (resolved at evaluation time)
+     */
+    dataSource?: 'actual' | 'estimated' | 'blended' | 'unknown' | 'metrics_pricing';
+    /**
+     * Estimated coverage (0-100) when using estimated spend.
+     */
+    coveragePercent?: number;
+    reconciliationStatus?: 'pending' | 'matched' | 'mismatch';
+    actualShare?: number;
+    estimatedShare?: number;
+    estimationMethod?: string;
+    estimatedDays?: string[];
+    estimatedDaysSource?: 'metrics' | 'ma7' | 'ma14' | 'ma';
+    periodType?: 'calendar_month' | 'billing_period' | 'rolling_30_days';
+    dataShare?: {
+        actual?: number;
+        estimated?: number;
+        forecast?: number;
+        estimatedByMethod?: {
+            metrics_pricing?: number;
+            moving_average?: number;
+            other?: number;
+        };
+        qualityScore?: number;
+        qualityLevel?: 'high' | 'medium' | 'low';
+    };
+    tagFilterApplied?: boolean;
+    /**
+     * Human-readable summary text for display in alerts list and notifications.
+     * Generated from structured summary data for easy consumption.
+     */
+    summaryText?: string;
+    /**
+     * Forecast confidence level (High, Medium, Low) based on data availability and elapsed days.
+     * Used to indicate the reliability of forecast calculations.
+     */
+    forecastConfidence?: 'high' | 'medium' | 'low';
+    /**
+     * Forecast method used to calculate the forecast amount.
+     * Values: 'conservative-blended', 'conservative-linear', 'trend-based', 'linear', 'rolling-current', 'fallback'
+     */
+    forecastMethod?: string;
+    /**
+     * Detailed information about the forecast calculation, including:
+     * - elapsedDays: Number of days elapsed in the period
+     * - totalDays: Total days in the period
+     * - remainingDays: Number of days remaining in the forecast period
+     * - dailyRate: Daily spending rate
+     * - For conservative-blended: historicalAverage, historicalDailyRate, blendedDailyRate, blendRatio
+     * - For conservative-linear: multiplier
+     * - For trend-based: trendAdjustment, growthRate, growthRateApplied
+     * - For recent-average-decreasing: recentAverageDailyRate, isDecreasingTrend
+     * - For weighted-average: recentAverageDailyRate
+     * - For rolling-current: method, note
+     */
+    forecastDetails?: Record<string, unknown>;
+    /**
+     * Human-readable explanation combining data confidence, estimated mix, and forecast approach.
+     */
+    dataStatusExplaination?: string;
+    /**
+     * Daily forecast costs for the remaining days in the period.
+     * Each entry contains the date (YYYYMMDD format), predicted cost, and method used.
+     * This allows frontend to visualize how the forecast is distributed across days.
+     */
+    forecastDailyCosts?: Array<{
+        date: number;
+        cost: number;
+        dataSource: 'forecast';
+        method: string;
+    }>;
+    /**
+     * Trigger reason indicating why the alert was triggered.
+     * For budget alerts: 'budget-threshold-percent' | 'budget-threshold-amount' | 'forecast-threshold-percent' | 'forecast-threshold-amount' | 'budget-threshold' | 'forecast-threshold' | 'both'
+     * For cost anomaly alerts: 'confidence' | 'minDelta' | 'minPercentChange' | 'minCost' | 'dodThreshold' | 'momThreshold' | string
+     */
+    triggerReason?: string | string[];
+    /**
+     * Earliest configured actual-spend trigger converted to an amount in the alert currency.
+     * Used to explain the budget condition in UI summaries and notifications.
+     */
+    actualTriggerAmount?: number;
+    /**
+     * Earliest configured forecast trigger converted to an amount in the alert currency.
+     * Used to explain the forecast condition in UI summaries and notifications.
+     */
+    forecastTriggerAmount?: number;
+}
+/**
+ * Daily cost data point for breakdown visualization
+ */
+export interface DailyCostDataPoint {
+    /** Date in YYYYMMDD format (number) */
+    date: number;
+    /** Cost for this day */
+    cost: number;
+    /** Data source: actual (from billing/metrics), estimated (MA-based), or forecast (projected) */
+    dataSource: 'actual' | 'estimated' | 'forecast';
+    /** For estimated/forecast: method used (e.g., 'moving-average-7', 'moving-average-14', 'moving-average', 'metrics_pricing', 'linear', 'trend') */
+    method?: string;
+    /** For actual: whether this came from metrics (true) or billing (false) */
+    fromMetrics?: boolean;
+}
+export interface CostAlertBreakdownResource {
+    resourceId: string;
+    name?: string;
+    delta?: number;
+    cost?: number;
+    percentage?: number;
+    /**
+     * Combined tags (Azure + spottoTags) for client-side filtering (ANY/ALL).
+     */
+    tags?: Record<string, string>;
+    /** Optional: metrics inputs for this resource (e.g., tokensIn/out). */
+    metricsInput?: Record<string, unknown>;
+    /** Optional: unit rates applied to compute cost. */
+    unitRates?: Record<string, number>;
+    /** Optional: estimated vs actual composition for UI. */
+    dataSource?: 'estimated' | 'actual' | 'blended' | 'metrics_pricing';
+    actualShare?: number;
+    estimatedShare?: number;
+    estimationMethod?: string;
+    /**
+     * Resource type (e.g., "microsoft.cognitiveservices/accounts")
+     * Helps frontend determine how to display this resource and its children
+     */
+    resourceType?: string;
+    /**
+     * Daily cost breakdown for this resource
+     * Includes actual, estimated, and forecast days
+     */
+    dailyCosts?: DailyCostDataPoint[];
+    /**
+     * Deployment-level breakdown (only for resources that have sub-components)
+     * For cognitive services: contains deployment/model information
+     * Limited to top N deployments to keep breakdown size manageable
+     */
+    deployments?: Array<{
+        deployment?: string;
+        model?: string;
+        cost: number;
+        percentage?: number;
+        metricsInput?: Record<string, unknown>;
+        unitRates?: Record<string, number>;
+        /** Daily cost breakdown for this deployment */
+        dailyCosts?: DailyCostDataPoint[];
+    }>;
+}
+export interface CostAlertBreakdownService {
+    serviceName: string;
+    delta?: number;
+    cost?: number;
+    percentage?: number;
+    dataSource?: 'estimated' | 'actual' | 'blended' | 'metrics_pricing';
+    /** Daily cost breakdown aggregated at service level */
+    dailyCosts?: DailyCostDataPoint[];
+    resources?: CostAlertBreakdownResource[];
+    unmappedResourceNames?: string[];
+}
+export interface CostAlertBreakdownTop {
+    subscriptionId: string;
+    subscriptionName?: string;
+    cost?: number;
+    percentage?: number;
+    /** Daily cost breakdown aggregated at subscription level */
+    dailyCosts?: DailyCostDataPoint[];
+    services?: CostAlertBreakdownService[];
+}
+export interface CostAlertBreakdownSummary {
+    top?: CostAlertBreakdownTop[];
+}
+/**
+ * New Alert Instance (Table Storage row / API DTO).
+ * Legacy CostAlert can map into this with status=open and category=cost.
+ */
+export interface CostAlertInstance extends BaseAlertInstance<CostAlertSummary, CostAlertScope, CostAlertType, CostAlertBreakdownSummary> {
+    category: CostAlertCategory;
+    discriminator: CostAlertDiscriminator;
+    /**
+     * Derived signature of scope (subs + tags) for idempotency/dedupe.
+     */
+    scopeSignature?: string;
+    jiraIssueKey?: string;
+    comments?: CostAlertComment[];
+    summary?: CostAlertSummary;
+    breakdown?: CostAlertBreakdownSummary;
+    definitionSnapshot?: string;
+}
+//# sourceMappingURL=cost.d.ts.map