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

package/src/config/types.ts

@@ -43,6 +43,14 @@ type TDatabaseConfig = {
   schema?: string;
   autoMigrate: boolean;
 };
+type TMcpConfig = {
+  enabled: boolean;
+  serverName: string;
+  serverTitle: string;
+  serverVersion: string;
+  serverDescription: string;
+  serverInstructions: string;
+};
 type SocketCookie =
   | {
       maxAge?: number | undefined;
@@ -59,6 +67,7 @@ export type Config = {
   apiBaseUrl: string;
   uiBaseUrl: string;
   ssoEnabled: boolean;
+  mcp: TMcpConfig;
   security: {
     httpsEnabled: boolean;
     trustProxy: boolean;

package/src/extensions/actions/ai/agent.action.ts

@@ -47,6 +47,7 @@ export class AiAgentAction extends AiBaseAction<
     settings,
     context,
     bindings,
+    signal,
   }: ExecArgs<AiAgentInput, WorkflowRuntimeContext, AiAgentSettings>) {
     const logger = context.services.logger;
     const modelBinding = bindings.model;
@@ -77,6 +78,7 @@ export class AiAgentAction extends AiBaseAction<
       bindings.tools,
       bindings.mcp,
       selectedMemorySlugs,
+      signal,
     )) as ToolSet | undefined;
     const toolNames = [
       ...Object.keys(bindings.tools ?? {}),
@@ -115,7 +117,10 @@ export class AiAgentAction extends AiBaseAction<
       throw new Error('Prompt is required to call the agent.');
     }
 
-    const result = await agent.generate({ prompt: agentPrompt });
+    const result = await agent.generate({
+      prompt: agentPrompt,
+      abortSignal: signal,
+    });
 
     return {
       text: result.text,

package/src/extensions/actions/ai/ai-base.action.ts

@@ -656,6 +656,7 @@ export abstract class AiBaseAction<
     toolBindings?: RuntimeBindings['tools'],
     mcpToolBindings?: RuntimeBindings['mcp'],
     selectedMemorySlugs: string[] = [],
+    signal?: AbortSignal,
   ): Promise<ToolSet | undefined> {
     const actionService = context.services.actions;
     const logger = context.services.logger;
@@ -691,15 +692,36 @@ export abstract class AiBaseAction<
           description: action.description,
           inputSchema: action.inputSchema,
           outputSchema: action.outputSchema,
-          execute: async (input) =>
-            nestedBindings
+          execute: async (input, options) => {
+            const toolSignal = options?.abortSignal ?? signal;
+
+            if (nestedBindings) {
+              return toolSignal
+                ? action.run(
+                    input,
+                    context,
+                    toolDefinition.settings as any,
+                    nestedBindings as RuntimeBindings,
+                    toolSignal,
+                  )
+                : action.run(
+                    input,
+                    context,
+                    toolDefinition.settings as any,
+                    nestedBindings as RuntimeBindings,
+                  );
+            }
+
+            return toolSignal
               ? action.run(
                   input,
                   context,
                   toolDefinition.settings as any,
-                  nestedBindings as RuntimeBindings,
+                  undefined,
+                  toolSignal,
                 )
-              : action.run(input, context, toolDefinition.settings as any),
+              : action.run(input, context, toolDefinition.settings as any);
+          },
         } as ToolSet[string];
       }
     }
@@ -746,7 +768,19 @@ export abstract class AiBaseAction<
           description: updateMemoryAction.description,
           inputSchema: memorySchema,
           outputSchema: memorySchema,
-          execute: async (input) => updateMemoryAction.run(input, context),
+          execute: async (input, options) => {
+            const toolSignal = options?.abortSignal ?? signal;
+
+            return toolSignal
+              ? updateMemoryAction.run(
+                  input,
+                  context,
+                  undefined,
+                  undefined,
+                  toolSignal,
+                )
+              : updateMemoryAction.run(input, context);
+          },
         } as ToolSet[string];
       }
     }

package/src/extensions/actions/ai/generate-object.base.action.ts

@@ -35,6 +35,7 @@ export abstract class AiGenerateObjectBaseAction<
     settings,
     context,
     bindings,
+    signal,
   }: ExecArgs<I, C, AiGenerateObjectSettings>) {
     const logger = context.services.logger;
     const modelBinding = bindings.model;
@@ -68,6 +69,7 @@ export abstract class AiGenerateObjectBaseAction<
       bindings.tools,
       bindings.mcp,
       selectedMemorySlugs,
+      signal,
     )) as ToolSet | undefined;
     const toolNames = [
       ...Object.keys(bindings.tools ?? {}),
@@ -101,6 +103,7 @@ export abstract class AiGenerateObjectBaseAction<
       ...callSettingsWithoutStops,
       model,
       output,
+      abortSignal: signal,
       ...(tools ? { tools } : {}),
       ...(stopWhen ? { stopWhen } : {}),
     });

package/src/extensions/actions/ai/generate-text.base.action.ts

@@ -31,6 +31,7 @@ export abstract class AiGenerateTextBaseAction<
     settings,
     context,
     bindings,
+    signal,
   }: ExecArgs<I, C, AiGenerateTextSettings>) {
     const logger = context.services.logger;
     const modelBinding = bindings.model;
@@ -61,6 +62,7 @@ export abstract class AiGenerateTextBaseAction<
       bindings.tools,
       bindings.mcp,
       selectedMemorySlugs,
+      signal,
     )) as ToolSet | undefined;
     const toolNames = [
       ...Object.keys(bindings.tools ?? {}),
@@ -86,6 +88,7 @@ export abstract class AiGenerateTextBaseAction<
       ...promptPayload,
       ...callSettings,
       model,
+      abortSignal: signal,
       ...(tools ? { tools } : {}),
       ...(stopWhen ? { stopWhen } : {}),
     });

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/web/http-request.action.ts

@@ -136,6 +136,17 @@ function resolveFinalUrl(response: {
   return response.request?.res?.responseUrl ?? response.request?.responseUrl;
 }
 
+function isAxiosCancellation(error: unknown) {
+  if (typeof axios.isCancel === 'function' && axios.isCancel(error)) {
+    return true;
+  }
+
+  return (
+    error instanceof Error &&
+    (error as Error & { code?: string }).code === 'ERR_CANCELED'
+  );
+}
+
 function parseRequestBody(
   body: string,
 ): string | Record<string, unknown> | unknown[] {
@@ -171,7 +182,7 @@ export const HttpRequestAction = createAction<
   inputSchema: httpRequestInputSchema,
   outputSchema: httpRequestOutputSchema,
   settingsSchema: httpRequestSettingsSchema,
-  async execute({ input, context, settings }) {
+  async execute({ input, context, settings, signal }) {
     const logger = context.services.logger;
     const timeoutMs = settings.timeout_ms ?? 10000;
     const method = settings.method ?? 'GET';
@@ -192,6 +203,7 @@ export const HttpRequestAction = createAction<
         method,
         headers,
         timeout: timeoutMs,
+        signal,
         validateStatus: () => true,
         ...(requestData !== undefined ? { data: requestData } : {}),
       });
@@ -240,6 +252,10 @@ export const HttpRequestAction = createAction<
         truncated: false,
       };
     } catch (error) {
+      if (signal?.aborted || isAxiosCancellation(error)) {
+        throw error;
+      }
+
       const message =
         error instanceof Error ? error.message : 'Unknown network error';
 

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';