@myagentroam/agent 0.11.32 → 0.11.34

package/dist/agent-core/tools/local/image-processing.js

@@ -1,146 +0,0 @@
-import { MarAgentError } from '../../error.js';
-import { TOOL_EXECUTION_LIMITS } from '../execution-limits.js';
-export async function readImageMetadata(data, mimeType, signal) {
-    throwIfAborted(signal);
-    try {
-        const sharp = await loadSharp();
-        const metadata = await sharp(data, {
-            failOn: 'warning',
-            limitInputPixels: TOOL_EXECUTION_LIMITS.viewImageMaxPixels,
-            pages: 1
-        }).metadata();
-        throwIfAborted(signal);
-        if (metadata.format !== expectedSharpFormat(mimeType) ||
-            !isPositiveSafeInteger(metadata.width) ||
-            !isPositiveSafeInteger(metadata.height))
-            return incompleteImage();
-        const width = metadata.autoOrient?.width ?? metadata.width;
-        const height = metadata.autoOrient?.height ?? metadata.height;
-        assertPixelLimit(width, height);
-        return { width, height, pages: metadata.pages ?? 1, mimeType };
-    }
-    catch (error) {
-        throwIfAborted(signal);
-        if (error instanceof MarAgentError)
-            throw error;
-        if (isPixelLimitError(error))
-            return imagePixelLimit();
-        return incompleteImage();
-    }
-}
-export async function processImage(data, metadata, options, signal) {
-    throwIfAborted(signal);
-    if (metadata.pages > 1)
-        throw new MarAgentError('MAR_AGENT_IMAGE_FORMAT_UNSUPPORTED', 'Animated images cannot be cropped or resized.');
-    const region = options.region;
-    const regionWidth = region?.width ?? metadata.width;
-    const regionHeight = region?.height ?? metadata.height;
-    const resize = options.resize;
-    try {
-        const sharp = await loadSharp();
-        const image = sharp(data, {
-            failOn: 'warning',
-            limitInputPixels: TOOL_EXECUTION_LIMITS.viewImageMaxPixels,
-            pages: 1,
-            autoOrient: true
-        });
-        if (region)
-            image.extract({
-                left: region.x,
-                top: region.y,
-                width: region.width,
-                height: region.height
-            });
-        if (resize) {
-            image.resize({
-                ...(resize.maxWidth === undefined ? {} : { width: Math.min(resize.maxWidth, regionWidth) }),
-                ...(resize.maxHeight === undefined
-                    ? {}
-                    : { height: Math.min(resize.maxHeight, regionHeight) }),
-                fit: 'inside',
-                withoutEnlargement: true
-            });
-        }
-        switch (metadata.mimeType) {
-            case 'image/png':
-                image.png();
-                break;
-            case 'image/jpeg':
-                image.jpeg({ quality: 90 });
-                break;
-            case 'image/webp':
-                image.webp({ quality: 90 });
-                break;
-        }
-        const output = await image.toBuffer({ resolveWithObject: true });
-        throwIfAborted(signal);
-        if (output.data.byteLength > TOOL_EXECUTION_LIMITS.viewImageMaxBytes)
-            throw imageOutputLimit();
-        const changedRegion = region !== undefined &&
-            (region.x !== 0 ||
-                region.y !== 0 ||
-                region.width !== metadata.width ||
-                region.height !== metadata.height);
-        const changedSize = output.info.width !== regionWidth || output.info.height !== regionHeight;
-        return {
-            bytes: output.data,
-            width: output.info.width,
-            height: output.info.height,
-            mimeType: metadata.mimeType,
-            ...(changedRegion || changedSize
-                ? { sourceWidth: metadata.width, sourceHeight: metadata.height }
-                : {}),
-            ...(changedRegion ? { region } : {})
-        };
-    }
-    catch (error) {
-        throwIfAborted(signal);
-        if (error instanceof MarAgentError)
-            throw error;
-        if (isPixelLimitError(error))
-            return imagePixelLimit();
-        return incompleteImage();
-    }
-}
-function expectedSharpFormat(mimeType) {
-    switch (mimeType) {
-        case 'image/png':
-            return 'png';
-        case 'image/jpeg':
-            return 'jpeg';
-        case 'image/webp':
-            return 'webp';
-    }
-}
-function assertPixelLimit(width, height) {
-    if (!isPositiveSafeInteger(width) ||
-        !isPositiveSafeInteger(height) ||
-        width > Math.floor(TOOL_EXECUTION_LIMITS.viewImageMaxPixels / height))
-        imagePixelLimit();
-}
-function isPositiveSafeInteger(value) {
-    return Number.isSafeInteger(value) && value > 0;
-}
-function isPixelLimitError(error) {
-    return error instanceof Error && /pixel limit/iu.test(error.message);
-}
-function throwIfAborted(signal) {
-    signal?.throwIfAborted();
-}
-function imageOutputLimit() {
-    return new MarAgentError('MAR_AGENT_TOOL_OUTPUT_LIMIT', `Image output exceeds ${TOOL_EXECUTION_LIMITS.viewImageMaxBytes} bytes. Use a smaller resize or region.`);
-}
-function imagePixelLimit() {
-    throw new MarAgentError('MAR_AGENT_TOOL_OUTPUT_LIMIT', `Image exceeds the source pixel-area limit (equivalent to ${Math.sqrt(TOOL_EXECUTION_LIMITS.viewImageMaxPixels)}×${Math.sqrt(TOOL_EXECUTION_LIMITS.viewImageMaxPixels)} pixels).`);
-}
-function incompleteImage() {
-    throw new MarAgentError('MAR_AGENT_IMAGE_INCOMPLETE', 'Image file is incomplete, malformed, or changed while reading. Wait for the writer to finish and read it again.');
-}
-async function loadSharp() {
-    try {
-        return (await import('sharp')).default;
-    }
-    catch {
-        throw new MarAgentError('MAR_AGENT_IMAGE_PROCESSING_UNAVAILABLE', 'Native image processing is unavailable because the sharp dependency could not be loaded.');
-    }
-}

