@carlonicora/nestjs-neo4jsonapi 1.96.0 → 1.98.0

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/services/assistant-action.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAGjF,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAExF,qBACa,sBAAuB,SAAQ,eAAe,CACzD,eAAe,EACf,OAAO,yBAAyB,CAAC,aAAa,CAC/C;IAKG,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAJ5C,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;OAA6B;gBAGxD,cAAc,EAAE,cAAc,EACb,yBAAyB,EAAE,yBAAyB,EACrE,UAAU,EAAE,UAAU;IAKxB;;;;;OAKG;IACG,mBAAmB,CAAC,MAAM,EAAE;QAChC,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,eAAe,CAAC;CA0B7B"}

package/dist/foundations/assistant-action/services/assistant-action.service.js

@@ -0,0 +1,67 @@
+"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.AssistantActionService = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const nestjs_cls_1 = require("nestjs-cls");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const assistant_meta_1 = require("../../assistant/entities/assistant.meta");
+const assistant_message_meta_1 = require("../../assistant-message/entities/assistant-message.meta");
+const assistant_action_1 = require("../entities/assistant-action");
+const assistant_action_meta_1 = require("../entities/assistant-action.meta");
+const assistant_action_repository_1 = require("../repositories/assistant-action.repository");
+let AssistantActionService = class AssistantActionService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, assistantActionRepository, clsService) {
+        super(jsonApiService, assistantActionRepository, clsService, assistant_action_1.AssistantActionDescriptor.model);
+        this.assistantActionRepository = assistantActionRepository;
+        this.descriptor = assistant_action_1.AssistantActionDescriptor;
+    }
+    /**
+     * 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.
+     */
+    async createPendingAction(params) {
+        const id = params.id ?? (0, crypto_1.randomUUID)();
+        await this.createFromDTO({
+            data: {
+                type: assistant_action_meta_1.assistantActionMeta.type,
+                id,
+                attributes: {
+                    status: "pending",
+                    toolName: params.toolName,
+                    toolArgs: params.toolArgs,
+                    summary: params.summary,
+                    threadId: params.threadId,
+                    userModuleIds: params.userModuleIds,
+                    ...(params.contentScope !== undefined ? { contentScope: params.contentScope } : {}),
+                    expiresAt: params.expiresAt,
+                },
+                relationships: {
+                    assistant: { data: { type: assistant_meta_1.assistantMeta.type, id: params.assistantId } },
+                    ...(params.messageId ? { message: { data: { type: assistant_message_meta_1.assistantMessageMeta.type, id: params.messageId } } } : {}),
+                },
+            },
+        });
+        return this.assistantActionRepository.findById({ id });
+    }
+};
+exports.AssistantActionService = AssistantActionService;
+exports.AssistantActionService = AssistantActionService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        assistant_action_repository_1.AssistantActionRepository,
+        nestjs_cls_1.ClsService])
+], AssistantActionService);
+//# sourceMappingURL=assistant-action.service.js.map

package/dist/foundations/assistant-action/services/assistant-action.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-action.service.js","sourceRoot":"","sources":["../../../../src/foundations/assistant-action/services/assistant-action.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,mCAAoC;AACpC,2CAAwC;AACxC,oFAAgF;AAChF,qFAAiF;AACjF,4EAAwE;AACxE,oGAA+F;AAC/F,mEAA0F;AAC1F,6EAAwE;AACxE,6FAAwF;AAGjF,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,kCAG3C;IAGC,YACE,cAA8B,EACb,yBAAoD,EACrE,UAAsB;QAEtB,KAAK,CAAC,cAAc,EAAE,yBAAyB,EAAE,UAAU,EAAE,4CAAyB,CAAC,KAAK,CAAC,CAAC;QAH7E,8BAAyB,GAAzB,yBAAyB,CAA2B;QAJpD,eAAU,GAAG,4CAAyB,CAAC;IAQ1D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB,CAAC,MAWzB;QACC,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAA,mBAAU,GAAE,CAAC;QAErC,MAAM,IAAI,CAAC,aAAa,CAAC;YACvB,IAAI,EAAE;gBACJ,IAAI,EAAE,2CAAmB,CAAC,IAAI;gBAC9B,EAAE;gBACF,UAAU,EAAE;oBACV,MAAM,EAAE,SAAS;oBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnF,SAAS,EAAE,MAAM,CAAC,SAAS;iBAC5B;gBACD,aAAa,EAAE;oBACb,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,8BAAa,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE;oBACzE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,6CAAoB,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9G;aACF;SACF,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;CACF,CAAA;AAzDY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;qCAQO,gCAAc;QACc,uDAAyB;QACzD,uBAAU;GATb,sBAAsB,CAyDlC"}

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

