meeglesdk 0.1.0

package/dist/types/workitem.d.ts

@@ -0,0 +1,1523 @@
+/**
+ * 工作项相关类型定义
+ * 100% 参考 Meego API 文档
+ */
+import type { FieldValuePair, RoleOwner, Schedule, UserDetail, Connection, MultiText } from './common.js';
+export type { UserDetail, Connection, MultiText };
+/** 工作流模式 */
+export type WorkItemPattern = 'Node' | 'State';
+/** 节点/状态流节点状态 */
+export type NodeStatus = 1 | 2 | 3;
+/** 节点负责人设置方式 */
+export type OwnerUsageMode = 1 | 2;
+/**
+ * 当前节点信息（节点流）
+ */
+export interface CurrentNode {
+    /** 节点 ID */
+    id: string;
+    /** 节点名称 */
+    name: string;
+    /** 负责人 user_key 数组 */
+    owners?: string[];
+    /** 是否里程碑 */
+    milestone?: boolean;
+}
+/**
+ * 工作项状态
+ */
+export interface WorkItemStatus {
+    /** 状态 key */
+    state_key: string;
+    /** 是否为完成状态 */
+    is_archived_state: boolean;
+    /** 是否为初始状态 */
+    is_init_state: boolean;
+    /** 状态更新时间（毫秒） */
+    updated_at: number;
+    /** 状态更新人 user_key */
+    updated_by: string;
+    /** 历史变更记录 */
+    history?: WorkItemStatusHistory[];
+}
+/**
+ * 工作项状态历史
+ */
+export interface WorkItemStatusHistory {
+    state_key: string;
+    is_archived_state: boolean;
+    is_init_state: boolean;
+    updated_at: number;
+    updated_by: string;
+}
+/**
+ * 状态时间记录
+ */
+export interface StateTime {
+    /** 状态名称 */
+    name: string;
+    /** 状态 key */
+    state_key: string;
+    /** 开始时间（毫秒） */
+    start_time: number;
+    /** 结束时间（毫秒），0 表示未结束 */
+    end_time: number;
+}
+/**
+ * 工作流节点（节点流）
+ */
+export interface WorkflowNode {
+    /** 节点 ID */
+    id: string;
+    /** 状态 key */
+    state_key: string;
+    /** 节点名称 */
+    name: string;
+    /** 节点状态 1:未开始 2:进行中 3:已完成 */
+    status: NodeStatus;
+    /** 节点表单字段 */
+    fields?: FieldValuePair[];
+    /** 负责人 user_key 数组 */
+    owners?: string[];
+    /** 节点总排期 */
+    node_schedule?: Schedule;
+    /** 差异化排期数组 */
+    schedules?: Schedule[];
+    /** 子任务列表 */
+    sub_tasks?: SubTask[];
+    /** 实际开始时间 */
+    actual_begin_time?: string;
+    /** 实际结束时间 */
+    actual_finish_time?: string;
+    /** 角色负责人 */
+    role_assignee?: RoleOwner[];
+    /** 是否里程碑节点 */
+    milestone?: boolean;
+    /** 负责人设置方式 */
+    owner_usage_mode?: OwnerUsageMode;
+    /** 是否差异化排期 */
+    different_schedule?: boolean;
+}
+/**
+ * 状态流节点
+ */
+export interface StateFlowNode {
+    /** 状态 ID */
+    id: string;
+    /** 状态名称 */
+    name: string;
+    /** 状态 */
+    status: NodeStatus;
+    /** 字段 */
+    fields?: FieldValuePair[];
+    /** 角色负责人 */
+    role_owners?: RoleOwner[];
+    /** 状态开始时间 */
+    actual_begin_time?: string;
+    /** 状态结束时间 */
+    actual_finish_time?: string;
+}
+/**
+ * 工作流信息
+ */
+export interface WorkflowInfo {
+    /** 模板版本 */
+    version: number;
+    /** 模板 ID */
+    template_id: number;
+    /** 用户详情 */
+    user_details?: UserDetail[];
+    /** 节点流节点数组 */
+    workflow_nodes?: WorkflowNode[];
+    /** 状态流节点数组 */
+    state_flow_nodes?: StateFlowNode[];
+    /** 连接数组 */
+    connections?: Array<{
+        transition_id?: number;
+        source_state_key: string;
+        target_state_key: string;
+    }>;
+}
+/**
+ * 关联字段详情
+ */
+export interface RelationFieldDetail {
+    /** 关联字段 key */
+    field_key: string;
+    /** 关联详情 */
+    detail: Array<{
+        /** 关联工作项 ID */
+        story_id: number;
+        /** 关联空间 key */
+        project_key: string;
+        /** 关联工作项类型 */
+        work_item_type_key: string;
+    }>;
+}
+/**
+ * 工作项信息
+ */
+export interface WorkItem {
+    /** 工作项 ID */
+    id: number;
+    /** 工作项名称 */
+    name: string;
+    /** 工作项类型 key */
+    work_item_type_key: string;
+    /** 所属空间 ID */
+    project_key: string;
+    /** 模板 ID */
+    template_id: number;
+    /** 模板类型 */
+    template_type?: string;
+    /** 工作流模式 */
+    pattern: WorkItemPattern;
+    /** 工作项标识 */
+    simple_name?: string;
+    /** 创建人 user_key */
+    created_by: string;
+    /** 更新人 user_key */
+    updated_by: string;
+    /** 删除人 user_key */
+    deleted_by?: string;
+    /** 创建时间（毫秒） */
+    created_at: number;
+    /** 更新时间（毫秒） */
+    updated_at: number;
+    /** 删除时间（毫秒） */
+    deleted_at?: number;
+    /** 当前节点（节点流） */
+    current_nodes?: CurrentNode[];
+    /** 工作项状态 */
+    work_item_status?: WorkItemStatus;
+    /** 状态时间记录（节点流） */
+    state_times?: StateTime[];
+    /** 字段列表 */
+    fields?: FieldValuePair[];
+    /** 用户详情（扩展查询） */
+    user_details?: UserDetail[];
+    /** 富文本信息（扩展查询） */
+    multi_texts?: MultiText[];
+    /** 工作流信息（扩展查询） */
+    workflow_infos?: WorkflowInfo;
+    /** 关联字段详情（扩展查询） */
+    relation_fields_detail?: RelationFieldDetail[];
+}
+/**
+ * 查询扩展选项
+ */
+export interface QueryWorkItemExpand {
+    /** 是否需要用户详细信息 */
+    need_user_detail?: boolean;
+    /** 是否需要工作流信息 */
+    need_workflow?: boolean;
+    /** 是否需要富文本信息 */
+    need_multi_text?: boolean;
+    /** 是否需要关联字段详情 */
+    relation_fields_detail?: boolean;
+    /** 是否需要复合字段组标识 */
+    need_group_uuid_for_compound?: boolean;
+}
+/**
+ * 获取工作项详情请求
+ */
+export interface QueryWorkItemRequest {
+    /** 工作项 ID 列表（最多 50 个） */
+    work_item_ids: number[];
+    /** 返回的字段（可选，默认全部） */
+    fields?: string[];
+    /** 扩展查询选项 */
+    expand?: QueryWorkItemExpand;
+}
+/**
+ * 创建工作项请求
+ */
+export interface CreateWorkItemRequest {
+    /** 工作项类型 key */
+    work_item_type_key: string;
+    /** 工作项名称 */
+    name?: string;
+    /** 流程模板 ID */
+    template_id?: number;
+    /** 字段值列表 */
+    field_value_pairs?: FieldValuePair[];
+}
+/**
+ * 更新工作项请求
+ */
+export interface UpdateWorkItemRequest {
+    /** 更新的字段 */
+    update_fields?: FieldValuePair[];
+}
+/**
+ * 删除工作项请求
+ */
+export interface DeleteWorkItemRequest {
+    /** 工作项 ID */
+    work_item_id: number;
+}
+/**
+ * 字段选项
+ */
+export interface FieldOption {
+    /** 选项值 */
+    value: string;
+    /** 选项标签 */
+    label: string;
+    /** 是否默认选中 */
+    is_default?: boolean;
+    /** 子选项（级联） */
+    children?: FieldOption[];
+}
+/**
+ * 字段元数据
+ */
+export interface FieldMeta {
+    /** 字段 key */
+    field_key: string;
+    /** 字段别名 */
+    field_alias?: string;
+    /** 字段名称 */
+    field_name: string;
+    /** 字段类型 */
+    field_type_key: string;
+    /** 是否必填 */
+    is_required?: boolean;
+    /** 是否可编辑 */
+    is_editable?: boolean;
+    /** 选项列表 */
+    options?: FieldOption[];
+    /** 默认值 */
+    default_value?: unknown;
+}
+/**
+ * 获取创建元数据响应
+ * API 直接返回字段数组
+ */
+export type GetWorkItemMetaResponse = FieldMeta[];
+/** 操作者类型 */
+export type OperatorType = 'user' | 'auto' | 'system' | 'calc_field' | 'plugin' | 'others';
+/** 操作渠道类型 */
+export type SourceType = 'auto' | 'plugin';
+/** 操作动作类型 */
+export type OperationType = 'modify' | 'create' | 'delete' | 'terminate' | 'restore' | 'complete' | 'rollback' | 'add' | 'remove';
+/** 操作记录模块 */
+export type OpRecordModule = 'work_item_mod' | 'node_mod' | 'sub_task_mod' | 'field_mod' | 'role_and_user_mod' | 'baseline_mod';
+/**
+ * 获取操作记录请求
+ */
+export interface GetOperationRecordsRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项 ID 列表（最多 50 个） */
+    work_item_ids: number[];
+    /** 分页参数 */
+    start_from?: string;
+    /** 操作者 */
+    operator?: string[];
+    /** 操作者类型 */
+    operator_type?: OperatorType[];
+    /** 操作渠道类型 */
+    source_type?: SourceType[];
+    /** 操作渠道值 */
+    source?: string[];
+    /** 操作动作类型 */
+    operation_type?: OperationType[];
+    /** 开始时间（毫秒） */
+    start?: number;
+    /** 结束时间（毫秒） */
+    end?: number;
+    /** 操作记录模块 */
+    op_record_module?: OpRecordModule[];
+    /** 每页数据条数（最大 200） */
+    page_size?: number;
+}
+/**
+ * 变更对象
+ */
+export interface RecordObject {
+    /** 对象类型 */
+    object_type: 'work_item' | 'node' | 'sub_task' | 'field' | 'role_and_user' | 'template' | 'owner';
+    /** 对象值 */
+    object_value: string;
+}
+/**
+ * 状态值
+ */
+export interface StatusValue {
+    /** 属性值 */
+    values: string[];
+    /** 对象属性 */
+    object_property: string;
+}
+/**
+ * 记录内容
+ */
+export interface RecordContent {
+    /** 变更主体对象 */
+    object: RecordObject;
+    /** 变更前的值 */
+    old?: string[];
+    /** 变更后的值 */
+    new?: string[];
+    /** 新增的值 */
+    add?: string[];
+    /** 删除的值 */
+    delete?: string[];
+    /** 状态值 */
+    status_values?: StatusValue[];
+    /** 所属对象 */
+    belong_object?: RecordObject[];
+    /** 其他信息 */
+    extra?: Record<string, unknown>;
+}
+/**
+ * 操作记录
+ */
+export interface OperationRecord {
+    /** 空间 key */
+    project_key: string;
+    /** 操作动作类型 */
+    operation_type: OperationType;
+    /** 操作时间（毫秒） */
+    operation_time: number;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 工作项类型 */
+    work_item_type_key: string;
+    /** 操作者类型 */
+    operator_type: OperatorType;
+    /** 操作者 */
+    operator: string;
+    /** 操作记录模块 */
+    op_record_module: OpRecordModule;
+    /** 操作渠道类型 */
+    source_type?: SourceType;
+    /** 操作渠道值 */
+    source?: string;
+    /** 记录内容 */
+    record_contents: RecordContent[];
+}
+/**
+ * 获取操作记录响应
+ */
+export interface GetOperationRecordsResponse {
+    /** 是否有更多 */
+    has_more: boolean;
+    /** 分页参数 */
+    start_from: string;
+    /** 操作记录列表 */
+    op_records: OperationRecord[];
+    /** 总数 */
+    total?: number;
+}
+/** 复合字段操作类型 */
+export type CompoundFieldAction = 'add' | 'update' | 'delete';
+/**
+ * 更新复合字段请求
+ */
+export interface UpdateCompoundFieldRequest {
+    /** 空间 ID 或域名 */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 复合字段 key（与 field_alias 二选一） */
+    field_key?: string;
+    /** 复合字段对接标识（与 field_key 二选一） */
+    field_alias?: string;
+    /** 组标识（update/delete 时必填） */
+    group_uuid?: string;
+    /** 操作类型 */
+    action: CompoundFieldAction;
+    /** 字段值（add/update 时使用） */
+    fields?: FieldValuePair[][];
+}
+/**
+ * 上传文件请求参数（添加附件到工作项）
+ */
+export interface UploadAttachmentRequest {
+    /** 文件数据 */
+    file: Blob | File | Buffer;
+    /** 文件名（可选，默认取 file.name 或使用 "file"） */
+    fileName?: string;
+    /** 附件字段 key（与 field_alias 二选一） */
+    field_key?: string;
+    /** 附件字段对接标识（与 field_key 二选一） */
+    field_alias?: string;
+    /** 复合字段数组下标（可选） */
+    index?: string;
+}
+/**
+ * 上传通用文件请求参数（用于富文本图片等）
+ */
+export interface UploadFileRequest {
+    /** 文件数据 */
+    file: Blob | File | Buffer;
+    /** 文件名（可选，默认取 file.name 或使用 "file"） */
+    fileName?: string;
+}
+/**
+ * 下载附件请求参数
+ */
+export interface DownloadAttachmentRequest {
+    /** 附件 UUID */
+    uuid: string;
+}
+/**
+ * 删除附件请求参数
+ */
+export interface DeleteAttachmentRequest {
+    /** 空间 ID 或域名 */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 附件字段 key（与 field_alias 二选一） */
+    field_key?: string;
+    /** 附件字段对接标识（与 field_key 二选一） */
+    field_alias?: string;
+    /** 要删除的附件 UUID 列表 */
+    uuids: string[];
+}
+/**
+ * 创建子任务请求
+ */
+export interface CreateSubtaskRequest {
+    /** 目标节点 ID（节点 ID 或节点 state_key 等价） */
+    node_id: string;
+    /** 子任务名称 */
+    name: string;
+    /** 目标节点的对接标识 */
+    alias_key?: string;
+    /** 子任务负责人的 userKey 列表（非角色联动模式使用） */
+    assignee?: string[];
+    /** 子任务角色负责人列表（角色联动模式使用） */
+    role_assignee?: RoleOwner[];
+    /** 子任务的排期信息 */
+    schedule?: Schedule;
+    /** 子任务的备注信息 */
+    note?: string;
+    /** 自定义字段及其对应的值列表 */
+    field_value_pairs?: FieldValuePair[];
+}
+/**
+ * 更新子任务请求
+ */
+export interface UpdateSubtaskRequest {
+    /** 子任务名称 */
+    name?: string;
+    /** 子任务负责人的 userKey 列表（非角色联动模式使用） */
+    assignee?: string[];
+    /** 子任务角色负责人列表（角色联动模式使用） */
+    role_assignee?: RoleOwner[];
+    /** 子任务的排期信息 */
+    schedule?: Schedule;
+    /** 子任务的备注信息 */
+    note?: string;
+    /** 交付物字段列表 */
+    deliverable?: FieldValuePair[];
+    /** 目标更新的字段列表 */
+    update_fields?: FieldValuePair[];
+}
+/** 子任务操作类型 */
+export type SubtaskAction = 'confirm' | 'rollback';
+/**
+ * 完成/回滚子任务请求
+ */
+export interface CompleteRollbackSubtaskRequest {
+    /** 目标节点 ID */
+    node_id: string;
+    /** 子任务 ID */
+    task_id: number;
+    /** 操作类型：confirm=完成，rollback=回滚 */
+    action: SubtaskAction;
+    /** 子任务负责人的 userKey 列表（非角色联动模式使用） */
+    assignee?: string[];
+    /** 子任务角色负责人列表（角色联动模式使用） */
+    role_assignee?: RoleOwner[];
+    /** 估分排期信息 */
+    schedules?: Schedule[];
+    /** 交付物字段列表 */
+    deliverable?: FieldValuePair[];
+    /** 备注信息 */
+    note?: string;
+}
+/**
+ * 获取子任务详情查询参数
+ */
+export interface GetSubtasksQuery {
+    /** 目标节点的 state_key，不传则查询所有节点的子任务 */
+    node_id?: string;
+}
+/** 子任务状态：0=进行中，1=已完成 */
+export type SubtaskStatus = 0 | 1;
+/**
+ * 搜索子任务请求（跨空间）
+ */
+export interface SearchSubtasksRequest {
+    /** 需要查询的空间 ID 列表 */
+    project_keys?: string[];
+    /** 空间域名列表 */
+    simple_names?: string[];
+    /** 分页大小，默认50 */
+    page_size?: number;
+    /** 页码，默认1 */
+    page_num?: number;
+    /** 子任务名称，支持模糊匹配 */
+    name?: string;
+    /** 子任务负责人的 userKey 列表 */
+    user_keys?: string[];
+    /** 子任务状态：0=进行中，1=已完成 */
+    status?: SubtaskStatus;
+    /** 创建时间区间 */
+    created_at?: {
+        /** 开始时间，毫秒精度 */
+        start?: number;
+        /** 结束时间，毫秒精度 */
+        end?: number;
+    };
+}
+/**
+ * 子任务信息
+ */
+export interface SubTask {
+    /** 子任务 ID */
+    id: string;
+    /** 子任务名称 */
+    name: string;
+    /** 排期数组 */
+    schedules?: Schedule[];
+    /** 排序字段 */
+    order?: number;
+    /** 是否已完成 */
+    passed: boolean;
+    /** 负责人 userKey 数组 */
+    owners?: string[];
+    /** 备注 */
+    note?: string;
+    /** 子任务负责人 userKey 列表（非角色联动模式） */
+    assignee?: string[];
+    /** 子任务角色负责人列表（角色联动模式） */
+    role_assignee?: RoleOwner[];
+    /** 交付物 */
+    deliverable?: FieldValuePair[];
+    /** 自定义字段 */
+    fields?: FieldValuePair[];
+    /** 备注（同 note） */
+    details?: string;
+    /** 实际开始时间，ISO 8601 格式 */
+    actual_begin_time?: string;
+    /** 实际完成时间，ISO 8601 格式 */
+    actual_finish_time?: string;
+    /** 子任务负责人分配模式（1: 自行添加，2: 与角色联动） */
+    owner_usage_mode?: number;
+    /** 子任务负责人范围或者关联的角色 */
+    owner_roles?: string[];
+}
+/**
+ * 节点子任务信息
+ */
+export interface NodeTask {
+    /** 节点 ID */
+    id: string;
+    /** 节点 state_key */
+    state_key: string;
+    /** 子任务列表 */
+    sub_tasks: SubTask[];
+}
+/**
+ * 子任务搜索结果项
+ */
+export interface SubtaskSearchResult {
+    /** 工作项实例 ID */
+    work_item_id: number;
+    /** 工作项实例名称 */
+    work_item_name: string;
+    /** 节点 ID */
+    node_id: string;
+    /** 子任务信息 */
+    sub_task: SubTask;
+}
+/**
+ * 搜索子任务响应
+ */
+export interface SearchSubtasksResponse {
+    /** 分页信息 */
+    pagination: {
+        /** 总记录数 */
+        total: number;
+        /** 当前页码 */
+        page_num: number;
+        /** 每页数据条数 */
+        page_size: number;
+    };
+    /** 搜索结果列表 */
+    data: SubtaskSearchResult[];
+}
+/**
+ * 富文本内容（用于评论）
+ */
+export interface CommentRichText {
+    /** 富文本 doc 信息 */
+    doc?: string;
+    /** 富文本中包含的图片 URL 列表 */
+    doc_img?: string[];
+    /** 富文本 html 信息 */
+    doc_html?: string;
+    /** 富文本纯文本信息 */
+    doc_text?: string;
+    /** 标识富文本内容是否为空 */
+    is_empty?: boolean;
+}
+/**
+ * 评论信息
+ * 注意：id 字段为字符串类型，因为飞书项目 API 返回的评论 ID 超过 JavaScript 安全整数范围
+ */
+export interface Comment {
+    /** 评论 ID（字符串格式，避免大整数精度丢失） */
+    id: string;
+    /** 评论所属工作项 ID */
+    work_item_id: number;
+    /** 评论所属工作项类型 */
+    work_item_type_key: string;
+    /** 评论创建时间，毫秒精度 */
+    created_at: number;
+    /** 评论人 user_key */
+    operator: string;
+    /** 评论内容（纯文本） */
+    content?: string;
+    /** 富文本信息 */
+    doc_rich_text?: CommentRichText;
+}
+/**
+ * 富文本元素（用于创建/更新评论）
+ * 参考: 富文本格式
+ */
+export interface RichTextElement {
+    /** 元素类型: paragraph, text, image 等 */
+    type: string;
+    /** 文本内容（type=text 时使用） */
+    text?: string;
+    /** 元素属性 */
+    attrs?: Record<string, unknown>;
+    /** 子元素（type=paragraph 时使用） */
+    content?: RichTextElement[];
+}
+/**
+ * 创建评论请求
+ */
+export interface CreateCommentRequest {
+    /** 评论内容，仅支持原生文本（与 rich_text 二选一，都有值时 rich_text 优先） */
+    content?: string;
+    /** 评论内容，支持富文本格式（与 content 二选一，都有值时 rich_text 优先） */
+    rich_text?: RichTextElement[];
+}
+/**
+ * 更新评论请求
+ */
+export interface UpdateCommentRequest {
+    /** 评论内容，仅支持原生文本（与 rich_text 二选一，都有值时 rich_text 优先） */
+    content?: string;
+    /** 评论内容，支持富文本格式（与 content 二选一，都有值时 rich_text 优先） */
+    rich_text?: RichTextElement[];
+}
+/**
+ * 查询评论请求参数
+ */
+export interface ListCommentsQuery {
+    /** 每页返回的数据条数，最大支持 200 条 */
+    page_size?: number;
+    /** 分页页码，从 1 开始计数，默认值为 1 */
+    page_num?: number;
+}
+/**
+ * 拉机器人入群请求
+ * 接口: POST /open_api/:project_key/work_item/:work_item_id/bot_join_chat
+ */
+export interface BotJoinChatRequest {
+    /** 工作项类型 key（必填） */
+    work_item_type_key: string;
+    /** 飞书开放平台应用 App ID 列表（必填） */
+    app_ids: string[];
+}
+/**
+ * 拉机器人入群响应
+ */
+export interface BotJoinChatResponse {
+    /** 工作项关联群 ID */
+    chat_id: string;
+    /** 失败的机器人 App ID 列表 */
+    failed_members: string[];
+    /** 成功入群的机器人 App ID 列表 */
+    success_members: string[];
+}
+/**
+ * 时间范围
+ */
+export interface TimeRange {
+    /** 开始时间，毫秒精度 */
+    start?: number;
+    /** 结束时间，毫秒精度 */
+    end?: number;
+}
+/**
+ * 工作项状态筛选条件
+ */
+export interface WorkItemStatusFilter {
+    /** 状态 key */
+    state_key?: string;
+    /** 是否为完成状态（状态流使用） */
+    is_archived_state?: boolean;
+    /** 是否为初始状态（状态流使用） */
+    is_init_state?: boolean;
+}
+/**
+ * 筛选工作项请求（单空间）
+ * 接口: /open_api/:project_key/work_item/filter
+ */
+export interface FilterWorkItemsRequest {
+    work_item_type_keys: string[];
+    work_item_name?: string;
+    user_keys?: string[];
+    work_item_ids?: number[];
+    search_id?: string;
+    sub_stages?: string[];
+    created_at?: TimeRange;
+    updated_at?: TimeRange;
+    work_item_status?: WorkItemStatusFilter[];
+    businesses?: string[];
+    priorities?: string[];
+    tags?: string[];
+    page_size?: number;
+    page_num?: number;
+    expand?: QueryWorkItemExpand;
+}
+/**
+ * 用户搜索条件（跨空间）
+ */
+export interface SearchUser {
+    /** 角色 ID（查询该角色包含指定人员的工作项） */
+    role?: string;
+    /** 人员字段 key（仅支持：创建人、关注人、经办人、报告人） */
+    field_key?: string;
+    /** 用户 user_key 列表 */
+    user_keys?: string[];
+}
+/**
+ * 筛选工作项请求（跨空间）
+ * 接口: /open_api/work_items/filter_across_project
+ */
+export interface FilterWorkItemsAcrossProjectRequest {
+    work_item_type_key: string;
+    project_keys?: string[];
+    simple_names?: string[];
+    work_item_name?: string;
+    search_user?: SearchUser;
+    work_item_ids?: number[];
+    tenant_group_id?: number;
+    created_at?: TimeRange;
+    updated_at?: TimeRange;
+    work_item_status?: WorkItemStatusFilter[];
+    businesses?: string[];
+    priorities?: string[];
+    tags?: string[];
+    template_ids?: number[];
+    page_size?: number;
+    page_num?: number;
+    expand?: QueryWorkItemExpand;
+}
+/**
+ * 搜索参数操作符
+ */
+export type SearchOperator = '~' | '!~' | '=' | '!=' | '<' | '>' | '<=' | '>=' | 'HAS ANY OF' | 'HAS NONE OF' | 'IS NULL' | 'IS NOT NULL' | 'CONTAINS' | 'NOT CONTAINS' | 'MEET' | 'NOT MEET';
+/**
+ * 前置操作符
+ */
+export type PreOperator = 'ANY' | 'EVERY';
+/**
+ * 连接符
+ */
+export type SearchConjunction = 'AND' | 'OR';
+/**
+ * 搜索参数
+ */
+export interface SearchParam {
+    /** 字段 key */
+    param_key: string;
+    /** 搜索字段值（格式取决于 param_key 和 operator） */
+    value: unknown;
+    /** 操作符 */
+    operator: SearchOperator;
+    /** 前置操作符（复合字段使用） */
+    pre_operator?: PreOperator;
+    /** 复合字段子条件（当 param_key 为复合字段父字段且 operator 为 MEET/NOT MEET 时使用） */
+    value_search_groups?: SearchGroup;
+}
+/**
+ * 搜索组
+ */
+export interface SearchGroup {
+    /** 搜索参数列表（最多 50 个） */
+    search_params: SearchParam[];
+    /** 条件之间的逻辑关系 */
+    conjunction: SearchConjunction;
+    /** 嵌套的搜索组 */
+    search_groups?: SearchGroup[];
+}
+/**
+ * 复杂条件搜索请求（单空间）
+ * 接口: /open_api/:project_key/work_item/:work_item_type_key/search/params
+ */
+export interface SearchWorkItemsByParamsRequest {
+    search_group: SearchGroup;
+    page_size?: number;
+    page_num?: number;
+    fields?: string[];
+    expand?: QueryWorkItemExpand;
+}
+/**
+ * 关联类型
+ * 0: 关联字段 ID
+ * 1: 关联字段对接标识
+ */
+export type RelationType = 0 | 1;
+/**
+ * 搜索关联工作项请求
+ * 接口: /open_api/:project_key/work_item/:work_item_type_key/:work_item_id/search_by_relation
+ */
+export interface SearchByRelationRequest {
+    /** 关联的工作项类型（必填） */
+    relation_work_item_type_key: string;
+    /** 关联关系 ID（必填） */
+    relation_key: string;
+    /** 关联类型：0=关联字段ID，1=关联字段对接标识 */
+    relation_type?: RelationType;
+    /** 分页大小，最大 200 */
+    page_size?: number;
+    /** 页码，从 1 开始 */
+    page_num?: number;
+}
+/**
+ * 全局搜索查询类型
+ */
+export type QueryType = 'workitem' | 'view';
+/**
+ * 全局搜索请求
+ * 接口: /open_api/compositive_search
+ */
+export interface CompositiveSearchRequest {
+    /** 查询类型（必填）: workitem=工作项, view=视图 */
+    query_type: QueryType;
+    /** 查询内容（必填） */
+    query: string;
+    /** 空间 key 列表（限定搜索范围） */
+    project_keys?: string[];
+    /** 工作项类型列表（query_type=workitem 时生效） */
+    query_sub_type?: string[];
+    /** 分页大小，默认 50 */
+    page_size?: number;
+    /** 页码，默认 1 */
+    page_num?: number;
+}
+/**
+ * 全局搜索结果项
+ */
+export interface CompositiveSearchItem {
+    ID: string;
+    name: string;
+    WorkItemTypeKey?: string;
+    ViewScopeKey?: string;
+    ProjectKey?: string;
+    ProjectKeys?: string[];
+    CreatedBy?: string;
+    CreatedAt?: number;
+    SearchHit?: string[];
+}
+/**
+ * 批量更新模式
+ * - APPEND: 追加（仅适用于多选字段）
+ * - UPDATE: 修改（即将原先的值替换为新值）
+ * - REPLACE: 替换（某个值替换为新值，仅适用于多选字段）
+ */
+export type BatchUpdateMode = 'APPEND' | 'UPDATE' | 'REPLACE';
+/**
+ * 批量更新工作项字段请求
+ * 接口: /open_api/work_item/batch_update
+ */
+export interface BatchUpdateRequest {
+    project_key: string;
+    work_item_ids: number[];
+    work_item_type_key: string;
+    update_mode: BatchUpdateMode;
+    field_key: string;
+    before_field_value?: unknown;
+    after_field_value: unknown;
+}
+/**
+ * 批量更新响应
+ */
+export interface BatchUpdateResponse {
+    /** 任务 ID，用于查询处理进度 */
+    task_id: string;
+}
+/**
+ * 批量任务状态
+ */
+export type BatchTaskStatus = 'SUCCESS' | 'IDLE' | 'RUNNING' | 'FAILED' | 'CANCELED' | 'NOT_EXIST';
+/**
+ * 批量任务子任务结果
+ */
+export interface BatchSubTaskResult {
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 工作项类型 */
+    work_item_type_key: string;
+}
+/**
+ * 批量任务错误信息
+ */
+export interface BatchErrorScene {
+    /** 错误码 */
+    error_code: number;
+    /** 错误信息 */
+    error_msg: string;
+    /** 失败的工作项 ID 列表 */
+    failed_work_item_ids: number[];
+}
+/**
+ * 批量任务结果查询请求
+ */
+export interface BatchTaskResultQuery {
+    /** 任务 ID */
+    task_id: string;
+}
+/**
+ * 批量任务结果
+ */
+export interface BatchTaskResult {
+    /** 任务 ID */
+    task_id: string;
+    /** 任务状态 */
+    task_status: BatchTaskStatus;
+    /** 总数 */
+    total: number;
+    /** 成功数 */
+    success_total: number;
+    /** 失败数 */
+    error_total: number;
+    /** 成功的子任务列表 */
+    success_sub_task_list?: BatchSubTaskResult[];
+    /** 失败的子任务列表 */
+    fail_sub_task_list?: BatchSubTaskResult[];
+    /** 错误场景列表 */
+    error_scenes?: BatchErrorScene[];
+}
+/**
+ * 交付物批量查询请求
+ * 接口: /open_api/work_item/deliverable/batch_query
+ */
+export interface DeliverableBatchQueryRequest {
+    /** 空间 ID（必填） */
+    project_key: string;
+    /** 工作项 ID 列表（必填，最多 10 个） */
+    work_item_ids: number[];
+}
+/**
+ * 交付物详情
+ */
+export interface DeliveryRelatedInfoItem {
+    /** 空间 key */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 工作项类型 */
+    work_item_type_key: string;
+    /** 工作项名称 */
+    name: string;
+}
+export interface DeliveryRelatedInfo {
+    /** 根工作项 */
+    root_work_item?: DeliveryRelatedInfoItem;
+    /** 直接挂载工作项 */
+    source_work_item?: DeliveryRelatedInfoItem;
+}
+export interface DeliverableInfo {
+    /** 交付物工作项名称 */
+    name: string;
+    /** 交付物工作项 ID */
+    work_item_id: number;
+    /** 是否是交付物模板资源 */
+    template_resources: boolean;
+    /** 交付物类型 */
+    template_type: string;
+    /** 是否删除 */
+    deleted: boolean;
+    /** 交付物关联挂载工作项信息 */
+    delivery_related_info?: DeliveryRelatedInfo;
+    /** 交付物来源工作项 ID */
+    instance_linked_virtual_resource_workitem?: number;
+}
+/**
+ * 交付物信息
+ */
+export interface WorkItemDeliverable {
+    /** 交付物信息 */
+    deliverable_info: DeliverableInfo;
+    /** 交付物类型 */
+    deliverable_type: string;
+    /** 交付物唯一标识 */
+    deliverable_uuid: string;
+}
+/** 节点操作类型 */
+export type NodeAction = 'confirm' | 'rollback';
+/**
+ * 状态流转请求（状态流工作项）
+ * 接口: POST /open_api/:project_key/workflow/:work_item_type_key/:work_item_id/node/state_change
+ */
+export interface StateChangeRequest {
+    /** 流转到下一状态的 ID（必填） */
+    transition_id: number;
+    /** 要更新的字段数组（仅能更新状态表单中的字段） */
+    fields?: FieldValuePair[];
+    /** 角色及负责人 */
+    role_owners?: RoleOwner[];
+}
+/**
+ * 节点完成/回滚请求（节点流工作项）
+ * 接口: POST /open_api/:project_key/workflow/:work_item_type_key/:work_item_id/node/:node_id/operate
+ */
+export interface NodeOperateRequest {
+    /** 操作类型：confirm=完成节点，rollback=回滚节点 */
+    action: NodeAction;
+    /** 回滚原因（action=rollback 时必填） */
+    rollback_reason?: string;
+    /** 节点负责人的 user_key 数组 */
+    node_owners?: string[];
+    /** 节点排期（非差异化排期场景） */
+    node_schedule?: Schedule;
+    /** 子排期数组（差异化排期场景） */
+    schedules?: Schedule[];
+    /** 要更新的字段数组 */
+    fields?: FieldValuePair[];
+    /** 角色负责人（节点与角色绑定时使用） */
+    role_assignee?: RoleOwner[];
+}
+/**
+ * 更新节点请求（节点流工作项）
+ * 接口: PUT /open_api/:project_key/workflow/:work_item_type_key/:work_item_id/node/:node_id
+ */
+export interface UpdateNodeRequest {
+    /** 节点负责人的 user_key 数组（不传表示无需更新，空数组表示删除所有人） */
+    node_owners?: string[];
+    /** 节点排期（动态计算排期时使用） */
+    node_schedule?: Schedule;
+    /** 子排期数组（按人汇总排期时使用，节点负责人必须>=2人才生效） */
+    schedules?: Schedule[];
+    /** 要更新的字段数组 */
+    fields?: FieldValuePair[];
+    /** 角色负责人（节点与角色绑定时使用） */
+    role_assignee?: RoleOwner[];
+}
+/** 流转必填信息查询模式 */
+export type TransitionRequiredMode = 'unfinished';
+/**
+ * 获取流转必填信息请求
+ * 接口: POST /open_api/work_item/transition_required_info/get
+ */
+export interface TransitionRequiredInfoRequest {
+    /** 空间 ID 或域名（必填） */
+    project_key: string;
+    /** 工作项类型 */
+    work_item_type_key?: string;
+    /** 工作项 ID（必填） */
+    work_item_id: number;
+    /**
+     * 流转时的节点标识（必填）
+     * - 节点流：表示节点 ID（node_key/state_key）
+     * - 状态流：表示目标状态 key
+     */
+    state_key: string;
+    /** 查询模式：unfinished=仅查询未完成的必填项 */
+    mode?: TransitionRequiredMode;
+}
+/** 表单项类型 */
+export type FormItemClass = 'field' | 'role' | 'control';
+/**
+ * 必填子任务
+ */
+export interface RequiredTask {
+    /** 子任务 ID */
+    task_id: number;
+    /** 子任务是否已完成 */
+    finished: boolean;
+}
+/**
+ * 必填字段
+ */
+export interface RequiredField {
+    /** 字段 key */
+    field_key: string;
+    /** 字段类型 */
+    field_type_key?: string;
+    /** 是否已填写 */
+    finished: boolean;
+    /** 未完成人员 user_key */
+    not_finished_owner?: string[];
+    /** 复合字段类型的必填子字段 */
+    sub_field?: RequiredField[];
+}
+/**
+ * 节点信息控件的节点信息
+ */
+export interface RequiredStateInfo {
+    /** 节点 node_id */
+    state_key: string;
+    /** 节点信息控件的必填节点字段 */
+    node_fields?: RequiredField[];
+}
+/**
+ * 必填表单项
+ */
+export interface RequiredFormItem {
+    /** 表单项类型：field=字段，role=角色，control=控件 */
+    class: FormItemClass;
+    /**
+     * 表单项的 key
+     * - 字段类型：field_key
+     * - 角色类型：role_key
+     * - 控件类型：控件 ID（如节点信息控件为 "workflow_state_info"）
+     */
+    key: string;
+    /** 字段类型（字段类型表单项） */
+    field_type_key?: string;
+    /** 该表单项是否已填写 */
+    finished: boolean;
+    /** 未完成人员 user_key */
+    not_finished_owner?: string[];
+    /** 复合字段类型的必填子字段 */
+    sub_field?: RequiredField[];
+    /** 节点信息控件的节点信息 */
+    state_info?: RequiredStateInfo;
+}
+/**
+ * 必填交付物
+ */
+export interface RequiredDeliverable {
+    /** 交付物 ID */
+    deliverable_id: number;
+    /** 是否已完成 */
+    finished: boolean;
+}
+/**
+ * 流转必填信息
+ */
+export interface TransitionRequiredInfo {
+    /** 必填子任务 */
+    tasks?: RequiredTask[];
+    /** 必填表单项 */
+    form_items?: RequiredFormItem[];
+    /** 必填节点字段 */
+    node_fields?: RequiredField[];
+    /** 必填交付物 */
+    deliverables?: RequiredDeliverable[];
+}
+/**
+ * WBS 视图查询参数
+ */
+export interface WbsViewQueryParams {
+    /** 是否融合需要交付物（查询参数） */
+    need_union_deliverable?: boolean;
+    /** 是否需要计划表自定义列聚合字段 */
+    need_schedule_table_agg?: boolean;
+}
+/**
+ * WBS 视图扩展查询参数
+ */
+export interface WbsViewExpand {
+    /** 是否需要融合交付物信息 */
+    need_union_deliverable?: boolean;
+    /** 是否需要 WBS 链路层级信息 */
+    need_wbs_relation_chain_path?: boolean;
+    /** 是否需要 WBS 链路实例信息 */
+    need_wbs_relation_chain_entity?: boolean;
+}
+/**
+ * WBS 视图请求体
+ */
+export interface WbsViewRequest {
+    expand?: WbsViewExpand;
+}
+/**
+ * WBS 工作流节点
+ */
+export interface WbsWorkflowNode {
+    /** 节点 ID */
+    state_key: string;
+    /** 节点名称 */
+    name: string;
+    /** 节点状态 */
+    status?: number;
+    /** 节点负责人 */
+    owners?: string[];
+    /** 子任务列表 */
+    sub_tasks?: Array<{
+        task_id: number;
+        name: string;
+        status: number;
+        assignee?: string[];
+    }>;
+    /** 交付物信息 */
+    deliverables?: Array<{
+        deliverable_id: number;
+        name: string;
+        finished: boolean;
+    }>;
+}
+/**
+ * WBS 工作项视图（行业专版）
+ * 接口: GET /open_api/:project_key/work_item/:work_item_type_key/:work_item_id/wbs_view
+ */
+export interface WbsWorkItem {
+    /** 工作项 ID */
+    id: number;
+    /** 工作项名称 */
+    name: string;
+    /** 工作项类型 key */
+    work_item_type_key: string;
+    /** 空间 key */
+    project_key: string;
+    /** WBS 工作流节点列表 */
+    workflow_nodes?: WbsWorkflowNode[];
+    /** WBS 链路层级信息 */
+    wbs_relation_chain_path?: string[];
+    /** WBS 链路实例信息 */
+    wbs_relation_chain_entity?: Array<{
+        work_item_id: number;
+        work_item_type_key: string;
+        project_key: string;
+    }>;
+}
+/**
+ * 工时关联对象类型
+ */
+export type WorkHourResourceType = 'node' | 'sub_task';
+/**
+ * 创建工时记录条目
+ */
+export interface CreateWorkingHourRecord {
+    /** 关联对象类型 */
+    resource_type: WorkHourResourceType;
+    /** 关联对象 ID */
+    resource_id: string;
+    /** 实际工时（单位：天） */
+    work_time: number | string;
+    /** 工作描述 */
+    work_description?: string;
+}
+/**
+ * 创建工时登记记录请求
+ */
+export interface CreateWorkHourRecordRequest {
+    /** 工作开始日期（毫秒时间戳） */
+    work_begin_date: number;
+    /** 工作结束日期（毫秒时间戳） */
+    work_end_date: number;
+    /** 是否包含节假日 */
+    include_holidays: boolean;
+    /** 待创建工时记录列表 */
+    working_hour_records: CreateWorkingHourRecord[];
+}
+/**
+ * 更新工时记录条目
+ */
+export interface UpdateWorkingHourRecord {
+    /** 工时记录 ID */
+    id: number;
+    /** 实际工时 */
+    work_time?: number | string;
+    /** 工作描述 */
+    work_description?: string;
+}
+/**
+ * 更新工时登记记录请求
+ */
+export interface UpdateWorkHourRecordRequest {
+    /** 待更新记录列表 */
+    working_hour_records: UpdateWorkingHourRecord[];
+}
+/**
+ * 删除工时登记记录请求
+ */
+export interface DeleteWorkHourRecordRequest {
+    /** 工时记录 ID 列表 */
+    working_hour_record_ids: number[];
+}
+/**
+ * 查询工时登记记录请求
+ */
+export interface ListWorkHourRecordsRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项类型 key */
+    work_item_type_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 页码 */
+    page_num?: number;
+    /** 分页大小 */
+    page_size?: number;
+}
+/**
+ * 工时登记记录
+ */
+export interface WorkHourRecord {
+    /** 工时记录 ID */
+    id: number;
+    /** 工作日期（毫秒时间戳） */
+    work_date?: number;
+    /** 实际工时 */
+    work_time?: number;
+    /** 创建时间 */
+    created_at?: number;
+    /** 更新时间 */
+    updated_at?: number;
+    /** 关联对象 ID */
+    resource_id?: string;
+    /** 关联对象名称 */
+    resource_name?: string;
+    /** 关联对象类型 */
+    resource_type?: WorkHourResourceType;
+    /** 工时归属人 user_key */
+    work_user_key?: string;
+    /** 工作描述 */
+    work_description?: string;
+    /** 关联工作项 ID */
+    related_work_item_id?: number;
+    /** 关联工作项名称 */
+    related_work_item_name?: string;
+    /** 关联工作项类型 */
+    related_work_item_type_key?: string;
+}
+/**
+ * 评审结论标签
+ */
+export interface ReviewConclusionOptionItem {
+    /** 标签 key */
+    key: string;
+    /** 标签名称 */
+    label: string;
+    /** 原始标签名称 */
+    origin_label?: string;
+}
+/**
+ * 评审意见（个人）
+ */
+export interface ReviewOwnerOpinionInfo {
+    /** 用户 user_key */
+    owner: string;
+    /** 评审意见 */
+    finished_opinion_result: string;
+}
+/**
+ * 评审意见（汇总）
+ */
+export interface ReviewOpinionInfo {
+    /** 汇总意见 */
+    finished_opinion_result?: string;
+    /** 人员意见 */
+    owners_finished_opinion_result?: ReviewOwnerOpinionInfo[];
+}
+/**
+ * 评审结论（个人）
+ */
+export interface ReviewOwnerConclusionInfo {
+    /** 用户 user_key */
+    owner: string;
+    /** 结论 */
+    finished_conclusion_result: ReviewConclusionOptionItem;
+}
+/**
+ * 评审结论（汇总）
+ */
+export interface ReviewConclusionInfo {
+    /** 汇总结论 */
+    finished_conclusion_result?: ReviewConclusionOptionItem;
+    /** 人员结论 */
+    owners_finished_conclusion_result?: ReviewOwnerConclusionInfo[];
+}
+/**
+ * 评审信息条目
+ */
+export interface ReviewFinishedInfoItem {
+    /** 节点 ID */
+    node_id: string;
+    /** 评审意见 */
+    opinion?: ReviewOpinionInfo;
+    /** 评审结论 */
+    conclusion?: ReviewConclusionInfo;
+    /** 汇总模式 */
+    summary_mode?: string;
+}
+/**
+ * 批量查询评审信息请求
+ * 接口: /open_api/work_item/finished/batch_query
+ */
+export interface ReviewBatchQueryRequest {
+    /** 空间 ID（必填） */
+    project_key: string;
+    /** 工作项 ID（必填） */
+    work_item_id: number;
+    /** 节点 ID 列表（必填，最多 10 个） */
+    node_ids: string[];
+}
+/**
+ * 批量查询评审信息响应
+ */
+export interface ReviewBatchQueryResponse {
+    project_key: string;
+    work_item_id: number;
+    finished_infos: ReviewFinishedInfoItem[];
+}
+/**
+ * 评审结论标签查询请求
+ */
+export interface ReviewConclusionOptionRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 节点 ID 列表 */
+    node_ids: string[];
+}
+/**
+ * 评审结论标签查询响应条目
+ */
+export interface ReviewConclusionOption {
+    /** 节点 ID */
+    node_id: string;
+    /** 统一评审结论标签（计划废弃） */
+    finished_conclusion_option?: ReviewConclusionOptionItem[];
+    /** 负责人评审结论标签 */
+    finished_owners_conclusion_option?: ReviewConclusionOptionItem[];
+    /** 整体评审结论标签 */
+    finished_overall_conclusion_option?: ReviewConclusionOptionItem[];
+}
+/**
+ * 修改评审意见/结论请求
+ */
+export interface UpdateReviewRequest {
+    /** 空间 ID */
+    project_key: string;
+    /** 工作项 ID */
+    work_item_id: number;
+    /** 节点 ID */
+    node_id: string;
+    /** 评审意见 */
+    opinion?: string;
+    /** 评审结论标签 key */
+    finished_conclusion_option_key?: string;
+    /** 操作类型 */
+    operation_type?: string;
+    /** 是否置空 */
+    reset?: boolean;
+}
+//# sourceMappingURL=workitem.d.ts.map