package/dist/agent-core/tools/local/read-context.js

@@ -1,152 +0,0 @@
-import { decodeMarkupText, markupAttributes, markupText, parseMarkupAttributes } from '../../prompts/markup.js';
-export function formatReadContextItem(index, metadata, content) {
-    const { oversizedLine, ...values } = metadata;
-    const header = `<mar_read_result${markupAttributes({ index, path: metadata.path, pathTruncated: metadata.pathTruncated })}>`;
-    const info = oversizedLine && typeof oversizedLine === 'object'
-        ? `<metadata${markupAttributes(values)}>\n    <oversized_line${markupAttributes(oversizedLine)} />\n  </metadata>`
-        : `<metadata${markupAttributes(values)} />`;
-    return [header, '  ' + markupText('content', content), '  ' + info, '</mar_read_result>'].join('\n');
-}
-function metadataValues(values) {
-    const result = {};
-    for (const [key, value] of Object.entries(values)) {
-        if (key === 'path')
-            result[key] = value;
-        else if (key === 'encoding' && ['utf-8', 'utf-16le', 'utf-16be'].includes(value))
-            result[key] = value;
-        else if (key === 'newline' && ['lf', 'crlf'].includes(value))
-            result[key] = value;
-        else if (['pathTruncated', 'eof', 'truncated', 'previewComplete'].includes(key)) {
-            if (value !== 'true' && value !== 'false')
-                throw new Error('MAR_AGENT_MARKUP_INVALID');
-            result[key] = value === 'true';
-        }
-        else if (['startLine', 'endLine', 'nextOffset'].includes(key)) {
-            if (!/^[0-9]+$/u.test(value) || !Number.isSafeInteger(Number(value)) || Number(value) < 1)
-                throw new Error('MAR_AGENT_MARKUP_INVALID');
-            result[key] = Number(value);
-        }
-        else
-            throw new Error('MAR_AGENT_MARKUP_INVALID');
-    }
-    return result;
-}
-export function parseReadContextOutput(value) {
-    try {
-        if (!value.startsWith('<mar_read_'))
-            return undefined;
-        const items = [];
-        const indexes = new Set();
-        let offset = 0;
-        while (offset < value.length) {
-            const header = /^<mar_read_(result|error)([^<>]*)>/.exec(value.slice(offset));
-            if (!header)
-                return undefined;
-            const attrs = parseMarkupAttributes(header[2]);
-            const index = Number(attrs.index);
-            if (!/^[0-9]+$/u.test(attrs.index ?? '') || !Number.isSafeInteger(index))
-                return undefined;
-            if (indexes.has(index))
-                return undefined;
-            indexes.add(index);
-            if (header[1] === 'error') {
-                if (!attrs.code ||
-                    Object.keys(attrs).some((key) => !['index', 'path', 'pathTruncated', 'code', 'detailsTruncated'].includes(key)))
-                    return undefined;
-                if (['pathTruncated', 'detailsTruncated'].some((key) => attrs[key] !== undefined && attrs[key] !== 'true' && attrs[key] !== 'false'))
-                    return undefined;
-                const end = value.indexOf('</mar_read_error>', offset + header[0].length);
-                if (end < 0)
-                    return undefined;
-                const body = value.slice(offset + header[0].length, end).trim();
-                if (body !== '<message />') {
-                    if (!body.startsWith('<message>') || !body.endsWith('</message>'))
-                        return undefined;
-                    decodeMarkupText(body.slice(9, -10));
-                }
-                offset = end + '</mar_read_error>'.length;
-            }
-            else {
-                if (!attrs.path ||
-                    Object.keys(attrs).some((key) => !['index', 'path', 'pathTruncated'].includes(key)) ||
-                    (attrs.pathTruncated !== undefined &&
-                        attrs.pathTruncated !== 'true' &&
-                        attrs.pathTruncated !== 'false'))
-                    return undefined;
-                const contentStart = offset + header[0].length + 3;
-                if (value.slice(contentStart - 3, contentStart) !== '\n  ')
-                    return undefined;
-                const contentEnd = value.indexOf('\n  ' + '<metadata', contentStart);
-                if (contentEnd < 0)
-                    return undefined;
-                const body = value.slice(contentStart, contentEnd);
-                let content;
-                if (body === '<content />')
-                    content = '';
-                else if (body.startsWith('<content>') && body.endsWith('</content>'))
-                    content = decodeMarkupText(body.slice(9, -10));
-                else {
-                    const reclaimed = /^<mar_context_gc([^<>]*)>\s*<instruction>([^<]*)<\/instruction>\s*<\/mar_context_gc>$/u.exec(body);
-                    if (!reclaimed || parseMarkupAttributes(reclaimed[1]).kind !== 'stale_read')
-                        return undefined;
-                    decodeMarkupText(reclaimed[2]);
-                    content = body;
-                }
-                const end = value.indexOf('\n' + '</mar_read_result>', contentEnd);
-                if (end < 0)
-                    return undefined;
-                const info = value.slice(contentEnd + 3, end);
-                const meta = /^<metadata([^<>]*?)(?: \/>|>\s*<oversized_line([^<>]*) \/>\s*<\/metadata>)$/u.exec(info);
-                if (!meta)
-                    return undefined;
-                const metadata = metadataValues(parseMarkupAttributes(meta[1]));
-                if (metadata.path !== attrs.path ||
-                    (metadata.pathTruncated === true) !== (attrs.pathTruncated === 'true'))
-                    return undefined;
-                if (meta[2] !== undefined) {
-                    const oversized = parseMarkupAttributes(meta[2]);
-                    if (Object.keys(oversized).length !== 4 ||
-                        Object.keys(oversized).some((key) => !['line', 'bytes', 'shownBytes', 'omittedBytes'].includes(key)) ||
-                        Object.values(oversized).some((number) => !/^[0-9]+$/u.test(number) || !Number.isSafeInteger(Number(number))))
-                        return undefined;
-                    metadata.oversizedLine = Object.fromEntries(Object.entries(oversized).map(([key, number]) => [key, Number(number)]));
-                }
-                items.push({
-                    index,
-                    path: attrs.path,
-                    pathTruncated: attrs.pathTruncated === 'true',
-                    content,
-                    metadata,
-                    contentStart,
-                    contentEnd
-                });
-                offset = end + 1 + '</mar_read_result>'.length;
-            }
-            if (offset < value.length) {
-                if (value[offset] !== '\n')
-                    return undefined;
-                offset++;
-            }
-        }
-        return { items };
-    }
-    catch {
-        return undefined;
-    }
-}
-export function replaceReadContextItems(value, replacements) {
-    const parsed = parseReadContextOutput(value);
-    if (!parsed)
-        return value;
-    const byIndex = new Map(replacements.map((replacement) => [replacement.index, replacement]));
-    const selected = parsed.items
-        .flatMap((item) => {
-        const replacement = byIndex.get(item.index);
-        return replacement ? [{ item, replacement: replacement.replacement }] : [];
-    })
-        .sort((left, right) => right.item.contentStart - left.item.contentStart);
-    let result = value;
-    for (const { item, replacement } of selected)
-        result = `${result.slice(0, item.contentStart)}${replacement}${result.slice(item.contentEnd)}`;
-    return result;
-}

