@minded-ai/mindedjs 1.0.78-beta-2 → 1.0.78

package/dist/nodes/addTriggerNode.js

@@ -4,7 +4,7 @@ exports.addTriggerNode = void 0;
 const logger_1 = require("../utils/logger");
 const addTriggerNode = async ({ graph, node }) => {
     const callback = async () => {
-        logger_1.logger.info(`Executing trigger node ${node.displayName}`);
+        logger_1.logger.info(`Executing trigger node ${node.name}`);
         return;
     };
     graph.addNode(node.name, callback);

package/dist/nodes/addTriggerNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"addTriggerNode.js","sourceRoot":"","sources":["../../src/nodes/addTriggerNode.ts"],"names":[],"mappings":";;;AAGA,4CAAyC;AAElC,MAAM,cAAc,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAkD,EAAE,EAAE;IACtG,MAAM,QAAQ,GAAiB,KAAK,IAAI,EAAE;QACxC,eAAM,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC,CAAC;AAPW,QAAA,cAAc,kBAOzB"}
+{"version":3,"file":"addTriggerNode.js","sourceRoot":"","sources":["../../src/nodes/addTriggerNode.ts"],"names":[],"mappings":";;;AAGA,4CAAyC;AAElC,MAAM,cAAc,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAkD,EAAE,EAAE;IACtG,MAAM,QAAQ,GAAiB,KAAK,IAAI,EAAE;QACxC,eAAM,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,OAAO;IACT,CAAC,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC,CAAC;AAPW,QAAA,cAAc,kBAOzB"}

package/dist/types/Agent.types.d.ts

@@ -23,31 +23,22 @@ export interface AgentInvokeParams {
     /** Optional name of the application triggering the agent in case of an app trigger */
     appName?: string;
 }
