meeglesdk 0.1.8 → 0.2.0

package/dist/types/common.d.ts

@@ -104,6 +104,10 @@ export interface PagedWorkItemIds {
     page_size: number;
     total: number;
 }
+/**
+ * 字段更新模式
+ */
+export type FieldUpdateMode = 0 | 1;
 /**
  * 字段值对
  * 参考: FieldValuePair
@@ -120,7 +124,7 @@ export interface FieldValuePair {
     /** 指代流转至该目标状态需要填写对应字段，状态流使用 */
     target_state?: TargetState;
     /** 字段更新模式（0: 全局替换, 1: 增量更新） */
-    update_mode?: number;
+    update_mode?: FieldUpdateMode;
     /** 字段描述 */
     help_description?: string;
 }
@@ -294,6 +298,8 @@ export interface ExpandParams {
     relation_fields_detail?: boolean;
     /** 是否需要返回用户信息 */
     need_user_detail?: boolean;
+    /** 是否需要子任务父级信息 */
+    need_sub_task_parent?: boolean;
     /** 是否融合需要交付物 */
     need_union_deliverable?: boolean;
     /** 是否需要返回WBS链路实例 */

package/dist/types/config.d.ts

@@ -4,6 +4,8 @@
  */
 import type { FieldValue, FieldValuePair, FieldConf, SimpleField, MultiText, UserDetail, Connection } from './common.js';
 import type { RelationFieldDetail, SearchGroup } from './workitem.js';
+export type ResourceId = number | string;
+export type ResourceUserDetail = Partial<UserDetail>;
 export type FlowMode = 'stateflow' | 'workflow';
 export interface RoleInfo {
     id: string;
@@ -56,10 +58,22 @@ export interface TeamOption {
     team_data_scopes?: TeamDataScope[];
     team_mode?: 'all' | 'custom';
 }
+export interface NumberSymbolSetting {
+    display?: string;
+    value?: string;
+    layout?: string;
+}
+export interface NumberConfig {
+    scaling_ratio?: string;
+    display_digits?: number;
+    symbol_setting?: NumberSymbolSetting;
+    thousandth?: boolean;
+}
 export interface CreateCustomFieldRequest {
     field_name: string;
     field_alias?: string;
     field_type_key: string;
+    parent_field_key?: string;
     value_type?: number;
     field_value?: FieldValue[];
     reference_work_item_type_key?: string;
@@ -72,6 +86,7 @@ export interface CreateCustomFieldRequest {
     help_description?: string;
     authorized_roles?: string[];
     team_option?: TeamOption;
+    number_config?: NumberConfig;
 }
 export interface UpdateCustomFieldRequest {
     field_key: string;
@@ -84,6 +99,7 @@ export interface UpdateCustomFieldRequest {
     help_description?: string;
     authorized_roles?: string[];
     team_option?: TeamOption;
+    number_config?: NumberConfig;
 }
 export interface RelationDetail {
     project_key: string;
@@ -118,6 +134,8 @@ export interface DeleteWorkItemRelationRequest {
 }
 export type RoleAppearMode = 1 | 2 | 3;
 export type MemberAssignMode = 1 | 2 | 3 | 4;
+export type FlowRoleWritableMemberAssignMode = 1 | 2 | 3;
+export type RoleLockScope = 'all' | 'basic' | 'role' | 'member' | 'auth';
 export interface FlowRoleInfo {
     id: string;
     name: string;
@@ -131,22 +149,23 @@ export interface FlowRoleInfo {
 }
 export interface FlowRoleRequest {
     id?: string;
-    name?: string;
+    name: string;
     role_alias?: string;
-    member_assign_mode?: MemberAssignMode;
+    member_assign_mode?: FlowRoleWritableMemberAssignMode;
     members?: string[];
     is_member_multi?: boolean;
     is_owner?: boolean;
     auto_enter_group?: boolean;
-    lock_scope?: string[];
+    lock_scope?: RoleLockScope[];
 }
+export type FlowRoleUpdateRequest = Partial<Omit<FlowRoleRequest, 'id'>>;
 export interface CreateFlowRoleRequest {
     role: FlowRoleRequest;
 }
 export interface UpdateFlowRoleRequest {
     role_id?: string;
     role_alias?: string;
-    role: Partial<FlowRoleRequest>;
+    role: FlowRoleUpdateRequest;
 }
 export interface DeleteFlowRoleRequest {
     role_id?: string;
@@ -160,42 +179,69 @@ export interface TemplateConf {
     template_id: number;
     template_key: string;
 }
+export type TemplateAction = 1 | 2 | 3;
+export type TemplateDisabled = 1 | 2;
+export type WorkflowOwnerUsageMode = 1 | 2 | 3 | 4;
+export type WorkflowVisibilityUsageMode = 1 | 2;
+export type WorkflowPassMode = 1 | 2 | 3;
+export type WorkflowTaskPassMode = 1 | 2;
+export type WorkflowTaskRequiredMode = 1 | 2;
+export type StateFlowStateType = 1 | 2 | 3;
 export interface TaskConf {
-    action?: number;
+    action?: TemplateAction;
     name?: string;
     id?: string;
     deliverable_field_id?: string;
-    pass_mode?: number;
-    node_pass_required_mode?: number;
+    pass_mode?: WorkflowTaskPassMode;
+    node_pass_required_mode?: WorkflowTaskRequiredMode;
+}
+export interface WorkflowSubWorkItem {
+    name?: string;
+    relation_uuid?: string;
+    relation_name?: string;
+    work_item_type_key?: string;
+    work_item_type_name?: string;
+}
+export interface WorkflowSubTask {
+    id?: string;
+    name?: string;
+    owner_usage_mode?: WorkflowOwnerUsageMode;
+    owner_roles?: string[];
+    owners?: string[];
 }
 export interface WorkflowConf {
-    action?: number;
+    action?: TemplateAction;
     state_key: string;
     name?: string;
     tags?: string[];
     pre_node_state_key?: string[];
-    owner_usage_mode?: number;
+    owner_usage_mode?: WorkflowOwnerUsageMode;
     owner_roles?: string[];
     owners?: string[];
     need_schedule?: boolean;
     different_schedule?: boolean;
-    visibility_usage_mode?: number;
+    visibility_usage_mode?: WorkflowVisibilityUsageMode;
     completion_tips?: string;
     deletable?: boolean;
     deletable_operation_role?: string[];
-    pass_mode?: number;
+    pass_mode?: WorkflowPassMode;
     is_limit_node?: boolean;
+    is_milestone?: boolean;
     done_operation_role?: string[];
     done_schedule?: boolean;
     done_allocate_owner?: boolean;
+    done_actual_point?: boolean;
+    done_finish_time?: boolean;
+    sub_work_items?: WorkflowSubWorkItem[];
+    sub_tasks?: WorkflowSubTask[];
     task_confs?: TaskConf[];
     fields?: FieldConf[];
 }
 export interface StateFlowConf {
-    action?: number;
+    action?: TemplateAction;
     state_key: string;
     name?: string;
-    state_type?: number;
+    state_type?: StateFlowStateType;
     authorized_roles?: string[];
 }
 export interface TemplateDetail {
@@ -204,8 +250,9 @@ export interface TemplateDetail {
     connections?: Connection[];
     template_id?: number;
     template_name?: string;
+    work_item_type_key?: string;
     version?: number;
-    is_disabled?: number;
+    is_disabled?: TemplateDisabled;
 }
 export interface TemplateCreateRequest {
     project_key: string;
@@ -223,7 +270,7 @@ export interface TemplateUpdateRequest {
 export type TemplateOperateRequest = TemplateCreateRequest | TemplateUpdateRequest;
 export interface ResourceQueryRequest {
     project_key: string;
-    work_item_ids: number[];
+    work_item_ids: ResourceId[];
     fields?: string[];
     work_item_type_key: string;
     expand?: {
@@ -231,21 +278,37 @@ export interface ResourceQueryRequest {
         relation_fields_detail?: boolean;
     };
 }
+export interface ResourceTemplateInfo {
+    id?: ResourceId;
+    work_flow_key?: string;
+    state_flow_key?: string;
+}
+export interface ResourceRoleOwner {
+    role: string;
+    role_key?: string;
+    owners?: ResourceUserDetail[];
+}
 export interface ResourceWorkItemDetail {
-    id: number;
+    id?: ResourceId;
+    work_item_id?: ResourceId;
     name: string;
+    owner?: ResourceUserDetail;
     work_item_type_key?: string;
     project_key?: string;
     template_type?: string;
-    created_by?: string | UserDetail;
-    updated_by?: string | UserDetail;
+    created_by?: string | ResourceUserDetail;
+    updated_by?: string | ResourceUserDetail;
     created_at?: number;
     updated_at?: number;
+    role_owners?: ResourceRoleOwner[];
     fields?: FieldValuePair[];
     simple_name?: string;
-    template_id?: number;
+    template_id?: ResourceId;
+    template?: ResourceTemplateInfo;
+    template_version?: ResourceId;
     multi_texts?: MultiText[];
     relation_fields_detail?: RelationFieldDetail[];
+    user_details?: ResourceUserDetail[];
 }
 export interface ResourceQueryResponse {
     data: ResourceWorkItemDetail[];
@@ -257,12 +320,12 @@ export interface ResourceCreateRequest {
     field_value_pairs?: FieldValuePair[];
 }
 export interface ResourceCreateResponse {
-    work_item_id: number;
+    work_item_id: ResourceId;
 }
 export interface ResourceUpdateRequest {
     project_key: string;
     work_item_type_key: string;
-    work_item_id: number;
+    work_item_id: ResourceId;
     update_fields: FieldValuePair[];
 }
 export interface ResourceCreateInstanceRequest {
@@ -272,7 +335,7 @@ export interface ResourceCreateInstanceRequest {
     template_id?: number;
 }
 export interface ResourceCreateInstanceResponseData {
-    work_item_id: number;
+    work_item_id: ResourceId;
     ignore_create_info?: {
         field_keys?: string[];
         role_ids?: string[];

package/dist/types/event.d.ts

@@ -2,8 +2,9 @@
  * 事件相关类型定义
  * 包含监听事件、拦截事件、插件装卸事件的类型
  */
+import type { AINodeAppIdentity, AINodeField, AINodeInfo, AINodeNodeState, AINodeStatus, AINodeSubTask, AINodeSubWorkItem } from './ainode.js';
 /** 事件来源类型 */
-export type EventSource = 'normal' | 'openapi' | 'open_api' | 'system' | 'automation';
+export type EventSource = 'normal' | 'openapi' | 'system' | 'automation';
 /** 工作项事件类型 (100x) */
 export type WorkItemEventType = 1001 | 1002 | 1003 | 1004 | 1005 | 1006 | 1007 | 1008 | 1009 | 1010 | 1011 | 1012;
 /** 节点事件类型 (200x) */
@@ -16,8 +17,12 @@ export type SubtaskEventType = 4001 | 4002 | 4003 | 4004 | 4005 | 4006 | 4007 |
 export type SpaceEventType = 5001 | 5002;
 /** 插件事件类型 (600x) */
 export type PluginEventType = 6001 | 6002 | 6003 | 6004;
+/** AI 节点事件类型 (800x) */
+export type AINodeEventType = 8001 | 8002 | 8003 | 8004 | 8005 | 8006;
+/** AI 字段事件类型 (810x) */
+export type AIFieldEventType = 8101 | 8102;
 /** 所有事件类型 */
-export type EventType = WorkItemEventType | NodeEventType | StatusEventType | SubtaskEventType | SpaceEventType | PluginEventType;
+export type EventType = WorkItemEventType | NodeEventType | StatusEventType | SubtaskEventType | SpaceEventType | PluginEventType | AINodeEventType | AIFieldEventType;
 /** 事件用户信息 */
 export interface EventUserInfo {
     /** 用户唯一 Key */
@@ -34,7 +39,7 @@ export interface EventWorkItemInfo {
     /** 工作项 ID */
     work_item_id: number;
     /** 工作项名称 */
-    work_item_name: string;
+    work_item_name?: string;
     /** 工作项类型 Key */
     work_item_type_key: string;
 }
@@ -231,10 +236,156 @@ export type PluginEventData = PluginInstallEventData | PluginUninstallEventData
 export interface PluginListenEvent extends ListenEventBase {
     data: PluginEventData;
 }
+/** AI 节点实体状态 */
+export interface AINodeEntityInfo {
+    /** AI 实体唯一 ID */
+    entity_id: string;
+    /** AI 应用标识 */
+    app_identity: AINodeAppIdentity;
+    /** AI 运行状态 */
+    status: AINodeStatus;
+}
+/** AI 节点状态变更信息 */
+export interface AINodeChangeInfo {
+    /** 变更前状态 */
+    before: AINodeEntityInfo | null;
+    /** 变更后状态 */
+    after: AINodeEntityInfo | null;
+}
+/** AI 节点事件中的节点信息 */
+export interface AINodeEventNodeInfo {
+    /** 节点 key */
+    state_key: string;
+    /** 节点状态 */
+    node_state: AINodeNodeState;
+    /** AI 信息 */
+    ai_info: AINodeInfo;
+    /** 节点字段 */
+    node_fields?: AINodeField[] | null;
+    /** 节点表单字段 */
+    conform_fields?: AINodeField[] | null;
+    /** 子任务 */
+    sub_tasks?: AINodeSubTask[] | null;
+    /** 子项 */
+    sub_work_items?: AINodeSubWorkItem[] | null;
+}
+/** AI 节点操作信息 */
+export interface AINodeOperationInfo {
+    /** 更新的节点 key */
+    update_nodes?: string[] | null;
+    /** 删除的节点 key */
+    del_nodes?: string[] | null;
+    /** 恢复的节点 key */
+    recover_nodes?: string[] | null;
+    /** 操作原因 */
+    reason?: string;
+    /** 当前负责人 */
+    owner_in_charge?: unknown;
+    /** 排期信息 */
+    schedule_info?: unknown;
+}
+/** AI 节点事件数据 */
+export interface AINodeEventData extends ListenEventDataBase {
+    event_type: AINodeEventType;
+    /** 工作流类型：0=节点流，1=状态流 */
+    flow_type: 0 | 1;
+    /** 工作项类型 Key */
+    work_item_type_key: string;
+    /** 关联工作项类型 Key */
+    link_work_item_type_key?: string;
+    /** 用户信息 */
+    user_info: EventUserInfo;
+    /** 工作项信息 */
+    work_item_info: EventWorkItemInfo[];
+    /** AI 节点变更信息 */
+    change_ai_node_info?: AINodeChangeInfo;
+    /** AI 节点信息 */
+    ai_node_info?: AINodeEventNodeInfo;
+    /** 节点操作信息 */
+    node_info?: AINodeOperationInfo;
+}
+/** AI 节点监听事件 */
+export interface AINodeListenEvent extends ListenEventBase {
+    data: AINodeEventData;
+}
+/** AI 字段自定义属性类型 */
+export type AIFieldCustomPropertyType = 'custom_input_select' | 'custom_input_multi_select' | 'custom_input_text' | 'custom_input_number';
+/** AI 字段自定义属性 */
+export interface AIFieldCustomProperty {
+    /** 属性 key */
+    key: string;
+    /** 属性值 */
+    value: string;
+    /** 属性类型 */
+    type: AIFieldCustomPropertyType | string;
+}
+/** AI 字段引用字段值 */
+export interface AIFieldReferenceValue {
+    /** 字段值 */
+    field_value: unknown;
+    /** 字段 key */
+    field_key: string;
+    /** 字段类型 */
+    field_type: string;
+    /** 字段名称 */
+    field_name: string;
+    /** 是否内置字段 */
+    internal: boolean;
+    /** 更新时间 */
+    updated_at: number;
+}
+/** AI 字段引用字段变更 */
+export interface AIFieldReferenceChange {
+    /** 变更前值 */
+    before: AIFieldReferenceValue | null;
+    /** 变更后值 */
+    after: AIFieldReferenceValue | null;
+}
+/** AI 字段实体信息 */
+export interface AIFieldEntity {
+    /** 字段名称 */
+    field_name: string;
+    /** 字段 key */
+    field_key: string;
+    /** 字段值 */
+    field_value: unknown;
+    /** 字段类型 */
+    field_type: string;
+    /** 是否内置字段 */
+    internal: boolean;
+    /** 更新时间 */
+    updated_at: number;
+    /** 引用字段变更信息 */
+    reference_changed?: Record<string, AIFieldReferenceChange>;
+    /** AI 计算任务 ID */
+    task_id: string;
+    /** 自定义属性列表 */
+    custom_property?: AIFieldCustomProperty[];
+}
+/** AI 字段事件数据 */
+export interface AIFieldEventData extends ListenEventDataBase {
+    event_type: AIFieldEventType;
+    /** 工作流类型：0=节点流，1=状态流 */
+    flow_type: 0 | 1;
+    /** 工作项类型 Key */
+    work_item_type_key: string;
+    /** 关联工作项类型 Key */
+    link_work_item_type_key?: string;
+    /** 用户信息 */
+    user_info: EventUserInfo;
+    /** 工作项信息 */
+    work_item_info: EventWorkItemInfo[];
+    /** AI 字段实体 */
+    field_ai_entity: AIFieldEntity;
+}
+/** AI 字段监听事件 */
+export interface AIFieldListenEvent extends ListenEventBase {
+    data: AIFieldEventData;
+}
 /** 所有监听事件数据联合类型 */
-export type ListenEventData = WorkItemEventData | NodeEventData | StatusEventData | SubtaskEventData | SpaceMemberEventData | PluginEventData;
+export type ListenEventData = WorkItemEventData | NodeEventData | StatusEventData | SubtaskEventData | SpaceMemberEventData | PluginEventData | AINodeEventData | AIFieldEventData;
 /** 所有监听事件联合类型 */
-export type ListenEvent = WorkItemListenEvent | NodeListenEvent | StatusListenEvent | SubtaskListenEvent | SpaceListenEvent | PluginListenEvent;
+export type ListenEvent = WorkItemListenEvent | NodeListenEvent | StatusListenEvent | SubtaskListenEvent | SpaceListenEvent | PluginListenEvent | AINodeListenEvent | AIFieldListenEvent;
 /** 拦截事件基础请求体 */
 export interface InterceptEventBase {
     /** 日志 ID */
@@ -298,27 +449,39 @@ export interface InterceptResponse {
 /** 节点拦截配置 */
 export interface NodeInterceptConfig {
     /** 节点模板 ID */
-    template_id: string;
+    template_id?: string;
+    /** 模板版本，不传时按服务端最新版本处理 */
+    version?: number;
     /** 要拦截的节点 ID 列表 */
     node_ids?: string[];
 }
 /** 状态拦截配置 */
 export interface StateInterceptConfig {
+    /** 工作项类型 */
+    work_item_type?: string;
     /** 状态模板 ID */
     template_id?: string;
     /** 兼容旧字段拼写 */
     tempate_id?: string;
+    /** 模板版本，不传时按服务端最新版本处理 */
+    version?: number;
     /** 要拦截的状态流转 ID 列表 */
     transition_ids?: string[];
+    /** 查询示例中的状态 ID 列表别名 */
+    state_ids?: string[];
 }
 /** 工作项拦截配置 */
 export interface WorkItemInterceptConfig {
     /** 工作项类型 */
-    work_item_type: string;
+    work_item_type?: string;
+    /** 查询示例中的工作项类型字段别名 */
+    workitem_type?: string;
     /** 要拦截的字段范围（仅 1009、1010 事件适用） */
     fields?: string[];
     /** 要拦截的流程模板列表（仅 1006、1007 事件适用） */
     template_ids?: string[];
+    /** 查询示例中的流程模板列表别名 */
+    templates?: string[];
     /** 节点拦截配置（节点系列 2001-2007、子任务系列 4001-4008 适用） */
     node_intercept_config?: NodeInterceptConfig[];
     /** 状态拦截配置（3001 适用） */
@@ -329,11 +492,15 @@ export interface ProjectInterceptConfig {
     /** 拦截配置 ID（查询时返回） */
     project_intercept_config_id?: string;
     /** 事件类型列表 */
-    events: number[];
+    events?: number[];
     /** 工作项类型列表 */
-    work_item_type: string[];
+    work_item_type?: string[];
+    /** 查询示例中的工作项类型列表别名 */
+    workitem_type?: string[];
     /** 精细化拦截配置 */
     work_item_intercept_config?: WorkItemInterceptConfig[];
+    /** 查询示例中的精细化拦截配置别名 */
+    workitem_intercept_config?: WorkItemInterceptConfig[];
 }
 /** 创建拦截配置请求 */
 export interface CreateInterceptConfigRequest {

package/dist/types/index.d.ts

@@ -11,3 +11,5 @@ export * from './view.js';
 export * from './measure.js';
 export * from './tenant.js';
 export * from './ainode.js';
+export * from './event.js';
+export * from './aifield.js';

package/dist/types/index.js

@@ -11,3 +11,5 @@ export * from './view.js';
 export * from './measure.js';
 export * from './tenant.js';
 export * from './ainode.js';
+export * from './event.js';
+export * from './aifield.js';

package/dist/types/measure.d.ts

@@ -33,6 +33,13 @@ export interface MeasureChartsByViewRequest {
     page_num?: number;
     page_size?: number;
 }
+/**
+ * 便捷查询视图图表分页参数
+ */
+export interface MeasureChartsByViewPageOptions {
+    pageNum?: number;
+    pageSize?: number;
+}
 /**
  * 图表摘要信息
  */

package/dist/types/tenant.d.ts

@@ -37,38 +37,51 @@ export interface TenantRichText {
 export interface TenantProductPrice {
     product_key?: string;
     price_key?: string;
+    version?: number;
+    name?: string;
+    name_i18n?: Record<string, string>;
+    external_platform?: string;
     external_price_key?: string;
     payment_mode?: string;
     period_unit?: string;
     trial_period?: number;
     trial_product_price?: string;
     publish_status?: string;
-    name?: string;
-    name_i18n?: Record<string, string>;
+    purchasable_tenants?: string[];
+    currency_code?: string;
     price?: number;
-    version?: number;
     extra?: Record<string, unknown>;
 }
 /**
  * 商品信息
  */
 export interface TenantProductInfo {
+    product_key?: string;
     product_type?: string;
     product_version?: number;
-    product_key?: string;
+    external_product_key?: string;
     icon_url?: string;
+    icon_url_i18n?: Record<string, string>;
     cover_url?: string;
+    cover_url_i18n?: Record<string, string>;
     name?: string;
+    name_i18n?: Record<string, string>;
     short_desc?: string;
+    short_desc_i18n?: Record<string, string>;
     long_desc?: TenantRichText;
+    long_desc_i18n?: Record<string, TenantRichText>;
     external_platform?: string;
+    publish_status?: string;
+    app_key?: string;
     approval_status?: string;
     product_prices?: TenantProductPrice[];
     product_price_display?: TenantRichText;
     product_price_display_i18n?: Record<string, TenantRichText>;
     sales_tenant?: {
+        display_id?: string;
         tenant_key?: string;
         tenant_name?: string;
+        tenant_key_lark?: string;
     };
     extra?: Record<string, unknown>;
 }

package/dist/types/user.d.ts

@@ -49,6 +49,10 @@ export interface SearchUsersRequest {
  * 用户组类型
  */
 export type UserGroupType = 'PROJECT_ADMIN' | 'PROJECT_MEMBER' | 'CUSTOMIZE';
+/**
+ * 可更新成员的用户组类型
+ */
+export type MutableUserGroupType = 'PROJECT_MEMBER' | 'CUSTOMIZE';
 /**
  * 创建自定义用户组请求
  * 接口: POST /open_api/:project_key/user_group
@@ -71,7 +75,7 @@ export interface CreateUserGroupResponse {
  * 接口: PATCH /open_api/:project_key/user_group/members
  */
 export interface UpdateUserGroupMembersRequest {
-    user_group_type: UserGroupType;
+    user_group_type: MutableUserGroupType;
     user_group_id?: string;
     add_users?: string[];
     delete_users?: string[];

package/dist/types/view.d.ts

@@ -61,6 +61,12 @@ export interface ViewConfListRequest {
     page_num?: number;
     is_query_quick_filter?: boolean;
 }
+/**
+ * 按标题模糊查询视图请求
+ */
+export interface SearchViewByTitleRequest extends Omit<ViewConfListRequest, 'view_name'> {
+    title: string;
+}
 /**
  * 视图配置条目
  */