@carlonicora/nestjs-neo4jsonapi 1.62.7 → 1.63.0

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 (216) hide show
  1. package/dist/agents/agents.modules.d.ts.map +1 -1
  2. package/dist/agents/agents.modules.js +3 -0
  3. package/dist/agents/agents.modules.js.map +1 -1
  4. package/dist/agents/chatbot/chatbot.module.d.ts +3 -0
  5. package/dist/agents/chatbot/chatbot.module.d.ts.map +1 -0
  6. package/dist/agents/chatbot/chatbot.module.js +65 -0
  7. package/dist/agents/chatbot/chatbot.module.js.map +1 -0
  8. package/dist/agents/chatbot/interfaces/chatbot.response.interface.d.ts +25 -0
  9. package/dist/agents/chatbot/interfaces/chatbot.response.interface.d.ts.map +1 -0
  10. package/dist/agents/chatbot/interfaces/chatbot.response.interface.js +3 -0
  11. package/dist/agents/chatbot/interfaces/chatbot.response.interface.js.map +1 -0
  12. package/dist/agents/chatbot/interfaces/graph.catalog.interface.d.ts +50 -0
  13. package/dist/agents/chatbot/interfaces/graph.catalog.interface.d.ts.map +1 -0
  14. package/dist/agents/chatbot/interfaces/graph.catalog.interface.js +3 -0
  15. package/dist/agents/chatbot/interfaces/graph.catalog.interface.js.map +1 -0
  16. package/dist/agents/chatbot/prompts/chatbot.system.prompt.d.ts +3 -0
  17. package/dist/agents/chatbot/prompts/chatbot.system.prompt.d.ts.map +1 -0
  18. package/dist/agents/chatbot/prompts/chatbot.system.prompt.js +60 -0
  19. package/dist/agents/chatbot/prompts/chatbot.system.prompt.js.map +1 -0
  20. package/dist/agents/chatbot/repositories/user-modules.repository.d.ts +28 -0
  21. package/dist/agents/chatbot/repositories/user-modules.repository.d.ts.map +1 -0
  22. package/dist/agents/chatbot/repositories/user-modules.repository.js +76 -0
  23. package/dist/agents/chatbot/repositories/user-modules.repository.js.map +1 -0
  24. package/dist/agents/chatbot/services/chatbot.index.manager.d.ts +17 -0
  25. package/dist/agents/chatbot/services/chatbot.index.manager.d.ts.map +1 -0
  26. package/dist/agents/chatbot/services/chatbot.index.manager.js +84 -0
  27. package/dist/agents/chatbot/services/chatbot.index.manager.js.map +1 -0
  28. package/dist/agents/chatbot/services/chatbot.search.service.d.ts +46 -0
  29. package/dist/agents/chatbot/services/chatbot.search.service.d.ts.map +1 -0
  30. package/dist/agents/chatbot/services/chatbot.search.service.js +148 -0
  31. package/dist/agents/chatbot/services/chatbot.search.service.js.map +1 -0
  32. package/dist/agents/chatbot/services/chatbot.service.d.ts +36 -0
  33. package/dist/agents/chatbot/services/chatbot.service.d.ts.map +1 -0
  34. package/dist/agents/chatbot/services/chatbot.service.js +220 -0
  35. package/dist/agents/chatbot/services/chatbot.service.js.map +1 -0
  36. package/dist/agents/chatbot/services/descriptor.source.d.ts +18 -0
  37. package/dist/agents/chatbot/services/descriptor.source.d.ts.map +1 -0
  38. package/dist/agents/chatbot/services/descriptor.source.js +41 -0
  39. package/dist/agents/chatbot/services/descriptor.source.js.map +1 -0
  40. package/dist/agents/chatbot/services/field-formatting.d.ts +18 -0
  41. package/dist/agents/chatbot/services/field-formatting.d.ts.map +1 -0
  42. package/dist/agents/chatbot/services/field-formatting.js +43 -0
  43. package/dist/agents/chatbot/services/field-formatting.js.map +1 -0
  44. package/dist/agents/chatbot/services/graph.catalog.service.d.ts +60 -0
  45. package/dist/agents/chatbot/services/graph.catalog.service.d.ts.map +1 -0
  46. package/dist/agents/chatbot/services/graph.catalog.service.js +217 -0
  47. package/dist/agents/chatbot/services/graph.catalog.service.js.map +1 -0
  48. package/dist/agents/chatbot/services/humanize-tool.d.ts +9 -0
  49. package/dist/agents/chatbot/services/humanize-tool.d.ts.map +1 -0
  50. package/dist/agents/chatbot/services/humanize-tool.js +35 -0
  51. package/dist/agents/chatbot/services/humanize-tool.js.map +1 -0
  52. package/dist/agents/chatbot/tools/describe-entity.tool.d.ts +14 -0
  53. package/dist/agents/chatbot/tools/describe-entity.tool.d.ts.map +1 -0
  54. package/dist/agents/chatbot/tools/describe-entity.tool.js +63 -0
  55. package/dist/agents/chatbot/tools/describe-entity.tool.js.map +1 -0
  56. package/dist/agents/chatbot/tools/read-entity.tool.d.ts +16 -0
  57. package/dist/agents/chatbot/tools/read-entity.tool.d.ts.map +1 -0
  58. package/dist/agents/chatbot/tools/read-entity.tool.js +102 -0
  59. package/dist/agents/chatbot/tools/read-entity.tool.js.map +1 -0
  60. package/dist/agents/chatbot/tools/resolve-entity.tool.d.ts +16 -0
  61. package/dist/agents/chatbot/tools/resolve-entity.tool.d.ts.map +1 -0
  62. package/dist/agents/chatbot/tools/resolve-entity.tool.js +48 -0
  63. package/dist/agents/chatbot/tools/resolve-entity.tool.js.map +1 -0
  64. package/dist/agents/chatbot/tools/search-entities.tool.d.ts +20 -0
  65. package/dist/agents/chatbot/tools/search-entities.tool.d.ts.map +1 -0
  66. package/dist/agents/chatbot/tools/search-entities.tool.js +122 -0
  67. package/dist/agents/chatbot/tools/search-entities.tool.js.map +1 -0
  68. package/dist/agents/chatbot/tools/tool.factory.d.ts +29 -0
  69. package/dist/agents/chatbot/tools/tool.factory.d.ts.map +1 -0
  70. package/dist/agents/chatbot/tools/tool.factory.js +72 -0
  71. package/dist/agents/chatbot/tools/tool.factory.js.map +1 -0
  72. package/dist/agents/chatbot/tools/traverse.tool.d.ts +58 -0
  73. package/dist/agents/chatbot/tools/traverse.tool.d.ts.map +1 -0
  74. package/dist/agents/chatbot/tools/traverse.tool.js +212 -0
  75. package/dist/agents/chatbot/tools/traverse.tool.js.map +1 -0
  76. package/dist/agents/index.d.ts +9 -0
  77. package/dist/agents/index.d.ts.map +1 -1
  78. package/dist/agents/index.js +17 -1
  79. package/dist/agents/index.js.map +1 -1
  80. package/dist/common/helpers/define-entity.d.ts.map +1 -1
  81. package/dist/common/helpers/define-entity.js +5 -1
  82. package/dist/common/helpers/define-entity.js.map +1 -1
  83. package/dist/common/interfaces/datamodel.interface.d.ts +10 -0
  84. package/dist/common/interfaces/datamodel.interface.d.ts.map +1 -1
  85. package/dist/common/interfaces/datamodel.interface.js.map +1 -1
  86. package/dist/common/interfaces/entity.descriptor.interface.d.ts +1 -1
  87. package/dist/common/interfaces/entity.descriptor.interface.d.ts.map +1 -1
  88. package/dist/common/interfaces/entity.descriptor.interface.js.map +1 -1
  89. package/dist/common/interfaces/entity.schema.interface.d.ts +48 -0
  90. package/dist/common/interfaces/entity.schema.interface.d.ts.map +1 -1
  91. package/dist/common/registries/entity.service.registry.d.ts +13 -0
  92. package/dist/common/registries/entity.service.registry.d.ts.map +1 -0
  93. package/dist/common/registries/entity.service.registry.js +52 -0
  94. package/dist/common/registries/entity.service.registry.js.map +1 -0
  95. package/dist/common/registries/index.d.ts +1 -0
  96. package/dist/common/registries/index.d.ts.map +1 -1
  97. package/dist/common/registries/index.js +1 -0
  98. package/dist/common/registries/index.js.map +1 -1
  99. package/dist/core/core.module.d.ts.map +1 -1
  100. package/dist/core/core.module.js +6 -2
  101. package/dist/core/core.module.js.map +1 -1
  102. package/dist/core/llm/services/llm.service.d.ts.map +1 -1
  103. package/dist/core/llm/services/llm.service.js +8 -0
  104. package/dist/core/llm/services/llm.service.js.map +1 -1
  105. package/dist/core/neo4j/abstracts/abstract.repository.d.ts +48 -1
  106. package/dist/core/neo4j/abstracts/abstract.repository.d.ts.map +1 -1
  107. package/dist/core/neo4j/abstracts/abstract.repository.js +147 -9
  108. package/dist/core/neo4j/abstracts/abstract.repository.js.map +1 -1
  109. package/dist/core/neo4j/abstracts/abstract.service.d.ts +47 -0
  110. package/dist/core/neo4j/abstracts/abstract.service.d.ts.map +1 -1
  111. package/dist/core/neo4j/abstracts/abstract.service.js +57 -0
  112. package/dist/core/neo4j/abstracts/abstract.service.js.map +1 -1
  113. package/dist/core/neo4j/factories/entity.factory.d.ts.map +1 -1
  114. package/dist/core/neo4j/factories/entity.factory.js +27 -6
  115. package/dist/core/neo4j/factories/entity.factory.js.map +1 -1
  116. package/dist/core/neo4j/helpers/build-filter-clauses.d.ts +11 -0
  117. package/dist/core/neo4j/helpers/build-filter-clauses.d.ts.map +1 -0
  118. package/dist/core/neo4j/helpers/build-filter-clauses.js +69 -0
  119. package/dist/core/neo4j/helpers/build-filter-clauses.js.map +1 -0
  120. package/dist/core/neo4j/helpers/build-order-by.d.ts +6 -0
  121. package/dist/core/neo4j/helpers/build-order-by.d.ts.map +1 -0
  122. package/dist/core/neo4j/helpers/build-order-by.js +20 -0
  123. package/dist/core/neo4j/helpers/build-order-by.js.map +1 -0
  124. package/dist/core/neo4j/index.d.ts +1 -0
  125. package/dist/core/neo4j/index.d.ts.map +1 -1
  126. package/dist/core/neo4j/index.js +2 -0
  127. package/dist/core/neo4j/index.js.map +1 -1
  128. package/dist/core/neo4j/types/filter.criterion.d.ts +20 -0
  129. package/dist/core/neo4j/types/filter.criterion.d.ts.map +1 -0
  130. package/dist/core/neo4j/types/filter.criterion.js +3 -0
  131. package/dist/core/neo4j/types/filter.criterion.js.map +1 -0
  132. package/dist/core/neo4j/types/index.d.ts +2 -0
  133. package/dist/core/neo4j/types/index.d.ts.map +1 -0
  134. package/dist/core/neo4j/types/index.js +3 -0
  135. package/dist/core/neo4j/types/index.js.map +1 -0
  136. package/dist/foundations/assistant/assistant.module.d.ts +5 -0
  137. package/dist/foundations/assistant/assistant.module.d.ts.map +1 -0
  138. package/dist/foundations/assistant/assistant.module.js +32 -0
  139. package/dist/foundations/assistant/assistant.module.js.map +1 -0
  140. package/dist/foundations/assistant/controllers/assistant.controller.d.ts +67 -0
  141. package/dist/foundations/assistant/controllers/assistant.controller.d.ts.map +1 -0
  142. package/dist/foundations/assistant/controllers/assistant.controller.js +226 -0
  143. package/dist/foundations/assistant/controllers/assistant.controller.js.map +1 -0
  144. package/dist/foundations/assistant/dtos/assistant-append.dto.d.ts +11 -0
  145. package/dist/foundations/assistant/dtos/assistant-append.dto.d.ts.map +1 -0
  146. package/dist/foundations/assistant/dtos/assistant-append.dto.js +44 -0
  147. package/dist/foundations/assistant/dtos/assistant-append.dto.js.map +1 -0
  148. package/dist/foundations/assistant/dtos/assistant-patch.dto.d.ts +12 -0
  149. package/dist/foundations/assistant/dtos/assistant-patch.dto.d.ts.map +1 -0
  150. package/dist/foundations/assistant/dtos/assistant-patch.dto.js +52 -0
  151. package/dist/foundations/assistant/dtos/assistant-patch.dto.js.map +1 -0
  152. package/dist/foundations/assistant/dtos/assistant-post.dto.d.ts +12 -0
  153. package/dist/foundations/assistant/dtos/assistant-post.dto.d.ts.map +1 -0
  154. package/dist/foundations/assistant/dtos/assistant-post.dto.js +51 -0
  155. package/dist/foundations/assistant/dtos/assistant-post.dto.js.map +1 -0
  156. package/dist/foundations/assistant/entities/assistant.d.ts +48 -0
  157. package/dist/foundations/assistant/entities/assistant.d.ts.map +1 -0
  158. package/dist/foundations/assistant/entities/assistant.js +44 -0
  159. package/dist/foundations/assistant/entities/assistant.js.map +1 -0
  160. package/dist/foundations/assistant/entities/assistant.meta.d.ts +3 -0
  161. package/dist/foundations/assistant/entities/assistant.meta.d.ts.map +1 -0
  162. package/dist/foundations/assistant/entities/assistant.meta.js +10 -0
  163. package/dist/foundations/assistant/entities/assistant.meta.js.map +1 -0
  164. package/dist/foundations/assistant/index.d.ts +7 -0
  165. package/dist/foundations/assistant/index.d.ts.map +1 -0
  166. package/dist/foundations/assistant/index.js +12 -0
  167. package/dist/foundations/assistant/index.js.map +1 -0
  168. package/dist/foundations/assistant/repositories/assistant.repository.d.ts +50 -0
  169. package/dist/foundations/assistant/repositories/assistant.repository.d.ts.map +1 -0
  170. package/dist/foundations/assistant/repositories/assistant.repository.js +65 -0
  171. package/dist/foundations/assistant/repositories/assistant.repository.js.map +1 -0
  172. package/dist/foundations/assistant/services/assistant.service.d.ts +113 -0
  173. package/dist/foundations/assistant/services/assistant.service.d.ts.map +1 -0
  174. package/dist/foundations/assistant/services/assistant.service.js +395 -0
  175. package/dist/foundations/assistant/services/assistant.service.js.map +1 -0
  176. package/dist/foundations/assistant-message/assistant-message.module.d.ts +6 -0
  177. package/dist/foundations/assistant-message/assistant-message.module.d.ts.map +1 -0
  178. package/dist/foundations/assistant-message/assistant-message.module.js +36 -0
  179. package/dist/foundations/assistant-message/assistant-message.module.js.map +1 -0
  180. package/dist/foundations/assistant-message/controllers/assistant-message.controller.d.ts +16 -0
  181. package/dist/foundations/assistant-message/controllers/assistant-message.controller.d.ts.map +1 -0
  182. package/dist/foundations/assistant-message/controllers/assistant-message.controller.js +84 -0
  183. package/dist/foundations/assistant-message/controllers/assistant-message.controller.js.map +1 -0
  184. package/dist/foundations/assistant-message/dtos/assistant-message.dto.d.ts +11 -0
  185. package/dist/foundations/assistant-message/dtos/assistant-message.dto.d.ts.map +1 -0
  186. package/dist/foundations/assistant-message/dtos/assistant-message.dto.js +45 -0
  187. package/dist/foundations/assistant-message/dtos/assistant-message.dto.js.map +1 -0
  188. package/dist/foundations/assistant-message/entities/assistant-message.d.ts +49 -0
  189. package/dist/foundations/assistant-message/entities/assistant-message.d.ts.map +1 -0
  190. package/dist/foundations/assistant-message/entities/assistant-message.js +52 -0
  191. package/dist/foundations/assistant-message/entities/assistant-message.js.map +1 -0
  192. package/dist/foundations/assistant-message/entities/assistant-message.meta.d.ts +3 -0
  193. package/dist/foundations/assistant-message/entities/assistant-message.meta.d.ts.map +1 -0
  194. package/dist/foundations/assistant-message/entities/assistant-message.meta.js +10 -0
  195. package/dist/foundations/assistant-message/entities/assistant-message.meta.js.map +1 -0
  196. package/dist/foundations/assistant-message/index.d.ts +8 -0
  197. package/dist/foundations/assistant-message/index.d.ts.map +1 -0
  198. package/dist/foundations/assistant-message/index.js +24 -0
  199. package/dist/foundations/assistant-message/index.js.map +1 -0
  200. package/dist/foundations/assistant-message/repositories/assistant-message.repository.d.ts +70 -0
  201. package/dist/foundations/assistant-message/repositories/assistant-message.repository.d.ts.map +1 -0
  202. package/dist/foundations/assistant-message/repositories/assistant-message.repository.js +119 -0
  203. package/dist/foundations/assistant-message/repositories/assistant-message.repository.js.map +1 -0
  204. package/dist/foundations/assistant-message/services/assistant-message.service.d.ts +31 -0
  205. package/dist/foundations/assistant-message/services/assistant-message.service.d.ts.map +1 -0
  206. package/dist/foundations/assistant-message/services/assistant-message.service.js +32 -0
  207. package/dist/foundations/assistant-message/services/assistant-message.service.js.map +1 -0
  208. package/dist/foundations/foundations.modules.d.ts.map +1 -1
  209. package/dist/foundations/foundations.modules.js +2 -0
  210. package/dist/foundations/foundations.modules.js.map +1 -1
  211. package/dist/foundations/index.d.ts +2 -0
  212. package/dist/foundations/index.d.ts.map +1 -1
  213. package/dist/foundations/index.js +2 -0
  214. package/dist/foundations/index.js.map +1 -1
  215. package/dist/foundations/stripe/__tests__/mocks/stripe.mock.d.ts +62 -62
  216. package/package.json +1 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph.catalog.service.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/services/graph.catalog.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAqC,MAAM,uCAAuC,CAAC;AACzG,OAAO,EAAE,SAAS,EAAE,MAAM,oDAAoD,CAAC;AAe/E;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,IAAI,KAAK,CAAC;QACf,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,SAAS,CAAA;SAAE,CAAC,CAAC;QACjF,aAAa,EAAE,MAAM,CACnB,MAAM,EACN;YACE,KAAK,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAC;gBAAC,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC;YAC7D,SAAS,EAAE,IAAI,GAAG,KAAK,CAAC;YACxB,YAAY,EAAE,MAAM,CAAC;YACrB,WAAW,EAAE,KAAK,GAAG,MAAM,CAAC;YAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,OAAO,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,WAAW,EAAE,MAAM,CAAA;aAAE,CAAC;SACjD,CACF,CAAC;QACF,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC;YAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KACtE,CAAC,CAAC;CACJ;AAED,qBACa,mBAAoB,YAAW,sBAAsB;IAMpD,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAoC;IACpD,2EAA2E;IAC3E,OAAO,CAAC,kBAAkB,CAA6B;gBAE1B,MAAM,EAAE,gBAAgB;IAErD,sBAAsB;IAItB,YAAY,IAAI,IAAI;IA4FpB,OAAO,CAAC,YAAY;IAmCpB,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM;IAqB1C,OAAO,CAAC,iBAAiB;IAiBzB,yBAAyB,IAAI,aAAa,EAAE;IAQ5C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,aAAa,GAAG,IAAI;CAM7E"}
