@roomle/web-sdk 6.0.0-alpha.3 → 6.0.0-alpha.4

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 (51) hide show
  1. package/lib/ConfiguratorKernel.wasm +0 -0
  2. package/lib/RoomleCore.wasm +0 -0
  3. package/lib/RoomleToolsCore.wasm +0 -0
  4. package/lib/{api-CfHIG8XG.mjs → api-rniFBA-W.mjs} +2 -2
  5. package/lib/{api-CfHIG8XG.mjs.map → api-rniFBA-W.mjs.map} +1 -1
  6. package/lib/{asset-loader.worker-CE4O0JU-.mjs → asset-loader.worker-Ct8sEbaT.mjs} +1 -1
  7. package/lib/{asset-loader.worker-CE4O0JU-.mjs.map → asset-loader.worker-Ct8sEbaT.mjs.map} +1 -1
  8. package/lib/{budgeteer.sw-yR2xApHT.mjs → budgeteer.sw-C1IOfc0T.mjs} +1 -1
  9. package/lib/{budgeteer.sw-yR2xApHT.mjs.map → budgeteer.sw-C1IOfc0T.mjs.map} +1 -1
  10. package/lib/configurator-CrCPVj-F.mjs +2 -0
  11. package/lib/{configurator-vJ5idG1h.mjs → configurator-xn7jpBZU.mjs} +3 -3
  12. package/lib/{configurator-vJ5idG1h.mjs.map → configurator-xn7jpBZU.mjs.map} +1 -1
  13. package/lib/{continuous-drawing-helper-BPe83b9-.mjs → continuous-drawing-helper-LPDWkQn5.mjs} +1 -1
  14. package/lib/{continuous-drawing-helper-BPe83b9-.mjs.map → continuous-drawing-helper-LPDWkQn5.mjs.map} +1 -1
  15. package/lib/{glb-viewer-C2U_66OO.mjs → glb-viewer-DQW1uEae.mjs} +3 -3
  16. package/lib/{glb-viewer-C2U_66OO.mjs.map → glb-viewer-DQW1uEae.mjs.map} +1 -1
  17. package/lib/glb-viewer-saf-p1k1.mjs +2 -0
  18. package/lib/hi-mcp-server-Bfxxay_N.mjs +5301 -0
  19. package/lib/hi-mcp-server-Bfxxay_N.mjs.map +1 -0
  20. package/lib/{homag-intelligence-CzTJI_Bo.mjs → homag-intelligence-H-BzewMH.mjs} +14 -3
  21. package/lib/homag-intelligence-H-BzewMH.mjs.map +1 -0
  22. package/lib/{material-viewer-1TdW2e5Q.mjs → material-viewer-CxuGhB8b.mjs} +3 -3
  23. package/lib/{material-viewer-1TdW2e5Q.mjs.map → material-viewer-CxuGhB8b.mjs.map} +1 -1
  24. package/lib/{packages-DbCxjl5Y.mjs → packages-DXTmm5eH.mjs} +5 -5
  25. package/lib/{packages-DbCxjl5Y.mjs.map → packages-DXTmm5eH.mjs.map} +1 -1
  26. package/lib/planner-CExgNxbp.mjs +2 -0
  27. package/lib/{planner-BWxMYEwu.mjs → planner-r-BVyJyI.mjs} +3 -3
  28. package/lib/{planner-BWxMYEwu.mjs.map → planner-r-BVyJyI.mjs.map} +1 -1
  29. package/lib/roomle-headless.d.ts +95 -9
  30. package/lib/roomle-headless.js +7 -7
  31. package/lib/{roomle-sdk-BIGMLwuJ.mjs → roomle-sdk-BIIJRe32.mjs} +2938 -2687
  32. package/lib/roomle-sdk-BIIJRe32.mjs.map +1 -0
  33. package/lib/roomle-sdk.d.ts +95 -9
  34. package/lib/roomle-sdk.js +6 -6
  35. package/lib/{script-loader-DOhxnpYD.mjs → script-loader-BVBVh2F_.mjs} +2 -2
  36. package/lib/{script-loader-DOhxnpYD.mjs.map → script-loader-BVBVh2F_.mjs.map} +1 -1
  37. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/package.json +1 -1
  38. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/wasm_modern/ConfiguratorKernel.wasm +0 -0
  39. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/wasm_modern/RoomleCore.wasm +0 -0
  40. package/lib/static/roomle-core-hsc/node_modules/roomle-core-hsc/wasm_modern/RoomleToolsCore.wasm +0 -0
  41. package/lib/{tools-core-DscrDxxP.mjs → tools-core-qoVhVWQJ.mjs} +3 -3
  42. package/lib/{tools-core-DscrDxxP.mjs.map → tools-core-qoVhVWQJ.mjs.map} +1 -1
  43. package/lib/workers-DfusgkFA.mjs +6 -0
  44. package/lib/{workers-B-AqdQMe.mjs.map → workers-DfusgkFA.mjs.map} +1 -1
  45. package/package.json +2 -2
  46. package/lib/configurator-DXd3P_DJ.mjs +0 -2
  47. package/lib/glb-viewer-DiHXOqau.mjs +0 -2
  48. package/lib/homag-intelligence-CzTJI_Bo.mjs.map +0 -1
  49. package/lib/planner-Bwo0xEWJ.mjs +0 -2
  50. package/lib/roomle-sdk-BIGMLwuJ.mjs.map +0 -1
  51. package/lib/workers-B-AqdQMe.mjs +0 -6
