@carlonicora/nestjs-neo4jsonapi 2.4.2 → 2.5.1

package/dist/agents/community.summariser/community.summariser.module.d.ts

@@ -1,3 +1,10 @@
+/**
+ * `CompanyModule` is deliberately NOT imported (same rule as
+ * `agents/drift/drift.module.ts`): it declares `CompanyController`, so importing
+ * it mounts `companies/*` into every consumer and crashes any app that replaces
+ * the company foundation with its own controller. The processor's credit gate
+ * uses the optional `CREDIT_VALIDATOR` seam — see `common/helpers/credit-gate.ts`.
+ */
 export declare class CommunitySummariserModule {
 }
 //# sourceMappingURL=community.summariser.module.d.ts.map

package/dist/agents/community.summariser/community.summariser.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"community.summariser.module.d.ts","sourceRoot":"","sources":["../../../src/agents/community.summariser/community.summariser.module.ts"],"names":[],"mappings":"AAWA,qBAUa,yBAAyB;CAAG"}
+{"version":3,"file":"community.summariser.module.d.ts","sourceRoot":"","sources":["../../../src/agents/community.summariser/community.summariser.module.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,qBAKa,yBAAyB;CAAG"}

package/dist/agents/community.summariser/community.summariser.module.js

@@ -17,17 +17,19 @@ const conditional_service_decorator_1 = require("../../common/decorators/conditi
 const community_summariser_processor_1 = require("./processors/community.summariser.processor");
 const community_summariser_service_1 = require("./services/community.summariser.service");
 const community_summariser_cron_1 = require("./cron/community.summariser.cron");
+/**
+ * `CompanyModule` is deliberately NOT imported (same rule as
+ * `agents/drift/drift.module.ts`): it declares `CompanyController`, so importing
+ * it mounts `companies/*` into every consumer and crashes any app that replaces
+ * the company foundation with its own controller. The processor's credit gate
+ * uses the optional `CREDIT_VALIDATOR` seam — see `common/helpers/credit-gate.ts`.
+ */
 let CommunitySummariserModule = class CommunitySummariserModule {
 };
 exports.CommunitySummariserModule = CommunitySummariserModule;
 exports.CommunitySummariserModule = CommunitySummariserModule = __decorate([
     (0, common_1.Module)({
-        imports: [
-            llm_module_1.LLMModule,
-            logging_module_1.LoggingModule,
-            community_module_1.CommunityModule,
-            bullmq_1.BullModule.registerQueue({ name: config_1.QueueId.COMMUNITY_SUMMARISER }),
-        ],
+        imports: [llm_module_1.LLMModule, logging_module_1.LoggingModule, community_module_1.CommunityModule, bullmq_1.BullModule.registerQueue({ name: config_1.QueueId.COMMUNITY_SUMMARISER })],
         providers: [community_summariser_service_1.CommunitySummariserService, community_summariser_processor_1.CommunitySummariserProcessor, (0, conditional_service_decorator_1.createWorkerProvider)(community_summariser_cron_1.CommunitySummariserCron)],
         exports: [community_summariser_service_1.CommunitySummariserService],
     })

package/dist/agents/community.summariser/community.summariser.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"community.summariser.module.js","sourceRoot":"","sources":["../../../src/agents/community.summariser/community.summariser.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,yCAAuC;AACvC,0DAAsD;AACtD,sEAAkE;AAClE,mFAA+E;AAC/E,yGAA6F;AAC7F,gGAA2F;AAC3F,0FAAqF;AACrF,gFAA2E;AAYpE,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;CAAG,CAAA;AAA5B,8DAAyB;oCAAzB,yBAAyB;IAVrC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,sBAAS;YACT,8BAAa;YACb,kCAAe;YACf,mBAAU,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,gBAAO,CAAC,oBAAoB,EAAE,CAAC;SACjE;QACD,SAAS,EAAE,CAAC,yDAA0B,EAAE,6DAA4B,EAAE,IAAA,oDAAoB,EAAC,mDAAuB,CAAC,CAAC;QACpH,OAAO,EAAE,CAAC,yDAA0B,CAAC;KACtC,CAAC;GACW,yBAAyB,CAAG"}
+{"version":3,"file":"community.summariser.module.js","sourceRoot":"","sources":["../../../src/agents/community.summariser/community.summariser.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,yCAAuC;AACvC,0DAAsD;AACtD,sEAAkE;AAClE,mFAA+E;AAC/E,yGAA6F;AAC7F,gGAA2F;AAC3F,0FAAqF;AACrF,gFAA2E;AAE3E;;;;;;GAMG;AAMI,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;CAAG,CAAA;AAA5B,8DAAyB;oCAAzB,yBAAyB;IALrC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,sBAAS,EAAE,8BAAa,EAAE,kCAAe,EAAE,mBAAU,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,gBAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACtH,SAAS,EAAE,CAAC,yDAA0B,EAAE,6DAA4B,EAAE,IAAA,oDAAoB,EAAC,mDAAuB,CAAC,CAAC;QACpH,OAAO,EAAE,CAAC,yDAA0B,CAAC;KACtC,CAAC;GACW,yBAAyB,CAAG"}

package/dist/agents/community.summariser/processors/community.summariser.processor.d.ts

@@ -1,7 +1,10 @@
 import { WorkerHost } from "@nestjs/bullmq";
 import { Job } from "bullmq";
 import { ClsService } from "nestjs-cls";
+import { CreditValidatorInterface } from "../../../common/tokens";
 import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { WebSocketService } from "../../../core/websocket/services/websocket.service";
+import { CommunityRepository } from "../../../foundations/community/repositories/community.repository";
 import { CommunitySummariserService } from "../services/community.summariser.service";
 interface CommunitySummariserJobData {
     communityId: string;
@@ -11,7 +14,13 @@ export declare class CommunitySummariserProcessor extends WorkerHost {
     private readonly summariserService;
     private readonly cls;
     private readonly logger;
-    constructor(summariserService: CommunitySummariserService, cls: ClsService, logger: AppLoggingService);
+    private readonly communityRepository;
+    private readonly webSocketService;
+    /** See ChunkProcessor: seam, not CompanyService — CompanyModule would mount `companies/*` here. */
+    private readonly creditValidator?;
+    constructor(summariserService: CommunitySummariserService, cls: ClsService, logger: AppLoggingService, communityRepository: CommunityRepository, webSocketService: WebSocketService, 
+    /** See ChunkProcessor: seam, not CompanyService — CompanyModule would mount `companies/*` here. */
+    creditValidator?: CreditValidatorInterface);
     onActive(job: Job): void;
     onError(job: Job): void;
     onCompleted(job: Job): void;

package/dist/agents/community.summariser/processors/community.summariser.processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"community.summariser.processor.d.ts","sourceRoot":"","sources":["../../../../src/agents/community.summariser/processors/community.summariser.processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAEtF,UAAU,0BAA0B;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBACa,4BAA6B,SAAQ,UAAU;IAExD,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,iBAAiB,EAAE,0BAA0B,EAC7C,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,iBAAiB;IAM5C,QAAQ,CAAC,GAAG,EAAE,GAAG;IAKjB,OAAO,CAAC,GAAG,EAAE,GAAG;IAOhB,WAAW,CAAC,GAAG,EAAE,GAAG;IAId,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,0BAA0B,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBnE"}
+{"version":3,"file":"community.summariser.processor.d.ts","sourceRoot":"","sources":["../../../../src/agents/community.summariser/processors/community.summariser.processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAoB,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kEAAkE,CAAC;AACvG,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAEtF,UAAU,0BAA0B;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBACa,4BAA6B,SAAQ,UAAU;IAExD,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,mGAAmG;IAGnG,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBARhB,iBAAiB,EAAE,0BAA0B,EAC7C,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,iBAAiB,EACzB,mBAAmB,EAAE,mBAAmB,EACxC,gBAAgB,EAAE,gBAAgB;IACnD,mGAAmG;IAGlF,eAAe,CAAC,EAAE,wBAAwB;IAM7D,QAAQ,CAAC,GAAG,EAAE,GAAG;IAKjB,OAAO,CAAC,GAAG,EAAE,GAAG;IAOhB,WAAW,CAAC,GAAG,EAAE,GAAG;IAId,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,0BAA0B,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAkCnE"}

package/dist/agents/community.summariser/processors/community.summariser.processor.js

@@ -8,20 +8,31 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommunitySummariserProcessor = void 0;
 const bullmq_1 = require("@nestjs/bullmq");
+const common_1 = require("@nestjs/common");
 const bullmq_2 = require("bullmq");
 const nestjs_cls_1 = require("nestjs-cls");
+const credit_gate_1 = require("../../../common/helpers/credit-gate");
+const tokens_1 = require("../../../common/tokens");
 const config_1 = require("../../../config");
 const logging_service_1 = require("../../../core/logging/services/logging.service");
+const websocket_service_1 = require("../../../core/websocket/services/websocket.service");
+const community_repository_1 = require("../../../foundations/community/repositories/community.repository");
 const community_summariser_service_1 = require("../services/community.summariser.service");
 let CommunitySummariserProcessor = class CommunitySummariserProcessor extends bullmq_1.WorkerHost {
-    constructor(summariserService, cls, logger) {
+    constructor(summariserService, cls, logger, communityRepository, webSocketService, creditValidator) {
         super();
         this.summariserService = summariserService;
         this.cls = cls;
         this.logger = logger;
+        this.communityRepository = communityRepository;
+        this.webSocketService = webSocketService;
+        this.creditValidator = creditValidator;
     }
     onActive(job) {
         this.logger.debug(`Processing community summariser job ${job.name} (ID: ${job.id})`);
@@ -36,6 +47,18 @@ let CommunitySummariserProcessor = class CommunitySummariserProcessor extends bu
         const { communityId, companyId } = job.data;
         await this.cls.run(async () => {
             this.cls.set("companyId", companyId);
+            if (!(await (0, credit_gate_1.hasAvailableCreditsVia)(this.creditValidator, { companyId }))) {
+                // Leave isStale set; flag pendingCredits so the 10-minute cron stops
+                // re-enqueueing it (spec §2: a fresh top-up must not be silently eaten).
+                await this.communityRepository.markPendingCredits(communityId);
+                // Deferrals happen without spend, so the frontend needs this push (spec §4.5).
+                await this.webSocketService.sendMessageToCompany(companyId, "company:ai_backlog_updated", {
+                    type: "company:ai_backlog_updated",
+                    companyId,
+                });
+                this.logger.log(`Deferred community summarisation for community ${communityId} (company ${companyId}) — no available credits`, "CommunitySummariserProcessor");
+                return;
+            }
             this.logger.log(`Starting community summarisation for community ${communityId} (company ${companyId})`, "CommunitySummariserProcessor");
             await this.summariserService.generateSummaryById(communityId);
             this.logger.log(`Completed community summarisation for community ${communityId}`, "CommunitySummariserProcessor");
@@ -63,8 +86,12 @@ __decorate([
 ], CommunitySummariserProcessor.prototype, "onCompleted", null);
 exports.CommunitySummariserProcessor = CommunitySummariserProcessor = __decorate([
     (0, bullmq_1.Processor)(config_1.QueueId.COMMUNITY_SUMMARISER, { concurrency: 1, lockDuration: 1000 * 60 * 5 }),
+    __param(5, (0, common_1.Optional)()),
+    __param(5, (0, common_1.Inject)(tokens_1.CREDIT_VALIDATOR)),
     __metadata("design:paramtypes", [community_summariser_service_1.CommunitySummariserService,
         nestjs_cls_1.ClsService,
-        logging_service_1.AppLoggingService])
+        logging_service_1.AppLoggingService,
+        community_repository_1.CommunityRepository,
+        websocket_service_1.WebSocketService, Object])
 ], CommunitySummariserProcessor);
 //# sourceMappingURL=community.summariser.processor.js.map

package/dist/agents/community.summariser/processors/community.summariser.processor.js.map

@@ -1 +1 @@
-{"version":3,"file":"community.summariser.processor.js","sourceRoot":"","sources":["../../../../src/agents/community.summariser/processors/community.summariser.processor.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAsE;AACtE,mCAA6B;AAC7B,2CAAwC;AACxC,4CAA0C;AAC1C,oFAAmF;AACnF,2FAAsF;AAQ/E,IAAM,4BAA4B,GAAlC,MAAM,4BAA6B,SAAQ,mBAAU;IAC1D,YACmB,iBAA6C,EAC7C,GAAe,EACf,MAAyB;QAE1C,KAAK,EAAE,CAAC;QAJS,sBAAiB,GAAjB,iBAAiB,CAA4B;QAC7C,QAAG,GAAH,GAAG,CAAY;QACf,WAAM,GAAN,MAAM,CAAmB;IAG5C,CAAC;IAGD,QAAQ,CAAC,GAAQ;QACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACvF,CAAC;IAGD,OAAO,CAAC,GAAQ;QACd,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,6CAA6C,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,cAAc,GAAG,CAAC,YAAY,EAAE,CACrG,CAAC;IACJ,CAAC;IAGD,WAAW,CAAC,GAAQ;QAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAoC;QAChD,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;QAE5C,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAErC,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,kDAAkD,WAAW,aAAa,SAAS,GAAG,EACtF,8BAA8B,CAC/B,CAAC;YAEF,MAAM,IAAI,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;YAE9D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,mDAAmD,WAAW,EAAE,EAAE,8BAA8B,CAAC,CAAC;QACpH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA1CY,oEAA4B;AAUvC;IADC,IAAA,sBAAa,EAAC,QAAQ,CAAC;;qCACV,YAAG;;4DAEhB;AAGD;IADC,IAAA,sBAAa,EAAC,QAAQ,CAAC;;qCACX,YAAG;;2DAIf;AAGD;IADC,IAAA,sBAAa,EAAC,WAAW,CAAC;;qCACV,YAAG;;+DAEnB;uCAxBU,4BAA4B;IADxC,IAAA,kBAAS,EAAC,gBAAO,CAAC,oBAAoB,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;qCAGjD,yDAA0B;QACxC,uBAAU;QACP,mCAAiB;GAJjC,4BAA4B,CA0CxC"}
+{"version":3,"file":"community.summariser.processor.js","sourceRoot":"","sources":["../../../../src/agents/community.summariser/processors/community.summariser.processor.ts"],"names":[],"mappings":"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"}

package/dist/common/decorators/conditional-service.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditional-service.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/conditional-service.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,kBAAkB,CAAC;AAE1B;;GAEG;AACH,oBAAY,OAAO;IACjB,GAAG,QAAQ;IACX,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC;AAiBvD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAYhH;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,CAEzF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,CAEtF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,CAc5F;AAED;;GAEG;AACH,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IAElC,UAAU,CAAC,OAAO,EAAE,aAAa;IAIjC,SAAS,CAAC,SAAS,IAAI,OAAO;IAI9B,SAAS,CAAC,YAAY,IAAI,OAAO;IAIjC,SAAS,CAAC,iBAAiB,IAAI,OAAO;IAItC,SAAS,CAAC,iBAAiB,IAAI,OAAO;CAGvC"}
+{"version":3,"file":"conditional-service.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/conditional-service.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,kBAAkB,CAAC;AAE1B;;GAEG;AACH,oBAAY,OAAO;IACjB,GAAG,QAAQ;IACX,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,eAA2B,CAAC;AA6BvD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAYhH;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,CAEzF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,CAEtF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,QAAQ,CAc5F;AAED;;GAEG;AACH,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IAElC,UAAU,CAAC,OAAO,EAAE,aAAa;IAIjC,SAAS,CAAC,SAAS,IAAI,OAAO;IAI9B,SAAS,CAAC,YAAY,IAAI,OAAO;IAIjC,SAAS,CAAC,iBAAiB,IAAI,OAAO;IAItC,SAAS,CAAC,iBAAiB,IAAI,OAAO;CAGvC"}

package/dist/common/decorators/conditional-service.decorator.js

@@ -21,15 +21,25 @@ exports.APP_MODE_TOKEN = Symbol("APP_MODE_TOKEN");
 /**
  * Resolves constructor injection tokens, accounting for @Inject() decorator overrides.
  * NestJS stores custom tokens (from @Inject, @InjectQueue, etc.) in 'self:paramtypes' metadata.
+ *
+ * `@Optional()` is honoured too. Nest records the optional parameter INDEXES in
+ * 'optional:paramtypes' (OPTIONAL_DEPS_METADATA); a factory provider expresses
+ * optionality as `{ token, optional: true }` in its `inject` array, so a bare
+ * token is ALWAYS required. Without this, a class wrapped by
+ * `createWorkerProvider`/`createApiProvider` loses its `@Optional()` markers and
+ * the app crashes at boot with `UnknownDependenciesException` whenever an
+ * optional seam (e.g. CREDIT_VALIDATOR, TOKEN_USAGE_RECORDER) is unbound — a
+ * failure only reproducible in a consumer that does NOT bind that seam.
  */
 function resolveInjectionTokens(ServiceClass) {
     const paramTypes = Reflect.getMetadata("design:paramtypes", ServiceClass) || [];
     const customTokens = Reflect.getMetadata("self:paramtypes", ServiceClass) || [];
+    const optionalIndexes = Reflect.getMetadata("optional:paramtypes", ServiceClass) || [];
     const tokens = [...paramTypes];
     for (const { index, param } of customTokens) {
         tokens[index] = param;
     }
-    return tokens;
+    return tokens.map((token, index) => (optionalIndexes.includes(index) ? { token, optional: true } : token));
 }
 /**
  * Helper function to create conditional providers based on app mode

package/dist/common/decorators/conditional-service.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"conditional-service.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/conditional-service.decorator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conditional-service.decorator.js","sourceRoot":"","sources":["../../../src/common/decorators/conditional-service.decorator.ts"],"names":[],"mappings":"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"}

package/dist/common/enums/ai.status.d.ts

@@ -1,8 +1,36 @@
+/**
+ * Two AI-status vocabularies coexist in this codebase — DO NOT unify them:
+ *
+ * - `AiStatus` (this enum) is the CHUNK-level vocabulary (lowercase snake_case
+ *   values) used by content-chunking / transcription pipelines.
+ * - `EntityAiStatus` (below) is the ENTITY-level vocabulary (PascalCase values)
+ *   already persisted on narr8's 13 KG entities (Campaign, Clue, Consequence,
+ *   Decision, Event, Faction, Goal, Item, Location, Npc, Pc, Secret, Threat).
+ *
+ * Stored values in both are PERMANENT — once written to Neo4j they may never be
+ * renamed, only appended to. This mirrors the precedent set by
+ * `Narr8TokenUsageType`.
+ */
 export declare enum AiStatus {
     Pending = "pending",
     InProgress = "in_progress",
     Completed = "completed",
     Failed = "failed",
-    Summarising = "summarising"
+    Summarising = "summarising",
+    PendingCredits = "pending_credits",
+    Discarded = "discarded"
 }
+/**
+ * Entity-level AI status vocabulary (PascalCase values are what narr8's 13 KG
+ * entities already store). VALUES ARE PERMANENT — see the vocabulary note above.
+ */
+export declare const EntityAiStatus: {
+    readonly Pending: "Pending";
+    readonly Summarising: "Summarising";
+    readonly Completed: "Completed";
+    readonly Failed: "Failed";
+    readonly PendingCredits: "PendingCredits";
+    readonly Discarded: "Discarded";
+};
+export type EntityAiStatus = (typeof EntityAiStatus)[keyof typeof EntityAiStatus];
 //# sourceMappingURL=ai.status.d.ts.map

package/dist/common/enums/ai.status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.status.d.ts","sourceRoot":"","sources":["../../../src/common/enums/ai.status.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,UAAU,gBAAgB;IAC1B,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,WAAW,gBAAgB;CAC5B"}
+{"version":3,"file":"ai.status.d.ts","sourceRoot":"","sources":["../../../src/common/enums/ai.status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,UAAU,gBAAgB;IAC1B,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,WAAW,gBAAgB;IAC3B,cAAc,oBAAoB;IAClC,SAAS,cAAc;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC"}

package/dist/common/enums/ai.status.js

@@ -1,6 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AiStatus = void 0;
+exports.EntityAiStatus = exports.AiStatus = void 0;
+/**
+ * Two AI-status vocabularies coexist in this codebase — DO NOT unify them:
+ *
+ * - `AiStatus` (this enum) is the CHUNK-level vocabulary (lowercase snake_case
+ *   values) used by content-chunking / transcription pipelines.
+ * - `EntityAiStatus` (below) is the ENTITY-level vocabulary (PascalCase values)
+ *   already persisted on narr8's 13 KG entities (Campaign, Clue, Consequence,
+ *   Decision, Event, Faction, Goal, Item, Location, Npc, Pc, Secret, Threat).
+ *
+ * Stored values in both are PERMANENT — once written to Neo4j they may never be
+ * renamed, only appended to. This mirrors the precedent set by
+ * `Narr8TokenUsageType`.
+ */
 var AiStatus;
 (function (AiStatus) {
     AiStatus["Pending"] = "pending";
@@ -8,5 +21,19 @@ var AiStatus;
     AiStatus["Completed"] = "completed";
     AiStatus["Failed"] = "failed";
     AiStatus["Summarising"] = "summarising";
+    AiStatus["PendingCredits"] = "pending_credits";
+    AiStatus["Discarded"] = "discarded";
 })(AiStatus || (exports.AiStatus = AiStatus = {}));
+/**
+ * Entity-level AI status vocabulary (PascalCase values are what narr8's 13 KG
+ * entities already store). VALUES ARE PERMANENT — see the vocabulary note above.
+ */
+exports.EntityAiStatus = {
+    Pending: "Pending",
+    Summarising: "Summarising",
+    Completed: "Completed",
+    Failed: "Failed",
+    PendingCredits: "PendingCredits",
+    Discarded: "Discarded",
+};
 //# sourceMappingURL=ai.status.js.map

package/dist/common/enums/ai.status.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.status.js","sourceRoot":"","sources":["../../../src/common/enums/ai.status.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,+BAAmB,CAAA;IACnB,sCAA0B,CAAA;IAC1B,mCAAuB,CAAA;IACvB,6BAAiB,CAAA;IACjB,uCAA2B,CAAA;AAC7B,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB"}
+{"version":3,"file":"ai.status.js","sourceRoot":"","sources":["../../../src/common/enums/ai.status.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,IAAY,QAQX;AARD,WAAY,QAAQ;IAClB,+BAAmB,CAAA;IACnB,sCAA0B,CAAA;IAC1B,mCAAuB,CAAA;IACvB,6BAAiB,CAAA;IACjB,uCAA2B,CAAA;IAC3B,8CAAkC,CAAA;IAClC,mCAAuB,CAAA;AACzB,CAAC,EARW,QAAQ,wBAAR,QAAQ,QAQnB;AAED;;;GAGG;AACU,QAAA,cAAc,GAAG;IAC5B,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,gBAAgB;IAChC,SAAS,EAAE,WAAW;CACd,CAAC"}

package/dist/common/helpers/credit-gate.d.ts

@@ -0,0 +1,30 @@
+import { CreditValidatorInterface } from "../tokens";
+/**
+ * Non-throwing credit probe for background work.
+ *
+ * Job processors must DEFER rather than fail when a company is out of credits,
+ * so they need a boolean answer. The `CREDIT_VALIDATOR` seam
+ * (`common/tokens.ts`) deliberately exposes only the throwing
+ * `validateCredits`, because its other consumers (HTTP controllers) want the
+ * 402 to propagate. This adapts one to the other.
+ *
+ * Why the seam rather than injecting `CompanyService` directly: `CompanyModule`
+ * declares `CompanyController`, so importing it into a processor's module
+ * mounts `companies/*` into every consumer and crashes any app that replaces
+ * the company foundation with its own controller (the same reasoning already
+ * documented in `agents/drift/drift.module.ts`).
+ *
+ * Semantics:
+ * - No validator bound (app never registered one) → `true`, i.e. ungated,
+ *   matching the "unchanged behaviour for consumers that opt out" contract.
+ * - Validator throws 402 `NO_CREDITS` → `false`, caller defers.
+ * - Validator throws anything else (company lookup failed, Neo4j down, …) →
+ *   RETHROWN. Those are real errors and must not be silently mistaken for an
+ *   empty balance, which would defer the job forever instead of retrying it.
+ * - Credits disabled (`creditCost <= 0`) → the validator is a documented no-op,
+ *   so this returns `true`.
+ */
+export declare function hasAvailableCreditsVia(validator: CreditValidatorInterface | undefined, params: {
+    companyId: string;
+}): Promise<boolean>;
+//# sourceMappingURL=credit-gate.d.ts.map

package/dist/common/helpers/credit-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-gate.d.ts","sourceRoot":"","sources":["../../../src/common/helpers/credit-gate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,wBAAwB,GAAG,SAAS,EAC/C,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/common/helpers/credit-gate.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasAvailableCreditsVia = hasAvailableCreditsVia;
+const common_1 = require("@nestjs/common");
+/**
+ * Non-throwing credit probe for background work.
+ *
+ * Job processors must DEFER rather than fail when a company is out of credits,
+ * so they need a boolean answer. The `CREDIT_VALIDATOR` seam
+ * (`common/tokens.ts`) deliberately exposes only the throwing
+ * `validateCredits`, because its other consumers (HTTP controllers) want the
+ * 402 to propagate. This adapts one to the other.
+ *
+ * Why the seam rather than injecting `CompanyService` directly: `CompanyModule`
+ * declares `CompanyController`, so importing it into a processor's module
+ * mounts `companies/*` into every consumer and crashes any app that replaces
+ * the company foundation with its own controller (the same reasoning already
+ * documented in `agents/drift/drift.module.ts`).
+ *
+ * Semantics:
+ * - No validator bound (app never registered one) → `true`, i.e. ungated,
+ *   matching the "unchanged behaviour for consumers that opt out" contract.
+ * - Validator throws 402 `NO_CREDITS` → `false`, caller defers.
+ * - Validator throws anything else (company lookup failed, Neo4j down, …) →
+ *   RETHROWN. Those are real errors and must not be silently mistaken for an
+ *   empty balance, which would defer the job forever instead of retrying it.
+ * - Credits disabled (`creditCost <= 0`) → the validator is a documented no-op,
+ *   so this returns `true`.
+ */
+async function hasAvailableCreditsVia(validator, params) {
+    if (!validator)
+        return true;
+    try {
+        await validator.validateCredits({ companyId: params.companyId });
+        return true;
+    }
+    catch (error) {
+        if (error instanceof common_1.HttpException && error.getStatus() === common_1.HttpStatus.PAYMENT_REQUIRED)
+            return false;
+        throw error;
+    }
+}
+//# sourceMappingURL=credit-gate.js.map

package/dist/common/helpers/credit-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-gate.js","sourceRoot":"","sources":["../../../src/common/helpers/credit-gate.ts"],"names":[],"mappings":";;AA4BA,wDAaC;AAzCD,2CAA2D;AAG3D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,KAAK,UAAU,sBAAsB,CAC1C,SAA+C,EAC/C,MAA6B;IAE7B,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,sBAAa,IAAI,KAAK,CAAC,SAAS,EAAE,KAAK,mBAAU,CAAC,gBAAgB;YAAE,OAAO,KAAK,CAAC;QACtG,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/common/helpers/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./credit-gate";
 export * from "./define-entity";
 export * from "./map-with-concurrency";
 export * from "./neo4j-date";

package/dist/common/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC"}

package/dist/common/helpers/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./credit-gate"), exports);
 __exportStar(require("./define-entity"), exports);
 __exportStar(require("./map-with-concurrency"), exports);
 __exportStar(require("./neo4j-date"), exports);

package/dist/common/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,yDAAuC;AACvC,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,kDAAgC;AAChC,yDAAuC;AACvC,+CAA6B"}

package/dist/common/tokens.d.ts

@@ -80,4 +80,55 @@ export interface TokenUsageRecorderInterface {
         costOverride?: number;
     }): Promise<void>;
 }
+/**
+ * Application-provided seam for gating AI operations on available company
+ * credits. Mirrors `TOKEN_USAGE_RECORDER` above: package code that needs to
+ * enforce the credit gate resolves this OPTIONAL token rather than injecting
+ * `CompanyService` directly, so consumers that never register a provider see
+ * unchanged (ungated) behaviour.
+ *
+ * `validateCredits` MUST throw `HttpException("NO_CREDITS", HttpStatus.PAYMENT_REQUIRED)`
+ * when the company has no available credits, and MUST be a no-op (never throw)
+ * when credits are disabled (`creditCost <= 0`).
+ *
+ * ## THE GATE FAILS OPEN — read this before relying on it
+ *
+ * Background job processors (`ChunkProcessor`, `ChunkEmbeddingProcessor`,
+ * `CommunitySummariserProcessor`) consult this seam through
+ * `hasAvailableCreditsVia` (`common/helpers/credit-gate.ts`), which turns the
+ * throwing contract above into the non-throwing boolean a processor needs in
+ * order to DEFER rather than fail. Its semantics:
+ *
+ * | Situation                                   | Result                                        |
+ * |---------------------------------------------|-----------------------------------------------|
+ * | No provider bound for `CREDIT_VALIDATOR`    | `true` — work proceeds UNGATED                 |
+ * | Validator throws 402 `NO_CREDITS`           | `false` — job defers (marked `PendingCredits`) |
+ * | Validator throws anything else              | rethrown — never read as an empty balance      |
+ * | Credits disabled (`creditCost <= 0`)        | `true` — validator is a documented no-op       |
+ *
+ * The first row is the dangerous one: **an application that intends to enforce
+ * credits but forgets to bind this token runs entirely ungated, silently.**
+ * Failing open is deliberate — it preserves behaviour for consumers that never
+ * opted in — but it means the binding, not the package, is what enforces
+ * billing. Any consumer enforcing credits MUST register a provider, e.g. from a
+ * `@Global()` module so package-internal code can resolve it from its own
+ * injector:
+ *
+ * ```ts
+ * { provide: CREDIT_VALIDATOR, useExisting: CreditValidatorService }
+ * ```
+ *
+ * A global registration is required rather than merely convenient: a library
+ * module can never import an application feature module, so the binding has to
+ * be visible application-wide.
+ */
+export declare const CREDIT_VALIDATOR: unique symbol;
+/**
+ * Contract implemented by an application-provided credit validator.
+ */
+export interface CreditValidatorInterface {
+    validateCredits(params: {
+        companyId: string;
+    }): Promise<void>;
+}
 //# sourceMappingURL=tokens.d.ts.map

package/dist/common/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/common/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E;;;;GAIG;AAGH,eAAO,MAAM,YAAY,eAAyB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,GAAG,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5F;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,CAAC,MAAM,EAAE;QACvB,MAAM,EAAE,mBAAmB,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,sJAAsJ;QACtJ,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,6HAA6H;QAC7H,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/common/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E;;;;GAIG;AAGH,eAAO,MAAM,YAAY,eAAyB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,GAAG,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5F;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,CAAC,MAAM,EAAE;QACvB,MAAM,EAAE,mBAAmB,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,sJAAsJ;QACtJ,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,6HAA6H;QAC7H,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D"}

package/dist/common/tokens.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOKEN_USAGE_RECORDER = exports.AUTH_CONTEXT_HOOK = exports.SYSTEM_ROLES = void 0;
+exports.CREDIT_VALIDATOR = exports.TOKEN_USAGE_RECORDER = exports.AUTH_CONTEXT_HOOK = exports.SYSTEM_ROLES = void 0;
 /**
  * Injection tokens for common module dependencies
  *
@@ -44,4 +44,47 @@ exports.AUTH_CONTEXT_HOOK = Symbol("AUTH_CONTEXT_HOOK");
  * `AudioLLMService`.
  */
 exports.TOKEN_USAGE_RECORDER = Symbol("TOKEN_USAGE_RECORDER");
+/**
+ * Application-provided seam for gating AI operations on available company
+ * credits. Mirrors `TOKEN_USAGE_RECORDER` above: package code that needs to
+ * enforce the credit gate resolves this OPTIONAL token rather than injecting
+ * `CompanyService` directly, so consumers that never register a provider see
+ * unchanged (ungated) behaviour.
+ *
+ * `validateCredits` MUST throw `HttpException("NO_CREDITS", HttpStatus.PAYMENT_REQUIRED)`
+ * when the company has no available credits, and MUST be a no-op (never throw)
+ * when credits are disabled (`creditCost <= 0`).
+ *
+ * ## THE GATE FAILS OPEN — read this before relying on it
+ *
+ * Background job processors (`ChunkProcessor`, `ChunkEmbeddingProcessor`,
+ * `CommunitySummariserProcessor`) consult this seam through
+ * `hasAvailableCreditsVia` (`common/helpers/credit-gate.ts`), which turns the
+ * throwing contract above into the non-throwing boolean a processor needs in
+ * order to DEFER rather than fail. Its semantics:
+ *
+ * | Situation                                   | Result                                        |
+ * |---------------------------------------------|-----------------------------------------------|
+ * | No provider bound for `CREDIT_VALIDATOR`    | `true` — work proceeds UNGATED                 |
+ * | Validator throws 402 `NO_CREDITS`           | `false` — job defers (marked `PendingCredits`) |
+ * | Validator throws anything else              | rethrown — never read as an empty balance      |
+ * | Credits disabled (`creditCost <= 0`)        | `true` — validator is a documented no-op       |
+ *
+ * The first row is the dangerous one: **an application that intends to enforce
+ * credits but forgets to bind this token runs entirely ungated, silently.**
+ * Failing open is deliberate — it preserves behaviour for consumers that never
+ * opted in — but it means the binding, not the package, is what enforces
+ * billing. Any consumer enforcing credits MUST register a provider, e.g. from a
+ * `@Global()` module so package-internal code can resolve it from its own
+ * injector:
+ *
+ * ```ts
+ * { provide: CREDIT_VALIDATOR, useExisting: CreditValidatorService }
+ * ```
+ *
+ * A global registration is required rather than merely convenient: a library
+ * module can never import an application feature module, so the binding has to
+ * be visible application-wide.
+ */
+exports.CREDIT_VALIDATOR = Symbol("CREDIT_VALIDATOR");
 //# sourceMappingURL=tokens.js.map

package/dist/common/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/common/tokens.ts"],"names":[],"mappings":";;;AAIA;;;;GAIG;AAEH,8BAA8B;AACjB,QAAA,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAUnD;;;;;;;;;GASG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAS7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACU,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/common/tokens.ts"],"names":[],"mappings":";;;AAIA;;;;GAIG;AAEH,8BAA8B;AACjB,QAAA,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAUnD;;;;;;;;;GASG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAS7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACU,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAwBnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACU,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/core/llm/index.d.ts

@@ -12,4 +12,5 @@ export * from "./services/rate-limited-embedder";
 export * from "./services/vision.llm.service";
 export * from "./utils/mock-from-zod";
 export * from "./utils/tools.utils";
+export * from "./utils/vertex.utils";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/llm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0CAA0C,CAAC;AACzD,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0CAA0C,CAAC;AACzD,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/core/llm/index.js

@@ -28,4 +28,5 @@ __exportStar(require("./services/rate-limited-embedder"), exports);
 __exportStar(require("./services/vision.llm.service"), exports);
 __exportStar(require("./utils/mock-from-zod"), exports);
 __exportStar(require("./utils/tools.utils"), exports);
+__exportStar(require("./utils/vertex.utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/core/llm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/llm/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,uDAAqC;AACrC,2DAAyC;AACzC,+CAA6B;AAC7B,+DAA6C;AAC7C,iEAA+C;AAC/C,8DAA4C;AAC5C,2EAAyD;AACzD,yDAAuC;AACvC,2DAAyC;AACzC,mEAAiD;AACjD,gEAA8C;AAC9C,wDAAsC;AACtC,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/llm/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,uDAAqC;AACrC,2DAAyC;AACzC,+CAA6B;AAC7B,+DAA6C;AAC7C,iEAA+C;AAC/C,8DAA4C;AAC5C,2EAAyD;AACzD,yDAAuC;AACvC,2DAAyC;AACzC,mEAAiD;AACjD,gEAA8C;AAC9C,wDAAsC;AACtC,sDAAoC;AACpC,uDAAqC"}

package/dist/core/llm/services/model.service.d.ts.map

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

package/dist/core/llm/services/model.service.js

@@ -63,6 +63,7 @@ const nestjs_cls_1 = require("nestjs-cls");
 const openai_2 = __importStar(require("openai"));
 const logging_service_1 = require("../../logging/services/logging.service");
 const model_weight_1 = require("../enums/model.weight");
+const vertex_utils_1 = require("../utils/vertex.utils");
 const embedder_token_bucket_service_1 = require("./embedder-token-bucket.service");
 const openrouter_fetch_1 = require("./openrouter-fetch");
 const rate_limited_embedder_1 = require("./rate-limited-embedder");
@@ -487,6 +488,10 @@ let ModelService = ModelService_1 = class ModelService {
                     model: cfg.model,
                     temperature,
                     location: cfg.region,
+                    // `region` accepts a region ("europe-west4"), a jurisdictional
+                    // multi-region ("eu"/"us"), or "global". LangChain only builds the
+                    // first and third correctly — see vertexLocationParams.
+                    ...(0, vertex_utils_1.vertexLocationParams)(cfg.region),
                     ...(maxOutputTokens ? { maxOutputTokens } : {}),
                 });
             }
@@ -626,6 +631,8 @@ let ModelService = ModelService_1 = class ModelService {
                 response = new google_vertexai_1.VertexAIEmbeddings({
                     model: embedderConfig.model,
                     location: embedderConfig.region,
+                    // EMBEDDER_REGION accepts a region or a multi-region, same as AI_REGION.
+                    ...(0, vertex_utils_1.vertexLocationParams)(embedderConfig.region),
                     dimensions: embedderConfig.dimensions,
                 });
                 break;