@stackfactor/agent-utils 1.2.20 → 1.3.2

package/README.md

@@ -40,7 +40,7 @@ When `expectsJsonResponse` is `true` (the default), JSON escape instructions are
 | Parameter             | Type                 | Default         | Description                                                                                              |
 | --------------------- | -------------------- | --------------- | -------------------------------------------------------------------------------------------------------- |
 | `modelName`           | `string`             | —               | Model identifier: `"gpt-4o"`, `"claude-3-5-sonnet"`, `"gemini-1.5-pro"`, `"deepseek-chat"`, `"kimi-k2-0905-preview"`, `"glm-4.6"`, etc. |
-| `config`              | `object`             | —               | API keys (`openAIAPIKey`, `anthropicAPIKey`, `googleAPIKey`, `deepSeekAPIKey`, `kimiAPIKey`, `glmAPIKey`), `temperature`, `agentic`, `recursionLimit`, `webSearch` |
+| `config`              | `object`             | —               | API keys (`openAIAPIKey`, `anthropicAPIKey`, `googleAPIKey`, `deepSeekAPIKey`, `kimiAPIKey`, `glmAPIKey`), `temperature`, `agentic`, `recursionLimit`, `tavily`, `tavilyAPIKey` |
 | `prompt`              | `string \| object[]` | —               | Plain string or array of `{ role, content }` message objects                                             |
 | `onProgressReport`    | `function \| null`   | `null`          | Async callback receiving `{ message, progress }` updates                                                 |
 | `minPercent`          | `number`             | `0`             | Lower bound for progress percentage                                                                      |
@@ -91,7 +91,8 @@ Constructs a LangChain agent with a model, system prompt, and tools. When `onRep
 | `systemPrompt`     | `string`           | —       | System prompt describing agent behaviour |
 | `tools`            | `any[]`            | `[]`    | LangChain tool instances                 |
 | `responseFormat`   | `any`              | —       | Structured response format descriptor    |
-| `config`           | `object`           | —       | API keys, temperature, etc.              |
+| `config`           | `object`           | —       | API keys, temperature, `tavily`, etc.    |
+| `usageTracker`     | `object \| null`    | `null`  | Accumulator the Tavily tools bill credits and record sources into |
 | `onReportProgress` | `Function \| null` | `null`  | Progress callback                        |
 | `minPercent`       | `number`           | `0`     | Minimum reportable progress              |
 | `maxPercent`       | `number`           | `100`   | Maximum reportable progress              |
@@ -254,15 +255,27 @@ Shared constants used across the package.
 
 ---
 
-## Web Search
+## Web Search (Tavily)
 
-Set `config.webSearch` to enable each provider's own web search tool. The provider runs the search server-side inside the same request — there is no client-side agent loop and no extra round trip — so every calling convention (streaming, non-streaming, agentic, with or without a Zod schema) is unchanged.
+Set `config.tavily` to give an agent the Tavily web tools. These run **client-side**: the model emits a tool call, this library performs the HTTP request, and the result is appended to the conversation. Only an agent loop can execute them, so **`config.agentic` must be `true`** — enabling `tavily` without it throws `BAD_REQUEST` rather than handing the model tools whose calls nothing answers.
 
-| Provider  | Native tool                                                                                                    | Context control                       | Billing                     |
-| --------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------------- | --------------------------- |
-| Anthropic | [`web_search` server tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool)         | Dynamic filtering (**on by default**) | $10 per 1,000 searches      |
-| OpenAI    | [`web_search` hosted tool](https://platform.openai.com/docs/guides/tools-web-search) (Responses API)              | `search_context_size`                 | Per search, model-dependent |
-| Google    | [`googleSearch` grounding](https://ai.google.dev/gemini-api/docs/google-search)                                   | None offered by the API               | Per grounded request        |
+| Tool          | Arguments                        | Returns                                                                 | Default |
+| ------------- | -------------------------------- | ----------------------------------------------------------------------- | ------- |
+| `web_search`  | `query`, `maxResults?`           | Snippets and URLs; no page content                                      | **on**  |
+| `web_extract` | `urls[]`, `query?`               | Page content — matching passages with a `query`, whole document without  | **on**  |
+| `web_map`     | `url`, `instructions?`           | URLs only, no content                                                   | off     |
+| `web_crawl`   | `url`, `instructions?`, `limit?` | Full content of every page visited                                      | off     |
+
+No new dependency is added: all four endpoints are a single `POST`, issued with the runtime's own `fetch`.
+
+### Both reading modes, one tool
+
+`web_extract` covers whole-page and targeted reading through Tavily's own optional `query` field, so the model chooses per call:
+
+- **`query` omitted** → the entire document.
+- **`query` supplied** → only the matching chunks (`chunks_per_source`, default `3`).
+
+Targeted extraction is dramatically cheaper in context and is usually sufficient; whole-document extraction is there for when the full structure matters. Splitting these into two tools would duplicate the description tokens on every request to express a distinction the API already makes with one optional field.
 
 ```typescript
 const usageTracker = {};
