@nan0web/ui 1.10.0 → 1.12.0

package/types/Model/index.d.ts

@@ -1,64 +1,58 @@
-export { User };
-export const HeaderModel: typeof DomainModels.HeaderModel;
-export const FooterModel: typeof DomainModels.FooterModel;
-export const HeroModel: typeof DomainModels.HeroModel;
-export const ButtonModel: typeof DomainModels.ButtonModel;
-export const ConfirmModel: typeof DomainModels.ConfirmModel;
-export const InputModel: typeof DomainModels.InputModel;
-export const SpinnerModel: typeof DomainModels.SpinnerModel;
-export const TableModel: typeof DomainModels.TableModel;
-export const ToastModel: typeof DomainModels.ToastModel;
-export const SelectModel: typeof DomainModels.SelectModel;
-export const AutocompleteModel: typeof DomainModels.AutocompleteModel;
-export const TreeModel: typeof DomainModels.TreeModel;
-export const TabsModel: typeof DomainModels.TabsModel;
-export const AccordionModel: typeof DomainModels.AccordionModel;
-export const GalleryModel: typeof DomainModels.GalleryModel;
-export const PriceModel: typeof DomainModels.PriceModel;
-export const PricingModel: typeof DomainModels.PricingModel;
-export const CommentModel: typeof DomainModels.CommentModel;
-export const TestimonialModel: typeof DomainModels.TestimonialModel;
-export const StatsItemModel: typeof DomainModels.StatsItemModel;
-export const StatsModel: typeof DomainModels.StatsModel;
-export const TimelineItemModel: typeof DomainModels.TimelineItemModel;
-export const TimelineModel: typeof DomainModels.TimelineModel;
 export default Model;
 import User from './User/User.js';
