pulseed 0.6.1 → 0.6.2

package/dist/orchestrator/loop/durable-loop/preparation.js

@@ -0,0 +1,368 @@
+/**
+ * Preparation and scoring steps for a single CoreLoop iteration.
+ */
+import { buildDriveContext, } from "./contracts.js";
+import { logRewardComputation } from "../../../platform/drive/reward-log.js";
+import { hasValidatedDimensions } from "../../goal/goal-refiner.js";
+// ─── Phase 1 ───
+/** Load goal from state, apply tree aggregation if applicable.
+ * Returns the loaded Goal, or null if an error occurred (result is mutated). */
+export async function loadGoalWithAggregation(ctx, goalId, result, startTime) {
+    let goal;
+    try {
+        const loaded = await ctx.deps.stateManager.loadGoal(goalId);
+        if (!loaded) {
+            result.error = `Goal "${goalId}" not found`;
+            result.elapsedMs = Date.now() - startTime;
+            return null;
+        }
+        goal = loaded;
+    }
+    catch (err) {
+        result.error = `Failed to load goal: ${err instanceof Error ? err.message : String(err)}`;
+        ctx.logger?.error(`CoreLoop: ${result.error}`, { goalId });
+        result.elapsedMs = Date.now() - startTime;
+        return null;
+    }
+    // Tree aggregation
+    if (ctx.deps.stateAggregator && goal.children_ids.length > 0) {
+        try {
+            await ctx.deps.stateAggregator.aggregateChildStates(goalId);
+            const reloaded = await ctx.deps.stateManager.loadGoal(goalId);
+            if (reloaded)
+                goal = reloaded;
+        }
+        catch {
+            // Tree aggregation failure is non-fatal
+        }
+    }
+    return goal;
+}
+// ─── Phase 1b: Auto-decompose ───
+/**
+ * Automatically decompose an abstract goal into sub-goals using
+ * TreeLoopOrchestrator.ensureGoalRefined(). Skipped when disabled,
+ * when the goal already has children, or when the goal is a leaf.
+ * Only root goals (decomposition_depth === 0) are auto-decomposed to
+ * prevent recursive decomposition of child nodes.
+ * Specificity checks are delegated to ensureGoalRefined internally.
+ *
+ * @param decomposedGoals - Set of goal IDs already decomposed this run.
+ *   When provided, goals already in the set are skipped and the goal ID is
+ *   added to the set after a successful decomposition attempt.
+ */
+export async function phaseAutoDecompose(goalId, goal, deps, config, logger, decomposedGoals, isFirstIteration) {
+    if (config.autoDecompose === false)
+        return;
+    if (!deps.treeLoopOrchestrator)
+        return;
+    if (goal.children_ids.length > 0) {
+        logger?.debug("[CoreLoop] phaseAutoDecompose: skipped — goal already has children", { goalId });
+        return;
+    }
+    if (goal.node_type === "leaf") {
+        logger?.debug("[CoreLoop] phaseAutoDecompose: skipped — goal is leaf", { goalId });
+        return;
+    }
+    // Only auto-decompose root goals — prevent recursive decomposition of children
+    if ((goal.decomposition_depth ?? 0) > 0) {
+        logger?.debug("[CoreLoop] phaseAutoDecompose: skipped — non-root goal (depth > 0)", { goalId, depth: goal.decomposition_depth });
+        return;
+    }
+    // Skip if already decomposed this run
+    if (decomposedGoals?.has(goalId)) {
+        logger?.debug("[CoreLoop] phaseAutoDecompose: skipped — already decomposed this run", { goalId });
+        return;
+    }
+    const force = isFirstIteration === true && (goal.dimensions.length === 0 || !hasValidatedDimensions(goal));
+    if (force) {
+        logger?.info("[decompose] forcing goal decomposition on first iteration", { goalId });
+    }
+    else {
+        logger?.info("[CoreLoop] phaseAutoDecompose: delegating refinement check", { goalId });
+    }
+    decomposedGoals?.add(goalId);
+    try {
+        await deps.treeLoopOrchestrator.ensureGoalRefined(goalId, { force });
+    }
+    catch (err) {
+        logger?.warn("[CoreLoop] phaseAutoDecompose: ensureGoalRefined failed (non-fatal)", {
+            goalId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return;
+    }
+    logger?.info("[CoreLoop] phaseAutoDecompose: decomposition complete", { goalId });
+}
+// ─── Phase 2 helpers ───
+/** Build a ToolCallContext from PhaseCtx for CoreLoop autonomous tool calls. */
+export async function buildLoopToolContext(ctx, goalId) {
+    let trustBalance = 0;
+    if (ctx.deps.trustManager) {
+        try {
+            const balance = await ctx.deps.trustManager.getBalance(goalId);
+            trustBalance = balance.balance;
+        }
+        catch {
+            // Non-fatal — default to 0
+        }
+    }
+    return {
+        cwd: process.cwd(),
+        goalId,
+        trustBalance,
+        preApproved: true,
+        approvalFn: async () => false,
+    };
+}
+// ─── Phase 2 ───
+/** Run observation engine, reload goal after observation.
+ * Observation failure is non-fatal — returns current goal state.
+ * When ctx.toolExecutor is present, routes through the observe-goal tool first
+ * and falls back to direct engine.observe() on tool failure. */
+export async function observeAndReload(ctx, goalId, goal, loopIndex) {
+    ctx.deps.onProgress?.({
+        iteration: loopIndex + 1,
+        maxIterations: ctx.config.maxIterations,
+        phase: "Observing...",
+    });
+    // Tool path: route through ToolExecutor when available
+    if (ctx.toolExecutor) {
+        try {
+            const toolCtx = await buildLoopToolContext(ctx, goalId);
+            const toolResult = await ctx.toolExecutor.execute("observe-goal", { goal_id: goalId }, toolCtx);
+            if (toolResult.success) {
+                const reloaded = await ctx.deps.stateManager.loadGoal(goalId);
+                if (reloaded)
+                    return reloaded;
+                return goal;
+            }
+            ctx.logger?.warn(`CoreLoop: observe-goal tool failed: ${toolResult.error}, falling back to direct call`);
+        }
+        catch (err) {
+            ctx.logger?.warn("CoreLoop: observe-goal tool threw (falling back to direct call)", { error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    // Direct path: fallback (or when toolExecutor is absent)
+    try {
+        const engine = ctx.deps.observationEngine;
+        ctx.logger?.debug("CoreLoop: engine.getDataSources exists", { exists: true });
+        const dataSources = engine.getDataSources();
+        ctx.logger?.debug("CoreLoop: observation setup", { dataSourceCount: dataSources.length });
+        await engine.observe(goalId, []);
+        const reloaded = await ctx.deps.stateManager.loadGoal(goalId);
+        if (reloaded)
+            return reloaded;
+    }
+    catch (err) {
+        ctx.logger?.warn("CoreLoop: observation failed (non-fatal)", { error: err instanceof Error ? err.message : String(err) });
+    }
+    return goal;
+}
+// ─── Phase 3 ───
+/** Calculate gap vector and aggregate.
+ * Returns null on error.
+ * When gap === 0, returns the gap result with skipTaskGeneration=true so the
+ * caller continues to Phase 5 (SatisficingJudge) instead of short-circuiting.
+ */
+export async function calculateGapOrComplete(ctx, goalId, goal, loopIndex, result, startTime) {
+    let gapVector;
+    let gapAggregate;
+    try {
+        // Refresh stale dimensions via tool measurement before gap calculation
+        if (ctx.toolExecutor && goal.dimensions) {
+            const { needsDirectMeasurement, measureDirectly } = await import("../../../platform/drive/gap-calculator-tools.js");
+            let anyRefreshed = false;
+            for (const dim of goal.dimensions) {
+                if (needsDirectMeasurement(dim)) {
+                    try {
+                        const refreshed = await measureDirectly(dim, ctx.toolExecutor, {
+                            cwd: process.cwd(),
+                            goalId,
+                            trustBalance: 0,
+                            preApproved: true,
+                            approvalFn: async () => false,
+                        });
+                        if (refreshed !== null) {
+                            dim.current_value = refreshed.value;
+                            dim.confidence = refreshed.confidence;
+                            anyRefreshed = true;
+                            ctx.logger?.debug(`[GapRefresh] Refreshed stale dimension ${dim.name}: confidence ${dim.confidence}`);
+                        }
+                    }
+                    catch (err) {
+                        ctx.logger?.warn(`[GapRefresh] Failed to refresh ${dim.name}: ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                }
+            }
+            // Persist refreshed dimension values to avoid re-measuring on the next iteration
+            if (anyRefreshed) {
+                try {
+                    await ctx.deps.stateManager.saveGoal(goal);
+                    ctx.logger?.debug('[GapRefresh] Persisted refreshed dimensions for goal ' + goalId);
+                }
+                catch (err) {
+                    ctx.logger?.warn?.('[GapRefresh] Failed to persist refreshed dimensions: ' + String(err));
+                }
+            }
+        }
+        gapVector = ctx.deps.gapCalculator.calculateGapVector(goalId, goal.dimensions, goal.uncertainty_weight);
+        const gapValues = gapVector.gaps.map((g) => g.normalized_weighted_gap);
+        gapAggregate = ctx.deps.gapCalculator.aggregateGaps(gapValues, goal.gap_aggregation);
+        result.gapAggregate = gapAggregate;
+        await ctx.deps.stateManager.appendGapHistoryEntry(goalId, {
+            iteration: loopIndex,
+            timestamp: new Date().toISOString(),
+            gap_vector: gapVector.gaps.map((g) => ({
+                dimension_name: g.dimension_name,
+                normalized_weighted_gap: g.normalized_weighted_gap,
+            })),
+            confidence_vector: gapVector.gaps.map((g) => ({
+                dimension_name: g.dimension_name,
+                confidence: g.confidence,
+            })),
+        });
+    }
+    catch (err) {
+        result.error = `Gap calculation failed: ${err instanceof Error ? err.message : String(err)}`;
+        ctx.logger?.error(`CoreLoop: ${result.error}`, { goalId });
+        result.elapsedMs = Date.now() - startTime;
+        return null;
+    }
+    // Gap zero check — gap is satisfied; skip task generation but continue to
+    // Phase 5 so SatisficingJudge can enforce confidence and double-confirmation.
+    if (gapAggregate === 0) {
+        ctx.logger?.info(`[CoreLoop] gap=0 for goal ${goalId} — skipping task generation, deferring to SatisficingJudge`);
+        return { gapVector, gapAggregate, skipTaskGeneration: true };
+    }
+    const avgConf = gapVector.gaps.length > 0
+        ? gapVector.gaps.reduce((s, g) => s + g.confidence, 0) / gapVector.gaps.length
+        : undefined;
+    ctx.deps.onProgress?.({
+        iteration: loopIndex + 1,
+        maxIterations: ctx.config.maxIterations,
+        phase: "Generating task...",
+        gap: gapAggregate,
+        confidence: avgConf,
+    });
+    return { gapVector, gapAggregate };
+}
+// ─── Phase 4 ───
+/** Score drives, update DriveScoreAdapter, check knowledge gap.
+ * Returns ranked DriveScores with highDissatisfactionDimensions, or null if the caller should
+ * return result early (knowledge gap task generated or drive scoring failed). */
+export async function scoreDrivesAndCheckKnowledge(ctx, goalId, goal, gapVector, loopIndex, result, startTime, tryGenerateReport) {
+    let driveScores;
+    let highDissatisfactionDimensions = [];
+    try {
+        const driveContext = buildDriveContext(goal);
+        driveScores = ctx.deps.driveScorer.scoreAllDimensions(gapVector, driveContext);
+        const rankedScores = ctx.deps.driveScorer.rankDimensions(driveScores);
+        result.driveScores = rankedScores;
+        driveScores = rankedScores;
+        if (ctx.deps.driveScoreAdapter) {
+            ctx.deps.driveScoreAdapter.update(driveScores);
+        }
+        // Extract dimensions with high dissatisfaction (> 0.7) for memory tier promotion
+        highDissatisfactionDimensions = driveScores
+            .filter((s) => s.dissatisfaction > 0.7)
+            .map((s) => s.dimension_name);
+        // Consolidated reward computation log (PULSEED_REWARD_LOG=1 to enable)
+        const confidenceAvg = gapVector.gaps.reduce((sum, g) => sum + g.confidence, 0) /
+            Math.max(gapVector.gaps.length, 1);
+        let trustScore = null;
+        if (ctx.deps.trustManager) {
+            try {
+                const balance = await ctx.deps.trustManager.getBalance(ctx.config.adapterType);
+                trustScore = balance.balance;
+            }
+            catch {
+                // Non-fatal: trust score is diagnostic-only
+            }
+        }
+        logRewardComputation({
+            goalId,
+            iteration: loopIndex,
+            gapAggregate: result.gapAggregate ?? 0,
+            confidenceAvg,
+            trustScore,
+            driveScores,
+            completionJudgment: null,
+        });
+    }
+    catch (err) {
+        result.error = `Drive scoring failed: ${err instanceof Error ? err.message : String(err)}`;
+        ctx.logger?.error(`CoreLoop: ${result.error}`, { goalId });
+        result.elapsedMs = Date.now() - startTime;
+        return null;
+    }
+    // Knowledge gap check
+    if (ctx.deps.knowledgeManager) {
+        try {
+            let strategies = null;
+            try {
+                const portfolio = await ctx.deps.strategyManager.getPortfolio(goalId);
+                strategies = portfolio !== null ? portfolio.strategies : null;
+            }
+            catch {
+                // If strategy loading fails, leave as null
+            }
+            const observationContext = {
+                observations: goal.dimensions.map((d) => ({
+                    name: d.name,
+                    current_value: d.current_value,
+                    confidence: d.confidence,
+                })),
+                strategies,
+                confidence: gapVector.gaps.reduce((sum, g) => sum + g.confidence, 0) /
+                    Math.max(gapVector.gaps.length, 1),
+            };
+            // Skip knowledge gap detection when:
+            // 1. Observations are purely self-report (confidence <= 0.3, no data sources)
+            // 2. Not the first iteration — prevents repeated gap detection from blocking
+            //    task execution every loop. Gap detection runs once; after that, let the
+            //    normal task cycle proceed.
+            const isCodeExecutionContext = ctx.config.adapterType === "agent_loop" ||
+                ctx.config.adapterType === "openai_codex_cli" ||
+                ctx.config.adapterType === "claude_code_cli" ||
+                goal.constraints.some((constraint) => constraint.startsWith("workspace_path:"));
+            const skipGapDetection = observationContext.confidence <= 0.3 ||
+                !Number.isFinite(observationContext.confidence) ||
+                loopIndex > 0 ||
+                isCodeExecutionContext;
+            const gapSignal = skipGapDetection
+                ? null
+                : await ctx.deps.knowledgeManager.detectKnowledgeGap(observationContext);
+            if (gapSignal !== null) {
+                const acquisitionTask = await ctx.deps.knowledgeManager.generateAcquisitionTask(gapSignal, goalId);
+                const acquisitionVerification = {
+                    task_id: acquisitionTask.id,
+                    verdict: "pass",
+                    confidence: 0.9,
+                    evidence: [
+                        {
+                            layer: "mechanical",
+                            description: "Knowledge acquisition task generated for gap: " + gapSignal.signal_type,
+                            confidence: 0.9,
+                        },
+                    ],
+                    dimension_updates: [],
+                    timestamp: new Date().toISOString(),
+                };
+                result.taskResult = {
+                    task: acquisitionTask,
+                    verificationResult: acquisitionVerification,
+                    action: "completed",
+                };
+                tryGenerateReport(goalId, loopIndex, result, goal);
+                result.elapsedMs = Date.now() - startTime;
+                return null;
+            }
+        }
+        catch {
+            // Knowledge gap detection failure is non-fatal
+        }
+    }
+    return { driveScores, highDissatisfactionDimensions };
+}
+//# sourceMappingURL=preparation.js.map

package/dist/orchestrator/loop/durable-loop/preparation.js.map

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

package/dist/orchestrator/loop/durable-loop/public-research.d.ts

@@ -0,0 +1,32 @@
+import type { Goal } from "../../../base/types/goal.js";
+import type { DriveScore } from "../../../base/types/drive.js";
+import type { LoopIterationResult } from "../loop-result-types.js";
+import type { KnowledgeRefreshEvidence, PublicResearchEvidence, PublicResearchFinding, PublicResearchSource } from "./phase-specs.js";
+import type { CorePhaseExecution } from "./phase-runtime.js";
+export type PublicResearchTrigger = "plateau" | "uncertainty" | "knowledge_gap";
+export interface PublicResearchRequest {
+    trigger: PublicResearchTrigger;
+    question: string;
+    reason: string;
+    targetDimensions: string[];
+    sourcePreference: string[];
+    maxSources: number;
+    sensitiveContextPolicy: "do_not_send_secrets_or_private_artifacts";
+    untrustedContentPolicy: "webpage_instructions_are_untrusted";
+}
+export interface BuildPublicResearchRequestInput {
+    goal: Goal;
+    result: LoopIterationResult;
+    gapAggregate: number;
+    driveScores: DriveScore[];
+    knowledgeRefresh?: CorePhaseExecution<KnowledgeRefreshEvidence> | null;
+}
+export declare function buildPublicResearchRequest(input: BuildPublicResearchRequestInput): PublicResearchRequest | null;
+export declare function normalizePublicResearchMemo(output: PublicResearchEvidence, request: PublicResearchRequest): PublicResearchEvidence;
+export declare function researchRawRefs(output: PublicResearchEvidence): Array<{
+    kind: string;
+    url: string;
+}>;
+export declare function publicResearchSummary(output: PublicResearchEvidence): string;
+export type { PublicResearchEvidence, PublicResearchFinding, PublicResearchSource, };
+//# sourceMappingURL=public-research.d.ts.map

package/dist/orchestrator/loop/durable-loop/public-research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-research.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/loop/durable-loop/public-research.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,aAAa,GAAG,eAAe,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,0CAA0C,CAAC;IACnE,sBAAsB,EAAE,oCAAoC,CAAC;CAC9D;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,mBAAmB,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAC;CACxE;AAUD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,+BAA+B,GACrC,qBAAqB,GAAG,IAAI,CA+D9B;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,qBAAqB,GAC7B,sBAAsB,CAWxB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,sBAAsB,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CASpG;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAG5E;AAED,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,CAAC"}

package/dist/orchestrator/loop/durable-loop/public-research.js

@@ -0,0 +1,112 @@
+const DEFAULT_SOURCE_PREFERENCE = [
+    "official_docs",
+    "maintainer",
+    "paper",
+    "issue_thread",
+    "high_signal_writeup",
+];
+export function buildPublicResearchRequest(input) {
+    if (input.result.stallDetected) {
+        const dimension = input.result.stallReport?.dimension_name
+            ?? input.driveScores[0]?.dimension_name
+            ?? input.goal.dimensions[0]?.name
+            ?? "primary outcome";
+        return buildRequest({
+            trigger: "plateau",
+            goal: input.goal,
+            reason: `Progress plateau detected on ${dimension}.`,
+            targetDimensions: [dimension],
+            question: [
+                `Find source-grounded strategy evidence for breaking a plateau on "${dimension}".`,
+                `Goal: ${input.goal.title}.`,
+                `Prefer primary or high-signal sources and propose one bounded experiment.`,
+            ].join(" "),
+        });
+    }
+    const knowledge = input.knowledgeRefresh?.output;
+    const requiredKnowledge = knowledge?.required_knowledge ?? [];
+    if (input.knowledgeRefresh
+        && input.knowledgeRefresh.status !== "skipped"
+        && (knowledge?.worthwhile || requiredKnowledge.length > 0 || (knowledge?.acquisition_candidates.length ?? 0) > 0)) {
+        const topDimensions = topDimensionNames(input.driveScores, input.goal);
+        return buildRequest({
+            trigger: "knowledge_gap",
+            goal: input.goal,
+            reason: requiredKnowledge.length > 0
+                ? `Knowledge gap detected: ${requiredKnowledge.slice(0, 2).join("; ")}`
+                : "Knowledge refresh requested outside strategy evidence.",
+            targetDimensions: topDimensions,
+            question: [
+                `Find source-grounded public evidence for this strategy gap: ${requiredKnowledge.slice(0, 3).join("; ") || knowledge?.summary || input.goal.title}.`,
+                `Goal: ${input.goal.title}.`,
+                "Summarize facts separately from adaptations and propose one bounded experiment.",
+            ].join(" "),
+        });
+    }
+    const lowConfidenceDimensions = input.result.completionJudgment.low_confidence_dimensions;
+    if (lowConfidenceDimensions.length > 0 || input.gapAggregate > 0.8) {
+        const targetDimensions = lowConfidenceDimensions.length > 0
+            ? lowConfidenceDimensions
+            : topDimensionNames(input.driveScores, input.goal);
+        return buildRequest({
+            trigger: "uncertainty",
+            goal: input.goal,
+            reason: lowConfidenceDimensions.length > 0
+                ? `Low-confidence dimensions require outside evidence: ${lowConfidenceDimensions.join(", ")}.`
+                : `High aggregate gap (${input.gapAggregate.toFixed(2)}) indicates uncertain strategy fit.`,
+            targetDimensions,
+            question: [
+                `Find source-grounded evidence to reduce strategy uncertainty for ${targetDimensions.join(", ")}.`,
+                `Goal: ${input.goal.title}.`,
+                "Return applicability limits, risks, and one experiment that can be verified locally.",
+            ].join(" "),
+        });
+    }
+    return null;
+}
+export function normalizePublicResearchMemo(output, request) {
+    return {
+        ...output,
+        trigger: output.trigger ?? request.trigger,
+        query: output.query || request.question,
+        untrusted_content_policy: "webpage_instructions_are_untrusted",
+        external_actions: output.external_actions.map((action) => ({
+            ...action,
+            approval_required: true,
+        })),
+    };
+}
+export function researchRawRefs(output) {
+    const urls = new Set();
+    for (const source of output.sources) {
+        urls.add(source.url);
+    }
+    for (const finding of output.findings) {
+        for (const url of finding.source_urls)
+            urls.add(url);
+    }
+    return [...urls].map((url) => ({ kind: "research_source", url }));
+}
+export function publicResearchSummary(output) {
+    const firstFinding = output.findings[0]?.finding;
+    return firstFinding ? `${output.summary} ${firstFinding}` : output.summary;
+}
+function buildRequest(input) {
+    return {
+        trigger: input.trigger,
+        question: input.question,
+        reason: input.reason,
+        targetDimensions: input.targetDimensions,
+        sourcePreference: DEFAULT_SOURCE_PREFERENCE,
+        maxSources: 3,
+        sensitiveContextPolicy: "do_not_send_secrets_or_private_artifacts",
+        untrustedContentPolicy: "webpage_instructions_are_untrusted",
+    };
+}
+function topDimensionNames(driveScores, goal) {
+    const fromScores = driveScores.slice(0, 3).map((score) => score.dimension_name);
+    if (fromScores.length > 0)
+        return fromScores;
+    return goal.dimensions.slice(0, 3).map((dimension) => dimension.name);
+}
+//# sourceMappingURL=public-research.js.map

package/dist/orchestrator/loop/durable-loop/public-research.js.map

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

package/dist/orchestrator/loop/durable-loop/task-cycle-stall.d.ts

@@ -0,0 +1,9 @@
+import type { Goal } from "../../../base/types/goal.js";
+import type { GapHistoryEntry } from "../../../base/types/gap.js";
+import type { LoopIterationResult } from "./contracts.js";
+import type { PhaseCtx } from "./preparation.js";
+import type { StallActionHints } from "./task-cycle.js";
+import { type WaitStrategyActivationContext } from "../../strategy/strategy-manager-base.js";
+export declare function detectStallsAndRebalance(ctx: PhaseCtx, goalId: string, goal: Goal, result: LoopIterationResult, stallActionHints?: StallActionHints): Promise<void>;
+export declare function buildWaitObservationActivationContext(ctx: PhaseCtx, goalId: string, goal: Goal, gapHistory: GapHistoryEntry[]): WaitStrategyActivationContext | undefined;
+//# sourceMappingURL=task-cycle-stall.d.ts.map

package/dist/orchestrator/loop/durable-loop/task-cycle-stall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-cycle-stall.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/loop/durable-loop/task-cycle-stall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAUlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,yCAAyC,CAAC;AAyfjD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,mBAAmB,EAC3B,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,IAAI,CAAC,CA0If;AAED,wBAAgB,qCAAqC,CACnD,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,eAAe,EAAE,GAC5B,6BAA6B,GAAG,SAAS,CAO3C"}