feat: convert browser binary captures

scripts/smoke-browser-inbox-plugin.js

@@ -135,6 +135,7 @@ function makeApi(initialSettings = {}) {
   const handlers = {};
   const unsubscribed = [];
   const fileWrites = [];
+  const fileByteWrites = [];
   const publishedEvents = [];
   let nextWriteError = null;
   return {
@@ -142,6 +143,7 @@ function makeApi(initialSettings = {}) {
     handlers,
     unsubscribed,
     fileWrites,
+    fileByteWrites,
     publishedEvents,
     failNextWrite(message) {
       nextWriteError = new Error(message || 'write failed');
@@ -174,6 +176,14 @@ function makeApi(initialSettings = {}) {
         }
         fileWrites.push({ relativePath, content, options });
       },
+      writeBytes: async (relativePath, dataBase64, options = {}) => {
+        if (nextWriteError) {
+          const err = nextWriteError;
+          nextWriteError = null;
+          throw err;
+        }
+        fileByteWrites.push({ relativePath, dataBase64, options });
+      },
     },
     getStoredCaptures(key = 'captures') {
       return settings[key] || [];
@@ -585,6 +595,41 @@ async function mountWithApi(api, props = { workspaceNode: { name: 'Project' }, w
   if (convertedFileEvent.payload.filePath !== 'Project/Files/notes.txt') throw new Error('converted file event filePath mismatch');
   component.unmount && component.unmount(fileConversionView.container);
 
+  const binaryFileApi = makeApi({
+    'captures:workspace:Project': [{
+      captureId: 'convert-binary-file',
+      capturedAt: '2026-06-29T02:25:00.000Z',
+      kind: 'file',
+      url: 'https://example.com/files',
+      title: 'Example Files',
+      domain: 'example.com',
+      fileName: 'logo.png',
+      fileMime: 'image/png',
+      fileSize: 4,
+      fileDataBase64: 'iVBORw==',
+      workspaceRootPath: 'Project',
+      workspaceName: 'Project',
+    }],
+  });
+  const binaryFileView = await mountWithApi(binaryFileApi);
+  const createBinaryFileButton = walk(binaryFileView.container, (node) => node.getAttribute && node.getAttribute('data-browser-inbox-action') === 'create-file');
+  if (!createBinaryFileButton) throw new Error('create file button for binary capture was not rendered');
+  createBinaryFileButton.click();
+  await flush();
+  if (binaryFileApi.fileWrites.length !== 0) throw new Error('binary file conversion used writeText');
+  if (binaryFileApi.fileByteWrites.length !== 1) throw new Error(`expected one byte write, got ${binaryFileApi.fileByteWrites.length}`);
+  const byteWrite = binaryFileApi.fileByteWrites[0];
+  if (byteWrite.relativePath !== 'Project/Files/logo.png') throw new Error(`byte write path mismatch: ${byteWrite.relativePath}`);
+  if (byteWrite.dataBase64 !== 'iVBORw==') throw new Error(`byte write data mismatch: ${byteWrite.dataBase64}`);
+  if (byteWrite.options.createIfMissing !== true || byteWrite.options.overwrite !== false) {
+    throw new Error(`byte write options mismatch: ${JSON.stringify(byteWrite.options)}`);
+  }
+  const convertedBinaryFileEvent = binaryFileApi.publishedEvents.find((event) => event.name === 'browser.capture.converted');
+  if (!convertedBinaryFileEvent || convertedBinaryFileEvent.payload.filePath !== 'Project/Files/logo.png') {
+    throw new Error('binary file conversion event mismatch');
+  }
+  component.unmount && component.unmount(binaryFileView.container);
+
   const failedFileApi = makeApi({
     'captures:workspace:Project': [{
       captureId: 'convert-file-conflict',

scripts/smoke-platform-frontend.js

@@ -109,6 +109,15 @@ const api = {
     writeText: async (relativePath, content) => {
       api.files._entries.set(relativePath, { type: 'file', content });
     },
+    readBytes: async (relativePath) => {
+      const entry = api.files._entries.get(relativePath);
+      if (!entry) throw new Error(`not-found: ${relativePath}`);
+      const content = entry.content || '';
+      return { relativePath, size: content.length, mimeHint: '', dataBase64: Buffer.from(content, 'binary').toString('base64') };
+    },
+    writeBytes: async (relativePath, dataBase64) => {
+      api.files._entries.set(relativePath, { type: 'file', content: Buffer.from(dataBase64, 'base64').toString('binary') });
+    },
     readText: async (relativePath) => {
       if (String(relativePath).split('/')[0].toLowerCase() === '.verstak') {
         throw new Error('reserved-path: .verstak is internal');