@@ -3665,11 +3665,26 @@ export declare interface ExternalObjectAPI {
3665
3665
  * and every root module of a row carries rowIndex, its place in the row from 1 at the left end.
3666
3666
  * The result is designed to be passed to an AI agent as it is, without further preparation,
3667
3667
  * with all geometry in one coordinate system: 3D, right-handed, Y up.
3668
+ * The sections "masterData" and "articles" are deprecated: they are library data, which
3669
+ * "getExternalObjectLibraryContext" returns, and the plan context returns them as that method does.
3668
3670
  * @param include The sections to include. All sections are returned when omitted or empty.
3669
- * @param options articleIds: only these articles get their docking vectors and corner point from a
3670
- * calculated template when they are not in the plan; without it every article that lacks them does.
3671
+ * @param options interiorDesign: the group, and optionally the root module, container or article,
3672
+ * the interior design options are read for; articleIds: deprecated, see "getExternalObjectLibraryContext".
3671
3673
  */
3672
3674
  getExternalObjectPlanContext(include?: HiPlanContextSection[], options?: HiPlanContextOptions): Promise<HiPlanContext>;
3675
+ /**
3676
+ * "getExternalObjectLibraryContext" returns an agent-ready snapshot of the loaded libraries, which
3677
+ * no change of the plan alters: the compacted master data per library (root modules, sub modules
3678
+ * and every attribute), the articles that can be used (compact catalog with dimensions, docking
3679
+ * vectors and sub-modules - the docking vectors and corner point of an article without its own from
3680
+ * its template, calculated outside the plan) and the sub articles that can be installed inside a
3681
+ * root module (articleId, libraryId and description). It changes only when a library or its
3682
+ * article catalog is loaded.
3683
+ * @param include The sections to include. All sections are returned when omitted or empty.
3684
+ * @param options articleIds: only these articles get their docking vectors and corner point from a
3685
+ * calculated template; without it every article that lacks them does.
3686
+ */
3687
+ getExternalObjectLibraryContext(include?: HiLibraryContextSection[], options?: HiLibraryContextOptions): Promise<HiLibraryContext>;
3673
3688
  /**
3674
3689
  * "getExternalObjectAgentPrompts" returns the prompts of an AI chat that plans with the HI tools of
3675
3690
  * the HI MCP server: systemPrompt, the system prompt of the chat, which names the planning skills
@@ -3678,6 +3693,21 @@ export declare interface ExternalObjectAPI {
3678
3693
  * The promise rejects when the planner has no HI module.
3679
3694
  */
3680
3695
  getExternalObjectAgentPrompts(): Promise<HiAgentPrompts>;
3696
+ /**
3697
+ * "getExternalObjectAgentTools" returns the HI agent tools as an MCP server lists them in
3698
+ * tools/list: per tool its name, description and the JSON Schema of its input. An AI agent that
3699
+ * plans with the HI tools takes them as its tools and runs them with "callExternalObjectAgentTool".
3700
+ * The tool code loads on the first call.
3701
+ */
3702
+ getExternalObjectAgentTools(): Promise<HiAgentToolDefinition[]>;
3703
+ /**
3704
+ * "callExternalObjectAgentTool" runs a tool of "getExternalObjectAgentTools" and resolves as an MCP
3705
+ * server answers tools/call, with text and image parts. An invalid input, an unknown tool and a
3706
+ * failed call resolve with isError and the reason as text.
3707
+ * @param name The name of the tool.
3708
+ * @param input The input of the tool.
3709
+ */
3710
+ callExternalObjectAgentTool(name: string, input: unknown): Promise<McpToolResult>;
3681
3711
  /**
3682
3712
  * "externalObjectGroupOperation" changes the groups in the plan by command. The payload refers to
3683
3713
  * groups, root modules and articles by the ids of "getExternalObjectPlanContext":
@@ -4398,6 +4428,7 @@ export declare interface GlueLogic {
4398
4428
  createOrReplacePosDataFromArticleLayout(articleLayoutJson: ExternalObjectGroupLayout, layoutType: string, posArticles?: PosArticle[]): Promise<PosGroup | PosGroup[] | undefined>;
4399
4429
  newPosDataFromGroup(posDataJson: PosGroup): Promise<PosGroup>;
4400
4430
  getPlanContext(include?: HiPlanContextSection[], options?: HiPlanContextOptions): Promise<HiPlanContext>;
4431
+ getLibraryContext(include?: HiLibraryContextSection[], options?: HiLibraryContextOptions): Promise<HiLibraryContext>;
4401
4432
  executeGroupOperation(command: string, payload: unknown): Promise<HiGroupOperationResult | HiToolCommandResult>;
4402
4433
  getAgentPrompts(): HiAgentPrompts;
4403
4434
  getGroupDataForOrder(options: GetGroupDataForOrderOptions): Promise<HiOrderData | null>;
@@ -4812,6 +4843,13 @@ export declare interface HiAgentPrompts {
4812
4843
  imagePrompt: string;
4813
4844
  }
4814
4845
 
4846
+ /** A tool of the HI agent tools as an MCP server lists it in `tools/list`: its input schema is a JSON Schema. */
4847
+ export declare interface HiAgentToolDefinition {
4848
+ name: string;
4849
+ description: string;
4850
+ inputSchema: Record<string, unknown>;
4851
+ }
4852
+
4815
4853
  export declare interface HiApiOptions extends HomagIntelligenceSubscription {
4816
4854
  om?: HomagIntelligenceSubscription;
4817
4855
  baseUrl?: string;
@@ -5126,6 +5164,23 @@ export declare interface HiInteriorScope {
5126
5164
  articleId?: string;
5127
5165
  }
5128
5166
 
5167
+ export declare interface HiLibraryContext {
5168
+ masterData?: Record<string, HiPlanMasterData>;
5169
+ articles?: HiPlanArticle[];
5170
+ subArticles?: HiInteriorArticle[];
5171
+ }
5172
+
5173
+ export declare interface HiLibraryContextOptions {
5174
+ /**
5175
+ * Only these articles get their docking vectors and corner point from a
5176
+ * template calculated outside the plan. Without it, every article that
5177
+ * lacks that geometry does.
5178
+ */
5179
+ articleIds?: string[];
5180
+ }
5181
+
5182
+ export declare type HiLibraryContextSection = 'masterData' | 'articles' | 'subArticles';
5183
+
5129
5184
  export declare type HiLoadObjectReason = (typeof HI_LOAD_OBJECT_REASON)[keyof typeof HI_LOAD_OBJECT_REASON];
5130
5185
 
5131
5186
  export declare interface HiObjectSelectionApi {
@@ -5241,9 +5296,8 @@ export declare interface HiPlanContextData {
5241
5296
  export declare interface HiPlanContextOptions {
5242
5297
  interiorDesign?: HiInteriorScope;
5243
5298
  /**
5244
- * Only these articles get their docking vectors and corner point from a
5245
- * template calculated outside the plan when no root module of theirs is in
5246
- * the plan. Without it, every article that lacks that geometry does.
5299
+ * @deprecated The articles are library data: use "articleIds" of
5300
+ * "getExternalObjectLibraryContext".
5247
5301
  */
5248
5302
  articleIds?: string[];
5249
5303
  }
@@ -5307,6 +5361,7 @@ export declare interface HiPlanInstallationElement {
5307
5361
  export declare interface HiPlanMasterData {
5308
5362
  libraryId: string;
5309
5363
  modules: HiPlanMasterDataModule[];
5364
+ subModules: HiPlanMasterDataModule[];
5310
5365
  attributes: HiPlanAttribute[];
5311
5366
  groupSettings: string[];
5312
5367
  }
@@ -5364,6 +5419,7 @@ export declare interface HiPlanRoot {
5364
5419
  subModules: Array<{
5365
5420
  id: string;
5366
5421
  imageUrl?: string;
5422
+ attributes: HiPlanRootAttribute[];
5367
5423
  }>;
5368
5424
  rowIndex?: number;
5369
5425
  }
@@ -6518,6 +6574,8 @@ export declare interface LibraryData {
6518
6574
  get masterData(): MasterData | null;
6519
6575
  get posGroupVersion(): number;
6520
6576
  initializePosGroup(posGroup: PosGroup): void;
6577
+ solveInitial(posGroup: PosGroup, masterData: MasterData): SolveInitialResult;
6578
+ solveInitialModule(module: PosModuleData, masterData: MasterData, articleId: string): SolveInitialResult;
6521
6579
  calculateGroup(posGroup: PosGroup): PosGroup;
6522
6580
  getOrderData(posGroup: PosGroup[], roomlePlannerId?: string, rooms?: PosContour[]): any;
6523
6581
  getAttributesDropDownValues(module: PosModuleData, attributeIds?: string | string[]): Promise<Record<string, HiAttributeOptionsResult>>;
@@ -6727,6 +6785,19 @@ export declare interface Matrix4 {
6727
6785
 
6728
6786
  export declare type MaybePromise<T> = (() => T) | (() => Promise<T>);
6729
6787
 
6788
+ /** The result of a tool as an MCP server answers `tools/call`. */
6789
+ export declare interface McpToolResult {
6790
+ content: Array<{
6791
+ type: 'text';
6792
+ text: string;
6793
+ } | {
6794
+ type: 'image';
6795
+ data: string;
6796
+ mimeType: string;
6797
+ }>;
6798
+ isError?: boolean;
6799
+ }
6800
+
6730
6801
  /**
6731
6802
  * MD5 hex digest of a string, e.g. the hashed password RapiAccess.signinUser expects
6732
6803
  */
@@ -8078,6 +8149,10 @@ export declare class PlannerKernelAccess extends ConfiguratorKernelAccess {
8078
8149
  protected _externalObjectComponentDeleted(remainingGroupOrGroups: ExternalObjectGroup | ExternalObjectGroup[], deletedRootModuleId: string): void;
8079
8150
  _externalObjectConfigurationDuplicated(duplicatedGroup: ExternalObjectGroup): void;
8080
8151
  loadExternalObjectGroups(load: () => PlanObject[]): Promise<PlanObject[]>;
8152
+ reportedPlanChanges<T>(kernelCall: () => T): {
8153
+ result: T;
8154
+ changes: Array<Promise<void>>;
8155
+ };
8081
8156
  _externalObjectPlanChanged(movedGroup: ExternalObjectGroup, objectPositionChanged: boolean): Promise<void | undefined>;
8082
8157
  _externalObjectConfigurationsMerged(mergedGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], targetRootModuleId: string, mergedWithDragging: boolean): Promise<void>;
8083
8158
  _externalObjectComponentSplitOff(splitGroups: ExternalObjectGroup[]): void;
@@ -8523,7 +8598,8 @@ export declare class PlannerSceneManager extends ConfiguratorSceneManager implem
8523
8598
  withEyeLevelScene<T>(capture: () => Promise<T>): Promise<T>;
8524
8599
  /**
8525
8600
  * The scene from `camera` at width × height as a JPEG data URL, rendered
8526
- * off-screen; see withEyeLevelScene for the first-person state
8601
+ * off-screen once the plan and its materials have loaded, as the scene is
8602
+ * now; see withEyeLevelScene for the first-person state
8527
8603
  */
8528
8604
  renderCameraImage(camera: PerspectiveCamera, width: number, height: number, quality?: number): Promise<string>;
8529
8605
  prepareThumbnailImage(options: PrepareImageOptionsPlanner): Promise<Base64Image>;
@@ -9175,14 +9251,14 @@ export declare type PosDock = 'RightTop' | 'BackTop' | 'LeftTop' | 'RightBottom'
9175
9251
 
9176
9252
  export declare interface PosDockedContext {
9177
9253
  ownDockingVector: PosDock | string;
9178
- ownDockingVectorIndex: number;
9254
+ ownDockingVectorIndex?: number;
9179
9255
  dockedRoots: PosDockedContextRoot[];
9180
9256
  }
9181
9257
 
9182
9258
  export declare interface PosDockedContextRoot {
9183
9259
  id: string;
9184
9260
  dockingVector: PosDock | string;
9185
- dockingVectorIndex: number;
9261
+ dockingVectorIndex?: number;
9186
9262
  mode?: PosDockMode | string;
9187
9263
  offset?: number[];
9188
9264
  }
@@ -11395,6 +11471,7 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
11395
11471
  _creator_: string;
11396
11472
  private _activePlugins;
11397
11473
  private _homagIntelligence;
11474
+ private _hiAgentTools;
11398
11475
  private _configuratorContext;
11399
11476
  private _domHelper;
11400
11477
  private _plannerKernelAccess;
@@ -11844,6 +11921,7 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
11844
11921
  _selectExternalObjectGroup(groupId: string, switchToPlanner: boolean): Promise<void>;
11845
11922
  getExternalObjectGroups(): Promise<object[]>;
11846
11923
  getExternalObjectPlanContext(include?: HiPlanContextSection[], options?: HiPlanContextOptions): Promise<HiPlanContext>;
11924
+ getExternalObjectLibraryContext(include?: HiLibraryContextSection[], options?: HiLibraryContextOptions): Promise<HiLibraryContext>;
11847
11925
  getExternalObjectAgentPrompts(): Promise<HiAgentPrompts>;
11848
11926
  /**
11849
11927
  * Shows the output of the host's planning agent in the AI Planning Assistant window
@@ -11851,6 +11929,9 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
11851
11929
  * with the callback "onPlanningAssistantPrompt".
11852
11930
  */
11853
11931
  planningAssistantOutput(part: PlanningAssistantOutput): Promise<void>;
11932
+ getExternalObjectAgentTools(): Promise<HiAgentToolDefinition[]>;
11933
+ callExternalObjectAgentTool(name: string, input: unknown): Promise<McpToolResult>;
11934
+ private _getHiAgentTools;
11854
11935
  externalObjectGroupOperation<C extends HiGroupOperation>(command: C, payload: HiGroupOperationPayloads[C]): Promise<HiGroupOperationResult>;
11855
11936
  externalObjectGroupOperation(command: HiToolCommandName, payload: Record<string, unknown>): Promise<HiToolCommandResult>;
11856
11937
  getExternalRoomInformation(mode?: PlanRoomGeometryMode): Promise<ExternalRoomInformation>;
@@ -12743,6 +12824,11 @@ export declare interface SnapState {
12743
12824
  value: Enumify<typeof CORE_SNAP_STATE>;
12744
12825
  }
12745
12826
 
12827
+ export declare interface SolveInitialResult {
12828
+ logs: PosErrorMsg[];
12829
+ hasChanged: boolean;
12830
+ }
12831
+
12746
12832
  export declare interface StaticComponent extends RoomleComponent {
12747
12833
  glbUrl: string;
12748
12834
  }
@@ -13143,7 +13229,7 @@ export declare class UndoRedoHandler {
13143
13229
  private _hold;
13144
13230
  private _release;
13145
13231
  private _toolCall;
13146
- runToolCall<T>(perform: () => Promise<T>): Promise<T>;
13232
+ runToolCall<T>(perform: () => Promise<T>, settle?: (commit: () => void) => Promise<unknown>): Promise<T>;
13147
13233
  private _holdToolCallStep;
13148
13234
  manageExternalObjectLoadingStart(reason?: string): void;
13149
13235
  resumeExternalObjectLoading(reason?: string): void;
@@ -1,16 +1,16 @@
1
- import { a as e, i as t, n, r, t as i } from "./packages-DbCxjl5Y.mjs";
1
+ import { a as e, i as t, n, r, t as i } from "./packages-DXTmm5eH.mjs";
2
2
  import { i as a, t as o } from "./kernel-BWfRHWkW.mjs";
3
3
  import { St as s, Tt as c, xt as l } from "./threejs-utils-Dy-rm1a9.mjs";
4
4
  import { Ti as u, m as d, nt as f } from "./three.core-BTUCraWz.mjs";
5
5
  import { i as p } from "./decorate-CjaqqbUP.mjs";
6
6
  import { D as m, H as h, g } from "./common-utils-CNGLvAo_.mjs";
7
- import { A as ee, B as te, F as ne, H as re, I as ie, J as ae, M as oe, N as se, O as _, P as v, V as ce, W as le, X as ue, Y as de, Z as fe, _t as pe, a as me, b as he, ct as ge, dt as _e, ft as ve, i as y, j as b, k as x, l as S, lt as C, m as w, mt as T, o as E, pt as D, q as O, r as k, s as A, t as j, u as M, ut as N, x as P, y as F } from "./roomle-sdk-BIGMLwuJ.mjs";
7
+ import { A as ee, B as te, F as ne, H as re, I as ie, J as ae, M as oe, N as se, O as _, P as v, V as ce, W as le, X as ue, Y as de, Z as fe, _t as pe, a as me, b as he, ct as ge, dt as _e, ft as ve, i as y, j as b, k as x, l as S, lt as C, m as w, mt as T, o as E, pt as D, q as O, r as k, s as A, t as j, u as M, ut as N, x as P, y as F } from "./roomle-sdk-BIIJRe32.mjs";
8
8
  import { n as ye } from "./roomle-renderer-nCUrLU_S.mjs";
9
- import { n as be } from "./script-loader-DOhxnpYD.mjs";
10
- import { t as xe } from "./configurator-vJ5idG1h.mjs";
11
- import { t as Se } from "./planner-BWxMYEwu.mjs";
12
- import { n as Ce, t as we } from "./glb-viewer-C2U_66OO.mjs";
13
- import { t as Te } from "./api-CfHIG8XG.mjs";
9
+ import { n as be } from "./script-loader-BVBVh2F_.mjs";
10
+ import { t as xe } from "./configurator-xn7jpBZU.mjs";
11
+ import { t as Se } from "./planner-r-BVyJyI.mjs";
12
+ import { n as Ce, t as we } from "./glb-viewer-DQW1uEae.mjs";
13
+ import { t as Te } from "./api-rniFBA-W.mjs";
14
14
  import { t as Ee } from "./roomle-headless-setup-bol8UwP_.mjs";
15
15
  import { createRequire as De } from "module";
16
16
  //#region packages/headless-core/src/headless-tween-stub.ts