@seed-ship/mcp-ui-solid 2.10.3 → 2.12.0

package/src/components/FormFieldRenderer.tsx

@@ -27,6 +27,10 @@ export const FormFieldRenderer: Component<FormFieldRendererProps> = (props) => {
     formData: props.formData || (() => ({})),
   })
 
+  const status = () => props.field.fieldStatus || 'optional'
+  const isUnsupported = () => status() === 'unsupported'
+  const isFieldDisabled = () => props.disabled || isUnsupported()
+
   const baseInputClass = () => `
     w-full px-3 py-2 border rounded-md
     focus:ring-2 focus:ring-blue-500 focus:border-blue-500
@@ -35,6 +39,7 @@ export const FormFieldRenderer: Component<FormFieldRendererProps> = (props) => {
       ? 'border-red-500 focus:ring-red-500'
       : 'border-gray-300 dark:border-gray-600'}
     dark:bg-gray-700 dark:text-white
+    ${isUnsupported() ? 'opacity-50' : ''}
   `
 
   const fieldId = () => `field-${props.field.name}`
@@ -46,12 +51,18 @@ export const FormFieldRenderer: Component<FormFieldRendererProps> = (props) => {
       <Show when={props.field.label && props.field.type !== 'checkbox'}>
         <label
           for={fieldId()}
-          class="block text-sm font-medium text-gray-700 dark:text-gray-300"
+          class={`block text-sm font-medium ${isUnsupported() ? 'text-gray-400 dark:text-gray-500' : 'text-gray-700 dark:text-gray-300'}`}
         >
           {props.field.label}
-          <Show when={props.field.required}>
+          <Show when={props.field.required || status() === 'required'}>
             <span class="text-red-500 ml-1" aria-hidden="true">*</span>
           </Show>
+          <Show when={isUnsupported()}>
+            <span class="ml-2 text-[10px] font-medium bg-orange-100 dark:bg-orange-900/30 text-orange-600 dark:text-orange-400 px-1.5 py-0.5 rounded">Not supported</span>
+          </Show>
+          <Show when={status() === 'unknown'}>
+            <span class="ml-2 text-[10px] font-medium bg-yellow-100 dark:bg-yellow-900/30 text-yellow-600 dark:text-yellow-400 px-1.5 py-0.5 rounded">?</span>
+          </Show>
         </label>
       </Show>
 
@@ -251,7 +262,18 @@ export const FormFieldRenderer: Component<FormFieldRendererProps> = (props) => {
         </Match>
       </Switch>
 
-      <Show when={props.field.helpText && !props.error}>
+      <Show when={props.field.statusReason}>
+        <p class={`text-xs ${
+          isUnsupported() ? 'text-orange-500 dark:text-orange-400'
+          : status() === 'unknown' ? 'text-yellow-500 dark:text-yellow-400'
+          : status() === 'required' ? 'text-blue-500 dark:text-blue-400'
+          : 'text-gray-500 dark:text-gray-400'
+        }`}>
+          {props.field.statusReason}
+        </p>
+      </Show>
+
+      <Show when={props.field.helpText && !props.error && !props.field.statusReason}>
         <p class="text-xs text-gray-500 dark:text-gray-400">{props.field.helpText}</p>
       </Show>
 

package/src/components/ScratchpadPanel.tsx

@@ -15,6 +15,10 @@ export interface ScratchpadPanelProps {
   onFilterChange?: (filters: Record<string, string | string[]>) => void
   onAction?: (action: string, data?: unknown) => void
   onSectionEdit?: (sectionId: string, content: unknown) => void
+  /** Dedicated callback for form submissions (cleaner than onAction) */
+  onSubmit?: (sectionId: string, values: Record<string, unknown>) => void
+  /** Called when user clicks retry on error state */
+  onRetry?: () => void
   onClose?: () => void
   closable?: boolean
   autoCloseDelay?: number
@@ -28,6 +32,7 @@ const STATUS_BADGES: Record<ScratchpadState['status'], { label: string; class: s
   waiting_human: { label: 'Your turn', class: 'bg-blue-100 text-blue-700 dark:bg-blue-900/30 dark:text-blue-400 animate-pulse' },
   processing: { label: 'Processing...', class: 'bg-purple-100 text-purple-700 dark:bg-purple-900/30 dark:text-purple-400' },
   complete: { label: 'Complete', class: 'bg-green-100 text-green-600 dark:bg-green-900/30 dark:text-green-400' },
+  error: { label: 'Error', class: 'bg-red-100 text-red-600 dark:bg-red-900/30 dark:text-red-400' },
 }
 
 export const ScratchpadPanel: Component<ScratchpadPanelProps> = (props) => {
@@ -59,8 +64,8 @@ export const ScratchpadPanel: Component<ScratchpadPanelProps> = (props) => {
     previewTimer = setTimeout(async () => {
       try {
         const res = await fetch(endpoint, {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
+          method: props.state.previewMethod || 'POST',
+          headers: { 'Content-Type': 'application/json', ...props.state.previewHeaders },
           credentials: 'include',
           body: JSON.stringify({ filters }),
         })
@@ -141,6 +146,7 @@ export const ScratchpadPanel: Component<ScratchpadPanelProps> = (props) => {
                   onFilterChange={props.onFilterChange}
                   onAction={props.onAction}
                   onSectionEdit={props.onSectionEdit}
+                  onSubmit={props.onSubmit}
                 />
               )}
             </For>
@@ -193,6 +199,35 @@ export const ScratchpadPanel: Component<ScratchpadPanelProps> = (props) => {
             </div>
           </Show>
 
+          {/* Error state with retry */}
+          <Show when={props.state.status === 'error' && props.state.error}>
+            <div class="px-4 py-3 border-t border-red-100 dark:border-red-900/30 bg-red-50 dark:bg-red-900/10">
+              <div class="flex items-start gap-2 text-sm text-red-700 dark:text-red-400">
+                <span class="flex-shrink-0 mt-0.5">⚠️</span>
+                <div class="flex-1">
+                  <p class="font-medium">{props.state.error!.message}</p>
+                  <Show when={props.state.error!.code}>
+                    <p class="text-xs text-red-500 dark:text-red-500 mt-0.5">Code: {props.state.error!.code}</p>
+                  </Show>
+                </div>
+              </div>
+              <div class="flex gap-2 mt-2">
+                <Show when={props.state.error!.retryable !== false}>
+                  <button type="button" onClick={() => props.onRetry?.()}
+                    class="px-3 py-1.5 text-sm font-medium rounded-lg bg-red-600 text-white hover:bg-red-700 transition-colors flex items-center gap-1">
+                    &#128260; Retry
+                  </button>
+                </Show>
+                <Show when={props.onClose}>
+                  <button type="button" onClick={() => props.onClose?.()}
+                    class="px-3 py-1.5 text-sm font-medium rounded-lg border border-gray-200 dark:border-gray-600 text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors">
+                    Close
+                  </button>
+                </Show>
+              </div>
+            </div>
+          </Show>
+
           {/* Search button when waiting_human */}
           <Show when={props.state.status === 'waiting_human' && hasFilters()}>
             <div class="px-4 py-3 border-t border-gray-100 dark:border-gray-700">
@@ -224,6 +259,7 @@ const SectionRenderer: Component<{
   onFilterChange?: (filters: Record<string, string | string[]>) => void
   onAction?: (action: string, data?: unknown) => void
   onSectionEdit?: (sectionId: string, content: unknown) => void
+  onSubmit?: (sectionId: string, values: Record<string, unknown>) => void
 }> = (props) => {
   return (
     <div class="px-4 py-3">
@@ -234,7 +270,7 @@ const SectionRenderer: Component<{
         <Match when={props.section.type === 'message'}><p class="text-sm text-gray-700 dark:text-gray-300">{String(props.section.content)}</p></Match>
         <Match when={props.section.type === 'action'}><ActionSection content={props.section.content} onAction={props.onAction} /></Match>
         <Match when={props.section.type === 'steps'}><EnrichedStepsSection content={props.section.content} onAction={props.onAction} onFilterChange={props.onFilterChange} /></Match>
-        <Match when={props.section.type === 'form'}><EmbeddedFormSection content={props.section.content} sectionId={props.section.id} onAction={props.onAction} /></Match>
+        <Match when={props.section.type === 'form'}><EmbeddedFormSection content={props.section.content} sectionId={props.section.id} onAction={props.onAction} onSubmit={props.onSubmit} /></Match>
         <Match when={props.section.type === 'understanding'}><UnderstandingSection content={props.section.content} /></Match>
         <Match when={props.section.type === 'feedback'}><FeedbackSection content={props.section.content} onAction={props.onAction} /></Match>
         <Match when={props.section.type === 'prompt'}><PromptSection content={props.section.content} onAction={props.onAction} /></Match>
@@ -362,6 +398,7 @@ const EmbeddedFormSection: Component<{
   content: unknown
   sectionId: string
   onAction?: (action: string, data?: unknown) => void
+  onSubmit?: (sectionId: string, values: Record<string, unknown>) => void
 }> = (props) => {
   const [formData, setFormData] = createSignal<Record<string, any>>({})
   const [dynamicOptions, setDynamicOptions] = createSignal<Record<string, Array<{ label: string; value: string }>>>({})
@@ -403,7 +440,22 @@ const EmbeddedFormSection: Component<{
 
   const handleSubmit = (e: Event) => {
     e.preventDefault()
-    props.onAction?.('submit_form', { sectionId: props.sectionId, values: formData() })
+
+    // Filter out unsupported fields, keep only values with content
+    const values = Object.fromEntries(
+      Object.entries(formData())
+        .filter(([key]) => {
+          const field = config().fields.find((f: any) => f.name === key)
+          return field?.fieldStatus !== 'unsupported'
+        })
+        .filter(([, v]) => v !== undefined && v !== '' && !(Array.isArray(v) && v.length === 0))
+    )
+
+    if (props.onSubmit) {
+      props.onSubmit(props.sectionId, values)
+    } else {
+      props.onAction?.('submit_form', { sectionId: props.sectionId, values })
+    }
   }
 
   return (
@@ -564,47 +616,56 @@ const FeedbackSection: Component<{
   onAction?: (action: string, data?: unknown) => void
 }> = (props) => {
   const [comment, setComment] = createSignal('')
+  const [showComment, setShowComment] = createSignal(false)
   const data = () => {
     const c = props.content as any
+    // Support both formats: options array (universal) and approve/reject (simple)
+    const options = c?.options || [
+      { value: c?.approve?.value || 'approve', label: c?.approve?.label || 'Yes', icon: '👍', variant: 'primary' },
+      { value: c?.reject?.value || 'reject', label: c?.reject?.label || 'No', icon: '👎' },
+    ]
     return {
       question: c?.question || '',
-      approve: c?.approve || { label: 'Yes', value: 'approve' },
-      reject: c?.reject || { label: 'No', value: 'reject' },
-      allowComment: c?.allowComment ?? false,
-      commentPlaceholder: c?.commentPlaceholder || 'Add a comment...',
+      options: options as Array<{ value: string; label: string; icon?: string; variant?: string; needsComment?: boolean }>,
+      allowFreeText: c?.allowFreeText ?? c?.allowComment ?? false,
+      placeholder: c?.placeholder || c?.commentPlaceholder || 'Add a comment...',
     }
   }
 
-  const handleFeedback = (approved: boolean) => {
-    const d = data()
-    props.onAction?.('feedback', {
-      approved,
-      value: approved ? d.approve.value : d.reject.value,
-      comment: comment(),
-    })
+  const handleOption = (option: any) => {
+    if (option.needsComment) {
+      setShowComment(true)
+      return
+    }
+    props.onAction?.('feedback', { option: option.value, comment: comment() })
   }
 
   return (
     <div class="space-y-3">
       <p class="text-sm text-gray-700 dark:text-gray-300">{data().question}</p>
-      <div class="flex gap-2">
-        <button type="button" onClick={() => handleFeedback(true)}
-          class="px-3 py-1.5 text-sm font-medium rounded-lg bg-green-600 text-white hover:bg-green-700 transition-colors flex items-center gap-1">
-          &#128077; {data().approve.label}
-        </button>
-        <button type="button" onClick={() => handleFeedback(false)}
-          class="px-3 py-1.5 text-sm font-medium rounded-lg border border-gray-200 dark:border-gray-600 text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors flex items-center gap-1">
-          &#128078; {data().reject.label}
-        </button>
+      <div class="flex flex-wrap gap-2">
+        <For each={data().options}>
+          {(option) => (
+            <button type="button" onClick={() => handleOption(option)}
+              class={`px-3 py-1.5 text-sm font-medium rounded-lg transition-colors flex items-center gap-1 ${
+                option.variant === 'primary' ? 'bg-blue-600 text-white hover:bg-blue-700'
+                : option.variant === 'danger' ? 'bg-red-600 text-white hover:bg-red-700'
+                : 'border border-gray-200 dark:border-gray-600 text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700'
+              }`}>
+              <Show when={option.icon}><span>{option.icon}</span></Show>
+              {option.label}
+            </button>
+          )}
+        </For>
       </div>
-      <Show when={data().allowComment}>
-        <input
-          type="text"
-          value={comment()}
-          onInput={(e) => setComment(e.currentTarget.value)}
-          placeholder={data().commentPlaceholder}
-          class="w-full px-3 py-2 text-sm border border-gray-200 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:border-blue-400 outline-none"
-        />
+      <Show when={data().allowFreeText || showComment()}>
+        <div class="flex gap-1">
+          <input type="text" value={comment()} onInput={(e) => setComment(e.currentTarget.value)}
+            placeholder={data().placeholder} autofocus={showComment()}
+            class="flex-1 px-3 py-2 text-sm border border-gray-200 dark:border-gray-600 rounded-lg bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:border-blue-400 outline-none" />
+          <button type="button" onClick={() => props.onAction?.('feedback', { option: 'comment', comment: comment() })}
+            class="px-3 py-2 text-sm bg-blue-600 text-white rounded-lg hover:bg-blue-700">Send</button>
+        </div>
       </Show>
     </div>
   )

package/src/types/chat-bus.ts

@@ -339,11 +339,17 @@ export interface ScratchpadState {
   preview?: { count: number; rows?: Record<string, unknown>[]; summary: string }
   /** Agent messages (explanations, questions) */
   agentMessages: Array<{ text: string; type: 'info' | 'question' | 'warning' }>
-  status: 'loading' | 'ready' | 'waiting_human' | 'processing' | 'complete'
+  status: 'loading' | 'ready' | 'waiting_human' | 'processing' | 'complete' | 'error'
+  /** Error details when status is 'error' */
+  error?: { message: string; code?: string; retryable?: boolean }
   /** Endpoint for auto-refresh preview when filters change */
   previewEndpoint?: string
   /** Debounce delay for preview refresh (ms, default 500) */
   previewDebounce?: number
+  /** HTTP method for preview (default POST) */
+  previewMethod?: 'GET' | 'POST'
+  /** Extra headers for preview fetch */
+  previewHeaders?: Record<string, string>
   /** Current turn number (multi-tour) */
   turn?: number
   /** Total expected turns */

package/src/types/index.ts

@@ -359,6 +359,12 @@ export interface FormFieldParams {
     extraParams?: Record<string, string>
   }
 
+  // Field status — API capability indicator
+  /** Whether this field is supported by the target API/dataset */
+  fieldStatus?: 'required' | 'optional' | 'unsupported' | 'unknown'
+  /** Human-readable explanation of the status */
+  statusReason?: string
+
   // Checkbox specific
   checkboxLabel?: string