Method opReadFile

src/FileRise/Domain/McpCoreOpsService.php:689–762

* @param array $payload * @return array */

(McpOpsContext $ctx, array $payload)

     * @return array<string,mixed>
     */
    private static function opReadFile(McpOpsContext $ctx, array $payload): array
    {
        return self::withSourceContext($ctx, $payload, false, function () use ($ctx, $payload): array {
            $folder = self::normalizeFolder((string)($payload['folder'] ?? 'root'));
            $file = self::normalizeFileName((string)($payload['file'] ?? ($payload['filename'] ?? '')));
            $maxBytes = self::boundedInt(
                $payload['maxBytes'] ?? self::DEFAULT_READ_FILE_PREVIEW_BYTES,
                256,
                self::MAX_READ_FILE_PREVIEW_BYTES,
                self::DEFAULT_READ_FILE_PREVIEW_BYTES
            );

            $username = $ctx->username();
            $perms = $ctx->permissions();

            $fullView = ACL::canRead($username, $perms, $folder)
                || ACL::ownsFolderOrAncestor($username, $perms, $folder);
            $ownOnlyGrant = ACL::hasGrant($username, $folder, 'read_own');
            if (!$fullView && !$ownOnlyGrant) {
                throw new RuntimeException('Forbidden: no view access to this folder.', 403);
            }

            self::assertFolderScope($ctx, $folder, $fullView ? 'read' : 'read_own');

            if (
                !$ctx->canBypassOwnership()
                && !$fullView
                && $ownOnlyGrant
            ) {
                self::assertFilesOwnedByUser($folder, [$file], $username);
            }

            $storage = StorageRegistry::getAdapter();
            $baseDir = rtrim(SourceContext::uploadRoot(), '/\\');
            $dir = ($folder === 'root')
                ? $baseDir
                : $baseDir . DIRECTORY_SEPARATOR . str_replace('/', DIRECTORY_SEPARATOR, $folder);
            $path = $dir . DIRECTORY_SEPARATOR . $file;

            $stat = $storage->stat($path);
            if ($stat === null || ($stat['type'] ?? '') !== 'file') {
                throw new RuntimeException('File not found.', 404);
            }

            $size = max(0, (int)($stat['size'] ?? 0));
            if ($size > self::MAX_READ_FILE_SIZE_BYTES) {
                throw new RuntimeException('File is too large for AI text preview.', 413);
            }

            $raw = $storage->read($path, $maxBytes, 0);
            if (!is_string($raw)) {
                throw new RuntimeException('Failed to read file.', 500);
            }
            if ($raw !== '' && strpos($raw, "\0") !== false) {
                throw new RuntimeException('File appears to be binary; text preview is unavailable.', 415);
            }

            $content = preg_replace('/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/', '', $raw);