@cratis/ai 5.0.0 → 6.0.0

package/generated/Providers/RateLimiting/RecordProviderRateLimited.ts

@@ -0,0 +1,84 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.RateLimiting.RecordProviderRateLimited. Time: 2026-09-24T20:45:06.9194159Z. Hash: C99BADF55E01B31F328DCFC9EDFC34662D8753EA06448188A8B281DDFAEF9B9C
+/*---------------------------------------------------------------------------------------------
+ *  **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 { AIProviderRateLimited } from './AIProviderRateLimited';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Command for recording that a provider turned work away over its own usage limit - the one place that appends {@link AIProviderRateLimited} for a caller that knows this directly, rather than inferring it from a worker's own failure text the way `Work.Failing.FailWork` still does. The completion path ({@link ProviderAwareLanguageModel}) is the first such caller (issue #1060) - it sees the vendor's actual 429/quota response, not a report relayed through a worker container.
+ */
+export interface IRecordProviderRateLimited {
+    
+    /**
+     * The provider that was rate-limited - its own identity resolves the event source.
+     */
+    provider?: Guid;
+    
+    /**
+     * When the provider is worth trying again.
+     */
+    until?: Date;
+}
+
+
+/**
+ * Command for recording that a provider turned work away over its own usage limit - the one place that appends {@link AIProviderRateLimited} for a caller that knows this directly, rather than inferring it from a worker's own failure text the way `Work.Failing.FailWork` still does. The completion path ({@link ProviderAwareLanguageModel}) is the first such caller (issue #1060) - it sees the vendor's actual 429/quota response, not a report relayed through a worker container.
+ */
+export class RecordProviderRateLimited extends Command<IRecordProviderRateLimited, AIProviderRateLimited> implements IRecordProviderRateLimited {
+    readonly route: string = '/api/a-i/providers/rate-limiting';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('provider', Guid, false),
+        new PropertyDescriptor('until', Date, false),
+    ];
+
+    private _provider!: Guid;
+    private _until!: Date;
+
+    constructor() {
+        super(AIProviderRateLimited, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The provider that was rate-limited - its own identity resolves the event source.
+     */
+    get provider(): Guid {
+        return this._provider;
+    }
+
+    set provider(value: Guid) {
+        this._provider = value;
+        this.propertyChanged('provider');
+    }
+    /**
+     * When the provider is worth trying again.
+     */
+    get until(): Date {
+        return this._until;
+    }
+
+    set until(value: Date) {
+        this._until = value;
+        this.propertyChanged('until');
+    }
+
+    static use(initialValues?: IRecordProviderRateLimited): [RecordProviderRateLimited, SetCommandValues<IRecordProviderRateLimited>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<RecordProviderRateLimited, IRecordProviderRateLimited>(RecordProviderRateLimited, initialValues);
+    }
+}

package/generated/Providers/RateLimiting/index.ts

@@ -0,0 +1,2 @@
+export * from './AIProviderRateLimited';
+export * from './RecordProviderRateLimited';

package/generated/Providers/Reconfiguring/AnthropicProviderReconfigured.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.AnthropicProviderReconfigured. Time: 2026-09-24T20:06:45.0108829Z. Hash: 73CECC02DBB40423998A0BDD0F3FAFB1527ECBA5CE07A0AED322CD59CA15CE53
+// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.AnthropicProviderReconfigured. Time: 2026-09-24T20:45:07.0633412Z. Hash: 73CECC02DBB40423998A0BDD0F3FAFB1527ECBA5CE07A0AED322CD59CA15CE53
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Reconfiguring/AzureOpenAIProviderReconfigured.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.AzureOpenAIProviderReconfigured. Time: 2026-09-24T20:06:45.0108829Z. Hash: CB7159FA2C0109888077012805CA383A4E899FA1C67CE1B3048B7098B4C38F4D
+// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.AzureOpenAIProviderReconfigured. Time: 2026-09-24T20:45:07.0633412Z. Hash: CB7159FA2C0109888077012805CA383A4E899FA1C67CE1B3048B7098B4C38F4D
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Reconfiguring/OpenAICompatibleProviderReconfigured.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.OpenAICompatibleProviderReconfigured. Time: 2026-09-24T20:06:45.0108829Z. Hash: C23BDDBB03D3CABA174385AD8E251F66DEA39497B0FC98EC2EA643677450E39C
+// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.OpenAICompatibleProviderReconfigured. Time: 2026-09-24T20:45:07.0633412Z. Hash: C23BDDBB03D3CABA174385AD8E251F66DEA39497B0FC98EC2EA643677450E39C
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Reconfiguring/ReconfigureAnthropicProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ReconfigureAnthropicProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: CCD933EE064EE8B73520666D59C412449A08216D16720C652D7519A6E890824F
+// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ReconfigureAnthropicProvider. Time: 2026-09-24T20:45:06.9194159Z. Hash: CCD933EE064EE8B73520666D59C412449A08216D16720C652D7519A6E890824F
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Reconfiguring/ReconfigureAzureOpenAIProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ReconfigureAzureOpenAIProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: F12891CA4BAAEEB6C5549B46033B1045A8E6C4669C4E04521598C87AE685B163
+// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ReconfigureAzureOpenAIProvider. Time: 2026-09-24T20:45:06.9194159Z. Hash: F12891CA4BAAEEB6C5549B46033B1045A8E6C4669C4E04521598C87AE685B163
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Reconfiguring/ReconfigureOpenAICompatibleProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ReconfigureOpenAICompatibleProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: AB3A046F8AC112250264AB5658804D2186F00B5638DEA16398DE350173759969
+// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ReconfigureOpenAICompatibleProvider. Time: 2026-09-24T20:45:06.9194159Z. Hash: AB3A046F8AC112250264AB5658804D2186F00B5638DEA16398DE350173759969
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Reconfiguring/ReconfigureOpenAIProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ReconfigureOpenAIProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: AFE978AE0A73F64BAF92AE796B24F2FD2C4B32D4ED7FB11D81B5AA79DF460170
+// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ReconfigureOpenAIProvider. Time: 2026-09-24T20:45:06.9194159Z. Hash: 8CA68B9346A5E420D0FE65943B5E81ABEE9D8EC2DEC7400E083D4DA05DD9C8B4
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/
@@ -9,11 +9,10 @@
 import { Command } from '@cratis/arc/commands';
 import { useCommand, SetCommandValues, ClearCommandValues } from '@cratis/arc.react/commands';
 import { PropertyDescriptor } from '@cratis/arc/reflection';
-import { OpenAIProviderReconfigured } from './OpenAIProviderReconfigured';
 import { Guid } from '@cratis/fundamentals';
 
 /**
- * Command for changing an OpenAI provider's API key - a blank value keeps whatever is already recorded. Ported from Direct's `AIProviders.Reconfiguring.ReconfigureOpenAIProvider` (plan Section 5.2 step 4) - deliberately without Direct's own subscription-credential-kind classification event, the same simplification {@link AddOpenAIProvider} makes and for the same reason (plan Section 5.6, not yet ported).
+ * Command for changing an OpenAI provider's API key - a blank value keeps whatever is already recorded.
  */
 export interface IReconfigureOpenAIProvider {
     
@@ -30,9 +29,9 @@ export interface IReconfigureOpenAIProvider {
 
 
 /**
- * Command for changing an OpenAI provider's API key - a blank value keeps whatever is already recorded. Ported from Direct's `AIProviders.Reconfiguring.ReconfigureOpenAIProvider` (plan Section 5.2 step 4) - deliberately without Direct's own subscription-credential-kind classification event, the same simplification {@link AddOpenAIProvider} makes and for the same reason (plan Section 5.6, not yet ported).
+ * Command for changing an OpenAI provider's API key - a blank value keeps whatever is already recorded.
  */
-export class ReconfigureOpenAIProvider extends Command<IReconfigureOpenAIProvider, OpenAIProviderReconfigured> implements IReconfigureOpenAIProvider {
+export class ReconfigureOpenAIProvider extends Command<IReconfigureOpenAIProvider, Record<string, unknown>> implements IReconfigureOpenAIProvider {
     readonly route: string = '/api/a-i/providers/reconfiguring/reconfigure-open-a-i-provider';
     readonly treatWarningsAsErrors: boolean = false;
     readonly roles: string[] = [];
@@ -45,7 +44,7 @@ export class ReconfigureOpenAIProvider extends Command<IReconfigureOpenAIProvide
     private _provider!: Guid;
 
     constructor() {
-        super(OpenAIProviderReconfigured, false);
+        super(Object, true);
     }
 
     get requestParameters(): string[] {

package/generated/Providers/Reconfiguring/ReconfigureZAIProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ReconfigureZAIProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: D86A895C7158E5B930549674321CF7B883A0EF747887BE903486122BA59041CC
+// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ReconfigureZAIProvider. Time: 2026-09-24T20:45:06.9194159Z. Hash: D86A895C7158E5B930549674321CF7B883A0EF747887BE903486122BA59041CC
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Reconfiguring/ZAIProviderReconfigured.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ZAIProviderReconfigured. Time: 2026-09-24T20:06:45.0108829Z. Hash: 0072330F97F0C7B543E24BA6D7287B64C89FA7F46C4EA0DC0699FBF7F68A937D
+// @generated by Cratis. Source: Cratis.AI.Providers.Reconfiguring.ZAIProviderReconfigured. Time: 2026-09-24T20:45:07.0633412Z. Hash: 0072330F97F0C7B543E24BA6D7287B64C89FA7F46C4EA0DC0699FBF7F68A937D
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Reconfiguring/index.ts

@@ -1,7 +1,6 @@
 export * from './AnthropicProviderReconfigured';
 export * from './AzureOpenAIProviderReconfigured';
 export * from './OpenAICompatibleProviderReconfigured';
-export * from './OpenAIProviderReconfigured';
 export * from './ReconfigureAnthropicProvider';
 export * from './ReconfigureAzureOpenAIProvider';
 export * from './ReconfigureOpenAICompatibleProvider';

package/generated/Providers/Refreshing/RecordRefreshedOpenAISubscription.ts

@@ -0,0 +1,83 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Refreshing.RecordRefreshedOpenAISubscription. Time: 2026-09-24T20:45:06.9194159Z. Hash: D9B7E2D0D0A73AA08D60DFE8EE9FC78740D443AECC2135D9F1B1F294DC594FCF
+/*---------------------------------------------------------------------------------------------
+ *  **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 recording that a ChatGPT subscription credential has been rotated. This is not a person reconfiguring a provider, which is why it is its own command and its own event rather than reusing `ReconfigureOpenAIProvider`: it is the system keeping a credential that rotates on every use current, and the log should read that way. It also has no blank-keeps-existing behavior - a refresh either produced a new credential or it did not happen. Recording it is not optional bookkeeping. OpenAI retires a refresh token the moment it is spent, so the credential Direct holds after an exchange is the only live one; failing to store it back would leave the provider authenticating with a token the vendor has already discarded, which fails on the next dispatch with nothing to point at.
+ */
+export interface IRecordRefreshedOpenAISubscription {
+    
+    /**
+     * The freshly minted credential, unprotected - protected here before it lands on the event.
+     */
+    credential?: string;
+    
+    /**
+     * The provider whose credential was rotated.
+     */
+    provider?: Guid;
+}
+
+
+/**
+ * Command for recording that a ChatGPT subscription credential has been rotated. This is not a person reconfiguring a provider, which is why it is its own command and its own event rather than reusing `ReconfigureOpenAIProvider`: it is the system keeping a credential that rotates on every use current, and the log should read that way. It also has no blank-keeps-existing behavior - a refresh either produced a new credential or it did not happen. Recording it is not optional bookkeeping. OpenAI retires a refresh token the moment it is spent, so the credential Direct holds after an exchange is the only live one; failing to store it back would leave the provider authenticating with a token the vendor has already discarded, which fails on the next dispatch with nothing to point at.
+ */
+export class RecordRefreshedOpenAISubscription extends Command<IRecordRefreshedOpenAISubscription, Record<string, unknown>> implements IRecordRefreshedOpenAISubscription {
+    readonly route: string = '/api/a-i/providers/refreshing';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('credential', String, false),
+        new PropertyDescriptor('provider', Guid, false),
+    ];
+
+    private _credential!: string;
+    private _provider!: Guid;
+
+    constructor() {
+        super(Object, true);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The freshly minted credential, unprotected - protected here before it lands on the event.
+     */
+    get credential(): string {
+        return this._credential;
+    }
+
+    set credential(value: string) {
+        this._credential = value;
+        this.propertyChanged('credential');
+    }
+    /**
+     * The provider whose credential was rotated.
+     */
+    get provider(): Guid {
+        return this._provider;
+    }
+
+    set provider(value: Guid) {
+        this._provider = value;
+        this.propertyChanged('provider');
+    }
+
+    static use(initialValues?: IRecordRefreshedOpenAISubscription): [RecordRefreshedOpenAISubscription, SetCommandValues<IRecordRefreshedOpenAISubscription>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<RecordRefreshedOpenAISubscription, IRecordRefreshedOpenAISubscription>(RecordRefreshedOpenAISubscription, initialValues);
+    }
+}

package/generated/Providers/Refreshing/index.ts

@@ -0,0 +1 @@
+export * from './RecordRefreshedOpenAISubscription';

package/generated/Providers/Removing/RemoveAIProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Removing.RemoveAIProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: FC6C6B28E182282A3EDCB8319142BE8A543EAE3A6E9D8BB08A0503E2F5543875
+// @generated by Cratis. Source: Cratis.AI.Providers.Removing.RemoveAIProvider. Time: 2026-09-24T20:45:06.9194159Z. Hash: FC6C6B28E182282A3EDCB8319142BE8A543EAE3A6E9D8BB08A0503E2F5543875
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Renaming/RenameAIProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Renaming.RenameAIProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: E241BAC70C3CB37CAD402CC8733071E7C95CC3299190A14DFAF6A22D4424A86F
+// @generated by Cratis. Source: Cratis.AI.Providers.Renaming.RenameAIProvider. Time: 2026-09-24T20:45:06.9194159Z. Hash: E241BAC70C3CB37CAD402CC8733071E7C95CC3299190A14DFAF6A22D4424A86F
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/SettingConcurrency/AIProviderConcurrencySet.ts

@@ -0,0 +1,20 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SettingConcurrency.AIProviderConcurrencySet. Time: 2026-09-24T20:45:07.0633412Z. Hash: BF560805662F37EAD6FC20E1AA1A7B0DE978EE0223DDF2026C066A4CF3D60028
+/*---------------------------------------------------------------------------------------------
+ *  **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 configured AI provider's concurrency bound has been set.
+ */
+export class AIProviderConcurrencySet {
+
+    /**
+     * How many units of work may run on the provider at once - zero for no limit.
+     */
+    @field(Number)
+    maxConcurrentJobs!: number;
+}

package/generated/Providers/SettingConcurrency/SetAIProviderConcurrency.ts

@@ -0,0 +1,91 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SettingConcurrency.SetAIProviderConcurrency. Time: 2026-09-24T20:45:06.9194159Z. Hash: 1E4B2F07AFBEDF06DB6A8EE10AF1F558FBE0A930DE5605596743BA674FC54300
+/*---------------------------------------------------------------------------------------------
+ *  **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, CommandValidator } from '@cratis/arc/commands';
+import { useCommand, SetCommandValues, ClearCommandValues } from '@cratis/arc.react/commands';
+import { PropertyDescriptor } from '@cratis/arc/reflection';
+import { AIProviderConcurrencySet } from './AIProviderConcurrencySet';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Command for bounding how many units of work may run on a configured AI provider at once - vendor-agnostic, since the bound is about the provider's capacity rather than anything the vendor exposes. Zero means no limit.
+ */
+export interface ISetAIProviderConcurrency {
+    
+    /**
+     * How many units of work may run on it at once - zero for no limit.
+     */
+    maxConcurrentJobs?: number;
+    
+    /**
+     * The provider to bound.
+     */
+    provider?: Guid;
+}
+
+export class SetAIProviderConcurrencyValidator extends CommandValidator<ISetAIProviderConcurrency> {
+    constructor() {
+        super();
+        this.ruleFor(c => c.maxConcurrentJobs).greaterThanOrEqual(0).withMessage('A concurrency limit cannot be negative - use zero for no limit');
+    }
+}
+
+/**
+ * Command for bounding how many units of work may run on a configured AI provider at once - vendor-agnostic, since the bound is about the provider's capacity rather than anything the vendor exposes. Zero means no limit.
+ */
+export class SetAIProviderConcurrency extends Command<ISetAIProviderConcurrency, AIProviderConcurrencySet> implements ISetAIProviderConcurrency {
+    readonly route: string = '/api/a-i/providers/setting-concurrency';
+    readonly validation: CommandValidator = new SetAIProviderConcurrencyValidator();
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('maxConcurrentJobs', Number, false),
+        new PropertyDescriptor('provider', Guid, false),
+    ];
+
+    private _maxConcurrentJobs!: number;
+    private _provider!: Guid;
+
+    constructor() {
+        super(AIProviderConcurrencySet, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * How many units of work may run on it at once - zero for no limit.
+     */
+    get maxConcurrentJobs(): number {
+        return this._maxConcurrentJobs;
+    }
+
+    set maxConcurrentJobs(value: number) {
+        this._maxConcurrentJobs = value;
+        this.propertyChanged('maxConcurrentJobs');
+    }
+    /**
+     * The provider to bound.
+     */
+    get provider(): Guid {
+        return this._provider;
+    }
+
+    set provider(value: Guid) {
+        this._provider = value;
+        this.propertyChanged('provider');
+    }
+
+    static use(initialValues?: ISetAIProviderConcurrency): [SetAIProviderConcurrency, SetCommandValues<ISetAIProviderConcurrency>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<SetAIProviderConcurrency, ISetAIProviderConcurrency>(SetAIProviderConcurrency, initialValues);
+    }
+}

package/generated/Providers/SettingConcurrency/index.ts

@@ -0,0 +1,2 @@
+export * from './AIProviderConcurrencySet';
+export * from './SetAIProviderConcurrency';

package/generated/Providers/SettingTierModels/AIProviderTierModelsSet.ts

@@ -0,0 +1,21 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SettingTierModels.AIProviderTierModelsSet. Time: 2026-09-24T20:45:07.0633412Z. Hash: 36CBFD4173F84B567EECF7C7C3070762C7A691DAE5FE558E5D9229435C610F84
+/*---------------------------------------------------------------------------------------------
+ *  **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 { TierModels } from '../TierModels';
+
+/**
+ * Event raised when the models a provider offers for Direct's capability tiers have been set - the whole table at once, unset tiers meaning the vendor default from then on.
+ */
+export class AIProviderTierModelsSet {
+
+    /**
+     * The mapping - every tier `NotSet` means the vendor defaults.
+     */
+    @field(TierModels)
+    models!: TierModels;
+}

package/generated/Providers/SettingTierModels/SetAIProviderTierModels.ts

@@ -0,0 +1,85 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SettingTierModels.SetAIProviderTierModels. Time: 2026-09-24T20:45:06.9194159Z. Hash: 535A47DAFA8A2E56A9C179BAF764A7CC14D8A35A8DCCB1CFA3861E1133BB406D
+/*---------------------------------------------------------------------------------------------
+ *  **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 { TierModels } from '../TierModels';
+import { AIProviderTierModelsSet } from './AIProviderTierModelsSet';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Command for setting which concrete models a provider offers for each of Direct's capability tiers (#865) - the translation table every tier-asking agent on that provider resolves through.
+ */
+export interface ISetAIProviderTierModels {
+    
+    /**
+     * The mapping - every tier `NotSet` means "back to the vendor defaults".
+     */
+    models?: TierModels;
+    
+    /**
+     * The provider to set the mapping on - the identity the event's stream is bound to.
+     */
+    provider?: Guid;
+}
+
+
+/**
+ * Command for setting which concrete models a provider offers for each of Direct's capability tiers (#865) - the translation table every tier-asking agent on that provider resolves through.
+ */
+export class SetAIProviderTierModels extends Command<ISetAIProviderTierModels, AIProviderTierModelsSet> implements ISetAIProviderTierModels {
+    readonly route: string = '/api/a-i/providers/setting-tier-models';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('models', TierModels, false),
+        new PropertyDescriptor('provider', Guid, false),
+    ];
+
+    private _models!: TierModels;
+    private _provider!: Guid;
+
+    constructor() {
+        super(AIProviderTierModelsSet, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The mapping - every tier `NotSet` means "back to the vendor defaults".
+     */
+    get models(): TierModels {
+        return this._models;
+    }
+
+    set models(value: TierModels) {
+        this._models = value;
+        this.propertyChanged('models');
+    }
+    /**
+     * The provider to set the mapping on - the identity the event's stream is bound to.
+     */
+    get provider(): Guid {
+        return this._provider;
+    }
+
+    set provider(value: Guid) {
+        this._provider = value;
+        this.propertyChanged('provider');
+    }
+
+    static use(initialValues?: ISetAIProviderTierModels): [SetAIProviderTierModels, SetCommandValues<ISetAIProviderTierModels>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<SetAIProviderTierModels, ISetAIProviderTierModels>(SetAIProviderTierModels, initialValues);
+    }
+}

package/generated/Providers/SettingTierModels/index.ts

@@ -0,0 +1,2 @@
+export * from './AIProviderTierModelsSet';
+export * from './SetAIProviderTierModels';

package/generated/Providers/SettingUsageCapacity/AIProviderUsageCapacitySet.ts

@@ -0,0 +1,20 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SettingUsageCapacity.AIProviderUsageCapacitySet. Time: 2026-09-24T20:45:07.0633412Z. Hash: 8F14277E4BBD76BAFE340B8875BEA3BF7EA21FB2FD1BA326ABD6EDE72E716AD3
+/*---------------------------------------------------------------------------------------------
+ *  **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 configured AI provider's usage capacity ceiling has been set.
+ */
+export class AIProviderUsageCapacitySet {
+
+    /**
+     * The new ceiling, in tokens - zero for no ceiling.
+     */
+    @field(Number)
+    usageCapacity!: number;
+}

package/generated/Providers/SettingUsageCapacity/SetAIProviderUsageCapacity.ts

@@ -0,0 +1,91 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.SettingUsageCapacity.SetAIProviderUsageCapacity. Time: 2026-09-24T20:45:06.9194159Z. Hash: 864F5156431ED611E6781370D982B72BA47F87155ED8264AA514B7C8F7427DF8
+/*---------------------------------------------------------------------------------------------
+ *  **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, CommandValidator } from '@cratis/arc/commands';
+import { useCommand, SetCommandValues, ClearCommandValues } from '@cratis/arc.react/commands';
+import { PropertyDescriptor } from '@cratis/arc/reflection';
+import { AIProviderUsageCapacitySet } from './AIProviderUsageCapacitySet';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Command for bounding how many tokens a configured AI provider may consume within its usage-reporting window - vendor APIs report consumption, not allowance, so this is what turns a vendor-reported (or, absent a usage credential, locally-burnt) number into "how much room is left", which capacity-aware pool selection ranks members by (issue #1061). Zero means no ceiling, which is what a provider starts with - a provider without one configured simply falls back to the existing least-burnt ranking.
+ */
+export interface ISetAIProviderUsageCapacity {
+    
+    /**
+     * The provider to bound.
+     */
+    provider?: Guid;
+    
+    /**
+     * How many tokens it may consume within its usage window - zero for no ceiling.
+     */
+    usageCapacity?: number;
+}
+
+export class SetAIProviderUsageCapacityValidator extends CommandValidator<ISetAIProviderUsageCapacity> {
+    constructor() {
+        super();
+        this.ruleFor(c => c.usageCapacity).greaterThanOrEqual(0).withMessage('A usage capacity cannot be negative - use zero for no ceiling');
+    }
+}
+
+/**
+ * Command for bounding how many tokens a configured AI provider may consume within its usage-reporting window - vendor APIs report consumption, not allowance, so this is what turns a vendor-reported (or, absent a usage credential, locally-burnt) number into "how much room is left", which capacity-aware pool selection ranks members by (issue #1061). Zero means no ceiling, which is what a provider starts with - a provider without one configured simply falls back to the existing least-burnt ranking.
+ */
+export class SetAIProviderUsageCapacity extends Command<ISetAIProviderUsageCapacity, AIProviderUsageCapacitySet> implements ISetAIProviderUsageCapacity {
+    readonly route: string = '/api/a-i/providers/setting-usage-capacity';
+    readonly validation: CommandValidator = new SetAIProviderUsageCapacityValidator();
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('provider', Guid, false),
+        new PropertyDescriptor('usageCapacity', Number, false),
+    ];
+
+    private _provider!: Guid;
+    private _usageCapacity!: number;
+
+    constructor() {
+        super(AIProviderUsageCapacitySet, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The provider to bound.
+     */
+    get provider(): Guid {
+        return this._provider;
+    }
+
+    set provider(value: Guid) {
+        this._provider = value;
+        this.propertyChanged('provider');
+    }
+    /**
+     * How many tokens it may consume within its usage window - zero for no ceiling.
+     */
+    get usageCapacity(): number {
+        return this._usageCapacity;
+    }
+
+    set usageCapacity(value: number) {
+        this._usageCapacity = value;
+        this.propertyChanged('usageCapacity');
+    }
+
+    static use(initialValues?: ISetAIProviderUsageCapacity): [SetAIProviderUsageCapacity, SetCommandValues<ISetAIProviderUsageCapacity>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<SetAIProviderUsageCapacity, ISetAIProviderUsageCapacity>(SetAIProviderUsageCapacity, initialValues);
+    }
+}

package/generated/Providers/SettingUsageCapacity/index.ts

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