@hexabot-ai/api 3.2.2-alpha.9 → 3.2.2-beta.1

package/dist/mcp/tools/memory-definition-mcp.tools.d.ts

@@ -0,0 +1,57 @@
+import { MemoryDefinitionService } from "../../workflow/services/memory-definition.service";
+import { MemoryScope } from "../../workflow/types";
+import { HexabotMcpToolBase } from './hexabot-mcp-tool.base';
+import { PaginationArgs } from './hexabot-mcp.schemas';
+export declare class HexabotMemoryDefinitionMcpTools extends HexabotMcpToolBase {
+    private readonly memoryDefinitionService;
+    constructor(memoryDefinitionService: MemoryDefinitionService);
+    searchMemoryDefinitions(args: {
+        query?: string;
+        scope?: MemoryScope;
+    } & PaginationArgs): Promise<{
+        items: unknown[];
+        total: number;
+        limit: number | undefined;
+        skip: number | undefined;
+    }>;
+    getMemoryDefinition(args: {
+        id: string;
+    }): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        name: string;
+        slug: string;
+        scope: MemoryScope;
+        schema: any;
+        ttlSeconds?: number | null | undefined;
+    }>;
+    createMemoryDefinition(args: {
+        name: string;
+        slug: string;
+        scope: MemoryScope;
+        schema: Record<string, unknown>;
+        ttlSeconds?: number | null;
+    }): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        name: string;
+        slug: string;
+        scope: MemoryScope;
+        schema: any;
+        ttlSeconds?: number | null | undefined;
+    }>;
+    updateMemoryDefinition(args: {
+        id: string;
+    } & Record<string, unknown>): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        name: string;
+        slug: string;
+        scope: MemoryScope;
+        schema: any;
+        ttlSeconds?: number | null | undefined;
+    }>;
+}

package/dist/mcp/tools/memory-definition-mcp.tools.js

