@stina/extension-api 0.32.0 → 0.33.0

package/src/schemas/contributions.schema.ts

@@ -18,121 +18,6 @@ export const LocalizedStringSchema = z
   .union([z.string(), z.record(z.string())])
   .describe('String or localized string map')
 
-// =============================================================================
-// Settings
-// =============================================================================
-
-/**
- * Options mapping for select field options from tool response
- */
-export const SettingOptionsMappingSchema = z
-  .object({
-    itemsKey: z.string().describe('Key for items array in tool result data'),
-    valueKey: z.string().describe('Key for option value'),
-    labelKey: z.string().describe('Key for option label'),
-    descriptionKey: z.string().optional().describe('Optional key for description'),
-  })
-  .describe('Mapping for select field options')
-
-/**
- * Create mapping for create tool response
- */
-export const SettingCreateMappingSchema = z
-  .object({
-    resultKey: z.string().optional().describe('Key for result data object'),
-    valueKey: z.string().describe('Key for option value (defaults to "id")'),
-  })
-  .describe('Mapping for create tool response')
-
-/**
- * Validation rules for settings
- */
-export const SettingValidationSchema = z
-  .object({
-    required: z.boolean().optional().describe('Whether the field is required'),
-    min: z.number().optional().describe('Minimum value (number) or length (string)'),
-    max: z.number().optional().describe('Maximum value (number) or length (string)'),
-    pattern: z.string().optional().describe('Regex pattern for validation'),
-  })
-  .describe('Validation rules')
-
-/**
- * Setting definition type interface for recursive typing
- */
-export interface SettingDefinitionType {
-  id: string
-  title: string
-  description?: string
-  type: 'string' | 'number' | 'boolean' | 'select'
-  default?: unknown
-  options?: { value: string; label: string }[]
-  optionsToolId?: string
-  optionsParams?: Record<string, unknown>
-  optionsMapping?: z.infer<typeof SettingOptionsMappingSchema>
-  createToolId?: string
-  createLabel?: string
-  createFields?: SettingDefinitionType[]
-  createParams?: Record<string, unknown>
-  createMapping?: z.infer<typeof SettingCreateMappingSchema>
-  validation?: z.infer<typeof SettingValidationSchema>
-}
-
-export const SettingDefinitionSchema: z.ZodType<SettingDefinitionType> = z.lazy(() =>
-  z
-    .object({
-      id: z.string().describe('Setting ID (namespaced automatically)'),
-      title: z.string().describe('Display title'),
-      description: z.string().optional().describe('Help text'),
-      type: z.enum(['string', 'number', 'boolean', 'select']).describe('Setting type'),
-      default: z.unknown().optional().describe('Default value'),
-      options: z
-        .array(z.object({ value: z.string(), label: z.string() }))
-        .optional()
-        .describe('For select type: available options'),
-      optionsToolId: z.string().optional().describe('For select type: load options from tool'),
-      optionsParams: z.record(z.unknown()).optional().describe('Params for options tool'),
-      optionsMapping: SettingOptionsMappingSchema.optional().describe('Mapping for options tool response'),
-      createToolId: z.string().optional().describe('Tool ID for creating a new option'),
-      createLabel: z.string().optional().describe('Label for create action'),
-      createFields: z.array(SettingDefinitionSchema).optional().describe('Fields for create form'),
-      createParams: z.record(z.unknown()).optional().describe('Static params for create tool'),
-      createMapping: SettingCreateMappingSchema.optional().describe('Mapping for create tool response'),
-      validation: SettingValidationSchema.optional().describe('Validation rules'),
-    })
-    .superRefine((data, ctx) => {
-      // Validate that create* fields are only used with type: 'select'
-      const hasCreateFields =
-        data.createToolId !== undefined ||
-        data.createLabel !== undefined ||
-        data.createFields !== undefined ||
-        data.createParams !== undefined ||
-        data.createMapping !== undefined
-
-      if (hasCreateFields && data.type !== 'select') {
-        ctx.addIssue({
-          code: z.ZodIssueCode.custom,
-          message: 'create* fields (createToolId, createLabel, createFields, createParams, createMapping) are only valid for type "select"',
-          path: ['type'],
-        })
-      }
-
-      // Validate that select type has options or optionsToolId
-      if (data.type === 'select') {
-        const hasOptions = data.options && data.options.length > 0
-        const hasOptionsToolId = data.optionsToolId !== undefined
-
-        if (!hasOptions && !hasOptionsToolId) {
-          ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: 'Setting of type "select" must have "options" or "optionsToolId"',
-            path: ['type'],
-          })
-        }
-      }
-    })
-    .describe('Setting definition')
-)
-
 // =============================================================================
 // Tool Settings Views
 // =============================================================================
