arcane-os 0.6.2 → 0.7.1

package/runtime/arcane/components/voice-transcription.html

@@ -42,15 +42,40 @@
     }
 
     .description,
-    .status{
-        margin:0;
+    .status {
+        margin: 0;
+        overflow-wrap: anywhere;
+    }
+
+    .transcription-feedback {
+        min-width: 0;
+    }
+
+    .stt-activation-progress {
+        display: block;
+        width: 100%;
+        height: .6rem;
+        margin-block-start: .7rem;
+        accent-color: var(--arcane-action, var(--primary-color));
+    }
+
+    .stt-activation-progress[hidden] {
+        display: none;
     }
 </style>
 
 <section class="voice-transcription">
     <p id="description" class="description"></p>
     <section id="transcript" class="transcript"></section>
-    <p id="status" class="status" role="status" aria-live="polite"></p>
+    <div class="transcription-feedback">
+        <p id="status" class="status" role="status" aria-live="polite"></p>
+        <progress
+            id="sttActivationProgress"
+            class="stt-activation-progress"
+            aria-label="Transcription model activation progress"
+            hidden
+        ></progress>
+    </div>
     <section class="controls">
         <button id="start" type="button" disabled></button>
         <button id="sttActivation" type="button" hidden disabled>Start transcription</button>
@@ -104,6 +129,7 @@
     const status=host.shadowRoot.querySelector('#status');
     const startButton=host.shadowRoot.querySelector('#start');
     const sttActivationButton=host.shadowRoot.querySelector('#sttActivation');
+    const sttActivationProgress = host.shadowRoot.querySelector('#sttActivationProgress');
     const stopButton=host.shadowRoot.querySelector('#stop');
     const completeButton=host.shadowRoot.querySelector('#complete');
     const runtimeStateAbortController=new AbortController();
@@ -225,6 +251,7 @@
         {
             host,
             button:sttActivationButton,
+            progress: sttActivationProgress,
             onChange:renderState,
             eventSource:events
         }

package/runtime/arcane/modules/ComponentContracts.js

@@ -407,27 +407,60 @@ function effectiveDashboardVisibility(definitions=[],visibility={}){
     );
 }
 
