@lloyal-labs/rig 1.2.3 → 1.4.0

package/dist/tools/report.js

@@ -14,12 +14,24 @@ const lloyal_agents_1 = require("@lloyal-labs/lloyal-agents");
  */
 class ReportTool extends lloyal_agents_1.Tool {
     name = 'report';
-    description = 'Submit your final research findings. Call this when you have gathered enough information to answer the question.';
-    parameters = {
-        type: 'object',
-        properties: { findings: { type: 'string', description: 'Your research findings and answer' } },
-        required: ['findings'],
-    };
+    description;
+    parameters;
+    constructor(opts) {
+        super();
+        this.description = opts?.description ??
+            'Submit your final research findings with specific evidence, direct quotes, data points, and source URLs from the pages you read. State what you found AND what you checked but could not find. Do not summarize — preserve detail.';
+        this.parameters = {
+            type: 'object',
+            properties: {
+                findings: {
+                    type: 'string',
+                    description: opts?.findingsDescription ??
+                        'Detailed findings with direct quotes, data points, and source URLs. Include what was found and what was not found.',
+                },
+            },
+            required: ['findings'],
+        };
+    }
     *execute() { return {}; }
 }
 exports.ReportTool = ReportTool;

package/dist/tools/report.js.map

@@ -1 +1 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/tools/report.ts"],"names":[],"mappings":";;;AACA,8DAAkD;AAGlD;;;;;;;;;GASG;AACH,MAAa,UAAW,SAAQ,oBAA0B;IAC/C,IAAI,GAAG,QAAQ,CAAC;IAChB,WAAW,GAAG,kHAAkH,CAAC;IACjI,UAAU,GAAe;QAChC,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE,EAAE;QAC9F,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB,CAAC;IAEF,CAAC,OAAO,KAAyB,OAAO,EAAE,CAAC,CAAC,CAAC;CAC9C;AAVD,gCAUC"}
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/tools/report.ts"],"names":[],"mappings":";;;AACA,8DAAkD;AAGlD;;;;;;;;;GASG;AACH,MAAa,UAAW,SAAQ,oBAA0B;IAC/C,IAAI,GAAG,QAAQ,CAAC;IAChB,WAAW,CAAS;IACpB,UAAU,CAAa;IAEhC,YAAY,IAKX;QACC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,WAAW;YAClC,oOAAoO,CAAC;QACvO,IAAI,CAAC,UAAU,GAAG;YAChB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,IAAI,EAAE,mBAAmB;wBACpC,oHAAoH;iBACvH;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB,CAAC;IACJ,CAAC;IAED,CAAC,OAAO,KAAyB,OAAO,EAAE,CAAC,CAAC,CAAC;CAC9C;AA5BD,gCA4BC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lloyal-labs/rig",
-  "version": "1.2.3",
+  "version": "1.4.0",
   "description": "Retrieval-Interleaved Generation for lloyal-agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -37,14 +37,14 @@
   "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/sdk": "*",
     "@lloyal-labs/lloyal-agents": "*",
+    "@lloyal-labs/sdk": "*",
+    "@mozilla/readability": "^0.6.0",
     "effection": "^4.0.2",
-    "linkedom": "^0.18.12",
-    "@mozilla/readability": "^0.6.0"
+    "linkedom": "^0.18.12"
   },
   "peerDependencies": {
     "@lloyal-labs/lloyal.node": "^2.0.2"

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 evidence and source URLs
-
-Process — follow every step in order:
-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. Search again with refined queries based on what you learned. Target gaps in your findings.
-4. Call web_research with sub-questions if you judge there are areas that need deeper investigation.
-5. Report with source URLs and direct quotes as evidence. State what you found and what you checked.

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, 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[];
-    }): 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,EAA8D,MAAM,4BAA4B,CAAC;AAC9G,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAE1F;;;;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,GAAG,SAAS,CAAC,OAAO,CAAC;CAoE5D"}

package/dist/tools/research.js

@@ -1,117 +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) {
-        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 }, 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',
-                maxTurns,
-                trace,
-                pressure,
-            });
-            // Force hard-cut agents to report — same pattern as prior harness reportPass
-            const hardCut = pool.agents.filter(a => !a.findings && !a.branch.disposed);
-            if (hardCut.length > 0) {
-                for (const a of pool.agents) {
-                    if (a.findings && !a.branch.disposed)
-                        a.branch.pruneSync();
-                }
-                const reportTool = toolkit.toolMap.get('report');
-                const reporters = yield* (0, lloyal_agents_1.runAgents)({
-                    tasks: hardCut.map(a => ({
-                        systemPrompt: reporterPrompt.system,
-                        content: reporterPrompt.user,
-                        tools: JSON.stringify([reportTool.schema]),
-                        parent: a.branch,
-                    })),
-                    tools: new Map([['report', reportTool]]),
-                    terminalTool: 'report',
-                    trace,
-                    pressure: { softLimit: 200, hardLimit: 64 },
-                });
-                hardCut.forEach((a, i) => {
-                    if (reporters.agents[i]?.findings)
-                        a.findings = reporters.agents[i].findings;
-                });
-            }
-            const result = {
-                findings: pool.agents.map(a => a.findings).filter(Boolean),
-                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":"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"}

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, 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[];
-    }): 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":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACL,IAAI,EAOL,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,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,GAAG,SAAS,CAAC,OAAO,CAAC;CA2F5D"}

package/dist/tools/web-research.js

@@ -1,136 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebResearchTool = void 0;
-const effection_1 = require("effection");
-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) {
-        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 }, 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",
-                maxTurns,
-                trace,
-                pressure,
-            });
-            // Scratchpad extraction for hard-cut agents — works under pressure
-            const hardCut = pool.agents.filter((a) => !a.findings && !a.branch.disposed);
-            if (hardCut.length > 0) {
-                for (const a of pool.agents) {
-                    if (a.findings && !a.branch.disposed)
-                        a.branch.pruneSync();
-                }
-                const ctx = yield* lloyal_agents_1.Ctx.expect();
-                const schema = {
-                    type: "object",
-                    properties: { findings: { type: "string" } },
-                    required: ["findings"],
-                };
-                const grammar = yield* (0, effection_1.call)(() => ctx.jsonSchemaToGrammar(JSON.stringify(schema)));
-                const msgs = [
-                    { role: "system", content: reporterPrompt.system },
-                    { role: "user", content: reporterPrompt.user },
-                ];
-                const { prompt } = ctx.formatChatSync(JSON.stringify(msgs), { enableThinking: false });
-                for (const a of hardCut) {
-                    try {
-                        const result = yield* (0, lloyal_agents_1.generate)({
-                            prompt,
-                            grammar,
-                            parse: (o) => JSON.parse(o),
-                            parent: a.branch,
-                        });
-                        if (result.parsed?.findings)
-                            a.findings = result.parsed.findings;
-                    }
-                    catch {
-                        /* extraction failure non-fatal */
-                    }
-                    if (!a.branch.disposed)
-                        a.branch.pruneSync();
-                }
-            }
-            const result = {
-                findings: pool.agents.map((a) => a.findings).filter(Boolean),
-                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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"}