npm - @minded-ai/mindedjs - Versions diffs - 1.0.19 → 1.0.21 - Mend

@minded-ai/mindedjs 1.0.19 → 1.0.21

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 (60) hide show

package/docs/api-reference/types/index.TriggerNode.html CHANGED Viewed

	@@ -1 +1 @@
1	- <!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>TriggerNode \| @~~agentsforce~~/~~sdk~~</title><meta name="description" content="Documentation for @~~agentsforce~~/~~sdk~~"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") \|\| "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">@~~agentsforce~~/~~sdk~~</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/index.html">index</a></li><li><a href="" aria-current="page">TriggerNode</a></li></ul><h1>Type Alias TriggerNode</h1></div><div class="tsd-signature"><span class="tsd-kind-type-alias">TriggerNode</span><span class="tsd-signature-symbol">:</span> <a href="../interfaces/index.AppTriggerNode.html" class="tsd-signature-type tsd-kind-interface">AppTriggerNode</a> <span class="tsd-signature-symbol">\|</span> <span class="tsd-signature-type">WebhookTriggerNode</span> <span class="tsd-signature-symbol">\|</span> <a href="../interfaces/index.ManualTriggerNode.html" class="tsd-signature-type tsd-kind-interface">ManualTriggerNode</a></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/agentsforce/mindedjs/blob/d3db8e73a98eb5a0ea8a43ace8e2bd5ceec39e5e/src/types/Flows.types.ts#L56">src/types/Flows.types.ts:56</a></li></ul></aside></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@~~agentsforce~~/~~sdk~~</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>
1	+ <!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>TriggerNode \| @minded-ai/mindedjs</title><meta name="description" content="Documentation for @minded-ai/mindedjs"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") \|\| "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">@minded-ai/mindedjs</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="../modules/index.html">index</a></li><li><a href="" aria-current="page">TriggerNode</a></li></ul><h1>Type Alias TriggerNode</h1></div><div class="tsd-signature"><span class="tsd-kind-type-alias">TriggerNode</span><span class="tsd-signature-symbol">:</span> <a href="../interfaces/index.AppTriggerNode.html" class="tsd-signature-type tsd-kind-interface">AppTriggerNode</a> <span class="tsd-signature-symbol">\|</span> <span class="tsd-signature-type">WebhookTriggerNode</span> <span class="tsd-signature-symbol">\|</span> <a href="../interfaces/index.ManualTriggerNode.html" class="tsd-signature-type tsd-kind-interface">ManualTriggerNode</a></div><aside class="tsd-sources"><ul><li>Defined in <a href="https://github.com/agentsforce/mindedjs/blob/d3db8e73a98eb5a0ea8a43ace8e2bd5ceec39e5e/src/types/Flows.types.ts#L56">src/types/Flows.types.ts:56</a></li></ul></aside></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">@minded-ai/mindedjs</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>

package/docs/examples/order-refund-flow.md CHANGED Viewed

@@ -517,7 +517,7 @@ export { agent, runRefundExample };
 1. **Install dependencies:**
 ```bash
-npm install @agentsforce/sdk langchain
+npm install @minded-ai/mindedjs langchain
 ```
 2. **Set up environment:**

package/docs/getting-started/installation.md CHANGED Viewed

@@ -12,19 +12,19 @@ Get MindedJS up and running in your project.
 {% tabs %}
 {% tab title="npm" %}
 ```bash
-npm i @agentsforce/sdk langchain
+npm i @minded-ai/mindedjs langchain
 ```
 {% endtab %}
 {% tab title="yarn" %}
 ```bash
-yarn add @agentsforce/sdk langchain
+yarn add @minded-ai/mindedjs langchain
 ```
 {% endtab %}
 {% tab title="pnpm" %}
 ```bash
-pnpm add @agentsforce/sdk langchain
+pnpm add @minded-ai/mindedjs langchain
 ```
 {% endtab %}
 {% endtabs %}

package/examples/orderRefundAgent/flows/orderRefundFlow.yaml CHANGED Viewed

@@ -2,7 +2,7 @@ name: 'Order refund flow'
 nodes:
   - type: 'trigger'
     triggerType: 'manual'
