@cratis/ai 2.28.0 → 2.29.0

package/generated/Providers/UsageReporting/UsageReportFor.ts

@@ -0,0 +1,65 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIProviderUsageReport. Time: 2026-09-22T14:46:22.6978567Z. Hash: EFC854588D809BFD96848460C38A25811BBABA0CBB4220CE50433D73B67F315E
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+// eslint-disable-next-line header/header
+import { QueryFor, QueryResultWithState } from '@cratis/arc/queries';
+import { useQuery, useSuspenseQuery, PerformQuery, SetSorting, QueryWhen } from '@cratis/arc.react/queries';
+import { ParameterDescriptor } from '@cratis/arc/reflection';
+import { Guid } from '@cratis/fundamentals';
+import { AIProviderUsageReport } from './AIProviderUsageReport';
+
+
+/**
+ * Gets a configured provider's vendor-reported usage over the trailing 30 days.
+ */
+export interface UsageReportForParameters {
+    
+    /**
+     * The provider to ask.
+    */
+    providerId: Guid;
+}
+
+
+/**
+ * Gets a configured provider's vendor-reported usage over the trailing 30 days.
+ */
+export class UsageReportFor extends QueryFor<AIProviderUsageReport, UsageReportForParameters> {
+    readonly route: string = '/api/a-i/providers/usage-reporting/usage-report-for';
+    readonly queryName: string = 'Cratis.AI.Providers.UsageReporting.AIProviderUsageReport.UsageReportFor';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly defaultValue: AIProviderUsageReport = {} as any;
+
+    constructor() {
+        super(AIProviderUsageReport, false);
+    }
+
+    get requiredRequestParameters(): string[] {
+        return [
+            'providerId',
+        ];
+    }
+
+    readonly parameterDescriptors: ParameterDescriptor[] = [
+        new ParameterDescriptor('providerId', Guid, false),
+    ];
+
+    providerId!: Guid;
+
+
+    static use(args?: UsageReportForParameters): [QueryResultWithState<AIProviderUsageReport>, PerformQuery<UsageReportForParameters>, SetSorting] {
+        return useQuery<AIProviderUsageReport, UsageReportFor, UsageReportForParameters>(UsageReportFor, args);
+    }
+
+    static useSuspense(args?: UsageReportForParameters): [QueryResultWithState<AIProviderUsageReport>, PerformQuery<UsageReportForParameters>, SetSorting] {
+        return useSuspenseQuery<AIProviderUsageReport, UsageReportFor, UsageReportForParameters>(UsageReportFor, args);
+    }
+
+    static when(condition: boolean): QueryWhen<UsageReportFor, AIProviderUsageReport, UsageReportForParameters> {
+        return new QueryWhen<UsageReportFor, AIProviderUsageReport, UsageReportForParameters>(UsageReportFor, condition);
+    }
+}

package/generated/Providers/UsageReporting/index.ts

@@ -0,0 +1,5 @@
+export * from './AIProviderCostDay';
+export * from './AIProviderUsageDay';
+export * from './AIProviderUsageReport';
+export * from './AIUsageReportAvailability';
+export * from './UsageReportFor';

