@moxxy/mode-deep-research 0.26.0

package/dist/parse-queries.js

@@ -0,0 +1,71 @@
+/**
+ * Parse the planner's output into individual sub-question strings — a
+ * numbered list under a QUERIES: header.
+ */
+export function parseQueries(text) {
+    return parseNumberedBlock(text, /^queries\s*:?$/i);
+}
+/**
+ * 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 function parseFollowups(text) {
+    const items = parseNumberedBlock(text, /^followups\s*:?$/i);
+    // "(none)" sentinel — the model is telling us no follow-ups are needed.
+    // Anchor it to a full line so a parenthetical that merely follows the
+    // header (e.g. "FOLLOWUPS:\n(none of the prior sources covered cost)\n1. …")
+    // doesn't swallow a genuine numbered list below it. Only honor the sentinel
+    // when no numbered items were parsed.
+    if (items.length === 0 && /^followups\s*:\s*\(none\)\s*$/im.test(text))
+        return [];
+    return items;
+}
+/**
+ * Cap on a single joined query/follow-up. A hostile or malformed model could
+ * emit thousands of continuation lines that all attach to one item; bound the
+ * per-item growth so a mangled plan can't produce a multi-MB subagent prompt.
+ */
+const MAX_ITEM_CHARS = 2000;
+function parseNumberedBlock(text, headerRegex) {
+    const lines = text.split('\n');
+    const items = [];
+    // Tracks whether the previous meaningful line was (or extended) a list item,
+    // so we only ever join wrapped continuations onto a real item.
+    let continuationOpen = false;
+    for (const raw of lines) {
+        const line = raw.trim();
+        // A blank line ends the current item's continuation run: a wrapped query
+        // never spans a blank line, so this prevents an unrelated trailing
+        // paragraph from being glued onto the last query.
+        if (!line) {
+            continuationOpen = false;
+            continue;
+        }
+        if (headerRegex.test(line)) {
+            // A header also closes any open continuation run.
+            continuationOpen = false;
+            continue;
+        }
+        const m = /^(?:\d+[.)]|[-*•])\s*(.+)$/.exec(line);
+        if (m) {
+            items.push(m[1].trim());
+            continuationOpen = true;
+            continue;
+        }
+        // Non-list line. If it directly continues an open item (the model wrapped a
+        // long query across lines), join it on rather than silently truncating the
+        // query — a dropped continuation gets sent to a subagent as a half-question.
+        // A non-list line with NO open item (junk preamble, a "(none …)" header
+        // parenthetical, etc.) is still dropped.
+        if (continuationOpen && items.length > 0) {
+            const last = items[items.length - 1];
+            const joined = `${last} ${line}`;
+            items[items.length - 1] =
+                joined.length > MAX_ITEM_CHARS ? joined.slice(0, MAX_ITEM_CHARS) : joined;
+        }
+    }
+    return items;
+}
+//# sourceMappingURL=parse-queries.js.map

package/dist/parse-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-queries.js","sourceRoot":"","sources":["../src/parse-queries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAC5D,wEAAwE;IACxE,sEAAsE;IACtE,6EAA6E;IAC7E,4EAA4E;IAC5E,sCAAsC;IACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAClF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B,SAAS,kBAAkB,CAAC,IAAY,EAAE,WAAmB;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,6EAA6E;IAC7E,+DAA+D;IAC/D,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,yEAAyE;QACzE,mEAAmE;QACnE,kDAAkD;QAClD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,gBAAgB,GAAG,KAAK,CAAC;YACzB,SAAS;QACX,CAAC;QACD,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,kDAAkD;YAClD,gBAAgB,GAAG,KAAK,CAAC;YACzB,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,EAAE,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YACzB,gBAAgB,GAAG,IAAI,CAAC;YACxB,SAAS;QACX,CAAC;QACD,4EAA4E;QAC5E,2EAA2E;QAC3E,6EAA6E;QAC7E,wEAAwE;QACxE,yCAAyC;QACzC,IAAI,gBAAgB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;YACtC,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;YACjC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;gBACrB,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/query-phase.d.ts

