weaver-work-cli 0.1.5 → 0.1.7

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

@@ -0,0 +1,33 @@
+import { workflowValidationError } from '../errors.js';
+import { workflowFormOperations } from './form.js';
+import { workflowReadOperations } from './read.js';
+import { workflowWriteOperations } from './write.js';
+function buildRegistry() {
+    const registry = new Map();
+    const definitions = [
+        ...workflowReadOperations,
+        ...workflowFormOperations,
+        ...workflowWriteOperations,
+    ];
+    for (const definition of definitions) {
+        if (registry.has(definition.name)) {
+            throw new Error(`duplicate workflow operation: ${definition.name}`);
+        }
+        registry.set(definition.name, definition);
+    }
+    return registry;
+}
+const workflowOperationRegistry = buildRegistry();
+export function workflowOperationDefinitions() {
+    return [...workflowOperationRegistry.values()];
+}
+export function getWorkflowOperation(operation) {
+    const definition = workflowOperationRegistry.get(operation);
+    if (!definition) {
+        throw workflowValidationError('operation_unknown', `流程模块不支持操作：${operation}`);
+    }
+    return definition;
+}
+export function hasWorkflowOperation(operation) {
+    return workflowOperationRegistry.has(operation);
+}

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

@@ -0,0 +1,167 @@
+import { WorkflowCliError, workflowValidationError } from '../errors.js';
+/**
+ * 模型输入中永远不允许出现的键。
+ *
+ * 依据共享规则：认证态由 CLI 托管，业务输入只描述业务对象与意图；
+ * 出现这些键说明调用方试图自行注入会话凭据或绕过封装层。
+ */
+export const FORBIDDEN_INPUT_KEYS = new Set([
+    'access_token',
+    'app_key',
+    'app_secret',
+    'cookie',
+    'cookies',
+    'eteamsid',
+    'token',
+    'sedit',
+    'dubboFlag',
+    'dubboToken',
+    'skipFlag',
+    'secondSectionType',
+    'authStr',
+    'authSignatureStr',
+]);
+export function asObject(value) {
+    if (value === undefined || value === null)
+        return {};
+    if (typeof value !== 'object' || Array.isArray(value)) {
+        throw workflowValidationError('input_invalid', '输入必须是 JSON 对象');
+    }
+    return value;
+}
+export function assertNoForbiddenKeys(input) {
+    const hits = Object.keys(input).filter((key) => FORBIDDEN_INPUT_KEYS.has(key));
+    if (hits.length) {
+        throw workflowValidationError('input_forbidden', `输入中包含不允许的认证相关字段：${hits.join('、')}。认证态由 weaver-work-cli 托管，请不要传入凭据。`, { fields: hits });
+    }
+}
+/** 去掉 undefined / null / 空串，便于构造请求体。 */
+export function compact(value) {
+    const output = {};
+    for (const [key, item] of Object.entries(value)) {
+        if (item === undefined || item === null || item === '')
+            continue;
+        output[key] = item;
+    }
+    return output;
+}
+export function asString(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    const text = String(value).trim();
+    return text ? text : undefined;
+}
+export function asInt(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const parsed = Number(value);
+    return Number.isInteger(parsed) ? parsed : undefined;
+}
+export function asStringArray(value, field) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    if (!Array.isArray(value)) {
+        throw workflowValidationError('input_invalid', `${field} 必须是字符串数组`);
+    }
+    return value.map((item) => String(item));
+}
+/** 请求 flag 是否开启（支持布尔与 0/1、"true"/"false"）。 */
+export function asBool(value, fallback = false) {
+    if (value === undefined || value === null || value === '')
+        return fallback;
+    if (typeof value === 'boolean')
+        return value;
+    const text = String(value).trim().toLowerCase();
+    if (['1', 'true', 'yes', 'y'].includes(text))
+        return true;
+    if (['0', 'false', 'no', 'n'].includes(text))
+        return false;
+    return fallback;
+}
+/** 从响应中取数据主体（兼容 res_base 包裹与 data 包裹）。 */
+export function responseData(response) {
+    if (!response || typeof response !== 'object') {
+        throw new WorkflowCliError('api', 'unexpected_response', '接口返回结构异常');
+    }
+    const record = response;
+    if (record.res_base && typeof record.res_base === 'object')
+        return record.res_base;
+    if (record.data !== undefined)
+        return record.data;
+    return response;
+}
+/**
+ * 记忆应用 ID（来源：原 Python `DEFAULT_MEMORY_APP_ID` / `memory_app_id_from_runtime`）。
+ *
+ * 记忆接口（buildAgentMemoryPrompt / agentMemoryExtract）要求 `chatParams.appid` 必须是
+ * 有效的 AI 应用 ID：缺省时接口直接返回空 promptText（表现为「记忆永远读不到」）。
+ * 解析顺序：显式入参 > 环境变量 `E10_MEMORY_APP_ID` > 内置默认值。
+ */
+export const DEFAULT_MEMORY_APP_ID = '1299808011830755362';
+export function resolveMemoryAppId(explicit) {
+    const text = (explicit ?? '').trim();
+    if (text)
+        return text;
+    return (process.env.E10_MEMORY_APP_ID ?? '').trim() || DEFAULT_MEMORY_APP_ID;
+}
+export function toArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (value === undefined || value === null)
+        return [];
+    return [value];
+}
+/**
+ * 把指针/元信息字段排到 JSON 最前（同名键保留 meta 的位置）。
+ *
+ * 原因：输出体积大时模型习惯用 `| head` 截断，而 JSON 尾部字段必然读不到
+ * —— `resultFile` 这类"续取指针"必须出现在前部，被截断也看得见。
+ */
+export function withLeadingMeta(meta, body) {
+    const ordered = {};
+    for (const [key, value] of Object.entries(meta)) {
+        if (value !== undefined)
+            ordered[key] = value;
+    }
+    for (const [key, value] of Object.entries(body)) {
+        if (value !== undefined)
+            ordered[key] = value;
+    }
+    return ordered;
+}
+/**
+ * 单次工具输出的体积安全线：超过就落盘 + 只回精简版。
+ *
+ * 宿主对单次工具输出有截断（V12.1.34 实测：24,000 B 与 28,000 B 完整内联，32,000 B（报 31.3 KB）
+ * 被截成 2048 B 预览 + 落盘），一旦被截断，模型只能写脚本反复读回、每读一次又被截断，
+ * 白花好几轮工具往返（实测某次会话多花 4 轮、约 54 s）。与其让宿主事后截，不如 CLI 主动落盘。
+ *
+ * **量这个线必须用 `stdoutBytesOf()`（美化口径）**，不能用压缩口径 —— 见该函数注释。
+ */
+export const STDOUT_SAFE_BYTES = 24_000;
+/** 结果序列化后的字节数（**压缩**口径，用作相对大小参考）。 */
+export function outputBytesOf(value) {
+    try {
+        return Buffer.byteLength(JSON.stringify(value), 'utf8');
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * 宿主**实际看到**的 stdout 体积（**美化**口径，缩进 2，与 CLI 打印格式一致）。
+ *
+ * ★ 安全线必须用这个量。CLI 打出来的是美化 JSON，而 `outputBytesOf()` 量的是压缩 JSON，
+ * 两者**实测相差 1.79 倍**（同一份 createForm 输出：压缩 21,146 / 美化 37,887）。用压缩口径判线会
+ * **系统性低估**，于是：① 该降级的没降级（`form.ts` 的第三档兜底 `writableFieldsOmitted` 从未触发）；
+ * ② 输出冲出宿主阈值被截成 2048 B 预览，而排在 2048 字节之后的内容（如 `writableFields`）
+ * **永远看不见** —— 模型于是自己去写脚本挖 resultFile，白烧好几轮往返。
+ */
+export function stdoutBytesOf(value) {
+    try {
+        return Buffer.byteLength(JSON.stringify(value, null, 2), 'utf8');
+    }
+    catch {
+        return 0;
+    }
+}

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

@@ -0,0 +1,44 @@
+export function workflowSuccess(action, data, meta) {
+    const payload = { ok: true, action, data };
+    if (meta && Object.keys(meta).length > 0)
+        payload.meta = meta;
+    return payload;
+}
+/** 构造「对象类型 + 严格禁止额外字段」的 JSON Schema。 */
+export function schemaOf(properties, options = {}) {
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties,
+        ...(options.required?.length ? { required: options.required } : {}),
+        ...(options.description ? { description: options.description } : {}),
+    };
+}
+/** 流程 requestId：服务端返回字符串，请求也接受数字或数字字符串。 */
+export const SCHEMA_REQUEST_ID = { oneOf: [{ type: 'integer' }, { type: 'string', pattern: '^\\d+$' }] };
+/** 流程分类：待办 / 已办 / 我发起 / 全部 */
+export const SCHEMA_CATEGORY = {
+    type: 'string',
+    enum: ['todo', 'done', 'mine', 'all'],
+    description: '这批流程属于哪个列表：待办=todo、已办=done、我发起的=mine、全部流程=all。'
+        + '只按"用户要看哪个列表"判定，与问句里的其他条件无关——句中的"我/我的"若只是筛选条件取值'
+        + '（如"费用承担人是我"）、"提交/发起/创建"若只是时间短语的修饰（如"本月提交的"）都**不构成 mine**。'
+        + '按这些判不出列表但用户给了筛选条件时用 all；连筛选条件都没有时先反问用户要查哪一批。',
+};
+/** 序号（1 基） */
+export const SCHEMA_INDEX = { type: 'integer', minimum: 1 };
+/** 分页大小 */
+export const SCHEMA_PAGE_SIZE = { type: 'integer', minimum: 1, maximum: 100 };
+/** prepare 阶段返回的续跑句柄（CLI 在本机托管载荷，模型只原样回传） */
+export const SCHEMA_CONTINUATION = {
+    type: 'string',
+    minLength: 1,
+    description: 'Prepare 阶段（含 createForm / editLoad 等前置步骤）返回的续跑句柄，形如 wc-1a2b3c4d5e6f7a8b；载荷由 CLI 在本机托管，原样回传即可，不要解析、改写、拼接或跨操作复用',
+};
+/** 写操作明确确认标记 */
+export const SCHEMA_CONFIRM = { const: true };
+/** prepare/apply 成对写操作共用的输入属性。 */
+export const CONTINUATION_INPUT = {
+    continuation: SCHEMA_CONTINUATION,
+    confirm: SCHEMA_CONFIRM,
+};