pi-agent-browser-native 0.9.4 → 0.9.6

package/dist/extensions/agent-browser/lib/results/presentation/navigation.js

@@ -1,231 +0,0 @@
-import { isNavigationObservableCommandName, isOpenNavigationCommand, isPageChangeSummaryCommand, } from "../../command-taxonomy.js";
-import { isRecord } from "../../parsing.js";
-import { detectConfirmationRequired } from "../confirmation.js";
-import { firstLine, omitUpstreamLifecycle, redactModelFacingText, stringifyModelFacing, } from "./common.js";
-const NAVIGATION_SUMMARY_FIELD = "navigationSummary";
-const GET_RESULT_FIELDS = {
-    attr: "value",
-    count: "count",
-    html: "html",
-    text: "text",
-    title: "title",
-    url: "url",
-    value: "value",
-};
-function getExtractionResultField(command, data) {
-    if (Object.hasOwn(data, "result")) {
-        return "result";
-    }
-    const field = command.command === "get" && command.subcommand !== undefined
-        ? GET_RESULT_FIELDS[command.subcommand]
-        : undefined;
-    return field !== undefined && field.length > 0 && Object.hasOwn(data, field) ? field : undefined;
-}
-function getScalarExtractionResult(command, data) {
-    const field = getExtractionResultField(command, data);
-    if (field === undefined) {
-        return undefined;
-    }
-    const result = data[field];
-    if (typeof result === "string") {
-        return result.trim().length > 0 ? result : "(empty string)";
-    }
-    if (typeof result === "number" || typeof result === "boolean") {
-        return String(result);
-    }
-    if (result === null || result === undefined) {
-        return "null";
-    }
-    return typeof result === "object" ? JSON.stringify(result, null, 2) : undefined;
-}
-function getExtractionOrigin(data) {
-    if (typeof data.origin === "string" && data.origin.trim().length > 0) {
-        return data.origin.trim();
-    }
-    return typeof data.url === "string" && data.url.trim().length > 0 ? data.url.trim() : undefined;
-}
-function formatGetSummaryLabel(subcommand) {
-    if (subcommand === undefined || subcommand.length === 0) {
-        return "Get result";
-    }
-    return subcommand.toLowerCase() === "url"
-        ? "URL"
-        : `${subcommand.slice(0, 1).toUpperCase()}${subcommand.slice(1)}`;
-}
-export function formatExtractionSummary(command, data) {
-    const result = getScalarExtractionResult(command, data);
-    if (result === undefined || result.length === 0) {
-        return undefined;
-    }
-    const line = firstLine(redactModelFacingText(result));
-    if (command.command === "get") {
-        return `${formatGetSummaryLabel(command.subcommand)}: ${line}`;
-    }
-    return command.command === "eval" ? `Eval result: ${line}` : undefined;
-}
-export function formatExtractionText(command, data) {
-    if (command.command !== "get" && command.command !== "eval") {
-        return undefined;
-    }
-    const result = getScalarExtractionResult(command, data);
-    if (result === undefined || result.length === 0) {
-        return undefined;
-    }
-    const origin = getExtractionOrigin(data);
-    const safeResult = redactModelFacingText(result);
-    const safeOrigin = origin !== undefined ? redactModelFacingText(origin) : undefined;
-    return safeOrigin !== undefined && safeOrigin.length > 0 && safeOrigin !== safeResult
-        ? `${safeResult}\n\nOrigin: ${safeOrigin}`
-        : safeResult;
-}
-export function isNavigationObservableCommand(command, subcommand) {
-    return isNavigationObservableCommandName(command, subcommand);
-}
-function isNavigationSummary(value) {
-    if (!isRecord(value)) {
-        return false;
-    }
-    return ((typeof value.title === "string" || typeof value.url === "string") &&
-        (value.title === undefined || typeof value.title === "string") &&
-        (value.url === undefined || typeof value.url === "string") &&
-        (value.urlChanged === undefined || typeof value.urlChanged === "boolean"));
-}
-export function getNavigationSummary(data) {
-    const value = data[NAVIGATION_SUMMARY_FIELD];
-    return isNavigationSummary(value) ? value : undefined;
-}
-function getTopLevelNavigationSummary(data) {
-    return isNavigationSummary(data)
-        ? {
-            title: typeof data.title === "string" ? data.title : undefined,
-            url: typeof data.url === "string" ? data.url : undefined,
-        }
-        : undefined;
-}
-function getNavigationText(value) {
-    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
-}
-function getNormalizedNavigationSummary(summary) {
-    const title = getNavigationText(summary?.title);
-    const url = getNavigationText(summary?.url);
-    return title !== undefined || url !== undefined
-        ? {
-            title,
-            url,
-            ...(typeof summary?.urlChanged === "boolean" ? { urlChanged: summary.urlChanged } : {}),
-        }
-        : undefined;
-}
-export function formatNavigationSummary(summary) {
-    const normalized = getNormalizedNavigationSummary(summary);
-    if (!normalized) {
-        return undefined;
-    }
-    return normalized.title !== undefined && normalized.url !== undefined
-        ? `${normalized.title}\n${normalized.url}`
-        : (normalized.title ?? normalized.url);
-}
-function getPageNavigation(command, data) {
-    if (!isRecord(data)) {
-        return undefined;
-    }
-    const summary = getNavigationSummary(data) ??
-        (isPageChangeSummaryCommand(command.command, command.subcommand)
-            ? getTopLevelNavigationSummary(data)
-            : undefined);
-    return getNormalizedNavigationSummary(summary);
-}
-function isNavigationObserved(command, navigation) {
-    return (navigation !== undefined &&
-        (navigation.urlChanged === true ||
-            isOpenNavigationCommand(command.command) ||
-            ["back", "forward", "pushstate", "reload"].includes(command.command ?? "")));
-}
-function getPageChangeKind(options, evidence) {
-    if (evidence.savedFilePath !== undefined || evidence.artifactCount > 0) {
-        return "artifact";
-    }
-    const navigation = evidence.navigation;
-    if (isNavigationObserved(options.commandInfo, navigation)) {
-        return "navigation";
-    }
-    if (detectConfirmationRequired(options.data) !== undefined) {
-        return "confirmation";
-    }
-    return navigation ||
-        isPageChangeSummaryCommand(options.commandInfo.command, options.commandInfo.subcommand)
-        ? "mutation"
-        : undefined;
-}
-function getPageChangeTargetParts(evidence) {
-    const parts = [evidence.navigation?.title, evidence.navigation?.url].filter((value) => value !== undefined);
-    if (evidence.savedFilePath !== undefined) {
-        parts.push(evidence.savedFilePath);
-    }
-    else if (evidence.artifactCount > 0) {
-        parts.push(`${evidence.artifactCount} artifact${evidence.artifactCount === 1 ? "" : "s"}`);
-    }
-    return parts;
-}
-function formatPageChangeText(command, evidence, kind) {
-    const observed = kind !== "mutation";
-    const parts = [
-        command.command ?? "agent-browser",
-        observed ? kind : "action dispatched",
-        ...getPageChangeTargetParts(evidence),
-    ];
-    return `${parts.join(" → ")}${observed ? "" : " → application change unverified"}`;
-}
-function getPageChangeIdentityFields(options, evidence) {
-    return {
-        ...(options.commandInfo.command !== undefined && options.commandInfo.command.length > 0
-            ? { command: options.commandInfo.command }
-            : {}),
-        ...(options.nextActions
-            ? { nextActionIds: options.nextActions.map((action) => action.id) }
-            : {}),
-        ...(evidence.savedFilePath !== undefined ? { savedFilePath: evidence.savedFilePath } : {}),
-        ...(evidence.navigation?.title !== undefined ? { title: evidence.navigation.title } : {}),
-        ...(evidence.navigation?.url !== undefined ? { url: evidence.navigation.url } : {}),
-    };
-}
-export function buildPageChangeSummary(options) {
-    const evidence = {
-        artifactCount: options.artifacts?.length ?? 0,
-        navigation: getPageNavigation(options.commandInfo, options.data),
-        savedFilePath: options.savedFilePath === "" ? undefined : options.savedFilePath,
-    };
-    const changeType = getPageChangeKind(options, evidence);
-    if (changeType === undefined) {
-        return undefined;
-    }
-    return {
-        ...getPageChangeIdentityFields(options, evidence),
-        ...(evidence.artifactCount > 0 ? { artifactCount: evidence.artifactCount } : {}),
-        changeType,
-        observed: changeType !== "mutation",
-        summary: formatPageChangeText(options.commandInfo, evidence, changeType),
-    };
-}
-function stripNavigationSummary(data) {
-    const { [NAVIGATION_SUMMARY_FIELD]: _navigationSummary, ...rest } = data;
-    return rest;
-}
-export function formatNavigationActionResult(data) {
-    const actionData = omitUpstreamLifecycle(stripNavigationSummary(data));
-    const lines = [];
-    if (typeof actionData.clicked === "string" || typeof actionData.clicked === "boolean") {
-        lines.push(`Clicked: ${String(actionData.clicked)}`);
-    }
-    if (typeof actionData.href === "string") {
-        lines.push(`Href: ${redactModelFacingText(actionData.href)}`);
-    }
-    if (typeof actionData.navigated === "boolean") {
-        lines.push(`Navigated: ${actionData.navigated}`);
-    }
-    if (lines.length > 0) {
-        return lines.join("\n");
-    }
-    const text = stringifyModelFacing(actionData).trim();
-    return text.length === 0 || text === "{}" ? undefined : text;
-}

