@lloyal-labs/rig 1.3.0 → 1.4.0

package/dist/index.d.ts

@@ -1,20 +1,23 @@
 /**
- * Rig — research infrastructure for the lloyal agent pipeline
+ * Rig — data sources and tools for the lloyal agent pipeline
  *
  * The default export is platform-agnostic. linkedom + @mozilla/readability
  * are pure JS and work in both Node.js and React Native (Hermes).
  *
- * Node-specific exports (createReranker, WebSource, CorpusSource,
- * loadResources, chunkResources) require node:fs and are available
- * via `@lloyal-labs/rig/node`.
+ * Node-specific exports (createReranker, loadResources, chunkResources)
+ * require node:fs and are available via `@lloyal-labs/rig/node`.
  *
  * @packageDocumentation
  * @category Rig
  */
-export { createTools, reportTool, ResearchTool, WebSearchTool, TavilyProvider, FetchPageTool, WebResearchTool, PlanTool, } from './tools';
-export type { ResearchToolOpts, WebResearchToolOpts, PlanToolOpts, PlanResult, PlanQuestion, SearchProvider, SearchResult, Reranker, ScoredChunk, ScoredResult, } from './tools';
+export { createTools, reportTool, ReportTool, WebSearchTool, TavilyProvider, FetchPageTool, PlanTool, } from './tools';
+export type { PlanToolOpts, PlanResult, PlanQuestion, SearchProvider, SearchResult, Reranker, ScoredChunk, ScoredResult, } from './tools';
+export { WebSource } from './sources/web';
+export type { WebSourceOpts } from './sources/web';
+export { CorpusSource } from './sources/corpus';
+export type { CorpusSourceOpts } from './sources/corpus';
+export type { SourceContext } from './sources/types';
 export { chunkFetchedPages, chunkHtml } from './sources/chunking';
 export type { FetchedPage } from './sources/chunking';
-export type { SourceContext } from './sources/types';
 export type { Resource, Chunk } from './resources/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,WAAW,EAAE,UAAU,EACvB,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAC1D,eAAe,EAAE,QAAQ,GAC1B,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EACnD,UAAU,EAAE,YAAY,EACxB,cAAc,EAAE,YAAY,EAC5B,QAAQ,EAAE,WAAW,EAAE,YAAY,GACpC,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,WAAW,EAAE,UAAU,EAAE,UAAU,EACnC,aAAa,EAAE,cAAc,EAAE,aAAa,EAC5C,QAAQ,GACT,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,YAAY,EACZ,UAAU,EAAE,YAAY,EACxB,cAAc,EAAE,YAAY,EAC5B,QAAQ,EAAE,WAAW,EAAE,YAAY,GACpC,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,29 +1,32 @@
 "use strict";
 /**
- * Rig — research infrastructure for the lloyal agent pipeline
+ * Rig — data sources and tools for the lloyal agent pipeline
  *
  * The default export is platform-agnostic. linkedom + @mozilla/readability
  * are pure JS and work in both Node.js and React Native (Hermes).
  *
- * Node-specific exports (createReranker, WebSource, CorpusSource,
- * loadResources, chunkResources) require node:fs and are available
- * via `@lloyal-labs/rig/node`.
+ * Node-specific exports (createReranker, loadResources, chunkResources)
+ * require node:fs and are available via `@lloyal-labs/rig/node`.
  *
  * @packageDocumentation
  * @category Rig
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.chunkHtml = exports.chunkFetchedPages = exports.PlanTool = exports.WebResearchTool = exports.FetchPageTool = exports.TavilyProvider = exports.WebSearchTool = exports.ResearchTool = exports.reportTool = exports.createTools = void 0;
+exports.chunkHtml = exports.chunkFetchedPages = exports.CorpusSource = exports.WebSource = exports.PlanTool = exports.FetchPageTool = exports.TavilyProvider = exports.WebSearchTool = exports.ReportTool = exports.reportTool = exports.createTools = void 0;
 // Tools (pure TS + Effection + linkedom — platform-agnostic)
 var tools_1 = require("./tools");
 Object.defineProperty(exports, "createTools", { enumerable: true, get: function () { return tools_1.createTools; } });
 Object.defineProperty(exports, "reportTool", { enumerable: true, get: function () { return tools_1.reportTool; } });
-Object.defineProperty(exports, "ResearchTool", { enumerable: true, get: function () { return tools_1.ResearchTool; } });
+Object.defineProperty(exports, "ReportTool", { enumerable: true, get: function () { return tools_1.ReportTool; } });
 Object.defineProperty(exports, "WebSearchTool", { enumerable: true, get: function () { return tools_1.WebSearchTool; } });
 Object.defineProperty(exports, "TavilyProvider", { enumerable: true, get: function () { return tools_1.TavilyProvider; } });
 Object.defineProperty(exports, "FetchPageTool", { enumerable: true, get: function () { return tools_1.FetchPageTool; } });
-Object.defineProperty(exports, "WebResearchTool", { enumerable: true, get: function () { return tools_1.WebResearchTool; } });
 Object.defineProperty(exports, "PlanTool", { enumerable: true, get: function () { return tools_1.PlanTool; } });
+// Sources (platform-agnostic — no node:fs)
+var web_1 = require("./sources/web");
+Object.defineProperty(exports, "WebSource", { enumerable: true, get: function () { return web_1.WebSource; } });
+var corpus_1 = require("./sources/corpus");
+Object.defineProperty(exports, "CorpusSource", { enumerable: true, get: function () { return corpus_1.CorpusSource; } });
 // Chunking (platform-agnostic — linkedom is pure JS)
 var chunking_1 = require("./sources/chunking");
 Object.defineProperty(exports, "chunkFetchedPages", { enumerable: true, get: function () { return chunking_1.chunkFetchedPages; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,6DAA6D;AAC7D,iCAIiB;AAHf,oGAAA,WAAW,OAAA;AAAE,mGAAA,UAAU,OAAA;AACvB,qGAAA,YAAY,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,sGAAA,aAAa,OAAA;AAC1D,wGAAA,eAAe,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAS3B,qDAAqD;AACrD,+CAAkE;AAAzD,6GAAA,iBAAiB,OAAA;AAAE,qGAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,6DAA6D;AAC7D,iCAIiB;AAHf,oGAAA,WAAW,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,mGAAA,UAAU,OAAA;AACnC,sGAAA,aAAa,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,sGAAA,aAAa,OAAA;AAC5C,iGAAA,QAAQ,OAAA;AASV,2CAA2C;AAC3C,qCAA0C;AAAjC,gGAAA,SAAS,OAAA;AAElB,2CAAgD;AAAvC,sGAAA,YAAY,OAAA;AAIrB,qDAAqD;AACrD,+CAAkE;AAAzD,6GAAA,iBAAiB,OAAA;AAAE,qGAAA,SAAS,OAAA"}

package/dist/node.d.ts

@@ -4,12 +4,13 @@
  * These require node:fs and/or @lloyal-labs/lloyal.node.
  * Import from `@lloyal-labs/rig/node` only in Node.js environments.
  *
+ * Sources (WebSource, CorpusSource) are now platform-agnostic and
+ * exported from the main `@lloyal-labs/rig` entry.
+ *
  * @packageDocumentation
  * @category Rig
  */
 export * from './index';
 export { createReranker } from './reranker';
