@caupulican/pi-adaptative 0.81.39 → 0.81.41

package/dist/core/research/research-lane-controller.js

@@ -0,0 +1,292 @@
+import { resolveModelThinkingLevel } from "@caupulican/pi-ai";
+import { getPrivateLaneDeniedPaths } from "../autonomy/lane-private-paths.js";
+import { createLaneToolSurface } from "../autonomy/lane-tool-surface.js";
+import { appendLaneRecordSnapshot, getLaneRecordSnapshots } from "../autonomy/session-lane-record.js";
+import { composeSubagentSystemPrompt } from "../autonomy/subagent-prompt.js";
+import { AUTONOMY_TELEMETRY_EVENT_TYPES } from "../autonomy/telemetry-events.js";
+import { registerInFlightWork } from "../reload-blockers.js";
+import { clampLaneMaxUsd } from "./lane-model-resolver.js";
+import { runResearch } from "./research-runner.js";
+/** Owns autonomous research demand, scheduling, execution, persistence, and cancellation. */
+export class ResearchLaneController {
+    _timer;
+    _isRunning = false;
+    _lastSkipReason;
+    _historySeeded = false;
+    _persistedRunCount = 0;
+    abortController = new AbortController();
+    warnedUnboundToolGrants = new Set();
+    deps;
+    lanes;
+    models;
+    constructor(deps, lanes, models) {
+        this.deps = deps;
+        this.lanes = lanes;
+        this.models = models;
+    }
+    seedHistory() {
+        if (this._historySeeded)
+            return;
+        const records = getLaneRecordSnapshots(this.deps.getSessionManager().getEntries());
+        this.lanes.ensureCounterAtLeast(records.length + 1);
+        this._persistedRunCount = records.filter((record) => record.type === "research").length;
+        this._historySeeded = true;
+    }
+    getLastSkipReason() {
+        return this._lastSkipReason;
+    }
+    abort() {
+        this.clearTimer();
+        this.abortController.abort();
+    }
+    clearTimer() {
+        if (this._timer !== undefined) {
+            clearTimeout(this._timer);
+            this._timer = undefined;
+        }
+    }
+    scheduleFromIdle() {
+        if (this._isRunning || this.deps.isDisposed() || this.deps.isChildSession())
+            return;
+        const research = this.deps.getSettingsManager().getResearchLaneSettings();
+        if (!research.enabled) {
+            this._lastSkipReason = "research_lane_disabled";
+            return;
+        }
+        const { mode } = this.deps.getSettingsManager().getAutonomySettings();
+        if (mode === "off") {
+            this._lastSkipReason = "autonomy_mode_off";
+            return;
+        }
+        this.seedHistory();
+        if (this._persistedRunCount >= research.maxRunsPerSession) {
+            this._lastSkipReason = "max_runs_reached";
+            return;
+        }
+        if (!this.buildDemand())
+            return;
+        const shipment = this.models.resolveShipment(research, "no_research_model");
+        if (!shipment.ok) {
+            this._lastSkipReason = shipment.skipReason;
+            return;
+        }
+        if (!this.models.capabilityProfile(shipment.model).backgroundLanesEnabled) {
+            this._lastSkipReason = "model_research_unsupported";
+            return;
+        }
+        this.clearTimer();
+        this._timer = setTimeout(() => {
+            this._timer = undefined;
+            void this.runScheduled();
+        }, research.idleDelayMs);
+        const timer = this._timer;
+        if (typeof timer === "object" && timer && "unref" in timer) {
+            const { unref } = timer;
+            unref?.call(timer);
+        }
+    }
+    async runOnce(request) {
+        if (this._isRunning)
+            return { started: false, skipReason: "research_lane_already_running" };
+        if (this.deps.isDisposed())
+            return { started: false, skipReason: "session_disposed" };
+        const settings = this.deps.getSettingsManager().getResearchLaneSettings();
+        const demand = request?.query
+            ? { query: request.query, context: request.context ?? "", goalId: request.goalId }
+            : this.buildDemand();
+        if (!demand)
+            return { started: false, skipReason: this._lastSkipReason ?? "no_research_demand" };
+        const shipment = this.models.resolveShipment(settings, "no_research_model");
+        if (!shipment.ok) {
+            this._lastSkipReason = shipment.skipReason;
+            return { started: false, skipReason: shipment.skipReason };
+        }
+        const { model, laneProfile } = shipment;
+        const laneCapability = this.models.capabilityProfile(model);
+        if (!laneCapability.backgroundLanesEnabled) {
+            this._lastSkipReason = "model_research_unsupported";
+            return { started: false, skipReason: "model_research_unsupported" };
+        }
+        this._isRunning = true;
+        this.seedHistory();
+        const startedRecord = this.lanes.start({ type: "research", goalId: demand.goalId });
+        this._persistedRunCount++;
+        const deregisterInFlight = registerInFlightWork(this.deps.getAgentDir(), "lane", `research:${startedRecord.laneId}`);
+        try {
+            let spentUsage;
+            const workspaceSources = await this.deps.collectWorkspaceSources({
+                query: `${demand.context}\n${demand.query}`,
+                cwd: this.deps.getCwd(),
+                maxSources: settings.maxSources,
+            });
+            const maxUsd = clampLaneMaxUsd(settings.maxUsd, this.deps.getCapabilityEnvelope()?.maxEstimatedUsd);
+            const toolSurface = createLaneToolSurface({
+                cwd: this.deps.getCwd(),
+                profile: laneProfile,
+                deniedPaths: getPrivateLaneDeniedPaths(this.deps.getCwd(), this.deps.getAgentDir()),
+            });
+            this.warnUnboundToolGrants(laneProfile, toolSurface);
+            const result = await runResearch({
+                query: demand.query,
+                context: demand.context,
+                sources: workspaceSources,
+                envelope: this.buildEnvelope(maxUsd, laneProfile, toolSurface),
+                maxUsd,
+                maxSources: settings.maxSources,
+                maxFindings: settings.maxFindings,
+                maxWallClockMs: settings.maxWallClockMs,
+                signal: this.abortController.signal,
+                complete: async ({ systemPrompt, userPrompt, signal }) => {
+                    const completion = await this.deps.runIsolatedCompletion({
+                        systemPrompt: composeSubagentSystemPrompt({
+                            soul: laneProfile?.soul,
+                            rolePrompt: systemPrompt,
+                            override: settings.systemPrompt,
+                        }),
+                        messages: [{ role: "user", content: [{ type: "text", text: userPrompt }], timestamp: Date.now() }],
+                        model,
+                        thinkingLevel: resolveModelThinkingLevel(model, laneProfile?.thinking),
+                        maxTokens: laneCapability.laneMaxOutputTokens,
+                        tools: toolSurface.tools,
+                        maxTurns: 6,
+                        beforeToolCall: toolSurface.beforeToolCall,
+                        signal,
+                        cacheRetention: "short",
+                        laneKind: "research",
+                    });
+                    spentUsage = completion.usage;
+                    return {
+                        text: completion.text,
+                        costUsd: completion.usage.cost.total,
+                        stopReason: String(completion.stopReason),
+                    };
+                },
+            });
+            if (this.deps.isDisposed()) {
+                const record = this.lanes.complete(startedRecord.laneId, {
+                    status: "canceled",
+                    reasonCode: "session_disposed",
+                });
+                return { started: true, record, result };
+            }
+            let evidenceEntryId;
+            if (result.bundle)
+                evidenceEntryId = this.deps.saveEvidenceBundleSnapshot(result.bundle);
+            if (spentUsage && (spentUsage.cost.total > 0 || spentUsage.totalTokens > 0)) {
+                this.deps.addSpawnedUsage(spentUsage, {
+                    label: "research-lane",
+                    reportId: `research:${this.deps.getSessionId()}:${startedRecord.laneId}`,
+                });
+            }
+            const record = this.lanes.complete(startedRecord.laneId, {
+                status: result.status,
+                reasonCode: result.reasonCode,
+                costUsd: result.costUsd,
+                evidenceEntryId,
+            });
+            if (record) {
+                appendLaneRecordSnapshot(this.deps.getSessionManager(), record);
+                this.emitTerminalTelemetry(record);
+            }
+            return { started: true, record, result };
+        }
+        catch (error) {
+            const record = this.lanes.complete(startedRecord.laneId, {
+                status: "failed",
+                reasonCode: "research_lane_error",
+            });
+            if (record && !this.deps.isDisposed()) {
+                appendLaneRecordSnapshot(this.deps.getSessionManager(), record);
+                this.emitTerminalTelemetry(record);
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            this.deps.emit({ type: "warning", message: `Research lane failed: ${message}` });
+            return { started: true, record };
+        }
+        finally {
+            this._isRunning = false;
+            deregisterInFlight();
+        }
+    }
+    buildDemand() {
+        const goal = this.deps.getGoalStateSnapshot();
+        if (!goal || goal.status !== "active") {
+            this._lastSkipReason = "no_active_goal";
+            return undefined;
+        }
+        const open = goal.requirements.filter((requirement) => requirement.status === "open");
+        if (open.length === 0) {
+            this._lastSkipReason = "no_open_requirements";
+            return undefined;
+        }
+        const query = `goal:${goal.goalId} requirements:${open
+            .map((requirement) => requirement.id)
+            .sort()
+            .join(",")}`;
+        if (this.deps.getEvidenceBundleSnapshot()?.query === query) {
+            this._lastSkipReason = "recent_evidence_sufficient";
+            return undefined;
+        }
+        const context = [
+            `Goal: ${goal.userGoal}`,
+            "Open requirements:",
+            ...open.slice(0, 20).map((requirement) => `- ${requirement.text}`),
+        ].join("\n");
+        return { query, context, goalId: goal.goalId };
+    }
+    async runScheduled() {
+        if (this._isRunning || this.deps.isDisposed())
+            return;
+        const research = this.deps.getSettingsManager().getResearchLaneSettings();
+        const { mode } = this.deps.getSettingsManager().getAutonomySettings();
+        if (!research.enabled || mode === "off")
+            return;
+        try {
+            await this.runOnce();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.deps.emit({ type: "warning", message: `Research lane failed: ${message}` });
+        }
+    }
+    buildEnvelope(maxUsd, laneProfile, surface) {
+        return {
+            id: `research-${this.deps.getSessionId()}-${Date.now()}`,
+            profileId: laneProfile?.name,
+            capabilities: ["research.execute", "filesystem.read", "memory.query"],
+            allowedTools: [...surface.allowedTools],
+            deniedTools: [...surface.deniedTools],
+            allowedPaths: [this.deps.getCwd()],
+            deniedPaths: getPrivateLaneDeniedPaths(this.deps.getCwd(), this.deps.getAgentDir()),
+            maxEstimatedUsd: clampLaneMaxUsd(maxUsd, this.deps.getCapabilityEnvelope()?.maxEstimatedUsd),
+            createdAt: new Date().toISOString(),
+        };
+    }
+    warnUnboundToolGrants(laneProfile, surface) {
+        if (!laneProfile || surface.unboundAllowPatterns.length === 0)
+            return;
+        const warningKey = `${laneProfile.name}\0${[...surface.unboundAllowPatterns].sort().join("\0")}`;
+        if (this.warnedUnboundToolGrants.has(warningKey))
+            return;
+        this.warnedUnboundToolGrants.add(warningKey);
+        this.deps.emit({
+            type: "warning",
+            message: `Lane profile '${laneProfile.name}' grants unavailable isolated-lane tools: ${surface.unboundAllowPatterns.join(", ")}. Only classified lane tools can execute.`,
+        });
+    }
+    emitTerminalTelemetry(record) {
+        this.deps.emitAutonomyTelemetry({
+            type: AUTONOMY_TELEMETRY_EVENT_TYPES.evidenceBundle,
+            timestamp: new Date().toISOString(),
+            payload: {
+                laneId: record.laneId,
+                laneType: record.type,
+                status: record.status,
+                reasonCode: record.reasonCode ?? null,
+                costUsd: record.costUsd ?? null,
+                hasEvidence: record.evidenceEntryId !== undefined,
+            },
+        });
+    }
+}
+//# sourceMappingURL=research-lane-controller.js.map

package/dist/core/research/research-lane-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-lane-controller.js","sourceRoot":"","sources":["../../../src/core/research/research-lane-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SessionManager } from \"@caupulican/pi-agent-core/node\";\nimport { resolveModelThinkingLevel, type Usage } from \"@caupulican/pi-ai\";\nimport type {\n\tAgentSessionEvent,\n\tIsolatedCompletionOptions,\n\tIsolatedCompletionResult,\n\tResearchLaneRunOutcome,\n} from \"../agent-session.ts\";\nimport type { CapabilityEnvelope, EvidenceBundle } from \"../autonomy/contracts.ts\";\nimport { getPrivateLaneDeniedPaths } from \"../autonomy/lane-private-paths.ts\";\nimport { createLaneToolSurface, type LaneToolSurface } from \"../autonomy/lane-tool-surface.ts\";\nimport type { LaneTracker } from \"../autonomy/lane-tracker.ts\";\nimport { appendLaneRecordSnapshot, getLaneRecordSnapshots } from \"../autonomy/session-lane-record.ts\";\nimport { composeSubagentSystemPrompt } from \"../autonomy/subagent-prompt.ts\";\nimport { AUTONOMY_TELEMETRY_EVENT_TYPES, type AutonomyTelemetryEvent } from \"../autonomy/telemetry-events.ts\";\nimport type { GoalState } from \"../goals/goal-state.ts\";\nimport type { NormalizedProfile } from \"../profile-registry.ts\";\nimport { registerInFlightWork } from \"../reload-blockers.ts\";\nimport type { SettingsManager } from \"../settings-manager.ts\";\nimport { clampLaneMaxUsd, type LaneModelResolver } from \"./lane-model-resolver.ts\";\nimport { runResearch } from \"./research-runner.ts\";\nimport type { collectWorkspaceSources } from \"./workspace-collector.ts\";\n\nexport interface ResearchLaneControllerDeps {\n\tisDisposed(): boolean;\n\tisChildSession(): boolean;\n\tgetSessionId(): string;\n\tgetCwd(): string;\n\tgetAgentDir(): string;\n\tgetSessionManager(): SessionManager;\n\tgetSettingsManager(): SettingsManager;\n\tgetCapabilityEnvelope(): CapabilityEnvelope | undefined;\n\temit(event: AgentSessionEvent): void;\n\temitAutonomyTelemetry(event: AutonomyTelemetryEvent): void;\n\tgetGoalStateSnapshot(): GoalState | undefined;\n\tgetEvidenceBundleSnapshot(): EvidenceBundle | undefined;\n\tsaveEvidenceBundleSnapshot(bundle: EvidenceBundle): string;\n\taddSpawnedUsage(\n\t\tusage: Usage,\n\t\topts: { label?: string; sourceSessionId?: string; reportId: string },\n\t): string | undefined;\n\trunIsolatedCompletion(opts: IsolatedCompletionOptions): Promise<IsolatedCompletionResult>;\n\tcollectWorkspaceSources: typeof collectWorkspaceSources;\n}\n\n/** Owns autonomous research demand, scheduling, execution, persistence, and cancellation. */\nexport class ResearchLaneController {\n\tprivate _timer: ReturnType<typeof setTimeout> | undefined;\n\tprivate _isRunning = false;\n\tprivate _lastSkipReason: string | undefined;\n\tprivate _historySeeded = false;\n\tprivate _persistedRunCount = 0;\n\tprivate readonly abortController = new AbortController();\n\tprivate readonly warnedUnboundToolGrants = new Set<string>();\n\tprivate readonly deps: ResearchLaneControllerDeps;\n\tprivate readonly lanes: LaneTracker;\n\tprivate readonly models: LaneModelResolver;\n\n\tconstructor(deps: ResearchLaneControllerDeps, lanes: LaneTracker, models: LaneModelResolver) {\n\t\tthis.deps = deps;\n\t\tthis.lanes = lanes;\n\t\tthis.models = models;\n\t}\n\n\tseedHistory(): void {\n\t\tif (this._historySeeded) return;\n\t\tconst records = getLaneRecordSnapshots(this.deps.getSessionManager().getEntries());\n\t\tthis.lanes.ensureCounterAtLeast(records.length + 1);\n\t\tthis._persistedRunCount = records.filter((record) => record.type === \"research\").length;\n\t\tthis._historySeeded = true;\n\t}\n\n\tgetLastSkipReason(): string | undefined {\n\t\treturn this._lastSkipReason;\n\t}\n\n\tabort(): void {\n\t\tthis.clearTimer();\n\t\tthis.abortController.abort();\n\t}\n\n\tclearTimer(): void {\n\t\tif (this._timer !== undefined) {\n\t\t\tclearTimeout(this._timer);\n\t\t\tthis._timer = undefined;\n\t\t}\n\t}\n\n\tscheduleFromIdle(): void {\n\t\tif (this._isRunning || this.deps.isDisposed() || this.deps.isChildSession()) return;\n\t\tconst research = this.deps.getSettingsManager().getResearchLaneSettings();\n\t\tif (!research.enabled) {\n\t\t\tthis._lastSkipReason = \"research_lane_disabled\";\n\t\t\treturn;\n\t\t}\n\t\tconst { mode } = this.deps.getSettingsManager().getAutonomySettings();\n\t\tif (mode === \"off\") {\n\t\t\tthis._lastSkipReason = \"autonomy_mode_off\";\n\t\t\treturn;\n\t\t}\n\t\tthis.seedHistory();\n\t\tif (this._persistedRunCount >= research.maxRunsPerSession) {\n\t\t\tthis._lastSkipReason = \"max_runs_reached\";\n\t\t\treturn;\n\t\t}\n\t\tif (!this.buildDemand()) return;\n\t\tconst shipment = this.models.resolveShipment(research, \"no_research_model\");\n\t\tif (!shipment.ok) {\n\t\t\tthis._lastSkipReason = shipment.skipReason;\n\t\t\treturn;\n\t\t}\n\t\tif (!this.models.capabilityProfile(shipment.model).backgroundLanesEnabled) {\n\t\t\tthis._lastSkipReason = \"model_research_unsupported\";\n\t\t\treturn;\n\t\t}\n\n\t\tthis.clearTimer();\n\t\tthis._timer = setTimeout(() => {\n\t\t\tthis._timer = undefined;\n\t\t\tvoid this.runScheduled();\n\t\t}, research.idleDelayMs);\n\t\tconst timer = this._timer;\n\t\tif (typeof timer === \"object\" && timer && \"unref\" in timer) {\n\t\t\tconst { unref } = timer as { unref?: () => void };\n\t\t\tunref?.call(timer);\n\t\t}\n\t}\n\n\tasync runOnce(request?: { query?: string; context?: string; goalId?: string }): Promise<ResearchLaneRunOutcome> {\n\t\tif (this._isRunning) return { started: false, skipReason: \"research_lane_already_running\" };\n\t\tif (this.deps.isDisposed()) return { started: false, skipReason: \"session_disposed\" };\n\n\t\tconst settings = this.deps.getSettingsManager().getResearchLaneSettings();\n\t\tconst demand = request?.query\n\t\t\t? { query: request.query, context: request.context ?? \"\", goalId: request.goalId }\n\t\t\t: this.buildDemand();\n\t\tif (!demand) return { started: false, skipReason: this._lastSkipReason ?? \"no_research_demand\" };\n\n\t\tconst shipment = this.models.resolveShipment(settings, \"no_research_model\");\n\t\tif (!shipment.ok) {\n\t\t\tthis._lastSkipReason = shipment.skipReason;\n\t\t\treturn { started: false, skipReason: shipment.skipReason };\n\t\t}\n\t\tconst { model, laneProfile } = shipment;\n\t\tconst laneCapability = this.models.capabilityProfile(model);\n\t\tif (!laneCapability.backgroundLanesEnabled) {\n\t\t\tthis._lastSkipReason = \"model_research_unsupported\";\n\t\t\treturn { started: false, skipReason: \"model_research_unsupported\" };\n\t\t}\n\n\t\tthis._isRunning = true;\n\t\tthis.seedHistory();\n\t\tconst startedRecord = this.lanes.start({ type: \"research\", goalId: demand.goalId });\n\t\tthis._persistedRunCount++;\n\t\tconst deregisterInFlight = registerInFlightWork(\n\t\t\tthis.deps.getAgentDir(),\n\t\t\t\"lane\",\n\t\t\t`research:${startedRecord.laneId}`,\n\t\t);\n\t\ttry {\n\t\t\tlet spentUsage: Usage | undefined;\n\t\t\tconst workspaceSources = await this.deps.collectWorkspaceSources({\n\t\t\t\tquery: `${demand.context}\\n${demand.query}`,\n\t\t\t\tcwd: this.deps.getCwd(),\n\t\t\t\tmaxSources: settings.maxSources,\n\t\t\t});\n\t\t\tconst maxUsd = clampLaneMaxUsd(settings.maxUsd, this.deps.getCapabilityEnvelope()?.maxEstimatedUsd);\n\t\t\tconst toolSurface = createLaneToolSurface({\n\t\t\t\tcwd: this.deps.getCwd(),\n\t\t\t\tprofile: laneProfile,\n\t\t\t\tdeniedPaths: getPrivateLaneDeniedPaths(this.deps.getCwd(), this.deps.getAgentDir()),\n\t\t\t});\n\t\t\tthis.warnUnboundToolGrants(laneProfile, toolSurface);\n\t\t\tconst result = await runResearch({\n\t\t\t\tquery: demand.query,\n\t\t\t\tcontext: demand.context,\n\t\t\t\tsources: workspaceSources,\n\t\t\t\tenvelope: this.buildEnvelope(maxUsd, laneProfile, toolSurface),\n\t\t\t\tmaxUsd,\n\t\t\t\tmaxSources: settings.maxSources,\n\t\t\t\tmaxFindings: settings.maxFindings,\n\t\t\t\tmaxWallClockMs: settings.maxWallClockMs,\n\t\t\t\tsignal: this.abortController.signal,\n\t\t\t\tcomplete: async ({ systemPrompt, userPrompt, signal }) => {\n\t\t\t\t\tconst completion = await this.deps.runIsolatedCompletion({\n\t\t\t\t\t\tsystemPrompt: composeSubagentSystemPrompt({\n\t\t\t\t\t\t\tsoul: laneProfile?.soul,\n\t\t\t\t\t\t\trolePrompt: systemPrompt,\n\t\t\t\t\t\t\toverride: settings.systemPrompt,\n\t\t\t\t\t\t}),\n\t\t\t\t\t\tmessages: [{ role: \"user\", content: [{ type: \"text\", text: userPrompt }], timestamp: Date.now() }],\n\t\t\t\t\t\tmodel,\n\t\t\t\t\t\tthinkingLevel: resolveModelThinkingLevel(model, laneProfile?.thinking),\n\t\t\t\t\t\tmaxTokens: laneCapability.laneMaxOutputTokens,\n\t\t\t\t\t\ttools: toolSurface.tools,\n\t\t\t\t\t\tmaxTurns: 6,\n\t\t\t\t\t\tbeforeToolCall: toolSurface.beforeToolCall,\n\t\t\t\t\t\tsignal,\n\t\t\t\t\t\tcacheRetention: \"short\",\n\t\t\t\t\t\tlaneKind: \"research\",\n\t\t\t\t\t});\n\t\t\t\t\tspentUsage = completion.usage;\n\t\t\t\t\treturn {\n\t\t\t\t\t\ttext: completion.text,\n\t\t\t\t\t\tcostUsd: completion.usage.cost.total,\n\t\t\t\t\t\tstopReason: String(completion.stopReason),\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t});\n\n\t\t\tif (this.deps.isDisposed()) {\n\t\t\t\tconst record = this.lanes.complete(startedRecord.laneId, {\n\t\t\t\t\tstatus: \"canceled\",\n\t\t\t\t\treasonCode: \"session_disposed\",\n\t\t\t\t});\n\t\t\t\treturn { started: true, record, result };\n\t\t\t}\n\n\t\t\tlet evidenceEntryId: string | undefined;\n\t\t\tif (result.bundle) evidenceEntryId = this.deps.saveEvidenceBundleSnapshot(result.bundle);\n\t\t\tif (spentUsage && (spentUsage.cost.total > 0 || spentUsage.totalTokens > 0)) {\n\t\t\t\tthis.deps.addSpawnedUsage(spentUsage, {\n\t\t\t\t\tlabel: \"research-lane\",\n\t\t\t\t\treportId: `research:${this.deps.getSessionId()}:${startedRecord.laneId}`,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tconst record = this.lanes.complete(startedRecord.laneId, {\n\t\t\t\tstatus: result.status,\n\t\t\t\treasonCode: result.reasonCode,\n\t\t\t\tcostUsd: result.costUsd,\n\t\t\t\tevidenceEntryId,\n\t\t\t});\n\t\t\tif (record) {\n\t\t\t\tappendLaneRecordSnapshot(this.deps.getSessionManager(), record);\n\t\t\t\tthis.emitTerminalTelemetry(record);\n\t\t\t}\n\t\t\treturn { started: true, record, result };\n\t\t} catch (error) {\n\t\t\tconst record = this.lanes.complete(startedRecord.laneId, {\n\t\t\t\tstatus: \"failed\",\n\t\t\t\treasonCode: \"research_lane_error\",\n\t\t\t});\n\t\t\tif (record && !this.deps.isDisposed()) {\n\t\t\t\tappendLaneRecordSnapshot(this.deps.getSessionManager(), record);\n\t\t\t\tthis.emitTerminalTelemetry(record);\n\t\t\t}\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\tthis.deps.emit({ type: \"warning\", message: `Research lane failed: ${message}` });\n\t\t\treturn { started: true, record };\n\t\t} finally {\n\t\t\tthis._isRunning = false;\n\t\t\tderegisterInFlight();\n\t\t}\n\t}\n\n\tprivate buildDemand(): { query: string; context: string; goalId: string } | undefined {\n\t\tconst goal = this.deps.getGoalStateSnapshot();\n\t\tif (!goal || goal.status !== \"active\") {\n\t\t\tthis._lastSkipReason = \"no_active_goal\";\n\t\t\treturn undefined;\n\t\t}\n\t\tconst open = goal.requirements.filter((requirement) => requirement.status === \"open\");\n\t\tif (open.length === 0) {\n\t\t\tthis._lastSkipReason = \"no_open_requirements\";\n\t\t\treturn undefined;\n\t\t}\n\t\tconst query = `goal:${goal.goalId} requirements:${open\n\t\t\t.map((requirement) => requirement.id)\n\t\t\t.sort()\n\t\t\t.join(\",\")}`;\n\t\tif (this.deps.getEvidenceBundleSnapshot()?.query === query) {\n\t\t\tthis._lastSkipReason = \"recent_evidence_sufficient\";\n\t\t\treturn undefined;\n\t\t}\n\t\tconst context = [\n\t\t\t`Goal: ${goal.userGoal}`,\n\t\t\t\"Open requirements:\",\n\t\t\t...open.slice(0, 20).map((requirement) => `- ${requirement.text}`),\n\t\t].join(\"\\n\");\n\t\treturn { query, context, goalId: goal.goalId };\n\t}\n\n\tprivate async runScheduled(): Promise<void> {\n\t\tif (this._isRunning || this.deps.isDisposed()) return;\n\t\tconst research = this.deps.getSettingsManager().getResearchLaneSettings();\n\t\tconst { mode } = this.deps.getSettingsManager().getAutonomySettings();\n\t\tif (!research.enabled || mode === \"off\") return;\n\t\ttry {\n\t\t\tawait this.runOnce();\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\tthis.deps.emit({ type: \"warning\", message: `Research lane failed: ${message}` });\n\t\t}\n\t}\n\n\tprivate buildEnvelope(\n\t\tmaxUsd: number,\n\t\tlaneProfile: NormalizedProfile | undefined,\n\t\tsurface: LaneToolSurface,\n\t): CapabilityEnvelope {\n\t\treturn {\n\t\t\tid: `research-${this.deps.getSessionId()}-${Date.now()}`,\n\t\t\tprofileId: laneProfile?.name,\n\t\t\tcapabilities: [\"research.execute\", \"filesystem.read\", \"memory.query\"],\n\t\t\tallowedTools: [...surface.allowedTools],\n\t\t\tdeniedTools: [...surface.deniedTools],\n\t\t\tallowedPaths: [this.deps.getCwd()],\n\t\t\tdeniedPaths: getPrivateLaneDeniedPaths(this.deps.getCwd(), this.deps.getAgentDir()),\n\t\t\tmaxEstimatedUsd: clampLaneMaxUsd(maxUsd, this.deps.getCapabilityEnvelope()?.maxEstimatedUsd),\n\t\t\tcreatedAt: new Date().toISOString(),\n\t\t};\n\t}\n\n\tprivate warnUnboundToolGrants(laneProfile: NormalizedProfile | undefined, surface: LaneToolSurface): void {\n\t\tif (!laneProfile || surface.unboundAllowPatterns.length === 0) return;\n\t\tconst warningKey = `${laneProfile.name}\\0${[...surface.unboundAllowPatterns].sort().join(\"\\0\")}`;\n\t\tif (this.warnedUnboundToolGrants.has(warningKey)) return;\n\t\tthis.warnedUnboundToolGrants.add(warningKey);\n\t\tthis.deps.emit({\n\t\t\ttype: \"warning\",\n\t\t\tmessage: `Lane profile '${laneProfile.name}' grants unavailable isolated-lane tools: ${surface.unboundAllowPatterns.join(\", \")}. Only classified lane tools can execute.`,\n\t\t});\n\t}\n\n\tprivate emitTerminalTelemetry(record: ReturnType<LaneTracker[\"complete\"]> & {}): void {\n\t\tthis.deps.emitAutonomyTelemetry({\n\t\t\ttype: AUTONOMY_TELEMETRY_EVENT_TYPES.evidenceBundle,\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tpayload: {\n\t\t\t\tlaneId: record.laneId,\n\t\t\t\tlaneType: record.type,\n\t\t\t\tstatus: record.status,\n\t\t\t\treasonCode: record.reasonCode ?? null,\n\t\t\t\tcostUsd: record.costUsd ?? null,\n\t\t\t\thasEvidence: record.evidenceEntryId !== undefined,\n\t\t\t},\n\t\t});\n\t}\n}\n"]}