@@ -0,0 +1,15 @@
+import { type ModeContext } from '@moxxy/sdk';
+import type { RoundFinding } from './fanout-phase.js';
+/**
+ * Drive the initial query-planning turn. Single-shot stream — the
+ * planner shouldn't be web-searching, that's the subagents' job.
+ * Returns the raw text, or null on provider error (already emitted).
+ */
+export declare function collectQueryPlan(ctx: ModeContext, redraftFeedback: string | null): Promise<string | null>;
+/**
+ * Drive the follow-up planning turn between gather rounds. The model
+ * sees the prior round(s)' findings as context and decides whether to
+ * spawn more parallel research or move to synthesis.
+ */
+export declare function collectFollowupPlan(ctx: ModeContext, originalPrompt: string, priorFindings: ReadonlyArray<RoundFinding>): Promise<string | null>;
+//# sourceMappingURL=query-phase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-phase.d.ts","sourceRoot":"","sources":["../src/query-phase.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAEjB,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,aAAa,CAAC,YAAY,CAAC,GACzC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB"}

package/dist/query-phase.js

@@ -0,0 +1,81 @@
+import { buildSystemPromptWithSkills, runSingleShotTurn, } from '@moxxy/sdk';
+import { FOLLOWUP_PLAN_SYSTEM_PROMPT, QUERY_PLAN_SYSTEM_PROMPT, } from './constants.js';
+/**
+ * Drive the initial query-planning turn. Single-shot stream — the
+ * planner shouldn't be web-searching, that's the subagents' job.
+ * Returns the raw text, or null on provider error (already emitted).
+ */
+export async function collectQueryPlan(ctx, redraftFeedback) {
+    const messages = buildPlannerMessages(ctx, QUERY_PLAN_SYSTEM_PROMPT, buildInitialUserMessages(ctx, redraftFeedback));
+    return runSingleShotTurn(ctx, messages, { maxTokens: 800 });
+}
+/**
+ * Drive the follow-up planning turn between gather rounds. The model
+ * sees the prior round(s)' findings as context and decides whether to
+ * spawn more parallel research or move to synthesis.
+ */
+export async function collectFollowupPlan(ctx, originalPrompt, priorFindings) {
+    const messages = buildPlannerMessages(ctx, FOLLOWUP_PLAN_SYSTEM_PROMPT, buildFollowupUserMessages(originalPrompt, priorFindings));
+    return runSingleShotTurn(ctx, messages, { maxTokens: 800 });
+}
+function buildPlannerMessages(ctx, systemPrompt, userMessages) {
+    const systemWithSkills = buildSystemPromptWithSkills(ctx.systemPrompt, ctx.skills.list()) ?? '';
+    return [
+        {
+            role: 'system',
+            content: [
+                {
+                    type: 'text',
+                    text: systemPrompt + (systemWithSkills ? `\n\n${systemWithSkills}` : ''),
+                },
+            ],
+        },
+        ...userMessages,
+    ];
+}
+function buildInitialUserMessages(ctx, redraftFeedback) {
+    const out = [];
+    for (const e of ctx.log.slice()) {
+        if (e.type === 'user_prompt') {
+            out.push({ role: 'user', content: [{ type: 'text', text: e.text }] });
+        }
+    }
+    if (redraftFeedback) {
+        out.push({
+            role: 'user',
+            content: [
+                {
+                    type: 'text',
+                    text: `The previous query plan needs to be redrafted. Feedback from the user: ${redraftFeedback}\n\n` +
+                        `Produce a new QUERIES block addressing this feedback.`,
+                },
+            ],
+        });
+    }
+    return out;
+}
+function buildFollowupUserMessages(originalPrompt, priorFindings) {
+    const sections = [];
+    sections.push(`Original question:\n${originalPrompt}`);
+    sections.push('');
+    sections.push('Prior research findings:');
+    for (const f of priorFindings) {
+        sections.push('');
+        sections.push(`### Round ${f.round}, sub-question: ${f.question}`);
+        if (f.error) {
+            sections.push(`(errored: ${f.error})`);
+        }
+        else {
+            sections.push(f.text.trim() || '(empty response)');
+        }
+    }
+    sections.push('');
+    sections.push('Decide whether more parallel research is needed. Reply with a FOLLOWUPS: block as instructed.');
+    return [
+        {
+            role: 'user',
+            content: [{ type: 'text', text: sections.join('\n') }],
+        },
+    ];
+}
+//# sourceMappingURL=query-phase.js.map

