langwatch 0.1.7 → 0.3.0-prerelease.1

package/examples/langchain/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "langchain-sdk-example",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "start": "tsc && dotenv -- node dist/index.js",
+    "build": "tsc",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "LangWatch",
+  "type": "module",
+  "license": "MIT",
+  "dependencies": {
+    "@langchain/openai": "^0.6.3",
+    "@langchain/core": "^0.3.66",
+    "langchain": "^0.3.30",
+    "@opentelemetry/context-async-hooks": "^2.0.1",
+    "@opentelemetry/sdk-node": "^0.203.0",
+    "cli-markdown": "^3.5.1",
+    "dotenv-cli": "^10.0.0",
+    "langwatch": "file:../../"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  }
+}

package/examples/langchain/src/cli-markdown.d.ts

@@ -0,0 +1,137 @@
+declare module 'cli-markdown' {
+  export interface CliMarkdownOptions {
+    /**
+     * Custom styles for different markdown elements
+     */
+    styles?: {
+      /**
+       * Style for headings (h1, h2, h3, etc.)
+       */
+      heading?: string;
+      /**
+       * Style for bold text
+       */
+      bold?: string;
+      /**
+       * Style for italic text
+       */
+      italic?: string;
+      /**
+       * Style for code blocks
+       */
+      code?: string;
+      /**
+       * Style for inline code
+       */
+      inlineCode?: string;
+      /**
+       * Style for links
+       */
+      link?: string;
+      /**
+       * Style for lists
+       */
+      list?: string;
+      /**
+       * Style for blockquotes
+       */
+      blockquote?: string;
+      /**
+       * Style for horizontal rules
+       */
+      hr?: string;
+    };
+    /**
+     * Whether to preserve line breaks
+     */
+    preserveLineBreaks?: boolean;
+    /**
+     * Custom renderer functions for different markdown elements
+     */
+    renderers?: {
+      /**
+       * Custom renderer for headings
+       */
+      heading?: (text: string, level: number) => string;
+      /**
+       * Custom renderer for paragraphs
+       */
+      paragraph?: (text: string) => string;
+      /**
+       * Custom renderer for lists
+       */
+      list?: (items: string[], ordered: boolean) => string;
+      /**
+       * Custom renderer for list items
+       */
+      listItem?: (text: string, index: number) => string;
+      /**
+       * Custom renderer for code blocks
+       */
+      code?: (code: string, language?: string) => string;
+      /**
+       * Custom renderer for inline code
+       */
+      inlineCode?: (code: string) => string;
+      /**
+       * Custom renderer for links
+       */
+      link?: (text: string, url: string) => string;
+      /**
+       * Custom renderer for images
+       */
+      image?: (alt: string, url: string) => string;
+      /**
+       * Custom renderer for blockquotes
+       */
+      blockquote?: (text: string) => string;
+      /**
+       * Custom renderer for horizontal rules
+       */
+      hr?: () => string;
+      /**
+       * Custom renderer for emphasis (bold/italic)
+       */
+      emphasis?: (text: string, type: 'bold' | 'italic') => string;
+    };
+    /**
+     * Maximum width for text wrapping
+     */
+    maxWidth?: number;
+    /**
+     * Whether to enable ANSI color codes
+     */
+    colors?: boolean;
+    /**
+     * Custom color theme
+     */
+    theme?: {
+      /**
+       * Color for headings
+       */
+      heading?: string;
+      /**
+       * Color for links
+       */
+      link?: string;
+      /**
+       * Color for code
+       */
+      code?: string;
+      /**
+       * Color for blockquotes
+       */
+      blockquote?: string;
+    };
+  }
+
+  /**
+   * Converts markdown text to formatted CLI output
+   * @param markdown - The markdown text to convert
+   * @param options - Configuration options for the conversion
+   * @returns Formatted CLI text
+   */
+  function cliMarkdown(markdown: string, options?: CliMarkdownOptions): string;
+
+  export = cliMarkdown;
+}

package/examples/langchain/src/index.ts

