@hexabot-ai/api 3.2.2-alpha.10 → 3.2.2-alpha.11

package/dist/workflow/types.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkflowVersionAction = exports.WorkflowType = exports.MemoryScope = exports.McpServerTransport = exports.DirectionType = void 0;
+exports.WORKFLOW_CALL_SERVICE = exports.WorkflowVersionAction = exports.WorkflowType = exports.MemoryScope = exports.McpServerTransport = exports.DirectionType = void 0;
 const types_1 = require("@hexabot-ai/types");
 Object.defineProperty(exports, "DirectionType", { enumerable: true, get: function () { return types_1.DirectionType; } });
 Object.defineProperty(exports, "McpServerTransport", { enumerable: true, get: function () { return types_1.McpServerTransport; } });
 Object.defineProperty(exports, "MemoryScope", { enumerable: true, get: function () { return types_1.MemoryScope; } });
 Object.defineProperty(exports, "WorkflowType", { enumerable: true, get: function () { return types_1.WorkflowType; } });
 Object.defineProperty(exports, "WorkflowVersionAction", { enumerable: true, get: function () { return types_1.WorkflowVersionAction; } });
+exports.WORKFLOW_CALL_SERVICE = Symbol('WORKFLOW_CALL_SERVICE');
 //# sourceMappingURL=types.js.map

package/dist/workflow/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflow/types.ts"],"names":[],"mappings":";;;AAYA,6CAS2B;AAMzB,8FAdA,qBAAa,OAcA;AACb,mGAdA,0BAAkB,OAcA;AAClB,4FAdA,mBAAW,OAcA;AACX,6FAdA,oBAAY,OAcA;AACZ,sGAdA,6BAAqB,OAcA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflow/types.ts"],"names":[],"mappings":";;;AAYA,6CAS2B;AAOzB,8FAfA,qBAAa,OAeA;AACb,mGAfA,0BAAkB,OAeA;AAClB,4FAfA,mBAAW,OAeA;AACX,6FAfA,oBAAY,OAeA;AACZ,sGAfA,6BAAqB,OAeA;AAkDV,QAAA,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC"}

package/dist/workflow/workflow.module.js

@@ -47,6 +47,7 @@ const workflow_run_service_1 = require("./services/workflow-run.service");
 const workflow_scheduler_service_1 = require("./services/workflow-scheduler.service");
 const workflow_version_service_1 = require("./services/workflow-version.service");
 const workflow_service_1 = require("./services/workflow.service");
+const types_1 = require("./types");
 let WorkflowModule = class WorkflowModule {
 };
 exports.WorkflowModule = WorkflowModule;
@@ -97,6 +98,7 @@ exports.WorkflowModule = WorkflowModule = __decorate([
             scheduled_workflow_context_1.ScheduledWorkflowContext,
             workflow_context_factory_1.WorkflowContextFactory,
             agentic_service_1.AgenticService,
+            { provide: types_1.WORKFLOW_CALL_SERVICE, useExisting: agentic_service_1.AgenticService },
         ],
         exports: [
             workflow_repository_1.WorkflowRepository,
@@ -115,6 +117,7 @@ exports.WorkflowModule = WorkflowModule = __decorate([
             mcp_client_pool_service_1.McpClientPoolService,
             conversational_workflow_context_1.ConversationalWorkflowContext,
             agentic_service_1.AgenticService,
+            types_1.WORKFLOW_CALL_SERVICE,
         ],
     })
 ], WorkflowModule);

