@orion-agents/orion-code 0.1.3 → 0.1.4

package/dist/runtime/subagents/research-quality.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Research quality, cost, and recovery hardening (v0.1.4, P1-R6).
+ *
+ * - Source ranking is EXPLAINABLE ONLY: it returns an ordering plus a list of
+ *   human-readable reasons (freshness / provider / scope match / dedup). It is
+ *   never a verdict on truth - a higher rank does not mean a source is correct.
+ * - Cost diagnostics summarize model/tool/time/source usage for `npm run cost`
+ *   reconciliation.
+ * - Recovery hints turn a structured failure reason into an actionable suggestion,
+ *   without ever suggesting a generic MCP or a write path.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rankSources = rankSources;
+exports.researchCostSummary = researchCostSummary;
+exports.recoveryHint = recoveryHint;
+function daysSince(iso, now) {
+    const t = new Date(iso).getTime();
+    if (Number.isNaN(t))
+        return 999;
+    return Math.max(0, Math.floor((now.getTime() - t) / 86400000));
+}
+function hostOf(url) {
+    if (!url)
+        return null;
+    try {
+        const h = new URL(url).hostname.toLowerCase();
+        return h.startsWith('[') && h.endsWith(']') ? h.slice(1, -1) : h;
+    }
+    catch {
+        return null;
+    }
+}
+function matchesDomain(host, domains = []) {
+    if (!host || domains.length === 0)
+        return false;
+    return domains.some(d => host === d.toLowerCase() || host.endsWith('.' + d.toLowerCase()));
+}
+/**
+ * Rank sources by explainable signals. Stale revisions are demoted. The returned
+ * `reasons` explain every contribution; the score is advisory, not truth.
+ */
+function rankSources(sources, opts = {}) {
+    const now = opts.now ?? new Date();
+    const ranked = sources.map(src => {
+        const reasons = [];
+        let score = 0;
+        const age = daysSince(src.retrievedAt, now);
+        score += Math.max(0, 30 - age); // fresher is better, capped
+        if (age <= 7)
+            reasons.push(`fresh (retrieved ${age}d ago)`);
+        else
+            reasons.push(`older (retrieved ${age}d ago)`);
+        if (src.status === 'stale') {
+            score -= 50;
+            reasons.push('stale revision (demoted)');
+        }
+        else if (src.status === 'blocked' || src.status === 'failed') {
+            score -= 40;
+            reasons.push(`unavailable (${src.status})`);
+        }
+        else {
+            reasons.push('available');
+        }
+        const idx = opts.preferredProviders?.indexOf(src.provider) ?? -1;
+        if (idx >= 0) {
+            score += 10 - idx;
+            reasons.push(`preferred provider (${src.provider})`);
+        }
+        else {
+            reasons.push(`provider ${src.provider}`);
+        }
+        const host = hostOf(src.canonicalUrl);
+        if (matchesDomain(host, opts.scope?.domains)) {
+            score += 15;
+            reasons.push('matches scope domain');
+        }
+        return { sourceId: src.id, score, reasons };
+    });
+    ranked.sort((a, b) => b.score - a.score || a.sourceId.localeCompare(b.sourceId));
+    return ranked.map((r, i) => ({ ...r, rank: i + 1 }));
+}
+/** Summarize research cost from the packet usage + source counts. */
+function researchCostSummary(packet, opts = {}) {
+    const notes = [];
+    const retrieved = packet.sources.filter(s => s.status === 'retrieved').length;
+    if (packet.sources.length > packet.request.maxSources) {
+        notes.push(`source count exceeded request budget (${packet.sources.length} > ${packet.request.maxSources})`);
+    }
+    if (opts.fetchedBytes !== undefined && packet.request.maxFetchBytes > 0 && opts.fetchedBytes > packet.request.maxFetchBytes) {
+        notes.push(`fetched bytes exceeded budget (${opts.fetchedBytes} > ${packet.request.maxFetchBytes})`);
+    }
+    return {
+        modelRequests: packet.usage.modelRequests,
+        toolCalls: packet.usage.toolCalls,
+        durationMs: packet.usage.durationMs,
+        sourceCount: packet.sources.length,
+        retrievedCount: retrieved,
+        notes,
+    };
+}
+/**
+ * Turn a structured failure reason into an actionable recovery hint. Never
+ * suggests a generic MCP or a write/exec path.
+ */
+function recoveryHint(reason) {
+    const r = (reason ?? '').toLowerCase();
+    if (r.includes('ssrf') || r.includes('blocked') || r.includes('internal')) {
+        return 'Blocked by security policy (SSRF/internal host). Use an allowlisted public URL.';
+    }
+    if (r.includes('dns')) {
+        return 'DNS resolution failed. Check network/allowlist; the guard runs on every redirect hop.';
+    }
+    if (r.includes('timeout') || r.includes('timed') || r.includes('too many redirect')) {
+        return 'Request timed out or redirected too often. Increase maxDurationMs or reduce sources.';
+    }
+    if (r.includes('too large') || r.includes('content-length') || r.includes('bytes')) {
+        return 'Response exceeded size budget. Increase maxFetchBytes or fetch a narrower excerpt.';
+    }
+    if (r.includes('provider') || r.includes('websearch') || r.includes('unavailable')) {
+        return 'Search provider unavailable. Configure an allowlisted provider (WebSearch/WebFetch only; no generic MCP).';
+    }
+    return 'Review the failure reason and retry within the request budget (sources/ bytes/ duration).';
+}
+//# sourceMappingURL=research-quality.js.map

