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

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

@@ -0,0 +1,51 @@
+/**
+ * Pagination request for listing override request history on a policy
+ */
+export interface AiGovernanceOverrideRequestsListRequest {
+    /**
+     * Optional filters; supports subject_id equals to scope results to one governed user
+     */
+    filters?: Array<{
+        /**
+         * Field to filter on
+         */
+        field?: 'subject_id';
+        /**
+         * Filter operator
+         */
+        operator?: 'equals';
+        /**
+         * Subject email or ID values to match
+         */
+        values?: string[];
+    }>;
+    /**
+     * Number of history records per page (max 100)
+     * @default 10
+     * @example 10
+     */
+    limit?: number;
+    /**
+     * Page number (1-indexed) for history
+     * @default 1
+     * @example 1
+     */
+    page?: number;
+    /**
+     * Optional search string (reserved for future use)
+     */
+    query?: string;
+    /**
+     * Sorting options for history
+     */
+    sort?: {
+        /**
+         * @example "decided_at"
+         */
+        field?: 'decided_at';
+        /**
+         * @example "DESC"
+         */
+        type?: 'ASC' | 'DESC';
+    };
+}

package/dist/ccm-optimization-service/src/services/schemas/AiGovernanceOverrideRequestsListRequest.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

@@ -0,0 +1,24 @@
+import type { AiGovernancePolicyDocument } from '../schemas/AiGovernancePolicyDocument';
+export interface AiGovernancePolicy {
+    accountId?: string;
+    /**
+     * @format date-time
+     */
+    createdAt?: string;
+    createdBy?: string;
+    document?: AiGovernancePolicyDocument;
+    /**
+     * @format uuid
+     */
+    id?: string;
+    name?: string;
+    /**
+     * 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;
+    /**
+     * @format date-time
+     */
+    updatedAt?: string;
+    updatedBy?: string;
+}

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

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

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

@@ -0,0 +1,10 @@
+import type { AiGovernancePolicySpec } from '../schemas/AiGovernancePolicySpec';
+import type { AiGovernanceSubjects } from '../schemas/AiGovernanceSubjects';
+export interface AiGovernancePolicyAuthoring {
+    /**
+     * Lowercase slug policy name
+     */
+    name: string;
+    spec: AiGovernancePolicySpec;
+    subjects: AiGovernanceSubjects;
+}

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

@@ -0,0 +1 @@
+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/AiGovernancePolicyDetails.d.ts

@@ -0,0 +1,8 @@
+import type { AiGovernancePolicyOverviewMetrics } from '../schemas/AiGovernancePolicyOverviewMetrics';
+export interface AiGovernancePolicyDetails extends AiGovernancePolicyOverviewMetrics {
+    /**
+     * @format uuid
+     */
+    policyId?: string;
+    policyName?: string;
+}

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

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

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

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

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

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

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

@@ -0,0 +1,6 @@
+import type { AiGovernancePolicySpec } from '../schemas/AiGovernancePolicySpec';
+import type { AiGovernanceSubjects } from '../schemas/AiGovernanceSubjects';
+export interface AiGovernancePolicyDocument {
+    spec?: AiGovernancePolicySpec;
+    subjects?: AiGovernanceSubjects;
+}

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

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

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

@@ -0,0 +1,21 @@
+import type { AiGovernancePolicyDocument } from '../schemas/AiGovernancePolicyDocument';
+import type { AiGovernancePolicyOverviewMetrics } from '../schemas/AiGovernancePolicyOverviewMetrics';
+export interface AiGovernancePolicyListItem extends AiGovernancePolicyOverviewMetrics {
+    accountId?: string;
+    /**
+     * @format date-time
+     */
+    createdAt?: string;
+    createdBy?: string;
+    document?: AiGovernancePolicyDocument;
+    /**
+     * @format uuid
+     */
+    id?: string;
+    name?: string;
+    /**
+     * @format date-time
+     */
+    updatedAt?: string;
+    updatedBy?: string;
+}

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * Pagination request for listing governance policies
+ */
+export interface AiGovernancePolicyListRequest {
+    filters?: Array<{
+        [key: string]: any;
+    }>;
+    /**
+     * Number of records per page (max 100)
+     * @default 10
+     * @example 10
+     */
+    limit?: number;
+    /**
+     * Page number (1-indexed)
+     * @default 1
+     * @example 1
+     */
+    page?: number;
+    /**
+     * Sorting options
+     */
+    sort?: {
+        /**
+         * @example "name"
+         */
+        field?: 'created_at' | 'name' | 'updated_at';
+        /**
+         * @example "DESC"
+         */
+        type?: 'ASC' | 'DESC';
+    };
+}

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

@@ -0,0 +1,14 @@
+import type { AiGovernancePolicyListItem } from '../schemas/AiGovernancePolicyListItem';
+export interface AiGovernancePolicyListResponse {
+    response: {
+        items: AiGovernancePolicyListItem[];
+        /**
+         * Total number of pages
+         */
+        pages: number;
+        /**
+         * Total number of policies matching the criteria
+         */
+        total: number;
+    };
+}

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

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

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

