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

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/channels/web/base-web-channel.ts

@@ -4,6 +4,8 @@
  * Full terms: see LICENSE.md.
  */
 
+import { randomUUID } from 'crypto';
+
 import type {
   Attachment,
   Source,
@@ -25,7 +27,6 @@ import {
 import { OnEvent } from '@nestjs/event-emitter';
 import { Request, Response } from 'express';
 import { Socket } from 'socket.io';
-import { v4 as uuidv4 } from 'uuid';
 import type { z } from 'zod';
 
 import { AttachmentOrmEntity } from '@/attachment/entities/attachment.entity';
@@ -37,16 +38,16 @@ import {
 import {
   ChannelCapabilities,
   DEFAULT_CHANNEL_CAPABILITIES,
-  ExtensionInject,
-  WebSocketChannelHandler,
-} from '@/channel';
+} from '@/channel/lib/channel-capabilities';
+import { ExtensionInject } from '@/channel/lib/extension-inject.decorator';
 import { MessageInboundEvent } from '@/channel/lib/inbound-events';
+import { WebSocketChannelHandler } from '@/channel/lib/transports/websocket-channel-handler';
 import { SourceService } from '@/channel/services/source.service';
 import { ChannelName } from '@/channel/types';
-import { SubscriberChannelData } from '@/chat';
 import { MessageCreateDto } from '@/chat/dto/message.dto';
 import { SubscriberCreateDto } from '@/chat/dto/subscriber.dto';
 import { MessageService } from '@/chat/services/message.service';
+import type { SubscriberChannelData } from '@/chat/types/channel';
 import { MenuService } from '@/cms/services/menu.service';
 import { config } from '@/config';
 import { SocketRequest } from '@/websocket/utils/socket-request';
@@ -73,6 +74,10 @@ import { WebSessionService } from './services/web-session.service';
 import { WEB_CHANNEL_NAME } from './settings.schema';
 import { Web } from './types';
 
+type WebSocketData = Socket['data'] & {
+  webMessageQueue?: Promise<void>;
+};
+
 /**
  * Base handler for the Socket.IO-backed "web" channel.
  *
@@ -125,7 +130,7 @@ export default abstract class BaseWebChannelHandler<N extends ChannelName>
   }
 
   generateId(): string {
-    return `${this.name}-${uuidv4()}`;
+    return `${this.name}-${randomUUID()}`;
   }
 
   getChannelAttributes(
@@ -160,6 +165,30 @@ export default abstract class BaseWebChannelHandler<N extends ChannelName>
     return normalizedSourceId.length > 0 ? normalizedSourceId : null;
   }
 
+  private enqueueMessageDispatch(
+    req: SocketRequest,
+    event: MessageInboundEvent,
+  ): void {
+    const socket = req.socket as Socket & { data?: WebSocketData };
+    const socketData = (socket.data ??= {});
+    // Keep chatbot processing ordered per socket without making the client ack
+    // wait for slow actions, LLM calls, or external integrations.
+    const previous = socketData.webMessageQueue ?? Promise.resolve();
+    const next = previous
+      .catch(() => undefined)
+      .then(() => this.channelEventBus.emitMessage(event))
+      .catch((err) => {
+        this.logger.error('Failed to process web socket message', err);
+      });
+
+    socketData.webMessageQueue = next;
+    void next.finally(() => {
+      if (socketData.webMessageQueue === next) {
+        delete socketData.webMessageQueue;
+      }
+    });
+  }
+
   @OnEvent('hook:websocket:connection', { async: true })
   async onWebSocketConnection(client: Socket) {
     try {
@@ -546,15 +575,24 @@ export default abstract class BaseWebChannelHandler<N extends ChannelName>
           messageEvent.setAuthorForeignId(profile.foreignId);
         }
         messageEvent.setCreatedAt(new Date());
+        // Resolve the thread before acknowledging the socket request so the
+        // client receives a stable thread_id, then dispatch chatbot work later.
+        const thread = await this.sessionService.resolveThreadForIncoming(
+          req,
+          profile.id,
+          {
+            explicitThreadId: messageEvent.getThreadId(),
+            inactivityHours: this.sessionService.resolveInactivityHours(
+              source.settings,
+            ),
+            sourceId: source.id,
+          },
+        );
+        messageEvent.setThreadId(thread.id);
+        messageEvent.setThreadIdOnRaw(thread.id);
 
         this.broadcast(profile, StdEventType.message, messageEvent.getRaw());
-        await this.channelEventBus.emitMessage(messageEvent);
-
-        const resolvedThreadId = messageEvent.getThreadId();
-        if (resolvedThreadId) {
-          messageEvent.setThreadIdOnRaw(resolvedThreadId);
-          if (req.session.web) req.session.web.threadId = resolvedThreadId;
-        }
+        this.enqueueMessageDispatch(req, messageEvent);
 
         continue;
       }

package/src/extensions/channels/web/outbound/web-outbound-message-encoder.ts

@@ -24,8 +24,8 @@ import { ChannelOutboundMessageEncoder } from '@/channel/lib/outbound';
 import { ChannelAttachmentService } from '@/channel/services/channel-attachment.service';
 import { VIEW_MORE_PAYLOAD } from '@/chat/helpers/constants';
 import { ContentOrmEntity } from '@/cms/entities/content.entity';
-import { I18nService } from '@/i18n';
-import { LoggerService } from '@/logger';
+import { I18nService } from '@/i18n/services/i18n.service';
+import { LoggerService } from '@/logger/logger.service';
 
 import { Web } from '../types';
 

package/src/extensions/channels/web/services/web-session.service.ts

@@ -215,6 +215,10 @@ export class WebSessionService {
     return this.threadService.resolveThread({ subscriberId, explicitThreadId });
   }
 
+  resolveInactivityHours(settings: unknown): number {
+    return this.threadService.resolveInactivityHours(settings);
+  }
+
   /**
    * Resolves a thread from the request query/body and writes the result back
    * to the session. Used by the subscribe/history flows.
@@ -232,4 +236,35 @@ export class WebSessionService {
 
     return thread;
   }
+
+  /**
+   * Resolves the writable thread for an incoming message and persists it on the
+   * socket session before chatbot processing continues asynchronously.
+   */
+  async resolveThreadForIncoming(
+    req: SocketRequest,
+    subscriberId: string,
+    {
+      explicitThreadId,
+      inactivityHours,
+      sourceId,
+    }: {
+      explicitThreadId?: string;
+      inactivityHours?: number;
+      sourceId?: string;
+    },
+  ): Promise<Thread> {
+    const thread = await this.threadService.resolveThreadForIncoming({
+      subscriberId,
+      explicitThreadId,
+      inactivityHours,
+      sourceId,
+    });
+
+    if (req.session.web) {
+      req.session.web.threadId = thread.id;
+    }
+
+    return thread;
+  }
 }

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/global.d.ts

@@ -8,10 +8,4 @@ import '../types/event-emitter';
 import '../types/express-session';
 import './types/ai-sdk-mcp-stdio';
 
-declare global {
-  type HyphenToUnderscore<S extends string> = S extends `${infer P}-${infer Q}`
-    ? `${P}_${HyphenToUnderscore<Q>}`
-    : S;
-}
-
 export {};

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/license/services/lemon-squeezy.service.ts

@@ -4,10 +4,11 @@
  * Full terms: see LICENSE.md.
  */
 
+import { randomUUID } from 'crypto';
+
 import { HttpService } from '@nestjs/axios';
 import { Injectable } from '@nestjs/common';
 import { AxiosError } from 'axios';
-import { v4 as uuidv4 } from 'uuid';
 
 import {
   LemonSqueezyActivationResponse,
@@ -52,7 +53,7 @@ export class LemonSqueezyService {
         `${LEMON_SQUEEZY_API_BASE_URL}/v1/licenses/activate`,
         {
           license_key: licenseKey,
-          instance_name: uuidv4(),
+          instance_name: randomUUID(),
         },
         {
           headers: {

package/src/mailer/mailer.module.ts

@@ -4,66 +4,13 @@
  * Full terms: see LICENSE.md.
  */
 
-import path from 'path';
-
 import { Global, Module } from '@nestjs/common';
-import {
-  ISendMailOptions,
-  MAILER_OPTIONS,
-  MailerOptions,
-  MailerModule as NestjsMailerModule,
-} from '@nestjs-modules/mailer';
-import SMTPTransport from 'nodemailer/lib/smtp-transport';
-
-import { config } from '@/config';
 
 import { MailerService } from './mailer.service';
-import { MjmlAdapter } from './mjml-adapter.class';
-
-const mailerOptions: MailerOptions = {
-  transport: new SMTPTransport({
-    ...config.emails.smtp,
-    logger: true,
-    debug: false,
-  }),
-  template: {
-    adapter: new MjmlAdapter(),
-    dir: path.join(process.cwd(), 'dist', 'templates'),
-    options: {
-      context: {
-        appName: config.parameters.appName,
-        appUrl: config.uiBaseUrl,
-      },
-    },
-  },
-  defaults: { from: config.emails.from },
-};
 
 @Global()
 @Module({
-  imports: [
-    ...(config.emails.isEnabled
-      ? [NestjsMailerModule.forRoot(mailerOptions)]
-      : []),
-  ],
-  providers: [
-    {
-      provide: MAILER_OPTIONS,
-      useValue: mailerOptions,
-    },
-    ...(config.emails.isEnabled
-      ? [MailerService]
-      : [
-          {
-            provide: MailerService,
-            useValue: {
-              sendMail(_options: ISendMailOptions) {
-                throw new Error('Email Service is not enabled');
-              },
-            },
-          },
-        ]),
-  ],
+  providers: [MailerService],
   exports: [MailerService],
 })
 export class MailerModule {}

package/src/mailer/mailer.service.ts

@@ -4,6 +4,90 @@
  * Full terms: see LICENSE.md.
  */
 
-import { MailerService as NestjsMailerService } from '@nestjs-modules/mailer';
+import { readFile } from 'fs/promises';
+import path from 'path';
 
-export class MailerService extends NestjsMailerService {}
+import { Injectable } from '@nestjs/common';
+import Handlebars from 'handlebars';
+import mjml2html from 'mjml';
+import nodemailer, {
+  SendMailOptions as NodemailerSendMailOptions,
+  SentMessageInfo,
+  Transporter,
+} from 'nodemailer';
+import SMTPTransport from 'nodemailer/lib/smtp-transport';
+
+import { config } from '@/config';
+
+export type SendMailOptions = NodemailerSendMailOptions & {
+  template?: string;
+  context?: Record<string, unknown>;
+};
+
+@Injectable()
+export class MailerService {
+  private readonly transporter?: Transporter<SentMessageInfo>;
+
+  constructor() {
+    if (!config.emails.isEnabled) {
+      return;
+    }
+
+    this.transporter = nodemailer.createTransport(
+      new SMTPTransport({
+        ...config.emails.smtp,
+        logger: true,
+        debug: false,
+      }),
+    );
+  }
+
+  async sendMail({ template, context, ...options }: SendMailOptions) {
+    if (!this.transporter) {
+      throw new Error('Email Service is not enabled');
+    }
+
+    const html = template
+      ? await this.renderTemplate(template, context)
+      : options.html;
+
+    return await this.transporter.sendMail({
+      from: config.emails.from,
+      ...options,
+      html,
+    });
+  }
+
+  async verifyAllTransporters(): Promise<boolean> {
+    if (!this.transporter) {
+      return false;
+    }
+
+    return await this.transporter.verify();
+  }
+
+  private async renderTemplate(
+    template: string,
+    context: Record<string, unknown> = {},
+  ): Promise<string> {
+    const templatePath = path.join(
+      process.cwd(),
+      'dist',
+      'templates',
+      template,
+    );
+    const content = await readFile(templatePath, 'utf-8');
+    const compiledHandlebars = Handlebars.compile(content)({
+      appName: config.parameters.appName,
+      appUrl: config.uiBaseUrl,
+      ...context,
+    });
+    const { errors, html } = mjml2html(compiledHandlebars);
+
+    if (errors.length) {
+      throw new Error('Unable to compile mjml template');
+    }
+
+    return html;
+  }
+}