@harnessio/react-ccm-optimization-service-client 0.3.0 → 0.3.1

package/dist/ccm-optimization-service/src/services/hooks/useDeleteAiGovernancePolicyMutation.d.ts

@@ -1,5 +1,5 @@
 import { UseMutationOptions } from '@tanstack/react-query';
-import type { AiGovernanceMessageResponse } from '../schemas/AiGovernanceMessageResponse';
+import type { AlertMessageResponse } from '../schemas/AlertMessageResponse';
 import type { ResponseWithPagination } from '../helpers';
 import { FetcherOptions } from '../../../../fetcher/index.js';
 export interface DeleteAiGovernancePolicyMutationPathParams {
@@ -12,7 +12,7 @@ export interface DeleteAiGovernancePolicyMutationPathParams {
 export interface DeleteAiGovernancePolicyMutationQueryParams {
     accountIdentifier: string;
 }
-export type DeleteAiGovernancePolicyOkResponse = ResponseWithPagination<AiGovernanceMessageResponse>;
+export type DeleteAiGovernancePolicyOkResponse = ResponseWithPagination<AlertMessageResponse>;
 export type DeleteAiGovernancePolicyErrorResponse = unknown;
 export interface DeleteAiGovernancePolicyProps extends DeleteAiGovernancePolicyMutationPathParams, Omit<FetcherOptions<DeleteAiGovernancePolicyMutationQueryParams, unknown>, 'url'> {
     queryParams: DeleteAiGovernancePolicyMutationQueryParams;

package/dist/ccm-optimization-service/src/services/hooks/useGetMyAiGovernanceBudgetOverviewQuery.d.ts

@@ -0,0 +1,28 @@
+import { UseQueryOptions } from '@tanstack/react-query';
+import type { AiGovernanceUserBudgetOverviewResponse } from '../schemas/AiGovernanceUserBudgetOverviewResponse';
+import type { ResponseWithPagination } from '../helpers';
+import { FetcherOptions } from '../../../../fetcher/index.js';
+export interface GetMyAiGovernanceBudgetOverviewQueryPathParams {
+    account_id: string;
+}
+export interface GetMyAiGovernanceBudgetOverviewQueryQueryParams {
+    accountIdentifier: string;
+    /**
+     * @format date-time
+     */
+    from?: string;
+    /**
+     * @format date-time
+     */
+    to?: string;
+}
+export type GetMyAiGovernanceBudgetOverviewOkResponse = ResponseWithPagination<AiGovernanceUserBudgetOverviewResponse>;
+export type GetMyAiGovernanceBudgetOverviewErrorResponse = unknown;
+export interface GetMyAiGovernanceBudgetOverviewProps extends GetMyAiGovernanceBudgetOverviewQueryPathParams, Omit<FetcherOptions<GetMyAiGovernanceBudgetOverviewQueryQueryParams, unknown>, 'url'> {
+    queryParams: GetMyAiGovernanceBudgetOverviewQueryQueryParams;
+}
+export declare function getMyAiGovernanceBudgetOverview(props: GetMyAiGovernanceBudgetOverviewProps): Promise<GetMyAiGovernanceBudgetOverviewOkResponse>;
+/**
+ * Returns a spend-versus-budget overview for the logged-in user across all mapped governance policies. Each policy includes per-rule spend, effective ceiling, utilization percentages, and the current budget period window. When from and to query parameters are omitted, the window defaults to the last 30 days ending at the current UTC time. Requires authentication only; governed users do not need AI governance admin RBAC.
+ */
+export declare function useGetMyAiGovernanceBudgetOverviewQuery(props: GetMyAiGovernanceBudgetOverviewProps, options?: Omit<UseQueryOptions<GetMyAiGovernanceBudgetOverviewOkResponse, GetMyAiGovernanceBudgetOverviewErrorResponse>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<GetMyAiGovernanceBudgetOverviewOkResponse, unknown>;

package/dist/ccm-optimization-service/src/services/hooks/useGetMyAiGovernanceBudgetOverviewQuery.js

@@ -0,0 +1,14 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+import { useQuery } from '@tanstack/react-query';
+import { fetcher } from '../../../../fetcher/index.js';
+export function getMyAiGovernanceBudgetOverview(props) {
+    return fetcher(Object.assign({ url: `/accounts/${props.account_id}/ai-governance/me/overview`, method: 'GET' }, props));
+}
+/**
+ * Returns a spend-versus-budget overview for the logged-in user across all mapped governance policies. Each policy includes per-rule spend, effective ceiling, utilization percentages, and the current budget period window. When from and to query parameters are omitted, the window defaults to the last 30 days ending at the current UTC time. Requires authentication only; governed users do not need AI governance admin RBAC.
+ */
+export function useGetMyAiGovernanceBudgetOverviewQuery(props, options) {
+    return useQuery(['GetMyAIGovernanceBudgetOverview', props.account_id, props.queryParams], ({ signal }) => getMyAiGovernanceBudgetOverview(Object.assign(Object.assign({}, props), { signal })), options);
+}

package/dist/ccm-optimization-service/src/services/hooks/useListAiGovernancePoliciesMutation.d.ts

@@ -18,6 +18,6 @@ export interface ListAiGovernancePoliciesProps extends ListAiGovernancePoliciesM
 }
 export declare function listAiGovernancePolicies(props: ListAiGovernancePoliciesProps): Promise<ListAiGovernancePoliciesOkResponse>;
 /**
- * Returns a paginated list of non-deleted governance policies for the account. Each policy document includes persisted ruleIds per rule. List responses omit rawYaml.
+ * Returns a paginated list of governance policies. Each item is a flat object with persisted policy fields (id, name, document, audit metadata) plus overview metrics (subjects, budget, spend, health). List responses omit rawYaml. cumulativeSpend, spendPercent, and userHealth are null until dry-run or reconcile has seeded the per-policy stats cache for the current period.
  */
 export declare function useListAiGovernancePoliciesMutation(options?: Omit<UseMutationOptions<ListAiGovernancePoliciesOkResponse, ListAiGovernancePoliciesErrorResponse, ListAiGovernancePoliciesProps>, 'mutationKey' | 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<ListAiGovernancePoliciesOkResponse, unknown, ListAiGovernancePoliciesProps, unknown>;

package/dist/ccm-optimization-service/src/services/hooks/useListAiGovernancePoliciesMutation.js

@@ -7,7 +7,7 @@ export function listAiGovernancePolicies(props) {
     return fetcher(Object.assign({ url: `/accounts/${props.account_id}/ai-governance/policies/list`, method: 'POST' }, props));
 }
 /**
- * Returns a paginated list of non-deleted governance policies for the account. Each policy document includes persisted ruleIds per rule. List responses omit rawYaml.
+ * Returns a paginated list of governance policies. Each item is a flat object with persisted policy fields (id, name, document, audit metadata) plus overview metrics (subjects, budget, spend, health). List responses omit rawYaml. cumulativeSpend, spendPercent, and userHealth are null until dry-run or reconcile has seeded the per-policy stats cache for the current period.
  */
 export function useListAiGovernancePoliciesMutation(options) {
     return useMutation((mutateProps) => listAiGovernancePolicies(mutateProps), options);

package/dist/ccm-optimization-service/src/services/hooks/useRequestMyAiGovernanceBudgetOverrideMutation.d.ts

@@ -0,0 +1,23 @@
+import { UseMutationOptions } from '@tanstack/react-query';
+import type { AlertMessageResponse } from '../schemas/AlertMessageResponse';
+import type { AiGovernanceRequestBudgetOverrideRequest } from '../schemas/AiGovernanceRequestBudgetOverrideRequest';
+import type { ResponseWithPagination } from '../helpers';
+import { FetcherOptions } from '../../../../fetcher/index.js';
+export interface RequestMyAiGovernanceBudgetOverrideMutationPathParams {
+    account_id: string;
+}
+export interface RequestMyAiGovernanceBudgetOverrideMutationQueryParams {
+    accountIdentifier: string;
+}
+export type RequestMyAiGovernanceBudgetOverrideRequestBody = AiGovernanceRequestBudgetOverrideRequest;
+export type RequestMyAiGovernanceBudgetOverrideOkResponse = ResponseWithPagination<AlertMessageResponse>;
+export type RequestMyAiGovernanceBudgetOverrideErrorResponse = unknown;
+export interface RequestMyAiGovernanceBudgetOverrideProps extends RequestMyAiGovernanceBudgetOverrideMutationPathParams, Omit<FetcherOptions<RequestMyAiGovernanceBudgetOverrideMutationQueryParams, RequestMyAiGovernanceBudgetOverrideRequestBody>, 'url'> {
+    queryParams: RequestMyAiGovernanceBudgetOverrideMutationQueryParams;
+    body: RequestMyAiGovernanceBudgetOverrideRequestBody;
+}
+export declare function requestMyAiGovernanceBudgetOverride(props: RequestMyAiGovernanceBudgetOverrideProps): Promise<RequestMyAiGovernanceBudgetOverrideOkResponse>;
+/**
+ * Submits a budget ceiling raise request for one budget-cap rule on a policy that governs the logged-in user. The request enters the policy's configured approval workflow (single- or multi-tier). Requires authentication only; governed users do not need AI governance admin RBAC.
+ */
+export declare function useRequestMyAiGovernanceBudgetOverrideMutation(options?: Omit<UseMutationOptions<RequestMyAiGovernanceBudgetOverrideOkResponse, RequestMyAiGovernanceBudgetOverrideErrorResponse, RequestMyAiGovernanceBudgetOverrideProps>, 'mutationKey' | 'mutationFn'>): import("@tanstack/react-query").UseMutationResult<RequestMyAiGovernanceBudgetOverrideOkResponse, unknown, RequestMyAiGovernanceBudgetOverrideProps, unknown>;

package/dist/ccm-optimization-service/src/services/hooks/useRequestMyAiGovernanceBudgetOverrideMutation.js

@@ -0,0 +1,14 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+import { useMutation } from '@tanstack/react-query';
+import { fetcher } from '../../../../fetcher/index.js';
+export function requestMyAiGovernanceBudgetOverride(props) {
+    return fetcher(Object.assign({ url: `/accounts/${props.account_id}/ai-governance/me/budgets/override/request`, method: 'POST' }, props));
+}
+/**
+ * Submits a budget ceiling raise request for one budget-cap rule on a policy that governs the logged-in user. The request enters the policy's configured approval workflow (single- or multi-tier). Requires authentication only; governed users do not need AI governance admin RBAC.
+ */
+export function useRequestMyAiGovernanceBudgetOverrideMutation(options) {
+    return useMutation((mutateProps) => requestMyAiGovernanceBudgetOverride(mutateProps), options);
+}

package/dist/ccm-optimization-service/src/services/index.d.ts

@@ -209,6 +209,8 @@ export type { GetKeyPairsForProxyErrorResponse, GetKeyPairsForProxyOkResponse, G
 export { getKeyPairsForProxy, useGetKeyPairsForProxyQuery, } from './hooks/useGetKeyPairsForProxyQuery';
 export type { GetMachineListForZoneErrorResponse, GetMachineListForZoneOkResponse, GetMachineListForZoneProps, GetMachineListForZoneQueryPathParams, GetMachineListForZoneQueryQueryParams, } from './hooks/useGetMachineListForZoneQuery';
 export { getMachineListForZone, useGetMachineListForZoneQuery, } from './hooks/useGetMachineListForZoneQuery';
+export type { GetMyAiGovernanceBudgetOverviewErrorResponse, GetMyAiGovernanceBudgetOverviewOkResponse, GetMyAiGovernanceBudgetOverviewProps, GetMyAiGovernanceBudgetOverviewQueryPathParams, GetMyAiGovernanceBudgetOverviewQueryQueryParams, } from './hooks/useGetMyAiGovernanceBudgetOverviewQuery';
+export { getMyAiGovernanceBudgetOverview, useGetMyAiGovernanceBudgetOverviewQuery, } from './hooks/useGetMyAiGovernanceBudgetOverviewQuery';
 export type { GetNodeClassErrorResponse, GetNodeClassOkResponse, GetNodeClassProps, GetNodeClassQueryPathParams, GetNodeClassQueryQueryParams, } from './hooks/useGetNodeClassQuery';
 export { getNodeClass, useGetNodeClassQuery } from './hooks/useGetNodeClassQuery';
 export type { GetNodePoolErrorResponse, GetNodePoolOkResponse, GetNodePoolProps, GetNodePoolQueryPathParams, GetNodePoolQueryQueryParams, } from './hooks/useGetNodePoolQuery';
@@ -297,6 +299,8 @@ export type { PaginatedAccessPointsErrorResponse, PaginatedAccessPointsMutationP
 export { paginatedAccessPoints, usePaginatedAccessPointsMutation, } from './hooks/usePaginatedAccessPointsMutation';
 export type { PerformBulkRuleActionErrorResponse, PerformBulkRuleActionMutationPathParams, PerformBulkRuleActionMutationQueryParams, PerformBulkRuleActionOkResponse, PerformBulkRuleActionProps, PerformBulkRuleActionRequestBody, } from './hooks/usePerformBulkRuleActionMutation';
 export { performBulkRuleAction, usePerformBulkRuleActionMutation, } from './hooks/usePerformBulkRuleActionMutation';
+export type { RequestMyAiGovernanceBudgetOverrideErrorResponse, RequestMyAiGovernanceBudgetOverrideMutationPathParams, RequestMyAiGovernanceBudgetOverrideMutationQueryParams, RequestMyAiGovernanceBudgetOverrideOkResponse, RequestMyAiGovernanceBudgetOverrideProps, RequestMyAiGovernanceBudgetOverrideRequestBody, } from './hooks/useRequestMyAiGovernanceBudgetOverrideMutation';
+export { requestMyAiGovernanceBudgetOverride, useRequestMyAiGovernanceBudgetOverrideMutation, } from './hooks/useRequestMyAiGovernanceBudgetOverrideMutation';
 export type { RequestsOfServiceErrorResponse, RequestsOfServiceOkResponse, RequestsOfServiceProps, RequestsOfServiceQueryPathParams, RequestsOfServiceQueryQueryParams, } from './hooks/useRequestsOfServiceQuery';
 export { requestsOfService, useRequestsOfServiceQuery } from './hooks/useRequestsOfServiceQuery';
 export type { ReviewAiGovernanceOverrideRequestsErrorResponse, ReviewAiGovernanceOverrideRequestsMutationPathParams, ReviewAiGovernanceOverrideRequestsMutationQueryParams, ReviewAiGovernanceOverrideRequestsOkResponse, ReviewAiGovernanceOverrideRequestsProps, ReviewAiGovernanceOverrideRequestsRequestBody, } from './hooks/useReviewAiGovernanceOverrideRequestsMutation';
@@ -366,13 +370,14 @@ export type { AiGovernanceDryRunResponse } from './schemas/AiGovernanceDryRunRes
 export type { AiGovernanceDryRunResult } from './schemas/AiGovernanceDryRunResult';
 export type { AiGovernanceDryRunRuleResult } from './schemas/AiGovernanceDryRunRuleResult';
 export type { AiGovernanceDryRunSubject } from './schemas/AiGovernanceDryRunSubject';
-export type { AiGovernanceMessageResponse } from './schemas/AiGovernanceMessageResponse';
+export type { AiGovernanceGovernancePeriod } from './schemas/AiGovernanceGovernancePeriod';
 export type { AiGovernanceMyOverrideRequestsList } from './schemas/AiGovernanceMyOverrideRequestsList';
 export type { AiGovernanceMyOverrideRequestsListRequest } from './schemas/AiGovernanceMyOverrideRequestsListRequest';
 export type { AiGovernanceMyOverrideRequestsListResponse } from './schemas/AiGovernanceMyOverrideRequestsListResponse';
 export type { AiGovernanceOverrideRequestsListRequest } from './schemas/AiGovernanceOverrideRequestsListRequest';
 export type { AiGovernancePolicy } from './schemas/AiGovernancePolicy';
 export type { AiGovernancePolicyAuthoring } from './schemas/AiGovernancePolicyAuthoring';
+export type { AiGovernancePolicyBudget } from './schemas/AiGovernancePolicyBudget';
 export type { AiGovernancePolicyDetails } from './schemas/AiGovernancePolicyDetails';
 export type { AiGovernancePolicyDetailsResponse } from './schemas/AiGovernancePolicyDetailsResponse';
 export type { AiGovernancePolicyDocument } from './schemas/AiGovernancePolicyDocument';
@@ -381,16 +386,22 @@ export type { AiGovernancePolicyListRequest } from './schemas/AiGovernancePolicy
 export type { AiGovernancePolicyListResponse } from './schemas/AiGovernancePolicyListResponse';
 export type { AiGovernancePolicyOverviewMetrics } from './schemas/AiGovernancePolicyOverviewMetrics';
 export type { AiGovernancePolicyResponse } from './schemas/AiGovernancePolicyResponse';
+export type { AiGovernancePolicySpec } from './schemas/AiGovernancePolicySpec';
 export type { AiGovernancePolicySubjectRow } from './schemas/AiGovernancePolicySubjectRow';
 export type { AiGovernancePolicySubjectsRequest } from './schemas/AiGovernancePolicySubjectsRequest';
 export type { AiGovernancePolicySubjectsResponse } from './schemas/AiGovernancePolicySubjectsResponse';
 export type { AiGovernancePolicyUpsertRequest } from './schemas/AiGovernancePolicyUpsertRequest';
 export type { AiGovernancePolicyUserHealth } from './schemas/AiGovernancePolicyUserHealth';
+export type { AiGovernanceRequestBudgetOverrideRequest } from './schemas/AiGovernanceRequestBudgetOverrideRequest';
 export type { AiGovernanceReviewOverrideItem } from './schemas/AiGovernanceReviewOverrideItem';
 export type { AiGovernanceReviewOverrideOutcome } from './schemas/AiGovernanceReviewOverrideOutcome';
 export type { AiGovernanceReviewOverridesRequest } from './schemas/AiGovernanceReviewOverridesRequest';
 export type { AiGovernanceReviewOverridesResponse } from './schemas/AiGovernanceReviewOverridesResponse';
 export type { AiGovernanceReviewOverridesResult } from './schemas/AiGovernanceReviewOverridesResult';
+export type { AiGovernanceRuleBudget } from './schemas/AiGovernanceRuleBudget';
+export type { AiGovernanceSubjects } from './schemas/AiGovernanceSubjects';
+export type { AiGovernanceUserBudgetOverview } from './schemas/AiGovernanceUserBudgetOverview';
+export type { AiGovernanceUserBudgetOverviewResponse } from './schemas/AiGovernanceUserBudgetOverviewResponse';
 export type { AiGovernanceUserBudgetRow } from './schemas/AiGovernanceUserBudgetRow';
 export type { AiGovernanceUserBudgets } from './schemas/AiGovernanceUserBudgets';
 export type { AiGovernanceUserBudgetsResponse } from './schemas/AiGovernanceUserBudgetsResponse';
@@ -399,6 +410,7 @@ export type { Alert } from './schemas/Alert';
 export type { AlertAssociatedEntity } from './schemas/AlertAssociatedEntity';
 export type { AlertDeleteResponse } from './schemas/AlertDeleteResponse';
 export type { AlertEvent } from './schemas/AlertEvent';
+export type { AlertMessageResponse } from './schemas/AlertMessageResponse';
 export type { AlertRecipient } from './schemas/AlertRecipient';
 export type { AlertRequest } from './schemas/AlertRequest';
 export type { AlertSearchRequest } from './schemas/AlertSearchRequest';

package/dist/ccm-optimization-service/src/services/index.js

@@ -103,6 +103,7 @@ export { getInstanceHealthCheckDetails, useGetInstanceHealthCheckDetailsQuery, }
 export { getInstancesTags, useGetInstancesTagsQuery } from './hooks/useGetInstancesTagsQuery';
 export { getKeyPairsForProxy, useGetKeyPairsForProxyQuery, } from './hooks/useGetKeyPairsForProxyQuery';
 export { getMachineListForZone, useGetMachineListForZoneQuery, } from './hooks/useGetMachineListForZoneQuery';
+export { getMyAiGovernanceBudgetOverview, useGetMyAiGovernanceBudgetOverviewQuery, } from './hooks/useGetMyAiGovernanceBudgetOverviewQuery';
 export { getNodeClass, useGetNodeClassQuery } from './hooks/useGetNodeClassQuery';
 export { getNodePool, useGetNodePoolQuery } from './hooks/useGetNodePoolQuery';
 export { getNodepoolSchedules, useGetNodepoolSchedulesQuery, } from './hooks/useGetNodepoolSchedulesQuery';
@@ -147,6 +148,7 @@ export { logsOfServiceV2, useLogsOfServiceV2Mutation } from './hooks/useLogsOfSe
 export { mapToDns, useMapToDnsMutation } from './hooks/useMapToDnsMutation';
 export { paginatedAccessPoints, usePaginatedAccessPointsMutation, } from './hooks/usePaginatedAccessPointsMutation';
 export { performBulkRuleAction, usePerformBulkRuleActionMutation, } from './hooks/usePerformBulkRuleActionMutation';
+export { requestMyAiGovernanceBudgetOverride, useRequestMyAiGovernanceBudgetOverrideMutation, } from './hooks/useRequestMyAiGovernanceBudgetOverrideMutation';
 export { requestsOfService, useRequestsOfServiceQuery } from './hooks/useRequestsOfServiceQuery';
 export { reviewAiGovernanceOverrideRequests, useReviewAiGovernanceOverrideRequestsMutation, } from './hooks/useReviewAiGovernanceOverrideRequestsMutation';
 export { routeDetails, useRouteDetailsQuery } from './hooks/useRouteDetailsQuery';

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceApprovalRequest.d.ts

@@ -38,10 +38,6 @@ export interface AiGovernanceApprovalRequest {
      */
     requestedAmount: number;
     requestedBy: string;
-    /**
-     * @format uuid
-     */
-    ruleId: string;
     status: 'approved' | 'deferred' | 'error' | 'expired' | 'pending' | 'rejected';
     subjectId: string;
     /**
@@ -61,6 +57,7 @@ export interface AiGovernanceApprovalRequest {
      */
     updatedAt: string;
     /**
+     * Override validity end; set on final approval to the end of the current budget period
      * @format date-time
      */
     validUntil?: string;

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceConnectorRef.d.ts

@@ -3,6 +3,10 @@ export interface AiGovernanceConnectorRef {
      * Explicit cloud connector id when targeted directly
      */
     connectorId?: string;
+    /**
+     * BQ genAISubAccountId for AWS/Bedrock rows; used to resolve child account connectors when connectorId is not set
+     */
+    genAISubAccountId?: string;
     /**
      * AI provider identifier
      */

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceDryRunSubject.d.ts

@@ -1,8 +1,8 @@
 export interface AiGovernanceDryRunSubject {
     /**
-     * @format int64
+     * Effective budget ceiling in USD dollars
      */
-    ceilingCents?: number;
+    ceilingDollars?: number;
     disallowedModels?: string[];
     /**
      * @format int64
@@ -16,9 +16,9 @@ export interface AiGovernanceDryRunSubject {
     reason?: string;
     skippedForRuleType?: boolean;
     /**
-     * @format int64
+     * Current-period spend in USD dollars
      */
-    spendCents?: number;
+    spendDollars?: number;
     subject: {
         email?: string;
         id?: string;

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceGovernancePeriod.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Budget period window used for spend attribution. JSON keys match attribution.GovernancePeriod (capitalized Period and Range).
+ */
+export interface AiGovernanceGovernancePeriod {
+    /**
+     * Budget period label for the rule
+     */
+    Period: 'monthly' | 'quarterly' | 'weekly';
+    Range: {
+        /**
+         * UTC end of the governance period window (typically the evaluation anchor time)
+         * @format date-time
+         */
+        End: string;
+        /**
+         * Inclusive UTC start of the governance period window
+         * @format date-time
+         */
+        Start: string;
+    };
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicy.d.ts

@@ -12,42 +12,13 @@ export interface AiGovernancePolicy {
      */
     id?: string;
     name?: string;
-    /**
-     * Count of pending cap-raise approval requests for this policy. Present on list responses only.
-     */
-    pendingUpgradeRequests?: number;
     /**
      * Original YAML upload when the policy was created or last updated via rawYaml. Empty when the JSON policy path was used; document is always authoritative.
      */
     rawYaml?: string;
-    /**
-     * Total current-period spend across governed subjects for budget-cap rules on this policy. Present on list responses only.
-     */
-    rolledUpSpend?: number;
-    /**
-     * Total number of unique governed subjects across budget-cap rules on this policy. Present on list responses only.
-     */
-    totalUsers?: number;
     /**
      * @format date-time
      */
     updatedAt?: string;
     updatedBy?: string;
-    /**
-     * Counts of governed subjects by budget utilization band. Present on list responses only.
-     */
-    userHealth?: {
-        /**
-         * Subjects at or above the at-risk threshold but below budget
-         */
-        atRisk?: number;
-        /**
-         * Subjects below the at-risk spend threshold
-         */
-        good?: number;
-        /**
-         * Subjects at or above 100% of their effective budget ceiling
-         */
-        overBudget?: number;
-    };
 }

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyAuthoring.d.ts

@@ -1,18 +1,10 @@
+import type { AiGovernancePolicySpec } from '../schemas/AiGovernancePolicySpec';
+import type { AiGovernanceSubjects } from '../schemas/AiGovernanceSubjects';
 export interface AiGovernancePolicyAuthoring {
     /**
      * Lowercase slug policy name
      */
     name: string;
-    /**
-     * Governance rules with flat type-specific fields (same shape as YAML rules)
-     */
-    rules: Array<{
-        [key: string]: any;
-    }>;
-    /**
-     * Policy-level subject selectors
-     */
-    subjects: {
-        [key: string]: any;
-    };
+    spec: AiGovernancePolicySpec;
+    subjects: AiGovernanceSubjects;
 }

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyAuthoring.js

@@ -1,4 +1 @@
-/* eslint-disable */
-// This code is autogenerated using @harnessio/oats-cli.
-// Please do not modify this code directly.
 export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyBudget.d.ts

@@ -0,0 +1,9 @@
+import type { AiGovernanceRuleBudget } from '../schemas/AiGovernanceRuleBudget';
+export interface AiGovernancePolicyBudget {
+    /**
+     * @format uuid
+     */
+    policy_id: string;
+    policy_name: string;
+    rule_budgets: AiGovernanceRuleBudget[];
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyBudget.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyDocument.d.ts

@@ -1,22 +1,6 @@
+import type { AiGovernancePolicySpec } from '../schemas/AiGovernancePolicySpec';
+import type { AiGovernanceSubjects } from '../schemas/AiGovernanceSubjects';
 export interface AiGovernancePolicyDocument {
-    /**
-     * Persisted rules with platform-assigned ruleIds
-     */
-    rules?: Array<{
-        connectors?: Array<{
-            [key: string]: any;
-        }>;
-        frequency?: string;
-        /**
-         * @format uuid
-         */
-        ruleId?: string;
-        type?: string;
-    }>;
-    /**
-     * Policy-level subject selectors
-     */
-    subjects?: {
-        [key: string]: any;
-    };
+    spec?: AiGovernancePolicySpec;
+    subjects?: AiGovernanceSubjects;
 }

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyDocument.js

@@ -1,4 +1 @@
-/* eslint-disable */
-// This code is autogenerated using @harnessio/oats-cli.
-// Please do not modify this code directly.
 export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyOverviewMetrics.d.ts

@@ -1,3 +1,4 @@
+import type { AiGovernanceGovernancePeriod } from '../schemas/AiGovernanceGovernancePeriod';
 import type { AiGovernancePolicyUserHealth } from '../schemas/AiGovernancePolicyUserHealth';
 /**
  * Overview metrics shared by policy list items and the single-policy overview response. Spend fields are populated only after dry-run or reconcile writes the per-policy stats cache.
@@ -8,19 +9,7 @@ export interface AiGovernancePolicyOverviewMetrics {
      */
     cumulativeSpend?: number | null;
     pendingRequestsCount: number;
-    period?: {
-        period?: string;
-        range?: {
-            /**
-             * @format date-time
-             */
-            end?: string;
-            /**
-             * @format date-time
-             */
-            start?: string;
-        };
-    };
+    period: AiGovernanceGovernancePeriod;
     /**
      * 1-indexed day within the current budget period
      */

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicySpec.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Typed constraint payload for a policy. Only type=budget-cap is currently supported.
+ */
+export interface AiGovernancePolicySpec {
+    /**
+     * Graduated responses triggered at ascending spend thresholds. Actions determine enforcement behavior; there is no separate enforcement strategy field.
+     */
+    actions?: Array<{
+        channels?: string[];
+        dedupeByCeiling?: boolean;
+        delivery?: 'digest' | 'immediate';
+        do: 'block-user' | 'notify' | 'remove-premium-models';
+        includeRecoveryInstructions?: boolean;
+        models?: string[];
+        when: {
+            thresholdPercent?: number;
+        };
+    }>;
+    /**
+     * Overall budget ceiling. Required unless every entry in providers sets its own amount.
+     */
+    amount?: number;
+    /**
+     * Approval tiers for budget-override requests, with strictly ascending upToAmount
+     */
+    approvals?: Array<{
+        approvers: {
+            emails?: string[];
+            userGroups?: string[];
+        };
+        autoApproveWhen?: {
+            maxPremiumSpendPercent?: number;
+        };
+        upToAmount: number;
+    }>;
+    /**
+     * Cron expression or descriptor (e.g. @hourly) controlling how often the policy is evaluated
+     */
+    evaluationSchedule: string;
+    /**
+     * Whether the ceiling applies per subject or to a shared pool. Defaults to per-subject (pooled for account-scoped subjects). Account-scoped policies must use pooled.
+     */
+    mode?: 'per-subject' | 'pooled';
+    period: 'custom' | 'monthly' | 'quarterly' | 'weekly';
+    /**
+     * Per-provider budget ceilings. Required (non-empty) when amount is omitted; provider names must not repeat. Each entry with its own amount creates an independent provider scope; an entry with no amount is governed by the total scope only.
+     */
+    providers?: Array<{
+        amount?: number;
+        provider: 'anthropic' | 'bedrock' | 'cursor';
+    }>;
+    /**
+     * Constraint shape; only budget-cap is currently supported
+     */
+    type: 'budget-cap';
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicySpec.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernancePolicyUpsertRequest.d.ts

@@ -5,7 +5,7 @@ import type { AiGovernancePolicyAuthoring } from '../schemas/AiGovernancePolicyA
 export interface AiGovernancePolicyUpsertRequest {
     policy?: AiGovernancePolicyAuthoring;
     /**
-     * Full governance policy YAML document with exactly one policy entry containing subjects and rules
+     * Full governance policy YAML document with exactly one policy entry containing subjects and spec
      */
     rawYaml?: string;
 }

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceRequestBudgetOverrideRequest.d.ts

@@ -0,0 +1,20 @@
+export interface AiGovernanceRequestBudgetOverrideRequest {
+    /**
+     * Requested budget ceiling raise in USD dollars
+     */
+    amount: number;
+    /**
+     * Governance policy that contains the budget-cap rule
+     * @format uuid
+     */
+    policy_id: string;
+    /**
+     * Business justification for the override request
+     */
+    reason: string;
+    /**
+     * Budget-cap rule to raise
+     * @format uuid
+     */
+    rule_id: string;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceRequestBudgetOverrideRequest.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceRuleBudget.d.ts

@@ -0,0 +1,32 @@
+import type { AiGovernanceGovernancePeriod } from '../schemas/AiGovernanceGovernancePeriod';
+export interface AiGovernanceRuleBudget {
+    /**
+     * Effective budget ceiling in USD dollars after active overrides
+     */
+    amount: number;
+    /**
+     * Spend as a percentage of the effective ceiling
+     */
+    percentage: number;
+    period: AiGovernanceGovernancePeriod;
+    /**
+     * Connector providers with spend in the current period for this rule
+     */
+    providers: string[];
+    /**
+     * Remaining budget in USD dollars (effective ceiling minus spend)
+     */
+    remaining: number;
+    /**
+     * Remaining budget as a percentage of the effective ceiling
+     */
+    remaining_percentage: number;
+    /**
+     * @format uuid
+     */
+    rule_id: string;
+    /**
+     * Current-period spend in USD dollars
+     */
+    spend: number;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceRuleBudget.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceSubjects.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Policy-level subject selector. Exactly one of account, users, userGroups, perspective, or costCategory must be set.
+ */
+export interface AiGovernanceSubjects {
+    /**
+     * Governs every subject on the account. Must be true when set.
+     */
+    account?: boolean;
+    /**
+     * Cost category identifier in scope
+     */
+    costCategory?: string;
+    /**
+     * Principals permanently excluded from every scope under the policy
+     */
+    exclude?: {
+        users?: string[];
+    };
+    /**
+     * Cost perspective identifier in scope
+     */
+    perspective?: string;
+    /**
+     * User group identifiers in scope
+     */
+    userGroups?: string[];
+    /**
+     * Explicit user emails in scope
+     */
+    users?: string[];
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceSubjects.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgetOverview.d.ts

@@ -0,0 +1,8 @@
+import type { AiGovernancePolicyBudget } from '../schemas/AiGovernancePolicyBudget';
+export interface AiGovernanceUserBudgetOverview {
+    policy_budgets: AiGovernancePolicyBudget[];
+    /**
+     * Canonical subject identifier for the logged-in user (typically email when available)
+     */
+    subject_id: string;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgetOverview.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgetOverviewResponse.d.ts

@@ -0,0 +1,4 @@
+import type { AiGovernanceUserBudgetOverview } from '../schemas/AiGovernanceUserBudgetOverview';
+export interface AiGovernanceUserBudgetOverviewResponse {
+    response: AiGovernanceUserBudgetOverview;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgetOverviewResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceUserBudgetRow.d.ts

@@ -1,12 +1,26 @@
 import type { AiGovernanceConnectorRef } from '../schemas/AiGovernanceConnectorRef';
 export interface AiGovernanceUserBudgetRow {
+    /**
+     * Graduated budget actions configured on the policy rule
+     */
+    actions?: Array<{
+        channels?: string[];
+        dedupeByCeiling?: boolean;
+        delivery?: 'digest' | 'immediate';
+        do: 'block-user' | 'notify' | 'remove-premium-models';
+        includeRecoveryInstructions?: boolean;
+        models?: string[];
+        when: {
+            thresholdPercent: number;
+        };
+    }>;
     /**
      * Budget ceiling from policy YAML, in USD dollars
      */
     authoredAmount: number;
     authoredConnectors: AiGovernanceConnectorRef[];
     /**
-     * Effective ceiling after active overrides (same as authored until Phase 1b overrides land)
+     * Effective ceiling after active overrides, in USD dollars
      */
     effectiveAmount: number;
     mode: 'per-subject' | 'pooled';
@@ -32,12 +46,11 @@ export interface AiGovernanceUserBudgetRow {
      */
     ruleId: string;
     /**
-     * Current-period spend in USD cents from attribution
-     * @format int64
+     * Current-period spend in USD dollars from attribution
      */
-    spendCents: number;
+    spendDollars: number;
     /**
-     * Spend as a percentage of the effective ceiling
+     * Spend as a percentage of the effective ceiling; omitted when effective ceiling is zero
      */
     spendPercent?: number;
     /**

package/dist/ccm-optimization-service/src/services/schemas/{AiGovernanceMessageResponse.d.ts → AlertMessageResponse.d.ts}

@@ -1,4 +1,4 @@
-export interface AiGovernanceMessageResponse {
+export interface AlertMessageResponse {
     response: {
         /**
          * Success message

package/dist/ccm-optimization-service/src/services/schemas/AlertMessageResponse.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harnessio/react-ccm-optimization-service-client",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Harness CCM Optimization Service APIs integrated with react hooks",
   "author": "Harness Inc",
   "license": "MIT",