package/dist/query-phase.js.map

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

package/dist/research-loop.d.ts

@@ -0,0 +1,18 @@
+import type { ModeContext, MoxxyEvent } from '@moxxy/sdk';
+/**
+ * Deep-research loop:
+ *   1. Plan QUERIES: block (with redraft-able approval gate)
+ *   2. Fan out (round 1) — one subagent per gathering query, in parallel
+ *   3. Up to MAX_FOLLOWUP_ROUNDS of:
+ *        a. Ask model "given findings so far, do you need follow-ups?"
+ *        b. If yes, fan out follow-ups with the prior findings as
+ *           context in each subagent's prompt.
+ *        c. If no, break out.
+ *   4. Synthesis approval gate (digest of all rounds)
+ *   5. Synthesize the final cited writeup.
+ *
+ * Headless contexts auto-approve both gates. Missing ctx.subagents is
+ * fatal — fan-out is the whole point of this mode.
+ */
+export declare function runDeepResearchMode(ctx: ModeContext): AsyncIterable<MoxxyEvent>;
+//# sourceMappingURL=research-loop.d.ts.map

package/dist/research-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-loop.d.ts","sourceRoot":"","sources":["../src/research-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAyB1D;;;;;;;;;;;;;;GAcG;AACH,wBAAuB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,CA8HtF"}

package/dist/research-loop.js

