@atomoz/workflows-nodes 0.1.27 → 0.1.28

package/dist/index.cjs

@@ -36,7 +36,13 @@ __export(index_exports, {
   AiToolNodeFunction: () => AiToolNodeFunction,
   AiToolNodeSchema: () => AiToolNodeSchema,
   BodyFieldSchema: () => BodyFieldSchema,
+  ChatLogNode: () => ChatLogNode,
+  ChatLogNodeFunction: () => ChatLogNodeFunction,
+  ChatLogSchema: () => ChatLogSchema,
   CustomToolSchema: () => CustomToolSchema,
+  GetOrCreateThreadNode: () => GetOrCreateThreadNode,
+  GetOrCreateThreadNodeFunction: () => GetOrCreateThreadNodeFunction,
+  GetOrCreateThreadSchema: () => GetOrCreateThreadSchema,
   HTTP_METHODS: () => HTTP_METHODS,
   HTTP_NODE_TYPES: () => HTTP_NODE_TYPES,
   HeaderSchema: () => HeaderSchema,
@@ -1124,6 +1130,18 @@ async function createLLMFromModel(modelConfig, authToken, streaming = false) {
 }
 
 // src/utils/guardrail-executor.ts
+function emitGuardrailEvent(context, name, passed, action, details) {
+  if (context?.emitter?.emitThought) {
+    context.emitter.emitThought({
+      content: `guardrail:${passed ? "passed" : "failed"}:${name}`,
+      type: "guardrail",
+      name,
+      passed,
+      action: action || "evaluate",
+      details
+    });
+  }
+}
 async function loadChatHistory(context) {
   const checkpointer = context?.checkpointer;
   const sessionId = context?.sessionId;
@@ -1218,6 +1236,7 @@ async function executeGuardrails(guardrails, content, mode = "fail-first", conte
       if (!guardPassed && actionInstruction) {
         violationMessage = actionInstruction;
       }
+      emitGuardrailEvent(context, guard.name, guardPassed, guard.action, violationMessage || "Rule passed");
     } else if (guard.type === "function") {
       const { nodeFunction, name, actionInstruction } = guard;
       if (typeof nodeFunction === "function") {
@@ -1250,6 +1269,7 @@ async function executeGuardrails(guardrails, content, mode = "fail-first", conte
           guardPassed = false;
           violationMessage = `Erro na fun\xE7\xE3o guardrail: ${error instanceof Error ? error.message : String(error)}`;
         }
+        emitGuardrailEvent(context, name, guardPassed, guard.action, violationMessage || "Function passed");
       }
     } else if (guard.type === "model") {
       const { model, evaluationPrompt, name, actionInstruction } = guard;
@@ -1317,6 +1337,7 @@ Reescreva o conte\xFAdo corrigindo a viola\xE7\xE3o. Retorne APENAS o texto corr
                   message: violationMessage,
                   action: "fix"
                 });
+                emitGuardrailEvent(context, name, false, "fix", `Content fixed: ${fixedContent.slice(0, 100)}...`);
               } catch (fixError) {
                 console.error(`[GUARDRAIL LLM] Erro ao corrigir conte\xFAdo:`, fixError);
               }
@@ -1328,8 +1349,10 @@ Reescreva o conte\xFAdo corrigindo a viola\xE7\xE3o. Retorne APENAS o texto corr
               guardPassed = false;
               violationMessage = actionInstruction || `Modelo de avalia\xE7\xE3o "${name}" detectou viola\xE7\xE3o de seguran\xE7a/pol\xEDtica.`;
               console.log(`[GUARDRAIL LLM] Resultado: UNSAFE - Bloqueado`);
+              emitGuardrailEvent(context, name, false, guard.action, violationMessage);
             } else {
               console.log(`[GUARDRAIL LLM] Resultado: SAFE - Aprovado`);
+              emitGuardrailEvent(context, name, true, "approve", "Content passed evaluation");
             }
           }
         } catch (error) {
@@ -3307,6 +3330,335 @@ var ModelGuardrailNodeFunction = async (inputs) => {
   };
 };
 
