/**

* Shared helpers for CLI runner prompts, args, queueing, sessions, and image

* payload preparation.

*/

import crypto from "node:crypto";

import fs from "node:fs/promises";

import os from "node:os";

import type { SilentReplyPromptMode } from "../system-prompt.types.js";

import { sanitizeImageBlocks } from "../tool-images.js";

import { formatTomlConfigOverride } from "./toml-inline.js";

/** Re-export CLI reliability helpers used by older runner call sites. */

export { buildCliSupervisorScopeKey, resolveCliNoOutputTimeoutMs } from "./reliability.js";

const CLI_RUN_QUEUE = new KeyedAsyncQueue();

return normalizeOptionalLowercaseString(providerId) === "claude-cli";

}

/** Enqueues a CLI run under a backend/session key to prevent unsafe overlap. */

export function enqueueCliRun<T>(key: string, task: () => Promise<T>): Promise<T> {

return CLI_RUN_QUEUE.enqueue(key, task);

}

/** Resolves the serialization key for a CLI backend run. */

export function resolveCliRunQueueKey(params: {

backendId: string;

serialize?: boolean;

return params.backendId;

}

/** Builds the system prompt sent to a CLI-backed agent runtime. */

export function buildCliAgentSystemPrompt(params: {

workspaceDir: string;

cwd?: string;

});

}

/** Back-compat alias for the CLI system prompt builder. */

export const buildSystemPrompt = buildCliAgentSystemPrompt;

/** Applies backend model aliases to a requested CLI model id. */

export function normalizeCliModel(modelId: string, backend: CliBackendConfig): string {

const trimmed = modelId.trim();

if (!trimmed) {

return trimmed;

}

/** Decides whether a system prompt should be sent for this CLI turn. */

export function resolveSystemPromptUsage(params: {

backend: CliBackendConfig;

isNewSession: boolean;

return systemPrompt;

}

/** Resolves the CLI session id to send and whether the turn starts a new session. */

export function resolveSessionIdToSend(params: {

backend: CliBackendConfig;

cliSessionId?: string;

return { sessionId: crypto.randomUUID(), isNew: true };

}

/** Routes prompt text to argv or stdin based on backend input policy. */

export function resolvePromptInput(params: { backend: CliBackendConfig; prompt: string }): {

argsPrompt?: string;

stdin?: string;

return `${trimmed}${separator}${paths.map((entry) => `${prefix}${entry}`).join("\n")}`;

}

/** Loads and sanitizes image references found in prompt text. */

export async function loadPromptRefImages(params: {

prompt: string;

workspaceDir: string;

return sanitizedImages;

}

/** Writes CLI image payloads to private paths and returns their file paths. */

export async function writeCliImages(params: {

backend: CliBackendConfig;

workspaceDir: string;

return { paths, cleanup };

}

/** Writes a temporary system prompt file when the backend needs file-based prompts. */

export async function writeCliSystemPromptFile(params: {

backend: CliBackendConfig;

systemPrompt: string;

};

}

/** Prepares prompt text and image paths for a CLI backend run. */

export async function prepareCliPromptImagePayload(params: {

backend: CliBackendConfig;

prompt: string;

};

}

/** Builds final CLI argv from backend config and prepared prompt/session inputs. */

export function buildCliArgs(params: {

backend: CliBackendConfig;

baseArgs: string[];