@shardflux/desktop-linux-arm64 0.1.0-next.5 → 0.1.1

package/CHANGELOG.md

@@ -1,7 +1,14 @@
 # Changelog
 
-## 0.1.0 (not yet published)
+## 0.1.1 (not yet published)
 
-- Shardflux for Ubuntu 24.04: desktop onboarding, conversations and launcher.
+- The app reads `shard`'s answers whole: Settings → Agents shows Connected (or Connect) instead of staying on
+  Checking…, the top-bar panel refreshes your conversations, and a conversation you start opens instead of showing
+  its details as an error. A note shard prints next to its answer (such as `Initialized a git repository …`) no
+  longer gets in the way, and a failed command shows its message. Installed with CLI 0.18.1+.
 
-- Port all seven Settings panes, device and vault approvals, actionable desktop notifications, file placeholders, screenshot capture and self-update. Use the custom StatusNotifierItem panel, publisher app marks, licensed Lucide icons and system-accent selections.
+## 0.1.0 (2026-10-10)
+
+- The Shardflux app for Ubuntu 24.04 (arm64): guided sign-in and agent setup, the top-bar panel for your
+  conversations, the launcher (Alt+Shift+Space), Settings, device and sign-in approvals, notifications with actions,
+  file downloads and self-update. Installed with `npm i -g shardflux` (CLI 0.18.0+) and opened by `shard`.

package/app/manifest.json

@@ -1 +1 @@
-{"id":"dev.shardflux.Desktop","version":"0.1.0-next.5"}
+{"id": "dev.shardflux.Desktop", "version": "0.1.1"}

package/app/ui/app.mjs

@@ -1,6 +1,6 @@
 import {icon,appMark,spinner} from './icons.mjs';
 import {installTray} from './tray.mjs';
-import {steps,samplePrompt,readProgress,canContinue,anyAgentConnected,accountConnected,demoPhase,cardState,commands,recordStart,DemoTurn,browserEvent,streamURL,safeHTTPS,observeActivity,recap,openPlace,shortcutLabel,escape as e} from './core.mjs';
+import {steps,samplePrompt,readProgress,cliResult,streams,canContinue,anyAgentConnected,accountConnected,demoPhase,cardState,commands,recordStart,DemoTurn,browserEvent,streamURL,safeHTTPS,observeActivity,recap,openPlace,shortcutLabel,escape as e} from './core.mjs';
 import {agentRows} from './agents.mjs';
 import {installSurfaces} from './surfaces.mjs';
 import {installSettings} from './settings.mjs';
@@ -14,7 +14,9 @@ model.rows=[];
 model.api=api;
 window.addEventListener('sf-profile',async ev=>{api=ev.detail;model.api=api;model.p=readProgress(await host('read',{name:'onboarding.json'}),api);model.error='';await refresh();render();});
 export const button=(title,action,cls='',disabled=false)=>`<button class="${cls}" data-action="${action}" ${disabled?'disabled':''}>${title}</button>`;
-export async function cli(argv,options={}) {let raw;try{raw=await host('cli',{argv,...options});}catch(err){raw=err.message;let detail;for(const line of raw.trim().split('\n')){try{detail=JSON.parse(line).error;}catch{}}if(detail)throw Object.assign(new Error(detail.message),{detail});throw err;}let result;for(const line of raw.trim().split('\n')){try{result=JSON.parse(line);}catch{}}if(result===undefined)throw new Error(raw.trim()||'shard returned no response.');if(result.error)throw Object.assign(new Error(result.error.message),{detail:result.error});return result;}
+// stdout and stderr arrive apart (see cliResult): the result is stdout's JSON document, or its NDJSON events for the
+// browser sign-in. A run that could not start at all rejects in the native host.
+export async function cli(argv,options={}) {return cliResult(await host('cli',{argv,...options}),{stream:streams(argv)});}
 export async function openConversation(key,target='auto') {const d=await cli(commands.open(key,target));if(d.url)await host('open',{url:d.url});else if(d.target==='terminal')await host('terminal',{argv:d.command||['shard','agents','open',key]});else if(!d.opened&&!d.ok)throw new Error('shard did not return a conversation destination. Update Shardflux and try Open again.');return d;}
 export const save=()=>host('write',{name:'onboarding.json',value:model.p});
 export const savePrefs=()=>host('write',{name:'desktop-linux.json',value:model.prefs});