-function formatAIRuntimeProgress(progress,fallback){
-    const phase=is.string(progress?.phase)&&progress.phase
-        ?progress.phase
-        :fallback;
-    const completed=progress?.completed;
-    const total=progress?.total;
-    const unit=is.string(progress?.unit)
-        ?progress.unit
-        :'';
-    if(!is.finite(completed)
-        ||!is.finite(total)
-        ||total<=0
-        ||!unit){
-        return phase;
+function formatAIRuntimeProgress(progress, fallback) {
+    const phase = is.string(progress?.phase) && progress.phase
+        ? progress.phase
+        : fallback;
+    const parts = [phase];
+    const message = is.string(progress?.message) && progress.message
+        ? progress.message
+        : is.string(progress?.stage) && progress.stage
+            ? progress.stage
+            : '';
+    if (message && message !== phase) {
+        parts.push(message);
     }
-    return `${phase} · ${completed} of ${total} ${unit}`;
+    const item = is.string(progress?.item) && progress.item
+        ? progress.item
+        : is.string(progress?.file) && progress.file
+            ? progress.file
+            : '';
+    if (item && item !== message) {
+        parts.push(item);
+    }
+    const completed = progress?.completed;
+    const total = progress?.total;
+    const unit = is.string(progress?.unit)
+        ? progress.unit
+        : '';
+    if (is.finite(completed) && is.finite(total) && total > 0 && unit) {
+        parts.push(`${completed} of ${total} ${unit}`);
+    } else if (is.finite(completed) && completed >= 0 && unit === 'files') {
+        parts.push(`${completed} files complete`);
+    }
+    if (is.finite(progress?.elapsedMs) && progress.elapsedMs >= 0) {
+        const elapsedSeconds = Math.floor(progress.elapsedMs / 1000);
+        const hours = Math.floor(elapsedSeconds / 3600);
+        const minutes = Math.floor(elapsedSeconds % 3600 / 60);
+        const seconds = elapsedSeconds % 60;
+        parts.push(
+            hours > 0
+                ? `${hours}h ${minutes}m elapsed`
+                : minutes > 0
+                    ? `${minutes}m ${String(seconds).padStart(2, '0')}s elapsed`
+                    : `${seconds}s elapsed`
+        );
+    }
+    if (progress?.heartbeat === true) {
+        parts.push('Still working');
+    }
+    return parts.join(' · ');
 }
 
 function createSTTActivationController({
     host,
     button,
+    progress = null,
     onChange,
     EventClass=globalThis.CustomEvent,
     eventSource=null
@@ -595,6 +628,40 @@ function createSTTActivationController({
             &&['unloaded','loading','unloading','error'].includes(role.state);
     }
 
+    function renderProgress() {
+        if (!progress) {
+            return;
+        }
+        const active = !destroyed
+            && (requestPending || ['loading', 'unloading'].includes(role?.state));
+        progress.hidden = !active;
+        if (!active) {
+            progress.removeAttribute('value');
+            progress.removeAttribute('max');
+            progress.removeAttribute('aria-valuetext');
+            return;
+        }
+        const completed = role?.progress?.completed;
+        const total = role?.progress?.total;
+        const unit = role?.progress?.unit;
+        if (!is.finite(completed)
+            || completed < 0
+            || !is.finite(total)
+            || total <= 0
+            || !is.string(unit)
+            || !unit) {
+            progress.removeAttribute('value');
+            progress.removeAttribute('max');
+        } else {
+            progress.max = total;
+            progress.value = completed;
+        }
+        progress.setAttribute(
+            'aria-valuetext',
+            status()
+        );
+    }
+
     async function request(nextAction){
         if(destroyed||requestPending||action()!==nextAction){
             return false;
@@ -647,6 +714,7 @@ function createSTTActivationController({
                 ||action()!==nextAction){
                 return false;
             }
+            renderProgress();
             onChange();
             if(destroyed
                 ||generation!==requestGeneration
@@ -715,6 +783,7 @@ function createSTTActivationController({
             if(!destroyed&&generation===requestGeneration){
                 requestPending=false;
                 try{
+                    renderProgress();
                     onChange();
                 }catch(error){
                     arcaneLogging.error('Unable to render STT activation state:',error);
@@ -749,6 +818,7 @@ function createSTTActivationController({
             requestPending=false;
         }
         role=nextRole;
+        renderProgress();
     }
 
     function destroy(){
@@ -758,6 +828,7 @@ function createSTTActivationController({
         destroyed=true;
         requestGeneration+=1;
         requestPending=false;
+        renderProgress();
         try{
             button.removeEventListener('click',activateSelectedSTT);
         }catch(error){

package/src/cli/main.mjs

@@ -35,6 +35,7 @@ const VALUE_OPTIONS=new Set([
 ]);
 const FLAG_OPTIONS=new Set([
     'git',
+    'public',
     'skip-tests',
     'dry-run',
     'require-local-ai',
@@ -60,7 +61,7 @@ Usage:
   ${CLI_NAME} upgrade [--workspace <directory>] [--app <id>]
   ${CLI_NAME} doctor [--workspace <directory>] [--arcane-root <directory>]
   ${CLI_NAME} import-map [--workspace <directory>] [--app <id>]
-  ${CLI_NAME} dev [--app <id>] [--host 127.0.0.1] [--port 8000] [--sdk-runtime-source <sdk-root>]
+  ${CLI_NAME} dev [--app <id>] [--public] [--host <address>] [--port 8000] [--sdk-runtime-source <sdk-root>]
   ${CLI_NAME} test [--app <id>] [--scope app]
   ${CLI_NAME} test --scope shared --test-file <repo-relative.test.mjs>
   ${CLI_NAME} check [--app <id>] [--scope app] [--skip-tests]
@@ -83,6 +84,8 @@ Usage:
   ${CLI_NAME} mail serve --profile <profile> --from <address> --app <id> --origin <origin> [--allow-to <addresses>] [--app-key-stdin] [--host 127.0.0.1] [--port 8025] [--request-timeout <ms>]
 
 Development:
+  --public                      Bind all IPv4 interfaces (0.0.0.0) and print network URLs.
+  --host <address>               Override the bind address; takes precedence over --public.
   --sdk-runtime-source <sdk-root>  Dev-only live SDK checkout; omitted preserves the workspace runtime mode.
 
 Global:
@@ -445,6 +448,9 @@ function operationOptions(command,parsed,cwd){
     if(values['sdk-runtime-source']!==undefined&&command!=='dev'){
         usage('--sdk-runtime-source is supported only by dev.');
     }
+    if(flags.has('public')&&command!=='dev'){
+        usage('--public is supported only by dev.');
+    }
     if(flags.has('overwrite')&&command!=='bundle'){
         usage('--overwrite is supported only by bundle.');
     }
@@ -506,7 +512,7 @@ function operationOptions(command,parsed,cwd){
         noExtraPositionals(command,positionals);
         return {
             ...common,
-            host:values.host??'127.0.0.1',
+            host:values.host??(flags.has('public')?'0.0.0.0':'127.0.0.1'),
             port:readPort(values.port,8000),
             ...(values['sdk-runtime-source']===undefined?{}:{
                 sdkRuntimeSourceRoot:path.resolve(cwd,values['sdk-runtime-source'])
@@ -831,6 +837,7 @@ function serverSummary(result){
         host:result.host,
         port:result.port,
         url:result.url,
+        ...(result.networkUrls===undefined?{}:{networkUrls:result.networkUrls}),
         ...(result.callerAuthentication
             ?{callerAuthentication:result.callerAuthentication}
             :{}),
@@ -841,7 +848,11 @@ function serverSummary(result){
 }
 
 async function waitForServer(result,signal,reporter){
-    reporter.emit('server.ready',serverSummary(result),`Development server ready at ${result.url}`);
+    const readyMessage=[
+        `Development server ready at ${result.url}`,
+        ...(result.networkUrls??[]).map(function networkAddress(url){return `Network: ${url}`;})
+    ].join('\n');
+    reporter.emit('server.ready',serverSummary(result),readyMessage);
     if(result.lifecycle&&is.function(result.lifecycle.then)){
         const abort=()=>{
             void Promise.resolve().then(()=>result.close?.()).catch(()=>{});

package/src/dev-server.mjs

@@ -2,6 +2,7 @@ import Is from 'strong-type';
 import {constants as FS_CONSTANTS} from 'node:fs';
 import {lstat,open,readFile,realpath} from 'node:fs/promises';
 import http from 'node:http';
+import os from 'node:os';
 import path from 'node:path';
 import {resolveWorkspace} from './workspace.mjs';
 import {createEventQueue} from './event-queue.mjs';
@@ -489,6 +490,29 @@ function listen(server,{host,port,signal}){
     });
 }
 
+function browserHostname(host){
+    return host.includes(':')?`[${host}]`:host;
+}
+
+function networkUrlsForAddress(address,startPath){
+    if(address.address==='127.0.0.1'||address.address==='::1')return [];
+    const allIPv4=address.address==='0.0.0.0';
+    const allInterfaces=address.address==='::';
+    const urls=new Set();
+    for(const entries of Object.values(os.networkInterfaces())){
+        for(const entry of entries??[]){
+            if(entry.internal)continue;
+            // Scoped IPv6 addresses need the receiving device's interface,
+            // so they cannot provide a portable browser link for another device.
+            if(entry.family==='IPv6'&&entry.scopeid)continue;
+            if(allIPv4&&entry.family!=='IPv4')continue;
+            if(!allIPv4&&!allInterfaces&&entry.address!==address.address)continue;
+            urls.add(`http://${browserHostname(entry.address)}:${address.port}${startPath}`);
+        }
+    }
+    return [...urls];
+}
+
 async function startOwnedDevServer({
     workspaceRoot=process.cwd(),
     appId,
@@ -504,8 +528,8 @@ async function startOwnedDevServer({
     if(sdkRuntimeSourceRoot!==undefined&&mode!=='source'){
         fail('sdkRuntimeSourceRoot is supported only in source development mode.','ARCANE_USAGE');
     }
-    if(host!=='127.0.0.1'&&host!=='::1'){
-        fail('Development server host must be a numeric loopback address (127.0.0.1 or ::1).','ARCANE_POLICY_DENIED');
+    if(!is.string(host)||!host.trim()){
+        fail('Development server host must be a nonempty string.','ARCANE_USAGE');
     }
     if(!is.integer(port)||port<0||port>65535)fail('port must be an integer from 0 through 65535.','ARCANE_USAGE');
     const requestedRuntimeMode=mode==='source'&&sdkRuntimeSourceRoot!==undefined
@@ -631,7 +655,9 @@ async function startOwnedDevServer({
         server.close();
         fail('Development server did not expose a TCP address.');
     }
-    const visibleHost=address.family==='IPv6'?`[${address.address}]`:address.address;
+    const visibleHost=address.address==='0.0.0.0'||address.address==='::'
+        ?'localhost'
+        :browserHostname(address.address);
     const endpoint=new URL(`http://${visibleHost}:${address.port}`);
     const origin=endpoint.origin;
     const cleanUrl=`${origin}${routeSet.startPath}`;
@@ -728,17 +754,20 @@ async function startOwnedDevServer({
         origin,
         cleanUrl,
         url,
+        networkUrls:[],
         close,
         closed:lifecycle,
         lifecycle
     };
     try{
+        result.networkUrls=networkUrlsForAddress(address,routeSet.startPath);
         await events.send({
             type:'server.started',
             mode,
             host:result.host,
             port:result.port,
             url,
+            networkUrls:result.networkUrls,
             appId:result.appId,
             ...(routeSet.runtime?{
                 runtimeMode:routeSet.runtime.mode,