@stina/extension-api 0.32.0 → 0.33.0-alpha.8cab91c

package/dist/{types.tools-XIdePk7Z.d.cts → types.tools-BYgcVNP4.d.cts}

@@ -180,6 +180,11 @@ interface ParagraphProps extends ExtensionComponentData {
 interface ButtonProps extends ExtensionComponentData {
     component: 'Button';
     text: string;
+    /** Visual style. Defaults to "normal". */
+    type?: 'normal' | 'primary' | 'danger' | 'accent';
+    /** Optional tooltip shown on hover. */
+    title?: string;
+    disabled?: boolean;
     onClickAction: ExtensionActionRef;
 }
 /** The extension API properties for the TextInput component. */
@@ -188,14 +193,46 @@ interface TextInputProps extends ExtensionComponentData {
     label: string;
     placeholder?: string;
     value?: string;
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
+}
+/** The extension API properties for the PasswordInput component. */
+interface PasswordInputProps extends ExtensionComponentData {
+    component: 'PasswordInput';
+    label: string;
+    placeholder?: string;
+    value?: string;
+    onChangeAction?: ExtensionActionRef;
+}
+/** The extension API properties for the NumberInput component. */
+interface NumberInputProps extends ExtensionComponentData {
+    component: 'NumberInput';
+    label: string;
+    placeholder?: string;
+    value?: string | number;
+    /** Optional minimum value. */
+    min?: number;
+    /** Optional maximum value. */
+    max?: number;
+    /** Optional step. */
+    step?: number;
+    onChangeAction?: ExtensionActionRef;
+}
+/** The extension API properties for the TextArea component. */
+interface TextAreaProps extends ExtensionComponentData {
+    component: 'TextArea';
+    label: string;
+    placeholder?: string;
+    value?: string;
+    /** Number of visible text rows. Defaults to 4. */
+    rows?: number;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the DateTimeInput component. */
 interface DateTimeInputProps extends ExtensionComponentData {
     component: 'DateTimeInput';
     label: string;
     value?: string;
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the Select component. */
 interface SelectProps extends ExtensionComponentData {
@@ -206,14 +243,14 @@ interface SelectProps extends ExtensionComponentData {
         value: string;
     }>;
     selectedValue?: string;
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the IconPicker component. */
 interface IconPickerProps extends ExtensionComponentData {
     component: 'IconPicker';
     label?: string;
     value?: string;
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the VerticalStack component. */
 interface VerticalStackProps extends ExtensionComponentData {
@@ -279,7 +316,7 @@ interface ToggleProps extends ExtensionComponentData {
     description?: string;
     checked?: boolean;
     disabled?: boolean;
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the Collapsible component. */
 interface CollapsibleProps extends ExtensionComponentData {
@@ -319,7 +356,7 @@ interface CheckboxProps extends ExtensionComponentData {
     /** Whether to strike through the label when checked. Defaults to true. */
     strikethrough?: boolean;
     /** Action to call when the checkbox state changes. */
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the Markdown component. */
 interface MarkdownProps extends ExtensionComponentData {
@@ -394,18 +431,10 @@ interface ListProps extends ExtensionComponentData {
     children: ExtensionComponentChildren;
 }
 
-/**
- * Contribution Types
- *
- * Types for extension contributions: settings, panels, providers, tools, commands, prompts.
- */
-
 /**
  * What an extension can contribute to Stina
  */
 interface ExtensionContributions {
-    /** User-configurable settings */
-    settings?: SettingDefinition[];
     /** Tool settings views for UI */
     toolSettings?: ToolSettingsViewDefinition[];
     /** Right panel contributions */
@@ -428,71 +457,6 @@ interface ExtensionContributions {
         };
     };
 }
-/**
- * Setting definition for the UI
- */
-interface SettingDefinition {
-    /** Setting ID (namespaced automatically) */
-    id: string;
-    /** Display title */
-    title: string;
-    /** Help text */
-    description?: string;
-    /** Setting type */
-    type: 'string' | 'number' | 'boolean' | 'select';
-    /** Default value */
-    default?: unknown;
-    /** For select type: available options */
-    options?: {
-        value: string;
-        label: string;
-    }[];
-    /** For select type: load options from tool */
-    optionsToolId?: string;
-    /** Params for options tool */
-    optionsParams?: Record<string, unknown>;
-    /** Mapping for options tool response */
-    optionsMapping?: SettingOptionsMapping;
-    /** Tool ID for creating a new option */
-    createToolId?: string;
-    /** Label for create action */
-    createLabel?: string;
-    /** Fields for create form */
-    createFields?: SettingDefinition[];
-    /** Static params always sent to create tool */
-    createParams?: Record<string, unknown>;
-    /** Mapping for create tool response */
-    createMapping?: SettingCreateMapping;
-    /** Validation rules */
-    validation?: {
-        required?: boolean;
-        min?: number;
-        max?: number;
-        pattern?: string;
-    };
-}
-/**
- * Mapping for select field options from tool response
- */
-interface SettingOptionsMapping {
-    /** Key for items array in tool result data */
-    itemsKey: string;
-    /** Key for option value */
-    valueKey: string;
-    /** Key for option label */
-    labelKey: string;
-    /** Optional key for description */
-    descriptionKey?: string;
-}
-/**
- * Mapping for create tool response
- */
-interface SettingCreateMapping {
-    /** Key for result data object */
-    resultKey?: string;
-    /** Key for option value (defaults to "id") */
-    valueKey: string;
-}
 /**
  * Tool settings view definition (UI schema)
  */
@@ -505,8 +469,6 @@ interface ToolSettingsViewDefinition {
     description?: string;
     /** View configuration */
     view: ToolSettingsView;
-    /** Fields for create/edit forms (uses SettingDefinition) */
-    fields?: SettingDefinition[];
 }
 /**
  * Tool settings view types
@@ -536,6 +498,31 @@ interface ToolSettingsListView {
     idParam?: string;
     /** Static params always sent to list tool */
     listParams?: Record<string, unknown>;
+    /**
+     * Component-tree-based create/edit form. Fields bind to the current
+     * item via `value: "$item.<key>"` (or `selectedValue` / `checked`),
+     * and the host saves the resulting object via `upsertToolId` when
+     * the user clicks "Save".
+     */
+    editView?: {
+        /** Root component to render in the create/edit modal. */
+        content: ExtensionComponentData;
+    };
+    /** Optional grouping configuration. When set, items are visually grouped by this field. */
+    groupBy?: ToolSettingsListGroupBy;
+}
+/**
+ * Configures grouping for a list view. Items are grouped by the value
+ * of `key` on each item; groups appear in the order specified by `order`
+ * (with unlisted groups falling back to alphabetical order at the end).
+ */
+interface ToolSettingsListGroupBy {
+    /** Key in each item used to determine group membership. */
+    key: string;
+    /** Explicit ordering of group values. Groups not listed appear afterwards, sorted alphabetically. */
+    order?: string[];
+    /** Human-friendly labels per group value (rendered as section headers). Falls back to the raw value if missing. */
+    labels?: Record<string, string>;
 }
 /**
  * Mapping from tool list data to UI fields
@@ -637,68 +624,22 @@ interface ProviderDefinition {
     suggestedDefaultModel?: string;
     /** Default settings for this provider (e.g., { url: "http://localhost:11434" }) */
     defaultSettings?: Record<string, unknown>;
-    /** Schema for provider-specific configuration UI */
-    configSchema?: ProviderConfigSchema;
-}
-/**
- * Schema for provider-specific configuration.
- * Used to generate UI forms for configuring provider settings.
- */
-interface ProviderConfigSchema {
-    /** Property definitions */
-    properties: Record<string, ProviderConfigProperty>;
-    /** Display order of properties in UI (optional, defaults to object key order) */
-    order?: string[];
-}
-/**
- * Property types for provider configuration
- */
-type ProviderConfigPropertyType = 'string' | 'number' | 'boolean' | 'select' | 'password' | 'url';
-/**
- * Single property in a provider configuration schema.
- * Defines how a setting should be rendered and validated in the UI.
- */
-interface ProviderConfigProperty {
-    /** Property type - determines UI control */
-    type: ProviderConfigPropertyType;
-    /** Display label */
-    title: string;
-    /** Help text shown below the input */
-    description?: string;
-    /** Default value */
-    default?: unknown;
-    /** Whether the field is required */
-    required?: boolean;
-    /** Placeholder text for input fields */
-    placeholder?: string;
-    /** For 'select' type: static options */
-    options?: ProviderConfigSelectOption[];
-    /** Validation rules */
-    validation?: ProviderConfigValidation;
-}
-/**
- * Option for select-type properties
- */
-interface ProviderConfigSelectOption {
-    /** Value stored in settings */
-    value: string;
-    /** Display label */
-    label: string;
+    /**
+     * Declarative configuration view rendered with the extensionComponent
+     * system. The host owns the settings state — bind fields with
+     * `value: "$settings.<key>"` and the host updates the model's
+     * settingsOverride when the user edits. `onChangeAction` is optional
+     * for input fields in this view; buttons can still use `onClickAction`
+     * to call extension actions (e.g. OAuth, "Test connection").
+     */
+    configView?: ProviderConfigView;
 }
 /**
- * Validation rules for a property
+ * Component-tree-based configuration view for a provider.
  */
-interface ProviderConfigValidation {
-    /** Regex pattern the value must match */
-    pattern?: string;
-    /** Minimum string length */
-    minLength?: number;
-    /** Maximum string length */
-    maxLength?: number;
-    /** Minimum number value */
-    min?: number;
-    /** Maximum number value */
-    max?: number;
+interface ProviderConfigView {
+    /** Component tree describing the form. */
+    content: ExtensionComponentData;
 }
 /**
  * Tool definition (metadata only, implementation in code)
@@ -1740,4 +1681,4 @@ interface ActionResult {
     error?: string;
 }
 
-export { type BackgroundTaskConfig as $, type ActionResult as A, type ProviderConfigValidation as B, type ChatMessage as C, type ExtensionContext as D, type ExtensionContributions as E, type Disposable as F, type GetModelsOptions as G, type SettingsAPI as H, type ProvidersAPI as I, type ToolsAPI as J, type ActionsAPI as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type EventsAPI as O, type PanelDefinition as P, type SchedulerAPI as Q, type SchedulerJobRequest as R, type SchedulerFirePayload as S, type ToolResult as T, type SchedulerSchedule as U, type UserAPI as V, type UserProfile as W, type ChatAPI as X, type ChatInstructionMessage as Y, type LogAPI as Z, type BackgroundWorkersAPI as _, type ChatOptions as a, type BackgroundTaskCallback as a0, type BackgroundTaskContext as a1, type BackgroundTaskHealth as a2, type BackgroundRestartPolicy as a3, type Query as a4, type QueryOptions as a5, type StorageAPI as a6, type SecretsAPI as a7, type StorageCollectionConfig as a8, type StorageContributions as a9, type DividerProps as aA, type IconProps as aB, type IconButtonType as aC, type IconButtonProps as aD, type PanelAction as aE, type PanelProps as aF, type ToggleProps as aG, type CollapsibleProps as aH, type FrameVariant as aI, type FrameProps as aJ, type ListProps as aK, type PillVariant as aL, type PillProps as aM, type CheckboxProps as aN, type MarkdownProps as aO, type TextPreviewProps as aP, type ModalProps as aQ, type ConditionalGroupProps as aR, type ExecutionContext as aS, type AIProvider as aa, type ToolCall as ab, type Tool as ac, type Action as ad, type ExtensionModule as ae, type HugeIconName as af, type AllowedCSSProperty as ag, type ExtensionComponentStyle as ah, type ExtensionComponentData as ai, type ExtensionComponentIterator as aj, type ExtensionComponentChildren as ak, type ExtensionActionCall as al, type ExtensionActionRef as am, type ExtensionDataSource as an, type ExtensionPanelDefinition as ao, type HeaderProps as ap, type LabelProps as aq, type ParagraphProps as ar, type ButtonProps as as, type TextInputProps as at, type DateTimeInputProps as au, type SelectProps as av, type IconPickerProps as aw, type VerticalStackProps as ax, type HorizontalStackProps as ay, type GridProps as az, type StreamEvent as b, type SettingDefinition as c, type SettingOptionsMapping as d, type SettingCreateMapping as e, type ToolSettingsViewDefinition as f, type ToolSettingsView as g, type ToolSettingsListView as h, type ToolSettingsListMapping as i, type ToolSettingsComponentView as j, type ToolSettingsActionDataSource as k, type PanelView as l, type PanelComponentView as m, type PanelActionDataSource as n, type PanelUnknownView as o, type ProviderDefinition as p, type PromptContribution as q, resolveLocalizedString as r, type PromptSection as s, type ToolDefinition as t, type ToolConfirmationConfig as u, type CommandDefinition as v, type ProviderConfigSchema as w, type ProviderConfigProperty as x, type ProviderConfigPropertyType as y, type ProviderConfigSelectOption as z };
+export { type StorageAPI as $, type ActionResult as A, type SchedulerAPI as B, type ChatMessage as C, type Disposable as D, type ExtensionContributions as E, type SchedulerJobRequest as F, type GetModelsOptions as G, type SchedulerSchedule as H, type UserProfile as I, type ChatAPI as J, type ChatInstructionMessage as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type LogAPI as O, type PanelDefinition as P, type BackgroundWorkersAPI as Q, type BackgroundTaskConfig as R, type SchedulerFirePayload as S, type ToolResult as T, type UserAPI as U, type BackgroundTaskCallback as V, type BackgroundTaskContext as W, type BackgroundTaskHealth as X, type BackgroundRestartPolicy as Y, type Query as Z, type QueryOptions as _, type ChatOptions as a, type SecretsAPI as a0, type StorageCollectionConfig as a1, type StorageContributions as a2, type AIProvider as a3, type ToolCall as a4, type Tool as a5, type Action as a6, type ExtensionModule as a7, type HugeIconName as a8, type AllowedCSSProperty as a9, type PanelAction as aA, type PanelProps as aB, type ToggleProps as aC, type CollapsibleProps as aD, type FrameVariant as aE, type FrameProps as aF, type ListProps as aG, type PillVariant as aH, type PillProps as aI, type CheckboxProps as aJ, type MarkdownProps as aK, type TextPreviewProps as aL, type ModalProps as aM, type ConditionalGroupProps as aN, type ExecutionContext as aO, type ExtensionComponentStyle as aa, type ExtensionComponentData as ab, type ExtensionComponentIterator as ac, type ExtensionComponentChildren as ad, type ExtensionActionCall as ae, type ExtensionActionRef as af, type ExtensionDataSource as ag, type ExtensionPanelDefinition as ah, type HeaderProps as ai, type LabelProps as aj, type ParagraphProps as ak, type ButtonProps as al, type TextInputProps as am, type PasswordInputProps as an, type NumberInputProps as ao, type TextAreaProps as ap, type DateTimeInputProps as aq, type SelectProps as ar, type IconPickerProps as as, type VerticalStackProps as at, type HorizontalStackProps as au, type GridProps as av, type DividerProps as aw, type IconProps as ax, type IconButtonType as ay, type IconButtonProps as az, type StreamEvent as b, type ToolSettingsViewDefinition as c, type ToolSettingsView as d, type ToolSettingsListView as e, type ToolSettingsListMapping as f, type ToolSettingsComponentView as g, type ToolSettingsActionDataSource as h, type PanelView as i, type PanelComponentView as j, type PanelActionDataSource as k, type PanelUnknownView as l, type ProviderDefinition as m, type ProviderConfigView as n, type PromptContribution as o, type PromptSection as p, type ToolDefinition as q, resolveLocalizedString as r, type ToolConfirmationConfig as s, type CommandDefinition as t, type ExtensionContext as u, type SettingsAPI as v, type ProvidersAPI as w, type ToolsAPI as x, type ActionsAPI as y, type EventsAPI as z };

package/dist/{types.tools-XIdePk7Z.d.ts → types.tools-BYgcVNP4.d.ts}

@@ -180,6 +180,11 @@ interface ParagraphProps extends ExtensionComponentData {
 interface ButtonProps extends ExtensionComponentData {
     component: 'Button';
     text: string;
+    /** Visual style. Defaults to "normal". */
+    type?: 'normal' | 'primary' | 'danger' | 'accent';
+    /** Optional tooltip shown on hover. */
+    title?: string;
+    disabled?: boolean;
     onClickAction: ExtensionActionRef;
 }
 /** The extension API properties for the TextInput component. */
@@ -188,14 +193,46 @@ interface TextInputProps extends ExtensionComponentData {
     label: string;
     placeholder?: string;
     value?: string;
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
+}
+/** The extension API properties for the PasswordInput component. */
+interface PasswordInputProps extends ExtensionComponentData {
+    component: 'PasswordInput';
+    label: string;
+    placeholder?: string;
+    value?: string;
+    onChangeAction?: ExtensionActionRef;
+}
+/** The extension API properties for the NumberInput component. */
+interface NumberInputProps extends ExtensionComponentData {
+    component: 'NumberInput';
+    label: string;
+    placeholder?: string;
+    value?: string | number;
+    /** Optional minimum value. */
+    min?: number;
+    /** Optional maximum value. */
+    max?: number;
+    /** Optional step. */
+    step?: number;
+    onChangeAction?: ExtensionActionRef;
+}
+/** The extension API properties for the TextArea component. */
+interface TextAreaProps extends ExtensionComponentData {
+    component: 'TextArea';
+    label: string;
+    placeholder?: string;
+    value?: string;
+    /** Number of visible text rows. Defaults to 4. */
+    rows?: number;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the DateTimeInput component. */
 interface DateTimeInputProps extends ExtensionComponentData {
     component: 'DateTimeInput';
     label: string;
     value?: string;
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the Select component. */
 interface SelectProps extends ExtensionComponentData {
@@ -206,14 +243,14 @@ interface SelectProps extends ExtensionComponentData {
         value: string;
     }>;
     selectedValue?: string;
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the IconPicker component. */
 interface IconPickerProps extends ExtensionComponentData {
     component: 'IconPicker';
     label?: string;
     value?: string;
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the VerticalStack component. */
 interface VerticalStackProps extends ExtensionComponentData {
@@ -279,7 +316,7 @@ interface ToggleProps extends ExtensionComponentData {
     description?: string;
     checked?: boolean;
     disabled?: boolean;
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the Collapsible component. */
 interface CollapsibleProps extends ExtensionComponentData {
@@ -319,7 +356,7 @@ interface CheckboxProps extends ExtensionComponentData {
     /** Whether to strike through the label when checked. Defaults to true. */
     strikethrough?: boolean;
     /** Action to call when the checkbox state changes. */
-    onChangeAction: ExtensionActionRef;
+    onChangeAction?: ExtensionActionRef;
 }
 /** The extension API properties for the Markdown component. */
 interface MarkdownProps extends ExtensionComponentData {
@@ -394,18 +431,10 @@ interface ListProps extends ExtensionComponentData {
     children: ExtensionComponentChildren;
 }
 
-/**
- * Contribution Types
- *
- * Types for extension contributions: settings, panels, providers, tools, commands, prompts.
- */
-
 /**
  * What an extension can contribute to Stina
  */
 interface ExtensionContributions {
-    /** User-configurable settings */
-    settings?: SettingDefinition[];
     /** Tool settings views for UI */
     toolSettings?: ToolSettingsViewDefinition[];
     /** Right panel contributions */
@@ -428,71 +457,6 @@ interface ExtensionContributions {
         };
     };
 }
-/**
- * Setting definition for the UI
- */
-interface SettingDefinition {
-    /** Setting ID (namespaced automatically) */
-    id: string;
-    /** Display title */
-    title: string;
-    /** Help text */
-    description?: string;
-    /** Setting type */
-    type: 'string' | 'number' | 'boolean' | 'select';
-    /** Default value */
-    default?: unknown;
-    /** For select type: available options */
-    options?: {
-        value: string;
-        label: string;
-    }[];
-    /** For select type: load options from tool */
-    optionsToolId?: string;
-    /** Params for options tool */
-    optionsParams?: Record<string, unknown>;
-    /** Mapping for options tool response */
-    optionsMapping?: SettingOptionsMapping;
-    /** Tool ID for creating a new option */
-    createToolId?: string;
-    /** Label for create action */
-    createLabel?: string;
-    /** Fields for create form */
-    createFields?: SettingDefinition[];
-    /** Static params always sent to create tool */
-    createParams?: Record<string, unknown>;
-    /** Mapping for create tool response */
-    createMapping?: SettingCreateMapping;
-    /** Validation rules */
-    validation?: {
-        required?: boolean;
-        min?: number;
-        max?: number;
-        pattern?: string;
-    };
-}
-/**
- * Mapping for select field options from tool response
- */
-interface SettingOptionsMapping {
-    /** Key for items array in tool result data */
-    itemsKey: string;
-    /** Key for option value */
-    valueKey: string;
-    /** Key for option label */
-    labelKey: string;
-    /** Optional key for description */
-    descriptionKey?: string;
-}
-/**
- * Mapping for create tool response
- */
-interface SettingCreateMapping {
-    /** Key for result data object */
-    resultKey?: string;
-    /** Key for option value (defaults to "id") */
-    valueKey: string;
-}
 /**
  * Tool settings view definition (UI schema)
  */
@@ -505,8 +469,6 @@ interface ToolSettingsViewDefinition {
     description?: string;
     /** View configuration */
     view: ToolSettingsView;
-    /** Fields for create/edit forms (uses SettingDefinition) */
-    fields?: SettingDefinition[];
 }
 /**
  * Tool settings view types
@@ -536,6 +498,31 @@ interface ToolSettingsListView {
     idParam?: string;
     /** Static params always sent to list tool */
     listParams?: Record<string, unknown>;
+    /**
+     * Component-tree-based create/edit form. Fields bind to the current
+     * item via `value: "$item.<key>"` (or `selectedValue` / `checked`),
+     * and the host saves the resulting object via `upsertToolId` when
+     * the user clicks "Save".
+     */
+    editView?: {
+        /** Root component to render in the create/edit modal. */
+        content: ExtensionComponentData;
+    };
+    /** Optional grouping configuration. When set, items are visually grouped by this field. */
+    groupBy?: ToolSettingsListGroupBy;
+}
+/**
+ * Configures grouping for a list view. Items are grouped by the value
+ * of `key` on each item; groups appear in the order specified by `order`
+ * (with unlisted groups falling back to alphabetical order at the end).
+ */
+interface ToolSettingsListGroupBy {
+    /** Key in each item used to determine group membership. */
+    key: string;
+    /** Explicit ordering of group values. Groups not listed appear afterwards, sorted alphabetically. */
+    order?: string[];
+    /** Human-friendly labels per group value (rendered as section headers). Falls back to the raw value if missing. */
+    labels?: Record<string, string>;
 }
 /**
  * Mapping from tool list data to UI fields
@@ -637,68 +624,22 @@ interface ProviderDefinition {
     suggestedDefaultModel?: string;
     /** Default settings for this provider (e.g., { url: "http://localhost:11434" }) */
     defaultSettings?: Record<string, unknown>;
-    /** Schema for provider-specific configuration UI */
-    configSchema?: ProviderConfigSchema;
-}
-/**
- * Schema for provider-specific configuration.
- * Used to generate UI forms for configuring provider settings.
- */
-interface ProviderConfigSchema {
-    /** Property definitions */
-    properties: Record<string, ProviderConfigProperty>;
-    /** Display order of properties in UI (optional, defaults to object key order) */
-    order?: string[];
-}
-/**
- * Property types for provider configuration
- */
-type ProviderConfigPropertyType = 'string' | 'number' | 'boolean' | 'select' | 'password' | 'url';
-/**
- * Single property in a provider configuration schema.
- * Defines how a setting should be rendered and validated in the UI.
- */
-interface ProviderConfigProperty {
-    /** Property type - determines UI control */
-    type: ProviderConfigPropertyType;
-    /** Display label */
-    title: string;
-    /** Help text shown below the input */
-    description?: string;
-    /** Default value */
-    default?: unknown;
-    /** Whether the field is required */
-    required?: boolean;
-    /** Placeholder text for input fields */
-    placeholder?: string;
-    /** For 'select' type: static options */
-    options?: ProviderConfigSelectOption[];
-    /** Validation rules */
-    validation?: ProviderConfigValidation;
-}
-/**
- * Option for select-type properties
- */
-interface ProviderConfigSelectOption {
-    /** Value stored in settings */
-    value: string;
-    /** Display label */
-    label: string;
+    /**
+     * Declarative configuration view rendered with the extensionComponent
+     * system. The host owns the settings state — bind fields with
+     * `value: "$settings.<key>"` and the host updates the model's
+     * settingsOverride when the user edits. `onChangeAction` is optional
+     * for input fields in this view; buttons can still use `onClickAction`
+     * to call extension actions (e.g. OAuth, "Test connection").
+     */
+    configView?: ProviderConfigView;
 }
 /**
- * Validation rules for a property
+ * Component-tree-based configuration view for a provider.
  */
-interface ProviderConfigValidation {
-    /** Regex pattern the value must match */
-    pattern?: string;
-    /** Minimum string length */
-    minLength?: number;
-    /** Maximum string length */
-    maxLength?: number;
-    /** Minimum number value */
-    min?: number;
-    /** Maximum number value */
-    max?: number;
+interface ProviderConfigView {
+    /** Component tree describing the form. */
+    content: ExtensionComponentData;
 }
 /**
  * Tool definition (metadata only, implementation in code)
@@ -1740,4 +1681,4 @@ interface ActionResult {
     error?: string;
 }
 
-export { type BackgroundTaskConfig as $, type ActionResult as A, type ProviderConfigValidation as B, type ChatMessage as C, type ExtensionContext as D, type ExtensionContributions as E, type Disposable as F, type GetModelsOptions as G, type SettingsAPI as H, type ProvidersAPI as I, type ToolsAPI as J, type ActionsAPI as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type EventsAPI as O, type PanelDefinition as P, type SchedulerAPI as Q, type SchedulerJobRequest as R, type SchedulerFirePayload as S, type ToolResult as T, type SchedulerSchedule as U, type UserAPI as V, type UserProfile as W, type ChatAPI as X, type ChatInstructionMessage as Y, type LogAPI as Z, type BackgroundWorkersAPI as _, type ChatOptions as a, type BackgroundTaskCallback as a0, type BackgroundTaskContext as a1, type BackgroundTaskHealth as a2, type BackgroundRestartPolicy as a3, type Query as a4, type QueryOptions as a5, type StorageAPI as a6, type SecretsAPI as a7, type StorageCollectionConfig as a8, type StorageContributions as a9, type DividerProps as aA, type IconProps as aB, type IconButtonType as aC, type IconButtonProps as aD, type PanelAction as aE, type PanelProps as aF, type ToggleProps as aG, type CollapsibleProps as aH, type FrameVariant as aI, type FrameProps as aJ, type ListProps as aK, type PillVariant as aL, type PillProps as aM, type CheckboxProps as aN, type MarkdownProps as aO, type TextPreviewProps as aP, type ModalProps as aQ, type ConditionalGroupProps as aR, type ExecutionContext as aS, type AIProvider as aa, type ToolCall as ab, type Tool as ac, type Action as ad, type ExtensionModule as ae, type HugeIconName as af, type AllowedCSSProperty as ag, type ExtensionComponentStyle as ah, type ExtensionComponentData as ai, type ExtensionComponentIterator as aj, type ExtensionComponentChildren as ak, type ExtensionActionCall as al, type ExtensionActionRef as am, type ExtensionDataSource as an, type ExtensionPanelDefinition as ao, type HeaderProps as ap, type LabelProps as aq, type ParagraphProps as ar, type ButtonProps as as, type TextInputProps as at, type DateTimeInputProps as au, type SelectProps as av, type IconPickerProps as aw, type VerticalStackProps as ax, type HorizontalStackProps as ay, type GridProps as az, type StreamEvent as b, type SettingDefinition as c, type SettingOptionsMapping as d, type SettingCreateMapping as e, type ToolSettingsViewDefinition as f, type ToolSettingsView as g, type ToolSettingsListView as h, type ToolSettingsListMapping as i, type ToolSettingsComponentView as j, type ToolSettingsActionDataSource as k, type PanelView as l, type PanelComponentView as m, type PanelActionDataSource as n, type PanelUnknownView as o, type ProviderDefinition as p, type PromptContribution as q, resolveLocalizedString as r, type PromptSection as s, type ToolDefinition as t, type ToolConfirmationConfig as u, type CommandDefinition as v, type ProviderConfigSchema as w, type ProviderConfigProperty as x, type ProviderConfigPropertyType as y, type ProviderConfigSelectOption as z };
+export { type StorageAPI as $, type ActionResult as A, type SchedulerAPI as B, type ChatMessage as C, type Disposable as D, type ExtensionContributions as E, type SchedulerJobRequest as F, type GetModelsOptions as G, type SchedulerSchedule as H, type UserProfile as I, type ChatAPI as J, type ChatInstructionMessage as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type LogAPI as O, type PanelDefinition as P, type BackgroundWorkersAPI as Q, type BackgroundTaskConfig as R, type SchedulerFirePayload as S, type ToolResult as T, type UserAPI as U, type BackgroundTaskCallback as V, type BackgroundTaskContext as W, type BackgroundTaskHealth as X, type BackgroundRestartPolicy as Y, type Query as Z, type QueryOptions as _, type ChatOptions as a, type SecretsAPI as a0, type StorageCollectionConfig as a1, type StorageContributions as a2, type AIProvider as a3, type ToolCall as a4, type Tool as a5, type Action as a6, type ExtensionModule as a7, type HugeIconName as a8, type AllowedCSSProperty as a9, type PanelAction as aA, type PanelProps as aB, type ToggleProps as aC, type CollapsibleProps as aD, type FrameVariant as aE, type FrameProps as aF, type ListProps as aG, type PillVariant as aH, type PillProps as aI, type CheckboxProps as aJ, type MarkdownProps as aK, type TextPreviewProps as aL, type ModalProps as aM, type ConditionalGroupProps as aN, type ExecutionContext as aO, type ExtensionComponentStyle as aa, type ExtensionComponentData as ab, type ExtensionComponentIterator as ac, type ExtensionComponentChildren as ad, type ExtensionActionCall as ae, type ExtensionActionRef as af, type ExtensionDataSource as ag, type ExtensionPanelDefinition as ah, type HeaderProps as ai, type LabelProps as aj, type ParagraphProps as ak, type ButtonProps as al, type TextInputProps as am, type PasswordInputProps as an, type NumberInputProps as ao, type TextAreaProps as ap, type DateTimeInputProps as aq, type SelectProps as ar, type IconPickerProps as as, type VerticalStackProps as at, type HorizontalStackProps as au, type GridProps as av, type DividerProps as aw, type IconProps as ax, type IconButtonType as ay, type IconButtonProps as az, type StreamEvent as b, type ToolSettingsViewDefinition as c, type ToolSettingsView as d, type ToolSettingsListView as e, type ToolSettingsListMapping as f, type ToolSettingsComponentView as g, type ToolSettingsActionDataSource as h, type PanelView as i, type PanelComponentView as j, type PanelActionDataSource as k, type PanelUnknownView as l, type ProviderDefinition as m, type ProviderConfigView as n, type PromptContribution as o, type PromptSection as p, type ToolDefinition as q, resolveLocalizedString as r, type ToolConfirmationConfig as s, type CommandDefinition as t, type ExtensionContext as u, type SettingsAPI as v, type ProvidersAPI as w, type ToolsAPI as x, type ActionsAPI as y, type EventsAPI as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stina/extension-api",
-  "version": "0.32.0",
+  "version": "0.33.0-alpha.8cab91c",
   "private": false,
   "repository": {
     "type": "git",