@runflow-ai/sdk 1.0.55 → 1.0.58

package/README.md

@@ -69,7 +69,58 @@ pnpm add @runflow-ai/sdk
 
 - **Node.js**: >= 22.0.0
 - **TypeScript**: >= 5.0.0 (recommended)
-- **Zod**: ^3.22.0 (included as dependency)
+
+### 📚 Built-in Libraries
+
+The SDK includes the following libraries out-of-the-box. **No need to install them separately** - they're available in all your agents:
+
+| Library | Version | Description | Import |
+|---------|---------|-------------|--------|
+| **axios** | ^1.7.0 | HTTP client for API requests | `import axios from 'axios'` |
+| **zod** | ^3.22.0 | Schema validation and TypeScript inference | `import { z } from 'zod'` |
+| **date-fns** | ^3.0.0 | Modern date utility library | `import { format, addDays } from 'date-fns'` |
+| **lodash** | ^4.17.21 | JavaScript utility library | `import _ from 'lodash'` |
+| **cheerio** | ^1.0.0 | Fast, flexible HTML/XML parsing | `import * as cheerio from 'cheerio'` |
+| **pino** | ^8.19.0 | Fast JSON logger | `import pino from 'pino'` |
+
+**Quick Examples:**
+
+```typescript
+import { createTool } from '@runflow-ai/sdk';
+import { z } from 'zod';
+import axios from 'axios';
+import { format, addDays } from 'date-fns';
+import _ from 'lodash';
+
+const myTool = createTool({
+  id: 'example-tool',
+  description: 'Shows all available libraries',
+  inputSchema: z.object({
+    url: z.string().url(),
+    data: z.array(z.any()),
+  }),
+  execute: async ({ context }) => {
+    // ✅ HTTP requests with axios
+    const response = await axios.get(context.url);
+    
+    // ✅ Date manipulation
+    const tomorrow = addDays(new Date(), 1);
+    const formatted = format(tomorrow, 'yyyy-MM-dd');
+    
+    // ✅ Array/Object utilities with lodash
+    const unique = _.uniq(context.data);
+    const grouped = _.groupBy(context.data, 'category');
+    
+    return { response: response.data, date: formatted, unique, grouped };
+  },
+});
+```
+
+> 💡 **Tip**: You can also use the SDK's HTTP helpers for convenience:
+> ```typescript
+> import { httpGet, httpPost } from '@runflow-ai/sdk/http';
+> const data = await httpGet('https://api.example.com/data');
+> ```
 
 ---
 
@@ -738,6 +789,247 @@ The `execute` function receives:
 
 ---
 
