@carlonicora/nestjs-neo4jsonapi 2.1.0 → 2.2.0

package/dist/foundations/assistant/dtos/assistant-append.dto.d.ts

@@ -1,4 +1,10 @@
 export declare class AssistantAppendAttributesDto {
+    /**
+     * This user message. Either plain text, or — following the host app's
+     * BlockNote convention — a JSON-serialised BlockNote document, which the
+     * server detects and converts. An append carries no binding; it inherits
+     * the thread's.
+     */
     content: string;
     howToMode?: boolean;
     limitToHowToId?: string;

package/dist/foundations/assistant/dtos/assistant-append.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-append.dto.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant/dtos/assistant-append.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,4BAA4B;IAIvC,OAAO,EAAG,MAAM,CAAC;IAIjB,SAAS,CAAC,EAAE,OAAO,CAAC;IAIpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,sBAAsB;IAEjC,IAAI,EAAG,MAAM,CAAC;IAId,UAAU,EAAG,4BAA4B,CAAC;CAC3C;AAED,qBAAa,kBAAkB;IAG7B,IAAI,EAAG,sBAAsB,CAAC;CAC/B"}
+{"version":3,"file":"assistant-append.dto.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant/dtos/assistant-append.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,4BAA4B;IACvC;;;;;OAKG;IAIH,OAAO,EAAG,MAAM,CAAC;IAIjB,SAAS,CAAC,EAAE,OAAO,CAAC;IAIpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,sBAAsB;IAEjC,IAAI,EAAG,MAAM,CAAC;IAId,UAAU,EAAG,4BAA4B,CAAC;CAC3C;AAED,qBAAa,kBAAkB;IAG7B,IAAI,EAAG,sBAAsB,CAAC;CAC/B"}

package/dist/foundations/assistant/dtos/assistant-append.dto.js

@@ -18,7 +18,7 @@ exports.AssistantAppendAttributesDto = AssistantAppendAttributesDto;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
-    (0, class_validator_1.MaxLength)(10_000),
+    (0, class_validator_1.MaxLength)(200_000),
     __metadata("design:type", String)
 ], AssistantAppendAttributesDto.prototype, "content", void 0);
 __decorate([

package/dist/foundations/assistant/dtos/assistant-append.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-append.dto.js","sourceRoot":"","sources":["../../../../src/foundations/assistant/dtos/assistant-append.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDAAiH;AAEjH,MAAa,4BAA4B;CAaxC;AAbD,oEAaC;AATC;IAHC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,MAAM,CAAC;;6DACD;AAIjB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;+DACQ;AAIpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;oEACa;AAG1B,MAAa,sBAAsB;CAOlC;AAPD,wDAOC;AALC;IADC,IAAA,wBAAM,EAAC,oBAAoB,CAAC;;oDACf;AAId;IAFC,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC;8BAC5B,4BAA4B;0DAAC;AAG5C,MAAa,kBAAkB;CAI9B;AAJD,gDAIC;AADC;IAFC,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC;8BAC5B,sBAAsB;gDAAC"}
+{"version":3,"file":"assistant-append.dto.js","sourceRoot":"","sources":["../../../../src/foundations/assistant/dtos/assistant-append.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDAAiH;AAEjH,MAAa,4BAA4B;CAmBxC;AAnBD,oEAmBC;AATC;IAHC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,OAAO,CAAC;;6DACF;AAIjB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;+DACQ;AAIpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;oEACa;AAG1B,MAAa,sBAAsB;CAOlC;AAPD,wDAOC;AALC;IADC,IAAA,wBAAM,EAAC,oBAAoB,CAAC;;oDACf;AAId;IAFC,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC;8BAC5B,4BAA4B;0DAAC;AAG5C,MAAa,kBAAkB;CAI9B;AAJD,gDAIC;AADC;IAFC,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC;8BAC5B,sBAAsB;gDAAC"}

package/dist/foundations/assistant/dtos/assistant-post.dto.d.ts

@@ -1,4 +1,32 @@
+/**
+ * Reference to the resource a thread is bound to (the `content` relationship,
+ * materialised as `(Assistant)-[:BOUND_TO]->(target)`).
+ *
+ * `type` is a plain `@IsString()` — NOT `@Equals(...)` — because the
+ * relationship is polymorphic: any registered model may be the target. The
+ * controller resolves the string against the model registry and rejects
+ * unknown types there, which is the only place that knows the full set.
+ */
+export declare class AssistantContentReferenceDto {
+    type: string;
+    id: string;
+}
+export declare class AssistantContentRelationshipDto {
+    data: AssistantContentReferenceDto;
+}
+export declare class AssistantPostRelationshipsDto {
+    content?: AssistantContentRelationshipDto;
+}
 export declare class AssistantPostAttributesDto {
+    /**
+     * The first user message. Either plain text, or — following the host app's
+     * BlockNote convention — a JSON-serialised BlockNote document. The server
+     * detects the latter and derives the persisted markdown (and the pinned
+     * entity mentions) from it; see AssistantService.resolveUserTurnInput.
+     *
+     * The cap is generous because a serialised document carries block structure
+     * as well as prose.
+     */
     content: string;
     title?: string;
     howToMode?: boolean;
@@ -7,6 +35,7 @@ export declare class AssistantPostAttributesDto {
 export declare class AssistantPostDataDto {
     type: string;
     attributes: AssistantPostAttributesDto;
+    relationships?: AssistantPostRelationshipsDto;
 }
 export declare class AssistantPostDto {
     data: AssistantPostDataDto;

package/dist/foundations/assistant/dtos/assistant-post.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-post.dto.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant/dtos/assistant-post.dto.ts"],"names":[],"mappings":"AAIA,qBAAa,0BAA0B;IAIrC,OAAO,EAAG,MAAM,CAAC;IAKjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,SAAS,CAAC,EAAE,OAAO,CAAC;IAIpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,oBAAoB;IAE/B,IAAI,EAAG,MAAM,CAAC;IAId,UAAU,EAAG,0BAA0B,CAAC;CACzC;AAED,qBAAa,gBAAgB;IAG3B,IAAI,EAAG,oBAAoB,CAAC;CAC7B"}
+{"version":3,"file":"assistant-post.dto.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant/dtos/assistant-post.dto.ts"],"names":[],"mappings":"AAcA;;;;;;;;GAQG;AACH,qBAAa,4BAA4B;IAGvC,IAAI,EAAG,MAAM,CAAC;IAGd,EAAE,EAAG,MAAM,CAAC;CACb;AAED,qBAAa,+BAA+B;IAI1C,IAAI,EAAG,4BAA4B,CAAC;CACrC;AAED,qBAAa,6BAA6B;IAIxC,OAAO,CAAC,EAAE,+BAA+B,CAAC;CAC3C;AAED,qBAAa,0BAA0B;IACrC;;;;;;;;OAQG;IAIH,OAAO,EAAG,MAAM,CAAC;IAKjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,SAAS,CAAC,EAAE,OAAO,CAAC;IAIpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,oBAAoB;IAE/B,IAAI,EAAG,MAAM,CAAC;IAId,UAAU,EAAG,0BAA0B,CAAC;IAKxC,aAAa,CAAC,EAAE,6BAA6B,CAAC;CAC/C;AAED,qBAAa,gBAAgB;IAG3B,IAAI,EAAG,oBAAoB,CAAC;CAC7B"}

package/dist/foundations/assistant/dtos/assistant-post.dto.js

@@ -9,17 +9,56 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AssistantPostDto = exports.AssistantPostDataDto = exports.AssistantPostAttributesDto = void 0;
+exports.AssistantPostDto = exports.AssistantPostDataDto = exports.AssistantPostAttributesDto = exports.AssistantPostRelationshipsDto = exports.AssistantContentRelationshipDto = exports.AssistantContentReferenceDto = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const assistant_meta_1 = require("../entities/assistant.meta");
+/**
+ * Reference to the resource a thread is bound to (the `content` relationship,
+ * materialised as `(Assistant)-[:BOUND_TO]->(target)`).
+ *
+ * `type` is a plain `@IsString()` — NOT `@Equals(...)` — because the
+ * relationship is polymorphic: any registered model may be the target. The
+ * controller resolves the string against the model registry and rejects
+ * unknown types there, which is the only place that knows the full set.
+ */
+class AssistantContentReferenceDto {
+}
+exports.AssistantContentReferenceDto = AssistantContentReferenceDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AssistantContentReferenceDto.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], AssistantContentReferenceDto.prototype, "id", void 0);
+class AssistantContentRelationshipDto {
+}
+exports.AssistantContentRelationshipDto = AssistantContentRelationshipDto;
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_transformer_1.Type)(() => AssistantContentReferenceDto),
+    __metadata("design:type", AssistantContentReferenceDto)
+], AssistantContentRelationshipDto.prototype, "data", void 0);
+class AssistantPostRelationshipsDto {
+}
+exports.AssistantPostRelationshipsDto = AssistantPostRelationshipsDto;
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => AssistantContentRelationshipDto),
+    __metadata("design:type", AssistantContentRelationshipDto)
+], AssistantPostRelationshipsDto.prototype, "content", void 0);
 class AssistantPostAttributesDto {
 }
 exports.AssistantPostAttributesDto = AssistantPostAttributesDto;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