package/dist/runtime/subagents/research-quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-quality.js","sourceRoot":"","sources":["../../../src/runtime/subagents/research-quality.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AA2CH,kCAwCC;AAYD,kDAoBC;AAMD,oCAkBC;AAhID,SAAS,SAAS,CAAC,GAAW,EAAE,GAAS;IACvC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAClC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IAChC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,GAAG,QAAU,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,MAAM,CAAC,GAAY;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC9C,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAmB,EAAE,UAAoB,EAAE;IAChE,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAC7F,CAAC;AASD;;;GAGG;AACH,SAAgB,WAAW,CAAC,OAAyB,EAAE,OAAoB,EAAE;IAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC5C,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,4BAA4B;QAC5D,IAAI,GAAG,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC,CAAC;;YACvD,OAAO,CAAC,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC,CAAC;QAEnD,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC3B,KAAK,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/D,KAAK,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,KAAK,IAAI,EAAE,GAAG,GAAG,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACtC,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;YAC7C,KAAK,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAWD,qEAAqE;AACrE,SAAgB,mBAAmB,CACjC,MAAsB,EACtB,OAAkC,EAAE;IAEpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IAC9E,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,yCAAyC,MAAM,CAAC,OAAO,CAAC,MAAM,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,CAAC;IAC/G,CAAC;IACD,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,GAAG,CAAC,IAAI,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC5H,KAAK,CAAC,IAAI,CAAC,kCAAkC,IAAI,CAAC,YAAY,MAAM,MAAM,CAAC,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC;IACvG,CAAC;IACD,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,aAAa;QACzC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;QACjC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;QACnC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;QAClC,cAAc,EAAE,SAAS;QACzB,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,MAA0B;IACrD,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1E,OAAO,iFAAiF,CAAC;IAC3F,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,uFAAuF,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACpF,OAAO,sFAAsF,CAAC;IAChG,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnF,OAAO,oFAAoF,CAAC;IAC9F,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACnF,OAAO,2GAA2G,CAAC;IACrH,CAAC;IACD,OAAO,2FAA2F,CAAC;AACrG,CAAC"}