package/dist/extensions/agent-browser/lib/results/presentation/notices.js

@@ -1,75 +0,0 @@
-import { isRecord } from "../../parsing.js";
-import { getSavedFileDetails } from "./artifacts.js";
-import { formatWebMcpCatalogUpdate } from "./common.js";
-import { formatNetworkRouteDiagnosticsText } from "./diagnostics.js";
-import { buildErrorPresentation } from "./errors.js";
-function appendNotice(draft, text) {
-    if (text !== undefined && text.length > 0 && draft.content[0]?.type === "text") {
-        draft.content[0] = { ...draft.content[0], text: `${draft.content[0].text}\n\n${text}` };
-    }
-}
-function getKeyboardInsertTextWarning(commandInfo) {
-    if (commandInfo.command !== "keyboard" || commandInfo.subcommand !== "inserttext") {
-        return undefined;
-    }
-    return "Input dispatch warning: keyboard inserttext skips key events. A DOM value change does not prove a framework-controlled editor accepted it; verify application state before saving, or use keyboard type when real key events are required.";
-}
-function applyRecordingError(draft, options, source) {
-    if (options.errorText === undefined ||
-        options.errorText.length === 0 ||
-        (!source.recordingCommand && !source.recordingBatch)) {
-        return;
-    }
-    const failure = buildErrorPresentation({
-        args: options.args,
-        commandInfo: options.commandInfo,
-        errorText: options.errorText,
-        presentationCommand: source.presentationCommandInfo.command,
-        sessionName: options.sessionName,
-    });
-    draft.resultCategory = "failure";
-    draft.failureCategory = failure.failureCategory;
-    draft.summary = failure.summary;
-    draft.content = [
-        {
-            type: "text",
-            text: `${failure.content[0]?.type === "text" ? failure.content[0].text : options.errorText}\n\n${draft.content[0]?.type === "text" ? draft.content[0].text : ""}`,
-        },
-    ];
-}
-function applyNetworkNotices(draft, options) {
-    const diagnostics = options.networkRouteDiagnostics;
-    if (diagnostics && diagnostics.length > 0 && draft.content[0]?.type === "text") {
-        const text = formatNetworkRouteDiagnosticsText(diagnostics);
-        if (text !== undefined && text.length > 0) {
-            draft.content[0] = { ...draft.content[0], text: `${text}\n\n${draft.content[0].text}` };
-        }
-        draft.networkRouteDiagnostics = diagnostics;
-    }
-}
-function applySavedFile(draft, source, commandInfo) {
-    if (!isRecord(source.data)) {
-        return;
-    }
-    const savedFile = getSavedFileDetails(commandInfo, source.data);
-    if (savedFile) {
-        draft.savedFile = savedFile;
-        draft.savedFilePath = savedFile.path;
-    }
-}
-export function applyPresentationNotices(draft, options, source) {
-    applyRecordingError(draft, options, source);
-    applyNetworkNotices(draft, options);
-    applySavedFile(draft, source, options.commandInfo);
-    const data = source.presentationData;
-    if (isRecord(data) &&
-        isRecord(data.webmcp) &&
-        (Array.isArray(data.webmcp.tools) || data.webmcp.status === "unavailable")) {
-        appendNotice(draft, formatWebMcpCatalogUpdate(data.webmcp));
-    }
-    if (options.commandInfo.command === "screenshot" &&
-        (options.args?.includes("--annotate") ?? false)) {
-        appendNotice(draft, "Annotated screenshot note: dense pages can produce overlapping labels. If the labels are noisy, capture a scoped element screenshot, take a non-annotated screenshot, or use snapshot -i high-value refs as the machine-readable map.");
-    }
-    appendNotice(draft, getKeyboardInsertTextWarning(source.commandInfo));
-}

