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

package/dist/core/mcp/toolSelectors.mjs

@@ -9,7 +9,7 @@ var REQUIRE_APPROVAL_TOOLS_SELECTOR_TAGS = [TOOL_TAG_ALL, TOOL_TAG_WRITE, TOOL_T
 var DEFAULT_ENABLE_TOOLS = [TOOL_TAG_ALL];
 var DEFAULT_DISABLE_TOOLS = [];
 var DEFAULT_PRELOAD_TOOLS = [];
-var DEFAULT_REQUIRE_APPROVAL_FOR_TOOLS = [TOOL_TAG_WRITE, TOOL_TAG_DESTRUCTIVE];
+var DEFAULT_REQUIRE_APPROVAL_FOR_TOOLS = [TOOL_TAG_DESTRUCTIVE];
 function isToolTag(selector) {
   return TOOL_TAGS.includes(selector);
 }

package/dist/core/mcp/toolSelectors.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/mcp/toolSelectors.ts"],"sourcesContent":["import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';\n\n/**\n * MCP server tool selectors are either a special tag or a literal tool name.\n *\n *   @all          — every tool on the server\n *   @read-only    — readOnlyHint === true\n *   @write        — readOnlyHint === false and not destructive\n *   @destructive   — destructiveHint === true\n */\nconst TOOL_TAG_ALL = '@all';\nconst TOOL_TAG_READ_ONLY = '@read-only';\nconst TOOL_TAG_WRITE = '@write';\nconst TOOL_TAG_DESTRUCTIVE = '@destructive';\n\nconst TOOL_TAGS = [TOOL_TAG_ALL, TOOL_TAG_READ_ONLY, TOOL_TAG_WRITE, TOOL_TAG_DESTRUCTIVE] as const;\ntype ToolTag = (typeof TOOL_TAGS)[number];\n\n/** Tags allowed on `enable_tools`, `disable_tools`, and `preload_tools`. */\nexport const TOOLS_SELECTOR_TAGS = [TOOL_TAG_ALL, TOOL_TAG_READ_ONLY] as const;\n\n/** Tags allowed on `require_approval_for_tools`. */\nexport const REQUIRE_APPROVAL_TOOLS_SELECTOR_TAGS = [TOOL_TAG_ALL, TOOL_TAG_WRITE, TOOL_TAG_DESTRUCTIVE] as const;\n\nexport const DEFAULT_ENABLE_TOOLS: string[] = [TOOL_TAG_ALL];\nexport const DEFAULT_DISABLE_TOOLS: string[] = [];\nexport const DEFAULT_PRELOAD_TOOLS: string[] = [];\nexport const DEFAULT_REQUIRE_APPROVAL_FOR_TOOLS: string[] = [TOOL_TAG_WRITE, TOOL_TAG_DESTRUCTIVE];\n\nfunction isToolTag(selector: string): selector is ToolTag {\n  return TOOL_TAGS.includes(selector as ToolTag);\n}\n\nfunction isReadOnly(annotations?: ToolAnnotations): boolean {\n  return annotations?.readOnlyHint === true;\n}\n\nfunction isWrite(annotations?: ToolAnnotations): boolean {\n  return annotations?.readOnlyHint === false && annotations.destructiveHint !== true;\n}\n\nfunction isDestructive(annotations?: ToolAnnotations): boolean {\n  return annotations?.destructiveHint === true;\n}\n\nfunction toolMatchesTag(tag: ToolTag, annotations: ToolAnnotations | undefined): boolean {\n  switch (tag) {\n    case TOOL_TAG_ALL:\n      return true;\n    case TOOL_TAG_READ_ONLY:\n      return isReadOnly(annotations);\n    case TOOL_TAG_WRITE:\n      return isWrite(annotations);\n    case TOOL_TAG_DESTRUCTIVE:\n      return isDestructive(annotations);\n  }\n}\n\n/** True if the tool matches any selector (tag or literal name). */\nexport function toolMatchesAnySelector(\n  toolName: string,\n  annotations: ToolAnnotations | undefined,\n  selectors: readonly string[] | undefined,\n): boolean {\n  if (!selectors?.length) {\n    return false;\n  }\n\n  for (const selector of selectors) {\n    if (isToolTag(selector)) {\n      if (toolMatchesTag(selector, annotations)) {\n        return true;\n      }\n    } else if (selector === toolName) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Whether the tool requires human approval before execution.\n * Matches `@write`, `@destructive`, `@all`, or explicit tool names against annotations.\n * Unannotated tools are exempt unless named in `require_approval_for_tools` or covered by `@all`.\n */\nexport function toolRequiresApproval(\n  toolName: string,\n  annotations: ToolAnnotations | undefined,\n  selectors: readonly string[] | undefined,\n): boolean {\n  if (!selectors?.length) {\n    return false;\n  }\n  return toolMatchesAnySelector(toolName, annotations, selectors);\n}\n\n/** True if the tool is enabled and not disabled. */\nexport function isToolAllowed(params: {\n  toolName: string;\n  annotations: ToolAnnotations | undefined;\n  enableSelectors: readonly string[];\n  disableSelectors: readonly string[];\n}): boolean {\n  const { toolName, annotations, enableSelectors, disableSelectors } = params;\n  if (!toolMatchesAnySelector(toolName, annotations, enableSelectors)) {\n    return false;\n  }\n  if (toolMatchesAnySelector(toolName, annotations, disableSelectors)) {\n    return false;\n  }\n  return true;\n}\n\n/** Non-tag names from a selector list (for upfront validation / sandbox allow-lists). */\nexport function literalToolNames(selectors: readonly string[] | undefined): string[] {\n  if (!selectors) {\n    return [];\n  }\n  return selectors.filter(s => !isToolTag(s));\n}\n\nexport function selectorsIncludeAll(selectors: readonly string[] | undefined): boolean {\n  return !!selectors?.includes(TOOL_TAG_ALL);\n}\n"],"mappings":";AAUA,IAAM,eAAe;AACrB,IAAM,qBAAqB;AAC3B,IAAM,iBAAiB;AACvB,IAAM,uBAAuB;AAE7B,IAAM,YAAY,CAAC,cAAc,oBAAoB,gBAAgB,oBAAoB;AAIlF,IAAM,sBAAsB,CAAC,cAAc,kBAAkB;AAG7D,IAAM,uCAAuC,CAAC,cAAc,gBAAgB,oBAAoB;AAEhG,IAAM,uBAAiC,CAAC,YAAY;AACpD,IAAM,wBAAkC,CAAC;AACzC,IAAM,wBAAkC,CAAC;AACzC,IAAM,qCAA+C,CAAC,gBAAgB,oBAAoB;AAEjG,SAAS,UAAU,UAAuC;AACxD,SAAO,UAAU,SAAS,QAAmB;AAC/C;AAEA,SAAS,WAAW,aAAwC;AAC1D,SAAO,aAAa,iBAAiB;AACvC;AAEA,SAAS,QAAQ,aAAwC;AACvD,SAAO,aAAa,iBAAiB,SAAS,YAAY,oBAAoB;AAChF;AAEA,SAAS,cAAc,aAAwC;AAC7D,SAAO,aAAa,oBAAoB;AAC1C;AAEA,SAAS,eAAe,KAAc,aAAmD;AACvF,UAAQ,KAAK;AAAA,IACX,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,WAAW,WAAW;AAAA,IAC/B,KAAK;AACH,aAAO,QAAQ,WAAW;AAAA,IAC5B,KAAK;AACH,aAAO,cAAc,WAAW;AAAA,EACpC;AACF;AAGO,SAAS,uBACd,UACA,aACA,WACS;AACT,MAAI,CAAC,WAAW,QAAQ;AACtB,WAAO;AAAA,EACT;AAEA,aAAW,YAAY,WAAW;AAChC,QAAI,UAAU,QAAQ,GAAG;AACvB,UAAI,eAAe,UAAU,WAAW,GAAG;AACzC,eAAO;AAAA,MACT;AAAA,IACF,WAAW,aAAa,UAAU;AAChC,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,qBACd,UACA,aACA,WACS;AACT,MAAI,CAAC,WAAW,QAAQ;AACtB,WAAO;AAAA,EACT;AACA,SAAO,uBAAuB,UAAU,aAAa,SAAS;AAChE;AAGO,SAAS,cAAc,QAKlB;AACV,QAAM,EAAE,UAAU,aAAa,iBAAiB,iBAAiB,IAAI;AACrE,MAAI,CAAC,uBAAuB,UAAU,aAAa,eAAe,GAAG;AACnE,WAAO;AAAA,EACT;AACA,MAAI,uBAAuB,UAAU,aAAa,gBAAgB,GAAG;AACnE,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAGO,SAAS,iBAAiB,WAAoD;AACnF,MAAI,CAAC,WAAW;AACd,WAAO,CAAC;AAAA,EACV;AACA,SAAO,UAAU,OAAO,OAAK,CAAC,UAAU,CAAC,CAAC;AAC5C;AAEO,SAAS,oBAAoB,WAAmD;AACrF,SAAO,CAAC,CAAC,WAAW,SAAS,YAAY;AAC3C;","names":[]}
+{"version":3,"sources":["../../../src/core/mcp/toolSelectors.ts"],"sourcesContent":["import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';\n\n/**\n * MCP server tool selectors are either a special tag or a literal tool name.\n *\n *   @all          — every tool on the server\n *   @read-only    — readOnlyHint === true\n *   @write        — readOnlyHint === false and not destructive\n *   @destructive   — destructiveHint === true\n */\nconst TOOL_TAG_ALL = '@all';\nconst TOOL_TAG_READ_ONLY = '@read-only';\nconst TOOL_TAG_WRITE = '@write';\nconst TOOL_TAG_DESTRUCTIVE = '@destructive';\n\nconst TOOL_TAGS = [TOOL_TAG_ALL, TOOL_TAG_READ_ONLY, TOOL_TAG_WRITE, TOOL_TAG_DESTRUCTIVE] as const;\ntype ToolTag = (typeof TOOL_TAGS)[number];\n\n/** Tags allowed on `enable_tools`, `disable_tools`, and `preload_tools`. */\nexport const TOOLS_SELECTOR_TAGS = [TOOL_TAG_ALL, TOOL_TAG_READ_ONLY] as const;\n\n/** Tags allowed on `require_approval_for_tools`. */\nexport const REQUIRE_APPROVAL_TOOLS_SELECTOR_TAGS = [TOOL_TAG_ALL, TOOL_TAG_WRITE, TOOL_TAG_DESTRUCTIVE] as const;\n\nexport const DEFAULT_ENABLE_TOOLS: string[] = [TOOL_TAG_ALL];\nexport const DEFAULT_DISABLE_TOOLS: string[] = [];\nexport const DEFAULT_PRELOAD_TOOLS: string[] = [];\nexport const DEFAULT_REQUIRE_APPROVAL_FOR_TOOLS: string[] = [TOOL_TAG_DESTRUCTIVE];\n\nfunction isToolTag(selector: string): selector is ToolTag {\n  return TOOL_TAGS.includes(selector as ToolTag);\n}\n\nfunction isReadOnly(annotations?: ToolAnnotations): boolean {\n  return annotations?.readOnlyHint === true;\n}\n\nfunction isWrite(annotations?: ToolAnnotations): boolean {\n  return annotations?.readOnlyHint === false && annotations.destructiveHint !== true;\n}\n\nfunction isDestructive(annotations?: ToolAnnotations): boolean {\n  return annotations?.destructiveHint === true;\n}\n\nfunction toolMatchesTag(tag: ToolTag, annotations: ToolAnnotations | undefined): boolean {\n  switch (tag) {\n    case TOOL_TAG_ALL:\n      return true;\n    case TOOL_TAG_READ_ONLY:\n      return isReadOnly(annotations);\n    case TOOL_TAG_WRITE:\n      return isWrite(annotations);\n    case TOOL_TAG_DESTRUCTIVE:\n      return isDestructive(annotations);\n  }\n}\n\n/** True if the tool matches any selector (tag or literal name). */\nexport function toolMatchesAnySelector(\n  toolName: string,\n  annotations: ToolAnnotations | undefined,\n  selectors: readonly string[] | undefined,\n): boolean {\n  if (!selectors?.length) {\n    return false;\n  }\n\n  for (const selector of selectors) {\n    if (isToolTag(selector)) {\n      if (toolMatchesTag(selector, annotations)) {\n        return true;\n      }\n    } else if (selector === toolName) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Whether the tool requires human approval before execution.\n * Matches `@write`, `@destructive`, `@all`, or explicit tool names against annotations.\n * Unannotated tools are exempt unless named in `require_approval_for_tools` or covered by `@all`.\n */\nexport function toolRequiresApproval(\n  toolName: string,\n  annotations: ToolAnnotations | undefined,\n  selectors: readonly string[] | undefined,\n): boolean {\n  if (!selectors?.length) {\n    return false;\n  }\n  return toolMatchesAnySelector(toolName, annotations, selectors);\n}\n\n/** True if the tool is enabled and not disabled. */\nexport function isToolAllowed(params: {\n  toolName: string;\n  annotations: ToolAnnotations | undefined;\n  enableSelectors: readonly string[];\n  disableSelectors: readonly string[];\n}): boolean {\n  const { toolName, annotations, enableSelectors, disableSelectors } = params;\n  if (!toolMatchesAnySelector(toolName, annotations, enableSelectors)) {\n    return false;\n  }\n  if (toolMatchesAnySelector(toolName, annotations, disableSelectors)) {\n    return false;\n  }\n  return true;\n}\n\n/** Non-tag names from a selector list (for upfront validation / sandbox allow-lists). */\nexport function literalToolNames(selectors: readonly string[] | undefined): string[] {\n  if (!selectors) {\n    return [];\n  }\n  return selectors.filter(s => !isToolTag(s));\n}\n\nexport function selectorsIncludeAll(selectors: readonly string[] | undefined): boolean {\n  return !!selectors?.includes(TOOL_TAG_ALL);\n}\n"],"mappings":";AAUA,IAAM,eAAe;AACrB,IAAM,qBAAqB;AAC3B,IAAM,iBAAiB;AACvB,IAAM,uBAAuB;AAE7B,IAAM,YAAY,CAAC,cAAc,oBAAoB,gBAAgB,oBAAoB;AAIlF,IAAM,sBAAsB,CAAC,cAAc,kBAAkB;AAG7D,IAAM,uCAAuC,CAAC,cAAc,gBAAgB,oBAAoB;AAEhG,IAAM,uBAAiC,CAAC,YAAY;AACpD,IAAM,wBAAkC,CAAC;AACzC,IAAM,wBAAkC,CAAC;AACzC,IAAM,qCAA+C,CAAC,oBAAoB;AAEjF,SAAS,UAAU,UAAuC;AACxD,SAAO,UAAU,SAAS,QAAmB;AAC/C;AAEA,SAAS,WAAW,aAAwC;AAC1D,SAAO,aAAa,iBAAiB;AACvC;AAEA,SAAS,QAAQ,aAAwC;AACvD,SAAO,aAAa,iBAAiB,SAAS,YAAY,oBAAoB;AAChF;AAEA,SAAS,cAAc,aAAwC;AAC7D,SAAO,aAAa,oBAAoB;AAC1C;AAEA,SAAS,eAAe,KAAc,aAAmD;AACvF,UAAQ,KAAK;AAAA,IACX,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,WAAW,WAAW;AAAA,IAC/B,KAAK;AACH,aAAO,QAAQ,WAAW;AAAA,IAC5B,KAAK;AACH,aAAO,cAAc,WAAW;AAAA,EACpC;AACF;AAGO,SAAS,uBACd,UACA,aACA,WACS;AACT,MAAI,CAAC,WAAW,QAAQ;AACtB,WAAO;AAAA,EACT;AAEA,aAAW,YAAY,WAAW;AAChC,QAAI,UAAU,QAAQ,GAAG;AACvB,UAAI,eAAe,UAAU,WAAW,GAAG;AACzC,eAAO;AAAA,MACT;AAAA,IACF,WAAW,aAAa,UAAU;AAChC,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,qBACd,UACA,aACA,WACS;AACT,MAAI,CAAC,WAAW,QAAQ;AACtB,WAAO;AAAA,EACT;AACA,SAAO,uBAAuB,UAAU,aAAa,SAAS;AAChE;AAGO,SAAS,cAAc,QAKlB;AACV,QAAM,EAAE,UAAU,aAAa,iBAAiB,iBAAiB,IAAI;AACrE,MAAI,CAAC,uBAAuB,UAAU,aAAa,eAAe,GAAG;AACnE,WAAO;AAAA,EACT;AACA,MAAI,uBAAuB,UAAU,aAAa,gBAAgB,GAAG;AACnE,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAGO,SAAS,iBAAiB,WAAoD;AACnF,MAAI,CAAC,WAAW;AACd,WAAO,CAAC;AAAA,EACV;AACA,SAAO,UAAU,OAAO,OAAK,CAAC,UAAU,CAAC,CAAC;AAC5C;AAEO,SAAS,oBAAoB,WAAmD;AACrF,SAAO,CAAC,CAAC,WAAW,SAAS,YAAY;AAC3C;","names":[]}

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

@@ -0,0 +1,24 @@
+import { WebSearchProviders, type IWebSearchProvider, type WebFetchPages, type WebSearchHits } from './WebSearchProvider';
+export type ParallelSearchMode = 'turbo' | 'fast' | 'basic' | 'advanced';
+export interface ParallelWebSearchProviderOptions {
+    apiKey: string;
+    /** Parallel Search mode preset. Caller supplies the default (e.g. `turbo`). */
+    mode: ParallelSearchMode;
+}
+/**
+ * Parallel Search + Extract via the official `parallel-web` SDK.
+ */
+export declare class ParallelWebSearchProvider implements IWebSearchProvider {
+    #private;
+    readonly id = WebSearchProviders.Parallel;
+    constructor(options: ParallelWebSearchProviderOptions);
+    search(input: {
+        search_queries: string[];
+        objective: string | undefined;
+    }): Promise<WebSearchHits>;
+    fetch(input: {
+        urls: string[];
+        objective: string | undefined;
+    }): Promise<WebFetchPages>;
+}
+//# sourceMappingURL=ParallelWebSearchProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelWebSearchProvider.d.ts","sourceRoot":"","sources":["../../../src/core/web-search/ParallelWebSearchProvider.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAOzE,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;;IAClE,QAAQ,CAAC,EAAE,+BAA+B;IAI1C,YAAY,OAAO,EAAE,gCAAgC,EAGpD;IAEK,MAAM,CAAC,KAAK,EAAE;QAAE,cAAc,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAmBvG;IAEK,KAAK,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAoB5F;CACF"}

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/dist/request-reply/client.d.ts

@@ -8,8 +8,8 @@ export interface SendRequestOptions {
 }
 /**
  * Publishes the request (JSON) on the worker channel, then polls the reply key with GETDEL
- * (see https://redis.io/docs/latest/commands/getdel/ ) until a result arrives or the wait
- * budget is exceeded.
+ * (see https://redis.io/docs/latest/commands/getdel/ ) until a result arrives, the executor
+ * heartbeat expires, or the wait budget is exceeded.
  */
 export declare function redisRequest<T extends JSONValue>({ redis: redisClient, executorId, path, request, options, }: {
     redis: RedisClientType;

package/dist/request-reply/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/request-reply/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAoB,eAAe,EAAE,MAAM,SAAS,CAAC;AAIvF,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC;CACxB;AAyBD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,EACtD,KAAK,EAAE,WAAW,EAClB,UAAU,EACV,IAAI,EACJ,OAAO,EACP,OAAO,GACR,EAAE;IACD,KAAK,EAAE,eAAe,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;CACnD,GAAG,OAAO,CAAC,SAAS,CAAC,CAkCrB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/request-reply/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAoB,eAAe,EAAE,MAAM,SAAS,CAAC;AAIvF,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC;CACxB;AAyBD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,EACtD,KAAK,EAAE,WAAW,EAClB,UAAU,EACV,IAAI,EACJ,OAAO,EACP,OAAO,GACR,EAAE;IACD,KAAK,EAAE,eAAe,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;CACnD,GAAG,OAAO,CAAC,SAAS,CAAC,CAuCrB"}

package/dist/request-reply/client.js

@@ -79,6 +79,9 @@ async function redisRequest({
     if (replyPayload) {
       return replyPayload;
     }
+    if (await redisClient.exists(aliveK) === 0) {
+      throw new import_errors.NoResponderError(executorId);
+    }
     if (import_node_perf_hooks.performance.now() >= replyDeadline) {
       throw new import_errors.RequestTimeoutError(replyTimeoutMs);
     }

package/dist/request-reply/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/request-reply/client.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { performance } from 'node:perf_hooks';\nimport type { RedisClientType } from 'redis';\nimport { NoResponderError, RequestTimeoutError } from './errors';\nimport type { JSONReply, JSONValue, PublishedRequest, RequestEnvelope } from './types';\nimport { jsonReplySchema } from './types';\nimport { heartbeatKey, replyKey, requestChannel, sleep } from './utils';\n\nexport interface SendRequestOptions {\n  /** Max time to wait for a reply after the request is published (ms). */\n  replyTimeoutMs: number;\n  /** Sleep between poll attempts when the reply is not yet present (ms). */\n  pollIntervalMs: number;\n}\n\nconst DEFAULT_REPLY_TIMEOUT_MS = 60_000;\nconst DEFAULT_POLL_INTERVAL_MS = 500;\n\nfunction resolveSendRequestOptions(options: Partial<SendRequestOptions> | undefined): SendRequestOptions {\n  return {\n    replyTimeoutMs: options?.replyTimeoutMs ?? DEFAULT_REPLY_TIMEOUT_MS,\n    pollIntervalMs: options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS,\n  };\n}\n\nfunction parseReplyPayload(raw: string) {\n  const parsed: unknown = JSON.parse(raw);\n  return jsonReplySchema.parse(parsed);\n}\n\nasync function getDelReply(redisClient: RedisClientType, rKey: string): Promise<JSONReply | null> {\n  const raw = await redisClient.getDel(rKey);\n  if (raw === null) {\n    return null;\n  }\n  return parseReplyPayload(raw);\n}\n\n/**\n * Publishes the request (JSON) on the worker channel, then polls the reply key with GETDEL\n * (see https://redis.io/docs/latest/commands/getdel/ ) until a result arrives or the wait\n * budget is exceeded.\n */\nexport async function redisRequest<T extends JSONValue>({\n  redis: redisClient,\n  executorId,\n  path,\n  request,\n  options,\n}: {\n  redis: RedisClientType;\n  executorId: string;\n  path: string;\n  request: RequestEnvelope<T>;\n  options?: Partial<SendRequestOptions> | undefined;\n}): Promise<JSONReply> {\n  const { replyTimeoutMs, pollIntervalMs } = resolveSendRequestOptions(options);\n  const aliveK = heartbeatKey(executorId);\n  if ((await redisClient.exists(aliveK)) === 0) {\n    throw new NoResponderError(executorId);\n  }\n\n  const requestId = randomUUID();\n  const rKey = replyKey(requestId);\n  const payload: PublishedRequest = {\n    replyKey: rKey,\n    path,\n    body: request.body,\n    headers: request.headers,\n  };\n  const serializedPayload = JSON.stringify(payload);\n  const subscriberCount = await redisClient.publish(requestChannel(executorId), serializedPayload);\n  if (subscriberCount === 0) {\n    throw new NoResponderError(executorId, 'No executor received the published request');\n  }\n\n  const replyDeadline = performance.now() + replyTimeoutMs;\n  // Give the executor a moment to process before the first poll.\n  await sleep(Math.min(200, replyTimeoutMs));\n  for (;;) {\n    const replyPayload = await getDelReply(redisClient, rKey);\n    if (replyPayload) {\n      return replyPayload;\n    }\n    if (performance.now() >= replyDeadline) {\n      throw new RequestTimeoutError(replyTimeoutMs);\n    }\n    await sleep(pollIntervalMs);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAA2B;AAC3B,6BAA4B;AAE5B,oBAAsD;AAEtD,mBAAgC;AAChC,mBAA8D;AAS9D,IAAM,2BAA2B;AACjC,IAAM,2BAA2B;AAEjC,SAAS,0BAA0B,SAAsE;AACvG,SAAO;AAAA,IACL,gBAAgB,SAAS,kBAAkB;AAAA,IAC3C,gBAAgB,SAAS,kBAAkB;AAAA,EAC7C;AACF;AAEA,SAAS,kBAAkB,KAAa;AACtC,QAAM,SAAkB,KAAK,MAAM,GAAG;AACtC,SAAO,6BAAgB,MAAM,MAAM;AACrC;AAEA,eAAe,YAAY,aAA8B,MAAyC;AAChG,QAAM,MAAM,MAAM,YAAY,OAAO,IAAI;AACzC,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AACA,SAAO,kBAAkB,GAAG;AAC9B;AAOA,eAAsB,aAAkC;AAAA,EACtD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMuB;AACrB,QAAM,EAAE,gBAAgB,eAAe,IAAI,0BAA0B,OAAO;AAC5E,QAAM,aAAS,2BAAa,UAAU;AACtC,MAAK,MAAM,YAAY,OAAO,MAAM,MAAO,GAAG;AAC5C,UAAM,IAAI,+BAAiB,UAAU;AAAA,EACvC;AAEA,QAAM,gBAAY,+BAAW;AAC7B,QAAM,WAAO,uBAAS,SAAS;AAC/B,QAAM,UAA4B;AAAA,IAChC,UAAU;AAAA,IACV;AAAA,IACA,MAAM,QAAQ;AAAA,IACd,SAAS,QAAQ;AAAA,EACnB;AACA,QAAM,oBAAoB,KAAK,UAAU,OAAO;AAChD,QAAM,kBAAkB,MAAM,YAAY,YAAQ,6BAAe,UAAU,GAAG,iBAAiB;AAC/F,MAAI,oBAAoB,GAAG;AACzB,UAAM,IAAI,+BAAiB,YAAY,4CAA4C;AAAA,EACrF;AAEA,QAAM,gBAAgB,mCAAY,IAAI,IAAI;AAE1C,YAAM,oBAAM,KAAK,IAAI,KAAK,cAAc,CAAC;AACzC,aAAS;AACP,UAAM,eAAe,MAAM,YAAY,aAAa,IAAI;AACxD,QAAI,cAAc;AAChB,aAAO;AAAA,IACT;AACA,QAAI,mCAAY,IAAI,KAAK,eAAe;AACtC,YAAM,IAAI,kCAAoB,cAAc;AAAA,IAC9C;AACA,cAAM,oBAAM,cAAc;AAAA,EAC5B;AACF;","names":[]}
+{"version":3,"sources":["../../src/request-reply/client.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { performance } from 'node:perf_hooks';\nimport type { RedisClientType } from 'redis';\nimport { NoResponderError, RequestTimeoutError } from './errors';\nimport type { JSONReply, JSONValue, PublishedRequest, RequestEnvelope } from './types';\nimport { jsonReplySchema } from './types';\nimport { heartbeatKey, replyKey, requestChannel, sleep } from './utils';\n\nexport interface SendRequestOptions {\n  /** Max time to wait for a reply after the request is published (ms). */\n  replyTimeoutMs: number;\n  /** Sleep between poll attempts when the reply is not yet present (ms). */\n  pollIntervalMs: number;\n}\n\nconst DEFAULT_REPLY_TIMEOUT_MS = 60_000;\nconst DEFAULT_POLL_INTERVAL_MS = 500;\n\nfunction resolveSendRequestOptions(options: Partial<SendRequestOptions> | undefined): SendRequestOptions {\n  return {\n    replyTimeoutMs: options?.replyTimeoutMs ?? DEFAULT_REPLY_TIMEOUT_MS,\n    pollIntervalMs: options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS,\n  };\n}\n\nfunction parseReplyPayload(raw: string) {\n  const parsed: unknown = JSON.parse(raw);\n  return jsonReplySchema.parse(parsed);\n}\n\nasync function getDelReply(redisClient: RedisClientType, rKey: string): Promise<JSONReply | null> {\n  const raw = await redisClient.getDel(rKey);\n  if (raw === null) {\n    return null;\n  }\n  return parseReplyPayload(raw);\n}\n\n/**\n * Publishes the request (JSON) on the worker channel, then polls the reply key with GETDEL\n * (see https://redis.io/docs/latest/commands/getdel/ ) until a result arrives, the executor\n * heartbeat expires, or the wait budget is exceeded.\n */\nexport async function redisRequest<T extends JSONValue>({\n  redis: redisClient,\n  executorId,\n  path,\n  request,\n  options,\n}: {\n  redis: RedisClientType;\n  executorId: string;\n  path: string;\n  request: RequestEnvelope<T>;\n  options?: Partial<SendRequestOptions> | undefined;\n}): Promise<JSONReply> {\n  const { replyTimeoutMs, pollIntervalMs } = resolveSendRequestOptions(options);\n  const aliveK = heartbeatKey(executorId);\n  if ((await redisClient.exists(aliveK)) === 0) {\n    throw new NoResponderError(executorId);\n  }\n\n  const requestId = randomUUID();\n  const rKey = replyKey(requestId);\n  const payload: PublishedRequest = {\n    replyKey: rKey,\n    path,\n    body: request.body,\n    headers: request.headers,\n  };\n  const serializedPayload = JSON.stringify(payload);\n  const subscriberCount = await redisClient.publish(requestChannel(executorId), serializedPayload);\n  if (subscriberCount === 0) {\n    throw new NoResponderError(executorId, 'No executor received the published request');\n  }\n\n  const replyDeadline = performance.now() + replyTimeoutMs;\n  // Give the executor a moment to process before the first poll.\n  await sleep(Math.min(200, replyTimeoutMs));\n  for (;;) {\n    const replyPayload = await getDelReply(redisClient, rKey);\n    if (replyPayload) {\n      return replyPayload;\n    }\n    // We already checked that the executor was alive before sending, but it may have\n    // died while we wait. Recheck here so we fail soon instead of waiting until the timeout.\n    if ((await redisClient.exists(aliveK)) === 0) {\n      throw new NoResponderError(executorId);\n    }\n    if (performance.now() >= replyDeadline) {\n      throw new RequestTimeoutError(replyTimeoutMs);\n    }\n    await sleep(pollIntervalMs);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAA2B;AAC3B,6BAA4B;AAE5B,oBAAsD;AAEtD,mBAAgC;AAChC,mBAA8D;AAS9D,IAAM,2BAA2B;AACjC,IAAM,2BAA2B;AAEjC,SAAS,0BAA0B,SAAsE;AACvG,SAAO;AAAA,IACL,gBAAgB,SAAS,kBAAkB;AAAA,IAC3C,gBAAgB,SAAS,kBAAkB;AAAA,EAC7C;AACF;AAEA,SAAS,kBAAkB,KAAa;AACtC,QAAM,SAAkB,KAAK,MAAM,GAAG;AACtC,SAAO,6BAAgB,MAAM,MAAM;AACrC;AAEA,eAAe,YAAY,aAA8B,MAAyC;AAChG,QAAM,MAAM,MAAM,YAAY,OAAO,IAAI;AACzC,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AACA,SAAO,kBAAkB,GAAG;AAC9B;AAOA,eAAsB,aAAkC;AAAA,EACtD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMuB;AACrB,QAAM,EAAE,gBAAgB,eAAe,IAAI,0BAA0B,OAAO;AAC5E,QAAM,aAAS,2BAAa,UAAU;AACtC,MAAK,MAAM,YAAY,OAAO,MAAM,MAAO,GAAG;AAC5C,UAAM,IAAI,+BAAiB,UAAU;AAAA,EACvC;AAEA,QAAM,gBAAY,+BAAW;AAC7B,QAAM,WAAO,uBAAS,SAAS;AAC/B,QAAM,UAA4B;AAAA,IAChC,UAAU;AAAA,IACV;AAAA,IACA,MAAM,QAAQ;AAAA,IACd,SAAS,QAAQ;AAAA,EACnB;AACA,QAAM,oBAAoB,KAAK,UAAU,OAAO;AAChD,QAAM,kBAAkB,MAAM,YAAY,YAAQ,6BAAe,UAAU,GAAG,iBAAiB;AAC/F,MAAI,oBAAoB,GAAG;AACzB,UAAM,IAAI,+BAAiB,YAAY,4CAA4C;AAAA,EACrF;AAEA,QAAM,gBAAgB,mCAAY,IAAI,IAAI;AAE1C,YAAM,oBAAM,KAAK,IAAI,KAAK,cAAc,CAAC;AACzC,aAAS;AACP,UAAM,eAAe,MAAM,YAAY,aAAa,IAAI;AACxD,QAAI,cAAc;AAChB,aAAO;AAAA,IACT;AAGA,QAAK,MAAM,YAAY,OAAO,MAAM,MAAO,GAAG;AAC5C,YAAM,IAAI,+BAAiB,UAAU;AAAA,IACvC;AACA,QAAI,mCAAY,IAAI,KAAK,eAAe;AACtC,YAAM,IAAI,kCAAoB,cAAc;AAAA,IAC9C;AACA,cAAM,oBAAM,cAAc;AAAA,EAC5B;AACF;","names":[]}

package/dist/request-reply/client.mjs

@@ -55,6 +55,9 @@ async function redisRequest({
     if (replyPayload) {
       return replyPayload;
     }
+    if (await redisClient.exists(aliveK) === 0) {
+      throw new NoResponderError(executorId);
+    }
     if (performance.now() >= replyDeadline) {
       throw new RequestTimeoutError(replyTimeoutMs);
     }

package/dist/request-reply/client.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/request-reply/client.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { performance } from 'node:perf_hooks';\nimport type { RedisClientType } from 'redis';\nimport { NoResponderError, RequestTimeoutError } from './errors';\nimport type { JSONReply, JSONValue, PublishedRequest, RequestEnvelope } from './types';\nimport { jsonReplySchema } from './types';\nimport { heartbeatKey, replyKey, requestChannel, sleep } from './utils';\n\nexport interface SendRequestOptions {\n  /** Max time to wait for a reply after the request is published (ms). */\n  replyTimeoutMs: number;\n  /** Sleep between poll attempts when the reply is not yet present (ms). */\n  pollIntervalMs: number;\n}\n\nconst DEFAULT_REPLY_TIMEOUT_MS = 60_000;\nconst DEFAULT_POLL_INTERVAL_MS = 500;\n\nfunction resolveSendRequestOptions(options: Partial<SendRequestOptions> | undefined): SendRequestOptions {\n  return {\n    replyTimeoutMs: options?.replyTimeoutMs ?? DEFAULT_REPLY_TIMEOUT_MS,\n    pollIntervalMs: options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS,\n  };\n}\n\nfunction parseReplyPayload(raw: string) {\n  const parsed: unknown = JSON.parse(raw);\n  return jsonReplySchema.parse(parsed);\n}\n\nasync function getDelReply(redisClient: RedisClientType, rKey: string): Promise<JSONReply | null> {\n  const raw = await redisClient.getDel(rKey);\n  if (raw === null) {\n    return null;\n  }\n  return parseReplyPayload(raw);\n}\n\n/**\n * Publishes the request (JSON) on the worker channel, then polls the reply key with GETDEL\n * (see https://redis.io/docs/latest/commands/getdel/ ) until a result arrives or the wait\n * budget is exceeded.\n */\nexport async function redisRequest<T extends JSONValue>({\n  redis: redisClient,\n  executorId,\n  path,\n  request,\n  options,\n}: {\n  redis: RedisClientType;\n  executorId: string;\n  path: string;\n  request: RequestEnvelope<T>;\n  options?: Partial<SendRequestOptions> | undefined;\n}): Promise<JSONReply> {\n  const { replyTimeoutMs, pollIntervalMs } = resolveSendRequestOptions(options);\n  const aliveK = heartbeatKey(executorId);\n  if ((await redisClient.exists(aliveK)) === 0) {\n    throw new NoResponderError(executorId);\n  }\n\n  const requestId = randomUUID();\n  const rKey = replyKey(requestId);\n  const payload: PublishedRequest = {\n    replyKey: rKey,\n    path,\n    body: request.body,\n    headers: request.headers,\n  };\n  const serializedPayload = JSON.stringify(payload);\n  const subscriberCount = await redisClient.publish(requestChannel(executorId), serializedPayload);\n  if (subscriberCount === 0) {\n    throw new NoResponderError(executorId, 'No executor received the published request');\n  }\n\n  const replyDeadline = performance.now() + replyTimeoutMs;\n  // Give the executor a moment to process before the first poll.\n  await sleep(Math.min(200, replyTimeoutMs));\n  for (;;) {\n    const replyPayload = await getDelReply(redisClient, rKey);\n    if (replyPayload) {\n      return replyPayload;\n    }\n    if (performance.now() >= replyDeadline) {\n      throw new RequestTimeoutError(replyTimeoutMs);\n    }\n    await sleep(pollIntervalMs);\n  }\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAE5B,SAAS,kBAAkB,2BAA2B;AAEtD,SAAS,uBAAuB;AAChC,SAAS,cAAc,UAAU,gBAAgB,aAAa;AAS9D,IAAM,2BAA2B;AACjC,IAAM,2BAA2B;AAEjC,SAAS,0BAA0B,SAAsE;AACvG,SAAO;AAAA,IACL,gBAAgB,SAAS,kBAAkB;AAAA,IAC3C,gBAAgB,SAAS,kBAAkB;AAAA,EAC7C;AACF;AAEA,SAAS,kBAAkB,KAAa;AACtC,QAAM,SAAkB,KAAK,MAAM,GAAG;AACtC,SAAO,gBAAgB,MAAM,MAAM;AACrC;AAEA,eAAe,YAAY,aAA8B,MAAyC;AAChG,QAAM,MAAM,MAAM,YAAY,OAAO,IAAI;AACzC,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AACA,SAAO,kBAAkB,GAAG;AAC9B;AAOA,eAAsB,aAAkC;AAAA,EACtD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMuB;AACrB,QAAM,EAAE,gBAAgB,eAAe,IAAI,0BAA0B,OAAO;AAC5E,QAAM,SAAS,aAAa,UAAU;AACtC,MAAK,MAAM,YAAY,OAAO,MAAM,MAAO,GAAG;AAC5C,UAAM,IAAI,iBAAiB,UAAU;AAAA,EACvC;AAEA,QAAM,YAAY,WAAW;AAC7B,QAAM,OAAO,SAAS,SAAS;AAC/B,QAAM,UAA4B;AAAA,IAChC,UAAU;AAAA,IACV;AAAA,IACA,MAAM,QAAQ;AAAA,IACd,SAAS,QAAQ;AAAA,EACnB;AACA,QAAM,oBAAoB,KAAK,UAAU,OAAO;AAChD,QAAM,kBAAkB,MAAM,YAAY,QAAQ,eAAe,UAAU,GAAG,iBAAiB;AAC/F,MAAI,oBAAoB,GAAG;AACzB,UAAM,IAAI,iBAAiB,YAAY,4CAA4C;AAAA,EACrF;AAEA,QAAM,gBAAgB,YAAY,IAAI,IAAI;AAE1C,QAAM,MAAM,KAAK,IAAI,KAAK,cAAc,CAAC;AACzC,aAAS;AACP,UAAM,eAAe,MAAM,YAAY,aAAa,IAAI;AACxD,QAAI,cAAc;AAChB,aAAO;AAAA,IACT;AACA,QAAI,YAAY,IAAI,KAAK,eAAe;AACtC,YAAM,IAAI,oBAAoB,cAAc;AAAA,IAC9C;AACA,UAAM,MAAM,cAAc;AAAA,EAC5B;AACF;","names":[]}
+{"version":3,"sources":["../../src/request-reply/client.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { performance } from 'node:perf_hooks';\nimport type { RedisClientType } from 'redis';\nimport { NoResponderError, RequestTimeoutError } from './errors';\nimport type { JSONReply, JSONValue, PublishedRequest, RequestEnvelope } from './types';\nimport { jsonReplySchema } from './types';\nimport { heartbeatKey, replyKey, requestChannel, sleep } from './utils';\n\nexport interface SendRequestOptions {\n  /** Max time to wait for a reply after the request is published (ms). */\n  replyTimeoutMs: number;\n  /** Sleep between poll attempts when the reply is not yet present (ms). */\n  pollIntervalMs: number;\n}\n\nconst DEFAULT_REPLY_TIMEOUT_MS = 60_000;\nconst DEFAULT_POLL_INTERVAL_MS = 500;\n\nfunction resolveSendRequestOptions(options: Partial<SendRequestOptions> | undefined): SendRequestOptions {\n  return {\n    replyTimeoutMs: options?.replyTimeoutMs ?? DEFAULT_REPLY_TIMEOUT_MS,\n    pollIntervalMs: options?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS,\n  };\n}\n\nfunction parseReplyPayload(raw: string) {\n  const parsed: unknown = JSON.parse(raw);\n  return jsonReplySchema.parse(parsed);\n}\n\nasync function getDelReply(redisClient: RedisClientType, rKey: string): Promise<JSONReply | null> {\n  const raw = await redisClient.getDel(rKey);\n  if (raw === null) {\n    return null;\n  }\n  return parseReplyPayload(raw);\n}\n\n/**\n * Publishes the request (JSON) on the worker channel, then polls the reply key with GETDEL\n * (see https://redis.io/docs/latest/commands/getdel/ ) until a result arrives, the executor\n * heartbeat expires, or the wait budget is exceeded.\n */\nexport async function redisRequest<T extends JSONValue>({\n  redis: redisClient,\n  executorId,\n  path,\n  request,\n  options,\n}: {\n  redis: RedisClientType;\n  executorId: string;\n  path: string;\n  request: RequestEnvelope<T>;\n  options?: Partial<SendRequestOptions> | undefined;\n}): Promise<JSONReply> {\n  const { replyTimeoutMs, pollIntervalMs } = resolveSendRequestOptions(options);\n  const aliveK = heartbeatKey(executorId);\n  if ((await redisClient.exists(aliveK)) === 0) {\n    throw new NoResponderError(executorId);\n  }\n\n  const requestId = randomUUID();\n  const rKey = replyKey(requestId);\n  const payload: PublishedRequest = {\n    replyKey: rKey,\n    path,\n    body: request.body,\n    headers: request.headers,\n  };\n  const serializedPayload = JSON.stringify(payload);\n  const subscriberCount = await redisClient.publish(requestChannel(executorId), serializedPayload);\n  if (subscriberCount === 0) {\n    throw new NoResponderError(executorId, 'No executor received the published request');\n  }\n\n  const replyDeadline = performance.now() + replyTimeoutMs;\n  // Give the executor a moment to process before the first poll.\n  await sleep(Math.min(200, replyTimeoutMs));\n  for (;;) {\n    const replyPayload = await getDelReply(redisClient, rKey);\n    if (replyPayload) {\n      return replyPayload;\n    }\n    // We already checked that the executor was alive before sending, but it may have\n    // died while we wait. Recheck here so we fail soon instead of waiting until the timeout.\n    if ((await redisClient.exists(aliveK)) === 0) {\n      throw new NoResponderError(executorId);\n    }\n    if (performance.now() >= replyDeadline) {\n      throw new RequestTimeoutError(replyTimeoutMs);\n    }\n    await sleep(pollIntervalMs);\n  }\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAE5B,SAAS,kBAAkB,2BAA2B;AAEtD,SAAS,uBAAuB;AAChC,SAAS,cAAc,UAAU,gBAAgB,aAAa;AAS9D,IAAM,2BAA2B;AACjC,IAAM,2BAA2B;AAEjC,SAAS,0BAA0B,SAAsE;AACvG,SAAO;AAAA,IACL,gBAAgB,SAAS,kBAAkB;AAAA,IAC3C,gBAAgB,SAAS,kBAAkB;AAAA,EAC7C;AACF;AAEA,SAAS,kBAAkB,KAAa;AACtC,QAAM,SAAkB,KAAK,MAAM,GAAG;AACtC,SAAO,gBAAgB,MAAM,MAAM;AACrC;AAEA,eAAe,YAAY,aAA8B,MAAyC;AAChG,QAAM,MAAM,MAAM,YAAY,OAAO,IAAI;AACzC,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AACA,SAAO,kBAAkB,GAAG;AAC9B;AAOA,eAAsB,aAAkC;AAAA,EACtD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMuB;AACrB,QAAM,EAAE,gBAAgB,eAAe,IAAI,0BAA0B,OAAO;AAC5E,QAAM,SAAS,aAAa,UAAU;AACtC,MAAK,MAAM,YAAY,OAAO,MAAM,MAAO,GAAG;AAC5C,UAAM,IAAI,iBAAiB,UAAU;AAAA,EACvC;AAEA,QAAM,YAAY,WAAW;AAC7B,QAAM,OAAO,SAAS,SAAS;AAC/B,QAAM,UAA4B;AAAA,IAChC,UAAU;AAAA,IACV;AAAA,IACA,MAAM,QAAQ;AAAA,IACd,SAAS,QAAQ;AAAA,EACnB;AACA,QAAM,oBAAoB,KAAK,UAAU,OAAO;AAChD,QAAM,kBAAkB,MAAM,YAAY,QAAQ,eAAe,UAAU,GAAG,iBAAiB;AAC/F,MAAI,oBAAoB,GAAG;AACzB,UAAM,IAAI,iBAAiB,YAAY,4CAA4C;AAAA,EACrF;AAEA,QAAM,gBAAgB,YAAY,IAAI,IAAI;AAE1C,QAAM,MAAM,KAAK,IAAI,KAAK,cAAc,CAAC;AACzC,aAAS;AACP,UAAM,eAAe,MAAM,YAAY,aAAa,IAAI;AACxD,QAAI,cAAc;AAChB,aAAO;AAAA,IACT;AAGA,QAAK,MAAM,YAAY,OAAO,MAAM,MAAO,GAAG;AAC5C,YAAM,IAAI,iBAAiB,UAAU;AAAA,IACvC;AACA,QAAI,YAAY,IAAI,KAAK,eAAe;AACtC,YAAM,IAAI,oBAAoB,cAAc;AAAA,IAC9C;AACA,UAAM,MAAM,cAAc;AAAA,EAC5B;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truefoundry/trueforge-core",
-  "version": "0.2.0-rc.4",
+  "version": "0.2.0-rc.6",
   "description": "TrueForge Agent Harness library.",
   "author": "TrueFoundry",
   "license": "MIT",
@@ -103,7 +103,9 @@
     "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",
     "ws": "^8.21.3",
     "zod": "^4.4.3"