@igoruehara/canvas-flow 0.1.0

package/server/memory/memory-service.d.ts

@@ -0,0 +1,134 @@
+import { Model } from 'mongoose';
+import { MemoryHistoryEntity } from './memory-history-schema';
+import { MemoryTurnEntity } from './memory-schema';
+import { TraceHistoryEntity } from './memory-trace-history-schema';
+export interface CreateMemoryTurn {
+    agentId?: string;
+    conversationId: string;
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    metadata?: Record<string, any>;
+}
+export declare class MemoryService {
+    private model;
+    private historyModel;
+    private traceHistoryModel;
+    constructor(model: Model<MemoryTurnEntity>, historyModel: Model<MemoryHistoryEntity>, traceHistoryModel: Model<TraceHistoryEntity>);
+    private isMessageHistoryTurn;
+    addTurn(turn: CreateMemoryTurn): Promise<(import("mongoose").Document<unknown, {}, MemoryTurnEntity, {}, {}> & MemoryTurnEntity & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }> & {
+        __v: number;
+    }) | {
+        skipped: boolean;
+        error: string;
+    }>;
+    addHistoryTurn(turn: CreateMemoryTurn): Promise<(import("mongoose").Document<unknown, {}, MemoryHistoryEntity, {}, {}> & MemoryHistoryEntity & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }> & {
+        __v: number;
+    }) | {
+        skipped: boolean;
+        error: string;
+    }>;
+    addTraceTurn(turn: CreateMemoryTurn): Promise<(import("mongoose").Document<unknown, {}, TraceHistoryEntity, {}, {}> & TraceHistoryEntity & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }> & {
+        __v: number;
+    }) | {
+        skipped: boolean;
+        error: string;
+    }>;
+    findRecent(agentId: string | undefined, conversationId: string, limit?: number, scope?: {
+        organizationId?: string;
+        metadataKind?: string;
+        conversationOwnerId?: string;
+    }): Promise<(import("mongoose").FlattenMaps<MemoryTurnEntity> & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }> & {
+        __v: number;
+    })[]>;
+    findHistory(filters: {
+        organizationId?: string;
+        agentId?: string;
+        conversationId?: string;
+        conversationIds?: string[];
+        metadataKind?: string;
+        flowId?: string;
+        dateFrom?: string;
+        dateTo?: string;
+        limit?: number;
+        page?: number;
+        skip?: number;
+    }): Promise<{
+        items: (import("mongoose").FlattenMaps<MemoryTurnEntity> & Required<{
+            _id: import("mongoose").Types.ObjectId;
+        }> & {
+            __v: number;
+        })[];
+        total: number;
+        page: number;
+        limit: number;
+        skip: number;
+        totalPages: number;
+    } | {
+        items: (import("mongoose").FlattenMaps<MemoryHistoryEntity> & Required<{
+            _id: import("mongoose").Types.ObjectId;
+        }> & {
+            __v: number;
+        })[];
+        total: number;
+        page: number;
+        limit: number;
+        skip: number;
+        totalPages: number;
+    }>;
+    private buildHistoryQuery;
+    private findLegacyHistory;
+    clearConversation(agentId: string | undefined, conversationId: string, scope?: {
+        organizationId?: string;
+        conversationOwnerId?: string;
+    }): Promise<import("mongodb").DeleteResult | {
+        acknowledged: boolean;
+        deletedCount: number;
+        error: string;
+    }>;
+    getMessageInsights(filters: {
+        organizationId?: string;
+        agentId?: string;
+        flowId?: string;
+        conversationId?: string;
+        conversationIds?: string[];
+        dateFrom?: string;
+        dateTo?: string;
+    }): Promise<{
+        summary: {
+            totalMessages: any;
+            userMessages: number;
+            assistantMessages: number;
+            conversations: number;
+            avgMessagesPerConversation: number;
+            avgUserMessagesPerConversation: number;
+            longConversations: number;
+        };
+        byRole: any[];
+        byChannel: any[];
+        byFlow: any[];
+        topConversations: any[];
+        daily: any[];
+    }>;
+    findTraceHistory(filters: {
+        organizationId?: string;
+        agentId?: string;
+        flowId?: string;
+        conversationId?: string;
+        conversationIds?: string[];
+        dateFrom?: string;
+        dateTo?: string;
+        limit?: number;
+    }): Promise<(import("mongoose").FlattenMaps<TraceHistoryEntity> & Required<{
+        _id: import("mongoose").Types.ObjectId;
+    }> & {
+        __v: number;
+    })[]>;
+}