@@ -270,52 +283,66 @@ const result = await langChain.runPromptWithModel(
   "claude-opus-5",
   {
     anthropicAPIKey: "sk-ant-...",
-    "claude-opus-5-web-search-costs": 10, // USD per 1,000 searches
-    webSearch: { maxUses: 5, allowedDomains: ["reuters.com", "bbc.com"] },
+    tavilyAPIKey: "tvly-...",
+    agentic: true, // required
+    "tavily-credit-costs": 0.008, // USD per credit
+    tavily: {
+      tools: ["search", "extract", "map"],
+      includeDomains: ["sc.gov", "sc.edu"],
+      maxCharsPerUrl: 60000,
+    },
   },
-  "What happened in the markets today?",
+  "What are the SC procurement thresholds for sole-source awards?",
   null, 0, 100, false, null, "StackFactor", [], usageTracker,
 );
-// usageTracker.tokens["claude-opus-5_webSearches"] === 2
-// usageTracker.cost includes 2 / 1000 * 10
-// usageTracker.webSearchSources === [{ url: "https://reuters.com/...", title: "..." }, ...]
+// usageTracker.tokens.tavilyCredits === 4
+// usageTracker.cost includes 4 * 0.008
+// usageTracker.webSearchSources === [{ url: "https://...", title: "..." }, ...]
 ```
 
-### `WebSearchConfig`
+### `TavilyConfig`
 
-`webSearch: true` uses provider defaults. Pass an object to configure it; each field is only sent to the providers that accept it, and the rest are ignored.
+`tavily: true` uses the defaults below. Pass an object to configure it.
 
-| Field               | Applies to        | Default      | Description                                                                                   |
-| ------------------- | ----------------- | ------------ | ----------------------------------------------------------------------------------------------- |
-| `maxUses`           | Anthropic         | unlimited    | Hard cap on searches per request                                                                 |
-| `allowedDomains`    | Anthropic, OpenAI | —            | Restrict results to these domains (bare domains, no scheme)                                      |
-| `blockedDomains`    | Anthropic         | —            | Exclude these domains; cannot be combined with `allowedDomains`                                   |
-| `userLocation`      | Anthropic, OpenAI | —            | `{ city, region, country, timezone }` — ISO 3166-1 alpha-2 country, IANA timezone                |
-| `searchContextSize` | OpenAI            | `"medium"`   | `"low" \| "medium" \| "high"` — how much context window results may consume                       |
-| `timeRange`         | Google            | —            | `{ startTime, endTime }` RFC 3339 window (`excludeDomains` is Vertex AI only and is not sent)    |
-| `dynamicFiltering`  | Anthropic         | `true`       | Filter results with code before they enter the context window; `false` forces `allowed_callers: ["direct"]` |
-| `responseInclusion` | Anthropic         | `"excluded"` | Whether filtered-away result blocks are echoed back in the response                               |
-| `toolVersion`       | Anthropic         | per model    | Pin the dated tool version instead of selecting it per model                                     |
+| Field             | Default                  | Description                                                                                  |
+| ----------------- | ------------------------ | -------------------------------------------------------------------------------------------- |
+| `tools`           | `["search", "extract"]`  | Which tools to expose; each one spends its description tokens on every request                |
+| `searchDepth`     | Tavily's `"basic"`       | `"basic" \| "advanced" \| "fast" \| "ultra-fast"`                                              |
+| `extractDepth`    | Tavily's `"basic"`       | `"advanced"` also pulls tables and embedded content, at double the credits                     |
+| `maxResults`      | `5`                      | Results per search                                                                            |
+| `chunksPerSource` | `3`                      | Relevant chunks per URL when a `query` is passed to `web_extract`                              |
+| `maxCharsPerUrl`  | `60000`                  | Per-URL cap before truncation (≈15k tokens)                                                   |
+| `maxCharsTotal`   | `150000`                 | Cap across one tool call (≈37k tokens)                                                        |
+| `includeDomains`  | —                        | Restrict `web_search` to these domains                                                        |
+| `excludeDomains`  | —                        | Exclude these domains from `web_search`                                                       |
+| `crawlLimit`      | `10`                     | Maximum pages one `web_crawl` or `web_map` call may return                                    |
+| `format`          | `"markdown"`             | `"markdown"` preserves table and heading structure at fewer tokens than the prose equivalent  |
 
 ### Context management
 
-Search results are the largest thing web search puts into a request, so each provider's context controls are applied up front rather than left at their defaults.
+Nothing sits between Tavily's response and the context window — there is no provider-side filtering here — so the caps above are the only thing standing between one `extract` call and a 100-page PDF. Three measures apply by default:
 
-**Anthropic — dynamic filtering, on by default.** Basic search (`web_search_20250305`) loads *every* raw search result into the context window. From `web_search_20260209` Claude instead writes and runs code that filters the results first, so only relevant content is ingested. `buildWebSearchTool` picks the tool version per model: Claude 4.6 and later get `web_search_20260318` with filtering enabled and `response_inclusion: "excluded"` (which also keeps the consumed result blocks out of the response, cutting billed output tokens); earlier models, which lack programmatic tool calling, fall back to `web_search_20250305`. Pinning a filtering version on an older model via `toolVersion` automatically adds `allowed_callers: ["direct"]` so the request cannot 400. Anthropic provisions the code execution that filtering needs automatically and does not charge extra for it beyond token costs.
+**Responses are stripped before the model sees them.** Tavily returns `score`, `published_date`, `favicon` and `id` alongside each result. None of it informs an answer, so only the title, URL and text are forwarded; the rest is dropped rather than billed as input tokens.
 
-**OpenAI — `search_context_size`.** This is OpenAI's only context knob and it is a genuine quality/cost tradeoff, so it is left at OpenAI's own balanced default of `"medium"` rather than silently downgraded. Set `searchContextSize: "low"` to minimize ingested context where answer depth matters less.
+**`web_search` never requests page content.** `include_raw_content` is always `false`: search finds documents, `web_extract` reads them. Asking for full text at search time pays for every result to find one.
+
+**Truncation is reported, never silent.** When a document exceeds `maxCharsPerUrl`, or a call exhausts `maxCharsTotal`, the payload says exactly what was cut:
+
+```
+[truncated: 60,000 of 412,336 characters shown — narrow the query or request fewer URLs to see the parts that matter]
+```
 
-**Google — no equivalent exists.** The Gemini API's `GoogleSearch` tool has no result-filtering or context-size field; grounded results are injected as-is. The only related lever, `dynamicRetrievalConfig`, belongs to the legacy Gemini 1.5 `googleSearchRetrieval` tool and gates *whether* a search happens, not how much of it is ingested. `searchTypes` is deliberately left unset so grounding stays on text-only web results instead of also returning image bytes.
+A model that cannot tell it received half a regulation will reason over the half it got, which on a compliance corpus is worse than an error.
 
-**Downstream.** Non-text blocks (`server_tool_use`, `web_search_tool_result`, code execution results) are dropped by `extractTextContent` and never re-sent: the library issues one self-contained request per call, so encrypted search results are not carried into follow-up turns. In agentic mode the agent loop does resend history, which is where dynamic filtering and `response_inclusion: "excluded"` matter most.
+`web_crawl` is off by default for the same reason: it returns full content for every page it visits, and is the easiest way here to exhaust a context window. Prefer `web_map` to enumerate a site, then `web_extract` with a `query` on the few URLs that matter.
 
 **Notes**
 
-- Models without a native web search tool (DeepSeek, Kimi, GLM) log a warning and run the prompt without search, so one config can be pointed at any model.
-- Searches performed are added to `usageTracker` as `<model>_webSearches`, costed from `<model>-web-search-costs`. Sources are collected on `usageTracker.webSearchSources`, deduplicated by URL — Anthropic and Google both require citing the original sources when their output is shown to end users.
-- Combining web search with a Zod `schema` requires Gemini 3 or later on Google; Gemini 1.5/2.x reject `responseSchema` alongside `googleSearch` with a 400.
-- With `response_inclusion: "excluded"`, `usageTracker.webSearchSources` is populated from the citations attached to the answer rather than from every raw result — the sources actually used, which is what has to be displayed.
-- Enabling web search on a `gpt-*` model routes the request through OpenAI's Responses API, where the structured-output schema is sent as `text.format` instead of `response_format`. This is handled automatically.
+- Works with every supported provider, including DeepSeek, Kimi and GLM, which have no native web search of their own.
+- Credits come from each response's own `usage` block rather than an estimate, and are accumulated on `usageTracker.tokens.tavilyCredits`, costed from the `tavily-credit-costs` constant (USD per credit; falls back to Tavily's list price of `0.008`).
+- URLs are collected on `usageTracker.webSearchSources`, deduplicated across the whole run — Tavily's terms require citing the original sources when its content is shown to end users.
+- Per-URL failures are surfaced in the tool result instead of being dropped, so a fetch failure is not mistaken for an absence of content.
+- Tool calls honour the caller's abort signal, so a cancelled run stops paying for in-flight crawls.
 
 ---
 
@@ -359,9 +386,10 @@ The `config` object accepted by LangChain methods supports the following keys:
 | `maxTokens`       | `number`  | Maximum output tokens (default: `16384` for Claude, `200000` for other providers). For Claude, values above `21333` automatically enable LangChain streaming to bypass the Anthropic SDK's 10-minute non-streaming guard. |
 | `agentic`         | `boolean` | Enable agentic mode in `runPromptWithModel` |
 | `recursionLimit`  | `number`  | Max agent steps (default: `25`)             |
-| `webSearch`       | `boolean \| WebSearchConfig` | Enable the provider's native web search tool (see [Web Search](#web-search)) |
+| `tavilyAPIKey`    | `string`  | Tavily API key; required when `tavily` is set                                |
+| `tavily`          | `boolean \| TavilyConfig` | Enable the Tavily web tools; requires `agentic: true` (see [Web Search (Tavily)](#web-search-tavily)) |
 
-Per-model cost constants are read from the same object using flat keys: `<model>-input-token-costs`, `<model>-output-token-costs`, `<model>-image-input-token-costs`, `<model>-image-output-token-costs`, `<model>-character-costs` (all USD per million), and `<model>-web-search-costs` (USD per **1,000** searches).
+Per-model cost constants are read from the same object using flat keys: `<model>-input-token-costs`, `<model>-output-token-costs`, `<model>-image-input-token-costs`, `<model>-image-output-token-costs`, and `<model>-character-costs` (all USD per million). Tavily is billed separately via `tavily-credit-costs` (USD per credit).
 
 ---
 

package/dist/cjs/index.d.ts

@@ -9,7 +9,8 @@ export { constants };
 export { errorHandling, AppError };
 export type { ParsedError } from "./errorHandling.js";
 export { langChain };
-export type { UsageTracker, WebSearchConfig } from "./langChain.js";
+export type { UsageTracker } from "./langChain.js";
+export type { TavilyConfig, TavilyToolName } from "./tavily.js";
 export { logger };
 export { serve };
 export { callAgent };

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AAEnC,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AAEnC,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/cjs/langChain.d.ts

@@ -10,11 +10,10 @@ export type UsageTracker = {
         [tokenKey: string]: number;
     };
     /**
-     * Sources returned by native web search, deduplicated by URL across every
-     * call in the run. Only present once a search has actually run. Anthropic and
-     * Google both require the original sources to be cited when their output is
-     * shown to end users, so they are surfaced here rather than discarded with
-     * the rest of the non-text content blocks.
+     * URLs returned by the Tavily tools, deduplicated across every call in the
+     * run. Only present once a web tool has actually run. Tavily's terms require
+     * the original sources to be cited when its content is shown to end users, so
+     * they are surfaced here rather than left buried in the tool messages.
      */
     webSearchSources?: {
         url: string;
@@ -22,64 +21,31 @@ export type UsageTracker = {
     }[];
 };
 /**
- * Caller-facing options for the providers' native web search tools. Enable web
- * search by setting `config.webSearch` to `true` (provider defaults) or to one
- * of these objects. Every field is optional and is only forwarded to the
- * providers that accept it — see `buildWebSearchTool` for the mapping.
+ * Instantiates and returns the appropriate LangChain chat model based on the model
+ * name prefix. `claude-` maps to `ChatAnthropic`, `gemini-` maps to
+ * `ChatGoogleGenerativeAI`, and `gpt-` maps to `ChatOpenAI`. DeepSeek (`deepseek-`),
+ * Kimi/Moonshot (`kimi-`, `moonshot-`), and GLM/Zhipu (`glm-`) models are routed
+ * through `ChatOpenAI` against each provider's OpenAI-compatible endpoint. When a Zod
+ * `schema` is provided, native structured output is configured per provider: OpenAI
+ * via `response_format` with `json_schema`, Anthropic via `output_config.format`, and
+ * Gemini via JSON mode (`json: true`) plus `responseSchema`. In every case the model
+ * emits JSON as the message text, so the caller's parse/validate pipeline is unchanged.
+ * The schema is ignored for the OpenAI-compatible providers (DeepSeek/Kimi/GLM), which
+ * have no native structured-output support here. Throws a `BAD_REQUEST` error for
+ * unrecognised model names.
+ * @param modelName - The model identifier, e.g. `"gpt-4o"`, `"claude-3-5-sonnet"`,
+ *   `"gemini-1.5-pro"`, `"deepseek-chat"`, `"kimi-k2-0905-preview"`, `"glm-4.6"`
+ * @param config - Configuration object containing API keys (`openAIAPIKey`,
+ *   `anthropicAPIKey`, `googleAPIKey`, `deepSeekAPIKey`, `kimiAPIKey`, `glmAPIKey`),
+ *   optional `maxTokens`, and optional `temperature`
+ * @param schema - Optional Zod schema used to configure native structured JSON output
+ *   for GPT / Claude / Gemini models; ignored for OpenAI-compatible providers
+ * @returns A configured LangChain chat model (or bound runnable) instance
  */
-export type WebSearchConfig = {
-    /** Anthropic only: hard cap on searches per request (`max_uses`). */
-    maxUses?: number;
-    /** Anthropic (`allowed_domains`) and OpenAI (`filters.allowed_domains`). */
-    allowedDomains?: string[];
-    /** Anthropic only (`blocked_domains`); cannot be combined with `allowedDomains`. */
-    blockedDomains?: string[];
-    /** Anthropic and OpenAI: approximate location used to localize results. */
-    userLocation?: {
-        city?: string;
-        region?: string;
-        /** Two-letter ISO 3166-1 alpha-2 code, e.g. `"US"`. */
-        country?: string;
-        /** IANA timezone ID, e.g. `"America/Los_Angeles"`. */
-        timezone?: string;
-    };
-    /**
-     * OpenAI only: how much of the context window search results may consume.
-     * OpenAI's default is `"medium"`; `"low"` minimizes context at some cost to
-     * answer quality, `"high"` is the expensive end.
-     */
-    searchContextSize?: "low" | "medium" | "high";
-    /** Gemini only: RFC 3339 window the search is restricted to. */
-    timeRange?: {
-        startTime: string;
-        endTime: string;
-    };
-    /**
-     * Anthropic only: opt out of dynamic filtering by forcing the search to be
-     * called directly (`allowed_callers: ["direct"]`). Defaults to `true` on
-     * models that support it — see `supportsAnthropicDynamicFiltering`. Turning
-     * this off means every raw search result lands in the context window.
-     */
-    dynamicFiltering?: boolean;
-    /**
-     * Anthropic only: whether search result blocks consumed by dynamic filtering
-     * are echoed back in the response. Defaults to `"excluded"`, which drops them
-     * and cuts the output tokens billed for content nothing downstream reads.
-     */
-    responseInclusion?: "full" | "excluded";
-    /**
-     * Anthropic only: pin the dated tool version instead of letting
-     * `buildWebSearchTool` pick per model. `web_search_20250305` is basic search,
-     * `web_search_20260209` adds dynamic filtering, `web_search_20260318` adds
-     * response-inclusion control. Pinning a filtering version on a model that
-     * cannot do programmatic tool calling returns a 400 unless
-     * `dynamicFiltering: false` is also set.
-     */
-    toolVersion?: string;
-};
+export declare const getLLMModel: (modelName: string, config: any, schema?: any) => any;
 declare const _default: {
     checkIfAIProviderConfigured: (config: any) => void;
-    createAgent: (name: string, modelName: string, systemPrompt: string, tools: any[], responseFormat: any, config: any) => any;
+    createAgent: (name: string, modelName: string, systemPrompt: string, tools: any[], responseFormat: any, config: any, usageTracker?: UsageTracker | null) => any;
     runAgent: (agent: any, prompt: string, config: any, onProgress?: Function | null, usageTracker?: UsageTracker | null) => Promise<any>;
     runPromptWithModel: (modelName: string, config: any, prompt: any, onProgressReport: any, minPercent?: number, maxPercent?: number, expectsJsonResponse?: boolean, schema?: any, agentName?: string, tools?: any[], usageTracker?: UsageTracker | null) => Promise<any>;
     runPromptWithModelForImageGeneration: (modelName: string, config: any, prompt: string, options?: any, usageTracker?: UsageTracker | null) => Promise<any>;

package/dist/cjs/langChain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":"AAuGA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACvC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD,CAAC;AAskBF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,2EAA2E;IAC3E,YAAY,CAAC,EAAE;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,uDAAuD;QACvD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,sDAAsD;QACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9C,gEAAgE;IAChE,SAAS,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACxC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;;0CAxnB2C,GAAG,KAAG,IAAI;wBAujC/C,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,KACV,GAAG;sBAiCG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,iBACb,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;oCA0YF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;sDAuuBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;0CAjhC8B,GAAG,KAAG,MAAM;+CAviC9C,YAAY,GAAG,IAAI,GAAG,SAAS,aAC7B,MAAM,kBACD,MAAM,UACd,GAAG,KACV,IAAI;mCAujCU,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AAwjCT,wBASE"}
+{"version":3,"file":"langChain.d.ts","sourceRoot":"","sources":["../../src/langChain.ts"],"names":[],"mappings":"AA4GA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACvC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD,CAAC;AA2lBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,QAAQ,GAAG,EACX,SAAQ,GAAU,KACjB,GAoHF,CAAC;;0CAzuB2C,GAAG,KAAG,IAAI;wBA4vB/C,MAAM,aACD,MAAM,gBACH,MAAM,SACb,GAAG,EAAE,kBACI,GAAG,UACX,GAAG,iBACG,YAAY,GAAG,IAAI,KAChC,GAAG;sBAoCG,GAAG,UACF,MAAM,UACN,GAAG,eACC,QAAQ,GAAG,IAAI,iBACb,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;oCAkYF,MAAM,UACT,GAAG,UACH,GAAG,oBACO,GAAG,eACT,MAAM,eACN,MAAM,wBACG,OAAO,WACpB,GAAG,cACA,MAAM,UACV,GAAG,EAAE,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;sDA0tBF,MAAM,UACT,GAAG,UACH,MAAM,YACL,GAAG,iBACE,YAAY,GAAG,IAAI,KAChC,OAAO,CAAC,GAAG,CAAC;0CApgC8B,GAAG,KAAG,MAAM;+CAzuB9C,YAAY,GAAG,IAAI,GAAG,SAAS,aAC7B,MAAM,kBACD,MAAM,UACd,GAAG,KACV,IAAI;mCAyvBU,MAAM,mBACJ,MAAM,EAAE,KACxB,MAAM;;AA2iCT,wBASE"}