fraim-hub 2.0.335 → 2.0.337

package/dist/src/ai-hub/attachment-store.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -30,7 +63,6 @@ exports.safeAttachmentMetaPath = safeAttachmentMetaPath;
  * path its own file-read tool opens.
  */
 const path_1 = __importDefault(require("path"));
-const sharp_1 = __importDefault(require("sharp"));
 /** Accepted upload MIME types (spec R1/R11). */
 exports.ACCEPTED_ATTACHMENT_MIME_TYPES = new Set([
     'image/png',
@@ -90,8 +122,9 @@ function pdfContainsScriptMarker(buffer) {
 async function sanitizeAttachmentBuffer(buffer, mimeType) {
     if (IMAGE_MIME_TYPES.has(mimeType)) {
         try {
+            const sharp = (await Promise.resolve().then(() => __importStar(require('sharp')))).default;
             const format = mimeType === 'image/jpeg' ? 'jpeg' : mimeType === 'image/gif' ? 'gif' : 'png';
-            return await (0, sharp_1.default)(buffer).toFormat(format).toBuffer();
+            return await sharp(buffer).toFormat(format).toBuffer();
         }
         catch (err) {
             throw new AttachmentRejectedError(415, `Not a valid ${mimeType} image.`);

package/dist/src/ai-hub/desktop-main.js

@@ -11,6 +11,7 @@ const electron_1 = require("electron");
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const server_1 = require("./server");
+const native_voice_input_1 = require("./native-voice-input");
 const cert_store_1 = require("./cert-store");
 const office_sideload_1 = require("./office-sideload");
 const office_setup_policy_1 = require("./office-setup-policy");
@@ -672,6 +673,10 @@ async function launchDesktopShell(options) {
             return result.canceled || result.filePaths.length === 0 ? null : result.filePaths[0];
         },
         restartToLatest: restartToLatestNow,
+        voiceInput: (0, native_voice_input_1.createNativeVoiceInputController)({
+            getWindow: () => mainWindow,
+            sendActionToFirstResponder: (action) => electron_1.Menu.sendActionToFirstResponder(action),
+        }),
         hubMainDiagnostics: {
             snapshot: () => (0, hub_main_diagnostics_1.getHubMainDiagnosticsSnapshot)(buildDesktopDebugSnapshot(runtimeId)),
         },

package/dist/src/ai-hub/native-voice-input.js

@@ -0,0 +1,141 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WINDOWS_VOICE_INPUT_PROGRAM = exports.NativeVoiceInputError = void 0;
+exports.getVoiceInputCapability = getVoiceInputCapability;
+exports.requestWindowsVoiceInput = requestWindowsVoiceInput;
+exports.createNativeVoiceInputController = createNativeVoiceInputController;
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = __importDefault(require("node:path"));
+class NativeVoiceInputError extends Error {
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = 'NativeVoiceInputError';
+    }
+}
+exports.NativeVoiceInputError = NativeVoiceInputError;
+function getVoiceInputCapability(platform = process.platform, native = false) {
+    if (platform === 'win32') {
+        return {
+            platform: 'windows', mode: native ? 'native' : 'manual', shortcutLabel: 'Win+H',
+            guidance: 'Press Win+H to start Windows Voice Typing. If it does not appear, check Windows Settings > Privacy & security > Speech and Microphone.',
+        };
+    }
+    if (platform === 'darwin') {
+        return {
+            platform: 'macos', mode: native ? 'native' : 'manual', shortcutLabel: 'Dictation shortcut',
+            guidance: 'Use the microphone key or your configured Dictation shortcut. If Dictation does not appear, enable it in System Settings > Keyboard > Dictation.',
+        };
+    }
+    return { platform: 'other', mode: 'unsupported', guidance: 'Voice input is available through system dictation on Windows and macOS.' };
+}
+// Fixed program only: no renderer or request data enters the native command.
+// The 32-byte union and individually paced events were validated in the #1844 spike.
+exports.WINDOWS_VOICE_INPUT_PROGRAM = String.raw `$ErrorActionPreference = 'Stop'
+$source = @'
+using System;
+using System.ComponentModel;
+using System.Runtime.InteropServices;
+public static class FraimVoiceTyping {
+    [StructLayout(LayoutKind.Sequential)]
+    private struct INPUT { public uint type; public InputUnion data; }
+    [StructLayout(LayoutKind.Explicit, Size = 32)]
+    private struct InputUnion { [FieldOffset(0)] public KEYBDINPUT keyboard; }
+    [StructLayout(LayoutKind.Sequential)]
+    private struct KEYBDINPUT {
+        public ushort virtualKey; public ushort scanCode; public uint flags;
+        public uint time; public UIntPtr extraInfo;
+    }
+    [DllImport("user32.dll", SetLastError = true)]
+    private static extern uint SendInput(uint count, INPUT[] inputs, int size);
+    private static bool Emit(ushort key, uint flags) {
+        INPUT input = new INPUT { type = 1, data = new InputUnion {
+            keyboard = new KEYBDINPUT { virtualKey = key, flags = flags }
+        }};
+        return SendInput(1, new INPUT[] { input }, Marshal.SizeOf(typeof(INPUT))) == 1;
+    }
+    private static void Send(ushort key, uint flags) {
+        if (!Emit(key, flags)) throw new Win32Exception(Marshal.GetLastWin32Error());
+    }
+    public static int Invoke() {
+        bool winDown = false, hDown = false;
+        try {
+            Send(0x5B, 0); winDown = true;
+            System.Threading.Thread.Sleep(40);
+            Send(0x48, 0); hDown = true;
+            System.Threading.Thread.Sleep(40);
+            Send(0x48, 2); hDown = false;
+            System.Threading.Thread.Sleep(40);
+            Send(0x5B, 2); winDown = false;
+            return 4;
+        } finally {
+            // Release each key independently even after partial emission.
+            if (hDown) Emit(0x48, 2);
+            if (winDown) Emit(0x5B, 2);
+        }
+    }
+}
+'@
+Add-Type -TypeDefinition $source -Language CSharp
+Write-Output ([FraimVoiceTyping]::Invoke())`;
+function requestWindowsVoiceInput(execute = node_child_process_1.execFile) {
+    return new Promise((resolve, reject) => {
+        const fail = () => reject(new NativeVoiceInputError('launch_failed'));
+        try {
+            execute(node_path_1.default.win32.join(process.env.SystemRoot || 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe'), ['-NoProfile', '-NonInteractive', '-EncodedCommand', Buffer.from(exports.WINDOWS_VOICE_INPUT_PROGRAM, 'utf16le').toString('base64')], 
+            // execFile kills only its child on timeout and calls back after close.
+            { windowsHide: true, timeout: 5000, maxBuffer: 4096, encoding: 'utf8' }, (error, stdout) => {
+                if (error || stdout.trim() !== '4')
+                    fail();
+                else
+                    resolve();
+            });
+        }
+        catch {
+            fail();
+        }
+    });
+}
+function createNativeVoiceInputController(options) {
+    const capability = getVoiceInputCapability(options.platform ?? process.platform, true);
+    let inFlight = false;
+    return {
+        capability,
+        async start() {
+            if (capability.mode === 'unsupported')
+                throw new NativeVoiceInputError('unsupported_platform');
+            if (inFlight)
+                throw new NativeVoiceInputError('launch_failed');
+            inFlight = true;
+            try {
+                try {
+                    const win = options.getWindow();
+                    if (!win || win.isDestroyed() || win.webContents.isDestroyed())
+                        throw new Error('unavailable');
+                    win.show();
+                    win.focus();
+                    win.webContents.focus();
+                }
+                catch {
+                    throw new NativeVoiceInputError('window_unavailable');
+                }
+                try {
+                    if (capability.platform === 'windows')
+                        await (options.requestWindows ?? requestWindowsVoiceInput)();
+                    else
+                        options.sendActionToFirstResponder('startDictation:');
+                }
+                catch {
+                    throw new NativeVoiceInputError('launch_failed');
+                }
+                return { status: 'requested', capability, message: `System dictation requested. ${capability.guidance}` };
+            }
+            finally {
+                inFlight = false;
+            }
+        },
+    };
+}

package/dist/src/ai-hub/server.js

@@ -52,6 +52,7 @@ const os_1 = __importDefault(require("os"));
 const crypto_1 = require("crypto");
 const child_process_1 = require("child_process");
 const https_1 = __importDefault(require("https"));
+const native_voice_input_1 = require("./native-voice-input");
 const types_1 = require("../first-run/types");
 const local_provider_registry_1 = require("../cli/providers/local-provider-registry");
 const learning_context_builder_1 = require("../local-mcp-server/learning-context-builder");
@@ -2944,6 +2945,7 @@ class AiHubServer {
         this.configuredAgentStore = options.configuredAgentStore || new configured_agents_1.AiHubConfiguredAgentStore();
         this.wordTaskpaneDir = options.wordTaskpaneDir ?? resolveWordTaskpaneDir(this.projectPath);
         this.folderPicker = options.folderPicker ?? pickProjectPath;
+        this.voiceInput = options.voiceInput;
         this.restartToLatest = options.restartToLatest ?? (async () => ({ restarting: false }));
         this.httpsPort = options.httpsPort;
         this.certBundle = options.certBundle;
@@ -3579,6 +3581,7 @@ class AiHubServer {
             // #755: the running build version, so the account menu can show it and flag
             // when a newer version is available (see GET /api/ai-hub/version for `latest`).
             version: (0, version_utils_1.getFraimVersion)(),
+            voiceInput: this.voiceInput?.capability ?? (0, native_voice_input_1.getVoiceInputCapability)(),
             project,
             // Issue #750: `apiKey` is no longer a persisted AiHubPreferences field —
             // it is overlaid on the wire response only, freshly resolved from
@@ -3826,10 +3829,10 @@ class AiHubServer {
             return false;
         }
     }
-    requireTrustedHubOrigin(req, res) {
+    requireTrustedHubOrigin(req, res, message = 'Configured agent management is only allowed from the local Hub origin.') {
         if (this.isTrustedHubOrigin(req))
             return true;
-        res.status(403).json({ error: 'Configured agent management is only allowed from the local Hub origin.' });
+        res.status(403).json({ error: message });
         return false;
     }
     applyRunHostSessionSignal(run, sessionId, hostIdForCommand = run.hostId) {
@@ -6392,6 +6395,30 @@ class AiHubServer {
                 return res.status(500).json({ error: error instanceof Error ? error.message : 'Could not restart to the latest version.' });
             }
         });
+        this.app.post('/api/ai-hub/voice-input/start', async (req, res) => {
+            if (!this.requireTrustedHubOrigin(req, res, 'System dictation is only allowed from the local Hub origin.'))
+                return;
+            const capability = this.voiceInput?.capability ?? (0, native_voice_input_1.getVoiceInputCapability)();
+            const startedAt = Date.now();
+            try {
+                if (capability.mode === 'unsupported')
+                    throw new native_voice_input_1.NativeVoiceInputError('unsupported_platform');
+                if (!this.voiceInput || capability.mode === 'manual') {
+                    (0, hub_main_diagnostics_1.recordHubMainDiagnostic)('hub.voice_input.manual_fallback', { platform: capability.platform });
+                    return res.json({ status: 'manual', capability, message: capability.guidance });
+                }
+                const result = await this.voiceInput.start();
+                (0, hub_main_diagnostics_1.recordHubMainDiagnostic)('hub.voice_input.requested', { platform: capability.platform, mode: capability.mode, durationMs: Date.now() - startedAt });
+                return res.json(result);
+            }
+            catch (error) {
+                const code = error instanceof native_voice_input_1.NativeVoiceInputError ? error.code : 'launch_failed';
+                const status = code === 'unsupported_platform' ? 422 : code === 'window_unavailable' ? 409 : 500;
+                const message = code === 'window_unavailable' ? 'Could not focus the Hub window.' : code === 'launch_failed' ? 'Could not request system dictation.' : '';
+                (0, hub_main_diagnostics_1.recordHubMainDiagnostic)('hub.voice_input.failed', { platform: capability.platform, code, durationMs: Date.now() - startedAt });
+                return res.status(status).json({ code, capability, error: `${message} ${capability.guidance}`.trim() });
+            }
+        });
         this.app.post('/api/ai-hub/project-path/pick', async (_req, res) => {
             try {
                 const projectPath = await this.folderPicker();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-hub",
-  "version": "2.0.335",
+  "version": "2.0.337",
   "description": "FRAIM Hub local companion package.",
   "author": "Sid Mathur <sid.mathur@gmail.com>",
   "homepage": "https://github.com/mathursrus/FRAIM#readme",
@@ -221,7 +221,7 @@
     "electron-updater": "^6.8.9",
     "express": "^5.2.1",
     "extract-zip": "^2.0.1",
-    "fraim": "2.0.335",
+    "fraim": "2.0.337",
     "mongodb": "^7.0.0",
     "node-cron": "4.2.1",
     "node-edge-tts": "^1.2.10",

package/public/ai-hub/index.html

@@ -93,14 +93,16 @@
 
   <!-- Issue #512 / #521 R6: Company area — same shell as Projects (jobs rail + collapsible context/learnings) -->
   <section class="hub-area" id="area-company" hidden>
-    <div class="area-shell">
-      <nav class="area-rail" id="company-rail"></nav>
+    <div class="area-shell scope-shell">
+      <nav class="tree-sidebar area-rail" id="company-rail" aria-label="Company navigation"></nav>
+      <button class="tree-collapse-btn" type="button" aria-label="Collapse navigation" title="Collapse navigation" aria-controls="company-rail" aria-expanded="true"></button>
+      <div class="tree-resizer" role="separator" aria-orientation="vertical" aria-label="Resize navigation" aria-controls="company-rail"></div>
       <div class="area-main">
         <!-- Info view: context/learnings accordions shown when no conv is active -->
         <div class="area-info-view" id="company-info-view">
           <div class="hub-area-page">
             <div class="eyebrow">FRAIM Hub</div>
-            <div class="area-h1">Company</div>
+            <h1 class="area-h1">Company</h1>
             <p class="area-lede">Your organization's identity, what you do, how you operate, and the guardrails every employee follows on every job.</p>
             <div id="company-push-banner"></div>
             <!-- #744: Brand editor — company identity across the Hub. -->
@@ -152,14 +154,16 @@
 
   <!-- Issue #512 / #521 R6: Manager area — same shell as Projects -->
   <section class="hub-area" id="area-manager" hidden>
-    <div class="area-shell">
-      <nav class="area-rail" id="manager-rail"></nav>
+    <div class="area-shell scope-shell">
+      <nav class="tree-sidebar area-rail" id="manager-rail" aria-label="Manager navigation"></nav>
+      <button class="tree-collapse-btn" type="button" aria-label="Collapse navigation" title="Collapse navigation" aria-controls="manager-rail" aria-expanded="true"></button>
+      <div class="tree-resizer" role="separator" aria-orientation="vertical" aria-label="Resize navigation" aria-controls="manager-rail"></div>
       <div class="area-main">
         <!-- Info view: context/learnings accordions shown when no conv is active -->
         <div class="area-info-view" id="manager-info-view">
           <div class="hub-area-page">
             <div class="eyebrow">FRAIM Hub</div>
-            <div class="area-h1">Manager</div>
+            <h1 class="area-h1">Manager</h1>
             <p class="area-lede">How you manage: your working style, preferences, and the standing rules your team follows when working with you.</p>
             <details class="ctx-acc" id="manager-agents-acc" open>
               <summary><span class="ca-chev">▸</span> <span>AI Agents</span></summary>
@@ -263,18 +267,19 @@
     </div>
 
     <!-- Project workspace: employee tree + the existing conversation surface. -->
-    <div id="proj-workspace" hidden>
-      <nav class="tree-sidebar" id="tree-sidebar"></nav>
-      <button class="tree-collapse-btn" id="tree-collapse-btn" type="button" aria-label="Collapse project navigation" title="Collapse project navigation"></button>
-      <div class="tree-resizer" id="tree-resizer" role="separator" aria-orientation="vertical" aria-label="Resize project navigation"></div>
+    <div id="proj-workspace" class="scope-shell" hidden>
+      <nav class="tree-sidebar" id="tree-sidebar" aria-label="Project navigation"></nav>
+      <button class="tree-collapse-btn" id="tree-collapse-btn" type="button" aria-label="Collapse navigation" title="Collapse navigation" aria-controls="tree-sidebar" aria-expanded="true"></button>
+      <div class="tree-resizer" id="tree-resizer" role="separator" aria-orientation="vertical" aria-label="Resize navigation" aria-controls="tree-sidebar"></div>
       <div class="workspace-conv">
 
-        <!-- #521 R5/R6.4: project brief & learnings as collapsible top sections
-             (consistent with Company/Manager), replacing the over-conversation
-             panels. Each sub-area is its own <details> so the manager controls
-             how much text is shown. The editable brief rows (#proj-brief-profile)
-             and the learnings list (#project-learnings) are unchanged. -->
-        <div id="proj-context-top" class="proj-context-top">
+        <!-- Project Info uses the same titled page shell as Company and Manager.
+             The shared view state makes Info, conversation, and search exclusive. -->
+        <div id="proj-context-top" class="area-info-view" hidden>
+          <div class="hub-area-page">
+            <div class="eyebrow">FRAIM Hub</div>
+            <h1 class="area-h1" id="project-info-heading">Project</h1>
+            <p class="area-lede">This project's context, rules, learnings, and assignments.</p>
           <!-- Issue #1198 / #1253 R4 / #1661: the folder this project points at,
                always on screen. Relocation is an explicit Project Info action. -->
           <div id="proj-folder-row" class="proj-folder-row" hidden>
@@ -320,6 +325,7 @@
               </div>
             </div>
           </details>
+          </div>
         </div>
 
 
@@ -577,9 +583,13 @@
 
             <div class="coach-input">
               <input type="file" id="attach-file-input" multiple accept="image/png,image/jpeg,image/gif,.pdf,.txt,.log" hidden>
+              <div class="voice-input-status" id="voice-input-status" role="status" aria-live="polite" aria-atomic="true" hidden></div>
               <textarea id="coach-text" aria-label="Type an instruction" placeholder="Type a job name, /handle, or describe what you need..." data-placeholder-idle="Type a job name, /handle, or describe what you need..." data-placeholder-review="Reply to continue the run, or use Approve / Request changes above..." data-placeholder-active="Coach this run, or type new instructions..." data-placeholder-armed="Now type what you want done..."></textarea>
               <div class="composer-footer">
                 <button class="attach-btn" type="button" id="attach-btn" aria-label="Attach a file or screenshot" title="Attach a file or screenshot">&#128206;</button>
+                <button class="composer-icon-btn voice-input-btn" type="button" id="voice-input-btn" disabled aria-label="Start voice input" aria-describedby="voice-input-status" title="Loading voice input availability">
+                  <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="9" y="2" width="6" height="12" rx="3"/><path d="M5 10v2a7 7 0 0 0 14 0v-2M12 19v3M8 22h8"/></svg>
+                </button>
                 <div class="quick-coach-row composer-coach-actions" id="quick-coach-btns" hidden>
                 <button class="ghost quick-coach-btn mark-complete-btn composer-icon-btn" type="button" id="mark-complete-btn" aria-label="Mark the job complete" title="Mark complete">&#10003;</button>
                 <button class="run-stop-btn composer-stop-btn" id="run-stop-btn" type="button" hidden aria-label="Stop the employee" title="Stop the employee">&#9209;</button>