weaver-work-cli 0.1.24 → 0.1.26

package/dist/shortcuts/workflow/operations/chatscene.js

@@ -0,0 +1,270 @@
+/**
+ * 智能填参：调 OA 的 `chatScene` 接口，让一个**独立智能体**把「用户意图 + 表单字段上下文」
+ * 映射成可直接喂给 `createRequest` 的 `data` 参数。
+ *
+ * ## 接口契约（来源：2026-10-19 真机 HAR，HTTP 200）
+ *
+ * ```
+ * POST {baseUrl}/api/ai/application/chat/chatScene
+ * aiappuniquekey: workflow_form_filler
+ * Content-Type: application/json;charset=UTF-8
+ * ```
+ *
+ * - body 里 `chatId`（19 位数字串）/ `taskId` / `userMessageId`（32 位无横线 hex）**每次随机**，
+ *   其余字段与值固定；
+ * - `messages[0].content` 是**字符串**（入参 JSON 序列化后的文本），**不是对象**；
+ * - 返回的 `data.chatMessage.content` 同样是**字符串**，要**二次 `JSON.parse`**；
+ * - **同步返回**（真机 `timeConsuming.all = 3592 ms`），不需要轮询 —— `pollingInterval` 在本场景不起作用。
+ *
+ * ## 失败口径
+ *
+ * 这个接口是**增强**而不是前置依赖：拿不到合法结果就返回 `ok:false`，由调用方原样退回旧口径
+ * （保留 `historyRequestData` / `systemFields`）。**任何异常都不向上抛**，绝不因为智能体故障
+ * 把整个发起流程打死。
+ */
+import { randomUUID } from 'node:crypto';
+/** 智能体应用标识。注意是**下划线**形态（不是早期的 `workflow-form-filler`）。 */
+export const CHATSCENE_APP_UNIQUE_KEY = 'workflow_form_filler';
+/** 接口路径（`/api/` 前缀是 host 的强制要求）。 */
+export const CHATSCENE_PATH = '/api/ai/application/chat/chatScene';
+/**
+ * 单独超时：真机 3.6 s，但这是**外部大模型**调用，可能排队。
+ *
+ * ★ 2026-10-20 用户裁定：**15 s**（此前 30 s）。实测该智能体真出状况时服务端自身也要挂到 30 s 才回
+ * `InterruptedIOException`，等它没有意义 —— 反正拿不到可用结果就会降级，早 15 s 放弃能让整条
+ * `createForm` 少等一半。失败口径不变（仍静默降级、不打断发起流程）。
+ */
+const CHATSCENE_TIMEOUT_MS = 15_000;
+/**
+ * 填写依据的后缀：智能体在每个字段值旁写 `<字段id>_reason`（实测还会写成 `_reason2`、`_reason3`），
+ * 这些键**必须**在进 `data` 之前剔掉。
+ *
+ * ★ 漏剔一个不是"多提交一个字段"，而是**整张单被卡住**：`createRequest` 的 `bindInputFields`
+ * 会把 `main` / 明细行里的每个键拿去和字段 id / 名称匹配，匹配不到就记一条 `NOT_FOUND` 歧义，
+ * 而 `commandCreateRequest` 一见 `fieldAmbiguities.length` 就直接返回 `NEEDS_CONFIRMATION`。
+ *
+ * 依据本身**只用于调试参数是怎么生成出来的**，不进任何返回面（2026-10-20 用户裁定）。
+ */
+const REASON_KEY = /_reason\d*$/;
+/**
+ * 19 位数字串，形态对齐雪花 ID（真机 `1327983839164596324`）。
+ *
+ * 用 `Date.now() * 1e6 + 随机 6 位`：时间戳保证单调整体、尾 6 位保证同毫秒内不撞。
+ * 必须走 `BigInt` —— `1.79e12 × 1e6 = 1.79e18` 已远超 `Number.MAX_SAFE_INTEGER`（9.0e15），
+ * 用 number 会丢精度、末尾几位变成 0。
+ */
+function randomChatId() {
+    const ts = BigInt(Date.now()) * 1000000n;
+    const seq = BigInt(Math.floor(Math.random() * 1_000_000));
+    return (ts + seq).toString();
+}
+/** 32 位无横线 hex（真机 `taskId` / `userMessageId` 的形态）。 */
+function randomHex32() {
+    return randomUUID().replace(/-/g, '');
+}
+/** 本地时间 `YYYY-MM-DD HH:mm:ss`，供智能体把「今天 / 下周三 / 上个月」换算成绝对日期。 */
+export function formatLocalNow(date = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`
+        + ` ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
+}
+/**
+ * 交给智能体的字段属性**白名单** —— 就是智能体入参契约里的那 12 个键，一个不多一个不少
+ * （2026-10-20 用户对齐真机入参）。为此要挡掉 `createForm` 侧那些**只给 CLI 自己用**的属性：
+ *
+ * | 属性 | 为什么不给智能体 |
+ * | --- | --- |
+ * | `fileUploadParams` | 文件夹 / 大小格式限制 / 一次性签名，是给调 caizhilian 上传的模型用的；带上它会让智能体误以为要自己判上传限制 |
+ * | `browserType` / `browserModule` | 浏览通道标识，由 CLI 在 `createRequest` 解析值时用，与「意图 → 值」无关 |
+ * | `readOnly` / `disableEdit` / `folderDependsOnOption` | 是否可写、附件文件夹是否随选项变，都是 CLI 侧的门禁/联动细节 |
+ *
+ * 键序与契约一致（`componentKey` → 布尔标记 → `format` → `initialValue` → `options`）。
+ */
+const AGENT_FIELD_KEYS = [
+    'id', 'name', 'subFormId', 'componentKey',
+    'isBrowser', 'isSelect', 'isMultiple', 'isEmployeeScope', 'isEinvoice',
+    'format', 'initialValue', 'options',
+];
+function pickAgentFields(fields) {
+    const picked = [];
+    for (const field of fields) {
+        if (!field || typeof field !== 'object')
+            continue;
+        const item = {};
+        for (const key of AGENT_FIELD_KEYS) {
+            const value = field[key];
+            if (value === undefined || value === null)
+                continue;
+            item[key] = value;
+        }
+        picked.push(item);
+    }
+    return picked;
+}
+/**
+ * 交给智能体的 `systemFields` **只留三项**：`defaults` / `levelOptions` / `secLevelOptions`。
+ *
+ * `createForm` 内部那份 `systemFields` 还带 `permissions`（逐字段的 view/edit/mandatory 位图，
+ * 真机 278 字段的表单就是 278 条）—— 那是 CLI 自己判"字段看不看得见、能不能填"用的，
+ * 与「意图 → 字段值」这个映射无关，发给智能体纯属噪声（2026-10-20 用户对齐真机入参）。
+ */
+function pickAgentSystemFields(raw) {
+    const source = (raw && typeof raw === 'object' && !Array.isArray(raw))
+        ? raw
+        : {};
+    const isPlainObject = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+    return {
+        defaults: isPlainObject(source.defaults) ? source.defaults : {},
+        levelOptions: Array.isArray(source.levelOptions) ? source.levelOptions : [],
+        secLevelOptions: Array.isArray(source.secLevelOptions) ? source.secLevelOptions : [],
+    };
+}
+export function buildChatSceneInput(params) {
+    return {
+        userQuestion: params.userQuestion,
+        workflow: { id: String(params.workflow.id ?? ''), name: String(params.workflow.name ?? '') },
+        fields: pickAgentFields(params.fields || []),
+        historyRequestData: params.historyRequestData ?? null,
+        systemFields: pickAgentSystemFields(params.systemFields),
+        userMemory: String(params.userMemory ?? ''),
+        now: params.now || formatLocalNow(),
+    };
+}
+/** 摘掉一行里的所有依据键（`_reason` / `_reason2` …），只留真值；空值也不留。 */
+function stripReasonKeys(source) {
+    const values = {};
+    for (const [key, value] of Object.entries(source)) {
+        if (REASON_KEY.test(key))
+            continue;
+        if (value === null || value === undefined)
+            continue;
+        values[key] = value;
+    }
+    return values;
+}
+/**
+ * 把智能体返回的 `formData` 收敛成 `{main, details}`，并**摘掉所有依据键**。
+ * 结构不对就返回 null（＝降级）。
+ */
+function normalizeFormData(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return null;
+    const mainRaw = raw.main;
+    const detailsRaw = raw.details;
+    const main = {};
+    if (mainRaw && typeof mainRaw === 'object' && !Array.isArray(mainRaw)) {
+        Object.assign(main, stripReasonKeys(mainRaw));
+    }
+    const details = {};
+    if (detailsRaw && typeof detailsRaw === 'object' && !Array.isArray(detailsRaw)) {
+        for (const [subFormId, rows] of Object.entries(detailsRaw)) {
+            if (!Array.isArray(rows))
+                continue;
+            const kept = [];
+            for (const row of rows) {
+                if (!row || typeof row !== 'object' || Array.isArray(row))
+                    continue;
+                const values = stripReasonKeys(row);
+                // 整行只有依据键、一个值都没有 ⇒ 不产行（否则会多出一行空明细）
+                if (!Object.keys(values).length)
+                    continue;
+                kept.push(values);
+            }
+            if (!kept.length)
+                continue;
+            details[subFormId] = kept;
+        }
+    }
+    // 一个字段都没有 ⇒ 视为没拿到结果（否则会把整张空表单当成"已填好"交出去）
+    if (!Object.keys(main).length && !Object.keys(details).length)
+        return null;
+    return { data: { main, details } };
+}
+/**
+ * `systemData` 只收四个已知键、统一成字符串；缺键 / 非字符串一律当空串。
+ * 四个键的 `_reason` 变体本来就不在白名单里，直接不收。
+ */
+function normalizeSystemData(raw) {
+    const source = (raw && typeof raw === 'object' && !Array.isArray(raw)) ? raw : {};
+    const systemData = {};
+    for (const key of ['requestName', 'requestLevel', 'secLevel', 'remark']) {
+        const value = source[key];
+        systemData[key] = (value === null || value === undefined) ? '' : String(value).trim();
+    }
+    return systemData;
+}
+/**
+ * 调 `chatScene` 并解析结果。**永不抛异常**。
+ *
+ * 判成功的三个条件（缺一即降级，对应需求「返回值 data.chatMessage.content 不存在或者为空则走原逻辑」）：
+ * 1. 外层 `code === 200 && status === true`；
+ * 2. `data.chatMessage.content` 是**非空字符串**；
+ * 3. 该字符串能 parse 成 JSON，且里面有非空的 `formData`。
+ */
+export async function requestFormFill(env, input) {
+    const startedAt = Date.now();
+    const base = () => ({ ok: false, durationMs: Date.now() - startedAt });
+    try {
+        const body = {
+            appUniqueKey: CHATSCENE_APP_UNIQUE_KEY,
+            fromPersonalHome: false,
+            chatId: randomChatId(),
+            appConfigType: 3,
+            // ★ content 必须是**字符串**：整个入参 JSON 序列化一次
+            messages: [{ content: JSON.stringify(input), role: 'user' }],
+            isNeedContext: 1,
+            regenerate: false,
+            pollingInterval: 200,
+            globalParam: {},
+            sessionParam: {},
+            frontToolList: [],
+            searchType: 1,
+            userMessageId: randomHex32(),
+            assist: { fileList: [], quoteContent: '' },
+            taskId: randomHex32(),
+            clientType: 1,
+        };
+        const response = await env.host.workflowRequest({
+            method: 'POST',
+            path: CHATSCENE_PATH,
+            // 该接口靠这个头定位智能体应用；workflow 系列接口不需要它
+            headers: { aiappuniquekey: CHATSCENE_APP_UNIQUE_KEY },
+            body,
+            operation: 'workflow.createForm',
+            timeoutMs: CHATSCENE_TIMEOUT_MS,
+            // 失败要能自己读结论（也避免把 code/status 异常抛成业务错误中断 createForm）
+            tolerateBusinessError: true,
+        });
+        const root = (response && typeof response === 'object') ? response : {};
+        if (Number(root.code) !== 200 || root.status !== true) {
+            return { ...base(), reason: `chatScene 返回 code=${String(root.code)} status=${String(root.status)}` };
+        }
+        const content = root?.data?.chatMessage?.content;
+        if (typeof content !== 'string' || !content.trim()) {
+            return { ...base(), reason: 'chatScene 未返回 chatMessage.content' };
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(content);
+        }
+        catch {
+            return { ...base(), reason: 'chatMessage.content 不是合法 JSON' };
+        }
+        const normalized = normalizeFormData(parsed?.formData);
+        if (!normalized)
+            return { ...base(), reason: '返回值里没有可用的 formData' };
+        return {
+            ok: true,
+            data: normalized.data,
+            systemData: normalizeSystemData(parsed?.systemData),
+            durationMs: Date.now() - startedAt,
+        };
+    }
+    catch (error) {
+        // 超时 / 网络 / HTTP 5xx / 登录态以外的任何问题，一律降级，不打断 createForm。
+        const message = (error && typeof error === 'object' && 'message' in error)
+            ? String(error.message)
+            : String(error);
+        return { ...base(), reason: `chatScene 调用失败：${message}` };
+    }
+}