-export { WebSource } from './sources/web';
-export { CorpusSource } from './sources/corpus';
 export { loadResources, chunkResources } from './resources';
 //# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/node.js

@@ -5,6 +5,9 @@
  * These require node:fs and/or @lloyal-labs/lloyal.node.
  * Import from `@lloyal-labs/rig/node` only in Node.js environments.
  *
+ * Sources (WebSource, CorpusSource) are now platform-agnostic and
+ * exported from the main `@lloyal-labs/rig` entry.
+ *
  * @packageDocumentation
  * @category Rig
  */
@@ -23,17 +26,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.chunkResources = exports.loadResources = exports.CorpusSource = exports.WebSource = exports.createReranker = void 0;
+exports.chunkResources = exports.loadResources = exports.createReranker = void 0;
 // Re-export everything from the platform-agnostic barrel
 __exportStar(require("./index"), exports);
 // Node-only: Reranker factory (requires @lloyal-labs/lloyal.node)
 var reranker_1 = require("./reranker");
 Object.defineProperty(exports, "createReranker", { enumerable: true, get: function () { return reranker_1.createReranker; } });
-// Node-only: Sources (require node:fs)
-var web_1 = require("./sources/web");
-Object.defineProperty(exports, "WebSource", { enumerable: true, get: function () { return web_1.WebSource; } });
-var corpus_1 = require("./sources/corpus");
-Object.defineProperty(exports, "CorpusSource", { enumerable: true, get: function () { return corpus_1.CorpusSource; } });
 // Node-only: Resource loading (requires node:fs)
 var resources_1 = require("./resources");
 Object.defineProperty(exports, "loadResources", { enumerable: true, get: function () { return resources_1.loadResources; } });

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;AAEH,yDAAyD;AACzD,0CAAwB;AAExB,kEAAkE;AAClE,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AAEvB,uCAAuC;AACvC,qCAA0C;AAAjC,gGAAA,SAAS,OAAA;AAClB,2CAAgD;AAAvC,sGAAA,YAAY,OAAA;AAErB,iDAAiD;AACjD,yCAA4D;AAAnD,0GAAA,aAAa,OAAA;AAAE,2GAAA,cAAc,OAAA"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;AAEH,yDAAyD;AACzD,0CAAwB;AAExB,kEAAkE;AAClE,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AAEvB,iDAAiD;AACjD,yCAA4D;AAAnD,0GAAA,aAAa,OAAA;AAAE,2GAAA,cAAc,OAAA"}

package/dist/sources/corpus.d.ts

@@ -1,22 +1,8 @@
 import type { Operation } from "effection";
 import { Source } from "@lloyal-labs/lloyal-agents";
-import type { Tool, PressureThresholds } from "@lloyal-labs/lloyal-agents";
+import type { Tool } from "@lloyal-labs/lloyal-agents";
 import type { Resource, Chunk } from "../resources/types";
-import type { SourceContext } from "./types";
-/**
- * Corpus-backed research source using local file search, read, and grep
- *
- * Provides grounding tools (`search`, `read_file`, `grep`) over a set of
- * loaded {@link Resource} / {@link Chunk} pairs. On {@link bind}, tokenizes
- * chunks via the reranker and prepends a reranker-backed `search` tool to
- * the tool list. The `search` tool is ordered first so the model prefers
- * semantic search before falling back to `read_file` or `grep`.
- *
- * The research tool is a self-referential {@link ResearchTool} that spawns
- * sub-agents with corpus-specific prompts and the full grounding toolkit.
- *
- * @category Rig
- */
+import type { Reranker } from "../tools/types";
 /**
  * Configuration for {@link CorpusSource}.
  *
@@ -35,40 +21,42 @@ export interface CorpusSourceOpts {
         /** Default max lines when no range specified. @default 100 */
         defaultMaxLines?: number;
     };
-    /** ResearchTool overrides */
-    research?: {
-        /** Override pressure thresholds for inner research pool */
-        pressure?: PressureThresholds;
-    };
 }