package/dist/runtime/subagents/research-renderer.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Research view-model + renderer parity (v0.1.4, P1-R4).
+ *
+ * A single `ResearchView` is computed once from a packet + citation resolution.
+ * Every presentation surface (TUI, terminal-ui, Print, JSON) projects THAT view,
+ * so the event order / status / conclusion are guaranteed consistent across
+ * renderers. The TUI shows the human-priority fields (stage, source counts,
+ * failures, citations, risks); terminal-ui keeps the technical diagnostics
+ * (provider, content hash, per-source status); Print/JSON emit the stable schema
+ * rather than concatenated claim text.
+ *
+ * Also emits a `ResearchLifecycleEvent` stream that the unified agent runtime can
+ * forward to TUI / terminal-ui / Print / JSON without each surface re-deriving it.
+ */
+import type { ResearchMode, ResearchPacket, Verification } from './research-types';
+import type { CitationResolution } from './research-citation';
+export type ResearchStage = 'completed' | 'partial' | 'failed';
+export interface ResearchView {
+    schemaVersion: number;
+    packetId: string;
+    objective: string;
+    mode: ResearchMode;
+    stage: ResearchStage;
+    sourceCount: number;
+    retrievedCount: number;
+    partialCount: number;
+    failedCount: number;
+    blockedCount: number;
+    staleCount: number;
+    citationCount: number;
+    conflictCount: number;
+    evidenceCandidateCount: number;
+    riskCount: number;
+    auditStatus: 'met' | 'partial' | 'unmet';
+    conclusion: string;
+    claims: Array<{
+        id: string;
+        verification: Verification;
+        bindingStatus: string;
+    }>;
+    sources: Array<{
+        id: string;
+        kind: string;
+        provider: string;
+        status: string;
+        canonicalUrl?: string;
+        contentHash?: string;
+    }>;
+}
+export type ResearchRenderMode = 'tui' | 'terminal' | 'print' | 'json';
+/** Compute the canonical view once; all renderers project this. */
+export declare function buildResearchView(packet: ResearchPacket, resolution: CitationResolution): ResearchView;
+/** Render the same view in the requested mode. All modes share one conclusion. */
+export declare function renderResearch(view: ResearchView, mode: ResearchRenderMode): string;
+/** Lifecycle events the unified agent runtime can forward to any surface. */
+export type ResearchLifecycleEvent = {
+    type: 'research_started';
+    packetId: string;
+    objective: string;
+    mode: ResearchMode;
+} | {
+    type: 'research_source';
+    packetId: string;
+    sourceId: string;
+    status: string;
+    provider: string;
+} | {
+    type: 'research_conflict';
+    packetId: string;
+    claimId: string;
+} | {
+    type: 'research_completed';
+    packetId: string;
+    stage: ResearchStage;
+    auditStatus: string;
+    conclusion: string;
+};
+export declare function toLifecycleEvents(view: ResearchView, resolution?: CitationResolution): ResearchLifecycleEvent[];
+//# sourceMappingURL=research-renderer.d.ts.map

package/dist/runtime/subagents/research-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-renderer.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/research-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,YAAY,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAEvE,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,GAAG,YAAY,CAiDtG;AAmBD,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAWnF;AA2CD,6EAA6E;AAC7E,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACrF;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjG;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,kBAAkB,GAAG,sBAAsB,EAAE,CAoB/G"}

