@carlonicora/nestjs-neo4jsonapi 1.96.0 → 1.98.0

package/dist/foundations/assistant-action/assistant-action.module.d.ts

@@ -0,0 +1,5 @@
+import { OnModuleInit } from "@nestjs/common";
+export declare class AssistantActionModule implements OnModuleInit {
+    onModuleInit(): void;
+}
+//# sourceMappingURL=assistant-action.module.d.ts.map

package/dist/foundations/assistant-action/assistant-action.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/assistant-action/assistant-action.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAYlE,qBAca,qBAAsB,YAAW,YAAY;IACxD,YAAY;CAGb"}

package/dist/foundations/assistant-action/assistant-action.module.js

@@ -0,0 +1,43 @@
+"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.AssistantActionModule = void 0;
+const common_1 = require("@nestjs/common");
+const conditional_service_decorator_1 = require("../../common/decorators/conditional-service.decorator");
+const registry_1 = require("../../common/registries/registry");
+const logging_module_1 = require("../../core/logging/logging.module");
+const assistant_module_1 = require("../assistant/assistant.module");
+const audit_module_1 = require("../audit/audit.module");
+const assistant_action_controller_1 = require("./controllers/assistant-action.controller");
+const assistant_action_expiry_cron_1 = require("./cron/assistant-action.expiry.cron");
+const assistant_action_1 = require("./entities/assistant-action");
+const assistant_action_repository_1 = require("./repositories/assistant-action.repository");
+const assistant_action_service_1 = require("./services/assistant-action.service");
+let AssistantActionModule = class AssistantActionModule {
+    onModuleInit() {
+        registry_1.modelRegistry.register(assistant_action_1.AssistantActionDescriptor.model);
+    }
+};
+exports.AssistantActionModule = AssistantActionModule;
+exports.AssistantActionModule = AssistantActionModule = __decorate([
+    (0, common_1.Module)({
+        // forwardRef: the controller needs AssistantService (resolveAction), while
+        // the operator turn flow in AssistantModule needs this module's service /
+        // repository to create and resolve pending actions.
+        imports: [(0, common_1.forwardRef)(() => assistant_module_1.AssistantModule), audit_module_1.AuditModule, logging_module_1.LoggingModule],
+        controllers: [assistant_action_controller_1.AssistantActionController],
+        providers: [
+            assistant_action_1.AssistantActionDescriptor.model.serialiser,
+            assistant_action_repository_1.AssistantActionRepository,
+            assistant_action_service_1.AssistantActionService,
+            (0, conditional_service_decorator_1.createWorkerProvider)(assistant_action_expiry_cron_1.AssistantActionExpiryCron),
+        ],
+        exports: [assistant_action_service_1.AssistantActionService, assistant_action_repository_1.AssistantActionRepository],
+    })
+], AssistantActionModule);
+//# sourceMappingURL=assistant-action.module.js.map

package/dist/foundations/assistant-action/assistant-action.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.module.js","sourceRoot":"","sources":["../../../src/foundations/assistant-action/assistant-action.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAkE;AAClE,yGAA6F;AAC7F,+DAAiE;AACjE,sEAAkE;AAClE,oEAAgE;AAChE,wDAAoD;AACpD,2FAAsF;AACtF,sFAAgF;AAChF,kEAAwE;AACxE,4FAAuF;AACvF,kFAA6E;AAgBtE,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAAY;QACV,wBAAa,CAAC,QAAQ,CAAC,4CAAyB,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;CACF,CAAA;AAJY,sDAAqB;gCAArB,qBAAqB;IAdjC,IAAA,eAAM,EAAC;QACN,2EAA2E;QAC3E,0EAA0E;QAC1E,oDAAoD;QACpD,OAAO,EAAE,CAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,kCAAe,CAAC,EAAE,0BAAW,EAAE,8BAAa,CAAC;QACxE,WAAW,EAAE,CAAC,uDAAyB,CAAC;QACxC,SAAS,EAAE;YACT,4CAAyB,CAAC,KAAK,CAAC,UAAU;YAC1C,uDAAyB;YACzB,iDAAsB;YACtB,IAAA,oDAAoB,EAAC,wDAAyB,CAAC;SAChD;QACD,OAAO,EAAE,CAAC,iDAAsB,EAAE,uDAAyB,CAAC;KAC7D,CAAC;GACW,qBAAqB,CAIjC"}

package/dist/foundations/assistant-action/controllers/assistant-action.controller.d.ts