-    name: 'CLI Trigger'
+    name: 'New Direct Message (Instant)'
   - type: 'tool'
     name: 'Refund order'
     toolName: 'refundOrder'
@@ -17,9 +17,9 @@ nodes:
     llmConfig:
       name: 'ChatOpenAI'
       properties:
-        model: 'o3'
+        model: 'gpt-4o'
 edges:
-  - source: 'CLI Trigger'
+  - source: 'New Direct Message (Instant)'
     target: 'Prompt'
     type: 'stepForward'
   - source: 'Prompt'

package/examples/orderRefundAgent/orderRefundAgent.ts CHANGED Viewed

@@ -10,6 +10,7 @@ const agent = new Agent({
   memorySchema,
   config: mindedConfig,
   tools,
+  platformToken: '123',
 });
 agent.on(events.AI_MESSAGE, async ({ message }) => {
@@ -17,12 +18,17 @@ agent.on(events.AI_MESSAGE, async ({ message }) => {
 });
 agent.on(events.TRIGGER_EVENT, async ({ triggerName, triggerBody }) => {
-  if (triggerName === 'CLI Trigger') {
+  if (triggerName == 'onMessage') {
+    const text = triggerBody?.content;
     return {
       memory: {},
-      messages: [new HumanMessage(triggerBody)],
+      messages: [new HumanMessage({ content: text, response_metadata: {} })],
     };
   }
+  return {
+    memory: {},
+    messages: [new HumanMessage({ content: triggerBody?.event?.text || triggerBody?.text || 'Empty message', response_metadata: {} })],
+  };
 });
 const sendMessage = async (message: string) => {
@@ -49,7 +55,7 @@ if (process.env.NO_PLATFORM_CONNECT === 'true') {
     await agent.invoke({
       triggerBody: userInput,
-      triggerName: 'CLI Trigger',
+      triggerName: 'New Direct Message (Instant)',
       sessionId: 'cli-session',
     });

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@minded-ai/mindedjs",
-  "version": "1.0.19",
-  "description": "",
+  "version": "1.0.21",
+  "description": "MindedJS is a TypeScript library for building agents.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -21,12 +21,14 @@
     "@types/chai": "^4.3.11",
     "@types/mocha": "^10.0.6",
     "@types/node": "^20.11.19",
+    "@types/sinon": "^17.0.4",
     "chai": "^4.3.10",
     "dotenv": "^16.4.5",
     "eslint": "^9.27.0",
     "globals": "^16.2.0",
     "mocha": "^10.3.0",
     "nodemon": "^3.1.10",
+    "sinon": "^20.0.0",
     "ts-node": "^10.9.2",
     "typedoc": "^0.28.5",
     "typescript": "^5.3.3",

package/src/agent.ts CHANGED Viewed

@@ -3,7 +3,7 @@ import { Tool } from './types/Tools.types';
 import { v4 as uuidv4 } from 'uuid';
 import { BaseLanguageModel } from '@langchain/core/language_models/base';
 import { Command, StateGraph } from '@langchain/langgraph';
-import { MemorySaver, BaseCheckpointSaver } from '@langchain/langgraph';
+import { BaseCheckpointSaver } from '@langchain/langgraph';
 import { nodeFactory } from './nodes/nodeFactory';
 import { CompiledGraph, PreCompiledGraph, stateAnnotation } from './types/LangGraph.types';
 import { edgeFactory } from './edges/edgeFactory';
@@ -11,7 +11,7 @@ import { AgentEventRequestPayloads, AgentEventResponsePayloads, AgentEvents } fr
 import { z } from 'zod';
 import { MindedConnection } from './platform/mindedConnection';
-import { MindedConnectionSocketMessageType } from './platform/mindedConnectionTypes';
+import { BaseMindedConnectionSocketMessage, MindedConnectionSocketMessageType, OnAppTrigger } from './platform/mindedConnectionTypes';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as yaml from 'js-yaml';
@@ -19,6 +19,7 @@ import { MindedSDKConfig } from './types/Agent.types';
 import { createLlmInstance } from './llm/createLlmInstance';
 import { config } from 'dotenv';
 import { resolve } from 'path';
+import { createCheckpointSaver } from './checkpointer/checkpointSaverFactory';
 config({ path: resolve(__dirname, '../.env') });
@@ -55,15 +56,20 @@ export class Agent {
     this.tools = tools;
     this.platformToken = platformToken;
     this.llm = createLlmInstance(config.llm);
-    this.checkpointer = memorySaver || new MemorySaver();
+    this.checkpointer = memorySaver || createCheckpointSaver('');
     this.validate();
     this.compiledGraph = this.initializeGraph();
     if (process.env.NODE_ENV !== 'test' && process.env.NO_PLATFORM_CONNECT !== 'true') {
       this.mindedConnection = new MindedConnection();
       this.mindedConnection.start();
-      this.mindedConnection.on(MindedConnectionSocketMessageType.OnAppTrigger, (trigger) => {
-        console.log('Received trigger:', trigger);
+      this.mindedConnection.on(MindedConnectionSocketMessageType.OnAppTrigger, async (message: BaseMindedConnectionSocketMessage) => {
+        const trigger = message as OnAppTrigger;
+        await this.invoke({
+          triggerBody: trigger.body,
+          triggerName: trigger.name,
+          sessionId: trigger.cnvId,
+        });
       });
     }
   }
@@ -168,10 +174,10 @@ export class Agent {
     const messages = handlerResult?.messages ?? [];
     console.log(`Invoking trigger ${triggerName} with session ${session}`);
     const config = { configurable: { thread_id: session, recursionLimit: 3 } };
-    const triggerNode = this.compiledGraph.builder.nodes[triggerName];
-    if (!triggerNode) {
-      throw new Error(`Trigger node not found: ${triggerName}`);
-    }
+    // const triggerNode = this.compiledGraph.builder.nodes[triggerName];
+    // if (!triggerNode) {
+    //   throw new Error(`Trigger node not found: ${triggerName}`);
+    // }
     const state = await this.compiledGraph.getState(config);
     // Resume interruption
     if (state.tasks?.[0]?.interrupts?.length > 0) {

package/src/checkpointer/checkpointSaverFactory.ts ADDED Viewed

@@ -0,0 +1,31 @@
+import { BaseCheckpointSaver, MemorySaver } from '@langchain/langgraph';
+import { MindedCheckpointSaver } from '../platform/mindedCheckpointSaver';
+/**
+ * Factory function to create the appropriate checkpoint saver based on environment variables
+ * @param platformToken - Optional platform token for remote checkpoint saving
+ * @returns BaseCheckpointSaver instance (either MemorySaver or MindedCheckpointSaver)
+ */
+export function createCheckpointSaver(platformToken: string): BaseCheckpointSaver {
+  const useRemoteCheckpointSaver = process.env.REMOTE_CHECKPOINT_SAVER === 'true';
+  if (!useRemoteCheckpointSaver || process.env.NODE_ENV === 'test') {
+    console.log('Using in-memory checkpoint saver');
+    return new MemorySaver();
+  }
+  //   // If not using in-memory, check for platform token and MINDED_SERVER
+  //   if (!platformToken) {
+  //     console.warn('No platform token provided, falling back to in-memory checkpoint saver');
+  //     return new MemorySaver();
+  //   }
+  const mindedServer = process.env.MINDED_SERVER;
+  if (!mindedServer) {
+    console.warn('MINDED_SERVER environment variable not set, falling back to in-memory checkpoint saver');
+    return new MemorySaver();
+  }
+  console.log(`Using remote checkpoint saver with server: ${mindedServer}`);
+  return new MindedCheckpointSaver(platformToken);
+}

package/src/edges/createPromptRouter.ts CHANGED Viewed

@@ -25,7 +25,7 @@ Your task is to analyze the current memory state, history and available nodes an
 Available nodes in the format of {nodeId}: {prompt}:
-${edges.map((edge) => `- ${edge.target}: ${edge.prompt}`).join('\n')}
+${edges.map((edge) => `- {${edge.target}}: {${edge.prompt}}`).join('\n')}
 Current memory state:
 ${JSON.stringify(state.memory)}

package/src/platform/mindedCheckpointSaver.ts CHANGED Viewed

@@ -6,6 +6,7 @@ import {
   ChannelVersions,
   PendingWrite,
   CheckpointListOptions,
+  CheckpointPendingWrite,
 } from '@langchain/langgraph-checkpoint';
 import type { RunnableConfig } from '@langchain/core/runnables';
 import { mindedRequest } from './mindedRequest';
@@ -16,26 +17,82 @@ export class MindedCheckpointSaver extends BaseCheckpointSaver<number> {
   }
   async getTuple(config: RunnableConfig<Record<string, any>>): Promise<CheckpointTuple | undefined> {
-    return await mindedRequest<CheckpointTuple | undefined, { config: RunnableConfig<Record<string, any>> }>({
-      path: '/checkpoint/get',
+    const response = await mindedRequest<{ tuple: CheckpointTuple | undefined }, { config: RunnableConfig<Record<string, any>> }>({
+      path: '/sdk-checkpoints/getTuple',
       method: 'POST',
       body: { config },
       token: this.token,
     });
+    if (!response.tuple) {
+      return undefined;
+    }
+    const tuple = response.tuple;
+    // Re-serialize and deserialize checkpoint to restore class information
+    const [checkpointType, serializedCheckpoint] = this.serde.dumpsTyped(tuple.checkpoint);
+    const checkpoint = (await this.serde.loadsTyped(checkpointType, serializedCheckpoint)) as Checkpoint;
+    // Re-serialize and deserialize metadata to restore class information
+    const metadata = tuple.metadata
+      ? (() => {
+          const [metadataType, serializedMetadata] = this.serde.dumpsTyped(tuple.metadata);
+          return this.serde.loadsTyped(metadataType, serializedMetadata) as CheckpointMetadata;
+        })()
+      : undefined;
+    // Re-serialize and deserialize pending writes to restore class information
+    const pendingWrites: CheckpointPendingWrite[] = tuple.pendingWrites
+      ? await Promise.all(
+          tuple.pendingWrites.map(async (write) => {
+            const [taskId, channel, value] = write;
+            const [valueType, serializedValue] = this.serde.dumpsTyped(value);
+            const deserializedValue = await this.serde.loadsTyped(valueType, serializedValue);
+            return [taskId, channel, deserializedValue] as CheckpointPendingWrite;
+          }),
+        )
+      : [];
+    return {
+      config: tuple.config,
+      checkpoint,
+      metadata: await metadata,
+      parentConfig: tuple.parentConfig,
+      pendingWrites,
+    };
   }
   async *list(config: RunnableConfig<Record<string, any>>, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple, any, any> {
-    const tuples = await mindedRequest<CheckpointTuple[], { config: RunnableConfig<Record<string, any>>; options?: CheckpointListOptions }>(
-      {
-        path: '/checkpoint/list',
-        method: 'POST',
-        body: { config, options },
-        token: this.token,
-      },
-    );
+    const response = await mindedRequest<
+      { checkpoints: CheckpointTuple[] },
+      { config: RunnableConfig<Record<string, any>>; options?: CheckpointListOptions }
+    >({
+      path: '/sdk-checkpoints/list',
+      method: 'POST',
+      body: { config, options },
+      token: this.token,
+    });
+    for (const tuple of response.checkpoints) {
+      // Re-serialize and deserialize checkpoint to restore class information
+      const [checkpointType, serializedCheckpoint] = this.serde.dumpsTyped(tuple.checkpoint);
+      const checkpoint = (await this.serde.loadsTyped(checkpointType, serializedCheckpoint)) as Checkpoint;
+      // Re-serialize and deserialize metadata to restore class information
+      const metadata = tuple.metadata
+        ? (() => {
+            const [metadataType, serializedMetadata] = this.serde.dumpsTyped(tuple.metadata);
+            return this.serde.loadsTyped(metadataType, serializedMetadata) as CheckpointMetadata;
+          })()
+        : undefined;
-    for (const tuple of tuples) {
-      yield tuple;
+      yield {
+        config: tuple.config,
+        checkpoint,
+        metadata: await metadata,
+        parentConfig: tuple.parentConfig,
+      };
     }
   }
@@ -45,8 +102,8 @@ export class MindedCheckpointSaver extends BaseCheckpointSaver<number> {
     metadata: CheckpointMetadata,
     newVersions: ChannelVersions,
   ): Promise<RunnableConfig<Record<string, any>>> {
-    const newConfig = await mindedRequest<
-      RunnableConfig<Record<string, any>>,
+    const response = await mindedRequest<
+      { config: RunnableConfig<Record<string, any>> },
       {
         config: RunnableConfig<Record<string, any>>;
         checkpoint: Checkpoint<string, string>;
@@ -54,18 +111,18 @@ export class MindedCheckpointSaver extends BaseCheckpointSaver<number> {
         newVersions: ChannelVersions;
       }
     >({
-      path: '/checkpoint/put',
+      path: '/sdk-checkpoints/put',
       method: 'POST',
       body: { config, checkpoint, metadata, newVersions },
       token: this.token,
     });
-    return newConfig;
+    return response.config;
   }
   async putWrites(config: RunnableConfig<Record<string, any>>, writes: PendingWrite[], taskId: string): Promise<void> {
-    await mindedRequest<void, { config: RunnableConfig<Record<string, any>>; writes: PendingWrite[]; taskId: string }>({
-      path: '/checkpoint/put-writes',
+    await mindedRequest({
+      path: '/sdk-checkpoints/putWrites',
       method: 'POST',
       body: { config, writes, taskId },
       token: this.token,

package/src/platform/mindedConnection.ts CHANGED Viewed

@@ -1,106 +1,150 @@
 import { io, Socket } from 'socket.io-client';
 import * as readline from 'readline';
 import { BaseMindedConnectionSocketMessage, MindedConnectionSocketMessageType } from './mindedConnectionTypes';
+import * as fs from 'fs';
+import * as path from 'path';
 export class MindedConnection {
   private socket: Socket | null = null;
   private rl: readline.Interface | null = null;
+  private readonly tokenPath = path.join(process.cwd(), '.minded-token');
   listeners: {
-    [key: string]: ((message: BaseMindedConnectionSocketMessage) => void)[]
+    [key: string]: ((message: BaseMindedConnectionSocketMessage) => void)[];
   } = {};
   constructor() {
-    if (!process.env.MINDED_CONNECTION_TOKEN) {
-      this.rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout
-      });
+    if (!process.env.MINDED_CONNECTION_TOKEN && !this.getSavedToken()) {
+      this.initializeReadline();
+    }
+  }
+  private initializeReadline() {
+    this.rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+  }
+  private getSavedToken(): string | null {
+    try {
+      if (fs.existsSync(this.tokenPath)) {
+        return fs.readFileSync(this.tokenPath, 'utf8').trim();
+      }
+    } catch (error) {
+      console.error('Error reading token file:', error);
+    }
+    return null;
+  }
+  private saveToken(token: string): void {
+    try {
+      fs.writeFileSync(this.tokenPath, token);
+    } catch (error) {
+      console.error('Error saving token:', error);
     }
   }
   private async getMindedToken(): Promise<string> {
     const envToken = process.env.MINDED_CONNECTION_TOKEN;
     if (envToken) {
+      this.saveToken(envToken);
       return envToken;
     }
+    const savedToken = this.getSavedToken();
+    if (savedToken) {
+      return savedToken;
+    }
+    if (!this.rl) {
+      this.initializeReadline();
+    }
     return new Promise((resolve) => {
       this.rl!.question('Enter your Minded connection token: ', (token: string) => {
-        resolve(token);
+        this.saveToken(token.trim());
+        resolve(token.trim());
       });
     });
   }
-  public on = (
-    event: MindedConnectionSocketMessageType,
-    callback: (message: BaseMindedConnectionSocketMessage) => void,
-  ) => {
+  public on = (event: MindedConnectionSocketMessageType, callback: (message: BaseMindedConnectionSocketMessage) => void) => {
     if (!this.listeners[event]) {
       this.listeners[event] = [];
     }
     this.listeners[event].push(callback);
   };
-  public emit = (
-    event: MindedConnectionSocketMessageType,
-    message: BaseMindedConnectionSocketMessage,
-  ) => {
+  public emit = (event: MindedConnectionSocketMessageType, message: BaseMindedConnectionSocketMessage) => {
     if (this.socket) {
       this.socket.emit(event, message);
     }
   };
+  private async connect(token: string) {
+    this.socket = io('http://localhost:8888', {
+      path: '/minded-connect',
+      query: {
+        token,
+      },
+    });
-  public start(): void {
-    this.getMindedToken().then(token => {
-      this.socket = io('http://localhost:8888', {
-        path: '/minded-connect',
-        query: {
-          token
-        }
-      });
-      // Connection event handlers
-      this.socket.on('connect', () => {
-        console.log('\x1b[32mConnection with Minded platform is live!\x1b[0m');
-        console.log('\x1b[36mPress Ctrl+C to exit.\x1b[0m');
-      });
+    // Connection event handlers
+    this.socket.on('connect', () => {
+      console.log('\x1b[32mConnection with Minded platform is live!\x1b[0m');
+      console.log('\x1b[36mPress Ctrl+C to exit.\x1b[0m');
+    });
-      this.socket.on('connect_error', () => {
-        console.error('Failed to connect to minded platform');
-      });
+    this.socket.on('connect_error', () => {
+      console.error('Failed to connect to minded platform');
+    });
-      this.socket.on('disconnect', () => {
-        console.log('Disconnected from local debugging socket');
+    this.socket.on('disconnect', () => {
+      console.log('Disconnected from local debugging socket');
+    });
-      });
+    // Listen for error messages from the server
+    this.socket.on('error', async (error: { message: string }) => {
+      console.error('Server error:', error.message);
-      // Listen for error messages from the server
-      this.socket.on('error', (error: { message: string }) => {
-        console.error('Server error:', error.message);
-      });
-      // Listen for specific message types
-      this.socket.onAny((event, message) => {
-        if (this.listeners[event]) {
-          this.listeners[event].forEach((listener) => {
-            listener(message);
-          });
+      if (error.message.includes('Invalid token')) {
+        // Delete saved token on connection error
+        if (fs.existsSync(this.tokenPath)) {
+          fs.unlinkSync(this.tokenPath);
         }
-      });
-      // Handle process termination
-      process.on('SIGINT', () => {
+        // Disconnect current socket
         if (this.socket?.connected) {
-          console.log('\nDisconnecting...');
           this.socket.disconnect();
         }
-        process.exit(0);
-      });
+        // Get new token and reconnect
+        const newToken = await this.getMindedToken();
+        await this.connect(newToken);
+      }
+    });
+    // Listen for specific message types
+    this.socket.onAny((event, message) => {
+      if (this.listeners[event]) {
+        this.listeners[event].forEach((listener) => {
+          listener(message);
+        });
+      }
+    });
+    // Handle process termination
+    process.on('SIGINT', () => {
+      if (this.socket?.connected) {
+        console.log('\nDisconnecting...');
+        this.socket.disconnect();
+      }
+      process.exit(0);
     });
+  }
+  public async start(): Promise<void> {
+    const token = await this.getMindedToken();
+    await this.connect(token);
   }
-}
+}

package/src/platform/mindedConnectionTypes.ts CHANGED Viewed

@@ -1,5 +1,4 @@
-export enum MindedConnectionSocketMessageType {
+export enum MindedConnectionSocketMessageType {
   OnAppTrigger = 'on-app-trigger',
 }
@@ -7,9 +6,9 @@ export interface BaseMindedConnectionSocketMessage {
   type: MindedConnectionSocketMessageType;
 }
-export interface OnAppTrigger extends BaseMindedConnectionSocketMessage {
+export interface OnAppTrigger extends BaseMindedConnectionSocketMessage {
   name: string;
+  agentId: string;
   body: Record<string, any>;
+  cnvId: string;
 }

package/src/platform/mindedRequest.ts CHANGED Viewed

@@ -1,5 +1,4 @@
 import axios from 'axios';
-const baseUrl = 'https://api.minded.com/sdk';
 type Method = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
@@ -14,6 +13,8 @@ export const mindedRequest = async <Response, Request = object>({
   body: Request;
   token: string;
 }): Promise<Response> => {
+  const baseUrl = process.env.MINDED_SERVER || 'https://api.minded.com/sdk';
   const response = await axios({
     method,
     url: `${baseUrl}${path}`,