package/dist/workflow/workflow.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.module.js","sourceRoot":"","sources":["../../src/workflow/workflow.module.ts"],"names":[],"mappings":";;;;;;;;;AAMA,2CAAoD;AACpD,+CAAqD;AACrD,6CAAgD;AAEhD,qDAAgD;AAChD,kEAAgE;AAChE,kDAA6C;AAC7C,qDAAgD;AAEhD,gGAA2F;AAC3F,gFAA2E;AAC3E,sFAAiF;AACjF,kFAA6E;AAC7E,+EAA0E;AAC1E,6FAAwF;AACxF,mFAA8E;AAC9E,2FAAsF;AACtF,2EAAuE;AACvE,oEAAkE;AAClE,kFAAgF;AAChF,0EAAwE;AACxE,wEAAsE;AACtE,gFAA8E;AAC9E,gEAA+D;AAC/D,gFAA2E;AAC3E,8FAAyF;AACzF,sFAAiF;AACjF,oFAA+E;AAC/E,4FAAuF;AACvF,4EAAwE;AACxE,2EAAwE;AACxE,yDAAuD;AACvD,gEAA4D;AAC5D,gFAA0E;AAC1E,sEAAiE;AACjE,oFAA+E;AAC/E,4EAAuE;AACvE,8DAA0D;AAC1D,0EAAqE;AACrE,sFAAiF;AACjF,kFAA6E;AAC7E,kEAA8D;AAoEvD,IAAM,cAAc,GAApB,MAAM,cAAc;CAAG,CAAA;AAAjB,wCAAc;yBAAd,cAAc;IAlE1B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,uBAAa,CAAC,UAAU,CAAC;gBACvB,mCAAiB;gBACjB,kDAAwB;gBACxB,0CAAoB;gBACpB,oDAAyB;gBACzB,4CAAqB;gBACrB,sCAAkB;gBAClB,+BAAe;aAChB,CAAC;YACF,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,sBAAS,CAAC;YAC3B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,wBAAU,CAAC;YAC5B,wBAAU;SACX;QACD,WAAW,EAAE;YACX,wCAAkB;YAClB,uDAAyB;YACzB,+CAAqB;YACrB,yDAA0B;YAC1B,2CAAmB;SACpB;QACD,SAAS,EAAE;YACT,wCAAkB;YAClB,uDAAyB;YACzB,+CAAqB;YACrB,yDAA0B;YAC1B,iDAAsB;YACtB,2CAAmB;YACnB,+CAAsB;YACtB,8BAAc;YACd,kCAAe;YACf,iDAAsB;YACtB,yCAAkB;YAClB,mDAAuB;YACvB,2CAAmB;YACnB,8BAAa;YACb,qCAAgB;YAChB,8CAAoB;YACpB,4BAAiB;YACjB,qDAAwB;YACxB,+DAA6B;YAC7B,+CAAqB;YACrB,qDAAwB;YACxB,iDAAsB;YACtB,gCAAc;SACf;QACD,OAAO,EAAE;YACP,wCAAkB;YAClB,uDAAyB;YACzB,+CAAqB;YACrB,yDAA0B;YAC1B,iDAAsB;YACtB,2CAAmB;YACnB,kCAAe;YACf,iDAAsB;YACtB,yCAAkB;YAClB,mDAAuB;YACvB,2CAAmB;YACnB,8BAAa;YACb,qCAAgB;YAChB,8CAAoB;YACpB,+DAA6B;YAC7B,gCAAc;SACf;KACF,CAAC;GACW,cAAc,CAAG"}
+{"version":3,"file":"workflow.module.js","sourceRoot":"","sources":["../../src/workflow/workflow.module.ts"],"names":[],"mappings":";;;;;;;;;AAMA,2CAAoD;AACpD,+CAAqD;AACrD,6CAAgD;AAEhD,qDAAgD;AAChD,kEAAgE;AAChE,kDAA6C;AAC7C,qDAAgD;AAEhD,gGAA2F;AAC3F,gFAA2E;AAC3E,sFAAiF;AACjF,kFAA6E;AAC7E,+EAA0E;AAC1E,6FAAwF;AACxF,mFAA8E;AAC9E,2FAAsF;AACtF,2EAAuE;AACvE,oEAAkE;AAClE,kFAAgF;AAChF,0EAAwE;AACxE,wEAAsE;AACtE,gFAA8E;AAC9E,gEAA+D;AAC/D,gFAA2E;AAC3E,8FAAyF;AACzF,sFAAiF;AACjF,oFAA+E;AAC/E,4FAAuF;AACvF,4EAAwE;AACxE,2EAAwE;AACxE,yDAAuD;AACvD,gEAA4D;AAC5D,gFAA0E;AAC1E,sEAAiE;AACjE,oFAA+E;AAC/E,4EAAuE;AACvE,8DAA0D;AAC1D,0EAAqE;AACrE,sFAAiF;AACjF,kFAA6E;AAC7E,kEAA8D;AAC9D,mCAAgD;AAsEzC,IAAM,cAAc,GAApB,MAAM,cAAc;CAAG,CAAA;AAAjB,wCAAc;yBAAd,cAAc;IApE1B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,uBAAa,CAAC,UAAU,CAAC;gBACvB,mCAAiB;gBACjB,kDAAwB;gBACxB,0CAAoB;gBACpB,oDAAyB;gBACzB,4CAAqB;gBACrB,sCAAkB;gBAClB,+BAAe;aAChB,CAAC;YACF,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,sBAAS,CAAC;YAC3B,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,wBAAU,CAAC;YAC5B,wBAAU;SACX;QACD,WAAW,EAAE;YACX,wCAAkB;YAClB,uDAAyB;YACzB,+CAAqB;YACrB,yDAA0B;YAC1B,2CAAmB;SACpB;QACD,SAAS,EAAE;YACT,wCAAkB;YAClB,uDAAyB;YACzB,+CAAqB;YACrB,yDAA0B;YAC1B,iDAAsB;YACtB,2CAAmB;YACnB,+CAAsB;YACtB,8BAAc;YACd,kCAAe;YACf,iDAAsB;YACtB,yCAAkB;YAClB,mDAAuB;YACvB,2CAAmB;YACnB,8BAAa;YACb,qCAAgB;YAChB,8CAAoB;YACpB,4BAAiB;YACjB,qDAAwB;YACxB,+DAA6B;YAC7B,+CAAqB;YACrB,qDAAwB;YACxB,iDAAsB;YACtB,gCAAc;YACd,EAAE,OAAO,EAAE,6BAAqB,EAAE,WAAW,EAAE,gCAAc,EAAE;SAChE;QACD,OAAO,EAAE;YACP,wCAAkB;YAClB,uDAAyB;YACzB,+CAAqB;YACrB,yDAA0B;YAC1B,iDAAsB;YACtB,2CAAmB;YACnB,kCAAe;YACf,iDAAsB;YACtB,yCAAkB;YAClB,mDAAuB;YACvB,2CAAmB;YACnB,8BAAa;YACb,qCAAgB;YAChB,8CAAoB;YACpB,+DAA6B;YAC7B,gCAAc;YACd,6BAAqB;SACtB;KACF,CAAC;GACW,cAAc,CAAG"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hexabot-ai/api",
   "private": false,
-  "version": "3.2.2-alpha.10",
+  "version": "3.2.2-alpha.11",
   "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.10",
-    "@hexabot-ai/types": "3.0.2-alpha.10"
+    "@hexabot-ai/agentic": "3.1.2-alpha.11",
+    "@hexabot-ai/types": "3.0.2-alpha.11"
   },
   "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.10"
