@truefoundry/trueforge-core 0.2.0-rc.5 → 0.2.0-rc.6

package/dist/core/web-search/ParallelWebSearchProvider.js

@@ -0,0 +1,95 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/web-search/ParallelWebSearchProvider.ts
+var ParallelWebSearchProvider_exports = {};
+__export(ParallelWebSearchProvider_exports, {
+  ParallelWebSearchProvider: () => ParallelWebSearchProvider
+});
+module.exports = __toCommonJS(ParallelWebSearchProvider_exports);
+var import_parallel_web = __toESM(require("parallel-web"), 1);
+var import_WebSearchProvider = require("./WebSearchProvider.js");
+var PARALLEL_SEARCH_MAX_RESULTS = 5;
+var PARALLEL_SEARCH_MAX_CHARS_PER_RESULT = 500;
+var PARALLEL_SEARCH_MAX_CHARS_TOTAL = 4e3;
+var ParallelWebSearchProvider = class {
+  id = import_WebSearchProvider.WebSearchProviders.Parallel;
+  #client;
+  #mode;
+  constructor(options) {
+    this.#client = new import_parallel_web.default({ apiKey: options.apiKey });
+    this.#mode = options.mode;
+  }
+  async search(input) {
+    const response = await this.#client.search({
+      search_queries: input.search_queries,
+      ...input.objective ? { objective: input.objective } : {},
+      mode: this.#mode,
+      max_chars_total: PARALLEL_SEARCH_MAX_CHARS_TOTAL,
+      advanced_settings: {
+        max_results: PARALLEL_SEARCH_MAX_RESULTS,
+        excerpt_settings: { max_chars_per_result: PARALLEL_SEARCH_MAX_CHARS_PER_RESULT }
+      }
+    });
+    return {
+      hits: response.results.map((result) => ({
+        title: result.title ?? "",
+        url: result.url,
+        snippet: result.excerpts.join("\n\n"),
+        published_at: result.publish_date ?? null
+      }))
+    };
+  }
+  async fetch(input) {
+    const response = await this.#client.extract({
+      urls: input.urls,
+      ...input.objective ? { objective: input.objective } : {}
+    });
+    const pages = [
+      ...response.results.map((result) => ({
+        url: result.url,
+        title: result.title ?? null,
+        content: result.full_content ?? result.excerpts.join("\n\n"),
+        error: null
+      })),
+      ...response.errors.map((err) => ({
+        url: err.url,
+        title: null,
+        content: "",
+        error: err.content ?? err.error_type
+      }))
+    ];
+    return { pages };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ParallelWebSearchProvider
+});
+//# sourceMappingURL=ParallelWebSearchProvider.js.map

