@inflexa-ai/harness 0.23.0 → 0.25.0

package/dist/tools/lib/preview-lock.d.ts

@@ -1,20 +0,0 @@
-/**
- * Per-previewId serialization for report iterations.
- *
- * Two iterations on the same preview must not race on its shared
- * `assets/` directory or version-dir creation. This lock ensures
- * sequential execution per previewId; iterations on different previewIds
- * remain fully parallel.
- *
- * SCOPE — in-process only. This Map is process-local: it serializes
- * iterations within one replica but gives NO cross-pod guarantee, and it
- * does not survive a DBOS replay. That is acceptable today because
- * `runReportIteration` runs in the in-process chat path (`passthroughStep`),
- * not as a durable workflow. When `iterateReport` is ported to a DBOS
- * workflow, replace this with a durable mechanism (a DBOS queue keyed by
- * previewId, or a Postgres advisory lock) — an in-process lock would then be
- * both a replay and a cross-replica correctness bug.
- */
-/** @internal — exposed for tests to assert no leak after settlement. */
-export declare const __previewLocksForTest: Map<string, Promise<unknown>>;
-export declare function withPreviewLock<T>(previewId: string, fn: () => Promise<T>): Promise<T>;

package/dist/tools/lib/preview-lock.js

@@ -1,35 +0,0 @@
-/**
- * Per-previewId serialization for report iterations.
- *
- * Two iterations on the same preview must not race on its shared
- * `assets/` directory or version-dir creation. This lock ensures
- * sequential execution per previewId; iterations on different previewIds
- * remain fully parallel.
- *
- * SCOPE — in-process only. This Map is process-local: it serializes
- * iterations within one replica but gives NO cross-pod guarantee, and it
- * does not survive a DBOS replay. That is acceptable today because
- * `runReportIteration` runs in the in-process chat path (`passthroughStep`),
- * not as a durable workflow. When `iterateReport` is ported to a DBOS
- * workflow, replace this with a durable mechanism (a DBOS queue keyed by
- * previewId, or a Postgres advisory lock) — an in-process lock would then be
- * both a replay and a cross-replica correctness bug.
- */
-const previewLocks = new Map();
-/** @internal — exposed for tests to assert no leak after settlement. */
-export const __previewLocksForTest = previewLocks;
-export async function withPreviewLock(previewId, fn) {
-    const prior = previewLocks.get(previewId) ?? Promise.resolve();
-    const next = prior.then(fn, fn);
-    // The stored promise must not surface as an unhandled rejection — callers
-    // only see/handle `next`. Swallow on the stored chain after running the
-    // cleanup hook.
-    const stored = next
-        .finally(() => {
-        if (previewLocks.get(previewId) === stored)
-            previewLocks.delete(previewId);
-    })
-        .catch(() => undefined);
-    previewLocks.set(previewId, stored);
-    return next;
-}

package/dist/tools/lib/report-preflight.d.ts

@@ -1,39 +0,0 @@
-/**
- * Report pre-flight — deterministic asset staging for iterate-report.
- *
- * Runs before the report-builder agent starts. Resolves each declared
- * source under the analysis root, enforces the 50MB cap, copies bytes
- * into the preview's shared assets/ dir, and enriches the brief with
- * inferred kind, size, CSV columns, head rows, and row count.
- *
- * The builder receives a complete brief and never has to discover or
- * stage anything itself.
- */
-export type AssetKind = "csv" | "tsv" | "image" | "json" | "other";
-export interface StagedAsset {
-    name: string;
-    path: string;
-    kind: AssetKind;
-    sizeBytes: number;
-    rowCount?: number;
-    columns?: string[];
-    headRows?: string[][];
-}
-export interface PreflightSource {
-    path: string;
-    as?: string;
-}
-export type PreflightResult = {
-    ok: true;
-    staged: StagedAsset[];
-} | {
-    ok: false;
-    reason: string;
-};
-export interface PreflightOptions {
-    sources: PreflightSource[];
-    analysisRoot: string;
-    assetsDirAbs: string;
-}
-export declare function stageReportAssets(opts: PreflightOptions): Promise<PreflightResult>;
-export declare function formatBytes(bytes: number): string;

