@roomle/web-sdk 5.2.0-alpha.9 → 6.0.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/lib/ConfiguratorKernel.js +45 -45
  2. package/lib/ConfiguratorKernel.wasm +0 -0
  3. package/lib/RoomleCore.js +46 -46
  4. package/lib/RoomleCore.wasm +0 -0
  5. package/lib/RoomleToolsCore.wasm +0 -0
  6. package/lib/api-56gsJaFH.mjs +92 -0
  7. package/lib/api-56gsJaFH.mjs.map +1 -0
  8. package/lib/asset-loader.worker-CE4O0JU-.mjs.map +1 -1
  9. package/lib/budgeteer.sw-yR2xApHT.mjs.map +1 -1
  10. package/lib/{configurator-lYzmK0Qp.mjs → configurator-B2Yqt1V5.mjs} +18 -18
  11. package/lib/{configurator-lYzmK0Qp.mjs.map → configurator-B2Yqt1V5.mjs.map} +1 -1
  12. package/lib/configurator-sOl9pxCL.mjs +2 -0
  13. package/lib/{glb-viewer-VYVfbQN8.mjs → glb-viewer-BLe8SEWm.mjs} +23 -23
  14. package/lib/{glb-viewer-VYVfbQN8.mjs.map → glb-viewer-BLe8SEWm.mjs.map} +1 -1
  15. package/lib/glb-viewer-Y_Md3SYw.mjs +2 -0
  16. package/lib/{homag-intelligence-D_Pw-YCG.mjs → homag-intelligence-DmCkEgju.mjs} +15 -6
  17. package/lib/homag-intelligence-DmCkEgju.mjs.map +1 -0
  18. package/lib/{material-viewer-DeLQwvg5.mjs → material-viewer-DlPRNBJK.mjs} +19 -19
  19. package/lib/{material-viewer-DeLQwvg5.mjs.map → material-viewer-DlPRNBJK.mjs.map} +1 -1
  20. package/lib/{packages-DCI_1Sdp.mjs → packages-CRUOFLSm.mjs} +5 -5
  21. package/lib/{packages-DCI_1Sdp.mjs.map → packages-CRUOFLSm.mjs.map} +1 -1
  22. package/lib/planner-DLmepUoo.mjs +44 -0
  23. package/lib/{planner-CQlnhaJ4.mjs.map → planner-DLmepUoo.mjs.map} +1 -1
  24. package/lib/planner-XmE07_OQ.mjs +2 -0
  25. package/lib/{roomle-headless-setup-DbO_rLjK.mjs → roomle-headless-setup-bol8UwP_.mjs} +76 -66
  26. package/lib/roomle-headless-setup-bol8UwP_.mjs.map +1 -0
  27. package/lib/roomle-headless.d.ts +422 -21
  28. package/lib/roomle-headless.js +88 -88
  29. package/lib/roomle-headless.js.map +1 -1
  30. package/lib/{roomle-sdk-CWL55lWB.mjs → roomle-sdk-ORPlJCHx.mjs} +6246 -3101
  31. package/lib/roomle-sdk-ORPlJCHx.mjs.map +1 -0
  32. package/lib/roomle-sdk.d.ts +422 -21
  33. package/lib/roomle-sdk.js +9 -9
  34. package/lib/{roomle-webgpu-renderer-__fKL0NL.mjs → roomle-webgpu-renderer-BQuRMtn8.mjs} +23 -12
  35. package/lib/{roomle-webgpu-renderer-__fKL0NL.mjs.map → roomle-webgpu-renderer-BQuRMtn8.mjs.map} +1 -1
  36. package/lib/{script-loader-C6XVqA2M.mjs → script-loader-CKTdvq5h.mjs} +2 -2
  37. package/lib/{script-loader-C6XVqA2M.mjs.map → script-loader-CKTdvq5h.mjs.map} +1 -1
  38. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/package.json +1 -1
  39. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/src/embind/configuratorCoreInterface.d.ts +2 -0
  40. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/src/embind/plannerCoreInterface.d.ts +5 -0
  41. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/wasm_modern/ConfiguratorKernel.js +45 -45
  42. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/wasm_modern/ConfiguratorKernel.wasm +0 -0
  43. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/wasm_modern/RoomleCore.js +46 -46
  44. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/wasm_modern/RoomleCore.wasm +0 -0
  45. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/wasm_modern/RoomleToolsCore.wasm +0 -0
  46. package/lib/{tools-core-Cn7-Y2Tw.mjs → tools-core-DNlMbyR3.mjs} +6 -6
  47. package/lib/{tools-core-Cn7-Y2Tw.mjs.map → tools-core-DNlMbyR3.mjs.map} +1 -1
  48. package/package.json +2 -2
  49. package/lib/api-BESWNKGU.mjs +0 -61
  50. package/lib/api-BESWNKGU.mjs.map +0 -1
  51. package/lib/configurator-DksQO8bz.mjs +0 -2
  52. package/lib/glb-viewer-wn8DMhFv.mjs +0 -2
  53. package/lib/homag-intelligence-D_Pw-YCG.mjs.map +0 -1
  54. package/lib/planner-CQlnhaJ4.mjs +0 -44
  55. package/lib/planner-tkKFy4GN.mjs +0 -2
  56. package/lib/roomle-headless-setup-DbO_rLjK.mjs.map +0 -1
  57. package/lib/roomle-sdk-CWL55lWB.mjs.map +0 -1
@@ -244,6 +244,9 @@ export declare interface Attic extends PlanElement_2 {
244
244
  readonly side: WallSide_2;
245
245
  readonly kneeHeight: number;
246
246
  readonly width: number;
247
+ readonly curved: boolean;
248
+ readonly exteriorNormal: Vector3;
249
+ readonly exteriorPlaneOrigin: Vector3;
247
250
  }
248
251
 
249
252
  export declare type AtticArray = EmscriptenArray<Attic>;
