@baishuyun/agents 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @baishuyun/agents
+
+## 0.0.1
+
+### Patch Changes
+
+- test init publish

package/index.ts

@@ -0,0 +1,10 @@
+export * from "./src/form-builder/index.js";
+export * from "./src/form-builder/consts/index.js";
+export * from "./src/form-builder/utils/index.js";
+export * from "./src/form-builder/types/index.js";
+export * from "./src/form-builder/prompts/index.js";
+export * from "./src/form-builder/model/ds.js";
+
+export * from "./src/form-designer/index.js";
+export * from "./src/fields-builder/index.js";
+export * from "./src/continue-confirmer/index.js";

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@baishuyun/agents",
+  "version": "0.0.1",
+  "description": "",
+  "main": "index.ts",
+  "type": "module",
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ai-sdk/deepseek": "^1.0.29",
+    "@ai-sdk/openai": "^2.0.76",
+    "@ai-sdk/vercel": "^1.0.29",
+    "@ai-sdk/xai": "^2.0.39",
+    "ai": "^5.0.101",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.17",
+    "typescript": "^5.9.3",
+    "@baishuyun/types": "1.0.1",
+    "@baishuyun/typescript-config": "0.0.1"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}

package/src/continue-confirmer/index.ts

@@ -0,0 +1,41 @@
+import { Experimental_Agent as Agent, type StopCondition } from "ai";
+
+import { CONTINUE_CONFIRMER_PROMPT } from "./prompt.js";
+import { ds } from "../form-builder/model/ds.js";
+import {
+  confirmToCreateRelatedForm,
+  confirmToCreateFieldsForRelatedForm,
+} from "../form-builder/tools/index.js";
+
+import { promptToCreateRelatedForm } from "../form-builder/tools/prompt-to-create-realted-form.js";
+
+const tools = {
+  promptToCreateRelatedForm,
+  confirmToCreateFieldsForRelatedForm,
+  confirmToCreateRelatedForm,
+};
+
+const done: StopCondition<typeof tools> = ({ steps }) => {
+  return steps.some((step) =>
+    step.content.some(
+      (part) =>
+        // 确认创建关联表字段，结束
+        (part.type === "tool-result" &&
+          part.toolName === "confirmToCreateFieldsForRelatedForm") ||
+        // 没有关联表，结束
+        (part.type === "tool-result" &&
+          !part.output &&
+          part.toolName === "promptToCreateRelatedForm"),
+    ),
+  );
+};
+
+export type ContinueTools = typeof tools;
+
+export const continueAgent = new Agent({
+  system: CONTINUE_CONFIRMER_PROMPT,
+  model: ds,
+  tools,
+  toolChoice: "required",
+  stopWhen: done,
+});

package/src/continue-confirmer/prompt.ts

@@ -0,0 +1,11 @@
+export const CONTINUE_CONFIRMER_PROMPT = `
+你是表单构建提示员，根据上下文信息，判断是否需要创建关联表单。
+
+步骤：
+1. 如果需要创建关联表单，询问用户是否继续创建关联表单并调用 confirmToCreateRelatedForm 工具请求确认。
+2. 如果用户确认继续创建关联表单，严格使用上下文识别到的关联表调用 confirmToCreateFieldsForRelatedForm 工具，让用户确认关联表来生成字段。
+3. 如果上下文信息中没有明确的关联表创建需求，不要主动提及关联表创建。直接提示表单创建已完成。
+
+要求：
+- 不要任何总结，确保简洁，只询问用户是否继续创建关联表单。
+`;

package/src/fields-builder/fields-builder.ts