package/dist/core/web-search/ParallelWebSearchProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/web-search/ParallelWebSearchProvider.ts"],"sourcesContent":["import Parallel from 'parallel-web';\nimport {\n  WebSearchProviders,\n  type IWebSearchProvider,\n  type WebFetchPages,\n  type WebSearchHits,\n} from './WebSearchProvider';\n\nexport type ParallelSearchMode = 'turbo' | 'fast' | 'basic' | 'advanced';\n\n/** Keep search payloads under the large-tool-response individual threshold (~6k tokens). */\nconst PARALLEL_SEARCH_MAX_RESULTS = 5;\nconst PARALLEL_SEARCH_MAX_CHARS_PER_RESULT = 500;\nconst PARALLEL_SEARCH_MAX_CHARS_TOTAL = 4000;\n\nexport interface ParallelWebSearchProviderOptions {\n  apiKey: string;\n  /** Parallel Search mode preset. Caller supplies the default (e.g. `turbo`). */\n  mode: ParallelSearchMode;\n}\n\n/**\n * Parallel Search + Extract via the official `parallel-web` SDK.\n */\nexport class ParallelWebSearchProvider implements IWebSearchProvider {\n  readonly id = WebSearchProviders.Parallel;\n  readonly #client: Parallel;\n  readonly #mode: ParallelSearchMode;\n\n  constructor(options: ParallelWebSearchProviderOptions) {\n    this.#client = new Parallel({ apiKey: options.apiKey });\n    this.#mode = options.mode;\n  }\n\n  async search(input: { search_queries: string[]; objective: string | undefined }): Promise<WebSearchHits> {\n    const response = await this.#client.search({\n      search_queries: input.search_queries,\n      ...(input.objective ? { objective: input.objective } : {}),\n      mode: this.#mode,\n      max_chars_total: PARALLEL_SEARCH_MAX_CHARS_TOTAL,\n      advanced_settings: {\n        max_results: PARALLEL_SEARCH_MAX_RESULTS,\n        excerpt_settings: { max_chars_per_result: PARALLEL_SEARCH_MAX_CHARS_PER_RESULT },\n      },\n    });\n    return {\n      hits: response.results.map(result => ({\n        title: result.title ?? '',\n        url: result.url,\n        snippet: result.excerpts.join('\\n\\n'),\n        published_at: result.publish_date ?? null,\n      })),\n    };\n  }\n\n  async fetch(input: { urls: string[]; objective: string | undefined }): Promise<WebFetchPages> {\n    const response = await this.#client.extract({\n      urls: input.urls,\n      ...(input.objective ? { objective: input.objective } : {}),\n    });\n    const pages = [\n      ...response.results.map(result => ({\n        url: result.url,\n        title: result.title ?? null,\n        content: result.full_content ?? result.excerpts.join('\\n\\n'),\n        error: null,\n      })),\n      ...response.errors.map(err => ({\n        url: err.url,\n        title: null,\n        content: '',\n        error: err.content ?? err.error_type,\n      })),\n    ];\n    return { pages };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAAqB;AACrB,+BAKO;AAKP,IAAM,8BAA8B;AACpC,IAAM,uCAAuC;AAC7C,IAAM,kCAAkC;AAWjC,IAAM,4BAAN,MAA8D;AAAA,EAC1D,KAAK,4CAAmB;AAAA,EACxB;AAAA,EACA;AAAA,EAET,YAAY,SAA2C;AACrD,SAAK,UAAU,IAAI,oBAAAA,QAAS,EAAE,QAAQ,QAAQ,OAAO,CAAC;AACtD,SAAK,QAAQ,QAAQ;AAAA,EACvB;AAAA,EAEA,MAAM,OAAO,OAA4F;AACvG,UAAM,WAAW,MAAM,KAAK,QAAQ,OAAO;AAAA,MACzC,gBAAgB,MAAM;AAAA,MACtB,GAAI,MAAM,YAAY,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;AAAA,MACxD,MAAM,KAAK;AAAA,MACX,iBAAiB;AAAA,MACjB,mBAAmB;AAAA,QACjB,aAAa;AAAA,QACb,kBAAkB,EAAE,sBAAsB,qCAAqC;AAAA,MACjF;AAAA,IACF,CAAC;AACD,WAAO;AAAA,MACL,MAAM,SAAS,QAAQ,IAAI,aAAW;AAAA,QACpC,OAAO,OAAO,SAAS;AAAA,QACvB,KAAK,OAAO;AAAA,QACZ,SAAS,OAAO,SAAS,KAAK,MAAM;AAAA,QACpC,cAAc,OAAO,gBAAgB;AAAA,MACvC,EAAE;AAAA,IACJ;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,OAAkF;AAC5F,UAAM,WAAW,MAAM,KAAK,QAAQ,QAAQ;AAAA,MAC1C,MAAM,MAAM;AAAA,MACZ,GAAI,MAAM,YAAY,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;AAAA,IAC1D,CAAC;AACD,UAAM,QAAQ;AAAA,MACZ,GAAG,SAAS,QAAQ,IAAI,aAAW;AAAA,QACjC,KAAK,OAAO;AAAA,QACZ,OAAO,OAAO,SAAS;AAAA,QACvB,SAAS,OAAO,gBAAgB,OAAO,SAAS,KAAK,MAAM;AAAA,QAC3D,OAAO;AAAA,MACT,EAAE;AAAA,MACF,GAAG,SAAS,OAAO,IAAI,UAAQ;AAAA,QAC7B,KAAK,IAAI;AAAA,QACT,OAAO;AAAA,QACP,SAAS;AAAA,QACT,OAAO,IAAI,WAAW,IAAI;AAAA,MAC5B,EAAE;AAAA,IACJ;AACA,WAAO,EAAE,MAAM;AAAA,EACjB;AACF;","names":["Parallel"]}

package/dist/core/web-search/ParallelWebSearchProvider.mjs

@@ -0,0 +1,62 @@
+// src/core/web-search/ParallelWebSearchProvider.ts
+import Parallel from "parallel-web";
+import {
+  WebSearchProviders
+} from "./WebSearchProvider.mjs";
+var PARALLEL_SEARCH_MAX_RESULTS = 5;
+var PARALLEL_SEARCH_MAX_CHARS_PER_RESULT = 500;
+var PARALLEL_SEARCH_MAX_CHARS_TOTAL = 4e3;
+var ParallelWebSearchProvider = class {
+  id = WebSearchProviders.Parallel;
+  #client;
+  #mode;
+  constructor(options) {
+    this.#client = new Parallel({ apiKey: options.apiKey });
+    this.#mode = options.mode;
+  }
+  async search(input) {
+    const response = await this.#client.search({
+      search_queries: input.search_queries,
+      ...input.objective ? { objective: input.objective } : {},
+      mode: this.#mode,
+      max_chars_total: PARALLEL_SEARCH_MAX_CHARS_TOTAL,
+      advanced_settings: {
+        max_results: PARALLEL_SEARCH_MAX_RESULTS,
+        excerpt_settings: { max_chars_per_result: PARALLEL_SEARCH_MAX_CHARS_PER_RESULT }
+      }
+    });
+    return {
+      hits: response.results.map((result) => ({
+        title: result.title ?? "",
+        url: result.url,
+        snippet: result.excerpts.join("\n\n"),
+        published_at: result.publish_date ?? null
+      }))
+    };
+  }
+  async fetch(input) {
+    const response = await this.#client.extract({
+      urls: input.urls,
+      ...input.objective ? { objective: input.objective } : {}
+    });
+    const pages = [
+      ...response.results.map((result) => ({
+        url: result.url,
+        title: result.title ?? null,
+        content: result.full_content ?? result.excerpts.join("\n\n"),
+        error: null
+      })),
+      ...response.errors.map((err) => ({
+        url: err.url,
+        title: null,
+        content: "",
+        error: err.content ?? err.error_type
+      }))
+    ];
+    return { pages };
+  }
+};
+export {
+  ParallelWebSearchProvider
+};
+//# sourceMappingURL=ParallelWebSearchProvider.mjs.map