@@ -177,6 +62,12 @@ export const ToolSettingsListViewSchema = z
     limitParam: z.string().optional().describe('Param name for limit'),
     idParam: z.string().optional().describe('Param name for get/delete ID'),
     listParams: z.record(z.unknown()).optional().describe('Static params for list tool'),
+    editView: z
+      .object({
+        content: ExtensionComponentDataSchema.describe('Root component for the create/edit modal'),
+      })
+      .optional()
+      .describe('Component-tree create/edit form bound to $item.<key>'),
   })
   .describe('List view backed by tools')
 
@@ -207,7 +98,6 @@ export const ToolSettingsViewDefinitionSchema = z
     title: z.string().describe('Display title'),
     description: z.string().optional().describe('Help text'),
     view: ToolSettingsViewSchema.describe('View configuration'),
-    fields: z.array(SettingDefinitionSchema).optional().describe('Fields for create/edit forms'),
   })
   .describe('Tool settings view definition')
 
@@ -271,60 +161,13 @@ export const PanelDefinitionSchema = z
 // =============================================================================
 
 /**
- * Provider config property type
- */
-export const ProviderConfigPropertyTypeSchema = z
-  .enum(['string', 'number', 'boolean', 'select', 'password', 'url'])
-  .describe('Property type')
-
-/**
- * Provider config select option
+ * Component-tree-based provider config view.
  */
-export const ProviderConfigSelectOptionSchema = z
+export const ProviderConfigViewSchema = z
   .object({
-    value: z.string().describe('Value stored in settings'),
-    label: z.string().describe('Display label'),
-  })
-  .describe('Select option')
-
-/**
- * Provider config validation
- */
-export const ProviderConfigValidationSchema = z
-  .object({
-    pattern: z.string().optional().describe('Regex pattern the value must match'),
-    minLength: z.number().optional().describe('Minimum string length'),
-    maxLength: z.number().optional().describe('Maximum string length'),
-    min: z.number().optional().describe('Minimum number value'),
-    max: z.number().optional().describe('Maximum number value'),
-  })
-  .describe('Validation rules')
-
-/**
- * Provider config property
- */
-export const ProviderConfigPropertySchema = z
-  .object({
-    type: ProviderConfigPropertyTypeSchema.describe('Property type'),
-    title: z.string().describe('Display label'),
-    description: z.string().optional().describe('Help text'),
-    default: z.unknown().optional().describe('Default value'),
-    required: z.boolean().optional().describe('Whether the field is required'),
-    placeholder: z.string().optional().describe('Placeholder text'),
-    options: z.array(ProviderConfigSelectOptionSchema).optional().describe('For select type'),
-    validation: ProviderConfigValidationSchema.optional().describe('Validation rules'),
-  })
-  .describe('Provider config property')
-
-/**
- * Provider config schema
- */
-export const ProviderConfigSchemaSchema = z
-  .object({
-    properties: z.record(ProviderConfigPropertySchema).describe('Property definitions'),
-    order: z.array(z.string()).optional().describe('Display order of properties'),
+    content: ExtensionComponentDataSchema.describe('Root component to render'),
   })
