@moxxy/mode-deep-research 0.26.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/approval.d.ts

@@ -0,0 +1,32 @@
+import type { ModeContext } from '@moxxy/sdk';
+export type QueryGateOutcome = {
+    kind: 'approve';
+} | {
+    kind: 'redraft';
+    feedback: string | null;
+} | {
+    kind: 'cancel';
+} | {
+    kind: 'redraft-cap-exceeded';
+};
+/**
+ * Optional approval gate after the query plan is produced. Headless
+ * contexts (no resolver) auto-approve. Approve / redraft-with-feedback /
+ * cancel option ids, with bounded redraft retries.
+ */
+export declare function runQueryApprovalGate(ctx: ModeContext, planText: string, queryCount: number, redraftCount: number): Promise<{
+    outcome: QueryGateOutcome;
+    redraftCount: number;
+}>;
+export type SynthesisGateOutcome = {
+    kind: 'synthesize';
+} | {
+    kind: 'cancel';
+};
+/**
+ * Approval gate shown after fan-out, before the synthesis turn. Body is
+ * a short digest of each subagent's result so the user can sanity-check
+ * coverage before paying for synthesis tokens.
+ */
+export declare function runSynthesisApprovalGate(ctx: ModeContext, digest: string): Promise<SynthesisGateOutcome>;
+//# sourceMappingURL=approval.d.ts.map

package/dist/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../src/approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAErC;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CA4C9D;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CA0B/B"}

package/dist/approval.js

@@ -0,0 +1,84 @@
+import { MAX_REDRAFTS } from './constants.js';
+/**
+ * Optional approval gate after the query plan is produced. Headless
+ * contexts (no resolver) auto-approve. Approve / redraft-with-feedback /
+ * cancel option ids, with bounded redraft retries.
+ */
+export async function runQueryApprovalGate(ctx, planText, queryCount, redraftCount) {
+    if (!ctx.approval)
+        return { outcome: { kind: 'approve' }, redraftCount };
+    const decision = await ctx.approval.confirm({
+        title: 'Query plan ready — review before fan-out',
+        body: planText,
+        kind: 'deep-research.queries',
+        defaultOptionId: 'approve',
+        options: [
+            {
+                id: 'approve',
+                label: 'Approve and fan out',
+                hotkey: 'a',
+                description: `Spawn ${queryCount} parallel subagent${queryCount === 1 ? '' : 's'} to research these.`,
+            },
+            {
+                id: 'redraft',
+                label: 'Redraft with feedback',
+                hotkey: 'r',
+                requestsText: true,
+                textPrompt: 'What should change about the query plan?',
+                description: 'Send feedback to the planner and get a new query plan.',
+            },
+            {
+                id: 'cancel',
+                label: 'Cancel this turn',
+                hotkey: 'c',
+                danger: true,
+            },
+        ],
+    });
+    if (decision.optionId === 'cancel')
+        return { outcome: { kind: 'cancel' }, redraftCount };
+    if (decision.optionId === 'redraft') {
+        const nextCount = redraftCount + 1;
+        if (nextCount > MAX_REDRAFTS) {
+            return { outcome: { kind: 'redraft-cap-exceeded' }, redraftCount: nextCount };
+        }
+        return {
+            outcome: { kind: 'redraft', feedback: decision.text ?? null },
+            redraftCount: nextCount,
+        };
+    }
+    return { outcome: { kind: 'approve' }, redraftCount };
+}
+/**
+ * Approval gate shown after fan-out, before the synthesis turn. Body is
+ * a short digest of each subagent's result so the user can sanity-check
+ * coverage before paying for synthesis tokens.
+ */
+export async function runSynthesisApprovalGate(ctx, digest) {
+    if (!ctx.approval)
+        return { kind: 'synthesize' };
+    const decision = await ctx.approval.confirm({
+        title: 'Fan-out complete — synthesize the final writeup?',
+        body: digest,
+        kind: 'deep-research.synthesis',
+        defaultOptionId: 'synthesize',
+        options: [
+            {
+                id: 'synthesize',
+                label: 'Synthesize',
+                hotkey: 's',
+                description: 'Combine the findings into the final writeup.',
+            },
+            {
+                id: 'cancel',
+                label: 'Cancel this turn',
+                hotkey: 'c',
+                danger: true,
+            },
+        ],
+    });
+    if (decision.optionId === 'cancel')
+        return { kind: 'cancel' };
+    return { kind: 'synthesize' };
+}
+//# sourceMappingURL=approval.js.map