@@ -0,0 +1,30 @@
+import { FastifyReply, FastifyRequest } from "fastify";
+import { CacheService } from "../../../core/cache/services/cache.service";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AuditService } from "../../audit/services/audit.service";
+import { AssistantService } from "../../assistant/services/assistant.service";
+import { AssistantActionService } from "../services/assistant-action.service";
+export declare class AssistantActionController {
+    private readonly assistantActions;
+    private readonly assistants;
+    private readonly jsonApi;
+    private readonly auditService;
+    private readonly cacheService;
+    private readonly crud;
+    constructor(assistantActions: AssistantActionService, assistants: AssistantService, jsonApi: JsonApiService, auditService: AuditService, cacheService: CacheService);
+    findById(request: FastifyRequest, reply: FastifyReply, actionId: string): Promise<void>;
+    /**
+     * POST /assistant-actions/:actionId/approve — resolve the pending action and
+     * resume the frozen operator run with approval. Synchronously returns the
+     * final assistant message (JSON:API) with the resolved action included.
+     */
+    approve(request: FastifyRequest, reply: FastifyReply, actionId: string): Promise<void>;
+    /**
+     * POST /assistant-actions/:actionId/deny — resolve the pending action and
+     * resume with denial. Returns the wrap-up assistant message with the
+     * resolved action included.
+     */
+    deny(request: FastifyRequest, reply: FastifyReply, actionId: string): Promise<void>;
+    private resolve;
+}
+//# sourceMappingURL=assistant-action.controller.d.ts.map

package/dist/foundations/assistant-action/controllers/assistant-action.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.controller.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/controllers/assistant-action.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAIvD,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAI9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,qBAEa,yBAAyB;IAIlC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAP/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmD;gBAGrD,gBAAgB,EAAE,sBAAsB,EACxC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY;IAMvC,QAAQ,CAAQ,OAAO,EAAE,cAAc,EAAS,KAAK,EAAE,YAAY,EAAqB,QAAQ,EAAE,MAAM;IAI9G;;;;OAIG;IAGG,OAAO,CAAQ,OAAO,EAAE,cAAc,EAAS,KAAK,EAAE,YAAY,EAAqB,QAAQ,EAAE,MAAM;IAI7G;;;;OAIG;IAGG,IAAI,CAAQ,OAAO,EAAE,cAAc,EAAS,KAAK,EAAE,YAAY,EAAqB,QAAQ,EAAE,MAAM;YAI5F,OAAO;CAqBtB"}

package/dist/foundations/assistant-action/controllers/assistant-action.controller.js