@@ -0,0 +1,128 @@
+"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.HexabotMemoryDefinitionMcpTools = void 0;
+const types_1 = require("@hexabot-ai/types");
+const common_1 = require("@nestjs/common");
+const mcp_nest_1 = require("@rekog/mcp-nest");
+const zod_1 = require("zod");
+const memory_definition_service_1 = require("../../workflow/services/memory-definition.service");
+const types_2 = require("../../workflow/types");
+const mcp_permission_decorator_1 = require("../decorators/mcp-permission.decorator");
+const mcp_permission_guard_1 = require("../guards/mcp-permission.guard");
+const hexabot_mcp_tool_base_1 = require("./hexabot-mcp-tool.base");
+const hexabot_mcp_schemas_1 = require("./hexabot-mcp.schemas");
+let HexabotMemoryDefinitionMcpTools = class HexabotMemoryDefinitionMcpTools extends hexabot_mcp_tool_base_1.HexabotMcpToolBase {
+    constructor(memoryDefinitionService) {
+        super();
+        this.memoryDefinitionService = memoryDefinitionService;
+    }
+    async searchMemoryDefinitions(args) {
+        const base = args.scope ? { scope: args.scope } : {};
+        const where = args.query
+            ? [
+                { ...base, name: this.contains(args.query) },
+                { ...base, slug: this.contains(args.query) },
+            ]
+            : base;
+        return await this.listWithCount(this.memoryDefinitionService, this.findOptions(args, where));
+    }
+    async getMemoryDefinition(args) {
+        const definition = await this.memoryDefinitionService.findOne(args.id);
+        if (!definition) {
+            throw new common_1.NotFoundException(`Memory definition ${args.id} not found`);
+        }
+        return definition;
+    }
+    async createMemoryDefinition(args) {
+        return await this.memoryDefinitionService.create(args);
+    }
+    async updateMemoryDefinition(args) {
+        const { id, ...updates } = args;
+        return await this.memoryDefinitionService.updateOne(id, updates);
+    }
+};
+exports.HexabotMemoryDefinitionMcpTools = HexabotMemoryDefinitionMcpTools;
+__decorate([
+    (0, mcp_permission_decorator_1.McpPermission)('memorydefinition', types_1.Action.READ),
+    (0, mcp_nest_1.ToolGuards)([mcp_permission_guard_1.McpPermissionGuard]),
+    (0, mcp_nest_1.Tool)({
+        name: 'hexabot_memory_definition_search',
+        description: 'Search workflow memory definitions.',
+        parameters: zod_1.z.object({
+            query: zod_1.z.string().optional(),
+            scope: zod_1.z.enum(types_2.MemoryScope).optional(),
+            ...hexabot_mcp_schemas_1.paginationSchema,
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HexabotMemoryDefinitionMcpTools.prototype, "searchMemoryDefinitions", null);
+__decorate([
+    (0, mcp_permission_decorator_1.McpPermission)('memorydefinition', types_1.Action.READ),
+    (0, mcp_nest_1.ToolGuards)([mcp_permission_guard_1.McpPermissionGuard]),
+    (0, mcp_nest_1.Tool)({
+        name: 'hexabot_memory_definition_get',
+        description: 'Read one workflow memory definition.',
+        parameters: zod_1.z.object({
+            id: hexabot_mcp_schemas_1.uuidSchema,
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HexabotMemoryDefinitionMcpTools.prototype, "getMemoryDefinition", null);
+__decorate([
+    (0, mcp_permission_decorator_1.McpPermission)('memorydefinition', types_1.Action.CREATE),
+    (0, mcp_nest_1.ToolGuards)([mcp_permission_guard_1.McpPermissionGuard]),
+    (0, mcp_nest_1.Tool)({
+        name: 'hexabot_memory_definition_create',
+        description: 'Create a workflow memory definition.',
+        parameters: zod_1.z.object({
+            name: zod_1.z.string().min(1),
+            slug: zod_1.z.string().regex(/^[a-z0-9_]+$/),
+            scope: zod_1.z.enum(types_2.MemoryScope),
+            schema: hexabot_mcp_schemas_1.jsonObjectSchema,
+            ttlSeconds: zod_1.z.number().int().min(1).nullable().optional(),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HexabotMemoryDefinitionMcpTools.prototype, "createMemoryDefinition", null);
+__decorate([
+    (0, mcp_permission_decorator_1.McpPermission)('memorydefinition', types_1.Action.UPDATE),
+    (0, mcp_nest_1.ToolGuards)([mcp_permission_guard_1.McpPermissionGuard]),
+    (0, mcp_nest_1.Tool)({
+        name: 'hexabot_memory_definition_update',
+        description: 'Update a workflow memory definition.',
+        parameters: zod_1.z.object({
+            id: hexabot_mcp_schemas_1.uuidSchema,
+            name: zod_1.z.string().min(1).optional(),
+            slug: zod_1.z
+                .string()
+                .regex(/^[a-z0-9_]+$/)
+                .optional(),
+            scope: zod_1.z.enum(types_2.MemoryScope).optional(),
+            schema: hexabot_mcp_schemas_1.jsonObjectSchema.optional(),
+            ttlSeconds: zod_1.z.number().int().min(1).nullable().optional(),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HexabotMemoryDefinitionMcpTools.prototype, "updateMemoryDefinition", null);
+exports.HexabotMemoryDefinitionMcpTools = HexabotMemoryDefinitionMcpTools = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [memory_definition_service_1.MemoryDefinitionService])
+], HexabotMemoryDefinitionMcpTools);
+//# sourceMappingURL=memory-definition-mcp.tools.js.map

package/dist/mcp/tools/memory-definition-mcp.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-definition-mcp.tools.js","sourceRoot":"","sources":["../../../src/mcp/tools/memory-definition-mcp.tools.ts"],"names":[],"mappings":";;;;;;;;;;;;AAMA,6CAA2C;AAC3C,2CAA+D;AAC/D,8CAAmD;AACnD,6BAAwB;AAExB,iGAAwF;AACxF,gDAA+C;AAE/C,qFAAuE;AACvE,yEAAoE;AAEpE,mEAA6D;AAC7D,+DAK+B;AAGxB,IAAM,+BAA+B,GAArC,MAAM,+BAAgC,SAAQ,0CAAkB;IACrE,YACmB,uBAAgD;QAEjE,KAAK,EAAE,CAAC;QAFS,4BAAuB,GAAvB,uBAAuB,CAAyB;IAGnE,CAAC;IAaK,AAAN,KAAK,CAAC,uBAAuB,CAC3B,IAA8D;QAE9D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK;YACtB,CAAC,CAAC;gBACE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;gBAC5C,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;aAC7C;YACH,CAAC,CAAC,IAAI,CAAC;QAET,OAAO,MAAM,IAAI,CAAC,aAAa,CAC7B,IAAI,CAAC,uBAAuB,EAC5B,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAC9B,CAAC;IACJ,CAAC;IAWK,AAAN,KAAK,CAAC,mBAAmB,CAAC,IAAoB;QAC5C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,0BAAiB,CAAC,qBAAqB,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAeK,AAAN,KAAK,CAAC,sBAAsB,CAAC,IAM5B;QACC,OAAO,MAAM,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,IAAW,CAAC,CAAC;IAChE,CAAC;IAmBK,AAAN,KAAK,CAAC,sBAAsB,CAAC,IAA8C;QACzE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;QAEhC,OAAO,MAAM,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,EAAE,EAAE,OAAc,CAAC,CAAC;IAC1E,CAAC;CACF,CAAA;AAlGY,0EAA+B;AAkBpC;IAXL,IAAA,wCAAa,EAAC,kBAAkB,EAAE,cAAM,CAAC,IAAI,CAAC;IAC9C,IAAA,qBAAU,EAAC,CAAC,yCAAkB,CAAC,CAAC;IAChC,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,kCAAkC;QACxC,WAAW,EAAE,qCAAqC;QAClD,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,KAAK,EAAE,OAAC,CAAC,IAAI,CAAC,mBAAW,CAAC,CAAC,QAAQ,EAAE;YACrC,GAAG,sCAAgB;SACpB,CAAC;KACH,CAAC;;;;8EAgBD;AAWK;IATL,IAAA,wCAAa,EAAC,kBAAkB,EAAE,cAAM,CAAC,IAAI,CAAC;IAC9C,IAAA,qBAAU,EAAC,CAAC,yCAAkB,CAAC,CAAC;IAChC,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,sCAAsC;QACnD,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,EAAE,EAAE,gCAAU;SACf,CAAC;KACH,CAAC;;;;0EAQD;AAeK;IAbL,IAAA,wCAAa,EAAC,kBAAkB,EAAE,cAAM,CAAC,MAAM,CAAC;IAChD,IAAA,qBAAU,EAAC,CAAC,yCAAkB,CAAC,CAAC;IAChC,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,kCAAkC;QACxC,WAAW,EAAE,sCAAsC;QACnD,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC;YACtC,KAAK,EAAE,OAAC,CAAC,IAAI,CAAC,mBAAW,CAAC;YAC1B,MAAM,EAAE,sCAAgB;YACxB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;SAC1D,CAAC;KACH,CAAC;;;;6EASD;AAmBK;IAjBL,IAAA,wCAAa,EAAC,kBAAkB,EAAE,cAAM,CAAC,MAAM,CAAC;IAChD,IAAA,qBAAU,EAAC,CAAC,yCAAkB,CAAC,CAAC;IAChC,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,kCAAkC;QACxC,WAAW,EAAE,sCAAsC;QACnD,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,EAAE,EAAE,gCAAU;YACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YAClC,IAAI,EAAE,OAAC;iBACJ,MAAM,EAAE;iBACR,KAAK,CAAC,cAAc,CAAC;iBACrB,QAAQ,EAAE;YACb,KAAK,EAAE,OAAC,CAAC,IAAI,CAAC,mBAAW,CAAC,CAAC,QAAQ,EAAE;YACrC,MAAM,EAAE,sCAAgB,CAAC,QAAQ,EAAE;YACnC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;SAC1D,CAAC;KACH,CAAC;;;;6EAKD;0CAjGU,+BAA+B;IAD3C,IAAA,mBAAU,GAAE;qCAGiC,mDAAuB;GAFxD,+BAA+B,CAkG3C"}

package/dist/mcp/tools/workflow-mcp.helper.d.ts

@@ -0,0 +1,156 @@
+import { type WorkflowFull, type WorkflowVersion, type WorkflowVersionFull } from '@hexabot-ai/types';
+import { WorkflowVersionService } from "../../workflow/services/workflow-version.service";
+import { WorkflowService } from "../../workflow/services/workflow.service";
+import { WorkflowVersionAction } from "../../workflow/types";
+type WorkflowVersionLike = WorkflowVersion | WorkflowVersionFull;
+type WorkflowVersionSummary = Pick<WorkflowVersion, 'id' | 'version' | 'checksum' | 'message' | 'action' | 'createdAt' | 'updatedAt'> & {
+    parentVersion: WorkflowVersion['parentVersion'] | WorkflowVersionFull['parentVersion'];
+    workflow: WorkflowVersion['workflow'] | WorkflowVersionFull['workflow'];
+    createdBy: WorkflowVersion['createdBy'] | WorkflowVersionFull['createdBy'];
+    definitionYmlByteLength?: number;
+};
+type WorkflowSummary = Omit<WorkflowFull, 'currentVersion' | 'publishedVersion' | 'definitionYml' | 'definition'> & {
+    currentVersion: WorkflowVersionSummary | null;
+    publishedVersion: WorkflowVersionSummary | null;
+    currentVersionId: string | null;
+    publishedVersionId: string | null;
+};
+export declare class HexabotWorkflowMcpHelper {
+    private readonly workflowService;
+    private readonly workflowVersionService;
+    constructor(workflowService: WorkflowService, workflowVersionService: WorkflowVersionService);
+    requireWorkflow(id: string): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        name: string;
+        description: string | null;
+        type: import("@hexabot-ai/types").WorkflowType;
+        schedule: string | null;
+        inputSchema: any;
+        builtin: boolean;
+        x: number;
+        y: number;
+        zoom: number;
+        direction: import("@hexabot-ai/types").DirectionType;
+        currentVersion: {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            version: number;
+            definitionYml: string;
+            checksum: string;
+            message: string | null;
+            action: import("@hexabot-ai/types/dist/types/workflow/domain").WorkflowVersionAction | null;
+            parentVersion: string | null;
+            workflow: string;
+            createdBy: string | null;
+        } | null;
+        publishedVersion: {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            version: number;
+            definitionYml: string;
+            checksum: string;
+            message: string | null;
+            action: import("@hexabot-ai/types/dist/types/workflow/domain").WorkflowVersionAction | null;
+            parentVersion: string | null;
+            workflow: string;
+            createdBy: string | null;
+        } | null;
+        createdBy: {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            firstName: string;
+            lastName: string;
+            language: string | null;
+            timezone: number;
+            locale: string | null;
+            gender: string | null;
+            country: string | null;
+            foreignId: string | null;
+            assignedAt: Date | null;
+            lastvisit: Date | null;
+            retainedFrom: Date | null;
+            channel: {
+                name: string | null;
+                data?: Record<string, any> | null | undefined;
+            };
+            username: string;
+            email: string;
+            sendEmail: boolean;
+            state: boolean;
+            resetCount: number;
+            resetToken: string | null;
+            labels: string[];
+            assignedTo: string | null;
+            roles: string[];
+            avatar: string | null;
+            provider?: {
+                strategy: "local";
+                sub?: string | undefined;
+            } | undefined;
+        } | null;
+        definitionYml?: string | undefined;
+        definition?: any;
+    }>;
+    commitWorkflowDefinition(params: {
+        workflowId: string;
+        definitionYml: string;
+        message?: string | null;
+        parentVersion?: string | null;
+        action?: WorkflowVersionAction;
+        createdBy: string;
+    }): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        version: number;
+        definitionYml: string;
+        checksum: string;
+        message: string | null;
+        action: import("@hexabot-ai/types/dist/types/workflow/domain").WorkflowVersionAction | null;
+        parentVersion: string | null;
+        workflow: string;
+        createdBy: string | null;
+    }>;
+    restoreWorkflowVersionSnapshot(args: {
+        workflowId: string;
+        versionId: string;
+        message?: string;
+    }, updatedBy: string): Promise<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        version: number;
+        definitionYml: string;
+        checksum: string;
+        message: string | null;
+        action: import("@hexabot-ai/types/dist/types/workflow/domain").WorkflowVersionAction | null;
+        parentVersion: string | null;
+        workflow: string;
+        createdBy: string | null;
+    }>;
+    buildWorkflowVersionStatus(workflow: WorkflowFull): {
+        workflow: {
+            id: string;
+            name: string;
+            type: import("@hexabot-ai/types").WorkflowType;
+        };
+        currentVersion: WorkflowVersionSummary | null;
+        publishedVersion: WorkflowVersionSummary | null;
+        currentVersionId: string | null;
+        publishedVersionId: string | null;
+        isPublished: boolean;
+        isCurrentVersionPublished: boolean;
+        hasUnpublishedChanges: boolean;
+    };
+    summarizeWorkflow(workflow: WorkflowFull): WorkflowSummary;
+    summarizeWorkflowVersion(version: WorkflowVersionLike | null | undefined, options?: {
+        includeDefinitionYmlByteLength?: boolean;
+    }): WorkflowVersionSummary | null;
+    private resolveRelationId;
+}
+export {};

package/dist/mcp/tools/workflow-mcp.helper.js

@@ -0,0 +1,128 @@
+"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.HexabotWorkflowMcpHelper = void 0;
+const common_1 = require("@nestjs/common");
+const workflow_definition_1 = require("../../workflow/lib/workflow-definition");
+const workflow_version_service_1 = require("../../workflow/services/workflow-version.service");
+const workflow_service_1 = require("../../workflow/services/workflow.service");
+const types_1 = require("../../workflow/types");
+let HexabotWorkflowMcpHelper = class HexabotWorkflowMcpHelper {
+    constructor(workflowService, workflowVersionService) {
+        this.workflowService = workflowService;
+        this.workflowVersionService = workflowVersionService;
+    }
+    async requireWorkflow(id) {
+        const workflow = await this.workflowService.findOneAndPopulate(id);
+        if (!workflow) {
+            throw new common_1.NotFoundException(`Workflow ${id} not found`);
+        }
+        return workflow;
+    }
+    async commitWorkflowDefinition(params) {
+        const workflow = await this.requireWorkflow(params.workflowId);
+        try {
+            (0, workflow_definition_1.parseWorkflowDefinition)(params.definitionYml);
+        }
+        catch (error) {
+            throw new common_1.BadRequestException(error instanceof Error ? error.message : 'Invalid workflow YAML');
+        }
+        const parentVersion = params.parentVersion === undefined
+            ? this.resolveRelationId(workflow.currentVersion)
+            : params.parentVersion;
+        const payload = {
+            workflow: params.workflowId,
+            definitionYml: params.definitionYml,
+            message: params.message ?? undefined,
+            parentVersion: parentVersion ?? undefined,
+            action: params.action ?? types_1.WorkflowVersionAction.update,
+            createdBy: params.createdBy,
+        };
+        return await this.workflowVersionService.commit(payload);
+    }
+    async restoreWorkflowVersionSnapshot(args, updatedBy) {
+        return await this.workflowVersionService.restoreVersion(args.workflowId, args.versionId, {
+            updatedBy,
+            message: args.message,
+        });
+    }
+    buildWorkflowVersionStatus(workflow) {
+        const currentVersion = this.summarizeWorkflowVersion(workflow.currentVersion);
+        const publishedVersion = this.summarizeWorkflowVersion(workflow.publishedVersion);
+        const currentVersionId = currentVersion?.id ?? null;
+        const publishedVersionId = publishedVersion?.id ?? null;
+        return {
+            workflow: {
+                id: workflow.id,
+                name: workflow.name,
+                type: workflow.type,
+            },
+            currentVersion,
+            publishedVersion,
+            currentVersionId,
+            publishedVersionId,
+            isPublished: Boolean(publishedVersionId),
+            isCurrentVersionPublished: Boolean(currentVersionId) && currentVersionId === publishedVersionId,
+            hasUnpublishedChanges: Boolean(currentVersionId) && currentVersionId !== publishedVersionId,
+        };
+    }
+    summarizeWorkflow(workflow) {
+        const { currentVersion, publishedVersion, definitionYml: _definitionYml, definition: _definition, ...metadata } = workflow;
+        const currentVersionSummary = this.summarizeWorkflowVersion(currentVersion);
+        const publishedVersionSummary = this.summarizeWorkflowVersion(publishedVersion);
+        return {
+            ...metadata,
+            currentVersion: currentVersionSummary,
+            publishedVersion: publishedVersionSummary,
+            currentVersionId: currentVersionSummary?.id ?? null,
+            publishedVersionId: publishedVersionSummary?.id ?? null,
+        };
+    }
+    summarizeWorkflowVersion(version, options) {
+        if (!version) {
+            return null;
+        }
+        const { id, version: versionNumber, checksum, message, action, parentVersion, workflow, createdBy, createdAt, updatedAt, } = version;
+        const summary = {
+            id,
+            version: versionNumber,
+            checksum,
+            message,
+            action,
+            parentVersion,
+            workflow,
+            createdBy,
+            createdAt,
+            updatedAt,
+            ...(options?.includeDefinitionYmlByteLength
+                ? {
+                    definitionYmlByteLength: typeof version.definitionYml === 'string'
+                        ? Buffer.byteLength(version.definitionYml, 'utf8')
+                        : undefined,
+                }
+                : {}),
+        };
+        return Object.fromEntries(Object.entries(summary).filter(([, value]) => value !== undefined));
+    }
+    resolveRelationId(relation) {
+        if (typeof relation === 'string') {
+            return relation;
+        }
+        return relation?.id ?? null;
+    }
+};
+exports.HexabotWorkflowMcpHelper = HexabotWorkflowMcpHelper;
+exports.HexabotWorkflowMcpHelper = HexabotWorkflowMcpHelper = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [workflow_service_1.WorkflowService,
+        workflow_version_service_1.WorkflowVersionService])
+], HexabotWorkflowMcpHelper);
+//# sourceMappingURL=workflow-mcp.helper.js.map

package/dist/mcp/tools/workflow-mcp.helper.js.map

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