package/dist/runtime/subagents/research-renderer.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Research view-model + renderer parity (v0.1.4, P1-R4).
+ *
+ * A single `ResearchView` is computed once from a packet + citation resolution.
+ * Every presentation surface (TUI, terminal-ui, Print, JSON) projects THAT view,
+ * so the event order / status / conclusion are guaranteed consistent across
+ * renderers. The TUI shows the human-priority fields (stage, source counts,
+ * failures, citations, risks); terminal-ui keeps the technical diagnostics
+ * (provider, content hash, per-source status); Print/JSON emit the stable schema
+ * rather than concatenated claim text.
+ *
+ * Also emits a `ResearchLifecycleEvent` stream that the unified agent runtime can
+ * forward to TUI / terminal-ui / Print / JSON without each surface re-deriving it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildResearchView = buildResearchView;
+exports.renderResearch = renderResearch;
+exports.toLifecycleEvents = toLifecycleEvents;
+/** Compute the canonical view once; all renderers project this. */
+function buildResearchView(packet, resolution) {
+    const sources = packet.sources;
+    const retrieved = sources.filter(s => s.status === 'retrieved').length;
+    const partial = sources.filter(s => s.status === 'partial').length;
+    const failed = sources.filter(s => s.status === 'failed').length;
+    const blocked = sources.filter(s => s.status === 'blocked').length;
+    const stale = sources.filter(s => s.status === 'stale').length;
+    const stage = resolution.audit.status === 'met'
+        ? 'completed'
+        : packet.risks.length > 0 || failed + blocked > 0
+            ? 'partial'
+            : 'completed';
+    const conclusion = buildConclusion(packet, resolution, { retrieved, failed, blocked });
+    return {
+        schemaVersion: packet.schemaVersion,
+        packetId: packet.packetId,
+        objective: packet.request.objective,
+        mode: packet.request.mode,
+        stage,
+        sourceCount: sources.length,
+        retrievedCount: retrieved,
+        partialCount: partial,
+        failedCount: failed,
+        blockedCount: blocked,
+        staleCount: stale,
+        citationCount: resolution.bindings.filter(b => b.status === 'bound').length,
+        conflictCount: resolution.conflicts.length,
+        evidenceCandidateCount: resolution.evidenceCandidates.length,
+        riskCount: packet.risks.length,
+        auditStatus: resolution.audit.status,
+        conclusion,
+        claims: packet.claims.map(c => ({
+            id: c.id,
+            verification: c.verification,
+            bindingStatus: resolution.bindings.find(b => b.claimId === c.id)?.status ?? 'dangling',
+        })),
+        sources: sources.map(s => ({
+            id: s.id,
+            kind: s.kind,
+            provider: s.provider,
+            status: s.status,
+            ...(s.canonicalUrl ? { canonicalUrl: s.canonicalUrl } : {}),
+            ...(s.contentHash ? { contentHash: s.contentHash } : {}),
+        })),
+    };
+}
+function buildConclusion(packet, resolution, counts) {
+    const unverified = resolution.audit.unverifiedClaimIds.length;
+    if (resolution.audit.status === 'met') {
+        return `Research complete: ${resolution.evidenceCandidates.length} evidence candidate(s) from ${counts.retrieved} verified source(s).`;
+    }
+    const parts = [];
+    parts.push(`Research ${resolution.audit.status}: ${resolution.evidenceCandidates.length} evidence candidate(s)`);
+    if (counts.failed + counts.blocked > 0)
+        parts.push(`${counts.failed + counts.blocked} source(s) failed/blocked`);
+    if (resolution.conflicts.length > 0)
+        parts.push(`${resolution.conflicts.length} conflict(s)`);
+    if (unverified > 0)
+        parts.push(`${unverified} claim(s) without independent verification`);
+    return parts.join('; ') + '.';
+}
+/** Render the same view in the requested mode. All modes share one conclusion. */
+function renderResearch(view, mode) {
+    switch (mode) {
+        case 'json':
+            return JSON.stringify(view);
+        case 'print':
+            return renderPrint(view);
+        case 'terminal':
+            return renderTerminal(view);
+        case 'tui':
+            return renderTui(view);
+    }
+}
+function renderTui(view) {
+    // Human-priority: stage, source counts, failures, citations, risks.
+    return [
+        `Research ${view.stage.toUpperCase()} (${view.mode})`,
+        `Sources: ${view.retrievedCount} retrieved / ${view.failedCount} failed / ${view.blockedCount} blocked / ${view.staleCount} stale`,
+        `Citations: ${view.citationCount} bound, ${view.conflictCount} conflict(s)`,
+        `Evidence candidates: ${view.evidenceCandidateCount}`,
+        `Risks: ${view.riskCount}`,
+        `Conclusion: ${view.conclusion}`,
+    ].join('\n');
+}
+function renderTerminal(view) {
+    // Technical diagnostics: provider + content hash per source + audit.
+    const srcLines = view.sources
+        .map(s => `  - ${s.id} [${s.status}] provider=${s.provider} kind=${s.kind}${s.contentHash ? ` hash=${s.contentHash.slice(0, 12)}` : ''}`)
+        .join('\n');
+    return [
+        `RESEARCH ${view.packetId} stage=${view.stage} audit=${view.auditStatus}`,
+        `objective: ${view.objective}`,
+        `sources (${view.sourceCount}):`,
+        srcLines,
+        `bindings: ${view.citationCount} bound, ${view.conflictCount} conflict(s)`,
+        `conclusion: ${view.conclusion}`,
+    ].join('\n');
+}
+function renderPrint(view) {
+    // Stable schema text (not raw concatenated claim text).
+    const claims = view.claims.map(c => `  - ${c.id}: ${c.verification} (${c.bindingStatus})`).join('\n');
+    return [
+        `# Research: ${view.objective}`,
+        `Status: ${view.stage} | Audit: ${view.auditStatus}`,
+        `Sources: ${view.sourceCount} (retrieved ${view.retrievedCount}, failed ${view.failedCount}, blocked ${view.blockedCount}, stale ${view.staleCount})`,
+        `Citations: ${view.citationCount} bound, ${view.conflictCount} conflict(s), ${view.evidenceCandidateCount} evidence candidate(s)`,
+        `Claims:`,
+        claims,
+        `Conclusion: ${view.conclusion}`,
+    ].join('\n');
+}
+function toLifecycleEvents(view, resolution) {
+    const events = [
+        { type: 'research_started', packetId: view.packetId, objective: view.objective, mode: view.mode },
+    ];
+    for (const s of view.sources) {
+        events.push({ type: 'research_source', packetId: view.packetId, sourceId: s.id, status: s.status, provider: s.provider });
+    }
+    if (resolution) {
+        for (const c of resolution.conflicts) {
+            events.push({ type: 'research_conflict', packetId: view.packetId, claimId: c.claimId });
+        }
+    }
+    events.push({
+        type: 'research_completed',
+        packetId: view.packetId,
+        stage: view.stage,
+        auditStatus: view.auditStatus,
+        conclusion: view.conclusion,
+    });
+    return events;
+}
+//# sourceMappingURL=research-renderer.js.map