package/generated/Usage/Daily/AgentUsageByDay.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Usage.Daily.AgentUsageByDay. Time: 2026-09-18T08:12:58.5134457Z. Hash: 2674C66E7E2AD98DE559BB6B1440B43F82F5D16C29E8A0CBFCA5948A5A8A3314
+// @generated by Cratis. Source: Cratis.AI.Usage.Daily.AgentUsageByDay. Time: 2026-09-22T14:46:22.7257933Z. Hash: 2674C66E7E2AD98DE559BB6B1440B43F82F5D16C29E8A0CBFCA5948A5A8A3314
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Usage/Daily/LastYear.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Usage.Daily.AgentUsageByDay. Time: 2026-09-18T08:12:58.4936779Z. Hash: D1AB14922E03E8E3709610E8C2476E5A080396D759345FA976233AAF9588F5B5
+// @generated by Cratis. Source: Cratis.AI.Usage.Daily.AgentUsageByDay. Time: 2026-09-22T14:46:22.7052468Z. Hash: D1AB14922E03E8E3709610E8C2476E5A080396D759345FA976233AAF9588F5B5
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Usage/RecordAgentSessionUsage.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Usage.RecordAgentSessionUsage. Time: 2026-09-18T08:12:58.4405795Z. Hash: 00C528E8CDF98B4B0BF929FA9126FE735831CC039DF99C4D50382C693DFFA5F6
+// @generated by Cratis. Source: Cratis.AI.Usage.RecordAgentSessionUsage. Time: 2026-09-22T14:46:22.6438452Z. Hash: 00C528E8CDF98B4B0BF929FA9126FE735831CC039DF99C4D50382C693DFFA5F6
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Usage/Trends/AgentUsageByMonth.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Usage.Trends.AgentUsageByMonth. Time: 2026-09-18T08:12:58.5134457Z. Hash: F1E47FE49C7E983E1C2F547DF3D5CA7AB31B7F519987ED999B9524607288C1B1
+// @generated by Cratis. Source: Cratis.AI.Usage.Trends.AgentUsageByMonth. Time: 2026-09-22T14:46:22.7257933Z. Hash: F1E47FE49C7E983E1C2F547DF3D5CA7AB31B7F519987ED999B9524607288C1B1
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Usage/Trends/AgentUsageByWeek.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Usage.Trends.AgentUsageByWeek. Time: 2026-09-18T08:12:58.5134457Z. Hash: CCAC4A183EBA3D92F60A52BC83FC643F92BBBA0C404B18B45F82C2C089538FCE
+// @generated by Cratis. Source: Cratis.AI.Usage.Trends.AgentUsageByWeek. Time: 2026-09-22T14:46:22.7257933Z. Hash: CCAC4A183EBA3D92F60A52BC83FC643F92BBBA0C404B18B45F82C2C089538FCE
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Usage/Trends/RecentMonths.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Usage.Trends.AgentUsageByMonth. Time: 2026-09-18T08:12:58.4936779Z. Hash: F240078B088824F58319DFCDDF639EBF531ACB4DE21ECC44495A8C80EA8F89A8
+// @generated by Cratis. Source: Cratis.AI.Usage.Trends.AgentUsageByMonth. Time: 2026-09-22T14:46:22.7052468Z. Hash: F240078B088824F58319DFCDDF639EBF531ACB4DE21ECC44495A8C80EA8F89A8
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Usage/Trends/RecentWeeks.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Usage.Trends.AgentUsageByWeek. Time: 2026-09-18T08:12:58.4936779Z. Hash: D66AFEC531F3FED5A5909A0C97F3BEF11E54213E02D6B55E664A8C0671371133
+// @generated by Cratis. Source: Cratis.AI.Usage.Trends.AgentUsageByWeek. Time: 2026-09-22T14:46:22.7052468Z. Hash: D66AFEC531F3FED5A5909A0C97F3BEF11E54213E02D6B55E664A8C0671371133
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/index.ts

@@ -16,6 +16,8 @@ export * from './generated/Providers/Adding';
 export * from './generated/Providers/Reconfiguring';
 export * from './generated/Providers/Renaming';
 export * from './generated/Providers/Removing';
+export * from './generated/Providers/UsageReporting';
+export * from './generated/Providers/UsageReporting/SettingCredential';
 
 // Studio's provider commands are named identically to Direct's own above (AddAnthropicProvider,
 // RenameAIProvider, ...) - the two really are different commands with different routes and event

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cratis/ai",
-    "version": "2.28.0",
+    "version": "2.29.0",
     "description": "Generated Arc command/query proxies and TypeScript types for Cratis.AI - the backend AI concerns (providers, pools, tiers, concurrency, conversations, agents, worker/harness scheduling, usage) shared by Direct and Studio. Generated only - no components, no CSS, no stories.",
     "keywords": [
         "cratis",