-    (0, class_validator_1.MaxLength)(10_000),
+    (0, class_validator_1.MaxLength)(200_000),
     __metadata("design:type", String)
 ], AssistantPostAttributesDto.prototype, "content", void 0);
 __decorate([
@@ -50,6 +89,12 @@ __decorate([
     (0, class_transformer_1.Type)(() => AssistantPostAttributesDto),
     __metadata("design:type", AssistantPostAttributesDto)
 ], AssistantPostDataDto.prototype, "attributes", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => AssistantPostRelationshipsDto),
+    __metadata("design:type", AssistantPostRelationshipsDto)
+], AssistantPostDataDto.prototype, "relationships", void 0);
 class AssistantPostDto {
 }
 exports.AssistantPostDto = AssistantPostDto;

package/dist/foundations/assistant/dtos/assistant-post.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-post.dto.js","sourceRoot":"","sources":["../../../../src/foundations/assistant/dtos/assistant-post.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDAAiH;AACjH,+DAA2D;AAE3D,MAAa,0BAA0B;CAkBtC;AAlBD,gEAkBC;AAdC;IAHC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,MAAM,CAAC;;2DACD;AAKjB;IAHC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,GAAG,CAAC;;yDACA;AAIf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;6DACQ;AAIpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;kEACa;AAG1B,MAAa,oBAAoB;CAOhC;AAPD,oDAOC;AALC;IADC,IAAA,wBAAM,EAAC,8BAAa,CAAC,QAAQ,CAAC;;kDACjB;AAId;IAFC,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC;8BAC1B,0BAA0B;wDAAC;AAG1C,MAAa,gBAAgB;CAI5B;AAJD,4CAIC;AADC;IAFC,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC;8BAC1B,oBAAoB;8CAAC"}
+{"version":3,"file":"assistant-post.dto.js","sourceRoot":"","sources":["../../../../src/foundations/assistant/dtos/assistant-post.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDAUyB;AACzB,+DAA2D;AAE3D;;;;;;;;GAQG;AACH,MAAa,4BAA4B;CAOxC;AAPD,oEAOC;AAJC;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;0DACC;AAGd;IADC,IAAA,wBAAM,GAAE;;wDACG;AAGd,MAAa,+BAA+B;CAK3C;AALD,0EAKC;AADC;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,2BAAS,GAAE;IACX,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,4BAA4B,CAAC;8BAClC,4BAA4B;6DAAC;AAGtC,MAAa,6BAA6B;CAKzC;AALD,sEAKC;AADC;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,+BAA+B,CAAC;8BAClC,+BAA+B;8DAAC;AAG5C,MAAa,0BAA0B;CA2BtC;AA3BD,gEA2BC;AAdC;IAHC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,OAAO,CAAC;;2DACF;AAKjB;IAHC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,GAAG,CAAC;;yDACA;AAIf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;6DACQ;AAIpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;kEACa;AAG1B,MAAa,oBAAoB;CAYhC;AAZD,oDAYC;AAVC;IADC,IAAA,wBAAM,EAAC,8BAAa,CAAC,QAAQ,CAAC;;kDACjB;AAId;IAFC,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC;8BAC1B,0BAA0B;wDAAC;AAKxC;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,6BAA6B,CAAC;8BAC1B,6BAA6B;2DAAC;AAGhD,MAAa,gBAAgB;CAI5B;AAJD,4CAIC;AADC;IAFC,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC;8BAC1B,oBAAoB;8CAAC"}

package/dist/foundations/assistant/repositories/assistant.repository.d.ts

@@ -49,6 +49,28 @@ export declare class AssistantRepository extends AbstractRepository<Assistant, t
     }>;
     constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
     protected buildUserHasAccess(): string;
