@hexabot-ai/api 3.2.2-alpha.13 → 3.2.2-alpha.15

package/dist/utils/test/port.d.ts

@@ -0,0 +1,8 @@
+export declare const getJestPort: () => number;
+export declare const getJestHost: () => string;
+export declare const getJestBaseUrl: () => string;
+export declare const configureJestNetworkEnv: () => {
+    port: number;
+    baseUrl: string;
+    apiOrigin: string;
+};

package/dist/utils/test/port.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureJestNetworkEnv = exports.getJestBaseUrl = exports.getJestHost = exports.getJestPort = void 0;
+const DEFAULT_JEST_PORT = 3001;
+const JEST_HOST = '127.0.0.1';
+const parsePort = (value, envName) => {
+    if (!value) {
+        return DEFAULT_JEST_PORT;
+    }
+    if (!/^\d+$/.test(value)) {
+        throw new Error(`Invalid ${envName} "${value}". Expected a TCP port between 1 and 65535.`);
+    }
+    const port = Number(value);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid ${envName} "${value}". Expected a TCP port between 1 and 65535.`);
+    }
+    return port;
+};
+const getJestPort = () => parsePort(process.env.JEST_PORT, 'JEST_PORT');
+exports.getJestPort = getJestPort;
+const getJestHost = () => JEST_HOST;
+exports.getJestHost = getJestHost;
+const getJestBaseUrl = () => `http://${(0, exports.getJestHost)()}:${(0, exports.getJestPort)()}`;
+exports.getJestBaseUrl = getJestBaseUrl;
+const configureJestNetworkEnv = () => {
+    const port = (0, exports.getJestPort)();
+    const baseUrl = `http://${(0, exports.getJestHost)()}:${port}`;
+    const apiOrigin = process.env.JEST_API_ORIGIN ?? `${baseUrl}/api`;
+    process.env.PORT = `${port}`;
+    process.env.API_ORIGIN = apiOrigin;
+    return { port, baseUrl, apiOrigin };
+};
+exports.configureJestNetworkEnv = configureJestNetworkEnv;
+//# sourceMappingURL=port.js.map

package/dist/utils/test/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../../src/utils/test/port.ts"],"names":[],"mappings":";;;AAMA,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,SAAS,GAAG,WAAW,CAAC;AAC9B,MAAM,SAAS,GAAG,CAAC,KAAyB,EAAE,OAAe,EAAU,EAAE;IACvE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,KAAK,KAAK,6CAA6C,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,KAAK,KAAK,6CAA6C,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEK,MAAM,WAAW,GAAG,GAAW,EAAE,CACtC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AADnC,QAAA,WAAW,eACwB;AAEzC,MAAM,WAAW,GAAG,GAAW,EAAE,CAAC,SAAS,CAAC;AAAtC,QAAA,WAAW,eAA2B;AAE5C,MAAM,cAAc,GAAG,GAAW,EAAE,CACzC,UAAU,IAAA,mBAAW,GAAE,IAAI,IAAA,mBAAW,GAAE,EAAE,CAAC;AADhC,QAAA,cAAc,kBACkB;AAEtC,MAAM,uBAAuB,GAAG,GAAG,EAAE;IAC1C,MAAM,IAAI,GAAG,IAAA,mBAAW,GAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,UAAU,IAAA,mBAAW,GAAE,IAAI,IAAI,EAAE,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,GAAG,OAAO,MAAM,CAAC;IAElE,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC;IAEnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACtC,CAAC,CAAC;AATW,QAAA,uBAAuB,2BASlC"}

package/dist/workflow/services/workflow.service.d.ts

@@ -24,11 +24,11 @@ export declare class WorkflowService extends BaseOrmService<WorkflowOrmEntity> {
         subscribe: `Workflow_${string}`;
     }>;
     private sendWorkflowEvent;
-    sendWorkflowStart(payload: WorkflowEventMap[keyof WorkflowEventMap]): void;
-    sendWorkflowFinish(payload: WorkflowEventMap[keyof WorkflowEventMap]): void;
-    sendWorkflowFailure(payload: WorkflowEventMap[keyof WorkflowEventMap]): void;
-    sendWorkflowStepStart(payload: WorkflowEventMap[keyof WorkflowEventMap]): void;
-    sendWorkflowStepSuspended(payload: WorkflowEventMap[keyof WorkflowEventMap]): void;
-    sendWorkflowStepSuccess(payload: WorkflowEventMap[keyof WorkflowEventMap]): void;
-    sendWorkflowStepError(payload: WorkflowEventMap[keyof WorkflowEventMap]): void;
+    sendWorkflowStart(payload: WorkflowEventMap[keyof WorkflowEventMap]): Promise<void>;
+    sendWorkflowFinish(payload: WorkflowEventMap[keyof WorkflowEventMap]): Promise<void>;
+    sendWorkflowFailure(payload: WorkflowEventMap[keyof WorkflowEventMap]): Promise<void>;
+    sendWorkflowStepStart(payload: WorkflowEventMap[keyof WorkflowEventMap]): Promise<void>;
+    sendWorkflowStepSuspended(payload: WorkflowEventMap[keyof WorkflowEventMap]): Promise<void>;
+    sendWorkflowStepSuccess(payload: WorkflowEventMap[keyof WorkflowEventMap]): Promise<void>;
+    sendWorkflowStepError(payload: WorkflowEventMap[keyof WorkflowEventMap]): Promise<void>;
 }

