@minded-ai/mindedjs 1.0.102 → 1.0.103-beta-2

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

@@ -5,7 +5,7 @@ export declare const createStateAnnotation: <Memory = any>() => import("@langcha
     messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
     memory: import("@langchain/langgraph").BinaryOperatorAggregate<Memory, Memory>;
     history: import("@langchain/langgraph").BinaryOperatorAggregate<HistoryStep[], HistoryStep[]>;
-    sessionId: import("@langchain/langgraph").LastValue<string>;
+    sessionId: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
     goto: import("@langchain/langgraph").BinaryOperatorAggregate<string | null | undefined, string | null | undefined>;
     sessionType: import("@langchain/langgraph").BinaryOperatorAggregate<SessionType, SessionType>;
     overrideStartFromNodeId: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
@@ -14,7 +14,7 @@ export declare const stateAnnotation: import("@langchain/langgraph").AnnotationR
     messages: import("@langchain/langgraph").BinaryOperatorAggregate<BaseMessage[], BaseMessage[]>;
     memory: import("@langchain/langgraph").BinaryOperatorAggregate<any, any>;
     history: import("@langchain/langgraph").BinaryOperatorAggregate<HistoryStep[], HistoryStep[]>;
-    sessionId: import("@langchain/langgraph").LastValue<string>;
+    sessionId: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
     goto: import("@langchain/langgraph").BinaryOperatorAggregate<string | null | undefined, string | null | undefined>;
     sessionType: import("@langchain/langgraph").BinaryOperatorAggregate<SessionType, SessionType>;
     overrideStartFromNodeId: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;

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;;;;;;;;EAyC9C,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,MAAM,eAAe,CAAC;AAEzD,eAAO,MAAM,qBAAqB,GAAI,MAAM,GAAG,GAAG;;;;;;;;EA2C9C,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"}

package/dist/types/LangGraph.types.js

@@ -32,7 +32,9 @@ const createStateAnnotation = () => langgraph_1.Annotation.Root({
         default: () => [],
         reducer: (a, b) => a.concat(b),
     }),
-    sessionId: (0, langgraph_1.Annotation)(),
+    sessionId: (0, langgraph_1.Annotation)({
+        reducer: (a, b) => b || a,
+    }),
     goto: (0, langgraph_1.Annotation)({
         default: () => null,
         reducer: (a, b) => 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;wBACrC,GAAG,CAAC,KAAK,CAAC,CAAC,iBAAiB,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,iBAAiB,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;oBACnG,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,IAAI,EAAE,IAAA,sBAAU,EAA4B;QAC1C,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;QACnB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;KACrB,CAAC;IACF,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;IACF,uBAAuB,EAAE,IAAA,sBAAU,EAAgB;QACjD,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;QACnB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;KACrB,CAAC;CACH,CAAC,CAAC;AAzCQ,QAAA,qBAAqB,yBAyC7B;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,+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;wBACrC,GAAG,CAAC,KAAK,CAAC,CAAC,iBAAiB,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,iBAAiB,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;oBACnG,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,EAAS;QAC5B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;KAC1B,CAAC;IACF,IAAI,EAAE,IAAA,sBAAU,EAA4B;QAC1C,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;QACnB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;KACrB,CAAC;IACF,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;IACF,uBAAuB,EAAE,IAAA,sBAAU,EAAgB;QACjD,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;QACnB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;KACrB,CAAC;CACH,CAAC,CAAC;AA3CQ,QAAA,qBAAqB,yBA2C7B;AAEL,gDAAgD;AACnC,QAAA,eAAe,GAAG,IAAA,6BAAqB,GAAE,CAAC"}

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM,uCAgBjB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM,uCAiBjB,CAAC"}

package/dist/utils/logger.js

@@ -17,6 +17,7 @@ exports.logger = (0, pino_1.default)({
             colorize: true,
             crlf: true,
             translateTime: 'SYS:standard',
+            messageKey: 'message', // Use 'message' instead of default 'msg'
         },
     },
     formatters: {

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,oDAA4B;AAC5B,gBAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,gDAAgD;AACnC,QAAA,MAAM,GAAG,IAAA,cAAI,EAAC;IACzB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO;IACvC,IAAI,EAAE,IAAI;IACV,SAAS,EAAE;QACT,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE;YACP,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,IAAI;YACV,aAAa,EAAE,cAAc;SAC9B;KACF;IACD,UAAU,EAAE;QACV,KAAK,CAAC,KAAK;YACT,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1B,CAAC;KACF;CACF,CAAC,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,oDAA4B;AAC5B,gBAAM,CAAC,MAAM,EAAE,CAAC;AAEhB,gDAAgD;AACnC,QAAA,MAAM,GAAG,IAAA,cAAI,EAAC;IACzB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO;IACvC,IAAI,EAAE,IAAI;IACV,SAAS,EAAE;QACT,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE;YACP,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,IAAI;YACV,aAAa,EAAE,cAAc;YAC7B,UAAU,EAAE,SAAS,EAAE,yCAAyC;SACjE;KACF;IACD,UAAU,EAAE;QACV,KAAK,CAAC,KAAK;YACT,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1B,CAAC;KACF;CACF,CAAC,CAAC"}

package/docs/getting-started/installation.md

@@ -35,48 +35,6 @@ pnpm add @minded-ai/mindedjs langchain
 {% endtab %}
 {% endtabs %}
 
-## Python dependencies
-
-
-### 1. Install uv
-
-First, install `uv` which includes the `uvx` command:
-
-```bash
-curl -LsSf https://astral.sh/uv/install.sh | sh
-```
-
-### 2. Install browser-use cli with uv
-
-```bash
-uv tool install 'browser-use[cli]'
-```
-
-### 3. Install Playwright Chromium browser
-
-After installing browser-use, you need to install the Chromium browser for Playwright:
-
-```bash
-playwright install chromium
-```
-
-This downloads the Chromium browser that browser-use uses to automate web interactions.
-
-### 4. Add uv to PATH
-
-After installation, add uv to your PATH:
-
-```bash
-# For immediate use
-source $HOME/.local/bin/env
-
-# For permanent access, add to your shell config:
-echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # or ~/.bashrc
-```
-
-{% endtab %}
-{% endtabs %}
-
 ## Next Steps
 
 Now that MindedJS is installed:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minded-ai/mindedjs",
-  "version": "1.0.102",
+  "version": "1.0.103-beta-2",
   "description": "MindedJS is a TypeScript library for building agents.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -66,4 +66,4 @@
     "uuid": "^11.1.0",
     "ws": "^8.15.1"
   }
-}
+}

package/src/agent.ts

@@ -26,6 +26,8 @@ import {
 import { createLlmInstance } from './llm/createLlmInstance';
 import { createCheckpointSaver } from './checkpointer/checkpointSaverFactory';
 import { getConfig } from './platform/config';
+import { InterruptSessionManager, InterruptType } from './interrupts/BaseInterruptSessionManager';
+import { createInterruptSessionManager } from './interrupts/interruptSessionManagerFactory';
 import { BaseMessage, HumanMessage } from '@langchain/core/messages';
 import triggerTypeToDefaultMessage from './triggers/triggerTypeToDefaultMessage';
 import appActionRunnerToolCreator from './internalTools/appActionRunnerTool';
@@ -43,6 +45,7 @@ type CreateAgentParams<Memory> = {
   tools: Tool<any, Memory>[];
   platformToken?: string;
   memorySaver?: BaseCheckpointSaver;
+  interruptSessionManager?: InterruptSessionManager;
 };
 
 /**
@@ -75,6 +78,8 @@ export class Agent {
 
   // Langgraph memory saver. In memory for local development, Custom for Platform
   private checkpointer!: BaseCheckpointSaver;
+  // Interrupt session manager. In memory for local development, Custom for Platform
+  public interruptSessionManager!: InterruptSessionManager;
   // Langgraph compiled graph
   public compiledGraph!: CompiledGraph;
   // Cache for secrets to avoid repeated API calls
@@ -145,7 +150,7 @@ export class Agent {
 
   private async init(params: CreateAgentParams<z.infer<typeof this.memorySchema>>): Promise<void> {
     try {
-      const { config, tools, memorySaver } = params;
+      const { config, tools, memorySaver, interruptSessionManager } = params;
       const { runLocally } = getConfig();
       if (!runLocally) {
         await mindedConnection.start();
@@ -178,6 +183,7 @@ export class Agent {
       const appActionsRunnerTools = this.initAppActionsRunnerTools();
       this.tools = [...tools, ...appActionsRunnerTools];
       this.checkpointer = memorySaver || createCheckpointSaver();
+      this.interruptSessionManager = interruptSessionManager || createInterruptSessionManager();
 
       // call here methods that needs environment variables to be loaded
       this.llm = createLlmInstance(config.llm);
@@ -416,10 +422,24 @@ export class Agent {
    * });
    * ```
    */
-  public async invoke({ triggerBody, triggerName, sessionId, appName }: AgentInvokeParams) {
+  public async invoke({ triggerBody, triggerName, sessionId, appName, bypassSessionCheck }: AgentInvokeParams): Promise<any> {
     sessionId = sessionId ?? uuidv4();
     try {
       await this.waitForInitialization();
+
+      // Try to acquire lock atomically (unless bypassing session check)
+      if (!bypassSessionCheck && !(await this.interruptSessionManager.lock(sessionId))) {
+        // Could not acquire lock, session is being processed - enqueue the message
+        logger.info({ msg: 'Enqueuing message', sessionId, triggerBody, triggerName, appName });
+        await this.interruptSessionManager.enqueueMessage(sessionId, {
+          triggerBody,
+          triggerName,
+          appName,
+        });
+        return;
+      }
+      // Session lock acquired, proceed with processing
+
       let messages: Array<BaseMessage> = [];
       let memoryUpdate = {};
       let sessionType: SessionType = SessionType.TEXT;
@@ -447,7 +467,8 @@ export class Agent {
           const handlerResult = results.find((r) => r !== undefined);
           if (handlerResult) {
             if (!handlerResult.isQualified) {
-              logger.debug({ msg: '[Trigger] Disqualified', triggerName, triggerBody, sessionId });
+              logger.info({ message: '[Trigger] Disqualified', triggerName, triggerBody, sessionId });
+              await this.interruptSessionManager.release(sessionId);
               return;
             }
             memoryUpdate = handlerResult.memory || {};
@@ -466,7 +487,10 @@ export class Agent {
           ? state.values.overrideStartFromNodeId
             ? state.values.overrideStartFromNodeId
             : state.next[0]
-          : this.startingNodeId!;
+          : this.startingNodeId;
+      if (!nodeToBeInvoked) {
+        throw new Error('No node to be invoked');
+      }
       nodeToBeInvoked = nodeToBeInvoked.replace(new RegExp(suffixes.join('|'), 'g'), '');
       const historyStep = this.createTriggerHistoryStep(
         state.values.history,
@@ -479,13 +503,37 @@ export class Agent {
 
       let res;
       // Resume interruption
-      if (state.tasks?.[0]?.interrupts?.length > 0) {
-        res = await this.compiledGraph.invoke(
-          new Command({
-            resume: { memory: memoryUpdate, messages, history: historyStep, sessionId, sessionType },
-          }),
-          langraphConfig,
-        );
+      if (state.tasks?.[state.tasks.length - 1]?.interrupts?.length > 0) {
+        const lastTask = state.tasks[state.tasks.length - 1];
+        const interrupt = lastTask.interrupts[0];
+        const interruptValue = (interrupt as any).value;
+
+        if (interruptValue?.type === InterruptType.HUMAN_IN_THE_LOOP) {
+          // For HUMAN_IN_THE_LOOP, use resume with the full object
+          res = await this.compiledGraph.invoke(
+            new Command({
+              resume: { memory: memoryUpdate, messages, history: historyStep, sessionId, sessionType, overrideStartFromNodeId: null },
+            }),
+            langraphConfig,
+          );
+        } else if (interruptValue?.type === InterruptType.NEW_TRIGGERS) {
+          // For NEW_TRIGGERS, check if there's an updateStateObject to apply first
+          const finalState = { memory: memoryUpdate, messages, history: [historyStep], sessionId, sessionType };
+          if (interruptValue.updateStateObject) {
+            finalState.messages = [...interruptValue.updateStateObject.messages, ...messages];
+            finalState.history = [...(interruptValue.updateStateObject.history || []), historyStep];
+            //add handlers for other state fields as needed
+          }
+
+          // Then use update with the full object and empty resume
+          res = await this.compiledGraph.invoke(
+            new Command({
+              update: finalState,
+              resume: '',
+            }),
+            langraphConfig,
+          );
+        }
       } else if (state.values.overrideStartFromNodeId) {
         res = await this.compiledGraph.invoke(
           new Command({
@@ -507,6 +555,26 @@ export class Agent {
           langraphConfig,
         );
       }
+      const nextMessage = await this.interruptSessionManager.dequeue(sessionId);
+      if (nextMessage) {
+        // Dequeue the first message and process it recursively
+        // Recursively process the next message with bypass flag
+        const invokeParams: AgentInvokeParams = {
+          triggerBody: nextMessage.triggerBody,
+          triggerName: nextMessage.triggerName,
+          sessionId: sessionId,
+          bypassSessionCheck: true,
+        };
+        if (nextMessage.appName) {
+          invokeParams.appName = nextMessage.appName;
+        }
+        logger.info({ msg: 'Invoking next message in the queue', invokeParams });
+        return await this.invoke(invokeParams);
+      }
+
+      // Release the session lock
+      await this.interruptSessionManager.release(sessionId);
+
       return res;
     } catch (error: any) {
       logger.error({
@@ -515,6 +583,10 @@ export class Agent {
         stack: error.stack,
         sessionId,
       });
+
+      // Release the session lock on error
+      await this.interruptSessionManager.release(sessionId);
+
       const state = await this.compiledGraph.getState(this.getLangraphConfig(sessionId));
       this.emit(AgentEvents.ERROR, { error: error instanceof Error ? error : new Error(JSON.stringify(error)), state: state.values });
       throw error;
@@ -823,7 +895,7 @@ export class Agent {
       // Hangup / end session handler
       connection.on(mindedConnectionSocketMessageType.DASHBOARD_VOICE_SESSION_END, (message) => {
         const hangup = message as BaseVoiceMessage;
-        logger.debug({ message: '[Voice] Dashboard eneded voice session', sessionId: hangup.sessionId });
+        logger.debug({ msg: '[Voice] Dashboard eneded voice session', sessionId: hangup.sessionId });
         const voiceSession = this.voiceSessions.get(hangup.sessionId);
         if (voiceSession) {
           voiceSession.hangup();
@@ -856,7 +928,8 @@ export class Agent {
       voiceId: voiceTrigger.voiceId,
     });
     await voiceSession.init();
-    logger.debug({ message: '[Voice] Voice session initialized', sessionId: params.sessionId });
+    logger.debug({ msg: '[Voice] Voice session initialized', sessionId: params.sessionId });
+
     this.voiceSessions.set(params.sessionId, voiceSession);
 
     // Emit voice session start event

package/src/cli/index.ts

@@ -19,7 +19,7 @@ function setToken(token: string): void {
   if (!fs.existsSync(envPath)) {
     // Create .env file with the token
     fs.writeFileSync(envPath, tokenLine + '\n');
-    logger.info(`Created ${envPath} and added token`);
+    logger.info({ msg: `Created ${envPath} and added token` });
   } else {
     // Read existing .env file
     const envContent = fs.readFileSync(envPath, 'utf8');
@@ -29,12 +29,12 @@ function setToken(token: string): void {
       // Replace existing token
       const updatedContent = envContent.replace(/MINDED_CONNECTION_TOKEN=.*/, tokenLine);
       fs.writeFileSync(envPath, updatedContent);
-      logger.info(`Updated MINDED_CONNECTION_TOKEN in ${envPath}`);
+      logger.info({ msg: `Updated MINDED_CONNECTION_TOKEN in ${envPath}` });
     } else {
       // Append token to existing file
       const newContent = envContent.endsWith('\n') ? envContent + tokenLine + '\n' : envContent + '\n' + tokenLine + '\n';
       fs.writeFileSync(envPath, newContent);
-      logger.info(`Added MINDED_CONNECTION_TOKEN to ${envPath}`);
+      logger.info({ msg: `Added MINDED_CONNECTION_TOKEN to ${envPath}` });
     }
   }
 }
@@ -44,7 +44,7 @@ function generateLambdaHandler(): void {
 
   // Check if minded.json exists
   if (!fs.existsSync(mindedConfigPath)) {
-    logger.error('minded.json not found in the current directory');
+    logger.error({ msg: 'minded.json not found in the current directory' });
     process.exit(1);
   }
 
@@ -54,14 +54,14 @@ function generateLambdaHandler(): void {
     const configContent = fs.readFileSync(mindedConfigPath, 'utf8');
     mindedConfig = JSON.parse(configContent);
   } catch (error) {
-    logger.error('Failed to read or parse minded.json:', error);
+    logger.error({ msg: 'Failed to read or parse minded.json:', error });
     process.exit(1);
   }
 
   // Get the agent path
   const agentPath = mindedConfig.agent;
   if (!agentPath) {
-    logger.error('No agent path found in minded.json');
+    logger.error({ msg: 'No agent path found in minded.json' });
     process.exit(1);
   }
 
@@ -91,7 +91,7 @@ function generateLambdaHandler(): void {
   }
 
   if (!templateContent) {
-    logger.error('Could not find Lambda handler template file');
+    logger.error({ msg: 'Could not find Lambda handler template file' });
     process.exit(1);
   }
 
@@ -102,10 +102,10 @@ function generateLambdaHandler(): void {
     // Write the Lambda handler to index.ts at the root
     const outputPath = path.join(process.cwd(), 'index.ts');
     fs.writeFileSync(outputPath, templateContent);
-    logger.info(`Generated Lambda handler at ${outputPath}`);
+    logger.info({ msg: `Generated Lambda handler at ${outputPath}` });
 
     // Compile the index.ts file using TypeScript
-    logger.info('Compiling the Lambda handler...');
+    logger.info({ msg: 'Compiling the Lambda handler...' });
 
     try {
       // Read tsconfig.json to get the outDir
@@ -138,12 +138,12 @@ function generateLambdaHandler(): void {
         cwd: process.cwd(),
       });
 
-      logger.info(`Successfully compiled Lambda handler to ${outDir}/index.js`);
+      logger.info({ msg: `Successfully compiled Lambda handler to ${outDir}/index.js` });
     } catch (compileError) {
-      logger.error({ message: 'Failed to compile Lambda handler', error: compileError });
+      logger.error({ msg: 'Failed to compile Lambda handler', error: compileError });
     }
   } catch (error) {
-    logger.error({ message: 'Failed to generate Lambda handler', error: error });
+    logger.error({ msg: 'Failed to generate Lambda handler', error: error });
     process.exit(1);
   }
 }
@@ -155,14 +155,14 @@ function main() {
   if (command === 'token') {
     const token = args[1];
     if (!token) {
-      logger.error('Please provide a token');
+      logger.error({ msg: 'Please provide a token' });
       process.exit(1);
     }
     setToken(token);
   } else if (command === 'generate-lambda-ts-handler') {
     generateLambdaHandler();
   } else {
-    logger.error('Unknown command. Available commands: token, generate-lambda-ts-handler');
+    logger.error({ msg: 'Unknown command. Available commands: token, generate-lambda-ts-handler' });
     process.exit(1);
   }
 }

package/src/edges/edgeFactory.ts

@@ -60,7 +60,7 @@ export const edgeFactory = ({
         if (result) {
           return result;
         } else {
-          logger.debug('No logical conditions matched, continuing to prompt conditions');
+          logger.debug({ msg: 'No logical conditions matched, continuing to prompt conditions' });
         }
       }
 
@@ -80,7 +80,7 @@ export const edgeFactory = ({
 
       // Fallback: stay at current source node
       const source = originalNode?.name || sourceNode;
-      logger.info(`No conditions matched, returning to source: ${source}`);
+      logger.info({ msg: `No conditions matched, returning to source: ${source}` });
       return source;
     };
   };

package/src/interrupts/BaseInterruptSessionManager.ts

@@ -0,0 +1,94 @@
+import { State } from '../types/LangGraph.types';
+import { GraphInterrupt } from '@langchain/langgraph';
+import { logger } from '../utils/logger';
+
+export enum InterruptType {
+  NEW_TRIGGERS = 'NEW_TRIGGERS',
+  HUMAN_IN_THE_LOOP = 'HUMAN_IN_THE_LOOP',
+}
+
+export interface QueuedMessage {
+  triggerBody: any;
+  triggerName: string;
+  appName?: string;
+}
+
+// export interface UpdateStateObject {
+//   memory: any;
+//   messages: any[];
+//   history: any[];
+//   sessionId: string;
+//   sessionType: SessionType;
+// }
+export interface InterruptPayload {
+  type: InterruptType.NEW_TRIGGERS;
+  updateStateObject?: Partial<State>;
+  id?: string;
+}
+
+export interface InterruptSessionManager {
+  isProcessed(sessionId: string): boolean | Promise<boolean>;
+  /**
+   * Atomically attempts to acquire a lock for the given session.
+   * This method should only succeed if the session is not already being processed.
+   *
+   * @param sessionId - The session ID to lock
+   * @returns true if the lock was successfully acquired, false if the session is already locked
+   */
+  lock(sessionId: string): boolean | Promise<boolean>;
+  release(sessionId: string): void | Promise<void>;
+  enqueueMessage(sessionId: string, message: QueuedMessage): void | Promise<void>;
+  dequeueAll(sessionId: string): QueuedMessage[] | Promise<QueuedMessage[]>;
+  dequeue(sessionId: string): QueuedMessage | null | Promise<QueuedMessage | null>;
+  checkQueueAndInterrupt(sessionId: string, updateStateObject?: Partial<State>): Promise<boolean>;
+}
+
+export abstract class BaseInterruptSessionManager implements InterruptSessionManager {
+  // Abstract methods that subclasses must implement for queue management
+  abstract isProcessed(sessionId: string): boolean | Promise<boolean>;
+  /**
+   * Atomically attempts to acquire a lock for the given session.
+   * This method should only succeed if the session is not already being processed.
+   * Implementations must ensure this operation is atomic to prevent race conditions.
+   *
+   * @param sessionId - The session ID to lock
+   * @returns true if the lock was successfully acquired, false if the session is already locked
+   */
+  abstract lock(sessionId: string): boolean | Promise<boolean>;
+  abstract release(sessionId: string): void | Promise<void>;
+  abstract enqueueMessage(sessionId: string, message: QueuedMessage): void | Promise<void>;
+  abstract dequeueAll(sessionId: string): QueuedMessage[] | Promise<QueuedMessage[]>;
+  abstract dequeue(sessionId: string): QueuedMessage | null | Promise<QueuedMessage | null>;
+
+  // Abstract method to check if queue has messages - this is the only queue-specific part
+  protected abstract hasQueuedMessages(sessionId: string): boolean | Promise<boolean>;
+  protected abstract getQueuedMessages(sessionId: string): QueuedMessage[] | Promise<QueuedMessage[]>;
+
+  // Common implementation of checkQueueAndInterrupt
+  async checkQueueAndInterrupt(sessionId: string, updateStateObject?: Partial<State>): Promise<boolean> {
+    if (await this.hasQueuedMessages(sessionId)) {
+      logger.trace({ msg: 'graph has queued messagess, interrupting graph', sessionId });
+
+      // Interrupt the graph with NEW_TRIGGERS flag and optional updateStateObject
+      const interruptPayload: InterruptPayload = { type: InterruptType.NEW_TRIGGERS };
+      if (updateStateObject) {
+        interruptPayload.updateStateObject = {
+          messages: updateStateObject.messages,
+          memory: updateStateObject.memory,
+          history: updateStateObject.history,
+          sessionId: updateStateObject.sessionId,
+          sessionType: updateStateObject.sessionType,
+        };
+      }
+
+      throw new GraphInterrupt([
+        {
+          value: interruptPayload,
+          when: 'during',
+          resumable: true,
+        },
+      ]);
+    }
+    return false;
+  }
+}

package/src/interrupts/MemoryInterruptSessionManager.ts

@@ -0,0 +1,57 @@
+import { BaseInterruptSessionManager, QueuedMessage } from './BaseInterruptSessionManager';
+
+export class MemoryInterruptSessionManager extends BaseInterruptSessionManager {
+  private sessionProcessing: Map<string, boolean> = new Map();
+  private sessionMessageQueues: Map<string, QueuedMessage[]> = new Map();
+
+  isProcessed(sessionId: string): boolean {
+    return this.sessionProcessing.get(sessionId) || false;
+  }
+
+  lock(sessionId: string): boolean {
+    const isCurrentlyProcessed = this.sessionProcessing.get(sessionId) || false;
+    if (isCurrentlyProcessed) {
+      return false; // Could not acquire lock
+    }
+    this.sessionProcessing.set(sessionId, true);
+    return true; // Successfully acquired lock
+  }
+
+  release(sessionId: string): void {
+    this.sessionProcessing.delete(sessionId);
+  }
+
+  enqueueMessage(sessionId: string, message: QueuedMessage): void {
+    if (!this.sessionMessageQueues.has(sessionId)) {
+      this.sessionMessageQueues.set(sessionId, []);
+    }
+    this.sessionMessageQueues.get(sessionId)!.push(message);
+  }
+
+  dequeueAll(sessionId: string): QueuedMessage[] {
+    const messages = this.sessionMessageQueues.get(sessionId) || [];
+    const result = [...messages];
+    this.sessionMessageQueues.set(sessionId, []);
+    return result;
+  }
+
+  dequeue(sessionId: string): QueuedMessage | null {
+    const messages = this.sessionMessageQueues.get(sessionId) || [];
+    if (messages.length === 0) {
+      return null;
+    }
+    const firstMessage = messages.shift()!;
+    this.sessionMessageQueues.set(sessionId, messages);
+    return firstMessage;
+  }
+
+  // Implementation of abstract methods from BaseInterruptSessionManager
+  protected hasQueuedMessages(sessionId: string): boolean {
+    const queue = this.sessionMessageQueues.get(sessionId) || [];
+    return queue.length > 0;
+  }
+
+  protected getQueuedMessages(sessionId: string): QueuedMessage[] {
+    return this.sessionMessageQueues.get(sessionId) || [];
+  }
+}