+    /**
+     * Attach the thread to the resource it is scoped to:
+     * `(Assistant)-[:BOUND_TO]->(target)`.
+     *
+     * This cannot go through the generic create path. `BOUND_TO` is declared
+     * polymorphic on the descriptor (any registered model may be the target), so
+     * `relationships.content.model` is only a placeholder — `assistantMeta`.
+     * `AbstractRepository.create` reads `rel.model.labelName` both to validate the
+     * target exists (abstract.repository.ts:713) and to build the edge MATCH
+     * (:822), so routing a Campaign id through it looks for
+     * `(:Assistant { id: <campaign-uuid> })` and fails with "One or more related
+     * nodes do not exist."
+     *
+     * The caller resolves the real label from the model registry, so the label
+     * interpolated here is always a registered one and never user input. The id
+     * stays parameterised.
+     */
+    bindContent(params: {
+        assistantId: string;
+        targetLabel: string;
+        targetId: string;
+    }): Promise<void>;
     /**
      * Override delete to cascade through HAS_MESSAGE children so that
      * `AssistantMessage` nodes (and their REFERENCES edges) are removed with

package/dist/foundations/assistant/repositories/assistant.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant/repositories/assistant.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEvE;;;;;;;;;GASG;AACH,qBACa,mBAAoB,SAAQ,kBAAkB,CAAC,SAAS,EAAE,OAAO,mBAAmB,CAAC,aAAa,CAAC;IAC9G,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAuB;gBAExC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAStC;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAUpD"}
+{"version":3,"file":"assistant.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant/repositories/assistant.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEvE;;;;;;;;;GASG;AACH,qBACa,mBAAoB,SAAQ,kBAAkB,CAAC,SAAS,EAAE,OAAO,mBAAmB,CAAC,aAAa,CAAC;IAC9G,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAuB;gBAExC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAStC;;;;;;;;;;;;;;;;OAgBG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxG;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAUpD"}

package/dist/foundations/assistant/repositories/assistant.repository.js

@@ -39,6 +39,34 @@ let AssistantRepository = class AssistantRepository extends abstract_repository_
             }
             WITH ${nodeName}`;
     }
+    /**
+     * Attach the thread to the resource it is scoped to:
+     * `(Assistant)-[:BOUND_TO]->(target)`.
+     *
+     * This cannot go through the generic create path. `BOUND_TO` is declared
+     * polymorphic on the descriptor (any registered model may be the target), so
+     * `relationships.content.model` is only a placeholder — `assistantMeta`.
+     * `AbstractRepository.create` reads `rel.model.labelName` both to validate the
+     * target exists (abstract.repository.ts:713) and to build the edge MATCH
+     * (:822), so routing a Campaign id through it looks for
+     * `(:Assistant { id: <campaign-uuid> })` and fails with "One or more related
+     * nodes do not exist."
+     *
+     * The caller resolves the real label from the model registry, so the label
+     * interpolated here is always a registered one and never user input. The id
+     * stays parameterised.
+     */
+    async bindContent(params) {
+        await this.neo4j.writeOne({
+            query: `
+        MATCH (assistant:Assistant {id: $assistantId})
+        MATCH (target:${params.targetLabel} {id: $targetId})
+        MERGE (assistant)-[rel:BOUND_TO]->(target)
+        SET rel.updatedAt = datetime()
+      `,
+            queryParams: { assistantId: params.assistantId, targetId: params.targetId },
+        });
+    }
     /**
      * Override delete to cascade through HAS_MESSAGE children so that
      * `AssistantMessage` nodes (and their REFERENCES edges) are removed with

package/dist/foundations/assistant/repositories/assistant.repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant.repository.js","sourceRoot":"","sources":["../../../../src/foundations/assistant/repositories/assistant.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,qDAAuE;AAEvE;;;;;;;;;GASG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,wCAAuE;IAG9G,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,+BAAmB,CAAC;IAIpD,CAAC;IAES,kBAAkB;QAC1B,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAC3C,OAAO,QAAQ,QAAQ;;uBAEJ,QAAQ;;mBAEZ,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,MAAsB;QACjC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,EAAE;;;;OAIN;YACD,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAjCY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;qCAIQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAH9E,mBAAmB,CAiC/B"}
+{"version":3,"file":"assistant.repository.js","sourceRoot":"","sources":["../../../../src/foundations/assistant/repositories/assistant.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,qDAAuE;AAEvE;;;;;;;;;GASG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,wCAAuE;IAG9G,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,+BAAmB,CAAC;IAIpD,CAAC;IAES,kBAAkB;QAC1B,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAC3C,OAAO,QAAQ,QAAQ;;uBAEJ,QAAQ;;mBAEZ,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,WAAW,CAAC,MAAsE;QACtF,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,EAAE;;wBAEW,MAAM,CAAC,WAAW;;;OAGnC;YACD,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC5E,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,MAAsB;QACjC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,EAAE;;;;OAIN;YACD,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA9DY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;qCAIQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAH9E,mBAAmB,CA8D/B"}

package/dist/foundations/assistant/services/assistant-mention.extractor.d.ts

@@ -0,0 +1,36 @@
+import { GraphCatalogService } from "../../../agents/graph/services/graph.catalog.service";
+import { ScopeGuard } from "../../../agents/graph/services/scope.guard";
+import { UserContext } from "../../../agents/graph/tools/tool.factory";
+import { EntityServiceRegistry } from "../../../common/registries/entity.service.registry";
+export interface ExtractedMention {
+    /** JSON:API type, e.g. "npcs". */
+    type: string;
+    id: string;
+    /** Display text the user saw. */
+    alias: string;
+}
+/**
+ * Turns a BlockNote document into the entity references a user message pins.
+ *
+ * A mention arrives from the browser, so it is INPUT, not a trusted pointer:
+ * validate() re-checks catalog membership, scope and existence before any of
+ * it reaches the LLM or becomes a REFERENCES edge.
+ */
+export declare class AssistantMentionExtractor {
+    private readonly catalog;
+    private readonly scopeGuard;
+    private readonly entityServices;
+    private readonly logger;
+    constructor(catalog: GraphCatalogService, scopeGuard: ScopeGuard, entityServices: EntityServiceRegistry);
+    /** Walks a BlockNote document for inline nodes of type "mention". Never throws. */
+    extract(blocks: unknown[]): ExtractedMention[];
+    /**
+     * Drops mentions that are not in the catalog for these modules, are outside
+     * the run's scope, or no longer resolve to a record.
+     */
+    validate(params: {
+        mentions: ExtractedMention[];
+        ctx: UserContext;
+    }): Promise<ExtractedMention[]>;
+}
+//# sourceMappingURL=assistant-mention.extractor.d.ts.map