@@ -0,0 +1,357 @@
+import { runQueryApprovalGate, runSynthesisApprovalGate, } from './approval.js';
+import { RESEARCH_MODE_NAME, DEEP_RESEARCH_PLUGIN_ID, MAX_FOLLOWUPS_PER_ROUND, MAX_FOLLOWUP_ROUNDS, MAX_REDRAFTS, MAX_SUBAGENTS, } from './constants.js';
+import { buildFanoutDigest, buildSynthesisInput, flattenOutcome, runFanout, } from './fanout-phase.js';
+import { parseFollowups, parseQueries } from './parse-queries.js';
+import { collectFollowupPlan, collectQueryPlan } from './query-phase.js';
+import { collectSynthesis } from './synthesis-phase.js';
+/**
+ * Deep-research loop:
+ *   1. Plan QUERIES: block (with redraft-able approval gate)
+ *   2. Fan out (round 1) — one subagent per gathering query, in parallel
+ *   3. Up to MAX_FOLLOWUP_ROUNDS of:
+ *        a. Ask model "given findings so far, do you need follow-ups?"
+ *        b. If yes, fan out follow-ups with the prior findings as
+ *           context in each subagent's prompt.
+ *        c. If no, break out.
+ *   4. Synthesis approval gate (digest of all rounds)
+ *   5. Synthesize the final cited writeup.
+ *
+ * Headless contexts auto-approve both gates. Missing ctx.subagents is
+ * fatal — fan-out is the whole point of this mode.
+ */
+export async function* runDeepResearchMode(ctx) {
+    if (ctx.signal.aborted) {
+        yield await ctx.emit({
+            type: 'abort',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            reason: 'aborted before deep-research start',
+        });
+        return;
+    }
+    if (!ctx.subagents) {
+        yield await ctx.emit({
+            type: 'error',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            kind: 'fatal',
+            message: 'research: ctx.subagents is unavailable (the @moxxy/plugin-subagents plugin appears disabled). ' +
+                'Re-enable it, or switch to the default mode for a serial alternative.',
+        });
+        return;
+    }
+    yield await ctx.emit({
+        type: 'mode_iteration',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'system',
+        strategy: RESEARCH_MODE_NAME,
+        iteration: 0,
+        routing: 'unresolved',
+    });
+    // Phase 1: query plan (with redraftable gate).
+    const planning = yield* runPlanningPhase(ctx);
+    if (planning === null)
+        return;
+    const { queries, originalPrompt } = planning;
+    // Phase 2: round-1 fan out.
+    const allFindings = [];
+    const round1 = yield* runRound(ctx, 1, queries, []);
+    if (round1 === null)
+        return;
+    allFindings.push(...round1);
+    // Phase 3: follow-up rounds, capped to MAX_FOLLOWUP_ROUNDS.
+    for (let round = 2; round <= MAX_FOLLOWUP_ROUNDS + 1; round += 1) {
+        if (ctx.signal.aborted)
+            return;
+        const followups = yield* runFollowupPlan(ctx, originalPrompt, allFindings, round);
+        if (followups === null)
+            return;
+        if (followups.length === 0) {
+            yield await ctx.emit({
+                type: 'plugin_event',
+                sessionId: ctx.sessionId,
+                turnId: ctx.turnId,
+                source: 'plugin',
+                pluginId: DEEP_RESEARCH_PLUGIN_ID,
+                subtype: 'deep_research_followups_none',
+                payload: { round },
+            });
+            break;
+        }
+        const nextRound = yield* runRound(ctx, round, followups, allFindings);
+        if (nextRound === null)
+            return;
+        allFindings.push(...nextRound);
+    }
+    if (ctx.signal.aborted)
+        return;
+    // Phase 4: synthesis approval gate.
+    const digest = buildFanoutDigest(allFindings);
+    const gate = await runSynthesisApprovalGate(ctx, digest);
+    if (gate.kind === 'cancel') {
+        yield await ctx.emit({
+            type: 'abort',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'user',
+            reason: 'synthesis cancelled by user',
+        });
+        return;
+    }
+    // Phase 5: synthesize.
+    const synthesisInput = buildSynthesisInput(originalPrompt, allFindings);
+    const synthesisText = await collectSynthesis(ctx, synthesisInput);
+    if (synthesisText === null)
+        return;
+    // Synthesis is a multi-second provider call; if the user aborted while it ran,
+    // emit an abort rather than the finished report — matching the abort discipline
+    // every other phase in this loop follows (see the ctx.signal.aborted guards above).
+    if (ctx.signal.aborted) {
+        yield await ctx.emit({
+            type: 'abort',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            reason: 'aborted during synthesis',
+        });
+        return;
+    }
+    yield await ctx.emit({
+        type: 'assistant_message',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'model',
+        content: synthesisText,
+        stopReason: 'end_turn',
+    });
+    yield await ctx.emit({
+        type: 'plugin_event',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'plugin',
+        pluginId: DEEP_RESEARCH_PLUGIN_ID,
+        subtype: 'deep_research_synthesis_completed',
+        payload: {
+            totalFindings: allFindings.length,
+            rounds: Math.max(...allFindings.map((f) => f.round), 1),
+            errored: allFindings.filter((f) => f.error).length,
+        },
+    });
+}
+/**
+ * One round of parallel fan-out — emits start/complete events around
+ * runFanout. Returns the per-round findings, or null on abort.
+ */
+async function* runRound(ctx, round, queries, priorFindings) {
+    yield await ctx.emit({
+        type: 'plugin_event',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'plugin',
+        pluginId: DEEP_RESEARCH_PLUGIN_ID,
+        subtype: 'deep_research_fanout_started',
+        payload: { round, queries: queries.length },
+    });
+    const outcome = await runFanout(ctx, queries, priorFindings);
+    yield await ctx.emit({
+        type: 'plugin_event',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'plugin',
+        pluginId: DEEP_RESEARCH_PLUGIN_ID,
+        subtype: 'deep_research_fanout_completed',
+        payload: {
+            round,
+            total: queries.length,
+            errored: outcome.errored.length,
+        },
+    });
+    if (ctx.signal.aborted)
+        return null;
+    return flattenOutcome(round, queries, outcome);
+}
+/**
+ * Ask the model whether to fan out more queries, given everything
+ * gathered so far. Returns the parsed follow-up queries (may be empty)
+ * or null on a fatal error.
+ */
+async function* runFollowupPlan(ctx, originalPrompt, priorFindings, round) {
+    yield await ctx.emit({
+        type: 'plugin_event',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'plugin',
+        pluginId: DEEP_RESEARCH_PLUGIN_ID,
+        subtype: 'deep_research_followups_planning',
+        payload: { round, basedOn: priorFindings.length },
+    });
+    const text = await collectFollowupPlan(ctx, originalPrompt, priorFindings);
+    if (text === null)
+        return null;
+    const followups = parseFollowups(text);
+    // Apply cap and surface the trim as an event — but only when there's
+    // something to draft. The empty case is signalled by the caller via
+    // `deep_research_followups_none`; emitting a "drafted with kept=0"
+    // event here would be a duplicate "nothing to do" signal.
+    const trimmed = followups.slice(0, MAX_FOLLOWUPS_PER_ROUND);
+    if (trimmed.length === 0)
+        return [];
+    yield await ctx.emit({
+        type: 'plugin_event',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'plugin',
+        pluginId: DEEP_RESEARCH_PLUGIN_ID,
+        subtype: 'deep_research_followups_drafted',
+        payload: {
+            round,
+            proposed: followups.length,
+            kept: trimmed.length,
+            queries: trimmed,
+        },
+    });
+    // Materialize the follow-up plan as an assistant_message so the user
+    // sees the queries that are about to run, even without an approval
+    // gate. (We deliberately skip a per-round approval gate to keep the
+    // user-facing checkpoints lightweight — the synthesis gate at the
+    // end is the final go/no-go.)
+    yield await ctx.emit({
+        type: 'assistant_message',
+        sessionId: ctx.sessionId,
+        turnId: ctx.turnId,
+        source: 'model',
+        content: `Follow-up round ${round} — spawning ${trimmed.length} more subagent${trimmed.length === 1 ? '' : 's'}:\n` +
+            trimmed.map((q, i) => `${i + 1}. ${q}`).join('\n'),
+        stopReason: 'end_turn',
+    });
+    return trimmed;
+}
+async function* runPlanningPhase(ctx) {
+    // Capture the original prompt from the log so we can re-include it in
+    // synthesis context. Use the LAST user_prompt — the one that triggered this
+    // turn — to stay consistent with how the runner scopes a turn (a multi-turn
+    // session's earlier prompts would otherwise anchor synthesis on a stale
+    // question). null = no user prompt at all (empty log).
+    const originalPrompt = (() => {
+        const events = ctx.log.slice();
+        for (let i = events.length - 1; i >= 0; i -= 1) {
+            const e = events[i];
+            if (e.type === 'user_prompt')
+                return e.text;
+        }
+        return null;
+    })();
+    if (originalPrompt === null) {
+        yield await ctx.emit({
+            type: 'error',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'system',
+            kind: 'fatal',
+            message: 'deep-research: no user prompt found in the session log — nothing to research.',
+        });
+        return null;
+    }
+    let redraftFeedback = null;
+    let redraftCount = 0;
+    while (true) {
+        if (ctx.signal.aborted) {
+            yield await ctx.emit({
+                type: 'abort',
+                sessionId: ctx.sessionId,
+                turnId: ctx.turnId,
+                source: 'system',
+                reason: 'aborted during planning',
+            });
+            return null;
+        }
+        const planText = await collectQueryPlan(ctx, redraftFeedback);
+        if (planText === null)
+            return null;
+        const queries = parseQueries(planText);
+        yield await ctx.emit({
+            type: 'plugin_event',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'plugin',
+            pluginId: DEEP_RESEARCH_PLUGIN_ID,
+            subtype: 'deep_research_queries_drafted',
+            payload: { text: planText, queries, redraft: redraftCount },
+        });
+        if (queries.length === 0) {
+            yield await ctx.emit({
+                type: 'assistant_message',
+                sessionId: ctx.sessionId,
+                turnId: ctx.turnId,
+                source: 'model',
+                content: planText,
+                stopReason: 'end_turn',
+            });
+            return null;
+        }
+        if (queries.length > MAX_SUBAGENTS) {
+            // Over-production is a normal, recoverable failure mode ("be exhaustive"
+            // prompts trip it easily). When an interactive resolver is present and we
+            // still have redraft budget, auto-redraft asking the planner to narrow,
+            // rather than killing the whole turn. Headless (no approval) or once the
+            // redraft cap is exhausted, fall through to the fatal abort.
+            const nextCount = redraftCount + 1;
+            if (ctx.approval && nextCount <= MAX_REDRAFTS) {
+                redraftCount = nextCount;
+                redraftFeedback =
+                    `You produced ${queries.length} queries; the cap is ${MAX_SUBAGENTS}. ` +
+                        `Return at most ${MAX_SUBAGENTS} parallel gathering queries.`;
+                continue;
+            }
+            yield await ctx.emit({
+                type: 'error',
+                sessionId: ctx.sessionId,
+                turnId: ctx.turnId,
+                source: 'system',
+                kind: 'fatal',
+                message: `deep-research: refusing a ${queries.length}-query plan (cap is ${MAX_SUBAGENTS}). Narrow scope or rephrase.`,
+            });
+            return null;
+        }
+        const gate = await runQueryApprovalGate(ctx, planText, queries.length, redraftCount);
+        redraftCount = gate.redraftCount;
+        if (gate.outcome.kind === 'cancel') {
+            yield await ctx.emit({
+                type: 'abort',
+                sessionId: ctx.sessionId,
+                turnId: ctx.turnId,
+                source: 'user',
+                reason: 'query plan rejected by user',
+            });
+            return null;
+        }
+        if (gate.outcome.kind === 'redraft-cap-exceeded') {
+            yield await ctx.emit({
+                type: 'error',
+                sessionId: ctx.sessionId,
+                turnId: ctx.turnId,
+                source: 'system',
+                kind: 'fatal',
+                message: `deep-research: redrafted ${MAX_REDRAFTS}× without approval; aborting.`,
+            });
+            return null;
+        }
+        if (gate.outcome.kind === 'redraft') {
+            redraftFeedback = gate.outcome.feedback;
+            continue;
+        }
+        yield await ctx.emit({
+            type: 'assistant_message',
+            sessionId: ctx.sessionId,
+            turnId: ctx.turnId,
+            source: 'model',
+            content: planText,
+            stopReason: 'end_turn',
+        });
+        return { queries, originalPrompt };
+    }
+}
+//# sourceMappingURL=research-loop.js.map