@@ -0,0 +1,43 @@
+export const fieldsBuilderPrompt = `
+你是表单字段构建专家，根据上下文设计说明理解业务需求，完成表单字段构建，生成字段描述 json。
+
+步骤：
+1. 严格根据前文设计说明，理解业务需求
+2. 根据需求，调用工具进行字段设计
+3. 请求用户确认保存字段
+
+输出：
+- 仅包含工具的结构化输出，不包含任何其他文字说明
+- 严格按设计说明的个数，严禁新增、遗漏字段
+- 设计中提到要关联其他表的字段，必须使用关联字段设计工具
+
+注意：
+- 关联字段有最高优先级，如果上下文提到字段需要关联其他表，必须使用关联字段设计工具
+- 涉及到合同、记录相关等字段信息时，使用关联字段
+- 表单布局需要紧凑合理
+- 关联表单无需重复设计字段反向关联
+- 对于身份证号、手机号等字段，使用文本字段，并添加相应的正则表达式校验
+- 字段设计时，注意字段的必填项和选填项
+- 字段类型尽量使用多样化字段，避免单一字段类型
+- 请至少使用(buildLinkDataField)工具设计一个关联字段
+`;
+
+export const fieldsOnlyPrompt = `
+你是表单字段构建专家，根据上下文设计说明理解业务需求，完成表单字段构建，生成字段描述 json。设计文档中字段设计完毕后，立即停止。
+
+输出：
+- 仅包含工具的结构化输出，不包含任何其他文字说明
+- 严格按设计说明的个数，严禁新增、遗漏字段
+- 设计中提到要关联其他表的字段，必须使用关联字段设计工具
+-
+
+注意：
+- 关联字段有最高优先级，如果上下文提到字段需要关联其他表，必须使用关联字段设计工具
+- 涉及到合同、记录相关等字段信息时，使用关联字段
+- 表单布局需要紧凑合理
+- 关联表单无需重复设计字段反向关联
+- 对于身份证号、手机号等字段，使用文本字段，并添加相应的正则表达式校验
+- 字段设计时，注意字段的必填项和选填项
+- 字段类型尽量使用多样化字段，避免单一字段类型
+- 请至少使用(buildLinkDataField)工具设计一个关联字段
+`;

package/src/fields-builder/index.ts

@@ -0,0 +1,109 @@
+import { type InferUITools, type StopCondition, tool } from "ai";
+import { z } from "zod";
+import { fieldsOnlyPrompt } from "./fields-builder.js";
+import { ds } from "../form-builder/model/ds.js";
+import { fieldsTools } from "../form-builder/types/index.js";
+import { EnhancedAgent } from "../utils/index.js";
+
+export const stop = tool({
+  name: "promptToStop",
+  description:
+    "stop when all fields have been built and no more fields are needed to be added.",
+  inputSchema: z.object({
+    hasRelatedForm: z.boolean(),
+  }),
+  outputSchema: z.boolean(),
+  execute: (input) => {
+    return input.hasRelatedForm;
+  },
+});
+
+const tools = {
+  ...fieldsTools,
+  promptToStop: stop,
+};
+
+export type FieldsBuildTools = InferUITools<typeof tools>;
+
+const needConfirm: StopCondition<typeof tools> = ({ steps }) => {
+  return steps.some((step) =>
+    step.content.some(
+      (part) => part.type === "tool-result" && part.toolName === "promptToStop",
+    ),
+  );
+};
+
+export type SaveCheckedFieldsPayload = {
+  formName: string;
+  relatedForms: Record<string, string>;
+};
+
+export const FieldsBuildWithConfirmAgent = new EnhancedAgent<
+  SaveCheckedFieldsPayload,
+  typeof tools
+>(
+  {
+    system: fieldsOnlyPrompt,
+    model: ds,
+    tools,
+    toolChoice: "required",
+    stopWhen: needConfirm,
+  },
+  {
+    type: "data-confirm",
+    data: {
+      type: "tool-confirmToSaveCheckedFields",
+      payload: {
+        formName: "",
+        relatedForms: {},
+      },
+    },
+  },
+  {
+    relatedForms: {},
+  },
+  (ctx, body) => {
+    console.log("ctx", ctx);
+    return {
+      formName: body.name,
+      relatedForms: ctx.relatedForms,
+    };
+  },
+);
+
+export const createBuilder = () =>
+  new EnhancedAgent<
+    {
+      formName: string;
+      relatedForms: Record<string, string>;
+    },
+    typeof tools
+  >(
+    {
+      system: fieldsOnlyPrompt,
+      model: ds,
+      tools,
+      toolChoice: "required",
+      stopWhen: needConfirm,
+    },
+    {
+      type: "data-confirm",
+      data: {
+        type: "tool-confirmToSaveCheckedFields",
+        payload: {
+          formName: "",
+          relatedForms: {},
+        },
+      },
+    },
+    {
+      relatedForms: {},
+    },
+    (ctx, body) => {
+      console.log("ctx", ctx);
+      return {
+        formName: body.name,
+        relatedForms: ctx.relatedForms,
+      };
+    },
+  );

package/src/form-builder/consts/index.ts

@@ -0,0 +1,5 @@
+// Approval string to be shared across frontend and backend
+export const APPROVAL = {
+  YES: "Yes, confirmed.",
+  NO: "No, denied.",
+} as const;

package/src/form-builder/index.ts