package/dist/tools/lib/report-preflight.js

@@ -1,283 +0,0 @@
-/**
- * Report pre-flight — deterministic asset staging for iterate-report.
- *
- * Runs before the report-builder agent starts. Resolves each declared
- * source under the analysis root, enforces the 50MB cap, copies bytes
- * into the preview's shared assets/ dir, and enriches the brief with
- * inferred kind, size, CSV columns, head rows, and row count.
- *
- * The builder receives a complete brief and never has to discover or
- * stage anything itself.
- */
-import { copyFile, mkdir, open, realpath, stat } from "node:fs/promises";
-import { basename, extname, resolve, sep } from "node:path";
-const MAX_ASSET_BYTES = 50 * 1024 * 1024;
-const MAX_ASSET_LABEL = "50MB";
-const HEAD_BUF_BYTES = 64 * 1024;
-const HEAD_ROW_COUNT = 5;
-const COUNT_CHUNK_BYTES = 64 * 1024;
-// JSON enrichment parses the whole file to detect array-of-objects shape.
-// Cap below the 50MB asset limit so we don't synchronously parse huge files
-// just for metadata — large JSON gets staged but lands in the brief without
-// columns/rowCount, the same way a non-tabular JSON would.
-const JSON_ENRICH_MAX_BYTES = 5 * 1024 * 1024;
-export async function stageReportAssets(opts) {
-    await mkdir(opts.assetsDirAbs, { recursive: true });
-    // Canonicalize analysisRoot so containment checks work when the path
-    // traverses symlinks (e.g. macOS /var → /private/var).
-    const analysisRoot = await realpath(opts.analysisRoot);
-    // Dedupe by destination name. Identical (path, name) pairs collapse
-    // silently; conflicting names from different paths are an error.
-    const byName = new Map();
-    for (const src of opts.sources) {
-        const name = (src.as ?? basename(src.path)).trim();
-        if (!name) {
-            return { ok: false, reason: `source has no destination name: ${src.path}` };
-        }
-        const existing = byName.get(name);
-        if (existing && existing.path !== src.path) {
-            return {
-                ok: false,
-                reason: `duplicate asset name '${name}' from sources '${existing.path}' and '${src.path}' — use \`as\` to disambiguate`,
-            };
-        }
-        byName.set(name, src);
-    }
-    const staged = [];
-    for (const [name, src] of byName) {
-        const resolved = await resolveSource(src.path, analysisRoot);
-        if (!resolved.ok)
-            return resolved;
-        let st;
-        try {
-            st = await stat(resolved.path);
-        }
-        catch {
-            return { ok: false, reason: `source not found: ${src.path}` };
-        }
-        if (!st.isFile()) {
-            return { ok: false, reason: `source is not a regular file: ${src.path}` };
-        }
-        if (st.size > MAX_ASSET_BYTES) {
-            return {
-                ok: false,
-                reason: `source ${src.path} is ${formatBytes(st.size)} — exceeds ${MAX_ASSET_LABEL} cap`,
-            };
-        }
-        const dst = resolveDestination(name, opts.assetsDirAbs);
-        if (!dst.ok)
-            return dst;
-        await copyFile(resolved.path, dst.path);
-        const kind = inferKind(name);
-        const asset = {
-            name,
-            path: src.path,
-            kind,
-            sizeBytes: st.size,
-        };
-        if (kind === "csv" || kind === "tsv") {
-            const enriched = await enrichTabular(dst.path, kind === "tsv" ? "\t" : ",");
-            if (enriched.columns)
-                asset.columns = enriched.columns;
-            if (enriched.headRows)
-                asset.headRows = enriched.headRows;
-            if (enriched.rowCount !== undefined)
-                asset.rowCount = enriched.rowCount;
-        }
-        else if (kind === "json" && st.size <= JSON_ENRICH_MAX_BYTES) {
-            const enriched = await enrichJson(dst.path);
-            if (enriched.columns)
-                asset.columns = enriched.columns;
-            if (enriched.headRows)
-                asset.headRows = enriched.headRows;
-            if (enriched.rowCount !== undefined)
-                asset.rowCount = enriched.rowCount;
-        }
-        staged.push(asset);
-    }
-    return { ok: true, staged };
-}
-/**
- * Resolves a source path under analysisRoot and canonicalizes through
- * symlinks. Sandbox steps have RW access to their own output dir on the
- * shared session storage, so a malicious or compromised step could create
- * a symlink pointing outside the analysis tree (e.g. to /etc/passwd).
- * `path.resolve` is purely lexical — only `realpath` catches symlink
- * escapes — so we re-validate containment after canonicalization.
- */
-async function resolveSource(path, analysisRoot) {
-    if (path.includes("\0")) {
-        return { ok: false, reason: `source contains null byte: ${path}` };
-    }
-    if (path.startsWith("/")) {
-        return { ok: false, reason: `source must be relative to analysis root: ${path}` };
-    }
-    const lexical = resolve(analysisRoot, path);
-    if (lexical !== analysisRoot && !lexical.startsWith(analysisRoot + sep)) {
-        return { ok: false, reason: `source escapes analysis root: ${path}` };
-    }
-    let canonical;
-    try {
-        canonical = await realpath(lexical);
-    }
-    catch (err) {
-        if (err.code === "ENOENT") {
-            return { ok: false, reason: `source not found: ${path}` };
-        }
-        throw err;
-    }
-    if (canonical !== analysisRoot && !canonical.startsWith(analysisRoot + sep)) {
-        return { ok: false, reason: `source escapes analysis root via symlink: ${path}` };
-    }
-    return { ok: true, path: canonical };
-}
-function resolveDestination(name, assetsDirAbs) {
-    if (name.includes("\0")) {
-        return { ok: false, reason: `destination contains null byte: ${name}` };
-    }
-    // Reject any path-y name — assets/ is intentionally flat. `as: "subdir/x"`
-    // would otherwise pass the starts-with check but fail at copyFile time
-    // because the parent dir doesn't exist, bubbling an unhandled exception
-    // out of stageReportAssets's {ok} contract.
-    if (name !== basename(name)) {
-        return { ok: false, reason: `destination must be a flat filename (no path separators): ${name}` };
-    }
-    const resolved = resolve(assetsDirAbs, name);
-    if (!resolved.startsWith(assetsDirAbs + sep)) {
-        return { ok: false, reason: `destination escapes assets dir: ${name}` };
-    }
-    return { ok: true, path: resolved };
-}
-function inferKind(name) {
-    const ext = extname(name).toLowerCase();
-    if (ext === ".csv")
-        return "csv";
-    if (ext === ".tsv")
-        return "tsv";
-    if (ext === ".png" || ext === ".jpg" || ext === ".jpeg" || ext === ".svg" || ext === ".gif" || ext === ".webp") {
-        return "image";
-    }
-    if (ext === ".json")
-        return "json";
-    return "other";
-}
-async function enrichTabular(path, delim) {
-    const fd = await open(path, "r");
-    try {
-        const buf = Buffer.alloc(HEAD_BUF_BYTES);
-        const { bytesRead } = await fd.read(buf, 0, HEAD_BUF_BYTES, 0);
-        const head = buf.subarray(0, bytesRead).toString("utf8");
-        const lines = head.split(/\r?\n/);
-        if (lines.length === 0 || lines[0].length === 0)
-            return {};
-        const columns = parseLine(lines[0], delim);
-        const headRows = [];
-        for (let i = 1; i < lines.length && headRows.length < HEAD_ROW_COUNT; i++) {
-            if (lines[i].length === 0)
-                continue;
-            headRows.push(parseLine(lines[i], delim));
-        }
-        const rowCount = await countRows(fd);
-        const result = {
-            columns,
-        };
-        if (headRows.length > 0)
-            result.headRows = headRows;
-        if (rowCount !== undefined)
-            result.rowCount = rowCount;
-        return result;
-    }
-    finally {
-        await fd.close();
-    }
-}
-function parseLine(line, delim) {
-    // Naive split — sufficient for analysis output where fields rarely contain
-    // delimiters or embedded newlines. The builder reads the actual file via the
-    // assets/ symlink for rendering; the brief just surfaces column names so the
-    // conv agent can compose section content correctly.
-    return line.split(delim).map((s) => s.replace(/^"|"$/g, ""));
-}
-/**
- * Detect array-of-objects JSON shape so the brief surfaces columns + a few
- * head rows the same way it does for CSV/TSV. Anything other than a top-level
- * array of objects (e.g. ECharts options, scalar config, nested aggregates)
- * is staged with no enrichment — the builder can still load it client-side
- * and use it directly, but the conv agent picks chart encoding without
- * column hints. Parses the full file; caller caps file size upstream.
- */
-async function enrichJson(path) {
-    let parsed;
-    try {
-        const { readFile } = await import("node:fs/promises");
-        parsed = JSON.parse(await readFile(path, "utf8"));
-    }
-    catch {
-        return {};
-    }
-    if (!Array.isArray(parsed) || parsed.length === 0)
-        return {};
-    // Sample the first non-null object for keys. Mixed-shape arrays still get
-    // first-element keys — good enough for the brief; renderer reads the file
-    // directly anyway.
-    const first = parsed.find((r) => r && typeof r === "object" && !Array.isArray(r));
-    if (!first)
-        return { rowCount: parsed.length };
-    const columns = Object.keys(first);
-    const headRows = [];
-    for (let i = 0; i < parsed.length && headRows.length < HEAD_ROW_COUNT; i++) {
-        const r = parsed[i];
-        if (!r || typeof r !== "object" || Array.isArray(r))
-            continue;
-        const obj = r;
-        headRows.push(columns.map((c) => stringifyCell(obj[c])));
-    }
-    const result = {
-        columns,
-        rowCount: parsed.length,
-    };
-    if (headRows.length > 0)
-        result.headRows = headRows;
-    return result;
-}
-function stringifyCell(v) {
-    if (v === null || v === undefined)
-        return "";
-    if (typeof v === "string")
-        return v;
-    if (typeof v === "number" || typeof v === "boolean")
-        return String(v);
-    return JSON.stringify(v);
-}
-async function countRows(fd) {
-    const buf = Buffer.alloc(COUNT_CHUNK_BYTES);
-    let newlines = 0;
-    let pos = 0;
-    let lastByte = -1;
-    while (true) {
-        const { bytesRead } = await fd.read(buf, 0, buf.length, pos);
-        if (bytesRead === 0)
-            break;
-        for (let i = 0; i < bytesRead; i++) {
-            if (buf[i] === 0x0a)
-                newlines++;
-        }
-        lastByte = buf[bytesRead - 1];
-        pos += bytesRead;
-    }
-    if (pos === 0)
-        return 0;
-    // If the file doesn't end with a newline, the last row wasn't counted.
-    const total = lastByte === 0x0a ? newlines : newlines + 1;
-    // Subtract one for the header.
-    return Math.max(0, total - 1);
-}
-export function formatBytes(bytes) {
-    if (bytes < 1024)
-        return `${bytes}B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)}KB`;
-    if (bytes < 1024 * 1024 * 1024)
-        return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
-    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)}GB`;
-}

package/dist/tools/report/build-report.d.ts

@@ -1,13 +0,0 @@
-/**
- * build_report tool — renders `report.html.j2` → `index.html` via the
- * in-process Nunjucks renderer. Closes over the runner's preview-dir state.
- *
- * Returns structured success or a typed error so the agent can fix and retry.
- * Version dir and templates dir are closure-state.
- */
-import { type Tool } from "../define-tool.js";
-export interface BuildReportToolState {
-    readonly versionDir: string;
-    readonly templatesDir: string;
-}
-export declare function createBuildReportTool(state: BuildReportToolState): Tool;

package/dist/tools/report/build-report.js

@@ -1,27 +0,0 @@
-/**
- * build_report tool — renders `report.html.j2` → `index.html` via the
- * in-process Nunjucks renderer. Closes over the runner's preview-dir state.
- *
- * Returns structured success or a typed error so the agent can fix and retry.
- * Version dir and templates dir are closure-state.
- */
-import { ok } from "neverthrow";
-import { z } from "zod";
-import { defineTool } from "../define-tool.js";
-import { renderReport } from "../../execution/report-render.js";
-export function createBuildReportTool(state) {
-    return defineTool({
-        id: "build_report",
-        description: "Render the report by compiling report.html.j2 into index.html. " +
-            "Always use this — never invoke a build script directly. Returns " +
-            "structured errors with line numbers when the template is broken.",
-        inputSchema: z.object({}),
-        describeCall: "none",
-        execute: async () => {
-            return ok(await renderReport({
-                versionDir: state.versionDir,
-                templatesDir: state.templatesDir,
-            }));
-        },
-    });
-}

package/dist/tools/report/index.d.ts

@@ -1,15 +0,0 @@
-/**
- * Report-tool barrel. These tools are NOT registered on the conversation
- * agent — they are constructed inside `harness/execution/report-runner.ts`
- * so each tool factory shares the runner's closure-captured outcome state
- * and preview-dir paths. The conversation agent reaches the report-builder
- * through its `submit_report` tool, which orchestrates the whole iteration.
- * (That conversation-agent tool shares the id `submit_report` with this
- * barrel's builder-side terminal tool — different rosters, never mixed.)
- */
-export { createBuildReportTool, type BuildReportToolState } from "./build-report.js";
-export { createSubmitReportTool, type ReportOutcome, type SubmitReportToolState } from "./submit-report.js";
-export { createMintPreviewUrlTool, type MintPreviewUrlToolState, type PreviewUrlCell } from "./mint-preview-url.js";
-export { createPreviewSnapshotTool, type PreviewSnapshotToolState } from "./preview-snapshot.js";
-export { createVersionFsTools, type VersionFsToolsState } from "./version-fs.js";
-export { type PreviewPublisher, type PreviewMintResult, UnavailablePreviewPublisher } from "./preview-publisher.js";

package/dist/tools/report/index.js

@@ -1,15 +0,0 @@
-/**
- * Report-tool barrel. These tools are NOT registered on the conversation
- * agent — they are constructed inside `harness/execution/report-runner.ts`
- * so each tool factory shares the runner's closure-captured outcome state
- * and preview-dir paths. The conversation agent reaches the report-builder
- * through its `submit_report` tool, which orchestrates the whole iteration.
- * (That conversation-agent tool shares the id `submit_report` with this
- * barrel's builder-side terminal tool — different rosters, never mixed.)
- */
-export { createBuildReportTool } from "./build-report.js";
-export { createSubmitReportTool } from "./submit-report.js";
-export { createMintPreviewUrlTool } from "./mint-preview-url.js";
-export { createPreviewSnapshotTool } from "./preview-snapshot.js";
-export { createVersionFsTools } from "./version-fs.js";
-export { UnavailablePreviewPublisher } from "./preview-publisher.js";

package/dist/tools/report/mint-preview-url.d.ts

@@ -1,26 +0,0 @@
-/**
- * mint_preview_url tool — get a content-server URL for the report preview.
- *
- * Calls the preview-access seam and returns the full navigatable URL
- * for the requested version.
- *
- * Most callers don't need this — `preview_snapshot` mints lazily on first
- * use. Reach for this tool when:
- *   - the previously-minted URL has expired
- *   - inspecting an older version (pass `version`)
- */
-import { type Tool } from "../define-tool.js";
-import { type PreviewPublisher } from "./preview-publisher.js";
-/** Shared, mutable URL cell so mint and preview-snapshot share a cached URL. */
-export interface PreviewUrlCell {
-    url: string | undefined;
-    expiresAt: string | undefined;
-}
-export interface MintPreviewUrlToolState {
-    readonly resourceId: string;
-    readonly previewId: string;
-    readonly currentVersion: number;
-    readonly previews: PreviewPublisher;
-    readonly urlCell: PreviewUrlCell;
-}
-export declare function createMintPreviewUrlTool(state: MintPreviewUrlToolState): Tool;

package/dist/tools/report/mint-preview-url.js

@@ -1,47 +0,0 @@
-/**
- * mint_preview_url tool — get a content-server URL for the report preview.
- *
- * Calls the preview-access seam and returns the full navigatable URL
- * for the requested version.
- *
- * Most callers don't need this — `preview_snapshot` mints lazily on first
- * use. Reach for this tool when:
- *   - the previously-minted URL has expired
- *   - inspecting an older version (pass `version`)
- */
-import { ok } from "neverthrow";
-import { z } from "zod";
-import { defineTool } from "../define-tool.js";
-import { describeMintFailure } from "./preview-publisher.js";
-export function createMintPreviewUrlTool(state) {
-    return defineTool({
-        id: "mint_preview_url",
-        description: "Mint a fresh preview URL for the report. Returns a time-limited " +
-            "content-server URL with an embedded auth token, alongside the " +
-            "`expiresAt` it is good until. Use this only when you need a URL for " +
-            "direct browser navigation — preview_snapshot handles the common case " +
-            "automatically.",
-        inputSchema: z.object({
-            version: z.number().optional().describe("Version to mint for. Defaults to the iteration's current version."),
-        }),
-        describeCall: "none",
-        execute: async (input) => {
-            const version = input.version ?? state.currentVersion;
-            const result = await state.previews.mintPreviewAccess(state.resourceId, state.previewId);
-            if (!result.ok) {
-                return ok({
-                    ok: false,
-                    error: describeMintFailure(result),
-                });
-            }
-            const url = `${result.data.baseUrl.replace(/\/?$/, "/")}v${version}/index.html?t=${result.data.token}`;
-            state.urlCell.url = url;
-            state.urlCell.expiresAt = result.data.expiresAt;
-            return ok({
-                ok: true,
-                url,
-                expiresAt: result.data.expiresAt,
-            });
-        },
-    });
-}

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

@@ -1,53 +0,0 @@
-/**
- * PreviewPublisher — the seam between the harness report path and the hosted
- * preview surface. The report build itself (FS + Nunjucks + LLM via
- * `ChatProvider`) is pure in-process; the only thing that reaches outside
- * the process is minting a content-server URL for the headless-Chrome
- * preview. That mint is hidden behind this one method.
- *
- * The managed implementation (HostedPreviewPublisher) owns the access
- * grant mint + managed client. The local default (UnavailablePreviewPublisher)
- * returns not-ok, so `preview_snapshot` short-circuits before touching
- * Chrome and the report still builds (submit_report is the only gate).
- */
-export type PreviewMintResult = {
-    ok: true;
-    data: {
-        baseUrl: string;
-        token: string;
-        expiresAt: string;
-    };
-} | {
-    ok: false;
-    status?: number;
-    error: {
-        message?: string;
-    };
-};
-/** The not-ok arm of the seam's result — what a failed mint is allowed to carry. */
-export type PreviewMintFailure = Extract<PreviewMintResult, {
-    ok: false;
-}>;
-/**
- * Renders a failed mint as the line an agent reads back from a preview tool.
- *
- * The failure shape is sparse by design: a realization with no HTTP transport
- * behind it supplies neither a status nor, necessarily, a message. Naming a
- * field the seam left unset would put the literal `status=undefined` in front
- * of the model, so the message carries only what actually arrived. This lives
- * beside the type because its whole job is to honour that type's optionality —
- * every tool holding the seam owes the same message, and one of them owning
- * the wording would make the others depend on a peer for a seam-wide concern.
- */
-export declare function describeMintFailure(failure: PreviewMintFailure): string;
-export interface PreviewPublisher {
-    mintPreviewAccess(resourceId: string, previewId: string): Promise<PreviewMintResult>;
-}
-/**
- * Local default — no hosted preview surface. Returns not-ok so the preview
- * tools surface a clear "unavailable" message and short-circuit before any
- * browser navigation.
- */
-export declare class UnavailablePreviewPublisher implements PreviewPublisher {
-    mintPreviewAccess(_resourceId: string, _previewId: string): Promise<PreviewMintResult>;
-}

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

@@ -1,45 +0,0 @@
-/**
- * PreviewPublisher — the seam between the harness report path and the hosted
- * preview surface. The report build itself (FS + Nunjucks + LLM via
- * `ChatProvider`) is pure in-process; the only thing that reaches outside
- * the process is minting a content-server URL for the headless-Chrome
- * preview. That mint is hidden behind this one method.
- *
- * The managed implementation (HostedPreviewPublisher) owns the access
- * grant mint + managed client. The local default (UnavailablePreviewPublisher)
- * returns not-ok, so `preview_snapshot` short-circuits before touching
- * Chrome and the report still builds (submit_report is the only gate).
- */
-/**
- * Renders a failed mint as the line an agent reads back from a preview tool.
- *
- * The failure shape is sparse by design: a realization with no HTTP transport
- * behind it supplies neither a status nor, necessarily, a message. Naming a
- * field the seam left unset would put the literal `status=undefined` in front
- * of the model, so the message carries only what actually arrived. This lives
- * beside the type because its whole job is to honour that type's optionality —
- * every tool holding the seam owes the same message, and one of them owning
- * the wording would make the others depend on a peer for a seam-wide concern.
- */
-export function describeMintFailure(failure) {
-    const detail = [];
-    if (failure.status !== undefined)
-        detail.push(`status=${failure.status}`);
-    const message = failure.error.message?.trim();
-    if (message)
-        detail.push(message);
-    return detail.length > 0 ? `preview-access mint failed: ${detail.join(" ")}` : "preview-access mint failed";
-}
-/**
- * Local default — no hosted preview surface. Returns not-ok so the preview
- * tools surface a clear "unavailable" message and short-circuit before any
- * browser navigation.
- */
-export class UnavailablePreviewPublisher {
-    async mintPreviewAccess(_resourceId, _previewId) {
-        return {
-            ok: false,
-            error: { message: "report preview is unavailable in this environment" },
-        };
-    }
-}

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

@@ -1,34 +0,0 @@
-/**
- * preview_snapshot tool — navigate headless Chrome to the rendered report,
- * wait for the `inflexa-theme-ready` event, capture a screenshot + console
- * messages + failed network requests in a single deterministic call.
- *
- * Lazily mints a preview URL via the `PreviewPublisher` seam on first use,
- * sharing the cached URL with the `mint_preview_url` tool via a
- * closure-captured `PreviewUrlCell`.
- *
- * Returned screenshot is base64-encoded PNG bytes; the agent can inspect
- * console errors / failed requests to decide whether to fix the template
- * or move on to submit_report.
- *
- * A seam that cannot mint is also reported through the injected `Logger`:
- * this tool is the build's only visual verification, so an unavailable seam
- * means that verification silently did not happen — a condition an operator
- * has to be able to see without reading the model transcript.
- */
-import { type Tool } from "../define-tool.js";
-import type { ChromeConfig } from "../../lib/chrome.js";
-import type { Logger } from "../../lib/logger.js";
-import { type PreviewPublisher } from "./preview-publisher.js";
-import type { PreviewUrlCell } from "./mint-preview-url.js";
-export interface PreviewSnapshotToolState {
-    readonly resourceId: string;
-    readonly previewId: string;
-    readonly currentVersion: number;
-    readonly previews: PreviewPublisher;
-    readonly urlCell: PreviewUrlCell;
-    readonly chrome: ChromeConfig;
-    /** Operational logging seam; omitted falls back to no-op. */
-    readonly logger?: Logger;
-}
-export declare function createPreviewSnapshotTool(state: PreviewSnapshotToolState): Tool;