@loopman/langchain-sdk 1.8.0 → 1.12.1

package/examples/templates/langgraph-hello-world/index.ts

@@ -0,0 +1,147 @@
+import { HumanMessage, ToolMessage } from "@langchain/core/messages";
+import { END, MemorySaver, START, StateGraph } from "@langchain/langgraph";
+import { ChatOpenAI } from "@langchain/openai";
+import { config } from "dotenv";
+import { tool } from "langchain";
+import * as z from "zod";
+
+import {
+  LoopmanGraphState,
+  createLoopmanConditionalEdge,
+  createLoopmanContextNode,
+  createLoopmanValidationNode,
+  enrichSystemPrompt,
+} from "@loopman/langchain-sdk";
+
+config();
+
+// Define your tools
+const sayHello = tool(
+  ({ name }) => {
+    console.log(`Hello, ${name}!`);
+    return `Hello, ${name}! Welcome to Loopman.`;
+  },
+  {
+    name: "say_hello",
+    description: "Say hello to someone",
+    schema: z.object({
+      name: z.string().describe("The name of the person to greet"),
+    }),
+  }
+);
+
+// Agent node with context enrichment
+async function agentNode(state: any) {
+  const { messages, guidelines, decisionContext } = state;
+
+  // Enrich system prompt with guidelines and decision history
+  const systemPrompt = enrichSystemPrompt(
+    "You are a helpful assistant that greets people ....",
+    { guidelines, decisionContext },
+    { maxDecisions: 3 }
+  );
+
+  const model = new ChatOpenAI({ model: "gpt-4o-mini" });
+  const modelWithTools = model.bindTools([sayHello]);
+
+  const messagesWithContext =
+    (guidelines && guidelines.length > 0) ||
+    (decisionContext && decisionContext.length > 0)
+      ? [{ role: "system", content: systemPrompt }, ...messages]
+      : messages;
+
+  const response = await modelWithTools.invoke(messagesWithContext);
+
+  return {
+    messages: [response],
+    requiresValidation: response.tool_calls && response.tool_calls.length > 0,
+  };
+}
+
+// Tool execution node
+async function toolNode(state: any) {
+  const { messages } = state;
+  const lastMessage = messages[messages.length - 1];
+
+  if (!lastMessage.tool_calls || lastMessage.tool_calls.length === 0) {
+    return {};
+  }
+
+  const toolCall = lastMessage.tool_calls[0];
+  const result = await sayHello.invoke(toolCall.args);
+
+  return {
+    messages: [
+      new ToolMessage({
+        content: result,
+        tool_call_id: toolCall.id,
+      }),
+    ],
+  };
+}
+
+// Build the graph with context loading
+const workflow = new StateGraph(LoopmanGraphState)
+  .addNode(
+    "load_context",
+    createLoopmanContextNode({
+      apiKey: process.env.LOOPMAN_API_KEY!,
+      workflowId: process.env.LOOPMAN_WORKFLOW_ID!,
+      category: "hello-world",
+      debug: true,
+    })
+  )
+  .addNode("agent", agentNode)
+  .addNode(
+    "loopman_validation",
+    createLoopmanValidationNode({
+      apiKey: process.env.LOOPMAN_API_KEY!,
+      workflowId: process.env.LOOPMAN_WORKFLOW_ID!,
+      debug: true,
+    })
+  )
+  .addNode("tools", toolNode)
+  .addEdge(START, "load_context")
+  .addEdge("load_context", "agent")
+  .addEdge("agent", "loopman_validation")
+  .addConditionalEdges(
+    "loopman_validation",
+    createLoopmanConditionalEdge({ debug: true }),
+    {
+      execute: "tools",
+      rejected: END,
+      retry: "agent",
+      timeout: END,
+      error: END,
+    }
+  )
+  .addEdge("tools", END);
+
+// Compile and run
+const checkpointer = new MemorySaver();
+const app = workflow.compile({ checkpointer });
+
+async function main() {
+  const config = { configurable: { thread_id: "hello-world-thread" } };
+  const inputs = {
+    messages: [new HumanMessage("Say hello to Alice")],
+  };
+
+  console.log("Starting LangGraph workflow with context enrichment...");
+
+  for await (const output of await app.stream(inputs, config)) {
+    const nodeName = Object.keys(output)[0];
+    console.log(`Step: ${nodeName}`);
+  }
+
+  const finalState = await app.getState(config);
+  console.log("Final status:", finalState.values.loopmanTaskStatus);
+  console.log("Guidelines loaded:", finalState.values.guidelines?.length || 0);
+  console.log(
+    "Decision context loaded:",
+    finalState.values.decisionContext?.length || 0
+  );
+  console.log("Workflow completed!");
+}
+
+main().catch(console.error);

package/examples/templates/langgraph-hello-world/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "loopman-langgraph-hello-world",
+  "version": "1.0.0",
+  "description": "Loopman LangGraph Hello World Example",
+  "main": "index.ts",
+  "type": "module",
+  "scripts": {
+    "start": "tsx index.ts",
+    "dev": "tsx index.ts",
+    "build": "tsc",
+    "run": "node dist/index.js"
+  },
+  "dependencies": {
+    "@langchain/core": "^1.0.2",
+    "@langchain/langgraph": "^1.0.1",
+    "@langchain/openai": "^1.0.0",
+    "@loopman/langchain-sdk": "^1.12.1",
+    "dotenv": "^17.2.3",
+    "langchain": "^1.0.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.9.2"
+  }
+}

package/examples/templates/langgraph-hello-world/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": ["ES2022"],
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "outDir": "./dist",
+    "rootDir": "./",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}
+

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@loopman/langchain-sdk",
-  "version": "1.8.0",
+  "version": "1.12.1",
   "description": "LangChain TypeScript SDK - Human-in-the-Loop validation via Loopman platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsc",
+    "build": "npm run export-templates && tsc",
     "clean": "rm -rf dist",
-    "release": "./scripts/release.sh"
+    "release": "./scripts/release.sh",
+    "export-templates": "mkdir -p dist && node scripts/export-templates.js",
+    "example:langgraph-full-state": "tsx examples/5-langgraph-integration/full-state-example.ts"
   },
   "keywords": [
     "langchain",
@@ -41,7 +43,8 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "examples/templates"
   ],
   "dependencies": {
     "@langchain/core": "^1.0.2",