@vectoriox/iox-ui 5.79.0 → 5.80.0

package/generation-core/index.d.ts

@@ -6504,7 +6504,10 @@ declare function modelCanDo(model: Pick<AiModelEntry, 'capabilities'>, step: AiS
 declare enum AiRefusalCode {
     NotInPlan = "ai.notInPlan",
     OutOfCredits = "ai.outOfCredits",
+    /** A step used more than twice its estimate (a loop), or the build its plan's `aiCreditsPerGeneration`. */
     CapReached = "ai.capReached",
+    /** The build asked for `GENERATION_LIMITS.plans` plans already — build one, change it with a sentence, or start over. */
+    PlansUsed = "ai.plansUsed",
     NotConnected = "ai.notConnected",
     KeyInvalid = "ai.keyInvalid",
     PlanUnknown = "ai.planUnknown"
@@ -6518,7 +6521,9 @@ declare enum AiNextKind {
     /** Open Settings ▸ AI. */
     Settings = "settings",
     /** Try again later, or with less. */
-    Retry = "retry"
+    Retry = "retry",
+    /** Keep the plan there is: build it, or change it with a sentence. */
+    KeepPlan = "keepPlan"
 }
 declare const AI_REFUSAL_NEXT: Readonly<Record<AiRefusalCode, AiNextKind>>;
 interface AiRefusal {
@@ -6528,6 +6533,8 @@ interface AiRefusal {
     remaining?: number;
     /** What the refused call would have cost, about. */
     estimate?: number;
+    /** `PlansUsed`: how many plans one build may ask for. */
+    plans?: number;
     next: {
         kind: AiNextKind;
         href?: string;

package/harness-core/index.d.ts

@@ -2987,7 +2987,9 @@ interface AiGenerationView {
     siteBuildId?: string;
     models: Partial<Record<`${AiStep}`, string>>;
     estimate: number;
-    cap: number;
+    /** The plan's `aiCreditsPerGeneration` for the whole build, or null when it sets none (a step's own ceiling is
+     *  twice that step's estimate — going back and planning again starts a new step). */
+    cap: number | null;
     /** Derived from the ledger — the running credit total. */
     spent: number;
     error?: {
@@ -3009,12 +3011,14 @@ interface GenerationStartRequest {
     }>;
     addresses?: string[];
 }
-/** The longest message, the most files and addresses a generation starts from (Start's limits). */
+/** The longest message, the most files and addresses a generation starts from (Start's limits), and how many plans
+ *  one build may ask for (a Design pick, a Try again or "Build with these" each asks one). */
 declare const GENERATION_LIMITS: {
     readonly promptChars: 4000;
     readonly files: 12;
     readonly addresses: 3;
     readonly sentenceChars: 500;
+    readonly plans: 5;
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "5.79.0",
+  "version": "5.80.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",

package/src/generation-core/ai-run.ts

@@ -177,7 +177,10 @@ export function modelCanDo(model: Pick<AiModelEntry, 'capabilities'>, step: AiSt
 export enum AiRefusalCode {
     NotInPlan = 'ai.notInPlan',
     OutOfCredits = 'ai.outOfCredits',
+    /** A step used more than twice its estimate (a loop), or the build its plan's `aiCreditsPerGeneration`. */
     CapReached = 'ai.capReached',
+    /** The build asked for `GENERATION_LIMITS.plans` plans already — build one, change it with a sentence, or start over. */
+    PlansUsed = 'ai.plansUsed',
     NotConnected = 'ai.notConnected',
     KeyInvalid = 'ai.keyInvalid',
     PlanUnknown = 'ai.planUnknown',
@@ -188,6 +191,7 @@ export const AI_REFUSAL_STATUS: Readonly<Record<AiRefusalCode, number>> = {
     [AiRefusalCode.NotInPlan]: 403,
     [AiRefusalCode.OutOfCredits]: 402,
     [AiRefusalCode.CapReached]: 402,
+    [AiRefusalCode.PlansUsed]: 409,
     [AiRefusalCode.NotConnected]: 409,
     [AiRefusalCode.KeyInvalid]: 409,
     [AiRefusalCode.PlanUnknown]: 503,
@@ -201,12 +205,15 @@ export enum AiNextKind {
     Settings = 'settings',
     /** Try again later, or with less. */
     Retry = 'retry',
+    /** Keep the plan there is: build it, or change it with a sentence. */
+    KeepPlan = 'keepPlan',
 }
 
 export const AI_REFUSAL_NEXT: Readonly<Record<AiRefusalCode, AiNextKind>> = {
     [AiRefusalCode.NotInPlan]: AiNextKind.Contact,
     [AiRefusalCode.OutOfCredits]: AiNextKind.Contact,
     [AiRefusalCode.CapReached]: AiNextKind.Retry,
+    [AiRefusalCode.PlansUsed]: AiNextKind.KeepPlan,
     [AiRefusalCode.NotConnected]: AiNextKind.Settings,
     [AiRefusalCode.KeyInvalid]: AiNextKind.Settings,
     [AiRefusalCode.PlanUnknown]: AiNextKind.Retry,
@@ -219,6 +226,8 @@ export interface AiRefusal {
     remaining?: number;
     /** What the refused call would have cost, about. */
     estimate?: number;
+    /** `PlansUsed`: how many plans one build may ask for. */
+    plans?: number;
     next: { kind: AiNextKind; href?: string };
 }
 

package/src/harness-core/generation-view.ts

@@ -95,7 +95,9 @@ export interface AiGenerationView {
     siteBuildId?: string;
     models: Partial<Record<`${AiStep}`, string>>;
     estimate: number;
-    cap: number;
+    /** The plan's `aiCreditsPerGeneration` for the whole build, or null when it sets none (a step's own ceiling is
+     *  twice that step's estimate — going back and planning again starts a new step). */
+    cap: number | null;
     /** Derived from the ledger — the running credit total. */
     spent: number;
     error?: { code: string; detail: string; providerMessage?: string; issues?: Array<{ code: string; path: string }> };
@@ -108,10 +110,12 @@ export interface GenerationStartRequest {
     addresses?: string[];
 }
 
-/** The longest message, the most files and addresses a generation starts from (Start's limits). */
+/** The longest message, the most files and addresses a generation starts from (Start's limits), and how many plans
+ *  one build may ask for (a Design pick, a Try again or "Build with these" each asks one). */
 export const GENERATION_LIMITS = {
     promptChars: 4_000,
     files: 12,
     addresses: 3,
     sentenceChars: 500,
+    plans: 5,
 } as const;