@cratis/ai 5.0.0 → 6.1.0

package/generated/Providers/Copilot/EndCopilotSignIn.ts

@@ -0,0 +1,101 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Copilot.EndCopilotSignIn. Time: 2026-09-24T21:15:04.2155460Z. Hash: 4A69DEBE1CBD722CA4584A391760BEAB85C1542C981F49B5D86B47D74C92BF30
+/*---------------------------------------------------------------------------------------------
+ *  **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 Copilot sign-in, however it turned out.
+ */
+export interface IEndCopilotSignIn {
+    
+    /**
+     * 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 Copilot sign-in, however it turned out.
+ */
+export class EndCopilotSignIn extends Command<IEndCopilotSignIn, Record<string, unknown>> implements IEndCopilotSignIn {
+    readonly route: string = '/api/a-i/providers/copilot/end-copilot-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?: IEndCopilotSignIn): [EndCopilotSignIn, SetCommandValues<IEndCopilotSignIn>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<EndCopilotSignIn, IEndCopilotSignIn>(EndCopilotSignIn, initialValues);
+    }
+}

package/generated/Providers/Copilot/ReconfigureCopilotProvider.ts

@@ -0,0 +1,84 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Copilot.ReconfigureCopilotProvider. Time: 2026-09-24T21:15:04.2155460Z. Hash: 567C54474B1C9865312B0BCAD69EB7844187C02D981350BFF464154EC0E2444D
+/*---------------------------------------------------------------------------------------------
+ *  **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 { CopilotProviderConnected } from './CopilotProviderConnected';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Sets a Copilot provider's credential from a GitHub token somebody already holds - the path for a deployment that has no OAuth app to run a device flow through, and for a machine account whose token is managed elsewhere.
+ */
+export interface IReconfigureCopilotProvider {
+    
+    /**
+     * The GitHub token the Copilot CLI will authenticate with.
+     */
+    apiKey?: string;
+    
+    /**
+     * The provider being configured.
+     */
+    provider?: Guid;
+}
+
+
+/**
+ * Sets a Copilot provider's credential from a GitHub token somebody already holds - the path for a deployment that has no OAuth app to run a device flow through, and for a machine account whose token is managed elsewhere.
+ */
+export class ReconfigureCopilotProvider extends Command<IReconfigureCopilotProvider, CopilotProviderConnected> implements IReconfigureCopilotProvider {
+    readonly route: string = '/api/a-i/providers/copilot/reconfigure-copilot-provider';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('apiKey', String, false),
+        new PropertyDescriptor('provider', Guid, false),
+    ];
+
+    private _apiKey!: string;
+    private _provider!: Guid;
+
+    constructor() {
+        super(CopilotProviderConnected, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The GitHub token the Copilot CLI will authenticate with.
+     */
+    get apiKey(): string {
+        return this._apiKey;
+    }
+
+    set apiKey(value: string) {
+        this._apiKey = value;
+        this.propertyChanged('apiKey');
+    }
+    /**
+     * The provider being configured.
+     */
+    get provider(): Guid {
+        return this._provider;
+    }
+
+    set provider(value: Guid) {
+        this._provider = value;
+        this.propertyChanged('provider');
+    }
+
+    static use(initialValues?: IReconfigureCopilotProvider): [ReconfigureCopilotProvider, SetCommandValues<IReconfigureCopilotProvider>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<ReconfigureCopilotProvider, IReconfigureCopilotProvider>(ReconfigureCopilotProvider, initialValues);
+    }
+}

package/generated/Providers/Copilot/StartCopilotSignIn.ts

@@ -0,0 +1,66 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Copilot.StartCopilotSignIn. Time: 2026-09-24T21:15:04.2155460Z. Hash: 86C9BABF6C16CF7030386AD7F0410FE96A15A727B754F30B75EF22F78C785F00
+/*---------------------------------------------------------------------------------------------
+ *  **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 { CopilotSignInStarted } from './CopilotSignInStarted';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Command for signing a Copilot provider in to a GitHub account, using GitHub's device flow. The same reasoning `StartOpenAISubscriptionSignIn` is built on applies here: nobody should have to mint a token somewhere else and paste it into a field labelled "API key" to connect a subscription. Device flow is the flow designed for this - the server has no browser, so a person authorizes from any browser they do have. Pasting a token stays available for deployments with no OAuth app of their own ({@link ReconfigureCopilotProvider}), but it is not the front door.
+ */
+export interface IStartCopilotSignIn {
+    
+    /**
+     * The provider being signed in.
+     */
+    provider?: Guid;
+}
+
+
+/**
+ * Command for signing a Copilot provider in to a GitHub account, using GitHub's device flow. The same reasoning `StartOpenAISubscriptionSignIn` is built on applies here: nobody should have to mint a token somewhere else and paste it into a field labelled "API key" to connect a subscription. Device flow is the flow designed for this - the server has no browser, so a person authorizes from any browser they do have. Pasting a token stays available for deployments with no OAuth app of their own ({@link ReconfigureCopilotProvider}), but it is not the front door.
+ */
+export class StartCopilotSignIn extends Command<IStartCopilotSignIn, CopilotSignInStarted> implements IStartCopilotSignIn {
+    readonly route: string = '/api/a-i/providers/copilot/start-copilot-sign-in';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('provider', Guid, false),
+    ];
+
+    private _provider!: Guid;
+
+    constructor() {
+        super(CopilotSignInStarted, 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?: IStartCopilotSignIn): [StartCopilotSignIn, SetCommandValues<IStartCopilotSignIn>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<StartCopilotSignIn, IStartCopilotSignIn>(StartCopilotSignIn, initialValues);
+    }
+}

package/generated/Providers/Copilot/index.ts

@@ -0,0 +1,8 @@
+export * from './AddCopilotProvider';
+export * from './CopilotProviderConnected';
+export * from './CopilotProviderDisconnected';
+export * from './CopilotSignInStarted';
+export * from './DisconnectCopilotProvider';
+export * from './EndCopilotSignIn';
+export * from './ReconfigureCopilotProvider';
+export * from './StartCopilotSignIn';

package/generated/Providers/Listing/AIProvider.ts

@@ -0,0 +1,95 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Listing.AIProvider. Time: 2026-09-24T21:15:04.3779775Z. Hash: 765317E802DBDEB4A036F2FBADB638EB1FF27C95AE66CBEB5DDEE2DAB96F4EC7
+/*---------------------------------------------------------------------------------------------
+ *  **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';
+import { AIProviderType } from '../AIProviderType';
+import { TierModels } from '../TierModels';
+
+/**
+ * Read model for listing configured AI providers - what the client-facing table and every provider-picking dropdown bind to. Deliberately carries no API key: see `ConfiguredAIProvider` for the credential-bearing counterpart, resolved server-side only. {@link Endpoint} auto-populates from whichever vendor's Added event carries one (Azure OpenAI, OpenAI-compatible, Z.ai) and stays unset for the others.
+ */
+export class AIProvider {
+
+    /**
+     * The provider's identity.
+     */
+    @field(Guid)
+    id!: Guid;
+
+    /**
+     * The provider's display name.
+     */
+    @field(String)
+    name!: string;
+
+    /**
+     * Which vendor this provider talks to.
+     */
+    @field(Number)
+    type!: AIProviderType;
+
+    /**
+     * The endpoint this provider is reached at, for the vendors that need one.
+     */
+    @field(String)
+    endpoint?: string;
+
+    /**
+     * How many units of work may run on this provider at once - zero for no limit. Set at creation from the vendor's Added event, and overridable afterwards via {@link AIProviderConcurrencySet}.
+     */
+    @field(Number)
+    maxConcurrentJobs?: number;
+
+    /**
+     * Whether this provider is on a ChatGPT subscription rather than a metered API key - which decides where it can be spent, and is not otherwise visible without the credential this model deliberately does not carry.
+     */
+    @field(Boolean)
+    isSubscription!: boolean;
+
+    /**
+     * When the subscription's current access token runs out. Direct refreshes it before dispatch, so this moving forward is the sign the credential is healthy - and it standing still is the sign it is not.
+     */
+    @field(Date)
+    subscriptionExpiresAt?: Date;
+
+    /**
+     * Which concrete models this provider offers for each capability tier - `null` until configured, and unset tiers derived from the catalog the provider published (#865, #1187).
+     */
+    @field(TierModels)
+    tierModels?: TierModels;
+
+    /**
+     * How many tokens this provider may consume within its usage-reporting window - `null` until configured (issue #1061).
+     */
+    @field(Number)
+    usageCapacity?: number;
+
+    /**
+     * When this provider last published its model catalog - `null` when it never has (#1187).
+     */
+    @field(Date)
+    modelsDiscoveredAt?: Date;
+
+    /**
+     * Why the catalog could not be read last time it was asked - an empty string when it could.
+     */
+    @field(String)
+    modelDiscoveryFailure!: string;
+
+    /**
+     * Whether a usage-reporting Admin API key is configured. Carried so the credentials dialog can say which of the two keys is actually set without this model ever holding either of them.
+     */
+    @field(Boolean)
+    hasUsageCredential!: boolean;
+
+    /**
+     * When the vendor is worth trying again after it turned calls away over its own limits - `null` when it never has. Carried here, not only on `ConfiguredAIProvider`, because a provider the vendor is currently refusing looks identical to a healthy idle one on the settings page, and that is exactly the state somebody needs to see.
+     */
+    @field(Date)
+    rateLimitedUntil?: Date;
+}

package/generated/Providers/Listing/AllAIProviders.ts

@@ -0,0 +1,82 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Listing.AIProvider. Time: 2026-09-24T21:15:04.3142918Z. Hash: B24347679567A3F68022B50D7C71A752CEFDF3FBFA4208D44301CC570BC0AFAD
+/*---------------------------------------------------------------------------------------------
+ *  **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 { AIProvider } from './AIProvider';
+
+class AllAIProvidersSortBy {
+
+    constructor(readonly query: AllAIProviders) {
+    }
+
+}
+
+class AllAIProvidersSortByWithoutQuery {
+
+}
+
+
+/**
+ * Observes every configured AI provider.
+ */
+export class AllAIProviders extends ObservableQueryFor<AIProvider[]> {
+    readonly route: string = '/api/a-i/providers/listing/all-a-i-providers';
+    readonly queryName: string = 'Cratis.AI.Providers.Listing.AIProvider.AllAIProviders';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly defaultValue: AIProvider[] = [];
+    private readonly _sortBy: AllAIProvidersSortBy;
+    private static readonly _sortBy: AllAIProvidersSortByWithoutQuery = new AllAIProvidersSortByWithoutQuery();
+
+    constructor() {
+        super(AIProvider, true);
+        this._sortBy = new AllAIProvidersSortBy(this);
+    }
+
+    get requiredRequestParameters(): string[] {
+        return [
+        ];
+    }
+
+    readonly parameterDescriptors: ParameterDescriptor[] = [
+    ];
+
+
+    get sortBy(): AllAIProvidersSortBy {
+        return this._sortBy;
+    }
+
+    static get sortBy(): AllAIProvidersSortByWithoutQuery {
+        return this._sortBy;
+    }
+
+    static use(sorting?: Sorting): [QueryResultWithState<AIProvider[]>, SetSorting] {
+        return useObservableQuery<AIProvider[], AllAIProviders>(AllAIProviders, undefined, sorting);
+    }
+
+    static useWithPaging(pageSize: number, sorting?: Sorting): [QueryResultWithState<AIProvider[]>, SetSorting, SetPage, SetPageSize] {
+        return useObservableQueryWithPaging<AIProvider[], AllAIProviders>(AllAIProviders, new Paging(0, pageSize), undefined, sorting);
+    }
+
+    static useSuspense(sorting?: Sorting): [QueryResultWithState<AIProvider[]>, SetSorting] {
+        return useSuspenseObservableQuery<AIProvider[], AllAIProviders>(AllAIProviders, undefined, sorting);
+    }
+
+    static useSuspenseWithPaging(pageSize: number, sorting?: Sorting): [QueryResultWithState<AIProvider[]>, SetSorting, SetPage, SetPageSize] {
+        return useSuspenseObservableQueryWithPaging<AIProvider[], AllAIProviders>(AllAIProviders, new Paging(0, pageSize), undefined, sorting);
+    }
+
+    static useChangeStream(getKey?: (item: AIProvider) => unknown, sorting?: Sorting): ChangeSet<AIProvider> {
+        return useChangeStream<AIProvider, AllAIProviders>(AllAIProviders, undefined, getKey, sorting);
+    }
+
+    static when(condition: boolean): ObservableQueryWhen<AllAIProviders, AIProvider[]> {
+        return new ObservableQueryWhen<AllAIProviders, AIProvider[]>(AllAIProviders, condition);
+    }
+}

package/generated/Providers/Listing/index.ts

@@ -0,0 +1,2 @@
+export * from './AIProvider';
+export * from './AllAIProviders';

package/generated/Providers/ModelTier.ts

@@ -0,0 +1,15 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.ModelTier. Time: 2026-09-24T21:15:04.3905175Z. Hash: C93146742348C857236E033F368C78110CD5A24CC639F3CD652F97E4EE186BA1
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+// eslint-disable-next-line header/header
+/**
+ * The capability tier a completion or worker session asks an AI provider for - the vendor-neutral way of saying how much model one wants, translated per provider into the concrete model that vendor offers. Ported from Direct's `AIProviders.ModelTier` (plan Section 5.2 step 1).
+ */
+export enum ModelTier {
+    fast = 0,
+    balanced = 1,
+    powerful = 2,
+    premier = 3,
+}

package/generated/Providers/Pools/AddingProvider/AddProviderToPool.ts

@@ -0,0 +1,84 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Pools.AddingProvider.AddProviderToPool. Time: 2026-09-24T21:15:04.2155460Z. Hash: 70ADB7B2708967047917EBCB71F2158148C9BD9E3C7D3643C3244F6158C29F6B
+/*---------------------------------------------------------------------------------------------
+ *  **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 { ProviderAddedToPool } from './ProviderAddedToPool';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Command for adding a provider to a pool (#871) - the member names a provider and nothing else: which model a completion runs on is decided by the acting agent's capability tier, translated through the member provider's own tier mapping, so a pool stays a set of interchangeable capacities rather than a grid of provider-and-model pairs.
+ */
+export interface IAddProviderToPool {
+    
+    /**
+     * The pool to add to.
+     */
+    pool?: Guid;
+    
+    /**
+     * The provider to add.
+     */
+    provider?: Guid;
+}
+
+
+/**
+ * Command for adding a provider to a pool (#871) - the member names a provider and nothing else: which model a completion runs on is decided by the acting agent's capability tier, translated through the member provider's own tier mapping, so a pool stays a set of interchangeable capacities rather than a grid of provider-and-model pairs.
+ */
+export class AddProviderToPool extends Command<IAddProviderToPool, ProviderAddedToPool> implements IAddProviderToPool {
+    readonly route: string = '/api/a-i/providers/pools/adding-provider';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('pool', Guid, false),
+        new PropertyDescriptor('provider', Guid, false),
+    ];
+
+    private _pool!: Guid;
+    private _provider!: Guid;
+
+    constructor() {
+        super(ProviderAddedToPool, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The pool to add to.
+     */
+    get pool(): Guid {
+        return this._pool;
+    }
+
+    set pool(value: Guid) {
+        this._pool = value;
+        this.propertyChanged('pool');
+    }
+    /**
+     * The provider to add.
+     */
+    get provider(): Guid {
+        return this._provider;
+    }
+
+    set provider(value: Guid) {
+        this._provider = value;
+        this.propertyChanged('provider');
+    }
+
+    static use(initialValues?: IAddProviderToPool): [AddProviderToPool, SetCommandValues<IAddProviderToPool>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<AddProviderToPool, IAddProviderToPool>(AddProviderToPool, initialValues);
+    }
+}

package/generated/Providers/Pools/AddingProvider/ProviderAddedToPool.ts

@@ -0,0 +1,21 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Pools.AddingProvider.ProviderAddedToPool. Time: 2026-09-24T21:15:04.3779775Z. Hash: DB1575F6402017867366E9779340BA788C59C46B8C18373198DCA02D25F5E2DF
+/*---------------------------------------------------------------------------------------------
+ *  **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';
+
+/**
+ * Event raised when a provider has been added to a pool.
+ */
+export class ProviderAddedToPool {
+
+    /**
+     * The provider that was added.
+     */
+    @field(Guid)
+    provider!: Guid;
+}

package/generated/Providers/Pools/AddingProvider/index.ts

@@ -0,0 +1,2 @@
+export * from './AddProviderToPool';
+export * from './ProviderAddedToPool';

package/generated/Providers/Pools/Creating/CreateAIProviderPool.ts

@@ -0,0 +1,65 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Pools.Creating.CreateAIProviderPool. Time: 2026-09-24T21:15:04.2155460Z. Hash: BAF101F9790EB9292D45B7C1C32FB9BD4415FC0E8013A58569CF13724E3AB7F8
+/*---------------------------------------------------------------------------------------------
+ *  **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 creating an AI provider pool - a named group of providers a role can draw from instead of naming a single provider, so a burst of reasoning work spreads across several accounts/vendors rather than burning one.
+ */
+export interface ICreateAIProviderPool {
+    
+    /**
+     * The pool's display name.
+     */
+    name?: string;
+}
+
+
+/**
+ * Command for creating an AI provider pool - a named group of providers a role can draw from instead of naming a single provider, so a burst of reasoning work spreads across several accounts/vendors rather than burning one.
+ */
+export class CreateAIProviderPool extends Command<ICreateAIProviderPool, Guid> implements ICreateAIProviderPool {
+    readonly route: string = '/api/a-i/providers/pools/creating';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('name', String, false),
+    ];
+
+    private _name!: string;
+
+    constructor() {
+        super(Guid, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The pool's display name.
+     */
+    get name(): string {
+        return this._name;
+    }
+
+    set name(value: string) {
+        this._name = value;
+        this.propertyChanged('name');
+    }
+
+    static use(initialValues?: ICreateAIProviderPool): [CreateAIProviderPool, SetCommandValues<ICreateAIProviderPool>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<CreateAIProviderPool, ICreateAIProviderPool>(CreateAIProviderPool, initialValues);
+    }
+}

package/generated/Providers/Pools/Creating/index.ts

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

package/generated/Providers/Pools/Listing/AIProviderPool.ts

@@ -0,0 +1,34 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Pools.Listing.AIProviderPool. Time: 2026-09-24T21:15:04.3779775Z. Hash: 8AEE5392D0E349CBD793D4FAC5647F773B92342FD58228EE20CDEDEB2C175274
+/*---------------------------------------------------------------------------------------------
+ *  **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';
+import { AIProviderPoolMember } from './AIProviderPoolMember';
+
+/**
+ * Read model for listing AI provider pools and their members. Carries no credentials - members reference providers by id, and the credential-bearing side stays behind `ConfiguredAIProvider`'s no-query wall.
+ */
+export class AIProviderPool {
+
+    /**
+     * The pool's identity.
+     */
+    @field(Guid)
+    id!: Guid;
+
+    /**
+     * The pool's display name.
+     */
+    @field(String)
+    name!: string;
+
+    /**
+     * The providers in the pool - each a bare provider reference, the acting agent's tier deciding the model on it.
+     */
+    @field(AIProviderPoolMember, true)
+    members?: AIProviderPoolMember[];
+}