+// src/nodes/chat/getOrCreateThread/data.ts
+var import_zod17 = require("zod");
+var GetOrCreateThreadSchema = import_zod17.z.object({
+  source: import_zod17.z.string().describe("Channel source: whatsapp, telegram, web, etc."),
+  identifier: import_zod17.z.string().describe("User identifier: phone number, chat_id, userId"),
+  timeoutMinutes: import_zod17.z.number().optional().describe("Inactivity timeout in minutes (default: 1440 = 24h)")
+});
+var GetOrCreateThreadNode = {
+  label: "Get or Create Thread",
+  type: "GetOrCreateThreadNode",
+  category: "chat",
+  description: "Generates or retrieves a threadId based on identifier + timeout. Ensures tenant isolation.",
+  icon: "\u{1F9F5}",
+  group: "Chat",
+  tags: {
+    execution: "async",
+    group: "Chat"
+  },
+  fields: [
+    {
+      id: "source",
+      label: "Source",
+      type: "string",
+      required: true,
+      defaultValue: "whatsapp",
+      placeholder: "whatsapp, telegram, web",
+      handle: {
+        type: "input",
+        label: "Source",
+        name: "source",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "identifier",
+      label: "Identifier",
+      type: "string",
+      required: true,
+      placeholder: "+5511999999999",
+      handle: {
+        type: "input",
+        label: "Identifier",
+        name: "identifier",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "timeoutMinutes",
+      label: "Timeout (minutes)",
+      type: "number",
+      required: false,
+      defaultValue: "1440",
+      placeholder: "1440 (24 hours)"
+    },
+    {
+      id: "threadId",
+      label: "Thread ID",
+      type: "string",
+      required: true,
+      typeable: false,
+      handle: {
+        type: "output",
+        label: "Thread ID",
+        name: "threadId",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "isNew",
+      label: "Is New Thread",
+      type: "boolean",
+      required: true,
+      typeable: false,
+      handle: {
+        type: "output",
+        label: "Is New",
+        name: "isNew",
+        fieldType: "boolean"
+      }
+    }
+  ]
+};
+
+// src/nodes/chat/getOrCreateThread/function.ts
+var GetOrCreateThreadNodeFunction = async (inputs) => {
+  const fieldValues = inputs.fieldValues || {};
+  const context = inputs.context || {};
+  const source = fieldValues.source;
+  const identifier = fieldValues.identifier;
+  const timeoutMinutes = Number(fieldValues.timeoutMinutes) || 1440;
+  const companyId = context?.companyId;
+  if (!companyId) {
+    throw new Error("GetOrCreateThread requires companyId in context for tenant isolation");
+  }
+  if (!source || !identifier) {
+    throw new Error("GetOrCreateThread requires source and identifier");
+  }
+  const timeoutMs = timeoutMinutes * 60 * 1e3;
+  const thresholdDate = new Date(Date.now() - timeoutMs);
+  const db = context?.db;
+  if (!db) {
+    throw new Error("GetOrCreateThread requires database connection in context");
+  }
+  try {
+    const existingSessions = await db.query(`
+            SELECT id, session_id, updated_at 
+            FROM chat_sessions 
+            WHERE company_id = $1 
+              AND metadata->>'source' = $2 
+              AND metadata->>'identifier' = $3
+              AND updated_at > $4
+            ORDER BY updated_at DESC
+            LIMIT 1
+        `, [companyId, source, identifier, thresholdDate]);
+    if (existingSessions.rows && existingSessions.rows.length > 0) {
+      const session = existingSessions.rows[0];
+      await db.query(`
+                UPDATE chat_sessions 
+                SET updated_at = NOW() 
+                WHERE id = $1 AND company_id = $2
+            `, [session.id, companyId]);
+      return {
+        threadId: session.session_id,
+        isNew: false
+      };
+    }
+    const newSessionId = crypto.randomUUID();
+    const workflowId = context?.workflowId;
+    await db.query(`
+            INSERT INTO chat_sessions (workflow_id, company_id, chat_id, session_id, metadata)
+            VALUES ($1, $2, $3, $4, $5)
+        `, [
+      workflowId || companyId,
+      // fallback to companyId if no workflowId
+      companyId,
+      `${source}:${identifier}`,
+      // chatId as composite key
+      newSessionId,
+      JSON.stringify({ source, identifier })
+    ]);
+    return {
+      threadId: newSessionId,
+      isNew: true
+    };
+  } catch (error) {
+    console.error("[GetOrCreateThread] Error:", error);
+    throw error;
+  }
+};
+
+// src/nodes/chat/chatLog/data.ts
+var import_zod18 = require("zod");
+var ChatLogSchema = import_zod18.z.object({
+  threadId: import_zod18.z.string().describe("Thread ID from GetOrCreateThread"),
+  direction: import_zod18.z.enum(["inbound", "outbound"]).describe("Message direction"),
+  content: import_zod18.z.string().describe("Message content"),
+  source: import_zod18.z.string().optional().describe("Channel source"),
+  identifier: import_zod18.z.string().optional().describe("User identifier"),
+  metadata: import_zod18.z.record(import_zod18.z.string(), import_zod18.z.any()).optional().describe("Additional metadata")
+});
+var ChatLogNode = {
+  label: "Chat Log",
+  type: "ChatLogNode",
+  category: "chat",
+  description: "Saves a message to the chat history. Supports inbound (user) and outbound (assistant) messages.",
+  icon: "\u{1F4AC}",
+  group: "Chat",
+  tags: {
+    execution: "async",
+    group: "Chat"
+  },
+  fields: [
+    {
+      id: "threadId",
+      label: "Thread ID",
+      type: "string",
+      required: true,
+      placeholder: "From GetOrCreateThread node",
+      handle: {
+        type: "input",
+        label: "Thread ID",
+        name: "threadId",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "direction",
+      label: "Direction",
+      type: "select",
+      required: true,
+      defaultValue: "inbound",
+      options: [
+        { label: "Inbound (User \u2192 System)", value: "inbound" },
+        { label: "Outbound (System \u2192 User)", value: "outbound" }
+      ]
+    },
+    {
+      id: "content",
+      label: "Content",
+      type: "string",
+      required: true,
+      placeholder: "Message content",
+      handle: {
+        type: "input",
+        label: "Content",
+        name: "content",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "source",
+      label: "Source",
+      type: "string",
+      required: false,
+      defaultValue: "whatsapp",
+      placeholder: "whatsapp, telegram, web",
+      handle: {
+        type: "input",
+        label: "Source",
+        name: "source",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "identifier",
+      label: "Identifier",
+      type: "string",
+      required: false,
+      placeholder: "+5511999999999",
+      handle: {
+        type: "input",
+        label: "Identifier",
+        name: "identifier",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "messageId",
+      label: "Message ID",
+      type: "string",
+      required: true,
+      typeable: false,
+      handle: {
+        type: "output",
+        label: "Message ID",
+        name: "messageId",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "success",
+      label: "Success",
+      type: "boolean",
+      required: true,
+      typeable: false,
+      handle: {
+        type: "output",
+        label: "Success",
+        name: "success",
+        fieldType: "boolean"
+      }
+    }
+  ]
+};
+
+// src/nodes/chat/chatLog/function.ts
+var ChatLogNodeFunction = async (inputs) => {
+  const fieldValues = inputs.fieldValues || {};
+  const context = inputs.context || {};
+  const threadId = fieldValues.threadId;
+  const direction = fieldValues.direction;
+  const content = fieldValues.content;
+  const source = fieldValues.source;
+  const identifier = fieldValues.identifier;
+  const companyId = context?.companyId;
+  if (!companyId) {
+    throw new Error("ChatLog requires companyId in context for tenant isolation");
+  }
+  if (!threadId || !content) {
+    throw new Error("ChatLog requires threadId and content");
+  }
+  const role = direction === "inbound" ? "user" : "assistant";
+  const db = context?.db;
+  if (!db) {
+    throw new Error("ChatLog requires database connection in context");
+  }
+  try {
+    const sessionResult = await db.query(`
+            SELECT id FROM chat_sessions 
+            WHERE session_id = $1 AND company_id = $2
+            LIMIT 1
+        `, [threadId, companyId]);
+    if (!sessionResult.rows || sessionResult.rows.length === 0) {
+      throw new Error(`Session not found for threadId: ${threadId}`);
+    }
+    const sessionId = sessionResult.rows[0].id;
+    const messageId = crypto.randomUUID();
+    await db.query(`
+            INSERT INTO chat_messages (id, session_id, role, content, metadata)
+            VALUES ($1, $2, $3, $4, $5)
+        `, [
+      messageId,
+      sessionId,
+      role,
+      content,
+      JSON.stringify({
+        direction,
+        source: source || null,
+        identifier: identifier || null
+      })
+    ]);
+    await db.query(`
+            UPDATE chat_sessions 
+            SET updated_at = NOW() 
+            WHERE id = $1 AND company_id = $2
+        `, [sessionId, companyId]);
+    return {
+      messageId,
+      success: true
+    };
+  } catch (error) {
+    console.error("[ChatLog] Error:", error);
+    return {
+      messageId: null,
+      success: false
+    };
+  }
+};
+
 // src/nodes/consts/nodes.ts
 var nodes = [
   ChatInputNode,
@@ -3333,7 +3685,9 @@ var nodes = [
   PromptGuardrailNode,
   RuleGuardrailNode,
   FunctionGuardrailNode,
-  ModelGuardrailNode
+  ModelGuardrailNode,
+  GetOrCreateThreadNode,
+  ChatLogNode
 ];
 var nodes_default = nodes;
 
@@ -3455,7 +3809,9 @@ var nodeFunctions = {
   PromptGuardrailNode: PromptGuardrailNodeFunction,
   RuleGuardrailNode: RuleGuardrailNodeFunction,
   FunctionGuardrailNode: FunctionGuardrailNodeFunction,
-  ModelGuardrailNode: ModelGuardrailNodeFunction
+  ModelGuardrailNode: ModelGuardrailNodeFunction,
+  GetOrCreateThreadNode: GetOrCreateThreadNodeFunction,
+  ChatLogNode: ChatLogNodeFunction
 };
 var node_functions_default = nodeFunctions;
 
@@ -3569,12 +3925,12 @@ var HttpPutInputNodeFunction = (params) => {
 };
 
 // src/nodes/inputs/http/put/schema.ts
-var import_zod17 = require("zod");
-var HttpPutInputNodeSchema = import_zod17.z.object({
+var import_zod19 = require("zod");
+var HttpPutInputNodeSchema = import_zod19.z.object({
   route: RouteSchema,
-  queryParams: import_zod17.z.array(QueryParamSchema).optional().describe("Query parameters configuration"),
-  headers: import_zod17.z.array(HeaderSchema).optional().describe("Headers configuration"),
-  body: import_zod17.z.array(BodyFieldSchema).optional().describe("Body fields configuration")
+  queryParams: import_zod19.z.array(QueryParamSchema).optional().describe("Query parameters configuration"),
+  headers: import_zod19.z.array(HeaderSchema).optional().describe("Headers configuration"),
+  body: import_zod19.z.array(BodyFieldSchema).optional().describe("Body fields configuration")
 });
 
 // src/nodes/inputs/http/delete/data.ts
@@ -3666,11 +4022,11 @@ var HttpDeleteInputNodeFunction = async (params) => {
 };
 
 // src/nodes/inputs/http/delete/schema.ts
-var import_zod18 = require("zod");
-var HttpDeleteInputNodeSchema = import_zod18.z.object({
+var import_zod20 = require("zod");
+var HttpDeleteInputNodeSchema = import_zod20.z.object({
   route: RouteSchema,
-  queryParams: import_zod18.z.array(QueryParamSchema).optional().describe("Query parameters configuration"),
-  headers: import_zod18.z.array(HeaderSchema).optional().describe("Headers configuration")
+  queryParams: import_zod20.z.array(QueryParamSchema).optional().describe("Query parameters configuration"),
+  headers: import_zod20.z.array(HeaderSchema).optional().describe("Headers configuration")
 });
 
 // src/nodes/inputs/http/patch/data.ts
@@ -3783,12 +4139,12 @@ var HttpPatchInputNodeFunction = (params) => {
 };
 
 // src/nodes/inputs/http/patch/schema.ts
-var import_zod19 = require("zod");
-var HttpPatchInputNodeSchema = import_zod19.z.object({
+var import_zod21 = require("zod");
+var HttpPatchInputNodeSchema = import_zod21.z.object({
   route: RouteSchema,
-  queryParams: import_zod19.z.array(QueryParamSchema).optional().describe("Query parameters configuration"),
-  headers: import_zod19.z.array(HeaderSchema).optional().describe("Headers configuration"),
-  body: import_zod19.z.array(BodyFieldSchema).optional().describe("Body fields configuration")
+  queryParams: import_zod21.z.array(QueryParamSchema).optional().describe("Query parameters configuration"),
+  headers: import_zod21.z.array(HeaderSchema).optional().describe("Headers configuration"),
+  body: import_zod21.z.array(BodyFieldSchema).optional().describe("Body fields configuration")
 });
 
 // src/nodes/inputs/http/utils.ts
@@ -3848,7 +4204,13 @@ var getHttpMethodFromFriendlyId = (friendlyId) => {
   AiToolNodeFunction,
   AiToolNodeSchema,
   BodyFieldSchema,
+  ChatLogNode,
+  ChatLogNodeFunction,
+  ChatLogSchema,
   CustomToolSchema,
+  GetOrCreateThreadNode,
+  GetOrCreateThreadNodeFunction,
+  GetOrCreateThreadSchema,
   HTTP_METHODS,
   HTTP_NODE_TYPES,
   HeaderSchema,

package/dist/index.d.cts

@@ -144,7 +144,7 @@ interface ExecutionStep {
 type NodeExecution = 'sync' | 'async';
 interface NodeTags {
     execution: NodeExecution[] | NodeExecution;
-    group: 'IA' | 'HTTP' | 'Data Transformation' | 'Custom' | 'Social' | 'Control' | 'Memory' | 'Guardrails';
+    group: 'IA' | 'HTTP' | 'Data Transformation' | 'Custom' | 'Social' | 'Control' | 'Memory' | 'Guardrails' | 'Chat';
 }
 
 type NodeData = {
@@ -191,6 +191,8 @@ declare const nodeFunctions: {
     RuleGuardrailNode: (inputs: any) => Promise<any>;
     FunctionGuardrailNode: (inputs: any) => Promise<any>;
     ModelGuardrailNode: (inputs: any) => Promise<any>;
+    GetOrCreateThreadNode: (inputs: any) => Promise<any>;
+    ChatLogNode: (inputs: any) => Promise<any>;
 };
 
 declare const IaAgentNodeSchema: z.ZodObject<{
@@ -444,4 +446,40 @@ declare const WhatsappSendMessageFunction: (fieldValues: any) => Promise<any>;
 
 declare const WhatsappMessageTriggerNode: NodeData;
 
-export { AiSupervisorNode, AiSupervisorNodeFunction, AiSupervisorNodeSchema, AiToolNode, AiToolNodeFunction, AiToolNodeSchema, type BaseNodeType, BodyFieldSchema, CustomToolSchema, type ExecutionStep, HTTP_METHODS, HTTP_NODE_TYPES, HeaderSchema, HttpDeleteInputNode, HttpDeleteInputNodeFunction, HttpDeleteInputNodeSchema, type HttpDeleteInputNodeType, HttpGetInputNode, HttpGetInputNodeFunction, HttpGetInputNodeSchema, type HttpGetInputNodeType, type HttpMethod, type HttpNodeType, type HttpOutput, HttpPatchInputNode, HttpPatchInputNodeFunction, HttpPatchInputNodeSchema, type HttpPatchInputNodeType, HttpPostInputNode, HttpPostInputNodeFunction, HttpPostInputNodeSchema, type HttpPostInputNodeType, HttpPutInputNode, HttpPutInputNodeFunction, HttpPutInputNodeSchema, type HttpPutInputNodeType, IaAgentNode, IaAgentNodeFunction, IaAgentNodeSchema, IaMessageNode, IaMessageNodeFunction, IaMessageNodeSchema, type NodeData, type NodeDefinition, type NodeExecution, type NodeExecutionConfig, type NodeExecutionContext, type NodeField, type NodeHandle, type NodeInput, type NodeInputValue, type NodeLogicFunction, type NodeOutput, type NodeOutputValue, type NodeStyle, type NodeTags, type NodeTransformation, type NodeValidation, QueryParamSchema, RouteSchema, WhatsappMessageTriggerNode, WhatsappSendMessageFunction, WhatsappSendMessageNode, WhatsappSendMessageNodeSchema, WhatsappSendTemplateNode, WhatsappSendTemplateNodeSchema, WhatsappStartChatFunction, createMessageTemplate, extractHttpMethodFromNodeType, getHttpMethodFromFriendlyId, getHttpMethodFromNodeType, getHttpNodeTypeStrings, getHttpNodeTypesArray, getHttpNodesTypes, getMessageTemplates, isAnyHttpInputNode, isHttpInputFriendlyId, isHttpInputNode, isHttpMethodNode, nodeFunctions, nodes, schemas };
+declare const GetOrCreateThreadSchema: z.ZodObject<{
+    source: z.ZodString;
+    identifier: z.ZodString;
+    timeoutMinutes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const GetOrCreateThreadNode: NodeData;
+
+/**
+ * GetOrCreateThread Node Function
+ *
+ * Generates or retrieves a threadId based on source + identifier + timeout.
+ * ALWAYS filters by companyId for tenant isolation.
+ */
+declare const GetOrCreateThreadNodeFunction: (inputs: any) => Promise<any>;
+
+declare const ChatLogSchema: z.ZodObject<{
+    threadId: z.ZodString;
+    direction: z.ZodEnum<{
+        inbound: "inbound";
+        outbound: "outbound";
+    }>;
+    content: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    identifier: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+declare const ChatLogNode: NodeData;
+
+/**
+ * ChatLog Node Function
+ *
+ * Saves a message to chat_messages table.
+ * ALWAYS filters by companyId for tenant isolation.
+ */
+declare const ChatLogNodeFunction: (inputs: any) => Promise<any>;
+
+export { AiSupervisorNode, AiSupervisorNodeFunction, AiSupervisorNodeSchema, AiToolNode, AiToolNodeFunction, AiToolNodeSchema, type BaseNodeType, BodyFieldSchema, ChatLogNode, ChatLogNodeFunction, ChatLogSchema, CustomToolSchema, type ExecutionStep, GetOrCreateThreadNode, GetOrCreateThreadNodeFunction, GetOrCreateThreadSchema, HTTP_METHODS, HTTP_NODE_TYPES, HeaderSchema, HttpDeleteInputNode, HttpDeleteInputNodeFunction, HttpDeleteInputNodeSchema, type HttpDeleteInputNodeType, HttpGetInputNode, HttpGetInputNodeFunction, HttpGetInputNodeSchema, type HttpGetInputNodeType, type HttpMethod, type HttpNodeType, type HttpOutput, HttpPatchInputNode, HttpPatchInputNodeFunction, HttpPatchInputNodeSchema, type HttpPatchInputNodeType, HttpPostInputNode, HttpPostInputNodeFunction, HttpPostInputNodeSchema, type HttpPostInputNodeType, HttpPutInputNode, HttpPutInputNodeFunction, HttpPutInputNodeSchema, type HttpPutInputNodeType, IaAgentNode, IaAgentNodeFunction, IaAgentNodeSchema, IaMessageNode, IaMessageNodeFunction, IaMessageNodeSchema, type NodeData, type NodeDefinition, type NodeExecution, type NodeExecutionConfig, type NodeExecutionContext, type NodeField, type NodeHandle, type NodeInput, type NodeInputValue, type NodeLogicFunction, type NodeOutput, type NodeOutputValue, type NodeStyle, type NodeTags, type NodeTransformation, type NodeValidation, QueryParamSchema, RouteSchema, WhatsappMessageTriggerNode, WhatsappSendMessageFunction, WhatsappSendMessageNode, WhatsappSendMessageNodeSchema, WhatsappSendTemplateNode, WhatsappSendTemplateNodeSchema, WhatsappStartChatFunction, createMessageTemplate, extractHttpMethodFromNodeType, getHttpMethodFromFriendlyId, getHttpMethodFromNodeType, getHttpNodeTypeStrings, getHttpNodeTypesArray, getHttpNodesTypes, getMessageTemplates, isAnyHttpInputNode, isHttpInputFriendlyId, isHttpInputNode, isHttpMethodNode, nodeFunctions, nodes, schemas };

package/dist/index.d.ts

@@ -144,7 +144,7 @@ interface ExecutionStep {
 type NodeExecution = 'sync' | 'async';
 interface NodeTags {
     execution: NodeExecution[] | NodeExecution;
-    group: 'IA' | 'HTTP' | 'Data Transformation' | 'Custom' | 'Social' | 'Control' | 'Memory' | 'Guardrails';
+    group: 'IA' | 'HTTP' | 'Data Transformation' | 'Custom' | 'Social' | 'Control' | 'Memory' | 'Guardrails' | 'Chat';
 }
 
 type NodeData = {
@@ -191,6 +191,8 @@ declare const nodeFunctions: {
     RuleGuardrailNode: (inputs: any) => Promise<any>;
     FunctionGuardrailNode: (inputs: any) => Promise<any>;
     ModelGuardrailNode: (inputs: any) => Promise<any>;
+    GetOrCreateThreadNode: (inputs: any) => Promise<any>;
+    ChatLogNode: (inputs: any) => Promise<any>;
 };
 
 declare const IaAgentNodeSchema: z.ZodObject<{
@@ -444,4 +446,40 @@ declare const WhatsappSendMessageFunction: (fieldValues: any) => Promise<any>;
 
 declare const WhatsappMessageTriggerNode: NodeData;
 
-export { AiSupervisorNode, AiSupervisorNodeFunction, AiSupervisorNodeSchema, AiToolNode, AiToolNodeFunction, AiToolNodeSchema, type BaseNodeType, BodyFieldSchema, CustomToolSchema, type ExecutionStep, HTTP_METHODS, HTTP_NODE_TYPES, HeaderSchema, HttpDeleteInputNode, HttpDeleteInputNodeFunction, HttpDeleteInputNodeSchema, type HttpDeleteInputNodeType, HttpGetInputNode, HttpGetInputNodeFunction, HttpGetInputNodeSchema, type HttpGetInputNodeType, type HttpMethod, type HttpNodeType, type HttpOutput, HttpPatchInputNode, HttpPatchInputNodeFunction, HttpPatchInputNodeSchema, type HttpPatchInputNodeType, HttpPostInputNode, HttpPostInputNodeFunction, HttpPostInputNodeSchema, type HttpPostInputNodeType, HttpPutInputNode, HttpPutInputNodeFunction, HttpPutInputNodeSchema, type HttpPutInputNodeType, IaAgentNode, IaAgentNodeFunction, IaAgentNodeSchema, IaMessageNode, IaMessageNodeFunction, IaMessageNodeSchema, type NodeData, type NodeDefinition, type NodeExecution, type NodeExecutionConfig, type NodeExecutionContext, type NodeField, type NodeHandle, type NodeInput, type NodeInputValue, type NodeLogicFunction, type NodeOutput, type NodeOutputValue, type NodeStyle, type NodeTags, type NodeTransformation, type NodeValidation, QueryParamSchema, RouteSchema, WhatsappMessageTriggerNode, WhatsappSendMessageFunction, WhatsappSendMessageNode, WhatsappSendMessageNodeSchema, WhatsappSendTemplateNode, WhatsappSendTemplateNodeSchema, WhatsappStartChatFunction, createMessageTemplate, extractHttpMethodFromNodeType, getHttpMethodFromFriendlyId, getHttpMethodFromNodeType, getHttpNodeTypeStrings, getHttpNodeTypesArray, getHttpNodesTypes, getMessageTemplates, isAnyHttpInputNode, isHttpInputFriendlyId, isHttpInputNode, isHttpMethodNode, nodeFunctions, nodes, schemas };
+declare const GetOrCreateThreadSchema: z.ZodObject<{
+    source: z.ZodString;
+    identifier: z.ZodString;
+    timeoutMinutes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const GetOrCreateThreadNode: NodeData;
+
+/**
+ * GetOrCreateThread Node Function
+ *
+ * Generates or retrieves a threadId based on source + identifier + timeout.
+ * ALWAYS filters by companyId for tenant isolation.
+ */
+declare const GetOrCreateThreadNodeFunction: (inputs: any) => Promise<any>;
+
+declare const ChatLogSchema: z.ZodObject<{
+    threadId: z.ZodString;
+    direction: z.ZodEnum<{
+        inbound: "inbound";
+        outbound: "outbound";
+    }>;
+    content: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    identifier: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+declare const ChatLogNode: NodeData;
+
+/**
+ * ChatLog Node Function
+ *
+ * Saves a message to chat_messages table.
+ * ALWAYS filters by companyId for tenant isolation.
+ */
+declare const ChatLogNodeFunction: (inputs: any) => Promise<any>;
+
+export { AiSupervisorNode, AiSupervisorNodeFunction, AiSupervisorNodeSchema, AiToolNode, AiToolNodeFunction, AiToolNodeSchema, type BaseNodeType, BodyFieldSchema, ChatLogNode, ChatLogNodeFunction, ChatLogSchema, CustomToolSchema, type ExecutionStep, GetOrCreateThreadNode, GetOrCreateThreadNodeFunction, GetOrCreateThreadSchema, HTTP_METHODS, HTTP_NODE_TYPES, HeaderSchema, HttpDeleteInputNode, HttpDeleteInputNodeFunction, HttpDeleteInputNodeSchema, type HttpDeleteInputNodeType, HttpGetInputNode, HttpGetInputNodeFunction, HttpGetInputNodeSchema, type HttpGetInputNodeType, type HttpMethod, type HttpNodeType, type HttpOutput, HttpPatchInputNode, HttpPatchInputNodeFunction, HttpPatchInputNodeSchema, type HttpPatchInputNodeType, HttpPostInputNode, HttpPostInputNodeFunction, HttpPostInputNodeSchema, type HttpPostInputNodeType, HttpPutInputNode, HttpPutInputNodeFunction, HttpPutInputNodeSchema, type HttpPutInputNodeType, IaAgentNode, IaAgentNodeFunction, IaAgentNodeSchema, IaMessageNode, IaMessageNodeFunction, IaMessageNodeSchema, type NodeData, type NodeDefinition, type NodeExecution, type NodeExecutionConfig, type NodeExecutionContext, type NodeField, type NodeHandle, type NodeInput, type NodeInputValue, type NodeLogicFunction, type NodeOutput, type NodeOutputValue, type NodeStyle, type NodeTags, type NodeTransformation, type NodeValidation, QueryParamSchema, RouteSchema, WhatsappMessageTriggerNode, WhatsappSendMessageFunction, WhatsappSendMessageNode, WhatsappSendMessageNodeSchema, WhatsappSendTemplateNode, WhatsappSendTemplateNodeSchema, WhatsappStartChatFunction, createMessageTemplate, extractHttpMethodFromNodeType, getHttpMethodFromFriendlyId, getHttpMethodFromNodeType, getHttpNodeTypeStrings, getHttpNodeTypesArray, getHttpNodesTypes, getMessageTemplates, isAnyHttpInputNode, isHttpInputFriendlyId, isHttpInputNode, isHttpMethodNode, nodeFunctions, nodes, schemas };

package/dist/index.js

@@ -1034,6 +1034,18 @@ async function createLLMFromModel(modelConfig, authToken, streaming = false) {
 }
 
 // src/utils/guardrail-executor.ts
+function emitGuardrailEvent(context, name, passed, action, details) {
+  if (context?.emitter?.emitThought) {
+    context.emitter.emitThought({
+      content: `guardrail:${passed ? "passed" : "failed"}:${name}`,
+      type: "guardrail",
+      name,
+      passed,
+      action: action || "evaluate",
+      details
+    });
+  }
+}
 async function loadChatHistory(context) {
   const checkpointer = context?.checkpointer;
   const sessionId = context?.sessionId;
@@ -1128,6 +1140,7 @@ async function executeGuardrails(guardrails, content, mode = "fail-first", conte
       if (!guardPassed && actionInstruction) {
         violationMessage = actionInstruction;
       }
+      emitGuardrailEvent(context, guard.name, guardPassed, guard.action, violationMessage || "Rule passed");
     } else if (guard.type === "function") {
       const { nodeFunction, name, actionInstruction } = guard;
       if (typeof nodeFunction === "function") {
@@ -1160,6 +1173,7 @@ async function executeGuardrails(guardrails, content, mode = "fail-first", conte
           guardPassed = false;
           violationMessage = `Erro na fun\xE7\xE3o guardrail: ${error instanceof Error ? error.message : String(error)}`;
         }
+        emitGuardrailEvent(context, name, guardPassed, guard.action, violationMessage || "Function passed");
       }
     } else if (guard.type === "model") {
       const { model, evaluationPrompt, name, actionInstruction } = guard;
@@ -1227,6 +1241,7 @@ Reescreva o conte\xFAdo corrigindo a viola\xE7\xE3o. Retorne APENAS o texto corr
                   message: violationMessage,
                   action: "fix"
                 });
+                emitGuardrailEvent(context, name, false, "fix", `Content fixed: ${fixedContent.slice(0, 100)}...`);
               } catch (fixError) {
                 console.error(`[GUARDRAIL LLM] Erro ao corrigir conte\xFAdo:`, fixError);
               }
@@ -1238,8 +1253,10 @@ Reescreva o conte\xFAdo corrigindo a viola\xE7\xE3o. Retorne APENAS o texto corr
               guardPassed = false;
               violationMessage = actionInstruction || `Modelo de avalia\xE7\xE3o "${name}" detectou viola\xE7\xE3o de seguran\xE7a/pol\xEDtica.`;
               console.log(`[GUARDRAIL LLM] Resultado: UNSAFE - Bloqueado`);
+              emitGuardrailEvent(context, name, false, guard.action, violationMessage);
             } else {
               console.log(`[GUARDRAIL LLM] Resultado: SAFE - Aprovado`);
+              emitGuardrailEvent(context, name, true, "approve", "Content passed evaluation");
             }
           }
         } catch (error) {
@@ -3217,6 +3234,335 @@ var ModelGuardrailNodeFunction = async (inputs) => {
   };
 };
 
+// src/nodes/chat/getOrCreateThread/data.ts
+import { z as z17 } from "zod";
+var GetOrCreateThreadSchema = z17.object({
+  source: z17.string().describe("Channel source: whatsapp, telegram, web, etc."),
+  identifier: z17.string().describe("User identifier: phone number, chat_id, userId"),
+  timeoutMinutes: z17.number().optional().describe("Inactivity timeout in minutes (default: 1440 = 24h)")
+});
+var GetOrCreateThreadNode = {
+  label: "Get or Create Thread",
+  type: "GetOrCreateThreadNode",
+  category: "chat",
+  description: "Generates or retrieves a threadId based on identifier + timeout. Ensures tenant isolation.",
+  icon: "\u{1F9F5}",
+  group: "Chat",
+  tags: {
+    execution: "async",
+    group: "Chat"
+  },
+  fields: [
+    {
+      id: "source",
+      label: "Source",
+      type: "string",
+      required: true,
+      defaultValue: "whatsapp",
+      placeholder: "whatsapp, telegram, web",
+      handle: {
+        type: "input",
+        label: "Source",
+        name: "source",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "identifier",
+      label: "Identifier",
+      type: "string",
+      required: true,
+      placeholder: "+5511999999999",
+      handle: {
+        type: "input",
+        label: "Identifier",
+        name: "identifier",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "timeoutMinutes",
+      label: "Timeout (minutes)",
+      type: "number",
+      required: false,
+      defaultValue: "1440",
+      placeholder: "1440 (24 hours)"
+    },
+    {
+      id: "threadId",
+      label: "Thread ID",
+      type: "string",
+      required: true,
+      typeable: false,
+      handle: {
+        type: "output",
+        label: "Thread ID",
+        name: "threadId",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "isNew",
+      label: "Is New Thread",
+      type: "boolean",
+      required: true,
+      typeable: false,
+      handle: {
+        type: "output",
+        label: "Is New",
+        name: "isNew",
+        fieldType: "boolean"
+      }
+    }
+  ]
+};
+
+// src/nodes/chat/getOrCreateThread/function.ts
+var GetOrCreateThreadNodeFunction = async (inputs) => {
+  const fieldValues = inputs.fieldValues || {};
+  const context = inputs.context || {};
+  const source = fieldValues.source;
+  const identifier = fieldValues.identifier;
+  const timeoutMinutes = Number(fieldValues.timeoutMinutes) || 1440;
+  const companyId = context?.companyId;
+  if (!companyId) {
+    throw new Error("GetOrCreateThread requires companyId in context for tenant isolation");
+  }
+  if (!source || !identifier) {
+    throw new Error("GetOrCreateThread requires source and identifier");
+  }
+  const timeoutMs = timeoutMinutes * 60 * 1e3;
+  const thresholdDate = new Date(Date.now() - timeoutMs);
+  const db = context?.db;
+  if (!db) {
+    throw new Error("GetOrCreateThread requires database connection in context");
+  }
+  try {
+    const existingSessions = await db.query(`
+            SELECT id, session_id, updated_at 
+            FROM chat_sessions 
+            WHERE company_id = $1 
+              AND metadata->>'source' = $2 
+              AND metadata->>'identifier' = $3
+              AND updated_at > $4
+            ORDER BY updated_at DESC
+            LIMIT 1
+        `, [companyId, source, identifier, thresholdDate]);
+    if (existingSessions.rows && existingSessions.rows.length > 0) {
+      const session = existingSessions.rows[0];
+      await db.query(`
+                UPDATE chat_sessions 
+                SET updated_at = NOW() 
+                WHERE id = $1 AND company_id = $2
+            `, [session.id, companyId]);
+      return {
+        threadId: session.session_id,
+        isNew: false
+      };
+    }
+    const newSessionId = crypto.randomUUID();
+    const workflowId = context?.workflowId;
+    await db.query(`
+            INSERT INTO chat_sessions (workflow_id, company_id, chat_id, session_id, metadata)
+            VALUES ($1, $2, $3, $4, $5)
+        `, [
+      workflowId || companyId,
+      // fallback to companyId if no workflowId
+      companyId,
+      `${source}:${identifier}`,
+      // chatId as composite key
+      newSessionId,
+      JSON.stringify({ source, identifier })
+    ]);
+    return {
+      threadId: newSessionId,
+      isNew: true
+    };
+  } catch (error) {
+    console.error("[GetOrCreateThread] Error:", error);
+    throw error;
+  }
+};
+
+// src/nodes/chat/chatLog/data.ts
+import { z as z18 } from "zod";
+var ChatLogSchema = z18.object({
+  threadId: z18.string().describe("Thread ID from GetOrCreateThread"),
+  direction: z18.enum(["inbound", "outbound"]).describe("Message direction"),
+  content: z18.string().describe("Message content"),
+  source: z18.string().optional().describe("Channel source"),
+  identifier: z18.string().optional().describe("User identifier"),
+  metadata: z18.record(z18.string(), z18.any()).optional().describe("Additional metadata")
+});
+var ChatLogNode = {
+  label: "Chat Log",
+  type: "ChatLogNode",
+  category: "chat",
+  description: "Saves a message to the chat history. Supports inbound (user) and outbound (assistant) messages.",
+  icon: "\u{1F4AC}",
+  group: "Chat",
+  tags: {
+    execution: "async",
+    group: "Chat"
+  },
+  fields: [
+    {
+      id: "threadId",
+      label: "Thread ID",
+      type: "string",
+      required: true,
+      placeholder: "From GetOrCreateThread node",
+      handle: {
+        type: "input",
+        label: "Thread ID",
+        name: "threadId",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "direction",
+      label: "Direction",
+      type: "select",
+      required: true,
+      defaultValue: "inbound",
+      options: [
+        { label: "Inbound (User \u2192 System)", value: "inbound" },
+        { label: "Outbound (System \u2192 User)", value: "outbound" }
+      ]
+    },
+    {
+      id: "content",
+      label: "Content",
+      type: "string",
+      required: true,
+      placeholder: "Message content",
+      handle: {
+        type: "input",
+        label: "Content",
+        name: "content",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "source",
+      label: "Source",
+      type: "string",
+      required: false,
+      defaultValue: "whatsapp",
+      placeholder: "whatsapp, telegram, web",
+      handle: {
+        type: "input",
+        label: "Source",
+        name: "source",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "identifier",
+      label: "Identifier",
+      type: "string",
+      required: false,
+      placeholder: "+5511999999999",
+      handle: {
+        type: "input",
+        label: "Identifier",
+        name: "identifier",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "messageId",
+      label: "Message ID",
+      type: "string",
+      required: true,
+      typeable: false,
+      handle: {
+        type: "output",
+        label: "Message ID",
+        name: "messageId",
+        fieldType: "string"
+      }
+    },
+    {
+      id: "success",
+      label: "Success",
+      type: "boolean",
+      required: true,
+      typeable: false,
+      handle: {
+        type: "output",
+        label: "Success",
+        name: "success",
+        fieldType: "boolean"
+      }
+    }
+  ]
+};
+
+// src/nodes/chat/chatLog/function.ts
+var ChatLogNodeFunction = async (inputs) => {
+  const fieldValues = inputs.fieldValues || {};
+  const context = inputs.context || {};
+  const threadId = fieldValues.threadId;
+  const direction = fieldValues.direction;
+  const content = fieldValues.content;
+  const source = fieldValues.source;
+  const identifier = fieldValues.identifier;
+  const companyId = context?.companyId;
+  if (!companyId) {
+    throw new Error("ChatLog requires companyId in context for tenant isolation");
+  }
+  if (!threadId || !content) {
+    throw new Error("ChatLog requires threadId and content");
+  }
+  const role = direction === "inbound" ? "user" : "assistant";
+  const db = context?.db;
+  if (!db) {
+    throw new Error("ChatLog requires database connection in context");
+  }
+  try {
+    const sessionResult = await db.query(`
+            SELECT id FROM chat_sessions 
+            WHERE session_id = $1 AND company_id = $2
+            LIMIT 1
+        `, [threadId, companyId]);
+    if (!sessionResult.rows || sessionResult.rows.length === 0) {
+      throw new Error(`Session not found for threadId: ${threadId}`);
+    }
+    const sessionId = sessionResult.rows[0].id;
+    const messageId = crypto.randomUUID();
+    await db.query(`
+            INSERT INTO chat_messages (id, session_id, role, content, metadata)
+            VALUES ($1, $2, $3, $4, $5)
+        `, [
+      messageId,
+      sessionId,
+      role,
+      content,
+      JSON.stringify({
+        direction,
+        source: source || null,
+        identifier: identifier || null
+      })
+    ]);
+    await db.query(`
+            UPDATE chat_sessions 
+            SET updated_at = NOW() 
+            WHERE id = $1 AND company_id = $2
+        `, [sessionId, companyId]);
+    return {
+      messageId,
+      success: true
+    };
+  } catch (error) {
+    console.error("[ChatLog] Error:", error);
+    return {
+      messageId: null,
+      success: false
+    };
+  }
+};
+
 // src/nodes/consts/nodes.ts
 var nodes = [
   ChatInputNode,
@@ -3243,7 +3589,9 @@ var nodes = [
   PromptGuardrailNode,
   RuleGuardrailNode,
   FunctionGuardrailNode,
-  ModelGuardrailNode
+  ModelGuardrailNode,
+  GetOrCreateThreadNode,
+  ChatLogNode
 ];
 var nodes_default = nodes;
 
@@ -3365,7 +3713,9 @@ var nodeFunctions = {
   PromptGuardrailNode: PromptGuardrailNodeFunction,
   RuleGuardrailNode: RuleGuardrailNodeFunction,
   FunctionGuardrailNode: FunctionGuardrailNodeFunction,
-  ModelGuardrailNode: ModelGuardrailNodeFunction
+  ModelGuardrailNode: ModelGuardrailNodeFunction,
+  GetOrCreateThreadNode: GetOrCreateThreadNodeFunction,
+  ChatLogNode: ChatLogNodeFunction
 };
 var node_functions_default = nodeFunctions;
 
@@ -3479,12 +3829,12 @@ var HttpPutInputNodeFunction = (params) => {
 };
 
 // src/nodes/inputs/http/put/schema.ts
-import { z as z17 } from "zod";
-var HttpPutInputNodeSchema = z17.object({
+import { z as z19 } from "zod";
+var HttpPutInputNodeSchema = z19.object({
   route: RouteSchema,
-  queryParams: z17.array(QueryParamSchema).optional().describe("Query parameters configuration"),
-  headers: z17.array(HeaderSchema).optional().describe("Headers configuration"),
-  body: z17.array(BodyFieldSchema).optional().describe("Body fields configuration")
+  queryParams: z19.array(QueryParamSchema).optional().describe("Query parameters configuration"),
+  headers: z19.array(HeaderSchema).optional().describe("Headers configuration"),
+  body: z19.array(BodyFieldSchema).optional().describe("Body fields configuration")
 });
 
 // src/nodes/inputs/http/delete/data.ts
@@ -3576,11 +3926,11 @@ var HttpDeleteInputNodeFunction = async (params) => {
 };
 
 // src/nodes/inputs/http/delete/schema.ts
-import { z as z18 } from "zod";
-var HttpDeleteInputNodeSchema = z18.object({
+import { z as z20 } from "zod";
+var HttpDeleteInputNodeSchema = z20.object({
   route: RouteSchema,
-  queryParams: z18.array(QueryParamSchema).optional().describe("Query parameters configuration"),
-  headers: z18.array(HeaderSchema).optional().describe("Headers configuration")
+  queryParams: z20.array(QueryParamSchema).optional().describe("Query parameters configuration"),
+  headers: z20.array(HeaderSchema).optional().describe("Headers configuration")
 });
 
 // src/nodes/inputs/http/patch/data.ts
@@ -3693,12 +4043,12 @@ var HttpPatchInputNodeFunction = (params) => {
 };
 
 // src/nodes/inputs/http/patch/schema.ts
-import { z as z19 } from "zod";
-var HttpPatchInputNodeSchema = z19.object({
+import { z as z21 } from "zod";
+var HttpPatchInputNodeSchema = z21.object({
   route: RouteSchema,
-  queryParams: z19.array(QueryParamSchema).optional().describe("Query parameters configuration"),
-  headers: z19.array(HeaderSchema).optional().describe("Headers configuration"),
-  body: z19.array(BodyFieldSchema).optional().describe("Body fields configuration")
+  queryParams: z21.array(QueryParamSchema).optional().describe("Query parameters configuration"),
+  headers: z21.array(HeaderSchema).optional().describe("Headers configuration"),
+  body: z21.array(BodyFieldSchema).optional().describe("Body fields configuration")
 });
 
 // src/nodes/inputs/http/utils.ts
@@ -3757,7 +4107,13 @@ export {
   AiToolNodeFunction,
   AiToolNodeSchema,
   BodyFieldSchema,
+  ChatLogNode,
+  ChatLogNodeFunction,
+  ChatLogSchema,
   CustomToolSchema,
+  GetOrCreateThreadNode,
+  GetOrCreateThreadNodeFunction,
+  GetOrCreateThreadSchema,
   HTTP_METHODS,
   HTTP_NODE_TYPES,
   HeaderSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@atomoz/workflows-nodes",
-    "version": "0.1.27",
+    "version": "0.1.28",
     "description": "Atomoz Workflows - Node Library",
     "type": "module",
     "main": "./dist/index.js",