package/dist/research-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-loop.js","sourceRoot":"","sources":["../src/research-loop.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,SAAS,GAEV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,mBAAmB,CAAC,GAAgB;IACzD,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,oCAAoC;SAC7C,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,OAAO;YACb,OAAO,EACL,gGAAgG;gBAChG,uEAAuE;SAC1E,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,kBAAkB;QAC5B,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,YAAY;KACtB,CAAC,CAAC;IAEH,+CAA+C;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO;IAC9B,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;IAE7C,4BAA4B;IAC5B,MAAM,WAAW,GAAmB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IACpD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO;IAC5B,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAE5B,4DAA4D;IAC5D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,mBAAmB,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACjE,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;QAClF,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO;QAC/B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,cAAc;gBACpB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,uBAAuB;gBACjC,OAAO,EAAE,8BAA8B;gBACvC,OAAO,EAAE,EAAE,KAAK,EAAE;aACnB,CAAC,CAAC;YACH,MAAM;QACR,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACtE,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO;QAC/B,WAAW,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO;IAE/B,oCAAoC;IACpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACzD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,6BAA6B;SACtC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,uBAAuB;IACvB,MAAM,cAAc,GAAG,mBAAmB,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACxE,MAAM,aAAa,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAClE,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO;IAEnC,+EAA+E;IAC/E,gFAAgF;IAChF,oFAAoF;IACpF,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,0BAA0B;SACnC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,mBAAmB;QACzB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,aAAa;QACtB,UAAU,EAAE,UAAU;KACvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,mCAAmC;QAC5C,OAAO,EAAE;YACP,aAAa,EAAE,WAAW,CAAC,MAAM;YACjC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM;SACnD;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,KAAK,SAAS,CAAC,CAAC,QAAQ,CACtB,GAAgB,EAChB,KAAa,EACb,OAA8B,EAC9B,aAA0C;IAE1C,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,8BAA8B;QACvC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE;KAC5C,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,gCAAgC;QACzC,OAAO,EAAE;YACP,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;SAChC;KACF,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,KAAK,SAAS,CAAC,CAAC,eAAe,CAC7B,GAAgB,EAChB,cAAsB,EACtB,aAA0C,EAC1C,KAAa;IAEb,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,kCAAkC;QAC3C,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE;KAClD,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IAC3E,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAEvC,qEAAqE;IACrE,oEAAoE;IACpE,mEAAmE;IACnE,0DAA0D;IAC1D,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,cAAc;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,iCAAiC;QAC1C,OAAO,EAAE;YACP,KAAK;YACL,QAAQ,EAAE,SAAS,CAAC,MAAM;YAC1B,IAAI,EAAE,OAAO,CAAC,MAAM;YACpB,OAAO,EAAE,OAAO;SACjB;KACF,CAAC,CAAC;IAEH,qEAAqE;IACrE,mEAAmE;IACnE,oEAAoE;IACpE,kEAAkE;IAClE,8BAA8B;IAC9B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,mBAAmB;QACzB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM,EAAE,OAAO;QACf,OAAO,EACL,mBAAmB,KAAK,eAAe,OAAO,CAAC,MAAM,iBAAiB,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK;YAC1G,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACpD,UAAU,EAAE,UAAU;KACvB,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,gBAAgB,CAC9B,GAAgB;IAMhB,sEAAsE;IACtE,4EAA4E;IAC5E,4EAA4E;IAC5E,wEAAwE;IACxE,uDAAuD;IACvD,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE;QAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACrB,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa;gBAAE,OAAO,CAAC,CAAC,IAAI,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,OAAO;YACb,OAAO,EACL,+EAA+E;SAClF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,yBAAyB;aAClC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC9D,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACnC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QAEvC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,uBAAuB;YACjC,OAAO,EAAE,+BAA+B;YACxC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;SAC5D,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,mBAAmB;gBACzB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,QAAQ;gBACjB,UAAU,EAAE,UAAU;aACvB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YACnC,yEAAyE;YACzE,0EAA0E;YAC1E,wEAAwE;YACxE,yEAAyE;YACzE,6DAA6D;YAC7D,MAAM,SAAS,GAAG,YAAY,GAAG,CAAC,CAAC;YACnC,IAAI,GAAG,CAAC,QAAQ,IAAI,SAAS,IAAI,YAAY,EAAE,CAAC;gBAC9C,YAAY,GAAG,SAAS,CAAC;gBACzB,eAAe;oBACb,gBAAgB,OAAO,CAAC,MAAM,wBAAwB,aAAa,IAAI;wBACvE,kBAAkB,aAAa,8BAA8B,CAAC;gBAChE,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,6BAA6B,OAAO,CAAC,MAAM,uBAAuB,aAAa,8BAA8B;aACvH,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACrF,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAEjC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,6BAA6B;aACtC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,QAAQ;gBAChB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,4BAA4B,YAAY,+BAA+B;aACjF,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACpC,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YACxC,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,QAAQ;YACjB,UAAU,EAAE,UAAU;SACvB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/synthesis-phase.d.ts

