@atlas-coder/atlas-agent 0.15.2 → 0.15.3

package/README.md

@@ -13,6 +13,25 @@ On install, the matching native binary for your OS/arch is downloaded from the
 [GitHub release](https://github.com/Omerfaruk-aydn/Atlas-Agent/releases) that
 matches this package version.
 
+On Windows x64, installation and updates also run `atlas-agent voice install`.
+This downloads the offline **Vosk** runtime and Turkish, English, Italian and
+French models from their official sources, verifies pinned SHA256 hashes and
+installs them beside the executable. Downloads total approximately 185 MB;
+installed assets occupy approximately 344 MB. Existing complete assets are
+reused. Administrator permission, a transcription API and Whisper are not
+required. Failed speech setup leaves the coding CLI installed and usable.
+
+Use `atlas-agent voice install` to retry downloads and `atlas-agent voice status`
+to check recognition. `ATLAS_AGENT_SKIP_SPEECH_SETUP=1` skips automatic downloads.
+Menu language selects the dictation model unless `option voice language` is set.
+`option voice model-dir` and `option voice runtime-dir` support custom paths.
+
+The legacy Windows engine remains optional: set `option voice backend windows`.
+`atlas-agent voice setup` installs its Windows components and may request UAC.
+Set `ATLAS_AGENT_VOICE_BACKEND=windows` before npm installation to choose this
+optional setup instead of Vosk downloads. That legacy engine does not support
+Turkish or Italian. Arabic models are not installed. Audio remains local.
+
 ## Usage
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlas-coder/atlas-agent",
-  "version": "0.15.2",
+  "version": "0.15.3",
   "description": "Atlas Agent — terminal-first AI coding assistant. Downloads the native binary on install.",
   "license": "MIT",
   "private": false,

package/scripts/postinstall.js

@@ -14,6 +14,7 @@ const fs = require('fs');
 const path = require('path');
 const https = require('https');
 const { URL } = require('url');
+const { setupWindowsSpeech } = require('./speech-setup');
 
 const PLATFORM_MAP = { win32: 'windows', darwin: 'darwin', linux: 'linux' };
 const platform = PLATFORM_MAP[process.platform] || process.platform;
@@ -135,4 +136,5 @@ function download(url, redirectsLeft, attempt) {
   }
   const size = (fs.statSync(dest).size / 1024 / 1024).toFixed(1);
   console.log(`Atlas Agent postinstall: installed ${assetName} (${size} MB)`);
+  setupWindowsSpeech(dest);
 })();

package/scripts/speech-setup.js

@@ -0,0 +1,30 @@
+'use strict';
+
+const { spawnSync } = require('child_process');
+
+// Use the installed binary's embedded setup, never a second downloaded script.
+// Failure only affects dictation; the coding CLI remains usable.
+function setupWindowsSpeech(binary, options = {}) {
+  const platform = options.platform || process.platform;
+  const env = options.env || process.env;
+  const spawn = options.spawn || spawnSync;
+  const log = options.log || console;
+  if (platform !== 'win32' || env.ATLAS_AGENT_SKIP_SPEECH_SETUP === '1') return;
+  const backend = env.ATLAS_AGENT_VOICE_BACKEND === 'windows' ? 'setup' : 'install';
+  const args = ['voice', backend, '--automatic'];
+  if (env.ATLAS_AGENT_VOICE_LANGUAGE) {
+    args.push('--language', env.ATLAS_AGENT_VOICE_LANGUAGE);
+  }
+  log.log(backend === 'setup'
+    ? 'Atlas Agent: checking optional Windows speech components. Windows may request administrator approval.'
+    : 'Atlas Agent: installing verified offline Turkish, English, Italian and French Vosk models.');
+  const result = spawn(binary, args, {
+    stdio: 'inherit', windowsHide: true, shell: false, env,
+    timeout: 17 * 60 * 1000,
+  });
+  if (result.error || result.status !== 0) {
+    log.warn(`Atlas Agent is installed. Offline dictation setup did not finish; retry atlas-agent voice ${backend} later.`);
+  }
+}
+
+module.exports = { setupWindowsSpeech };

package/scripts/speech-setup.test.js

@@ -0,0 +1,29 @@
+'use strict';
+
+const assert = require('assert').strict;
+const { setupWindowsSpeech } = require('./speech-setup');
+
+let calls = [];
+let warnings = [];
+const fixture = {
+  platform: 'win32', env: {},
+  spawn: (...args) => { calls.push(args); return { status: 0 }; },
+  log: { log: () => {}, warn: (message) => warnings.push(message) },
+};
+setupWindowsSpeech('C:\\Users\\Ömer&Ceylin\\atlas.exe', fixture);
+assert.equal(calls.length, 1);
+assert.equal(calls[0][0], 'C:\\Users\\Ömer&Ceylin\\atlas.exe');
+assert.deepEqual(calls[0][1], ['voice', 'install', '--automatic']);
+assert.equal(calls[0][2].shell, false);
+assert.equal(calls[0][2].windowsHide, true);
+setupWindowsSpeech('atlas.exe', { ...fixture, platform: 'linux' });
+setupWindowsSpeech('atlas.exe', { ...fixture, env: { ATLAS_AGENT_SKIP_SPEECH_SETUP: '1' } });
+assert.equal(calls.length, 1);
+setupWindowsSpeech('atlas.exe', { ...fixture, env: { ATLAS_AGENT_VOICE_LANGUAGE: 'tr-TR' } });
+assert.deepEqual(calls[1][1], ['voice', 'install', '--automatic', '--language', 'tr-TR']);
+setupWindowsSpeech('atlas.exe', { ...fixture, env: { ATLAS_AGENT_VOICE_BACKEND: 'windows' } });
+assert.deepEqual(calls[2][1], ['voice', 'setup', '--automatic']);
+setupWindowsSpeech('atlas.exe', { ...fixture, spawn: () => ({ status: 1 }) });
+setupWindowsSpeech('atlas.exe', { ...fixture, spawn: () => ({ error: new Error('timed out') }) });
+assert.equal(warnings.length, 2);
+console.log('Windows speech installer checks passed.');