@minded-ai/mindedjs 1.0.91-beta-1 → 1.0.92-beta-2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/dist/agent.d.ts +4 -1
  2. package/dist/agent.d.ts.map +1 -1
  3. package/dist/agent.js +80 -7
  4. package/dist/agent.js.map +1 -1
  5. package/dist/interrupts/InterruptSessionManager.types.d.ts +36 -0
  6. package/dist/interrupts/InterruptSessionManager.types.d.ts.map +1 -0
  7. package/dist/interrupts/InterruptSessionManager.types.js +39 -0
  8. package/dist/interrupts/InterruptSessionManager.types.js.map +1 -0
  9. package/dist/interrupts/MemoryInterruptSessionManager.d.ts +14 -0
  10. package/dist/interrupts/MemoryInterruptSessionManager.d.ts.map +1 -0
  11. package/dist/interrupts/MemoryInterruptSessionManager.js +51 -0
  12. package/dist/interrupts/MemoryInterruptSessionManager.js.map +1 -0
  13. package/dist/interrupts/MindedInterruptSessionManager.d.ts +15 -0
  14. package/dist/interrupts/MindedInterruptSessionManager.d.ts.map +1 -0
  15. package/dist/interrupts/MindedInterruptSessionManager.js +121 -0
  16. package/dist/interrupts/MindedInterruptSessionManager.js.map +1 -0
  17. package/dist/interrupts/interruptSessionManagerFactory.d.ts +4 -0
  18. package/dist/interrupts/interruptSessionManagerFactory.d.ts.map +1 -0
  19. package/dist/interrupts/interruptSessionManagerFactory.js +19 -0
  20. package/dist/interrupts/interruptSessionManagerFactory.js.map +1 -0
  21. package/dist/nodes/addHumanInTheLoopNode.d.ts.map +1 -1
  22. package/dist/nodes/addHumanInTheLoopNode.js +2 -1
  23. package/dist/nodes/addHumanInTheLoopNode.js.map +1 -1
  24. package/dist/nodes/addPromptNode.d.ts.map +1 -1
  25. package/dist/nodes/addPromptNode.js +40 -0
  26. package/dist/nodes/addPromptNode.js.map +1 -1
  27. package/dist/nodes/nodeFactory.d.ts.map +1 -1
  28. package/dist/nodes/nodeFactory.js.map +1 -1
  29. package/dist/platform/mindedConnectionTypes.d.ts +82 -1
  30. package/dist/platform/mindedConnectionTypes.d.ts.map +1 -1
  31. package/dist/platform/mindedConnectionTypes.js +9 -0
  32. package/dist/platform/mindedConnectionTypes.js.map +1 -1
  33. package/dist/types/Agent.types.d.ts +2 -9
  34. package/dist/types/Agent.types.d.ts.map +1 -1
  35. package/dist/types/Agent.types.js +1 -11
  36. package/dist/types/Agent.types.js.map +1 -1
  37. package/dist/types/LangGraph.types.d.ts +2 -2
  38. package/dist/types/LangGraph.types.d.ts.map +1 -1
  39. package/dist/types/LangGraph.types.js +3 -1
  40. package/dist/types/LangGraph.types.js.map +1 -1
  41. package/package.json +1 -1
  42. package/src/agent.ts +100 -9
  43. package/src/interrupts/InterruptSessionManager.types.ts +79 -0
  44. package/src/interrupts/MemoryInterruptSessionManager.ts +56 -0
  45. package/src/interrupts/MindedInterruptSessionManager.ts +157 -0
  46. package/src/interrupts/interruptSessionManagerFactory.ts +17 -0
  47. package/src/nodes/addHumanInTheLoopNode.ts +2 -1
  48. package/src/nodes/addPromptNode.ts +45 -4
  49. package/src/nodes/nodeFactory.ts +1 -2
  50. package/src/platform/mindedConnectionTypes.ts +100 -0
  51. package/src/types/Agent.types.ts +2 -11
  52. package/src/types/LangGraph.types.ts +3 -1
