meeglesdk 0.1.8 → 0.2.0

package/dist/service/workitem/wbsView.d.ts

@@ -0,0 +1,48 @@
+/**
+ * WBS 发布态服务
+ *
+ * 计划表发布态接口和草稿态是两套能力边界，
+ * 单独拆出服务可以避免 draft/view 两类接口再次混用。
+ */
+import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
+import type { QueryWbsViewStructureRequest, QueryWbsViewStructureResponse, QueryWbsViewRowDetailRequest, QueryWbsViewRowDetailResponse, QueryWbsInstanceExpandInfoRequest, QueryWbsInstanceExpandInfoResponse } from '../../types/workitem.js';
+/** API 路径 */
+export declare const API_PATHS: {
+    /** 查询全量计划表骨架 */
+    STRUCTURE: string;
+    /** 查询计划表行详情 */
+    DETAIL: string;
+    /** 查询计划表扩展信息 */
+    EXPAND: string;
+};
+/**
+ * WBS 发布态服务
+ */
+export declare class WbsViewService extends BaseService {
+    private readonly projectKeyResolver;
+    constructor(requestHandler: ConstructorParameters<typeof BaseService>[0]);
+    /**
+     * 查询全量计划表骨架
+     *
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 发布态计划表骨架
+     */
+    queryStructure(request: QueryWbsViewStructureRequest, options?: ServiceRequestOptions<QueryWbsViewStructureResponse>): Promise<QueryWbsViewStructureResponse>;
+    /**
+     * 查询计划表行详细信息
+     *
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 发布态计划表行详情
+     */
+    queryRowDetails(request: QueryWbsViewRowDetailRequest, options?: ServiceRequestOptions<QueryWbsViewRowDetailResponse>): Promise<QueryWbsViewRowDetailResponse>;
+    /**
+     * 查询计划表扩展信息
+     *
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 发布态计划表扩展信息
+     */
+    queryExpandInfo(request: QueryWbsInstanceExpandInfoRequest, options?: ServiceRequestOptions<QueryWbsInstanceExpandInfoResponse>): Promise<QueryWbsInstanceExpandInfoResponse>;
+}

package/dist/service/workitem/wbsView.js

@@ -0,0 +1,86 @@
+/**
+ * WBS 发布态服务
+ *
+ * 计划表发布态接口和草稿态是两套能力边界，
+ * 单独拆出服务可以避免 draft/view 两类接口再次混用。
+ */
+import { BaseService } from '../../core/base-service.js';
+import { WbsProjectKeyResolver } from './wbsProjectKeyResolver.js';
+/** API 路径 */
+export const API_PATHS = {
+    /** 查询全量计划表骨架 */
+    STRUCTURE: '/open_api/work_item/wbs_view/structure/query',
+    /** 查询计划表行详情 */
+    DETAIL: '/open_api/work_item/wbs_view/detail/query',
+    /** 查询计划表扩展信息 */
+    EXPAND: '/open_api/work_item/wbs_instance/expand/query',
+};
+/**
+ * WBS 发布态服务
+ */
+export class WbsViewService extends BaseService {
+    projectKeyResolver;
+    constructor(requestHandler) {
+        super(requestHandler);
+        this.projectKeyResolver = new WbsProjectKeyResolver(requestHandler);
+    }
+    /**
+     * 查询全量计划表骨架
+     *
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 发布态计划表骨架
+     */
+    async queryStructure(request, options) {
+        const projectKey = await this.projectKeyResolver.resolveProjectKey({
+            projectKey: request.project_key,
+            workItemId: request.work_item_id,
+            options,
+        });
+        const result = await this.post(API_PATHS.STRUCTURE, {
+            ...request,
+            project_key: projectKey,
+        }, options);
+        // 文档字段表与示例冲突，SDK 统一归一到 wbs_structure，避免调用方额外分支。
+        return {
+            wbs_structure: result.wbs_structure ?? result.wbs_draft_structure,
+        };
+    }
+    /**
+     * 查询计划表行详细信息
+     *
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 发布态计划表行详情
+     */
+    async queryRowDetails(request, options) {
+        const projectKey = await this.projectKeyResolver.resolveProjectKey({
+            projectKey: request.project_key,
+            workItemId: request.work_item_id,
+            options,
+        });
+        return this.post(API_PATHS.DETAIL, {
+            ...request,
+            project_key: projectKey,
+        }, options);
+    }
+    /**
+     * 查询计划表扩展信息
+     *
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 发布态计划表扩展信息
+     */
+    async queryExpandInfo(request, options) {
+        const projectKey = await this.projectKeyResolver.resolveProjectKey({
+            projectKey: request.project_key,
+            workItemId: request.work_item_id,
+            workItemTypeKey: request.work_item_type_key,
+            options,
+        });
+        return this.post(API_PATHS.EXPAND, {
+            ...request,
+            project_key: projectKey,
+        }, options);
+    }
+}