+### HTTP Utilities
+
+The **HTTP** module provides pre-configured utilities for making HTTP requests in tools and agents. Built on top of **axios**, it comes with sensible defaults, automatic error handling, and full TypeScript support.
+
+#### Features
+
+- 🌐 **Pre-configured axios instance** with 30s timeout
+- 🛡️ **Automatic error handling** with enhanced error messages
+- 🎯 **Helper functions** for common HTTP methods (GET, POST, PUT, PATCH, DELETE)
+- 📦 **Zero configuration** - works out of the box
+- 🔒 **Type-safe** - Full TypeScript support with exported types
+- ⚡ **Available in all agents** - No need to install additional dependencies
+
+#### Quick Start
+
+```typescript
+import { createTool } from '@runflow-ai/sdk';
+import { http, httpGet, httpPost } from '@runflow-ai/sdk/http';
+import { z } from 'zod';
+
+const weatherTool = createTool({
+  id: 'get-weather',
+  description: 'Get current weather for a city',
+  inputSchema: z.object({
+    city: z.string(),
+  }),
+  execute: async ({ context }) => {
+    try {
+      // Option 1: Using httpGet helper (simplest)
+      const data = await httpGet('https://api.openweathermap.org/data/2.5/weather', {
+        params: {
+          q: context.city,
+          appid: process.env.OPENWEATHER_API_KEY,
+          units: 'metric',
+        },
+      });
+
+      return {
+        city: data.name,
+        temperature: data.main.temp,
+        condition: data.weather[0].description,
+      };
+    } catch (error: any) {
+      return { error: `Failed to fetch weather: ${error.message}` };
+    }
+  },
+});
+```
+
+#### Helper Functions
+
+The SDK provides convenient helper functions that automatically extract data from responses:
+
+```typescript
+import { httpGet, httpPost, httpPut, httpPatch, httpDelete } from '@runflow-ai/sdk/http';
+
+// GET request - returns only the data payload
+const user = await httpGet('https://api.example.com/users/123');
+console.log(user.name);
+
+// POST request
+const newUser = await httpPost('https://api.example.com/users', {
+  name: 'John Doe',
+  email: 'john@example.com',
+});
+
+// PUT request
+const updated = await httpPut('https://api.example.com/users/123', {
+  name: 'Jane Doe',
+});
+
+// PATCH request
+const patched = await httpPatch('https://api.example.com/users/123', {
+  email: 'newemail@example.com',
+});
+
+// DELETE request
+await httpDelete('https://api.example.com/users/123');
+```
+
+#### Using the HTTP Instance
+
+For more control, use the pre-configured `http` instance directly:
+
+```typescript
+import { http } from '@runflow-ai/sdk/http';
+
+// GET with full response
+const response = await http.get('https://api.example.com/data');
+console.log(response.status);
+console.log(response.headers);
+console.log(response.data);
+
+// POST with custom headers
+const response = await http.post(
+  'https://api.example.com/resource',
+  { data: 'value' },
+  {
+    headers: {
+      'Authorization': `Bearer ${process.env.API_TOKEN}`,
+      'Content-Type': 'application/json',
+    },
+    timeout: 5000,
+  }
+);
+
+// Multiple requests in parallel
+const [users, posts, comments] = await Promise.all([
+  http.get('https://api.example.com/users'),
+  http.get('https://api.example.com/posts'),
+  http.get('https://api.example.com/comments'),
+]);
+```
+
+#### Advanced: Direct Axios Usage
+
+For complete control, use axios directly:
+
+```typescript
+import { axios } from '@runflow-ai/sdk/http';
+
+// Create a custom instance
+const customAPI = axios.create({
+  baseURL: 'https://api.example.com',
+  headers: {
+    'Authorization': `Bearer ${process.env.API_TOKEN}`,
+  },
+  timeout: 10000,
+});
+
+// Add interceptors
+customAPI.interceptors.request.use((config) => {
+  console.log(`Request: ${config.method?.toUpperCase()} ${config.url}`);
+  return config;
+});
+
+// Use the custom instance
+const response = await customAPI.get('/users');
+```
+
+#### Error Handling
+
+All HTTP utilities provide enhanced error messages:
+
+```typescript
+import { httpGet } from '@runflow-ai/sdk/http';
+
+try {
+  const data = await httpGet('https://api.example.com/data');
+  return { success: true, data };
+} catch (error: any) {
+  // Error message includes HTTP status and details
+  console.error(error.message);
+  // "HTTP GET failed: HTTP 404: Not Found"
+  
+  return { success: false, error: error.message };
+}
+```
+
+#### TypeScript Types
+
+All axios types are re-exported for convenience:
+
+```typescript
+import type {
+  AxiosInstance,
+  AxiosRequestConfig,
+  AxiosResponse,
+  AxiosError,
+} from '@runflow-ai/sdk/http';
+
+async function fetchData(
+  url: string,
+  config?: AxiosRequestConfig
+): Promise<AxiosResponse> {
+  const response = await http.get(url, config);
+  return response;
+}
+```
+
+#### Complete Example: Weather Tool
+
+```typescript
+import { Agent, openai, createTool } from '@runflow-ai/sdk';
+import { httpGet } from '@runflow-ai/sdk/http';
+import { z } from 'zod';
+
+const weatherTool = createTool({
+  id: 'get-weather',
+  description: 'Get current weather for any city',
+  inputSchema: z.object({
+    city: z.string().describe('City name (e.g., "São Paulo", "New York")'),
+  }),
+  execute: async ({ context }) => {
+    try {
+      const apiKey = process.env.OPENWEATHER_API_KEY;
+      
+      const data = await httpGet('https://api.openweathermap.org/data/2.5/weather', {
+        params: {
+          q: context.city,
+          appid: apiKey,
+          units: 'metric',
+          lang: 'pt_br',
+        },
+        timeout: 5000,
+      });
+
+      return {
+        city: data.name,
+        temperature: data.main.temp,
+        feelsLike: data.main.feels_like,
+        condition: data.weather[0].description,
+        humidity: data.main.humidity,
+        windSpeed: data.wind.speed,
+      };
+    } catch (error: any) {
+      if (error.message.includes('404')) {
+        return { error: `City "${context.city}" not found` };
+      }
+      throw new Error(`Weather API error: ${error.message}`);
+    }
+  },
+});
+
+const agent = new Agent({
+  name: 'Weather Assistant',
+  instructions: 'You help users check the weather. Use the weather tool when users ask about weather conditions.',
+  model: openai('gpt-4o'),
+  tools: {
+    weather: weatherTool,
+  },
+});
+
+// Use the agent
+const result = await agent.process({
+  message: 'What is the weather like in São Paulo?',
+});
+```
+
+---
+
 ### Connectors
 
 **Connectors** are dynamic integrations with external services defined in the Runflow backend. Connector tools automatically load schemas from the backend, support mock execution, and handle path parameters seamlessly.