package/dist/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../src/approval.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQ9C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAgB,EAChB,QAAgB,EAChB,UAAkB,EAClB,YAAoB;IAEpB,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,CAAC;IAEzE,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC1C,KAAK,EAAE,0CAA0C;QACjD,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,uBAAuB;QAC7B,eAAe,EAAE,SAAS;QAC1B,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,SAAS;gBACb,KAAK,EAAE,qBAAqB;gBAC5B,MAAM,EAAE,GAAG;gBACX,WAAW,EAAE,SAAS,UAAU,qBAAqB,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,qBAAqB;aACtG;YACD;gBACE,EAAE,EAAE,SAAS;gBACb,KAAK,EAAE,uBAAuB;gBAC9B,MAAM,EAAE,GAAG;gBACX,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,0CAA0C;gBACtD,WAAW,EAAE,wDAAwD;aACtE;YACD;gBACE,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,kBAAkB;gBACzB,MAAM,EAAE,GAAG;gBACX,MAAM,EAAE,IAAI;aACb;SACF;KACF,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,CAAC;IACzF,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,YAAY,GAAG,CAAC,CAAC;QACnC,IAAI,SAAS,GAAG,YAAY,EAAE,CAAC;YAC7B,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;QAChF,CAAC;QACD,OAAO;YACL,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,IAAI,IAAI,EAAE;YAC7D,YAAY,EAAE,SAAS;SACxB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,CAAC;AACxD,CAAC;AAMD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAgB,EAChB,MAAc;IAEd,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAEjD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC1C,KAAK,EAAE,kDAAkD;QACzD,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,yBAAyB;QAC/B,eAAe,EAAE,YAAY;QAC7B,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,YAAY;gBAChB,KAAK,EAAE,YAAY;gBACnB,MAAM,EAAE,GAAG;gBACX,WAAW,EAAE,8CAA8C;aAC5D;YACD;gBACE,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,kBAAkB;gBACzB,MAAM,EAAE,GAAG;gBACX,MAAM,EAAE,IAAI;aACb;SACF;KACF,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9D,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AAChC,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,62 @@
+export declare const RESEARCH_MODE_NAME = "research";
+export declare const DEEP_RESEARCH_PLUGIN_ID: import("@moxxy/sdk").PluginId;
+/**
+ * Asked once in the planning phase. The subagents fan out IN PARALLEL —
+ * which means a query can never depend on another query's output. If we
+ * let the planner emit "compare side A and side B" or "what are the
+ * disputed claims" as separate queries, the subagent running them has
+ * no idea what was actually gathered and either invents content or
+ * gives up (e.g. "I can't determine what 'the disputed claims' refers
+ * to from the prompt alone"). The synthesis phase already sees every
+ * subagent's findings end-to-end and is where comparison + contradiction
+ * analysis belongs — the planner's job is purely to spread the raw
+ * gathering work across independent angles.
+ */
+export declare const QUERY_PLAN_SYSTEM_PROMPT = "You are scoping a deep-research task. Produce 2-5 PARALLEL GATHERING queries \u2014 one per independent angle of raw evidence the synthesis phase will need.\n\nHARD RULES (the loop refuses plans that break these):\n- Each query MUST be independently answerable from web search + page reads ALONE \u2014 without seeing any other query's output. The subagents run in parallel and never see each other's findings.\n- DO NOT emit comparison, contradiction, \"differences\", \"disputed claims\", \"which side is right\", \"balanced timeline\", \"verify side X's claims\", or other queries that require knowing what OTHER queries returned. Those are the synthesis phase's job, not gathering.\n- DO NOT pad. If the user's question only needs 2 angles (e.g. \"compare X side vs Y side\"), emit exactly 2 queries \u2014 one per side. The synthesis turn does the comparison.\n- Each query should be concrete and scoped (\"What did <party> say about <topic> in the last 30 days?\"), not an open theme (\"Background on X\").\n- No two queries should be rephrasings of each other.\n\nReply with EXACTLY this format and nothing else:\n\nQUERIES:\n1. <gathering query>\n2. <gathering query>\n...\n\nStop after the last numbered line.";
+/**
+ * System prompt for each fan-out subagent. They run in standard tool-use
+ * mode, but constrained (by allowedTools) to read-only web tools. The
+ * SOURCES: block is what the synthesis phase pulls citations from.
+ */
+export declare const SUBAGENT_SYSTEM_PROMPT = "You are a focused research subagent. You have ONE sub-question to answer. Use web_search and web_fetch (and Read for any local files referenced) to gather evidence, then produce a concise writeup.\n\nStop tool-calling when you have enough material to answer. Reply with:\n\nFINDINGS:\n<2-4 short paragraphs answering the sub-question, citing sources inline like [1], [2] where claims come from a specific source>\n\nSOURCES:\n[1] <title> \u2014 <url>\n[2] <title> \u2014 <url>\n...\n\nDo NOT edit files. Do NOT run git. Stop after the last source line.";
+/**
+ * Asked between fan-out rounds. Given the findings from the prior
+ * round(s), the model decides whether MORE parallel gathering is
+ * needed to fill specific gaps before synthesis — and if so, what.
+ * This is the "agentic" half of the loop that the user explicitly
+ * asked for: round-1 gathers Iran-side + USA-side, round-2 spawns
+ * follow-ups armed with both, instead of asking blind round-1
+ * subagents to compare things they can't see.
+ */
+export declare const FOLLOWUP_PLAN_SYSTEM_PROMPT = "You have the findings of the previous research round(s). Decide whether you need MORE parallel gathering to fill specific gaps the synthesis phase can't resolve on its own.\n\nYou will receive:\n- The original user question.\n- Each prior subagent's question + FINDINGS + SOURCES block.\n\nDecision rules:\n- ONLY emit follow-ups when there is a CONCRETE gap that needs more raw evidence \u2014 a contradiction begging for a third source, a claim that needs primary-document verification, a missing data point that one round can't synthesize around.\n- The follow-up subagents WILL be given the prior findings as context in their prompt, so phrasing like \"verify the casualty figure of X reported by Iranian state media against independent sources\" is fine.\n- DO NOT emit follow-ups that just rephrase prior queries or chase tangents.\n- Each follow-up still runs in parallel with the others in this round, so follow-ups must be independent of EACH OTHER (just like round-1 queries).\n- If the prior findings are sufficient for a good synthesis, emit none and stop. The synthesis turn handles cross-cutting comparison without help.\n\nReply with EXACTLY one of these formats and nothing else:\n\nFOLLOWUPS:\n1. <follow-up gathering query>\n2. <follow-up gathering query>\n...\n\nor\n\nFOLLOWUPS: (none)\n\nStop after the last line.";
+/**
+ * Synthesis turn: consume the per-subagent findings + sources and
+ * produce a single structured writeup with renumbered citations.
+ */
+export declare const SYNTHESIS_SYSTEM_PROMPT = "You are synthesizing a deep-research report from the findings of multiple subagents \u2014 possibly across multiple research rounds (an initial gathering round plus optional follow-up rounds that drilled into specific gaps the initial round surfaced).\n\nYou will receive the original question, each subagent's question + round number + FINDINGS + SOURCES block. Produce the final writeup with these sections, in this order:\n\n## Executive summary\n<3-5 bullet points; the key takeaways.>\n\n## Key findings\n<numbered paragraphs covering each substantive finding, citing sources inline as [n] referring to the unified Sources list below. Call out contradictions explicitly. Mark gaps as \"Not covered: \u2026\". When findings from a follow-up round resolve or amplify a contradiction the initial round surfaced, say so.>\n\n## Sources\n[1] <title> \u2014 <url>\n[2] <title> \u2014 <url>\n...\n(Renumber so the unified list is contiguous; each source appears once even if cited by multiple subagents.)\n\n## Open questions\n<bullets describing what remains unresolved, or \"None \u2014 the gathered evidence is sufficient.\">\n\nBe tight. Do not narrate your process.";
+/** Refuse plans larger than this in the initial round — guards against runaway fan-out cost. */
+export declare const MAX_SUBAGENTS = 6;
+/** Maximum follow-up rounds after the initial gathering. */
+export declare const MAX_FOLLOWUP_ROUNDS = 2;
+/** Maximum follow-up queries per round. */
+export declare const MAX_FOLLOWUPS_PER_ROUND = 4;
+export declare const MAX_REDRAFTS = 3;
+export declare const SUBAGENT_MAX_ITERATIONS = 40;
+/**
+ * Per-finding character cap when a prior round's findings are embedded as
+ * context into EACH follow-up subagent's prompt. The same blob is duplicated
+ * across every sibling subagent and re-sent every round, so an uncapped
+ * multi-KB finding grows the embedded context multiplicatively. The full
+ * untruncated text is still used for the single synthesis turn.
+ */
+export declare const SUBAGENT_PRIOR_FINDING_MAX_CHARS = 1500;
+/**
+ * Tools each subagent is allowed to call. Constrained to read-only web +
+ * filesystem reads — no edits, no shell, no git, so a runaway subagent
+ * can't damage the working tree. WebSearch / WebFetch may be exposed
+ * under different names depending on plugin configuration; the registry
+ * silently ignores unknown names, so listing both common spellings is
+ * harmless.
+ */
+export declare const SUBAGENT_ALLOWED_TOOLS: readonly ["WebSearch", "WebFetch", "web_search", "web_fetch", "Read", "read"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C,eAAO,MAAM,uBAAuB,+BAA0C,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,usCAgBF,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,6iBAYiC,CAAC;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,2zCAwBd,CAAC;AAE3B;;;GAGG;AACH,eAAO,MAAM,uBAAuB,qpCAmBG,CAAC;AAExC,gGAAgG;AAChG,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,+EAOzB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,141 @@
+import { asPluginId } from '@moxxy/sdk';
+export const RESEARCH_MODE_NAME = 'research';
+export const DEEP_RESEARCH_PLUGIN_ID = asPluginId('@moxxy/mode-deep-research');
+/**
+ * Asked once in the planning phase. The subagents fan out IN PARALLEL —
+ * which means a query can never depend on another query's output. If we
+ * let the planner emit "compare side A and side B" or "what are the
+ * disputed claims" as separate queries, the subagent running them has
+ * no idea what was actually gathered and either invents content or
+ * gives up (e.g. "I can't determine what 'the disputed claims' refers
+ * to from the prompt alone"). The synthesis phase already sees every
+ * subagent's findings end-to-end and is where comparison + contradiction
+ * analysis belongs — the planner's job is purely to spread the raw
+ * gathering work across independent angles.
+ */
+export const QUERY_PLAN_SYSTEM_PROMPT = `You are scoping a deep-research task. Produce 2-5 PARALLEL GATHERING queries — one per independent angle of raw evidence the synthesis phase will need.
+
+HARD RULES (the loop refuses plans that break these):
+- Each query MUST be independently answerable from web search + page reads ALONE — without seeing any other query's output. The subagents run in parallel and never see each other's findings.
+- DO NOT emit comparison, contradiction, "differences", "disputed claims", "which side is right", "balanced timeline", "verify side X's claims", or other queries that require knowing what OTHER queries returned. Those are the synthesis phase's job, not gathering.
+- DO NOT pad. If the user's question only needs 2 angles (e.g. "compare X side vs Y side"), emit exactly 2 queries — one per side. The synthesis turn does the comparison.
+- Each query should be concrete and scoped ("What did <party> say about <topic> in the last 30 days?"), not an open theme ("Background on X").
+- No two queries should be rephrasings of each other.
+
+Reply with EXACTLY this format and nothing else:
+
+QUERIES:
+1. <gathering query>
+2. <gathering query>
+...
+
+Stop after the last numbered line.`;
+/**
+ * System prompt for each fan-out subagent. They run in standard tool-use
+ * mode, but constrained (by allowedTools) to read-only web tools. The
+ * SOURCES: block is what the synthesis phase pulls citations from.
+ */
+export const SUBAGENT_SYSTEM_PROMPT = `You are a focused research subagent. You have ONE sub-question to answer. Use web_search and web_fetch (and Read for any local files referenced) to gather evidence, then produce a concise writeup.
+
+Stop tool-calling when you have enough material to answer. Reply with:
+
+FINDINGS:
+<2-4 short paragraphs answering the sub-question, citing sources inline like [1], [2] where claims come from a specific source>
+
+SOURCES:
+[1] <title> — <url>
+[2] <title> — <url>
+...
+
+Do NOT edit files. Do NOT run git. Stop after the last source line.`;
+/**
+ * Asked between fan-out rounds. Given the findings from the prior
+ * round(s), the model decides whether MORE parallel gathering is
+ * needed to fill specific gaps before synthesis — and if so, what.
+ * This is the "agentic" half of the loop that the user explicitly
+ * asked for: round-1 gathers Iran-side + USA-side, round-2 spawns
+ * follow-ups armed with both, instead of asking blind round-1
+ * subagents to compare things they can't see.
+ */
+export const FOLLOWUP_PLAN_SYSTEM_PROMPT = `You have the findings of the previous research round(s). Decide whether you need MORE parallel gathering to fill specific gaps the synthesis phase can't resolve on its own.
+
+You will receive:
+- The original user question.
+- Each prior subagent's question + FINDINGS + SOURCES block.
+
+Decision rules:
+- ONLY emit follow-ups when there is a CONCRETE gap that needs more raw evidence — a contradiction begging for a third source, a claim that needs primary-document verification, a missing data point that one round can't synthesize around.
+- The follow-up subagents WILL be given the prior findings as context in their prompt, so phrasing like "verify the casualty figure of X reported by Iranian state media against independent sources" is fine.
+- DO NOT emit follow-ups that just rephrase prior queries or chase tangents.
+- Each follow-up still runs in parallel with the others in this round, so follow-ups must be independent of EACH OTHER (just like round-1 queries).
+- If the prior findings are sufficient for a good synthesis, emit none and stop. The synthesis turn handles cross-cutting comparison without help.
+
+Reply with EXACTLY one of these formats and nothing else:
+
+FOLLOWUPS:
+1. <follow-up gathering query>
+2. <follow-up gathering query>
+...
+
+or
+
+FOLLOWUPS: (none)
+
+Stop after the last line.`;
+/**
+ * Synthesis turn: consume the per-subagent findings + sources and
+ * produce a single structured writeup with renumbered citations.
+ */
+export const SYNTHESIS_SYSTEM_PROMPT = `You are synthesizing a deep-research report from the findings of multiple subagents — possibly across multiple research rounds (an initial gathering round plus optional follow-up rounds that drilled into specific gaps the initial round surfaced).
+
+You will receive the original question, each subagent's question + round number + FINDINGS + SOURCES block. Produce the final writeup with these sections, in this order:
+
+## Executive summary
+<3-5 bullet points; the key takeaways.>
+
+## Key findings
+<numbered paragraphs covering each substantive finding, citing sources inline as [n] referring to the unified Sources list below. Call out contradictions explicitly. Mark gaps as "Not covered: …". When findings from a follow-up round resolve or amplify a contradiction the initial round surfaced, say so.>
+
+## Sources
+[1] <title> — <url>
+[2] <title> — <url>
+...
+(Renumber so the unified list is contiguous; each source appears once even if cited by multiple subagents.)
+
+## Open questions
+<bullets describing what remains unresolved, or "None — the gathered evidence is sufficient.">
+
+Be tight. Do not narrate your process.`;
+/** Refuse plans larger than this in the initial round — guards against runaway fan-out cost. */
+export const MAX_SUBAGENTS = 6;
+/** Maximum follow-up rounds after the initial gathering. */
+export const MAX_FOLLOWUP_ROUNDS = 2;
+/** Maximum follow-up queries per round. */
+export const MAX_FOLLOWUPS_PER_ROUND = 4;
+export const MAX_REDRAFTS = 3;
+export const SUBAGENT_MAX_ITERATIONS = 40;
+/**
+ * Per-finding character cap when a prior round's findings are embedded as
+ * context into EACH follow-up subagent's prompt. The same blob is duplicated
+ * across every sibling subagent and re-sent every round, so an uncapped
+ * multi-KB finding grows the embedded context multiplicatively. The full
+ * untruncated text is still used for the single synthesis turn.
+ */
+export const SUBAGENT_PRIOR_FINDING_MAX_CHARS = 1500;
+/**
+ * Tools each subagent is allowed to call. Constrained to read-only web +
+ * filesystem reads — no edits, no shell, no git, so a runaway subagent
+ * can't damage the working tree. WebSearch / WebFetch may be exposed
+ * under different names depending on plugin configuration; the registry
+ * silently ignores unknown names, so listing both common spellings is
+ * harmless.
+ */
+export const SUBAGENT_ALLOWED_TOOLS = [
+    'WebSearch',
+    'WebFetch',
+    'web_search',
+    'web_fetch',
+    'Read',
+    'read',
+];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAE7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC,2BAA2B,CAAC,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;mCAgBL,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;oEAY8B,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;0BAwBjB,CAAC;AAE3B;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;uCAmBA,CAAC;AAExC,gGAAgG;AAChG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW;IACX,UAAU;IACV,YAAY;IACZ,WAAW;IACX,MAAM;IACN,MAAM;CACE,CAAC"}

package/dist/fanout-phase.d.ts

@@ -0,0 +1,44 @@
+import type { ModeContext, SubagentResult } from '@moxxy/sdk';
+export interface FanoutOutcome {
+    readonly results: ReadonlyArray<SubagentResult>;
+    readonly errored: ReadonlyArray<{
+        readonly index: number;
+        readonly message: string;
+    }>;
+}
+/**
+ * Findings accumulated across rounds — each entry is one subagent's
+ * outcome plus the round it ran in. Synthesis and follow-up planning
+ * both work off this flat list.
+ */
+export interface RoundFinding {
+    readonly round: number;
+    readonly question: string;
+    readonly text: string;
+    readonly error?: string;
+}
+export declare function flattenOutcome(round: number, queries: ReadonlyArray<string>, outcome: FanoutOutcome): RoundFinding[];
+/**
+ * Spawn one subagent per query in parallel, each constrained to web /
+ * read-only tools. When `priorFindings` is non-empty, the prior
+ * findings are embedded in each subagent's user prompt so follow-up
+ * agents see what earlier rounds already gathered (which is the whole
+ * point of multi-round research — round-2 follow-ups should not be
+ * blind to round-1's findings).
+ *
+ * Caller MUST have verified ctx.subagents is present.
+ */
+export declare function runFanout(ctx: ModeContext, queries: ReadonlyArray<string>, priorFindings?: ReadonlyArray<RoundFinding>): Promise<FanoutOutcome>;
+/**
+ * Build a one-screen digest of subagent outcomes for the synthesis gate.
+ * Each entry shows the sub-question and a 200-char headline of the
+ * findings, plus a clear marker for any subagent that errored.
+ */
+export declare function buildFanoutDigest(findings: ReadonlyArray<RoundFinding>): string;
+/**
+ * Build the synthesis turn's user message: weaves the original question
+ * back together with each subagent's writeup so the synthesizer has the
+ * raw material to cite and combine.
+ */
+export declare function buildSynthesisInput(originalPrompt: string, findings: ReadonlyArray<RoundFinding>): string;
+//# sourceMappingURL=fanout-phase.d.ts.map

package/dist/fanout-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout-phase.d.ts","sourceRoot":"","sources":["../src/fanout-phase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAC;AAS5E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvF;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAC9B,OAAO,EAAE,aAAa,GACrB,YAAY,EAAE,CAWhB;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAC9B,aAAa,GAAE,aAAa,CAAC,YAAY,CAAM,GAC9C,OAAO,CAAC,aAAa,CAAC,CAoCxB;AAqCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,MAAM,CAgB/E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,GACpC,MAAM,CAeR"}

package/dist/fanout-phase.js

@@ -0,0 +1,133 @@
+import { SUBAGENT_ALLOWED_TOOLS, SUBAGENT_MAX_ITERATIONS, SUBAGENT_PRIOR_FINDING_MAX_CHARS, SUBAGENT_SYSTEM_PROMPT, } from './constants.js';
+export function flattenOutcome(round, queries, outcome) {
+    return queries.map((question, i) => {
+        const r = outcome.results[i];
+        const err = outcome.errored.find((e) => e.index === i);
+        return {
+            round,
+            question,
+            text: (r?.text ?? '').trim(),
+            ...(err ? { error: err.message } : {}),
+        };
+    });
+}
+/**
+ * Spawn one subagent per query in parallel, each constrained to web /
+ * read-only tools. When `priorFindings` is non-empty, the prior
+ * findings are embedded in each subagent's user prompt so follow-up
+ * agents see what earlier rounds already gathered (which is the whole
+ * point of multi-round research — round-2 follow-ups should not be
+ * blind to round-1's findings).
+ *
+ * Caller MUST have verified ctx.subagents is present.
+ */
+export async function runFanout(ctx, queries, priorFindings = []) {
+    if (!ctx.subagents) {
+        throw new Error('deep-research: runFanout called without ctx.subagents — caller bug');
+    }
+    const specs = queries.map((q, i) => ({
+        prompt: buildSubagentPrompt(q, priorFindings),
+        systemPrompt: SUBAGENT_SYSTEM_PROMPT,
+        mode: 'default',
+        maxIterations: SUBAGENT_MAX_ITERATIONS,
+        allowedTools: [...SUBAGENT_ALLOWED_TOOLS],
+        label: `subagent-${i + 1}`,
+    }));
+    let results;
+    try {
+        results = await ctx.subagents.spawnAll(specs);
+    }
+    catch (err) {
+        // spawnAll is Promise.all under the hood (run-child.ts) — a single child's
+        // setup work (strategy/model resolution, log appends, tool-registry build)
+        // throwing OUTSIDE its own try/catch rejects the whole batch. Treat that as
+        // every-subagent-errored rather than letting the rejection crash the entire
+        // research turn and discard all prior-round findings. flattenOutcome turns
+        // these into RoundFinding rows the loop carries into synthesis.
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            results: [],
+            errored: queries.map((_, index) => ({ index, message })),
+        };
+    }
+    const errored = [];
+    results.forEach((r, i) => {
+        if (r.error)
+            errored.push({ index: i, message: r.error.message });
+    });
+    return { results, errored };
+}
+function buildSubagentPrompt(query, priorFindings) {
+    if (priorFindings.length === 0)
+        return query;
+    const sections = [];
+    sections.push('Earlier research rounds gathered the following findings — use them as context for the focused question at the bottom, but you still need to do your own search to answer the focused question.');
+    sections.push('');
+    for (const f of priorFindings) {
+        sections.push(`### Round ${f.round}: ${f.question}`);
+        if (f.error) {
+            sections.push(`(errored: ${f.error})`);
+        }
+        else {
+            // Cap each embedded finding: the SAME prior-findings blob is duplicated
+            // into every sibling subagent's prompt every round, so unbounded text
+            // grows multiplicatively and can blow the subagent's context window. The
+            // full untruncated text is preserved only for the single synthesis turn.
+            sections.push(capFindingText(f.text) || '(empty response)');
+        }
+        sections.push('');
+    }
+    sections.push('---');
+    sections.push('');
+    sections.push(`Your focused follow-up question:\n${query}`);
+    return sections.join('\n');
+}
+/** Bound a prior finding's text before it is embedded into a subagent prompt. */
+function capFindingText(text) {
+    if (text.length <= SUBAGENT_PRIOR_FINDING_MAX_CHARS)
+        return text;
+    return `${text.slice(0, SUBAGENT_PRIOR_FINDING_MAX_CHARS)}\n…[truncated]`;
+}
+/**
+ * Build a one-screen digest of subagent outcomes for the synthesis gate.
+ * Each entry shows the sub-question and a 200-char headline of the
+ * findings, plus a clear marker for any subagent that errored.
+ */
+export function buildFanoutDigest(findings) {
+    const total = findings.length;
+    const errored = findings.filter((f) => f.error).length;
+    const ok = total - errored;
+    const head = `${ok} of ${total} subagent${total === 1 ? '' : 's'} returned`;
+    const errStub = errored > 0 ? `, ${errored} errored` : '';
+    const blocks = findings.map((f, i) => {
+        if (f.error) {
+            return `${i + 1}. [round ${f.round}] ${f.question}\n   [errored: ${f.error}]`;
+        }
+        const headline = f.text.trim().slice(0, 200).replace(/\n+/g, ' ');
+        return `${i + 1}. [round ${f.round}] ${f.question}\n   ${headline || '(empty response)'}`;
+    });
+    return `${head}${errStub}.\n\n${blocks.join('\n\n')}`;
+}
+/**
+ * Build the synthesis turn's user message: weaves the original question
+ * back together with each subagent's writeup so the synthesizer has the
+ * raw material to cite and combine.
+ */
+export function buildSynthesisInput(originalPrompt, findings) {
+    const parts = [];
+    parts.push(`Original question:\n${originalPrompt}`);
+    parts.push('');
+    parts.push('Sub-question findings:');
+    findings.forEach((f, i) => {
+        parts.push('');
+        parts.push(`### #${i + 1} (round ${f.round}): ${f.question}`);
+        if (f.error) {
+            parts.push(`(errored: ${f.error})`);
+        }
+        else {
+            parts.push(f.text || '(empty response)');
+        }
+    });
+    return parts.join('\n');
+}
+//# sourceMappingURL=fanout-phase.js.map