package/dist/extensions/agent-browser/lib/results/presentation/observation-contracts.js

@@ -1 +0,0 @@
-export {};

package/dist/extensions/agent-browser/lib/results/presentation/observation-rendering.js

@@ -1,127 +0,0 @@
-import { isRecord } from "../../parsing.js";
-import { isSessionArtifactManifest } from "../artifact-manifest-validation.js";
-import { stringifyUnknown, truncateText } from "../text.js";
-import { applyArtifactManifest } from "./artifacts.js";
-import { redactModelFacingText } from "./common.js";
-import { OBSERVATION_INLINE_MAX_CHARS, projectAgentBrowserObservation } from "./content.js";
-import { buildSpillArtifactEntries, writeLargeOutputSpillFile, } from "./output-spill.js";
-function isJsonValue(value) {
-    if (value === null ||
-        typeof value === "string" ||
-        typeof value === "number" ||
-        typeof value === "boolean") {
-        return true;
-    }
-    if (Array.isArray(value)) {
-        return value.every(isJsonValue);
-    }
-    return isRecord(value) && Object.values(value).every(isJsonValue);
-}
-function toJsonValue(value) {
-    const parsed = JSON.parse(JSON.stringify(value));
-    if (!isJsonValue(parsed)) {
-        throw new Error("Serialized browser observation must be JSON.");
-    }
-    return parsed;
-}
-function getCompactSummary(observation) {
-    if (typeof observation.summary === "string") {
-        return truncateText(observation.summary, 700);
-    }
-    return typeof observation.error === "string" ? truncateText(observation.error, 700) : undefined;
-}
-function buildCompactObservation(observation, persisted) {
-    const compact = {
-        success: observation.success,
-        resultCategory: observation.resultCategory,
-        failureCategory: observation.failureCategory,
-        successCategory: observation.successCategory,
-        summary: getCompactSummary(observation),
-        compacted: true,
-        ...(persisted.spill
-            ? {
-                observationPath: persisted.spill.path,
-                retrieve: "Read observationPath for the complete redacted observation, including exact recovery actions and requested data.",
-            }
-            : {
-                observationUnavailable: truncateText(redactModelFacingText(persisted.error ?? "Spill could not be written; request a smaller result."), 1_000),
-            }),
-    };
-    for (const key of [
-        "sessionName",
-        "namespace",
-        "codeRun",
-        "error",
-        "failures",
-        "nextActions",
-        "artifactVerification",
-        "imageObservations",
-        "data",
-        "fullOutputPath",
-        "fullOutputPaths",
-    ]) {
-        if (observation[key] !== undefined &&
-            JSON.stringify({ ...compact, [key]: observation[key] }, null, 2).length <=
-                OBSERVATION_INLINE_MAX_CHARS - 500) {
-            compact[key] = observation[key];
-        }
-    }
-    return compact;
-}
-async function persistObservation(options, observation, prose, text) {
-    const manifest = isSessionArtifactManifest(options.details.artifactManifest)
-        ? options.details.artifactManifest
-        : undefined;
-    try {
-        const write = () => writeLargeOutputSpillFile({
-            data: { ...observation, ...(!options.json ? { text: prose } : {}) },
-            persistentArtifactStore: options.persistentArtifactStore,
-            text,
-        });
-        const spill = await (options.withArtifactWrite ? options.withArtifactWrite(write) : write());
-        return {
-            spill,
-            manifest: applyArtifactManifest({ content: [], summary: "" }, manifest, buildSpillArtifactEntries({
-                ...spill,
-                commandInfo: {
-                    command: typeof options.details.command === "string" ? options.details.command : undefined,
-                },
-            })).artifactManifest,
-        };
-    }
-    catch (error) {
-        return { manifest, error: error instanceof Error ? error.message : stringifyUnknown(error) };
-    }
-}
-/** Bound final model-visible output after recovery assembly; never truncate executable actions. */
-export async function renderAgentBrowserObservation(options) {
-    const observation = projectAgentBrowserObservation(options.details, options.succeeded);
-    let structuredContent = observation;
-    const images = options.content.filter((part) => part.type === "image");
-    const prose = options.content
-        .filter((part) => part.type === "text")
-        .map((part) => part.text)
-        .join("\n\n");
-    const { data: _data, error: _error, summary: _summary, ...metadata } = observation;
-    let text = options.json
-        ? JSON.stringify(observation, null, 2)
-        : `${prose}\n\nObservation: ${JSON.stringify(metadata)}`;
-    let manifest = isSessionArtifactManifest(options.details.artifactManifest)
-        ? options.details.artifactManifest
-        : undefined;
-    if (text.length > OBSERVATION_INLINE_MAX_CHARS ||
-        JSON.stringify(observation).length > OBSERVATION_INLINE_MAX_CHARS) {
-        const persisted = await persistObservation(options, observation, prose, text);
-        manifest = persisted.manifest;
-        structuredContent = buildCompactObservation(observation, persisted);
-        text = options.preserveContent === true ? prose : JSON.stringify(structuredContent, null, 2);
-        if (options.preserveContent !== true && !options.json) {
-            text = `Browser observation compacted.\n${text}`;
-        }
-    }
-    return {
-        content: [{ type: "text", text }, ...images],
-        artifactManifest: manifest,
-        structuredContent: toJsonValue(structuredContent),
-    };
-}

