@cratis/ai 4.2.0 → 6.0.0

package/generated/Providers/SettingUsageCapacity/index.ts

@@ -0,0 +1,2 @@
+export * from './AIProviderUsageCapacitySet';
+export * from './SetAIProviderUsageCapacity';

package/generated/Providers/SigningIn/EndOpenAISubscriptionSignIn.ts

@@ -0,0 +1,101 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SigningIn.EndOpenAISubscriptionSignIn. Time: 2026-09-24T20:45:06.9194159Z. Hash: DAAC4FCEDCA535012B2F63971DBEEF95B1AB6EA4A3B234AE60E1E43BA5554B1B
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+/* eslint-disable @typescript-eslint/no-empty-interface */
+// eslint-disable-next-line header/header
+import { Command } from '@cratis/arc/commands';
+import { useCommand, SetCommandValues, ClearCommandValues } from '@cratis/arc.react/commands';
+import { PropertyDescriptor } from '@cratis/arc/reflection';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Command for ending a sign-in, however it turned out.
+ */
+export interface IEndOpenAISubscriptionSignIn {
+    
+    /**
+     * The provider whose sign-in ended.
+     */
+    provider?: Guid;
+    
+    /**
+     * Why it did not succeed, when it did not.
+     */
+    reason?: string;
+    
+    /**
+     * Whether the person authorized it.
+     */
+    succeeded?: boolean;
+}
+
+
+/**
+ * Command for ending a sign-in, however it turned out.
+ */
+export class EndOpenAISubscriptionSignIn extends Command<IEndOpenAISubscriptionSignIn, Record<string, unknown>> implements IEndOpenAISubscriptionSignIn {
+    readonly route: string = '/api/a-i/providers/signing-in/end-open-a-i-subscription-sign-in';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('provider', Guid, false),
+        new PropertyDescriptor('reason', String, false),
+        new PropertyDescriptor('succeeded', Boolean, false),
+    ];
+
+    private _provider!: Guid;
+    private _reason!: string;
+    private _succeeded!: boolean;
+
+    constructor() {
+        super(Object, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The provider whose sign-in ended.
+     */
+    get provider(): Guid {
+        return this._provider;
+    }
+
+    set provider(value: Guid) {
+        this._provider = value;
+        this.propertyChanged('provider');
+    }
+    /**
+     * Why it did not succeed, when it did not.
+     */
+    get reason(): string {
+        return this._reason;
+    }
+
+    set reason(value: string) {
+        this._reason = value;
+        this.propertyChanged('reason');
+    }
+    /**
+     * Whether the person authorized it.
+     */
+    get succeeded(): boolean {
+        return this._succeeded;
+    }
+
+    set succeeded(value: boolean) {
+        this._succeeded = value;
+        this.propertyChanged('succeeded');
+    }
+
+    static use(initialValues?: IEndOpenAISubscriptionSignIn): [EndOpenAISubscriptionSignIn, SetCommandValues<IEndOpenAISubscriptionSignIn>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<EndOpenAISubscriptionSignIn, IEndOpenAISubscriptionSignIn>(EndOpenAISubscriptionSignIn, initialValues);
+    }
+}

package/generated/Providers/SigningIn/OpenAISubscriptionSignInStarted.ts

@@ -0,0 +1,32 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SigningIn.OpenAISubscriptionSignInStarted. Time: 2026-09-24T20:45:07.0633412Z. Hash: 5E0B745F765E277C5CEE18E76F068440BE913AB6D2973860460E5EE16659EEC0
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+// eslint-disable-next-line header/header
+import { field } from '@cratis/fundamentals';
+
+/**
+ * Event raised when a ChatGPT subscription sign-in is waiting for somebody to authorize it.
+ */
+export class OpenAISubscriptionSignInStarted {
+
+    /**
+     * The code to type into the verification page. Not a secret: it is worthless without someone signing in to their own ChatGPT account.
+     */
+    @field(String)
+    userCode!: string;
+
+    /**
+     * Where to type it.
+     */
+    @field(String)
+    verificationUrl!: string;
+
+    /**
+     * When the code stops being accepted.
+     */
+    @field(Date)
+    expiresAt!: Date;
+}

package/generated/Providers/SigningIn/PendingSubscriptionSignIn.ts

@@ -0,0 +1,39 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SigningIn.PendingSubscriptionSignIn. Time: 2026-09-24T20:45:07.0633412Z. Hash: 0BCC769E63741E9225CA1DABD83D9C5F3A6401F665857ABC334D1A35D5AC283E
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+// eslint-disable-next-line header/header
+import { field } from '@cratis/fundamentals';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Read model for a sign-in that is waiting on somebody - what the provider row shows the code and link from. It exists only while the sign-in is outstanding: both ways it can end remove it.
+ */
+export class PendingSubscriptionSignIn {
+
+    /**
+     * The provider being signed in.
+     */
+    @field(Guid)
+    id!: Guid;
+
+    /**
+     * The code to type into the verification page.
+     */
+    @field(String)
+    userCode!: string;
+
+    /**
+     * Where to type it.
+     */
+    @field(String)
+    verificationUrl!: string;
+
+    /**
+     * When the code stops being accepted.
+     */
+    @field(Date)
+    expiresAt!: Date;
+}

package/generated/Providers/SigningIn/PendingSubscriptionSignIns.ts

@@ -0,0 +1,82 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SigningIn.PendingSubscriptionSignIn. Time: 2026-09-24T20:45:07.0050510Z. Hash: 9B94B4AB51DF62D97224B66D7FCF6A20022F7D7E1B45D1BD630483FA6B337CD7
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+// eslint-disable-next-line header/header
+import { ObservableQueryFor, QueryResultWithState, Sorting, Paging, ChangeSet } from '@cratis/arc/queries';
+import { useObservableQuery, useObservableQueryWithPaging, useSuspenseObservableQuery, useSuspenseObservableQueryWithPaging, useChangeStream, SetSorting, SetPage, SetPageSize, ObservableQueryWhen } from '@cratis/arc.react/queries';
+import { ParameterDescriptor } from '@cratis/arc/reflection';
+import { PendingSubscriptionSignIn } from './PendingSubscriptionSignIn';
+
+class PendingSubscriptionSignInsSortBy {
+
+    constructor(readonly query: PendingSubscriptionSignIns) {
+    }
+
+}
+
+class PendingSubscriptionSignInsSortByWithoutQuery {
+
+}
+
+
+/**
+ * Observes every sign-in currently waiting on somebody.
+ */
+export class PendingSubscriptionSignIns extends ObservableQueryFor<PendingSubscriptionSignIn[]> {
+    readonly route: string = '/api/a-i/providers/signing-in/pending-subscription-sign-ins';
+    readonly queryName: string = 'Cratis.AI.Providers.SigningIn.PendingSubscriptionSignIn.PendingSubscriptionSignIns';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly defaultValue: PendingSubscriptionSignIn[] = [];
+    private readonly _sortBy: PendingSubscriptionSignInsSortBy;
+    private static readonly _sortBy: PendingSubscriptionSignInsSortByWithoutQuery = new PendingSubscriptionSignInsSortByWithoutQuery();
+
+    constructor() {
+        super(PendingSubscriptionSignIn, true);
+        this._sortBy = new PendingSubscriptionSignInsSortBy(this);
+    }
+
+    get requiredRequestParameters(): string[] {
+        return [
+        ];
+    }
+
+    readonly parameterDescriptors: ParameterDescriptor[] = [
+    ];
+
+
+    get sortBy(): PendingSubscriptionSignInsSortBy {
+        return this._sortBy;
+    }
+
+    static get sortBy(): PendingSubscriptionSignInsSortByWithoutQuery {
+        return this._sortBy;
+    }
+
+    static use(sorting?: Sorting): [QueryResultWithState<PendingSubscriptionSignIn[]>, SetSorting] {
+        return useObservableQuery<PendingSubscriptionSignIn[], PendingSubscriptionSignIns>(PendingSubscriptionSignIns, undefined, sorting);
+    }
+
+    static useWithPaging(pageSize: number, sorting?: Sorting): [QueryResultWithState<PendingSubscriptionSignIn[]>, SetSorting, SetPage, SetPageSize] {
+        return useObservableQueryWithPaging<PendingSubscriptionSignIn[], PendingSubscriptionSignIns>(PendingSubscriptionSignIns, new Paging(0, pageSize), undefined, sorting);
+    }
+
+    static useSuspense(sorting?: Sorting): [QueryResultWithState<PendingSubscriptionSignIn[]>, SetSorting] {
+        return useSuspenseObservableQuery<PendingSubscriptionSignIn[], PendingSubscriptionSignIns>(PendingSubscriptionSignIns, undefined, sorting);
+    }
+
+    static useSuspenseWithPaging(pageSize: number, sorting?: Sorting): [QueryResultWithState<PendingSubscriptionSignIn[]>, SetSorting, SetPage, SetPageSize] {
+        return useSuspenseObservableQueryWithPaging<PendingSubscriptionSignIn[], PendingSubscriptionSignIns>(PendingSubscriptionSignIns, new Paging(0, pageSize), undefined, sorting);
+    }
+
+    static useChangeStream(getKey?: (item: PendingSubscriptionSignIn) => unknown, sorting?: Sorting): ChangeSet<PendingSubscriptionSignIn> {
+        return useChangeStream<PendingSubscriptionSignIn, PendingSubscriptionSignIns>(PendingSubscriptionSignIns, undefined, getKey, sorting);
+    }
+
+    static when(condition: boolean): ObservableQueryWhen<PendingSubscriptionSignIns, PendingSubscriptionSignIn[]> {
+        return new ObservableQueryWhen<PendingSubscriptionSignIns, PendingSubscriptionSignIn[]>(PendingSubscriptionSignIns, condition);
+    }
+}

package/generated/Providers/SigningIn/StartOpenAISubscriptionSignIn.ts

@@ -0,0 +1,66 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SigningIn.StartOpenAISubscriptionSignIn. Time: 2026-09-24T20:45:06.9194159Z. Hash: CC9096637255609AC7498D77B0855FAB69BCEEA6CB9F9E87A9E1D40F5064FF5C
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+/* eslint-disable @typescript-eslint/no-empty-interface */
+// eslint-disable-next-line header/header
+import { Command } from '@cratis/arc/commands';
+import { useCommand, SetCommandValues, ClearCommandValues } from '@cratis/arc.react/commands';
+import { PropertyDescriptor } from '@cratis/arc/reflection';
+import { OpenAISubscriptionSignInStarted } from './OpenAISubscriptionSignInStarted';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Command for signing an OpenAI provider in to a ChatGPT subscription, using OpenAI's device-code flow. This exists so nobody has to copy JSON out of a file. The alternative - run `pi` somewhere, open `~/.pi/agent/auth.json`, paste an object into a field labelled "API key" - is undiscoverable and easy to get half right. Device-code is the flow designed for exactly this situation: the server has no browser, so a person authorizes from any browser they do have.
+ */
+export interface IStartOpenAISubscriptionSignIn {
+    
+    /**
+     * The provider being signed in.
+     */
+    provider?: Guid;
+}
+
+
+/**
+ * Command for signing an OpenAI provider in to a ChatGPT subscription, using OpenAI's device-code flow. This exists so nobody has to copy JSON out of a file. The alternative - run `pi` somewhere, open `~/.pi/agent/auth.json`, paste an object into a field labelled "API key" - is undiscoverable and easy to get half right. Device-code is the flow designed for exactly this situation: the server has no browser, so a person authorizes from any browser they do have.
+ */
+export class StartOpenAISubscriptionSignIn extends Command<IStartOpenAISubscriptionSignIn, OpenAISubscriptionSignInStarted> implements IStartOpenAISubscriptionSignIn {
+    readonly route: string = '/api/a-i/providers/signing-in/start-open-a-i-subscription-sign-in';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('provider', Guid, false),
+    ];
+
+    private _provider!: Guid;
+
+    constructor() {
+        super(OpenAISubscriptionSignInStarted, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The provider being signed in.
+     */
+    get provider(): Guid {
+        return this._provider;
+    }
+
+    set provider(value: Guid) {
+        this._provider = value;
+        this.propertyChanged('provider');
+    }
+
+    static use(initialValues?: IStartOpenAISubscriptionSignIn): [StartOpenAISubscriptionSignIn, SetCommandValues<IStartOpenAISubscriptionSignIn>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<StartOpenAISubscriptionSignIn, IStartOpenAISubscriptionSignIn>(StartOpenAISubscriptionSignIn, initialValues);
+    }
+}

package/generated/Providers/SigningIn/index.ts

@@ -0,0 +1,5 @@
+export * from './EndOpenAISubscriptionSignIn';
+export * from './OpenAISubscriptionSignInStarted';
+export * from './PendingSubscriptionSignIn';
+export * from './PendingSubscriptionSignIns';
+export * from './StartOpenAISubscriptionSignIn';

package/generated/Providers/TierModels.ts

@@ -0,0 +1,38 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.TierModels. Time: 2026-09-24T20:45:07.0633412Z. Hash: A06974923D33AF02EBE6F6364410A146F39134D50E393F5BDF977CD21E2F81B1
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+// eslint-disable-next-line header/header
+import { field } from '@cratis/fundamentals';
+
+/**
+ * A provider's mapping from the package's capability tiers to the concrete models that vendor offers - one model per tier, unset tiers falling back to the vendor's defaults. Ported from Direct's `AIProviders.TierModels` (plan Section 5.2 step 6).
+ */
+export class TierModels {
+
+    /**
+     * The vendor's model for {@link Fast} - {@link NotSet} for the vendor default.
+     */
+    @field(String)
+    fast!: string;
+
+    /**
+     * The vendor's model for {@link Balanced} - {@link NotSet} for the vendor default.
+     */
+    @field(String)
+    balanced!: string;
+
+    /**
+     * The vendor's model for {@link Powerful} - {@link NotSet} for the vendor default.
+     */
+    @field(String)
+    powerful!: string;
+
+    /**
+     * The vendor's model for {@link Premier} - {@link NotSet} for the vendor default.
+     */
+    @field(String)
+    premier!: string;
+}

package/generated/Providers/UsageReporting/AIProviderCostDay.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIProviderCostDay. Time: 2026-09-24T16:20:39.6736015Z. Hash: 65829F49EFC432CFE6D2373FC261CF25D126A67EB39ACA43A3CFCB8A90B90CB8
+// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIProviderCostDay. Time: 2026-09-24T20:45:07.0633412Z. Hash: 65829F49EFC432CFE6D2373FC261CF25D126A67EB39ACA43A3CFCB8A90B90CB8
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/UsageReporting/AIProviderUsage.ts

@@ -0,0 +1,45 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIProviderUsage. Time: 2026-09-24T20:45:07.0633412Z. Hash: 2ECBD7FD5F44CF7367832864DF645ACB383A50FF08402007A1175EC42736AB6F
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+// eslint-disable-next-line header/header
+import { field } from '@cratis/fundamentals';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * How much work a provider has actually been given, over the trailing week and over all time.
+ */
+export class AIProviderUsage {
+
+    /**
+     * The provider the work ran on.
+     */
+    @field(Guid)
+    providerId!: Guid;
+
+    /**
+     * Sessions in the trailing week.
+     */
+    @field(Number)
+    jobsLastWeek!: number;
+
+    /**
+     * Tokens spent in the trailing week.
+     */
+    @field(Number)
+    tokensUsedLastWeek!: number;
+
+    /**
+     * Sessions over all time.
+     */
+    @field(Number)
+    jobsTotal!: number;
+
+    /**
+     * Tokens spent over all time.
+     */
+    @field(Number)
+    tokensUsedTotal!: number;
+}

package/generated/Providers/UsageReporting/AIProviderUsageDay.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIProviderUsageDay. Time: 2026-09-24T16:20:39.6736015Z. Hash: 58A73E84D604A751916B07997C6B4825BC80F1EA77A2A39AB70391CD1B6360AC
+// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIProviderUsageDay. Time: 2026-09-24T20:45:07.0633412Z. Hash: 58A73E84D604A751916B07997C6B4825BC80F1EA77A2A39AB70391CD1B6360AC
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/UsageReporting/AIProviderUsageReport.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIProviderUsageReport. Time: 2026-09-24T16:20:39.6736015Z. Hash: 904624D9E3519046F95B2EA40270C3104B64F3B7C60D89BDA1CADAEBDF86308B
+// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIProviderUsageReport. Time: 2026-09-24T20:45:07.0633412Z. Hash: 904624D9E3519046F95B2EA40270C3104B64F3B7C60D89BDA1CADAEBDF86308B
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/UsageReporting/AIUsageReportAvailability.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIUsageReportAvailability. Time: 2026-09-24T16:20:39.6810234Z. Hash: AE2EBE1D8375DFE60816D256636E89DAB713FC12FBA3E3011CFBC07D39198960
+// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIUsageReportAvailability. Time: 2026-09-24T20:45:07.0779900Z. Hash: AE2EBE1D8375DFE60816D256636E89DAB713FC12FBA3E3011CFBC07D39198960
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/UsageReporting/AllAIProviderUsage.ts

@@ -0,0 +1,78 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.AIProviderUsage. Time: 2026-09-24T20:45:06.9985386Z. Hash: B9F462BA9558BA40FD960C2114A6A86723ABE2E6D348B205AB1E1E64F50F5DEA
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+// eslint-disable-next-line header/header
+import { QueryFor, QueryResultWithState, Sorting, Paging } from '@cratis/arc/queries';
+import { useQuery, useQueryWithPaging, useSuspenseQuery, useSuspenseQueryWithPaging, PerformQuery, SetSorting, SetPage, SetPageSize, QueryWhen } from '@cratis/arc.react/queries';
+import { ParameterDescriptor } from '@cratis/arc/reflection';
+import { AIProviderUsage } from './AIProviderUsage';
+
+class AllAIProviderUsageSortBy {
+
+    constructor(readonly query: AllAIProviderUsage) {
+    }
+
+}
+
+class AllAIProviderUsageSortByWithoutQuery {
+
+}
+
+
+/**
+ * Totals every provider's recorded usage.
+ */
+export class AllAIProviderUsage extends QueryFor<AIProviderUsage[]> {
+    readonly route: string = '/api/a-i/providers/usage-reporting/all-a-i-provider-usage';
+    readonly queryName: string = 'Cratis.AI.Providers.UsageReporting.AIProviderUsage.AllAIProviderUsage';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly defaultValue: AIProviderUsage[] = [];
+    private readonly _sortBy: AllAIProviderUsageSortBy;
+    private static readonly _sortBy: AllAIProviderUsageSortByWithoutQuery = new AllAIProviderUsageSortByWithoutQuery();
+
+    constructor() {
+        super(AIProviderUsage, true);
+        this._sortBy = new AllAIProviderUsageSortBy(this);
+    }
+
+    get requiredRequestParameters(): string[] {
+        return [
+        ];
+    }
+
+    readonly parameterDescriptors: ParameterDescriptor[] = [
+    ];
+
+
+    get sortBy(): AllAIProviderUsageSortBy {
+        return this._sortBy;
+    }
+
+    static get sortBy(): AllAIProviderUsageSortByWithoutQuery {
+        return this._sortBy;
+    }
+
+    static use(sorting?: Sorting): [QueryResultWithState<AIProviderUsage[]>, PerformQuery, SetSorting] {
+        return useQuery<AIProviderUsage[], AllAIProviderUsage>(AllAIProviderUsage, undefined, sorting);
+    }
+
+    static useWithPaging(pageSize: number, sorting?: Sorting): [QueryResultWithState<AIProviderUsage[]>, PerformQuery, SetSorting, SetPage, SetPageSize] {
+        return useQueryWithPaging<AIProviderUsage[], AllAIProviderUsage>(AllAIProviderUsage, new Paging(0, pageSize), undefined, sorting);
+    }
+
+    static useSuspense(sorting?: Sorting): [QueryResultWithState<AIProviderUsage[]>, PerformQuery, SetSorting] {
+        return useSuspenseQuery<AIProviderUsage[], AllAIProviderUsage>(AllAIProviderUsage, undefined, sorting);
+    }
+
+    static useSuspenseWithPaging(pageSize: number, sorting?: Sorting): [QueryResultWithState<AIProviderUsage[]>, PerformQuery, SetSorting, SetPage, SetPageSize] {
+        return useSuspenseQueryWithPaging<AIProviderUsage[], AllAIProviderUsage>(AllAIProviderUsage, new Paging(0, pageSize), undefined, sorting);
+    }
+
+    static when(condition: boolean): QueryWhen<AllAIProviderUsage, AIProviderUsage[]> {
+        return new QueryWhen<AllAIProviderUsage, AIProviderUsage[]>(AllAIProviderUsage, condition);
+    }
+}

package/generated/Providers/UsageReporting/RecordingSnapshot/AIProviderUsageSnapshotRecorded.ts

@@ -0,0 +1,33 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.UsageReporting.RecordingSnapshot.AIProviderUsageSnapshotRecorded. Time: 2026-09-24T20:45:07.0633412Z. Hash: E0EDE873597AFE8885E3C73BA17B79463B8ED900550C987CEEC1F3CDA1366253
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+// eslint-disable-next-line header/header
+import { field } from '@cratis/fundamentals';
+import { AIUsageReportAvailability } from '../AIUsageReportAvailability';
+
+/**
+ * Event raised when a provider's usage level has been refreshed ahead of a selection decision - the audit trail for capacity-aware pool selection (issue #1061).
+ */
+export class AIProviderUsageSnapshotRecorded {
+
+    /**
+     * Why the vendor-reported usage was or was not available for this refresh.
+     */
+    @field(Number)
+    availability!: AIUsageReportAvailability;
+
+    /**
+     * The tokens counted as consumed - vendor-reported where `Availability` is {@link Available}, Direct's own trailing-week burn otherwise.
+     */
+    @field(Number)
+    consumedTokens!: number;
+
+    /**
+     * Whether `ConsumedTokens` came from Direct's own trailing-week burn rather than the vendor's usage report.
+     */
+    @field(Boolean)
+    usedLocalBurnFallback!: boolean;
+}