@@ -0,0 +1,24 @@
+import { Experimental_Agent as Agent, stepCountIs } from "ai";
+
+import { ds } from "./model/ds.js";
+
+import * as tools from "./tools/index.js";
+import { formBuilderPrompt } from "./prompts/index.js";
+import {
+  getExecutableTools,
+  getToolsRequiringConfirmation,
+} from "./utils/process-confirm-tool-call.js";
+
+export const formBuilderAgent = new Agent({
+  system: formBuilderPrompt,
+  model: ds,
+  tools,
+  stopWhen: stepCountIs(200),
+  experimental_context: {
+    relatedForms: {},
+  },
+});
+
+export const ToolsRequiringConfirmation = getToolsRequiringConfirmation(tools);
+
+export const ToolsCanBeExecutedDirectly = getExecutableTools(tools);

package/src/form-builder/model/ds.ts

@@ -0,0 +1,8 @@
+import { createDeepSeek } from "@ai-sdk/deepseek";
+
+const deepseek = createDeepSeek({
+  // todo: move to env variable && update key
+  apiKey: "sk-f86317613ca4472b97ee4957af550b5c",
+});
+
+export const ds = deepseek("deepseek-chat");

package/src/form-builder/model/openai.ts

@@ -0,0 +1,7 @@
+import { createOpenAI } from "@ai-sdk/openai";
+
+const openai = createOpenAI({
+  apiKey: "",
+});
+
+export const gpt5 = openai("gpt-5");

package/src/form-builder/model/v0.ts

@@ -0,0 +1,7 @@
+import { createVercel } from "@ai-sdk/vercel";
+
+const vercel = createVercel({
+  apiKey: "",
+});
+
+export const v0 = vercel("v0-1.0-md");

package/src/form-builder/model/xai.ts

@@ -0,0 +1,7 @@
+import { createXai } from "@ai-sdk/xai";
+
+const xai = createXai({
+  apiKey: "",
+});
+
+export const grok3 = xai("grok-3");

package/src/form-builder/prompts/fields-design-docs.ts

@@ -0,0 +1,3 @@
+export const fieldsDesignDocs = `
+你是表单设计专家，根据用户业务需求，列出表单字段，从业务角度给出每个字段的设计说明。
+`;

package/src/form-builder/prompts/index.ts

@@ -0,0 +1,32 @@
+export const formBuilderPrompt = `
+你是表单设计专家，根据用户业务需求，完成表单设计。请控制表单规模，合理使用关联字段，尽量进行表单拆分。
+
+
+步骤：
+1. 根据用户需求，创建表单，列出字段，从业务角度给出每个字段的设计说明
+2. 调用确认工具，确认是否继续创建表单
+3. 用户确认后，调用工具创建正式表单字段，如果字段需要关联其他表单，创建关联字段(buildLinkDataField)，并记住关联表单名称
+4. 字段设计完毕后，调用确认工具，确认是否保存字段
+5. 如果步骤 3. 中创建了关联表单，调用确认工具，提示确认是否创建所有关联表单
+6. 如果用户确认继续创建关联表单，调用确认工具，确认为哪一个关联表单创建字段
+7. 如果用户确认为关联表单创建字段，回到步骤 3.，继续创建对应关联表单字段
+
+格式：
+- 关联字段 label 命名无需加“关联”二字，直接像设计普通字段一样命名
+- 关联字段创建无需特定分区和说明，像设计普通字段一样设计
+- 统一使用中文
+- 字段设计时，不要返回分区说明，请直接用分割线工具表示分区信息
+- 表单布局需要紧凑合理，不同区域尝试用分割线字段分割
+- 确保回复精简，不要有多余的解释
+
+注意：
+- 每次设计表单字段时，就考虑到后续可能需要设计的关联表单，而不是设计新表单时再关联旧表单
+- 关联表单无需重复设计字段反向关联
+- 如果有多个表，主表单就应该有关联字段关联其他表单
+- 对于身份证号、手机号等字段，使用文本字段，并添加相应的正则表达式校验
+- 字段设计时，注意字段的必填项和选填项
+- 字段类型尽量使用多样化字段，避免单一字段类型
+- 尽量进行表单拆分，避免单个表单字段过多，使用关联字段连接不同表单
+- 涉及到合同、人员、记录等信息时，使用关联字段
+- 完成后，不需要总结
+`;

package/src/form-builder/schema/index.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+
+export const option = z.object({
+  value: z.string().min(1).max(100),
+  text: z.string().min(1).max(100),
+  color: z.string().optional(),
+});