package/dist/http/index.d.ts

@@ -0,0 +1,101 @@
+import axios, { AxiosInstance, AxiosRequestConfig, AxiosResponse, AxiosError } from 'axios';
+/**
+ * Pre-configured axios instance with sensible defaults for agent tools
+ *
+ * @example
+ * ```typescript
+ * import { http } from '@runflow-ai/sdk/http';
+ *
+ * const response = await http.get('https://api.example.com/data');
+ * console.log(response.data);
+ * ```
+ */
+export declare const http: AxiosInstance;
+/**
+ * Utility function to make GET requests with automatic error handling
+ * Returns only the data payload for convenience
+ *
+ * @example
+ * ```typescript
+ * import { httpGet } from '@runflow-ai/sdk/http';
+ *
+ * const data = await httpGet('https://api.example.com/users/123');
+ * console.log(data.name);
+ * ```
+ */
+export declare function httpGet<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+/**
+ * Utility function to make POST requests with automatic error handling
+ * Returns only the data payload for convenience
+ *
+ * @example
+ * ```typescript
+ * import { httpPost } from '@runflow-ai/sdk/http';
+ *
+ * const data = await httpPost('https://api.example.com/users', {
+ *   name: 'John Doe',
+ *   email: 'john@example.com'
+ * });
+ * console.log(data.id);
+ * ```
+ */
+export declare function httpPost<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+/**
+ * Utility function to make PUT requests with automatic error handling
+ * Returns only the data payload for convenience
+ *
+ * @example
+ * ```typescript
+ * import { httpPut } from '@runflow-ai/sdk/http';
+ *
+ * const data = await httpPut('https://api.example.com/users/123', {
+ *   name: 'Jane Doe'
+ * });
+ * ```
+ */
+export declare function httpPut<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+/**
+ * Utility function to make PATCH requests with automatic error handling
+ * Returns only the data payload for convenience
+ *
+ * @example
+ * ```typescript
+ * import { httpPatch } from '@runflow-ai/sdk/http';
+ *
+ * const data = await httpPatch('https://api.example.com/users/123', {
+ *   email: 'newemail@example.com'
+ * });
+ * ```
+ */
+export declare function httpPatch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+/**
+ * Utility function to make DELETE requests with automatic error handling
+ * Returns only the data payload for convenience
+ *
+ * @example
+ * ```typescript
+ * import { httpDelete } from '@runflow-ai/sdk/http';
+ *
+ * await httpDelete('https://api.example.com/users/123');
+ * ```
+ */
+export declare function httpDelete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+/**
+ * Re-export axios for advanced users who need full control
+ *
+ * @example
+ * ```typescript
+ * import { axios } from '@runflow-ai/sdk/http';
+ *
+ * const customInstance = axios.create({
+ *   baseURL: 'https://api.example.com',
+ *   headers: { 'Authorization': 'Bearer token' }
+ * });
+ * ```
+ */
+export { axios };
+/**
+ * Re-export axios types for convenience
+ */
+export type { AxiosInstance, AxiosRequestConfig, AxiosResponse, AxiosError, };
+//# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAE5F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,EAAE,aAMjB,CAAC;AA6BH;;;;;;;;;;;GAWG;AACH,wBAAsB,OAAO,CAAC,CAAC,GAAG,GAAG,EACnC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,CAAC,GAAG,GAAG,EACnC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAAC,CAAC,GAAG,GAAG,EACrC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,GAAG,EACtC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB;;GAEG;AACH,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,UAAU,GACX,CAAC"}

