@aetherai/aether 0.0.3

package/dist/CLI/packages/core/src/utils/rateLimit.js

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isApiError, isStructuredError } from './quotaErrorDetection.js';
+// Known rate-limit error codes across providers.
+// 429  - Standard HTTP "Too Many Requests" (DashScope TPM, OpenAI, etc.)
+// 503  - Provider throttling/overload (treated as rate-limit for retry UI)
+// 1302 - Z.AI GLM rate limit (https://docs.z.ai/api-reference/api-code)
+// 1305 - DashScope/IdealTalk internal rate limit (issue #1918)
+const RATE_LIMIT_ERROR_CODES = new Set([429, 503, 1302, 1305]);
+/**
+ * Detects rate-limit / throttling errors and returns retry info.
+ *
+ * @param error - The error to check.
+ * @param extraCodes - Additional error codes to treat as rate-limit errors,
+ *   merged with the built-in set at call time (not mutating the default set).
+ */
+export function isRateLimitError(error, extraCodes) {
+    const code = getErrorCode(error);
+    if (code === null)
+        return false;
+    if (RATE_LIMIT_ERROR_CODES.has(code))
+        return true;
+    if (extraCodes && extraCodes.includes(code))
+        return true;
+    return false;
+}
+/**
+ * Extracts the numeric error code from various error shapes.
+ * Mirrors the same parsing patterns used by parseAndFormatApiError.
+ */
+function getErrorCode(error) {
+    if (isApiError(error))
+        return Number(error.error.code) || null;
+    // JSON in string / Error.message — check BEFORE isStructuredError because
+    // Error instances also satisfy isStructuredError (both have .message).
+    const msg = error instanceof Error
+        ? error.message
+        : typeof error === 'string'
+            ? error
+            : null;
+    if (msg) {
+        const i = msg.indexOf('{');
+        if (i !== -1) {
+            try {
+                const p = JSON.parse(msg.substring(i));
+                if (isApiError(p))
+                    return Number(p.error.code) || null;
+            }
+            catch {
+                /* not valid JSON */
+            }
+        }
+    }
+    // StructuredError (.status) — plain objects from Gemini SDK
+    if (isStructuredError(error)) {
+        return typeof error.status === 'number' ? error.status : null;
+    }
+    // HttpError (.status on Error)
+    if (error instanceof Error && 'status' in error) {
+        const s = error.status;
+        if (typeof s === 'number')
+            return s;
+    }
+    return null;
+}
+//# sourceMappingURL=rateLimit.js.map

