@carlonicora/nestjs-neo4jsonapi 1.62.7 → 1.63.0

package/dist/agents/agents.modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.modules.d.ts","sourceRoot":"","sources":["../../src/agents/agents.modules.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,qBAoBa,YAAY;CAAG"}
+{"version":3,"file":"agents.modules.d.ts","sourceRoot":"","sources":["../../src/agents/agents.modules.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,qBAsBa,YAAY;CAAG"}

package/dist/agents/agents.modules.js

@@ -8,6 +8,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentsModule = void 0;
 const common_1 = require("@nestjs/common");
+const chatbot_module_1 = require("./chatbot/chatbot.module");
 const community_detector_module_1 = require("./community.detector/community.detector.module");
 const community_summariser_module_1 = require("./community.summariser/community.summariser.module");
 const contextualiser_module_1 = require("./contextualiser/contextualiser.module");
@@ -26,6 +27,7 @@ exports.AgentsModule = AgentsModule;
 exports.AgentsModule = AgentsModule = __decorate([
     (0, common_1.Module)({
         imports: [
+            chatbot_module_1.ChatbotModule,
             community_detector_module_1.CommunityDetectorModule,
             community_summariser_module_1.CommunitySummariserModule,
             contextualiser_module_1.ContextualiserModule,
@@ -35,6 +37,7 @@ exports.AgentsModule = AgentsModule = __decorate([
             summariser_module_1.SummariserModule,
         ],
         exports: [
+            chatbot_module_1.ChatbotModule,
             community_detector_module_1.CommunityDetectorModule,
             community_summariser_module_1.CommunitySummariserModule,
             contextualiser_module_1.ContextualiserModule,

package/dist/agents/agents.modules.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.modules.js","sourceRoot":"","sources":["../../src/agents/agents.modules.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,8FAAyF;AACzF,oGAA+F;AAC/F,kFAA8E;AAC9E,uDAAmD;AACnD,+EAA0E;AAC1E,mEAA+D;AAC/D,sEAAkE;AAElE;;;;GAIG;AAqBI,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IApBxB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,mDAAuB;YACvB,uDAAyB;YACzB,4CAAoB;YACpB,0BAAW;YACX,yCAAkB;YAClB,kCAAe;YACf,oCAAgB;SACjB;QACD,OAAO,EAAE;YACP,mDAAuB;YACvB,uDAAyB;YACzB,4CAAoB;YACpB,0BAAW;YACX,yCAAkB;YAClB,kCAAe;YACf,oCAAgB;SACjB;KACF,CAAC;GACW,YAAY,CAAG"}
+{"version":3,"file":"agents.modules.js","sourceRoot":"","sources":["../../src/agents/agents.modules.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,6DAAyD;AACzD,8FAAyF;AACzF,oGAA+F;AAC/F,kFAA8E;AAC9E,uDAAmD;AACnD,+EAA0E;AAC1E,mEAA+D;AAC/D,sEAAkE;AAElE;;;;GAIG;AAuBI,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IAtBxB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,8BAAa;YACb,mDAAuB;YACvB,uDAAyB;YACzB,4CAAoB;YACpB,0BAAW;YACX,yCAAkB;YAClB,kCAAe;YACf,oCAAgB;SACjB;QACD,OAAO,EAAE;YACP,8BAAa;YACb,mDAAuB;YACvB,uDAAyB;YACzB,4CAAoB;YACpB,0BAAW;YACX,yCAAkB;YAClB,kCAAe;YACf,oCAAgB;SACjB;KACF,CAAC;GACW,YAAY,CAAG"}

package/dist/agents/chatbot/chatbot.module.d.ts

@@ -0,0 +1,3 @@
+export declare class ChatbotModule {
+}
+//# sourceMappingURL=chatbot.module.d.ts.map

package/dist/agents/chatbot/chatbot.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.module.d.ts","sourceRoot":"","sources":["../../../src/agents/chatbot/chatbot.module.ts"],"names":[],"mappings":"AAeA,qBAsCa,aAAa;CAAG"}

package/dist/agents/chatbot/chatbot.module.js

@@ -0,0 +1,65 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatbotModule = void 0;
+const common_1 = require("@nestjs/common");
+const llm_module_1 = require("../../core/llm/llm.module");
+const user_modules_repository_1 = require("./repositories/user-modules.repository");
+const chatbot_index_manager_1 = require("./services/chatbot.index.manager");
+const chatbot_search_service_1 = require("./services/chatbot.search.service");
+const chatbot_service_1 = require("./services/chatbot.service");
+const descriptor_source_1 = require("./services/descriptor.source");
+const graph_catalog_service_1 = require("./services/graph.catalog.service");
+const describe_entity_tool_1 = require("./tools/describe-entity.tool");
+const read_entity_tool_1 = require("./tools/read-entity.tool");
+const resolve_entity_tool_1 = require("./tools/resolve-entity.tool");
+const search_entities_tool_1 = require("./tools/search-entities.tool");
+const tool_factory_1 = require("./tools/tool.factory");
+const traverse_tool_1 = require("./tools/traverse.tool");
+let ChatbotModule = class ChatbotModule {
+};
+exports.ChatbotModule = ChatbotModule;
+exports.ChatbotModule = ChatbotModule = __decorate([
+    (0, common_1.Module)({
+        imports: [llm_module_1.LLMModule],
+        providers: [
+            descriptor_source_1.GraphDescriptorRegistry,
+            {
+                provide: graph_catalog_service_1.GraphCatalogService,
+                useFactory: (src) => new graph_catalog_service_1.GraphCatalogService(src),
+                inject: [descriptor_source_1.GraphDescriptorRegistry],
+            },
+            tool_factory_1.ToolFactory,
+            resolve_entity_tool_1.ResolveEntityTool,
+            describe_entity_tool_1.DescribeEntityTool,
+            search_entities_tool_1.SearchEntitiesTool,
+            read_entity_tool_1.ReadEntityTool,
+            traverse_tool_1.TraverseTool,
+            user_modules_repository_1.UserModulesRepository,
+            chatbot_service_1.ChatbotService,
+            // Per-label fulltext + vector index manager (fires once on module init)
+            chatbot_index_manager_1.ChatbotIndexManager,
+            // Cascading search: substring fulltext → Lucene fuzzy → semantic vector
+            chatbot_search_service_1.ChatbotSearchService,
+        ],
+        exports: [
+            chatbot_service_1.ChatbotService,
+            descriptor_source_1.GraphDescriptorRegistry,
+            graph_catalog_service_1.GraphCatalogService,
+            user_modules_repository_1.UserModulesRepository,
+            tool_factory_1.ToolFactory,
+            resolve_entity_tool_1.ResolveEntityTool,
+            describe_entity_tool_1.DescribeEntityTool,
+            search_entities_tool_1.SearchEntitiesTool,
+            read_entity_tool_1.ReadEntityTool,
+            traverse_tool_1.TraverseTool,
+            chatbot_search_service_1.ChatbotSearchService,
+        ],
+    })
+], ChatbotModule);
+//# sourceMappingURL=chatbot.module.js.map

package/dist/agents/chatbot/chatbot.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.module.js","sourceRoot":"","sources":["../../../src/agents/chatbot/chatbot.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,0DAAsD;AACtD,oFAA+E;AAC/E,4EAAuE;AACvE,8EAAyE;AACzE,gEAA4D;AAC5D,oEAAuE;AACvE,4EAAuE;AACvE,uEAAkE;AAClE,+DAA0D;AAC1D,qEAAgE;AAChE,uEAAkE;AAClE,uDAAmD;AACnD,yDAAqD;AAwC9C,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IAtCzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,sBAAS,CAAC;QACpB,SAAS,EAAE;YACT,2CAAuB;YACvB;gBACE,OAAO,EAAE,2CAAmB;gBAC5B,UAAU,EAAE,CAAC,GAA4B,EAAE,EAAE,CAAC,IAAI,2CAAmB,CAAC,GAAG,CAAC;gBAC1E,MAAM,EAAE,CAAC,2CAAuB,CAAC;aAClC;YACD,0BAAW;YACX,uCAAiB;YACjB,yCAAkB;YAClB,yCAAkB;YAClB,iCAAc;YACd,4BAAY;YACZ,+CAAqB;YACrB,gCAAc;YAEd,wEAAwE;YACxE,2CAAmB;YAEnB,wEAAwE;YACxE,6CAAoB;SACrB;QACD,OAAO,EAAE;YACP,gCAAc;YACd,2CAAuB;YACvB,2CAAmB;YACnB,+CAAqB;YACrB,0BAAW;YACX,uCAAiB;YACjB,yCAAkB;YAClB,yCAAkB;YAClB,iCAAc;YACd,4BAAY;YACZ,6CAAoB;SACrB;KACF,CAAC;GACW,aAAa,CAAG"}

package/dist/agents/chatbot/interfaces/chatbot.response.interface.d.ts

@@ -0,0 +1,25 @@
+import { AgentMessageType } from "../../../common/enums/agentmessage.type";
+export interface ChatbotReference {
+    type: string;
+    id: string;
+    reason: string;
+}
+export interface ChatbotToolCall {
+    tool: string;
+    input: Record<string, unknown>;
+    durationMs: number;
+    error?: string;
+}
+export interface ChatbotResponseInterface {
+    type: AgentMessageType.Assistant;
+    answer: string;
+    references: ChatbotReference[];
+    needsClarification: boolean;
+    suggestedQuestions: string[];
+    tokens: {
+        input: number;
+        output: number;
+    };
+    toolCalls: ChatbotToolCall[];
+}
+//# sourceMappingURL=chatbot.response.interface.d.ts.map

package/dist/agents/chatbot/interfaces/chatbot.response.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.response.interface.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/interfaces/chatbot.response.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B"}

package/dist/agents/chatbot/interfaces/chatbot.response.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=chatbot.response.interface.js.map

package/dist/agents/chatbot/interfaces/chatbot.response.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.response.interface.js","sourceRoot":"","sources":["../../../../src/agents/chatbot/interfaces/chatbot.response.interface.ts"],"names":[],"mappings":""}

package/dist/agents/chatbot/interfaces/graph.catalog.interface.d.ts

@@ -0,0 +1,50 @@
+import { FieldKind } from "../../../common/interfaces/entity.schema.interface";
+export interface CatalogField {
+    name: string;
+    /** Cypher scalar / array type string from the Descriptor. */
+    type: string;
+    description: string;
+    /** Whether filter operators apply to this field. */
+    filterable: boolean;
+    /** Whether sort may reference this field. */
+    sortable: boolean;
+    /**
+     * Semantic kind propagated from the descriptor. When present, the catalogue
+     * renderer emits an inline marker and the tool layer emits a companion
+     * formatted value alongside the raw scalar.
+     */
+    kind?: FieldKind;
+}
+export interface CatalogRelationship {
+    /** Traversal name exposed to the LLM. */
+    name: string;
+    sourceType: string;
+    targetType: string;
+    cardinality: "one" | "many";
+    description: string;
+    /** Internal: used by tool layer to build the Cypher MATCH; never exposed to the LLM. */
+    cypherDirection: "out" | "in";
+    cypherLabel: string;
+    /** Internal: true if this relationship was materialised from a sibling's reverse: {} block. */
+    isReverse: boolean;
+    /** For reverse relationships only: the descriptor key on the target side
+     *  (i.e. the forward relationship name on the target's own descriptor).
+     *  Used by the traverse tool to pass the correct lookup key to
+     *  AbstractRepository.findByRelated, which keys relationships by descriptor name. */
+    inverseKey?: string;
+}
+export interface CatalogEntity {
+    type: string;
+    /** Stable module UUID — matches the `(Module) {id}` node in Neo4j. */
+    moduleId: string;
+    description: string;
+    fields: CatalogField[];
+    relationships: CatalogRelationship[];
+    summary?: (data: any) => string;
+    textSearchFields?: string[];
+    /** Neo4j node name / alias for tool-layer query construction. */
+    nodeName: string;
+    /** Neo4j label name for tool-layer query construction. */
+    labelName: string;
+}
+//# sourceMappingURL=graph.catalog.interface.d.ts.map

package/dist/agents/chatbot/interfaces/graph.catalog.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.catalog.interface.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/interfaces/graph.catalog.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oDAAoD,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,KAAK,GAAG,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,eAAe,EAAE,KAAK,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,SAAS,EAAE,OAAO,CAAC;IACnB;;;yFAGqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/agents/chatbot/interfaces/graph.catalog.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=graph.catalog.interface.js.map

package/dist/agents/chatbot/interfaces/graph.catalog.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.catalog.interface.js","sourceRoot":"","sources":["../../../../src/agents/chatbot/interfaces/graph.catalog.interface.ts"],"names":[],"mappings":""}

package/dist/agents/chatbot/prompts/chatbot.system.prompt.d.ts

@@ -0,0 +1,3 @@
+export declare const CHATBOT_SYSTEM_PROMPT_BASE = "# Role\n\nYou help a user explore their company's ERP data. The data is stored as a graph \u2014 entities are nodes, and the connections between them are edges.\n\nYou answer the user's questions by traversing this graph: find the entities the question is about, read their fields, and walk the relationships between them to reach related entities, continuing until you have enough information to answer. Nearly every useful answer requires following at least one edge \u2014 a single search is rarely the whole story.\n\nEvery fact in your answer must come from a tool call that returned it. Do not invent field names, relationship names, entity types, or record contents.\n\n## Your data\n\n{GRAPH_MAP}\n\nThe catalogue above is the complete list of entity types, fields, and relationships available to you. Anything not listed does not exist.\n\n**Every currency value in this system is stored as an integer number of cents \u2014 never as a decimal amount.** A stored value of `600` means 6.00, `500` means 5.00, and `1234567` means 12,345.67. Fields that carry money are marked `money` in the catalogue above (e.g. `total_amount (number, money [integer stored in minor units (2 decimals); divide by 10^2 to display], ...)`). For these fields, every record returned by `read_entity`, `search_entities`, or `traverse` also carries a sibling `<name>_formatted` string \u2014 quote that string when narrating the amount in your answer, and never quote the raw integer as if it were euros. Filters and sort still target the raw field (pass cents, e.g. `{ field: \"total_amount\", op: \"gt\", value: 10000 }` to mean \"over 100.00\").\n\n## Tools\n\nYou have five tools. Call them in sequence \u2014 a typical question needs two or three.\n\nBefore choosing a tool, check the \"Entities already in this conversation\" block that may be provided below. If the user's phrase refers to an entity listed there \u2014 by its exact name, by a partial name, or implicitly (\"them\", \"their\", \"other\", \"these\") \u2014 treat that entity as resolved. Use its `type` and `id` directly with `read_entity` or `traverse`. Do not call `resolve_entity` for a name that is already resolved in context.\n\nOtherwise, if the user names an entity \u2014 a customer, a person, a product, a project, anything that could correspond to a record in the graph \u2014 your first tool call is `resolve_entity` with the user's literal phrase. Do not guess a type. `resolve_entity` returns candidates across every entity type in one shot; you then pick a candidate and proceed with `describe_entity` + the typed tools.\n\n- `resolve_entity(text)` \u2014 look up nodes by name across every entity type in one call. Pass the user's literal phrase verbatim, including words like \"and\", \"&\", or other punctuation that may be part of a name. The response carries a `matchMode` and `items` sorted by `score` descending:\n  - `exact` or `fuzzy` \u2192 if `items.length === 1` or `items[0].score - items[1].score \u2265 0.15`, pick `items[0]`. Otherwise set `needsClarification: true` and list the top candidates to the user.\n  - `semantic` \u2192 same rule, margin \u2265 0.08. Also warn the user that the match is approximate.\n  - `none` \u2192 no record exists; tell the user and suggest rephrasing.\n\n- `describe_entity(type)` \u2014 inspect one entity type in full: every field with its type, and every relationship with its target type and description. Call this for every type you intend to touch, BEFORE searching, reading, or traversing it. The next three tools will refuse to run on a type that has not been described in this turn.\n\n- `search_entities(type, filters?, sort?, limit?)` \u2014 find records of a known type by filter and sort. Use this when you already have the type (from `resolve_entity` or because the user referred to a kind of record without naming a specific one, e.g. \"all orders over 10,000\"). `search_entities` does not search by name \u2014 to find a record by name, call `resolve_entity` first.\n\n- `read_entity(type, id, include?)` \u2014 fetch the full fields of a single node by id. Tool outputs from other tools are summaries; call this to get the complete record before reporting on it.\n\n- `traverse(fromType, fromId, relationship, filters?, sort?, limit?)` \u2014 walk one edge from a known node to its connected nodes. The `relationship` must be one listed under the source type in the catalogue. `filters` and `sort` apply to the target node's fields. This is the only way to cross from one entity type to another.\n\nIf a tool returns `{ error: \"\u2026\" }`, read the message \u2014 it usually lists valid fields or relationships. Pick one of those and call the tool again. Recover within the same turn; do not apologise to the user for a tool error.\n\n## Output\n\nReturn these fields:\n\n- `answer` \u2014 a concise prose reply (2\u20134 sentences) built from the actual field values and traversal results. When you report on a record, use its real field values, not its type name.\n\n- `references` \u2014 every entity that contributes to the meaning of your `answer`, as `{ type, id, reason }`. An entity contributes when it is the subject the user asked about, or a record the answer reports a fact about. `reason` is one short clause explaining that role (for example \"the account the user asked about\", \"one of the orders listed in the answer\"). Do not include entities you retrieved, inspected, and discarded: a `resolve_entity` call that returned three candidates of which you only used one \u2014 the other two are not references; a `traverse` that walked an edge whose target you did not mention \u2014 not a reference. These references are persisted and re-loaded as context on the next turn, so polluting them with irrelevant records will cause the next turn to confuse them with the actual subject \u2014 be strict.\n\n- `suggestedQuestions` \u2014 3 to 5 concrete next questions. Each should name an entity from the answer and point to a relationship in the catalogue that you did not walk this turn.\n\n- `needsClarification` \u2014 `true` when (a) `resolve_entity` returned multiple candidates in the winning tier and the top score did not exceed the runner-up by the tier's margin threshold, or (b) a `search_entities` filter query returned multiple records with no way for you to pick between them. Do not set this without evidence from a tool call.\n";
+export declare function renderChatbotSystemPrompt(graphMap: string): string;
+//# sourceMappingURL=chatbot.system.prompt.d.ts.map

package/dist/agents/chatbot/prompts/chatbot.system.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.system.prompt.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/prompts/chatbot.system.prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,qwMAkDtC,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMlE"}

package/dist/agents/chatbot/prompts/chatbot.system.prompt.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHATBOT_SYSTEM_PROMPT_BASE = void 0;
+exports.renderChatbotSystemPrompt = renderChatbotSystemPrompt;
+exports.CHATBOT_SYSTEM_PROMPT_BASE = `# Role
+
+You help a user explore their company's ERP data. The data is stored as a graph — entities are nodes, and the connections between them are edges.
+
+You answer the user's questions by traversing this graph: find the entities the question is about, read their fields, and walk the relationships between them to reach related entities, continuing until you have enough information to answer. Nearly every useful answer requires following at least one edge — a single search is rarely the whole story.
+
+Every fact in your answer must come from a tool call that returned it. Do not invent field names, relationship names, entity types, or record contents.
+
+## Your data
+
+{GRAPH_MAP}
+
+The catalogue above is the complete list of entity types, fields, and relationships available to you. Anything not listed does not exist.
+
+**Every currency value in this system is stored as an integer number of cents — never as a decimal amount.** A stored value of \`600\` means 6.00, \`500\` means 5.00, and \`1234567\` means 12,345.67. Fields that carry money are marked \`money\` in the catalogue above (e.g. \`total_amount (number, money [integer stored in minor units (2 decimals); divide by 10^2 to display], ...)\`). For these fields, every record returned by \`read_entity\`, \`search_entities\`, or \`traverse\` also carries a sibling \`<name>_formatted\` string — quote that string when narrating the amount in your answer, and never quote the raw integer as if it were euros. Filters and sort still target the raw field (pass cents, e.g. \`{ field: "total_amount", op: "gt", value: 10000 }\` to mean "over 100.00").
+
+## Tools
+
+You have five tools. Call them in sequence — a typical question needs two or three.
+
+Before choosing a tool, check the "Entities already in this conversation" block that may be provided below. If the user's phrase refers to an entity listed there — by its exact name, by a partial name, or implicitly ("them", "their", "other", "these") — treat that entity as resolved. Use its \`type\` and \`id\` directly with \`read_entity\` or \`traverse\`. Do not call \`resolve_entity\` for a name that is already resolved in context.
+
+Otherwise, if the user names an entity — a customer, a person, a product, a project, anything that could correspond to a record in the graph — your first tool call is \`resolve_entity\` with the user's literal phrase. Do not guess a type. \`resolve_entity\` returns candidates across every entity type in one shot; you then pick a candidate and proceed with \`describe_entity\` + the typed tools.
+
+- \`resolve_entity(text)\` — look up nodes by name across every entity type in one call. Pass the user's literal phrase verbatim, including words like "and", "&", or other punctuation that may be part of a name. The response carries a \`matchMode\` and \`items\` sorted by \`score\` descending:
+  - \`exact\` or \`fuzzy\` → if \`items.length === 1\` or \`items[0].score - items[1].score ≥ 0.15\`, pick \`items[0]\`. Otherwise set \`needsClarification: true\` and list the top candidates to the user.
+  - \`semantic\` → same rule, margin ≥ 0.08. Also warn the user that the match is approximate.
+  - \`none\` → no record exists; tell the user and suggest rephrasing.
+
+- \`describe_entity(type)\` — inspect one entity type in full: every field with its type, and every relationship with its target type and description. Call this for every type you intend to touch, BEFORE searching, reading, or traversing it. The next three tools will refuse to run on a type that has not been described in this turn.
+
+- \`search_entities(type, filters?, sort?, limit?)\` — find records of a known type by filter and sort. Use this when you already have the type (from \`resolve_entity\` or because the user referred to a kind of record without naming a specific one, e.g. "all orders over 10,000"). \`search_entities\` does not search by name — to find a record by name, call \`resolve_entity\` first.
+
+- \`read_entity(type, id, include?)\` — fetch the full fields of a single node by id. Tool outputs from other tools are summaries; call this to get the complete record before reporting on it.
+
+- \`traverse(fromType, fromId, relationship, filters?, sort?, limit?)\` — walk one edge from a known node to its connected nodes. The \`relationship\` must be one listed under the source type in the catalogue. \`filters\` and \`sort\` apply to the target node's fields. This is the only way to cross from one entity type to another.
+
+If a tool returns \`{ error: "…" }\`, read the message — it usually lists valid fields or relationships. Pick one of those and call the tool again. Recover within the same turn; do not apologise to the user for a tool error.
+
+## Output
+
+Return these fields:
+
+- \`answer\` — a concise prose reply (2–4 sentences) built from the actual field values and traversal results. When you report on a record, use its real field values, not its type name.
+
+- \`references\` — every entity that contributes to the meaning of your \`answer\`, as \`{ type, id, reason }\`. An entity contributes when it is the subject the user asked about, or a record the answer reports a fact about. \`reason\` is one short clause explaining that role (for example "the account the user asked about", "one of the orders listed in the answer"). Do not include entities you retrieved, inspected, and discarded: a \`resolve_entity\` call that returned three candidates of which you only used one — the other two are not references; a \`traverse\` that walked an edge whose target you did not mention — not a reference. These references are persisted and re-loaded as context on the next turn, so polluting them with irrelevant records will cause the next turn to confuse them with the actual subject — be strict.
+
+- \`suggestedQuestions\` — 3 to 5 concrete next questions. Each should name an entity from the answer and point to a relationship in the catalogue that you did not walk this turn.
+
+- \`needsClarification\` — \`true\` when (a) \`resolve_entity\` returned multiple candidates in the winning tier and the top score did not exceed the runner-up by the tier's margin threshold, or (b) a \`search_entities\` filter query returned multiple records with no way for you to pick between them. Do not set this without evidence from a tool call.
+`;
+function renderChatbotSystemPrompt(graphMap) {
+    return exports.CHATBOT_SYSTEM_PROMPT_BASE.replace("{GRAPH_MAP}", graphMap ||
+        "(No accessible data — the user has no enabled modules with described entities. DO NOT attempt any tool calls. Respond politely explaining that you have no data to query.)");
+}
+//# sourceMappingURL=chatbot.system.prompt.js.map

package/dist/agents/chatbot/prompts/chatbot.system.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.system.prompt.js","sourceRoot":"","sources":["../../../../src/agents/chatbot/prompts/chatbot.system.prompt.ts"],"names":[],"mappings":";;;AAoDA,8DAMC;AA1DY,QAAA,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDzC,CAAC;AAEF,SAAgB,yBAAyB,CAAC,QAAgB;IACxD,OAAO,kCAA0B,CAAC,OAAO,CACvC,aAAa,EACb,QAAQ;QACN,4KAA4K,CAC/K,CAAC;AACJ,CAAC"}

package/dist/agents/chatbot/repositories/user-modules.repository.d.ts

@@ -0,0 +1,28 @@
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+/**
+ * Resolves which (Module) node IDs the current user can READ. Mirrors the
+ * permission model used by the rest of the app (see AuthRepository): a module
+ * is visible to the user iff its parent Feature is subscribed by the user's
+ * Company (or is a core Feature), and the effective `read` permission after
+ * merging the Module's default `permissions` JSON with any role-level
+ * `HAS_PERMISSIONS` overrides resolves to `true`.
+ *
+ * Used by the chatbot to filter the graph catalog at request time.
+ */
+export declare class UserModulesRepository {
+    private readonly neo4j;
+    private readonly logger;
+    constructor(neo4j: Neo4jService);
+    /**
+     * Returns every (Module).id the user has effective `read` access to.
+     *
+     * The query reuses `featureModuleQuery` — identical to the permission
+     * resolution run at login by AuthRepository — so the chatbot's module
+     * filter is always in lock-step with the rest of the app. The resolved
+     * effective permissions are returned on a virtual module node as a JSON
+     * string on `properties.permissions`; we parse it and keep the modules
+     * where `read.value === true`.
+     */
+    findModuleIdsForUser(userId: string): Promise<string[]>;
+}
+//# sourceMappingURL=user-modules.repository.d.ts.map

package/dist/agents/chatbot/repositories/user-modules.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-modules.repository.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/repositories/user-modules.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAQ1E;;;;;;;;;GASG;AACH,qBACa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAEpC,KAAK,EAAE,YAAY;IAEhD;;;;;;;;;OASG;IACG,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CA4B9D"}

package/dist/agents/chatbot/repositories/user-modules.repository.js

@@ -0,0 +1,76 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var UserModulesRepository_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserModulesRepository = void 0;
+const common_1 = require("@nestjs/common");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const feature_module_query_1 = require("../../../foundations/module/queries/feature.module.query");
+/**
+ * Resolves which (Module) node IDs the current user can READ. Mirrors the
+ * permission model used by the rest of the app (see AuthRepository): a module
+ * is visible to the user iff its parent Feature is subscribed by the user's
+ * Company (or is a core Feature), and the effective `read` permission after
+ * merging the Module's default `permissions` JSON with any role-level
+ * `HAS_PERMISSIONS` overrides resolves to `true`.
+ *
+ * Used by the chatbot to filter the graph catalog at request time.
+ */
+let UserModulesRepository = UserModulesRepository_1 = class UserModulesRepository {
+    constructor(neo4j) {
+        this.neo4j = neo4j;
+        this.logger = new common_1.Logger(UserModulesRepository_1.name);
+    }
+    /**
+     * Returns every (Module).id the user has effective `read` access to.
+     *
+     * The query reuses `featureModuleQuery` — identical to the permission
+     * resolution run at login by AuthRepository — so the chatbot's module
+     * filter is always in lock-step with the rest of the app. The resolved
+     * effective permissions are returned on a virtual module node as a JSON
+     * string on `properties.permissions`; we parse it and keep the modules
+     * where `read.value === true`.
+     */
+    async findModuleIdsForUser(userId) {
+        const result = await this.neo4j.read(`
+      MATCH (user:User {id: $userId})-[:BELONGS_TO]->(company:Company)
+      ${feature_module_query_1.featureModuleQuery}
+      `, { userId });
+        const moduleIds = [];
+        for (const record of result.records) {
+            const moduleNode = record.get("module");
+            const props = moduleNode?.properties;
+            if (!props)
+                continue;
+            const id = props.id;
+            const permsJson = props.permissions;
+            if (typeof id !== "string" || !id.length || typeof permsJson !== "string")
+                continue;
+            try {
+                const perms = JSON.parse(permsJson);
+                const read = perms.find((p) => p.type === "read");
+                if (read?.value === true)
+                    moduleIds.push(id);
+            }
+            catch {
+                this.logger.warn(`findModuleIdsForUser: malformed permissions JSON on module ${id}`);
+            }
+        }
+        this.logger.log(`findModuleIdsForUser: userId=${userId} readableModuleIds=${JSON.stringify(moduleIds)}`);
+        return moduleIds;
+    }
+};
+exports.UserModulesRepository = UserModulesRepository;
+exports.UserModulesRepository = UserModulesRepository = UserModulesRepository_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService])
+], UserModulesRepository);
+//# sourceMappingURL=user-modules.repository.js.map

package/dist/agents/chatbot/repositories/user-modules.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-modules.repository.js","sourceRoot":"","sources":["../../../../src/agents/chatbot/repositories/user-modules.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,8EAA0E;AAC1E,mGAA8F;AAO9F;;;;;;;;;GASG;AAEI,IAAM,qBAAqB,6BAA3B,MAAM,qBAAqB;IAGhC,YAA6B,KAAmB;QAAnB,UAAK,GAAL,KAAK,CAAc;QAF/B,WAAM,GAAG,IAAI,eAAM,CAAC,uBAAqB,CAAC,IAAI,CAAC,CAAC;IAEd,CAAC;IAEpD;;;;;;;;;OASG;IACH,KAAK,CAAC,oBAAoB,CAAC,MAAc;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAClC;;QAEE,yCAAkB;OACnB,EACD,EAAE,MAAM,EAAE,CACX,CAAC;QAEF,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,UAAU,GAAQ,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,UAAU,EAAE,UAAU,CAAC;YACrC,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC;YACpC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,MAAM,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,SAAS;YACpF,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAsB,CAAC;gBACzD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;gBAClD,IAAI,IAAI,EAAE,KAAK,KAAK,IAAI;oBAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8DAA8D,EAAE,EAAE,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gCAAgC,MAAM,sBAAsB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACzG,OAAO,SAAS,CAAC;IACnB,CAAC;CACF,CAAA;AA3CY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCAIyB,4BAAY;GAHrC,qBAAqB,CA2CjC"}

package/dist/agents/chatbot/services/chatbot.index.manager.d.ts

@@ -0,0 +1,17 @@
+import { OnApplicationBootstrap } from "@nestjs/common";
+import { ModelService } from "../../../core/llm/services/model.service";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { GraphCatalogService } from "./graph.catalog.service";
+export declare class ChatbotIndexManager implements OnApplicationBootstrap {
+    private readonly neo4j;
+    private readonly catalog;
+    private readonly models;
+    private readonly logger;
+    constructor(neo4j: Neo4jService, catalog: GraphCatalogService, models: ModelService);
+    onApplicationBootstrap(): Promise<void>;
+    private ensureFulltext;
+    private ensureVector;
+    fulltextIndexName(label: string): string;
+    vectorIndexName(label: string): string;
+}
+//# sourceMappingURL=chatbot.index.manager.d.ts.map

package/dist/agents/chatbot/services/chatbot.index.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.index.manager.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/services/chatbot.index.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,qBACa,mBAAoB,YAAW,sBAAsB;IAI9D,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;gBAG5C,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,YAAY;IAOjC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;YAY/B,cAAc;YAed,YAAY;IAkB1B,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIxC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAGvC"}

package/dist/agents/chatbot/services/chatbot.index.manager.js

@@ -0,0 +1,84 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var ChatbotIndexManager_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatbotIndexManager = void 0;
+const common_1 = require("@nestjs/common");
+const model_service_1 = require("../../../core/llm/services/model.service");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const graph_catalog_service_1 = require("./graph.catalog.service");
+let ChatbotIndexManager = ChatbotIndexManager_1 = class ChatbotIndexManager {
+    constructor(neo4j, catalog, models) {
+        this.neo4j = neo4j;
+        this.catalog = catalog;
+        this.models = models;
+        this.logger = new common_1.Logger(ChatbotIndexManager_1.name);
+    }
+    // Fires in onApplicationBootstrap (after all onModuleInit). GraphCatalogService
+    // builds its catalog in its own onApplicationBootstrap; because it's declared
+    // before this manager in chatbot.module.ts, its bootstrap runs first and the
+    // catalog is populated by the time we read it here.
+    async onApplicationBootstrap() {
+        const entities = this.catalog.getAllChatEnabledEntities();
+        if (!entities.length)
+            return;
+        const dims = this.models.getEmbedderDimensions();
+        for (const e of entities) {
+            await this.ensureFulltext(e);
+            await this.ensureVector(e, dims);
+        }
+    }
+    async ensureFulltext(e) {
+        const fields = (e.textSearchFields ?? []).map((f) => `n.\`${f}\``).join(", ");
+        if (!fields)
+            return;
+        const indexName = this.fulltextIndexName(e.labelName);
+        await this.neo4j.writeOne({
+            query: `
+        CREATE FULLTEXT INDEX \`${indexName}\` IF NOT EXISTS
+        FOR (n:\`${e.labelName}\`)
+        ON EACH [${fields}]
+      `,
+        });
+        this.logger.debug(`Ensured fulltext index ${indexName} for ${e.labelName}`);
+    }
+    async ensureVector(e, dims) {
+        if (!e.textSearchFields?.length)
+            return;
+        const indexName = this.vectorIndexName(e.labelName);
+        await this.neo4j.writeOne({
+            query: `
+        CREATE VECTOR INDEX \`${indexName}\` IF NOT EXISTS
+        FOR (n:\`${e.labelName}\`)
+        ON n.name_embedding
+        OPTIONS { indexConfig: {
+          \`vector.dimensions\`: ${dims},
+          \`vector.similarity_function\`: 'cosine'
+        }}
+      `,
+        });
+        this.logger.debug(`Ensured vector index ${indexName} for ${e.labelName}`);
+    }
+    fulltextIndexName(label) {
+        return `${label.toLowerCase()}_chat_fulltext`;
+    }
+    vectorIndexName(label) {
+        return `${label.toLowerCase()}_chat_embedding`;
+    }
+};
+exports.ChatbotIndexManager = ChatbotIndexManager;
+exports.ChatbotIndexManager = ChatbotIndexManager = ChatbotIndexManager_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService,
+        graph_catalog_service_1.GraphCatalogService,
+        model_service_1.ModelService])
+], ChatbotIndexManager);
+//# sourceMappingURL=chatbot.index.manager.js.map

package/dist/agents/chatbot/services/chatbot.index.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.index.manager.js","sourceRoot":"","sources":["../../../../src/agents/chatbot/services/chatbot.index.manager.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAA4E;AAC5E,4EAAwE;AACxE,8EAA0E;AAE1E,mEAA8D;AAGvD,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAG9B,YACmB,KAAmB,EACnB,OAA4B,EAC5B,MAAoB;QAFpB,UAAK,GAAL,KAAK,CAAc;QACnB,YAAO,GAAP,OAAO,CAAqB;QAC5B,WAAM,GAAN,MAAM,CAAc;QALtB,WAAM,GAAG,IAAI,eAAM,CAAC,qBAAmB,CAAC,IAAI,CAAC,CAAC;IAM5D,CAAC;IAEJ,gFAAgF;IAChF,8EAA8E;IAC9E,6EAA6E;IAC7E,oDAAoD;IACpD,KAAK,CAAC,sBAAsB;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC;QAC1D,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO;QAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAEjD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,CAAgB;QAC3C,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,EAAE;kCACqB,SAAS;mBACxB,CAAC,CAAC,SAAS;mBACX,MAAM;OAClB;SACF,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,SAAS,QAAQ,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAC9E,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,CAAgB,EAAE,IAAY;QACvD,IAAI,CAAC,CAAC,CAAC,gBAAgB,EAAE,MAAM;YAAE,OAAO;QAExC,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,EAAE;gCACmB,SAAS;mBACtB,CAAC,CAAC,SAAS;;;mCAGK,IAAI;;;OAGhC;SACF,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,SAAS,QAAQ,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,iBAAiB,CAAC,KAAa;QAC7B,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,gBAAgB,CAAC;IAChD,CAAC;IAED,eAAe,CAAC,KAAa;QAC3B,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACjD,CAAC;CACF,CAAA;AAjEY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;qCAKe,4BAAY;QACV,2CAAmB;QACpB,4BAAY;GAN5B,mBAAmB,CAiE/B"}

package/dist/agents/chatbot/services/chatbot.search.service.d.ts

@@ -0,0 +1,46 @@
+import { EmbedderService } from "../../../core/llm/services/embedder.service";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { CatalogEntity } from "../interfaces/graph.catalog.interface";
+import { ChatbotIndexManager } from "./chatbot.index.manager";
+import { GraphCatalogService } from "./graph.catalog.service";
+export declare const CHATBOT_EXACT_MAX_RESULTS = 10;
+export declare const CHATBOT_FUZZY_MAX_RESULTS = 10;
+export declare const CHATBOT_SEMANTIC_MAX_RESULTS = 5;
+export declare const CHATBOT_RESOLVE_MAX_RESULTS = 10;
+export declare const CHATBOT_SEMANTIC_MIN_SCORE = 0.6;
+export type MatchMode = "exact" | "fuzzy" | "semantic" | "none";
+export interface RunSearchParams {
+    entity: CatalogEntity;
+    text: string;
+    companyId: string;
+    limit: number;
+}
+export interface RankedCandidate {
+    type: string;
+    id: string;
+    summary: string;
+    score: number;
+}
+export interface ResolveEntityParams {
+    text: string;
+    companyId: string;
+    userModuleIds: string[];
+}
+export interface ResolveEntityResult {
+    matchMode: MatchMode;
+    items: RankedCandidate[];
+}
+export declare class ChatbotSearchService {
+    private readonly neo4j;
+    private readonly embedder;
+    private readonly indexNames;
+    private readonly catalog;
+    private readonly logger;
+    constructor(neo4j: Neo4jService, embedder: EmbedderService, indexNames: ChatbotIndexManager, catalog: GraphCatalogService);
+    resolveEntity(params: ResolveEntityParams): Promise<ResolveEntityResult>;
+    private runTierForEntitySafe;
+    private projectSummary;
+    private tierFulltext;
+    private tierSemantic;
+}
+//# sourceMappingURL=chatbot.search.service.d.ts.map

package/dist/agents/chatbot/services/chatbot.search.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatbot.search.service.d.ts","sourceRoot":"","sources":["../../../../src/agents/chatbot/services/chatbot.search.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAK9C,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AASD,qBACa,oBAAoB;IAI7B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAG7C,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,mBAAmB;IAGzC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAyBhE,oBAAoB;IAgClC,OAAO,CAAC,cAAc;YAiBR,YAAY;YA6BZ,YAAY;CAgC3B"}