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

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

@@ -0,0 +1,242 @@
+"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.HexabotWorkflowRunMcpTools = void 0;
+const agentic_1 = require("@hexabot-ai/agentic");
+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 trigger_event_wrapper_1 = require("../../workflow/lib/trigger-event-wrapper");
+const agentic_service_1 = require("../../workflow/services/agentic.service");
+const workflow_run_service_1 = require("../../workflow/services/workflow-run.service");
+const workflow_service_1 = require("../../workflow/services/workflow.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");
+const hexabot_mcp_utils_1 = require("./hexabot-mcp.utils");
+const WORKFLOW_DEFINITION_RESPONSE_KEYS = ['definitionYml'];
+let HexabotWorkflowRunMcpTools = class HexabotWorkflowRunMcpTools extends hexabot_mcp_tool_base_1.HexabotMcpToolBase {
+    constructor(workflowService, workflowRunService, agenticService) {
+        super();
+        this.workflowService = workflowService;
+        this.workflowRunService = workflowRunService;
+        this.agenticService = agenticService;
+    }
+    async runWorkflow(args, _context, request) {
+        const actor = this.getActor(request);
+        const workflow = await this.workflowService.findOne(args.workflowId);
+        if (!workflow) {
+            throw new common_1.NotFoundException(`Workflow ${args.workflowId} not found`);
+        }
+        if (workflow.type !== types_2.WorkflowType.manual &&
+            workflow.type !== types_2.WorkflowType.scheduled) {
+            throw new common_1.BadRequestException('Workflow must be manual or scheduled to run manually');
+        }
+        const event = workflow.type === types_2.WorkflowType.scheduled
+            ? new trigger_event_wrapper_1.ScheduledEventWrapper({
+                schedule: workflow.schedule ?? null,
+                triggeredAt: new Date(),
+            })
+            : new trigger_event_wrapper_1.ManualEventWrapper(this.workflowService.validateManualInput(args.input ?? {}, workflow.inputSchema), actor.id);
+        event.setInitiator(actor);
+        event.setWorkflowId(workflow.id);
+        const run = await this.agenticService.handleEvent(event);
+        return { accepted: true, run };
+    }
+    async searchWorkflowRuns(args) {
+        const where = {
+            ...(args.workflowId ? { workflow: { id: args.workflowId } } : {}),
+            ...(args.status ? { status: args.status } : {}),
+        };
+        const result = await this.listWithCount(this.workflowRunService, this.findOptions(args, where));
+        return this.sanitizeWorkflowRunResponse(result);
+    }
+    async getWorkflowRun(args) {
+        const run = await this.workflowRunService.findOneAndPopulate(args.id);
+        if (!run) {
+            throw new common_1.NotFoundException(`Workflow run ${args.id} not found`);
+        }
+        return this.withoutWorkflowDefinition(run);
+    }
+    async debugWorkflowRun(args) {
+        const run = await this.workflowRunService.findOneAndPopulate(args.id);
+        if (!run) {
+            throw new common_1.NotFoundException(`Workflow run ${args.id} not found`);
+        }
+        const includeRelatedRuns = args.includeRelatedRuns ?? true;
+        const childRunsLimit = args.childRunsLimit ?? 10;
+        const parentRunId = this.resolveRelationId(run.parentRun);
+        const childWhere = { parentRun: { id: run.id } };
+        const [parentRun, childRuns, childRunTotal] = includeRelatedRuns
+            ? await Promise.all([
+                parentRunId
+                    ? this.workflowRunService.findOneAndPopulate(parentRunId)
+                    : Promise.resolve(null),
+                this.workflowRunService.findAndPopulate({
+                    where: childWhere,
+                    order: { createdAt: 'ASC' },
+                    take: childRunsLimit,
+                }),
+                this.workflowRunService.count({ where: childWhere }),
+            ])
+            : [null, [], 0];
+        const includeWorkflowDefinition = args.includeWorkflowDefinition ?? true;
+        const response = {
+            run: this.withoutWorkflowDefinition(run),
+            relatedRuns: {
+                parent: this.withoutWorkflowDefinition(parentRun),
+                children: this.withoutWorkflowDefinition(childRuns),
+                childRunTotal,
+                childRunsLimit: includeRelatedRuns ? childRunsLimit : 0,
+            },
+            summary: this.buildWorkflowRunDebugSummary(run, childRunTotal),
+        };
+        if (includeWorkflowDefinition) {
+            response.workflowDefinitionYml =
+                run.workflowVersion?.definitionYml ?? null;
+        }
+        return response;
+    }
+    buildWorkflowRunDebugSummary(run, childRunTotal) {
+        const stepEntries = Object.entries(run.stepLog ?? {});
+        const stepStatusCounts = stepEntries.reduce((counts, [, step]) => ({
+            ...counts,
+            [step.status]: (counts[step.status] ?? 0) + 1,
+        }), {});
+        const failedSteps = stepEntries
+            .filter(([, step]) => step.status === agentic_1.EWorkflowRunStatus.FAILED || Boolean(step.error))
+            .map(([stepId, step]) => ({
+            id: step.id ?? stepId,
+            name: step.name ?? stepId,
+            action: step.action ?? null,
+            status: step.status,
+            error: step.error ?? null,
+            reason: step.reason ?? null,
+        }));
+        return {
+            id: run.id,
+            status: run.status,
+            workflow: {
+                id: run.workflow.id,
+                name: run.workflow.name,
+                type: run.workflow.type,
+            },
+            workflowVersion: run.workflowVersion
+                ? {
+                    id: run.workflowVersion.id,
+                    version: run.workflowVersion.version,
+                    checksum: run.workflowVersion.checksum,
+                }
+                : null,
+            error: run.error ?? null,
+            duration: run.duration ?? null,
+            createdAt: run.createdAt,
+            updatedAt: run.updatedAt,
+            suspendedAt: run.suspendedAt ?? null,
+            finishedAt: run.finishedAt ?? null,
+            failedAt: run.failedAt ?? null,
+            suspension: run.status === agentic_1.EWorkflowRunStatus.SUSPENDED
+                ? {
+                    step: run.suspendedStep ?? null,
+                    reason: run.suspensionReason ?? null,
+                    stepExecId: run.suspensionStepExecId ?? null,
+                    index: run.suspensionIndex ?? null,
+                    key: run.suspensionKey ?? null,
+                }
+                : null,
+            stepStatusCounts,
+            failedSteps,
+            childRunTotal,
+        };
+    }
+    sanitizeWorkflowRunResponse(response) {
+        return {
+            ...response,
+            items: this.withoutWorkflowDefinition(response.items),
+        };
+    }
+    withoutWorkflowDefinition(value) {
+        return (0, hexabot_mcp_utils_1.omitKeysDeep)(value, WORKFLOW_DEFINITION_RESPONSE_KEYS);
+    }
+};
+exports.HexabotWorkflowRunMcpTools = HexabotWorkflowRunMcpTools;
+__decorate([
+    (0, mcp_permission_decorator_1.McpPermission)('workflowrun', types_1.Action.CREATE),
+    (0, mcp_nest_1.ToolGuards)([mcp_permission_guard_1.McpPermissionGuard]),
+    (0, mcp_nest_1.Tool)({
+        name: 'hexabot_workflow_run',
+        description: 'Run a manual or scheduled workflow and return the run summary.',
+        parameters: zod_1.z.object({
+            workflowId: hexabot_mcp_schemas_1.uuidSchema,
+            input: hexabot_mcp_schemas_1.jsonObjectSchema.default({}),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, Object]),
+    __metadata("design:returntype", Promise)
+], HexabotWorkflowRunMcpTools.prototype, "runWorkflow", null);
+__decorate([
+    (0, mcp_permission_decorator_1.McpPermission)('workflowrun', types_1.Action.READ),
+    (0, mcp_nest_1.ToolGuards)([mcp_permission_guard_1.McpPermissionGuard]),
+    (0, mcp_nest_1.Tool)({
+        name: 'hexabot_workflow_run_search',
+        description: 'Search workflow runs by workflow and status.',
+        parameters: zod_1.z.object({
+            workflowId: hexabot_mcp_schemas_1.uuidSchema.optional(),
+            status: zod_1.z.string().optional(),
+            ...hexabot_mcp_schemas_1.paginationSchema,
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HexabotWorkflowRunMcpTools.prototype, "searchWorkflowRuns", null);
+__decorate([
+    (0, mcp_permission_decorator_1.McpPermission)('workflowrun', types_1.Action.READ),
+    (0, mcp_nest_1.ToolGuards)([mcp_permission_guard_1.McpPermissionGuard]),
+    (0, mcp_nest_1.Tool)({
+        name: 'hexabot_workflow_run_get',
+        description: 'Read one workflow run with populated workflow metadata.',
+        parameters: zod_1.z.object({
+            id: hexabot_mcp_schemas_1.uuidSchema,
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HexabotWorkflowRunMcpTools.prototype, "getWorkflowRun", null);
+__decorate([
+    (0, mcp_permission_decorator_1.McpPermission)('workflowrun', types_1.Action.READ),
+    (0, mcp_nest_1.ToolGuards)([mcp_permission_guard_1.McpPermissionGuard]),
+    (0, mcp_nest_1.Tool)({
+        name: 'hexabot_workflow_run_debug',
+        description: 'Inspect one workflow run for debugging with execution state, workflow YAML, and related parent/child runs.',
+        parameters: zod_1.z.object({
+            id: hexabot_mcp_schemas_1.uuidSchema,
+            includeWorkflowDefinition: zod_1.z.boolean().default(true),
+            includeRelatedRuns: zod_1.z.boolean().default(true),
+            childRunsLimit: zod_1.z.number().int().min(1).max(50).default(10),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HexabotWorkflowRunMcpTools.prototype, "debugWorkflowRun", null);
+exports.HexabotWorkflowRunMcpTools = HexabotWorkflowRunMcpTools = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [workflow_service_1.WorkflowService,
+        workflow_run_service_1.WorkflowRunService,
+        agentic_service_1.AgenticService])
+], HexabotWorkflowRunMcpTools);
+//# sourceMappingURL=workflow-run-mcp.tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-run-mcp.tools.js","sourceRoot":"","sources":["../../../src/mcp/tools/workflow-run-mcp.tools.ts"],"names":[],"mappings":";;;;;;;;;;;;AAMA,iDAI6B;AAC7B,6CAAiE;AACjE,2CAIwB;AACxB,8CAAmD;AACnD,6BAAwB;AAGxB,oFAG8C;AAC9C,6EAAqE;AACrE,uFAA8E;AAC9E,+EAAuE;AACvE,gDAAgD;AAEhD,qFAAuE;AACvE,yEAAoE;AAGpE,mEAA6D;AAC7D,+DAK+B;AAC/B,2DAAmD;AAEnD,MAAM,iCAAiC,GAAG,CAAC,eAAe,CAAU,CAAC;AAG9D,IAAM,0BAA0B,GAAhC,MAAM,0BAA2B,SAAQ,0CAAkB;IAChE,YACmB,eAAgC,EAChC,kBAAsC,EACtC,cAA8B;QAE/C,KAAK,EAAE,CAAC;QAJS,oBAAe,GAAf,eAAe,CAAiB;QAChC,uBAAkB,GAAlB,kBAAkB,CAAoB;QACtC,mBAAc,GAAd,cAAc,CAAgB;IAGjD,CAAC;IAaK,AAAN,KAAK,CAAC,WAAW,CACf,IAA4D,EAC5D,QAAiB,EACjB,OAA2B;QAE3B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,0BAAiB,CAAC,YAAY,IAAI,CAAC,UAAU,YAAY,CAAC,CAAC;QACvE,CAAC;QAED,IACE,QAAQ,CAAC,IAAI,KAAK,oBAAY,CAAC,MAAM;YACrC,QAAQ,CAAC,IAAI,KAAK,oBAAY,CAAC,SAAS,EACxC,CAAC;YACD,MAAM,IAAI,4BAAmB,CAC3B,sDAAsD,CACvD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GACT,QAAQ,CAAC,IAAI,KAAK,oBAAY,CAAC,SAAS;YACtC,CAAC,CAAC,IAAI,6CAAqB,CAAC;gBACxB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;gBACnC,WAAW,EAAE,IAAI,IAAI,EAAE;aACxB,CAAC;YACJ,CAAC,CAAC,IAAI,0CAAkB,CACpB,IAAI,CAAC,eAAe,CAAC,mBAAmB,CACtC,IAAI,CAAC,KAAK,IAAI,EAAE,EAChB,QAAQ,CAAC,WAAW,CACrB,EACD,KAAK,CAAC,EAAE,CACT,CAAC;QACR,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEjC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAEzD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACjC,CAAC;IAaK,AAAN,KAAK,CAAC,kBAAkB,CACtB,IAA+D;QAE/D,MAAM,KAAK,GAAG;YACZ,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzC,CAAC;QACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CACrC,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,WAAW,CAAuB,IAAI,EAAE,KAAK,CAAC,CACpD,CAAC;QAEF,OAAO,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAWK,AAAN,KAAK,CAAC,cAAc,CAAC,IAAoB;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,0BAAiB,CAAC,gBAAgB,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAeK,AAAN,KAAK,CAAC,gBAAgB,CAAC,IAKtB;QACC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,0BAAiB,CAAC,gBAAgB,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC;QAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,UAAU,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAS,CAAC;QACxD,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,GAAG,kBAAkB;YAC9D,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,WAAW;oBACT,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,WAAW,CAAC;oBACzD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;gBACzB,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC;oBACtC,KAAK,EAAE,UAAU;oBACjB,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;oBAC3B,IAAI,EAAE,cAAc;iBACrB,CAAC;gBACF,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;aACrD,CAAC;YACJ,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAW,CAAC;QAC7B,MAAM,yBAAyB,GAAG,IAAI,CAAC,yBAAyB,IAAI,IAAI,CAAC;QACzE,MAAM,QAAQ,GAA4B;YACxC,GAAG,EAAE,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC;YACxC,WAAW,EAAE;gBACX,MAAM,EAAE,IAAI,CAAC,yBAAyB,CAAC,SAAS,CAAC;gBACjD,QAAQ,EAAE,IAAI,CAAC,yBAAyB,CAAC,SAAS,CAAC;gBACnD,aAAa;gBACb,cAAc,EAAE,kBAAkB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;aACxD;YACD,OAAO,EAAE,IAAI,CAAC,4BAA4B,CAAC,GAAG,EAAE,aAAa,CAAC;SAC/D,CAAC;QAEF,IAAI,yBAAyB,EAAE,CAAC;YAC9B,QAAQ,CAAC,qBAAqB;gBAC5B,GAAG,CAAC,eAAe,EAAE,aAAa,IAAI,IAAI,CAAC;QAC/C,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,4BAA4B,CAClC,GAAoB,EACpB,aAAqB;QAErB,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAGjD,CAAC;QACJ,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CACzC,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACrB,GAAG,MAAM;YACT,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;SAC9C,CAAC,EACF,EAAE,CACH,CAAC;QACF,MAAM,WAAW,GAAG,WAAW;aAC5B,MAAM,CACL,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CACX,IAAI,CAAC,MAAM,KAAK,4BAAkB,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CACnE;aACA,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,MAAM;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,MAAM;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;SAC5B,CAAC,CAAC,CAAC;QAEN,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,MAAM,EAAE,GAAG,CAAC,MAA2B;YACvC,QAAQ,EAAE;gBACR,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE;gBACnB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;gBACvB,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;aACxB;YACD,eAAe,EAAE,GAAG,CAAC,eAAe;gBAClC,CAAC,CAAC;oBACE,EAAE,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE;oBAC1B,OAAO,EAAE,GAAG,CAAC,eAAe,CAAC,OAAO;oBACpC,QAAQ,EAAE,GAAG,CAAC,eAAe,CAAC,QAAQ;iBACvC;gBACH,CAAC,CAAC,IAAI;YACR,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,IAAI;YAC9B,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;YACpC,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;YAClC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,IAAI;YAC9B,UAAU,EACR,GAAG,CAAC,MAAM,KAAK,4BAAkB,CAAC,SAAS;gBACzC,CAAC,CAAC;oBACE,IAAI,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;oBAC/B,MAAM,EAAE,GAAG,CAAC,gBAAgB,IAAI,IAAI;oBACpC,UAAU,EAAE,GAAG,CAAC,oBAAoB,IAAI,IAAI;oBAC5C,KAAK,EAAE,GAAG,CAAC,eAAe,IAAI,IAAI;oBAClC,GAAG,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;iBAC/B;gBACH,CAAC,CAAC,IAAI;YACV,gBAAgB;YAChB,WAAW;YACX,aAAa;SACd,CAAC;IACJ,CAAC;IAEO,2BAA2B,CACjC,QAAW;QAEX,OAAO;YACL,GAAG,QAAQ;YACX,KAAK,EAAE,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,KAAK,CAAC;SACtD,CAAC;IACJ,CAAC;IAEO,yBAAyB,CAAI,KAAQ;QAC3C,OAAO,IAAA,gCAAY,EAAC,KAAK,EAAE,iCAAiC,CAAC,CAAC;IAChE,CAAC;CACF,CAAA;AArPY,gEAA0B;AAoB/B;IAXL,IAAA,wCAAa,EAAC,aAAa,EAAE,cAAM,CAAC,MAAM,CAAC;IAC3C,IAAA,qBAAU,EAAC,CAAC,yCAAkB,CAAC,CAAC;IAChC,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,gEAAgE;QAClE,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,gCAAU;YACtB,KAAK,EAAE,sCAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;SACpC,CAAC;KACH,CAAC;;;;6DAwCD;AAaK;IAXL,IAAA,wCAAa,EAAC,aAAa,EAAE,cAAM,CAAC,IAAI,CAAC;IACzC,IAAA,qBAAU,EAAC,CAAC,yCAAkB,CAAC,CAAC;IAChC,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,8CAA8C;QAC3D,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,gCAAU,CAAC,QAAQ,EAAE;YACjC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,GAAG,sCAAgB;SACpB,CAAC;KACH,CAAC;;;;oEAcD;AAWK;IATL,IAAA,wCAAa,EAAC,aAAa,EAAE,cAAM,CAAC,IAAI,CAAC;IACzC,IAAA,qBAAU,EAAC,CAAC,yCAAkB,CAAC,CAAC;IAChC,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,yDAAyD;QACtE,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,EAAE,EAAE,gCAAU;SACf,CAAC;KACH,CAAC;;;;gEAQD;AAeK;IAbL,IAAA,wCAAa,EAAC,aAAa,EAAE,cAAM,CAAC,IAAI,CAAC;IACzC,IAAA,qBAAU,EAAC,CAAC,yCAAkB,CAAC,CAAC;IAChC,IAAA,eAAI,EAAC;QACJ,IAAI,EAAE,4BAA4B;QAClC,WAAW,EACT,4GAA4G;QAC9G,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,EAAE,EAAE,gCAAU;YACd,yBAAyB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;YACpD,kBAAkB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;YAC7C,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;SAC5D,CAAC;KACH,CAAC;;;;kEA+CD;qCApKU,0BAA0B;IADtC,IAAA,mBAAU,GAAE;qCAGyB,kCAAe;QACZ,yCAAkB;QACtB,gCAAc;GAJtC,0BAA0B,CAqPtC"}

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

@@ -0,0 +1,238 @@
+import { type WorkflowVersion, type WorkflowVersionFull } from '@hexabot-ai/types';
+import { ActionService } from "../../actions/actions.service";
+import { RuntimeBindingsService } from "../../bindings/runtime-bindings.service";
+import { WorkflowVersionService } from "../../workflow/services/workflow-version.service";
+import { WorkflowVersionAction } from "../../workflow/types";
+import { HexabotMcpRequest } from '../types';
+import { HexabotMcpToolBase } from './hexabot-mcp-tool.base';
+import { PaginationArgs } from './hexabot-mcp.schemas';
+import { HexabotWorkflowMcpHelper } from './workflow-mcp.helper';
+export declare class HexabotWorkflowVersionMcpTools extends HexabotMcpToolBase {
+    private readonly workflowVersionService;
+    private readonly actionService;
+    private readonly runtimeBindingsService;
+    private readonly workflowHelper;
+    constructor(workflowVersionService: WorkflowVersionService, actionService: ActionService, runtimeBindingsService: RuntimeBindingsService, workflowHelper: HexabotWorkflowMcpHelper);
+    commitWorkflowYaml(args: {
+        workflowId: string;
+        definitionYml: string;
+        message?: string;
+        parentVersion?: string | null;
+        action: WorkflowVersionAction;
+    }, _context: unknown, request?: HexabotMcpRequest): Promise<(Pick<{
+        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;
+    }, "id" | "createdAt" | "updatedAt" | "message" | "action" | "version" | "checksum"> & {
+        parentVersion: WorkflowVersion["parentVersion"] | WorkflowVersionFull["parentVersion"];
+        workflow: WorkflowVersion["workflow"] | WorkflowVersionFull["workflow"];
+        createdBy: WorkflowVersion["createdBy"] | WorkflowVersionFull["createdBy"];
+        definitionYmlByteLength?: number;
+    }) | null>;
+    validateWorkflowYaml(args: {
+        definitionYml: string;
+        validateActions?: boolean;
+    }): Promise<{
+        valid: boolean;
+        errors: string[];
+        definition?: undefined;
+    } | {
+        valid: boolean;
+        errors: never[];
+        definition: {
+            defs: Record<string, {
+                kind: "task";
+                action: string;
+                description?: string | undefined;
+                inputs?: Record<string, import("@hexabot-ai/agentic").JsonValue> | undefined;
+                bindings?: Record<string, string | string[]> | undefined;
+                settings?: {
+                    [x: string]: import("@hexabot-ai/agentic").JsonValue;
+                    timeout_ms?: number | undefined;
+                    retries?: {
+                        max_attempts: number;
+                        backoff_ms: number;
+                        max_delay_ms: number;
+                        jitter: number;
+                        multiplier: number;
+                        enabled?: boolean | undefined;
+                    } | undefined;
+                } | undefined;
+            } | {
+                kind: string;
+                settings: Record<string, unknown>;
+                description?: string | undefined;
+                action?: string | undefined;
+                bindings?: Record<string, string | string[]> | undefined;
+            }>;
+            flow: import("@hexabot-ai/agentic").FlowStep[];
+            outputs: Record<string, string>;
+            inputs?: {
+                schema?: Record<string, import("@hexabot-ai/agentic").InputField> | undefined;
+            } | undefined;
+            context?: Record<string, import("@hexabot-ai/agentic").JsonValue> | undefined;
+            defaults?: {
+                settings?: {
+                    [x: string]: import("@hexabot-ai/agentic").JsonValue;
+                    timeout_ms?: number | undefined;
+                    retries?: {
+                        max_attempts: number;
+                        backoff_ms: number;
+                        max_delay_ms: number;
+                        jitter: number;
+                        multiplier: number;
+                        enabled?: boolean | undefined;
+                    } | undefined;
+                } | undefined;
+            } | undefined;
+        };
+    }>;
+    searchWorkflowVersions(args: {
+        workflowId: string;
+    } & PaginationArgs): Promise<{
+        items: ((Pick<{
+            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;
+        }, "id" | "createdAt" | "updatedAt" | "message" | "action" | "version" | "checksum"> & {
+            parentVersion: WorkflowVersion["parentVersion"] | WorkflowVersionFull["parentVersion"];
+            workflow: WorkflowVersion["workflow"] | WorkflowVersionFull["workflow"];
+            createdBy: WorkflowVersion["createdBy"] | WorkflowVersionFull["createdBy"];
+            definitionYmlByteLength?: number;
+        }) | null)[];
+        total: number;
+        limit: number | undefined;
+        skip: number | undefined;
+    }>;
+    getWorkflowVersion(args: {
+        id: string;
+        workflowId?: string;
+    }): Promise<(Pick<{
+        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;
+    }, "id" | "createdAt" | "updatedAt" | "message" | "action" | "version" | "checksum"> & {
+        parentVersion: WorkflowVersion["parentVersion"] | WorkflowVersionFull["parentVersion"];
+        workflow: WorkflowVersion["workflow"] | WorkflowVersionFull["workflow"];
+        createdBy: WorkflowVersion["createdBy"] | WorkflowVersionFull["createdBy"];
+        definitionYmlByteLength?: number;
+    }) | null>;
+    getWorkflowYaml(args: {
+        workflowId?: string;
+        versionId?: string;
+        offset?: number;
+        limit?: number;
+    }): Promise<{
+        workflowId: string | null;
+        versionId: string;
+        version: number;
+        checksum: string;
+        definitionYmlByteLength: number;
+        definitionYmlLength: number;
+        chunk: {
+            offset: number;
+            limit: number;
+            unit: string;
+            endOffset: number;
+            length: number;
+            byteLength: number;
+            hasMore: boolean;
+            nextOffset: number | null;
+        };
+        definitionYml: string;
+    }>;
+    updateWorkflowVersion(args: {
+        id: string;
+        message?: string | null;
+    }): Promise<(Pick<{
+        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;
+    }, "id" | "createdAt" | "updatedAt" | "message" | "action" | "version" | "checksum"> & {
+        parentVersion: WorkflowVersion["parentVersion"] | WorkflowVersionFull["parentVersion"];
+        workflow: WorkflowVersion["workflow"] | WorkflowVersionFull["workflow"];
+        createdBy: WorkflowVersion["createdBy"] | WorkflowVersionFull["createdBy"];
+        definitionYmlByteLength?: number;
+    }) | null>;
+    restoreWorkflowVersion(args: {
+        workflowId: string;
+        versionId: string;
+        message?: string;
+    }, _context: unknown, request?: HexabotMcpRequest): Promise<(Pick<{
+        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;
+    }, "id" | "createdAt" | "updatedAt" | "message" | "action" | "version" | "checksum"> & {
+        parentVersion: WorkflowVersion["parentVersion"] | WorkflowVersionFull["parentVersion"];
+        workflow: WorkflowVersion["workflow"] | WorkflowVersionFull["workflow"];
+        createdBy: WorkflowVersion["createdBy"] | WorkflowVersionFull["createdBy"];
+        definitionYmlByteLength?: number;
+    }) | null>;
+    rollbackWorkflowVersion(args: {
+        workflowId: string;
+        versionId: string;
+        message?: string;
+    }, _context: unknown, request?: HexabotMcpRequest): Promise<(Pick<{
+        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;
+    }, "id" | "createdAt" | "updatedAt" | "message" | "action" | "version" | "checksum"> & {
+        parentVersion: WorkflowVersion["parentVersion"] | WorkflowVersionFull["parentVersion"];
+        workflow: WorkflowVersion["workflow"] | WorkflowVersionFull["workflow"];
+        createdBy: WorkflowVersion["createdBy"] | WorkflowVersionFull["createdBy"];
+        definitionYmlByteLength?: number;
+    }) | null>;
+    private getWorkflowValidationActions;
+    private requireWorkflowVersionForYaml;
+    private sliceUtf8Chunk;
+    private findUtf8IndexForOffset;
+    private readCodePoint;
+}