-export declare class CorpusSource extends Source<SourceContext, Chunk> {
+/**
+ * Corpus-backed data source using local file search, read, and grep
+ *
+ * Provides three tools: semantic search (via reranker), file reading,
+ * and regex grep. On {@link bind}, tokenizes chunks through the reranker
+ * and prepends a reranker-backed search tool.
+ *
+ * No orchestration, no prompts, no node:fs. Use {@link spawnAgents}
+ * from your harness to orchestrate agents with these tools.
+ *
+ * @category Rig
+ */
+export declare class CorpusSource extends Source<{
+    reranker: Reranker;
+}, Chunk> {
     private _chunks;
     private _tools;
-    private _researchTool;
     private _bound;
-    private _researchOpts?;
     /** @inheritDoc */
     readonly name = "corpus";
     /**
      * @param resources - Loaded file resources for read_file and grep tools
      * @param chunks - Pre-split chunks for reranker-backed search
-     * @param opts - Configuration for grep, read_file, and research tools
+     * @param opts - Configuration for grep and read_file tools
      */
     constructor(resources: Resource[], chunks: Chunk[], opts?: CorpusSourceOpts);
     /** @inheritDoc */
-    get researchTool(): Tool;
-    /** @inheritDoc */
-    get groundingTools(): Tool[];
+    get tools(): Tool[];
     /**
-     * Late-bind reranker and build the research toolkit
-     *
-     * Tokenizes all chunks through the reranker, prepends a {@link SearchTool}
-     * to the tool list, then constructs the self-referential
-     * {@link ResearchTool} with corpus-specific prompts. Idempotent — skips
-     * if already bound.
-     *
+     * Late-bind reranker: tokenize chunks and prepend SearchTool.
+     * Idempotent — skips if already bound.
      * @inheritDoc
      */
-    bind(ctx: SourceContext): Operation<void>;
+    bind(ctx: {
+        reranker: Reranker;
+    }): Operation<void>;
 }
 //# sourceMappingURL=corpus.d.ts.map

package/dist/sources/corpus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../../src/sources/corpus.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAwB,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAe7C;;;;;;;;;;;;;GAaG;AACH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,IAAI,CAAC,EAAE;QACL,wCAAwC;QACxC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,+CAA+C;QAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,iCAAiC;IACjC,QAAQ,CAAC,EAAE;QACT,8DAA8D;QAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,6BAA6B;IAC7B,QAAQ,CAAC,EAAE;QACT,2DAA2D;QAC3D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;KAC/B,CAAC;CACH;AAED,qBAAa,YAAa,SAAQ,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC;IAC5D,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAC,CAA+B;IAErD,kBAAkB;IAClB,QAAQ,CAAC,IAAI,YAAY;IAEzB;;;;OAIG;gBACS,SAAS,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,EAAE,gBAAgB;IAU3E,kBAAkB;IAClB,IAAI,YAAY,IAAI,IAAI,CAIvB;IAED,kBAAkB;IAClB,IAAI,cAAc,IAAI,IAAI,EAAE,CAAwB;IAEpD;;;;;;;;;OASG;IACF,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC;CAqB3C"}
+{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../../src/sources/corpus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAS,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,IAAI,CAAC,EAAE;QACL,wCAAwC;QACxC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,+CAA+C;QAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,iCAAiC;IACjC,QAAQ,CAAC,EAAE;QACT,8DAA8D;QAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,YAAa,SAAQ,MAAM,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,EAAE,KAAK,CAAC;IACrE,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IAEvB,kBAAkB;IAClB,QAAQ,CAAC,IAAI,YAAY;IAEzB;;;;OAIG;gBACS,SAAS,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,EAAE,gBAAgB;IAS3E,kBAAkB;IAClB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAwB;IAE3C;;;;OAIG;IACF,IAAI,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,SAAS,CAAC,IAAI,CAAC;CASpD"}

package/dist/sources/corpus.js

@@ -1,35 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CorpusSource = void 0;
-const fs = require("node:fs");
-const path = require("node:path");
 const effection_1 = require("effection");
 const lloyal_agents_1 = require("@lloyal-labs/lloyal-agents");
 const search_1 = require("../tools/search");
 const read_file_1 = require("../tools/read-file");
 const grep_1 = require("../tools/grep");
-const research_1 = require("../tools/research");
-function readTask(name) {
-    const raw = fs
-        .readFileSync(path.resolve(__dirname, `${name}.md`), "utf8")
-        .trim();
-    const sep = raw.indexOf("\n---\n");
-    if (sep === -1)
-        return { system: raw, user: "" };
-    return { system: raw.slice(0, sep).trim(), user: raw.slice(sep + 5).trim() };
-}
+/**
+ * Corpus-backed data source using local file search, read, and grep
+ *
+ * Provides three tools: semantic search (via reranker), file reading,
+ * and regex grep. On {@link bind}, tokenizes chunks through the reranker
+ * and prepends a reranker-backed search tool.
+ *
+ * No orchestration, no prompts, no node:fs. Use {@link spawnAgents}
+ * from your harness to orchestrate agents with these tools.
+ *
+ * @category Rig
+ */
 class CorpusSource extends lloyal_agents_1.Source {
     _chunks;
-    _tools = [];
-    _researchTool = null;
+    _tools;
     _bound = false;
-    _researchOpts;
     /** @inheritDoc */
     name = "corpus";
     /**
      * @param resources - Loaded file resources for read_file and grep tools
      * @param chunks - Pre-split chunks for reranker-backed search
-     * @param opts - Configuration for grep, read_file, and research tools
+     * @param opts - Configuration for grep and read_file tools
      */
     constructor(resources, chunks, opts) {
         super();
@@ -38,24 +36,12 @@ class CorpusSource extends lloyal_agents_1.Source {
             new read_file_1.ReadFileTool(resources, opts?.readFile),
             new grep_1.GrepTool(resources, opts?.grep),
         ];
-        this._researchOpts = opts?.research;
-    }
-    /** @inheritDoc */
-    get researchTool() {
-        if (!this._researchTool)
-            throw new Error("CorpusSource: bind() must be called first");
-        return this._researchTool;
     }
     /** @inheritDoc */
-    get groundingTools() { return this._tools; }
+    get tools() { return this._tools; }
     /**
-     * Late-bind reranker and build the research toolkit
-     *
-     * Tokenizes all chunks through the reranker, prepends a {@link SearchTool}
-     * to the tool list, then constructs the self-referential
-     * {@link ResearchTool} with corpus-specific prompts. Idempotent — skips
-     * if already bound.
-     *
+     * Late-bind reranker: tokenize chunks and prepend SearchTool.
+     * Idempotent — skips if already bound.
      * @inheritDoc
      */
     *bind(ctx) {
@@ -66,17 +52,6 @@ class CorpusSource extends lloyal_agents_1.Source {
             type: 'source:bind', sourceName: this.name });
         yield* (0, effection_1.call)(() => ctx.reranker.tokenizeChunks(this._chunks));
         this._tools.unshift(new search_1.SearchTool(this._chunks, ctx.reranker));
-        const researchPrompt = readTask("corpus-research");
-        const research = new research_1.ResearchTool({
-            systemPrompt: researchPrompt.system,
-            reporterPrompt: ctx.reporterPrompt,
-            maxTurns: ctx.maxTurns,
-            trace: ctx.trace,
-            pressure: this._researchOpts?.pressure,
-        });
-        const toolkit = (0, lloyal_agents_1.createToolkit)([...this._tools, ctx.reportTool, research]);
-        research.setToolkit(toolkit);
-        this._researchTool = research;
         this._bound = true;
     }
 }

package/dist/sources/corpus.js.map

@@ -1 +1 @@
-{"version":3,"file":"corpus.js","sourceRoot":"","sources":["../../src/sources/corpus.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"corpus.js","sourceRoot":"","sources":["../../src/sources/corpus.ts"],"names":[],"mappings":";;;AAAA,yCAAiC;AAEjC,8DAA2D;AAI3D,4CAA6C;AAC7C,kDAAkD;AAClD,wCAAyC;AAsBzC;;;;;;;;;;;GAWG;AACH,MAAa,YAAa,SAAQ,sBAAqC;IAC7D,OAAO,CAAU;IACjB,MAAM,CAAS;IACf,MAAM,GAAG,KAAK,CAAC;IAEvB,kBAAkB;IACT,IAAI,GAAG,QAAQ,CAAC;IAEzB;;;;OAIG;IACH,YAAY,SAAqB,EAAE,MAAe,EAAE,IAAuB;QACzE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,wBAAY,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC;YAC3C,IAAI,eAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC;SACpC,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,IAAI,KAAK,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAE3C;;;;OAIG;IACH,CAAC,IAAI,CAAC,GAA2B;QAC/B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,qBAAK,CAAC,MAAM,EAAE,CAAC;QACjC,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE;YACzE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,KAAK,CAAC,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,mBAAU,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF;AAvCD,oCAuCC"}

package/dist/sources/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Source implementations for the research pipeline
+ * Source implementations — data backends for agent pipelines
  *
  * @packageDocumentation
  * @category Rig

package/dist/sources/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CorpusSource = exports.WebSource = void 0;
 /**
- * Source implementations for the research pipeline
+ * Source implementations — data backends for agent pipelines
  *
  * @packageDocumentation
  * @category Rig

package/dist/sources/types.d.ts

@@ -1,28 +1,16 @@
-import type { Tool } from '@lloyal-labs/lloyal-agents';
 import type { Reranker } from '../tools/types';
 /**
- * Runtime context passed to {@link Source.bind} during pipeline setup
+ * Runtime context passed to {@link Source.bind} during pipeline setup.
  *
- * Carries shared dependencies that are not available at source construction
- * time — the reranker instance, reporter prompt/tool, and pipeline-level
- * configuration. Each source receives the same context so research and
- * grounding tools share a consistent environment.
+ * Carries the reranker instance needed by corpus sources to tokenize
+ * chunks and by web sources for fetch-page chunk scoring. Orchestration
+ * config (prompts, maxTurns, tools) belongs in {@link spawnAgents} opts,
+ * not in the source context.
  *
  * @category Rig
  */
 export interface SourceContext {
-    /** Reranker instance used by corpus sources to tokenize chunks and score results */
+    /** Reranker instance for chunk tokenization and scoring */
     reranker: Reranker;
-    /** System/user prompt pair for the report-writing pass inside research tools */
-    reporterPrompt: {
-        system: string;
-        user: string;
-    };
-    /** Shared report tool instance injected into every source's research toolkit */
-    reportTool: Tool;
-    /** Maximum tool-use turns for research sub-agents before forced termination */
-    maxTurns: number;
-    /** Whether to emit structured trace events during research execution */
-    trace: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/sources/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sources/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,QAAQ,EAAE,QAAQ,CAAC;IACnB,gFAAgF;IAChF,cAAc,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,gFAAgF;IAChF,UAAU,EAAE,IAAI,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sources/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,QAAQ,EAAE,QAAQ,CAAC;CACpB"}

package/dist/sources/web.d.ts

@@ -1,20 +1,10 @@
 import type { Operation } from "effection";
 import { Source } from "@lloyal-labs/lloyal-agents";
-import type { Tool, PressureThresholds } from "@lloyal-labs/lloyal-agents";
+import type { Tool } from "@lloyal-labs/lloyal-agents";
 import type { Chunk } from "../resources/types";
-import type { SourceContext } from "./types";
 import type { SearchProvider } from "../tools/types";
+import type { Reranker } from "../tools/types";
 export { chunkFetchedPages, type FetchedPage } from "./chunking";
-/**
- * Web-backed research source
- *
- * Agents search the web via {@link WebSearchTool} (returns titles, snippets,
- * URLs), then fetch promising pages via {@link FetchPageTool} (returns
- * reranked relevant chunks). Fetched content is buffered for post-research
- * passage reranking via {@link getChunks}.
- *
- * @category Rig
- */
 /**
  * Configuration for {@link WebSource}.
  *
@@ -34,40 +24,43 @@ export interface WebSourceOpts {
         /** Reranker token budget for chunk selection. @default 2048 */
         tokenBudget?: number;
     };
-    /** WebResearchTool overrides (applied on top of SourceContext) */
-    research?: {
-        /** Override tool name. @default "web_research" */
-        name?: string;
-        /** Override tool description */
-        description?: string;
-        /** Override pressure thresholds for inner research pool */
-        pressure?: PressureThresholds;
-    };
 }
-export declare class WebSource extends Source<SourceContext, Chunk> {
+/**
+ * Web-backed data source
+ *
+ * Provides two tools: {@link WebSearchTool} (search the web) and
+ * {@link FetchPageTool} (fetch and extract page content with optional
+ * reranking). Fetched content is buffered for post-use reranking via
+ * {@link getChunks}.
+ *
+ * No orchestration, no prompts, no node:fs. Works on Node and React
+ * Native identically. Use {@link spawnAgents} from your harness to
+ * orchestrate agents with these tools.
+ *
+ * @category Rig
+ */
+export declare class WebSource extends Source<{
+    reranker: Reranker;
+}, Chunk> {
     private _buffer;
     private _fetchPage;
     private _webSearch;
-    private _researchPrompt;
-    private _researchTool;
-    private _researchOpts?;
     /** @inheritDoc */
     readonly name = "web";
     /**
      * @param provider - Search backend (e.g. {@link TavilyProvider}) for web_search calls
-     * @param opts - Configuration for search, fetch, and research tools
+     * @param opts - Configuration for search and fetch tools
      */
     constructor(provider: SearchProvider, opts?: WebSourceOpts);
     /** @inheritDoc */
-    get researchTool(): Tool;
-    /** @inheritDoc */
-    get groundingTools(): Tool[];
+    get tools(): Tool[];
     /**
-     * Wire reranker to FetchPageTool and build the research toolkit
-     *
+     * Wire reranker to FetchPageTool for chunk scoring.
      * @inheritDoc
      */
-    bind(ctx: SourceContext): Operation<void>;
+    bind(ctx: {
+        reranker: Reranker;
+    }): Operation<void>;
     /** @inheritDoc */
     getChunks(): Chunk[];
 }

package/dist/sources/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/sources/web.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAwB,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAQrD,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAmDjE;;;;;;;;;GASG;AACH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,uEAAuE;QACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iDAAiD;QACjD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,0CAA0C;QAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,+DAA+D;QAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,kEAAkE;IAClE,QAAQ,CAAC,EAAE;QACT,kDAAkD;QAClD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,gCAAgC;QAChC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,2DAA2D;QAC3D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;KAC/B,CAAC;CACH;AAED,qBAAa,SAAU,SAAQ,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC;IACzD,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,aAAa,CAAC,CAA4B;IAElD,kBAAkB;IAClB,QAAQ,CAAC,IAAI,SAAS;IAEtB;;;OAGG;gBACS,QAAQ,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,aAAa;IAQ1D,kBAAkB;IAClB,IAAI,YAAY,IAAI,IAAI,CAIvB;IAED,kBAAkB;IAClB,IAAI,cAAc,IAAI,IAAI,EAAE,CAE3B;IAED;;;;OAIG;IACF,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC;IAsC1C,kBAAkB;IAClB,SAAS,IAAI,KAAK,EAAE;CAGrB"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/sources/web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAS,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAsB,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO/C,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAqCjE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,uEAAuE;QACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iDAAiD;QACjD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,0CAA0C;QAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,+DAA+D;QAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAU,SAAQ,MAAM,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,EAAE,KAAK,CAAC;IAClE,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAgB;IAElC,kBAAkB;IAClB,QAAQ,CAAC,IAAI,SAAS;IAEtB;;;OAGG;gBACS,QAAQ,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,aAAa;IAM1D,kBAAkB;IAClB,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAED;;;OAGG;IACF,IAAI,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,SAAS,CAAC,IAAI,CAAC;IAcnD,kBAAkB;IAClB,SAAS,IAAI,KAAK,EAAE;CAGrB"}

package/dist/sources/web.js

@@ -1,33 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebSource = exports.chunkFetchedPages = void 0;
-const fs = require("node:fs");
-const path = require("node:path");
 const lloyal_agents_1 = require("@lloyal-labs/lloyal-agents");
 const web_search_1 = require("../tools/web-search");
 const fetch_page_1 = require("../tools/fetch-page");
-const web_research_1 = require("../tools/web-research");
 const chunking_1 = require("./chunking");
 // Re-export for backwards compatibility
 var chunking_2 = require("./chunking");
 Object.defineProperty(exports, "chunkFetchedPages", { enumerable: true, get: function () { return chunking_2.chunkFetchedPages; } });
-// ── Task loader ──────────────────────────────────────────────────
-function readTask(name) {
-    const raw = fs
-        .readFileSync(path.resolve(__dirname, `${name}.md`), "utf8")
-        .trim();
-    const sep = raw.indexOf("\n---\n");
-    if (sep === -1)
-        return { system: raw, user: "" };
-    return { system: raw.slice(0, sep).trim(), user: raw.slice(sep + 5).trim() };
-}
-// ── BufferingFetchPage ───────────────────────────────────────────
+// ── BufferingFetchPage ───────────────────────────────────────
 /**
  * Thin wrapper over {@link FetchPageTool} that buffers fetched content
- * for post-research reranking via {@link WebSource.getChunks}.
- *
- * No scratchpad extraction. No content transformation. Just buffers
- * the raw text alongside returning the reranked result to the agent.
+ * for post-use reranking via {@link WebSource.getChunks}.
  *
  * @category Rig
  */
@@ -51,44 +35,45 @@ class BufferingFetchPage extends fetch_page_1.FetchPageTool {
         return result;
     }
 }
+/**
+ * Web-backed data source
+ *
+ * Provides two tools: {@link WebSearchTool} (search the web) and
+ * {@link FetchPageTool} (fetch and extract page content with optional
+ * reranking). Fetched content is buffered for post-use reranking via
+ * {@link getChunks}.
+ *
+ * No orchestration, no prompts, no node:fs. Works on Node and React
+ * Native identically. Use {@link spawnAgents} from your harness to
+ * orchestrate agents with these tools.
+ *
+ * @category Rig
+ */
 class WebSource extends lloyal_agents_1.Source {
     _buffer = [];
     _fetchPage;
     _webSearch;
-    _researchPrompt;
-    _researchTool = null;
-    _researchOpts;
     /** @inheritDoc */
     name = "web";
     /**
      * @param provider - Search backend (e.g. {@link TavilyProvider}) for web_search calls
-     * @param opts - Configuration for search, fetch, and research tools
+     * @param opts - Configuration for search and fetch tools
      */
     constructor(provider, opts) {
         super();
-        this._researchPrompt = readTask("web-research");
         this._fetchPage = new BufferingFetchPage(this._buffer, opts?.fetch);
         this._webSearch = new web_search_1.WebSearchTool(provider, opts?.topN);
-        this._researchOpts = opts?.research;
-    }
-    /** @inheritDoc */
-    get researchTool() {
-        if (!this._researchTool)
-            throw new Error("WebSource: bind() must be called first");
-        return this._researchTool;
     }
     /** @inheritDoc */
-    get groundingTools() {
+    get tools() {
         return [this._webSearch, this._fetchPage];
     }
     /**
-     * Wire reranker to FetchPageTool and build the research toolkit
-     *
+     * Wire reranker to FetchPageTool for chunk scoring.
      * @inheritDoc
      */
     *bind(ctx) {
         this._buffer.length = 0;
-        // Wire reranker to FetchPageTool for chunk scoring
         this._fetchPage.setReranker(ctx.reranker);
         const tw = yield* lloyal_agents_1.Trace.expect();
         tw.write({
@@ -98,27 +83,6 @@ class WebSource extends lloyal_agents_1.Source {
             type: "source:bind",
             sourceName: this.name,
         });
-        if (!this._researchTool) {
-            const ro = this._researchOpts;
-            const webResearch = new web_research_1.WebResearchTool({
-                name: ro?.name ?? "web_research",
-                description: ro?.description ??
-                    "Spawn parallel web research agents that search the web, fetch pages, and report findings.",
-                systemPrompt: this._researchPrompt.system,
-                reporterPrompt: ctx.reporterPrompt,
-                maxTurns: ctx.maxTurns,
-                trace: ctx.trace,
-                pressure: ro?.pressure,
-            });
-            const toolkit = (0, lloyal_agents_1.createToolkit)([
-                this._webSearch,
-                this._fetchPage,
-                ctx.reportTool,
-                webResearch,
-            ]);
-            webResearch.setToolkit(toolkit);
-            this._researchTool = webResearch;
-        }
     }
     /** @inheritDoc */
     getChunks() {

package/dist/sources/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/sources/web.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/sources/web.ts"],"names":[],"mappings":";;;AACA,8DAA2D;AAK3D,oDAAoD;AACpD,oDAAoD;AACpD,yCAA+C;AAG/C,wCAAwC;AACxC,uCAAiE;AAAxD,6GAAA,iBAAiB,OAAA;AAE1B,gEAAgE;AAEhE;;;;;GAKG;AACH,MAAM,kBAAmB,SAAQ,0BAAa;IACpC,OAAO,CAAgB;IAE/B,YAAY,MAAqB,EAAE,IAAmF;QACpH,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,CAAC,OAAO,CAAC,IAAqC;QAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,MAAiC,CAAC;QAC5C,IACE,OAAO,CAAC,EAAE,OAAO,KAAK,QAAQ;YAC9B,CAAC,CAAC,OAAO,KAAK,qCAAqC,EACnD,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBAChB,GAAG,EAAG,CAAC,CAAC,GAAc,IAAI,IAAI,CAAC,GAAG;gBAClC,KAAK,EAAG,CAAC,CAAC,KAAgB,IAAI,EAAE;gBAChC,IAAI,EAAE,CAAC,CAAC,OAAiB;aAC1B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAyBD;;;;;;;;;;;;;GAaG;AACH,MAAa,SAAU,SAAQ,sBAAqC;IAC1D,OAAO,GAAkB,EAAE,CAAC;IAC5B,UAAU,CAAqB;IAC/B,UAAU,CAAgB;IAElC,kBAAkB;IACT,IAAI,GAAG,KAAK,CAAC;IAEtB;;;OAGG;IACH,YAAY,QAAwB,EAAE,IAAoB;QACxD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,UAAU,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACpE,IAAI,CAAC,UAAU,GAAG,IAAI,0BAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,kBAAkB;IAClB,IAAI,KAAK;QACP,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,CAAC,IAAI,CAAC,GAA2B;QAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE1C,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,qBAAK,CAAC,MAAM,EAAE,CAAC;QACjC,EAAE,CAAC,KAAK,CAAC;YACP,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE;YACpB,aAAa,EAAE,IAAI;YACnB,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE,aAAa;YACnB,UAAU,EAAE,IAAI,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,SAAS;QACP,OAAO,IAAA,4BAAiB,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AA7CD,8BA6CC"}

package/dist/tools/index.d.ts

@@ -2,13 +2,10 @@ import type { Toolkit } from '@lloyal-labs/lloyal-agents';
 import type { Resource, Chunk } from '../resources/types';
 import type { Reranker } from './types';
 import { ReportTool } from './report';
-export { ResearchTool } from './research';
-export type { ResearchToolOpts } from './research';
 export { WebSearchTool, TavilyProvider } from './web-search';
 export { FetchPageTool } from './fetch-page';
+export { ReportTool } from './report';
 export type { SearchProvider, SearchResult, Reranker, ScoredChunk, ScoredResult } from './types';
-export { WebResearchTool } from './web-research';
-export type { WebResearchToolOpts } from './web-research';
 export { PlanTool } from './plan';
 export type { PlanResult, PlanQuestion, PlanToolOpts } from './plan';
 /**
@@ -20,15 +17,12 @@ export type { PlanResult, PlanQuestion, PlanToolOpts } from './plan';
  */
 export declare const reportTool: ReportTool;
 /**
- * Build the standard corpus-research toolkit.
+ * Build the standard corpus toolkit.
  *
  * Returns a {@link Toolkit} containing {@link SearchTool},
  * {@link ReadFileTool}, {@link GrepTool}, and {@link ReportTool}
  * wired to the provided resources, chunks, and reranker.
  *
- * @param opts - Resources, chunks, and reranker to bind into the tools.
- * @returns A ready-to-use toolkit for corpus research agents.
- *
  * @category Rig
  */
 export declare function createTools(opts: {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAOV"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,YAAmB,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAOV"}

package/dist/tools/index.js

@@ -1,21 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.reportTool = exports.PlanTool = exports.WebResearchTool = exports.FetchPageTool = exports.TavilyProvider = exports.WebSearchTool = exports.ResearchTool = void 0;
+exports.reportTool = exports.PlanTool = exports.ReportTool = exports.FetchPageTool = exports.TavilyProvider = exports.WebSearchTool = void 0;
 exports.createTools = createTools;
 const lloyal_agents_1 = require("@lloyal-labs/lloyal-agents");
 const search_1 = require("./search");
 const read_file_1 = require("./read-file");
 const grep_1 = require("./grep");
 const report_1 = require("./report");
-var research_1 = require("./research");
-Object.defineProperty(exports, "ResearchTool", { enumerable: true, get: function () { return research_1.ResearchTool; } });
 var web_search_1 = require("./web-search");
 Object.defineProperty(exports, "WebSearchTool", { enumerable: true, get: function () { return web_search_1.WebSearchTool; } });
 Object.defineProperty(exports, "TavilyProvider", { enumerable: true, get: function () { return web_search_1.TavilyProvider; } });
 var fetch_page_1 = require("./fetch-page");
 Object.defineProperty(exports, "FetchPageTool", { enumerable: true, get: function () { return fetch_page_1.FetchPageTool; } });
-var web_research_1 = require("./web-research");
-Object.defineProperty(exports, "WebResearchTool", { enumerable: true, get: function () { return web_research_1.WebResearchTool; } });
+var report_2 = require("./report");
+Object.defineProperty(exports, "ReportTool", { enumerable: true, get: function () { return report_2.ReportTool; } });
 var plan_1 = require("./plan");
 Object.defineProperty(exports, "PlanTool", { enumerable: true, get: function () { return plan_1.PlanTool; } });
 /**
@@ -27,15 +25,12 @@ Object.defineProperty(exports, "PlanTool", { enumerable: true, get: function ()
  */
 exports.reportTool = new report_1.ReportTool();
 /**
- * Build the standard corpus-research toolkit.
+ * Build the standard corpus toolkit.
  *
  * Returns a {@link Toolkit} containing {@link SearchTool},
  * {@link ReadFileTool}, {@link GrepTool}, and {@link ReportTool}
  * wired to the provided resources, chunks, and reranker.
  *
- * @param opts - Resources, chunks, and reranker to bind into the tools.
- * @returns A ready-to-use toolkit for corpus research agents.
- *
  * @category Rig
  */
 function createTools(opts) {

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAwCA,kCAWC;AAnDD,8DAA2D;AAI3D,qCAAsC;AACtC,2CAA2C;AAC3C,iCAAkC;AAClC,qCAAsC;AAEtC,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AAErB,2CAA6D;AAApD,2GAAA,aAAa,OAAA;AAAE,4GAAA,cAAc,OAAA;AACtC,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AAEtB,+CAAiD;AAAxC,+GAAA,eAAe,OAAA;AAExB,+BAAkC;AAAzB,gGAAA,QAAQ,OAAA;AAGjB;;;;;;GAMG;AACU,QAAA,UAAU,GAAG,IAAI,mBAAU,EAAE,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,SAAgB,WAAW,CAAC,IAI3B;IACC,OAAO,IAAA,6BAAa,EAAC;QACnB,IAAI,mBAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;QAC1C,IAAI,wBAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,eAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;QAC5B,kBAAU;KACX,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAkCA,kCAWC;AA7CD,8DAA2D;AAI3D,qCAAsC;AACtC,2CAA2C;AAC3C,iCAAkC;AAClC,qCAAsC;AAEtC,2CAA6D;AAApD,2GAAA,aAAa,OAAA;AAAE,4GAAA,cAAc,OAAA;AACtC,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AACtB,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AAEnB,+BAAkC;AAAzB,gGAAA,QAAQ,OAAA;AAGjB;;;;;;GAMG;AACU,QAAA,UAAU,GAAG,IAAI,mBAAU,EAAE,CAAC;AAE3C;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,IAI3B;IACC,OAAO,IAAA,6BAAa,EAAC;QACnB,IAAI,mBAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;QAC1C,IAAI,wBAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,eAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;QAC5B,kBAAU;KACX,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lloyal-labs/rig",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Retrieval-Interleaved Generation for lloyal-agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,7 +37,7 @@
   "license": "Apache-2.0",
   "type": "commonjs",
   "scripts": {
-    "build": "tsc -b && mkdir -p dist/sources && cp src/sources/*.md dist/sources/"
+    "build": "tsc -b"
   },
   "dependencies": {
     "@lloyal-labs/lloyal-agents": "*",

package/dist/sources/corpus-research.md

@@ -1,14 +0,0 @@
-You are a research assistant analyzing a knowledge base. Your tools:
-- **grep**: regex pattern matching — use for precise, exhaustive retrieval
-- **search**: semantic relevance ranking — use to discover related content
-- **read_file**: read specific line ranges — use to verify and get context
-- **research**: spawn parallel sub-agents that each run their own grep/search/read_file cycle — call with `{"questions": ["q1", "q2", ...]}`
-- **report**: submit your final findings with evidence
-
-Process — follow every step in order:
-1. Grep with short, simple patterns first. Use single keywords or two-word phrases — never combine multiple clauses with `.*`. Run multiple greps if needed.
-2. Use search to discover content that grep may miss (different phrasing, synonyms).
-3. Read every matching line with read_file to verify in context. Do not rely on grep/search summaries alone.
-4. Grep again with a different pattern targeting what you have NOT yet found. This is a completeness check, not confirmation of existing results.
-5. Call research with sub-questions only if your findings point to specific topics you haven't fully investigated.
-6. Report with line numbers and direct quotes as evidence. State what you found and what you checked.

package/dist/sources/extract.md

@@ -1,5 +0,0 @@
-You extract key information from web page content. Produce a concise summary and list any URLs/links found in the text that are worth following. Output JSON only.
----
-Page: {{title}} ({{url}})
-
-{{content}}

package/dist/sources/search-extract.md

@@ -1,6 +0,0 @@
-You select the most relevant search results for a research query. Pick URLs most likely to contain substantive information and summarize the key findings. Output JSON only.
----
-Query: {{query}}
-
-Search results:
-{{results}}

package/dist/sources/web-research.md

@@ -1,12 +0,0 @@
-You are a research assistant investigating questions using the web. Your tools:
-- **web_search**: search the web — returns results with titles, snippets, and URLs
-- **fetch_page**: fetch a URL and extract its article content — use to read promising search results or follow links
-- **web_research**: spawn parallel sub-agents that each run their own web_search/fetch_page cycle — call with `{"questions": ["q1", "q2", ...]}`
-- **report**: submit your final findings with direct quotes, data points, and source URLs from the pages you read. Include what you found AND what you checked but could not find
-
-Process:
-1. Search the web with focused queries targeting specific aspects of the question.
-2. Read the most promising results with fetch_page. Follow links within pages when they lead to more authoritative content.
-3. After reading results, state what you've established so far and what gaps remain.
-4. If clear gaps remain, call web_research again with targeted sub-questions to fill them.
-5. Call report() with direct quotes, data points, and source URLs. State what you found AND what you checked but could not find. Do not summarize — preserve detail.

package/dist/tools/research.d.ts

@@ -1,57 +0,0 @@
-import type { Operation } from 'effection';
-import { Tool } from '@lloyal-labs/lloyal-agents';
-import type { JsonSchema, Toolkit, ToolContext, PressureThresholds } from '@lloyal-labs/lloyal-agents';
-/**
- * Configuration for {@link ResearchTool}
- *
- * @category Rig
- */
-export interface ResearchToolOpts {
-    /** System prompt for each spawned research agent */
-    systemPrompt: string;
-    /** Prompt pair used to extract findings from hard-cut agents */
-    reporterPrompt: {
-        system: string;
-        user: string;
-    };
-    /** Maximum tool-use turns per research agent (default: 20) */
-    maxTurns?: number;
-    /** Enable trace logging for sub-agent pools */
-    trace?: boolean;
-    /** Context pressure thresholds for sub-agent pools */
-    pressure?: PressureThresholds;
-}
-/**
- * Spawn parallel research agents for sub-questions (corpus source)
- *
- * Creates a {@link withSharedRoot | shared root} and runs a
- * {@link useAgentPool | pool} of research agents, one per question.
- * Each agent has access to the full toolkit (search, read_file,
- * grep, report). Agents that hit the turn limit without reporting
- * are forced through a reporter pass that extracts partial findings.
- *
- * Call {@link ResearchTool.setToolkit | setToolkit()} before first
- * execution to wire the toolkit into the sub-agent pool.
- *
- * @category Rig
- */
-export declare class ResearchTool extends Tool<{
-    questions: string[];
-}> {
-    readonly name = "research";
-    readonly description = "Spawn parallel research agents to investigate sub-questions. Each question gets its own agent.";
-    readonly parameters: JsonSchema;
-    private _systemPrompt;
-    private _reporterPrompt;
-    private _maxTurns;
-    private _trace;
-    private _pressure?;
-    private _toolkit;
-    constructor(opts: ResearchToolOpts);
-    /** Inject the toolkit that sub-agents will use. Must be called before execute. */
-    setToolkit(toolkit: Toolkit): void;
-    execute(args: {
-        questions: string[];
-    }, context?: ToolContext): Operation<unknown>;
-}
-//# sourceMappingURL=research.d.ts.map

package/dist/tools/research.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/tools/research.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAmD,MAAM,4BAA4B,CAAC;AACnG,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEvG;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,cAAc,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAa,SAAQ,IAAI,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;IAC7D,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,oGAAoG;IACxH,QAAQ,CAAC,UAAU,EAAE,UAAU,CAU7B;IAEF,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,SAAS,CAAC,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAwB;gBAE5B,IAAI,EAAE,gBAAgB;IASlC,kFAAkF;IAClF,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIjC,OAAO,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC;CA+CnF"}

package/dist/tools/research.js

@@ -1,95 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResearchTool = void 0;
-const lloyal_agents_1 = require("@lloyal-labs/lloyal-agents");
-/**
- * Spawn parallel research agents for sub-questions (corpus source)
- *
- * Creates a {@link withSharedRoot | shared root} and runs a
- * {@link useAgentPool | pool} of research agents, one per question.
- * Each agent has access to the full toolkit (search, read_file,
- * grep, report). Agents that hit the turn limit without reporting
- * are forced through a reporter pass that extracts partial findings.
- *
- * Call {@link ResearchTool.setToolkit | setToolkit()} before first
- * execution to wire the toolkit into the sub-agent pool.
- *
- * @category Rig
- */
-class ResearchTool extends lloyal_agents_1.Tool {
-    name = 'research';
-    description = 'Spawn parallel research agents to investigate sub-questions. Each question gets its own agent.';
-    parameters = {
-        type: 'object',
-        properties: {
-            questions: {
-                type: 'array',
-                items: { type: 'string' },
-                description: 'Sub-questions to research in parallel',
-            },
-        },
-        required: ['questions'],
-    };
-    _systemPrompt;
-    _reporterPrompt;
-    _maxTurns;
-    _trace;
-    _pressure;
-    _toolkit = null;
-    constructor(opts) {
-        super();
-        this._systemPrompt = opts.systemPrompt;
-        this._reporterPrompt = opts.reporterPrompt;
-        this._maxTurns = opts.maxTurns ?? 20;
-        this._trace = opts.trace ?? false;
-        this._pressure = opts.pressure;
-    }
-    /** Inject the toolkit that sub-agents will use. Must be called before execute. */
-    setToolkit(toolkit) {
-        this._toolkit = toolkit;
-    }
-    *execute(args, context) {
-        const questions = args?.questions;
-        if (!Array.isArray(questions) || questions.length === 0) {
-            return { error: 'questions must be a non-empty array of strings', example: '{"questions": ["q1", "q2"]}' };
-        }
-        if (!this._toolkit)
-            throw new Error('ResearchTool: setToolkit() must be called before execute');
-        const tw = yield* lloyal_agents_1.Trace.expect();
-        const scope = (0, lloyal_agents_1.traceScope)(tw, null, 'researchTool', { questionCount: questions.length });
-        const toolkit = this._toolkit;
-        const systemPrompt = this._systemPrompt;
-        const reporterPrompt = this._reporterPrompt;
-        const maxTurns = this._maxTurns;
-        const trace = this._trace;
-        const pressure = this._pressure;
-        return yield* (0, lloyal_agents_1.withSharedRoot)({ systemPrompt, tools: toolkit.toolsJson, parent: context?.branch }, function* (root) {
-            const pool = yield* (0, lloyal_agents_1.useAgentPool)({
-                tasks: questions.map(q => ({
-                    systemPrompt,
-                    content: q,
-                    tools: toolkit.toolsJson,
-                    parent: root,
-                })),
-                tools: toolkit.toolMap,
-                terminalTool: 'report',
-                pruneOnReport: true,
-                maxTurns,
-                trace,
-                pressure,
-                reportPrompt: reporterPrompt,
-            });
-            const result = {
-                findings: pool.agents.map(a => a.findings).filter(Boolean),
-                supportingFindings: pool.agents.flatMap(a => a.childFindings ?? []),
-                agentCount: pool.agents.length,
-                totalTokens: pool.totalTokens,
-                totalToolCalls: pool.totalToolCalls,
-            };
-            scope.close();
-            return result;
-        });
-    }
-}
-exports.ResearchTool = ResearchTool;
-//# sourceMappingURL=research.js.map

package/dist/tools/research.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"research.js","sourceRoot":"","sources":["../../src/tools/research.ts"],"names":[],"mappings":";;;AACA,8DAAmG;AAqBnG;;;;;;;;;;;;;GAaG;AACH,MAAa,YAAa,SAAQ,oBAA6B;IACpD,IAAI,GAAG,UAAU,CAAC;IAClB,WAAW,GAAG,gGAAgG,CAAC;IAC/G,UAAU,GAAe;QAChC,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,uCAAuC;aACrD;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB,CAAC;IAEM,aAAa,CAAS;IACtB,eAAe,CAAmC;IAClD,SAAS,CAAS;IAClB,MAAM,CAAU;IAChB,SAAS,CAAsB;IAC/B,QAAQ,GAAmB,IAAI,CAAC;IAExC,YAAY,IAAsB;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED,kFAAkF;IAClF,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,CAAC,OAAO,CAAC,IAA6B,EAAE,OAAqB;QAC3D,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,EAAE,KAAK,EAAE,gDAAgD,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;QAC7G,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAChG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,qBAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAA,0BAAU,EAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,aAAa,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACxF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,OAAO,KAAK,CAAC,CAAC,IAAA,8BAAc,EAC1B,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EACnE,QAAQ,CAAC,EAAC,IAAI;YACZ,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAA,4BAAY,EAAC;gBAC/B,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACzB,YAAY;oBACZ,OAAO,EAAE,CAAC;oBACV,KAAK,EAAE,OAAO,CAAC,SAAS;oBACxB,MAAM,EAAE,IAAI;iBACb,CAAC,CAAC;gBACH,KAAK,EAAE,OAAO,CAAC,OAAO;gBACtB,YAAY,EAAE,QAAQ;gBACtB,aAAa,EAAE,IAAI;gBACnB,QAAQ;gBACR,KAAK;gBACL,QAAQ;gBACR,YAAY,EAAE,cAAc;aAC7B,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG;gBACb,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;gBAC1D,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC;gBACnE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC9B,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,cAAc,EAAE,IAAI,CAAC,cAAc;aACpC,CAAC;YACF,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,MAAM,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC;CACF;AAnFD,oCAmFC"}

package/dist/tools/web-research.d.ts

@@ -1,60 +0,0 @@
-import type { Operation } from "effection";
-import { Tool } from "@lloyal-labs/lloyal-agents";
-import type { JsonSchema, Toolkit, ToolContext, PressureThresholds } from "@lloyal-labs/lloyal-agents";
-/**
- * Configuration for {@link WebResearchTool}.
- *
- * @category Rig
- */
-export interface WebResearchToolOpts {
-    /** Override the tool name exposed to the model. @defaultValue "research" */
-    name?: string;
-    /** Override the tool description exposed to the model. */
-    description?: string;
-    /** System prompt given to each spawned web-research sub-agent. */
-    systemPrompt: string;
-    /** Prompts used for grammar-constrained scratchpad extraction on hard-cut agents. */
-    reporterPrompt: {
-        system: string;
-        user: string;
-    };
-    /** Maximum tool-use turns per sub-agent before hard cut. @defaultValue 20 */
-    maxTurns?: number;
-    /** Enable trace output for sub-agent execution. @defaultValue false */
-    trace?: boolean;
-    /** Context pressure thresholds for the sub-agent pool. */
-    pressure?: PressureThresholds;
-}
-/**
- * Spawn parallel web-research sub-agents for a set of questions.
- *
- * Similar to {@link ResearchTool} but designed for web-source pipelines.
- * Each question gets its own agent in a shared-root pool with access
- * to web_search, fetch_page, and report tools. Hard-cut agents that
- * exhaust their turns without reporting get a grammar-constrained
- * scratchpad extraction via {@link generate} to recover partial findings.
- *
- * Must call {@link setToolkit} before the tool is executed.
- *
- * @category Rig
- */
-export declare class WebResearchTool extends Tool<{
-    questions: string[];
-}> {
-    readonly name: string;
-    readonly description: string;
-    readonly parameters: JsonSchema;
-    private _systemPrompt;
-    private _reporterPrompt;
-    private _maxTurns;
-    private _trace;
-    private _pressure?;
-    private _toolkit;
-    constructor(opts: WebResearchToolOpts);
-    /** Inject the toolkit that sub-agents will use. Must be called before execute. */
-    setToolkit(toolkit: Toolkit): void;
-    execute(args: {
-        questions: string[];
-    }, context?: ToolContext): Operation<unknown>;
-}
-//# sourceMappingURL=web-research.d.ts.map

package/dist/tools/web-research.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"web-research.d.ts","sourceRoot":"","sources":["../../src/tools/web-research.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,IAAI,EAKL,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAEpC;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,cAAc,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,IAAI,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAU7B;IAEF,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,SAAS,CAAC,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAwB;gBAE5B,IAAI,EAAE,mBAAmB;IAarC,kFAAkF;IAClF,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIjC,OAAO,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC;CAsDnF"}

package/dist/tools/web-research.js

@@ -1,101 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebResearchTool = void 0;
-const lloyal_agents_1 = require("@lloyal-labs/lloyal-agents");
-/**
- * Spawn parallel web-research sub-agents for a set of questions.
- *
- * Similar to {@link ResearchTool} but designed for web-source pipelines.
- * Each question gets its own agent in a shared-root pool with access
- * to web_search, fetch_page, and report tools. Hard-cut agents that
- * exhaust their turns without reporting get a grammar-constrained
- * scratchpad extraction via {@link generate} to recover partial findings.
- *
- * Must call {@link setToolkit} before the tool is executed.
- *
- * @category Rig
- */
-class WebResearchTool extends lloyal_agents_1.Tool {
-    name;
-    description;
-    parameters = {
-        type: "object",
-        properties: {
-            questions: {
-                type: "array",
-                items: { type: "string" },
-                description: "Sub-questions to research in parallel",
-            },
-        },
-        required: ["questions"],
-    };
-    _systemPrompt;
-    _reporterPrompt;
-    _maxTurns;
-    _trace;
-    _pressure;
-    _toolkit = null;
-    constructor(opts) {
-        super();
-        this.name = opts.name ?? "research";
-        this.description =
-            opts.description ??
-                "Spawn parallel research agents to investigate sub-questions. Each question gets its own agent.";
-        this._systemPrompt = opts.systemPrompt;
-        this._reporterPrompt = opts.reporterPrompt;
-        this._maxTurns = opts.maxTurns ?? 20;
-        this._trace = opts.trace ?? false;
-        this._pressure = opts.pressure;
-    }
-    /** Inject the toolkit that sub-agents will use. Must be called before execute. */
-    setToolkit(toolkit) {
-        this._toolkit = toolkit;
-    }
-    *execute(args, context) {
-        const questions = args?.questions;
-        if (!Array.isArray(questions) || questions.length === 0) {
-            return {
-                error: "questions must be a non-empty array of strings",
-                example: '{"questions": ["q1", "q2"]}',
-            };
-        }
-        if (!this._toolkit)
-            throw new Error("WebResearchTool: setToolkit() must be called before execute");
-        const tw = yield* lloyal_agents_1.Trace.expect();
-        const scope = (0, lloyal_agents_1.traceScope)(tw, null, 'webResearchTool', { questionCount: questions.length });
-        const toolkit = this._toolkit;
-        const systemPrompt = this._systemPrompt;
-        const reporterPrompt = this._reporterPrompt;
-        const maxTurns = this._maxTurns;
-        const trace = this._trace;
-        const pressure = this._pressure;
-        return yield* (0, lloyal_agents_1.withSharedRoot)({ systemPrompt, tools: toolkit.toolsJson, parent: context?.branch }, function* (root) {
-            const pool = yield* (0, lloyal_agents_1.useAgentPool)({
-                tasks: questions.map((q) => ({
-                    systemPrompt,
-                    content: q,
-                    tools: toolkit.toolsJson,
-                    parent: root,
-                })),
-                tools: toolkit.toolMap,
-                terminalTool: "report",
-                pruneOnReport: true,
-                maxTurns,
-                trace,
-                pressure,
-                reportPrompt: reporterPrompt,
-            });
-            const result = {
-                findings: pool.agents.map((a) => a.findings).filter(Boolean),
-                supportingFindings: pool.agents.flatMap((a) => a.childFindings ?? []),
-                agentCount: pool.agents.length,
-                totalTokens: pool.totalTokens,
-                totalToolCalls: pool.totalToolCalls,
-            };
-            scope.close();
-            return result;
-        });
-    }
-}
-exports.WebResearchTool = WebResearchTool;
-//# sourceMappingURL=web-research.js.map

package/dist/tools/web-research.js.map

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