@@ -2334,6 +2337,7 @@ export declare abstract class ConstructionObject extends PlanObjectPtr {
2334
2337
  export declare interface ConstructionObject_2 extends PlanObject_2 {
2335
2338
  new (): ConstructionObject_2;
2336
2339
  getAttachedWall(): Wall_2;
2340
+ getAttachedAttic(): Attic;
2337
2341
  getPreferredSide(): WallSide_2;
2338
2342
  getCornerFromLeft(): Vector3;
2339
2343
  getCornerFromRight(): Vector3;
@@ -2467,6 +2471,12 @@ export declare const CORE_DOCK_PAIR_TYPE: {
2467
2471
  readonly LINE: 1;
2468
2472
  };
2469
2473
 
2474
+ export declare const CORE_DOCK_PAIR_TYPE_2: {
2475
+ readonly POINT: 0;
2476
+ readonly LINE: 1;
2477
+ readonly AREA: 2;
2478
+ };
2479
+
2470
2480
  export declare const CORE_DRAWING_MODE: {
2471
2481
  readonly WALL: 0;
2472
2482
  readonly ROOM_CONTOUR: 1;
@@ -2988,16 +2998,49 @@ export declare interface DockingLineSegment {
2988
2998
  to: number;
2989
2999
  }
2990
3000
 
3001
+ export declare interface DockingLineSegment_2 {
3002
+ from: number;
3003
+ to: number;
3004
+ }
3005
+
3006
+ export declare interface DockPairPreview {
3007
+ areaWidth?: number;
3008
+ childDockId: number;
3009
+ childId: number;
3010
+ displacedChildId: number;
3011
+ displacedChildTransform: Matrix4;
3012
+ displacedComponents: number[];
3013
+ displacementRotation: Vector3;
3014
+ displacementVector: Vector3;
3015
+ insertInBetween: boolean;
3016
+ lineFrom?: Vector3;
3017
+ lineSegments: DockingLineSegment_2[];
3018
+ lineTo?: Vector3;
3019
+ parentDockId: number;
3020
+ parentId: number;
3021
+ position: Vector3;
3022
+ positionFrom?: Vector3;
3023
+ positionTo?: Vector3;
3024
+ rotation: Vector3;
3025
+ type: DockPairType_2;
3026
+ }
3027
+
2991
3028
  export declare class DockPairPreviewArray extends EmsArray<KernelDockPairPreview> {
2992
3029
  }
2993
3030
 
2994
- export declare class DockPairPreviewArray_2 extends EmsArray<KernelDockPairPreview> {
3031
+ export declare type DockPairPreviewArray_2 = EmscriptenArray<DockPairPreview>;
3032
+
3033
+ export declare class DockPairPreviewArray_3 extends EmsArray<KernelDockPairPreview> {
2995
3034
  }
2996
3035
 
2997
3036
  export declare interface DockPairType {
2998
3037
  value: Enumify<typeof CORE_DOCK_PAIR_TYPE>;
2999
3038
  }
3000
3039
 
3040
+ export declare interface DockPairType_2 {
3041
+ value: Enumify_3<typeof CORE_DOCK_PAIR_TYPE_2>;
3042
+ }
3043
+
3001
3044
  export declare class DomHelper implements LifeCycleCallbacks, Context {
3002
3045
  _creator_: string;
3003
3046
  private _lifeCycleManager;
@@ -3582,13 +3625,15 @@ export declare interface ExternalObjectAPI {
3582
3625
  /**
3583
3626
  * "openOrCloseGeometryOfExternalObject" switches the geometry of the modules between closed and open representation.
3584
3627
  * The function can switch the geometry of the group or the singe root module with the ID "groupIdOrRootModuleId".
3628
+ * A root module is switched without the root modules docked to it.
3585
3629
  * If "groupIdOrRootModuleId" is the ID of a root module and the "subModuleId" is also specified, only this one sub-module is opened or closed.
3586
3630
  * @param groupIdOrRootModuleId The ID of the group of modules or the ID of the root module.
3587
3631
  * @param subModuleId The ID of the sub module.
3588
3632
  * @param open If true, the modules are opened, if false, they are closed, if the geometry is already in the desired state, nothing happens.
3589
3633
  * @param animate If true the opening or closing is animated else the geometry is switched instantly.
3634
+ * @returns false if the group or root module is not in the plan or has no geometry that opens and closes; nothing is switched then.
3590
3635
  */
3591
- openOrCloseGeometryOfExternalObject(groupIdOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): void;
3636
+ openOrCloseGeometryOfExternalObject(groupIdOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): boolean;
3592
3637
  /**
3593
3638
  * "getExternalObjectGroups" returns all groups of external objects modules (PosData) that are currently loaded in the plan.
3594
3639
  */
@@ -3606,11 +3651,24 @@ export declare interface ExternalObjectAPI {
3606
3651
  * resubmittable article picks with footprints and free docking vectors), and what stands in the
3607
3652
  * room (the doors, windows and other plan objects as floor outlines with their height range,
3608
3653
  * and the HI groups as the outlines of their root modules).
3654
+ * The groups are in the placement frame: position.pos is the room point of the group's back left
3655
+ * bottom docking corner, rotationY the rotation of a placement, the footprint is measured from there,
3656
+ * and every root module of a row carries rowIndex, its place in the row from 1 at the left end.
3609
3657
  * The result is designed to be passed to an AI agent as it is, without further preparation,
3610
3658
  * with all geometry in one coordinate system: 3D, right-handed, Y up.
3611
3659
  * @param include The sections to include. All sections are returned when omitted or empty.
3660
+ * @param options articleIds: only these articles get their docking vectors and corner point from a
3661
+ * calculated template when they are not in the plan; without it every article that lacks them does.
3662
+ */
3663
+ getExternalObjectPlanContext(include?: HiPlanContextSection[], options?: HiPlanContextOptions): Promise<HiPlanContext>;
3664
+ /**
3665
+ * "getExternalObjectAgentPrompts" returns the prompts of an AI chat that plans with the HI tools of
3666
+ * the HI MCP server: systemPrompt, the system prompt of the chat, which names the planning skills
3667
+ * the agent fetches with get-skill, and imagePrompt, the text of a user message that carries an
3668
+ * image and no text. More prompts may be added to the object later.
3669
+ * The promise rejects when the planner has no HI module.
3612
3670
  */
3613
- getExternalObjectPlanContext(include?: HiPlanContextSection[]): Promise<HiPlanContext>;
3671
+ getExternalObjectAgentPrompts(): Promise<HiAgentPrompts>;
3614
3672
  /**
3615
3673
  * "externalObjectGroupOperation" changes the groups in the plan by command. The payload refers to
3616
3674
  * groups, root modules and articles by the ids of "getExternalObjectPlanContext":
@@ -3620,20 +3678,29 @@ export declare interface ExternalObjectAPI {
3620
3678
  * - "delete-group" { groupId } removes the group from the plan
3621
3679
  * - "delete-root-module" { rootModuleId } removes a root module; the rest of the group splits where it is no longer docked together
3622
3680
  * - "merge-article-into-group" { groupId, articleId, attributes?, dockTo: { rootId, ownDockingVector, dockingVector, mode?, offset? } } docks a new root module of the article to a free docking vector of a root module of the group; the new root module takes the implicitRelevant input attributes of that root module, and attributes override them
3623
- * - "exchange-root-module" { groupId, rootModuleId, articleId } replaces a root module with an article of one root module, keeping its docking and the implicitRelevant input attributes of the replaced root module
3681
+ * - "exchange-root-module" { groupId, rootModuleId, articleId, attributes? } replaces a root module with an article of one root module, keeping its docking and the implicitRelevant input attributes of the replaced root module; attributes override them
3624
3682
  * - "merge-groups" { targetGroupId, groupIds } merges the groups into the target group where they stand, like the merge action of the planner; no docking is added
3625
- * The promise resolves once the planner has loaded the result, with the affected groups in the shape of the plan context,
3626
- * and rejects with the reason when the payload is invalid or the operation cannot be performed.
3683
+ * - "insert-article-into-group" { groupId, articleId, attributes?, between: [rootModuleId, rootModuleId] } inserts a root module between two root modules docked side by side; the side at a wall keeps its place
3684
+ * - "remove-article-from-group" { groupId, rootModuleId } removes a root module and closes the gap; gapClosed says whether it did
3685
+ * - "swap-root-modules" { groupId, rootModuleIds: [rootModuleId, rootModuleId] } lets two root modules change places, with the units hung on them
3686
+ * A command named like an HI MCP tool (HI_TOOL_COMMAND) performs the whole tool with the tool's arguments - for a tool named like
3687
+ * a group operation a superset of its payload - and adds corrections, hint and historySteps (1 when the tool changed the plan, 0 when not; the planner runs the whole tool as one undo step) to the result:
3688
+ * create-or-replace-groups, place-group, change-module-attribute, change-group-attribute, delete-group, delete-article-in-place,
3689
+ * delete-article-and-compact, merge-article-into-group, exchange-root-module, insert-article-into-group, swap-root-modules, merge-groups.
3690
+ * The promise resolves once the planner has loaded the result, with the affected groups in the shape and the placement frame of
3691
+ * the plan context, and rejects with the reason when the payload is invalid or the operation cannot be performed.
3627
3692
  * @param command The operation.
3628
3693
  * @param payload The payload of the operation.
3629
3694
  */
3630
3695
  externalObjectGroupOperation<C extends HiGroupOperation>(command: C, payload: HiGroupOperationPayloads[C]): Promise<HiGroupOperationResult>;
3696
+ externalObjectGroupOperation(command: HiToolCommandName, payload: Record<string, unknown>): Promise<HiToolCommandResult>;
3631
3697
  /**
3632
3698
  * It generates a snapshot of the external object in the plan without saving any data.
3633
3699
  * By default, the snapshot includes order data, room information, the plan XML, GLBs of the complete scene,
3634
3700
  * and only the objects in the scene, as well as perspective images and a top image.
3635
3701
  * The complete XML plan is returned. The assets are returned as base64 strings.
3636
3702
  * The `requestData` parameter can be used to control which parts of the snapshot are generated, returning only requested properties to improve performance. If `requestData` is passed, omitted properties will be `undefined`.
3703
+ * Open doors and drawers are closed for the images and the object GLB unless `requestData.keepOpenGeometry` is true.
3637
3704
  * @param requestData An optional filter object indicating which snapshot properties to generate.
3638
3705
  * @returns the snapshot of the external objects
3639
3706
  */
@@ -3808,6 +3875,11 @@ export declare interface ExternalObjectSnapshotRequest {
3808
3875
  topImage?: boolean;
3809
3876
  perspectiveObjectImage?: boolean;
3810
3877
  topObjectImage?: boolean;
3878
+ /**
3879
+ * If true, the images and the object GLB show the doors and drawers as they are in the planner.
3880
+ * Otherwise open doors and drawers are closed for the snapshot.
3881
+ */
3882
+ keepOpenGeometry?: boolean;
3811
3883
  }
3812
3884
 
3813
3885
  export declare interface ExternalObjectSnapshotSaveResult {
@@ -3860,6 +3932,14 @@ export declare interface ExternalObjectValidContainerModules {
3860
3932
  parentModuleId: string;
3861
3933
  }
3862
3934
 
3935
+ export declare interface ExternalPlanInstallationElement {
3936
+ runtimeId: number;
3937
+ type: ExternalPlanInstallationElementType;
3938
+ position: [number, number, number];
3939
+ }
3940
+
3941
+ export declare type ExternalPlanInstallationElementType = 'ElectricPlug' | 'WaterConnection';
3942
+
3863
3943
  export declare type ExternalPlanObstacleKind = 'group' | 'door' | 'window' | 'object';
3864
3944
 
3865
3945
  export declare interface ExternalPlanObstacles {
@@ -3869,6 +3949,7 @@ export declare interface ExternalPlanObstacles {
3869
3949
  }>;
3870
3950
  obstacles: ExternalPlanObstacleSegment[];
3871
3951
  kinds: Record<number, ExternalPlanObstacleKind>;
3952
+ installationElements?: ExternalPlanInstallationElement[];
3872
3953
  }
3873
3954
 
3874
3955
  export declare interface ExternalPlanObstacleSegment {
@@ -4054,11 +4135,11 @@ export declare class FloorPlanElementViewModel extends PlanElementViewModel {
4054
4135
  }
4055
4136
 
4056
4137
  export declare interface FloorType {
4057
- value: Enumify_2<typeof CORE_FLOOR_TYPE>;
4138
+ value: Enumify_2<typeof CORE_FLOOR_TYPE_2>;
4058
4139
  }
4059
4140
 
4060
4141
  export declare interface FloorType_2 {
4061
- value: Enumify<typeof CORE_FLOOR_TYPE_2>;
4142
+ value: Enumify<typeof CORE_FLOOR_TYPE>;
4062
4143
  }
4063
4144
 
4064
4145
  /**
@@ -4291,8 +4372,8 @@ export declare interface GlueLogic {
4291
4372
  updateProperty(rootModuleId?: string, propertyName?: string, propertyValue?: string | number | boolean): void;
4292
4373
  findValidSubArticles(posGroupIds: string[] | string): PosArticle[];
4293
4374
  getValidContainerModulesForSubArticle(posGroupIds: string[] | string, subArticleId: string): ValidContainerModules[];
4294
- addSubArticle(articleId: string, rootModuleId: string, parentModuleId: string, insertPosition?: number[]): void;
4295
- moveSubArticle(articleId: string, subModuleId: string, rootModuleId: string, parentModuleId: string, insertPosition?: number[]): void;
4375
+ addSubArticle(articleId: string, rootModuleId: string, parentModuleId: string, insertPosition?: number[]): Promise<void>;
4376
+ moveSubArticle(articleId: string, subModuleId: string, rootModuleId: string, parentModuleId: string, insertPosition?: number[]): Promise<void>;
4296
4377
  deleteSubArticles(groupId: string, subModuleId: string[] | string): Promise<void>;
4297
4378
  changedGroupPlanningSituation(changedGroup: ExternalObjectGroup, objectPositionChanged: boolean): Promise<void>;
4298
4379
  changedGroupFromHistory(historyGroup: PosGroup, reloadGroup: boolean): void;
@@ -4305,8 +4386,9 @@ export declare interface GlueLogic {
4305
4386
  newPosDataFromId(id: string): Promise<PosGroup | undefined>;
4306
4387
  createOrReplacePosDataFromArticleLayout(articleLayoutJson: ExternalObjectGroupLayout, layoutType: string, posArticles?: PosArticle[]): Promise<PosGroup | PosGroup[] | undefined>;
4307
4388
  newPosDataFromGroup(posDataJson: PosGroup): Promise<PosGroup>;
4308
- getPlanContext(include?: HiPlanContextSection[]): Promise<HiPlanContext>;
4309
- executeGroupOperation(command: string, payload: unknown): Promise<HiGroupOperationResult>;
4389
+ getPlanContext(include?: HiPlanContextSection[], options?: HiPlanContextOptions): Promise<HiPlanContext>;
4390
+ executeGroupOperation(command: string, payload: unknown): Promise<HiGroupOperationResult | HiToolCommandResult>;
4391
+ getAgentPrompts(): HiAgentPrompts;
4310
4392
  getGroupDataForOrder(options: GetGroupDataForOrderOptions): Promise<HiOrderData | null>;
4311
4393
  getMaterialUrl(materialId: string, groupOrModuleId?: string): string | null;
4312
4394
  }
@@ -4490,6 +4572,12 @@ export declare const HI_CONTEXT_ACTION: {
4490
4572
  * payload type and one handler.
4491
4573
  */
4492
4574
  export declare const HI_GROUP_OPERATION: {
4575
+ readonly ADD_INTERIOR_FITTING: "add-interior-fitting";
4576
+ readonly MOVE_INTERIOR_FITTING: "move-interior-fitting";
4577
+ readonly DELETE_INTERIOR_FITTINGS: "delete-interior-fittings";
4578
+ readonly REPLACE_INTERIOR_FITTING: "replace-interior-fitting";
4579
+ readonly OPEN_OR_CLOSE_GROUP: "open-or-close-group";
4580
+ readonly OPEN_OR_CLOSE_ARTICLE: "open-or-close-article";
4493
4581
  readonly CHANGE_MODULE_ATTRIBUTE: "change-module-attribute";
4494
4582
  readonly CHANGE_GROUP_ATTRIBUTE: "change-group-attribute";
4495
4583
  readonly CHANGE_ATTRIBUTES: "change-attributes";
@@ -4532,6 +4620,35 @@ export declare const HI_PANEL_ACTION: {
4532
4620
  readonly SHOW_ARTICLES: "articles";
4533
4621
  };
4534
4622
 
4623
+ export declare const HI_TOOL_COMMAND: {
4624
+ readonly ADD_INTERIOR_FITTING: "add-interior-fitting";
4625
+ readonly MOVE_INTERIOR_FITTING: "move-interior-fitting";
4626
+ readonly DELETE_INTERIOR_FITTINGS: "delete-interior-fittings";
4627
+ readonly REPLACE_INTERIOR_FITTING: "replace-interior-fitting";
4628
+ readonly OPEN_OR_CLOSE_GROUP: "open-or-close-group";
4629
+ readonly OPEN_OR_CLOSE_ARTICLE: "open-or-close-article";
4630
+ readonly CREATE_OR_REPLACE_GROUPS: "create-or-replace-groups";
4631
+ readonly PLACE_GROUP: "place-group";
4632
+ readonly CHANGE_MODULE_ATTRIBUTE: "change-module-attribute";
4633
+ readonly CHANGE_GROUP_ATTRIBUTE: "change-group-attribute";
4634
+ readonly DELETE_GROUP: "delete-group";
4635
+ readonly DELETE_ARTICLE_IN_PLACE: "delete-article-in-place";
4636
+ readonly DELETE_ARTICLE_AND_COMPACT: "delete-article-and-compact";
4637
+ readonly MERGE_ARTICLE_INTO_GROUP: "merge-article-into-group";
4638
+ readonly EXCHANGE_ROOT_MODULE: "exchange-root-module";
4639
+ readonly INSERT_ARTICLE_INTO_GROUP: "insert-article-into-group";
4640
+ readonly SWAP_ROOT_MODULES: "swap-root-modules";
4641
+ readonly MERGE_GROUPS: "merge-groups";
4642
+ };
4643
+
4644
+ /** The prompts of an AI chat that plans with the HI MCP tools. */
4645
+ export declare interface HiAgentPrompts {
4646
+ /** The system prompt of the chat. */
4647
+ systemPrompt: string;
4648
+ /** The text of a user message that carries an image and no text. */
4649
+ imagePrompt: string;
4650
+ }
4651
+
4535
4652
  export declare interface HiApiOptions extends HomagIntelligenceSubscription {
4536
4653
  om?: HomagIntelligenceSubscription;
4537
4654
  baseUrl?: string;
@@ -4680,6 +4797,36 @@ export declare interface HighlightHelper {
4680
4797
  export declare type HiGroupOperation = (typeof HI_GROUP_OPERATION)[keyof typeof HI_GROUP_OPERATION];
4681
4798
 
4682
4799
  export declare interface HiGroupOperationPayloads {
4800
+ 'add-interior-fitting': {
4801
+ groupId: string;
4802
+ } & Omit<Extract<HiInteriorEdit, {
4803
+ operation: 'add';
4804
+ }>, 'operation'>;
4805
+ 'move-interior-fitting': {
4806
+ groupId: string;
4807
+ } & Omit<Extract<HiInteriorEdit, {
4808
+ operation: 'move';
4809
+ }>, 'operation'>;
4810
+ 'delete-interior-fittings': {
4811
+ groupId: string;
4812
+ } & Omit<Extract<HiInteriorEdit, {
4813
+ operation: 'delete';
4814
+ }>, 'operation'>;
4815
+ 'replace-interior-fitting': {
4816
+ groupId: string;
4817
+ } & Omit<Extract<HiInteriorEdit, {
4818
+ operation: 'replace';
4819
+ }>, 'operation'>;
4820
+ /** Opens or closes the doors and drawers of the group; not a plan change. */
4821
+ 'open-or-close-group': {
4822
+ groupId: string;
4823
+ open: boolean;
4824
+ };
4825
+ /** Opens or closes the doors and drawers of one root module; not a plan change. */
4826
+ 'open-or-close-article': {
4827
+ rootModuleId: string;
4828
+ open: boolean;
4829
+ };
4683
4830
  'change-module-attribute': {
4684
4831
  rootModuleId: string;
4685
4832
  moduleId?: string | null;
@@ -4732,7 +4879,7 @@ export declare interface HiGroupOperationPayloads {
4732
4879
  };
4733
4880
  }
4734
4881
 
4735
- export declare interface HiGroupOperationResult {
4882
+ export declare interface HiGroupOperationResult extends Partial<HiInteriorOutcome> {
4736
4883
  command: HiGroupOperation;
4737
4884
  groups: HiPlanGroup[];
4738
4885
  removedGroupIds: string[];
@@ -4742,6 +4889,80 @@ export declare interface HiGroupOperationResult {
4742
4889
  skippedAttributes?: Array<Omit<HiAttributeChange, 'value'>>;
4743
4890
  }
4744
4891
 
4892
+ export declare interface HiInteriorArticle {
4893
+ articleId: string;
4894
+ libraryId: string;
4895
+ desc?: string;
4896
+ }
4897
+
4898
+ export declare interface HiInteriorDesignOptions {
4899
+ groupId: string;
4900
+ status: 'available' | 'empty' | 'unsupported';
4901
+ fittings: Array<HiInteriorFitting & {
4902
+ replacementArticles?: HiInteriorArticle[];
4903
+ }>;
4904
+ articles: Array<HiInteriorArticle & {
4905
+ destinations: HiInteriorDestination[];
4906
+ }>;
4907
+ }
4908
+
4909
+ export declare type HiInteriorDestination = ExternalObjectValidContainerModules;
4910
+
4911
+ export declare type HiInteriorEdit = {
4912
+ operation: 'add';
4913
+ articleId: string;
4914
+ destination: HiInteriorDestination;
4915
+ insertPosition?: HiInteriorPoint;
4916
+ } | {
4917
+ operation: 'move';
4918
+ instanceId: string;
4919
+ destination?: HiInteriorDestination;
4920
+ insertPosition?: HiInteriorPoint;
4921
+ } | {
4922
+ operation: 'delete';
4923
+ instanceIds: string[];
4924
+ } | {
4925
+ operation: 'replace';
4926
+ instanceId: string;
4927
+ articleId: string;
4928
+ insertPosition?: HiInteriorPoint;
4929
+ };
4930
+
4931
+ export declare interface HiInteriorFitting {
4932
+ instanceId: string;
4933
+ groupId: string;
4934
+ rootId: string;
4935
+ parentModuleId: string;
4936
+ ancestorModuleIds: string[];
4937
+ articleId: string;
4938
+ libraryId: string;
4939
+ name: string;
4940
+ articleName?: string;
4941
+ desc?: string;
4942
+ position?: HiInteriorPoint;
4943
+ attributes: Array<{
4944
+ id: string;
4945
+ value?: string | number | boolean;
4946
+ }>;
4947
+ }
4948
+
4949
+ export declare interface HiInteriorOutcome {
4950
+ changed: boolean;
4951
+ addedInstanceIds: string[];
4952
+ removedInstanceIds: string[];
4953
+ fittings: HiInteriorFitting[];
4954
+ corrections: string[];
4955
+ }
4956
+
4957
+ export declare type HiInteriorPoint = [number, number, number];
4958
+
4959
+ export declare interface HiInteriorScope {
4960
+ groupId: string;
4961
+ rootId?: string;
4962
+ containerModuleId?: string;
4963
+ articleId?: string;
4964
+ }
4965
+
4745
4966
  export declare type HiLoadObjectReason = (typeof HI_LOAD_OBJECT_REASON)[keyof typeof HI_LOAD_OBJECT_REASON];
4746
4967
 
4747
4968
  export declare interface HiObjectSelectionApi {
@@ -4838,11 +5059,13 @@ export declare interface HiPlanAttribute {
4838
5059
  }
4839
5060
 
4840
5061
  export declare interface HiPlanContext {
5062
+ interiorDesign?: HiInteriorDesignOptions;
4841
5063
  masterData?: Record<string, HiPlanMasterData>;
4842
5064
  rooms?: HiPlanRoomInformation;
4843
5065
  articles?: HiPlanArticle[];
4844
5066
  groups?: HiPlanGroup[];
4845
5067
  obstacles?: HiPlanObstacles;
5068
+ installationElements?: HiPlanInstallationElement[];
4846
5069
  }
4847
5070
 
4848
5071
  export declare interface HiPlanContextData {
@@ -4852,7 +5075,17 @@ export declare interface HiPlanContextData {
4852
5075
  }>;
4853
5076
  }
4854
5077
 
4855
- export declare type HiPlanContextSection = 'masterData' | 'rooms' | 'articles' | 'groups' | 'obstacles';
5078
+ export declare interface HiPlanContextOptions {
5079
+ interiorDesign?: HiInteriorScope;
5080
+ /**
5081
+ * Only these articles get their docking vectors and corner point from a
5082
+ * template calculated outside the plan when no root module of theirs is in
5083
+ * the plan. Without it, every article that lacks that geometry does.
5084
+ */
5085
+ articleIds?: string[];
5086
+ }
5087
+
5088
+ export declare type HiPlanContextSection = 'masterData' | 'rooms' | 'articles' | 'groups' | 'obstacles' | 'installationElements' | 'interiorDesign';
4856
5089
 
4857
5090
  export declare interface HiPlanContour {
4858
5091
  level: number;
@@ -4883,6 +5116,7 @@ export declare interface HiPlanFootprint {
4883
5116
  }
4884
5117
 
4885
5118
  export declare interface HiPlanGroup {
5119
+ interiorFittings?: HiInteriorFitting[];
4886
5120
  id: string;
4887
5121
  libraryId?: string;
4888
5122
  position: HiPlanGroupPosition;
@@ -4899,6 +5133,12 @@ export declare interface HiPlanGroupPosition {
4899
5133
  pos?: number[];
4900
5134
  rotationY?: number;
4901
5135
  footprint?: HiPlanFootprint;
5136
+ rootId?: string;
5137
+ }
5138
+
5139
+ export declare interface HiPlanInstallationElement {
5140
+ type: ExternalPlanInstallationElementType;
5141
+ position: [number, number, number];
4902
5142
  }
4903
5143
 
4904
5144
  export declare interface HiPlanMasterData {
@@ -4962,6 +5202,7 @@ export declare interface HiPlanRoot {
4962
5202
  id: string;
4963
5203
  imageUrl?: string;
4964
5204
  }>;
5205
+ rowIndex?: number;
4965
5206
  }
4966
5207
 
4967
5208
  export declare interface HiPlanRootAttribute {
@@ -5013,6 +5254,46 @@ export declare class HiTagCatalogCallbacks implements Context {
5013
5254
  private _processedArticles;
5014
5255
  }
5015
5256
 
5257
+ export declare type HiToolCommandName = (typeof HI_TOOL_COMMAND)[keyof typeof HI_TOOL_COMMAND];
5258
+
5259
+ /**
5260
+ * The answer of a tool command: the result of its tool - a tool named like a
5261
+ * group operation answers as the operation does, with what the tool adds -
5262
+ * and the undo steps it put on the planner's history with the follow-up
5263
+ * reloads they cause. A tool that fails after it changed the plan answers
5264
+ * with its error and those steps only; one that fails before rejects.
5265
+ */
5266
+ export declare interface HiToolCommandResult extends Partial<HiInteriorOutcome> {
5267
+ error?: string;
5268
+ command?: string;
5269
+ groups?: HiPlanGroup[];
5270
+ group?: HiPlanGroup;
5271
+ removedGroupIds?: string[];
5272
+ otherGroupIds?: string[];
5273
+ changedModuleIds?: string[];
5274
+ corrections?: string[];
5275
+ hint?: string;
5276
+ loaded?: Array<{
5277
+ id: string;
5278
+ }>;
5279
+ groupAttributes?: Array<{
5280
+ index: number;
5281
+ id: string;
5282
+ set: string[];
5283
+ notCarried?: string[];
5284
+ }>;
5285
+ notLoaded?: Array<{
5286
+ index: number;
5287
+ id?: string;
5288
+ rootIds?: string[];
5289
+ errors: string[];
5290
+ }>;
5291
+ placedIn?: 'corner' | 'wall';
5292
+ wall?: HiPlanWall;
5293
+ gapClosed?: boolean;
5294
+ historySteps: number;
5295
+ }
5296
+
5016
5297
  export declare class HomagIntelligence {
5017
5298
  private _roomlePlanner;
5018
5299
  private _api;
@@ -5140,6 +5421,11 @@ export declare class ImageRenderer implements Context {
5140
5421
  updateBounds(bounds: Box3): Promise<void>;
5141
5422
  static getCameraTargetForBBox(bbox: Box3, spacing?: number): CameraTarget;
5142
5423
  preparePerspectiveImage(scene: Scene, camera: PerspectiveCamera, cameraTarget?: CameraTarget, options?: PrepareImageOptions, onBeforeRender?: (camera: Camera) => void): Promise<Base64Image>;
5424
+ /**
5425
+ * The scene from `camera` as it stands, at width × height, as a JPEG data
5426
+ * URL; helpers (UI, previews, dimensions, gizmos) are left out
5427
+ */
5428
+ renderCameraImage(scene: Scene, camera: Camera, width: number, height: number, quality: number): Promise<string>;
5143
5429
  protected _getRenderSize(options: PrepareImageOptions): {
5144
5430
  width: number;
5145
5431
  height: number;
@@ -5154,7 +5440,8 @@ export declare class ImageRenderer implements Context {
5154
5440
  protected _renderImageFrame(renderInstance: GenericRoomleRenderer | WebGLRenderer | WebGPURenderer, scene: Scene, camera: Camera, options?: PrepareImageOptions): Promise<ImageFrame>;
5155
5441
  protected _getThreejsRenderer(renderInstance: GenericRoomleRenderer | WebGLRenderer | WebGPURenderer): WebGLRenderer | WebGPURenderer;
5156
5442
  protected _renderSingleFrame(renderInstance: GenericRoomleRenderer | WebGLRenderer | WebGPURenderer, scene: Scene, camera: Camera, options?: PrepareImageOptions): void;
5157
- protected _readFrameAndClear(renderer: WebGLRenderer | WebGPURenderer, _options?: PrepareImageOptions): Promise<ImageFrame>;
5443
+ /** `type` and `quality` as for HTMLCanvasElement.toDataURL, PNG by default */
5444
+ protected _readFrameAndClear(renderer: WebGLRenderer | WebGPURenderer, _options?: PrepareImageOptions, type?: string, quality?: number): Promise<ImageFrame>;
5158
5445
  }
5159
5446
 
5160
5447
  export declare class InitData implements Context, Omit<InitDataDefinition, 'colors'> {
@@ -5400,6 +5687,8 @@ export declare const enum INTERSECTION_MODE {
5400
5687
  CONFIGURATOR = 1
5401
5688
  }
5402
5689
 
5690
+ export declare const isDeletedInvisibleWall: (wall: KernelWall) => boolean;
5691
+
5403
5692
  export declare const isExternalObject: (someThing: unknown) => someThing is ExternalObject;
5404
5693
 
5405
5694
  export declare const isExtObjId: (id: unknown) => id is ExtObjId;
@@ -5502,6 +5791,8 @@ export declare interface Kernel {
5502
5791
  getChildrenOfPlanComponent(planComponentId: number, onlyPossibleChildren: boolean, onlyVisibleChildren: boolean): PossibleChildArray_2;
5503
5792
  syncPlanObjectToView(conversationId: number, planObjectId: number): void;
5504
5793
  getAddOnSpotsForPlanObject(planObjectId: number): AddOnSpotArray_2;
5794
+ getDockPairs(targetObjectId: number, dockingEntity: any, allowInsertInBetween: boolean): DockPairPreviewArray_2;
5795
+ dockNewComponent(targetObjectId: number, dockingEntity: any, dockPair: any): number;
5505
5796
  setExternalMeshInvalid(assetType: AssetType_2, idOrUrl: string, quality: number): void;
5506
5797
  setAssetInvalid(assetType: AssetType_2, idOrUrl: string, quality: number): void;
5507
5798
  loadExternalAttributeDefinition(serializedDefinition: string): void;
@@ -6047,6 +6338,7 @@ export declare interface LeftOrRightWallSide {
6047
6338
  }
6048
6339
 
6049
6340
  export declare interface LibraryData {
6341
+ supportsInteriorDesign?: boolean;
6050
6342
  libraryId: string;
6051
6343
  get masterData(): MasterData | null;
6052
6344
  get posGroupVersion(): number;
@@ -7206,6 +7498,7 @@ export declare interface PlanInteractionHandler_2 {
7206
7498
  setAtticSide(attic: Attic, side: WallSide_2): void;
7207
7499
  setAtticKneeHeight(attic: Attic, kneeHeight: number): void;
7208
7500
  setAtticWidth(attic: Attic, width: number): void;
7501
+ setAtticCurved(attic: Attic, curved: boolean): void;
7209
7502
  setFloorMaterial(floor: Floor_2, material: FloorMaterial_2): void;
7210
7503
  setFloorMaterialRotation(floor: Floor_2, rotationInRad: number): void;
7211
7504
  setFloorMaterialUvScale(floor: Floor_2, uvScale: Vector3): void;
@@ -7671,7 +7964,7 @@ export declare interface PlannerKernelContainer {
7671
7964
  StringArray: StringArray;
7672
7965
  Vector2fArray: Vector2fArray;
7673
7966
  LongArray: LongArray_2;
7674
- DockPairPreviewArray: DockPairPreviewArray_2;
7967
+ DockPairPreviewArray: DockPairPreviewArray_3;
7675
7968
  ComponentArray: ComponentArray_2;
7676
7969
  Type: Type_2;
7677
7970
  UnitType: UnitType_2;
@@ -7822,6 +8115,7 @@ export declare class PlannerSceneEventHandler extends SceneEventHandler<SceneEve
7822
8115
  private _dragMeasurementLine;
7823
8116
  setMeasurementLineLength(measurementLine: MeasurementLinePlanElementViewModel, targetLengthMM: number, direction: string): void;
7824
8117
  switchCameraMode(): void;
8118
+ private _isHiddenWallRaycastObject;
7825
8119
  }
7826
8120
 
7827
8121
  export declare class PlannerSceneManager extends ConfiguratorSceneManager implements PlannerKernelCallbackI {
@@ -7995,6 +8289,16 @@ export declare class PlannerSceneManager extends ConfiguratorSceneManager implem
7995
8289
  deletePlanElements(runtimeIds: RuntimeId[]): Promise<void>;
7996
8290
  deletePlanElementSelection(): Promise<void>;
7997
8291
  deletePlanElementByIds(runtimeIds: number[]): Promise<void>;
8292
+ private _deletePlanElementByIds;
8293
+ private _deleteRoomFloors;
8294
+ private _removePlanElementIfPresent;
8295
+ private _removeConstructionsAttachedToWall;
8296
+ private _handleRoomWallDeletion;
8297
+ private _getAttachedRoomFloors;
8298
+ private _wallNeedsToStayForAnyRoom;
8299
+ private _convertWallToInvisible;
8300
+ private _removePlanElementViewModel;
8301
+ private _notifyRemovedPlanElementChanges;
7998
8302
  rotatePlanElements(ids: RuntimeId[], rotateBy: number): void;
7999
8303
  rotatePlanElementSelection(rotateBy: number): void;
8000
8304
  planBoundsChanged(): void;
@@ -8004,6 +8308,20 @@ export declare class PlannerSceneManager extends ConfiguratorSceneManager implem
8004
8308
  preparePerspectiveImageOf(runtimeId: RuntimeId, options?: PrepareImageOptions): Promise<Base64Image>;
8005
8309
  protected _waitForAssets(): Promise<void>;
8006
8310
  private _preparePerspectiveImage;
8311
+ /**
8312
+ * Runs `capture` with the scene as the first-person view shows it (3D
8313
+ * geometry, all walls, the ceiling) while the canvas keeps showing the
8314
+ * current view, e.g. to render a photo camera with renderCameraImage and
8315
+ * measure what it sees. Drawing pauses until the view's state is restored.
8316
+ * Interim: the pause goes once the measurements no longer depend on the
8317
+ * scene's view state.
8318
+ */
8319
+ withEyeLevelScene<T>(capture: () => Promise<T>): Promise<T>;
8320
+ /**
8321
+ * The scene from `camera` at width × height as a JPEG data URL, rendered
8322
+ * off-screen; see withEyeLevelScene for the first-person state
8323
+ */
8324
+ renderCameraImage(camera: PerspectiveCamera, width: number, height: number, quality?: number): Promise<string>;
8007
8325
  prepareThumbnailImage(options: PrepareImageOptionsPlanner): Promise<Base64Image>;
8008
8326
  private _handlePlannerIsolationModeState;
8009
8327
  private _hideAllExceptSelectedElement;
@@ -8161,6 +8479,43 @@ export declare class PlannerSceneManager extends ConfiguratorSceneManager implem
8161
8479
  getExternalSubArticles(id: number): PosArticle[];
8162
8480
  }
8163
8481
 
8482
+ /**
8483
+ * One part of the output of the host's planning agent for the AI Planning Assistant window:
8484
+ * - "text": a piece of the answer of the running turn, markdown, appended to the answer
8485
+ * - "activity": what the agent does now, e.g. the tool it runs, shown in the status line
8486
+ * - "error": the turn failed; the text replaces the answer of the turn and ends the turn
8487
+ * - "done": the turn is complete; the input is free again
8488
+ * - "availability": the input on or off, with the reason shown in the status line; off until the host enables it
8489
+ * - "images": the image drop on or off; off until the host enables it
8490
+ */
8491
+ export declare type PlanningAssistantOutput = {
8492
+ type: 'text';
8493
+ text: string;
8494
+ } | {
8495
+ type: 'activity';
8496
+ text: string;
8497
+ } | {
8498
+ type: 'error';
8499
+ text: string;
8500
+ } | {
8501
+ type: 'done';
8502
+ } | {
8503
+ type: 'availability';
8504
+ available: boolean;
8505
+ text?: string;
8506
+ } | {
8507
+ type: 'images';
8508
+ enabled: boolean;
8509
+ };
8510
+
8511
+ /** The message the user sends in the AI Planning Assistant window. */
8512
+ export declare interface PlanningAssistantPrompt {
8513
+ /** What the user typed, trimmed; empty when the user sends only an image. */
8514
+ text: string;
8515
+ /** The images of the message as JPEG data URLs: the long side at most 1568 px, EXIF rotation applied, transparent parts white. */
8516
+ images: string[];
8517
+ }
8518
+
8164
8519
  export declare interface PlanNode extends KernelObject {
8165
8520
  readonly nodeType: NodeType;
8166
8521
  getMaxWallHeight(): number;
@@ -8738,6 +9093,7 @@ export declare interface PosModuleAttribute {
8738
9093
  }
8739
9094
 
8740
9095
  export declare interface PosModuleData {
9096
+ positionRelativeToRoot?: number[];
8741
9097
  id: string;
8742
9098
  name: string;
8743
9099
  modules?: PosModuleData[];
@@ -9766,13 +10122,14 @@ export declare class RoomDesignerApi implements RoomDesignerRequests {
9766
10122
  selectGroup(groupId: string): Promise<void>;
9767
10123
  selectRoot(rootModuleId: string): Promise<void>;
9768
10124
  selectModule(rootModuleId: string, subModuleId: string): Promise<void>;
9769
- openCloseGroup(groupOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): Promise<void>;
10125
+ openCloseGroup(groupOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): Promise<boolean>;
9770
10126
  deleteGroup(groupId: string): Promise<void>;
9771
10127
  deleteRootModule(rootModuleId: string): Promise<void>;
9772
10128
  mergeGroups(groupIds: string[]): Promise<void>;
9773
10129
  getPosDataOfAllGroups(): Promise<PosGroup[]>;
9774
10130
  getRoomInformation(mode?: PlanRoomGeometryMode): Promise<ExternalRoomInformation>;
9775
10131
  getPlanObstacles(): Promise<ExternalPlanObstacles>;
10132
+ private _gatherInstallationElements;
9776
10133
  saveExternalObjectSnapshot(): Promise<ExternalObjectSnapshotSaveResult | null>;
9777
10134
  saveCurrentPlanSnapshot(): Promise<RapiPlanSnapshotGetData>;
9778
10135
  renderPosDataImage(posDataJson: object): Promise<void>;
@@ -9785,7 +10142,7 @@ export declare interface RoomDesignerRequests {
9785
10142
  selectGroup(groupId: string): Promise<void>;
9786
10143
  selectRoot(rootModuleId: string): Promise<void>;
9787
10144
  selectModule(rootModuleId: string, subModuleId: string): Promise<void>;
9788
- openCloseGroup(groupOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): void;
10145
+ openCloseGroup(groupOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): Promise<boolean>;
9789
10146
  deleteGroup(groupId: string): Promise<void>;
9790
10147
  deleteRootModule(rootModuleId: string): Promise<void>;
9791
10148
  mergeGroups(groupIds: string[]): Promise<void>;
@@ -10484,6 +10841,12 @@ export declare class RoomleConfigurator<P extends readonly PluginName[] = readon
10484
10841
  * only possible if undo was called before
10485
10842
  */
10486
10843
  redo(): Promise<void>;
10844
+ /**
10845
+ * Shows the output of the host's agent in the AI Planning Assistant window
10846
+ * (featureFlags.planningAssistant), one part per call; the window sends the user's messages
10847
+ * with the callback "onPlanningAssistantPrompt".
10848
+ */
10849
+ planningAssistantOutput(part: PlanningAssistantOutput): Promise<void>;
10487
10850
  /**
10488
10851
  * clears current configurator history
10489
10852
  */
@@ -11273,11 +11636,19 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
11273
11636
  removeExternalObject(groupOrRootModuleId: string): Promise<void>;
11274
11637
  selectExternalObject(groupOrRootModuleId: string, subModuleId: string | null, contextAction: HiContextAction): Promise<void>;
11275
11638
  highlightExternalObject(groupOrRootModuleId: string, subModuleId: string | null): Promise<void>;
11276
- openOrCloseGeometryOfExternalObject(groupIdOrRootModuleId: string, _subModuleId: string | null, open: boolean, animate: boolean): void;
11639
+ openOrCloseGeometryOfExternalObject(groupIdOrRootModuleId: string, _subModuleId: string | null, open: boolean, animate: boolean): boolean;
11277
11640
  _selectExternalObjectGroup(groupId: string, switchToPlanner: boolean): Promise<void>;
11278
11641
  getExternalObjectGroups(): Promise<object[]>;
11279
- getExternalObjectPlanContext(include?: HiPlanContextSection[]): Promise<HiPlanContext>;
11642
+ getExternalObjectPlanContext(include?: HiPlanContextSection[], options?: HiPlanContextOptions): Promise<HiPlanContext>;
11643
+ getExternalObjectAgentPrompts(): Promise<HiAgentPrompts>;
11644
+ /**
11645
+ * Shows the output of the host's planning agent in the AI Planning Assistant window
11646
+ * (featureFlags.planningAssistant), one part per call; the window sends the user's messages
11647
+ * with the callback "onPlanningAssistantPrompt".
11648
+ */
11649
+ planningAssistantOutput(part: PlanningAssistantOutput): Promise<void>;
11280
11650
  externalObjectGroupOperation<C extends HiGroupOperation>(command: C, payload: HiGroupOperationPayloads[C]): Promise<HiGroupOperationResult>;
11651
+ externalObjectGroupOperation(command: HiToolCommandName, payload: Record<string, unknown>): Promise<HiToolCommandResult>;
11281
11652
  getExternalRoomInformation(mode?: PlanRoomGeometryMode): Promise<ExternalRoomInformation>;
11282
11653
  _getExternalPlanObstacles(): Promise<ExternalPlanObstacles>;
11283
11654
  private _planObstacleKind;
@@ -11885,6 +12256,14 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
11885
12256
  private _renderLoopFunctionApplied;
11886
12257
  protected _renderListener: (() => void) | null;
11887
12258
  protected _stopRendering: boolean;
12259
+ /**
12260
+ * While set, the render loop skips its frames and the canvas keeps its last
12261
+ * frame, so the scene can be changed for an off-screen capture without the
12262
+ * user seeing it. Interim, used only by PlannerSceneManager.withEyeLevelScene
12263
+ * through _pauseDrawing and _resumeDrawing: remove all three once the
12264
+ * capture no longer needs the scene in another view's state.
12265
+ */
12266
+ private _drawingPaused;
11888
12267
  protected _roomleRenderer: GenericRoomleRenderer | null;
11889
12268
  private _roomleRendererReady;
11890
12269
  protected _sceneSetupReady: AsyncGuard<void>;
@@ -11927,6 +12306,14 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
11927
12306
  * Start render loop and update everything (AA, AO, Shadows, etc)
11928
12307
  * @private
11929
12308
  */
12309
+ /**
12310
+ * See _drawingPaused; applies a pending render-loop function first, which
12311
+ * would otherwise wait for a frame that does not come
12312
+ */
12313
+ protected _pauseDrawing(): void;
12314
+ private _applyRenderLoopFunction;
12315
+ /** See _drawingPaused; the next frame redraws everything */
12316
+ protected _resumeDrawing(): void;
11930
12317
  protected _renderEverything(): void;
11931
12318
  /**
11932
12319
  * Start render loop and render the scene but keep shadows and AO, needed for material changes
@@ -12421,6 +12808,16 @@ export declare class UiCallback implements Context {
12421
12808
  * is called the scene is ready for rendering it as an image
12422
12809
  */
12423
12810
  onReadyForRender: () => void;
12811
+ /**
12812
+ * is called when the user sends a message in the AI Planning Assistant window; the host runs its
12813
+ * agent with it and passes the agent's output to "planningAssistantOutput"
12814
+ */
12815
+ onPlanningAssistantPrompt: (prompt: PlanningAssistantPrompt) => void;
12816
+ /**
12817
+ * is called by "planningAssistantOutput" with each part of the agent's output; the AI Planning
12818
+ * Assistant window shows it. Not forwarded to the host of an embedding.
12819
+ */
12820
+ onPlanningAssistantOutput: (part: PlanningAssistantOutput) => void;
12424
12821
  }
12425
12822
 
12426
12823
  export declare interface UIComponentInfo {
@@ -12512,6 +12909,9 @@ export declare class UndoRedoHandler {
12512
12909
  cancelDrawing(): void;
12513
12910
  private _hold;
12514
12911
  private _release;
12912
+ private _toolCall;
12913
+ runToolCall<T>(perform: () => Promise<T>): Promise<T>;
12914
+ private _holdToolCallStep;
12515
12915
  manageExternalObjectLoadingStart(reason?: string): void;
12516
12916
  resumeExternalObjectLoading(reason?: string): void;
12517
12917
  manageExternalObjectLoadingEnd(shouldEnd?: boolean): void;
@@ -12894,7 +13294,8 @@ export declare class WallPlanElementViewModel extends PlanElementViewModel {
12894
13294
  private _addThinLineForInvisibleWall;
12895
13295
  private _updateThinLine;
12896
13296
  private _removeThinLineForInvisibleWall;
12897
- private _applyFenceContourLineVisibility;
13297
+ private _applyInvisibleWallLineVisibility;
13298
+ isDeleted(): boolean;
12898
13299
  update(): void;
12899
13300
  }
12900
13301