package/dist/workflow/services/workflow.service.js

@@ -20,7 +20,6 @@ const base_orm_service_1 = require("../../utils/generics/base-orm.service");
 const websocket_1 = require("../../websocket");
 const workflow_entity_1 = require("../entities/workflow.entity");
 const workflow_repository_1 = require("../repositories/workflow.repository");
-const types_1 = require("../types");
 const workflow_run_service_1 = require("./workflow-run.service");
 let WorkflowService = class WorkflowService extends base_orm_service_1.BaseOrmService {
     constructor(repository, gateway, workflowRunService) {
@@ -110,42 +109,48 @@ let WorkflowService = class WorkflowService extends base_orm_service_1.BaseOrmSe
             this.logger.error('workflowRun context is required');
             return;
         }
-        const { initiatorId, workflowId, threadId } = workflowRun?.context;
+        const { initiatorId, workflowId, threadId } = workflowRun.context;
+        if (typeof initiatorId !== 'string' ||
+            !initiatorId ||
+            typeof workflowId !== 'string' ||
+            !workflowId) {
+            this.logger.error('workflowRun context requires initiatorId and workflowId');
+            return;
+        }
         const workflow = await this.findOne(workflowId);
-        const canBroadcastEvents = initiatorId &&
-            workflow?.type &&
-            [types_1.WorkflowType.conversational].includes(workflow.type);
-        if (canBroadcastEvents) {
-            this.gateway.broadcastWorkflowEvent({
-                ...payload,
-                t,
-                workflowId,
-                initiatorId,
-                threadId: typeof threadId === 'string' ? threadId : undefined,
-                workflowEvent: workflowEvent.replace('hook:', ''),
-            });
+        if (!workflow?.type) {
+            this.logger.error('workflow is required');
+            return;
         }
+        this.gateway.broadcastWorkflowEvent({
+            ...payload,
+            t,
+            workflowId,
+            initiatorId,
+            threadId: typeof threadId === 'string' ? threadId : undefined,
+            workflowEvent: workflowEvent.replace('hook:', ''),
+        });
     }
-    sendWorkflowStart(payload) {
-        this.sendWorkflowEvent('hook:workflow:start', payload);
+    async sendWorkflowStart(payload) {
+        await this.sendWorkflowEvent('hook:workflow:start', payload);
     }
-    sendWorkflowFinish(payload) {
-        this.sendWorkflowEvent('hook:workflow:finish', payload);
+    async sendWorkflowFinish(payload) {
+        await this.sendWorkflowEvent('hook:workflow:finish', payload);
     }
-    sendWorkflowFailure(payload) {
-        this.sendWorkflowEvent('hook:workflow:failure', payload);
+    async sendWorkflowFailure(payload) {
+        await this.sendWorkflowEvent('hook:workflow:failure', payload);
     }
-    sendWorkflowStepStart(payload) {
-        this.sendWorkflowEvent('hook:step:start', payload);
+    async sendWorkflowStepStart(payload) {
+        await this.sendWorkflowEvent('hook:step:start', payload);
     }
-    sendWorkflowStepSuspended(payload) {
-        this.sendWorkflowEvent('hook:step:suspended', payload);
+    async sendWorkflowStepSuspended(payload) {
+        await this.sendWorkflowEvent('hook:step:suspended', payload);
     }
-    sendWorkflowStepSuccess(payload) {
-        this.sendWorkflowEvent('hook:step:success', payload);
+    async sendWorkflowStepSuccess(payload) {
+        await this.sendWorkflowEvent('hook:step:success', payload);
     }
-    sendWorkflowStepError(payload) {
-        this.sendWorkflowEvent('hook:step:error', payload);
+    async sendWorkflowStepError(payload) {
+        await this.sendWorkflowEvent('hook:step:error', payload);
     }
 };
 exports.WorkflowService = WorkflowService;
@@ -163,43 +168,43 @@ __decorate([
     (0, event_emitter_1.OnEvent)('hook:workflow:start'),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", void 0)
+    __metadata("design:returntype", Promise)
 ], WorkflowService.prototype, "sendWorkflowStart", null);
 __decorate([
     (0, event_emitter_1.OnEvent)('hook:workflow:finish'),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", void 0)
+    __metadata("design:returntype", Promise)
 ], WorkflowService.prototype, "sendWorkflowFinish", null);
 __decorate([
     (0, event_emitter_1.OnEvent)('hook:workflow:failure'),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", void 0)
+    __metadata("design:returntype", Promise)
 ], WorkflowService.prototype, "sendWorkflowFailure", null);
 __decorate([
     (0, event_emitter_1.OnEvent)('hook:step:start'),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", void 0)
+    __metadata("design:returntype", Promise)
 ], WorkflowService.prototype, "sendWorkflowStepStart", null);
 __decorate([
     (0, event_emitter_1.OnEvent)('hook:step:suspended'),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", void 0)
+    __metadata("design:returntype", Promise)
 ], WorkflowService.prototype, "sendWorkflowStepSuspended", null);
 __decorate([
     (0, event_emitter_1.OnEvent)('hook:step:success'),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", void 0)
+    __metadata("design:returntype", Promise)
 ], WorkflowService.prototype, "sendWorkflowStepSuccess", null);
 __decorate([
     (0, event_emitter_1.OnEvent)('hook:step:error'),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", void 0)
+    __metadata("design:returntype", Promise)
 ], WorkflowService.prototype, "sendWorkflowStepError", null);
 exports.WorkflowService = WorkflowService = __decorate([
     (0, common_1.Injectable)(),

package/dist/workflow/services/workflow.service.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hexabot-ai/api",
   "private": false,
-  "version": "3.2.2-alpha.13",
+  "version": "3.2.2-alpha.15",
   "description": "Hexabot is a solution for creating and managing chatbots across multiple channels, leveraging AI for advanced conversational capabilities. It provides a user-friendly interface for building, training, and deploying chatbots with integrated support for various messaging platforms.",
   "author": "Hexastack",
   "license": "FCL-1.0-ALv2",
@@ -92,8 +92,8 @@
     "typeorm": "^0.3.28",
     "yaml": "^2.8.3",
     "zod": "^4.3.6",
-    "@hexabot-ai/agentic": "3.1.2-alpha.13",
-    "@hexabot-ai/types": "3.0.2-alpha.13"
+    "@hexabot-ai/agentic": "3.1.2-alpha.15",
+    "@hexabot-ai/types": "3.0.2-alpha.15"
   },
   "devDependencies": {
     "@compodoc/compodoc": "^1.1.31",
@@ -144,7 +144,7 @@
     "tsconfig-paths": "^4.2.0",
     "tsconfig-paths-jest": "^0.0.1",
     "typescript": "^5.1.3",
-    "@hexabot-ai/frontend": "3.2.2-alpha.13"
+    "@hexabot-ai/frontend": "3.2.2-alpha.15"
   },
   "optionalDependencies": {
     "@css-inline/css-inline-linux-arm64-musl": "^0.14.1",

package/src/mcp/README.md

@@ -2,7 +2,7 @@
 
 This module exposes Hexabot API capabilities through the Model Context Protocol
 (MCP) so coding agents can inspect and manage workflows, workflow runs, memory
-definitions, actions, credentials, and CMS content.
+definitions, actions, credentials, MCP servers, and CMS content.
 
 The implementation uses `@rekog/mcp-nest` with Streamable HTTP transport.
 Authentication is Hexabot-native: users create personal MCP bearer tokens from
@@ -145,15 +145,24 @@ client, but the effective configuration should be equivalent to:
 | --- | --- | --- |
 | `hexabot_workflow_search` | `workflow:read` | Search workflows by metadata. |
 | `hexabot_workflow_get` | `workflow:read` | Read one workflow with populated version metadata. |
+| `hexabot_workflow_version_status` | `workflow:read` | Check current and published version pointers for one workflow. |
 | `hexabot_workflow_create` | `workflow:create` | Create a workflow and optionally commit initial YAML. |
 | `hexabot_workflow_update` | `workflow:update` | Update workflow metadata and optionally commit YAML. |
+| `hexabot_workflow_yaml_validate` | `workflow:read` | Validate workflow definition YAML without creating a version. |
 | `hexabot_workflow_yaml_commit` | `workflowversion:create` | Validate and commit workflow definition YAML. |
+| `hexabot_workflow_rollback` | `workflowversion:create` | Roll back to a previous version by creating a new restore snapshot. |
 | `hexabot_workflow_publish` | `workflow:update` | Publish the current workflow version. |
 | `hexabot_workflow_unpublish` | `workflow:update` | Clear the published workflow version. |
 | `hexabot_workflow_run` | `workflowrun:create` | Run a manual or scheduled workflow and return the run summary. |
 
 Workflow YAML is validated with `parseWorkflowDefinition()` before a version is
-created.
+created. Coding agents can call `hexabot_workflow_yaml_validate` first to get
+structured validation errors without mutating workflow state. Commits inherit
+the workflow's current version as their parent unless `parentVersion` is
+explicitly supplied. `hexabot_workflow_rollback` and
+`hexabot_workflow_version_restore` both create a new current restore snapshot;
+publish that snapshot with `hexabot_workflow_publish` when it should become the
+published version.
 
 ### Workflow versions and runs
 
@@ -165,6 +174,7 @@ created.
 | `hexabot_workflow_version_restore` | `workflowversion:create` | Restore a previous version by creating a new snapshot. |
 | `hexabot_workflow_run_search` | `workflowrun:read` | Search workflow runs by workflow and status. |
 | `hexabot_workflow_run_get` | `workflowrun:read` | Read one workflow run with populated workflow metadata. |
+| `hexabot_workflow_run_debug` | `workflowrun:read` | Inspect one workflow run with execution state, workflow YAML, and parent/child run context for troubleshooting. |
 
 ### Memory definitions
 
@@ -195,6 +205,15 @@ Credential secret values are never returned. The MCP tools remove the `value`
 field from all credential responses and do not support searching by secret
 value.
 
+### MCP servers
+
+| Tool | Permission | Purpose |
+| --- | --- | --- |
+| `hexabot_mcp_server_search` | `mcpserver:read` | Search configured MCP servers. |
+| `hexabot_mcp_server_get` | `mcpserver:read` | Read one configured MCP server. |
+| `hexabot_mcp_server_create` | `mcpserver:create` | Create an MCP server configuration. |
+| `hexabot_mcp_server_update` | `mcpserver:update` | Update an MCP server configuration. |
+
 ### CMS and RAG content
 
 | Tool | Permission | Purpose |
@@ -211,7 +230,9 @@ value.
 
 ## Extending the MCP module
 
-Add new tools in `tools/hexabot-mcp.tools.ts`.
+Add new tools in the focused provider file under `tools/` that matches the
+domain, or create a new `*-mcp.tools.ts` provider when the domain is new. Export
+and register new providers through `tools/index.ts`.
 
 Each tool should:
 

package/src/mcp/mcp-api.module.ts

@@ -23,7 +23,7 @@ import { HexabotMcpTokenGuard } from './guards/hexabot-mcp-token.guard';
 import { McpPermissionGuard } from './guards/mcp-permission.guard';
 import { McpTokenRepository } from './repositories/mcp-token.repository';
 import { McpTokenService } from './services/mcp-token.service';
-import { HexabotMcpTools } from './tools/hexabot-mcp.tools';
+import { HEXABOT_MCP_TOOL_PROVIDERS } from './tools';
 
 @Module({
   imports: [
@@ -54,7 +54,7 @@ import { HexabotMcpTools } from './tools/hexabot-mcp.tools';
     McpPermissionGuard,
     McpTokenRepository,
     McpTokenService,
-    HexabotMcpTools,
+    ...HEXABOT_MCP_TOOL_PROVIDERS,
   ],
   controllers: [McpTokenController],
 })

package/src/mcp/tools/catalog-mcp.tools.ts

@@ -0,0 +1,122 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2026 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { Action } from '@hexabot-ai/types';
+import { Injectable, NotFoundException } from '@nestjs/common';
+import { Tool, ToolGuards } from '@rekog/mcp-nest';
+import { z } from 'zod';
+
+import { ActionService } from '@/actions/actions.service';
+import { RuntimeBindingsService } from '@/bindings/runtime-bindings.service';
+import { WorkflowType } from '@/workflow/types';
+
+import { McpPermission } from '../decorators/mcp-permission.decorator';
+import { McpPermissionGuard } from '../guards/mcp-permission.guard';
+
+@Injectable()
+export class HexabotCatalogMcpTools {
+  constructor(
+    private readonly actionService: ActionService,
+    private readonly runtimeBindingsService: RuntimeBindingsService,
+  ) {}
+
+  @McpPermission('workflow', Action.READ)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_action_search',
+    description: 'Search available workflow actions and their schemas.',
+    parameters: z.object({
+      query: z.string().optional(),
+      workflowType: z.enum(WorkflowType).optional(),
+    }),
+  })
+  async searchActions(args: { query?: string; workflowType?: WorkflowType }) {
+    const query = args.query?.toLowerCase();
+    const actions = this.actionService.getAllSchemaDefinitions(
+      args.workflowType,
+    );
+
+    return {
+      items: query
+        ? actions.filter((action) =>
+            [
+              action.name,
+              action.description,
+              action.group,
+              ...(action.workflowTypes ?? []),
+            ]
+              .filter(Boolean)
+              .some((value) => `${value}`.toLowerCase().includes(query)),
+          )
+        : actions,
+    };
+  }
+
+  @McpPermission('workflow', Action.READ)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_action_get',
+    description: 'Read schema metadata for one workflow action.',
+    parameters: z.object({
+      name: z.string().min(1),
+    }),
+  })
+  async getAction(args: { name: string }) {
+    const action = this.actionService
+      .getAllSchemaDefinitions()
+      .find((entry) => entry.name === args.name);
+    if (!action) {
+      throw new NotFoundException(`Action ${args.name} not found`);
+    }
+
+    return action;
+  }
+
+  @McpPermission('workflow', Action.READ)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_binding_search',
+    description: 'Search workflow runtime binding kind schemas.',
+    parameters: z.object({
+      query: z.string().optional(),
+    }),
+  })
+  async searchBindings(args: { query?: string }) {
+    const query = args.query?.toLowerCase();
+    const entries = Object.entries(
+      this.runtimeBindingsService.getAllSchemaDefinitions(),
+    ).map(([kind, definition]) => ({ kind, ...definition }));
+
+    return {
+      items: query
+        ? entries.filter((entry) =>
+            [entry.kind, entry.icon, entry.color]
+              .filter(Boolean)
+              .some((value) => `${value}`.toLowerCase().includes(query)),
+          )
+        : entries,
+    };
+  }
+
+  @McpPermission('workflow', Action.READ)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_binding_get',
+    description: 'Read schema metadata for one workflow runtime binding kind.',
+    parameters: z.object({
+      kind: z.string().min(1),
+    }),
+  })
+  async getBinding(args: { kind: string }) {
+    const bindings = this.runtimeBindingsService.getAllSchemaDefinitions();
+    const binding = bindings[args.kind];
+    if (!binding) {
+      throw new NotFoundException(`Binding kind ${args.kind} not found`);
+    }
+
+    return { kind: args.kind, ...binding };
+  }
+}