@@ -0,0 +1,109 @@
+import { setupLangWatch } from "langwatch/node";
+import { LangWatchCallbackHandler } from "langwatch/observability/instrumentation/langchain";
+import { getLangWatchTracer } from "langwatch";
+import { semconv } from "langwatch/observability";
+import { ChatOpenAI } from "@langchain/openai";
+import { HumanMessage, SystemMessage } from "@langchain/core/messages";
+import * as readline from "readline";
+import cliMarkdown from "cli-markdown";
+
+await setupLangWatch();
+
+const tracer = getLangWatchTracer("langchain-sdk-example");
+
+async function main() {
+  const threadId = crypto.randomUUID();
+  const langWatchCallback = new LangWatchCallbackHandler();
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  console.log('🤖 AI Chatbot started! Type "quit" to exit.');
+  console.log("---");
+
+  // Initialize LangChain chat model
+  const chatModel = new ChatOpenAI({
+    modelName: "gpt-4o-mini",
+    temperature: 0.7,
+    callbacks: [langWatchCallback],
+  });
+
+  const conversationHistory: Array<HumanMessage | SystemMessage> = [
+    new SystemMessage(
+      "You are a helpful assistant that can answer questions and help with tasks. You may use markdown to format your responses."
+    ),
+  ];
+
+  while (true) {
+    let finish = false;
+
+    await tracer.withActiveSpan("iteration", {
+      attributes: {
+        [semconv.ATTR_LANGWATCH_THREAD_ID]: threadId,
+      },
+    }, async (span) => {
+      try {
+        // Get user input
+        const userInput = await new Promise<string>((resolve) => {
+          rl.question("You: ", resolve);
+        });
+
+        // Check for exit command
+        if (
+          userInput.toLowerCase() === "quit" ||
+          userInput.toLowerCase() === "exit"
+        ) {
+          console.log("👋 Goodbye!");
+          finish = true;
+          return;
+        }
+
+        // Skip empty input
+        if (!userInput.trim()) {
+          return;
+        }
+
+        // Add user message to conversation history
+        conversationHistory.push(new HumanMessage(userInput));
+
+        // Generate AI response
+        console.log("🤖 Thinking...");
+
+        const result = await chatModel.invoke(conversationHistory, { callbacks: [] });
+        const aiResponse = result.content as string;
+
+        // Add AI response to conversation history
+        conversationHistory.push(result);
+
+        // Display AI response with markdown formatting
+        console.log("AI:");
+        console.log(
+          `${cliMarkdown(aiResponse, {
+            colors: true,
+            maxWidth: 80,
+            theme: {
+              heading: "cyan",
+              link: "blue",
+              code: "green",
+              blockquote: "yellow",
+            },
+          })}---`,
+        );
+      } catch (error) {
+        console.error("❌ Error:", error);
+        console.log("Please try again.");
+      }
+    });
+
+    if (finish) {
+      break;
+    }
+  }
+
+  rl.close();
+}
+
+// Run the chatbot
+main().catch(console.error);

package/examples/langchain/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "node16",
+    "moduleResolution": "node16",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/examples/langgraph/.env.example

@@ -0,0 +1,2 @@
+LANGWATCH_API_KEY=""
+OPENAI_API_KEY=""

package/examples/langgraph/README.md

@@ -0,0 +1,42 @@
+# LangGraph Example
+
+This directory contains examples of AI apps built with the LangWatch SDK and LangGraph.
+
+## Example
+
+### Basic Chatbot (`src/index.ts`)
+
+A simple chatbot that handles basic conversation flow using LangGraph:
+
+- **Features:**
+  - Basic conversation loop
+  - User input handling
+  - AI response generation using LangGraph
+  - Conversation history management
+  - Error handling
+  - Exit commands (`quit`, `exit`)
+
+- **Usage:**
+  ```bash
+  npm run start
+  ```
+
+## Troubleshooting
+
+### Common Issues:
+
+1. **"Cannot find module 'langwatch/node'"**
+   - Make sure you've built the LangWatch SDK
+   - Check that the package is properly built
+
+2. **OpenAI API errors**
+   - Verify your API key is set correctly
+   - Check your OpenAI account has sufficient credits
+
+3. **TypeScript compilation errors**
+   - Run `npm run start` to check for type errors
+   - Ensure all dependencies are installed
+
+4. **LangGraph import errors**
+   - Make sure all LangGraph dependencies are installed
+   - Check that the LangGraph version is compatible