package/server/memory/memory-service.js

@@ -0,0 +1,317 @@
+"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.MemoryService = void 0;
+const common_1 = require("@nestjs/common");
+const mongoose_1 = require("mongoose");
+const memory_constants_model_1 = require("./memory-constants-model");
+let MemoryService = class MemoryService {
+    constructor(model, historyModel, traceHistoryModel) {
+        this.model = model;
+        this.historyModel = historyModel;
+        this.traceHistoryModel = traceHistoryModel;
+    }
+    isMessageHistoryTurn(turn) {
+        return turn.metadata?.kind === 'message';
+    }
+    async addTurn(turn) {
+        try {
+            const saved = await new this.model(turn).save();
+            if (this.isMessageHistoryTurn(turn)) {
+                await this.addHistoryTurn({
+                    ...turn,
+                    metadata: {
+                        ...(turn.metadata || {}),
+                        runtimeTurnId: String(saved._id),
+                    },
+                });
+            }
+            return saved;
+        }
+        catch (error) {
+            return { skipped: true, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    async addHistoryTurn(turn) {
+        try {
+            return await new this.historyModel(turn).save();
+        }
+        catch (error) {
+            return { skipped: true, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    async addTraceTurn(turn) {
+        try {
+            return await new this.traceHistoryModel(turn).save();
+        }
+        catch (error) {
+            return { skipped: true, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    async findRecent(agentId, conversationId, limit = 20, scope) {
+        const query = { conversationId };
+        if (agentId)
+            query.agentId = agentId;
+        if (scope?.organizationId)
+            query['metadata.organizationId'] = scope.organizationId;
+        if (scope?.metadataKind)
+            query['metadata.kind'] = scope.metadataKind;
+        if (scope?.conversationOwnerId)
+            query['metadata.conversationOwnerId'] = scope.conversationOwnerId;
+        try {
+            const rows = await this.model
+                .find(query)
+                .sort({ createdAt: -1 })
+                .limit(Math.max(0, limit))
+                .lean()
+                .exec();
+            return rows.reverse();
+        }
+        catch {
+            return [];
+        }
+    }
+    async findHistory(filters) {
+        const query = this.buildHistoryQuery(filters);
+        const limit = Math.max(1, Math.min(Number(filters.limit || 50), 500));
+        const page = Math.max(1, Math.floor(Number(filters.page || 1)));
+        const explicitSkip = Number(filters.skip);
+        const skip = Number.isFinite(explicitSkip) && explicitSkip >= 0 ? Math.floor(explicitSkip) : (page - 1) * limit;
+        try {
+            const [items, total] = await Promise.all([
+                this.historyModel
+                    .find(query)
+                    .sort({ createdAt: -1 })
+                    .skip(skip)
+                    .limit(limit)
+                    .lean()
+                    .exec(),
+                this.historyModel.countDocuments(query).exec(),
+            ]);
+            if (!items.length && total === 0) {
+                return await this.findLegacyHistory(query, { limit, page, skip });
+            }
+            return {
+                items,
+                total,
+                page,
+                limit,
+                skip,
+                totalPages: total > 0 ? Math.ceil(total / limit) : 0,
+            };
+        }
+        catch {
+            return { items: [], total: 0, page, limit, skip, totalPages: 0 };
+        }
+    }
+    buildHistoryQuery(filters) {
+        const query = {};
+        if (filters.agentId)
+            query.agentId = filters.agentId;
+        if (filters.conversationId) {
+            query.conversationId = filters.conversationId;
+        }
+        else if (Array.isArray(filters.conversationIds)) {
+            const conversationIds = filters.conversationIds.map((id) => String(id || '').trim()).filter(Boolean);
+            if (conversationIds.length)
+                query.conversationId = { $in: conversationIds };
+        }
+        if (filters.organizationId)
+            query['metadata.organizationId'] = filters.organizationId;
+        if (filters.metadataKind)
+            query['metadata.kind'] = filters.metadataKind;
+        if (filters.flowId) {
+            query.$or = [
+                { 'metadata.flowId': filters.flowId },
+                { 'metadata.entryFlowId': filters.flowId },
+                { 'metadata.activeFlowId': filters.flowId },
+            ];
+        }
+        const createdAt = {};
+        if (filters.dateFrom) {
+            const date = new Date(filters.dateFrom);
+            if (!Number.isNaN(date.getTime()))
+                createdAt.$gte = date;
+        }
+        if (filters.dateTo) {
+            const date = new Date(filters.dateTo);
+            if (!Number.isNaN(date.getTime()))
+                createdAt.$lte = date;
+        }
+        if (Object.keys(createdAt).length)
+            query.createdAt = createdAt;
+        return query;
+    }
+    async findLegacyHistory(query, pagination) {
+        const { limit, page, skip } = pagination;
+        try {
+            const [items, total] = await Promise.all([
+                this.model
+                    .find(query)
+                    .sort({ createdAt: -1 })
+                    .skip(skip)
+                    .limit(limit)
+                    .lean()
+                    .exec(),
+                this.model.countDocuments(query).exec(),
+            ]);
+            return {
+                items,
+                total,
+                page,
+                limit,
+                skip,
+                totalPages: total > 0 ? Math.ceil(total / limit) : 0,
+            };
+        }
+        catch {
+            return { items: [], total: 0, page, limit, skip, totalPages: 0 };
+        }
+    }
+    async clearConversation(agentId, conversationId, scope) {
+        const query = { conversationId };
+        if (agentId)
+            query.agentId = agentId;
+        if (scope?.organizationId)
+            query['metadata.organizationId'] = scope.organizationId;
+        if (scope?.conversationOwnerId)
+            query['metadata.conversationOwnerId'] = scope.conversationOwnerId;
+        try {
+            return await this.model.deleteMany(query).exec();
+        }
+        catch (error) {
+            return { acknowledged: false, deletedCount: 0, error: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    async getMessageInsights(filters) {
+        const query = this.buildHistoryQuery({ ...filters, metadataKind: 'message' });
+        try {
+            const [byRole, byChannel, byFlow, conversationRows, conversationStats, daily] = await Promise.all([
+                this.historyModel.aggregate([
+                    { $match: query },
+                    { $group: { _id: '$role', count: { $sum: 1 } } },
+                    { $project: { role: '$_id', count: 1, _id: 0 } },
+                    { $sort: { count: -1 } },
+                ]).exec(),
+                this.historyModel.aggregate([
+                    { $match: query },
+                    { $group: { _id: '$metadata.channel', count: { $sum: 1 }, conversations: { $addToSet: '$conversationId' } } },
+                    { $project: { channel: { $ifNull: ['$_id', ''] }, count: 1, conversations: { $size: '$conversations' }, _id: 0 } },
+                    { $sort: { count: -1 } },
+                    { $limit: 20 },
+                ]).exec(),
+                this.historyModel.aggregate([
+                    { $match: query },
+                    { $group: { _id: { flowId: '$metadata.flowId', flowName: '$metadata.flowName' }, count: { $sum: 1 }, conversations: { $addToSet: '$conversationId' } } },
+                    { $project: { flowId: '$_id.flowId', flowName: '$_id.flowName', count: 1, conversations: { $size: '$conversations' }, _id: 0 } },
+                    { $sort: { count: -1 } },
+                    { $limit: 20 },
+                ]).exec(),
+                this.historyModel.aggregate([
+                    { $match: query },
+                    { $group: { _id: '$conversationId', messages: { $sum: 1 }, userMessages: { $sum: { $cond: [{ $eq: ['$role', 'user'] }, 1, 0] } }, assistantMessages: { $sum: { $cond: [{ $eq: ['$role', 'assistant'] }, 1, 0] } }, lastAt: { $max: '$createdAt' } } },
+                    { $sort: { messages: -1, lastAt: -1 } },
+                    { $limit: 20 },
+                    { $project: { conversationId: '$_id', messages: 1, userMessages: 1, assistantMessages: 1, lastAt: 1, _id: 0 } },
+                ]).exec(),
+                this.historyModel.aggregate([
+                    { $match: query },
+                    { $group: { _id: '$conversationId', messages: { $sum: 1 }, userMessages: { $sum: { $cond: [{ $eq: ['$role', 'user'] }, 1, 0] } } } },
+                    {
+                        $group: {
+                            _id: null,
+                            conversations: { $sum: 1 },
+                            longConversations: { $sum: { $cond: [{ $gte: ['$userMessages', 5] }, 1, 0] } },
+                        },
+                    },
+                    { $project: { _id: 0, conversations: 1, longConversations: 1 } },
+                ]).exec(),
+                this.historyModel.aggregate([
+                    { $match: query },
+                    {
+                        $group: {
+                            _id: { $dateToString: { format: '%Y-%m-%d', date: '$createdAt' } },
+                            messages: { $sum: 1 },
+                            conversations: { $addToSet: '$conversationId' },
+                        },
+                    },
+                    { $project: { date: '$_id', messages: 1, conversations: { $size: '$conversations' }, _id: 0 } },
+                    { $sort: { date: 1 } },
+                    { $limit: 90 },
+                ]).exec(),
+            ]);
+            const totalMessages = byRole.reduce((sum, item) => sum + Number(item.count || 0), 0);
+            const stats = conversationStats?.[0] || {};
+            const conversations = Number(stats.conversations || 0);
+            const userMessages = Number(byRole.find((item) => item.role === 'user')?.count || 0);
+            const assistantMessages = Number(byRole.find((item) => item.role === 'assistant')?.count || 0);
+            const longConversations = Number(stats.longConversations || 0);
+            return {
+                summary: {
+                    totalMessages,
+                    userMessages,
+                    assistantMessages,
+                    conversations,
+                    avgMessagesPerConversation: conversations ? totalMessages / conversations : 0,
+                    avgUserMessagesPerConversation: conversations ? userMessages / conversations : 0,
+                    longConversations,
+                },
+                byRole,
+                byChannel,
+                byFlow,
+                topConversations: conversationRows,
+                daily,
+            };
+        }
+        catch {
+            return {
+                summary: {
+                    totalMessages: 0,
+                    userMessages: 0,
+                    assistantMessages: 0,
+                    conversations: 0,
+                    avgMessagesPerConversation: 0,
+                    avgUserMessagesPerConversation: 0,
+                    longConversations: 0,
+                },
+                byRole: [],
+                byChannel: [],
+                byFlow: [],
+                topConversations: [],
+                daily: [],
+            };
+        }
+    }
+    async findTraceHistory(filters) {
+        const query = this.buildHistoryQuery({ ...filters, metadataKind: 'trace' });
+        const limit = Math.max(1, Math.min(Number(filters.limit || 300), 1000));
+        try {
+            return await this.traceHistoryModel.find(query).sort({ createdAt: -1 }).limit(limit).lean().exec();
+        }
+        catch {
+            return [];
+        }
+    }
+};
+exports.MemoryService = MemoryService;
+exports.MemoryService = MemoryService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(memory_constants_model_1.MODEL_NAME)),
+    __param(1, (0, common_1.Inject)(memory_constants_model_1.HISTORY_MODEL_NAME)),
+    __param(2, (0, common_1.Inject)(memory_constants_model_1.TRACE_HISTORY_MODEL_NAME)),
+    __metadata("design:paramtypes", [mongoose_1.Model,
+        mongoose_1.Model,
+        mongoose_1.Model])
+], MemoryService);
+//# sourceMappingURL=memory-service.js.map

package/server/memory/memory-service.js.map

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

package/server/memory/memory-trace-history-schema.d.ts

@@ -0,0 +1,48 @@
+import * as mongoose from 'mongoose';
+import { Document } from 'mongoose';
+export declare const TraceHistoryEntitySchema: mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any>, {}, {}, {}, {}, {
+    collection: string;
+    timestamps: {
+        createdAt: true;
+        updatedAt: false;
+    };
+}, {
+    role: string;
+    content: string;
+    conversationId: string;
+    metadata: any;
+    agentId?: string;
+    createdAt: NativeDate;
+}, mongoose.Document<unknown, {}, mongoose.FlatRecord<{
+    role: string;
+    content: string;
+    conversationId: string;
+    metadata: any;
+    agentId?: string;
+    createdAt: NativeDate;
+}>, {}, mongoose.MergeType<mongoose.DefaultSchemaOptions, {
+    collection: string;
+    timestamps: {
+        createdAt: true;
+        updatedAt: false;
+    };
+}>> & mongoose.FlatRecord<{
+    role: string;
+    content: string;
+    conversationId: string;
+    metadata: any;
+    agentId?: string;
+    createdAt: NativeDate;
+}> & {
+    _id: mongoose.Types.ObjectId;
+} & {
+    __v: number;
+}>;
+export declare class TraceHistoryEntity extends Document {
+    agentId?: string;
+    conversationId: string;
+    role: string;
+    content: string;
+    metadata?: Record<string, any>;
+    createdAt: Date;
+}

package/server/memory/memory-trace-history-schema.js

@@ -0,0 +1,62 @@
+"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.TraceHistoryEntity = exports.TraceHistoryEntitySchema = void 0;
+const mongoose_1 = require("@nestjs/mongoose");
+const mongoose = require("mongoose");
+const mongoose_2 = require("mongoose");
+const memory_constants_model_1 = require("./memory-constants-model");
+exports.TraceHistoryEntitySchema = new mongoose.Schema({
+    agentId: { type: String, index: true },
+    conversationId: { type: String, required: true, index: true },
+    role: { type: String, required: true },
+    content: { type: String, default: '' },
+    metadata: { type: mongoose.Schema.Types.Mixed, default: {} },
+}, {
+    collection: memory_constants_model_1.TRACE_HISTORY_COLLECTION_NAME,
+    timestamps: { createdAt: true, updatedAt: false },
+});
+exports.TraceHistoryEntitySchema.index({ agentId: 1, conversationId: 1, createdAt: -1 });
+exports.TraceHistoryEntitySchema.index({ 'metadata.organizationId': 1, 'metadata.kind': 1, createdAt: -1 });
+exports.TraceHistoryEntitySchema.index({ 'metadata.organizationId': 1, agentId: 1, conversationId: 1, 'metadata.kind': 1, createdAt: -1 });
+exports.TraceHistoryEntitySchema.index({ 'metadata.organizationId': 1, 'metadata.flowId': 1, 'metadata.kind': 1, createdAt: -1 });
+exports.TraceHistoryEntitySchema.index({ 'metadata.organizationId': 1, 'metadata.entryFlowId': 1, 'metadata.kind': 1, createdAt: -1 });
+exports.TraceHistoryEntitySchema.index({ 'metadata.organizationId': 1, 'metadata.activeFlowId': 1, 'metadata.kind': 1, createdAt: -1 });
+let TraceHistoryEntity = class TraceHistoryEntity extends mongoose_2.Document {
+};
+exports.TraceHistoryEntity = TraceHistoryEntity;
+__decorate([
+    (0, mongoose_1.Prop)(),
+    __metadata("design:type", String)
+], TraceHistoryEntity.prototype, "agentId", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ required: true }),
+    __metadata("design:type", String)
+], TraceHistoryEntity.prototype, "conversationId", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ required: true }),
+    __metadata("design:type", String)
+], TraceHistoryEntity.prototype, "role", void 0);
+__decorate([
+    (0, mongoose_1.Prop)(),
+    __metadata("design:type", String)
+], TraceHistoryEntity.prototype, "content", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: mongoose.Schema.Types.Mixed, default: {} }),
+    __metadata("design:type", Object)
+], TraceHistoryEntity.prototype, "metadata", void 0);
+exports.TraceHistoryEntity = TraceHistoryEntity = __decorate([
+    (0, mongoose_1.Schema)({
+        collection: memory_constants_model_1.TRACE_HISTORY_COLLECTION_NAME,
+        timestamps: { createdAt: true, updatedAt: false },
+    })
+], TraceHistoryEntity);
+//# sourceMappingURL=memory-trace-history-schema.js.map