package/dist/core/web-search/ParallelWebSearchProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/web-search/ParallelWebSearchProvider.ts"],"sourcesContent":["import Parallel from 'parallel-web';\nimport {\n  WebSearchProviders,\n  type IWebSearchProvider,\n  type WebFetchPages,\n  type WebSearchHits,\n} from './WebSearchProvider';\n\nexport type ParallelSearchMode = 'turbo' | 'fast' | 'basic' | 'advanced';\n\n/** Keep search payloads under the large-tool-response individual threshold (~6k tokens). */\nconst PARALLEL_SEARCH_MAX_RESULTS = 5;\nconst PARALLEL_SEARCH_MAX_CHARS_PER_RESULT = 500;\nconst PARALLEL_SEARCH_MAX_CHARS_TOTAL = 4000;\n\nexport interface ParallelWebSearchProviderOptions {\n  apiKey: string;\n  /** Parallel Search mode preset. Caller supplies the default (e.g. `turbo`). */\n  mode: ParallelSearchMode;\n}\n\n/**\n * Parallel Search + Extract via the official `parallel-web` SDK.\n */\nexport class ParallelWebSearchProvider implements IWebSearchProvider {\n  readonly id = WebSearchProviders.Parallel;\n  readonly #client: Parallel;\n  readonly #mode: ParallelSearchMode;\n\n  constructor(options: ParallelWebSearchProviderOptions) {\n    this.#client = new Parallel({ apiKey: options.apiKey });\n    this.#mode = options.mode;\n  }\n\n  async search(input: { search_queries: string[]; objective: string | undefined }): Promise<WebSearchHits> {\n    const response = await this.#client.search({\n      search_queries: input.search_queries,\n      ...(input.objective ? { objective: input.objective } : {}),\n      mode: this.#mode,\n      max_chars_total: PARALLEL_SEARCH_MAX_CHARS_TOTAL,\n      advanced_settings: {\n        max_results: PARALLEL_SEARCH_MAX_RESULTS,\n        excerpt_settings: { max_chars_per_result: PARALLEL_SEARCH_MAX_CHARS_PER_RESULT },\n      },\n    });\n    return {\n      hits: response.results.map(result => ({\n        title: result.title ?? '',\n        url: result.url,\n        snippet: result.excerpts.join('\\n\\n'),\n        published_at: result.publish_date ?? null,\n      })),\n    };\n  }\n\n  async fetch(input: { urls: string[]; objective: string | undefined }): Promise<WebFetchPages> {\n    const response = await this.#client.extract({\n      urls: input.urls,\n      ...(input.objective ? { objective: input.objective } : {}),\n    });\n    const pages = [\n      ...response.results.map(result => ({\n        url: result.url,\n        title: result.title ?? null,\n        content: result.full_content ?? result.excerpts.join('\\n\\n'),\n        error: null,\n      })),\n      ...response.errors.map(err => ({\n        url: err.url,\n        title: null,\n        content: '',\n        error: err.content ?? err.error_type,\n      })),\n    ];\n    return { pages };\n  }\n}\n"],"mappings":";AAAA,OAAO,cAAc;AACrB;AAAA,EACE;AAAA,OAIK;AAKP,IAAM,8BAA8B;AACpC,IAAM,uCAAuC;AAC7C,IAAM,kCAAkC;AAWjC,IAAM,4BAAN,MAA8D;AAAA,EAC1D,KAAK,mBAAmB;AAAA,EACxB;AAAA,EACA;AAAA,EAET,YAAY,SAA2C;AACrD,SAAK,UAAU,IAAI,SAAS,EAAE,QAAQ,QAAQ,OAAO,CAAC;AACtD,SAAK,QAAQ,QAAQ;AAAA,EACvB;AAAA,EAEA,MAAM,OAAO,OAA4F;AACvG,UAAM,WAAW,MAAM,KAAK,QAAQ,OAAO;AAAA,MACzC,gBAAgB,MAAM;AAAA,MACtB,GAAI,MAAM,YAAY,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;AAAA,MACxD,MAAM,KAAK;AAAA,MACX,iBAAiB;AAAA,MACjB,mBAAmB;AAAA,QACjB,aAAa;AAAA,QACb,kBAAkB,EAAE,sBAAsB,qCAAqC;AAAA,MACjF;AAAA,IACF,CAAC;AACD,WAAO;AAAA,MACL,MAAM,SAAS,QAAQ,IAAI,aAAW;AAAA,QACpC,OAAO,OAAO,SAAS;AAAA,QACvB,KAAK,OAAO;AAAA,QACZ,SAAS,OAAO,SAAS,KAAK,MAAM;AAAA,QACpC,cAAc,OAAO,gBAAgB;AAAA,MACvC,EAAE;AAAA,IACJ;AAAA,EACF;AAAA,EAEA,MAAM,MAAM,OAAkF;AAC5F,UAAM,WAAW,MAAM,KAAK,QAAQ,QAAQ;AAAA,MAC1C,MAAM,MAAM;AAAA,MACZ,GAAI,MAAM,YAAY,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC;AAAA,IAC1D,CAAC;AACD,UAAM,QAAQ;AAAA,MACZ,GAAG,SAAS,QAAQ,IAAI,aAAW;AAAA,QACjC,KAAK,OAAO;AAAA,QACZ,OAAO,OAAO,SAAS;AAAA,QACvB,SAAS,OAAO,gBAAgB,OAAO,SAAS,KAAK,MAAM;AAAA,QAC3D,OAAO;AAAA,MACT,EAAE;AAAA,MACF,GAAG,SAAS,OAAO,IAAI,UAAQ;AAAA,QAC7B,KAAK,IAAI;AAAA,QACT,OAAO;AAAA,QACP,SAAS;AAAA,QACT,OAAO,IAAI,WAAW,IAAI;AAAA,MAC5B,EAAE;AAAA,IACJ;AACA,WAAO,EAAE,MAAM;AAAA,EACjB;AACF;","names":[]}

package/dist/core/web-search/WebSearchProvider.d.ts

@@ -0,0 +1,42 @@
+/** Supported host web-search backends (env `TRUEFOUNDRY_WEB_SEARCH_PROVIDER.name`). */
+export declare enum WebSearchProviders {
+    Parallel = "parallel"
+}
+/** One search hit in the provider-normalized shape. */
+export interface WebSearchHit {
+    title: string;
+    url: string;
+    snippet: string;
+    published_at: string | null;
+}
+/** Normalized search response — stable across providers. */
+export interface WebSearchHits {
+    hits: WebSearchHit[];
+}
+/** One fetched page (or per-URL error) in the provider-normalized shape. */
+export interface WebFetchPage {
+    url: string;
+    title: string | null;
+    content: string;
+    error: string | null;
+}
+/** Normalized fetch/extract response — stable across providers. */
+export interface WebFetchPages {
+    pages: WebFetchPage[];
+}
+/**
+ * Host-supplied web search backend. Implementations map vendor APIs onto
+ * {@link WebSearchHits} / {@link WebFetchPages} so the capability tools stay provider-agnostic.
+ */
+export interface IWebSearchProvider {
+    readonly id: WebSearchProviders;
+    search(input: {
+        search_queries: string[];
+        objective: string | undefined;
+    }): Promise<WebSearchHits>;
+    fetch(input: {
+        urls: string[];
+        objective: string | undefined;
+    }): Promise<WebFetchPages>;
+}
+//# sourceMappingURL=WebSearchProvider.d.ts.map

package/dist/core/web-search/WebSearchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSearchProvider.d.ts","sourceRoot":"","sources":["../../../src/core/web-search/WebSearchProvider.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;CACtB;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAChC,MAAM,CAAC,KAAK,EAAE;QAAE,cAAc,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnG,KAAK,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACzF"}

package/dist/core/web-search/WebSearchProvider.js

@@ -0,0 +1,34 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/web-search/WebSearchProvider.ts
+var WebSearchProvider_exports = {};
+__export(WebSearchProvider_exports, {
+  WebSearchProviders: () => WebSearchProviders
+});
+module.exports = __toCommonJS(WebSearchProvider_exports);
+var WebSearchProviders = /* @__PURE__ */ ((WebSearchProviders2) => {
+  WebSearchProviders2["Parallel"] = "parallel";
+  return WebSearchProviders2;
+})(WebSearchProviders || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WebSearchProviders
+});
+//# sourceMappingURL=WebSearchProvider.js.map