@@ -3,6 +3,7 @@ import { PolymorphicDiscriminatorData } from "../../../common/interfaces/entity.
 import type { Company } from "../../company/entities/company";
 import type { Assistant } from "../../assistant/entities/assistant";
 import type { Chunk } from "../../chunk/entities/chunk.entity";
+import type { AssistantAction } from "../../assistant-action/entities/assistant-action";
 export type AssistantMessageRole = "user" | "assistant" | "system";
 export type AssistantMessage = Entity & {
     role: AssistantMessageRole;
@@ -12,10 +13,12 @@ export type AssistantMessage = Entity & {
     inputTokens?: number;
     outputTokens?: number;
     trace?: string;
+    messageType?: string;
     company: Company;
     assistant: Assistant;
     references?: unknown[];
     citations?: Chunk[];
+    action?: AssistantAction;
 };
 export declare const AssistantMessageDescriptor: import("../../../common").EntityDescriptor<AssistantMessage, {
     assistant: {
@@ -64,6 +67,15 @@ export declare const AssistantMessageDescriptor: import("../../../common").Entit
             required: false;
         })[];
     };
+    action: {
+        model: import("../../../common").DataMeta;
+        direction: "out";
+        relationship: string;
+        cardinality: "one";
+        required: false;
+        dtoKey: string;
+        immutable: true;
+    };
 }>;
 export type AssistantMessageDescriptorType = typeof AssistantMessageDescriptor;
 //# sourceMappingURL=assistant-message.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"assistant-message.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-message/entities/assistant-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAElG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAI/D,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEnE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAkCT,4BAA4B;;;;;;;;;;;;;;;;;;;;EAsBxD,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,OAAO,0BAA0B,CAAC"}
+{"version":3,"file":"assistant-message.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-message/entities/assistant-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAElG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AAIxF,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEnE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAmCT,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BxD,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,OAAO,0BAA0B,CAAC"}

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

@@ -5,6 +5,7 @@ const common_1 = require("../../../common");
 const registry_1 = require("../../../common/registries/registry");
 const assistant_meta_1 = require("../../assistant/entities/assistant.meta");
 const chunk_meta_1 = require("../../chunk/entities/chunk.meta");