-import * as DomainModels from '../domain/index.js';
-declare const Model: {
-    SandboxModel: typeof DomainModels.SandboxModel;
-    ShowcaseAppModel: typeof DomainModels.ShowcaseAppModel;
-    Navigation: typeof DomainModels.Navigation;
-    Language: any;
-    HeaderModel: typeof DomainModels.HeaderModel;
-    FooterModel: typeof DomainModels.FooterModel;
-    HeroModel: typeof DomainModels.HeroModel;
-    ButtonModel: typeof DomainModels.ButtonModel;
-    ConfirmModel: typeof DomainModels.ConfirmModel;
-    InputModel: typeof DomainModels.InputModel;
-    SpinnerModel: typeof DomainModels.SpinnerModel;
-    TableModel: typeof DomainModels.TableModel;
-    ToastModel: typeof DomainModels.ToastModel;
-    SelectModel: typeof DomainModels.SelectModel;
-    AutocompleteModel: typeof DomainModels.AutocompleteModel;
-    TreeModel: typeof DomainModels.TreeModel;
-    TabsModel: typeof DomainModels.TabsModel;
-    AccordionModel: typeof DomainModels.AccordionModel;
-    GalleryModel: typeof DomainModels.GalleryModel;
-    PriceModel: typeof DomainModels.PriceModel;
-    PricingModel: typeof DomainModels.PricingModel;
-    CommentModel: typeof DomainModels.CommentModel;
-    TestimonialModel: typeof DomainModels.TestimonialModel;
-    StatsItemModel: typeof DomainModels.StatsItemModel;
-    StatsModel: typeof DomainModels.StatsModel;
-    TimelineItemModel: typeof DomainModels.TimelineItemModel;
-    TimelineModel: typeof DomainModels.TimelineModel;
-    HeaderVisibilityModel: typeof DomainModels.HeaderVisibilityModel;
-    HeaderConfigModel: typeof DomainModels.HeaderConfigModel;
-    FooterVisibilityModel: typeof DomainModels.FooterVisibilityModel;
-    FooterConfigModel: typeof DomainModels.FooterConfigModel;
-    EmptyStateModel: typeof DomainModels.EmptyStateModel;
-    BannerModel: typeof DomainModels.BannerModel;
-    ProfileDropdownModel: typeof DomainModels.ProfileDropdownModel;
-    User: typeof User;
-};
+import { HeaderModel } from '../domain/HeaderModel.js';
+import { FooterModel } from '../domain/FooterModel.js';
+import { HeroModel } from '../domain/HeroModel.js';
+import { ButtonModel } from '../domain/components/index.js';
+import { ConfirmModel } from '../domain/components/index.js';
+import { InputModel } from '../domain/components/index.js';
+import { SpinnerModel } from '../domain/components/index.js';
+import { TableModel } from '../domain/components/index.js';
+import { ToastModel } from '../domain/components/index.js';
+import { SelectModel } from '../domain/components/index.js';
+import { AutocompleteModel } from '../domain/components/index.js';
+import { TreeModel } from '../domain/components/index.js';
+import { TabsModel } from '../domain/components/index.js';
+import { AccordionModel } from '../domain/components/index.js';
+import { GalleryModel } from '../domain/components/index.js';
+import { PriceModel } from '../domain/components/index.js';
+import { PricingModel } from '../domain/components/index.js';
+import { CommentModel } from '../domain/components/index.js';
+import { TestimonialModel } from '../domain/components/index.js';
+import { StatsItemModel } from '../domain/components/index.js';
+import { StatsModel } from '../domain/components/index.js';
+import { TimelineItemModel } from '../domain/components/index.js';
+import { TimelineModel } from '../domain/components/index.js';
+import { EmptyStateModel } from '../domain/components/index.js';
+import { BannerModel } from '../domain/components/index.js';
+import { ProfileDropdownModel } from '../domain/components/index.js';
+declare namespace Model {
+    export { User };
+    export { HeaderModel };
+    export { FooterModel };
+    export { HeroModel };
+    export { ButtonModel };
+    export { ConfirmModel };
+    export { InputModel };
+    export { SpinnerModel };
+    export { TableModel };
+    export { ToastModel };
+    export { SelectModel };
+    export { AutocompleteModel };
+    export { TreeModel };
+    export { TabsModel };
+    export { AccordionModel };
+    export { GalleryModel };
+    export { PriceModel };
+    export { PricingModel };
+    export { CommentModel };
+    export { TestimonialModel };
+    export { StatsItemModel };
+    export { StatsModel };
+    export { TimelineItemModel };
+    export { TimelineModel };
+    export { EmptyStateModel };
+    export { BannerModel };
+    export { ProfileDropdownModel };
+}
+export { User, HeaderModel, FooterModel, HeroModel, ButtonModel, ConfirmModel, InputModel, SpinnerModel, TableModel, ToastModel, SelectModel, AutocompleteModel, TreeModel, TabsModel, AccordionModel, GalleryModel, PriceModel, PricingModel, CommentModel, TestimonialModel, StatsItemModel, StatsModel, TimelineItemModel, TimelineModel, EmptyStateModel, BannerModel, ProfileDropdownModel };

package/types/StdIn.d.ts

@@ -22,10 +22,10 @@ export default class StdIn extends EventProcessor {
         processor?: Processor | undefined;
         stream?: UiMessage[] | undefined;
     });
-    /** @type {UiMessage[]} Input message buffer */
-    stream: UiMessage[];
     /** @type {Processor} Input processor */
     processor: Processor;
+    /** @type {UiMessage[]} Input message buffer */
+    stream: UiMessage[];
     /**
      * Checks if there are messages waiting in the input stream.
      * @returns {boolean} True if waiting messages, false otherwise
@@ -56,7 +56,7 @@ export default class StdIn extends EventProcessor {
     decode(message: UiMessage | string[] | any): UiMessage;
 }
 import EventProcessor from '@nan0web/event/oop';
-import { UiMessage } from './core/index.js';
 declare class Processor extends EventProcessor {
 }
+import { UiMessage } from './core/index.js';
 export {};

package/types/cli.d.ts

@@ -0,0 +1 @@
+export { UIApp as default } from "./domain/app/UIApp.js";

package/types/core/GeneratorRunner.d.ts

@@ -29,9 +29,17 @@ export type AdapterHandlers = {
      */
     progress?: ((intent: import("./Intent.js").ProgressIntent) => void | Promise<void>) | undefined;
     /**
-     * Handler for 'log' intents. Optional (defaults to no-op).
+     * Handler for 'show' intents. Optional (defaults to no-op).
+     */
+    show?: ((intent: import("./Intent.js").ShowIntent) => void | Promise<void>) | undefined;
+    /**
+     * Handler for 'log' intents. Optional.
      */
     log?: ((intent: import("./Intent.js").LogIntent) => void | Promise<void>) | undefined;
