@seed-ship/mcp-ui-solid 2.6.4 → 2.8.0

package/src/types/chat-bus.ts

@@ -58,6 +58,9 @@ export interface ChatEvents {
   onBriefing: (event: ChatEventBase & { briefing: BriefingEvent }) => void
   onCapabilityChange: (event: ChatEventBase & { capabilities: string[] }) => void
 
+  // --- Scratchpad (HITL shared workspace) ---
+  onScratchpad: (event: ChatEventBase & { scratchpad: ScratchpadEvent }) => void
+
   // --- Fallback ---
   onCustomEvent: (type: string, event: ChatEventBase & { data: unknown }) => void
 }
@@ -221,8 +224,29 @@ export interface FormPromptConfig {
     checkboxLabel?: string
     /** Help text below field */
     helpText?: string
+    /** Dependent field — update options when parent field changes */
+    dependsOn?: {
+      field: string
+      apiUrl: string
+      labelField: string
+      valueField: string
+      extraParams?: Record<string, string>
+    }
+    /** Conditional visibility (show/hide based on another field value) */
+    showWhen?: { field: string; operator: 'equals' | 'not_equals' | 'in'; value: any }
   }>
   submitLabel?: string
+  /** Live preview configuration — shows stats as user fills the form */
+  preview?: {
+    /** API endpoint to call for preview */
+    endpoint: string
+    /** Debounce delay in ms (default: 500) */
+    debounceMs?: number
+    /** Fields to include in the preview request */
+    fields: string[]
+    /** Display format */
+    format?: 'text' | 'stats'
+  }
 }
 
 export interface SelectPromptConfig {
@@ -293,6 +317,52 @@ export interface BriefingSection {
   components?: UIComponent[]
 }
 
+// ─── Scratchpad types ────────────────────────────────────────
+
+/**
+ * @experimental
+ * Scratchpad state — shared workspace between agent and human.
+ * The agent fills sections, the human can edit filters and validate.
+ */
+export interface ScratchpadState {
+  id: string
+  title: string
+  sections: ScratchpadSection[]
+  /** Active filters — human can add/remove */
+  filters: Record<string, string | string[]>
+  /** Live preview (auto-updated when filters change) */
+  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'
+}
+
+export interface ScratchpadSection {
+  id: string
+  title: string
+  type: 'data' | 'filter' | 'preview' | 'message' | 'action' | 'steps' | 'form'
+  content: unknown
+  /** Can the human edit this section? */
+  editable: boolean
+  /** Who filled this section */
+  source: 'agent' | 'human' | 'api'
+}
+
+/**
+ * @experimental
+ * SSE event for scratchpad create/update/close.
+ */
+export interface ScratchpadEvent {
+  id: string
+  action: 'create' | 'update' | 'close'
+  title?: string
+  sections?: ScratchpadSection[]
+  filters?: Record<string, string | string[]>
+  preview?: { count: number; rows?: Record<string, unknown>[]; summary: string }
+  agentMessages?: Array<{ text: string; type: 'info' | 'question' | 'warning' }>
+  status?: ScratchpadState['status']
+}
+
 // ─── SSE / Stream types ──────────────────────────────────────
 
 export interface StreamDoneMetadata {

package/src/types/index.ts

@@ -344,6 +344,21 @@ export interface FormFieldParams {
   /** Debounce delay in ms (default: 300) */
   debounceMs?: number
 
+  // Dependent field — update options when parent changes
+  /** Field dependency configuration */
+  dependsOn?: {
+    /** Name of the parent field */
+    field: string
+    /** API URL template — use {value} for parent value (e.g. '/departements/{value}/communes') */
+    apiUrl: string
+    /** Field in API response to display */
+    labelField: string
+    /** Field in API response for value */
+    valueField: string
+    /** Extra query parameters */
+    extraParams?: Record<string, string>
+  }
+
   // Checkbox specific
   checkboxLabel?: string