@@ -0,0 +1,217 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ var GraphCatalogService_1;
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ exports.GraphCatalogService = void 0;
14
+ const common_1 = require("@nestjs/common");
15
+ const FILTERABLE_TYPES = new Set(["string", "number", "boolean", "date", "datetime"]);
16
+ const SORTABLE_TYPES = new Set(["string", "number", "date", "datetime"]);
17
+ function renderFieldKindMarker(kind) {
18
+ if (!kind)
19
+ return "";
20
+ if (kind.type === "money") {
21
+ const minor = kind.minorUnits ?? 2;
22
+ const factor = minor === 0 ? "1" : `10^${minor}`;
23
+ return `, money [integer stored in minor units (${minor} decimals); divide by ${factor} to display]`;
24
+ }
25
+ return "";
26
+ }
27
+ let GraphCatalogService = GraphCatalogService_1 = class GraphCatalogService {
28
+ constructor(source) {
29
+ this.source = source;
30
+ this.logger = new common_1.Logger(GraphCatalogService_1.name);
31
+ this.entities = new Map();
32
+ /** Keyed by `moduleId` (UUID), value is the pre-rendered text fragment. */
33
+ this.renderedByModuleId = new Map();
34
+ }
35
+ onApplicationBootstrap() {
36
+ this.buildCatalog();
37
+ }
38
+ buildCatalog() {
39
+ this.entities.clear();
40
+ this.renderedByModuleId.clear();
41
+ const descriptors = this.source.loadAll().filter((d) => typeof d.description === "string" && d.description.length);
42
+ // Pass 1: create CatalogEntity for every described descriptor (fields + forward relationships).
43
+ for (const d of descriptors) {
44
+ const fields = Object.entries(d.fields)
45
+ .filter(([, def]) => typeof def.description === "string" && def.description.length)
46
+ .map(([name, def]) => ({
47
+ name,
48
+ type: def.type,
49
+ description: def.description,
50
+ filterable: FILTERABLE_TYPES.has(def.type),
51
+ sortable: SORTABLE_TYPES.has(def.type),
52
+ ...(def.kind ? { kind: def.kind } : {}),
53
+ }));
54
+ const relationships = [];
55
+ for (const [name, rel] of Object.entries(d.relationships)) {
56
+ if (!rel.description)
57
+ continue;
58
+ relationships.push({
59
+ name,
60
+ sourceType: d.model.type,
61
+ targetType: rel.model.type,
62
+ cardinality: rel.cardinality,
63
+ description: rel.description,
64
+ cypherDirection: rel.direction,
65
+ cypherLabel: rel.relationship,
66
+ isReverse: false,
67
+ });
68
+ }
69
+ this.entities.set(d.model.type, {
70
+ type: d.model.type,
71
+ moduleId: d.moduleId,
72
+ description: d.description,
73
+ fields,
74
+ relationships,
75
+ summary: d.chat?.summary,
76
+ textSearchFields: d.chat?.textSearchFields,
77
+ nodeName: d.model.nodeName,
78
+ labelName: d.model.labelName,
79
+ });
80
+ }
81
+ // Pass 2: materialise reverse relationships on target entities.
82
+ for (const d of descriptors) {
83
+ for (const [name, rel] of Object.entries(d.relationships)) {
84
+ if (!rel.description || !rel.reverse)
85
+ continue;
86
+ const target = this.entities.get(rel.model.type);
87
+ if (!target) {
88
+ this.logger.warn(`Reverse relationship "${rel.reverse.name}" dropped: target ${rel.model.type} not visible.`);
89
+ continue;
90
+ }
91
+ const collision = target.relationships.find((r) => r.name === rel.reverse.name);
92
+ if (collision) {
93
+ throw new Error(`Conflicting reverse relationship name "${rel.reverse.name}" on ${rel.model.type}: ` +
94
+ `already defined by ${collision.sourceType}.${collision.name}`);
95
+ }
96
+ target.relationships.push({
97
+ name: rel.reverse.name,
98
+ sourceType: rel.model.type,
99
+ targetType: d.model.type,
100
+ cardinality: rel.cardinality,
101
+ description: rel.reverse.description,
102
+ cypherDirection: rel.direction === "out" ? "in" : "out",
103
+ cypherLabel: rel.relationship,
104
+ isReverse: true,
105
+ inverseKey: name,
106
+ });
107
+ }
108
+ }
109
+ // Pass 3: render per-moduleId text fragments.
110
+ const byModuleId = new Map();
111
+ for (const e of this.entities.values()) {
112
+ const list = byModuleId.get(e.moduleId) ?? [];
113
+ list.push(e);
114
+ byModuleId.set(e.moduleId, list);
115
+ }
116
+ for (const [moduleId, list] of byModuleId.entries()) {
117
+ this.renderedByModuleId.set(moduleId, this.renderModule(moduleId, list));
118
+ }
119
+ this.logger.log(`Graph catalog built: ${this.entities.size} entities, ${byModuleId.size} modules: ${JSON.stringify(Array.from(this.entities.values()).map((e) => ({ type: e.type, moduleId: e.moduleId })))}`);
120
+ }
121
+ renderModule(moduleId, list) {
122
+ const entityBlocks = list.map((e) => {
123
+ const fieldLines = e.fields.length
124
+ ? e.fields
125
+ .map((f) => {
126
+ const kindMarker = renderFieldKindMarker(f.kind);
127
+ return ` - ${f.name} (${f.type}${kindMarker}${f.sortable ? ", sortable" : ""}${f.filterable ? ", filterable" : ""})`;
128
+ })
129
+ .join("\n")
130
+ : " (no described fields)";
131
+ return `- **${e.type}** — ${e.description}\n fields:\n${fieldLines}`;
132
+ });
133
+ const relLines = [];
134
+ for (const e of list) {
135
+ for (const r of e.relationships) {
136
+ if (r.isReverse)
137
+ continue; // forward-only in the rendered map; reverse names appear in the bracket pair
138
+ const forwardName = r.name;
139
+ const reverse = this.entities
140
+ .get(r.targetType)
141
+ ?.relationships.find((x) => x.isReverse && x.sourceType === r.targetType && x.cypherLabel === r.cypherLabel);
142
+ const names = reverse
143
+ ? `${e.type}.${forwardName} / ${r.targetType}.${reverse.name}`
144
+ : `${e.type}.${forwardName}`;
145
+ relLines.push(`(${e.type}) --> (${r.targetType}) [${names}] — ${r.description}`);
146
+ }
147
+ }
148
+ return [
149
+ `## Entities (module=${moduleId})`,
150
+ entityBlocks.join("\n"),
151
+ "",
152
+ `## Relationships (module=${moduleId})`,
153
+ relLines.join("\n"),
154
+ ].join("\n");
155
+ }
156
+ getMapFor(userModuleIds) {
157
+ if (!userModuleIds.length) {
158
+ this.logger.warn(`getMapFor: empty userModuleIds`);
159
+ return "";
160
+ }
161
+ const accessible = new Set(userModuleIds);
162
+ const registeredModuleIds = new Set(Array.from(this.entities.values()).map((e) => e.moduleId));
163
+ const matchedModuleIds = userModuleIds.filter((m) => this.renderedByModuleId.has(m));
164
+ const unmatchedUserModuleIds = userModuleIds.filter((m) => !this.renderedByModuleId.has(m));
165
+ this.logger.log(`getMapFor: userModuleIds=${JSON.stringify(userModuleIds)} registeredModuleIds=${JSON.stringify(Array.from(registeredModuleIds))} matched=${JSON.stringify(matchedModuleIds)} unmatched=${JSON.stringify(unmatchedUserModuleIds)}`);
166
+ const sections = [];
167
+ for (const m of userModuleIds) {
168
+ const fragment = this.renderedByModuleId.get(m);
169
+ if (!fragment)
170
+ continue;
171
+ sections.push(this.filterCrossModule(fragment, accessible));
172
+ }
173
+ return sections.join("\n\n");
174
+ }
175
+ filterCrossModule(fragment, accessibleModuleIds) {
176
+ // Relationship lines: "(srcType) --> (targetType) [..]". Drop if targetType's moduleId is inaccessible.
177
+ const lines = fragment.split("\n");
178
+ const out = [];
179
+ for (const line of lines) {
180
+ const match = line.match(/^\(\w+\)\s+-->\s+\((\w+)\)/);
181
+ if (!match) {
182
+ out.push(line);
183
+ continue;
184
+ }
185
+ const targetType = match[1];
186
+ const target = this.entities.get(targetType);
187
+ if (target && accessibleModuleIds.has(target.moduleId))
188
+ out.push(line);
189
+ }
190
+ return out.join("\n");
191
+ }
192
+ getAllChatEnabledEntities() {
193
+ const out = [];
194
+ for (const e of this.entities.values()) {
195
+ if (e.textSearchFields?.length)
196
+ out.push(e);
197
+ }
198
+ return out;
199
+ }
200
+ hasType(type) {
201
+ return this.entities.has(type);
202
+ }
203
+ getEntityDetail(type, userModuleIds) {
204
+ const e = this.entities.get(type);
205
+ if (!e)
206
+ return null;
207
+ if (!userModuleIds.includes(e.moduleId))
208
+ return null;
209
+ return e;
210
+ }
211
+ };
212
+ exports.GraphCatalogService = GraphCatalogService;
213
+ exports.GraphCatalogService = GraphCatalogService = GraphCatalogService_1 = __decorate([
214
+ (0, common_1.Injectable)(),
215
+ __metadata("design:paramtypes", [Object])
216
+ ], GraphCatalogService);
217
+ //# sourceMappingURL=graph.catalog.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph.catalog.service.js","sourceRoot":"","sources":["../../../../src/agents/chatbot/services/graph.catalog.service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Humanise a tool invocation into a user-facing status string.
3
+ * Used by ChatbotService to emit `assistant:status` socket events before each
4
+ * tool call. Falls back to `Running <toolName>` for tools we haven't explicitly
5
+ * labelled — the UI still gets a progress hint, and the assistant turn
6
+ * continues regardless.
7
+ */
8
+ export declare function humanizeTool(tool: string, input: Record<string, unknown>): string;
9
+ //# sourceMappingURL=humanize-tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"humanize-tool.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/services/humanize-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAuBjF"}
@@ -0,0 +1,35 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.humanizeTool = humanizeTool;
4
+ /**
5
+ * Humanise a tool invocation into a user-facing status string.
6
+ * Used by ChatbotService to emit `assistant:status` socket events before each
7
+ * tool call. Falls back to `Running <toolName>` for tools we haven't explicitly
8
+ * labelled — the UI still gets a progress hint, and the assistant turn
9
+ * continues regardless.
10
+ */
11
+ function humanizeTool(tool, input) {
12
+ const type = typeof input.type === "string" ? input.type : "";
13
+ switch (tool) {
14
+ case "resolve_entity": {
15
+ const text = typeof input.text === "string" ? input.text : "";
16
+ return `Resolving "${text}"`;
17
+ }
18
+ case "describe_entity":
19
+ return `Looking up ${type} schema`;
20
+ case "search_entities":
21
+ return `Searching ${type}`;
22
+ case "read_entity": {
23
+ const id = typeof input.id === "string" ? input.id : "";
24
+ return `Reading ${type} · ${id}`;
25
+ }
26
+ case "traverse": {
27
+ const from = typeof input.from === "string" ? input.from : "";
28
+ const via = typeof input.via === "string" ? input.via : "";
29
+ return `Traversing ${from} → ${via}`;
30
+ }
31
+ default:
32
+ return `Running ${tool}`;
33
+ }
34
+ }
35
+ //# sourceMappingURL=humanize-tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"humanize-tool.js","sourceRoot":"","sources":["../../../../src/agents/chatbot/services/humanize-tool.ts"],"names":[],"mappings":";;AAOA,oCAuBC;AA9BD;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,IAAY,EAAE,KAA8B;IACvE,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,OAAO,cAAc,IAAI,GAAG,CAAC;QAC/B,CAAC;QACD,KAAK,iBAAiB;YACpB,OAAO,cAAc,IAAI,SAAS,CAAC;QACrC,KAAK,iBAAiB;YACpB,OAAO,aAAa,IAAI,EAAE,CAAC;QAC7B,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,WAAW,IAAI,MAAM,EAAE,EAAE,CAAC;QACnC,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,MAAM,GAAG,GAAG,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,OAAO,cAAc,IAAI,MAAM,GAAG,EAAE,CAAC;QACvC,CAAC;QACD;YACE,OAAO,WAAW,IAAI,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC"}
@@ -0,0 +1,14 @@
1
+ import { DynamicStructuredTool } from "@langchain/core/tools";
2
+ import { z } from "zod";
3
+ import { ToolFactory, ToolCallRecord, UserContext } from "./tool.factory";
4
+ declare const inputSchema: z.ZodObject<{
5
+ type: z.ZodString;
6
+ }, z.core.$strip>;
7
+ export declare class DescribeEntityTool {
8
+ private readonly factory;
9
+ constructor(factory: ToolFactory);
10
+ build(ctx: UserContext, recorder: ToolCallRecord[]): DynamicStructuredTool;
11
+ invoke(input: z.infer<typeof inputSchema>, ctx: UserContext, recorder: ToolCallRecord[]): Promise<unknown>;
12
+ }
13
+ export {};
14
+ //# sourceMappingURL=describe-entity.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"describe-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/tools/describe-entity.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1E,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAEH,qBACa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,WAAW;IAEjD,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,qBAAqB;IASpE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CA4BjH"}
@@ -0,0 +1,63 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.DescribeEntityTool = void 0;
13
+ const common_1 = require("@nestjs/common");
14
+ const tools_1 = require("@langchain/core/tools");
15
+ const zod_1 = require("zod");
16
+ const tool_factory_1 = require("./tool.factory");
17
+ const inputSchema = zod_1.z.object({
18
+ type: zod_1.z.string().describe("Entity type name from the graph map."),
19
+ });
20
+ let DescribeEntityTool = class DescribeEntityTool {
21
+ constructor(factory) {
22
+ this.factory = factory;
23
+ }
24
+ build(ctx, recorder) {
25
+ return new tools_1.DynamicStructuredTool({
26
+ name: "describe_entity",
27
+ description: "Returns the described fields and relationships for an entity type.",
28
+ schema: inputSchema,
29
+ func: async (input) => JSON.stringify(await this.invoke(input, ctx, recorder)),
30
+ });
31
+ }
32
+ async invoke(input, ctx, recorder) {
33
+ return this.factory.capture({ tool: "describe_entity", input }, async () => {
34
+ const entity = this.factory.resolveEntity(input.type, ctx);
35
+ if ("error" in entity)
36
+ return entity;
37
+ return {
38
+ type: entity.type,
39
+ description: entity.description,
40
+ fields: entity.fields.map((f) => ({
41
+ name: f.name,
42
+ type: f.type,
43
+ description: f.description,
44
+ filterable: f.filterable,
45
+ sortable: f.sortable,
46
+ ...(f.kind ? { kind: f.kind } : {}),
47
+ })),
48
+ relationships: entity.relationships.map((r) => ({
49
+ name: r.name,
50
+ targetType: r.targetType,
51
+ cardinality: r.cardinality,
52
+ description: r.description,
53
+ })),
54
+ };
55
+ }, recorder);
56
+ }
57
+ };
58
+ exports.DescribeEntityTool = DescribeEntityTool;
59
+ exports.DescribeEntityTool = DescribeEntityTool = __decorate([
60
+ (0, common_1.Injectable)(),
61
+ __metadata("design:paramtypes", [tool_factory_1.ToolFactory])
62
+ ], DescribeEntityTool);
63
+ //# sourceMappingURL=describe-entity.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"describe-entity.tool.js","sourceRoot":"","sources":["../../../../src/agents/chatbot/tools/describe-entity.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,iDAA8D;AAC9D,6BAAwB;AACxB,iDAA0E;AAE1E,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CAClE,CAAC,CAAC;AAGI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YAA6B,OAAoB;QAApB,YAAO,GAAP,OAAO,CAAa;IAAG,CAAC;IAErD,KAAK,CAAC,GAAgB,EAAE,QAA0B;QAChD,OAAO,IAAI,6BAAqB,CAAC;YAC/B,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,oEAAoE;YACjF,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;SAC/E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAkC,EAAE,GAAgB,EAAE,QAA0B;QAC3F,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CACzB,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,EAClC,KAAK,IAAI,EAAE;YACT,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC3D,IAAI,OAAO,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;YACrC,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACpC,CAAC,CAAC;gBACH,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC9C,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;iBAC3B,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC,EACD,QAAQ,CACT,CAAC;IACJ,CAAC;CACF,CAAA;AAxCY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;qCAE2B,0BAAW;GADtC,kBAAkB,CAwC9B"}
@@ -0,0 +1,16 @@
1
+ import { DynamicStructuredTool } from "@langchain/core/tools";
2
+ import { z } from "zod";
3
+ import { ToolFactory, ToolCallRecord, UserContext } from "./tool.factory";
4
+ declare const inputSchema: z.ZodObject<{
5
+ type: z.ZodString;
6
+ id: z.ZodString;
7
+ include: z.ZodOptional<z.ZodArray<z.ZodString>>;
8
+ }, z.core.$strip>;
9
+ export declare class ReadEntityTool {
10
+ private readonly factory;
11
+ constructor(factory: ToolFactory);
12
+ build(ctx: UserContext, recorder: ToolCallRecord[]): DynamicStructuredTool;
13
+ invoke(input: z.infer<typeof inputSchema>, ctx: UserContext, recorder: ToolCallRecord[]): Promise<unknown>;
14
+ }
15
+ export {};
16
+ //# sourceMappingURL=read-entity.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/tools/read-entity.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG1E,QAAA,MAAM,WAAW;;;;iBAIf,CAAC;AAEH,qBACa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,WAAW;IAEjD,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,qBAAqB;IASpE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAuEjH"}
@@ -0,0 +1,102 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.ReadEntityTool = void 0;
13
+ const common_1 = require("@nestjs/common");
14
+ const tools_1 = require("@langchain/core/tools");
15
+ const zod_1 = require("zod");
16
+ const tool_factory_1 = require("./tool.factory");
17
+ const field_formatting_1 = require("../services/field-formatting");
18
+ const inputSchema = zod_1.z.object({
19
+ type: zod_1.z.string(),
20
+ id: zod_1.z.string(),
21
+ include: zod_1.z.array(zod_1.z.string()).optional().describe("Relationship names to pull one-hop related records."),
22
+ });
23
+ let ReadEntityTool = class ReadEntityTool {
24
+ constructor(factory) {
25
+ this.factory = factory;
26
+ }
27
+ build(ctx, recorder) {
28
+ return new tools_1.DynamicStructuredTool({
29
+ name: "read_entity",
30
+ description: "Fetches one record by id, optionally pulling related records across described relationships.",
31
+ schema: inputSchema,
32
+ func: async (input) => JSON.stringify(await this.invoke(input, ctx, recorder)),
33
+ });
34
+ }
35
+ async invoke(input, ctx, recorder) {
36
+ return this.factory.capture({ tool: "read_entity", input }, async () => {
37
+ const described = recorder.some((c) => c.tool === "describe_entity" && c.input.type === input.type);
38
+ if (!described) {
39
+ return {
40
+ error: `You must call describe_entity({ type: "${input.type}" }) before reading a ${input.type} record. The describe call returns the exact field names and relationships available — needed to interpret the response and construct any include argument.`,
41
+ };
42
+ }
43
+ const entity = this.factory.resolveEntity(input.type, ctx);
44
+ if ("error" in entity)
45
+ return entity;
46
+ const validRels = new Set(entity.relationships.map((r) => r.name));
47
+ for (const name of input.include ?? []) {
48
+ if (!validRels.has(name)) {
49
+ return { error: `Relationship "${name}" is not available on ${entity.type}.` };
50
+ }
51
+ }
52
+ const svc = this.factory.resolveService(entity.type);
53
+ if (!svc)
54
+ return { error: `Service not available for "${entity.type}".` };
55
+ const record = await svc.findRecordById({ id: input.id });
56
+ if (!record)
57
+ return { error: `No ${entity.type} with id ${input.id}.` };
58
+ const related = {};
59
+ if (input.include?.length) {
60
+ for (const name of input.include) {
61
+ const rel = entity.relationships.find((r) => r.name === name);
62
+ const targetSvc = this.factory.resolveService(rel.targetType);
63
+ if (!targetSvc) {
64
+ related[name] = { error: `Service for ${rel.targetType} not available.` };
65
+ continue;
66
+ }
67
+ // Use edge-based lookup so this works for relationships that are
68
+ // reverse-only on the catalog (not declared on the target descriptor).
69
+ const targetDirection = rel.cypherDirection === "out" ? "in" : "out";
70
+ const records = await targetSvc.findRelatedRecordsByEdge({
71
+ cypherLabel: rel.cypherLabel,
72
+ cypherDirection: targetDirection,
73
+ relatedLabel: entity.labelName,
74
+ relatedId: input.id,
75
+ limit: 50,
76
+ });
77
+ const targetEntity = this.factory.resolveEntity(rel.targetType, ctx);
78
+ const summariser = "error" in targetEntity
79
+ ? (d) => String(d.id)
80
+ : (targetEntity.summary ?? ((d) => String(d.name ?? d.id)));
81
+ related[name] = records.map((r) => ({
82
+ id: r.id,
83
+ type: rel.targetType,
84
+ summary: summariser(r),
85
+ }));
86
+ }
87
+ }
88
+ return {
89
+ id: record.id,
90
+ type: entity.type,
91
+ fields: (0, field_formatting_1.buildToolFieldsOutput)(entity.fields, record),
92
+ ...(input.include?.length ? { related } : {}),
93
+ };
94
+ }, recorder);
95
+ }
96
+ };
97
+ exports.ReadEntityTool = ReadEntityTool;
98
+ exports.ReadEntityTool = ReadEntityTool = __decorate([
99
+ (0, common_1.Injectable)(),
100
+ __metadata("design:paramtypes", [tool_factory_1.ToolFactory])
101
+ ], ReadEntityTool);
102
+ //# sourceMappingURL=read-entity.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read-entity.tool.js","sourceRoot":"","sources":["../../../../src/agents/chatbot/tools/read-entity.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import { DynamicStructuredTool } from "@langchain/core/tools";
2
+ import { z } from "zod";
3
+ import { ToolFactory, ToolCallRecord, UserContext } from "./tool.factory";
4
+ import { ChatbotSearchService } from "../services/chatbot.search.service";
5
+ declare const inputSchema: z.ZodObject<{
6
+ text: z.ZodString;
7
+ }, z.core.$strip>;
8
+ export declare class ResolveEntityTool {
9
+ private readonly factory;
10
+ private readonly search;
11
+ constructor(factory: ToolFactory, search: ChatbotSearchService);
12
+ build(ctx: UserContext, recorder: ToolCallRecord[]): DynamicStructuredTool;
13
+ invoke(input: z.infer<typeof inputSchema>, ctx: UserContext, recorder: ToolCallRecord[]): Promise<unknown>;
14
+ }
15
+ export {};
16
+ //# sourceMappingURL=resolve-entity.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-entity.tool.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/tools/resolve-entity.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE1E,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAEH,qBACa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,oBAAoB;IAG/C,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,qBAAqB;IAUpE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAYjH"}
@@ -0,0 +1,48 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.ResolveEntityTool = void 0;
13
+ const common_1 = require("@nestjs/common");
14
+ const tools_1 = require("@langchain/core/tools");
15
+ const zod_1 = require("zod");
16
+ const tool_factory_1 = require("./tool.factory");
17
+ const chatbot_search_service_1 = require("../services/chatbot.search.service");
18
+ const inputSchema = zod_1.z.object({
19
+ text: zod_1.z.string().min(1).describe("The user's literal phrase. Pass 'Faby and Carlo' verbatim, not split."),
20
+ });
21
+ let ResolveEntityTool = class ResolveEntityTool {
22
+ constructor(factory, search) {
23
+ this.factory = factory;
24
+ this.search = search;
25
+ }
26
+ build(ctx, recorder) {
27
+ return new tools_1.DynamicStructuredTool({
28
+ name: "resolve_entity",
29
+ description: "Resolve a user-named entity across every visible type. Returns ranked candidates from the highest-confidence tier that yielded any match anywhere. Use this before search_entities / read_entity / traverse whenever the user refers to a named record.",
30
+ schema: inputSchema,
31
+ func: async (input) => JSON.stringify(await this.invoke(input, ctx, recorder)),
32
+ });
33
+ }
34
+ async invoke(input, ctx, recorder) {
35
+ return this.factory.capture({ tool: "resolve_entity", input }, async () => this.search.resolveEntity({
36
+ text: input.text,
37
+ companyId: ctx.companyId,
38
+ userModuleIds: ctx.userModuleIds,
39
+ }), recorder);
40
+ }
41
+ };
42
+ exports.ResolveEntityTool = ResolveEntityTool;
43
+ exports.ResolveEntityTool = ResolveEntityTool = __decorate([
44
+ (0, common_1.Injectable)(),
45
+ __metadata("design:paramtypes", [tool_factory_1.ToolFactory,
46
+ chatbot_search_service_1.ChatbotSearchService])
47
+ ], ResolveEntityTool);
48
+ //# sourceMappingURL=resolve-entity.tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-entity.tool.js","sourceRoot":"","sources":["../../../../src/agents/chatbot/tools/resolve-entity.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,iDAA8D;AAC9D,6BAAwB;AACxB,iDAA0E;AAC1E,+EAA0E;AAE1E,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uEAAuE,CAAC;CAC1G,CAAC,CAAC;AAGI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,YACmB,OAAoB,EACpB,MAA4B;QAD5B,YAAO,GAAP,OAAO,CAAa;QACpB,WAAM,GAAN,MAAM,CAAsB;IAC5C,CAAC;IAEJ,KAAK,CAAC,GAAgB,EAAE,QAA0B;QAChD,OAAO,IAAI,6BAAqB,CAAC;YAC/B,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,yPAAyP;YAC3P,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;SAC/E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAkC,EAAE,GAAgB,EAAE,QAA0B;QAC3F,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CACzB,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,EACjC,KAAK,IAAI,EAAE,CACT,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,aAAa,EAAE,GAAG,CAAC,aAAa;SACjC,CAAC,EACJ,QAAQ,CACT,CAAC;IACJ,CAAC;CACF,CAAA;AA5BY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAGiB,0BAAW;QACZ,6CAAoB;GAHpC,iBAAiB,CA4B7B"}
@@ -0,0 +1,20 @@
1
+ import { DynamicStructuredTool } from "@langchain/core/tools";
2
+ import { z } from "zod";
3
+ import { ToolFactory, ToolCallRecord, UserContext } from "./tool.factory";
4
+ import { ChatbotSearchService } from "../services/chatbot.search.service";
5
+ declare const inputSchema: z.ZodObject<{
6
+ type: z.ZodString;
7
+ filters: z.ZodOptional<z.ZodAny>;
8
+ sort: z.ZodOptional<z.ZodAny>;
9
+ limit: z.ZodOptional<z.ZodNumber>;
10
+ }, z.core.$strict>;
11
+ export declare class SearchEntitiesTool {
12
+ private readonly factory;
13
+ private readonly _search;
14
+ constructor(factory: ToolFactory, _search: ChatbotSearchService);
15
+ build(ctx: UserContext, recorder: ToolCallRecord[]): DynamicStructuredTool;
16
+ invoke(input: z.infer<typeof inputSchema>, ctx: UserContext, recorder: ToolCallRecord[]): Promise<unknown>;
17
+ private buildOutput;
18
+ }
19
+ export {};
20
+ //# sourceMappingURL=search-entities.tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/tools/search-entities.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAI1E,QAAA,MAAM,WAAW;;;;;kBAON,CAAC;AAUZ,qBACa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAGxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAHP,OAAO,EAAE,WAAW,EAGpB,OAAO,EAAE,oBAAoB;IAGhD,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,qBAAqB;IAUpE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAkEhH,OAAO,CAAC,WAAW;CAUpB"}