package/dist/agent-core/tools/local/read.d.ts

@@ -1,43 +0,0 @@
-import type { ClientToolDefinition } from '../../model/contracts.js';
-import { WorkspacePathResolver } from '../shared/path-resolver.js';
-export type { ReadEventData } from '../contracts.js';
-export declare const readToolDefinition: ClientToolDefinition;
-export interface ReadRequest {
-    path: string;
-    offset?: number;
-    limit?: number;
-}
-export interface ReadResult {
-    path: string;
-    content: string;
-    text: string;
-    encoding: 'utf-8' | 'utf-16le' | 'utf-16be';
-    newline: 'crlf' | 'lf';
-    startLine: number;
-    endLine?: number;
-    eof: boolean;
-    truncated: boolean;
-    nextOffset?: number;
-}
-export interface ReadErrorResult {
-    path: string;
-    error: {
-        code: string;
-        message: string;
-    };
-}
-export interface BatchReadResult {
-    mode: 'batch';
-    results: Array<ReadResult | ReadErrorResult>;
-    truncated: boolean;
-}
-export declare class ReadTool {
-    #private;
-    private readonly paths;
-    constructor(paths: WorkspacePathResolver);
-    execute(arguments_: unknown, signal?: AbortSignal): Promise<BatchReadResult>;
-}
-export declare function formatBatchReadOutput(results: Array<ReadResult | ReadErrorResult>): {
-    content: string;
-    truncated: boolean;
-};