package/dist/runtime/subagents/research-renderer.js.map

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

package/dist/runtime/subagents/research-types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Research-to-Evidence schema (v0.1.4).
+ *
+ * These types describe a safe, traceable, recoverable research loop that turns
+ * a read-only `research` subagent result into a `ResearchPacket` whose claims
+ * are bound to verifiable sources.
+ *
+ * Every packet is versioned. Unknown schema versions fail closed; unknown
+ * fields are ignored but the schema must match. The schema is renderer- and
+ * protocol-agnostic so TUI / terminal-ui / Print-JSON all consume one shape.
+ */
+export declare const RESEARCH_SCHEMA_VERSION: 1;
+export type ResearchMode = 'local' | 'web' | 'mixed';
+export type SourceKind = 'file' | 'search_result' | 'web_page' | 'provider_document';
+export type SourceStatus = 'retrieved' | 'partial' | 'failed' | 'blocked' | 'stale';
+export type EvidenceKind = 'file' | 'external' | 'inference';
+/**
+ * Verification is the boundary between fact and inference.
+ * - `observed`           : traceable to a source that was actually retrieved.
+ * - `partially_observed` : partially traceable (e.g. excerpt but not full content).
+ * - `unverified`         : claim exists but no independent source backs it.
+ * - `contradicted`       : at least one source disputes the claim.
+ */
+export type Verification = 'observed' | 'partially_observed' | 'unverified' | 'contradicted';
+export type Confidence = 'high' | 'medium' | 'low';
+export interface ResearchScope {
+    /** Canonical project root the research is scoped to. */
+    projectRoot: string;
+    /** In-project paths the child is allowed to read. */
+    paths?: string[];
+    /** Allowed external domains (web/mixed only). */
+    domains?: string[];
+    freshness?: 'any' | 'recent' | 'as_of';
+    asOf?: string;
+}
+export interface ResearchRequest {
+    schemaVersion: number;
+    objective: string;
+    scope: ResearchScope;
+    mode: ResearchMode;
+    /** Upper bound on number of sources collected. */
+    maxSources: number;
+    /** Upper bound on bytes fetched from external sources (0 for local-only). */
+    maxFetchBytes: number;
+    /** Hard wall-clock budget for the whole research packet. */
+    maxDurationMs: number;
+    expectedOutput?: string;
+    /** Optional binding to a Goal objective revision. */
+    goalBinding?: {
+        goalId: string;
+        objectiveRevision: number;
+    };
+}
+export interface ResearchSource {
+    id: string;
+    kind: SourceKind;
+    /** Canonical, normalized URL for web/provider sources. */
+    canonicalUrl?: string;
+    /** User-visible URL with secret-bearing query params removed. */
+    displayUrl?: string;
+    /** Project-relative path for file sources (never an absolute user path). */
+    projectPath?: string;
+    title?: string;
+    excerpt?: string;
+    provider: string;
+    retrievedAt: string;
+    /**
+     * Hash over the canonical source content. Proves what was read, NOT that the
+     * content is true. Used for drift detection, not authenticity.
+     */
+    contentHash?: string;
+    status: SourceStatus;
+    failureReason?: string;
+    /** Human-readable descriptions of redactions applied (e.g. "api_key"). */
+    redactions?: string[];
+}
+export interface ResearchClaim {
+    id: string;
+    text: string;
+    /** Bindings into `ResearchPacket.sources`. Must be non-empty for observed claims. */
+    sourceIds: string[];
+    evidenceKind: EvidenceKind;
+    verification: Verification;
+    confidence?: Confidence;
+    /** Ids of claims/sources this claim contradicts. */
+    conflicts?: string[];
+}
+export interface ResearchPacket {
+    schemaVersion: number;
+    packetId: string;
+    projectPath: string;
+    sessionId: string;
+    goalId?: string;
+    objectiveRevision?: number;
+    request: ResearchRequest;
+    summary: string;
+    claims: ResearchClaim[];
+    sources: ResearchSource[];
+    /** Questions the research could not answer. */
+    gaps: string[];
+    risks: string[];
+    usage: import('./types').SubtaskUsage;
+    createdAt: string;
+}
+//# sourceMappingURL=research-types.d.ts.map