package/dist/extensions/agent-browser/lib/results/presentation/outcomes.js

@@ -1,120 +0,0 @@
-import { buildReadConfirmationNextActions } from "../../read-confirmation.js";
-import { buildAgentBrowserNextActions } from "../action-recommendations.js";
-import { buildAgentBrowserResultCategoryDetails } from "../categories.js";
-import { classifyPresentationSuccessCategory, formatMissingArtifactFailureText, hasMissingFileArtifact, } from "./artifacts.js";
-import { buildNetworkRequestsNextActions, buildStreamNextActions } from "./diagnostics.js";
-import { isOverlayBlockedClickError } from "./errors.js";
-import { buildPageChangeSummary } from "./navigation.js";
-function markFailure(draft, category, text, prepend) {
-    draft.resultCategory = "failure";
-    draft.failureCategory = category;
-    draft.successCategory = undefined;
-    draft.summary = text;
-    if (!prepend && draft.content[0]?.type === "text") {
-        draft.content[0] = { ...draft.content[0], text: `${text}\n\n${draft.content[0].text}` };
-    }
-    else {
-        draft.content.unshift({ type: "text", text });
-    }
-}
-function applyArtifactFailures(draft, options) {
-    const missing = formatMissingArtifactFailureText(draft.artifacts);
-    const hasError = options.errorText !== undefined && options.errorText.length > 0;
-    if (hasError) {
-        return;
-    }
-    if (missing !== undefined && missing.length > 0 && hasMissingFileArtifact(draft.artifacts)) {
-        markFailure(draft, "artifact-missing", missing, false);
-    }
-    const recording = draft.artifacts?.find((artifact) => artifact.recording?.success === false ||
-        artifact.recording?.output.encoderSucceeded === false);
-    if (recording) {
-        markFailure(draft, "upstream-error", `Recording failed: ${recording.recording?.error ?? "native capture/encoder failure"}`, true);
-    }
-}
-function classifyOutcome(draft, options, source) {
-    if (source.readConfirmation?.state === "pending") {
-        draft.readConfirmation = source.readConfirmation;
-        draft.resultCategory = "failure";
-        draft.failureCategory = "confirmation-required";
-        draft.successCategory = undefined;
-    }
-    if (draft.resultCategory === undefined) {
-        const categories = buildAgentBrowserResultCategoryDetails({
-            artifacts: draft.artifacts,
-            command: source.presentationCommandInfo.command,
-            confirmationRequired: source.confirmationRequired !== undefined,
-            errorText: options.envelope?.success === false ? draft.summary : undefined,
-            savedFile: draft.savedFile,
-            succeeded: options.envelope?.success !== false && source.confirmationRequired === undefined,
-        });
-        draft.resultCategory = categories.resultCategory;
-        draft.successCategory = categories.successCategory;
-        draft.failureCategory = categories.failureCategory;
-    }
-    if (draft.resultCategory === "success") {
-        draft.successCategory = classifyPresentationSuccessCategory({
-            artifactVerification: draft.artifactVerification,
-            artifacts: draft.artifacts,
-            savedFile: draft.savedFile,
-        });
-    }
-}
-function getGenericNextActions(draft, options, source) {
-    if (draft.nextActions) {
-        return undefined;
-    }
-    return buildAgentBrowserNextActions({
-        artifacts: draft.artifacts,
-        args: options.args,
-        command: source.presentationCommandInfo.command,
-        confirmationId: source.confirmationRequired?.id,
-        failureCategory: draft.failureCategory,
-        overlayBlockedClick: isOverlayBlockedClickError(source.presentationCommandInfo.command, options.envelope?.success === false ? draft.summary : undefined, options.args ?? source.presentationCommandInfo.commandTokens),
-        resultCategory: draft.resultCategory ?? "success",
-        savedFilePath: draft.savedFilePath,
-        sessionName: options.sessionName,
-        subcommand: source.presentationCommandInfo.subcommand,
-        successCategory: draft.successCategory,
-    });
-}
-function applyNextActions(draft, options, source) {
-    const generic = getGenericNextActions(draft, options, source);
-    const network = source.commandInfo.command === "network" &&
-        source.commandInfo.subcommand === "requests" &&
-        draft.resultCategory === "success"
-        ? buildNetworkRequestsNextActions(source.data, options.sessionName, draft.networkRouteDiagnostics)
-        : undefined;
-    const stream = draft.resultCategory === "success"
-        ? buildStreamNextActions(source.commandInfo, source.data, options.sessionName)
-        : undefined;
-    const merged = [draft.nextActions, generic, network, stream].flatMap((group) => group ?? []);
-    const fallback = merged.length > 0 ? merged : undefined;
-    draft.nextActions = source.readConfirmation
-        ? buildReadConfirmationNextActions(source.readConfirmation, true)
-        : fallback;
-}
-export function applyPresentationOutcome(draft, options, source) {
-    applyArtifactFailures(draft, options);
-    classifyOutcome(draft, options, source);
-    applyNextActions(draft, options, source);
-    draft.pageChangeSummary ??= buildPageChangeSummary({
-        artifacts: draft.artifacts,
-        commandInfo: source.presentationCommandInfo,
-        data: source.data,
-        nextActions: draft.nextActions,
-        savedFilePath: draft.savedFilePath,
-        summary: draft.summary,
-    });
-    if (draft.pageChangeSummary?.observed === false &&
-        source.presentationCommandInfo.command !== "batch" &&
-        draft.content[0]?.type === "text") {
-        draft.content[0] = {
-            ...draft.content[0],
-            text: `${draft.content[0].text}\n\nAction dispatched; application change unverified. Verify the expected URL, text, state, or external receipt before relying on it.`,
-        };
-    }
-    if (options.modelVisible === false) {
-        draft.content = [];
-    }
-}

