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

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceCreateOverrideRequest.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/AiGovernanceDryRunRuleResult.d.ts

@@ -1,8 +1,7 @@
 import type { AiGovernanceConnectorRef } from '../schemas/AiGovernanceConnectorRef';
 import type { AiGovernanceDryRunSubject } from '../schemas/AiGovernanceDryRunSubject';
 export interface AiGovernanceDryRunRuleResult {
-    authoredConnectors: AiGovernanceConnectorRef[];
-    resolvedConnectors: AiGovernanceConnectorRef[];
+    connectors: AiGovernanceConnectorRef[];
     /**
      * @format uuid
      */

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

@@ -1,8 +1,5 @@
 export interface AiGovernanceDryRunSubject {
-    /**
-     * @format int64
-     */
-    ceilingCents?: number;
+    ceilingDollars?: number;
     disallowedModels?: string[];
     /**
      * @format int64
@@ -15,10 +12,7 @@ export interface AiGovernanceDryRunSubject {
     modelsUsed?: string[];
     reason?: string;
     skippedForRuleType?: boolean;
-    /**
-     * @format int64
-     */
-    spendCents?: number;
+    spendDollars?: number;
     subject: {
         email?: string;
         id?: string;

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

@@ -0,0 +1,19 @@
+/**
+ * Budget period window used for spend attribution on a rule
+ */
+export interface AiGovernanceGovernancePeriod {
+    /**
+     * Budget period label, e.g. monthly, weekly, quarterly
+     */
+    Period?: string;
+    Range?: {
+        /**
+         * @format date-time
+         */
+        End?: string;
+        /**
+         * @format date-time
+         */
+        Start?: string;
+    };
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceGovernancePeriod.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/AiGovernancePolicy.d.ts

@@ -7,47 +7,22 @@ export interface AiGovernancePolicy {
     createdAt?: string;
     createdBy?: string;
     document?: AiGovernancePolicyDocument;
+    /**
+     * Harness folder identifier when the policy is assigned to a folder. Omitted when unset.
+     */
+    folderId?: string;
     /**
      * @format uuid
      */
     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,16 @@
+import type { AiGovernancePolicySpec } from '../schemas/AiGovernancePolicySpec';
+import type { AiGovernanceSubjects } from '../schemas/AiGovernanceSubjects';
 export interface AiGovernancePolicyAuthoring {
     /**
-     * Lowercase slug policy name
+     * Optional UTC timestamp before which policy evaluation is skipped. Omitted means the policy is active immediately.
+     * @format date-time
+     * @example "2026-09-01T00:00:00Z"
      */
-    name: string;
-    /**
-     * Governance rules with flat type-specific fields (same shape as YAML rules)
-     */
-    rules: Array<{
-        [key: string]: any;
-    }>;
+    beginsAt?: string;
     /**
-     * Policy-level subject selectors
+     * Human-readable policy name; must start with a letter and contain only letters, digits, spaces, and hyphens
      */
-    subjects: {
-        [key: string]: any;
-    };
+    name: string;
+    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,12 @@
+import type { AiGovernancePolicySpec } from '../schemas/AiGovernancePolicySpec';
+import type { AiGovernanceSubjects } from '../schemas/AiGovernanceSubjects';
 export interface AiGovernancePolicyDocument {
     /**
-     * Persisted rules with platform-assigned ruleIds
+     * Optional UTC timestamp before which policy evaluation is skipped. Omitted means the policy is active immediately.
+     * @format date-time
+     * @example "2026-09-01T00:00:00Z"
      */
-    rules?: Array<{
-        connectors?: Array<{
-            [key: string]: any;
-        }>;
-        frequency?: string;
-        /**
-         * @format uuid
-         */
-        ruleId?: string;
-        type?: string;
-    }>;
-    /**
-     * Policy-level subject selectors
-     */
-    subjects?: {
-        [key: string]: any;
-    };
+    beginsAt?: string;
+    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/AiGovernancePolicyListItem.d.ts

@@ -8,6 +8,10 @@ export interface AiGovernancePolicyListItem extends AiGovernancePolicyOverviewMe
     createdAt?: string;
     createdBy?: string;
     document?: AiGovernancePolicyDocument;
+    /**
+     * Harness folder identifier when the policy is assigned to a folder. Omitted when unset.
+     */
+    folderId?: string;
     /**
      * @format uuid
      */

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

@@ -1,9 +1,28 @@
 /**
- * Pagination request for listing governance policies
+ * Pagination request for listing governance policies. Use query for free-text name search; use filters for exact or structured criteria.
  */
 export interface AiGovernancePolicyListRequest {
+    /**
+     * Optional filters; supports name, folder_id, created_at, and updated_at with standard operators (equals, not_equals, greater_than, greater_than_or_equals, less_than, less_than_or_equals)
+     * @example [{"field":"folder_id","operator":"equals","values":["folder-abc123"]}]
+     */
     filters?: Array<{
-        [key: string]: any;
+        /**
+         * Database column to filter on. Use folder_id (snake_case) to scope policies to a Harness folder.
+         */
+        field?: 'created_at' | 'folder_id' | 'name' | 'updated_at';
+        /**
+         * Multiple fields to filter with OR clause (higher priority than single field)
+         */
+        fields?: Array<'created_at' | 'folder_id' | 'name' | 'updated_at'>;
+        /**
+         * Filter operator
+         */
+        operator?: 'equals' | 'greater_than' | 'greater_than_or_equals' | 'less_than' | 'less_than_or_equals' | 'not_equals';
+        /**
+         * Values to match against the selected field
+         */
+        values?: string[];
     }>;
     /**
      * Number of records per page (max 100)
@@ -17,6 +36,11 @@ export interface AiGovernancePolicyListRequest {
      * @example 1
      */
     page?: number;
+    /**
+     * Search query to filter policies by name (case-insensitive partial match)
+     * @example "production"
+     */
+    query?: string;
     /**
      * Sorting options
      */

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

@@ -3,6 +3,10 @@ import type { AiGovernancePolicyUserHealth } from '../schemas/AiGovernancePolicy
  * 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.
  */
 export interface AiGovernancePolicyOverviewMetrics {
+    /**
+     * Number of mapped subjects with an active block-user enforcement action
+     */
+    blockedCount: number;
     /**
      * Null until dry-run or reconcile has seeded the per-policy stats cache for the current period
      */

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

@@ -0,0 +1,45 @@
+import type { AiGovernanceBudgetAction } from '../schemas/AiGovernanceBudgetAction';
+/**
+ * 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. When omitted on create, the platform default is block-user at 100%.
+     */
+    actions?: AiGovernanceBudgetAction[];
+    /**
+     * 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: {
+            auto?: boolean;
+            emails?: string[];
+            userGroups?: string[];
+        };
+        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 @@
+export {};

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

@@ -1,5 +1,9 @@
 import type { AiGovernanceApprovalRequestView } from '../schemas/AiGovernanceApprovalRequestView';
 export interface AiGovernancePolicySubjectRow {
+    /**
+     * True when the subject has an active block-user enforcement action
+     */
+    blocked: boolean;
     /**
      * Effective budget ceiling after active overrides
      */

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

@@ -3,10 +3,10 @@
  */
 export interface AiGovernancePolicySubjectsRequest {
     /**
-     * all returns every mapped subject; pending_requests returns only subjects with an open budget raise request
+     * all returns every mapped subject; pending_requests returns only subjects with an open budget raise request; blocked returns only subjects with an active block-user enforcement action
      * @default "all"
      */
-    filter?: 'all' | 'pending_requests';
+    filter?: 'all' | 'blocked' | 'pending_requests';
     /**
      * Number of records per page (max 100)
      * @default 10

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

@@ -1,11 +1,17 @@
 import type { AiGovernancePolicyAuthoring } from '../schemas/AiGovernancePolicyAuthoring';
-/**
- * Provide either rawYaml or policy (not both required in schema, but one must be supplied at runtime).
- */
-export interface AiGovernancePolicyUpsertRequest {
-    policy?: AiGovernancePolicyAuthoring;
+export type AiGovernancePolicyUpsertRequest = {
     /**
-     * Full governance policy YAML document with exactly one policy entry containing subjects and rules
+     * Optional Harness folder identifier for RBAC scoping and UI organization. Stored as a table column; not part of the policy document.
      */
-    rawYaml?: string;
-}
+    folderId?: string;
+    /**
+     * Full governance policy YAML document with exactly one policy entry containing optional beginsAt, subjects, and spec
+     */
+    rawYaml: string;
+} & {
+    /**
+     * Optional Harness folder identifier for RBAC scoping and UI organization. Stored as a table column; not part of the policy document.
+     */
+    folderId?: string;
+    policy: AiGovernancePolicyAuthoring;
+};

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

@@ -0,0 +1,15 @@
+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;
+}

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/AiGovernanceRuleOverride.d.ts

@@ -0,0 +1,36 @@
+export interface AiGovernanceRuleOverride {
+    /**
+     * @format uuid
+     */
+    approvalRequestId?: string;
+    /**
+     * @format date-time
+     */
+    createdAt?: string;
+    createdBy?: string;
+    /**
+     * @format date-time
+     */
+    expiresAt?: string;
+    /**
+     * @format uuid
+     */
+    id: string;
+    payload?: {
+        [key: string]: any;
+    };
+    /**
+     * @format uuid
+     */
+    policyId: string;
+    /**
+     * @format uuid
+     */
+    ruleId: string;
+    source: 'approved' | 'self-service';
+    subjectId: string;
+    /**
+     * @format date-time
+     */
+    updatedAt?: string;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceRuleOverride.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/AiGovernanceRuleOverrideResponse.d.ts

@@ -0,0 +1,12 @@
+import type { AiGovernanceRuleOverride } from '../schemas/AiGovernanceRuleOverride';
+export interface AiGovernanceRuleOverrideResponse {
+    code?: string;
+    errors?: string[];
+    response?: AiGovernanceRuleOverride;
+    success?: boolean;
+    /**
+     * Unix milliseconds timestamp
+     * @format int64
+     */
+    ts?: number;
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceRuleOverrideResponse.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,10 +1,15 @@
+import type { AiGovernanceBudgetAction } from '../schemas/AiGovernanceBudgetAction';
 import type { AiGovernanceConnectorRef } from '../schemas/AiGovernanceConnectorRef';
 export interface AiGovernanceUserBudgetRow {
+    /**
+     * Graduated responses configured on the budget-cap rule, in ascending threshold order
+     */
+    actions: AiGovernanceBudgetAction[];
     /**
      * Budget ceiling from policy YAML, in USD dollars
      */
     authoredAmount: number;
-    authoredConnectors: AiGovernanceConnectorRef[];
+    connectors: AiGovernanceConnectorRef[];
     /**
      * Effective ceiling after active overrides (same as authored until Phase 1b overrides land)
      */
@@ -26,16 +31,14 @@ export interface AiGovernanceUserBudgetRow {
      */
     policyId: string;
     policyName: string;
-    resolvedConnectors: AiGovernanceConnectorRef[];
     /**
      * @format uuid
      */
     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
      */

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.2",
   "description": "Harness CCM Optimization Service APIs integrated with react hooks",
   "author": "Harness Inc",
   "license": "MIT",