package/dist/foundations/assistant/services/assistant-mention.extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-mention.extractor.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant/services/assistant-mention.extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,4CAA4C,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,qBACa,yBAAyB;IAIlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;gBAGlD,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,qBAAqB;IAGxD,mFAAmF;IACnF,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,EAAE;IAmC9C;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;QAAC,GAAG,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAoBxG"}

package/dist/foundations/assistant/services/assistant-mention.extractor.js

@@ -0,0 +1,99 @@
+"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 AssistantMentionExtractor_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssistantMentionExtractor = void 0;
+const common_1 = require("@nestjs/common");
+const graph_catalog_service_1 = require("../../../agents/graph/services/graph.catalog.service");
+const scope_guard_1 = require("../../../agents/graph/services/scope.guard");
+const entity_service_registry_1 = require("../../../common/registries/entity.service.registry");
+/**
+ * Turns a BlockNote document into the entity references a user message pins.
+ *
+ * A mention arrives from the browser, so it is INPUT, not a trusted pointer:
+ * validate() re-checks catalog membership, scope and existence before any of
+ * it reaches the LLM or becomes a REFERENCES edge.
+ */
+let AssistantMentionExtractor = AssistantMentionExtractor_1 = class AssistantMentionExtractor {
+    constructor(catalog, scopeGuard, entityServices) {
+        this.catalog = catalog;
+        this.scopeGuard = scopeGuard;
+        this.entityServices = entityServices;
+        this.logger = new common_1.Logger(AssistantMentionExtractor_1.name);
+    }
+    /** Walks a BlockNote document for inline nodes of type "mention". Never throws. */
+    extract(blocks) {
+        const out = [];
+        const seen = new Set();
+        const walk = (node) => {
+            if (!node || typeof node !== "object")
+                return;
+            if (Array.isArray(node)) {
+                node.forEach(walk);
+                return;
+            }
+            if (node.type === "mention") {
+                const id = node.props?.id;
+                const type = node.props?.entityType;
+                if (typeof id === "string" && typeof type === "string") {
+                    const key = `${type}/${id}`;
+                    if (!seen.has(key)) {
+                        seen.add(key);
+                        out.push({ type, id, alias: String(node.props?.alias ?? "") });
+                    }
+                }
+                return;
+            }
+            walk(node.content);
+            walk(node.children);
+        };
+        try {
+            walk(blocks);
+        }
+        catch (err) {
+            this.logger.warn(`extract: malformed document — ${err instanceof Error ? err.message : String(err)}`);
+            return [];
+        }
+        return out;
+    }
+    /**
+     * Drops mentions that are not in the catalog for these modules, are outside
+     * the run's scope, or no longer resolve to a record.
+     */
+    async validate(params) {
+        const kept = [];
+        for (const mention of params.mentions) {
+            if (!this.catalog.getEntityDetail(mention.type, params.ctx.userModuleIds)) {
+                this.logger.warn(`validate: dropping mention of uncatalogued type "${mention.type}".`);
+                continue;
+            }
+            if (!(await this.scopeGuard.isInScope({ type: mention.type, id: mention.id, ctx: params.ctx }))) {
+                this.logger.warn(`validate: dropping out-of-scope mention ${mention.type}/${mention.id}.`);
+                continue;
+            }
+            const service = this.entityServices.get(mention.type);
+            if (!service || !(await service.findRecordById({ id: mention.id }))) {
+                this.logger.warn(`validate: dropping unreadable mention ${mention.type}/${mention.id}.`);
+                continue;
+            }
+            kept.push(mention);
+        }
+        return kept;
+    }
+};
+exports.AssistantMentionExtractor = AssistantMentionExtractor;
+exports.AssistantMentionExtractor = AssistantMentionExtractor = AssistantMentionExtractor_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [graph_catalog_service_1.GraphCatalogService,
+        scope_guard_1.ScopeGuard,
+        entity_service_registry_1.EntityServiceRegistry])
+], AssistantMentionExtractor);
+//# sourceMappingURL=assistant-mention.extractor.js.map