@@ -0,0 +1,79 @@
1
+ import { State } from '../types/LangGraph.types';
2
+ import { GraphInterrupt } from '@langchain/langgraph';
3
+
4
+ export enum InterruptType {
5
+ NEW_TRIGGERS = 'NEW_TRIGGERS',
6
+ HUMAN_IN_THE_LOOP = 'HUMAN_IN_THE_LOOP',
7
+ }
8
+
9
+ export interface QueuedMessage {
10
+ triggerBody: any;
11
+ triggerName: string;
12
+ appName?: string;
13
+ }
14
+
15
+ // export interface UpdateStateObject {
16
+ // memory: any;
17
+ // messages: any[];
18
+ // history: any[];
19
+ // sessionId: string;
20
+ // sessionType: SessionType;
21
+ // }
22
+ export interface InterruptPayload {
23
+ type: InterruptType.NEW_TRIGGERS;
24
+ updateStateObject?: Partial<State>;
25
+ id?: string;
26
+ }
27
+
28
+ export interface InterruptSessionManager {
29
+ isProcessed(sessionId: string): boolean | Promise<boolean>;
30
+ lock(sessionId: string): void | Promise<void>;
31
+ release(sessionId: string): void | Promise<void>;
32
+ enqueueMessage(sessionId: string, message: QueuedMessage): void | Promise<void>;
33
+ dequeueAll(sessionId: string): QueuedMessage[] | Promise<QueuedMessage[]>;
34
+ dequeue(sessionId: string): QueuedMessage | null | Promise<QueuedMessage | null>;
35
+ checkQueueAndInterrupt(sessionId: string, updateStateObject?: Partial<State>): Promise<boolean>;
36
+ }
37
+
38
+ export abstract class BaseInterruptSessionManager implements InterruptSessionManager {
39
+ // Abstract methods that subclasses must implement for queue management
40
+ abstract isProcessed(sessionId: string): boolean | Promise<boolean>;
41
+ abstract lock(sessionId: string): void | Promise<void>;
42
+ abstract release(sessionId: string): void | Promise<void>;
43
+ abstract enqueueMessage(sessionId: string, message: QueuedMessage): void | Promise<void>;
44
+ abstract dequeueAll(sessionId: string): QueuedMessage[] | Promise<QueuedMessage[]>;
45
+ abstract dequeue(sessionId: string): QueuedMessage | null | Promise<QueuedMessage | null>;
46
+
47
+ // Abstract method to check if queue has messages - this is the only queue-specific part
48
+ protected abstract hasQueuedMessages(sessionId: string): boolean | Promise<boolean>;
49
+ protected abstract getQueuedMessages(sessionId: string): QueuedMessage[] | Promise<QueuedMessage[]>;
50
+
51
+ // Common implementation of checkQueueAndInterrupt
52
+ async checkQueueAndInterrupt(sessionId: string, updateStateObject?: Partial<State>): Promise<boolean> {
53
+ if (await this.hasQueuedMessages(sessionId)) {
54
+ const queue = await this.getQueuedMessages(sessionId);
55
+ console.log({ message: 'Interrupting graph', sessionId, queue, updateStateObject });
56
+
57
+ // Interrupt the graph with NEW_TRIGGERS flag and optional updateStateObject
58
+ const interruptPayload: InterruptPayload = { type: InterruptType.NEW_TRIGGERS };
59
+ if (updateStateObject) {
60
+ interruptPayload.updateStateObject = {
61
+ messages: updateStateObject.messages,
62
+ memory: updateStateObject.memory,
63
+ history: updateStateObject.history,
64
+ sessionId: updateStateObject.sessionId,
65
+ sessionType: updateStateObject.sessionType,
66
+ };
67
+ }
68
+
69
+ throw new GraphInterrupt([
70
+ {
71
+ value: interruptPayload,
72
+ when: 'during',
73
+ resumable: true,
74
+ },
75
+ ]);
76
+ }
77
+ return false;
78
+ }
79
+ }
@@ -0,0 +1,56 @@
1
+ import { State } from '../types/LangGraph.types';
2
+ import { logger } from '../utils/logger';
3
+ import { BaseInterruptSessionManager, QueuedMessage, InterruptType, InterruptPayload } from './InterruptSessionManager.types';
4
+ import { GraphInterrupt, interrupt } from '@langchain/langgraph';
5
+ import { v4 as uuidv4 } from 'uuid';
6
+
7
+ export class MemoryInterruptSessionManager extends BaseInterruptSessionManager {
8
+ private sessionProcessing: Map<string, boolean> = new Map();
9
+ private sessionMessageQueues: Map<string, QueuedMessage[]> = new Map();
10
+
11
+ isProcessed(sessionId: string): boolean {
12
+ return this.sessionProcessing.get(sessionId) || false;
13
+ }
14
+
15
+ lock(sessionId: string): void {
16
+ this.sessionProcessing.set(sessionId, true);
17
+ }
18
+
19
+ release(sessionId: string): void {
20
+ this.sessionProcessing.set(sessionId, false);
21
+ }
22
+
23
+ enqueueMessage(sessionId: string, message: QueuedMessage): void {
24
+ if (!this.sessionMessageQueues.has(sessionId)) {
25
+ this.sessionMessageQueues.set(sessionId, []);
26
+ }
27
+ this.sessionMessageQueues.get(sessionId)!.push(message);
28
+ }
29
+
30
+ dequeueAll(sessionId: string): QueuedMessage[] {
31
+ const messages = this.sessionMessageQueues.get(sessionId) || [];
32
+ const result = [...messages];
33
+ this.sessionMessageQueues.set(sessionId, []);
34
+ return result;
35
+ }
36
+
37
+ dequeue(sessionId: string): QueuedMessage | null {
38
+ const messages = this.sessionMessageQueues.get(sessionId) || [];
39
+ if (messages.length === 0) {
40
+ return null;
41
+ }
42
+ const firstMessage = messages.shift()!;
43
+ this.sessionMessageQueues.set(sessionId, messages);
44
+ return firstMessage;
45
+ }
46
+
47
+ // Implementation of abstract methods from BaseInterruptSessionManager
48
+ protected hasQueuedMessages(sessionId: string): boolean {
49
+ const queue = this.sessionMessageQueues.get(sessionId) || [];
50
+ return queue.length > 0;
51
+ }
52
+
53
+ protected getQueuedMessages(sessionId: string): QueuedMessage[] {
54
+ return this.sessionMessageQueues.get(sessionId) || [];
55
+ }
56
+ }
@@ -0,0 +1,157 @@
1
+ import { BaseInterruptSessionManager, QueuedMessage } from './InterruptSessionManager.types';
2
+ import { MindedConnection } from '../platform/mindedConnection';
3
+ import {
4
+ MindedConnectionSocketMessageType,
5
+ InterruptSessionIsProcessedRequest,
6
+ InterruptSessionIsProcessedResponse,
7
+ InterruptSessionLockRequest,
8
+ InterruptSessionLockResponse,
9
+ InterruptSessionReleaseRequest,
10
+ InterruptSessionReleaseResponse,
11
+ InterruptSessionEnqueueRequest,
12
+ InterruptSessionEnqueueResponse,
13
+ InterruptSessionDequeueAllRequest,
14
+ InterruptSessionDequeueAllResponse,
15
+ InterruptSessionDequeueRequest,
16
+ InterruptSessionDequeueResponse,
17
+ InterruptSessionHasMessagesRequest,
18
+ InterruptSessionHasMessagesResponse,
19
+ InterruptSessionGetMessagesRequest,
20
+ InterruptSessionGetMessagesResponse,
21
+ } from '../platform/mindedConnectionTypes';
22
+
23
+ export class MindedInterruptSessionManager extends BaseInterruptSessionManager {
24
+ private mindedConnection: MindedConnection;
25
+
26
+ constructor(mindedConnection: MindedConnection) {
27
+ super();
28
+ this.mindedConnection = mindedConnection;
29
+ }
30
+
31
+ async isProcessed(sessionId: string): Promise<boolean> {
32
+ try {
33
+ const response = await this.mindedConnection.awaitEmit<InterruptSessionIsProcessedRequest, InterruptSessionIsProcessedResponse>(
34
+ MindedConnectionSocketMessageType.INTERRUPT_SESSION_IS_PROCESSED,
35
+ {
36
+ type: MindedConnectionSocketMessageType.INTERRUPT_SESSION_IS_PROCESSED,
37
+ sessionId,
38
+ },
39
+ );
40
+ return response.isProcessed ?? false;
41
+ } catch (error) {
42
+ console.error('Error checking if session is processed:', error);
43
+ return false;
44
+ }
45
+ }
46
+
47
+ async lock(sessionId: string): Promise<void> {
48
+ try {
49
+ await this.mindedConnection.awaitEmit<InterruptSessionLockRequest, InterruptSessionLockResponse>(
50
+ MindedConnectionSocketMessageType.INTERRUPT_SESSION_LOCK,
51
+ {
52
+ type: MindedConnectionSocketMessageType.INTERRUPT_SESSION_LOCK,
53
+ sessionId,
54
+ },
55
+ );
56
+ } catch (error) {
57
+ console.error('Error locking session:', error);
58
+ throw error;
59
+ }
60
+ }
61
+
62
+ async release(sessionId: string): Promise<void> {
63
+ try {
64
+ await this.mindedConnection.awaitEmit<InterruptSessionReleaseRequest, InterruptSessionReleaseResponse>(
65
+ MindedConnectionSocketMessageType.INTERRUPT_SESSION_RELEASE,
66
+ {
67
+ type: MindedConnectionSocketMessageType.INTERRUPT_SESSION_RELEASE,
68
+ sessionId,
69
+ },
70
+ );
71
+ } catch (error) {
72
+ console.error('Error releasing session:', error);
73
+ throw error;
74
+ }
75
+ }
76
+
77
+ async enqueueMessage(sessionId: string, message: QueuedMessage): Promise<void> {
78
+ try {
79
+ await this.mindedConnection.awaitEmit<InterruptSessionEnqueueRequest, InterruptSessionEnqueueResponse>(
80
+ MindedConnectionSocketMessageType.INTERRUPT_SESSION_ENQUEUE,
81
+ {
82
+ type: MindedConnectionSocketMessageType.INTERRUPT_SESSION_ENQUEUE,
83
+ sessionId,
84
+ message,
85
+ },
86
+ );
87
+ } catch (error) {
88
+ console.error('Error enqueuing message:', error);
89
+ throw error;
90
+ }
91
+ }
92
+
93
+ async dequeueAll(sessionId: string): Promise<QueuedMessage[]> {
94
+ try {
95
+ const response = await this.mindedConnection.awaitEmit<InterruptSessionDequeueAllRequest, InterruptSessionDequeueAllResponse>(
96
+ MindedConnectionSocketMessageType.INTERRUPT_SESSION_DEQUEUE_ALL,
97
+ {
98
+ type: MindedConnectionSocketMessageType.INTERRUPT_SESSION_DEQUEUE_ALL,
99
+ sessionId,
100
+ },
101
+ );
102
+ return response.messages ?? [];
103
+ } catch (error) {
104
+ console.error('Error dequeuing all messages:', error);
105
+ return [];
106
+ }
107
+ }
108
+
109
+ async dequeue(sessionId: string): Promise<QueuedMessage | null> {
110
+ try {
111
+ const response = await this.mindedConnection.awaitEmit<InterruptSessionDequeueRequest, InterruptSessionDequeueResponse>(
112
+ MindedConnectionSocketMessageType.INTERRUPT_SESSION_DEQUEUE,
113
+ {
114
+ type: MindedConnectionSocketMessageType.INTERRUPT_SESSION_DEQUEUE,
115
+ sessionId,
116
+ },
117
+ );
118
+ return response.message ?? null;
119
+ } catch (error) {
120
+ console.error('Error dequeuing message:', error);
121
+ return null;
122
+ }
123
+ }
124
+
125
+ // Implementation of abstract methods from BaseInterruptSessionManager
126
+ protected async hasQueuedMessages(sessionId: string): Promise<boolean> {
127
+ try {
128
+ const response = await this.mindedConnection.awaitEmit<InterruptSessionHasMessagesRequest, InterruptSessionHasMessagesResponse>(
129
+ MindedConnectionSocketMessageType.INTERRUPT_SESSION_HAS_MESSAGES,
130
+ {
131
+ type: MindedConnectionSocketMessageType.INTERRUPT_SESSION_HAS_MESSAGES,
132
+ sessionId,
133
+ },
134
+ );
135
+ return response.hasMessages ?? false;
136
+ } catch (error) {
137
+ console.error('Error checking if session has messages:', error);
138
+ return false;
139
+ }
140
+ }
141
+
142
+ protected async getQueuedMessages(sessionId: string): Promise<QueuedMessage[]> {
143
+ try {
144
+ const response = await this.mindedConnection.awaitEmit<InterruptSessionGetMessagesRequest, InterruptSessionGetMessagesResponse>(
145
+ MindedConnectionSocketMessageType.INTERRUPT_SESSION_GET_MESSAGES,
146
+ {
147
+ type: MindedConnectionSocketMessageType.INTERRUPT_SESSION_GET_MESSAGES,
148
+ sessionId,
149
+ },
150
+ );
151
+ return response.messages ?? [];
152
+ } catch (error) {
153
+ console.error('Error getting queued messages:', error);
154
+ return [];
155
+ }
156
+ }
157
+ }
@@ -0,0 +1,17 @@
1
+ import { InterruptSessionManager } from './InterruptSessionManager.types';
2
+ import { MemoryInterruptSessionManager } from './MemoryInterruptSessionManager';
3
+ import { MindedInterruptSessionManager } from './MindedInterruptSessionManager';
4
+ import { MindedConnection } from '../platform/mindedConnection';
5
+ import { getConfig } from '../platform/config';
6
+
7
+ export function createInterruptSessionManager(mindedConnection: MindedConnection | null): InterruptSessionManager {
8
+ const { runLocally } = getConfig();
9
+ if (runLocally) {
10
+ return new MemoryInterruptSessionManager();
11
+ } else {
12
+ if (!mindedConnection) {
13
+ throw new Error('MindedConnection is required for platform interrupt session manager');
14
+ }
15
+ return new MindedInterruptSessionManager(mindedConnection);
16
+ }
17
+ }
@@ -3,6 +3,7 @@ import { PreCompiledGraph, stateAnnotation } from '../types/LangGraph.types';
3
3
  import { RunnableLike } from '@langchain/core/runnables';