@@ -52,7 +54,7 @@ export function render(){
 }
 async function signedIn(email){model.email=email;model.signIn='done';model.p.completed=[...new Set([...model.p.completed,0])];render();await cli(commands.setup);await refresh();model.signIn='idle';await go(1);}
 let browserRun;
-async function signIn(browser){model.error='';model.signIn=browser?'browser':'working';render();if(browser){browserRun=host('cli',{argv:commands.browser('Shardflux for Linux'),stream:true,timeout:540});await browserRun;return;}try{const doc=await cli(commands.signIn);await signedIn(doc.user?.email);}catch(err){if(/mfa|two.factor|verification/i.test(err.message)){model.signIn='mfa';render();}else throw err;}}
+async function signIn(browser){model.error='';model.signIn=browser?'browser':'working';render();if(browser){const argv=commands.browser('Shardflux for Linux');browserRun=host('cli',{argv,stream:true,timeout:540});const run=await browserRun;if(model.signIn==='browser'&&run.status!==0)cliResult(run,{stream:true});return;}try{const doc=await cli(commands.signIn);await signedIn(doc.user?.email);}catch(err){if(/mfa|two.factor|verification/i.test(err.message)){model.signIn='mfa';render();}else throw err;}}
 window.addEventListener('sf-cli-line',async ev=>{if(ev.detail.id!==browserRun?.id)return;const value=browserEvent(ev.detail.line);if(value?.event==='open'){model.code=value.user_code;model.url=value.verification_uri_complete;render();}else if(value?.event==='signed_in'){try{await signedIn(value.email);}catch(err){model.error=err.message;render();}}else if(value?.event==='error'){model.error=value.message;model.signIn='idle';render();}});
 async function go(step){model.p.step=step;await save();if(step===2&&!model.p.sample_path){const d=await cli(commands.sample);if(!d.sample_path?.startsWith('/'))throw new Error('The sample project could not be prepared.');model.p.sample_path=d.sample_path;await save();}render();}
 export async function connect(id){const c=model.inspection?.connections.find(c=>c.id===id);if(c?.action?.url){await host('open',{url:safeHTTPS(c.action.url)});return;}if(c?.action?.retry){await refresh(true,id==='codex');return;}if(c?.action?.command){const argv=c.action.command;if(argv[0]==='shard'){await cli([...argv.slice(1).filter(a=>a!=='--json'),'--json']);}else await host('terminal',{argv});}else await refresh(true,id==='codex');await refresh();}

package/app/ui/core.mjs

@@ -55,6 +55,41 @@ export function reference(doc,joined=false) {
   if(doc.workspace?.workspace_key)return doc.workspace.workspace_key;
   throw new Error('shard did not return a conversation destination. Update Shardflux and try Open again.');
 }
