@minded-ai/mindedjs 2.0.19 → 2.0.21-beta-analytics-1

package/src/events/AgentEvents.ts

@@ -9,6 +9,7 @@ export enum AgentEvents {
   ERROR = 'ERROR',
   ON_LOGICAL_CONDITION = 'ON_LOGICAL_CONDITION',
   ON_LOGICAL_CONDITION_RESULT = 'ON_LOGICAL_CONDITION_RESULT',
+  ANALYTICS_EVENT = 'ANALYTICS_EVENT',
 }
 
 export type AgentEventRequestPayloads<Memory> = {
@@ -40,6 +41,11 @@ export type AgentEventRequestPayloads<Memory> = {
     executionTimeMs: number;
     error?: Error;
   };
+  [AgentEvents.ANALYTICS_EVENT]: {
+    eventName: string;
+    payload: Record<string, any>;
+    sessionId: string;
+  };
 };
 
 export type AgentEventResponsePayloads = {
@@ -55,4 +61,5 @@ export type AgentEventResponsePayloads = {
   [AgentEvents.ON_LOGICAL_CONDITION_RESULT]: {
     throwError: boolean;
   };
+  [AgentEvents.ANALYTICS_EVENT]: void;
 };

package/src/nodes/addAppToolNode.ts

@@ -27,8 +27,6 @@ export const addAppToolNode = async ({
   agent: Agent;
   tools: Tool<any, any>[];
 }) => {
-  const cleanedParameters = Object.fromEntries(Object.entries(node.parameters || {}).filter(([, value]) => value !== ''));
-
   // Find the tool from the tools array by name
   const appRunnerTool = tools.find((tool) => tool.name === node.displayName);
 
@@ -39,6 +37,21 @@ export const addAppToolNode = async ({
   const callback: RunnableLike = async (state: typeof stateAnnotation.State) => {
     logger.debug({ msg: `[Node] Executing tool node`, node: appRunnerTool.name });
 
+    // Compile parameters with variable injection support
+    const compiledParameters: Record<string, any> = {};
+    const compileContext = { state, memory: state.memory, env: process.env };
+
+    for (const [key, value] of Object.entries(node.parameters || {})) {
+      if (value !== '') {
+        // If the value is a string, compile it to allow variable injection
+        if (typeof value === 'string') {
+          compiledParameters[key] = compilePrompt(value, compileContext);
+        } else {
+          compiledParameters[key] = value;
+        }
+      }
+    }
+
     const executeWrapper = async (input: z.infer<typeof appRunnerTool.input>) => {
       try {
         const response = await appRunnerTool.execute({ input, state, agent });
@@ -56,6 +69,9 @@ export const addAppToolNode = async ({
 
     const combinedPlaybooks = combinePlaybooks(agent.playbooks) || '';
 
+    // Compile the prompt if it exists to allow variable injection
+    const compiledNodePrompt = node.prompt ? compilePrompt(node.prompt, compileContext) : null;
+
     const message = `${combinedPlaybooks ? combinedPlaybooks + '\n\n' : ''}
     Additional context:
     previous messages are available for context.
@@ -66,9 +82,9 @@ export const addAppToolNode = async ({
     - User instructions for choosing tool parameters that are not set by the user (if any)
     - Workflow memory
     Parameters manually configured by the user are:
-    ${JSON.stringify(cleanedParameters)}
+    ${JSON.stringify(compiledParameters)}
     User instructions for choosing tool parameters are:
-        ${node.prompt ? `${node.prompt}` : 'no instructions set by the user'}`;
+        ${compiledNodePrompt ? compiledNodePrompt : 'no instructions set by the user'}`;
 
     const compiledPrompt = compilePrompt(message, { state: state, memory: state.memory, env: process.env });
     const systemMessage = new SystemMessage(compiledPrompt);
@@ -81,7 +97,7 @@ export const addAppToolNode = async ({
     const AIToolCallMessage = await llm.bindTools([tool], { tool_choice: tool.name }).invoke(state.messages);
     AIToolCallMessage.tool_calls[0].args = {
       ...AIToolCallMessage.tool_calls[0].args,
-      ...cleanedParameters, //user set parameters have priority over ai generated parameters
+      ...compiledParameters, //user set parameters have priority over ai generated parameters
     };
     const toolCallMessage = await tool.invoke(AIToolCallMessage.tool_calls[0]);
     AIToolCallMessage.additional_kwargs = {

package/src/nodes/addBrowserTaskRunNode.ts

@@ -73,6 +73,7 @@ export const addBrowserTaskRunNode = async ({ graph, browserTaskNode, attachedTo
         hasResult: !!result.result,
         stepCount: result.steps?.length || 0,
         recordingCount: result.recordings?.length || 0,
+        downloadedFilesCount: result.downloadedFiles?.length || 0,
       });
 
       // Create tool message with the result
@@ -83,6 +84,7 @@ export const addBrowserTaskRunNode = async ({ graph, browserTaskNode, attachedTo
           steps: result.steps || [],
           recordings: result.recordings || [],
           inputParams: inputParams,
+          downloadedFiles: result.downloadedFiles || [],
         }),
         name: 'browser-task',
         tool_call_id: toolCall.id,
@@ -95,6 +97,7 @@ export const addBrowserTaskRunNode = async ({ graph, browserTaskNode, attachedTo
             steps: result.steps,
             recordings: result.recordings,
             inputParams: inputParams,
+            downloadedFiles: result.downloadedFiles || [],
           },
         },
       });
@@ -111,6 +114,7 @@ export const addBrowserTaskRunNode = async ({ graph, browserTaskNode, attachedTo
             nodeDisplayName: browserTaskNode.displayName,
             steps: result.steps,
             recordings: result.recordings,
+            downloadedFiles: result.downloadedFiles || [],
             status: 'completed',
           },
           update: true, // This triggers the message reducer to update the existing message

package/src/platform/mindedConnectionTypes.ts

@@ -56,6 +56,8 @@ export enum mindedConnectionSocketMessageType {
   // Tool execution
   EXECUTE_TOOL = 'execute-tool',
   VECTORSTORE_QUERY = 'vectorstore-query',
+  // Analytics
+  ANALYTICS_EVENT = 'analytics-event',
 }
 
 export type mindedConnectionSocketMessageTypeMap = {
@@ -100,6 +102,7 @@ export type mindedConnectionSocketMessageTypeMap = {
   [mindedConnectionSocketMessageType.INTERRUPT_SESSION_GET_MESSAGES]: InterruptSessionGetMessagesRequest;
   [mindedConnectionSocketMessageType.EXECUTE_TOOL]: ExecuteToolRequest;
   [mindedConnectionSocketMessageType.VECTORSTORE_QUERY]: VectorStoreQueryRequest;
+  [mindedConnectionSocketMessageType.ANALYTICS_EVENT]: AnalyticsEventRequest;
 };
 
 export interface BasemindedConnectionSocketMessage {
@@ -471,6 +474,7 @@ export interface InvokeBrowserTaskResponse extends BaseSdkConnectionSocketMessag
   result?: any;
   steps?: any[];
   recordings?: any[];
+  downloadedFiles?: string[];
 }
 
 export interface ExecuteToolRequest extends BasemindedConnectionSocketMessage {
@@ -504,3 +508,14 @@ export interface VectorStoreQueryResponse extends BaseSdkConnectionSocketMessage
     metadata: Record<string, any>;
   }>;
 }
+
+export interface AnalyticsEventRequest extends BasemindedConnectionSocketMessage {
+  type: mindedConnectionSocketMessageType.ANALYTICS_EVENT;
+  eventName: string;
+  payload: Record<string, any>;
+  sessionId: string;
+}
+
+export interface AnalyticsEventResponse extends BaseSdkConnectionSocketMessageResponseCallbackAck {
+  success?: boolean;
+}

package/src/types/Agent.types.ts

@@ -15,6 +15,10 @@ export type MindedSDKConfig = {
    * Optional directories containing playbook definition files. If omitted, no playbooks will be loaded.
    */
   playbooks?: string[];
+  /**
+   * Optional recursion limit for LangGraph execution. Defaults to 25 if not specified.
+   */
+  recursionLimit?: number;
 };
 
 /**

package/src/types/Analytics.types.ts

@@ -0,0 +1,26 @@
+/**
+ * Enum of default analytics event names emitted by the SDK
+ */
+export enum AnalyticsEventName {
+  INVOCATION_START = 'invocation_start',
+  // Future events can be added here:
+  // INVOCATION_END = 'invocation_end',
+  // INVOCATION_ERROR = 'invocation_error',
+  // TOOL_EXECUTION_START = 'tool_execution_start',
+  // TOOL_EXECUTION_END = 'tool_execution_end',
+  // NODE_TRANSITION = 'node_transition',
+  // VOICE_SESSION_START = 'voice_session_start',
+  // VOICE_SESSION_END = 'voice_session_end',
+}
+
+/**
+ * Interface for analytics events
+ */
+export interface AnalyticsEvent {
+  /** The name of the event being tracked */
+  eventName: string;
+  /** The data payload associated with the event */
+  payload: Record<string, any>;
+  /** Session ID associated with the event (required) */
+  sessionId: string;
+}