package/dist/service/workitem/workItem.d.ts

@@ -11,12 +11,14 @@
  * - 附件管理 (attachment)
  * - 群聊管理 (chat)
  * - 工作流操作 (workflow)
+ * - 计划表草稿 (wbsDraft)
+ * - 计划表发布态 (wbsView)
  * - 工时登记 (workHour)
  * - 评审管理 (review)
  */
 import type { RequestHandler } from '../../core/request/index.js';
 import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
-import type { WorkItem, QueryWorkItemRequest, CreateWorkItemRequest, UpdateWorkItemRequest, GetWorkItemMetaResponse, GetOperationRecordsRequest, GetOperationRecordsResponse, UpdateCompoundFieldRequest, WorkItemWithImages } from '../../types/workitem.js';
+import type { WorkItem, QueryWorkItemRequest, CreateWorkItemRequest, UpdateWorkItemRequest, FreezeWorkItemRequest, GetWorkItemMetaResponse, GetOperationRecordsRequest, GetOperationRecordsResponse, GetFieldOptionsRequest, GetFieldOptionsResponse, UpdateCompoundFieldValueRequest, WorkItemWithImages } from '../../types/workitem.js';
 import { SearchService } from './search.js';
 import { BatchService } from './batch.js';
 import { CommentService } from './comment.js';
@@ -24,6 +26,8 @@ import { SubtaskService } from './subtask.js';
 import { AttachmentService } from './attachment.js';
 import { ChatService } from './chat.js';
 import { WorkflowService } from './workflow.js';
+import { WbsDraftService } from './wbsDraft.js';
+import { WbsViewService } from './wbsView.js';
 import { WorkHourService } from './workhour.js';
 import { ReviewService } from './review.js';
 /** API 路径 */
@@ -44,6 +48,8 @@ export declare const API_PATHS: {
     ABORT: string;
     /** 获取工作项操作记录 */
     OPERATION_RECORD: string;
+    /** 获取工作项指定字段可选选项 */
+    FIELD_OPTIONS: string;
     /** 按组更新复合字段值 */
     UPDATE_COMPOUND_FIELD: string;
 };
@@ -73,6 +79,8 @@ export interface QueryWorkItemOptions extends ServiceRequestOptions<WorkItem[]>
  * - attachment: 附件服务
  * - chat: 群聊服务
  * - workflow: 工作流服务