+const assistant_action_meta_1 = require("../../assistant-action/entities/assistant-action.meta");
 const assistant_message_meta_1 = require("./assistant-message.meta");
 exports.AssistantMessageDescriptor = (0, common_1.defineEntity)()({
     ...assistant_message_meta_1.assistantMessageMeta,
@@ -17,6 +18,7 @@ exports.AssistantMessageDescriptor = (0, common_1.defineEntity)()({
         inputTokens: { type: "number" },
         outputTokens: { type: "number" },
         trace: { type: "string" },
+        messageType: { type: "string" },
     },
     relationships: {
         assistant: {
@@ -62,6 +64,15 @@ exports.AssistantMessageDescriptor = (0, common_1.defineEntity)()({
                 { name: "reason", type: "string", required: false },
             ],
         },
+        action: {
+            model: assistant_action_meta_1.assistantActionMeta,
+            direction: "out", // (AssistantMessage)-[:REQUESTED_IN]->(AssistantAction) — mirror of AssistantAction.message
+            relationship: "REQUESTED_IN",
+            cardinality: "one",
+            required: false,
+            dtoKey: "action",
+            immutable: true,
+        },
     },
 });
 //# sourceMappingURL=assistant-message.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"assistant-message.js","sourceRoot":"","sources":["../../../../src/foundations/assistant-message/entities/assistant-message.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AAEvD,kEAAoE;AAGpE,4EAAwE;AAExE,gEAA4D;AAC5D,qEAAgE;AAkBnD,QAAA,0BAA0B,GAAG,IAAA,qBAAY,GAAoB,CAAC;IACzE,GAAG,6CAAoB;IACvB,eAAe,EAAE,IAAI;IACrB,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,kBAAkB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QACxC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC1B;IACD,aAAa,EAAE;QACb,SAAS,EAAE;YACT,KAAK,EAAE,8BAAa;YACpB,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,aAAa;YAC3B,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;SAChB;QACD,UAAU,EAAE;YACV,KAAK,EAAE,6CAAoB;YAC3B,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,MAAM;YACnB,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;gBACtD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;aACpD;YACD,WAAW,EAAE;gBACX,UAAU,EAAE,EAAE;gBACd,aAAa,EAAE,CAAC,IAAkC,EAAE,EAAE;oBACpD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;wBAChC,MAAM,KAAK,GAAG,wBAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;wBAClD,IAAI,KAAK;4BAAE,OAAO,KAAK,CAAC;oBAC1B,CAAC;oBACD,MAAM,IAAI,KAAK,CAAC,yDAAyD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC1G,CAAC;aACF;SACF;QACD,SAAS,EAAE;YACT,KAAK,EAAE,sBAAS;YAChB,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,OAAO;YACrB,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACrD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;aACpD;SACF;KACF;CACF,CAAC,CAAC"}
+{"version":3,"file":"assistant-message.js","sourceRoot":"","sources":["../../../../src/foundations/assistant-message/entities/assistant-message.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AAEvD,kEAAoE;AAGpE,4EAAwE;AAExE,gEAA4D;AAE5D,iGAA4F;AAC5F,qEAAgE;AAoBnD,QAAA,0BAA0B,GAAG,IAAA,qBAAY,GAAoB,CAAC;IACzE,GAAG,6CAAoB;IACvB,eAAe,EAAE,IAAI;IACrB,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,kBAAkB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QACxC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAChC;IACD,aAAa,EAAE;QACb,SAAS,EAAE;YACT,KAAK,EAAE,8BAAa;YACpB,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,aAAa;YAC3B,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;SAChB;QACD,UAAU,EAAE;YACV,KAAK,EAAE,6CAAoB;YAC3B,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,MAAM;YACnB,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;gBACtD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;aACpD;YACD,WAAW,EAAE;gBACX,UAAU,EAAE,EAAE;gBACd,aAAa,EAAE,CAAC,IAAkC,EAAE,EAAE;oBACpD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;wBAChC,MAAM,KAAK,GAAG,wBAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;wBAClD,IAAI,KAAK;4BAAE,OAAO,KAAK,CAAC;oBAC1B,CAAC;oBACD,MAAM,IAAI,KAAK,CAAC,yDAAyD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC1G,CAAC;aACF;SACF;QACD,SAAS,EAAE;YACT,KAAK,EAAE,sBAAS;YAChB,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,OAAO;YACrB,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACrD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;aACpD;SACF;QACD,MAAM,EAAE;YACN,KAAK,EAAE,2CAAmB;YAC1B,SAAS,EAAE,KAAK,EAAE,4FAA4F;YAC9G,YAAY,EAAE,cAAc;YAC5B,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,IAAI;SAChB;KACF;CACF,CAAC,CAAC"}

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

@@ -59,6 +59,15 @@ export declare class AssistantMessageRepository extends AbstractRepository<Assis
                 required: false;
             })[];
         };
+        action: {
+            model: import("../../..").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "one";
+            required: false;
+            dtoKey: string;
+            immutable: true;
+        };
     }>;
     constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
     protected buildUserHasAccess(): string;

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

@@ -1 +1 @@
-{"version":3,"file":"assistant-message.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-message/repositories/assistant-message.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;AAEnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iEAAiE,CAAC;AACvG,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE7F;;;;;;GAMG;AACH,qBACa,0BAA2B,SAAQ,kBAAkB,CAChE,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA8B;gBAE/C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAStC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IAEzE;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAcvE;;;;;;OAMG;IACG,cAAc,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,eAAe,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BjG;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC3E,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjB;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3E;;;OAGG;IACG,yBAAyB,CAAC,MAAM,EAAE;QACtC,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAuB/D"}
+{"version":3,"file":"assistant-message.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-message/repositories/assistant-message.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;AAEnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iEAAiE,CAAC;AACvG,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE7F;;;;;;GAMG;AACH,qBACa,0BAA2B,SAAQ,kBAAkB,CAChE,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA8B;gBAE/C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAStC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IAEzE;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAcvE;;;;;;OAMG;IACG,cAAc,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,eAAe,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BjG;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC3E,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjB;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3E;;;OAGG;IACG,yBAAyB,CAAC,MAAM,EAAE;QACtC,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAuB/D"}

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