package/dist/http/index.js

@@ -0,0 +1,161 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.axios = exports.http = void 0;
+exports.httpGet = httpGet;
+exports.httpPost = httpPost;
+exports.httpPut = httpPut;
+exports.httpPatch = httpPatch;
+exports.httpDelete = httpDelete;
+const axios_1 = __importDefault(require("axios"));
+exports.axios = axios_1.default;
+/**
+ * Pre-configured axios instance with sensible defaults for agent tools
+ *
+ * @example
+ * ```typescript
+ * import { http } from '@runflow-ai/sdk/http';
+ *
+ * const response = await http.get('https://api.example.com/data');
+ * console.log(response.data);
+ * ```
+ */
+exports.http = axios_1.default.create({
+    timeout: 30000, // 30 seconds
+    headers: {
+        'User-Agent': 'Runflow-Agent/1.0',
+        'Accept': 'application/json',
+    },
+});
+// Add request interceptor for logging (optional)
+exports.http.interceptors.request.use((config) => {
+    // You can add request logging here if needed
+    return config;
+}, (error) => {
+    return Promise.reject(error);
+});
+// Add response interceptor for error handling
+exports.http.interceptors.response.use((response) => response, (error) => {
+    // Enhance error message
+    if (error.response) {
+        // Server responded with error status
+        error.message = `HTTP ${error.response.status}: ${error.response.statusText}`;
+    }
+    else if (error.request) {
+        // No response received
+        error.message = 'No response received from server';
+    }
+    return Promise.reject(error);
+});
+/**
+ * Utility function to make GET requests with automatic error handling
+ * Returns only the data payload for convenience
+ *
+ * @example
+ * ```typescript
+ * import { httpGet } from '@runflow-ai/sdk/http';
+ *
+ * const data = await httpGet('https://api.example.com/users/123');
+ * console.log(data.name);
+ * ```
+ */
+async function httpGet(url, config) {
+    try {
+        const response = await exports.http.get(url, config);
+        return response.data;
+    }
+    catch (error) {
+        throw new Error(`HTTP GET failed: ${error.message}`);
+    }
+}
+/**
+ * Utility function to make POST requests with automatic error handling
+ * Returns only the data payload for convenience
+ *
+ * @example
+ * ```typescript
+ * import { httpPost } from '@runflow-ai/sdk/http';
+ *
+ * const data = await httpPost('https://api.example.com/users', {
+ *   name: 'John Doe',
+ *   email: 'john@example.com'
+ * });
+ * console.log(data.id);
+ * ```
+ */
+async function httpPost(url, data, config) {
+    try {
+        const response = await exports.http.post(url, data, config);
+        return response.data;
+    }
+    catch (error) {
+        throw new Error(`HTTP POST failed: ${error.message}`);
+    }
+}
+/**
+ * Utility function to make PUT requests with automatic error handling
+ * Returns only the data payload for convenience
+ *
+ * @example
+ * ```typescript
+ * import { httpPut } from '@runflow-ai/sdk/http';
+ *
+ * const data = await httpPut('https://api.example.com/users/123', {
+ *   name: 'Jane Doe'
+ * });
+ * ```
+ */
+async function httpPut(url, data, config) {
+    try {
+        const response = await exports.http.put(url, data, config);
+        return response.data;
+    }
+    catch (error) {
+        throw new Error(`HTTP PUT failed: ${error.message}`);
+    }
+}
+/**
+ * Utility function to make PATCH requests with automatic error handling
+ * Returns only the data payload for convenience
+ *
+ * @example
+ * ```typescript
+ * import { httpPatch } from '@runflow-ai/sdk/http';
+ *
+ * const data = await httpPatch('https://api.example.com/users/123', {
+ *   email: 'newemail@example.com'
+ * });
+ * ```
+ */
+async function httpPatch(url, data, config) {
+    try {
+        const response = await exports.http.patch(url, data, config);
+        return response.data;
+    }
+    catch (error) {
+        throw new Error(`HTTP PATCH failed: ${error.message}`);
+    }
+}
+/**
+ * Utility function to make DELETE requests with automatic error handling
+ * Returns only the data payload for convenience
+ *
+ * @example
+ * ```typescript
+ * import { httpDelete } from '@runflow-ai/sdk/http';
+ *
+ * await httpDelete('https://api.example.com/users/123');
+ * ```
+ */
+async function httpDelete(url, config) {
+    try {
+        const response = await exports.http.delete(url, config);
+        return response.data;
+    }
+    catch (error) {
+        throw new Error(`HTTP DELETE failed: ${error.message}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"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"}

package/dist/observability/logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/observability/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AA+DD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAuDlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAE1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAiClE"}
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/observability/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AA+DD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CA6DlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAE1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAsClE"}

package/dist/observability/logging.js

@@ -97,8 +97,14 @@ function log(name, data) {
         custom: {
             customLog: true
         },
-        // ✅ Não espalha todo o state para evitar conflito de threadId
-        // O TraceCollector já tem o contexto correto via setContext()
+        // ✅ Passar campos do state como fallback
+        // Se TraceCollector tiver context setado via setContext(), ele sobrescreve
+        // Se não tiver (auto-init), usa esses valores
+        threadId: state.threadId,
+        userId: state.userId,
+        sessionId: state.sessionId,
+        entityType: state.entityType,
+        entityValue: state.entityValue,
     }, parentTraceId // ✅ Conecta na hierarquia se houver parent ativo
     );
     if (typeof data === 'object' && data !== null) {
@@ -164,7 +170,12 @@ function logError(name, error) {
             errorType: error instanceof Error ? error.name : 'Error',
             errorMessage: error instanceof Error ? error.message : String(error)
         },
-        // ✅ Não espalha todo o state para evitar conflito de threadId
+        // ✅ Passar campos do state como fallback
+        threadId: state.threadId,
+        userId: state.userId,
+        sessionId: state.sessionId,
+        entityType: state.entityType,
+        entityValue: state.entityValue,
     }, parentTraceId // ✅ Conecta na hierarquia se houver parent ativo
     );
     span?.setError(error);

package/dist/observability/logging.js.map

@@ -1 +1 @@
-{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/observability/logging.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/observability/logging.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA0FH,kBA6DC;AAYD,4BAEC;AAaD,4BAsCC;AAtND,6CAA0C;AAa1C,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,SAAS,iBAAiB;IACxB,yBAAyB;IACzB,IAAK,MAAc,CAAC,uBAAuB,EAAE,CAAC;QAC5C,OAAQ,MAAc,CAAC,uBAAuB,CAAC;IACjD,CAAC;IAED,oDAAoD;IACpD,IAAI,CAAC;QACH,MAAM,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC9D,MAAM,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAEjE,MAAM,SAAS,GAAG,sBAAsB,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,eAAe,CAAC;QAElE,MAAM,SAAS,GAAG,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE;YAC3D,SAAS,EAAE,CAAC;YACZ,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QAEH,mBAAmB;QAClB,MAAc,CAAC,uBAAuB,GAAG,SAAS,CAAC;QAEpD,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;QAC7F,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,IAAI,cAA0C,CAAC;AAE/C,SAAS,iBAAiB;IACxB,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAC3C,IAAI,CAAC,cAAc;QAAE,OAAO;IAE5B,uBAAuB;IACvB,IAAI,cAAc,EAAE,CAAC;QACnB,YAAY,CAAC,cAAc,CAAC,CAAC;IAC/B,CAAC;IAED,wCAAwC;IACxC,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE;QAC/B,cAAc,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YACjC,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,IAAI,CAAC,CAAC;AACX,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACH,SAAgB,GAAG,CAAC,IAAY,EAAE,IAAU;IAC1C,MAAM,KAAK,GAAG,iBAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,mBAAmB,EAAE,CAAC;IAE/D,wDAAwD;IACxD,2DAA2D;IAC3D,MAAM,aAAa,GAAI,MAAc,CAAC,yBAAyB,CAAC;IAEhE,0EAA0E;IAC1E,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,IAAI,aAAa,EAAE,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,sBAAsB,aAAa,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CACnC,cAAc,EACd;QACE,WAAW;QACX,SAAS,EAAE,IAAI;QACf,MAAM,EAAE;YACN,SAAS,EAAE,IAAI;SAChB;QACD,yCAAyC;QACzC,2EAA2E;QAC3E,8CAA8C;QAC9C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,EACD,aAAa,CAAE,iDAAiD;KACjE,CAAC;IAEF,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;QAED,8DAA8D;QAC9D,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzF,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iBAAiB,EAAE,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CAAC,IAAY,EAAE,IAAa;IAClD,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,QAAQ,CAAC,IAAY,EAAE,KAAqB;IAC1D,MAAM,KAAK,GAAG,iBAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,mBAAmB,EAAE,CAAC;IAE/D,wDAAwD;IACxD,MAAM,aAAa,GAAI,MAAc,CAAC,yBAAyB,CAAC;IAEhE,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CACnC,aAAa,EACb;QACE,WAAW;QACX,SAAS,EAAE,IAAI;QACf,MAAM,EAAE;YACN,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;YACxD,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SACrE;QACD,yCAAyC;QACzC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,EACD,aAAa,CAAE,iDAAiD;KACjE,CAAC;IAEF,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEtB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iBAAiB,EAAE,CAAC;AACtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runflow-ai/sdk",
-  "version": "1.0.55",
+  "version": "1.0.58",
   "description": "Runflow SDK - Multi-agent AI framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -65,6 +65,11 @@
       "import": "./dist/providers/index.js",
       "require": "./dist/providers/index.js",
       "types": "./dist/providers/index.d.ts"
+    },
+    "./http": {
+      "import": "./dist/http/index.js",
+      "require": "./dist/http/index.js",
+      "types": "./dist/http/index.d.ts"
     }
   },
   "scripts": {
@@ -76,11 +81,16 @@
     "publish:safe": "npm run validate && npm publish"
   },
   "dependencies": {
+    "axios": "^1.7.0",
+    "cheerio": "^1.0.0-rc.12",
+    "date-fns": "^3.0.0",
+    "lodash": "^4.17.21",
     "pino": "^8.19.0",
     "pino-pretty": "^10.3.1",
     "zod": "^3.22.0"
   },
   "devDependencies": {
+    "@types/lodash": "^4.14.202",
     "@types/node": "^20.0.0",
     "@types/jest": "^30.0.0",
     "jest": "^30.0.5",