@lark-project/js-sdk 2.1.5 → 2.1.7

package/CHANGELOG.md

@@ -1,4 +1,7 @@
 # Change Log
+## 2.1.7（2026/5/28）
+- 「Add」新增 AI 节点相关类型与客户端入口
+
 # 2.1.5（2026/3/6）
 - 「Add」新增 LiteAppSubscribedPropertyValueType 类型相关定义
 

package/dist/es/index.js

@@ -496,6 +496,16 @@ _a29 = IMPL_KEY;
  */
 BuilderComponent[_a29] = "liteAppComponent";
 
+// src/features/AINode.ts
+var _a30;
+var AINode = class extends BaseModel {
+};
+_a30 = IMPL_KEY;
+/**
+ * @internal
+ */
+AINode[_a30] = "aiNode";
+
 // src/client.ts
 function getImplClass(decl, impls) {
   return impls == null ? void 0 : impls[decl[IMPL_KEY]];
@@ -589,6 +599,13 @@ var _SDKClient = class {
   get liteAppComponent() {
     return getImplValue(BuilderComponent, this._meegoBizHub);
   }
+  /**
+   * AI 节点点位容器特有能力
+   * only 2.0
+   */
+  get aiNode() {
+    return getImplValue(AINode, this._meegoBizHub);
+  }
   /**
    * 应用导航
    */
@@ -722,7 +739,7 @@ var SDKClient = _SDKClient;
 /**
  * SDK 版本号
  */
-SDKClient.version = "2.1.5";
+SDKClient.version = "2.1.7";
 
 // src/types/biz.ts
 var AttributeType = /* @__PURE__ */ ((AttributeType2) => {
@@ -833,6 +850,14 @@ var LiteAppSubscribedPropertyTemplate = /* @__PURE__ */ ((LiteAppSubscribedPrope
   LiteAppSubscribedPropertyTemplate2["DataSource"] = "dataSource";
   return LiteAppSubscribedPropertyTemplate2;
 })(LiteAppSubscribedPropertyTemplate || {});
+var AINodeRuningState = /* @__PURE__ */ ((AINodeRuningState2) => {
+  AINodeRuningState2["Idle"] = "idle";
+  AINodeRuningState2["Running"] = "running";
+  AINodeRuningState2["Done"] = "done";
+  AINodeRuningState2["Stopped"] = "stopped";
+  AINodeRuningState2["Error"] = "error";
+  return AINodeRuningState2;
+})(AINodeRuningState || {});
 
 // src/errors/CustomError.ts
 var CustomError = class extends Error {
@@ -934,6 +959,8 @@ var SystemPermissionDeniedError = class extends CustomError {
 // src/index.ts
 var src_default = SDKClient;
 export {
+  AINode,
+  AINodeRuningState,
   ActionSheet,
   AttributeType,
   BuilderComponent,

package/dist/lib/index.js

@@ -48,6 +48,8 @@ var __async = (__this, __arguments, generator) => {
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  AINode: () => AINode,
+  AINodeRuningState: () => AINodeRuningState,
   ActionSheet: () => ActionSheet,
   AttributeType: () => AttributeType,
   BuilderComponent: () => BuilderComponent,
@@ -570,6 +572,16 @@ _a29 = IMPL_KEY;
  */
 BuilderComponent[_a29] = "liteAppComponent";
 
+// src/features/AINode.ts
+var _a30;
+var AINode = class extends BaseModel {
+};
+_a30 = IMPL_KEY;
+/**
+ * @internal
+ */
+AINode[_a30] = "aiNode";
+
 // src/client.ts
 function getImplClass(decl, impls) {
   return impls == null ? void 0 : impls[decl[IMPL_KEY]];
@@ -663,6 +675,13 @@ var _SDKClient = class {
   get liteAppComponent() {
     return getImplValue(BuilderComponent, this._meegoBizHub);
   }
+  /**
+   * AI 节点点位容器特有能力
+   * only 2.0
+   */
+  get aiNode() {
+    return getImplValue(AINode, this._meegoBizHub);
+  }
   /**
    * 应用导航
    */
@@ -796,7 +815,7 @@ var SDKClient = _SDKClient;
 /**
  * SDK 版本号
  */
-SDKClient.version = "2.1.5";
+SDKClient.version = "2.1.7";
 
 // src/types/biz.ts
 var AttributeType = /* @__PURE__ */ ((AttributeType2) => {
@@ -907,6 +926,14 @@ var LiteAppSubscribedPropertyTemplate = /* @__PURE__ */ ((LiteAppSubscribedPrope
   LiteAppSubscribedPropertyTemplate2["DataSource"] = "dataSource";
   return LiteAppSubscribedPropertyTemplate2;
 })(LiteAppSubscribedPropertyTemplate || {});
+var AINodeRuningState = /* @__PURE__ */ ((AINodeRuningState2) => {
+  AINodeRuningState2["Idle"] = "idle";
+  AINodeRuningState2["Running"] = "running";
+  AINodeRuningState2["Done"] = "done";
+  AINodeRuningState2["Stopped"] = "stopped";
+  AINodeRuningState2["Error"] = "error";
+  return AINodeRuningState2;
+})(AINodeRuningState || {});
 
 // src/errors/CustomError.ts
 var CustomError = class extends Error {
@@ -1009,6 +1036,8 @@ var SystemPermissionDeniedError = class extends CustomError {
 var src_default = SDKClient;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AINode,
+  AINodeRuningState,
   ActionSheet,
   AttributeType,
   BuilderComponent,

package/dist/types/index.d.ts

@@ -149,6 +149,11 @@ declare enum FieldType {
      */
     workItemRelatedMultiSelect = "work_item_related_multi_select"
 }
+/**
+ * @public
+ * 工作项字段值类型
+ */
+type WorkItemFieldValue = string | string[] | number | number[] | boolean | unknown;
 /**
  * @public
  * 空间（仅含关键属性）
@@ -435,6 +440,10 @@ interface ScheduleUnitButtonFeatureContext {
          * 计划表单元值
          */
         value: Record<string, any>;
+        /**
+         * 当前计划表唯一标识
+         */
+        scheduleTableUUID: string;
     };
 }
 /**
@@ -1027,6 +1036,44 @@ interface LiteAppComponentPreset {
         height: number;
     };
 }
+/** ----------------------- AI 节点构成类型 ----------------------- */
+interface AINodeFeatureContext {
+    /**
+     * AI 节点当前所属空间标识
+     */
+    spaceId: string;
+    /**
+     * AI 节点当前所属工作项类型标识
+     */
+    workObjectId: string;
+    /**
+     * AI 节点当前所属工作项实例标识
+     */
+    workItemId: number;
+    /**
+     * 当前节点标识
+     */
+    nodeId: string;
+}
+/**
+ * AI 节点运行状态
+ */
+declare enum AINodeRuningState {
+    Idle = "idle",
+    Running = "running",
+    Done = "done",
+    Stopped = "stopped",
+    Error = "error"
+}
+/**
+ * AI 节点 props
+ */
+interface AINodeProps {
+    /**
+     * AI 节点运行状态字段
+     */
+    ai_node_running: AINodeRuningState;
+}
 /**
  * liteapp 工作项实例定义
  */
@@ -1064,9 +1111,9 @@ type LiteAppWorkItemInstance = {
      */
     isDeleted: boolean;
     /**
-     * 其他字段
+     * 配置字段
      */
-    fields?: Record<string, unknown>;
+    fields?: Record<string, WorkItemFieldValue>;
 };
 type LiteAppComponentDataSourceResult = {
     /**
@@ -1324,9 +1371,8 @@ declare abstract class WorkItem extends BaseModel {
     abstract isDeleted: boolean;
     /**
      * 获取工作项实例自定义字段相关数据
-     * TODO: 类型暂未定义
      */
-    abstract getFieldValue(fieldId: string): any;
+    abstract getFieldValue(fieldId: string): FieldValue;
 }
 
 /**
@@ -2465,6 +2511,42 @@ declare abstract class BuilderComponent extends BaseModel {
     abstract notify: (key: string, value: LiteAppSubscribedPropertyValueType) => Promise<void>;
 }
 
+/**
+ * @public
+ * AI 节点
+ */
+declare abstract class AINode extends BaseModel {
+    /**
+     * @internal
+     */
+    protected static [IMPL_KEY]: string;
+    /**
+     * 获取当前 AI 节点所在的上下文
+     */
+    abstract getContext(): Promise<AINodeFeatureContext>;
+    /**
+     * 获取 AI 节点运行态 props
+     */
+    abstract getProps(): Promise<AINodeProps>;
+    /**
+     * 监听 AI 节点 props 变更
+     * @param callback 返回最新的 props
+     * @param watchKeys 需要监听的 key，默认监听所有 key
+     */
+    abstract watch(callback: (next: AINodeProps | Record<string, never>) => void, watchKeys?: (keyof AINodeProps)[]): Promise<Off>;
+    /**
+     * 监听工作项表单项值变化
+     * @param options.watchKeys 需要监听的工作项字段 ID 列表
+     * @param callback 当监听值发生变化时触发，changedValue 为变化的 kv
+     */
+    abstract onWorkItemFormValueChanged(options: {
+        watchKeys: Array<{
+            key: string | AttributeType;
+            type: Exclude<FieldType, FieldType.richText | FieldType.singleSignal | FieldType.multiSignal | FieldType.singleVoting | FieldType.multiVoting | FieldType.simpleVoting>;
+        }>;
+    }, callback: (changedValue: Record<string, unknown>) => void): Promise<Off>;
+}
+
 /**
  * @public
  * SDKClient 的配置项
@@ -2543,6 +2625,11 @@ declare class SDKClient {
      * only web 2.0
      */
     get liteAppComponent(): BuilderComponent;
+    /**
+     * AI 节点点位容器特有能力
+     * only 2.0
+     */
+    get aiNode(): AINode;
     /**
      * 应用导航
      */
@@ -2700,4 +2787,4 @@ declare class NotSupportedError extends CustomError {
  * @packageDocumentation
  */
 
-export { ActionSheet, ActionSheetOptions, AttributeType, BatchButtonFeatureContext, BizLine, BriefField, BriefNode, BriefSpace, BriefTemplate, BriefView, BriefWorkItem, BriefWorkObject, BuilderComponent, Button, ButtonFeatureContext, ButtonScene, Clipboard, ColorScheme, ComponentScheduleIdentity, ComponentScheduleScene, Configuration, ConfigurationFeatureContext, ContainerModal, ContainerModalConfigureOptions, Context, Control, ControlFeatureContext, CreateButtonFeatureContext, CustomComponent, CustomComponentFeatureContext, CustomComponentProps, CustomComponentType, CustomField, CustomFieldConfig, CustomFieldFeatureContext, CustomFieldProps, CustomFieldValidateMsg, CustomFieldValueType, Event, EventPayloadMap, EventType, ExCompoundFieldValueType, Field, FieldType, FieldValue, FlowMode, Geolocation, GeolocationCoordinates, GeolocationPosition, I18nTitleConfig, IMPL_KEY, IPluginCustomBuildConfig, IRichTextEditorImageUploadComplete, IntegrationFeatureContext, Intercept, InterceptEvent, InterceptFeatureContext, InternalError, InvalidParamsError, Language, LiteAppCompLayoutConfig, LiteAppCompPropBriefConfig, LiteAppCompPropFullConfig, LiteAppCompPropSelectConfig, LiteAppCompPropValueType, LiteAppComponentConfig, LiteAppComponentDataSourceResult, LiteAppComponentFeatureContext, LiteAppComponentPreset, LiteAppComponentProps, LiteAppPropBoolean, LiteAppPropDataSource, LiteAppPropDateRange, LiteAppPropDateWithTime, LiteAppPropField, LiteAppPropLayout, LiteAppPropMultiSelect, LiteAppPropNumber, LiteAppPropSelect, LiteAppPropTemplateType, LiteAppPropText, LiteAppPropView, LiteAppPropWorkItemInstance, LiteAppPropWorkItemListAfterFilter, LiteAppPropWorkItemListAfterSort, LiteAppPropWorkItemType, LiteAppSubscribedPropertyTemplate, LiteAppSubscribedPropertyValueType, LiteAppWorkItemInstance, MEEGO_BIZ_HUB, Modal, ModalConfirmOptions, ModalOpenOptions, Navigation, NoAuthError, NodeStatus, NotFoundError, NotSupportedError, Off, OutOfLimitError, Page, PageFeatureContext, RichTextEditor, RichTextEditorContent, RichTextEditorOptions, Role, RoleOwners, SDKClient, SDKClientOptions, ScheduleCompValidateMsg, ScheduleCompValueType, ScheduleUnitButtonFeatureContext, Script, ScriptFeatureContext, Shared, Space, Storage, SubFieldType, SystemPermissionDeniedError, Tab, TabFeatureContext, Toast, ToastOptions, User, UserInfo, Utils, View, ViewFeatureContext, WbsStatus, WorkItem, WorkItemButtonFeatureContext, WorkItemCreateFormPreset, WorkItemFinder, WorkItemFinderOptions, WorkObject, SDKClient as default, unwatch };
+export { AINode, AINodeFeatureContext, AINodeProps, AINodeRuningState, ActionSheet, ActionSheetOptions, AttributeType, BatchButtonFeatureContext, BizLine, BriefField, BriefNode, BriefSpace, BriefTemplate, BriefView, BriefWorkItem, BriefWorkObject, BuilderComponent, Button, ButtonFeatureContext, ButtonScene, Clipboard, ColorScheme, ComponentScheduleIdentity, ComponentScheduleScene, Configuration, ConfigurationFeatureContext, ContainerModal, ContainerModalConfigureOptions, Context, Control, ControlFeatureContext, CreateButtonFeatureContext, CustomComponent, CustomComponentFeatureContext, CustomComponentProps, CustomComponentType, CustomField, CustomFieldConfig, CustomFieldFeatureContext, CustomFieldProps, CustomFieldValidateMsg, CustomFieldValueType, Event, EventPayloadMap, EventType, ExCompoundFieldValueType, Field, FieldType, FieldValue, FlowMode, Geolocation, GeolocationCoordinates, GeolocationPosition, I18nTitleConfig, IMPL_KEY, IPluginCustomBuildConfig, IRichTextEditorImageUploadComplete, IntegrationFeatureContext, Intercept, InterceptEvent, InterceptFeatureContext, InternalError, InvalidParamsError, Language, LiteAppCompLayoutConfig, LiteAppCompPropBriefConfig, LiteAppCompPropFullConfig, LiteAppCompPropSelectConfig, LiteAppCompPropValueType, LiteAppComponentConfig, LiteAppComponentDataSourceResult, LiteAppComponentFeatureContext, LiteAppComponentPreset, LiteAppComponentProps, LiteAppPropBoolean, LiteAppPropDataSource, LiteAppPropDateRange, LiteAppPropDateWithTime, LiteAppPropField, LiteAppPropLayout, LiteAppPropMultiSelect, LiteAppPropNumber, LiteAppPropSelect, LiteAppPropTemplateType, LiteAppPropText, LiteAppPropView, LiteAppPropWorkItemInstance, LiteAppPropWorkItemListAfterFilter, LiteAppPropWorkItemListAfterSort, LiteAppPropWorkItemType, LiteAppSubscribedPropertyTemplate, LiteAppSubscribedPropertyValueType, LiteAppWorkItemInstance, MEEGO_BIZ_HUB, Modal, ModalConfirmOptions, ModalOpenOptions, Navigation, NoAuthError, NodeStatus, NotFoundError, NotSupportedError, Off, OutOfLimitError, Page, PageFeatureContext, RichTextEditor, RichTextEditorContent, RichTextEditorOptions, Role, RoleOwners, SDKClient, SDKClientOptions, ScheduleCompValidateMsg, ScheduleCompValueType, ScheduleUnitButtonFeatureContext, Script, ScriptFeatureContext, Shared, Space, Storage, SubFieldType, SystemPermissionDeniedError, Tab, TabFeatureContext, Toast, ToastOptions, User, UserInfo, Utils, View, ViewFeatureContext, WbsStatus, WorkItem, WorkItemButtonFeatureContext, WorkItemCreateFormPreset, WorkItemFieldValue, WorkItemFinder, WorkItemFinderOptions, WorkObject, SDKClient as default, unwatch };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-project/js-sdk",
-  "version": "2.1.5",
+  "version": "2.1.7",
   "runtimeMinVersions": {
     "web": "2.1.0",
     "mobile": "1.1.0"