package/dist/foundations/assistant/services/assistant-mention.extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-mention.extractor.js","sourceRoot":"","sources":["../../../../src/foundations/assistant/services/assistant-mention.extractor.ts"],"names":[],"mappings":"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"}

package/dist/foundations/assistant/services/assistant.service.d.ts

@@ -3,10 +3,13 @@ import { ClsService } from "nestjs-cls";
 import { OperatorService } from "../../../agents/operator/services/operator.service";
 import { ResponderService } from "../../../agents/responder/services/responder.service";
 import { GraphCatalogService } from "../../../agents/graph/services/graph.catalog.service";
+import { ScopeGuard } from "../../../agents/graph/services/scope.guard";
 import { UserModulesRepository } from "../../../agents/graph/repositories/user-modules.repository";
 import type { ToolCallRecord } from "../../../agents/graph/tools/tool.factory";
 import { EntityServiceRegistry } from "../../../common/registries/entity.service.registry";
 import { BaseConfigInterface } from "../../../config/interfaces/base.config.interface";
+import { BlockNoteService } from "../../../core/blocknote/services/blocknote.service";
+import { JsonApiDataInterface } from "../../../core/jsonapi/interfaces/jsonapi.data.interface";
 import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
 import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
 import { WebSocketService } from "../../../core/websocket/services/websocket.service";
