@rytass/bpm-core-shared 0.3.0 → 0.5.0

package/src/lib/workflow-toolset.js

@@ -1,702 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WORKFLOW_TOOL_BY_NAME = exports.WORKFLOW_TOOLSET = void 0;
-exports.readWorkflowSnapshot = readWorkflowSnapshot;
-exports.executeWorkflowTool = executeWorkflowTool;
-const tslib_1 = require("tslib");
-const workflow_graph_1 = require("./workflow-graph");
-const workflow_command_1 = require("./workflow-command");
-// ── Reusable schema fragments ──────────────────────────────────────────────
-const NODE_TYPE_ENUM = ['userTask', 'serviceTask', 'exclusiveGateway'];
-const TRIGGER_MODE_ENUM = ['AND', 'OR'];
-const RESUBMIT_STRATEGY_ENUM = [
-    'FROM_RETURN_POINT',
-    'RESTART',
-];
-const CONDITION_OPERATOR_ENUM = workflow_graph_1.CONDITION_OPERATOR_OPTIONS.map((option) => option.id);
-const APPROVER_RESOLVER_SCHEMA = {
-    description: '簽核人員解析策略，以 type 區分。DIRECT: { type, memberIds[] }；POSITION: { type, positionId }；' +
-        'ORG_UNIT_MEMBER: { type, orgUnitId, includeDescendants? }；ORG_UNIT_POSITION: { type, orgUnitId, positionId, includeDescendants? }；' +
-        'ORG_MANAGER: { type, baseFromInitiator, levelsUp, fallback? }；ORG_UNIT_MANAGER: { type, orgUnitId, fallback? }；' +
-        'DYNAMIC_FORM: { type, formPath }；EXPRESSION: { type, expression }。',
-    properties: {
-        type: {
-            enum: [
-                'DIRECT',
-                'POSITION',
-                'ORG_UNIT_MEMBER',
-                'ORG_UNIT_POSITION',
-                'ORG_MANAGER',
-                'ORG_UNIT_MANAGER',
-                'DYNAMIC_FORM',
-                'EXPRESSION',
-            ],
-            type: 'string',
-        },
-    },
-    required: ['type'],
-    type: 'object',
-};
-const SERVICE_ACTION_SCHEMA = {
-    description: '系統節點動作，以 type 區分。NOTIFY: { type, channels[], recipients(ApproverResolver), template? }；' +
-        'WEBHOOK: { type, url, headers?, payload? }；SET_FORM_FIELD: { type, fieldPath, value }。',
-    properties: {
-        type: { enum: ['NOTIFY', 'WEBHOOK', 'SET_FORM_FIELD'], type: 'string' },
-    },
-    required: ['type'],
-    type: 'object',
-};
-function objectSchema(properties, required) {
-    return { additionalProperties: false, properties, required, type: 'object' };
-}
-// ── Tool catalog ───────────────────────────────────────────────────────────
-exports.WORKFLOW_TOOLSET = [
-    {
-        name: 'add_node',
-        description: '在流程中新增一個節點（簽核/系統/條件分流）。可選擇插入錨點：anchorEdgeId 會把節點插入該連線中間；anchorAfterNodeId 會接在該節點之後；皆未指定時沿用目前選取或追加到末端。',
-        inputSchema: objectSchema({
-            nodeType: { enum: [...NODE_TYPE_ENUM], type: 'string' },
-            anchorEdgeId: { type: ['string', 'null'] },
-            anchorAfterNodeId: { type: ['string', 'null'] },
-        }, ['nodeType']),
-        kind: 'mutation',
-    },
-    {
-        name: 'rename_node',
-        description: '修改節點顯示名稱。',
-        inputSchema: objectSchema({ nodeId: { type: 'string' }, label: { type: 'string' } }, ['nodeId', 'label']),
-        kind: 'mutation',
-    },
-    {
-        name: 'delete_node',
-        description: '刪除節點及其相連的連線（開始/結束節點不可刪除）。',
-        inputSchema: objectSchema({ nodeId: { type: 'string' } }, ['nodeId']),
-        kind: 'mutation',
-    },
-    {
-        name: 'set_node_trigger_mode',
-        description: '設定節點觸發模式：AND=所有前置完成才觸發；OR=任一前置完成即觸發（僅多重輸入時有意義）。',
-        inputSchema: objectSchema({
-            nodeId: { type: 'string' },
-            triggerMode: { enum: [...TRIGGER_MODE_ENUM], type: 'string' },
-        }, ['nodeId', 'triggerMode']),
-        kind: 'mutation',
-    },
-    {
-        name: 'set_user_task_approver',
-        description: '設定簽核節點的簽核人員（會將決策政策重設為 SINGLE）。approverResolver 可省略或不完整 —— 此時預設為「直屬主管」（ORG_MANAGER，往上 1 層）。',
-        inputSchema: objectSchema({ nodeId: { type: 'string' }, approverResolver: APPROVER_RESOLVER_SCHEMA }, ['nodeId']),
-        kind: 'mutation',
-    },
-    {
-        name: 'set_user_task_options',
-        description: '設定簽核節點的選項開關與描述：是否允許駁回/轉簽/加簽，以及節點描述。只更新有提供的欄位。',
-        inputSchema: objectSchema({
-            nodeId: { type: 'string' },
-            allowReject: { type: 'boolean' },
-            allowTransfer: { type: 'boolean' },
-            allowAddSigner: { type: 'boolean' },
-            description: { type: 'string' },
-        }, ['nodeId']),
-        kind: 'mutation',
-    },
-    {
-        name: 'set_user_task_return_resubmit_strategy',
-        description: '設定簽核節點退回後的重送策略：RESTART=從頭重跑；FROM_RETURN_POINT=回到退回節點。',
-        inputSchema: objectSchema({
-            nodeId: { type: 'string' },
-            resubmitStrategy: { enum: [...RESUBMIT_STRATEGY_ENUM], type: 'string' },
-        }, ['nodeId', 'resubmitStrategy']),
-        kind: 'mutation',
-    },
-    {
-        name: 'set_service_action',
-        description: '設定系統節點的動作（NOTIFY 知會 / WEBHOOK / SET_FORM_FIELD）。',
-        inputSchema: objectSchema({ nodeId: { type: 'string' }, action: SERVICE_ACTION_SCHEMA }, ['nodeId', 'action']),
-        kind: 'mutation',
-    },
-    {
-        name: 'set_end_state',
-        description: '設定結束節點的最終狀態（APPROVED / REJECTED）。',
-        inputSchema: objectSchema({
-            nodeId: { type: 'string' },
-            endState: { enum: ['APPROVED', 'REJECTED'], type: 'string' },
-        }, ['nodeId', 'endState']),
-        kind: 'mutation',
-    },
-    {
-        name: 'connect_edge',
-        description: '在兩個節點之間建立連線（source → target）。若 source 不可輸出或 target 不可輸入則拒絕。',
-        inputSchema: objectSchema({ source: { type: 'string' }, target: { type: 'string' } }, ['source', 'target']),
-        kind: 'mutation',
-    },
-    {
-        name: 'delete_edge',
-        description: '刪除一條連線。',
-        inputSchema: objectSchema({ edgeId: { type: 'string' } }, ['edgeId']),
-        kind: 'mutation',
-    },
-    {
-        name: 'set_edge_condition',
-        description: '設定條件分流輸出連線的條件（依綁定表單欄位）。fieldKey 為表單欄位、operator 為比較運算子、value 為比較值；系統會自動編譯為 CEL 條件並產生標籤。需先綁定表單。',
-        inputSchema: objectSchema({
-            edgeId: { type: 'string' },
-            fieldKey: { type: ['string', 'null'] },
-            operator: { enum: [...CONDITION_OPERATOR_ENUM, null], type: ['string', 'null'] },
-            value: { type: ['string', 'null'] },
-        }, ['edgeId']),
-        kind: 'mutation',
-    },
-    {
-        name: 'set_edge_default',
-        description: '將條件分流的某條輸出連線設為（或取消）預設路徑；設為預設時會自動取消同源其他連線的預設。',
-        inputSchema: objectSchema({ edgeId: { type: 'string' }, isDefault: { type: 'boolean' } }, ['edgeId', 'isDefault']),
-        kind: 'mutation',
-    },
-    {
-        name: 'set_initiator_policy_cel',
-        description: '直接設定發起人政策的 CEL 條件式（傳 null 代表清除/不限制）。',
-        inputSchema: objectSchema({ cel: { type: ['string', 'null'] } }, ['cel']),
-        kind: 'mutation',
-    },
-    {
-        name: 'auto_layout',
-        description: '對整個流程套用自動排版（由前端 dagre 重新計算節點座標）。',
-        inputSchema: objectSchema({}, []),
-        kind: 'mutation',
-    },
-    // ── Macros ──
-    {
-        name: 'insert_approval_step',
-        description: '高階：新增一個簽核關卡。approverResolver 可省略 —— 省略或資料不全時，預設為「直屬主管」（ORG_MANAGER，從申請人往上 1 層），不需要真實會員 id。畫初稿時建議直接省略簽核人、先把流程結構建出來。',
-        inputSchema: objectSchema({
-            approverResolver: APPROVER_RESOLVER_SCHEMA,
-            label: { type: 'string' },
-            anchorEdgeId: { type: ['string', 'null'] },
-            anchorAfterNodeId: { type: ['string', 'null'] },
-        }, []),
-        kind: 'macro',
-    },
-    {
-        name: 'insert_notification',
-        description: '高階：新增一個系統通知關卡。action 可省略 —— 省略或資料不全時，預設為站內通知（NOTIFY / IN_APP / 收件者為直屬主管）。',
-        inputSchema: objectSchema({
-            action: SERVICE_ACTION_SCHEMA,
-            label: { type: 'string' },
-            anchorEdgeId: { type: ['string', 'null'] },
-            anchorAfterNodeId: { type: ['string', 'null'] },
-        }, []),
-        kind: 'macro',
-    },
-    {
-        name: 'insert_conditional_branch',
-        description: '高階：新增一個條件分流節點（可選 label 與插入錨點）。',
-        inputSchema: objectSchema({
-            label: { type: 'string' },
-            anchorEdgeId: { type: ['string', 'null'] },
-            anchorAfterNodeId: { type: ['string', 'null'] },
-        }, []),
-        kind: 'macro',
-    },
-    // ── Queries ──
-    {
-        name: 'get_workflow_snapshot',
-        description: '讀取目前流程的精簡快照：所有節點、連線、選取狀態、表單綁定、發起人政策、以及驗證問題。動作前應先呼叫以了解現況。',
-        inputSchema: objectSchema({}, []),
-        kind: 'query',
-    },
-    {
-        name: 'describe_node_types',
-        description: '取得可用節點型別與其資料結構說明。',
-        inputSchema: objectSchema({}, []),
-        kind: 'query',
-    },
-    {
-        name: 'list_form_fields',
-        description: '列出目前綁定表單的欄位（fieldKey、型別、標籤），供設定條件分流條件時參考。',
-        inputSchema: objectSchema({}, []),
-        kind: 'query',
-    },
-    {
-        name: 'validate_workflow',
-        description: '檢查目前流程設定是否完整，回傳問題描述（無問題則為 null）。',
-        inputSchema: objectSchema({}, []),
-        kind: 'query',
-    },
-    {
-        name: 'list_org_units',
-        description: '列出組織單位（id、名稱），供指定 ORG_UNIT_MEMBER / ORG_UNIT_POSITION / ORG_UNIT_MANAGER 簽核人時取得真實 orgUnitId。',
-        inputSchema: objectSchema({}, []),
-        kind: 'query',
-    },
-    {
-        name: 'list_positions',
-        description: '列出職位（id、名稱），供指定 POSITION / ORG_UNIT_POSITION 簽核人時取得真實 positionId。',
-        inputSchema: objectSchema({}, []),
-        kind: 'query',
-    },
-    {
-        name: 'search_members',
-        description: '依關鍵字搜尋會員（回傳 id、姓名、email），供指定 DIRECT 簽核人或通知收件者時取得真實 memberId。使用者點名某人時先用這個查到 id 再設定。',
-        inputSchema: objectSchema({ query: { type: 'string' } }, ['query']),
-        kind: 'query',
-    },
-];
-/** Quick lookup of a tool definition by name. */
-exports.WORKFLOW_TOOL_BY_NAME = new Map(exports.WORKFLOW_TOOLSET.map((tool) => [tool.name, tool]));
-function readWorkflowSnapshot(state) {
-    return {
-        edges: state.definition.edges.map((edge) => readEdgeSnapshot(edge, state.definition.nodes)),
-        formDefinitionVersionId: state.formDefinitionVersionId,
-        initiatorPolicyCel: state.initiatorPolicyCel,
-        issue: readWorkflowIssue(state),
-        nodes: state.definition.nodes.map(readNodeSnapshot),
-        selectedEdgeIds: state.selectedEdgeIds,
-        selectedNodeId: state.selectedNodeId,
-    };
-}
-function readWorkflowIssue(state) {
-    return (0, workflow_graph_1.readWorkflowDefinitionIssue)(state.definition);
-}
-function readNodeSnapshot(node) {
-    return {
-        id: node.id,
-        label: node.data.label,
-        summary: readNodeSummary(node),
-        type: node.type,
-        typeLabel: workflow_graph_1.WORKFLOW_NODE_TYPE_LABELS[node.type],
-    };
-}
-function readNodeSummary(node) {
-    var _a, _b;
-    if (node.type === 'userTask') {
-        return `簽核人=${node.data.approverResolver.type}；觸發=${(_a = node.data.triggerMode) !== null && _a !== void 0 ? _a : 'AND'}`;
-    }
-    if (node.type === 'serviceTask') {
-        return `動作=${node.data.action.type}`;
-    }
-    if (node.type === 'endEvent') {
-        return `結束狀態=${(_b = node.data.endState) !== null && _b !== void 0 ? _b : 'APPROVED'}`;
-    }
-    if (node.type === 'exclusiveGateway' || node.type === 'parallelGateway') {
-        return `方向=${node.data.direction}`;
-    }
-    return '開始';
-}
-function readEdgeSnapshot(edge, nodes) {
-    var _a, _b;
-    return {
-        condition: (_a = edge.data.condition) !== null && _a !== void 0 ? _a : null,
-        conditionLabel: (_b = edge.data.label) !== null && _b !== void 0 ? _b : null,
-        id: edge.id,
-        isDefault: Boolean(edge.data.isDefault && (0, workflow_graph_1.isExclusiveGatewaySourceEdge)(edge, nodes)),
-        source: edge.source,
-        target: edge.target,
-    };
-}
-/**
- * Execute a single LLM tool call against the designer state. Mutations and
- * macros return the new state + a fresh snapshot; queries return read-only data.
- * Async because directory query tools may fetch from the host (GraphQL).
- */
-function executeWorkflowTool(state_1, toolName_1, rawInput_1) {
-    return tslib_1.__awaiter(this, arguments, void 0, function* (state, toolName, rawInput, options = {}) {
-        const tool = exports.WORKFLOW_TOOL_BY_NAME.get(toolName);
-        if (!tool) {
-            return { error: `未知的工具：${toolName}`, ok: false };
-        }
-        const input = isRecord(rawInput) ? rawInput : {};
-        try {
-            if (tool.kind === 'query') {
-                return {
-                    data: yield runQueryTool(state, toolName, input, options),
-                    kind: 'query',
-                    ok: true,
-                };
-            }
-            if (tool.kind === 'macro') {
-                const macro = buildMacroCommand(toolName, input);
-                const result = (0, workflow_command_1.applyWorkflowMacroCommand)(state, macro, options);
-                return finalizeMutation('macro', result);
-            }
-            const command = buildPrimitiveCommand(toolName, input);
-            const result = (0, workflow_command_1.applyWorkflowCommand)(state, command, options);
-            return finalizeMutation('mutation', result);
-        }
-        catch (error) {
-            return { error: readToolError(error), ok: false };
-        }
-    });
-}
-function finalizeMutation(kind, result) {
-    if (result.error) {
-        return { error: result.error, ok: false };
-    }
-    return {
-        kind,
-        ok: true,
-        result,
-        snapshot: readWorkflowSnapshot(result.state),
-    };
-}
-function runQueryTool(state, toolName, input, options) {
-    return tslib_1.__awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c;
-        if (toolName === 'get_workflow_snapshot') {
-            return readWorkflowSnapshot(state);
-        }
-        if (toolName === 'describe_node_types') {
-            return readNodeTypeCatalog();
-        }
-        if (toolName === 'list_form_fields') {
-            return readFormFieldCatalog(state.formSchema);
-        }
-        if (toolName === 'list_org_units') {
-            return readDirectoryResult((_a = options.directory) === null || _a === void 0 ? void 0 : _a.listOrgUnits());
-        }
-        if (toolName === 'list_positions') {
-            return readDirectoryResult((_b = options.directory) === null || _b === void 0 ? void 0 : _b.listPositions());
-        }
-        if (toolName === 'search_members') {
-            const query = typeof input['query'] === 'string' ? input['query'] : '';
-            return readDirectoryResult((_c = options.directory) === null || _c === void 0 ? void 0 : _c.searchMembers(query));
-        }
-        // validate_workflow
-        return { issue: readWorkflowIssue(state) };
-    });
-}
-function readDirectoryResult(pending) {
-    return tslib_1.__awaiter(this, void 0, void 0, function* () {
-        if (!pending) {
-            return { available: false, items: [] };
-        }
-        return { available: true, items: yield pending };
-    });
-}
-// ── Command builders (parse LLM input → typed command) ──────────────────────
-function buildPrimitiveCommand(toolName, input) {
-    switch (toolName) {
-        case 'add_node':
-            return {
-                anchor: readAnchor(input),
-                nodeType: readEnum(input, 'nodeType', NODE_TYPE_ENUM),
-                type: 'addNode',
-            };
-        case 'rename_node':
-            return {
-                label: readString(input, 'label'),
-                nodeId: readString(input, 'nodeId'),
-                type: 'renameNode',
-            };
-        case 'delete_node':
-            return { nodeId: readString(input, 'nodeId'), type: 'deleteNode' };
-        case 'set_node_trigger_mode':
-            return {
-                nodeId: readString(input, 'nodeId'),
-                triggerMode: readEnum(input, 'triggerMode', TRIGGER_MODE_ENUM),
-                type: 'setNodeTriggerMode',
-            };
-        case 'set_user_task_approver':
-            return {
-                approverResolver: parseApproverResolver(input['approverResolver']),
-                nodeId: readString(input, 'nodeId'),
-                type: 'setUserTaskApprover',
-            };
-        case 'set_user_task_options':
-            return Object.assign(Object.assign(Object.assign(Object.assign({ nodeId: readString(input, 'nodeId'), type: 'setUserTaskOptions' }, readOptionalBoolean(input, 'allowReject', 'allowReject')), readOptionalBoolean(input, 'allowTransfer', 'allowTransfer')), readOptionalBoolean(input, 'allowAddSigner', 'allowAddSigner')), readOptionalString(input, 'description', 'description'));
-        case 'set_user_task_return_resubmit_strategy':
-            return {
-                nodeId: readString(input, 'nodeId'),
-                resubmitStrategy: readEnum(input, 'resubmitStrategy', RESUBMIT_STRATEGY_ENUM),
-                type: 'setUserTaskReturnResubmitStrategy',
-            };
-        case 'set_service_action':
-            return {
-                action: parseServiceAction(input['action']),
-                nodeId: readString(input, 'nodeId'),
-                type: 'setServiceAction',
-            };
-        case 'set_end_state':
-            return {
-                endState: readEnum(input, 'endState', ['APPROVED', 'REJECTED']),
-                nodeId: readString(input, 'nodeId'),
-                type: 'setEndState',
-            };
-        case 'connect_edge':
-            return {
-                source: readString(input, 'source'),
-                target: readString(input, 'target'),
-                type: 'connectEdge',
-            };
-        case 'delete_edge':
-            return { edgeId: readString(input, 'edgeId'), type: 'deleteEdge' };
-        case 'set_edge_condition':
-            return {
-                edgeId: readString(input, 'edgeId'),
-                type: 'setEdgeCondition',
-                fieldKey: readNullableString(input, 'fieldKey'),
-                operator: readNullableEnum(input, 'operator', CONDITION_OPERATOR_ENUM),
-                value: readNullableString(input, 'value'),
-            };
-        case 'set_edge_default':
-            return {
-                edgeId: readString(input, 'edgeId'),
-                isDefault: readBoolean(input, 'isDefault'),
-                type: 'setEdgeDefault',
-            };
-        case 'set_initiator_policy_cel':
-            return {
-                cel: readNullableString(input, 'cel'),
-                type: 'setInitiatorPolicyCel',
-            };
-        case 'auto_layout':
-            return { type: 'autoLayout' };
-        default:
-            throw new Error(`工具 ${toolName} 尚未支援。`);
-    }
-}
-function buildMacroCommand(toolName, input) {
-    if (toolName === 'insert_approval_step') {
-        return Object.assign({ anchor: readAnchor(input), approverResolver: parseApproverResolver(input['approverResolver']), type: 'insertApprovalStep' }, readOptionalString(input, 'label', 'label'));
-    }
-    if (toolName === 'insert_notification') {
-        return Object.assign({ action: parseServiceAction(input['action']), anchor: readAnchor(input), type: 'insertNotification' }, readOptionalString(input, 'label', 'label'));
-    }
-    return Object.assign({ anchor: readAnchor(input), type: 'insertConditionalBranch' }, readOptionalString(input, 'label', 'label'));
-}
-// ── Static catalogs for query tools ─────────────────────────────────────────
-function readNodeTypeCatalog() {
-    return {
-        nodeTypes: [
-            {
-                dataShape: 'label, approverResolver, decisionPolicy, returnBehavior, allowReject, allowTransfer, allowAddSigner, triggerMode, sla?, notification?',
-                label: workflow_graph_1.WORKFLOW_NODE_TYPE_LABELS.userTask,
-                type: 'userTask',
-            },
-            {
-                dataShape: 'label, action(NOTIFY|WEBHOOK|SET_FORM_FIELD), triggerMode',
-                label: workflow_graph_1.WORKFLOW_NODE_TYPE_LABELS.serviceTask,
-                type: 'serviceTask',
-            },
-            {
-                dataShape: 'label, direction(split|join), triggerMode；輸出連線需設定條件',
-                label: workflow_graph_1.WORKFLOW_NODE_TYPE_LABELS.exclusiveGateway,
-                type: 'exclusiveGateway',
-            },
-            {
-                dataShape: 'label（系統內建，固定存在）',
-                label: workflow_graph_1.WORKFLOW_NODE_TYPE_LABELS.startEvent,
-                type: 'startEvent',
-            },
-            {
-                dataShape: 'label, endState(APPROVED|REJECTED)',
-                label: workflow_graph_1.WORKFLOW_NODE_TYPE_LABELS.endEvent,
-                type: 'endEvent',
-            },
-        ],
-    };
-}
-function readFormFieldCatalog(schema) {
-    var _a;
-    return {
-        fields: (_a = schema === null || schema === void 0 ? void 0 : schema.fields.map((field) => ({
-            fieldKey: field.fieldKey,
-            label: field.label,
-            required: field.required,
-            type: field.type,
-        }))) !== null && _a !== void 0 ? _a : [],
-        hasBoundForm: Boolean(schema),
-    };
-}
-// ── Input parsing helpers (no `any`) ────────────────────────────────────────
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function readString(input, key) {
-    const value = input[key];
-    if (typeof value !== 'string' || value.length === 0) {
-        throw new Error(`參數 ${key} 必須為非空字串。`);
-    }
-    return value;
-}
-function readBoolean(input, key) {
-    const value = input[key];
-    if (typeof value !== 'boolean') {
-        throw new Error(`參數 ${key} 必須為布林值。`);
-    }
-    return value;
-}
-function readEnum(input, key, allowed) {
-    const value = input[key];
-    if (typeof value !== 'string' || !allowed.includes(value)) {
-        throw new Error(`參數 ${key} 必須為：${allowed.join(' / ')}。`);
-    }
-    return value;
-}
-function readNullableString(input, key) {
-    const value = input[key];
-    if (value === undefined || value === null) {
-        return null;
-    }
-    if (typeof value !== 'string') {
-        throw new Error(`參數 ${key} 必須為字串或 null。`);
-    }
-    return value;
-}
-function readNullableEnum(input, key, allowed) {
-    const value = input[key];
-    if (value === undefined || value === null) {
-        return null;
-    }
-    if (typeof value !== 'string' || !allowed.includes(value)) {
-        throw new Error(`參數 ${key} 必須為：${allowed.join(' / ')} 或 null。`);
-    }
-    return value;
-}
-function readOptionalBoolean(input, key, outKey) {
-    const value = input[key];
-    if (value === undefined) {
-        return {};
-    }
-    if (typeof value !== 'boolean') {
-        throw new Error(`參數 ${key} 必須為布林值。`);
-    }
-    return { [outKey]: value };
-}
-function readOptionalString(input, key, outKey) {
-    const value = input[key];
-    if (value === undefined) {
-        return {};
-    }
-    if (typeof value !== 'string') {
-        throw new Error(`參數 ${key} 必須為字串。`);
-    }
-    return { [outKey]: value };
-}
-function readAnchor(input) {
-    return {
-        afterNodeId: readNullableString(input, 'anchorAfterNodeId'),
-        edgeId: readNullableString(input, 'anchorEdgeId'),
-    };
-}
-/**
- * The always-valid default approver: the initiator's direct manager (one level
- * up). Needs no member/org id, so a draft built purely from this passes
- * validation — letting the assistant draw a flow from one sentence.
- */
-const DEFAULT_MANAGER_RESOLVER = {
-    baseFromInitiator: true,
-    levelsUp: 1,
-    type: 'ORG_MANAGER',
-};
-const DEFAULT_NOTIFY_ACTION = {
-    channels: ['IN_APP'],
-    recipients: DEFAULT_MANAGER_RESOLVER,
-    type: 'NOTIFY',
-};
-/**
- * Coerce an LLM-supplied approver resolver into a valid one, **never throwing**.
- * When required ids are missing (the model can't know real member/org ids), we
- * fall back to {@link DEFAULT_MANAGER_RESOLVER} so the operation still succeeds;
- * `validate_workflow` surfaces anything that still needs the user's attention.
- */
-function parseApproverResolver(value) {
-    if (!isRecord(value)) {
-        return DEFAULT_MANAGER_RESOLVER;
-    }
-    switch (value['type']) {
-        case 'DIRECT': {
-            const memberIds = readStringArray(value['memberIds']);
-            return memberIds.length > 0
-                ? { memberIds, type: 'DIRECT' }
-                : DEFAULT_MANAGER_RESOLVER;
-        }
-        case 'POSITION': {
-            const positionId = readNonEmptyString(value['positionId']);
-            return positionId
-                ? { positionId, type: 'POSITION' }
-                : DEFAULT_MANAGER_RESOLVER;
-        }
-        case 'ORG_UNIT_MEMBER': {
-            const orgUnitId = readNonEmptyString(value['orgUnitId']);
-            return orgUnitId
-                ? Object.assign({ orgUnitId, type: 'ORG_UNIT_MEMBER' }, readOptionalBoolean(value, 'includeDescendants', 'includeDescendants')) : DEFAULT_MANAGER_RESOLVER;
-        }
-        case 'ORG_UNIT_POSITION': {
-            const orgUnitId = readNonEmptyString(value['orgUnitId']);
-            const positionId = readNonEmptyString(value['positionId']);
-            return orgUnitId && positionId
-                ? Object.assign({ orgUnitId,
-                    positionId, type: 'ORG_UNIT_POSITION' }, readOptionalBoolean(value, 'includeDescendants', 'includeDescendants')) : DEFAULT_MANAGER_RESOLVER;
-        }
-        case 'ORG_MANAGER':
-            return {
-                baseFromInitiator: value['baseFromInitiator'] !== false,
-                levelsUp: readPositiveInteger(value['levelsUp'], 1),
-                type: 'ORG_MANAGER',
-            };
-        case 'ORG_UNIT_MANAGER': {
-            const orgUnitId = readNonEmptyString(value['orgUnitId']);
-            return orgUnitId
-                ? { orgUnitId, type: 'ORG_UNIT_MANAGER' }
-                : DEFAULT_MANAGER_RESOLVER;
-        }
-        case 'DYNAMIC_FORM': {
-            const formPath = readNonEmptyString(value['formPath']);
-            return formPath
-                ? { formPath, type: 'DYNAMIC_FORM' }
-                : DEFAULT_MANAGER_RESOLVER;
-        }
-        case 'EXPRESSION': {
-            const expression = readNonEmptyString(value['expression']);
-            return expression
-                ? { expression, type: 'EXPRESSION' }
-                : DEFAULT_MANAGER_RESOLVER;
-        }
-        default:
-            return DEFAULT_MANAGER_RESOLVER;
-    }
-}
-/** Coerce an LLM-supplied service action, **never throwing** (defaults to NOTIFY). */
-function parseServiceAction(value) {
-    if (!isRecord(value)) {
-        return DEFAULT_NOTIFY_ACTION;
-    }
-    if (value['type'] === 'WEBHOOK') {
-        const url = readNonEmptyString(value['url']);
-        return url
-            ? Object.assign({ type: 'WEBHOOK', url }, readOptionalString(value, 'payload', 'payload')) : DEFAULT_NOTIFY_ACTION;
-    }
-    if (value['type'] === 'SET_FORM_FIELD') {
-        const fieldPath = readNonEmptyString(value['fieldPath']);
-        const fieldValue = readNonEmptyString(value['value']);
-        return fieldPath && fieldValue
-            ? { fieldPath, type: 'SET_FORM_FIELD', value: fieldValue }
-            : DEFAULT_NOTIFY_ACTION;
-    }
-    // NOTIFY (default for any other / missing type).
-    return Object.assign({ channels: readNotifyChannels(value['channels']), recipients: parseApproverResolver(value['recipients']), type: 'NOTIFY' }, readOptionalString(value, 'template', 'template'));
-}
-function readStringArray(value) {
-    return Array.isArray(value)
-        ? value.filter((item) => typeof item === 'string' && item.length > 0)
-        : [];
-}
-function readNonEmptyString(value) {
-    return typeof value === 'string' && value.trim().length > 0 ? value : null;
-}
-function readPositiveInteger(value, fallback) {
-    return typeof value === 'number' && Number.isInteger(value) && value > 0
-        ? value
-        : fallback;
-}
-function readNotifyChannels(value) {
-    const channels = Array.isArray(value)
-        ? value.filter((item) => item === 'IN_APP' || item === 'EMAIL')
-        : [];
-    return channels.length > 0 ? channels : ['IN_APP'];
-}
-function readToolError(error) {
-    return error instanceof Error ? error.message : '工具執行發生未知錯誤。';
-}
-//# sourceMappingURL=workflow-toolset.js.map