@@ -0,0 +1,31 @@
+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.
+ */
+export interface AiGovernancePolicyOverviewMetrics {
+    /**
+     * Null until dry-run or reconcile has seeded the per-policy stats cache for the current period
+     */
+    cumulativeSpend?: number | null;
+    pendingRequestsCount: number;
+    period: AiGovernanceGovernancePeriod;
+    /**
+     * 1-indexed day within the current budget period
+     */
+    periodDay: number;
+    /**
+     * Null until dry-run or reconcile has seeded the per-policy stats cache for the current period
+     */
+    spendPercent?: number | null;
+    /**
+     * Total effective budget ceiling for the current policy period across all budget-cap rules
+     */
+    totalPeriodBudget: number;
+    totalSubjects: number;
+    /**
+     * Null until dry-run or reconcile has seeded the per-policy stats cache for the current period
+     */
+    userHealth?: AiGovernancePolicyUserHealth | null;
+    warnings?: string[];
+}

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

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

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

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

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

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

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

@@ -0,0 +1,24 @@
+import type { AiGovernanceApprovalRequestView } from '../schemas/AiGovernanceApprovalRequestView';
+export interface AiGovernancePolicySubjectRow {
+    /**
+     * Effective budget ceiling after active overrides
+     */
+    budget: number;
+    /**
+     * Subject email
+     */
+    email: string;
+    pendingRequest?: AiGovernanceApprovalRequestView;
+    /**
+     * Current-period spend for the primary budget-cap rule
+     */
+    spendAmount: number;
+    /**
+     * Spend as a percentage of effective budget
+     */
+    spendPercent: number;
+    /**
+     * Budget utilization band for the subject
+     */
+    status: 'atRisk' | 'good' | 'overBudget';
+}

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * Pagination and filter request for listing governed subjects on a policy
+ */
+export interface AiGovernancePolicySubjectsRequest {
+    /**
+     * all returns every mapped subject; pending_requests returns only subjects with an open budget raise request
+     * @default "all"
+     */
+    filter?: 'all' | 'pending_requests';
+    /**
+     * Number of records per page (max 100)
+     * @default 10
+     * @example 10
+     */
+    limit?: number;
+    /**
+     * Page number (1-indexed)
+     * @default 1
+     * @example 1
+     */
+    page?: number;
+    /**
+     * Optional search string matched against subject email
+     */
+    query?: string;
+    /**
+     * Sorting options
+     */
+    sort?: {
+        /**
+         * @example "email"
+         */
+        field?: 'email';
+        /**
+         * @example "ASC"
+         */
+        type?: 'ASC' | 'DESC';
+    };
+}

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

@@ -0,0 +1,14 @@
+import type { AiGovernancePolicySubjectRow } from '../schemas/AiGovernancePolicySubjectRow';
+export interface AiGovernancePolicySubjectsResponse {
+    response: {
+        items: AiGovernancePolicySubjectRow[];
+        /**
+         * Total number of pages
+         */
+        pages: number;
+        /**
+         * Total number of mapped subjects matching the filter
+         */
+        total: number;
+    };
+}

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

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

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

@@ -0,0 +1,11 @@
+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;
+    /**
+     * Full governance policy YAML document with exactly one policy entry containing subjects and spec
+     */
+    rawYaml?: string;
+}

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

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

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

@@ -0,0 +1,5 @@
+export interface AiGovernancePolicyUserHealth {
+    atRisk?: number;
+    good?: number;
+    overBudget?: number;
+}

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

@@ -0,0 +1,11 @@
+export interface AiGovernanceReviewOverrideItem {
+    action: 'approve' | 'reject';
+    /**
+     * Optional approved ceiling in USD dollars when action is approve; the caller must be authorized for this amount on the pending tier
+     */
+    approved_amount?: number;
+    /**
+     * @format uuid
+     */
+    request_id: string;
+}

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

@@ -0,0 +1,10 @@
+import type { AiGovernanceApprovalRequest } from '../schemas/AiGovernanceApprovalRequest';
+export interface AiGovernanceReviewOverrideOutcome {
+    message?: string;
+    request?: AiGovernanceApprovalRequest;
+    /**
+     * @format uuid
+     */
+    requestId: string;
+    success: boolean;
+}

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

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

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

@@ -0,0 +1,4 @@
+import type { AiGovernanceReviewOverrideItem } from '../schemas/AiGovernanceReviewOverrideItem';
+export interface AiGovernanceReviewOverridesRequest {
+    items: AiGovernanceReviewOverrideItem[];
+}

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

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

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

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

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

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

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

@@ -0,0 +1,4 @@
+import type { AiGovernanceReviewOverrideOutcome } from '../schemas/AiGovernanceReviewOverrideOutcome';
+export interface AiGovernanceReviewOverridesResult {
+    results: AiGovernanceReviewOverrideOutcome[];
+}

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

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