aionflare-connect 0.1.0 → 0.2.1

package/README.md

@@ -12,7 +12,7 @@ A local terminal for AIONFLARE Coder ([ADR-0094](../../docs/adr/0094-coder-cloud
    ```
 
 3. Open the pairing link it prints, in the browser where you use AIONFLARE, within 10 minutes. Your browser may ask whether aionflare.com may connect to devices on your computer: allow it.
-4. In Coder, open **Console and network › Terminal**. Browsers paired before reconnect by themselves whenever the helper is running.
+4. In a Coder project, turn on **Terminal** in the Environment panel (under Code). A terminal opens beside the chat; **+** opens another. Browsers paired before reconnect by themselves whenever the helper is running.
 
 Press **Ctrl+C** to stop it and close every shell. `npx aionflare-connect --forget` forgets every paired browser. `--help` lists the options.
 
@@ -21,6 +21,7 @@ Press **Ctrl+C** to stop it and close every shell. `npx aionflare-connect --forg
 - It listens on this computer only (127.0.0.1), never on your network.
 - It accepts a connection only from the AIONFLARE website, naming this computer's address, with a key it gave that browser when you paired it. Keys are kept as their SHA-256 in `~/.aionflare/connect.json`.
 - It opens up to 3 shells (PowerShell on Windows, your login shell elsewhere), starting in the chosen folder.
+- For a Coder project, it can open your computer's own folder dialog so you choose the app's folder (an existing one, or a new one named after the project). It then works in that folder, and remembers the folders you picked; the website can switch it only to one of those.
 - For Coder's **Copy project here** and **Save to project**, it reads and writes text files only inside the chosen folder, never through links, skipping `node_modules`, `.git` and build folders.
 - It does nothing else. It makes no internet connections and sends nothing to AIONFLARE. Its window shows a line when a browser pairs, connects or opens a shell, never what you type.
 

package/bin/aionflare-connect.mjs

@@ -45,6 +45,8 @@ async function loadConfig() {
     return {
       port: Number(raw.port) || undefined,
       devices: Array.isArray(raw.devices) ? raw.devices : [],
+      // Owner (2026-11-07): the folders picked for projects in this computer's folder dialog.
+      folders: Array.isArray(raw.folders) ? raw.folders.filter((f) => typeof f === 'string') : [],
     };
   } catch {
     return { devices: [] };

package/lib/core.mjs

@@ -5,7 +5,7 @@ import { createHash, randomBytes, timingSafeEqual } from 'node:crypto';
 import { lstat, mkdir, readdir, readFile, realpath, writeFile } from 'node:fs/promises';
 import { dirname, join, relative, resolve, sep } from 'node:path';
 
-export const version = '0.1.0';
+export const version = '0.2.1';
 // The messages the Workspace and the helper exchange; raised when they change incompatibly.
 export const protocol = 1;
 export const defaultPort = 47613;

package/lib/folders.mjs

@@ -0,0 +1,114 @@
+// Owner (2026-11-07): the app's folder for a Coder project, chosen by the member in their own
+// computer's folder dialog (Windows Explorer, macOS Finder, or zenity on Linux): an existing folder,
+// or a new one named after the project inside the folder they pick. The website never names a path:
+// only folders picked here (or the one the helper started in) are used, and they are remembered in
+// the helper's settings so a project finds its folder again.
+import { spawn } from 'node:child_process';
+import { mkdir, stat } from 'node:fs/promises';
+import { platform } from 'node:os';
+import { join, resolve } from 'node:path';
+
+// A new folder's name: the project's name with only letters, digits, spaces, dots, dashes and
+// underscores (60 at most).
+export function folderName(name) {
+  const clean = String(name ?? '')
+    .replace(/[^A-Za-z0-9 ._-]+/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .replace(/^[.\s]+|[.\s]+$/g, '')
+    .slice(0, 60);
+  return clean || 'Coder project';
+}
+
+function run(file, args, env = {}) {
+  return new Promise((done) => {
+    const child = spawn(file, args, {
+      env: { ...process.env, ...env },
+      stdio: ['ignore', 'pipe', 'ignore'],
+      windowsHide: false,
+    });
+    let out = '';
+    child.stdout.on('data', (d) => (out += d));
+    child.on('error', () => done(null));
+    child.on('close', (code) => done(code === 0 ? out.trim() : null));
+    // A dialog left open is closed after 5 minutes.
+    setTimeout(() => child.kill(), 5 * 60_000);
+  });
+}
+
+// The folder dialog of this computer, its title passed as an environment variable (never as code).
+// Null when the member cancels or the computer has no dialog.
+export async function pickFolder(title) {
+  const env = { AIONFLARE_DIALOG_TITLE: String(title).slice(0, 120) };
+  const os = platform();
+  if (os === 'win32')
+    return run(
+      'powershell.exe',
+      [
+        '-NoProfile',
+        '-STA',
+        '-Command',
+        // Owner live check (2026-11-07): the window opened behind the browser, unseen. It now has a
+        // shown, always-on-top owner (invisible), brought to the front; and no property that only
+        // newer .NET has (Windows PowerShell 5.1 runs .NET Framework 4).
+        'Add-Type -AssemblyName System.Windows.Forms;' +
+          '$d = New-Object System.Windows.Forms.FolderBrowserDialog;' +
+          '$d.Description = $env:AIONFLARE_DIALOG_TITLE;' +
+          '$d.ShowNewFolderButton = $true;' +
+          '$top = New-Object System.Windows.Forms.Form;' +
+          '$top.TopMost = $true; $top.ShowInTaskbar = $false; $top.Opacity = 0;' +
+          "$top.StartPosition = 'CenterScreen'; $top.Size = New-Object System.Drawing.Size(1, 1);" +
+          '$top.Show(); $top.Activate();' +
+          '$r = $d.ShowDialog($top); $top.Close();' +
+          "if ($r -eq 'OK') { [Console]::Out.Write($d.SelectedPath) }",
+      ],
+      env,
+    );
+  if (os === 'darwin')
+    return run(
+      'osascript',
+      [
+        '-e',
+        'set t to system attribute "AIONFLARE_DIALOG_TITLE"',
+        '-e',
+        'POSIX path of (choose folder with prompt t)',
+      ],
+      env,
+    );
+  return (
+    (await run('zenity', [
+      '--file-selection',
+      '--directory',
+      '--title',
+      env.AIONFLARE_DIALOG_TITLE,
+    ])) ??
+    run('kdialog', [
+      '--getexistingdirectory',
+      process.env.HOME ?? '/',
+      '--title',
+      env.AIONFLARE_DIALOG_TITLE,
+    ])
+  );
+}
+
+// "open": the folder picked. "create": a new folder named after the project inside the folder
+// picked (a number added when the name is taken). Null when cancelled.
+export async function chooseFolder(mode, name) {
+  const picked = await pickFolder(
+    mode === 'create'
+      ? 'AIONFLARE Coder: choose where to create the folder for ' + folderName(name)
+      : 'AIONFLARE Coder: choose the folder of ' + folderName(name),
+  );
+  if (!picked) return null;
+  const base = resolve(picked.replace(/[\r\n]+$/g, ''));
+  if (!(await stat(base).catch(() => null))?.isDirectory()) return null;
+  if (mode !== 'create') return base;
+  const wanted = folderName(name);
+  for (let n = 1; n < 100; n++) {
+    const target = join(base, n === 1 ? wanted : wanted + ' ' + n);
+    if (await stat(target).catch(() => null)) continue;
+    await mkdir(target);
+    return target;
+  }
+  return null;
+}

package/lib/server.mjs

@@ -23,6 +23,7 @@ import {
   writeText,
 } from './core.mjs';
 import { FrameReader, acceptKey, encodeFrame } from './ws.mjs';
+import { chooseFolder } from './folders.mjs';
 
 const require = createRequire(import.meta.url);
 // A message can carry a whole project (2 MB of text, written as JSON).
@@ -35,7 +36,11 @@ function shellFor() {
   return { file, args: ['-l'], name: basename(file) };
 }
 
-export function startServer({ folder, port, dev, config, saveConfig, log }) {
+export function startServer({ folder: startFolder, port, dev, config, saveConfig, log }) {
+  // Owner (2026-11-07): the folder the helper works in: where it started, or one the member picked
+  // in their computer's folder dialog for a project (remembered in config.folders, the last 20).
+  let folder = startFolder;
+  const approved = () => [startFolder, ...(config.folders ?? [])];
   const pty = require('node-pty');
   const shell = shellFor();
   // One pairing code each time the helper starts.
@@ -52,6 +57,7 @@ export function startServer({ folder, port, dev, config, saveConfig, log }) {
     folder,
     folder_name: basename(folder),
     max_shells: maxShells,
+    features: ['choose', 'use'],
     limits: fileLimits,
   });
 
@@ -225,6 +231,31 @@ export function startServer({ folder, port, dev, config, saveConfig, log }) {
             skipped: out.filter((f) => f.reason),
           });
         }
+        // Owner (2026-11-07): a project's folder, picked in this computer's own folder dialog
+        // (an existing one, or a new one named after the project); then the helper works there.
+        case 'choose': {
+          log('Opening the folder window on this computer (it may be behind the browser)…');
+          const picked = await chooseFolder(m.mode === 'create' ? 'create' : 'open', m.name);
+          if (!picked) {
+            log('No folder was chosen.');
+            return reply({ cancelled: true });
+          }
+          config.folders = [...(config.folders ?? []).filter((f) => f !== picked), picked].slice(
+            -20,
+          );
+          await saveConfig(config);
+          folder = picked;
+          log('Working in ' + folder + '.');
+          return reply({ folder, folder_name: basename(folder) });
+        }
+        // A folder picked before (or the one the helper started in), by its full path.
+        case 'use': {
+          const wanted = String(m.folder ?? '');
+          if (!approved().includes(wanted) || !(await isFolder(wanted)))
+            return reply({ refused: true });
+          folder = wanted;
+          return reply({ folder, folder_name: basename(folder) });
+        }
         case 'forget': {
           config.devices = (config.devices ?? []).filter((d) => d.id !== authed);
           await saveConfig(config);
@@ -264,6 +295,10 @@ export function startServer({ folder, port, dev, config, saveConfig, log }) {
   };
 }
 
+async function isFolder(path) {
+  const { stat } = await import('node:fs/promises');
+  return !!(await stat(path).catch(() => null))?.isDirectory();
+}
 function clamp(value, min, max, fallback) {
   const n = Math.floor(Number(value));
   return Number.isFinite(n) ? Math.min(max, Math.max(min, n)) : fallback;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aionflare-connect",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "A local terminal for AIONFLARE Coder: open shells on your own computer from the Workspace.",
   "type": "module",
   "bin": {