package/src/form-builder/tools/address.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { tool } from "ai";
+import { buildWidgetName } from "../utils/index.js";
+
+export const buildAddressField = tool({
+  name: "buildAddressField",
+  description:
+    "Builds a form field for collecting address information from users.",
+  inputSchema: z.object({
+    label: z.string().min(1).max(100),
+    required: z.boolean().default(false),
+    fieldWidth: z.enum(["3", "4", "6", "8", "9", "12"]).default("12"),
+    description: z.string().min(1).max(100).optional(),
+    addressMode: z
+      .enum(["all", "provinceCityDistrict", "provinceCity", "provinceOnly"])
+      .default("all"),
+  }),
+  execute: (input) => {
+    const { label, required, fieldWidth, description, addressMode } = input;
+    const modeMap: Record<string, string> = {
+      all: "pcda",
+      provinceCityDistrict: "pcd",
+      provinceCity: "pc",
+      provinceOnly: "p",
+    };
+    return {
+      widget: {
+        type: "address",
+        widgetName: buildWidgetName(),
+        widgetNameAlias: "",
+        customCls: null,
+        width: 720,
+        enable: true,
+        visible: true,
+        allowBlank: !required,
+        labelStyle: label,
+        funMode: "module",
+        module: null,
+        libs: [],
+        extendSet: {
+          sort: ["datahelp", "module", "formEvent"],
+          status: true,
+          triggerField: "",
+          triggerFieldMode: "none",
+          version: 1,
+        },
+        needDetail: true,
+        format: modeMap[addressMode] || "all",
+        eventMode: 1, //公式联动触发模式  1  默认，省市县/详细地址内容改变都触发   2  只有省市县改变才触发  3  只有详细地址改变才触发
+        seleceMapAddress: true, //开启经纬度定位
+      },
+      description,
+      label,
+      lineWidth: parseInt(fieldWidth, 10),
+      tab: null,
+    };
+  },
+});

package/src/form-builder/tools/attachment.ts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { tool } from "ai";
+import { buildWidgetName } from "../utils/index.js";
+
+export const buildAttachmentField = tool({
+  name: "buildAttachmentField",
+  description: "Builds an attachment field for a form.",
+  inputSchema: z.object({
+    label: z.string().min(1).max(100),
+    placeholder: z.string().min(1).max(100).optional(),
+    required: z.boolean().default(false),
+    fieldWidth: z.enum(["3", "4", "6", "8", "9", "12"]).default("12"),
+    description: z.string().min(1).max(100).optional(),
+    fileType: z
+      .enum([
+        "exe",
+        "pdf",
+        "doc",
+        "docx",
+        "xls",
+        "xlsx",
+        "ppt",
+        "pptx",
+        "txt",
+        "jpg",
+        "jpeg",
+        "png",
+        "gif",
+        "bmp",
+      ])
+      .array()
+      .optional()
+      .default(["exe", "pdf"]),
+  }),
+  execute: (input) => {
+    const { label, required, fieldWidth, description, fileType } = input;
+    return {
+      widget: {
+        type: "upload",
+        widgetName: buildWidgetName(),
+        widgetNameAlias: "",
+        customCls: null,
+        enable: true,
+        visible: true,
+        allowBlank: !required,
+        labelStyle: label,
+        maxFileCount: 50, //允许多文件上传  1为不可以 50为可以
+        download: true, //打包下载
+        is_file_down: true, //操作权限 可下载
+        check_image_exif: true, //照片支持查看EXIF扩展信息
+        online_edit: true, //允许文档在线编辑
+        online_edit_record: true, //是否查看协作记录
+        fileSizeLimit: 10485760, //设置单个文件大小上限，单位是字节，范围 1M-20M
+        fileType,
+      },
+      description,
+      label,
+      lineWidth: parseInt(fieldWidth),
+      tab: null,
+    };
+  },
+});