+    "@hexabot-ai/frontend": "3.2.2-alpha.11"
   },
   "optionalDependencies": {
     "@css-inline/css-inline-linux-arm64-musl": "^0.14.1",

package/src/actions/actions.service.ts

@@ -66,6 +66,12 @@ export class ActionService {
       const name = action.getName();
       const localizationOptions =
         this.i18nService.getJsonSchemaLocalizationOptions(name, lang);
+      const inputSchema = toDraft07JsonSchema(
+        action.inputSchema,
+        localizationOptions,
+      );
+
+      this.applyActionSchemaContext(inputSchema, name, workflowType);
 
       return {
         name,
@@ -75,10 +81,7 @@ export class ActionService {
         group: action.group,
         workflowTypes: action.workflowTypes,
         supportedBindings: action.supportedBindings ?? [],
-        inputSchema: toDraft07JsonSchema(
-          action.inputSchema,
-          localizationOptions,
-        ),
+        inputSchema,
         outputSchema: toDraft07JsonSchema(
           action.outputSchema,
           localizationOptions,
@@ -91,6 +94,33 @@ export class ActionService {
     });
   }
 
+  private applyActionSchemaContext(
+    inputSchema: Record<string, any>,
+    actionName: string,
+    workflowType?: WorkflowType,
+  ): void {
+    if (actionName !== 'call_workflow' || !workflowType) {
+      return;
+    }
+
+    const workflowIdSchema = inputSchema.properties?.workflow_id;
+    if (!workflowIdSchema || typeof workflowIdSchema !== 'object') {
+      return;
+    }
+
+    // The same call_workflow action is available to every workflow type, but a
+    // specific workflow can only call another workflow with the same trigger
+    // type. The catalog endpoint has the active type, so it can scope the UI
+    // picker before the action is saved.
+    workflowIdSchema['ui:options'] = {
+      ...(workflowIdSchema['ui:options'] ?? {}),
+      where: {
+        ...(workflowIdSchema['ui:options']?.where ?? {}),
+        type: workflowType,
+      },
+    };
+  }
+
   getRegistry(): Record<
     ActionName,
     BaseAction<any, any, BaseWorkflowContext, any>

package/src/app.module.ts

@@ -46,6 +46,7 @@ import { LoggerModule } from './logger/logger.module';
 import { MailerModule } from './mailer/mailer.module';
 import { MigrationModule } from './migration/migration.module';
 import { SettingModule } from './setting/setting.module';
+import { WorkflowTransferModule } from './transfer/workflow-transfer.module';
 import { Ability } from './user/guards/ability.guard';
 import { UserModule } from './user/user.module';
 import { WebsocketModule } from './websocket/websocket.module';
@@ -115,6 +116,7 @@ export const HEXABOT_MODULE_IMPORTS: ModuleImports = [
   ActionsModule,
   BindingsModule,
   WorkflowModule,
+  WorkflowTransferModule,
   HelperModule,
   LoggerModule,
   WebsocketModule,

package/src/extensions/actions/ai/mcp.binding.ts

@@ -8,6 +8,7 @@ import { BindingKindDescriptor } from '@hexabot-ai/agentic';
 import z from 'zod';
 
 import { createBindingKind } from '@/bindings/create-binding-kind';
+import { workflowResourceRef } from '@/workflow/resource-refs';
 
 export const aiMcpToolBindingSchema = z.strictObject({
   server_id: z.uuid().meta({
@@ -20,6 +21,7 @@ export const aiMcpToolBindingSchema = z.strictObject({
       labelKey: 'name',
       enableEntityAddButton: true,
     },
+    ...workflowResourceRef('mcpServer'),
   }),
   tool_names: z
     .array(z.string().trim().min(1))

package/src/extensions/actions/ai/memory.binding.ts

@@ -8,6 +8,7 @@ import { BindingKindDescriptor } from '@hexabot-ai/agentic';
 import z from 'zod';
 
 import { createBindingKind } from '@/bindings/create-binding-kind';
+import { workflowResourceRef } from '@/workflow/resource-refs';
 
 export const aiMemoryBindingSchema = z.strictObject({
   definition_id: z.uuid().meta({
@@ -21,6 +22,7 @@ export const aiMemoryBindingSchema = z.strictObject({
       labelKey: 'name',
       enableEntityAddButton: true,
     },
+    ...workflowResourceRef('memoryDefinition'),
   }),
 });
 

package/src/extensions/actions/ai/retrieve-content-rag.action.ts

@@ -9,6 +9,7 @@ import { z } from 'zod';
 import { createAction } from '@/actions/create-action';
 import { RagMode, RagQueryOptions } from '@/cms';
 import { WorkflowRuntimeContext } from '@/workflow/contexts/workflow-runtime.context';
+import { workflowResourceRef } from '@/workflow/resource-refs';
 
 const contentRagModeSchema = z.enum(['embedding', 'lexical']);
 const retrieveRagContentInputSchema = z.strictObject({
@@ -38,6 +39,7 @@ const retrieveRagContentSettingsSchema = z.strictObject({
         valueKey: 'id',
         labelKey: 'name',
       },
+      ...workflowResourceRef('contentType'),
     }),
   include_inactive: z.boolean().default(false).meta({
     title: 'Include inactive',

package/src/extensions/actions/messaging/list.action.ts

@@ -17,6 +17,7 @@ import { ExecArgs } from '@/actions';
 import { ActionService } from '@/actions/actions.service';
 import { ContentTypeService } from '@/cms/services/content-type.service';
 import { ConversationalWorkflowContext } from '@/workflow/contexts/conversational-workflow.context';
+import { workflowResourceRef } from '@/workflow/resource-refs';
 
 import {
   MessageAction,
@@ -31,6 +32,12 @@ const listActionInputSchema = z
   .extend({
     content: contentOptionsSchema
       .omit({ limit: true })
+      .extend({
+        contentType: contentOptionsSchema.shape.contentType.meta({
+          ...contentOptionsSchema.shape.contentType.meta(),
+          ...workflowResourceRef('contentType'),
+        }),
+      })
       .default({
         display: 'list',
         buttons: [

package/src/extensions/actions/subscriber/update-labels.action.ts

@@ -8,6 +8,7 @@ import { z } from 'zod';
 
 import { createAction } from '@/actions/create-action';
 import { ConversationalWorkflowContext } from '@/workflow/contexts/conversational-workflow.context';
+import { workflowResourceRef } from '@/workflow/resource-refs';
 import { WorkflowType } from '@/workflow/types';
 
 const subscriberUpdateLabelsInputSchema = z
@@ -24,6 +25,7 @@ const subscriberUpdateLabelsInputSchema = z
           valueKey: 'id',
           labelKey: 'title',
         },
+        ...workflowResourceRef('label'),
       }),
     labels_to_remove: z
       .array(z.uuid())
@@ -37,6 +39,7 @@ const subscriberUpdateLabelsInputSchema = z
           valueKey: 'id',
           labelKey: 'title',
         },
+        ...workflowResourceRef('label'),
       }),
   })
   .superRefine((input, ctx) => {

package/src/extensions/actions/workflow/call-workflow.action.ts

@@ -0,0 +1,112 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { JsonValueSchema } from '@hexabot-ai/agentic';
+import { z } from 'zod';
+
+import { createAction } from '@/actions/create-action';
+import { WorkflowRuntimeContext } from '@/workflow/contexts/workflow-runtime.context';
+import { workflowResourceRef } from '@/workflow/resource-refs';
+import { CallWorkflowResult } from '@/workflow/types';
+
+const callWorkflowInputSchema = z.object({
+  workflow_id: z.uuid().meta({
+    title: 'Workflow',
+    description: 'Workflow to call and wait for before continuing.',
+    'ui:widget': 'AutoCompleteWidget',
+    'ui:options': {
+      entity: 'Workflow',
+      valueKey: 'id',
+      labelKey: 'name',
+    },
+    ...workflowResourceRef('workflow'),
+  }),
+  input: z.record(z.string(), JsonValueSchema).optional().meta({
+    title: 'Input',
+    description:
+      'Optional input payload for the called workflow. When omitted, the current trigger input is reused.',
+  }),
+});
+const callWorkflowFinishedSchema = z.object({
+  status: z.literal('finished'),
+  workflow_id: z.uuid(),
+  workflow_run_id: z.uuid(),
+  output: z.record(z.string(), z.any()),
+});
+const callWorkflowResumeSchema = z.union([
+  callWorkflowFinishedSchema,
+  z.object({
+    status: z.literal('suspended'),
+    workflow_id: z.uuid(),
+    workflow_run_id: z.uuid(),
+  }),
+  z.object({
+    status: z.literal('failed'),
+    workflow_id: z.uuid(),
+    workflow_run_id: z.uuid(),
+    error: z.string(),
+  }),
+]);
+
+type CallWorkflowInput = z.infer<typeof callWorkflowInputSchema>;
+type CallWorkflowOutput = z.infer<typeof callWorkflowFinishedSchema>;
+
+const assertFinishedResult = (result: CallWorkflowResult) => {
+  if (result.status === 'finished') {
+    return result;
+  }
+
+  if (result.status === 'failed') {
+    throw new Error(result.error);
+  }
+
+  throw new Error(
+    `Workflow ${result.workflow_id} suspended but did not return a final result`,
+  );
+};
+
+export const CallWorkflowAction = createAction<
+  CallWorkflowInput,
+  CallWorkflowOutput,
+  WorkflowRuntimeContext
+>({
+  name: 'call_workflow',
+  description: 'Calls another workflow and waits for its output.',
+  group: 'workflow',
+  icon: 'Workflow',
+  color: '#64748B',
+  inputSchema: callWorkflowInputSchema,
+  outputSchema: callWorkflowFinishedSchema,
+  async execute({ input, context }) {
+    // AgenticService owns workflow resolution and run creation because the
+    // target workflow is an API-persisted entity, not an agentic DSL primitive.
+    const result = await context.services.agentic.callWorkflow({
+      workflowId: input.workflow_id,
+      input: input.input,
+      parentContext: context,
+    });
+
+    if (result.status !== 'suspended') {
+      return assertFinishedResult(result);
+    }
+
+    // If the child suspends, this action suspends the parent at the call site.
+    // A future event resumes the child leaf first; AgenticService then resumes
+    // this parent action with the final child payload.
+    const resumeData = await context.workflow.suspend<unknown>({
+      reason: 'awaiting_child_workflow',
+      data: {
+        workflow_id: result.workflow_id,
+        workflow_run_id: result.workflow_run_id,
+      },
+    });
+    const parsed = callWorkflowResumeSchema.parse(resumeData);
+
+    return assertFinishedResult(parsed);
+  },
+});
+
+export default CallWorkflowAction;

package/src/extensions/actions/workflow/i18n/en.translations.json

@@ -0,0 +1,9 @@
+{
+  "call_workflow": {
+    "Calls another workflow and waits for its output.": "Calls another workflow and waits for its output.",
+    "Workflow": "Workflow",
+    "Workflow to call and wait for before continuing.": "Workflow to call and wait for before continuing.",
+    "Input": "Input",
+    "Optional input payload for the called workflow. When omitted, the current trigger input is reused.": "Optional input payload for the called workflow. When omitted, the current trigger input is reused."
+  }
+}

package/src/extensions/actions/workflow/i18n/fr.translations.json

@@ -0,0 +1,9 @@
+{
+  "call_workflow": {
+    "Calls another workflow and waits for its output.": "Appelle un autre workflow et attend sa sortie.",
+    "Workflow": "Workflow",
+    "Workflow to call and wait for before continuing.": "Workflow à appeler et à attendre avant de continuer.",
+    "Input": "Entrée",
+    "Optional input payload for the called workflow. When omitted, the current trigger input is reused.": "Payload d'entrée facultatif pour le workflow appelé. S'il est omis, l'entrée du déclencheur courant est réutilisée."
+  }
+}

package/src/extensions/index.ts

@@ -43,3 +43,5 @@ export * from './actions/messaging/attachment.action';
 export * from './actions/messaging/list.action';
 
 export * from './actions/web/send-mail.action';
+
+export * from './actions/workflow/call-workflow.action';

package/src/index.ts

@@ -58,6 +58,8 @@ export * from './migration';
 
 export * from './setting';
 
+export * from './transfer';
+
 export * from './user';
 
 export * from './websocket';

package/src/transfer/adapters/content-type-transfer.adapter.ts

@@ -0,0 +1,154 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2026 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { isDeepStrictEqual } from 'node:util';
+
+import {
+  type WorkflowExportBundle,
+  type WorkflowExportBundleContentType,
+  type WorkflowImportResourceResult,
+} from '@hexabot-ai/types';
+import { ConflictException, Injectable } from '@nestjs/common';
+import { In } from 'typeorm';
+
+import { ContentTypeOrmEntity } from '@/cms/entities/content-type.entity';
+import { ContentTypeService } from '@/cms/services/content-type.service';
+
+import {
+  WorkflowTransferAdapter,
+  WorkflowTransferExportContext,
+  WorkflowTransferImportContext,
+  WorkflowTransferResourceAdapter,
+} from '../workflow-transfer-resource-adapter';
+import {
+  assertFoundAll,
+  buildPostCreateEvent,
+  buildResourceResult,
+  uniqueResourceIds,
+  type WorkflowTransferImportAdapterResult,
+} from '../workflow-transfer.types';
+
+@WorkflowTransferAdapter()
+@Injectable()
+export class ContentTypeTransferAdapter extends WorkflowTransferResourceAdapter {
+  override readonly kind = 'contentType';
+
+  override readonly resourceKeys = ['contentTypes'];
+
+  constructor(private readonly contentTypeService: ContentTypeService) {
+    super();
+  }
+
+  override async buildExportResources(
+    ctx: WorkflowTransferExportContext,
+  ): Promise<Record<string, WorkflowExportBundleContentType[]>> {
+    return {
+      contentTypes: await this.buildContentTypeExportResources(
+        ctx.getRefs(this.kind),
+      ),
+    };
+  }
+
+  private async buildContentTypeExportResources(
+    ids: string[],
+  ): Promise<WorkflowExportBundleContentType[]> {
+    const uniqueIds = uniqueResourceIds(ids);
+    if (uniqueIds.length === 0) {
+      return [];
+    }
+
+    const contentTypes = await this.contentTypeService.find({
+      where: { id: In(uniqueIds) },
+    });
+    assertFoundAll(
+      'content type',
+      uniqueIds,
+      contentTypes.map((contentType) => contentType.id),
+    );
+
+    return contentTypes.map((contentType) => ({
+      exportId: contentType.id,
+      name: contentType.name,
+      schema: contentType.schema,
+    }));
+  }
+
+  override async importResources(
+    ctx: WorkflowTransferImportContext,
+  ): Promise<WorkflowTransferImportAdapterResult> {
+    const contentTypes =
+      ctx.getResources<
+        WorkflowExportBundle['resources']['contentTypes'][number]
+      >('contentTypes');
+    const idMap: Record<string, string> = {};
+    const resources: WorkflowImportResourceResult[] = [];
+    const postCreateEvents: WorkflowTransferImportAdapterResult['postCreateEvents'] =
+      [];
+
+    for (const contentType of contentTypes) {
+      const existing = await ctx.manager.findOne(ContentTypeOrmEntity, {
+        where: { name: contentType.name },
+      });
+
+      if (existing) {
+        if (!this.isEquivalentContentType(existing, contentType)) {
+          throw new ConflictException(
+            `Content type "${contentType.name}" already exists with different configuration`,
+          );
+        }
+
+        idMap[contentType.exportId] = existing.id;
+        resources.push(
+          buildResourceResult({
+            kind: 'contentType',
+            exportId: contentType.exportId,
+            localId: existing.id,
+            name: contentType.name,
+            action: 'reused',
+          }),
+        );
+        continue;
+      }
+
+      const payload = {
+        name: contentType.name,
+        schema: contentType.schema,
+      };
+      const created = await ctx.manager.save(
+        ContentTypeOrmEntity,
+        ctx.manager.create(ContentTypeOrmEntity, payload),
+      );
+
+      idMap[contentType.exportId] = created.id;
+      resources.push(
+        buildResourceResult({
+          kind: 'contentType',
+          exportId: contentType.exportId,
+          localId: created.id,
+          name: contentType.name,
+          action: 'created',
+        }),
+      );
+      postCreateEvents.push(
+        buildPostCreateEvent('contentType', created, payload),
+      );
+    }
+
+    return {
+      idMap,
+      resources,
+      warnings: [],
+      postCreateEvents,
+    };
+  }
+
+  private isEquivalentContentType(
+    existing: ContentTypeOrmEntity,
+    imported: WorkflowExportBundle['resources']['contentTypes'][number],
+  ): boolean {
+    return isDeepStrictEqual(existing.schema, imported.schema);
+  }
+}