@@ -0,0 +1,8 @@
+import { type ModeContext } from '@moxxy/sdk';
+/**
+ * Run the synthesis turn: single-shot stream that consumes the
+ * per-subagent findings and produces the final structured writeup.
+ * Returns the assembled text or null on error.
+ */
+export declare function collectSynthesis(ctx: ModeContext, inputBody: string): Promise<string | null>;
+//# sourceMappingURL=synthesis-phase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis-phase.d.ts","sourceRoot":"","sources":["../src/synthesis-phase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAwB,MAAM,YAAY,CAAC;AAIvF;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB"}

package/dist/synthesis-phase.js

@@ -0,0 +1,21 @@
+import { runSingleShotTurn } from '@moxxy/sdk';
+import { SYNTHESIS_SYSTEM_PROMPT } from './constants.js';
+/**
+ * Run the synthesis turn: single-shot stream that consumes the
+ * per-subagent findings and produces the final structured writeup.
+ * Returns the assembled text or null on error.
+ */
+export async function collectSynthesis(ctx, inputBody) {
+    const messages = [
+        {
+            role: 'system',
+            content: [{ type: 'text', text: SYNTHESIS_SYSTEM_PROMPT }],
+        },
+        {
+            role: 'user',
+            content: [{ type: 'text', text: inputBody }],
+        },
+    ];
+    return runSingleShotTurn(ctx, messages, { maxTokens: 4096 });
+}
+//# sourceMappingURL=synthesis-phase.js.map

package/dist/synthesis-phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis-phase.js","sourceRoot":"","sources":["../src/synthesis-phase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA0C,MAAM,YAAY,CAAC;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAgB,EAChB,SAAiB;IAEjB,MAAM,QAAQ,GAAsB;QAClC;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;SAC3D;QACD;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;SAC7C;KACF,CAAC;IACF,OAAO,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC"}