+// How the page reads a shard run, as the Mac's ConversationProcess does. The native host hands over {status,
+// timed_out, stdout, stderr} with the two streams apart. `--json` prints one JSON document on stdout, pretty-printed
+// over many lines; the only command that streams NDJSON events (one per line) is the browser sign-in, as in
+// MenuBarCore (BrowserSignIn.run is ConversationProcess's one onLine caller). A failure's error envelope
+// ({"error":{code,message,...}}) is read from stdout, else from the end of stderr, where CLI 0.18.0 writes it; any
+// other stderr text is a diagnostic ("Initialized a git repository in …") and never decides the result.
+export const streams = argv => argv[0]==='auth' && argv[1]==='login' && argv.includes('--browser');
+const parseJSON = text => {try{return JSON.parse(text);}catch{return undefined;}};
+/** The whole text as one JSON document, else the last one in it: pretty-printed JSON opens at column 0 and indents
+ * everything inside, so the last line starting with { or [ starts the last document. */
+export function lastDocument(text='') {
+  const whole=parseJSON(text.trim());if(whole!==undefined)return whole;
+  const lines=text.split('\n');
+  for(let i=lines.length-1;i>=0;i--)if(/^[{[]/.test(lines[i])){const doc=parseJSON(lines.slice(i).join('\n').trim());if(doc!==undefined)return doc;}
+  return undefined;
+}
+const envelope = doc => doc && typeof doc==='object' && doc.error && typeof doc.error==='object' && typeof doc.error.message==='string' ? doc.error : null;
+/** The command's answer, or an Error carrying `detail` (the error envelope) and `doc` (what stdout said). A run that
+ * exited 0 with a readable document is a success, whatever stderr holds. */
+export function cliResult(run, {stream=false}={}) {
+  const {status=-1,stdout='',stderr='',timed_out:timedOut=false}=run&&typeof run==='object'?run:{};
+  let doc,detail=null;
+  if(stream){const events=stdout.split('\n').map(line=>parseJSON(line.trim())).filter(v=>v&&typeof v==='object');doc=events.at(-1);const failed=events.findLast(v=>v.event==='error');if(failed)detail={code:failed.code,message:failed.message};}
+  else doc=lastDocument(stdout);
+  detail??=envelope(doc);
+  if(status===0&&doc!==undefined&&!detail)return doc;
+  if(!detail&&status!==0)detail=envelope(lastDocument(stderr));
+  const extra=doc!==undefined&&!envelope(doc)?{doc}:{};
+  if(detail)throw Object.assign(new Error(detail.message),{detail},extra);
+  if(timedOut)throw Object.assign(new Error('shard took too long. Check your conversations before starting another one.'),extra);
+  if(status===0)throw new Error('shard returned a response this app can’t read. Update Shardflux and try again.');
+  // Without an envelope only shard's own `error:` line is worth showing; a diagnostic is not the reason it failed.
+  const said=stderr.split('\n').map(l=>l.trim()).findLast(l=>l.startsWith('error: '))?.slice(7).replace(/\s*\[code=[^\]]*\]$/,'');
+  throw Object.assign(new Error(said||'shard could not finish. Check your sign-in and try again.'),extra);
+}
 export function browserEvent(line) {
   try {const e=JSON.parse(line);if(e.event==='open' && e.user_code)return {...e,verification_uri_complete:safeHTTPS(e.verification_uri_complete)};if(['signed_in','error'].includes(e.event))return e;}catch{}return null;
 }

package/app/ui/surfaces.mjs

@@ -175,6 +175,8 @@ export function installSurfaces({model,host,cli,save,savePrefs,render,button,reg
       const failure=t3Failure(err.detail);
       if(failure){L.remedy=t3Remedy(failure,L.targets?.t3?.mode)?failure:null;if(failure.threadID)L.created=failureReference(failure)??`t3:${failure.threadID}`;else if(failure.conversation)L.created=failure.conversation;}
       else if(err.detail?.details?.workspace_key)L.created=err.detail.details.workspace_key;
+      // shard printed the started conversation and then failed: offer that one, never a second Start.
+      else if(err.doc){try{L.created=reference(err.doc,!!L.on);}catch{}}
       L.error=err.message;
     }finally{L.stage=null;if(promptFile)await host('remove-prompt',{path:promptFile});render();}
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardflux/desktop-linux-arm64",
-  "version": "0.1.0-next.5",
+  "version": "0.1.1",
   "description": "Shardflux desktop app for Ubuntu Linux",
   "license": "Apache-2.0",
   "os": [
@@ -20,5 +20,8 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "prepack": "node scripts/check-package.mjs"
   }
 }