package/server/memory/memory-trace-history-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-trace-history-schema.js","sourceRoot":"","sources":["../../src/memory/memory-trace-history-schema.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+CAAgD;AAChD,qCAAqC;AACrC,uCAAoC;AACpC,qEAAyE;AAE5D,QAAA,wBAAwB,GAAG,IAAI,QAAQ,CAAC,MAAM,CACzD;IACE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE;IACtC,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;IAC7D,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;IACtC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;IACtC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;CAC7D,EACD;IACE,UAAU,EAAE,sDAA6B;IACzC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;CAClD,CACF,CAAC;AAEF,gCAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACjF,gCAAwB,CAAC,KAAK,CAAC,EAAE,yBAAyB,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACpG,gCAAwB,CAAC,KAAK,CAAC,EAAE,yBAAyB,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACnI,gCAAwB,CAAC,KAAK,CAAC,EAAE,yBAAyB,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAC1H,gCAAwB,CAAC,KAAK,CAAC,EAAE,yBAAyB,EAAE,CAAC,EAAE,sBAAsB,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAC/H,gCAAwB,CAAC,KAAK,CAAC,EAAE,yBAAyB,EAAE,CAAC,EAAE,uBAAuB,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAMzH,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,mBAAQ;CAiB/C,CAAA;AAjBY,gDAAkB;AAE7B;IADC,IAAA,eAAI,GAAE;;mDACU;AAGjB;IADC,IAAA,eAAI,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;0DACF;AAGvB;IADC,IAAA,eAAI,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gDACZ;AAGb;IADC,IAAA,eAAI,GAAE;;mDACS;AAGhB;IADC,IAAA,eAAI,EAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;;oDAC1B;6BAdpB,kBAAkB;IAJ9B,IAAA,iBAAM,EAAC;QACN,UAAU,EAAE,sDAA6B;QACzC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;KAClD,CAAC;GACW,kBAAkB,CAiB9B"}

