@lloyal-labs/rig 1.2.3 → 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

@@ -2,47 +2,61 @@ import type { Operation } from "effection";
 import { Source } 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";
+import type { Reranker } from "../tools/types";
 /**
- * Corpus-backed research source using local file search, read, and grep
+ * Configuration for {@link CorpusSource}.
  *
- * 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`.
+ * @category Rig
+ */
+export interface CorpusSourceOpts {
+    /** GrepTool configuration */
+    grep?: {
+        /** Max matches returned. @default 50 */
+        maxResults?: number;
+        /** Max chars per matched line. @default 200 */
+        lineMaxChars?: number;
+    };
+    /** ReadFileTool configuration */
+    readFile?: {
+        /** Default max lines when no range specified. @default 100 */
+        defaultMaxLines?: number;
+    };
+}
+/**
+ * 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.
  *
- * The research tool is a self-referential {@link ResearchTool} that spawns
- * sub-agents with corpus-specific prompts and the full grounding toolkit.
+ * 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<SourceContext, Chunk> {
+export declare class CorpusSource extends Source<{
+    reranker: Reranker;
+}, Chunk> {
     private _chunks;
     private _tools;
-    private _researchTool;
     private _bound;
     /** @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 and read_file tools
      */
-    constructor(resources: Resource[], chunks: Chunk[]);
-    /** @inheritDoc */
-    get researchTool(): Tool;
+    constructor(resources: Resource[], chunks: Chunk[], opts?: CorpusSourceOpts);
     /** @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,MAAM,4BAA4B,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAe7C;;;;;;;;;;;;;GAaG;AACH,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;IAEvB,kBAAkB;IAClB,QAAQ,CAAC,IAAI,YAAY;IAEzB;;;OAGG;gBACS,SAAS,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IAMlD,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;CAoB3C"}
+{"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,69 +1,47 @@
 "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 research source using local file search, read, and grep
+ * Corpus-backed data 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`.
+ * 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.
  *
- * The research tool is a self-referential {@link ResearchTool} that spawns
- * sub-agents with corpus-specific prompts and the full grounding toolkit.
+ * 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;
     /** @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 and read_file tools
      */
-    constructor(resources, chunks) {
+    constructor(resources, chunks, opts) {
         super();
         this._chunks = chunks;
-        this._tools = [new read_file_1.ReadFileTool(resources), new grep_1.GrepTool(resources)];
-    }
-    /** @inheritDoc */
-    get researchTool() {
-        if (!this._researchTool)
-            throw new Error("CorpusSource: bind() must be called first");
-        return this._researchTool;
+        this._tools = [
+            new read_file_1.ReadFileTool(resources, opts?.readFile),
+            new grep_1.GrepTool(resources, opts?.grep),
+        ];
     }
     /** @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) {
@@ -74,16 +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,
-        });
-        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,10 +1,12 @@
 /**
- * Source implementations for the research pipeline
+ * Source implementations — data backends for agent pipelines
  *
  * @packageDocumentation
  * @category Rig
  */
 export { WebSource } from './web';
+export type { WebSourceOpts } from './web';
 export { CorpusSource } from './corpus';
+export type { CorpusSourceOpts } from './corpus';
 export type { SourceContext } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

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/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,6BAAkC;AAAzB,gGAAA,SAAS,OAAA;AAClB,mCAAwC;AAA/B,sGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,6BAAkC;AAAzB,gGAAA,SAAS,OAAA;AAElB,mCAAwC;AAA/B,sGAAA,YAAY,OAAA"}

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

@@ -2,41 +2,65 @@ import type { Operation } from "effection";
 import { Source } 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
+ * Configuration for {@link WebSource}.
  *
- * 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
+ */
+export interface WebSourceOpts {
+    /** Max search results returned to agents. @default 8 */
+    topN?: number;
+    /** FetchPageTool configuration */
+    fetch?: {
+        /** Max chars for full-content fallback (no reranker). @default 6000 */
+        maxChars?: number;
+        /** Top-K reranked chunks returned. @default 5 */
+        topK?: number;
+        /** Fetch timeout in ms. @default 10000 */
+        timeout?: number;
+        /** Reranker token budget for chunk selection. @default 2048 */
+        tokenBudget?: number;
+    };
+}
+/**
+ * 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<SourceContext, Chunk> {
+export declare class WebSource extends Source<{
+    reranker: Reranker;
+}, Chunk> {
     private _buffer;
     private _fetchPage;
     private _webSearch;
-    private _researchPrompt;
-    private _researchTool;
     /** @inheritDoc */
     readonly name = "web";
     /**
      * @param provider - Search backend (e.g. {@link TavilyProvider}) for web_search calls
+     * @param opts - Configuration for search and fetch tools
      */
-    constructor(provider: SearchProvider);
-    /** @inheritDoc */
-    get researchTool(): Tool;
+    constructor(provider: SearchProvider, opts?: WebSourceOpts);
     /** @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,MAAM,4BAA4B,CAAC;AACvD,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,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;IAErD,kBAAkB;IAClB,QAAQ,CAAC,IAAI,SAAS;IAEtB;;OAEG;gBACS,QAAQ,EAAE,cAAc;IAOpC,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;IAoC1C,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"}