@@ -51,6 +51,15 @@ export declare class AssistantMessageService extends AbstractService<AssistantMe
                 required: false;
             })[];
         };
+        action: {
+            model: import("../../..").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "one";
+            required: false;
+            dtoKey: string;
+            immutable: true;
+        };
     }>;
     constructor(jsonApiService: JsonApiService, assistantMessageRepository: AssistantMessageRepository, clsService: ClsService);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"assistant-message.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-message/services/assistant-message.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAE1F,qBACa,uBAAwB,SAAQ,eAAe,CAC1D,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA8B;gBAGzD,cAAc,EAAE,cAAc,EAC9B,0BAA0B,EAAE,0BAA0B,EACtD,UAAU,EAAE,UAAU;CAIzB"}
+{"version":3,"file":"assistant-message.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/assistant-message/services/assistant-message.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAE1F,qBACa,uBAAwB,SAAQ,eAAe,CAC1D,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA8B;gBAGzD,cAAc,EAAE,cAAc,EAC9B,0BAA0B,EAAE,0BAA0B,EACtD,UAAU,EAAE,UAAU;CAIzB"}

package/dist/foundations/index.d.ts

@@ -3,6 +3,7 @@
  */
 export * from "./foundations.modules";
 export * from "./assistant";
+export * from "./assistant-action";
 export * from "./assistant-message";
 export * from "./atomicfact";
 export * from "./audit";

package/dist/foundations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,uBAAuB,CAAC;AAGtC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,uBAAuB,CAAC;AAGtC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}

package/dist/foundations/index.js

@@ -21,6 +21,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./foundations.modules"), exports);
 // Individual foundation modules with entities, metas, repositories, and services
 __exportStar(require("./assistant"), exports);
+__exportStar(require("./assistant-action"), exports);
 __exportStar(require("./assistant-message"), exports);
 __exportStar(require("./atomicfact"), exports);
 __exportStar(require("./audit"), exports);

package/dist/foundations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,sFAAsF;AACtF,wDAAsC;AAEtC,iFAAiF;AACjF,8CAA4B;AAC5B,sDAAoC;AACpC,+CAA6B;AAC7B,0CAAwB;AACxB,yCAAuB;AACvB,0CAAwB;AACxB,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,iDAA+B;AAC/B,4CAA0B;AAC1B,2CAAyB;AACzB,+CAA6B;AAC7B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,yCAAuB;AACvB,6CAA2B;AAC3B,8CAA4B;AAC5B,yCAAuB;AACvB,uCAAqB;AACrB,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,yCAAuB;AACvB,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,sFAAsF;AACtF,wDAAsC;AAEtC,iFAAiF;AACjF,8CAA4B;AAC5B,qDAAmC;AACnC,sDAAoC;AACpC,+CAA6B;AAC7B,0CAAwB;AACxB,yCAAuB;AACvB,0CAAwB;AACxB,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,iDAA+B;AAC/B,4CAA0B;AAC1B,2CAAyB;AACzB,+CAA6B;AAC7B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,yCAAuB;AACvB,6CAA2B;AAC3B,8CAA4B;AAC5B,yCAAuB;AACvB,uCAAqB;AACrB,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,yCAAuB;AACvB,yCAAuB"}

package/dist/foundations/tokenusage/entities/tokenusage.entity.d.ts

