@inflexa-ai/harness 0.23.0 → 0.24.0

package/dist/memory/card-builders.d.ts

@@ -39,14 +39,6 @@ export interface RunCardData {
     title: string;
     stepCount: number;
 }
-export interface PreviewCardData {
-    id: string;
-    previewId: string;
-    version: number;
-    title: string;
-    previewPath: string;
-    format: "html" | "pdf";
-}
 /** Build the `data-plan` payload by loading the stored plan. `ok(null)` when
  *  the plan is missing or no longer parses (absence is NOT an error) — the
  *  caller falls back to a chip. */
@@ -100,22 +92,3 @@ export declare function fileGroupHash(paths: string[], title: string | undefined
  * path the live tool rejected would be resurrected into a card on reload.
  */
 export declare function buildFileReferenceCardData(input: Record<string, unknown>): FileReferenceCardData | null;
-/**
- * Build the `data-report-preview` payload for an `iterate_report` tool_use. The
- * preview's source of truth is the filesystem under
- * `previews/{previewId}/`: directory layout yields `version`
- * (latest `vN`) + `previewPath`, and `preview-meta.json` yields title/format.
- * Mirrors `buildRunCardData` — the live emit knows the server-generated
- * `previewId`, while the reconstruct-on-read path resolves it (from the
- * iteration's `previewId` input, or else the analysis's latest preview). The
- * card is keyed by `previewId` only, so every iteration's tool_use rebuilds
- * the same card and the frontend groups them into one with all versions selectable.
- * Null when nothing renders — the caller falls back to a chip.
- */
-export declare function buildPreviewCardData(
-/** Absolute host root of the analysis's workspace tree (previews live inside it). */
-workspaceRoot: string, opts: {
-    previewId?: string;
-    title?: string;
-    format?: "html" | "pdf";
-}): Promise<PreviewCardData | null>;

package/dist/memory/card-builders.js

@@ -16,17 +16,12 @@
  * under the part `type` directly.
  */
 import { createHash } from "node:crypto";
-import { readdir, readFile, stat } from "node:fs/promises";
-import { join } from "node:path";
 import { okAsync } from "neverthrow";
 import { tryQuery } from "../lib/db-result.js";
-import { tryFs } from "../lib/fs-result.js";
 import { AnalysisPlanSchema } from "../schemas/workflow-state.js";
 import { loadPlan } from "../state/index.js";
 import { normalizeEchartSpec } from "../tools/display/normalize-echart-spec.js";
 import { validatePath } from "../tools/lib/path-validation.js";
-import { latestPreviewVersion, previewDir, PREVIEWS_ROOT } from "../workspace/paths.js";
-const PREVIEW_META_FILE = "preview-meta.json";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -176,73 +171,3 @@ export function buildFileReferenceCardData(input) {
     const id = `pres-${fileGroupHash(files.map((f) => f.path), title)}`;
     return { id, ...(title !== undefined ? { title } : {}), files };
 }
-/** The stored preview metadata, or `null` when the file is absent — a malformed
- *  file is a genuine read failure (`err`), folded to `null` at the call site. */
-function readPreviewMeta(previewRootAbs) {
-    const path = join(previewRootAbs, PREVIEW_META_FILE);
-    return tryFs("cardBuilders.readPreviewMeta", async () => JSON.parse(await readFile(path, "utf8")), { path, onAbsent: () => null });
-}
-/** Directory names (not files) directly under `dir`, or `[]` when absent. */
-function subdirs(dir) {
-    return tryFs("cardBuilders.subdirs", async () => (await readdir(dir, { withFileTypes: true })).filter((e) => e.isDirectory()).map((e) => e.name), {
-        path: dir,
-        onAbsent: () => [],
-    });
-}
-/** The most-recently-modified previewId under an analysis, or null when none. */
-function latestPreviewId(previewsRootAbs) {
-    return subdirs(previewsRootAbs).map(async (dirs) => {
-        if (dirs.length <= 1)
-            return dirs[0] ?? null;
-        let best = null;
-        for (const name of dirs) {
-            const path = join(previewsRootAbs, name);
-            const mtimeMs = await tryFs("cardBuilders.latestPreviewId.stat", async () => (await stat(path)).mtimeMs, { path }).unwrapOr(null); // skip an unreadable/absent entry
-            if (mtimeMs !== null && (!best || mtimeMs > best.mtimeMs)) {
-                best = { name, mtimeMs };
-            }
-        }
-        return best?.name ?? dirs[0];
-    });
-}
-/**
- * Build the `data-report-preview` payload for an `iterate_report` tool_use. The
- * preview's source of truth is the filesystem under
- * `previews/{previewId}/`: directory layout yields `version`
- * (latest `vN`) + `previewPath`, and `preview-meta.json` yields title/format.
- * Mirrors `buildRunCardData` — the live emit knows the server-generated
- * `previewId`, while the reconstruct-on-read path resolves it (from the
- * iteration's `previewId` input, or else the analysis's latest preview). The
- * card is keyed by `previewId` only, so every iteration's tool_use rebuilds
- * the same card and the frontend groups them into one with all versions selectable.
- * Null when nothing renders — the caller falls back to a chip.
- */
-export async function buildPreviewCardData(
-/** Absolute host root of the analysis's workspace tree (previews live inside it). */
-workspaceRoot, opts) {
-    const previewsRootAbs = join(workspaceRoot, PREVIEWS_ROOT);
-    const resolveId = opts.previewId ? okAsync(opts.previewId) : latestPreviewId(previewsRootAbs);
-    return resolveId
-        .andThen((previewId) => {
-        if (!previewId)
-            return okAsync(null);
-        const previewRootAbs = join(workspaceRoot, previewDir(previewId));
-        return subdirs(previewRootAbs).andThen((versionDirs) => {
-            const version = latestPreviewVersion(versionDirs);
-            if (version === 0)
-                return okAsync(null);
-            return readPreviewMeta(previewRootAbs).map((meta) => {
-                const id = `prev-${createHash("sha256").update(previewId).digest("hex").slice(0, 16)}`;
-                return {
-                    id,
-                    previewId,
-                    version,
-                    title: opts.title ?? meta?.title ?? "Report",
-                    previewPath: `v${version}/index.html`,
-                    format: opts.format ?? (meta?.format === "pdf" ? "pdf" : "html"),
-                };
-            });
-        });
-    })
-        .unwrapOr(null);
-}

package/dist/memory/conversation-display-backfill.d.ts

@@ -1,9 +1,7 @@
 import type { Pool } from "pg";
 import type { Tool } from "../tools/define-tool.js";
-import type { ResolveWorkspaceRoot } from "../workspace/paths.js";
 export interface ConversationDisplayBackfillDeps {
     readonly pool: Pool;
-    readonly resolveWorkspaceRoot: ResolveWorkspaceRoot;
     /**
      * The conversation agent's composed roster, used to recover each legacy call's
      * one-line detail from its persisted input. Tools contributed through the
@@ -17,8 +15,8 @@ export interface ConversationDisplayBackfillDeps {
  * Freeze the migration renderer's output into display envelopes, once per legacy
  * turn, so the runtime read path never has to reconstruct anything.
  *
- * Missing mutable resources degrade to a generic, cardless display — a workspace
- * that has moved is normal historical absence, not a fault. Malformed stored rows
+ * Missing mutable resources degrade to a generic, cardless display — a plan
+ * that is absent is normal historical absence, not a fault. Malformed stored rows
  * and database faults remain startup-fatal: a turn that cannot be migrated must
  * not be silently skipped and then read as if it had no display.
  */

package/dist/memory/conversation-display-backfill.js

@@ -10,8 +10,8 @@ const GENUINE_USER_SQL = `m.message_envelope->'message'->>'role' = 'user'
  * Freeze the migration renderer's output into display envelopes, once per legacy
  * turn, so the runtime read path never has to reconstruct anything.
  *
- * Missing mutable resources degrade to a generic, cardless display — a workspace
- * that has moved is normal historical absence, not a fault. Malformed stored rows
+ * Missing mutable resources degrade to a generic, cardless display — a plan
+ * that is absent is normal historical absence, not a fault. Malformed stored rows
  * and database faults remain startup-fatal: a turn that cannot be migrated must
  * not be silently skipped and then read as if it had no display.
  */
@@ -64,13 +64,7 @@ export async function backfillConversationDisplayEnvelopes(deps) {
             });
             let resolveCard;
             if (head.analysis_id !== null) {
-                try {
-                    resolveCard = createCardResolver(deps.pool, head.analysis_id, deps.resolveWorkspaceRoot(head.analysis_id));
-                }
-                catch {
-                    // A removed/moved workspace is normal historical absence.
-                    resolveCard = undefined;
-                }
+                resolveCard = createCardResolver(deps.pool, head.analysis_id);
             }
             const cortex = await contentToCortexMessages(stored, { resolveCard, resolveDetail });
             const uiMessages = cortexMessagesToConversationUI(cortex);

package/dist/memory/conversation-display-storage.d.ts

@@ -15,7 +15,7 @@
  * reconstruction.
  */
 import { type DataUIPart, type UIMessage } from "ai";
-import type { AskPart, FileReferencePart, PlanPart, PresentationPart, PreviewPart, DataPreviewFailedPart, ReportSessionStartedPart, RunCardPart } from "../contracts/chat-parts.js";
+import type { AskPart, ChildSessionStartedPart, FileReferencePart, PlanPart, PresentationPart, ReportRenderedPart, RunCardPart } from "../contracts/chat-parts.js";
 import type { ToolCallOutcome } from "../contracts/chat-events.js";
 import type { CortexMessage, CortexPart, ToolCallPart } from "../contracts/message.js";
 export declare const SUPPORTED_DISPLAY_SCHEMA_VERSION = 1;
@@ -38,9 +38,8 @@ export type ConversationUIData = {
     "run-card": Payload<RunCardPart>;
     "file-reference": Payload<FileReferencePart>;
     ask: Payload<AskPart>;
-    "report-preview": Payload<PreviewPart>;
-    "report-preview-failed": Payload<DataPreviewFailedPart>;
-    "report-session-started": Payload<ReportSessionStartedPart>;
+    "child-session-started": Payload<ChildSessionStartedPart>;
+    "report-rendered": Payload<ReportRenderedPart>;
 };
 export interface ConversationDisplayMetadata {
     interrupted?: boolean;

package/dist/memory/conversation-display-storage.js

@@ -16,7 +16,7 @@
  */
 import { validateUIMessages } from "ai";
 import { z } from "zod";
-import { AskPartSchema, DataPreviewFailedPartSchema, FileReferencePartSchema, PlanPartSchema, PresentationPartSchema, PreviewPartSchema, ReportSessionStartedPartSchema, RunCardPartSchema, } from "../contracts/schemas/chat-parts.js";
+import { AskPartSchema, ChildSessionStartedPartSchema, FileReferencePartSchema, PlanPartSchema, PresentationPartSchema, ReportRenderedPartSchema, RunCardPartSchema, } from "../contracts/schemas/chat-parts.js";
 import { ToolCallOutcomeSchema } from "../contracts/schemas/chat-events.js";
 export const SUPPORTED_DISPLAY_SCHEMA_VERSION = 1;
 const DisplayEnvelopeHeaderSchema = z.object({
@@ -54,9 +54,8 @@ const dataSchemas = {
     "run-card": RunCardPartSchema.omit({ type: true }).strict(),
     "file-reference": FileReferencePartSchema.omit({ type: true }).strict(),
     ask: AskPartSchema.omit({ type: true }).strict(),
-    "report-preview": PreviewPartSchema.omit({ type: true }).strict(),
-    "report-preview-failed": DataPreviewFailedPartSchema.omit({ type: true }).strict(),
-    "report-session-started": ReportSessionStartedPartSchema.omit({ type: true }).strict(),
+    "child-session-started": ChildSessionStartedPartSchema.omit({ type: true }).strict(),
+    "report-rendered": ReportRenderedPartSchema.omit({ type: true }).strict(),
 };
 export function envelopeDisplayMessages(messages) {
     if (messages.length === 0)

package/dist/memory/reconstruct-cards.d.ts

@@ -4,15 +4,13 @@
  * through the pre-v1 direct-upgrade window, then remove its runtime fallback
  * in a dedicated compatibility change.
  *
- * `show_plan` / `show_user` / `show_file` / `execute_analysis` / `iterate_report` emit
- * `data-plan` / `data-presentation` / `data-file-reference` / `data-run-card` /
- * `data-report-preview` cards
+ * `show_plan` / `show_user` / `show_file` / `execute_analysis` emit
+ * `data-plan` / `data-presentation` / `data-file-reference` / `data-run-card` cards
  * live over the chat SSE stream. On reload, `content-to-cortex` calls this
  * resolver for each AI SDK tool-call part: a recognised display tool yields its card (rebuilt via the
  * shared `card-builders`); anything else yields `null` and falls back to a
- * generic `tool-call` chip. Keyed by the analysis `Pool` + id (plan / run) or
- * the analysis's workspace root (preview, filesystem-backed) so the card can
- * be re-loaded.
+ * generic `tool-call` chip. Keyed by the analysis `Pool` + id (plan / run) so
+ * the card can be re-loaded.
  */
 import type { CortexPart } from "@inflexa-ai/harness/contracts/message.js";
 import type { Pool } from "pg";
@@ -26,4 +24,4 @@ export interface StoredToolCallForCard {
 /** @deprecated Used only by the legacy display backfill/fallback. */
 export type ToolCardResolver = (block: StoredToolCallForCard) => Promise<CortexPart | null>;
 /** @deprecated Use persisted conversation display envelopes for runtime reads. */
-export declare function createCardResolver(pool: Pool, analysisId: string, workspaceRoot: string): ToolCardResolver;
+export declare function createCardResolver(pool: Pool, analysisId: string): ToolCardResolver;

package/dist/memory/reconstruct-cards.js

@@ -4,38 +4,24 @@
  * through the pre-v1 direct-upgrade window, then remove its runtime fallback
  * in a dedicated compatibility change.
  *
- * `show_plan` / `show_user` / `show_file` / `execute_analysis` / `iterate_report` emit
- * `data-plan` / `data-presentation` / `data-file-reference` / `data-run-card` /
- * `data-report-preview` cards
+ * `show_plan` / `show_user` / `show_file` / `execute_analysis` emit
+ * `data-plan` / `data-presentation` / `data-file-reference` / `data-run-card` cards
  * live over the chat SSE stream. On reload, `content-to-cortex` calls this
  * resolver for each AI SDK tool-call part: a recognised display tool yields its card (rebuilt via the
  * shared `card-builders`); anything else yields `null` and falls back to a
- * generic `tool-call` chip. Keyed by the analysis `Pool` + id (plan / run) or
- * the analysis's workspace root (preview, filesystem-backed) so the card can
- * be re-loaded.
+ * generic `tool-call` chip. Keyed by the analysis `Pool` + id (plan / run) so
+ * the card can be re-loaded.
  */
 import { unwrapOrThrow } from "../lib/result.js";
 import { adHocPlanId, adHocRunId } from "../tools/analysis-invocation.js";
 import { validatePath } from "../tools/lib/path-validation.js";
-import { buildFileReferenceCardData, buildPlanCardData, buildPresentationCardData, buildPreviewCardData, buildRunCardData } from "./card-builders.js";
+import { buildFileReferenceCardData, buildPlanCardData, buildPresentationCardData, buildRunCardData } from "./card-builders.js";
 /** @deprecated Use persisted conversation display envelopes for runtime reads. */
-export function createCardResolver(pool, analysisId, workspaceRoot) {
+export function createCardResolver(pool, analysisId) {
     return async (block) => {
         if (block.type !== "tool_use")
             return null;
         const input = (block.input ?? {});
-        // The report tool is `submit_report`; legacy transcripts carry the
-        // former ids `iterate_report` / `iterateReport` — accept all three. The
-        // brief-carrying field is still `report`, so the card reads identically.
-        if (block.name === "submit_report" || block.name === "iterate_report" || block.name === "iterateReport") {
-            const report = (input.report ?? null);
-            const card = await buildPreviewCardData(workspaceRoot, {
-                previewId: typeof input.previewId === "string" ? input.previewId : undefined,
-                title: report && typeof report.title === "string" ? report.title : undefined,
-                format: input.format === "pdf" || input.format === "html" ? input.format : undefined,
-            });
-            return card ? { type: "data-report-preview", ...card } : null;
-        }
         if (block.name === "show_user") {
             // The live tool rejects a malformed/traversal echart `dataPath` and emits nothing; the
             // persisted tool_use still carries it, so the reload path MUST re-validate before building

package/dist/runtime/boot.js

@@ -38,7 +38,6 @@
  */
 import { unwrapOrThrow } from "../lib/result.js";
 import { SANDBOX_AGENT_META } from "../agents/sandbox/index.js";
-import { REPORT_BUILDER_AGENT_ID, REPORT_BUILDER_SKILLS } from "../agents/report-builder.js";
 import { validateAgentSkills } from "../agents/sandbox/validate-skills.js";
 import { initCortexState } from "../state/init.js";
 import { backfillConversationDisplayEnvelopes } from "../memory/conversation-display-backfill.js";
@@ -49,16 +48,8 @@ import { markDraining } from "./lifecycle.js";
 import { runShutdownSequence } from "./shutdown.js";
 const noop = () => { };
 const noopAsync = () => Promise.resolve();
-/**
- * Every agent whose declared packs must resolve before the first run. The
- * report-builder is not in the sandbox catalog — it is not plannable — but it
- * declares a pack all the same, and a missing one there surfaces as a failed
- * render partway through a report rather than at boot.
- */
-const SKILL_DECLARING_AGENTS = {
-    ...SANDBOX_AGENT_META,
-    [REPORT_BUILDER_AGENT_ID]: { id: REPORT_BUILDER_AGENT_ID, skills: REPORT_BUILDER_SKILLS },
-};
+/** Every agent whose declared packs must resolve before the first run. */
+const SKILL_DECLARING_AGENTS = SANDBOX_AGENT_META;
 export async function bootHarness(deps) {
     const { core, pool, skillsDir, logger } = deps;
     (deps.initTelemetry ?? noop)();
@@ -73,7 +64,6 @@ export async function bootHarness(deps) {
     const conversationAgent = unwrapOrThrow(runtime.agents.forThread("conversation"));
     await backfillConversationDisplayEnvelopes({
         pool,
-        resolveWorkspaceRoot: core.conversation.resolveWorkspaceRoot,
         tools: conversationAgent.tools,
     });
     await deps.beforeLaunch?.();

package/dist/tools/report-session/preview-report.d.ts

@@ -28,7 +28,8 @@
  * render problem, a figure that escapes the workspace root, a write failure, and a stamp failure. The tool
  * never throws for one of them. When the page
  * lands, the tool stamps the hash of the rendered draft on the session state, thus the eyes and the record
- * know which draft the page shows. The filesystem speaks the
+ * know which draft the page shows. It then emits one durable `data-report-rendered` part, thus the
+ * transcript places the render and a live client learns that a fresh page exists. The filesystem speaks the
  * throw protocol, and the workspace-root seam signals an unresolvable resource the same way. Thus the
  * write runs through the `tryFs` glue, which turns a genuine fault into the ok-channel outcome and lets a
  * control-flow exception propagate.

package/dist/tools/report-session/preview-report.js

@@ -28,12 +28,14 @@
  * render problem, a figure that escapes the workspace root, a write failure, and a stamp failure. The tool
  * never throws for one of them. When the page
  * lands, the tool stamps the hash of the rendered draft on the session state, thus the eyes and the record
- * know which draft the page shows. The filesystem speaks the
+ * know which draft the page shows. It then emits one durable `data-report-rendered` part, thus the
+ * transcript places the render and a live client learns that a fresh page exists. The filesystem speaks the
  * throw protocol, and the workspace-root seam signals an unresolvable resource the same way. Thus the
  * write runs through the `tryFs` glue, which turns a genuine fault into the ok-channel outcome and lets a
  * control-flow exception propagate.
  */
 import { err, ok } from "neverthrow";
+import { randomUUID } from "node:crypto";
 import { copyFile, mkdir, readdir, rm, writeFile } from "node:fs/promises";
 import { extname, join } from "node:path";
 import { relative as relativePosix } from "node:path/posix";
@@ -475,6 +477,12 @@ export function createPreviewReportTool(deps) {
                 logger.warn("the rendered hash did not stamp", { threadId, analysisId, detail });
                 return ok({ outcome: "stamp-failed", pagePath: written.value, detail });
             }
+            // The part rides the rendered arm only. Each degraded arm shows no
+            // fresh page, thus it emits nothing.
+            await ctx.emit({
+                type: "data-report-rendered",
+                data: { id: randomUUID(), renderedAt: new Date().toISOString(), title: document.title },
+            });
             const access = await mintAccess(deps.makeSessionPages, analysisId, threadId, ctx.session.auth, logger);
             return ok({ outcome: "rendered", pagePath: written.value, ...(access !== undefined ? { access } : {}) });
         },

package/dist/tools/start-report-session.js

@@ -173,8 +173,8 @@ export function createStartReportSessionTool(deps) {
                 // names a session that an earlier turn announced, thus a second
                 // part would put a second entry into the transcript.
                 await ctx.emit({
-                    type: "data-report-session-started",
-                    data: { threadId: child.threadId, parentThreadId },
+                    type: "data-child-session-started",
+                    data: { threadId: child.threadId, parentThreadId, threadType: "report" },
                 });
                 return ok({ outcome: "started", threadId: child.threadId, title: child.title });
             }

package/dist/workspace/paths.d.ts

@@ -159,27 +159,6 @@ export declare function tailWritePrefix(args: {
  * a step briefing names (see the harness-workspace-tools spec).
  */
 export declare function toSandboxPath(workspaceRoot: string, resourceId: string, hostAbsPath: string): string;
-/**
- * Parent of every preview, workspace-root-relative. Callers that enumerate
- * previews join this; callers that address one join {@link previewDir}. Both
- * spell the segment through this constant so the tree has one owner.
- */
-export declare const PREVIEWS_ROOT = "previews";
-/**
- * Versioned preview directory, workspace-root-relative. Previews live inside
- * the analysis tree (`previews/{previewId}/v{N}`); the content-token `res`
- * claim keeps the separate `previews/{analysisId}/{previewId}` formula in
- * `contracts/content-url.ts` — that is URL space, not a filesystem sub-path,
- * and hosts that serve previews map one onto the other themselves.
- */
-export declare function previewVersionDir(previewId: string, version: number): string;
-/** Preview root for a specific preview (all versions), workspace-root-relative. */
-export declare function previewDir(previewId: string): string;
-/**
- * Find the highest version number from a list of version directory names.
- * Expects names like "v1", "v2", etc. Returns 0 if no versions found.
- */
-export declare function latestPreviewVersion(dirNames: string[]): number;
 /**
  * Parent of every report session, workspace-root-relative. Callers that
  * enumerate the sessions join this. Callers that address one join

package/dist/workspace/paths.js

@@ -151,43 +151,6 @@ export function toSandboxPath(workspaceRoot, resourceId, hostAbsPath) {
     }
     return tail === "" ? `/${resourceId}` : `/${resourceId}/${tail}`;
 }
-/**
- * Parent of every preview, workspace-root-relative. Callers that enumerate
- * previews join this; callers that address one join {@link previewDir}. Both
- * spell the segment through this constant so the tree has one owner.
- */
-export const PREVIEWS_ROOT = "previews";
-/**
- * Versioned preview directory, workspace-root-relative. Previews live inside
- * the analysis tree (`previews/{previewId}/v{N}`); the content-token `res`
- * claim keeps the separate `previews/{analysisId}/{previewId}` formula in
- * `contracts/content-url.ts` — that is URL space, not a filesystem sub-path,
- * and hosts that serve previews map one onto the other themselves.
- */
-export function previewVersionDir(previewId, version) {
-    return `${previewDir(previewId)}/v${version}`;
-}
-/** Preview root for a specific preview (all versions), workspace-root-relative. */
-export function previewDir(previewId) {
-    assertSafeId(previewId, "previewId");
-    return `${PREVIEWS_ROOT}/${previewId}`;
-}
-/**
- * Find the highest version number from a list of version directory names.
- * Expects names like "v1", "v2", etc. Returns 0 if no versions found.
- */
-export function latestPreviewVersion(dirNames) {
-    let max = 0;
-    for (const name of dirNames) {
-        const match = name.match(/^v(\d+)$/);
-        if (match) {
-            const n = parseInt(match[1], 10);
-            if (n > max)
-                max = n;
-        }
-    }
-    return max;
-}
 /**
  * Parent of every report session, workspace-root-relative. Callers that
  * enumerate the sessions join this. Callers that address one join

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@inflexa-ai/harness",
-    "version": "0.23.0",
+    "version": "0.24.0",
     "description": "Host-agnostic bioinformatics agent harness — hand-rolled agent loop, DBOS-durable workflows, sandboxed compute.",
     "license": "Apache-2.0",
     "type": "module",
@@ -76,7 +76,6 @@
         "mime": "^4.1.0",
         "nanoid": "^5.1.16",
         "neverthrow": "^8.2.0",
-        "nunjucks": "^3.2.4",
         "openai": "^7.4.0",
         "p-queue": "^9.3.3",
         "pdf-parse": "^2.4.5",
@@ -89,7 +88,6 @@
         "@types/bun": "latest",
         "@types/dockerode": "^3.3.47",
         "@types/node": "^24.13.3",
-        "@types/nunjucks": "^3.2.6",
         "@types/pdf-parse": "^1.1.5",
         "@types/pg": "^8.20.0",
         "csstree-validator": "^4.0.1",

package/dist/agents/report-builder.d.ts

@@ -1,34 +0,0 @@
-/**
- * Report Builder Agent — in-process templating agent (no sandbox).
- *
- * Authors HTML reports via Jinja2 templating. Runs in the Cortex Node
- * process — file IO is in-process via the `versionFs` tool roster, rendering
- * is Node-side via Nunjucks (`build_report` tool), and visual validation
- * uses headless Chrome via the `preview_snapshot` tool.
- *
- * The agent receives a complete brief from iterate-report's pre-flight
- * (assets staged, columns parsed, sections fully composed) and has no
- * discovery surface — its workspace is rooted at the version directory.
- *
- * NOT a sandbox-agent catalog member (per design Decision #2 — not
- * plannable). The full tool roster is constructed inside the runner so
- * each tool shares the runner's closure-captured outcome state and
- * preview-dir paths; this factory just packages the result into a plain
- * `AgentDefinition`.
- */
-import type { AgentDefinition } from "../loop/types.js";
-import type { Tool } from "../tools/define-tool.js";
-export declare const REPORT_BUILDER_AGENT_ID = "report-builder";
-/** Skill pack the report-builder prompt directs the model to read (design-system reference). */
-export declare const REPORT_BUILDER_SKILLS: readonly ["report-html"];
-export interface CreateReportBuilderAgentDeps {
-    /** Model id — provenance / metric label; the provider owns the wire model. */
-    readonly model: string;
-    /**
-     * Full tool roster — the 4 custom report tools plus the in-process
-     * versionFs surface, all constructed inside the runner so they close
-     * over the iteration's outcome state and preview-dir paths.
-     */
-    readonly tools: readonly Tool[];
-}
-export declare function createReportBuilderAgent(deps: CreateReportBuilderAgentDeps): AgentDefinition;

package/dist/agents/report-builder.js

@@ -1,34 +0,0 @@
-/**
- * Report Builder Agent — in-process templating agent (no sandbox).
- *
- * Authors HTML reports via Jinja2 templating. Runs in the Cortex Node
- * process — file IO is in-process via the `versionFs` tool roster, rendering
- * is Node-side via Nunjucks (`build_report` tool), and visual validation
- * uses headless Chrome via the `preview_snapshot` tool.
- *
- * The agent receives a complete brief from iterate-report's pre-flight
- * (assets staged, columns parsed, sections fully composed) and has no
- * discovery surface — its workspace is rooted at the version directory.
- *
- * NOT a sandbox-agent catalog member (per design Decision #2 — not
- * plannable). The full tool roster is constructed inside the runner so
- * each tool shares the runner's closure-captured outcome state and
- * preview-dir paths; this factory just packages the result into a plain
- * `AgentDefinition`.
- */
-import { reportBuilderPrompt } from "../prompts/report-builder.js";
-import { composeSystemPrompt } from "./system-prompt.js";
-export const REPORT_BUILDER_AGENT_ID = "report-builder";
-/** Skill pack the report-builder prompt directs the model to read (design-system reference). */
-export const REPORT_BUILDER_SKILLS = ["report-html"];
-/** Runaway guard — Jinja recovery may take several build/edit cycles. */
-const REPORT_BUILDER_MAX_ITERATIONS = 75;
-export function createReportBuilderAgent(deps) {
-    return {
-        id: REPORT_BUILDER_AGENT_ID,
-        systemPrompt: composeSystemPrompt(reportBuilderPrompt),
-        model: deps.model,
-        tools: deps.tools,
-        maxIterations: REPORT_BUILDER_MAX_ITERATIONS,
-    };
-}

package/dist/execution/report-render.d.ts

@@ -1,39 +0,0 @@
-/**
- * Report renderer — Node-side Nunjucks render of v{N}/report.html.j2 to v{N}/index.html.
- *
- * Stateless pure module: no harness imports, no env reads at import time,
- * safe to run standalone in tests.
- */
-export interface RenderReportOptions {
-    versionDir: string;
-    templatesDir: string;
-}
-export interface RenderReportResult {
-    ok: boolean;
-    indexBytes: number;
-    error?: {
-        kind: "missing-template" | "syntax" | "runtime";
-        message: string;
-        line?: number;
-        snippet?: string;
-    };
-}
-/**
- * Render `${versionDir}/report.html.j2` to `${versionDir}/index.html`.
- *
- * Loader resolution order: [versionDir, templatesDir]. `report.html.j2`
- * lives in versionDir; `extends "base.html.j2"` and `include "components/..."`
- * resolve from templatesDir. Autoescape is OFF — templates own escaping.
- *
- * `${templatesDir}/echarts-theme.json` is read, parsed, re-stringified, and
- * passed as `echarts_theme` (a JSON string) for safe inlining inside a
- * `<script>` block.
- *
- * Returns `{ ok: true, indexBytes }` on success. On failure, returns
- * `{ ok: false, indexBytes: 0, error }` with `error.kind`:
- *   - "missing-template" — `report.html.j2` (or any `extends`/`include` target)
- *      not found by either loader. Message identifies the missing path.
- *   - "syntax" — Nunjucks parse error in any loaded template.
- *   - "runtime" — anything else thrown during render or write.
- */
-export declare function renderReport(opts: RenderReportOptions): Promise<RenderReportResult>;