@carlonicora/nestjs-neo4jsonapi 1.97.0 → 1.98.0

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"}

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

@@ -0,0 +1,131 @@
+"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.AssistantActionRepository = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const assistant_action_1 = require("../entities/assistant-action");
+const assistant_action_meta_1 = require("../entities/assistant-action.meta");
+/**
+ * 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`).
+ */
+let AssistantActionRepository = class AssistantActionRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = assistant_action_1.AssistantActionDescriptor;
+    }
+    buildUserHasAccess() {
+        const { nodeName } = this.descriptor.model;
+        return `WITH ${nodeName}
+            WHERE EXISTS {
+              MATCH (${nodeName})<-[:HAS_ACTION]-(:Assistant)-[:CREATED_BY]->(:User {id: $currentUserId})
+            }
+            WITH ${nodeName}`;
+    }
+    /**
+     * 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.
+     */
+    async resolveStatus(params) {
+        const query = this.neo4j.initQuery({ serialiser: assistant_action_1.AssistantActionDescriptor.model });
+        query.queryParams = { ...query.queryParams, searchValue: params.id, from: params.from, to: params.to };
+        query.query += `
+      ${this.buildDefaultMatch({ searchField: "id" })}
+      ${this.securityService.userHasAccess({ validator: () => this.buildUserHasAccess() })}
+      SET ${assistant_action_meta_1.assistantActionMeta.nodeName}.updatedAt = ${assistant_action_meta_1.assistantActionMeta.nodeName}.updatedAt
+      WITH ${assistant_action_meta_1.assistantActionMeta.nodeName}
+      WHERE ${assistant_action_meta_1.assistantActionMeta.nodeName}.status = $from AND ${assistant_action_meta_1.assistantActionMeta.nodeName}.expiresAt > datetime()
+      SET ${assistant_action_meta_1.assistantActionMeta.nodeName}.status = $to,
+          ${assistant_action_meta_1.assistantActionMeta.nodeName}.resolvedAt = datetime(),
+          ${assistant_action_meta_1.assistantActionMeta.nodeName}.updatedAt = datetime()
+      WITH ${assistant_action_meta_1.assistantActionMeta.nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        // writeOne (not readOne): the query contains SET, which Neo4j rejects
+        // inside a read transaction. writeOne shares QueryType and returns the
+        // serialised entity (or null when the guard did not match).
+        const updated = await this.neo4j.writeOne(query);
+        return !!updated;
+    }
+    /**
+     * 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.
+     */
+    async findAllOverduePendingActions() {
+        const query = this.neo4j.initQuery();
+        query.queryParams = { ...query.queryParams, pendingStatus: "pending" };
+        query.query += `
+      MATCH (${assistant_action_meta_1.assistantActionMeta.nodeName}:${assistant_action_meta_1.assistantActionMeta.labelName} {status: $pendingStatus})-[:BELONGS_TO]->(company:Company)
+      WHERE ${assistant_action_meta_1.assistantActionMeta.nodeName}.expiresAt < datetime()
+      RETURN ${assistant_action_meta_1.assistantActionMeta.nodeName}.id AS assistantActionId, company.id AS companyId
+      ORDER BY ${assistant_action_meta_1.assistantActionMeta.nodeName}.expiresAt ASC
+    `;
+        const result = await this.neo4j.read(query.query, query.queryParams);
+        return result.records.map((record) => ({
+            assistantActionId: record.get("assistantActionId"),
+            companyId: record.get("companyId"),
+        }));
+    }
+    /**
+     * 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.
+     */
+    async expireAction(params) {
+        const query = this.neo4j.initQuery();
+        query.queryParams = {
+            ...query.queryParams,
+            assistantActionId: params.assistantActionId,
+            companyId: params.companyId,
+            pendingStatus: "pending",
+            expiredStatus: "expired",
+        };
+        query.query += `
+      MATCH (${assistant_action_meta_1.assistantActionMeta.nodeName}:${assistant_action_meta_1.assistantActionMeta.labelName} {id: $assistantActionId})-[:BELONGS_TO]->(company:Company {id: $companyId})
+      WHERE ${assistant_action_meta_1.assistantActionMeta.nodeName}.status = $pendingStatus AND ${assistant_action_meta_1.assistantActionMeta.nodeName}.expiresAt < datetime()
+      SET ${assistant_action_meta_1.assistantActionMeta.nodeName}.status = $expiredStatus,
+          ${assistant_action_meta_1.assistantActionMeta.nodeName}.resolvedAt = datetime(),
+          ${assistant_action_meta_1.assistantActionMeta.nodeName}.updatedAt = datetime()
+    `;
+        await this.neo4j.writeOne(query);
+    }
+};
+exports.AssistantActionRepository = AssistantActionRepository;
+exports.AssistantActionRepository = AssistantActionRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], AssistantActionRepository);
+//# sourceMappingURL=assistant-action.repository.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.repository.js","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/repositories/assistant-action.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,mEAAiH;AACjH,6EAAwE;AAExE;;;;;;GAMG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,wCAG9C;IAGC,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,4CAAyB,CAAC;IAI1D,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;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,aAAa,CAAC,MAInB;QACC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,4CAAyB,CAAC,KAAK,EAAE,CAAC,CAAC;QACpF,KAAK,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QACvG,KAAK,CAAC,KAAK,IAAI;QACX,IAAI,CAAC,iBAAiB,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;YAC9E,2CAAmB,CAAC,QAAQ,gBAAgB,2CAAmB,CAAC,QAAQ;aACvE,2CAAmB,CAAC,QAAQ;cAC3B,2CAAmB,CAAC,QAAQ,uBAAuB,2CAAmB,CAAC,QAAQ;YACjF,2CAAmB,CAAC,QAAQ;YAC5B,2CAAmB,CAAC,QAAQ;YAC5B,2CAAmB,CAAC,QAAQ;aAC3B,2CAAmB,CAAC,QAAQ;QACjC,IAAI,CAAC,oBAAoB,EAAE;KAC9B,CAAC;QACF,sEAAsE;QACtE,uEAAuE;QACvE,4DAA4D;QAC5D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjD,OAAO,CAAC,CAAC,OAAO,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,4BAA4B;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,aAAa,EAAE,SAAyC,EAAE,CAAC;QACvG,KAAK,CAAC,KAAK,IAAI;eACJ,2CAAmB,CAAC,QAAQ,IAAI,2CAAmB,CAAC,SAAS;cAC9D,2CAAmB,CAAC,QAAQ;eAC3B,2CAAmB,CAAC,QAAQ;iBAC1B,2CAAmB,CAAC,QAAQ;KACxC,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACrE,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACrC,iBAAiB,EAAE,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAW;YAC5D,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAW;SAC7C,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,MAAwD;QACzE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,WAAW,GAAG;YAClB,GAAG,KAAK,CAAC,WAAW;YACpB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,aAAa,EAAE,SAAyC;YACxD,aAAa,EAAE,SAAyC;SACzD,CAAC;QACF,KAAK,CAAC,KAAK,IAAI;eACJ,2CAAmB,CAAC,QAAQ,IAAI,2CAAmB,CAAC,SAAS;cAC9D,2CAAmB,CAAC,QAAQ,gCAAgC,2CAAmB,CAAC,QAAQ;YAC1F,2CAAmB,CAAC,QAAQ;YAC5B,2CAAmB,CAAC,QAAQ;YAC5B,2CAAmB,CAAC,QAAQ;KACnC,CAAC;QACF,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AA9GY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,mBAAU,GAAE;qCAOQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAN9E,yBAAyB,CA8GrC"}

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

@@ -0,0 +1,48 @@
+import { ClsService } from "nestjs-cls";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { AssistantAction, AssistantActionDescriptor } from "../entities/assistant-action";
+import { AssistantActionRepository } from "../repositories/assistant-action.repository";
+export declare class AssistantActionService extends AbstractService<AssistantAction, typeof AssistantActionDescriptor.relationships> {
+    private readonly assistantActionRepository;
+    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(jsonApiService: JsonApiService, assistantActionRepository: AssistantActionRepository, clsService: ClsService);
+    /**
+     * Internal creation of a pending action (used by the operator turn flow when
+     * a run interrupts on a destructive tool call). Goes through `createFromDTO`
+     * — the framework path — so `expiresAt` (ISO string) is auto-cast to a Neo4j
+     * datetime by the descriptor.
+     */
+    createPendingAction(params: {
+        id?: string;
+        toolName: string;
+        toolArgs: string;
+        summary: string;
+        threadId: string;
+        userModuleIds: string;
+        contentScope?: string;
+        expiresAt: string;
+        assistantId: string;
+        messageId?: string;
+    }): Promise<AssistantAction>;
+}
+//# sourceMappingURL=assistant-action.service.d.ts.map