-export declare enum FlowHistoryStepType {
-    APP_TRIGGER_NODE = "appTriggerNode",
-    TRIGGER_NODE = "triggerNode",
-    APP_ACTION_NODE = "appActionNode",
-    CUSTOM_ACTION_NODE = "customActionNode",
-    PROMPT_NODE = "promptNode"
+export declare enum FlowHistoryType {
+    TRIGGER_INVOCATION = "triggerInvocation",
+    APP_ACTION_INVOCATION = "appActionInvocation"
 }
-export interface HistoryStep {
-    type: FlowHistoryStepType;
-    step: number;
-    raw: any;
-    nodeId: string;
-    nodeDisplayName: string;
-    messageId?: string;
+export interface FlowHistory {
+    type: FlowHistoryType;
 }
-export interface TrigggerHistoryStep extends HistoryStep {
-    type: FlowHistoryStepType.APP_TRIGGER_NODE;
-    appName: string;
-}
-export interface AppActionInvocationHistoryStep extends HistoryStep {
-    type: FlowHistoryStepType.APP_ACTION_NODE;
-    appName: string;
+export interface TriggerInvocationHistory extends FlowHistory {
+    type: FlowHistoryType.TRIGGER_INVOCATION;
+    appName?: string;
+    triggerName: string;
+    triggerBody: any;
 }
-export interface CustomActionInvocationHistoryStep extends HistoryStep {
-    type: FlowHistoryStepType.CUSTOM_ACTION_NODE;
+export interface AppActionInvocationHistory extends FlowHistory {
+    type: FlowHistoryType.APP_ACTION_INVOCATION;
+    nodeTitle: string;
 }
 export declare enum SessionType {
     VOICE = "voice",

package/dist/types/Agent.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Agent.types.d.ts","sourceRoot":"","sources":["../../src/types/Agent.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,aAAa,CAAC,MAAM,EAAE,CAAC,SAAS,MAAM,yBAAyB,CAAC,MAAM,CAAC,IAAI,CACrF,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAC1C,OAAO,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,WAAW,EAAE,GAAG,CAAC;IACjB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,oBAAY,mBAAmB;IAC7B,gBAAgB,mBAAmB;IACnC,YAAY,gBAAgB;IAC5B,eAAe,kBAAkB;IACjC,kBAAkB,qBAAqB;IACvC,WAAW,eAAe;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,IAAI,EAAE,mBAAmB,CAAC,gBAAgB,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,8BAA+B,SAAQ,WAAW;IACjE,IAAI,EAAE,mBAAmB,CAAC,eAAe,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iCAAkC,SAAQ,WAAW;IACpE,IAAI,EAAE,mBAAmB,CAAC,kBAAkB,CAAC;CAC9C;AAED,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,IAAI,SAAS;CACd"}
+{"version":3,"file":"Agent.types.d.ts","sourceRoot":"","sources":["../../src/types/Agent.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,aAAa,CAAC,MAAM,EAAE,CAAC,SAAS,MAAM,yBAAyB,CAAC,MAAM,CAAC,IAAI,CACrF,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAC1C,OAAO,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,WAAW,EAAE,GAAG,CAAC;IACjB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,oBAAY,eAAe;IACzB,kBAAkB,sBAAsB;IACxC,qBAAqB,wBAAwB;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,IAAI,EAAE,eAAe,CAAC,kBAAkB,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,0BAA2B,SAAQ,WAAW;IAC7D,IAAI,EAAE,eAAe,CAAC,qBAAqB,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,IAAI,SAAS;CACd"}

package/dist/types/Agent.types.js

@@ -1,14 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionType = exports.FlowHistoryStepType = void 0;
-var FlowHistoryStepType;
-(function (FlowHistoryStepType) {
-    FlowHistoryStepType["APP_TRIGGER_NODE"] = "appTriggerNode";
-    FlowHistoryStepType["TRIGGER_NODE"] = "triggerNode";
-    FlowHistoryStepType["APP_ACTION_NODE"] = "appActionNode";
-    FlowHistoryStepType["CUSTOM_ACTION_NODE"] = "customActionNode";
-    FlowHistoryStepType["PROMPT_NODE"] = "promptNode";
-})(FlowHistoryStepType || (exports.FlowHistoryStepType = FlowHistoryStepType = {}));
+exports.SessionType = exports.FlowHistoryType = void 0;
+var FlowHistoryType;
+(function (FlowHistoryType) {
+    FlowHistoryType["TRIGGER_INVOCATION"] = "triggerInvocation";
+    FlowHistoryType["APP_ACTION_INVOCATION"] = "appActionInvocation";
+})(FlowHistoryType || (exports.FlowHistoryType = FlowHistoryType = {}));
+;
 var SessionType;
 (function (SessionType) {
     SessionType["VOICE"] = "voice";

package/dist/types/Agent.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Agent.types.js","sourceRoot":"","sources":["../../src/types/Agent.types.ts"],"names":[],"mappings":";;;AAgCA,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,0DAAmC,CAAA;IACnC,mDAA4B,CAAA;IAC5B,wDAAiC,CAAA;IACjC,8DAAuC,CAAA;IACvC,iDAA0B,CAAA;AAC5B,CAAC,EANW,mBAAmB,mCAAnB,mBAAmB,QAM9B;AAyBD,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,4BAAa,CAAA;AACf,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB"}
+{"version":3,"file":"Agent.types.js","sourceRoot":"","sources":["../../src/types/Agent.types.ts"],"names":[],"mappings":";;;AAgCA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,2DAAwC,CAAA;IACxC,gEAA6C,CAAA;AAC/C,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B;AAgBA,CAAC;AAEF,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,4BAAa,CAAA;AACf,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB"}

package/dist/types/Flows.types.d.ts

@@ -22,7 +22,7 @@ export interface BaseNode {
     position?: Position;
     humanInTheLoop?: boolean;
     canStayOnNode?: boolean;
-    displayName: string;
+    displayName?: string;
 }
 export declare enum TriggerType {
     APP = "app",

package/dist/types/Flows.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Flows.types.d.ts","sourceRoot":"","sources":["../../src/types/Flows.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Flows.types.d.ts","sourceRoot":"","sources":["../../src/types/Flows.types.ts"],"names":[],"mappings":"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"}

package/dist/types/LangGraph.types.d.ts

@@ -1,17 +1,59 @@
 import { BaseMessage } from '@langchain/core/messages';
 import { CompiledStateGraph, StateGraph } from '@langchain/langgraph';
-import { HistoryStep, SessionType } from './Agent.types';
+import { FlowHistory, SessionType, TriggerInvocationHistory } from './Agent.types';
 export declare const createStateAnnotation: <Memory = any>() => import("@langchain/langgraph").AnnotationRoot<{
     messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
     memory: import("@langchain/langgraph").BinaryOperatorAggregate<Memory, Memory>;
-    history: import("@langchain/langgraph").BinaryOperatorAggregate<HistoryStep[], HistoryStep[]>;
+    triggerInvocations: import("@langchain/langgraph").BinaryOperatorAggregate<TriggerInvocationHistory[], TriggerInvocationHistory[]>;
+    triggerMetadata: {
+        (): import("@langchain/langgraph").LastValue<{
+            name: string;
+            triggerBody: any;
+        } | null>;
+        (annotation: import("@langchain/langgraph").SingleReducer<{
+            name: string;
+            triggerBody: any;
+        } | null, {
+            name: string;
+            triggerBody: any;
+        } | null>): import("@langchain/langgraph").BinaryOperatorAggregate<{
+            name: string;
+            triggerBody: any;
+        } | null, {
+            name: string;
+            triggerBody: any;
+        } | null>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    history: import("@langchain/langgraph").BinaryOperatorAggregate<FlowHistory[], FlowHistory[]>;
     sessionId: import("@langchain/langgraph").LastValue<string>;
     sessionType: import("@langchain/langgraph").BinaryOperatorAggregate<SessionType, SessionType>;
 }>;
 export declare const stateAnnotation: import("@langchain/langgraph").AnnotationRoot<{
     messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
     memory: import("@langchain/langgraph").BinaryOperatorAggregate<any, any>;
-    history: import("@langchain/langgraph").BinaryOperatorAggregate<HistoryStep[], HistoryStep[]>;
+    triggerInvocations: import("@langchain/langgraph").BinaryOperatorAggregate<TriggerInvocationHistory[], TriggerInvocationHistory[]>;
+    triggerMetadata: {
+        (): import("@langchain/langgraph").LastValue<{
+            name: string;
+            triggerBody: any;
+        } | null>;
+        (annotation: import("@langchain/langgraph").SingleReducer<{
+            name: string;
+            triggerBody: any;
+        } | null, {
+            name: string;
+            triggerBody: any;
+        } | null>): import("@langchain/langgraph").BinaryOperatorAggregate<{
+            name: string;
+            triggerBody: any;
+        } | null, {
+            name: string;
+            triggerBody: any;
+        } | null>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    history: import("@langchain/langgraph").BinaryOperatorAggregate<FlowHistory[], FlowHistory[]>;
     sessionId: import("@langchain/langgraph").LastValue<string>;
     sessionType: import("@langchain/langgraph").BinaryOperatorAggregate<SessionType, SessionType>;
 }>;

package/dist/types/LangGraph.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LangGraph.types.d.ts","sourceRoot":"","sources":["../../src/types/LangGraph.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAc,kBAAkB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEzD,eAAO,MAAM,qBAAqB,GAAI,MAAM,GAAG,GAAG;;;;;;EAgC9C,CAAC;AAGL,eAAO,MAAM,eAAe;;;;;;EAA0B,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC"}
+{"version":3,"file":"LangGraph.types.d.ts","sourceRoot":"","sources":["../../src/types/LangGraph.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAc,kBAAkB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEnF,eAAO,MAAM,qBAAqB,GAAI,MAAM,GAAG,GAAG;;;;;;kBA4BtC,MAAM;yBACC,GAAG;;;kBADV,MAAM;yBACC,GAAG;;kBADV,MAAM;yBACC,GAAG;;kBADV,MAAM;yBACC,GAAG;;kBADV,MAAM;yBACC,GAAG;;;;;;;EAWlB,CAAC;AAGL,eAAO,MAAM,eAAe;;;;;;kBAfhB,MAAM;yBACC,GAAG;;;kBADV,MAAM;yBACC,GAAG;;kBADV,MAAM;yBACC,GAAG;;kBADV,MAAM;yBACC,GAAG;;kBADV,MAAM;yBACC,GAAG;;;;;;;EAcgC,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC"}

package/dist/types/LangGraph.types.js

@@ -27,6 +27,11 @@ const createStateAnnotation = () => langgraph_1.Annotation.Root({
         default: () => ({}),
         reducer: (a, b) => ({ ...a, ...b }),
     }),
+    triggerInvocations: (0, langgraph_1.Annotation)({
+        default: () => [],
+        reducer: (a, b) => a.concat(b),
+    }),
+    triggerMetadata: (langgraph_1.Annotation),
     history: (0, langgraph_1.Annotation)({
         default: () => [],
         reducer: (a, b) => a.concat(b),

package/dist/types/LangGraph.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"LangGraph.types.js","sourceRoot":"","sources":["../../src/types/LangGraph.types.ts"],"names":[],"mappings":";;;AACA,oDAAkF;AAClF,+CAAyD;AAElD,MAAM,qBAAqB,GAAG,GAAiB,EAAE,CACtD,sBAAU,CAAC,IAAI,CAAC;IACd,QAAQ,EAAE,IAAA,sBAAU,EAAqB;QACvC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;QACjB,OAAO,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE;;YACrC,MAAM,GAAG,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;YAC9B,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;gBAClC,IAAI,MAAA,OAAO,CAAC,iBAAiB,0CAAE,MAAM,EAAE,CAAC;oBACtC,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;oBAChE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;wBACjB,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;oBACvC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC;IACF,MAAM,EAAE,IAAA,sBAAU,EAAS;QACzB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAa,CAAA;QAC7B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;KACpC,CAAC;IACF,OAAO,EAAE,IAAA,sBAAU,EAAqB;QACtC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;KAC/B,CAAC;IACF,SAAS,EAAE,IAAA,sBAAU,GAAU;IAC/B,WAAW,EAAE,IAAA,sBAAU,EAAc;QACnC,OAAO,EAAE,GAAG,EAAE,CAAC,yBAAW,CAAC,IAAI;QAC/B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;KAC1B,CAAC;CACH,CAAC,CAAC;AAhCQ,QAAA,qBAAqB,yBAgC7B;AAEL,gDAAgD;AACnC,QAAA,eAAe,GAAG,IAAA,6BAAqB,GAAE,CAAC"}
+{"version":3,"file":"LangGraph.types.js","sourceRoot":"","sources":["../../src/types/LangGraph.types.ts"],"names":[],"mappings":";;;AACA,oDAAkF;AAClF,+CAAmF;AAE5E,MAAM,qBAAqB,GAAG,GAAiB,EAAE,CACtD,sBAAU,CAAC,IAAI,CAAC;IACd,QAAQ,EAAE,IAAA,sBAAU,EAAqB;QACvC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;QACjB,OAAO,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE;;YACrC,MAAM,GAAG,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;YAC9B,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;gBAClC,IAAI,MAAA,OAAO,CAAC,iBAAiB,0CAAE,MAAM,EAAE,CAAC;oBACtC,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;oBAChE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;wBACjB,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;oBACvC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC;IACF,MAAM,EAAE,IAAA,sBAAU,EAAS;QACzB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAa,CAAA;QAC7B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;KACpC,CAAC;IACF,kBAAkB,EAAE,IAAA,sBAAU,EAAkC;QAC9D,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;KAC/B,CAAC;IACF,eAAe,EAAE,CAAA,sBAGR,CAAA;IACT,OAAO,EAAE,IAAA,sBAAU,EAAqB;QACtC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;KAC/B,CAAC;IACF,SAAS,EAAE,IAAA,sBAAU,GAAU;IAC/B,WAAW,EAAE,IAAA,sBAAU,EAAc;QACnC,OAAO,EAAE,GAAG,EAAE,CAAC,yBAAW,CAAC,IAAI;QAC/B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;KAC1B,CAAC;CACH,CAAC,CAAC;AAxCQ,QAAA,qBAAqB,yBAwC7B;AAEL,gDAAgD;AACnC,QAAA,eAAe,GAAG,IAAA,6BAAqB,GAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minded-ai/mindedjs",
-  "version": "1.0.78-beta-2",
+  "version": "1.0.78",
   "description": "MindedJS is a TypeScript library for building agents.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/agent.ts

@@ -15,7 +15,7 @@ import { InvokeMessage, MindedConnectionSocketMessageType } from './platform/min
 import * as fs from 'fs';
 import * as path from 'path';
 import * as yaml from 'js-yaml';
-import { AgentInvokeParams, FlowHistoryStepType, MindedSDKConfig, SessionType } from './types/Agent.types';
+import { AgentInvokeParams, FlowHistoryType, MindedSDKConfig, SessionType, TriggerInvocationHistory } from './types/Agent.types';
 import { createLlmInstance } from './llm/createLlmInstance';
 import { createCheckpointSaver } from './checkpointer/checkpointSaverFactory';
 import { getConfig } from './platform/config';
@@ -315,7 +315,9 @@ export class Agent {
     return {
       messages: [],
       memory: {} as z.infer<typeof this.memorySchema>,
+      triggerMetadata: null,
       history: [],
+      triggerInvocations: [] as Array<TriggerInvocationHistory>,
       sessionId: state.sessionId || uuidv4(), // Preserve existing sessionId or generate new one
       sessionType: state.sessionType || SessionType.TEXT,
     };
@@ -390,7 +392,7 @@ export class Agent {
     const triggerInvocation = { appName, triggerName, triggerBody };
     const history = [
       {
-        type: FlowHistoryStepType.APP_TRIGGER_NODE,
+        type: FlowHistoryType.TRIGGER_INVOCATION,
         ...triggerInvocation,
       },
     ];
@@ -402,16 +404,155 @@ export class Agent {
     if (state.tasks?.[0]?.interrupts?.length > 0) {
       res = await this.compiledGraph.invoke(
         new Command({
-          resume: { memory: memoryUpdate, messages, history, sessionId, sessionType },
+          resume: { memory: memoryUpdate, messages, history, triggerInvocations: [triggerInvocation], sessionId, sessionType },
         }),
         langraphConfig,
       );
     } else {
-      res = await this.compiledGraph.invoke({ messages, memory: memoryUpdate, history, sessionId, sessionType }, langraphConfig);
+      res = await this.compiledGraph.invoke(
+        { messages, memory: memoryUpdate, history, triggerInvocations: [triggerInvocation], sessionId, sessionType },
+        langraphConfig,
+      );
     }
     return res;
   }
 
+  /**
+   * Register an event handler for specific agent events.
+   *
+   * This method allows you to listen for and respond to various events that occur during
+   * agent execution, such as trigger events, memory updates, or custom application events.
+   * Multiple handlers can be registered for the same event type and will be executed in the order they are registered.
+   *
+   * ## Available Event Types
+   *
+   * ### AI_MESSAGE
+   * Emitted when an AI generates a message that should be sent to the user.
+   *
+   * **Input Structure:**
+   * ```typescript
+   * {
+   *   message: string;     // The AI-generated message content
+   *   state: {             // Full agent state
+   *     messages: BaseMessage[];           // Conversation messages
+   *     memory: Memory;                    // Current memory state (your defined memory schema)
+   *     triggerInvocations: Array<...>;    // Trigger invocation history
+   *     triggerMetadata: {...} | null;     // Current trigger metadata
+   *     history: FlowHistory[];            // Flow execution history
+   *     sessionId: string;                 // Session identifier
+   *   }
+   * }
+   * ```
+   *
+   * **Expected Output:** `void` - Handlers are used for side effects like sending messages to UI
+   *
+   * **Common Use Cases:**
+   * - Real-time chat UI updates with session context
+   * - Logging AI responses for analytics or debugging
+   * - Message formatting and transformation
+   * - Notifications and alerts based on AI responses
+   * - Session-based message routing
+   *
+   * ### TRIGGER_EVENT
+   * Emitted when a trigger node is executed. Allows you to qualify, transform, and provide
+   * initial state for trigger inputs before they're processed by the agent.
+   *
+   * **Input Structure:**
+   * ```typescript
+   * {
+   *   triggerName: string;  // Name of the trigger being executed
+   *   triggerBody: any;     // The trigger input data (type varies by trigger)
+   * }
+   * ```
+   *
+   * **Expected Output:** One of three possible return types:
+   *
+   * 1. **Provide Initial State:**
+   * ```typescript
+   * {
+   *   messages?: BaseMessage[];  // Initial messages for the conversation
+   *   memory?: Memory;          // Initial memory state
+   *   sessionId?: string;       // Session ID for persistence (resumes existing sessions)
+   * }
+   * ```
+   *
+   * 2. **Disqualify the Trigger:**
+   * ```typescript
+   * false  // Rejects/disqualifies the trigger from processing
+   * ```
+   *
+   * 3. **Qualify without Initial State:**
+   * ```typescript
+   * void  // Qualifies the trigger but provides no initial state
+   * ```
+   *
+   * **Common Use Cases:**
+   * - Input validation and trigger qualification
+   * - Data transformation into standardized formats
+   * - Context setting with initial memory state
+   * - Access control and business rule enforcement
+   * - Routing logic for different trigger types
+   *
+   * @template E - The event type, constrained to known agent event types
+   * @param event - The name of the event to listen for
+   * @param handler - The function to call when the event is emitted
+   *
+   * @example
+   * ```typescript
+   * // AI_MESSAGE Event Handler
+   * agent.on('AI_MESSAGE', async ({ message, state }) => {
+   *   logger.info({ msg: 'AI said:', output: message });
+   *   logger.info({ msg: 'Current memory:', output: state.memory });
+   *   logger.info({ msg: 'Session ID:', output: state.sessionId });
+   *
+   *   // Send to user interface with session context
+   *   await sendMessageToUser(message, state.sessionId);
+   *
+   *   // Send via WebSocket
+   *   await websocket.send(JSON.stringify({
+   *     type: 'ai_message',
+   *     content: message,
+   *     sessionId: state.sessionId,
+   *     memory: state.memory
+   *   }));
+   * });
+   *
+   * // TRIGGER_EVENT Event Handler - Input Validation
+   * agent.on('TRIGGER_EVENT', async ({ triggerName, triggerBody }) => {
+   *   // Validate trigger input
+   *   if (!isValidInput(triggerBody)) {
+   *     return false; // Disqualify the trigger
+   *   }
+   *
+   *   // Business hours check
+   *   if (triggerName === 'supportRequest' && !isBusinessHours()) {
+   *     return false;
+   *   }
+   *
+   *   return {
+   *     memory: { validatedInput: triggerBody },
+   *     messages: [new HumanMessage('Support request received')],
+   *     sessionId: triggerBody.userId // Resume existing session
+   *   };
+   * });
+   *
+   * // TRIGGER_EVENT Event Handler - Data Transformation
+   * agent.on('TRIGGER_EVENT', async ({ triggerName, triggerBody }) => {
+   *   if (triggerName === 'emailTrigger') {
+   *     // Transform email data into structured format
+   *     const parsedEmail = parseEmailContent(triggerBody);
+   *
+   *     return {
+   *       memory: {
+   *         emailSubject: parsedEmail.subject,
+   *         senderEmail: parsedEmail.from
+   *       },
+   *       messages: [new HumanMessage(parsedEmail.content)],
+   *     };
+   *   }
+   * });
+   * ```
+   */
   // Public API for registering event listeners
   public on<E extends keyof AgentEventRequestPayloads<z.infer<typeof this.memorySchema>>>(
     event: E,
@@ -445,7 +586,7 @@ export class Agent {
     }
     return this.flows
       .flatMap((flow) => flow.nodes.filter((node) => node.type === NodeType.APP_TOOL))
-      .map((node) => appActionRunnerToolCreator(node.metadata.schema, node.name, this.mindedConnection as MindedConnection));
+      .map((node) => appActionRunnerToolCreator(node.metadata.schema, node.displayName!, this.mindedConnection as MindedConnection));
   }
 
   // Private method to get secrets from the backend service and load them into environment variables

package/src/events/AgentEvents.ts

@@ -1,5 +1,5 @@
 import { BaseMessage } from '@langchain/core/messages';
-import { HistoryStep } from '../types/Agent.types';
+import { FlowHistory } from '../types/Agent.types';
 import { createStateAnnotation } from '../types/LangGraph.types';
 
 export enum AgentEvents {
@@ -28,7 +28,7 @@ export type AgentEventResponsePayloads<Memory> = {
     isQualified: boolean;
     messages?: BaseMessage[];
     memory?: Memory;
-    history?: HistoryStep[];
+    history?: FlowHistory[];
     sessionId?: string;
   };
 };

package/src/index.ts

@@ -35,14 +35,7 @@ export {
   KnownTriggerNames,
 } from './types/Flows.types';
 export type { Tool, ToolExecuteInput } from './types/Tools.types';
-export {
-  FlowHistoryStepType,
-  HistoryStep,
-  TrigggerHistoryStep,
-  AppActionInvocationHistoryStep,
-  CustomActionInvocationHistoryStep,
-  SessionType,
-} from './types/Agent.types';
+export { FlowHistoryType, FlowHistory, TriggerInvocationHistory, AppActionInvocationHistory, SessionType } from './types/Agent.types';
 export type { AgentInvokeParams, MindedSDKConfig } from './types/Agent.types';
 export type { Environment } from './types/Platform.types';
 export type { State } from './types/LangGraph.types';

package/src/nodes/addAppToolNode.ts

@@ -6,11 +6,10 @@ import { RunnableLike } from '@langchain/core/runnables';
 import { z } from 'zod';
 import { LLMProviders } from '../types/LLM.types';
 import { getAppActionRunnerTool } from '../internalTools/appActionRunnerTool';
-import { AppActionInvocationHistoryStep, FlowHistoryStepType } from '../types/Agent.types';
+import { FlowHistoryType } from '../types/Agent.types';
 import { Agent } from '../agent';
 import { logger } from '../utils/logger';
 import { compilePlaybooks } from '../playbooks/playbooks';
-import { createHistoryStep } from '../utils/history';
 
 export const addAppToolNode = async ({
   graph,
@@ -24,7 +23,7 @@ export const addAppToolNode = async ({
   agent: Agent;
 }) => {
   const cleanedParameters = Object.fromEntries(Object.entries(node.parameters || {}).filter(([, value]) => value !== ''));
-  const appRunnerTool = getAppActionRunnerTool(node.name);
+  const appRunnerTool = getAppActionRunnerTool(node.displayName!);
   const callback: RunnableLike = async (state: typeof stateAnnotation.State) => {
     logger.info(`Executing tool node ${appRunnerTool.name}`);
 
@@ -77,13 +76,7 @@ export const addAppToolNode = async ({
     };
     return {
       messages: [AIToolCallMessage, toolCallMessage],
-      history: createHistoryStep<AppActionInvocationHistoryStep>(state.history, {
-        type: FlowHistoryStepType.APP_ACTION_NODE,
-        nodeId: node.name,
-        nodeDisplayName: node.displayName!,
-        raw: AIToolCallMessage.tool_calls[0],
-        appName: node.appName,
-      }),
+      history: [{ type: FlowHistoryType.APP_ACTION_INVOCATION, nodeTitle: node.displayName }],
     };
   };
   graph.addNode(node.name, callback);

package/src/nodes/addJumpToNode.ts

@@ -3,13 +3,19 @@ import { PreCompiledGraph } from '../types/LangGraph.types';
 import { JumpToNode } from '../types/Flows.types';
 import { logger } from '../utils/logger';
 
-export const addJumpToNode = async ({ graph, node }: { graph: PreCompiledGraph; node: JumpToNode }) => {
+export const addJumpToNode = async ({
+  graph,
+  node,
+}: {
+  graph: PreCompiledGraph;
+  node: JumpToNode;
+}) => {
   const callback: RunnableLike = async () => {
-    logger.info(`Executing jump node ${node.displayName} – jumping to ${node.targetNodeId}`);
+    logger.info(`Executing jump node ${node.name} – jumping to ${node.targetNodeId}`);
     // No state modifications are necessary; control flow is handled via edges.
     return;
   };
 
   graph.addNode(node.name, callback);
   graph.addEdge(node.name as any, node.targetNodeId as any);
-};
+}; 

package/src/nodes/addPromptNode.ts

@@ -7,13 +7,12 @@ import { SystemMessage, AIMessage, ToolMessage } from '@langchain/core/messages'
 import { Tool } from '../types/Tools.types';
 import { tool as langchainTool } from '@langchain/core/tools';
 import { AgentEventRequestPayloads, AgentEvents } from '../events/AgentEvents';
-import { EmitSignature, FlowHistoryStepType, HistoryStep } from '../types/Agent.types';
+import { EmitSignature } from '../types/Agent.types';
 import { createLlmInstance } from '../llm/createLlmInstance';
 import extractToolStateResponse from '../utils/extractStateMemoryResponse';
 import { Agent } from '../agent';
 import { logger } from '../utils/logger';
 import { compilePlaybooks } from '../playbooks/playbooks';
-import { createHistoryStep } from '../utils/history';
 
 type AddPromptNodeParams = {
   graph: PreCompiledGraph;
@@ -26,7 +25,7 @@ type AddPromptNodeParams = {
 
 export const addPromptNode = async ({ graph, node, llm, tools, emit, agent }: AddPromptNodeParams) => {
   const callback: RunnableLike = async (state: typeof stateAnnotation.State) => {
-    logger.info(`Executing prompt node ${node.displayName}`);
+    logger.info(`Executing prompt node ${node.name}`);
     const llmToUse = node.llmConfig ? createLlmInstance(node.llmConfig) : llm;
 
     const globalTools = tools
@@ -99,13 +98,6 @@ export const addPromptNode = async ({ graph, node, llm, tools, emit, agent }: Ad
     }
 
     return {
-      history: createHistoryStep<HistoryStep>(state.history, {
-        type: FlowHistoryStepType.PROMPT_NODE,
-        nodeId: node.name,
-        nodeDisplayName: node.displayName,
-        raw: result.content,
-        messageId: result.id,
-      }),
       messages: [result],
     };
   };

package/src/nodes/addToolNode.ts

@@ -28,9 +28,9 @@ export const addToolNode = async ({
     throw new Error(`Tool not found: ${toolNode.toolName}`);
   }
   const callback: RunnableLike = async (state: typeof stateAnnotation.State) => {
-    logger.info(`Executing tool node ${toolNode.displayName}`);
+    logger.info(`Executing tool node ${toolNode.name}`);
 
-    const tool = langchainTool(() => {}, {
+    const tool = langchainTool(() => { }, {
       name: matchedTool.name,
       description: matchedTool.description,
       schema: matchedTool.input,

package/src/nodes/addTriggerNode.ts

@@ -5,7 +5,7 @@ import { logger } from '../utils/logger';
 
 export const addTriggerNode = async ({ graph, node }: { graph: PreCompiledGraph; node: TriggerNode }) => {
   const callback: RunnableLike = async () => {
-    logger.info(`Executing trigger node ${node.displayName}`);
+    logger.info(`Executing trigger node ${node.name}`);
     return;
   };
 

package/src/types/Agent.types.ts

@@ -30,36 +30,26 @@ export interface AgentInvokeParams {
   appName?: string;
 }
 
-export enum FlowHistoryStepType {
-  APP_TRIGGER_NODE = 'appTriggerNode',
-  TRIGGER_NODE = 'triggerNode',
-  APP_ACTION_NODE = 'appActionNode',
-  CUSTOM_ACTION_NODE = 'customActionNode',
-  PROMPT_NODE = 'promptNode',
+export enum FlowHistoryType {
+  TRIGGER_INVOCATION = 'triggerInvocation',
+  APP_ACTION_INVOCATION = 'appActionInvocation',
 }
 
-export interface HistoryStep {
-  type: FlowHistoryStepType;
-  step: number;
-  raw: any;
-  nodeId: string;
-  nodeDisplayName: string;
-  messageId?: string;
+export interface FlowHistory {
+  type: FlowHistoryType;
 }
 
-export interface TrigggerHistoryStep extends HistoryStep {
-  type: FlowHistoryStepType.APP_TRIGGER_NODE;
-  appName: string;
-}
-
-export interface AppActionInvocationHistoryStep extends HistoryStep {
-  type: FlowHistoryStepType.APP_ACTION_NODE;
-  appName: string;
+export interface TriggerInvocationHistory extends FlowHistory {
+  type: FlowHistoryType.TRIGGER_INVOCATION;
+  appName?: string;
+  triggerName: string;
+  triggerBody: any;
 }
 
-export interface CustomActionInvocationHistoryStep extends HistoryStep {
-  type: FlowHistoryStepType.CUSTOM_ACTION_NODE;
-}
+export interface AppActionInvocationHistory extends FlowHistory {
+  type: FlowHistoryType.APP_ACTION_INVOCATION;
+  nodeTitle: string;
+};
 
 export enum SessionType {
   VOICE = 'voice',