@@ -3,6 +3,7 @@ import { Company } from "../../company/entities/company";
 export type TokenUsage = Entity & {
     inputTokens: number;
     outputTokens: number;
+    cachedInputTokens?: number;
     cost?: number;
     tokenUsageType: string;
     company: Company;

package/dist/foundations/tokenusage/entities/tokenusage.entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.entity.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IAEvB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC"}
+{"version":3,"file":"tokenusage.entity.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IAEvB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage.map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.map.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage.map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAEzE,eAAO,MAAM,aAAa,GAAI,QAAQ;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,aAAa,EAAE,aAAa,CAAA;CAAE,KAAG,UAShG,CAAC"}
+{"version":3,"file":"tokenusage.map.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage.map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAEzE,eAAO,MAAM,aAAa,GAAI,QAAQ;IAAE,IAAI,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,aAAa,EAAE,aAAa,CAAA;CAAE,KAAG,UAUhG,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage.map.js

@@ -7,6 +7,7 @@ const mapTokenUsage = (params) => {
         ...(0, entity_1.mapEntity)({ record: params.data }),
         inputTokens: params.data.inputTokens,
         outputTokens: params.data.outputTokens,
+        cachedInputTokens: params.data.cachedInputTokens,
         cost: params.data.cost,
         tokenUsageType: params.data.tokenUsageType,
         company: undefined,

package/dist/foundations/tokenusage/entities/tokenusage.map.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.map.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage.map.ts"],"names":[],"mappings":";;;AAAA,6DAA6D;AAItD,MAAM,aAAa,GAAG,CAAC,MAAgE,EAAc,EAAE;IAC5G,OAAO;QACL,GAAG,IAAA,kBAAS,EAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACrC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW;QACpC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY;QACtC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;QACtB,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc;QAC1C,OAAO,EAAE,SAAS;KACnB,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,aAAa,iBASxB"}
+{"version":3,"file":"tokenusage.map.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage.map.ts"],"names":[],"mappings":";;;AAAA,6DAA6D;AAItD,MAAM,aAAa,GAAG,CAAC,MAAgE,EAAc,EAAE;IAC5G,OAAO;QACL,GAAG,IAAA,kBAAS,EAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACrC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW;QACpC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY;QACtC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB;QAChD,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI;QACtB,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc;QAC1C,OAAO,EAAE,SAAS;KACnB,CAAC;AACJ,CAAC,CAAC;AAVW,QAAA,aAAa,iBAUxB"}

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

@@ -9,6 +9,7 @@ export declare class TokenUsageRepository implements OnModuleInit {
         tokenUsageType: string;
         inputTokens: number;
         outputTokens: number;
+        cachedInputTokens?: number;
         cost?: number;
         relationshipId: string;
         relationshipType: string;

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

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/repositories/tokenusage.repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAG1E,qBACa,oBAAqB,YAAW,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY;IAE1C,YAAY;IAMZ,MAAM,CAAC,MAAM,EAAE;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC;CAgClB"}
+{"version":3,"file":"tokenusage.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/repositories/tokenusage.repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAG1E,qBACa,oBAAqB,YAAW,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY;IAE1C,YAAY;IAMZ,MAAM,CAAC,MAAM,EAAE;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC;CAkClB"}

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

@@ -30,6 +30,7 @@ let TokenUsageRepository = class TokenUsageRepository {
             tokenUsageType: params.tokenUsageType,
             inputTokens: params.inputTokens,
             outputTokens: params.outputTokens,
+            cachedInputTokens: params.cachedInputTokens ?? 0,
             relationshipId: params.relationshipId,
             cost: params.cost ?? 0,
         };
@@ -39,6 +40,7 @@ let TokenUsageRepository = class TokenUsageRepository {
         tokenUsageType: $tokenUsageType,
         inputTokens: $inputTokens,
         outputTokens: $outputTokens,
+        cachedInputTokens: $cachedInputTokens,
         cost: $cost,
         createdAt: datetime(),
         updatedAt: datetime()

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

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.repository.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/repositories/tokenusage.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA0D;AAC1D,8EAA0E;AAC1E,+EAA2E;AAGpE,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,YAA6B,KAAmB;QAAnB,UAAK,GAAL,KAAK,CAAc;IAAG,CAAC;IAEpD,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,EAAE,qBAAqB,gCAAc,CAAC,QAAQ,0BAA0B,gCAAc,CAAC,QAAQ,IAAI,gCAAc,CAAC,SAAS,aAAa,gCAAc,CAAC,QAAQ,eAAe;SACpL,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAQZ;QACC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAErC,KAAK,CAAC,WAAW,GAAG;YAClB,GAAG,KAAK,CAAC,WAAW;YACpB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;SACvB,CAAC;QAEF,KAAK,CAAC,KAAK,IAAI;;;;;;;;;;;;;yBAaM,MAAM,CAAC,gBAAgB;;KAE3C,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AAjDY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAEyB,4BAAY;GADrC,oBAAoB,CAiDhC"}
+{"version":3,"file":"tokenusage.repository.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/repositories/tokenusage.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA0D;AAC1D,8EAA0E;AAC1E,+EAA2E;AAGpE,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,YAA6B,KAAmB;QAAnB,UAAK,GAAL,KAAK,CAAc;IAAG,CAAC;IAEpD,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,EAAE,qBAAqB,gCAAc,CAAC,QAAQ,0BAA0B,gCAAc,CAAC,QAAQ,IAAI,gCAAc,CAAC,SAAS,aAAa,gCAAc,CAAC,QAAQ,eAAe;SACpL,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MASZ;QACC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAErC,KAAK,CAAC,WAAW,GAAG;YAClB,GAAG,KAAK,CAAC,WAAW;YACpB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,CAAC;YAChD,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;SACvB,CAAC;QAEF,KAAK,CAAC,KAAK,IAAI;;;;;;;;;;;;;;yBAcM,MAAM,CAAC,gBAAgB;;KAE3C,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AApDY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAEyB,4BAAY;GADrC,oBAAoB,CAoDhC"}

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

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/services/tokenusage.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAqB,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGnE,qBACa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAL/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;gBAG1C,oBAAoB,EAAE,oBAAoB,EAC1C,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC,EACjD,YAAY,EAAE,aAAa;IAG9C,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,CAAC,eAAe;IAWvB;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,mBAAmB,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,MAAM;IAO3G,gBAAgB,CAAC,MAAM,EAAE;QAC7B,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;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC;CAgClB"}
+{"version":3,"file":"tokenusage.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/services/tokenusage.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAqB,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGnE,qBACa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAL/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;gBAG1C,oBAAoB,EAAE,oBAAoB,EAC1C,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC,EACjD,YAAY,EAAE,aAAa;IAG9C,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,CAAC,eAAe;IAWvB;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,mBAAmB,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,MAAM;IAY3G,gBAAgB,CAAC,MAAM,EAAE;QAC7B,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;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC;CAiClB"}

package/dist/foundations/tokenusage/services/tokenusage.service.js

@@ -45,9 +45,14 @@ let TokenUsageService = TokenUsageService_1 = class TokenUsageService {
      */
     computeCost(params) {
         const costConfig = params.useVisionCosts ? this.aiConfig.vision : this.configForWeight(params.modelWeight);
-        const inputCost = (params.tokens.input / 1_000_000) * (costConfig.inputCostPer1MTokens ?? 0);
-        const outputCost = (params.tokens.output / 1_000_000) * (costConfig.outputCostPer1MTokens ?? 0);
-        return inputCost + outputCost;
+        const inputRate = costConfig.inputCostPer1MTokens ?? 0;
+        const outputRate = costConfig.outputCostPer1MTokens ?? 0;
+        // vision/audio configs have no cached rate → falls back to the full input rate (no discount).
+        const cachedRate = costConfig.cachedInputCostPer1MTokens ?? inputRate;
+        const cached = Math.min(params.tokens.cached ?? 0, params.tokens.input);
+        const uncachedInput = params.tokens.input - cached;
+        const cost = uncachedInput * inputRate + cached * cachedRate + params.tokens.output * outputRate;
+        return cost / 1_000_000;
     }
     async recordTokenUsage(params) {
         const cost = this.computeCost({
@@ -60,6 +65,7 @@ let TokenUsageService = TokenUsageService_1 = class TokenUsageService {
             tokenUsageType: params.type,
             inputTokens: params.tokens.input,
             outputTokens: params.tokens.output,
+            cachedInputTokens: params.tokens.cached ?? 0,
             cost: cost,
             relationshipId: params.relationshipId,
             relationshipType: params.relationshipType,

package/dist/foundations/tokenusage/services/tokenusage.service.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nestjs-neo4jsonapi",
-  "version": "1.96.0",
+  "version": "1.98.0",
   "description": "NestJS foundation package with JSON:API, Neo4j, Redis, LangChain agents, and common utilities",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
@@ -72,6 +72,7 @@
     "@langchain/core": "^1.1.48",
     "@langchain/google-vertexai": "^2.1.31",
     "@langchain/langgraph": "^1.3.2",
+    "@langchain/langgraph-checkpoint-redis": "^1.0.7",
     "@langchain/openai": "^1.4.7",
     "@langchain/textsplitters": "^1.0.1",
     "langsmith": "^0.7.5",