@inflexa-ai/harness 0.22.1 → 0.24.0

package/README.md

@@ -36,7 +36,6 @@ import {
     createNoopRunCharge,            // RunCharge        seam
     createNoopUsageRecorder,        // UsageRecorder    seam
     createNoopArtifactRegistry,     // ArtifactRegistry seam
-    UnavailablePreviewPublisher,    // PreviewPublisher seam
     createDbosRunLauncher,          // shared RunLauncher
     createConsoleLogger,            // Logger — writes to console
     createNoopLogger,               // Logger — discards (the fallback when none is wired)
@@ -47,7 +46,7 @@ import {
 } from "@inflexa-ai/harness";
 ```
 
-`assembleCoreRuntime` is the single composition point: it registers the durable workflows and builds the conversation agent over them. The harness declares **six capability seams** an embedder wires — `RunAuthorizer`, `ResolveBilling`, `ArtifactRegistry`, `RunCharge`, `UsageRecorder`, `PreviewPublisher` — plus the **shared `RunLauncher`** (one host-neutral realization, `createDbosRunLauncher`). Local, dependency-free realizations of all six ship from the barrel; an embedder constructs them (or its own) and passes them in. The harness only ever sees the interface.
+`assembleCoreRuntime` is the single composition point: it registers the durable workflows and builds the conversation agent over them. The harness declares **five capability seams** an embedder wires — `RunAuthorizer`, `ResolveBilling`, `ArtifactRegistry`, `RunCharge`, `UsageRecorder` — plus the **shared `RunLauncher`** (one host-neutral realization, `createDbosRunLauncher`). Local, dependency-free realizations of all five ship from the barrel; an embedder constructs them (or its own) and passes them in. The harness only ever sees the interface.
 
 ## Logging
 

package/dist/agents/conversation-agent.d.ts

@@ -35,7 +35,6 @@ import { type BioToolKeys } from "../tools/bio/keys.js";
 import type { EnvironmentStorePaths } from "../config/environment-stores.js";
 import type { RunAuthorizer } from "../execution/run-authorizer.js";
 import type { RunLauncher } from "../execution/run-launcher.js";
-import type { SubmitReportDeps } from "../tools/iterate-report.js";
 import type { Logger } from "../lib/logger.js";
 import type { UsageRecorder } from "../billing/usage-recorder.js";
 import type { CitationResolver } from "../citations/types.js";
@@ -98,16 +97,8 @@ export interface ConversationAgentDeps extends EnvironmentStorePaths {
      * workflows through it so the durability engine stays out of the tools.
      */
     readonly runLauncher: RunLauncher;
-    /**
-     * Preview-publishing seam factory. No tool of the roster reads it. The field
-     * stays, because a change to the deps breaks an embedder at its composition
-     * root.
-     */
-    readonly createPreviewPublisher: SubmitReportDeps["createPreviewPublisher"];
     /** API keys for the external bio/chem data sources. */
     readonly bioKeys: BioToolKeys;
-    /** Root templates dir. No tool of the roster reads it. */
-    readonly templatesDir: string;
     /** Skills root. No tool of the roster reads it. */
     readonly skillsDir: string;
     /** Headless-Chrome config for report snapshot/preview rendering. */

package/dist/app/chat-turn.js

@@ -75,6 +75,7 @@ export async function prepareChatTurn(deps, params) {
         runActivityContext,
         history,
         workingMemory: createWorkingMemory(pool),
+        ...(deps.logger ? { logger: deps.logger } : {}),
     });
     return { kind: "ok", threadType, messages, userMessage };
 }

package/dist/app/message-assembly.d.ts

@@ -35,6 +35,7 @@
  * thread store.
  */
 import type { ModelMessage } from "ai";
+import type { Logger } from "../lib/logger.js";
 import type { LoopMessage } from "../loop/types.js";
 import type { ThreadHistory } from "../memory/thread-history.js";
 import type { ThreadType } from "../memory/thread-store.js";
@@ -64,6 +65,8 @@ export interface AssembleMessagesArgs {
     readonly workingMemory: WorkingMemoryStore;
     /** History-window token budget. Defaults to {@link DEFAULT_HISTORY_TOKEN_BUDGET}. */
     readonly tokenBudget?: number;
+    /** Diagnostic seam for the history repair record; omitted falls back to no-op. */
+    readonly logger?: Logger;
 }
 export interface AssembledMessages {
     /** The full message array for `runAgent`. */

package/dist/app/message-assembly.js

@@ -34,7 +34,9 @@
  * tail injections (ephemeral, re-derived each turn) are never written to the
  * thread store.
  */
+import { createNoopLogger } from "../lib/console-logger.js";
 import { unwrapOrThrow } from "../lib/result.js";
+import { stripUnansweredToolCalls } from "../memory/tool-call-integrity.js";
 import { normalizeUnicode, redactSecrets } from "../input-sanitization.js";
 /**
  * Token budget for the `loadRecent` history window. Sized to leave headroom
@@ -49,6 +51,21 @@ export const DEFAULT_HISTORY_TOKEN_BUDGET = 120_000;
 export async function assembleMessages(args) {
     const budget = args.tokenBudget ?? DEFAULT_HISTORY_TOKEN_BUDGET;
     const history = unwrapOrThrow(await args.history.loadRecent(args.threadId, budget, { keepFirstTurn: args.threadType === "report" }));
+    // Read-side safety net for the wire contract: every tool call carries a
+    // result. The loop upholds it at every exit, but the store outlives any one
+    // writer — a row an older build wrote, or a hand-edited database, can carry
+    // an unanswered call, and the provider boundary then refuses the WHOLE
+    // transcript on every turn: the thread is wedged forever. Stripping the
+    // orphan here degrades one message instead. The warning is the only account
+    // a reader gets that the stored thread and the assembled one differ.
+    const repaired = stripUnansweredToolCalls(history);
+    if (repaired.length > 0) {
+        (args.logger ?? createNoopLogger()).named("assembly").warn("unanswered tool calls stripped from thread history", {
+            threadId: args.threadId,
+            toolCallIds: repaired.map((d) => d.toolCallId),
+            tools: repaired.map((d) => d.toolName),
+        });
+    }
     // Sanitization — applied once, here, to the new user input only.
     const userMessage = {
         role: "user",

package/dist/contracts/chat-parts.d.ts

@@ -331,32 +331,44 @@ export interface RunFailedPart {
     /** Machine-readable failure reason (e.g., "budget_exceeded"). */
     reason?: string;
 }
-export interface PreviewPart {
-    type: "data-report-preview";
-    /** Unique per emission (UUID). */
-    id: string;
-    /** Groups all versions of the same preview. */
-    previewId: string;
-    /** Version number (1, 2, 3, ...). */
-    version: number;
-    /** Report title. */
-    title: string;
-    /** Version-relative path (e.g., "v1/index.html"). */
-    previewPath: string;
-    /** Report format. */
-    format: "html" | "pdf";
+/**
+ * The record that a turn started a child session. It rides the chat stream
+ * live, and it persists into the turn at the position of the spawn.
+ *
+ * The part is a placement record and a freshness signal only. The thread
+ * store is the authority for the session: its existence, its title, and its
+ * archived state. When the thread of the part is archived or absent, a
+ * consumer renders nothing for it.
+ */
+export interface ChildSessionStartedPart {
+    type: "data-child-session-started";
+    /** The id of the child thread that the spawn made. */
+    threadId: string;
+    /** The id of the conversation thread that spawned it. */
+    parentThreadId: string;
+    /**
+     * The type of the child thread, in the thread store's vocabulary.
+     * Known values today: `"report"`.
+     */
+    threadType: string;
 }
-export interface DataPreviewFailedPart {
-    type: "data-report-preview-failed";
-    /** Unique per emission (UUID). */
+/**
+ * The record that a report-session preview rendered the page. It rides the
+ * chat stream live, and it persists into the turn at the position of the
+ * render.
+ *
+ * The part is a placement record and a freshness signal only. The version
+ * store and the session-page mint stay the authority for what is viewable:
+ * the part carries no path, no format, and no URL. A consumer that wants the
+ * page reads those surfaces.
+ */
+export interface ReportRenderedPart {
+    type: "data-report-rendered";
+    /** Unique per emission. */
     id: string;
-    /** Groups all versions of the same preview. */
-    previewId: string;
-    /** Attempted version number that failed. */
-    version: number;
-    /** Human-readable failure reason. */
-    reason: string;
-    /** Optional taxonomy of failure kinds. */
-    errorKind?: "render" | "submit" | "build" | "timeout" | "internal";
+    /** The ISO timestamp of the successful render. */
+    renderedAt: string;
+    /** The title of the rendered document. */
+    title?: string;
 }
-export type CortexChatPart = PresentationPart | PlanPart | RunCardPart | FileReferencePart | AskPart | RunStartedPart | DagStatePart | StepActivityPart | StepFileTreePart | StepOutputPart | StepSummaryPart | StepUsagePart | StepBlockedPart | RunSynthesisPart | SynthesisProgressPart | RunCompletedPart | RunFailedPart | PreviewPart | DataPreviewFailedPart;
+export type CortexChatPart = PresentationPart | PlanPart | RunCardPart | FileReferencePart | AskPart | RunStartedPart | DagStatePart | StepActivityPart | StepFileTreePart | StepOutputPart | StepSummaryPart | StepUsagePart | StepBlockedPart | RunSynthesisPart | SynthesisProgressPart | RunCompletedPart | RunFailedPart | ChildSessionStartedPart | ReportRenderedPart;

package/dist/contracts/content-url.d.ts

@@ -1,60 +1,26 @@
 /**
  * Content URL construction — shared between the frontend and Cortex.
  *
- * The `res` claim formulas and URL shapes are the canonical TypeScript contract
- * for the content-token flow. The storage backend mirrors each formula in Go; both
- * sides are locked by the shared test vectors at
- * `src/__tests__/fixtures/preview-res.json` (previews) and
- * `src/__tests__/fixtures/report-session-res.json` (report-session pages), each a
+ * The `res` claim formula and URL shape are the canonical TypeScript contract
+ * for the content-token flow. The storage backend mirrors the formula in Go; both
+ * sides are locked by the shared test vector at
+ * `src/__tests__/fixtures/report-session-res.json` (report-session pages), a
  * byte-identical copy of the storage backend's `kernel/contenttoken/testdata` file.
  *
- * End-to-end contract (previews):
- *   token res claim : "previews/{analysisId}/{previewId}"
- *   URL             : {contentBaseUrl}/previews/{analysisId}/{previewId}/{previewPath}?t={token}
- *   Caddy predicate : request.path.startsWith("/" + res + "/")
- *
  * End-to-end contract (report-session pages):
  *   token res claim : "report-sessions/{analysisId}/{threadId}"  (token kind "rs")
  *   URL             : {contentBaseUrl}/report-sessions/{analysisId}/{threadId}/{pagePath}?t={token}
  *   Caddy predicate : request.path.startsWith("/" + res + "/")
  *
- * This is URL space only. On disk a preview lives inside its analysis's workspace tree, at
- * `{resolveWorkspaceRoot(analysisId)}/previews/{previewId}/{previewPath}` (the workspace-layout
- * spec), and a session page at `{resolveWorkspaceRoot(analysisId)}/report-sessions/{threadId}/{pagePath}`
+ * This is URL space only. On disk a session page lives inside its analysis's workspace tree, at
+ * `{resolveWorkspaceRoot(analysisId)}/report-sessions/{threadId}/{pagePath}`
  * (the report-session-agent spec) — the `res` claim carries the analysis id because the URL needs an
  * authorization boundary, whereas the resolved root already identifies the analysis and so does not
- * repeat it. A host that serves either space owns the map between the two.
+ * repeat it. A host that serves the space owns the map between the two.
  *
  * The harness's contracts module owns this TS implementation so both the harness and
  * react-client consume one canonical formula.
  */
-/**
- * Canonical `res` claim formula for a preview. Returns the literal string
- * `previews/{analysisId}/{previewId}` with no leading or trailing slash.
- *
- * This is the URL sub-path served by the content-server (Caddy) and the token's
- * authorization boundary — NOT a filesystem sub-path; see the module doc.
- *
- * MUST match `fmt.Sprintf("previews/%s/%s", analysisID, previewID)` in
- * the storage backend's Go preview-access implementation. Drift is caught by the shared test
- * vector at `src/__tests__/fixtures/preview-res.json`.
- */
-export declare function previewResourceId(analysisId: string, previewId: string): string;
-/**
- * Build a content-token preview URL for an iframe src.
- *
- * Produces `{contentBaseUrl}/{res}/{previewPath}?t={token}` where `res` is
- * the output of `previewResourceId(analysisId, previewId)`. The query parameter
- * name is `t` (matching Caddy's `from_query t` directive). The token is
- * URL-encoded.
- *
- * @param contentBaseUrl - Content server base URL (trailing slash tolerated)
- * @param analysisId - The analysis ID (authorization boundary)
- * @param previewId - The preview ID (groups all versions)
- * @param previewPath - Version-relative path (e.g., "v1/index.html"). Leading slash tolerated.
- * @param token - Short-lived content token minted by the storage backend (required)
- */
-export declare function buildPreviewUrl(contentBaseUrl: string, analysisId: string, previewId: string, previewPath: string, token: string): string;
 /**
  * Canonical `res` claim formula for a report-session page. Returns the literal string
  * `report-sessions/{analysisId}/{threadId}` with no leading or trailing slash.

package/dist/contracts/content-url.js

@@ -1,67 +1,26 @@
 /**
  * Content URL construction — shared between the frontend and Cortex.
  *
- * The `res` claim formulas and URL shapes are the canonical TypeScript contract
- * for the content-token flow. The storage backend mirrors each formula in Go; both
- * sides are locked by the shared test vectors at
- * `src/__tests__/fixtures/preview-res.json` (previews) and
- * `src/__tests__/fixtures/report-session-res.json` (report-session pages), each a
+ * The `res` claim formula and URL shape are the canonical TypeScript contract
+ * for the content-token flow. The storage backend mirrors the formula in Go; both
+ * sides are locked by the shared test vector at
+ * `src/__tests__/fixtures/report-session-res.json` (report-session pages), a
  * byte-identical copy of the storage backend's `kernel/contenttoken/testdata` file.
  *
- * End-to-end contract (previews):
- *   token res claim : "previews/{analysisId}/{previewId}"
- *   URL             : {contentBaseUrl}/previews/{analysisId}/{previewId}/{previewPath}?t={token}
- *   Caddy predicate : request.path.startsWith("/" + res + "/")
- *
  * End-to-end contract (report-session pages):
  *   token res claim : "report-sessions/{analysisId}/{threadId}"  (token kind "rs")
  *   URL             : {contentBaseUrl}/report-sessions/{analysisId}/{threadId}/{pagePath}?t={token}
  *   Caddy predicate : request.path.startsWith("/" + res + "/")
  *
- * This is URL space only. On disk a preview lives inside its analysis's workspace tree, at
- * `{resolveWorkspaceRoot(analysisId)}/previews/{previewId}/{previewPath}` (the workspace-layout
- * spec), and a session page at `{resolveWorkspaceRoot(analysisId)}/report-sessions/{threadId}/{pagePath}`
+ * This is URL space only. On disk a session page lives inside its analysis's workspace tree, at
+ * `{resolveWorkspaceRoot(analysisId)}/report-sessions/{threadId}/{pagePath}`
  * (the report-session-agent spec) — the `res` claim carries the analysis id because the URL needs an
  * authorization boundary, whereas the resolved root already identifies the analysis and so does not
- * repeat it. A host that serves either space owns the map between the two.
+ * repeat it. A host that serves the space owns the map between the two.
  *
  * The harness's contracts module owns this TS implementation so both the harness and
  * react-client consume one canonical formula.
  */
-/**
- * Canonical `res` claim formula for a preview. Returns the literal string
- * `previews/{analysisId}/{previewId}` with no leading or trailing slash.
- *
- * This is the URL sub-path served by the content-server (Caddy) and the token's
- * authorization boundary — NOT a filesystem sub-path; see the module doc.
- *
- * MUST match `fmt.Sprintf("previews/%s/%s", analysisID, previewID)` in
- * the storage backend's Go preview-access implementation. Drift is caught by the shared test
- * vector at `src/__tests__/fixtures/preview-res.json`.
- */
-export function previewResourceId(analysisId, previewId) {
-    return `previews/${analysisId}/${previewId}`;
-}
-/**
- * Build a content-token preview URL for an iframe src.
- *
- * Produces `{contentBaseUrl}/{res}/{previewPath}?t={token}` where `res` is
- * the output of `previewResourceId(analysisId, previewId)`. The query parameter
- * name is `t` (matching Caddy's `from_query t` directive). The token is
- * URL-encoded.
- *
- * @param contentBaseUrl - Content server base URL (trailing slash tolerated)
- * @param analysisId - The analysis ID (authorization boundary)
- * @param previewId - The preview ID (groups all versions)
- * @param previewPath - Version-relative path (e.g., "v1/index.html"). Leading slash tolerated.
- * @param token - Short-lived content token minted by the storage backend (required)
- */
-export function buildPreviewUrl(contentBaseUrl, analysisId, previewId, previewPath, token) {
-    const base = contentBaseUrl.replace(/\/+$/, "");
-    const path = previewPath.replace(/^\/+/, "");
-    const res = previewResourceId(analysisId, previewId);
-    return `${base}/${res}/${path}?t=${encodeURIComponent(token)}`;
-}
 /**
  * Canonical `res` claim formula for a report-session page. Returns the literal string
  * `report-sessions/{analysisId}/{threadId}` with no leading or trailing slash.

package/dist/contracts/index.d.ts

@@ -2,7 +2,7 @@ export { ORGAN_SYSTEMS, OrganSystemSchema, ORGAN_SYSTEM_LABELS, organSystemLabel
 export type { OrganSystem } from "./organ-system.js";
 export { SEVERITIES, SeveritySchema } from "./severity.js";
 export type { Severity } from "./severity.js";
-export type { PlanStep, PresentationContent, PresentationPart, PlanPart, RunCardPart, FileReferenceEntry, FileReferencePart, AskPart, RunStartedPart, StepStatus, DagStepState, DagStatePart, StepPhase, StepActivityPart, FileTreeEntry, StepFileTreePart, StepOutputFile, StepOutputPart, StepSummaryPart, StepUsagePart, StepBlockedPart, SynthesizedFinding, BiologicalTheme, RunSynthesisPart, SynthesisPhase, SynthesisProgressPart, RunCompletedFinding, RunCompletedPart, RunFailedPart, PreviewPart, DataPreviewFailedPart, CortexChatPart, } from "./chat-parts.js";
+export type { PlanStep, PresentationContent, PresentationPart, PlanPart, RunCardPart, FileReferenceEntry, FileReferencePart, AskPart, RunStartedPart, StepStatus, DagStepState, DagStatePart, StepPhase, StepActivityPart, FileTreeEntry, StepFileTreePart, StepOutputFile, StepOutputPart, StepSummaryPart, StepUsagePart, StepBlockedPart, SynthesizedFinding, BiologicalTheme, RunSynthesisPart, SynthesisPhase, SynthesisProgressPart, RunCompletedFinding, RunCompletedPart, RunFailedPart, ChildSessionStartedPart, ReportRenderedPart, CortexChatPart, } from "./chat-parts.js";
 export type { EventSource, TextDeltaEvent, ToolStartedEvent, ToolFinishedEvent, FinishEvent, ChatErrorEvent, CortexChatEvent } from "./chat-events.js";
 export type { TokenUsageRollup } from "./usage.js";
 export { DATA_PROFILE_RUN_LITERAL } from "./data-profile.js";
@@ -15,4 +15,4 @@ export { CoverageSchema, RowCoverageSchema, EntitySchema, ClaimSupportSchema, Cl
 export type { Coverage, RowCoverage, Entity, EvidenceItem, ClaimSupport, ClaimEvidence, LiabilityBullet, LiabilitySummary, TractabilitySection, ClinicalTrialAttribution, ClinicalTrialRow, ClinicalDevelopment, FailedTrialRow, TrialOutcomeRow, OrganRiskRow, OffTargetRow, RegulatoryActionRow, SafetyFlag, SafetyProfile, OffTissueRow, QualityGateStatus, QualityGates, Derived, Dossier, DossierBody, SectionBlurbKey, TargetAssessmentPhase, TargetAssessmentProgressEvent, } from "./target-dossier.js";
 export { TargetAssessmentStatusSchema, TargetAssessmentErrorSchema, TargetAssessmentListRowSchema, TargetAssessmentRowSchema, } from "./target-assessment-row.js";
 export type { TargetAssessmentStatus, TargetAssessmentError, TargetAssessmentListRow, TargetAssessmentRow } from "./target-assessment-row.js";
-export { buildPreviewUrl, buildReportSessionUrl, previewResourceId, reportSessionResourceId } from "./content-url.js";
+export { buildReportSessionUrl, reportSessionResourceId } from "./content-url.js";

package/dist/contracts/index.js

@@ -5,4 +5,4 @@ export { PART_REGISTRY, isTransient, isReconciling, isSidebarPart } from "./part
 export { AnalogyCoverageSchema, AnalogyReportSchema, AnalogyReportErrorSchema, AnalogicalReasonerOutputSchema } from "./analogy-report.js";
 export { CoverageSchema, RowCoverageSchema, EntitySchema, ClaimSupportSchema, ClaimEvidenceSchema, LiabilityBulletSchema, LiabilitySummarySchema, TractabilitySchema, IndicationsSchema, DrugInteractionsSchema, ClinicalTrialAttributionSchema, ClinicalDevelopmentSchema, OrganRiskRowSchema, OffTargetRowSchema, OffTargetPanelSchema, RegulatoryActionRowSchema, SafetyFlagSchema, SafetyProfileSchema, OffTissueRowSchema, OffTissueRiskSchema, ReferenceBiologyShape, EvidenceConflictsSchema, EvidenceTimelineSchema, TranslationalChainSchema, AdditionalEvidenceSchema, DiscoveryTrialsSchema, QualityGateStatusSchema, QualityGatesSchema, DerivedSchema, DossierSchema, DossierBodySchema, isDossier, dossierJsonSchema, SECTION_BLURBS, TargetAssessmentPhaseSchema, TargetAssessmentProgressEventSchema, } from "./target-dossier.js";
 export { TargetAssessmentStatusSchema, TargetAssessmentErrorSchema, TargetAssessmentListRowSchema, TargetAssessmentRowSchema, } from "./target-assessment-row.js";
-export { buildPreviewUrl, buildReportSessionUrl, previewResourceId, reportSessionResourceId } from "./content-url.js";
+export { buildReportSessionUrl, reportSessionResourceId } from "./content-url.js";

package/dist/contracts/message.d.ts

@@ -3,7 +3,7 @@
  * and the public API for everything the chat path exchanges.
  *
  * No AI SDK types appear here or anywhere else in the package. The
- * discriminant is `type`, so `switch (part.type) { case "data-report-preview": ... }`
+ * discriminant is `type`, so `switch (part.type) { case "data-child-session-started": ... }`
  * narrows the union member without any `as` cast.
  */
 import type { ToolCallDetail, ToolCallOutcome } from "./chat-events.js";

package/dist/contracts/message.js

@@ -3,7 +3,7 @@
  * and the public API for everything the chat path exchanges.
  *
  * No AI SDK types appear here or anywhere else in the package. The
- * discriminant is `type`, so `switch (part.type) { case "data-report-preview": ... }`
+ * discriminant is `type`, so `switch (part.type) { case "data-child-session-started": ... }`
  * narrows the union member without any `as` cast.
  */
 export {};

package/dist/contracts/part-registry.js

@@ -16,8 +16,8 @@ export const PART_REGISTRY = {
     "data-synthesis-progress": { emitter: "workflow", consumer: "sidebar", transient: false, reconciling: true },
     "data-run-completed": { emitter: "workflow", consumer: "sidebar", transient: false, reconciling: false },
     "data-run-failed": { emitter: "workflow", consumer: "sidebar", transient: false, reconciling: false },
-    "data-report-preview": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: false },
-    "data-report-preview-failed": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: false },
+    "data-child-session-started": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: false },
+    "data-report-rendered": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: false },
 };
 export function isTransient(type) {
     return PART_REGISTRY[type].transient;

package/dist/contracts/schemas/chat-parts.d.ts

@@ -441,31 +441,17 @@ export declare const RunFailedPartSchema: z.ZodObject<{
     error: z.ZodString;
     reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare const PreviewPartSchema: z.ZodObject<{
-    type: z.ZodLiteral<"data-report-preview">;
-    id: z.ZodString;
-    previewId: z.ZodString;
-    version: z.ZodNumber;
-    title: z.ZodString;
-    previewPath: z.ZodString;
-    format: z.ZodEnum<{
-        html: "html";
-        pdf: "pdf";
-    }>;
+export declare const ChildSessionStartedPartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"data-child-session-started">;
+    threadId: z.ZodString;
+    parentThreadId: z.ZodString;
+    threadType: z.ZodString;
 }, z.core.$strip>;
-export declare const DataPreviewFailedPartSchema: z.ZodObject<{
-    type: z.ZodLiteral<"data-report-preview-failed">;
+export declare const ReportRenderedPartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"data-report-rendered">;
     id: z.ZodString;
-    previewId: z.ZodString;
-    version: z.ZodNumber;
-    reason: z.ZodString;
-    errorKind: z.ZodOptional<z.ZodEnum<{
-        timeout: "timeout";
-        render: "render";
-        submit: "submit";
-        build: "build";
-        internal: "internal";
-    }>>;
+    renderedAt: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const CortexChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"data-presentation">;
@@ -740,27 +726,13 @@ export declare const CortexChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     error: z.ZodString;
     reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"data-report-preview">;
-    id: z.ZodString;
-    previewId: z.ZodString;
-    version: z.ZodNumber;
-    title: z.ZodString;
-    previewPath: z.ZodString;
-    format: z.ZodEnum<{
-        html: "html";
-        pdf: "pdf";
-    }>;
+    type: z.ZodLiteral<"data-child-session-started">;
+    threadId: z.ZodString;
+    parentThreadId: z.ZodString;
+    threadType: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"data-report-preview-failed">;
+    type: z.ZodLiteral<"data-report-rendered">;
     id: z.ZodString;
-    previewId: z.ZodString;
-    version: z.ZodNumber;
-    reason: z.ZodString;
-    errorKind: z.ZodOptional<z.ZodEnum<{
-        timeout: "timeout";
-        render: "render";
-        submit: "submit";
-        build: "build";
-        internal: "internal";
-    }>>;
+    renderedAt: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "type">;

package/dist/contracts/schemas/chat-parts.js

@@ -275,24 +275,21 @@ export const RunFailedPartSchema = z.object({
     error: z.string(),
     reason: z.string().optional(),
 });
-// ── Preview ────────────────────────────────────────────────────────
-export const PreviewPartSchema = z.object({
-    type: z.literal("data-report-preview"),
-    id: z.string(),
-    previewId: z.string(),
-    version: z.number(),
-    title: z.string(),
-    previewPath: z.string(),
-    format: z.enum(["html", "pdf"]),
+// ── Child Session Started ──────────────────────────────────────────
+export const ChildSessionStartedPartSchema = z.object({
+    type: z.literal("data-child-session-started"),
+    threadId: z.string(),
+    parentThreadId: z.string(),
+    // A plain string, deliberately not an enum: a future session type must
+    // not fail validation in an older consumer.
+    threadType: z.string(),
 });
-// ── Preview Failed ─────────────────────────────────────────────────
-export const DataPreviewFailedPartSchema = z.object({
-    type: z.literal("data-report-preview-failed"),
+// ── Report Rendered ────────────────────────────────────────────────
+export const ReportRenderedPartSchema = z.object({
+    type: z.literal("data-report-rendered"),
     id: z.string(),
-    previewId: z.string(),
-    version: z.number(),
-    reason: z.string(),
-    errorKind: z.enum(["render", "submit", "build", "timeout", "internal"]).optional(),
+    renderedAt: z.string(),
+    title: z.string().optional(),
 });
 // ── Union ───────────────────────────────────────────────────────────
 export const CortexChatPartSchema = z.discriminatedUnion("type", [
@@ -313,6 +310,6 @@ export const CortexChatPartSchema = z.discriminatedUnion("type", [
     SynthesisProgressPartSchema,
     RunCompletedPartSchema,
     RunFailedPartSchema,
-    PreviewPartSchema,
-    DataPreviewFailedPartSchema,
+    ChildSessionStartedPartSchema,
+    ReportRenderedPartSchema,
 ]);

package/dist/contracts/schemas/index.d.ts

@@ -1,3 +1,3 @@
-export { PlanStepSchema, PresentationContentSchema, PresentationPartSchema, PlanPartSchema, RunCardPartSchema, FileReferenceEntrySchema, FileReferencePartSchema, RunStartedPartSchema, StepStatusSchema, DagStepStateSchema, DagStatePartSchema, StepPhaseSchema, StepActivityPartSchema, FileTreeEntrySchema, StepFileTreePartSchema, StepOutputFileSchema, StepOutputPartSchema, StepSummaryPartSchema, StepUsagePartSchema, StepBlockedPartSchema, SynthesizedFindingSchema, BiologicalThemeSchema, RunSynthesisPartSchema, SynthesisPhaseSchema, SynthesisProgressPartSchema, RunCompletedFindingSchema, RunCompletedPartSchema, RunFailedPartSchema, PreviewPartSchema, DataPreviewFailedPartSchema, CortexChatPartSchema, } from "./chat-parts.js";
+export { PlanStepSchema, PresentationContentSchema, PresentationPartSchema, PlanPartSchema, RunCardPartSchema, FileReferenceEntrySchema, FileReferencePartSchema, RunStartedPartSchema, StepStatusSchema, DagStepStateSchema, DagStatePartSchema, StepPhaseSchema, StepActivityPartSchema, FileTreeEntrySchema, StepFileTreePartSchema, StepOutputFileSchema, StepOutputPartSchema, StepSummaryPartSchema, StepUsagePartSchema, StepBlockedPartSchema, SynthesizedFindingSchema, BiologicalThemeSchema, RunSynthesisPartSchema, SynthesisPhaseSchema, SynthesisProgressPartSchema, RunCompletedFindingSchema, RunCompletedPartSchema, RunFailedPartSchema, CortexChatPartSchema, } from "./chat-parts.js";
 export { EventSourceSchema, TextDeltaEventSchema, ToolStartedEventSchema, ToolFinishedEventSchema, FinishEventSchema, ChatErrorEventSchema, CortexChatEventSchema, } from "./chat-events.js";
 export { TokenUsageRollupSchema } from "./usage.js";

package/dist/contracts/schemas/index.js

@@ -1,3 +1,3 @@
-export { PlanStepSchema, PresentationContentSchema, PresentationPartSchema, PlanPartSchema, RunCardPartSchema, FileReferenceEntrySchema, FileReferencePartSchema, RunStartedPartSchema, StepStatusSchema, DagStepStateSchema, DagStatePartSchema, StepPhaseSchema, StepActivityPartSchema, FileTreeEntrySchema, StepFileTreePartSchema, StepOutputFileSchema, StepOutputPartSchema, StepSummaryPartSchema, StepUsagePartSchema, StepBlockedPartSchema, SynthesizedFindingSchema, BiologicalThemeSchema, RunSynthesisPartSchema, SynthesisPhaseSchema, SynthesisProgressPartSchema, RunCompletedFindingSchema, RunCompletedPartSchema, RunFailedPartSchema, PreviewPartSchema, DataPreviewFailedPartSchema, CortexChatPartSchema, } from "./chat-parts.js";
+export { PlanStepSchema, PresentationContentSchema, PresentationPartSchema, PlanPartSchema, RunCardPartSchema, FileReferenceEntrySchema, FileReferencePartSchema, RunStartedPartSchema, StepStatusSchema, DagStepStateSchema, DagStatePartSchema, StepPhaseSchema, StepActivityPartSchema, FileTreeEntrySchema, StepFileTreePartSchema, StepOutputFileSchema, StepOutputPartSchema, StepSummaryPartSchema, StepUsagePartSchema, StepBlockedPartSchema, SynthesizedFindingSchema, BiologicalThemeSchema, RunSynthesisPartSchema, SynthesisPhaseSchema, SynthesisProgressPartSchema, RunCompletedFindingSchema, RunCompletedPartSchema, RunFailedPartSchema, CortexChatPartSchema, } from "./chat-parts.js";
 export { EventSourceSchema, TextDeltaEventSchema, ToolStartedEventSchema, ToolFinishedEventSchema, FinishEventSchema, ChatErrorEventSchema, CortexChatEventSchema, } from "./chat-events.js";
 export { TokenUsageRollupSchema } from "./usage.js";

package/dist/execution/run-authorizer.d.ts

@@ -11,7 +11,7 @@
  * `RunSession` with no host call, no jti, no revoke. The harness's tools depend only on
  * this interface and never read a credential.
  *
- * Mirrors the `PreviewPublisher` seam: a narrow interface in the harness, the managed
+ * Mirrors the `SessionPagePublisher` seam: a narrow interface in the harness, the managed
  * realization injected at the composition root.
  */
 import type { AuthContext, Provenance, RunFrame, RunSession, Scope } from "../auth/types.js";

package/dist/execution/run-authorizer.js

@@ -11,7 +11,7 @@
  * `RunSession` with no host call, no jti, no revoke. The harness's tools depend only on
  * this interface and never read a credential.
  *
- * Mirrors the `PreviewPublisher` seam: a narrow interface in the harness, the managed
+ * Mirrors the `SessionPagePublisher` seam: a narrow interface in the harness, the managed
  * realization injected at the composition root.
  */
 export {};

package/dist/index.d.ts

@@ -33,8 +33,6 @@ export { createNoopArtifactRegistry } from "./execution/noop-artifact-registry.j
 export type { ArtifactRegistry, ArtifactRegistrationInput, ArtifactSyncInput, ExternalRegistrationResult } from "./execution/artifact-registry.js";
 export type { ArtifactManifestEntry } from "./schemas/artifact-manifest.js";
 export type { ProvenanceCollector } from "./provenance/collector.js";
-export { UnavailablePreviewPublisher } from "./tools/report/preview-publisher.js";
-export type { PreviewPublisher, PreviewMintResult } from "./tools/report/preview-publisher.js";
 export { UnavailableSessionPagePublisher } from "./tools/report-session/session-page-publisher.js";
 export type { MakeSessionPagePublisher, SessionPagePublisher, SessionPageMintResult } from "./tools/report-session/session-page-publisher.js";
 export type { ResolvePageUrl, SessionPageAccess } from "./tools/report-session/index.js";
@@ -88,7 +86,7 @@ export type { ConversationDisplayMetadata, ConversationUIData, ConversationUIMes
 export { storedMessagesToCortex } from "./memory/conversation-display-replay.js";
 export type { CortexChatEvent, TextDeltaEvent, ToolStartedEvent, ToolFinishedEvent, ToolOutcome, ToolCallOutcome, ToolCallDetail, FinishEvent, ChatErrorEvent, } from "./contracts/chat-events.js";
 export type { TokenUsageRollup } from "./contracts/usage.js";
-export type { CortexChatPart, PresentationPart, PresentationContent, PlanPart, RunCardPart, FileReferencePart, FileReferenceEntry, RunStartedPart, DagStatePart, DagStepState, StepStatus, StepActivityPart, StepPhase, StepFileTreePart, FileTreeEntry, StepOutputPart, StepOutputFile, StepSummaryPart, StepUsagePart, StepBlockedPart, RunSynthesisPart, SynthesizedFinding, BiologicalTheme, SynthesisProgressPart, SynthesisPhase, RunCompletedPart, RunCompletedFinding, RunFailedPart, PreviewPart, DataPreviewFailedPart, } from "./contracts/chat-parts.js";
+export type { CortexChatPart, PresentationPart, PresentationContent, PlanPart, RunCardPart, FileReferencePart, FileReferenceEntry, RunStartedPart, DagStatePart, DagStepState, StepStatus, StepActivityPart, StepPhase, StepFileTreePart, FileTreeEntry, StepOutputPart, StepOutputFile, StepSummaryPart, StepUsagePart, StepBlockedPart, RunSynthesisPart, SynthesizedFinding, BiologicalTheme, SynthesisProgressPart, SynthesisPhase, RunCompletedPart, RunCompletedFinding, RunFailedPart, } from "./contracts/chat-parts.js";
 export { PART_REGISTRY, isTransient, isReconciling, isSidebarPart } from "./contracts/part-registry.js";
 export type { CortexChatPartType, PartDescriptor, PartEmitter, PartConsumer } from "./contracts/part-registry.js";
 export { launchDbos, shutdownDbos, sweepEphemeralWorkflows } from "./runtime/dbos.js";

package/dist/index.js

@@ -40,8 +40,6 @@ export { createNoopRunCharge } from "./billing/noop-run-charge.js";
 export { createNoopUsageRecorder } from "./billing/noop-usage-recorder.js";
 // Seam: artifact registration.
 export { createNoopArtifactRegistry } from "./execution/noop-artifact-registry.js";
-// Seam: report preview publishing.
-export { UnavailablePreviewPublisher } from "./tools/report/preview-publisher.js";
 // Seam: the hosted view of a report-session page. A managed host serves the URL space
 // `report-sessions/{analysisId}/{threadId}` and mints access through its own publisher,
 // thus the seam belongs on the front door. Both seams bind per call over the auth of the

package/dist/lib/zod-issues.d.ts

@@ -13,10 +13,9 @@
  *    ` ```json {…}``` `). The payload is complete; only the wrapper makes it a
  *    string.
  *
- * This module owns both halves of the response for the four model-facing
+ * This module owns both halves of the response for the three model-facing
  * validation sites (`loop/run-agent.ts`'s tool-input boundary,
- * `execution/run-synthesis.ts`, `tools/research/generate-plan.ts`,
- * `tools/iterate-report.ts`):
+ * `execution/run-synthesis.ts`, `tools/research/generate-plan.ts`):
  *
  *  - `hintForZodIssue` — a **diagnostic only**. It parses nothing into the
  *    caller's data; it distinguishes the two modes so the message the model

package/dist/lib/zod-issues.js

@@ -13,10 +13,9 @@
  *    ` ```json {…}``` `). The payload is complete; only the wrapper makes it a
  *    string.
  *
- * This module owns both halves of the response for the four model-facing
+ * This module owns both halves of the response for the three model-facing
  * validation sites (`loop/run-agent.ts`'s tool-input boundary,
- * `execution/run-synthesis.ts`, `tools/research/generate-plan.ts`,
- * `tools/iterate-report.ts`):
+ * `execution/run-synthesis.ts`, `tools/research/generate-plan.ts`):
  *
  *  - `hintForZodIssue` — a **diagnostic only**. It parses nothing into the
  *    caller's data; it distinguishes the two modes so the message the model

package/dist/loop/__fixtures__/scripted-provider.js

@@ -14,9 +14,11 @@ function mapFinishReason(finishReason) {
     }
 }
 export function makeMessage(content, finishReason, usage) {
+    const mapped = mapFinishReason(finishReason);
     return {
         message: { role: "assistant", content },
-        finishReason: mapFinishReason(finishReason),
+        finishReason: mapped,
+        ...(mapped === finishReason ? {} : { rawFinishReason: finishReason }),
         usage,
     };
 }