diff --git a/apps/android/tests/chat-files.test.ts b/apps/android/tests/chat-files.test.ts
new file mode 100644
index 0000000..f99e054
--- /dev/null
+++ b/apps/android/tests/chat-files.test.ts
@@ -0,0 +1,302 @@
+import { describe, expect, it, vi } from 'vitest'
+import {
+ type StagedFile,
+ bytesToBase64,
+ documentImageReadBudget,
+ readDocumentImageBase64,
+ formatUploadedFilesPrompt,
+ formatUploadedFilesReferencePrompt,
+ isTextFile,
+ isValidUtf8Text,
+ uploadStagedFileToWorkspace,
+ uploadStagedFilesToWorkspace,
+} from '../src/screens/chat-files'
+
+describe('chat-files utilities', () => {
+ describe('isTextFile', () => {
+ it('detects common code and text file extensions', () => {
+ expect(isTextFile('script.py')).toBe(true)
+ expect(isTextFile('main.ts')).toBe(true)
+ expect(isTextFile('App.tsx')).toBe(true)
+ expect(isTextFile('README.md')).toBe(true)
+ expect(isTextFile('data.json')).toBe(true)
+ expect(isTextFile('config.yaml')).toBe(true)
+ expect(isTextFile('table.csv')).toBe(true)
+ expect(isTextFile('Dockerfile')).toBe(true)
+ expect(isTextFile('Makefile')).toBe(true)
+ })
+
+ it('detects text mime types', () => {
+ expect(isTextFile('unknown', 'text/plain')).toBe(true)
+ expect(isTextFile('unknown', 'application/json')).toBe(true)
+ expect(isTextFile('unknown', 'application/javascript')).toBe(true)
+ })
+
+ it('rejects unsupported binary formats', () => {
+ expect(isTextFile('archive.zip')).toBe(false)
+ expect(isTextFile('program.exe')).toBe(false)
+ expect(isTextFile('audio.mp3')).toBe(false)
+ expect(isTextFile('video.mp4')).toBe(false)
+ expect(isTextFile('file.bin', 'application/octet-stream')).toBe(false)
+ })
+ })
+
+ describe('isValidUtf8Text', () => {
+ it('accepts clean utf-8 text and rejects null bytes or replacement characters', () => {
+ expect(isValidUtf8Text('Hello world\nThis is clean.')).toBe(true)
+ expect(isValidUtf8Text('中文内容测试:代码与说明')).toBe(true)
+ expect(isValidUtf8Text('binary\0content')).toBe(false)
+ expect(isValidUtf8Text('corrupted\uFFFDtext')).toBe(false)
+ })
+ })
+
+ describe('formatUploadedFilesPrompt', () => {
+ it('returns raw text unchanged when no files are staged', () => {
+ expect(formatUploadedFilesPrompt('hello world', [])).toBe('hello world')
+ expect(formatUploadedFilesPrompt(' test draft ', [])).toBe(' test draft ')
+ })
+
+ it('formats Claude-style uploaded_files block when user text is empty', () => {
+ const file: StagedFile = {
+ id: 'f1',
+ name: 'notes.txt',
+ size: 100,
+ mimeType: 'text/plain',
+ uri: 'file:///cache/notes.txt',
+ content: 'line 1\nline 2',
+ }
+ const prompt = formatUploadedFilesPrompt('', [file])
+ expect(prompt).toContain('')
+ expect(prompt).toContain('name="notes.txt"')
+ expect(prompt).toContain('size="100"')
+ expect(prompt).toContain('line 1\nline 2')
+ expect(prompt).toContain('')
+ })
+
+ it('combines user question with multiple staged files', () => {
+ const textFile: StagedFile = {
+ id: 'f1',
+ name: 'test.py',
+ size: 32,
+ mimeType: 'text/x-python',
+ uri: 'file:///cache/test.py',
+ content: 'print("hello")',
+ }
+ const jsonFile: StagedFile = {
+ id: 'f2',
+ name: 'data.json',
+ size: 16,
+ mimeType: 'application/json',
+ uri: 'file:///cache/data.json',
+ content: '{"key": "value"}',
+ }
+ const prompt = formatUploadedFilesPrompt('Please analyze these files', [textFile, jsonFile])
+ expect(prompt.startsWith('Please analyze these files')).toBe(true)
+ expect(prompt).toContain('')
+ expect(prompt).toContain('print("hello")')
+ expect(prompt).toContain('')
+ expect(prompt).toContain('{"key": "value"}')
+ expect(prompt).toContain('')
+ })
+
+ it('escapes xml-breaking characters in file names and attributes', () => {
+ const file: StagedFile = {
+ id: 'f3',
+ name: '