Files
AgentLab/frontend/src/run/inputSchema.ts
T
ThearchyHelios 7739340607 普通用户建应用集成收尾:
- 问数据和个人应用的图放行绑定只读查询等合规工具的调用工具节点,只读和遮罩在这条路径上生效;被治理成写入的工具在只读运行里直接拒;知识库范围在工具层固定(图级默认值、参数名纠错、Agent 都改不了)
- 个人应用的刷新和个人蓝图的试运行只有拥有者能读:运行、事件、证据、工件、文件、运行与审批列表、对比、可验证报告、质询、假设分析、提取工作流一并收紧;个人蓝图的试运行不论谁发起都按个人应用约束
- 共享蓝图只给拥有者、对应应用的管理者、管理员,看不到的一律 404;审核副本归审核人;管理员看别人的个人应用只有元数据、可以归档
- 记录表跨版本汇总(只读挂载旧版本、按当前列 UNION ALL、各版本各自固定高水位,缺的版本照实写进印章);停用前发起的运行可以继续写旧版本;更正沿用原提交人、更正人记审计
- 约定收口:待办种类 review、事件 file.extracted、表单错误 file、模板定义带示例与预置;前端类型一次补齐、去掉临时的局部类型;审核待办卡不再给打不开的链接;读附件事件有中文说法;检查脚本补断言
2026-10-15 13:55:19 +08:00

104 lines
5.4 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 输入节点的字段 → agentlab.form/1 表单(X2:只有一个表单渲染器)。
*
* 正式运行的表单由服务端转好放在版本详情里(VersionDetailOut.input_schema,服务端 app/apps/forms.input_schema);
* 画布试运行用的是画布上还没保存的入口字段,只能在这里按同一套规则转:没写类型的按文本,可选值变成下拉,
* 说明、默认值照搬。两处规则对不上时以服务端为准——发起时服务端照版本快照校验,这里只决定怎么画。
*
* 文件字段(normal-user-apps N9):输入节点的字段写 type: file,转成 type 为 object、x-widget 为 file 的字段,允许的类型
* 和大小(accept、max_mb)进 x-file。值是上传后拿回的引用,没上传的不传。
*/
import type { FileLimits, FormField, FormSchema } from '../typesApp'
/** 输入节点的一个字段(canvas/nodeDefs 的 ioFields;type / enum / format / 上下限是应用平台新加的,老图没有) */
export interface InputField {
name: string
required?: boolean
description?: string
default?: unknown
example?: unknown
/** file:文件(上传后拿回的引用);表单里的 object 只给文件控件,输入节点上写 file */
type?: Exclude<FormField['type'], 'object'> | 'file'
enum?: (string | number)[]
format?: FormField['format']
/** 数字类型的上下限(闭区间,表单子集没有 exclusiveMinimum:「大于 0」的金额写 0.01) */
minimum?: number
maximum?: number
/** 文件字段:允许的类型(MIME 或扩展名)、大小上限(MB) */
accept?: string[]
max_mb?: number
}
/** 文件字段:type 为 object、x-widget 为 file,限制进 x-file(同服务端 apps/forms.input_schema) */
function fileField(f: InputField): FormField {
const limits: FileLimits = {}
if (Array.isArray(f.accept) && f.accept.length) limits.accept = f.accept.filter((a) => typeof a === 'string' && a)
if (typeof f.max_mb === 'number' && Number.isFinite(f.max_mb) && f.max_mb > 0) limits.max_mb = f.max_mb
const field: FormField = { type: 'object', title: f.name, 'x-widget': 'file' }
if (f.description) field.description = f.description
if (Object.keys(limits).length) field['x-file'] = limits
return field
}
const TYPES = new Set(['string', 'number', 'integer', 'boolean', 'array'])
const FORMATS = new Set(['date', 'date-time', 'email', 'uri'])
export function inputSchemaOf(fields: InputField[]): FormSchema {
const properties: Record<string, FormField> = {}
const required: string[] = []
for (const f of fields) {
if (!f?.name) continue
if (f.type === 'file') {
properties[f.name] = fileField(f)
if (f.required) required.push(f.name)
continue
}
const type = f.type && TYPES.has(f.type) ? f.type as Exclude<FormField['type'], 'object'> : 'string'
const options = Array.isArray(f.enum) && f.enum.length ? f.enum : null
const field: FormField = { type, title: f.name }
if (f.description) field.description = f.description
if (f.default != null && f.default !== '') field.default = f.default
if (type === 'array') {
// 数组只能装枚举字符串(多选),没给可选值的照旧当一段文本填:老图里写 JSON 数组的字段不至于填不进去
if (options) field.items = { type: 'string', enum: options.map(String) }
else field.type = 'string'
} else if (options) {
field.enum = options
}
if (type === 'string' && f.format && FORMATS.has(f.format)) field.format = f.format
if (type === 'number' || type === 'integer') {
if (typeof f.minimum === 'number' && Number.isFinite(f.minimum)) field.minimum = f.minimum
if (typeof f.maximum === 'number' && Number.isFinite(f.maximum)) field.maximum = f.maximum
}
// 老图的字段都是文本,多行框更好填(以前每个字段都是两行的文本框)
if (field.type === 'string' && !field.enum && !field.format) field['x-widget'] = 'textarea'
properties[f.name] = field
if (f.required) required.push(f.name)
}
return { format: 'agentlab.form/1', type: 'object', properties, required, 'x-order': Object.keys(properties) }
}
/**
* 表单里填的值 → 发起运行的 input。留空的按默认值(占位里写着「默认:…」,照它说的办);没写类型的文本看起来像
* JSON 就按 JSON 传,让老图里数组、对象类型的输入照旧能用
*/
export function inputPayload(schema: FormSchema, values: Record<string, unknown>): Record<string, unknown> {
const payload: Record<string, unknown> = {}
for (const [name, field] of Object.entries(schema.properties)) {
const typed = values[name]
const blank = typed == null || (typeof typed === 'string' && typed.trim() === '')
if (blank && field.default == null && (field.type === 'number' || field.type === 'integer')) continue // 没填的数字不传,不传空串
if (field['x-widget'] === 'file') { // 文件:上传后拿回的引用原样传,没上传的不传
if (!blank) payload[name] = typed
continue
}
const raw = blank ? field.default ?? (field.type === 'array' ? [] : field.type === 'boolean' ? false : '') : typed
if (field.type === 'string' && !field.enum && typeof raw === 'string' && /^\s*[[{]/.test(raw)) {
try { payload[name] = JSON.parse(raw) } catch { payload[name] = raw }
} else {
payload[name] = raw
}
}
return payload
}