@@ -18,6 +21,7 @@ import { AssistantMessageRepository } from "../../assistant-message/repositories
 import { AssistantMessageService } from "../../assistant-message/services/assistant-message.service";
 import { Assistant, AssistantDescriptor } from "../entities/assistant";
 import { AssistantRepository } from "../repositories/assistant.repository";
+import { AssistantMentionExtractor } from "./assistant-mention.extractor";
 /**
  * Maximum number of prior messages (turns) passed to the LLM on each turn.
  * Keeps prompt size and cost bounded for long conversations.
@@ -50,6 +54,9 @@ export declare class AssistantService extends AbstractService<Assistant, typeof
     private readonly assistantActionRepo;
     private readonly webSocketService;
     private readonly configService;
+    private readonly mentions;
+    private readonly blockNote;
+    private readonly scopeGuard;
     protected readonly descriptor: import("../../..").EntityDescriptor<Assistant, {
         owner: {
             model: import("../../..").DataMeta;
@@ -84,7 +91,7 @@ export declare class AssistantService extends AbstractService<Assistant, typeof
         };
     }>;
     private readonly assistantLogger;
-    constructor(jsonApiService: JsonApiService, assistantRepository: AssistantRepository, clsService: ClsService, userModuleIdsRepository: UserModulesRepository, responder: ResponderService, assistantMessages: AssistantMessageService, assistantMessageRepo: AssistantMessageRepository, graphCatalog: GraphCatalogService, entityServices: EntityServiceRegistry, operator: OperatorService, assistantActions: AssistantActionService, assistantActionRepo: AssistantActionRepository, webSocketService: WebSocketService, configService: ConfigService<BaseConfigInterface>);
+    constructor(jsonApiService: JsonApiService, assistantRepository: AssistantRepository, clsService: ClsService, userModuleIdsRepository: UserModulesRepository, responder: ResponderService, assistantMessages: AssistantMessageService, assistantMessageRepo: AssistantMessageRepository, graphCatalog: GraphCatalogService, entityServices: EntityServiceRegistry, operator: OperatorService, assistantActions: AssistantActionService, assistantActionRepo: AssistantActionRepository, webSocketService: WebSocketService, configService: ConfigService<BaseConfigInterface>, mentions: AssistantMentionExtractor, blockNote: BlockNoteService, scopeGuard: ScopeGuard);
     createWithFirstMessage(params: {
         companyId: string;
         userId: string;
@@ -92,6 +99,10 @@ export declare class AssistantService extends AbstractService<Assistant, typeof
         title?: string;
         howToMode?: boolean;
         limitToHowToId?: string;
+        boundContent?: {
+            type: string;
+            id: string;
+        };
     }): Promise<{
         assistant: Assistant;
         userMessage: AssistantMessage;
@@ -124,6 +135,10 @@ export declare class AssistantService extends AbstractService<Assistant, typeof
         title?: string;
         howToMode?: boolean;
         limitToHowToId?: string;
+        boundContent?: {
+            type: string;
+            id: string;
+        };
     }): Promise<{
         assistant: Assistant;
         userMessage: AssistantMessage;
@@ -163,9 +178,76 @@ export declare class AssistantService extends AbstractService<Assistant, typeof
         assistantMessage: AssistantMessage;
         action: AssistantAction;
     }>;
+    /**
+     * List the threads bound to one resource (e.g. every assistant thread for a
+     * campaign). Delegates to the inherited `findByRelated` over the `content`
+     * relationship — the BOUND_TO traversal already exists, so there is no new
+     * Cypher here and company/owner RBAC still comes from the repository.
+     */
+    findByBoundContent(params: {
+        boundType: string;
+        boundId: string;
+        query: any;
+    }): Promise<JsonApiDataInterface>;
+    /**
+     * Build the run's UserContext once per turn. `scopeId`/`scopeType` are set
+     * only when the thread is bound to a catalogued scope ROOT (a descriptor
+     * whose compiled scope chain is empty, e.g. a campaign). A thread bound to
+     * something further down a chain still gets content scope, but not a
+     * transitive run scope — the guard has no root to confine the run to.
+     */
+    private buildTurnContext;
+    /**
+     * Write the `BOUND_TO` edge that scopes a thread to a resource.
+     *
+     * Deliberately NOT part of the `createFromDTO` call above: `BOUND_TO` is
+     * polymorphic, so its descriptor entry carries `assistantMeta` as a
+     * placeholder model. The generic create path reads `rel.model.labelName` to
+     * validate the target and to build the edge, so a Campaign id sent that way
+     * is looked up as `(:Assistant { id: … })` and 400s with "One or more
+     * related nodes do not exist."
+     *
+     * The label is resolved from the model registry — the same registry the
+     * descriptor's own polymorphic discriminator uses on the read path — so an
+     * unregistered type fails loudly here rather than writing a dangling edge.
+     */
+    private attachBoundContent;
+    private toContentScope;
+    private toBoundContent;
+    /**
+     * A BlockNote-backed field arrives as a JSON string in its own string
+     * attribute — the convention every host-app entity already uses (e.g.
+     * `Npc.description`: `JSON.stringify` out, `JSON.parse` back). Detect that
+     * shape without trusting it: a plain-text message must never be mistaken for
+     * a document, so this requires an array whose first entry is an object with
+     * a string `type`, which is the minimal shape of a BlockNote block.
+     */
+    private parseBlockNoteDocument;
+    /**
+     * Derive from a user message: the markdown to persist (mention links kept, so
+     * the thread can re-render them), a plain-text form for the thread title, and
+     * the validated entity mentions to pin into the turn's focus context.
+     *
+     * Plain-text input passes straight through, so apps without a rich composer
+     * are unaffected.
+     */
+    private resolveUserTurnInput;
+    /**
+     * Materialise REFERENCES edges from the USER message to the entities that
+     * message named. The reference metadata is fixed: a mention is an explicit,
+     * maximally relevant pointer, not a ranked retrieval hit.
+     */
+    private linkPinnedMentions;
+    /**
+     * Drop records that fall outside the run's scope root, grouping by JSON:API
+     * type so `ScopeGuard` can build one predicate per type. A no-op for an
+     * unscoped run — `ScopeGuard.filter` returns everything in that case, so the
+     * short-circuit only avoids a pointless round trip.
+     */
+    private filterByScope;
     /**
      * Resolve the content scope from the assistant's BOUND_TO relationship if
-     * loaded. Mirrors the inline logic in `runAgentTurn`.
+     * loaded.
      */
     private resolveContentScope;
     /**

package/dist/foundations/assistant/services/assistant.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant/services/assistant.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"assistant.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant/services/assistant.service.ts"],"names":[],"mappings":"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"}