package/dist/extensions/agent-browser/lib/results/presentation/output-completion.js

@@ -1,77 +0,0 @@
-import { getScreenshotCapture } from "../../orchestration/browser-run/screenshot-capture.js";
-import { isRecord } from "../../parsing.js";
-import { applyArtifactManifest, attachInlineImage, buildArtifactVerificationSummary, buildManifestEntriesForFileArtifacts, extractFileArtifacts, extractImagePath, isManifestFileArtifact, } from "./artifacts.js";
-import { getPresentationPaths } from "./content.js";
-import { compactLargePresentationOutput } from "./large-output.js";
-export async function extractPresentationArtifacts(options, source) {
-    return extractFileArtifacts({
-        artifactManifest: options.artifactManifest,
-        artifactMaxUpdatedAtMs: options.artifactMaxUpdatedAtMs,
-        artifactMinUpdatedAtMs: options.artifactMinUpdatedAtMs,
-        artifactRequest: options.artifactRequest,
-        commandInfo: source.presentationCommandInfo,
-        cwd: options.cwd,
-        data: source.data,
-        namespace: options.namespace,
-        recordingOutcome: source.recordingCommand ? options.envelope?.success : undefined,
-        recordingPending: options.recordingPending,
-        previousRecordingContactSheetPath: options.previousRecordingContactSheetPath,
-        sessionName: options.sessionName,
-    });
-}
-function getAttachableImage(options, source, artifacts) {
-    const path = getImagePath(options, source, artifacts);
-    if (path === undefined ||
-        path.length === 0 ||
-        (isRecord(source.data) && source.data.changed === false)) {
-        return undefined;
-    }
-    return artifacts.some((artifact) => artifact.absolutePath === path &&
-        ["missing", "stale", "failed"].includes(artifact.status ?? ""))
-        ? undefined
-        : path;
-}
-function getImagePath(options, source, artifacts) {
-    return (options.artifactRequest?.absolutePath ??
-        extractImagePath(options.commandInfo, options.cwd, source.data) ??
-        (source.recordingCommand
-            ? artifacts.find((artifact) => artifact.kind === "image" && artifact.status === "saved")
-                ?.absolutePath
-            : undefined));
-}
-async function attachPresentationImage(draft, options, source, artifacts) {
-    const imagePath = getAttachableImage(options, source, artifacts);
-    const withImage = imagePath === undefined
-        ? draft
-        : await attachInlineImage(draft, imagePath, options.modelVisible);
-    if (options.commandInfo.command === "screenshot" && withImage.imageObservations) {
-        const capture = getScreenshotCapture(source.commandInfo.commandTokens ?? []).kind;
-        withImage.imageObservations = withImage.imageObservations.map((image) => Object.assign({}, image, { capture }));
-    }
-    return withImage;
-}
-export async function completePresentationOutput(draft, options, source, artifacts) {
-    if (artifacts.length > 0 && !draft.artifacts) {
-        draft.artifacts = artifacts;
-    }
-    draft.artifactVerification ??= buildArtifactVerificationSummary(artifacts);
-    const withImage = await attachPresentationImage(draft, options, source, artifacts);
-    const compacted = options.modelVisible === false
-        ? withImage
-        : await compactLargePresentationOutput({
-            artifactManifest: options.artifactManifest,
-            commandInfo: options.commandInfo,
-            data: source.presentationData,
-            persistentArtifactStore: options.persistentArtifactStore,
-            presentation: withImage,
-        });
-    const withManifest = applyArtifactManifest(compacted, compacted.artifactManifest ?? options.artifactManifest, buildManifestEntriesForFileArtifacts(artifacts.filter(isManifestFileArtifact)));
-    const currentSpillPaths = new Set(getPresentationPaths({
-        primaryPath: withManifest.fullOutputPath,
-        secondaryPaths: withManifest.fullOutputPaths,
-    }));
-    withManifest.artifactVerification =
-        buildArtifactVerificationSummary(artifacts, withManifest.artifactManifest, currentSpillPaths) ??
-            withManifest.artifactVerification;
-    return withManifest;
-}