+    /**
+     * Handler for 'agent' intents (AI Subagents). Optional (fallback to show if not implemented).
+     */
+    agent?: ((intent: import("./Intent.js").AgentIntent) => Promise<import("./Intent.js").AgentResponse>) | undefined;
     /**
      * Handler for 'render' intents (visual component injection). Optional.
      */
@@ -52,4 +60,9 @@ export type RunnerOptions = {
      * External AbortSignal for cancellation from outside.
      */
     signal?: AbortSignal | undefined;
+    /**
+     * Array where all executed intents will be sequentially recorded.
+     * Useful for generating 'crash reports' or Nan0Spec files on failure.
+     */
+    trace?: import("./Intent.js").Intent[] | undefined;
 };

package/types/core/InputAdapter.d.ts

@@ -1,10 +1,21 @@
+/**
+ * @typedef {Object} AskOptions
+ * @property {boolean} [silent] - Suppress logs or output.
+ * @property {string} [title] - Custom title for the prompt.
+ * @property {string} [hint] - Presentation hint (e.g., 'password', 'tree', 'markdown').
+ * @property {any} [default] - Default value if no input is provided.
+ * @property {Array<string|Object>} [options] - Array of options for select inputs.
+ * @property {Record<string, any>} [UI] - Localization dictionary/overrides.
+ * @property {string} [component] - Target specific component override.
+ */
+/** @typedef {import('./index.js').AskResponse} AskResponse */
 /**
  * Abstract input adapter for UI implementations.
  *
  * @class InputAdapter
  * @extends Event
  */
