*/

import {

type ChildProcess,

type ChildProcessByStdio,

spawn as nodeSpawn,

type SpawnOptions,

type SpawnOptionsWithStdioTuple,

type StdioNull,

type StdioPipe,

} from "node:child_process";

import type { Readable } from "node:stream";

import crossSpawn from "cross-spawn";

const EXIT_STDIO_GRACE_MS = 100;

export function spawnProcess(

command: string,

args: string[],

options: SpawnOptionsWithStdioTuple<StdioNull, StdioPipe, StdioPipe>,

): ChildProcessByStdio<null, Readable, Readable>;

export function spawnProcess(command: string, args: string[], options: SpawnOptions): ChildProcess;

export function spawnProcess(command: string, args: string[], options: SpawnOptions): ChildProcess {

return process.platform === "win32"

? crossSpawn(command, args, options)

: nodeSpawn(command, args, options);

}

/**

* Wait for a child process to terminate without hanging on inherited stdio handles.

*

* entity subset emitted by trusted HTML producers without parsing full HTML.

*/

/** Decoded entity text plus the source length consumed from the input. */

export interface DecodedHtmlEntity {

interface DecodedHtmlEntity {

text: string;

length: number;

}

}

/** Decodes a named or numeric HTML entity without the surrounding `&`/`;`. */

export function decodeHtmlEntity(entity: string): string | undefined {

function decodeHtmlEntity(entity: string): string | undefined {

switch (entity) {

case "amp":

return "&";

type ImageProbe,

} from "../../media/image-ops.js";

export interface ImageResizeOptions {

interface ImageResizeOptions {

maxWidth?: number; // Default: 2000

maxHeight?: number; // Default: 2000

maxBytes?: number; // Default: 4.5MB of base64 payload (below Anthropic's 5MB limit)

jpegQuality?: number; // Default: 80

}

export interface ResizedImage {

interface ResizedImage {

data: string; // base64

mimeType: string;

originalWidth: number;

const PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];

/** Detects supported image MIME types from leading file bytes. */

export function detectSupportedImageMimeType(buffer: Uint8Array): string | null {

function detectSupportedImageMimeType(buffer: Uint8Array): string | null {

if (startsWith(buffer, [0xff, 0xd8, 0xff])) {

return buffer[3] === 0xf7 ? null : "image/jpeg";

}

return isAbsolute(filePath) ? resolvePath(filePath) : resolvePath(cwd, filePath);

}

export function getCwdRelativePath(filePath: string, cwd: string): string | undefined {

function getCwdRelativePath(filePath: string, cwd: string): string | undefined {

const resolvedCwd = resolvePath(cwd);

const resolvedPath = resolveAgainstCwd(filePath, resolvedCwd);

const relativePath = relative(resolvedCwd, resolvedPath);