@skopon-cool/form-sdk 0.4.5 → 0.4.7

package/dist/submit/intersectPayloadBlocksWithForm.d.ts

@@ -25,8 +25,10 @@ export declare function intersectPayloadBlocksWithForm(payloadDef: PayloadBlocks
 export declare function extractExtraBlockValues(extraBlocks: FormBlock[]): Record<string, unknown>;
 /** payload 是否含至少一个具 name 的 input 块（可用于卡片 fallback） */
 export declare function payloadHasInputBlocks(payloadDef: PayloadBlocksDefinition): boolean;
-/** 交集为空时 fallback：payload 中可上屏的 blocks（layout + input） */
+/** 交集为空时 fallback：payload 中可上屏的 blocks（layout + 非 hidden input） */
 export declare function getPayloadRenderableBlocks(payloadDef: PayloadBlocksDefinition): FormBlock[];
-/** payload 中所有 input 块 field name（fallback 提交用） */
+/** payload 中所有 input 块 field name（fallback 提交用，含 hidden） */
 export declare function getPayloadInputFieldNames(payloadDef: PayloadBlocksDefinition): string[];
+/** payload 中 hidden text 的默认提交值（fallback 不上屏时仍需写入 answer） */
+export declare function getPayloadHiddenBlockValues(payloadDef: PayloadBlocksDefinition): Record<string, unknown>;
 //# sourceMappingURL=intersectPayloadBlocksWithForm.d.ts.map

package/dist/submit/intersectPayloadBlocksWithForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intersectPayloadBlocksWithForm.d.ts","sourceRoot":"","sources":["../../src/submit/intersectPayloadBlocksWithForm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3D,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC,GAAG;IAC3F;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAA;CACxB,CAAA;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,SAAS,EAAE,CAAA;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAA;IACxB,0DAA0D;IAC1D,YAAY,EAAE,SAAS,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AAuED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAmBvF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,uBAAuB,EACnC,cAAc,EAAE,UAAU,GAAG,SAAS,GACrC,yBAAyB,CA+B3B;AA+BD,2CAA2C;AAC3C,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzF;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAIlF;AAED,0DAA0D;AAC1D,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,EAAE,CAK3F;AAED,mDAAmD;AACnD,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM,EAAE,CAIvF"}
+{"version":3,"file":"intersectPayloadBlocksWithForm.d.ts","sourceRoot":"","sources":["../../src/submit/intersectPayloadBlocksWithForm.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG3D,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC,GAAG;IAC3F;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAA;CACxB,CAAA;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,SAAS,EAAE,CAAA;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAA;IACxB,0DAA0D;IAC1D,YAAY,EAAE,SAAS,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AA8ED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAmBvF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,uBAAuB,EACnC,cAAc,EAAE,UAAU,GAAG,SAAS,GACrC,yBAAyB,CA+B3B;AA+BD,2CAA2C;AAC3C,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzF;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAIlF;AAED,mEAAmE;AACnE,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,uBAAuB,GAAG,SAAS,EAAE,CAO3F;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM,EAAE,CAIvF;AAED,6DAA6D;AAC7D,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,uBAAuB,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/dist/types/index.d.ts

@@ -31,9 +31,17 @@ export interface FormBlockOption {
     value: string;
     label: string;
 }
+export type FormConditionOperator = 'eq' | 'ne' | 'empty' | 'notEmpty';
+export interface FormBlockCondition {
+    fieldName: string;
+    operator: FormConditionOperator;
+    value?: string;
+}
 /** 简历多选组件：渲染时用于 /univ/resume/search 的筛选条件 */
 export interface FormResumeFilter {
     names?: string[];
+    /** Agent 类型（编辑器辅助，运行时不用） */
+    agentKind?: string;
     agentUniqueIds?: string[];
     resumeUniqueIds?: string[];
     pageSize?: number;
@@ -70,6 +78,12 @@ export interface FormBlock {
     fileMinCount?: number;
     fileMaxCount?: number;
     defaultValue?: string | string[] | boolean;
+    /** 派生 JSON Schema 时写入 property.$comment */
+    jsonSchemaDescription?: string;
+    /** 是否隐藏（仅 text 块；隐藏时仍提交） */
+    hidden?: boolean;
+    /** 是否需要 LLM 处理（持久化进 block json） */
+    needLLM?: boolean;
     /** 简历多选：是否显示「换一批」 */
     resumeEnableRefresh?: boolean;
     /** 简历多选：最少选中数量，配置值 ≥ 1 */
@@ -86,6 +100,7 @@ export interface FormBlock {
     caseMaxCount?: number;
     /** 案例单选：列表筛选条件（持久化进 block json） */
     caseFilter?: FormCaseFilter;
+    condition?: FormBlockCondition;
 }
 export interface FormSchema {
     title?: string;
@@ -96,6 +111,9 @@ export interface FormSchema {
 export declare function isMediaBlockType(type: FormBlockType): boolean;
 export declare function isLayoutBlockType(type: FormBlockType): boolean;
 export declare function isInputBlockType(type: FormBlockType): boolean;
+export declare function isDisplayBlockType(type: FormBlockType): boolean;
+export declare function isOptionsBlockType(type: FormBlockType): boolean;
+export declare function supportsDefaultValue(type: FormBlockType): boolean;
 export interface FormDefinitionPayload {
     title?: string;
     description?: string;

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "Skopon form rendering SDK (A2UI + form_definition) with submit helpers",
   "type": "module",
   "sideEffects": [

package/src/adapter/a2uiAdapter.test.ts

@@ -88,6 +88,31 @@ describe('a2uiAdapter blocks <-> surface', () => {
     expect(imgNode?.mediaSize).toBe('large')
   })
 
+  it('blocksToA2ui omits hidden text controls but keeps dataModel defaults', () => {
+    const doc = blocksToA2ui(
+      {
+        title: '',
+        description: '',
+        blocks: [
+          { id: 'b-title', type: 'text', name: 'title', label: '标题', defaultValue: 'shown' },
+          {
+            id: 'b-hint',
+            type: 'text',
+            name: 'agent_hint',
+            label: '提示',
+            defaultValue: 'secret',
+            hidden: true,
+          },
+        ],
+      },
+      { includeHeader: false },
+    )
+    expect(doc.components.some((c) => c.id === 'b-hint')).toBe(false)
+    expect(doc.components.some((c) => c.id === 'b-title')).toBe(true)
+    expect(doc.dataModel?.agent_hint).toBe('secret')
+    expect(doc.dataModel?.title).toBe('shown')
+  })
+
   it('blocksToA2ui preserves select vs multiselect picker types', () => {
     const doc = blocksToA2ui(
       {

package/src/adapter/a2uiAdapter.ts

@@ -147,6 +147,20 @@ function blockToComponent(block: FormBlock): {
       return { node: { id, component: 'Text', text: label, variant: 'body' } }
 
     case 'text':
+      // 隐藏 text：不生成可见控件，仍写入 dataModel 默认值供提交
+      if (block.hidden) {
+        return name
+          ? { node: null, dataKey: name, dataValue: defaultValueForBlock(block) }
+          : { node: null }
+      }
+      return withData({
+        id,
+        component: 'TextField',
+        label,
+        variant: 'shortText',
+        ...(block.placeholder ? { placeholder: block.placeholder } : {}),
+        value: { path },
+      })
     case 'tel':
     case 'url':
       return withData({
@@ -312,10 +326,11 @@ export function blocksToA2ui(
 
   for (const block of definition.blocks ?? []) {
     const { node, dataKey, dataValue } = blockToComponent(block)
+    // hidden 等无节点块仍可写入 dataModel，保证「不展示仍提交」
+    if (dataKey) dataModel[dataKey] = dataValue
     if (!node) continue
     components.push(node)
     childIds.push(node.id)
-    if (dataKey) dataModel[dataKey] = dataValue
   }
 
   components.unshift({ id: ROOT_ID, component: 'Column', children: childIds })

package/src/adapter/formSchema.test.ts

@@ -2,7 +2,11 @@
  * @vitest-environment node
  */
 import { describe, it, expect } from 'vitest'
-import { coerceToggleValue, normalizeFormDefinition } from './formSchema'
+import {
+  coerceToggleValue,
+  normalizeFormDefinition,
+  blocksToJsonSchema,
+} from './formSchema'
 import { mapFormDefinitionFromDto } from './resolveSurface'
 
 describe('coerceToggleValue', () => {
@@ -38,27 +42,104 @@ describe('normalizeFormDefinition toggle default', () => {
     expect(def.blocks[0]?.defaultValue).toBe(true)
   })
 
-  it('preserves jsonSchema from raw definition', () => {
-    const schema = { type: 'object', properties: { title: { type: 'string' } } }
+  it('regenerates jsonSchema from blocks', () => {
+    const def = normalizeFormDefinition({
+      title: 'Title',
+      description: 'Desc',
+      blocks: [
+        {
+          id: 'b1',
+          type: 'text',
+          name: 'title',
+          label: '标题',
+          required: true,
+        },
+      ],
+      jsonSchema: { type: 'object', properties: { stale: { type: 'number' } } },
+    })
+    expect(def.jsonSchema).toEqual(
+      blocksToJsonSchema(def.blocks, 'Title', 'Desc'),
+    )
+    expect(def.jsonSchema).toMatchObject({
+      type: 'object',
+      properties: { title: { type: 'string' } },
+      required: ['title'],
+    })
+  })
+})
+
+describe('normalizeFormDefinition preserves needLLM and editor fields', () => {
+  it('keeps needLLM, hidden, condition, jsonSchemaDescription after normalize', () => {
+    const def = normalizeFormDefinition({
+      title: '',
+      description: '',
+      blocks: [
+        {
+          id: 'b1',
+          type: 'text',
+          name: 'prompt',
+          label: 'Prompt',
+          needLLM: true,
+          hidden: true,
+          jsonSchemaDescription: 'for agent',
+          condition: { fieldName: 'other', operator: 'eq', value: '1' },
+        },
+        {
+          id: 'b0',
+          type: 'text',
+          name: 'other',
+          label: 'Other',
+        },
+      ],
+      jsonSchema: {},
+    })
+    const block = def.blocks.find((item) => item.name === 'prompt')
+    expect(block?.needLLM).toBe(true)
+    expect(block?.hidden).toBe(true)
+    expect(block?.jsonSchemaDescription).toBe('for agent')
+    expect(block?.condition).toEqual({
+      fieldName: 'other',
+      operator: 'eq',
+      value: '1',
+    })
+  })
+
+  it('keeps resumeFilter.agentKind', () => {
     const def = normalizeFormDefinition({
       title: '',
       description: '',
-      blocks: [],
-      jsonSchema: schema,
+      blocks: [
+        {
+          id: 'b1',
+          type: 'resume_multiselect',
+          name: 'partners',
+          resumeFilter: {
+            agentKind: 'management',
+            names: [],
+            agentUniqueIds: [],
+            resumeUniqueIds: [],
+            pageSize: 20,
+          },
+        },
+      ],
+      jsonSchema: {},
     })
-    expect(def.jsonSchema).toEqual(schema)
+    expect(def.blocks[0]?.resumeFilter?.agentKind).toBe('management')
   })
 })
 
 describe('mapFormDefinitionFromDto jsonSchema', () => {
-  it('reads json_schema snake_case from DTO', () => {
-    const schema = { type: 'object' }
+  it('regenerates jsonSchema from DTO blocks', () => {
     const def = mapFormDefinitionFromDto({
       title: 'T',
       blocks: [{ id: 'b1', type: 'text', name: 'x', label: 'X' }],
-      json_schema: schema,
+      json_schema: { type: 'object', properties: { stale: { type: 'number' } } },
+    })
+    expect(def?.jsonSchema).toMatchObject({
+      type: 'object',
+      title: 'T',
+      properties: { x: { type: 'string' } },
     })
-    expect(def?.jsonSchema).toEqual(schema)
   })
 })
 

package/src/adapter/formSchema.ts

@@ -1,5 +1,12 @@
-import type { FormBlock, FormBlockType, FormCaseFilter, FormResumeFilter, FormJsonSchema, FormSchema } from '../types/index'
-import { isInputBlockType, isMediaBlockType } from '../types/index'
+import type {
+  FormBlock,
+  FormBlockType,
+  FormCaseFilter,
+  FormResumeFilter,
+  FormJsonSchema,
+  FormSchema,
+} from '../types/index'
+import { isInputBlockType, isMediaBlockType, isOptionsBlockType } from '../types/index'
 import { generateId } from './id'
 import {
   filterFileAcceptExtensionsForTypes,
@@ -32,7 +39,7 @@ function normalizeFileUploadCount(raw: unknown, fallback = 1): number {
   return Math.max(0, Math.floor(num))
 }
 
-function normalizeMultiselectCount(raw: unknown, fallback = 1): number {
+export function normalizeMultiselectCount(raw: unknown, fallback = 1): number {
   const num = typeof raw === 'number' ? raw : Number(raw)
   if (!Number.isFinite(num)) return fallback
   return Math.max(1, Math.floor(num))
@@ -42,16 +49,27 @@ function normalizeDefaultValue(
   type: FormBlockType,
   raw: FormBlock['defaultValue'],
 ): FormBlock['defaultValue'] {
-  if (raw === undefined) return undefined
-  if (type === 'toggle') return coerceToggleValue(raw)
-  if (type === 'multiselect' || type === 'checkbox' || type === 'resume_multiselect' || type === 'case_multiselect') {
-    if (Array.isArray(raw)) return raw.map(String)
-    if (typeof raw === 'string' && raw) return [raw]
+  if (raw === undefined || raw === null) return undefined
+  if (type === 'toggle') {
+    return coerceToggleValue(raw)
+  }
+  if (
+    type === 'multiselect' ||
+    type === 'checkbox' ||
+    type === 'resume_multiselect' ||
+    type === 'case_multiselect'
+  ) {
+    if (Array.isArray(raw)) {
+      const values = raw.map(String).map((item) => item.trim()).filter(Boolean)
+      return values
+    }
+    if (typeof raw === 'string' && raw.trim()) return [raw.trim()]
     return []
   }
   if (typeof raw === 'boolean') return raw ? 'true' : 'false'
   if (Array.isArray(raw)) return raw.map(String)
-  return String(raw)
+  const trimmed = String(raw).trim()
+  return trimmed || undefined
 }
 
 /** n8n 等可能把 flowUniqueIds 发成 JSON 数组字符串；解析失败则 []。 */
@@ -100,8 +118,13 @@ function normalizeResumeFilter(raw: FormResumeFilter | undefined): FormResumeFil
     Number.isFinite(pageSizeRaw) && pageSizeRaw >= 1 && pageSizeRaw <= 100
       ? Math.floor(pageSizeRaw)
       : 20
+  const agentKind =
+    typeof raw?.agentKind === 'string' && raw.agentKind.trim()
+      ? raw.agentKind.trim()
+      : undefined
   return {
     names: Array.isArray(raw?.names) ? raw!.names.map(String).filter(Boolean) : [],
+    agentKind,
     agentUniqueIds: Array.isArray(raw?.agentUniqueIds)
       ? raw!.agentUniqueIds.map(String).filter(Boolean)
       : [],
@@ -148,12 +171,22 @@ function normalizeBlock(raw: FormBlock): FormBlock {
     fileMinCount: type === 'file' ? normalizeFileUploadCount(migrated.fileMinCount, 1) : undefined,
     fileMaxCount: type === 'file' ? normalizeFileUploadCount(migrated.fileMaxCount, 1) : undefined,
     defaultValue: normalizeDefaultValue(type, migrated.defaultValue),
+    jsonSchemaDescription: migrated.jsonSchemaDescription?.trim() ?? '',
+    hidden: type === 'text' ? migrated.hidden === true : undefined,
+    needLLM: migrated.needLLM === true ? true : undefined,
     options: Array.isArray(migrated.options)
       ? migrated.options.map((opt, index) => ({
           value: opt.value?.trim() || `option_${index + 1}`,
           label: opt.label?.trim() || `选项 ${index + 1}`,
         }))
       : undefined,
+    condition: migrated.condition?.fieldName
+      ? {
+          fieldName: migrated.condition.fieldName.trim(),
+          operator: migrated.condition.operator ?? 'eq',
+          value: migrated.condition.value,
+        }
+      : undefined,
     resumeEnableRefresh:
       type === 'resume_multiselect' ? migrated.resumeEnableRefresh !== false : undefined,
     resumeMinCount:
@@ -181,12 +214,175 @@ function normalizeBlock(raw: FormBlock): FormBlock {
   }
 }
 
+function getOptionValueSet(block: FormBlock): Set<string> {
+  return new Set((block.options ?? []).map((opt) => opt.value))
+}
+
+function buildMultiselectCountJsonSchema(
+  minCount: number | undefined,
+  maxCount: number | undefined,
+): Record<string, unknown> {
+  const schema: Record<string, unknown> = {
+    type: 'array',
+    items: { type: 'string' },
+  }
+  if (minCount !== undefined) {
+    schema.minItems = normalizeMultiselectCount(minCount, 1)
+  }
+  if (maxCount !== undefined) {
+    schema.maxItems = normalizeMultiselectCount(maxCount, 1)
+  }
+  return schema
+}
+
+export function resolveSchemaDefaultValue(block: FormBlock): unknown | undefined {
+  const normalized = normalizeDefaultValue(block.type, block.defaultValue)
+  if (normalized === undefined) return undefined
+
+  const optionValues = getOptionValueSet(block)
+
+  switch (block.type) {
+    case 'toggle':
+      return normalized as boolean
+    case 'number': {
+      const num = Number(normalized as string)
+      return Number.isNaN(num) ? undefined : num
+    }
+    case 'multiselect':
+    case 'checkbox': {
+      const values = (normalized as string[]).filter((item) => optionValues.has(item))
+      return values.length > 0 ? values : undefined
+    }
+    case 'select':
+    case 'radio': {
+      const value = normalized as string
+      return optionValues.has(value) ? value : undefined
+    }
+    case 'resume_multiselect':
+    case 'case_multiselect': {
+      const values = Array.isArray(normalized)
+        ? (normalized as string[]).map(String).filter(Boolean)
+        : []
+      return values.length > 0 ? values : undefined
+    }
+    default:
+      return normalized
+  }
+}
+
+function blockToJsonSchemaProperty(block: FormBlock): Record<string, unknown> | null {
+  const name = block.name?.trim()
+  if (!name || !isInputBlockType(block.type)) return null
+
+  let property: Record<string, unknown>
+
+  switch (block.type) {
+    case 'number':
+      property = { type: 'number' }
+      break
+    case 'toggle':
+      property = { type: 'boolean' }
+      break
+    case 'select':
+    case 'radio': {
+      property = { type: 'string' }
+      const enumValues = (block.options ?? []).map((opt) => opt.value).filter(Boolean)
+      if (enumValues.length > 0) property.enum = enumValues
+      break
+    }
+    case 'multiselect':
+    case 'checkbox': {
+      const enumValues = (block.options ?? []).map((opt) => opt.value).filter(Boolean)
+      property = {
+        type: 'array',
+        items:
+          enumValues.length > 0
+            ? { type: 'string', enum: enumValues }
+            : { type: 'string' },
+      }
+      break
+    }
+    case 'file': {
+      const minCount = normalizeFileUploadCount(block.fileMinCount, 1)
+      const maxCount = normalizeFileUploadCount(block.fileMaxCount, 1)
+      if (maxCount <= 1) {
+        property = { type: 'string' }
+      } else {
+        property = {
+          type: 'array',
+          items: { type: 'string' },
+          minItems: minCount,
+          maxItems: maxCount,
+        }
+      }
+      break
+    }
+    case 'resume_multiselect':
+      property = buildMultiselectCountJsonSchema(block.resumeMinCount, block.resumeMaxCount)
+      break
+    case 'case_multiselect':
+      property = buildMultiselectCountJsonSchema(block.caseMinCount, block.caseMaxCount)
+      break
+    case 'text':
+      property = { type: 'string' }
+      if (block.hidden) property['x-hidden'] = true
+      break
+    default:
+      property = { type: 'string' }
+      break
+  }
+
+  const comment = block.jsonSchemaDescription?.trim()
+  if (comment) property.$comment = comment
+
+  const defaultValue = resolveSchemaDefaultValue(block)
+  if (defaultValue !== undefined) property.default = defaultValue
+
+  return property
+}
+
+export function blocksToJsonSchema(
+  blocks: FormBlock[],
+  title?: string,
+  description?: string,
+): FormJsonSchema {
+  const properties: Record<string, Record<string, unknown>> = {}
+  const required: string[] = []
+
+  for (const block of blocks) {
+    const name = block.name?.trim()
+    if (!name || !isInputBlockType(block.type)) continue
+
+    const property = blockToJsonSchemaProperty(block)
+    if (!property) continue
+
+    properties[name] = property
+    if (block.required) required.push(name)
+  }
+
+  const schema: FormJsonSchema = {
+    type: 'object',
+    properties,
+    required,
+    additionalProperties: false,
+  }
+
+  const trimmedTitle = title?.trim()
+  const trimmedDescription = description?.trim()
+  if (trimmedTitle) schema.title = trimmedTitle
+  if (trimmedDescription) schema.description = trimmedDescription
+
+  return schema
+}
+
 export function syncFormDefinition(definition: FormSchema): FormSchema {
+  const title = definition.title ?? ''
+  const description = definition.description ?? ''
   return {
-    title: definition.title ?? '',
-    description: definition.description ?? '',
+    title,
+    description,
     blocks: definition.blocks,
-    jsonSchema: definition.jsonSchema ?? {},
+    jsonSchema: blocksToJsonSchema(definition.blocks, title, description),
   }
 }
 
@@ -199,7 +395,7 @@ export function normalizeFormDefinition(raw: FormSchema | undefined): FormSchema
     title: typeof raw.title === 'string' ? raw.title : '',
     description: typeof raw.description === 'string' ? raw.description : '',
     blocks,
-    jsonSchema: normalizeJsonSchema(raw.jsonSchema),
+    jsonSchema: {},
   })
 }
 
@@ -267,7 +463,3 @@ export function createEmptyBlock(type: FormBlockType): FormBlock {
 
   return block
 }
-
-function isOptionsBlockType(type: FormBlockType): boolean {
-  return type === 'select' || type === 'multiselect' || type === 'radio' || type === 'checkbox'
-}

package/src/components/AskUserFormCard.tsx

@@ -13,7 +13,7 @@ import {
 } from '../submit/buildAnswerAgentBody'
 import {
   extractExtraBlockValues,
-  getPayloadInputFieldNames,
+  getPayloadHiddenBlockValues,
   getPayloadRenderableBlocks,
   intersectPayloadBlocksWithForm,
   parsePayloadBlocksJson,
@@ -195,18 +195,29 @@ function AskUserFormCardBody({
     return []
   }, [intersection, usePayloadFallback, payloadDef])
 
-  const extraValues = useMemo(
-    () => (usePayloadFallback ? {} : extractExtraBlockValues(intersection?.extraBlocks ?? [])),
-    [usePayloadFallback, intersection],
+  const extraValues = useMemo(() => {
+    if (usePayloadFallback && payloadDef) {
+      // fallback：hidden 不上屏，提交仍带默认值
+      return getPayloadHiddenBlockValues(payloadDef)
+    }
+    const fromExtra = extractExtraBlockValues(intersection?.extraBlocks ?? [])
+    // 交集命中但 surface 可能为空（仅 hidden）时，兜底写入默认值
+    const fromHiddenMatched = extractExtraBlockValues(
+      (intersection?.matchedBlocks ?? []).filter(
+        (block) => block.type === 'text' && block.hidden === true,
+      ),
+    )
+    return { ...fromHiddenMatched, ...fromExtra }
+  }, [usePayloadFallback, payloadDef, intersection])
+
+  const fieldNames = useMemo(
+    () =>
+      renderBlocks
+        .filter((block) => block.name?.trim())
+        .map((block) => block.name!.trim()),
+    [renderBlocks],
   )
 
-  const fieldNames = useMemo(() => {
-    if (usePayloadFallback && payloadDef) return getPayloadInputFieldNames(payloadDef)
-    return renderBlocks
-      .filter((block) => block.name?.trim())
-      .map((block) => block.name!.trim())
-  }, [usePayloadFallback, payloadDef, renderBlocks])
-
   const surfaceTitle = intersection?.title ?? payloadDef?.title ?? ''
   const surfaceDescription = intersection?.description ?? payloadDef?.description ?? ''
 
@@ -313,12 +324,13 @@ function AskUserFormCardBody({
     setSubmitting(true)
     try {
       const cardValues = rendererRef.current?.getValues(fieldNames) ?? {}
-      const validationError = validateFormSubmitValues(renderBlocks, cardValues)
+      // extra/hidden 后合并：getValues 对未上屏字段可能为 undefined，不能覆盖默认值
+      const answer = { ...cardValues, ...extraValues }
+      const validationError = validateFormSubmitValues(renderBlocks, answer)
       if (validationError) {
         onNotifyRef.current?.('error', validationError.message)
         return
       }
-      const answer = { ...cardValues, ...extraValues }
 
       if (submitMode === 'post') {
         const url = (callbackUrl ?? '').trim()