package/dist/fanout-phase.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { RESEARCH_MODE_NAME } from './constants.js';
+export { parseFollowups, parseQueries } from './parse-queries.js';
+export { buildFanoutDigest, buildSynthesisInput, flattenOutcome, type RoundFinding, } from './fanout-phase.js';
+export declare const deepResearchMode: import("@moxxy/sdk").ModeDef;
+export declare const deepResearchModePlugin: import("@moxxy/sdk").Plugin;
+export default deepResearchModePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,gBAAgB,8BAI3B,CAAC;AAEH,eAAO,MAAM,sBAAsB,6BAIjC,CAAC;AAEH,eAAe,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+import { defineMode, definePlugin } from '@moxxy/sdk';
+import { RESEARCH_MODE_NAME } from './constants.js';
+import { runDeepResearchMode } from './research-loop.js';
+export { RESEARCH_MODE_NAME } from './constants.js';
+export { parseFollowups, parseQueries } from './parse-queries.js';
+export { buildFanoutDigest, buildSynthesisInput, flattenOutcome, } from './fanout-phase.js';
+export const deepResearchMode = defineMode({
+    name: RESEARCH_MODE_NAME,
+    description: 'Fan-out research: plan queries, run subagents in parallel, synthesise a report',
+    run: runDeepResearchMode,
+});
+export const deepResearchModePlugin = definePlugin({
+    name: '@moxxy/mode-deep-research',
+    version: '0.0.0',
+    modes: [deepResearchMode],
+});
+export default deepResearchModePlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,GAEf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;IACzC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,gFAAgF;IAC7F,GAAG,EAAE,mBAAmB;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,YAAY,CAAC;IACjD,IAAI,EAAE,2BAA2B;IACjC,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,CAAC,gBAAgB,CAAC;CAC1B,CAAC,CAAC;AAEH,eAAe,sBAAsB,CAAC"}

package/dist/parse-queries.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Parse the planner's output into individual sub-question strings — a
+ * numbered list under a QUERIES: header.
+ */
+export declare function parseQueries(text: string): string[];
+/**
+ * Parse the follow-up planner output. Accepts either a numbered list
+ * under `FOLLOWUPS:` OR the literal `FOLLOWUPS: (none)` form. Returns
+ * an empty array in both the "(none)" and "no parseable items" cases —
+ * the loop treats both as "no more research needed, proceed to synthesis".
+ */
+export declare function parseFollowups(text: string): string[];
+//# sourceMappingURL=parse-queries.d.ts.map

package/dist/parse-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-queries.d.ts","sourceRoot":"","sources":["../src/parse-queries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CASrD"}