-  .describe('Provider configuration schema')
+  .describe('Provider configuration view (component tree)')
 
 /**
  * Provider definition
@@ -336,7 +179,7 @@ export const ProviderDefinitionSchema = z
     description: z.string().optional().describe('Description'),
     suggestedDefaultModel: z.string().optional().describe('Suggested default model'),
     defaultSettings: z.record(z.unknown()).optional().describe('Default settings'),
-    configSchema: ProviderConfigSchemaSchema.optional().describe('Configuration UI schema'),
+    configView: ProviderConfigViewSchema.optional().describe('Component-tree configuration view'),
   })
   .describe('Provider definition')
 
@@ -429,7 +272,6 @@ export const StorageContributionsSchema = z
  */
 export const ExtensionContributionsSchema = z
   .object({
-    settings: z.array(SettingDefinitionSchema).optional().describe('User-configurable settings'),
     toolSettings: z.array(ToolSettingsViewDefinitionSchema).optional().describe('Tool settings views'),
     panels: z.array(PanelDefinitionSchema).optional().describe('Right panel contributions'),
     providers: z.array(ProviderDefinitionSchema).optional().describe('AI providers'),
@@ -445,10 +287,6 @@ export const ExtensionContributionsSchema = z
 // =============================================================================
 
 export type LocalizedString = z.infer<typeof LocalizedStringSchema>
-export type SettingOptionsMapping = z.infer<typeof SettingOptionsMappingSchema>
-export type SettingCreateMapping = z.infer<typeof SettingCreateMappingSchema>
-export type SettingValidation = z.infer<typeof SettingValidationSchema>
-export type SettingDefinition = z.infer<typeof SettingDefinitionSchema>
 export type ToolSettingsListMapping = z.infer<typeof ToolSettingsListMappingSchema>
 export type ToolSettingsActionDataSource = z.infer<typeof ToolSettingsActionDataSourceSchema>
 export type ToolSettingsListView = z.infer<typeof ToolSettingsListViewSchema>
@@ -460,11 +298,7 @@ export type PanelComponentView = z.infer<typeof PanelComponentViewSchema>
 export type PanelUnknownView = z.infer<typeof PanelUnknownViewSchema>
 export type PanelView = z.infer<typeof PanelViewSchema>
 export type PanelDefinition = z.infer<typeof PanelDefinitionSchema>
-export type ProviderConfigPropertyType = z.infer<typeof ProviderConfigPropertyTypeSchema>
-export type ProviderConfigSelectOption = z.infer<typeof ProviderConfigSelectOptionSchema>
-export type ProviderConfigValidation = z.infer<typeof ProviderConfigValidationSchema>
-export type ProviderConfigProperty = z.infer<typeof ProviderConfigPropertySchema>
-export type ProviderConfigSchema = z.infer<typeof ProviderConfigSchemaSchema>
+export type ProviderConfigView = z.infer<typeof ProviderConfigViewSchema>
 export type ProviderDefinition = z.infer<typeof ProviderDefinitionSchema>
 export type ToolDefinition = z.infer<typeof ToolDefinitionSchema>
 export type CommandDefinition = z.infer<typeof CommandDefinitionSchema>

package/src/schemas/index.ts

@@ -39,10 +39,6 @@ export {
 export {
   ExtensionContributionsSchema,
   LocalizedStringSchema,
-  SettingDefinitionSchema,
-  SettingOptionsMappingSchema,
-  SettingCreateMappingSchema,
-  SettingValidationSchema,
   ToolSettingsViewDefinitionSchema,
   ToolSettingsViewSchema,
   ToolSettingsListViewSchema,
@@ -55,21 +51,13 @@ export {
   PanelUnknownViewSchema,
   PanelActionDataSourceSchema,
   ProviderDefinitionSchema,
-  ProviderConfigSchemaSchema,
-  ProviderConfigPropertySchema,
-  ProviderConfigPropertyTypeSchema,
-  ProviderConfigSelectOptionSchema,
-  ProviderConfigValidationSchema,
+  ProviderConfigViewSchema,
   ToolDefinitionSchema,
   CommandDefinitionSchema,
   PromptContributionSchema,
   PromptSectionSchema,
   type ExtensionContributions,
   type LocalizedString,
-  type SettingDefinition,
-  type SettingOptionsMapping,
-  type SettingCreateMapping,
-  type SettingValidation,
   type ToolSettingsViewDefinition,
   type ToolSettingsView,
   type ToolSettingsListView,
@@ -82,11 +70,7 @@ export {
   type PanelUnknownView,
   type PanelActionDataSource,
   type ProviderDefinition,
-  type ProviderConfigSchema,
-  type ProviderConfigProperty,
-  type ProviderConfigPropertyType,
-  type ProviderConfigSelectOption,
-  type ProviderConfigValidation,
+  type ProviderConfigView,
   type ToolDefinition,
   type CommandDefinition,
   type PromptContribution,

package/src/types.components.ts

@@ -261,6 +261,11 @@ export interface ParagraphProps extends ExtensionComponentData {
 export 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
 }
 
@@ -270,7 +275,42 @@ export interface TextInputProps extends ExtensionComponentData {
   label: string
   placeholder?: string
   value?: string
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
+}
+
+/** The extension API properties for the PasswordInput component. */
+export interface PasswordInputProps extends ExtensionComponentData {
+  component: 'PasswordInput'
+  label: string
+  placeholder?: string
+  value?: string
+  onChangeAction?: ExtensionActionRef
+}
+
+/** The extension API properties for the NumberInput component. */
+export 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. */
+export 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. */
@@ -278,7 +318,7 @@ export interface DateTimeInputProps extends ExtensionComponentData {
   component: 'DateTimeInput'
   label: string
   value?: string
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
 }
 
 /** The extension API properties for the Select component. */
@@ -287,7 +327,7 @@ export interface SelectProps extends ExtensionComponentData {
   label: string
   options: Array<{ label: string; value: string }>
   selectedValue?: string
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
 }
 
 /** The extension API properties for the IconPicker component. */
@@ -295,7 +335,7 @@ export interface IconPickerProps extends ExtensionComponentData {
   component: 'IconPicker'
   label?: string
   value?: string
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
 }
 
 /** The extension API properties for the VerticalStack component. */
@@ -371,7 +411,7 @@ export interface ToggleProps extends ExtensionComponentData {
   description?: string
   checked?: boolean
   disabled?: boolean
-  onChangeAction: ExtensionActionRef
+  onChangeAction?: ExtensionActionRef
 }
 
 /** The extension API properties for the Collapsible component. */
@@ -415,7 +455,7 @@ export 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. */

package/src/types.contributions.ts

@@ -11,8 +11,6 @@ import type { ExtensionComponentData } from './types.components.js'
  * What an extension can contribute to Stina
  */
 export interface ExtensionContributions {
-  /** User-configurable settings */
-  settings?: SettingDefinition[]
   /** Tool settings views for UI */
   toolSettings?: ToolSettingsViewDefinition[]
   /** Right panel contributions */
@@ -36,75 +34,6 @@ export interface ExtensionContributions {
   }
 }
 
-// ============================================================================
-// Settings
-// ============================================================================
-
-/**
- * Setting definition for the UI
- */
-export 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
- */
-export 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
- */
-export interface SettingCreateMapping {
-  /** Key for result data object */
-  resultKey?: string
-  /** Key for option value (defaults to "id") */
-  valueKey: string
-}
-
 // ============================================================================
 // Tool Settings Views
 // ============================================================================
@@ -121,8 +50,6 @@ export interface ToolSettingsViewDefinition {
   description?: string
   /** View configuration */
   view: ToolSettingsView
-  /** Fields for create/edit forms (uses SettingDefinition) */
-  fields?: SettingDefinition[]
 }
 
 /**
@@ -154,6 +81,16 @@ export 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
+  }
 }
 
 /**
@@ -272,79 +209,23 @@ export 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.
- */
-export 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
- */
-export 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.
- */
-export 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
- */
-export 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.
  */
-export 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
+export interface ProviderConfigView {
+  /** Component tree describing the form. */
+  content: import('./types.components.js').ExtensionComponentData
 }
 
 // ============================================================================

package/src/types.ts

@@ -22,10 +22,6 @@ export type {
 // Contributions
 export type {
   ExtensionContributions,
-  // Settings
-  SettingDefinition,
-  SettingOptionsMapping,
-  SettingCreateMapping,
   // Tool Settings Views
   ToolSettingsViewDefinition,
   ToolSettingsView,
@@ -41,11 +37,7 @@ export type {
   PanelComponentView,
   // Providers
   ProviderDefinition,
-  ProviderConfigSchema,
-  ProviderConfigPropertyType,
-  ProviderConfigProperty,
-  ProviderConfigSelectOption,
-  ProviderConfigValidation,
+  ProviderConfigView,
   // Tools
   ToolDefinition,
   ToolConfirmationConfig,