package/dist/core/research/session-evidence-bundle.d.ts

@@ -1,10 +1,8 @@
 import type { SessionEntry, SessionManager } from "@caupulican/pi-agent-core/node";
 import type { EvidenceBundle } from "../autonomy/contracts.ts";
+import { type SessionSnapshotPayload } from "../session-snapshot.ts";
 export declare const EVIDENCE_BUNDLE_CUSTOM_TYPE = "evidence_bundle";
-export interface EvidenceBundleSnapshotPayload {
-    version: 1;
-    bundle: EvidenceBundle;
-}
+export type EvidenceBundleSnapshotPayload = SessionSnapshotPayload<"bundle", EvidenceBundle>;
 export declare function appendEvidenceBundleSnapshot(sessionManager: Pick<SessionManager, "appendCustomEntry">, bundle: EvidenceBundle): string;
 export declare function getEvidenceBundleSnapshots(entries: readonly SessionEntry[]): EvidenceBundle[];
 export declare function getLatestEvidenceBundleSnapshot(entries: readonly SessionEntry[]): EvidenceBundle | undefined;

package/dist/core/research/session-evidence-bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-evidence-bundle.d.ts","sourceRoot":"","sources":["../../../src/core/research/session-evidence-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,eAAO,MAAM,2BAA2B,oBAAoB,CAAC;AAE7D,MAAM,WAAW,6BAA6B;IAC7C,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;CACvB;AAED,wBAAgB,4BAA4B,CAC3C,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,mBAAmB,CAAC,EACzD,MAAM,EAAE,cAAc,GACpB,MAAM,CAMR;AAQD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,cAAc,EAAE,CAmB7F;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,cAAc,GAAG,SAAS,CAe5G","sourcesContent":["import type { SessionEntry, SessionManager } from \"@caupulican/pi-agent-core/node\";\nimport type { EvidenceBundle } from \"../autonomy/contracts.ts\";\nimport { cloneEvidenceBundleForStorage, isEvidenceBundle } from \"./evidence-bundle.ts\";\n\nexport const EVIDENCE_BUNDLE_CUSTOM_TYPE = \"evidence_bundle\";\n\nexport interface EvidenceBundleSnapshotPayload {\n\tversion: 1;\n\tbundle: EvidenceBundle;\n}\n\nexport function appendEvidenceBundleSnapshot(\n\tsessionManager: Pick<SessionManager, \"appendCustomEntry\">,\n\tbundle: EvidenceBundle,\n): string {\n\tconst payload: EvidenceBundleSnapshotPayload = {\n\t\tversion: 1,\n\t\tbundle: cloneEvidenceBundleForStorage(bundle),\n\t};\n\treturn sessionManager.appendCustomEntry(EVIDENCE_BUNDLE_CUSTOM_TYPE, payload);\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n\tconst prototype = Object.getPrototypeOf(value);\n\treturn prototype === Object.prototype || prototype === null;\n}\n\nexport function getEvidenceBundleSnapshots(entries: readonly SessionEntry[]): EvidenceBundle[] {\n\tconst bundles: EvidenceBundle[] = [];\n\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"custom\" || entry.customType !== EVIDENCE_BUNDLE_CUSTOM_TYPE) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst payload = entry.data;\n\t\tif (!isPlainRecord(payload)) continue;\n\t\tif (payload.version !== 1) continue;\n\t\tif (!(\"bundle\" in payload)) continue;\n\t\tconst bundle = payload.bundle;\n\t\tif (isEvidenceBundle(bundle)) {\n\t\t\tbundles.push(cloneEvidenceBundleForStorage(bundle));\n\t\t}\n\t}\n\n\treturn bundles;\n}\n\nexport function getLatestEvidenceBundleSnapshot(entries: readonly SessionEntry[]): EvidenceBundle | undefined {\n\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\tconst entry = entries[i];\n\t\tif (entry.type === \"custom\" && entry.customType === EVIDENCE_BUNDLE_CUSTOM_TYPE) {\n\t\t\tconst payload = entry.data;\n\t\t\tif (!isPlainRecord(payload)) continue;\n\t\t\tif (payload.version !== 1) continue;\n\t\t\tif (!(\"bundle\" in payload)) continue;\n\t\t\tconst bundle = payload.bundle;\n\t\t\tif (isEvidenceBundle(bundle)) {\n\t\t\t\treturn cloneEvidenceBundleForStorage(bundle);\n\t\t\t}\n\t\t}\n\t}\n\treturn undefined;\n}\n"]}
+{"version":3,"file":"session-evidence-bundle.d.ts","sourceRoot":"","sources":["../../../src/core/research/session-evidence-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAKN,KAAK,sBAAsB,EAC3B,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,2BAA2B,oBAAoB,CAAC;AAE7D,MAAM,MAAM,6BAA6B,GAAG,sBAAsB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AAS7F,wBAAgB,4BAA4B,CAC3C,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,mBAAmB,CAAC,EACzD,MAAM,EAAE,cAAc,GACpB,MAAM,CAER;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,cAAc,EAAE,CAE7F;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,cAAc,GAAG,SAAS,CAE5G","sourcesContent":["import type { SessionEntry, SessionManager } from \"@caupulican/pi-agent-core/node\";\nimport type { EvidenceBundle } from \"../autonomy/contracts.ts\";\nimport {\n\tappendSessionSnapshot,\n\tgetLatestSessionSnapshot,\n\tgetSessionSnapshots,\n\ttype SessionSnapshotCodec,\n\ttype SessionSnapshotPayload,\n} from \"../session-snapshot.ts\";\nimport { cloneEvidenceBundleForStorage, isEvidenceBundle } from \"./evidence-bundle.ts\";\n\nexport const EVIDENCE_BUNDLE_CUSTOM_TYPE = \"evidence_bundle\";\n\nexport type EvidenceBundleSnapshotPayload = SessionSnapshotPayload<\"bundle\", EvidenceBundle>;\n\nconst EVIDENCE_BUNDLE_SNAPSHOT_CODEC: SessionSnapshotCodec<EvidenceBundle, \"bundle\"> = {\n\tcustomType: EVIDENCE_BUNDLE_CUSTOM_TYPE,\n\tvalueKey: \"bundle\",\n\tisValue: isEvidenceBundle,\n\tclone: cloneEvidenceBundleForStorage,\n};\n\nexport function appendEvidenceBundleSnapshot(\n\tsessionManager: Pick<SessionManager, \"appendCustomEntry\">,\n\tbundle: EvidenceBundle,\n): string {\n\treturn appendSessionSnapshot(sessionManager, EVIDENCE_BUNDLE_SNAPSHOT_CODEC, bundle);\n}\n\nexport function getEvidenceBundleSnapshots(entries: readonly SessionEntry[]): EvidenceBundle[] {\n\treturn getSessionSnapshots(entries, EVIDENCE_BUNDLE_SNAPSHOT_CODEC);\n}\n\nexport function getLatestEvidenceBundleSnapshot(entries: readonly SessionEntry[]): EvidenceBundle | undefined {\n\treturn getLatestSessionSnapshot(entries, EVIDENCE_BUNDLE_SNAPSHOT_CODEC);\n}\n"]}

package/dist/core/research/session-evidence-bundle.js

@@ -1,55 +1,19 @@
+import { appendSessionSnapshot, getLatestSessionSnapshot, getSessionSnapshots, } from "../session-snapshot.js";
 import { cloneEvidenceBundleForStorage, isEvidenceBundle } from "./evidence-bundle.js";
 export const EVIDENCE_BUNDLE_CUSTOM_TYPE = "evidence_bundle";
+const EVIDENCE_BUNDLE_SNAPSHOT_CODEC = {
+    customType: EVIDENCE_BUNDLE_CUSTOM_TYPE,
+    valueKey: "bundle",
+    isValue: isEvidenceBundle,
+    clone: cloneEvidenceBundleForStorage,
+};
 export function appendEvidenceBundleSnapshot(sessionManager, bundle) {
-    const payload = {
-        version: 1,
-        bundle: cloneEvidenceBundleForStorage(bundle),
-    };
-    return sessionManager.appendCustomEntry(EVIDENCE_BUNDLE_CUSTOM_TYPE, payload);
-}
-function isPlainRecord(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        return false;
-    const prototype = Object.getPrototypeOf(value);
-    return prototype === Object.prototype || prototype === null;
+    return appendSessionSnapshot(sessionManager, EVIDENCE_BUNDLE_SNAPSHOT_CODEC, bundle);
 }
 export function getEvidenceBundleSnapshots(entries) {
-    const bundles = [];
-    for (const entry of entries) {
-        if (entry.type !== "custom" || entry.customType !== EVIDENCE_BUNDLE_CUSTOM_TYPE) {
-            continue;
-        }
-        const payload = entry.data;
-        if (!isPlainRecord(payload))
-            continue;
-        if (payload.version !== 1)
-            continue;
-        if (!("bundle" in payload))
-            continue;
-        const bundle = payload.bundle;
-        if (isEvidenceBundle(bundle)) {
-            bundles.push(cloneEvidenceBundleForStorage(bundle));
-        }
-    }
-    return bundles;
+    return getSessionSnapshots(entries, EVIDENCE_BUNDLE_SNAPSHOT_CODEC);
 }
 export function getLatestEvidenceBundleSnapshot(entries) {
-    for (let i = entries.length - 1; i >= 0; i--) {
-        const entry = entries[i];
-        if (entry.type === "custom" && entry.customType === EVIDENCE_BUNDLE_CUSTOM_TYPE) {
-            const payload = entry.data;
-            if (!isPlainRecord(payload))
-                continue;
-            if (payload.version !== 1)
-                continue;
-            if (!("bundle" in payload))
-                continue;
-            const bundle = payload.bundle;
-            if (isEvidenceBundle(bundle)) {
-                return cloneEvidenceBundleForStorage(bundle);
-            }
-        }
-    }
-    return undefined;
+    return getLatestSessionSnapshot(entries, EVIDENCE_BUNDLE_SNAPSHOT_CODEC);
 }
 //# sourceMappingURL=session-evidence-bundle.js.map

package/dist/core/research/session-evidence-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-evidence-bundle.js","sourceRoot":"","sources":["../../../src/core/research/session-evidence-bundle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEvF,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;AAO7D,MAAM,UAAU,4BAA4B,CAC3C,cAAyD,EACzD,MAAsB,EACb;IACT,MAAM,OAAO,GAAkC;QAC9C,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,6BAA6B,CAAC,MAAM,CAAC;KAC7C,CAAC;IACF,OAAO,cAAc,CAAC,iBAAiB,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;AAAA,CAC9E;AAED,SAAS,aAAa,CAAC,KAAc,EAAoC;IACxE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAAA,CAC5D;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAgC,EAAoB;IAC9F,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,2BAA2B,EAAE,CAAC;YACjF,SAAS;QACV,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC;YAAE,SAAS;QACpC,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC;YAAE,SAAS;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,MAAM,CAAC,CAAC,CAAC;QACrD,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAAA,CACf;AAED,MAAM,UAAU,+BAA+B,CAAC,OAAgC,EAA8B;IAC7G,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,2BAA2B,EAAE,CAAC;YACjF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;YAC3B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;gBAAE,SAAS;YACtC,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC;gBAAE,SAAS;YACpC,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC;gBAAE,SAAS;YACrC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,OAAO,6BAA6B,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CACjB","sourcesContent":["import type { SessionEntry, SessionManager } from \"@caupulican/pi-agent-core/node\";\nimport type { EvidenceBundle } from \"../autonomy/contracts.ts\";\nimport { cloneEvidenceBundleForStorage, isEvidenceBundle } from \"./evidence-bundle.ts\";\n\nexport const EVIDENCE_BUNDLE_CUSTOM_TYPE = \"evidence_bundle\";\n\nexport interface EvidenceBundleSnapshotPayload {\n\tversion: 1;\n\tbundle: EvidenceBundle;\n}\n\nexport function appendEvidenceBundleSnapshot(\n\tsessionManager: Pick<SessionManager, \"appendCustomEntry\">,\n\tbundle: EvidenceBundle,\n): string {\n\tconst payload: EvidenceBundleSnapshotPayload = {\n\t\tversion: 1,\n\t\tbundle: cloneEvidenceBundleForStorage(bundle),\n\t};\n\treturn sessionManager.appendCustomEntry(EVIDENCE_BUNDLE_CUSTOM_TYPE, payload);\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n\tconst prototype = Object.getPrototypeOf(value);\n\treturn prototype === Object.prototype || prototype === null;\n}\n\nexport function getEvidenceBundleSnapshots(entries: readonly SessionEntry[]): EvidenceBundle[] {\n\tconst bundles: EvidenceBundle[] = [];\n\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"custom\" || entry.customType !== EVIDENCE_BUNDLE_CUSTOM_TYPE) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst payload = entry.data;\n\t\tif (!isPlainRecord(payload)) continue;\n\t\tif (payload.version !== 1) continue;\n\t\tif (!(\"bundle\" in payload)) continue;\n\t\tconst bundle = payload.bundle;\n\t\tif (isEvidenceBundle(bundle)) {\n\t\t\tbundles.push(cloneEvidenceBundleForStorage(bundle));\n\t\t}\n\t}\n\n\treturn bundles;\n}\n\nexport function getLatestEvidenceBundleSnapshot(entries: readonly SessionEntry[]): EvidenceBundle | undefined {\n\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\tconst entry = entries[i];\n\t\tif (entry.type === \"custom\" && entry.customType === EVIDENCE_BUNDLE_CUSTOM_TYPE) {\n\t\t\tconst payload = entry.data;\n\t\t\tif (!isPlainRecord(payload)) continue;\n\t\t\tif (payload.version !== 1) continue;\n\t\t\tif (!(\"bundle\" in payload)) continue;\n\t\t\tconst bundle = payload.bundle;\n\t\t\tif (isEvidenceBundle(bundle)) {\n\t\t\t\treturn cloneEvidenceBundleForStorage(bundle);\n\t\t\t}\n\t\t}\n\t}\n\treturn undefined;\n}\n"]}
+{"version":3,"file":"session-evidence-bundle.js","sourceRoot":"","sources":["../../../src/core/research/session-evidence-bundle.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,GAGnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,6BAA6B,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEvF,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;AAI7D,MAAM,8BAA8B,GAAmD;IACtF,UAAU,EAAE,2BAA2B;IACvC,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,gBAAgB;IACzB,KAAK,EAAE,6BAA6B;CACpC,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAC3C,cAAyD,EACzD,MAAsB,EACb;IACT,OAAO,qBAAqB,CAAC,cAAc,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAAC;AAAA,CACrF;AAED,MAAM,UAAU,0BAA0B,CAAC,OAAgC,EAAoB;IAC9F,OAAO,mBAAmB,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;AAAA,CACpE;AAED,MAAM,UAAU,+BAA+B,CAAC,OAAgC,EAA8B;IAC7G,OAAO,wBAAwB,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;AAAA,CACzE","sourcesContent":["import type { SessionEntry, SessionManager } from \"@caupulican/pi-agent-core/node\";\nimport type { EvidenceBundle } from \"../autonomy/contracts.ts\";\nimport {\n\tappendSessionSnapshot,\n\tgetLatestSessionSnapshot,\n\tgetSessionSnapshots,\n\ttype SessionSnapshotCodec,\n\ttype SessionSnapshotPayload,\n} from \"../session-snapshot.ts\";\nimport { cloneEvidenceBundleForStorage, isEvidenceBundle } from \"./evidence-bundle.ts\";\n\nexport const EVIDENCE_BUNDLE_CUSTOM_TYPE = \"evidence_bundle\";\n\nexport type EvidenceBundleSnapshotPayload = SessionSnapshotPayload<\"bundle\", EvidenceBundle>;\n\nconst EVIDENCE_BUNDLE_SNAPSHOT_CODEC: SessionSnapshotCodec<EvidenceBundle, \"bundle\"> = {\n\tcustomType: EVIDENCE_BUNDLE_CUSTOM_TYPE,\n\tvalueKey: \"bundle\",\n\tisValue: isEvidenceBundle,\n\tclone: cloneEvidenceBundleForStorage,\n};\n\nexport function appendEvidenceBundleSnapshot(\n\tsessionManager: Pick<SessionManager, \"appendCustomEntry\">,\n\tbundle: EvidenceBundle,\n): string {\n\treturn appendSessionSnapshot(sessionManager, EVIDENCE_BUNDLE_SNAPSHOT_CODEC, bundle);\n}\n\nexport function getEvidenceBundleSnapshots(entries: readonly SessionEntry[]): EvidenceBundle[] {\n\treturn getSessionSnapshots(entries, EVIDENCE_BUNDLE_SNAPSHOT_CODEC);\n}\n\nexport function getLatestEvidenceBundleSnapshot(entries: readonly SessionEntry[]): EvidenceBundle | undefined {\n\treturn getLatestSessionSnapshot(entries, EVIDENCE_BUNDLE_SNAPSHOT_CODEC);\n}\n"]}