@@ -0,0 +1,119 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssistantActionController = void 0;
+const common_1 = require("@nestjs/common");
+const decorators_1 = require("../../../common/decorators");
+const jwt_auth_guard_1 = require("../../../common/guards/jwt.auth.guard");
+const crud_handlers_1 = require("../../../common/handlers/crud.handlers");
+const cache_service_1 = require("../../../core/cache/services/cache.service");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const audit_service_1 = require("../../audit/services/audit.service");
+const assistant_service_1 = require("../../assistant/services/assistant.service");
+const assistant_message_1 = require("../../assistant-message/entities/assistant-message");
+const assistant_action_1 = require("../entities/assistant-action");
+const assistant_action_meta_1 = require("../entities/assistant-action.meta");
+const assistant_action_service_1 = require("../services/assistant-action.service");
+let AssistantActionController = class AssistantActionController {
+    constructor(assistantActions, assistants, jsonApi, auditService, cacheService) {
+        this.assistantActions = assistantActions;
+        this.assistants = assistants;
+        this.jsonApi = jsonApi;
+        this.auditService = auditService;
+        this.cacheService = cacheService;
+        this.crud = (0, crud_handlers_1.createCrudHandlers)(() => this.assistantActions);
+    }
+    // GET /assistant-actions/:actionId
+    async findById(request, reply, actionId) {
+        return this.crud.findById(reply, actionId);
+    }
+    /**
+     * POST /assistant-actions/:actionId/approve — resolve the pending action and
+     * resume the frozen operator run with approval. Synchronously returns the
+     * final assistant message (JSON:API) with the resolved action included.
+     */
+    async approve(request, reply, actionId) {
+        return this.resolve(reply, actionId, true);
+    }
+    /**
+     * POST /assistant-actions/:actionId/deny — resolve the pending action and
+     * resume with denial. Returns the wrap-up assistant message with the
+     * resolved action included.
+     */
+    async deny(request, reply, actionId) {
+        return this.resolve(reply, actionId, false);
+    }
+    async resolve(reply, actionId, approved) {
+        const { assistantMessage, action } = await this.assistants.resolveAction({ actionId, approved });
+        const document = await this.jsonApi.buildSingle(assistant_message_1.AssistantMessageDescriptor.model, assistantMessage);
+        const actionDocument = await this.jsonApi.buildSingle(assistant_action_1.AssistantActionDescriptor.model, action);
+        // Merge the resolved action into `included`, deduping by (type,id) and
+        // never echoing the primary message resource back into `included`.
+        const merged = [...(document.included ?? []), actionDocument.data, ...(actionDocument.included ?? [])];
+        const seen = new Set();
+        document.included = merged.filter((resource) => {
+            if (!resource)
+                return false;
+            if (resource.type === document.data?.type && resource.id === document.data?.id)
+                return false;
+            const key = `${resource.type}-${resource.id}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+        reply.send(document);
+    }
+};
+exports.AssistantActionController = AssistantActionController;
+__decorate([
+    (0, common_1.Get)(`${assistant_action_meta_1.assistantActionMeta.endpoint}/:actionId`),
+    (0, decorators_1.Audit)(assistant_action_meta_1.assistantActionMeta, "actionId"),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Res)()),
+    __param(2, (0, common_1.Param)("actionId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String]),
+    __metadata("design:returntype", Promise)
+], AssistantActionController.prototype, "findById", null);
+__decorate([
+    (0, common_1.Post)(`${assistant_action_meta_1.assistantActionMeta.endpoint}/:actionId/approve`),
+    (0, decorators_1.CacheInvalidate)(assistant_action_meta_1.assistantActionMeta, "actionId"),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Res)()),
+    __param(2, (0, common_1.Param)("actionId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String]),
+    __metadata("design:returntype", Promise)
+], AssistantActionController.prototype, "approve", null);
+__decorate([
+    (0, common_1.Post)(`${assistant_action_meta_1.assistantActionMeta.endpoint}/:actionId/deny`),
+    (0, decorators_1.CacheInvalidate)(assistant_action_meta_1.assistantActionMeta, "actionId"),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Res)()),
+    __param(2, (0, common_1.Param)("actionId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String]),
+    __metadata("design:returntype", Promise)
+], AssistantActionController.prototype, "deny", null);
+exports.AssistantActionController = AssistantActionController = __decorate([
+    (0, common_1.UseGuards)(jwt_auth_guard_1.JwtAuthGuard),
+    (0, common_1.Controller)(),
+    __metadata("design:paramtypes", [assistant_action_service_1.AssistantActionService,
+        assistant_service_1.AssistantService,
+        jsonapi_service_1.JsonApiService,
+        audit_service_1.AuditService,
+        cache_service_1.CacheService])
+], AssistantActionController);
+//# sourceMappingURL=assistant-action.controller.js.map

package/dist/foundations/assistant-action/controllers/assistant-action.controller.js.map

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

package/dist/foundations/assistant-action/cron/assistant-action.expiry.cron.d.ts

@@ -0,0 +1,9 @@
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { AssistantActionRepository } from "../repositories/assistant-action.repository";
+export declare class AssistantActionExpiryCron {
+    private readonly assistantActionRepository;
+    private readonly logger;
+    constructor(assistantActionRepository: AssistantActionRepository, logger: AppLoggingService);
+    handleOverdueActions(): Promise<void>;
+}
+//# sourceMappingURL=assistant-action.expiry.cron.d.ts.map

package/dist/foundations/assistant-action/cron/assistant-action.expiry.cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.expiry.cron.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/cron/assistant-action.expiry.cron.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAExF,qBACa,yBAAyB;IAElC,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,yBAAyB,EAAE,yBAAyB,EACpD,MAAM,EAAE,iBAAiB;IAItC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;CAa5C"}

package/dist/foundations/assistant-action/cron/assistant-action.expiry.cron.js

@@ -0,0 +1,46 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssistantActionExpiryCron = void 0;
+const common_1 = require("@nestjs/common");
+const schedule_1 = require("@nestjs/schedule");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+const assistant_action_repository_1 = require("../repositories/assistant-action.repository");
+let AssistantActionExpiryCron = class AssistantActionExpiryCron {
+    constructor(assistantActionRepository, logger) {
+        this.assistantActionRepository = assistantActionRepository;
+        this.logger = logger;
+    }
+    async handleOverdueActions() {
+        const overdueActions = await this.assistantActionRepository.findAllOverduePendingActions();
+        for (const { assistantActionId, companyId } of overdueActions) {
+            try {
+                await this.assistantActionRepository.expireAction({ assistantActionId, companyId });
+            }
+            catch (error) {
+                this.logger.error(`Failed to expire assistant action ${assistantActionId} for company ${companyId}: ${error.message}`, "AssistantActionExpiryCron");
+            }
+        }
+    }
+};
+exports.AssistantActionExpiryCron = AssistantActionExpiryCron;
+__decorate([
+    (0, schedule_1.Cron)(schedule_1.CronExpression.EVERY_HOUR),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AssistantActionExpiryCron.prototype, "handleOverdueActions", null);
+exports.AssistantActionExpiryCron = AssistantActionExpiryCron = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [assistant_action_repository_1.AssistantActionRepository,
+        logging_service_1.AppLoggingService])
+], AssistantActionExpiryCron);
+//# sourceMappingURL=assistant-action.expiry.cron.js.map

package/dist/foundations/assistant-action/cron/assistant-action.expiry.cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.expiry.cron.js","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/cron/assistant-action.expiry.cron.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,+CAAwD;AACxD,oFAAmF;AACnF,6FAAwF;AAGjF,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IACpC,YACmB,yBAAoD,EACpD,MAAyB;QADzB,8BAAyB,GAAzB,yBAAyB,CAA2B;QACpD,WAAM,GAAN,MAAM,CAAmB;IACzC,CAAC;IAGE,AAAN,KAAK,CAAC,oBAAoB;QACxB,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,4BAA4B,EAAE,CAAC;QAC3F,KAAK,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,IAAI,cAAc,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,yBAAyB,CAAC,YAAY,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,CAAC;YACtF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,qCAAqC,iBAAiB,gBAAgB,SAAS,KAAM,KAAe,CAAC,OAAO,EAAE,EAC9G,2BAA2B,CAC5B,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAA;AApBY,8DAAyB;AAO9B;IADL,IAAA,eAAI,EAAC,yBAAc,CAAC,UAAU,CAAC;;;;qEAa/B;oCAnBU,yBAAyB;IADrC,IAAA,mBAAU,GAAE;qCAGmC,uDAAyB;QAC5C,mCAAiB;GAHjC,yBAAyB,CAoBrC"}

package/dist/foundations/assistant-action/entities/assistant-action.d.ts

@@ -0,0 +1,49 @@
+import { Entity } from "../../../common";
+import type { Company } from "../../company/entities/company";
+import type { Assistant } from "../../assistant/entities/assistant";
+import type { AssistantMessage } from "../../assistant-message/entities/assistant-message";
+export type AssistantActionStatus = "pending" | "approved" | "denied" | "expired" | "executed" | "failed";
+/**
+ * AssistantAction — a durable, first-class record of a destructive tool call
+ * awaiting (or having received) human approval. Survives Redis checkpoint loss
+ * and acts as the audit trail for operator approval gates.
+ *
+ * `requestedAt` is intentionally NOT a field — the framework's `createdAt`
+ * covers it.
+ */
+export type AssistantAction = Entity & {
+    status: AssistantActionStatus;
+    toolName: string;
+    toolArgs: string;
+    summary: string;
+    threadId: string;
+    userModuleIds: string;
+    contentScope?: string;
+    resolvedAt?: string;
+    expiresAt: string;
+    company: Company;
+    assistant: Assistant;
+    message?: AssistantMessage;
+};
+export declare const AssistantActionDescriptor: import("../../../common").EntityDescriptor<AssistantAction, {
+    assistant: {
+        model: import("../../../common").DataMeta;
+        direction: "in";
+        relationship: string;
+        cardinality: "one";
+        required: true;
+        dtoKey: string;
+        immutable: true;
+    };
+    message: {
+        model: import("../../../common").DataMeta;
+        direction: "in";
+        relationship: string;
+        cardinality: "one";
+        required: false;
+        dtoKey: string;
+        immutable: true;
+    };
+}>;
+export type AssistantActionDescriptorType = typeof AssistantActionDescriptor;
+//# sourceMappingURL=assistant-action.d.ts.map

package/dist/foundations/assistant-action/entities/assistant-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/entities/assistant-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAI3F,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1G;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG;IACrC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;EAkCpC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,OAAO,yBAAyB,CAAC"}

package/dist/foundations/assistant-action/entities/assistant-action.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssistantActionDescriptor = void 0;
+const common_1 = require("../../../common");
+const assistant_meta_1 = require("../../assistant/entities/assistant.meta");
+const assistant_message_meta_1 = require("../../assistant-message/entities/assistant-message.meta");
+const assistant_action_meta_1 = require("./assistant-action.meta");
+exports.AssistantActionDescriptor = (0, common_1.defineEntity)()({
+    ...assistant_action_meta_1.assistantActionMeta,
+    isCompanyScoped: true,
+    fields: {
+        status: { type: "string" },
+        toolName: { type: "string" },
+        toolArgs: { type: "string" },
+        summary: { type: "string" },
+        threadId: { type: "string" },
+        userModuleIds: { type: "string" },
+        contentScope: { type: "string" },
+        resolvedAt: { type: "datetime" },
+        expiresAt: { type: "datetime", required: true },
+    },
+    relationships: {
+        assistant: {
+            model: assistant_meta_1.assistantMeta,
+            direction: "in", // the Assistant owns the action: (Assistant)-[:HAS_ACTION]->(AssistantAction)
+            relationship: "HAS_ACTION",
+            cardinality: "one",
+            required: true,
+            dtoKey: "assistant",
+            immutable: true,
+        },
+        message: {
+            model: assistant_message_meta_1.assistantMessageMeta,
+            direction: "in", // (AssistantMessage)-[:REQUESTED_IN]->(AssistantAction)
+            relationship: "REQUESTED_IN",
+            cardinality: "one",
+            required: false,
+            dtoKey: "message",
+            immutable: true,
+        },
+    },
+});
+//# sourceMappingURL=assistant-action.js.map

package/dist/foundations/assistant-action/entities/assistant-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.js","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/entities/assistant-action.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AAGvD,4EAAwE;AAExE,oGAA+F;AAC/F,mEAA8D;AA2BjD,QAAA,yBAAyB,GAAG,IAAA,qBAAY,GAAmB,CAAC;IACvE,GAAG,2CAAmB;IACtB,eAAe,EAAE,IAAI;IACrB,MAAM,EAAE;QACN,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACjC,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAChC,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;KAChD;IACD,aAAa,EAAE;QACb,SAAS,EAAE;YACT,KAAK,EAAE,8BAAa;YACpB,SAAS,EAAE,IAAI,EAAE,8EAA8E;YAC/F,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,IAAI;SAChB;QACD,OAAO,EAAE;YACP,KAAK,EAAE,6CAAoB;YAC3B,SAAS,EAAE,IAAI,EAAE,wDAAwD;YACzE,YAAY,EAAE,cAAc;YAC5B,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI;SAChB;KACF;CACF,CAAC,CAAC"}

package/dist/foundations/assistant-action/entities/assistant-action.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const assistantActionMeta: DataMeta;
+//# sourceMappingURL=assistant-action.meta.d.ts.map

package/dist/foundations/assistant-action/entities/assistant-action.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/entities/assistant-action.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,mBAAmB,EAAE,QAKjC,CAAC"}

package/dist/foundations/assistant-action/entities/assistant-action.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assistantActionMeta = void 0;
+exports.assistantActionMeta = {
+    type: "assistant-actions",
+    endpoint: "assistant-actions",
+    nodeName: "assistantAction",
+    labelName: "AssistantAction",
+};
+//# sourceMappingURL=assistant-action.meta.js.map

package/dist/foundations/assistant-action/entities/assistant-action.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.meta.js","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/entities/assistant-action.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,mBAAmB,GAAa;IAC3C,IAAI,EAAE,mBAAmB;IACzB,QAAQ,EAAE,mBAAmB;IAC7B,QAAQ,EAAE,iBAAiB;IAC3B,SAAS,EAAE,iBAAiB;CAC7B,CAAC"}

package/dist/foundations/assistant-action/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./entities/assistant-action.meta";
+export * from "./entities/assistant-action";
+export * from "./repositories/assistant-action.repository";
+export * from "./services/assistant-action.service";
+export * from "./controllers/assistant-action.controller";
+export * from "./assistant-action.module";
+//# sourceMappingURL=index.d.ts.map

package/dist/foundations/assistant-action/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/assistant-action/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2BAA2B,CAAC"}

package/dist/foundations/assistant-action/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./entities/assistant-action.meta"), exports);
+__exportStar(require("./entities/assistant-action"), exports);
+__exportStar(require("./repositories/assistant-action.repository"), exports);
+__exportStar(require("./services/assistant-action.service"), exports);
+__exportStar(require("./controllers/assistant-action.controller"), exports);
+__exportStar(require("./assistant-action.module"), exports);
+//# sourceMappingURL=index.js.map

package/dist/foundations/assistant-action/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/assistant-action/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAiD;AACjD,8DAA4C;AAC5C,6EAA2D;AAC3D,sEAAoD;AACpD,4EAA0D;AAC1D,4DAA0C"}

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

@@ -0,0 +1,81 @@
+import { ClsService } from "nestjs-cls";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { AssistantAction, AssistantActionDescriptor, AssistantActionStatus } from "../entities/assistant-action";
+/**
+ * AssistantActionRepository
+ *
+ * Owner-RBAC is inherited from the parent Assistant (a user may only see the
+ * actions that belong to their own assistants). Company scope is applied
+ * automatically via `buildDefaultMatch()` (`isCompanyScoped: true`).
+ */
+export declare class AssistantActionRepository extends AbstractRepository<AssistantAction, typeof AssistantActionDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<AssistantAction, {
+        assistant: {
+            model: import("../../..").DataMeta;
+            direction: "in";
+            relationship: string;
+            cardinality: "one";
+            required: true;
+            dtoKey: string;
+            immutable: true;
+        };
+        message: {
+            model: import("../../..").DataMeta;
+            direction: "in";
+            relationship: string;
+            cardinality: "one";
+            required: false;
+            dtoKey: string;
+            immutable: true;
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    protected buildUserHasAccess(): string;
+    /**
+     * Atomically transition the action's status from `from` to `to`, guarded in
+     * Cypher so that only one of N concurrent attempts wins (`WHERE status =
+     * $from`). Also requires `expiresAt` to be in the future — expired actions
+     * can no longer be resolved.
+     *
+     * Under Neo4j's read-committed isolation a plain `MATCH … WHERE … SET` is
+     * check-then-set: the WHERE is evaluated before the write lock is acquired
+     * at SET and is NOT re-evaluated afterwards, so two concurrent approves
+     * could both pass the guard. The no-op `SET updatedAt = updatedAt` acquires
+     * the node's write lock BEFORE the guard (standard Neo4j CAS idiom), making
+     * the guard + transition atomic.
+     *
+     * Owner-RBAC (`buildUserHasAccess`) is injected via
+     * `securityService.userHasAccess()`, mirroring the framework's standard
+     * write path in AbstractRepository.
+     *
+     * Returns true when this call won the transition, false otherwise.
+     */
+    resolveStatus(params: {
+        id: string;
+        from: AssistantActionStatus;
+        to: AssistantActionStatus;
+    }): Promise<boolean>;
+    /**
+     * Cross-company sweep used by AssistantActionExpiryCron (runs outside any
+     * request, so there is no CLS company context). Mirrors
+     * CommunityRepository.findAllStaleCommunities(): the read returns
+     * id + companyId pairs so that every subsequent write stays company-scoped.
+     */
+    findAllOverduePendingActions(): Promise<{
+        assistantActionId: string;
+        companyId: string;
+    }[]>;
+    /**
+     * Company-scoped expiry write for a single overdue pending action, called by
+     * AssistantActionExpiryCron with the companyId resolved by the sweep above.
+     * Guarded on status AND expiresAt so a concurrent approval/denial between
+     * the sweep read and this write is never overwritten.
+     */
+    expireAction(params: {
+        assistantActionId: string;
+        companyId: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=assistant-action.repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/repositories/assistant-action.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,eAAe,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGjH;;;;;;GAMG;AACH,qBACa,yBAA0B,SAAQ,kBAAkB,CAC/D,eAAe,EACf,OAAO,yBAAyB,CAAC,aAAa,CAC/C;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;OAA6B;gBAE9C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAStC;;;;;;;;;;;;;;;;;;OAkBG;IACG,aAAa,CAAC,MAAM,EAAE;QAC1B,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,qBAAqB,CAAC;QAC5B,EAAE,EAAE,qBAAqB,CAAC;KAC3B,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBpB;;;;;OAKG;IACG,4BAA4B,IAAI,OAAO,CAAC;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAgBjG;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkB5F"}