package/src/form-builder/tools/button.ts

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { tool } from "ai";
+import { buildWidgetName } from "../utils/index.js";
+
+export const buildButtonField = tool({
+  name: "buildButtonField",
+  description: "build a button field",
+  inputSchema: z.object({
+    label: z.string().min(1).max(100),
+    theme: z.enum(["primary", "bordered", "ghost"]).default("primary"),
+    buttonText: z.string().min(1).max(100),
+    backgroundColor: z.string().min(1).max(7),
+    required: z.boolean().default(false),
+    fieldWidth: z.enum(["3", "4", "6", "8", "9", "12"]).default("12"),
+    description: z.string().min(1).max(100).default(""),
+  }),
+  execute: (input) => {
+    const {
+      label,
+      buttonText,
+      backgroundColor,
+      theme,
+      required,
+      fieldWidth,
+      description,
+    } = input;
+    const themeMap = {
+      primary: "default",
+      bordered: "style1",
+      ghost: "none",
+    };
+    return {
+      widget: {
+        type: "button",
+        widgetName: buildWidgetName(),
+        widgetNameAlias: "",
+        triggerEvent: 0,
+        customCls: null,
+        height: 36,
+        width: 350,
+        text: buttonText,
+        enable: true,
+        visible: true,
+        allowBlank: !required,
+        labelStyle: label,
+        extendSet: {
+          sort: ["datahelp", "module", "formEvent"],
+          status: true,
+          triggerField: "",
+          triggerFieldMode: "none",
+          funMode: "popupreport",
+        },
+        background: {
+          //颜色
+          mode: "color",
+          color: backgroundColor,
+          position: "center",
+        },
+        mode: "all", //模式  all 扩展  popupreport 弹出报表  popupform 弹出表单  print 页面打印  popuppage 弹出外部网页
+        theme: themeMap[theme] || "default", //风格  default 默认，有边框有底色  style1 有边框无底色  none 无边框无底色
+        eventAlert: false, //是否显示提醒框
+        alertinfo: {
+          icon: "success",
+          tip: "请设置提示内容",
+        },
+      },
+      description,
+      label,
+      lineWidth: parseInt(fieldWidth),
+      tab: null,
+    };
+  },
+});

package/src/form-builder/tools/checkbox.ts

@@ -0,0 +1,55 @@
+import { tool } from "ai";
+import { z } from "zod";
+import { buildWidgetName } from "../utils/index.js";
+
+export const buildCheckBoxGroupField = tool({
+  name: "buildCheckBoxGroupField",
+  description: "build a check boxk group field",
+  inputSchema: z.object({
+    label: z.string().min(1).max(100),
+    fieldWidth: z.enum(["3", "4", "6", "8", "9", "12"]).default("12"),
+    description: z.string().min(1).max(100).optional(),
+    required: z.boolean().default(false),
+    layout: z.enum(["horizontal", "vertical"]).default("horizontal"),
+    options: z.array(
+      z.object({
+        value: z.string().min(1).max(100),
+        text: z.string().min(1).max(100),
+        color: z.string().min(1).max(7),
+      }),
+    ),
+  }),
+  execute: (input) => {
+    const { label, fieldWidth, description, options, required, layout } = input;
+    return {
+      widget: {
+        type: "checkboxgroup",
+        widgetName: buildWidgetName(),
+        widgetNameAlias: "",
+        customCls: null,
+        enable: true,
+        visible: true,
+        allowBlank: !required,
+        labelStyle: label,
+        funMode: "module",
+        module: null,
+        libs: [],
+        extendSet: {
+          sort: ["datahelp", "module", "formEvent"],
+          status: true,
+          triggerField: "",
+          triggerFieldMode: "none",
+          version: 1,
+        },
+        items: options,
+        colorEnable: true, //颜色 是否开启颜色
+        layout,
+        allowAddOptions: false, //允许成员填写时添加新选项
+      },
+      description,
+      label,
+      lineWidth: parseInt(fieldWidth),
+      tab: null,
+    };
+  },
+});

package/src/form-builder/tools/confirm-to-create-fields-for-related-form.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { tool } from "ai";
+
+export const confirmToCreateFieldsForRelatedForm = tool({
+  name: "confirmToCreateFieldsForRelatedForm",
+  description: "require user confirm to create fields for related forms.",
+  inputSchema: z.object({
+    forms: z.array(
+      z.object({
+        title: z.string().min(2).max(100),
+        description: z.string().min(2).max(500),
+      }),
+    ),
+  }),
+  outputSchema: z.string(),
+});

package/src/form-builder/tools/confirm-to-create-form.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import { tool } from "ai";
+
+export const confirmToCreateForm = tool({
+  name: "confirmToCreateForm",
+  description: "confirm to start creating a form",
+  inputSchema: z.object({
+    formName: z.string().min(2).max(100),
+  }),
+  outputSchema: z.string(),
+});

package/src/form-builder/tools/confirm-to-create-related-form.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { tool } from "ai";
+
+export const confirmToCreateRelatedForm = tool({
+  name: "confirmToCreateRelatedForm",
+  description: "require user confirm to create following related forms.",
+  inputSchema: z.object({
+    forms: z.array(
+      z.object({
+        title: z.string().min(2).max(100),
+        description: z.string().min(2).max(500),
+      }),
+    ),
+  }),
+  outputSchema: z.string(),
+});