package/dist/core/web-search/WebSearchProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/web-search/WebSearchProvider.ts"],"sourcesContent":["/** Supported host web-search backends (env `TRUEFOUNDRY_WEB_SEARCH_PROVIDER.name`). */\nexport enum WebSearchProviders {\n  Parallel = 'parallel',\n}\n\n/** One search hit in the provider-normalized shape. */\nexport interface WebSearchHit {\n  title: string;\n  url: string;\n  snippet: string;\n  published_at: string | null;\n}\n\n/** Normalized search response — stable across providers. */\nexport interface WebSearchHits {\n  hits: WebSearchHit[];\n}\n\n/** One fetched page (or per-URL error) in the provider-normalized shape. */\nexport interface WebFetchPage {\n  url: string;\n  title: string | null;\n  content: string;\n  error: string | null;\n}\n\n/** Normalized fetch/extract response — stable across providers. */\nexport interface WebFetchPages {\n  pages: WebFetchPage[];\n}\n\n/**\n * Host-supplied web search backend. Implementations map vendor APIs onto\n * {@link WebSearchHits} / {@link WebFetchPages} so the capability tools stay provider-agnostic.\n */\nexport interface IWebSearchProvider {\n  readonly id: WebSearchProviders;\n  search(input: { search_queries: string[]; objective: string | undefined }): Promise<WebSearchHits>;\n  fetch(input: { urls: string[]; objective: string | undefined }): Promise<WebFetchPages>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACO,IAAK,qBAAL,kBAAKA,wBAAL;AACL,EAAAA,oBAAA,cAAW;AADD,SAAAA;AAAA,GAAA;","names":["WebSearchProviders"]}

package/dist/core/web-search/WebSearchProvider.mjs

@@ -0,0 +1,9 @@
+// src/core/web-search/WebSearchProvider.ts
+var WebSearchProviders = /* @__PURE__ */ ((WebSearchProviders2) => {
+  WebSearchProviders2["Parallel"] = "parallel";
+  return WebSearchProviders2;
+})(WebSearchProviders || {});
+export {
+  WebSearchProviders
+};
+//# sourceMappingURL=WebSearchProvider.mjs.map

package/dist/core/web-search/WebSearchProvider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/web-search/WebSearchProvider.ts"],"sourcesContent":["/** Supported host web-search backends (env `TRUEFOUNDRY_WEB_SEARCH_PROVIDER.name`). */\nexport enum WebSearchProviders {\n  Parallel = 'parallel',\n}\n\n/** One search hit in the provider-normalized shape. */\nexport interface WebSearchHit {\n  title: string;\n  url: string;\n  snippet: string;\n  published_at: string | null;\n}\n\n/** Normalized search response — stable across providers. */\nexport interface WebSearchHits {\n  hits: WebSearchHit[];\n}\n\n/** One fetched page (or per-URL error) in the provider-normalized shape. */\nexport interface WebFetchPage {\n  url: string;\n  title: string | null;\n  content: string;\n  error: string | null;\n}\n\n/** Normalized fetch/extract response — stable across providers. */\nexport interface WebFetchPages {\n  pages: WebFetchPage[];\n}\n\n/**\n * Host-supplied web search backend. Implementations map vendor APIs onto\n * {@link WebSearchHits} / {@link WebFetchPages} so the capability tools stay provider-agnostic.\n */\nexport interface IWebSearchProvider {\n  readonly id: WebSearchProviders;\n  search(input: { search_queries: string[]; objective: string | undefined }): Promise<WebSearchHits>;\n  fetch(input: { urls: string[]; objective: string | undefined }): Promise<WebFetchPages>;\n}\n"],"mappings":";AACO,IAAK,qBAAL,kBAAKA,wBAAL;AACL,EAAAA,oBAAA,cAAW;AADD,SAAAA;AAAA,GAAA;","names":["WebSearchProviders"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truefoundry/trueforge-core",
-  "version": "0.2.0-rc.5",
+  "version": "0.2.0-rc.6",
   "description": "TrueForge Agent Harness library.",
   "author": "TrueFoundry",
   "license": "MIT",
@@ -103,6 +103,7 @@
     "ai": "^7.0.82",
     "dedent": "^1.7.2",
     "openai": "^7.5.0",
+    "parallel-web": "^1.3.3",
     "ulid": "^3.0.2",
     "undici": "7.29.0",
     "winston": "^3.19.0",