package/dist/runtime/subagents/research-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-types.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/research-types.ts"],"names":[],"mappings":"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"}

package/dist/runtime/subagents/research-types.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Research-to-Evidence schema (v0.1.4).
+ *
+ * These types describe a safe, traceable, recoverable research loop that turns
+ * a read-only `research` subagent result into a `ResearchPacket` whose claims
+ * are bound to verifiable sources.
+ *
+ * Every packet is versioned. Unknown schema versions fail closed; unknown
+ * fields are ignored but the schema must match. The schema is renderer- and
+ * protocol-agnostic so TUI / terminal-ui / Print-JSON all consume one shape.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESEARCH_SCHEMA_VERSION = void 0;
+exports.RESEARCH_SCHEMA_VERSION = 1;
+//# sourceMappingURL=research-types.js.map

package/dist/runtime/subagents/research-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-types.js","sourceRoot":"","sources":["../../../src/runtime/subagents/research-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEU,QAAA,uBAAuB,GAAG,CAAU,CAAC"}

package/dist/runtime/subagents/runtime-integration.d.ts

@@ -31,7 +31,7 @@ export interface SubagentTurnInputs {
     /** Lifecycle event sink (runtime event + trace). */
     onSubtaskEvent?: (event: RuntimeSubtaskEvent) => void;
     /** Called once per finished task with its structured result, for artifact persistence. */
-    onSubtaskResult?: (result: import('./types').SubtaskResult, batchId: string) => void;
+    onSubtaskResult?: (result: import('./types').SubtaskResult, batchId: string, objective?: string) => void;
     /**
      * R6: live permission state from the root runtime. Returns true when a
      * permission request is awaiting user decision. When provided, the policy

package/dist/runtime/subagents/runtime-integration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-integration.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/runtime-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,sBAAsB,CAAC;AAIvE,OAAO,EAAE,eAAe,EAA+B,MAAM,cAAc,CAAC;AAI5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAiBhE,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,MAAM,EAAE,cAAc,CAAC;IACvB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,aAAa,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,CAAC,CAAC;IACjF,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oDAAoD;IACpD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACtD,0FAA0F;IAC1F,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrF;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,SAAS,EAAE,YAAY,EACpC,KAAK,EAAE,OAAO,SAAS,EAAE,YAAY,EACrC,UAAU,CAAC,EAAE,MAAM,KAChB,IAAI,CAAC;IACV,qEAAqE;IACrE,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,wBAAwB,CAAC;CAClD;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CA8GjG;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,GAAG,IAAI,CAG1F;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,YAAY,CAAC;IACtC,wDAAwD;IACxD,eAAe,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,GACzB,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,CAAC,CAOnE;AAED,0EAA0E;AAC1E,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"runtime-integration.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/runtime-integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,sBAAsB,CAAC;AAIvE,OAAO,EAAE,eAAe,EAA+B,MAAM,cAAc,CAAC;AAI5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAiBhE,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,MAAM,EAAE,cAAc,CAAC;IACvB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,aAAa,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,CAAC,CAAC;IACjF,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oDAAoD;IACpD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACtD,0FAA0F;IAC1F,eAAe,CAAC,EAAE,CAChB,MAAM,EAAE,OAAO,SAAS,EAAE,aAAa,EACvC,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,KACf,IAAI,CAAC;IACV;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,SAAS,EAAE,YAAY,EACpC,KAAK,EAAE,OAAO,SAAS,EAAE,YAAY,EACrC,UAAU,CAAC,EAAE,MAAM,KAChB,IAAI,CAAC;IACV,qEAAqE;IACrE,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,wBAAwB,CAAC;CAClD;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CA8GjG;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,GAAG,IAAI,CAG1F;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,YAAY,CAAC;IACtC,wDAAwD;IACxD,eAAe,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,GACzB,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,CAAC,CAOnE;AAED,0EAA0E;AAC1E,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/runtime/subagents/runtime-integration.js.map

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

package/dist/runtime/subagents/supervisor.d.ts

@@ -60,7 +60,7 @@ export interface SubagentSupervisorDeps {
     /** Lifecycle event sink (runtime event + trace). */
     onEvent?: (event: RuntimeSubtaskEvent) => void;
     /** Called once per task with its final SubtaskResult (for artifact persistence). */
-    onSubtaskResult?: (result: SubtaskResult, batchId: string) => void;
+    onSubtaskResult?: (result: SubtaskResult, batchId: string, objective?: string) => void;
 }
 export interface RunBatchOutcome {
     result: SubtaskBatchResult;

package/dist/runtime/subagents/supervisor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/supervisor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAA6C,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAElB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAEvB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,oBAAoB,CAAC;IAC7B,YAAY,EAAE,oBAAoB,CAAC;IACnC,yEAAyE;IACzE,YAAY,EAAE,iBAAiB,CAAC;IAChC,sEAAsE;IACtE,OAAO,EAAE,YAAY,CAAC;IACtB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC;IACrC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,SAAS,EAAE,YAAY,EACpC,KAAK,EAAE,OAAO,SAAS,EAAE,YAAY,EACrC,UAAU,CAAC,EAAE,MAAM,KAChB,IAAI,CAAC;IACV,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAChC,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC/C,oFAAoF;IACpF,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAeD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,eAAe,CAAC,CA+G1B"}
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/supervisor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAA6C,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAElB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAEvB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,oBAAoB,CAAC;IAC7B,YAAY,EAAE,oBAAoB,CAAC;IACnC,yEAAyE;IACzE,YAAY,EAAE,iBAAiB,CAAC;IAChC,sEAAsE;IACtE,OAAO,EAAE,YAAY,CAAC;IACtB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC;IACrC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,SAAS,EAAE,YAAY,EACpC,KAAK,EAAE,OAAO,SAAS,EAAE,YAAY,EACrC,UAAU,CAAC,EAAE,MAAM,KAChB,IAAI,CAAC;IACV,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAChC,iDAAiD;IACjD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC/C,oFAAoF;IACpF,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACxF;AAeD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,eAAe,CAAC,CA+G1B"}

package/dist/runtime/subagents/supervisor.js

@@ -251,7 +251,7 @@ function finalizeTask(deps, batchId, taskId, task, result) {
     }
     // Persist the structured result for trace/resume durability - isolated.
     try {
-        deps.onSubtaskResult?.(result, batchId);
+        deps.onSubtaskResult?.(result, batchId, task.objective);
     }
     catch {
         // An artifact/trace sink throwing cannot reject the batch.