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

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.14",
+  "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.14",
-    "@hexabot-ai/types": "3.0.2-alpha.14"
+    "@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.14"
+    "@hexabot-ai/frontend": "3.2.2-alpha.15"
   },
   "optionalDependencies": {
     "@css-inline/css-inline-linux-arm64-musl": "^0.14.1",

package/src/mcp/README.md

@@ -145,17 +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. Coding agents can call `hexabot_workflow_yaml_validate` first to get
-structured validation errors without mutating workflow state.
+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
 
@@ -167,6 +174,7 @@ structured validation errors without mutating workflow state.
 | `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
 
@@ -222,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 };
+  }
+}

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

@@ -0,0 +1,239 @@
+/*
+ * 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 { ContentTypeOrmEntity } from '@/cms/entities/content-type.entity';
+import { ContentOrmEntity } from '@/cms/entities/content.entity';
+import { ContentTypeService } from '@/cms/services/content-type.service';
+import { ContentService } from '@/cms/services/content.service';
+
+import { McpPermission } from '../decorators/mcp-permission.decorator';
+import { McpPermissionGuard } from '../guards/mcp-permission.guard';
+
+import { HexabotMcpToolBase } from './hexabot-mcp-tool.base';
+import {
+  jsonObjectSchema,
+  PaginationArgs,
+  paginationSchema,
+  uuidSchema,
+} from './hexabot-mcp.schemas';
+
+@Injectable()
+export class HexabotCmsMcpTools extends HexabotMcpToolBase {
+  constructor(
+    private readonly contentTypeService: ContentTypeService,
+    private readonly contentService: ContentService,
+  ) {
+    super();
+  }
+
+  @McpPermission('contenttype', Action.READ)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_content_type_search',
+    description: 'Search CMS content types.',
+    parameters: z.object({
+      query: z.string().optional(),
+      ...paginationSchema,
+    }),
+  })
+  async searchContentTypes(args: { query?: string } & PaginationArgs) {
+    const where = args.query ? { name: this.contains(args.query) } : {};
+
+    return await this.listWithCount(
+      this.contentTypeService,
+      this.findOptions<ContentTypeOrmEntity>(args, where),
+    );
+  }
+
+  @McpPermission('contenttype', Action.READ)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_content_type_get',
+    description: 'Read one CMS content type.',
+    parameters: z.object({
+      id: uuidSchema,
+    }),
+  })
+  async getContentType(args: { id: string }) {
+    const contentType = await this.contentTypeService.findOne(args.id);
+    if (!contentType) {
+      throw new NotFoundException(`Content type ${args.id} not found`);
+    }
+
+    return contentType;
+  }
+
+  @McpPermission('contenttype', Action.CREATE)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_content_type_create',
+    description: 'Create a CMS content type.',
+    parameters: z.object({
+      name: z.string().min(1),
+      schema: jsonObjectSchema,
+    }),
+  })
+  async createContentType(args: {
+    name: string;
+    schema: Record<string, unknown>;
+  }) {
+    return await this.contentTypeService.create(args as any);
+  }
+
+  @McpPermission('contenttype', Action.UPDATE)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_content_type_update',
+    description: 'Update a CMS content type.',
+    parameters: z.object({
+      id: uuidSchema,
+      name: z.string().min(1).optional(),
+      schema: jsonObjectSchema.optional(),
+    }),
+  })
+  async updateContentType(args: { id: string } & Record<string, unknown>) {
+    const { id, ...updates } = args;
+
+    return await this.contentTypeService.updateOne(id, updates as any);
+  }
+
+  @McpPermission('content', Action.READ)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_content_search',
+    description: 'Search CMS content records.',
+    parameters: z.object({
+      query: z.string().optional(),
+      contentTypeId: uuidSchema.optional(),
+      status: z.boolean().optional(),
+      ...paginationSchema,
+    }),
+  })
+  async searchContent(
+    args: {
+      query?: string;
+      contentTypeId?: string;
+      status?: boolean;
+    } & PaginationArgs,
+  ) {
+    if (args.query) {
+      return {
+        items: await this.contentService.textSearch(args.query, {
+          status: args.status,
+          contentTypeId: args.contentTypeId,
+          limit: args.limit,
+        }),
+        limit: args.limit,
+        skip: 0,
+      };
+    }
+
+    const where = {
+      ...(args.contentTypeId
+        ? { contentType: { id: args.contentTypeId } }
+        : {}),
+      ...(args.status !== undefined ? { status: args.status } : {}),
+    } as any;
+
+    return await this.listWithCount(
+      this.contentService,
+      this.findOptions<ContentOrmEntity>(args, where),
+    );
+  }
+
+  @McpPermission('content', Action.READ)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_content_get',
+    description: 'Read one CMS content record.',
+    parameters: z.object({
+      id: uuidSchema,
+    }),
+  })
+  async getContent(args: { id: string }) {
+    const content = await this.contentService.findOneAndPopulate(args.id);
+    if (!content) {
+      throw new NotFoundException(`Content ${args.id} not found`);
+    }
+
+    return content;
+  }
+
+  @McpPermission('content', Action.CREATE)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_content_create',
+    description: 'Create a CMS content record.',
+    parameters: z.object({
+      contentType: uuidSchema,
+      title: z.string().min(1),
+      status: z.boolean().optional(),
+      properties: jsonObjectSchema.optional(),
+    }),
+  })
+  async createContent(args: {
+    contentType: string;
+    title: string;
+    status?: boolean;
+    properties?: Record<string, unknown>;
+  }) {
+    return await this.contentService.create(args as any);
+  }
+
+  @McpPermission('content', Action.UPDATE)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_content_update',
+    description: 'Update a CMS content record.',
+    parameters: z.object({
+      id: uuidSchema,
+      contentType: uuidSchema.optional(),
+      title: z.string().min(1).optional(),
+      status: z.boolean().optional(),
+      properties: jsonObjectSchema.optional(),
+    }),
+  })
+  async updateContent(args: { id: string } & Record<string, unknown>) {
+    const { id, ...updates } = args;
+
+    return await this.contentService.updateOne(id, updates as any);
+  }
+
+  @McpPermission('content', Action.READ)
+  @ToolGuards([McpPermissionGuard])
+  @Tool({
+    name: 'hexabot_rag_content_search',
+    description: 'Search indexed CMS content through Hexabot RAG retrieval.',
+    parameters: z.object({
+      query: z.string().min(1),
+      mode: z.enum(['embedding', 'lexical']).optional(),
+      limit: z.number().int().min(1).max(50).default(10),
+      contentTypeId: uuidSchema.optional(),
+      includeInactive: z.boolean().optional(),
+    }),
+  })
+  async searchRagContent(args: {
+    query: string;
+    mode?: 'embedding' | 'lexical';
+    limit: number;
+    contentTypeId?: string;
+    includeInactive?: boolean;
+  }) {
+    return {
+      items: await this.contentService.retrieve(args.query, {
+        mode: args.mode,
+        limit: args.limit,
+        contentTypeId: args.contentTypeId,
+        includeInactive: args.includeInactive,
+      }),
+    };
+  }
+}