package/server/observability/observability.d.ts

@@ -0,0 +1,3 @@
+export declare function sanitizeForLog(value: any, depth?: number): any;
+export declare function logEvent(level: 'info' | 'warn' | 'error', event: string, data?: Record<string, any>): void;
+export declare function getErrorDetails(error: any): any;

package/server/observability/observability.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeForLog = sanitizeForLog;
+exports.logEvent = logEvent;
+exports.getErrorDetails = getErrorDetails;
+const SENSITIVE_KEY_PATTERN = /(api[-_]?key|authorization|password|passwd|secret|token|access[-_]?token|refresh[-_]?token|connection[-_]?string|credential|private[-_]?key|client[-_]?secret)/i;
+const MAX_STRING_LENGTH = 1200;
+const MAX_ARRAY_LENGTH = 50;
+const MAX_DEPTH = 6;
+function sanitizeForLog(value, depth = 0) {
+    if (value === null || value === undefined)
+        return value;
+    if (depth > MAX_DEPTH)
+        return '[MaxDepth]';
+    if (typeof value === 'string') {
+        return value.length > MAX_STRING_LENGTH ? `${value.slice(0, MAX_STRING_LENGTH)}...[truncated:${value.length}]` : value;
+    }
+    if (typeof value !== 'object')
+        return value;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value)) {
+        const items = value.slice(0, MAX_ARRAY_LENGTH).map((item) => sanitizeForLog(item, depth + 1));
+        return value.length > MAX_ARRAY_LENGTH ? [...items, `[truncated:${value.length - MAX_ARRAY_LENGTH}]`] : items;
+    }
+    const clean = {};
+    for (const [key, raw] of Object.entries(value)) {
+        if (SENSITIVE_KEY_PATTERN.test(key)) {
+            clean[key] = raw ? '[redacted]' : raw;
+            continue;
+        }
+        clean[key] = sanitizeForLog(raw, depth + 1);
+    }
+    return clean;
+}
+function logEvent(level, event, data = {}) {
+    const payload = {
+        level,
+        event,
+        service: 'canvas-flow',
+        timestamp: new Date().toISOString(),
+        ...sanitizeForLog(data),
+    };
+    const line = JSON.stringify(payload);
+    if (level === 'error') {
+        console.error(line);
+    }
+    else if (level === 'warn') {
+        console.warn(line);
+    }
+    else {
+        console.log(line);
+    }
+}
+function getErrorDetails(error) {
+    return sanitizeForLog({
+        name: error?.name,
+        message: error?.message || String(error || ''),
+        stack: error?.stack,
+    });
+}
+//# sourceMappingURL=observability.js.map

package/server/observability/observability.js.map

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