@runflow-ai/sdk 1.0.88 → 1.0.90

package/dist/tools/web-search/formatter.d.ts

@@ -0,0 +1,7 @@
+import { WebSearchResponse } from './types';
+/**
+ * Format a WebSearchResponse as markdown for LLM consumption.
+ * Kept concise to avoid token waste.
+ */
+export declare function formatForLLM(response: WebSearchResponse): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/tools/web-search/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../../src/tools/web-search/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CA2BhE"}

package/dist/tools/web-search/formatter.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatForLLM = formatForLLM;
+/**
+ * Format a WebSearchResponse as markdown for LLM consumption.
+ * Kept concise to avoid token waste.
+ */
+function formatForLLM(response) {
+    const lines = [];
+    if (response.answer) {
+        lines.push(`**Answer:** ${response.answer}`);
+        lines.push('');
+    }
+    if (!response.results || response.results.length === 0) {
+        lines.push('No results found.');
+        return lines.join('\n');
+    }
+    lines.push('**Search Results:**');
+    lines.push('');
+    response.results.forEach((result, index) => {
+        const num = index + 1;
+        lines.push(`${num}. [${result.title}](${result.url})`);
+        lines.push(`   ${result.snippet}`);
+        if (result.publishedDate) {
+            lines.push(`   *Published: ${result.publishedDate}*`);
+        }
+        lines.push('');
+    });
+    return lines.join('\n').trimEnd();
+}
+//# sourceMappingURL=formatter.js.map

package/dist/tools/web-search/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../../src/tools/web-search/formatter.ts"],"names":[],"mappings":";;AAMA,oCA2BC;AA/BD;;;GAGG;AACH,SAAgB,YAAY,CAAC,QAA2B;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACzC,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/tools/web-search/index.d.ts

@@ -0,0 +1,29 @@
+import { WebSearchConfig, WebSearchResponse } from './types';
+import type { RunflowTool } from '../../types';
+export type { WebSearchConfig, WebSearchResponse, WebSearchResult, WebSearchProvider } from './types';
+/**
+ * Execute a web search programmatically.
+ *
+ * - Standalone mode: if `config.apiKey` is provided, calls the search provider directly.
+ * - Platform mode: uses the Runflow platform connector infrastructure (no apiKey needed).
+ *
+ * @example
+ * // Standalone (direct API key)
+ * const result = await webSearch('latest AI news', { provider: 'tavily', apiKey: 'tvly-...' });
+ *
+ * // Platform connector
+ * const result = await webSearch('latest AI news', { connector: 'tavily-default' });
+ */
+export declare function webSearch(query: string, config?: WebSearchConfig): Promise<WebSearchResponse>;
+/**
+ * Create a RunflowTool that performs web searches, ready for use in agents.
+ *
+ * @example
+ * import { Agent, createWebSearchTool } from '@runflow-ai/sdk';
+ *
+ * const agent = new Agent({
+ *   tools: [createWebSearchTool({ provider: 'tavily', apiKey: process.env.TAVILY_API_KEY })],
+ * });
+ */
+export declare function createWebSearchTool(config?: WebSearchConfig): RunflowTool;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/web-search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/web-search/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAK7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEtG;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,eAAoB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAiC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,eAAoB,GAAG,WAAW,CA8B7E"}