4
4
  import { logger } from '../utils/logger';
5
5
  import { internalNodesSuffix } from '../types/Flows.types';
6
+ import { InterruptType } from '../interrupts/InterruptSessionManager.types';
6
7
 
7
8
  type AddHumanInTheLoopNodeParams = {
8
9
  graph: PreCompiledGraph;
@@ -16,7 +17,7 @@ export const addHumanInTheLoopNode = async ({ graph, attachedToNodeName }: AddHu
16
17
  logger.info(`Executing "human in the loop" node for the attached node${attachedToNodeName}`);
17
18
 
18
19
  if (state.messages[state.messages.length - 1].getType() === 'ai') {
19
- const value = interrupt('input from human in the loop');
20
+ const value = interrupt({ type: InterruptType.HUMAN_IN_THE_LOOP });
20
21
  return value;
21
22
  }
22
23
  };
@@ -14,7 +14,7 @@ import { Agent } from '../agent';
14
14
  import { logger } from '../utils/logger';
15
15
  import { compilePlaybooks } from '../playbooks/playbooks';
16
16
  import { createHistoryStep } from '../utils/history';
17
-
17
+ const wait = (ms: number) => new Promise((r) => setTimeout(r, ms));
18
18
  type AddPromptNodeParams = {
19
19
  graph: PreCompiledGraph;
20
20
  node: PromptNode;
@@ -26,6 +26,7 @@ type AddPromptNodeParams = {
26
26
 
27
27
  export const addPromptNode = async ({ graph, node, llm, tools, emit, agent }: AddPromptNodeParams) => {
28
28
  const callback: RunnableLike = async (state: typeof stateAnnotation.State) => {
29
+ await agent.interruptSessionManager.checkQueueAndInterrupt(state.sessionId);
29
30
  logger.info(`Executing prompt node ${node.displayName}`);
30
31
  const llmToUse = node.llmConfig ? createLlmInstance(node.llmConfig) : llm;
31
32
 
@@ -52,7 +53,7 @@ export const addPromptNode = async ({ graph, node, llm, tools, emit, agent }: Ad
52
53
  `;
53
54
 
54
55
  const result: AIMessage = await llmToUse.bindTools(globalTools).invoke([...state.messages, new SystemMessage(message)]);
55
-
56
+ await agent.interruptSessionManager.checkQueueAndInterrupt(state.sessionId);
56
57
  // Check if the result contains tool calls
57
58
  if (result.tool_calls && result.tool_calls.length > 0) {
58
59
  // Execute the tools
@@ -66,6 +67,26 @@ export const addPromptNode = async ({ graph, node, llm, tools, emit, agent }: Ad
66
67
  try {
67
68
  // Invoke the LangChain tool directly
68
69
  const toolResult = await matchedTool.invoke(toolCall);
70
+ console.log('after invoke?');
71
+ //check for queue after tool call
72
+ await agent.interruptSessionManager.checkQueueAndInterrupt(state.sessionId, {
73
+ messages: [
74
+ result,
75
+ toolResult,
76
+ new SystemMessage(
77
+ 'you called tool when the user send a new message, Consider calling the function again after user message is processed',
78
+ ),
79
+ ],
80
+ history: [
81
+ createHistoryStep<HistoryStep>(state.history, {
82
+ type: NodeType.TOOL,
83
+ nodeId: node.name,
84
+ nodeDisplayName: node.displayName,
85
+ raw: toolResult,
86
+ messageIds: [toolResult.id!],
87
+ }),
88
+ ],
89
+ });
69
90
  const toolStateUpdate = extractToolStateResponse(toolResult);
70
91
  // Properly merge memory and other state updates
71
92
  stateUpdates = {
@@ -74,7 +95,8 @@ export const addPromptNode = async ({ graph, node, llm, tools, emit, agent }: Ad
74
95
  memory: { ...(stateUpdates as any).memory, ...(toolStateUpdate as any).memory },
75
96
  };
76
97
  toolResults.push(toolResult);
77
- } catch (error) {
98
+ } catch (error: any) {
99
+ if (error?.name === 'GraphInterrupt') throw error;
78
100
  logger.error({ msg: `Error executing tool ${toolCall.name}:`, error });
79
101
  const errorMessage = new ToolMessage({
80
102
  content: JSON.stringify({ error: error instanceof Error ? error.message : String(error) }),
@@ -87,10 +109,30 @@ export const addPromptNode = async ({ graph, node, llm, tools, emit, agent }: Ad
87
109
  }
88
110
  }
89
111
 
112
+ // await agent.interruptSessionManager.checkQueueAndInterrupt(state.sessionId);
113
+
90
114
  // Return the tool call message and tool results with state updates spread at top level
91
115
  return {
92
116
  ...stateUpdates,
93
117
  messages: [result, ...toolResults],
118
+ history: [
119
+ createHistoryStep<HistoryStep>(state.history, {
120
+ type: NodeType.TOOL,
121
+ nodeId: node.name,
122
+ nodeDisplayName: node.displayName,
123
+ raw: result,
124
+ messageIds: [result.id!],
125
+ }),
126
+ ...toolResults.map((toolResult) =>
127
+ createHistoryStep<HistoryStep>(state.history, {
128
+ type: NodeType.TOOL,
129
+ nodeId: node.name,
130
+ nodeDisplayName: node.displayName,
131
+ raw: toolResult,
132
+ messageIds: [toolResult.id!],
133
+ }),
134
+ ),
135
+ ],
94
136
  };
95
137
  }
96
138
 
@@ -101,7 +143,6 @@ export const addPromptNode = async ({ graph, node, llm, tools, emit, agent }: Ad
101
143
  });
102
144
  console.log('AI Message', result.content);
103
145
  }
104
-
105
146
  return {
106
147
  history: createHistoryStep<HistoryStep>(state.history, {
107
148
  type: NodeType.PROMPT_NODE,
@@ -1,5 +1,4 @@
1
- import { RunnableLike } from '@langchain/core/runnables';
2
- import { JunctionNode, Node, NodeType } from '../types/Flows.types';
1
+ import { Node, NodeType } from '../types/Flows.types';
3
2
  import { PreCompiledGraph } from '../types/LangGraph.types';
4
3
  import { Tool } from '../types/Tools.types';
5
4
  import { addToolNode } from './addToolNode';
@@ -32,6 +32,15 @@ export enum MindedConnectionSocketMessageType {
32
32
  TIMER_RESET = 'timer-reset',
33
33
  TIMER_CANCEL = 'timer-cancel',
34
34
  TIMER_TRIGGER = 'timer-trigger',
35
+ // Interrupt Session Management
36
+ INTERRUPT_SESSION_IS_PROCESSED = 'interrupt-session-is-processed',
37
+ INTERRUPT_SESSION_LOCK = 'interrupt-session-lock',
38
+ INTERRUPT_SESSION_RELEASE = 'interrupt-session-release',
39
+ INTERRUPT_SESSION_ENQUEUE = 'interrupt-session-enqueue',
40
+ INTERRUPT_SESSION_DEQUEUE_ALL = 'interrupt-session-dequeue-all',
41
+ INTERRUPT_SESSION_DEQUEUE = 'interrupt-session-dequeue',
42
+ INTERRUPT_SESSION_HAS_MESSAGES = 'interrupt-session-has-messages',
43
+ INTERRUPT_SESSION_GET_MESSAGES = 'interrupt-session-get-messages',
35
44
  }
36
45
 
37
46
  export type MindedConnectionSocketMessageTypeMap = {
@@ -55,6 +64,15 @@ export type MindedConnectionSocketMessageTypeMap = {
55
64
  [MindedConnectionSocketMessageType.TIMER_RESET]: TimerResetRequest;
56
65
  [MindedConnectionSocketMessageType.TIMER_CANCEL]: TimerCancelRequest;
57
66
  [MindedConnectionSocketMessageType.TIMER_TRIGGER]: TimerTriggerRequest;
67
+ // Interrupt Session Management
68
+ [MindedConnectionSocketMessageType.INTERRUPT_SESSION_IS_PROCESSED]: InterruptSessionIsProcessedRequest;
69
+ [MindedConnectionSocketMessageType.INTERRUPT_SESSION_LOCK]: InterruptSessionLockRequest;
70
+ [MindedConnectionSocketMessageType.INTERRUPT_SESSION_RELEASE]: InterruptSessionReleaseRequest;
71
+ [MindedConnectionSocketMessageType.INTERRUPT_SESSION_ENQUEUE]: InterruptSessionEnqueueRequest;
72
+ [MindedConnectionSocketMessageType.INTERRUPT_SESSION_DEQUEUE_ALL]: InterruptSessionDequeueAllRequest;
73
+ [MindedConnectionSocketMessageType.INTERRUPT_SESSION_DEQUEUE]: InterruptSessionDequeueRequest;
74
+ [MindedConnectionSocketMessageType.INTERRUPT_SESSION_HAS_MESSAGES]: InterruptSessionHasMessagesRequest;
75
+ [MindedConnectionSocketMessageType.INTERRUPT_SESSION_GET_MESSAGES]: InterruptSessionGetMessagesRequest;
58
76
  };
59
77
 
60
78
  export interface BaseMindedConnectionSocketMessage {
@@ -178,3 +196,85 @@ export interface TimerTriggerRequest extends BaseMindedConnectionSocketMessage {
178
196
  timerName: string;
179
197
  eventArgs: Record<string, any>;
180
198
  }
199
+
200
+ // Interrupt Session Management Interfaces
201
+ export interface InterruptSessionIsProcessedRequest extends BaseMindedConnectionSocketMessage {
202
+ sessionId: string;
203
+ }
204
+
205
+ export interface InterruptSessionIsProcessedResponse extends BaseSdkConnectionSocketMessageResponseCallbackAck {
206
+ isProcessed?: boolean;
207
+ }
208
+
209
+ export interface InterruptSessionLockRequest extends BaseMindedConnectionSocketMessage {
210
+ sessionId: string;
211
+ }
212
+
213
+ export interface InterruptSessionLockResponse extends BaseSdkConnectionSocketMessageResponseCallbackAck {
214
+ success?: boolean;
215
+ }
216
+
217
+ export interface InterruptSessionReleaseRequest extends BaseMindedConnectionSocketMessage {
218
+ sessionId: string;
219
+ }
220
+
221
+ export interface InterruptSessionReleaseResponse extends BaseSdkConnectionSocketMessageResponseCallbackAck {
222
+ success?: boolean;
223
+ }
224
+
225
+ export interface InterruptSessionEnqueueRequest extends BaseMindedConnectionSocketMessage {
226
+ sessionId: string;
227
+ message: {
228
+ triggerBody: any;
229
+ triggerName: string;
230
+ appName?: string;
231
+ };
232
+ }
233
+
234
+ export interface InterruptSessionEnqueueResponse extends BaseSdkConnectionSocketMessageResponseCallbackAck {
235
+ success?: boolean;
236
+ }
237
+
238
+ export interface InterruptSessionDequeueAllRequest extends BaseMindedConnectionSocketMessage {
239
+ sessionId: string;
240
+ }
241
+
242
+ export interface InterruptSessionDequeueAllResponse extends BaseSdkConnectionSocketMessageResponseCallbackAck {
243
+ messages?: Array<{
244
+ triggerBody: any;
245
+ triggerName: string;
246
+ appName?: string;
247
+ }>;
248
+ }
249
+
250
+ export interface InterruptSessionDequeueRequest extends BaseMindedConnectionSocketMessage {
251
+ sessionId: string;
252
+ }
253
+
254
+ export interface InterruptSessionDequeueResponse extends BaseSdkConnectionSocketMessageResponseCallbackAck {
255
+ message?: {
256
+ triggerBody: any;
257
+ triggerName: string;
258
+ appName?: string;
259
+ } | null;
260
+ }
261
+
262
+ export interface InterruptSessionHasMessagesRequest extends BaseMindedConnectionSocketMessage {
263
+ sessionId: string;
264
+ }
265
+
266
+ export interface InterruptSessionHasMessagesResponse extends BaseSdkConnectionSocketMessageResponseCallbackAck {
267
+ hasMessages?: boolean;
268
+ }
269
+
270
+ export interface InterruptSessionGetMessagesRequest extends BaseMindedConnectionSocketMessage {
271
+ sessionId: string;
272
+ }
273
+
274
+ export interface InterruptSessionGetMessagesResponse extends BaseSdkConnectionSocketMessageResponseCallbackAck {
275
+ messages?: Array<{
276
+ triggerBody: any;
277
+ triggerName: string;
278
+ appName?: string;
279
+ }>;
280
+ }
@@ -29,18 +29,9 @@ export interface AgentInvokeParams {
29
29
  sessionId?: string;
30
30
  /** Optional name of the application triggering the agent in case of an app trigger */
31
31
  appName?: string;
32
+ /** Internal flag to bypass session processing check for recursive calls */
33
+ bypassSessionCheck?: boolean;
32
34
  }
33
-
34
- export enum HistoryStepType {
35
- APP_TRIGGER_NODE = 'appTriggerNode',
36
- TRIGGER_NODE = 'triggerNode',
37
- APP_ACTION_NODE = 'appActionNode',
38
- CUSTOM_ACTION_NODE = 'customActionNode',
39
- PROMPT_NODE = 'promptNode',
40
- JUMP_TO_NODE = 'jumpToNode',
41
- JUNCTION_NODE = 'junctionNode',
42
- }
43
-
44
35
  export interface HistoryStep {
45
36
  type: NodeType;
46
37
  step: number;
@@ -29,7 +29,9 @@ export const createStateAnnotation = <Memory = any>() =>
29
29
  default: () => [],
30
30
  reducer: (a, b) => a.concat(b),
31
31
  }),
32
- sessionId: Annotation<string>(),
32
+ sessionId: Annotation<string>({
33
+ reducer: (a, b) => b || a,
34
+ }),
33
35
  sessionType: Annotation<SessionType>({
34
36
  default: () => SessionType.TEXT,
35
37
  reducer: (a, b) => b || a,