@cratis/ai 5.0.0 → 6.1.0

package/generated/Agents/Skills/Removing/RemoveAgentSkill.ts

@@ -0,0 +1,84 @@
+// @generated by Cratis. Source: Cratis.AI.Agents.Skills.Removing.RemoveAgentSkill. Time: 2026-09-24T21:15:04.2155460Z. Hash: FECD77BB5BE1DDAA5529BD7A965F86C61CB1786304090A9E13B111ADADE63960
+/*---------------------------------------------------------------------------------------------
+ *  **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 { AgentSkillRemoved } from './AgentSkillRemoved';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * Command for removing a skill from an agent.
+ */
+export interface IRemoveAgentSkill {
+    
+    /**
+     * The agent the skill belongs to.
+     */
+    id?: string;
+    
+    /**
+     * The skill to remove.
+     */
+    skill?: Guid;
+}
+
+
+/**
+ * Command for removing a skill from an agent.
+ */
+export class RemoveAgentSkill extends Command<IRemoveAgentSkill, AgentSkillRemoved> implements IRemoveAgentSkill {
+    readonly route: string = '/api/a-i/agents/skills/removing';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('id', String, false),
+        new PropertyDescriptor('skill', Guid, false),
+    ];
+
+    private _id!: string;
+    private _skill!: Guid;
+
+    constructor() {
+        super(AgentSkillRemoved, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The agent the skill belongs to.
+     */
+    get id(): string {
+        return this._id;
+    }
+
+    set id(value: string) {
+        this._id = value;
+        this.propertyChanged('id');
+    }
+    /**
+     * The skill to remove.
+     */
+    get skill(): Guid {
+        return this._skill;
+    }
+
+    set skill(value: Guid) {
+        this._skill = value;
+        this.propertyChanged('skill');
+    }
+
+    static use(initialValues?: IRemoveAgentSkill): [RemoveAgentSkill, SetCommandValues<IRemoveAgentSkill>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<RemoveAgentSkill, IRemoveAgentSkill>(RemoveAgentSkill, initialValues);
+    }
+}

package/generated/Agents/Skills/Removing/index.ts

@@ -0,0 +1,2 @@
+export * from './AgentSkillRemoved';
+export * from './RemoveAgentSkill';

package/generated/Agents/Skills/Updating/UpdateAgentSkill.ts

@@ -0,0 +1,126 @@
+// @generated by Cratis. Source: Cratis.AI.Agents.Skills.Updating.UpdateAgentSkill. Time: 2026-09-24T21:15:04.2155460Z. Hash: D8CBC1313041516642AB0ABEB6E821D8CBDD171C28E49CDCB0EBA935DB9D8736
+/*---------------------------------------------------------------------------------------------
+ *  **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 { Guid } from '@cratis/fundamentals';
+
+/**
+ * Command for changing a skill on an agent - its name, its content, or both.
+ */
+export interface IUpdateAgentSkill {
+    
+    /**
+     * What the skill teaches, in markdown.
+     */
+    content?: string;
+    
+    /**
+     * The agent the skill belongs to.
+     */
+    id?: string;
+    
+    /**
+     * The skill's name.
+     */
+    name?: string;
+    
+    /**
+     * The skill to change.
+     */
+    skill?: Guid;
+}
+
+export class UpdateAgentSkillValidator extends CommandValidator<IUpdateAgentSkill> {
+    constructor() {
+        super();
+        this.ruleFor(c => c.content).maxLength(20000).withMessage('A skill\'s content can hold at most 20000 characters');
+    }
+}
+
+/**
+ * Command for changing a skill on an agent - its name, its content, or both.
+ */
+export class UpdateAgentSkill extends Command<IUpdateAgentSkill, Record<string, unknown>> implements IUpdateAgentSkill {
+    readonly route: string = '/api/a-i/agents/skills/updating';
+    readonly validation: CommandValidator = new UpdateAgentSkillValidator();
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('content', String, false),
+        new PropertyDescriptor('id', String, false),
+        new PropertyDescriptor('name', String, false),
+        new PropertyDescriptor('skill', Guid, false),
+    ];
+
+    private _content!: string;
+    private _id!: string;
+    private _name!: string;
+    private _skill!: Guid;
+
+    constructor() {
+        super(Object, true);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * What the skill teaches, in markdown.
+     */
+    get content(): string {
+        return this._content;
+    }
+
+    set content(value: string) {
+        this._content = value;
+        this.propertyChanged('content');
+    }
+    /**
+     * The agent the skill belongs to.
+     */
+    get id(): string {
+        return this._id;
+    }
+
+    set id(value: string) {
+        this._id = value;
+        this.propertyChanged('id');
+    }
+    /**
+     * The skill's name.
+     */
+    get name(): string {
+        return this._name;
+    }
+
+    set name(value: string) {
+        this._name = value;
+        this.propertyChanged('name');
+    }
+    /**
+     * The skill to change.
+     */
+    get skill(): Guid {
+        return this._skill;
+    }
+
+    set skill(value: Guid) {
+        this._skill = value;
+        this.propertyChanged('skill');
+    }
+
+    static use(initialValues?: IUpdateAgentSkill): [UpdateAgentSkill, SetCommandValues<IUpdateAgentSkill>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<UpdateAgentSkill, IUpdateAgentSkill>(UpdateAgentSkill, initialValues);
+    }
+}

package/generated/Agents/Skills/Updating/index.ts

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

package/generated/Agents/Skills/index.ts

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

package/generated/Agents/index.ts

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

package/generated/Decisions/Adding/AddDecisionEngineProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Decisions.Adding.AddDecisionEngineProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: 0A4D3186F7590ED53E16C5E46BB0283CDB85B25A1AB3F00CF5CF11739C92B3F3
+// @generated by Cratis. Source: Cratis.AI.Decisions.Adding.AddDecisionEngineProvider. Time: 2026-09-24T21:15:04.2155460Z. Hash: 0A4D3186F7590ED53E16C5E46BB0283CDB85B25A1AB3F00CF5CF11739C92B3F3
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Decisions/Reconfiguring/DecisionEngineProviderReconfigured.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Decisions.Reconfiguring.DecisionEngineProviderReconfigured. Time: 2026-09-24T20:06:45.0108829Z. Hash: 16B89A13BDC2D051C4DE18A5E207E3BA37F0CB187E7A5CC3F7D53CEE47D3F8F6
+// @generated by Cratis. Source: Cratis.AI.Decisions.Reconfiguring.DecisionEngineProviderReconfigured. Time: 2026-09-24T21:15:04.3779775Z. Hash: 16B89A13BDC2D051C4DE18A5E207E3BA37F0CB187E7A5CC3F7D53CEE47D3F8F6
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Decisions/Reconfiguring/ReconfigureDecisionEngineProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Decisions.Reconfiguring.ReconfigureDecisionEngineProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: EBB086002B8F8B3BC52ECBD864D68E581B125242A39605BEEA82026113884995
+// @generated by Cratis. Source: Cratis.AI.Decisions.Reconfiguring.ReconfigureDecisionEngineProvider. Time: 2026-09-24T21:15:04.2155460Z. Hash: EBB086002B8F8B3BC52ECBD864D68E581B125242A39605BEEA82026113884995
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Harnesses/Harness.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Harnesses.Harness. Time: 2026-09-24T20:06:45.0214802Z. Hash: B750E8CF1D14A2A26290D35DBCEC16348CE36173B827BFBE54DFFC6F5418D09A
+// @generated by Cratis. Source: Cratis.AI.Harnesses.Harness. Time: 2026-09-24T21:15:04.3905175Z. Hash: B750E8CF1D14A2A26290D35DBCEC16348CE36173B827BFBE54DFFC6F5418D09A
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/AIModelCapability.ts

@@ -0,0 +1,16 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.AIModelCapability. Time: 2026-09-24T21:15:04.3905175Z. Hash: C223C6CD1A528E36C0157B90AA20D3711E7CD003A1B2E6A332F32371AC46BE68
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+// eslint-disable-next-line header/header
+/**
+ * A behavior exposed by an individual language model. Ported from Direct's `AIProviders.AIModelCapability` (plan Section 5.2 step 2).
+ */
+export enum AIModelCapability {
+    conversational = 0,
+    reasoning = 1,
+    toolUse = 2,
+    vision = 3,
+    decision = 4,
+}

package/generated/Providers/AIProviderCapability.ts

@@ -0,0 +1,14 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.AIProviderCapability. Time: 2026-09-24T21:15:04.3905175Z. Hash: 3641C1B7D9209004423BF01969015681F34AA6DB997DE42A74EDF506FCF9066D
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+// eslint-disable-next-line header/header
+/**
+ * A way an AI provider can be used. Ported from Direct's `AIProviders.AIProviderCapability` (plan Section 5.2 step 2).
+ */
+export enum AIProviderCapability {
+    conversational = 0,
+    agentic = 1,
+    decision = 2,
+}

package/generated/Providers/AIProviderType.ts

@@ -0,0 +1,19 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.AIProviderType. Time: 2026-09-24T21:15:04.3905175Z. Hash: 5369392EEAFFBDBAB64ED5601242F7E63989DDB48F32727492F618E6C5178B20
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+// eslint-disable-next-line header/header
+/**
+ * Which vendor a configured AI provider talks to. Ported from Direct's `AIProviders.AIProviderType` (plan Section 5.2 step 1) - already the superset the plan asks the package to own (Section 1's scope table).
+ */
+export enum AIProviderType {
+    anthropic = 0,
+    openAI = 1,
+    azureOpenAI = 2,
+    openAICompatible = 3,
+    ZAI = 4,
+    openAICodex = 5,
+    decisionEngine = 6,
+    copilot = 7,
+}

package/generated/Providers/Adding/AddAnthropicProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Adding.AddAnthropicProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: 21AA5E59F49E19CD59F34D5A0375D1A693B8FB275BCF06BD2B2F77157F2FEE10
+// @generated by Cratis. Source: Cratis.AI.Providers.Adding.AddAnthropicProvider. Time: 2026-09-24T21:15:04.2155460Z. Hash: 21AA5E59F49E19CD59F34D5A0375D1A693B8FB275BCF06BD2B2F77157F2FEE10
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Adding/AddAzureOpenAIProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Adding.AddAzureOpenAIProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: A27E326198BFC90872E61300D2494450CE3FB921477188F0EFD0368813387A8C
+// @generated by Cratis. Source: Cratis.AI.Providers.Adding.AddAzureOpenAIProvider. Time: 2026-09-24T21:15:04.2155460Z. Hash: A27E326198BFC90872E61300D2494450CE3FB921477188F0EFD0368813387A8C
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Adding/AddOpenAICompatibleProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Adding.AddOpenAICompatibleProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: D971DCDC59215AA87BDC6CBB0505C8847C16E4748EC20FD0F46AAE473EF20B8C
+// @generated by Cratis. Source: Cratis.AI.Providers.Adding.AddOpenAICompatibleProvider. Time: 2026-09-24T21:15:04.2155460Z. Hash: D971DCDC59215AA87BDC6CBB0505C8847C16E4748EC20FD0F46AAE473EF20B8C
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Adding/AddOpenAIProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Adding.AddOpenAIProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: 5B29A32955557EC709EC2FDFA77F01DDAA837E0D151A0FC999C712904AC771BF
+// @generated by Cratis. Source: Cratis.AI.Providers.Adding.AddOpenAIProvider. Time: 2026-09-24T21:15:04.2155460Z. Hash: 5B29A32955557EC709EC2FDFA77F01DDAA837E0D151A0FC999C712904AC771BF
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/Adding/AddZAIProvider.ts

@@ -1,4 +1,4 @@
-// @generated by Cratis. Source: Cratis.AI.Providers.Adding.AddZAIProvider. Time: 2026-09-24T20:06:44.9231420Z. Hash: 06FBD795E3651AF33623DBF53D1EA56073428F79FABA05A651CB734CF2C90E8D
+// @generated by Cratis. Source: Cratis.AI.Providers.Adding.AddZAIProvider. Time: 2026-09-24T21:15:04.2155460Z. Hash: 06FBD795E3651AF33623DBF53D1EA56073428F79FABA05A651CB734CF2C90E8D
 /*---------------------------------------------------------------------------------------------
  *  **DO NOT EDIT** - This file is an automatically generated file.
  *--------------------------------------------------------------------------------------------*/

package/generated/Providers/AvailableModels/AvailableAIModelDiscovery.ts

@@ -0,0 +1,51 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.AvailableModels.AvailableAIModelDiscovery. Time: 2026-09-24T21:15:04.3779775Z. Hash: 6F53F47A78829634580A3396D2FAB1EEBCF9656D5BD20C13C98F158C49F1436D
+/*---------------------------------------------------------------------------------------------
+ *  **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 { AIModelCapability } from '../AIModelCapability';
+
+/**
+ * One row in the discovered catalog, enriched with what Direct knows about the model - what the model pickers in Settings bind to. `[Passive]`, so it is computed on demand from the provider's own events rather than materialized - which is what makes it strongly consistent by key. A refresh appends its event and the next read sees it, with no projection to be behind: the reason the dialog used to need a cache invalidation dance and still showed a stale answer. A sentinel row carries the reason discovery failed, which is what keeps "this provider serves no models" and "nobody could ask" apart on a surface that would otherwise render both as an empty list.
+ */
+export class AvailableAIModelDiscovery {
+
+    /**
+     * The exact model id, or {@link NotSet} for a sentinel row.
+     */
+    @field(String)
+    id!: string;
+
+    /**
+     * The friendly model name.
+     */
+    @field(String)
+    displayName!: string;
+
+    /**
+     * Known model capabilities.
+     */
+    @field(Number, true)
+    capabilities!: AIModelCapability[];
+
+    /**
+     * Whether this row describes a model.
+     */
+    @field(Boolean)
+    hasModel!: boolean;
+
+    /**
+     * Why the catalog could not be read, or an empty string when it was.
+     */
+    @field(String)
+    failure!: string;
+
+    /**
+     * When the provider was last asked - the default when it never has been.
+     */
+    @field(Date)
+    discoveredAt!: Date;
+}

package/generated/Providers/AvailableModels/DiscoverModelsFor.ts

@@ -0,0 +1,102 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.AvailableModels.AvailableAIModelDiscovery. Time: 2026-09-24T21:15:04.3076891Z. Hash: F566D0E62146F131AA65C2DD81C69BD27EC7E901F1BAAF6A7E046837D43250FD
+/*---------------------------------------------------------------------------------------------
+ *  **DO NOT EDIT** - This file is an automatically generated file.
+ *--------------------------------------------------------------------------------------------*/
+
+/* eslint-disable sort-imports */
+// eslint-disable-next-line header/header
+import { QueryFor, QueryResultWithState, Sorting, SortingActions, SortingActionsForQuery, 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 { Guid } from '@cratis/fundamentals';
+import { AvailableAIModelDiscovery } from './AvailableAIModelDiscovery';
+
+class DiscoverModelsForSortBy {
+    private _providerId: SortingActionsForQuery<AvailableAIModelDiscovery[]>;
+
+    constructor(readonly query: DiscoverModelsFor) {
+        this._providerId = new SortingActionsForQuery<AvailableAIModelDiscovery[]>('providerId', query);
+    }
+
+    get providerId(): SortingActionsForQuery<AvailableAIModelDiscovery[]> {
+        return this._providerId;
+    }
+}
+
+class DiscoverModelsForSortByWithoutQuery {
+    private _providerId: SortingActions  = new SortingActions('providerId');
+
+    get providerId(): SortingActions {
+        return this._providerId;
+    }
+}
+
+/**
+ * Gets the catalog a provider published at its last discovery.
+ */
+export interface DiscoverModelsForParameters {
+    
+    /**
+     * The provider whose catalog to read.
+    */
+    providerId: Guid;
+}
+
+
+/**
+ * Gets the catalog a provider published at its last discovery.
+ */
+export class DiscoverModelsFor extends QueryFor<AvailableAIModelDiscovery[], DiscoverModelsForParameters> {
+    readonly route: string = '/api/a-i/providers/available-models/discover-models-for';
+    readonly queryName: string = 'Cratis.AI.Providers.AvailableModels.AvailableAIModelDiscovery.DiscoverModelsFor';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly defaultValue: AvailableAIModelDiscovery[] = [];
+    private readonly _sortBy: DiscoverModelsForSortBy;
+    private static readonly _sortBy: DiscoverModelsForSortByWithoutQuery = new DiscoverModelsForSortByWithoutQuery();
+
+    constructor() {
+        super(AvailableAIModelDiscovery, true);
+        this._sortBy = new DiscoverModelsForSortBy(this);
+    }
+
+    get requiredRequestParameters(): string[] {
+        return [
+            'providerId',
+        ];
+    }
+
+    readonly parameterDescriptors: ParameterDescriptor[] = [
+        new ParameterDescriptor('providerId', Guid, false),
+    ];
+
+    providerId!: Guid;
+
+    get sortBy(): DiscoverModelsForSortBy {
+        return this._sortBy;
+    }
+
+    static get sortBy(): DiscoverModelsForSortByWithoutQuery {
+        return this._sortBy;
+    }
+
+    static use(args?: DiscoverModelsForParameters, sorting?: Sorting): [QueryResultWithState<AvailableAIModelDiscovery[]>, PerformQuery<DiscoverModelsForParameters>, SetSorting] {
+        return useQuery<AvailableAIModelDiscovery[], DiscoverModelsFor, DiscoverModelsForParameters>(DiscoverModelsFor, args, sorting);
+    }
+
+    static useWithPaging(pageSize: number, args?: DiscoverModelsForParameters, sorting?: Sorting): [QueryResultWithState<AvailableAIModelDiscovery[]>, PerformQuery, SetSorting, SetPage, SetPageSize] {
+        return useQueryWithPaging<AvailableAIModelDiscovery[], DiscoverModelsFor>(DiscoverModelsFor, new Paging(0, pageSize), args, sorting);
+    }
+
+    static useSuspense(args?: DiscoverModelsForParameters, sorting?: Sorting): [QueryResultWithState<AvailableAIModelDiscovery[]>, PerformQuery<DiscoverModelsForParameters>, SetSorting] {
+        return useSuspenseQuery<AvailableAIModelDiscovery[], DiscoverModelsFor, DiscoverModelsForParameters>(DiscoverModelsFor, args, sorting);
+    }
+
+    static useSuspenseWithPaging(pageSize: number, args?: DiscoverModelsForParameters, sorting?: Sorting): [QueryResultWithState<AvailableAIModelDiscovery[]>, PerformQuery, SetSorting, SetPage, SetPageSize] {
+        return useSuspenseQueryWithPaging<AvailableAIModelDiscovery[], DiscoverModelsFor>(DiscoverModelsFor, new Paging(0, pageSize), args, sorting);
+    }
+
+    static when(condition: boolean): QueryWhen<DiscoverModelsFor, AvailableAIModelDiscovery[], DiscoverModelsForParameters> {
+        return new QueryWhen<DiscoverModelsFor, AvailableAIModelDiscovery[], DiscoverModelsForParameters>(DiscoverModelsFor, condition);
+    }
+}

package/generated/Providers/AvailableModels/RefreshAvailableModels.ts

@@ -0,0 +1,65 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.AvailableModels.RefreshAvailableModels. Time: 2026-09-24T21:15:04.2155460Z. Hash: 0BECACA1D4B857C570B09FE906711B7D6876D0D0AF5D75BA6389060955DF0505
+/*---------------------------------------------------------------------------------------------
+ *  **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 asking a provider which models it currently serves and recording the answer (#1187).
+ */
+export interface IRefreshAvailableModels {
+    
+    /**
+     * The provider to ask - the identity the events' stream is bound to.
+     */
+    provider?: Guid;
+}
+
+
+/**
+ * Command for asking a provider which models it currently serves and recording the answer (#1187).
+ */
+export class RefreshAvailableModels extends Command<IRefreshAvailableModels, Record<string, unknown>> implements IRefreshAvailableModels {
+    readonly route: string = '/api/a-i/providers/available-models';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('provider', Guid, false),
+    ];
+
+    private _provider!: Guid;
+
+    constructor() {
+        super(Object, true);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The provider to ask - the identity the events' stream is bound to.
+     */
+    get provider(): Guid {
+        return this._provider;
+    }
+
+    set provider(value: Guid) {
+        this._provider = value;
+        this.propertyChanged('provider');
+    }
+
+    static use(initialValues?: IRefreshAvailableModels): [RefreshAvailableModels, SetCommandValues<IRefreshAvailableModels>, ClearCommandValues] {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return useCommand<RefreshAvailableModels, IRefreshAvailableModels>(RefreshAvailableModels, initialValues);
+    }
+}

package/generated/Providers/AvailableModels/index.ts

@@ -0,0 +1,3 @@
+export * from './AvailableAIModelDiscovery';
+export * from './DiscoverModelsFor';
+export * from './RefreshAvailableModels';

package/generated/Providers/Capabilities/AIProviderCapabilityDescription.ts

@@ -0,0 +1,28 @@
+// @generated by Cratis. Source: Cratis.AI.Providers.Capabilities.AIProviderCapabilityDescription. Time: 2026-09-24T21:15:04.3779775Z. Hash: 4B6A48AB819A94004BA675CC7EF219050194A5272C16ACD39E08F1280C0D8CE5
+/*---------------------------------------------------------------------------------------------
+ *  **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 { AIProviderCapability } from '../AIProviderCapability';
+import { AIProviderType } from '../AIProviderType';
+
+/**
+ * Safe, credential-free capability metadata for an AI provider type.
+ */
+export class AIProviderCapabilityDescription {
+
+    /**
+     * The provider type.
+     */
+    @field(Number)
+    type!: AIProviderType;
+
+    /**
+     * The intrinsic capabilities offered by the provider type.
+     */
+    @field(Number, true)
+    capabilities!: AIProviderCapability[];
+}