package/dist/CLI/packages/core/src/utils/rateLimit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimit.js","sourceRoot":"","sources":["../../../../../../../core/src/utils/rateLimit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEzE,iDAAiD;AACjD,yEAAyE;AACzE,2EAA2E;AAC3E,wEAAwE;AACxE,+DAA+D;AAC/D,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAe/D;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,UAA8B;IAE9B,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAE/D,0EAA0E;IAC1E,uEAAuE;IACvE,MAAM,GAAG,GACP,KAAK,YAAY,KAAK;QACpB,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,CAAC;IACb,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAY,CAAC;gBAClD,IAAI,UAAU,CAAC,CAAC,CAAC;oBAAE,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;YACzD,CAAC;YAAC,MAAM,CAAC;gBACP,oBAAoB;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IAED,+BAA+B;IAC/B,IAAI,KAAK,YAAY,KAAK,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;QAChD,MAAM,CAAC,GAAI,KAA8B,CAAC,MAAM,CAAC;QACjD,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/CLI/packages/core/src/utils/readManyFiles.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { PartListUnion } from '@google/genai';
+import type { Config } from '../config/config.js';
+/**
+ * Options for reading multiple files.
+ */
+export interface ReadManyFilesOptions {
+    /**
+     * An array of file or directory paths to read.
+     * Paths are relative to the project root.
+     */
+    paths: string[];
+    /**
+     * Optional AbortSignal for cancellation support.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Information about a single file that was read.
+ */
+export interface FileReadInfo {
+    /** Absolute path to the file */
+    filePath: string;
+    /** Content of the file (string for text, Part for images/PDFs) */
+    content: PartListUnion;
+    /** Whether this is a directory listing rather than file content */
+    isDirectory: boolean;
+}
+/**
+ * Result from reading multiple files.
+ */
+export interface ReadManyFilesResult {
+    /**
+     * Content parts ready for LLM consumption.
+     * For text files, content is concatenated with separators.
+     * For images/PDFs, includes inline data parts.
+     */
+    contentParts: PartListUnion;
+    /**
+     * Individual file results with paths and content.
+     * Used for recording each file read as a separate tool result.
+     */
+    files: FileReadInfo[];
+    /**
+     * Error message if an error occurred during file search.
+     */
+    error?: string;
+}
+/**
+ * Reads content from multiple files and directories specified by paths.
+ *
+ * For directories, returns the folder structure.
+ * For text files, concatenates their content into a single string with separators.
+ * For image and PDF files, returns base64-encoded data.
+ *
+ * @param config - The runtime configuration
+ * @param options - Options for file reading (paths, filters, signal)
+ * @returns Result containing content parts and processed files
+ *
+ * NOTE: This utility is invoked only by explicit user-triggered file reads.
+ * Do not apply workspace filters or path restrictions here.
+ */
+export declare function readManyFiles(config: Config, options: ReadManyFilesOptions): Promise<ReadManyFilesResult>;

package/dist/CLI/packages/core/src/utils/readManyFiles.js

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getErrorMessage } from './errors.js';
+import { processSingleFileContent } from './fileUtils.js';
+import { getFolderStructure } from './getFolderStructure.js';
+const DEFAULT_OUTPUT_HEADER = '\n--- Content from referenced files ---';
+const DEFAULT_OUTPUT_TERMINATOR = '\n--- End of content ---';
+/**
+ * Reads content from multiple files and directories specified by paths.
+ *
+ * For directories, returns the folder structure.
+ * For text files, concatenates their content into a single string with separators.
+ * For image and PDF files, returns base64-encoded data.
+ *
+ * @param config - The runtime configuration
+ * @param options - Options for file reading (paths, filters, signal)
+ * @returns Result containing content parts and processed files
+ *
+ * NOTE: This utility is invoked only by explicit user-triggered file reads.
+ * Do not apply workspace filters or path restrictions here.
+ */
+export async function readManyFiles(config, options) {
+    const { paths: inputPatterns } = options;
+    const seenFiles = new Set();
+    const contentParts = [];
+    const files = [];
+    try {
+        const projectRoot = config.getProjectRoot();
+        for (const rawPattern of inputPatterns) {
+            const normalizedPattern = rawPattern.replace(/\\/g, '/');
+            const fullPath = path.resolve(projectRoot, normalizedPattern);
+            const stats = fs.existsSync(fullPath) ? fs.statSync(fullPath) : null;
+            if (stats?.isDirectory()) {
+                const { contentParts: dirParts, info } = await readDirectory(config, fullPath);
+                contentParts.push(...dirParts);
+                files.push(info);
+                continue;
+            }
+            if (stats?.isFile() && !seenFiles.has(fullPath)) {
+                seenFiles.add(fullPath);
+                const readResult = await readFileContent(config, fullPath);
+                if (readResult) {
+                    contentParts.push(...readResult.contentParts);
+                    files.push(readResult.info);
+                }
+            }
+        }
+    }
+    catch (error) {
+        const errorMessage = `Error during file search: ${getErrorMessage(error)}`;
+        return {
+            contentParts: [errorMessage],
+            files: [],
+            error: errorMessage,
+        };
+    }
+    if (contentParts.length > 0) {
+        contentParts.unshift({ text: DEFAULT_OUTPUT_HEADER });
+        contentParts.push({ text: DEFAULT_OUTPUT_TERMINATOR });
+    }
+    else {
+        contentParts.push({
+            text: 'No files matching the criteria were found or all were skipped.',
+        });
+    }
+    return { contentParts: contentParts, files };
+}
+async function readDirectory(config, directoryPath) {
+    const structure = await getFolderStructure(directoryPath, {
+        fileService: config.getFileService(),
+        fileFilteringOptions: config.getFileFilteringOptions(),
+    });
+    const contentParts = [
+        { text: `\nContent from ${directoryPath}:\n` },
+        { text: structure },
+    ];
+    return {
+        contentParts,
+        info: {
+            filePath: directoryPath,
+            content: structure,
+            isDirectory: true,
+        },
+    };
+}
+async function readFileContent(config, filePath) {
+    try {
+        const fileReadResult = await processSingleFileContent(filePath, config);
+        if (fileReadResult.error) {
+            return null;
+        }
+        const prefixText = { text: `\nContent from ${filePath}:\n` };
+        if (typeof fileReadResult.llmContent === 'string') {
+            let fileContentForLlm = '';
+            if (fileReadResult.isTruncated) {
+                const [start, end] = fileReadResult.linesShown;
+                const total = fileReadResult.originalLineCount;
+                fileContentForLlm = `Showing lines ${start}-${end} of ${total} total lines.\n---\n${fileReadResult.llmContent}`;
+            }
+            else {
+                fileContentForLlm = fileReadResult.llmContent;
+            }
+            const contentParts = [prefixText, { text: fileContentForLlm }];
+            return {
+                contentParts,
+                info: {
+                    filePath,
+                    content: fileContentForLlm,
+                    isDirectory: false,
+                },
+            };
+        }
+        // For binary files (images, PDFs), add prefix text before the inlineData/fileData part
+        const contentParts = [prefixText, fileReadResult.llmContent];
+        return {
+            contentParts,
+            info: {
+                filePath,
+                content: fileReadResult.llmContent,
+                isDirectory: false,
+            },
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=readManyFiles.js.map

package/dist/CLI/packages/core/src/utils/readManyFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readManyFiles.js","sourceRoot":"","sources":["../../../../../../../core/src/utils/readManyFiles.ts"],"names":[],"mappings":"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"}

package/dist/CLI/packages/core/src/utils/request-tokenizer/imageTokenizer.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ImageMetadata } from './types.js';
+/**
+ * Image tokenizer for calculating image tokens based on dimensions
+ *
+ * Key rules:
+ * - 28x28 pixels = 1 token
+ * - Minimum: 4 tokens per image
+ * - Maximum: 16384 tokens per image
+ * - Additional: 2 special tokens (vision_bos + vision_eos)
+ * - Supports: PNG, JPEG, WebP, GIF, BMP, TIFF, HEIC formats
+ */
+export declare class ImageTokenizer {
+    /** 28x28 pixels = 1 token */
+    private static readonly PIXELS_PER_TOKEN;
+    /** Minimum tokens per image */
+    private static readonly MIN_TOKENS_PER_IMAGE;
+    /** Maximum tokens per image */
+    private static readonly MAX_TOKENS_PER_IMAGE;
+    /** Special tokens for vision markers */
+    private static readonly VISION_SPECIAL_TOKENS;
+    /**
+     * Extract image metadata from base64 data
+     *
+     * @param base64Data Base64-encoded image data (with or without data URL prefix)
+     * @param mimeType MIME type of the image
+     * @returns Promise resolving to ImageMetadata with dimensions and format info
+     */
+    extractImageMetadata(base64Data: string, mimeType: string): Promise<ImageMetadata>;
+    /**
+     * Extract image dimensions from buffer based on format
+     *
+     * @param buffer Binary image data buffer
+     * @param mimeType MIME type to determine parsing strategy
+     * @returns Promise resolving to width and height dimensions
+     */
+    private extractDimensions;
+    /**
+     * Extract PNG dimensions from IHDR chunk
+     * PNG signature: 89 50 4E 47 0D 0A 1A 0A
+     * Width/height at bytes 16-19 and 20-23 (big-endian)
+     */
+    private extractPngDimensions;
+    /**
+     * Extract JPEG dimensions from SOF (Start of Frame) markers
+     * JPEG starts with FF D8, SOF markers: 0xC0-0xC3, 0xC5-0xC7, 0xC9-0xCB, 0xCD-0xCF
+     * Dimensions at offset +5 (height) and +7 (width) from SOF marker
+     */
+    private extractJpegDimensions;
+    /**
+     * Extract WebP dimensions from RIFF container
+     * Supports VP8, VP8L, and VP8X formats
+     */
+    private extractWebpDimensions;
+    /**
+     * Extract GIF dimensions from header
+     * Supports GIF87a and GIF89a formats
+     */
+    private extractGifDimensions;
+    /**
+     * Calculate tokens for an image based on its metadata
+     *
+     * @param metadata Image metadata containing width, height, and format info
+     * @returns Total token count including base image tokens and special tokens
+     */
+    calculateTokens(metadata: ImageMetadata): number;
+    /**
+     * Calculate tokens with scaling logic
+     *
+     * Steps:
+     * 1. Normalize to 28-pixel multiples
+     * 2. Scale large images down, small images up
+     * 3. Calculate tokens: pixels / 784 + 2 special tokens
+     *
+     * @param width Original image width in pixels
+     * @param height Original image height in pixels
+     * @returns Total token count for the image
+     */
+    private calculateTokensWithScaling;
+    /**
+     * Calculate tokens for multiple images serially
+     *
+     * @param base64DataArray Array of image data with MIME type information
+     * @returns Promise resolving to array of token counts in same order as input
+     */
+    calculateTokensBatch(base64DataArray: Array<{
+        data: string;
+        mimeType: string;
+    }>): Promise<number[]>;
+    /**
+     * Extract BMP dimensions from header
+     * BMP signature: 42 4D (BM)
+     * Width/height at bytes 18-21 and 22-25 (little-endian)
+     */
+    private extractBmpDimensions;
+    /**
+     * Extract TIFF dimensions from IFD (Image File Directory)
+     * TIFF can be little-endian (II) or big-endian (MM)
+     * Width/height are stored in IFD entries with tags 0x0100 and 0x0101
+     */
+    private extractTiffDimensions;
+    /**
+     * Extract HEIC dimensions from meta box
+     * HEIC is based on ISO Base Media File Format
+     * This is a simplified implementation that looks for 'ispe' (Image Spatial Extents) box
+     */
+    private extractHeicDimensions;
+}