package/dist/tools/web-search/index.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webSearch = webSearch;
+exports.createWebSearchTool = createWebSearchTool;
+const zod_1 = require("zod");
+const providers_1 = require("./providers");
+const formatter_1 = require("./formatter");
+const tool_creator_1 = require("../tool-creator");
+const api_client_1 = require("../../core/api-client");
+/**
+ * Execute a web search programmatically.
+ *
+ * - Standalone mode: if `config.apiKey` is provided, calls the search provider directly.
+ * - Platform mode: uses the Runflow platform connector infrastructure (no apiKey needed).
+ *
+ * @example
+ * // Standalone (direct API key)
+ * const result = await webSearch('latest AI news', { provider: 'tavily', apiKey: 'tvly-...' });
+ *
+ * // Platform connector
+ * const result = await webSearch('latest AI news', { connector: 'tavily-default' });
+ */
+async function webSearch(query, config = {}) {
+    const provider = config.provider ?? 'tavily';
+    // Standalone mode: direct provider call
+    if (config.apiKey) {
+        const adapter = (0, providers_1.getSearchProvider)(provider);
+        return adapter.search(query, config);
+    }
+    // Platform mode: use connector infrastructure
+    const api = (0, api_client_1.createRunflowAPIClient)();
+    const connectorSlug = config.connector ?? `${provider}-default`;
+    const rawResponse = await api.connector(connectorSlug, 'search', {
+        query,
+        maxResults: config.maxResults,
+        searchDepth: config.searchDepth,
+        includeContent: config.includeContent,
+    });
+    // Normalize the connector response into WebSearchResponse
+    // The platform connector is expected to return a compatible shape.
+    // If the platform returns a non-standard shape, adapt it here.
+    if (rawResponse && Array.isArray(rawResponse.results)) {
+        return rawResponse;
+    }
+    // Fallback: wrap raw results if the connector returns a different shape
+    return {
+        query,
+        results: Array.isArray(rawResponse) ? rawResponse : [],
+        answer: rawResponse?.answer,
+    };
+}
+/**
+ * Create a RunflowTool that performs web searches, ready for use in agents.
+ *
+ * @example
+ * import { Agent, createWebSearchTool } from '@runflow-ai/sdk';
+ *
+ * const agent = new Agent({
+ *   tools: [createWebSearchTool({ provider: 'tavily', apiKey: process.env.TAVILY_API_KEY })],
+ * });
+ */
+function createWebSearchTool(config = {}) {
+    const inputSchema = zod_1.z.object({
+        query: zod_1.z.string().describe('The search query to look up on the internet'),
+        maxResults: zod_1.z
+            .number()
+            .optional()
+            .describe('Maximum number of results to return (default: 5)'),
+    });
+    const tool = (0, tool_creator_1.createTool)({
+        id: 'web_search',
+        description: 'Search the internet for current information. Use this when you need up-to-date data, facts, news, or information not in your training data.',
+        inputSchema,
+        execute: async ({ context }) => {
+            const mergedConfig = {
+                ...config,
+                maxResults: context.maxResults ?? config.maxResults,
+            };
+            const response = await webSearch(context.query, mergedConfig);
+            return (0, formatter_1.formatForLLM)(response);
+        },
+    });
+    // Attach metadata for introspection
+    tool._isWebSearchTool = true;
+    tool._provider = config.provider ?? 'tavily';
+    return tool;
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/web-search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/web-search/index.ts"],"names":[],"mappings":";;AAwBA,8BAoCC;AAYD,kDA8BC;AAtGD,6BAAwB;AAExB,2CAAgD;AAChD,2CAA2C;AAC3C,kDAA6C;AAC7C,sDAA+D;AAM/D;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,SAAS,CAC7B,KAAa,EACb,SAA0B,EAAE;IAE5B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,QAAQ,CAAC;IAE7C,wCAAwC;IACxC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,IAAA,6BAAiB,EAAC,QAAQ,CAAC,CAAC;QAC5C,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,8CAA8C;IAC9C,MAAM,GAAG,GAAG,IAAA,mCAAsB,GAAE,CAAC;IAErC,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,IAAI,GAAG,QAAQ,UAAU,CAAC;IAChE,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,aAAa,EAAE,QAAQ,EAAE;QAC/D,KAAK;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC,CAAC;IAEH,0DAA0D;IAC1D,mEAAmE;IACnE,+DAA+D;IAC/D,IAAI,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,OAAO,WAAgC,CAAC;IAC1C,CAAC;IAED,wEAAwE;IACxE,OAAO;QACL,KAAK;QACL,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;QACtD,MAAM,EAAE,WAAW,EAAE,MAAM;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,mBAAmB,CAAC,SAA0B,EAAE;IAC9D,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;QAC3B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACzE,UAAU,EAAE,OAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kDAAkD,CAAC;KAChE,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,IAAA,yBAAU,EAAC;QACtB,EAAE,EAAE,YAAY;QAChB,WAAW,EACT,6IAA6I;QAC/I,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC7B,MAAM,YAAY,GAAoB;gBACpC,GAAG,MAAM;gBACT,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU;aACpD,CAAC;YAEF,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;YAC9D,OAAO,IAAA,wBAAY,EAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;KACF,CAAC,CAAC;IAEH,oCAAoC;IACnC,IAAY,CAAC,gBAAgB,GAAG,IAAI,CAAC;IACrC,IAAY,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,IAAI,QAAQ,CAAC;IAEtD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/web-search/providers/exa.d.ts

@@ -0,0 +1,5 @@
+import { SearchProviderAdapter, WebSearchConfig, WebSearchResponse } from '../types';
+export declare class ExaProvider implements SearchProviderAdapter {
+    search(query: string, config: WebSearchConfig): Promise<WebSearchResponse>;
+}
+//# sourceMappingURL=exa.d.ts.map

package/dist/tools/web-search/providers/exa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exa.d.ts","sourceRoot":"","sources":["../../../../src/tools/web-search/providers/exa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAmB,MAAM,UAAU,CAAC;AAoBtG,qBAAa,WAAY,YAAW,qBAAqB;IACjD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAqDjF"}

package/dist/tools/web-search/providers/exa.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExaProvider = void 0;
+class ExaProvider {
+    async search(query, config) {
+        const apiKey = config.apiKey;
+        if (!apiKey) {
+            throw new Error('Exa API key is required');
+        }
+        const body = {
+            query,
+            numResults: config.maxResults ?? 5,
+            contents: {
+                text: config.includeContent ?? false,
+                highlights: true,
+            },
+            type: 'neural',
+        };
+        const response = await fetch('https://api.exa.ai/search', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': apiKey,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Exa API error ${response.status}: ${errorText}`);
+        }
+        const data = (await response.json());
+        const results = data.results.map((r) => {
+            const snippet = r.highlights && r.highlights.length > 0
+                ? r.highlights.map((h) => h.text).join(' ... ')
+                : (r.text ?? '');
+            return {
+                title: r.title,
+                url: r.url,
+                snippet,
+                content: r.text,
+                score: r.score,
+                publishedDate: r.publishedDate,
+            };
+        });
+        return {
+            query,
+            results,
+        };
+    }
+}
+exports.ExaProvider = ExaProvider;
+//# sourceMappingURL=exa.js.map

package/dist/tools/web-search/providers/exa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exa.js","sourceRoot":"","sources":["../../../../src/tools/web-search/providers/exa.ts"],"names":[],"mappings":";;;AAoBA,MAAa,WAAW;IACtB,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,MAAuB;QACjD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,IAAI,GAAG;YACX,KAAK;YACL,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;YAClC,QAAQ,EAAE;gBACR,IAAI,EAAE,MAAM,CAAC,cAAc,IAAI,KAAK;gBACpC,UAAU,EAAE,IAAI;aACjB;YACD,IAAI,EAAE,QAAQ;SACf,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,2BAA2B,EAAE;YACxD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,MAAM;aACpB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAC;QAEvD,MAAM,OAAO,GAAsB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACxD,MAAM,OAAO,GACX,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;gBACrC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;gBAC/C,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAErB,OAAO;gBACL,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,OAAO;gBACP,OAAO,EAAE,CAAC,CAAC,IAAI;gBACf,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,aAAa,EAAE,CAAC,CAAC,aAAa;aAC/B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,KAAK;YACL,OAAO;SACR,CAAC;IACJ,CAAC;CACF;AAtDD,kCAsDC"}

package/dist/tools/web-search/providers/index.d.ts

@@ -0,0 +1,6 @@
+import { SearchProviderAdapter, WebSearchProvider } from '../types';
+export declare function getSearchProvider(name: WebSearchProvider): SearchProviderAdapter;
+export { TavilyProvider } from './tavily';
+export { ExaProvider } from './exa';
+export { SerperProvider } from './serper';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/web-search/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/web-search/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKpE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,qBAAqB,CAahF;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/tools/web-search/providers/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SerperProvider = exports.ExaProvider = exports.TavilyProvider = void 0;
+exports.getSearchProvider = getSearchProvider;
+const tavily_1 = require("./tavily");
+const exa_1 = require("./exa");
+const serper_1 = require("./serper");
+function getSearchProvider(name) {
+    switch (name) {
+        case 'tavily':
+            return new tavily_1.TavilyProvider();
+        case 'exa':
+            return new exa_1.ExaProvider();
+        case 'serper':
+            return new serper_1.SerperProvider();
+        default: {
+            const _exhaustive = name;
+            throw new Error(`Unknown web search provider: ${_exhaustive}`);
+        }
+    }
+}
+var tavily_2 = require("./tavily");
+Object.defineProperty(exports, "TavilyProvider", { enumerable: true, get: function () { return tavily_2.TavilyProvider; } });
+var exa_2 = require("./exa");
+Object.defineProperty(exports, "ExaProvider", { enumerable: true, get: function () { return exa_2.ExaProvider; } });
+var serper_2 = require("./serper");
+Object.defineProperty(exports, "SerperProvider", { enumerable: true, get: function () { return serper_2.SerperProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/web-search/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/web-search/providers/index.ts"],"names":[],"mappings":";;;AAKA,8CAaC;AAjBD,qCAA0C;AAC1C,+BAAoC;AACpC,qCAA0C;AAE1C,SAAgB,iBAAiB,CAAC,IAAuB;IACvD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,uBAAc,EAAE,CAAC;QAC9B,KAAK,KAAK;YACR,OAAO,IAAI,iBAAW,EAAE,CAAC;QAC3B,KAAK,QAAQ;YACX,OAAO,IAAI,uBAAc,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,IAAI,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;AACH,CAAC;AAED,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,6BAAoC;AAA3B,kGAAA,WAAW,OAAA;AACpB,mCAA0C;AAAjC,wGAAA,cAAc,OAAA"}

package/dist/tools/web-search/providers/serper.d.ts

@@ -0,0 +1,5 @@
+import { SearchProviderAdapter, WebSearchConfig, WebSearchResponse } from '../types';
+export declare class SerperProvider implements SearchProviderAdapter {
+    search(query: string, config: WebSearchConfig): Promise<WebSearchResponse>;
+}
+//# sourceMappingURL=serper.d.ts.map

package/dist/tools/web-search/providers/serper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serper.d.ts","sourceRoot":"","sources":["../../../../src/tools/web-search/providers/serper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAmB,MAAM,UAAU,CAAC;AAqBtG,qBAAa,cAAe,YAAW,qBAAqB;IACpD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAgDjF"}

package/dist/tools/web-search/providers/serper.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SerperProvider = void 0;
+class SerperProvider {
+    async search(query, config) {
+        const apiKey = config.apiKey;
+        if (!apiKey) {
+            throw new Error('Serper API key is required');
+        }
+        const body = {
+            q: query,
+            num: config.maxResults ?? 5,
+        };
+        const response = await fetch('https://google.serper.dev/search', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-API-KEY': apiKey,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Serper API error ${response.status}: ${errorText}`);
+        }
+        const data = (await response.json());
+        const results = (data.organic ?? []).map((r) => ({
+            title: r.title,
+            url: r.link,
+            snippet: r.snippet,
+            publishedDate: r.date,
+        }));
+        let answer;
+        if (data.answerBox) {
+            answer =
+                data.answerBox.answer ??
+                    data.answerBox.snippet ??
+                    data.answerBox.title;
+        }
+        return {
+            query,
+            results,
+            answer,
+        };
+    }
+}
+exports.SerperProvider = SerperProvider;
+//# sourceMappingURL=serper.js.map

package/dist/tools/web-search/providers/serper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serper.js","sourceRoot":"","sources":["../../../../src/tools/web-search/providers/serper.ts"],"names":[],"mappings":";;;AAqBA,MAAa,cAAc;IACzB,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,MAAuB;QACjD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,IAAI,GAAG;YACX,CAAC,EAAE,KAAK;YACR,GAAG,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;SAC5B,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,kCAAkC,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,MAAM;aACpB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;QAE1D,MAAM,OAAO,GAAsB,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClE,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,IAAI;YACX,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,aAAa,EAAE,CAAC,CAAC,IAAI;SACtB,CAAC,CAAC,CAAC;QAEJ,IAAI,MAA0B,CAAC;QAC/B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM;gBACJ,IAAI,CAAC,SAAS,CAAC,MAAM;oBACrB,IAAI,CAAC,SAAS,CAAC,OAAO;oBACtB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,OAAO;YACL,KAAK;YACL,OAAO;YACP,MAAM;SACP,CAAC;IACJ,CAAC;CACF;AAjDD,wCAiDC"}

package/dist/tools/web-search/providers/tavily.d.ts

@@ -0,0 +1,5 @@
+import { SearchProviderAdapter, WebSearchConfig, WebSearchResponse } from '../types';
+export declare class TavilyProvider implements SearchProviderAdapter {
+    search(query: string, config: WebSearchConfig): Promise<WebSearchResponse>;
+}
+//# sourceMappingURL=tavily.d.ts.map

package/dist/tools/web-search/providers/tavily.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.d.ts","sourceRoot":"","sources":["../../../../src/tools/web-search/providers/tavily.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAmB,MAAM,UAAU,CAAC;AAiBtG,qBAAa,cAAe,YAAW,qBAAqB;IACpD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA+CjF"}

package/dist/tools/web-search/providers/tavily.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TavilyProvider = void 0;
+class TavilyProvider {
+    async search(query, config) {
+        const apiKey = config.apiKey;
+        if (!apiKey) {
+            throw new Error('Tavily API key is required');
+        }
+        // Note: Tavily API requires the key in the request body (their API design).
+        // When using platform mode, the key is managed server-side via the connector.
+        const body = {
+            api_key: apiKey,
+            query,
+            max_results: config.maxResults ?? 5,
+            search_depth: config.searchDepth ?? 'basic',
+            include_raw_content: config.includeContent ?? false,
+            include_answer: true,
+        };
+        const response = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Tavily API error ${response.status}: ${errorText}`);
+        }
+        const data = (await response.json());
+        const results = data.results.map((r) => ({
+            title: r.title,
+            url: r.url,
+            snippet: r.content,
+            content: r.raw_content,
+            score: r.score,
+            publishedDate: r.published_date,
+        }));
+        return {
+            query: data.query,
+            results,
+            answer: data.answer,
+        };
+    }
+}
+exports.TavilyProvider = TavilyProvider;
+//# sourceMappingURL=tavily.js.map

package/dist/tools/web-search/providers/tavily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.js","sourceRoot":"","sources":["../../../../src/tools/web-search/providers/tavily.ts"],"names":[],"mappings":";;;AAiBA,MAAa,cAAc;IACzB,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,MAAuB;QACjD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,4EAA4E;QAC5E,8EAA8E;QAC9E,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,MAAM;YACf,KAAK;YACL,WAAW,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;YACnC,YAAY,EAAE,MAAM,CAAC,WAAW,IAAI,OAAO;YAC3C,mBAAmB,EAAE,MAAM,CAAC,cAAc,IAAI,KAAK;YACnD,cAAc,EAAE,IAAI;SACrB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;YAC5D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;QAE1D,MAAM,OAAO,GAAsB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1D,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,WAAW;YACtB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,aAAa,EAAE,CAAC,CAAC,cAAc;SAChC,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO;YACP,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAhDD,wCAgDC"}

package/dist/tools/web-search/types.d.ts

@@ -0,0 +1,26 @@
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    content?: string;
+    score?: number;
+    publishedDate?: string;
+}
+export interface WebSearchResponse {
+    query: string;
+    results: WebSearchResult[];
+    answer?: string;
+}
+export type WebSearchProvider = 'tavily' | 'exa' | 'serper';
+export interface WebSearchConfig {
+    provider?: WebSearchProvider;
+    apiKey?: string;
+    maxResults?: number;
+    searchDepth?: 'basic' | 'advanced';
+    includeContent?: boolean;
+    connector?: string;
+}
+export interface SearchProviderAdapter {
+    search(query: string, config: WebSearchConfig): Promise<WebSearchResponse>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/web-search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/web-search/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACnC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC5E"}

package/dist/tools/web-search/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/tools/web-search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/web-search/types.ts"],"names":[],"mappings":""}

package/dist/types/all-types.d.ts

@@ -295,6 +295,25 @@ export interface RunflowAPIClient {
     credentials: {
         getByName(name: string): Promise<CredentialResponse>;
     };
+    schedules: {
+        create<T = any>(config: T): Promise<{
+            success: boolean;
+            data: any;
+        }>;
+        list(): Promise<{
+            success: boolean;
+            data: any[];
+            total: number;
+        }>;
+        update<T = any>(id: string, config: T): Promise<{
+            success: boolean;
+            data: any;
+        }>;
+        cancel(id: string): Promise<{
+            success: boolean;
+            deleted: boolean;
+        }>;
+    };
     sendTraces(request: TraceRequest): Promise<TraceResponse>;
     sendEvents(request: EventsRequest): Promise<EventsResponse>;
     log(message: string, data?: any): void;
@@ -596,6 +615,8 @@ export interface WorkflowConfig {
     options?: WorkflowOptions;
     /** Transform step results into the final workflow output before schema validation */
     outputTransform?: (stepResults: Record<string, any>, input: any) => any;
+    /** Observability settings for this workflow (same controls as Agent) */
+    observability?: ObservabilityMode | ObservabilityConfig;
 }
 export interface WorkflowStep {
     id: string;
@@ -842,8 +863,12 @@ export interface TraceMetadata {
         presencePenalty?: number;
     };
     workflowId?: string;
+    workflowName?: string;
     stepId?: string;
     stepType?: string;
+    stepNumber?: number;
+    totalSteps?: number;
+    _traceType?: string;
     toolName?: string;
     toolType?: string;
     toolsUsed?: string[];