-export default class InputAdapter extends Event {
+export class InputAdapter extends Event {
     static CancelError: typeof CancelError;
     /** @returns {typeof CancelError} */
     get CancelError(): typeof CancelError;
@@ -28,19 +39,52 @@ export default class InputAdapter extends Event {
     isReady(): boolean;
     /**
      * Helper to ask a question.
-     * @param {string} question - Question to ask.
-     * @returns {Promise<string>}
+     * @param {string|import('./Message/Message.js').default|any} question - Question to ask, Form instance, or AskIntent.
+     * @param {AskOptions} [options] - Additional options.
+     * @returns {Promise<AskResponse>}
      */
-    ask(question: string): Promise<string>;
+    ask(question: string | import("./Message/Message.js").default | any, options?: AskOptions): Promise<AskResponse>;
     /**
      * Generic selection prompt.
      * @param {Object} config - Selection configuration.
-     * @returns {Promise<{ index: number, value: string | null }>}
+     * @returns {Promise<{ index?: number, value: string | null }>}
      */
     select(config: any): Promise<{
-        index: number;
+        index?: number;
         value: string | null;
     }>;
 }
+export default InputAdapter;
+export type AskOptions = {
+    /**
+     * - Suppress logs or output.
+     */
+    silent?: boolean | undefined;
+    /**
+     * - Custom title for the prompt.
+     */
+    title?: string | undefined;
+    /**
+     * - Presentation hint (e.g., 'password', 'tree', 'markdown').
+     */
+    hint?: string | undefined;
+    /**
+     * - Default value if no input is provided.
+     */
+    default?: any;
+    /**
+     * - Array of options for select inputs.
+     */
+    options?: any[] | undefined;
+    /**
+     * - Localization dictionary/overrides.
+     */
+    UI?: Record<string, any> | undefined;
+    /**
+     * - Target specific component override.
+     */
+    component?: string | undefined;
+};
+export type AskResponse = import("./index.js").AskResponse;
 import Event from '@nan0web/event/oop';
 import CancelError from './Error/CancelError.js';

package/types/core/Intent.d.ts

@@ -12,6 +12,76 @@ export function isModelSchema(schema: any): boolean;
  * @returns {intent is Intent}
  */
 export function validateIntent(intent: any): intent is Intent;
+/**
+ * Create an ask intent.
+ *
+ * Two modes:
+ *   ask('amount', { help: 'Enter amount', type: 'number' })  → single field
+ *   ask('transfer', TransferMoneyModel)                       → full Model form
+ *
+ * @param {string} field - Field name or form name.
+ * @param {object | Function} schema - Field descriptor or Model-as-Schema class.
+ * @returns {AskIntent}
+ */
+export function ask(field: string, schema: object | Function): AskIntent;
+/**
+ * @typedef {Object} ProgressOptions
+ * @property {number} [total] - Absolute total steps.
+ * @property {string} [id] - Progress tracking ID.
+ * @property {number} [width] - Width of the progress bar in terminal characters.
+ * @property {number} [fps] - Frames per second update rate limit.
+ * @property {string} [format] - Custom format string (e.g. '{time} {bar} {percent} {title}').
+ * @property {number} [columns] - Number of columns (terminal width).
+ * @property {boolean} [forceOneLine] - Prevent wrapping and truncate instead.
+ * @property {boolean|'success'|'error'} [stop] - Set to true to stop, or 'success'/'error' to stop with a status icon (for spinners).
+ */
+/**
+ * Create a progress intent.
+ * @param {string} message - Status message from Model (i18n static field value).
+ * @param {number} [value=0] - Progress value (current step or percentage).
+ * @param {ProgressOptions|number|string} [optionsOrTotalOrId] - Options object, or absolute total steps (number), or progress tracking ID (string).
+ * @param {string} [id='default'] - Progress ID (if total is provided).
+ * @returns {ProgressIntent}
+ */
+export function progress(message: string, value?: number, optionsOrTotalOrId?: ProgressOptions | number | string, id?: string): ProgressIntent;
+export function log(level: any, message: any, data?: {}): {
+    type: string;
+    level: any;
+    message: any;
+};
+/**
+ * Create a render intent.
+ * @param {string} component - Component name (e.g. 'App.Layout.Header').
+ * @param {object} [props] - Static props for the component.
+ * @returns {RenderIntent}
+ */
+export function render(component: string, props?: object): RenderIntent;
+/**
+ * Create a result intent.
+ * @param {*} data - The raw result data.
+ * @returns {ResultIntent}
+ */
+export function result(data: any): ResultIntent;
+/**
+ * @typedef {Object} ShowData
+ * @property {any} [component]
+ * @property {import('@nan0web/types').Model} [model]
+ */
+/**
+ * Create a show intent.
+ * @param {string | any} message Message to display.
+ * @param {ShowLevel|ShowData} [level='info'] Level of message or additional data then `level = 'info'`.
+ * @param {ShowData} [data={}] Additional data to display.
+ * @returns {ShowIntent}
+ */
+export function show(message: string | any, level?: ShowLevel | ShowData, data?: ShowData): ShowIntent;
+/**
+ * Create an agent intent to delegate a task to an AI subagent.
+ * @param {string} task - The instructional task for the AI agent.
+ * @param {AgentContext} [context={}] - Contextual data (files, errors, docs).
+ * @returns {AgentIntent}
+ */
+export function agent(task: string, context?: AgentContext): AgentIntent;
 /**
  * @typedef {Object} FieldSchema
  * @property {string} help - Human-readable label / i18n key.
@@ -36,16 +106,29 @@ export function validateIntent(intent: any): intent is Intent;
  * @typedef {Object} ProgressIntent
  * @property {'progress'} type
  * @property {number} [value] - Progress value (0-1).
- * @property {string} [id] - Progress ID for tracking multiple parallel operations.
+ * @property {number} [total] - Absolute total (if value is absolute).
+ * @property {string} [id] - Progress ID for tracking by Adapter to calculate speed/eta.
  * @property {string} message - Status message from Model (i18n static field value).
+ * @property {ProgressOptions} [options] - Additional options for progress intent.
+ */
+/**
+ * @typedef {'info' | 'warn' | 'error' | 'success'} ShowLevel
  */
+/** @typedef {ShowLevel} LogLevel */
 /**
- * Model emits a log message. No response expected.
+ * Model emits a show message. No response expected.
  * Message MUST come from the Model (i18n static field value).
+ * @typedef {Object} ShowIntent
+ * @property {'show'} type
+ * @property {ShowLevel} level
+ * @property {string} message - Show message from Model (i18n static field value).
+ */
+/**
+ * Model emits a log message intended for debugging/developer (Not UI).
  * @typedef {Object} LogIntent
  * @property {'log'} type
- * @property {'info' | 'warn' | 'error' | 'success'} level
- * @property {string} message - Log message from Model (i18n static field value).
+ * @property {LogLevel} level
+ * @property {string} message - Internal log message.
  */
 /**
  * Final return value from the generator.
@@ -61,16 +144,56 @@ export function validateIntent(intent: any): intent is Intent;
  * @property {string} component - Component name (e.g. 'App.Layout.Header').
  * @property {object} props - Static props for the component.
  */
+/**
+ * Contextual data and attachments for the AI subagent.
+ * @typedef {Object} AgentContext
+ * @property {string[]} [instructions] - List of instructions or guidelines (e.g. ['Use 1-char emojis only']).
+ * @property {Record<string, string>} [files] - Hash map of file paths to their string contents.
+ * @property {Record<string, any>} [data] - Any arbitrary JSON data (e.g. parsed errors, ASTs, metadata) useful for the task.
+ */
+/**
+ * Model delegates a task to an AI subagent. The Adapter should launch the agent
+ * with the provided task and context, and return the result. If the agent is skipped,
+ * it returns { success: false } but allows user to generate a prompt.
+ * @typedef {Object} AgentIntent
+ * @property {'agent'} type
+ * @property {string} task - The instructional task for the AI agent.
+ * @property {AgentContext} context - Contextual data, files, and instructions for the task.
+ * @property {() => string} toPrompt - Helper to format task and context as an LLM prompt.
+ */
 /**
  * Union of all possible yielded intents.
- * @typedef {AskIntent | ProgressIntent | LogIntent | RenderIntent} Intent
+ * @typedef {(AskIntent | ProgressIntent | LogIntent | ShowIntent | RenderIntent | AgentIntent | ResultIntent) & {
+ *   $value?: any;
+ *   $success?: boolean;
+ *   $files?: Record<string, string>;
+ *   $message?: string;
+ * }} Intent
  */
 /**
  * Response to an AskIntent. Adapter provides the collected value.
  * The value MUST conform to the type described in the requested FieldSchema.
  * @typedef {Object} AskResponse
  * @property {*} value - The value matching schema.type (collected from user / LLM / test fixture).
- * @property {boolean} [cancelled] - Whether the user cancelled this interaction (e.g. pressed ESC).
+ * @property {boolean} cancelled - Whether the user cancelled this interaction (e.g. pressed ESC).
+ * @property {string} [action] - The action identifier (e.g., 'submit', 'exit', 'back').
+ * @property {any} [body] - Additional payload or form data.
+ * @property {any} [form] - The form model instance (if applicable).
+ * @property {number} [index] - The selected index for lists/tables.
+ */
+/**
+ * Response to an AgentIntent.
+ * The underlying Adapter (Orchestrator) is responsible for communicating with the LLM,
+ * enforcing output formats (e.g. Unified Diff or Tool Calls like `updateFile`),
+ * and resolving common LLM hallucinations (like Grok truncating code with `// ...`).
+ *
+ * The Model (e.g. IconsAuditor) receives this clean, resolved response and does not
+ * need to parse Markdown or interpret diffs itself.
+ *
+ * @typedef {Object} AgentResponse
+ * @property {boolean} success - True if the agent successfully processed the task.
+ * @property {Record<string, string>} [files] - Hash map of fully resolved, updated file contents.
+ * @property {string} [message] - Optional summary or explanation returned by the AI.
  */
 /**
  * Special response that Adapters can send to abort the generator.
@@ -88,27 +211,49 @@ export function validateIntent(intent: any): intent is Intent;
  */
 /**
  * Union of all possible responses an Adapter can send back via iterator.next().
- * @typedef {AskResponse | AbortResponse | undefined} IntentResponse
+ * @typedef {AskResponse | AgentResponse | AbortResponse | undefined} IntentResponse
  */
-export const INTENT_TYPES: readonly ["ask", "progress", "log", "render"];
-export function ask(field: string, schema: object | Function): AskIntent;
-export function progress(message: any): {
-    type: string;
-    message: any;
-};
-export function log(level: any, message: any, data?: {}): {
-    type: string;
-    level: any;
-    message: any;
-};
-export function render(component: any, props?: {}): {
-    type: string;
-    component: any;
-    props: {};
+/**
+ * @typedef {'ask' | 'show' | 'progress' | 'render' | 'agent'} IntentType
+ */
+export const INTENT_TYPES: readonly ["ask", "progress", "show", "log", "render", "agent"];
+export type ProgressOptions = {
+    /**
+     * - Absolute total steps.
+     */
+    total?: number | undefined;
+    /**
+     * - Progress tracking ID.
+     */
+    id?: string | undefined;
+    /**
+     * - Width of the progress bar in terminal characters.
+     */
+    width?: number | undefined;
+    /**
+     * - Frames per second update rate limit.
+     */
+    fps?: number | undefined;
+    /**
+     * - Custom format string (e.g. '{time} {bar} {percent} {title}').
+     */
+    format?: string | undefined;
+    /**
+     * - Number of columns (terminal width).
+     */
+    columns?: number | undefined;
+    /**
+     * - Prevent wrapping and truncate instead.
+     */
+    forceOneLine?: boolean | undefined;
+    /**
+     * - Set to true to stop, or 'success'/'error' to stop with a status icon (for spinners).
+     */
+    stop?: boolean | "error" | "success" | undefined;
 };
-export function result(data: any): {
-    type: string;
-    data: any;
+export type ShowData = {
+    component?: any;
+    model?: import("@nan0web/types").Model | undefined;
 };
 export type FieldSchema = {
     /**
@@ -169,23 +314,44 @@ export type ProgressIntent = {
      */
     value?: number | undefined;
     /**
-     * - Progress ID for tracking multiple parallel operations.
+     * - Absolute total (if value is absolute).
+     */
+    total?: number | undefined;
+    /**
+     * - Progress ID for tracking by Adapter to calculate speed/eta.
      */
     id?: string | undefined;
     /**
      * - Status message from Model (i18n static field value).
      */
     message: string;
+    /**
+     * - Additional options for progress intent.
+     */
+    options?: ProgressOptions | undefined;
 };
+export type ShowLevel = "info" | "warn" | "error" | "success";
+export type LogLevel = ShowLevel;
 /**
- * Model emits a log message. No response expected.
+ * Model emits a show message. No response expected.
  * Message MUST come from the Model (i18n static field value).
  */
+export type ShowIntent = {
+    type: "show";
+    level: ShowLevel;
+    /**
+     * - Show message from Model (i18n static field value).
+     */
+    message: string;
+};
+/**
+ * Model emits a log message intended for debugging/developer (Not UI).
+ */
 export type LogIntent = {
     type: "log";
-    level: "info" | "warn" | "error" | "success";
+    level: LogLevel;
     /**
-     * - Log message from Model (i18n static field value).
+     * - Internal log message.
      */
     message: string;
 };
@@ -214,10 +380,52 @@ export type RenderIntent = {
      */
     props: object;
 };
+/**
+ * Contextual data and attachments for the AI subagent.
+ */
+export type AgentContext = {
+    /**
+     * - List of instructions or guidelines (e.g. ['Use 1-char emojis only']).
+     */
+    instructions?: string[] | undefined;
+    /**
+     * - Hash map of file paths to their string contents.
+     */
+    files?: Record<string, string> | undefined;
+    /**
+     * - Any arbitrary JSON data (e.g. parsed errors, ASTs, metadata) useful for the task.
+     */
+    data?: Record<string, any> | undefined;
+};
+/**
+ * Model delegates a task to an AI subagent. The Adapter should launch the agent
+ * with the provided task and context, and return the result. If the agent is skipped,
+ * it returns { success: false } but allows user to generate a prompt.
+ */
+export type AgentIntent = {
+    type: "agent";
+    /**
+     * - The instructional task for the AI agent.
+     */
+    task: string;
+    /**
+     * - Contextual data, files, and instructions for the task.
+     */
+    context: AgentContext;
+    /**
+     * - Helper to format task and context as an LLM prompt.
+     */
+    toPrompt: () => string;
+};
 /**
  * Union of all possible yielded intents.
  */
-export type Intent = AskIntent | ProgressIntent | LogIntent | RenderIntent;
+export type Intent = (AskIntent | ProgressIntent | LogIntent | ShowIntent | RenderIntent | AgentIntent | ResultIntent) & {
+    $value?: any;
+    $success?: boolean;
+    $files?: Record<string, string>;
+    $message?: string;
+};
 /**
  * Response to an AskIntent. Adapter provides the collected value.
  * The value MUST conform to the type described in the requested FieldSchema.
@@ -230,7 +438,46 @@ export type AskResponse = {
     /**
      * - Whether the user cancelled this interaction (e.g. pressed ESC).
      */
-    cancelled?: boolean | undefined;
+    cancelled: boolean;
+    /**
+     * - The action identifier (e.g., 'submit', 'exit', 'back').
+     */
+    action?: string | undefined;
+    /**
+     * - Additional payload or form data.
+     */
+    body?: any;
+    /**
+     * - The form model instance (if applicable).
+     */
+    form?: any;
+    /**
+     * - The selected index for lists/tables.
+     */
+    index?: number | undefined;
+};
+/**
+ * Response to an AgentIntent.
+ * The underlying Adapter (Orchestrator) is responsible for communicating with the LLM,
+ * enforcing output formats (e.g. Unified Diff or Tool Calls like `updateFile`),
+ * and resolving common LLM hallucinations (like Grok truncating code with `// ...`).
+ *
+ * The Model (e.g. IconsAuditor) receives this clean, resolved response and does not
+ * need to parse Markdown or interpret diffs itself.
+ */
+export type AgentResponse = {
+    /**
+     * - True if the agent successfully processed the task.
+     */
+    success: boolean;
+    /**
+     * - Hash map of fully resolved, updated file contents.
+     */
+    files?: Record<string, string> | undefined;
+    /**
+     * - Optional summary or explanation returned by the AI.
+     */
+    message?: string | undefined;
 };
 /**
  * Special response that Adapters can send to abort the generator.
@@ -255,4 +502,5 @@ export type AbortResponse = {
 /**
  * Union of all possible responses an Adapter can send back via iterator.next().
  */
-export type IntentResponse = AskResponse | AbortResponse | undefined;
+export type IntentResponse = AskResponse | AgentResponse | AbortResponse | undefined;
+export type IntentType = "ask" | "show" | "progress" | "render" | "agent";

package/types/core/Message/Message.d.ts

@@ -61,9 +61,9 @@ export default class UiMessage extends Message {
      */
     constructor(input?: any);
     /** @type {string} */
-    type: string;
-    /** @type {string} */
     id: string;
+    /** @type {string} */
+    type: string;
     /**
      * Validates the message body against its schema.
      *