+ * - wbsDraft: 计划表草稿服务
+ * - wbsView: 计划表发布态服务
  */
 export declare class WorkItemService extends BaseService {
     /** 搜索服务 */
@@ -89,6 +97,10 @@ export declare class WorkItemService extends BaseService {
     readonly chat: ChatService;
     /** 工作流服务 */
     readonly workflow: WorkflowService;
+    /** 计划表草稿服务 */
+    readonly wbsDraft: WbsDraftService;
+    /** 计划表发布态服务 */
+    readonly wbsView: WbsViewService;
     /** 工时登记服务 */
     readonly workHour: WorkHourService;
     /** 评审服务 */
@@ -178,11 +190,10 @@ export declare class WorkItemService extends BaseService {
     /**
      * 冻结/解冻工作项
      *
-     * @param workItemIds 工作项 ID 列表
-     * @param freeze true: 冻结, false: 解冻
+     * @param request 冻结/解冻请求
      * @param options 请求选项
      */
-    freeze(workItemIds: number[], freeze: boolean, options?: ServiceRequestOptions<void>): Promise<void>;
+    freeze(request: FreezeWorkItemRequest, options?: ServiceRequestOptions<void>): Promise<void>;
     /**
      * 终止工作项
      *
@@ -221,6 +232,18 @@ export declare class WorkItemService extends BaseService {
      * ```
      */
     getOperationRecords(request: GetOperationRecordsRequest, options?: ServiceRequestOptions<GetOperationRecordsResponse>): Promise<GetOperationRecordsResponse>;
+    /**
+     * 获取工作项指定字段可选选项
+     *
+     * @param request 请求参数
+     * @param request.project_key 空间 ID 或域名
+     * @param request.work_item_type_key 工作项类型 key
+     * @param request.work_item_id 工作项 ID
+     * @param request.field_key 字段 key
+     * @param options 请求选项
+     * @returns 可选选项列表
+     */
+    getFieldOptions(request: GetFieldOptionsRequest, options?: ServiceRequestOptions<GetFieldOptionsResponse>): Promise<GetFieldOptionsResponse>;
     /**
      * 按组更新复合字段值
      *
@@ -230,7 +253,7 @@ export declare class WorkItemService extends BaseService {
      * @example
      * ```typescript
      * // 添加一组复合字段数据
-     * await client.workItem.updateCompoundField({
+     * await client.workItem.updateCompoundFieldValue({
      *   project_key: 'my-project',
      *   work_item_id: 123456,
      *   field_key: 'field_xxx',
@@ -241,7 +264,7 @@ export declare class WorkItemService extends BaseService {
      * });
      *
      * // 删除一组复合字段数据
-     * await client.workItem.updateCompoundField({
+     * await client.workItem.updateCompoundFieldValue({
      *   project_key: 'my-project',
      *   work_item_id: 123456,
      *   field_key: 'field_xxx',
@@ -250,5 +273,5 @@ export declare class WorkItemService extends BaseService {
      * });
      * ```
      */
-    updateCompoundField(request: UpdateCompoundFieldRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    updateCompoundFieldValue(request: UpdateCompoundFieldValueRequest, options?: ServiceRequestOptions<void>): Promise<void>;
 }

package/dist/service/workitem/workItem.js

@@ -11,6 +11,8 @@
  * - 附件管理 (attachment)
  * - 群聊管理 (chat)
  * - 工作流操作 (workflow)
+ * - 计划表草稿 (wbsDraft)
+ * - 计划表发布态 (wbsView)
  * - 工时登记 (workHour)
  * - 评审管理 (review)
  */
@@ -23,6 +25,8 @@ import { SubtaskService } from './subtask.js';
 import { AttachmentService } from './attachment.js';
 import { ChatService } from './chat.js';
 import { WorkflowService } from './workflow.js';
+import { WbsDraftService } from './wbsDraft.js';
+import { WbsViewService } from './wbsView.js';
 import { WorkHourService } from './workhour.js';
 import { ReviewService } from './review.js';
 /** API 路径 */
@@ -43,6 +47,8 @@ export const API_PATHS = {
     ABORT: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/abort',
     /** 获取工作项操作记录 */
     OPERATION_RECORD: '/open_api/op_record/work_item/list',
+    /** 获取工作项指定字段可选选项 */
+    FIELD_OPTIONS: '/open_api/work_item/field/options',
     /** 按组更新复合字段值 */
     UPDATE_COMPOUND_FIELD: '/open_api/work_item/field_value/update_compound_field',
 };
@@ -57,6 +63,8 @@ export const API_PATHS = {
  * - attachment: 附件服务
  * - chat: 群聊服务
  * - workflow: 工作流服务
+ * - wbsDraft: 计划表草稿服务
+ * - wbsView: 计划表发布态服务
  */
 export class WorkItemService extends BaseService {
     /** 搜索服务 */
@@ -73,6 +81,10 @@ export class WorkItemService extends BaseService {
     chat;
     /** 工作流服务 */
     workflow;
+    /** 计划表草稿服务 */
+    wbsDraft;
+    /** 计划表发布态服务 */
+    wbsView;
     /** 工时登记服务 */
     workHour;
     /** 评审服务 */
@@ -87,6 +99,8 @@ export class WorkItemService extends BaseService {
         this.attachment = new AttachmentService(requestHandler);
         this.chat = new ChatService(requestHandler);
         this.workflow = new WorkflowService(requestHandler);
+        this.wbsDraft = new WbsDraftService(requestHandler);
+        this.wbsView = new WbsViewService(requestHandler);
         this.workHour = new WorkHourService(requestHandler);
         this.review = new ReviewService(requestHandler);
     }
@@ -266,15 +280,11 @@ export class WorkItemService extends BaseService {
     /**
      * 冻结/解冻工作项
      *
-     * @param workItemIds 工作项 ID 列表
-     * @param freeze true: 冻结, false: 解冻
+     * @param request 冻结/解冻请求
      * @param options 请求选项
      */
-    async freeze(workItemIds, freeze, options) {
-        await this.put(API_PATHS.FREEZE, {
-            work_item_ids: workItemIds,
-            action: freeze ? 'freeze' : 'unfreeze',
-        }, options);
+    async freeze(request, options) {
+        await this.put(API_PATHS.FREEZE, request, options);
     }
     /**
      * 终止工作项
@@ -336,6 +346,29 @@ export class WorkItemService extends BaseService {
     async getOperationRecords(request, options) {
         return this.post(API_PATHS.OPERATION_RECORD, request, options);
     }
+    /**
+     * 获取工作项指定字段可选选项
+     *
+     * @param request 请求参数
+     * @param request.project_key 空间 ID 或域名
+     * @param request.work_item_type_key 工作项类型 key
+     * @param request.work_item_id 工作项 ID
+     * @param request.field_key 字段 key
+     * @param options 请求选项
+     * @returns 可选选项列表
+     */
+    async getFieldOptions(request, options) {
+        const body = {
+            project_key: request.project_key,
+            work_item_type_key: request.work_item_type_key,
+            work_item_id: request.work_item_id,
+            field_key: request.field_key,
+            ...(request.first_option_key !== undefined
+                ? { first_option_key: request.first_option_key }
+                : {}),
+        };
+        return this.post(API_PATHS.FIELD_OPTIONS, body, options);
+    }
     /**
      * 按组更新复合字段值
      *
@@ -345,7 +378,7 @@ export class WorkItemService extends BaseService {
      * @example
      * ```typescript
      * // 添加一组复合字段数据
-     * await client.workItem.updateCompoundField({
+     * await client.workItem.updateCompoundFieldValue({
      *   project_key: 'my-project',
      *   work_item_id: 123456,
      *   field_key: 'field_xxx',
@@ -356,7 +389,7 @@ export class WorkItemService extends BaseService {
      * });
      *
      * // 删除一组复合字段数据
-     * await client.workItem.updateCompoundField({
+     * await client.workItem.updateCompoundFieldValue({
      *   project_key: 'my-project',
      *   work_item_id: 123456,
      *   field_key: 'field_xxx',
@@ -365,7 +398,7 @@ export class WorkItemService extends BaseService {
      * });
      * ```
      */
-    async updateCompoundField(request, options) {
+    async updateCompoundFieldValue(request, options) {
         await this.post(API_PATHS.UPDATE_COMPOUND_FIELD, request, options);
     }
 }

package/dist/service/workitem/workflow.d.ts

@@ -10,7 +10,7 @@
  * - 获取工作流详情
  */
 import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
-import type { StateChangeRequest, NodeOperateRequest, UpdateNodeRequest, TransitionRequiredInfoRequest, TransitionRequiredInfo, WorkflowInfo, WorkflowQueryRequest, WbsViewQueryParams, WbsViewRequest, WbsWorkItem } from '../../types/workitem.js';
+import type { StateChangeRequest, NodeOperateRequest, UpdateNodeRequest, TransitionRequiredInfoRequest, TransitionRequiredInfo, WorkflowInfo, WorkflowQueryRequest, WbsViewQueryParams, WbsViewRequest, WbsViewResponse } from '../../types/workitem.js';
 /** API 路径 */
 export declare const API_PATHS: {
     /** 获取工作流详情 */
@@ -230,5 +230,5 @@ export declare class WorkflowService extends BaseService {
         query?: WbsViewQueryParams;
         /** 请求体（expand 等扩展参数） */
         body?: WbsViewRequest;
-    }, options?: ServiceRequestOptions<WbsWorkItem>): Promise<WbsWorkItem>;
+    }, options?: ServiceRequestOptions<WbsViewResponse>): Promise<WbsViewResponse>;
 }

package/dist/service/workitem/workflow.js

@@ -273,6 +273,7 @@ export class WorkflowService extends BaseService {
         const expandQuery = params?.body?.expand
             ? {
                 need_union_deliverable: params.body.expand.need_union_deliverable,
+                need_schedule_table_agg: params.body.expand.need_schedule_table_agg,
                 need_wbs_relation_chain_path: params.body.expand.need_wbs_relation_chain_path,
                 need_wbs_relation_chain_entity: params.body.expand.need_wbs_relation_chain_entity,
             }

package/dist/service/workitem/workhour.d.ts

@@ -30,7 +30,7 @@ export declare class WorkHourService extends BaseService {
      * @param options 请求选项
      * @returns 新建工时记录列表
      */
-    create(projectKey: string, workItemTypeKey: string, workItemId: number, request: CreateWorkHourRecordRequest, options?: ServiceRequestOptions<WorkHourRecord[]>): Promise<WorkHourRecord[]>;
+    create(projectKey: string, workItemTypeKey: string, workItemId: number | string, request: CreateWorkHourRecordRequest, options?: ServiceRequestOptions<WorkHourRecord[]>): Promise<WorkHourRecord[]>;
     /**
      * 更新工时登记记录
      *
@@ -40,7 +40,7 @@ export declare class WorkHourService extends BaseService {
      * @param request 更新请求
      * @param options 请求选项
      */
-    update(projectKey: string, workItemTypeKey: string, workItemId: number, request: UpdateWorkHourRecordRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    update(projectKey: string, workItemTypeKey: string, workItemId: number | string, request: UpdateWorkHourRecordRequest, options?: ServiceRequestOptions<void>): Promise<void>;
     /**
      * 删除工时登记记录
      *
@@ -50,7 +50,7 @@ export declare class WorkHourService extends BaseService {
      * @param request 删除请求
      * @param options 请求选项
      */
-    deleteRecords(projectKey: string, workItemTypeKey: string, workItemId: number, request: DeleteWorkHourRecordRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    deleteRecords(projectKey: string, workItemTypeKey: string, workItemId: number | string, request: DeleteWorkHourRecordRequest, options?: ServiceRequestOptions<void>): Promise<void>;
     /**
      * 获取工作项的工时登记记录列表
      *

package/dist/types/aifield.d.ts

@@ -0,0 +1,12 @@
+/**
+ * AI 字段相关类型定义
+ */
+/** AI 字段可回写的字段值 */
+export type AIFieldValue = string | number | boolean | null | Record<string, unknown> | unknown[];
+/** 更新 AI 字段请求 */
+export interface AIFieldUpdateRequest {
+    /** AI 任务 ID */
+    ai_task_id: string;
+    /** 回写到 AI 字段的值 */
+    field_value: AIFieldValue;
+}

package/dist/types/aifield.js

@@ -0,0 +1,4 @@
+/**
+ * AI 字段相关类型定义
+ */
+export {};

package/dist/types/ainode.d.ts

@@ -1,11 +1,10 @@
 /**
- * AI Node types
  * AI 节点相关类型定义
  */
 /**
  * AI 节点运行状态
  */
-export type AINodeStatus = 'idle' | 'running' | 'done' | 'stopped' | 'error';
+export type AINodeStatus = 'idle' | 'running' | 'done' | 'stopped';
 /**
  * AI 节点状态枚举
  */
@@ -18,9 +17,11 @@ export declare const AINodeRunningState: {
     readonly Done: "done";
     /** 停止状态 */
     readonly Stopped: "stopped";
-    /** 错误状态 */
-    readonly Error: "error";
 };
+/** AI 节点流转状态 */
+export type AINodeNodeState = 'REACHED' | 'UNREACH' | string;
+/** AI 节点字段值 */
+export type AINodeFieldValue = string | number | boolean | null | Record<string, unknown> | unknown[];
 /**
  * AI 节点字段
  */
@@ -29,8 +30,27 @@ export interface AINodeField {
     field_key: string;
     /** 字段类型 */
     field_type: string;
-    /** 字段值 */
-    value: string;
+    /** 字段名称 */
+    field_name?: string;
+    /** 查询接口字段值 */
+    value?: AINodeFieldValue;
+    /** 事件字段值 */
+    field_value?: AINodeFieldValue;
+}
+/** AI 节点自定义属性类型 */
+export type AINodeCustomPropertyType = 'multiSelect' | 'select' | 'text' | 'number';
+/**
+ * AI 节点自定义属性
+ */
+export interface AINodeCustomProperty {
+    /** 查询接口属性类型 */
+    type?: AINodeCustomPropertyType | string;
+    /** 查询接口属性值 */
+    value?: string;
+    /** 事件属性类型 */
+    Type?: AINodeCustomPropertyType | string;
+    /** 事件属性值 */
+    Value?: string;
 }
 /**
  * AI 节点属性值
@@ -40,6 +60,8 @@ export interface AINodePropValue {
     field?: AINodeField[] | null;
     /** 节点字段列表 */
     node_field?: AINodeField[] | null;
+    /** 自定义属性 */
+    custom_property?: AINodeCustomProperty | null;
 }
 /**
  * AI 节点属性
@@ -48,7 +70,7 @@ export interface AINodeProp {
     /** 属性键（如 prop_key_1） */
     prop_key: string;
     /** AI 属性的类型列表 */
-    prop_type: string[];
+    prop_type: string | string[];
     /** 属性值 */
     prop_value: AINodePropValue;
 }
@@ -79,7 +101,7 @@ export interface AINodeSubTask {
     /** 子任务 ID */
     task_id: number;
     /** 是否已完成 */
-    is_finished: boolean;
+    is_finished: boolean | 0 | 1;
 }
 /**
  * 子工作项
@@ -88,37 +110,25 @@ export interface AINodeSubWorkItem {
     /** 关联 ID */
     relation_id: string;
     /** 关联的工作项 ID 列表 */
-    workitem_ids: string[];
+    workitem_ids: Array<number | string>;
     /** 关联工作项类型 */
     work_item_type: string;
 }
 /**
- * 获取 AI 节点信息请求参数
+ * AI 节点定位参数
  */
-export interface AINodeQueryRequest {
-    /** 空间 ID（project_key） */
-    project_key: string;
-    /** 工作项实例 ID */
-    work_item_id: number;
+export type AINodeLocator = {
     /**
      * 节点 ID（node_key / state_key）
      * 说明：node_uuid 和 state_key 必填一个
      */
-    state_key?: string;
+    state_key: string;
     /**
      * 节点 uuid
      * 说明：node_uuid 和 state_key 必填一个
      */
     node_uuid?: string;
-}
-/**
- * 修改 AI 节点数据请求参数
- */
-export interface AINodeEditRequest {
-    /** 空间 ID（project_key） */
-    project_key?: string;
-    /** 工作项实例 ID */
-    work_item_id: number;
+} | {
     /**
      * 节点 ID（node_key / state_key）
      * 说明：node_uuid 和 state_key 必填一个
@@ -128,7 +138,29 @@ export interface AINodeEditRequest {
      * 节点 uuid
      * 说明：node_uuid 和 state_key 必填一个
      */
-    node_uuid?: string;
+    node_uuid: string;
+};
+/**
+ * 获取 AI 节点信息请求基础参数
+ */
+export interface AINodeQueryRequestBase {
+    /** 空间 ID（project_key） */
+    project_key: string;
+    /** 工作项实例 ID */
+    work_item_id: number;
+}
+/**
+ * 获取 AI 节点信息请求参数
+ */
+export type AINodeQueryRequest = AINodeQueryRequestBase & AINodeLocator;
+/**
+ * 修改 AI 节点数据请求基础参数
+ */
+export interface AINodeEditRequestBase {
+    /** 空间 ID（project_key） */
+    project_key?: string;
+    /** 工作项实例 ID */
+    work_item_id: number;
     /**
      * AI 运行状态
      * 目前仅支持从 running 流转到 done
@@ -139,6 +171,10 @@ export interface AINodeEditRequest {
     /** 节点表单，不传视为不更新 */
     conform_fields?: AINodeEditField[];
 }
+/**
+ * 修改 AI 节点数据请求参数
+ */
+export type AINodeEditRequest = AINodeEditRequestBase & AINodeLocator;
 /**
  * 修改 AI 节点字段
  */
@@ -148,33 +184,27 @@ export interface AINodeEditField {
     /** 字段键 */
     field_key?: string;
     /** 字段值 */
-    value: string;
+    value: AINodeFieldValue;
 }
 /**
- * 完成 AI 节点请求参数
+ * 完成 AI 节点请求基础参数
  */
-export interface AINodeConfirmRequest {
+export interface AINodeConfirmRequestBase {
     /** 空间 ID（project_key） */
     project_key: string;
     /** 工作项实例 ID */
     work_item_id: number;
-    /**
-     * 节点 ID（node_key / state_key）
-     * 说明：node_uuid 和 state_key 必填一个
-     */
-    state_key?: string;
-    /**
-     * 节点 uuid
-     * 说明：node_uuid 和 state_key 必填一个
-     */
-    node_uuid?: string;
 }
+/**
+ * 完成 AI 节点请求参数
+ */
+export type AINodeConfirmRequest = AINodeConfirmRequestBase & AINodeLocator;
 /**
  * 获取 AI 节点信息响应数据
  */
 export interface AINodeQueryResponse {
     /** 节点状态 */
-    node_state: string;
+    node_state: AINodeNodeState;
     /** AI 信息 */
     ai_info: AINodeInfo;
     /** 节点字段（含系统字段） */

package/dist/types/ainode.js

@@ -1,5 +1,4 @@
 /**
- * AI Node types
  * AI 节点相关类型定义
  */
 /**
@@ -14,6 +13,4 @@ export const AINodeRunningState = {
     Done: 'done',
     /** 停止状态 */
     Stopped: 'stopped',
-    /** 错误状态 */
-    Error: 'error',
 };