@hyperez/regna-code 0.1.9 → 0.2.1

package/README.md

@@ -15,28 +15,33 @@ Regna Code is a thin client. The models, knowledge, and routing live behind the
 npm i -g @hyperez/regna-code
 ```
 
-Then just run it. On first launch it walks you through login:
+Then just run it. On first launch it asks how you want to connect:
 
 ```
-regna                                      # logs in if needed, then starts interactive
-regna "explain this repo"                  # with a prompt
-regna -p "summarize today's changes" < /dev/null   # headless/scripted (close stdin)
+  Choose how to connect:
+    1) Online   - Regna cloud (regnax.ai)
+    2) Offline  - air-gapped / self-hosted gateway
 ```
 
-`regna` opens https://regnax.ai/console, you paste an API key once, and it is stored at `~/.regna/auth.json`. No environment setup needed.
+- **Online**: opens https://regnax.ai/console, you paste an API key once. Default model `regna-pro`.
+- **Offline**: you enter your internal gateway URL (OpenAI-compatible `/v1`) and key, then pick a default model from whatever the gateway serves. Offline runs with no engine self-network and the egress guard enforced.
+
+Your choice and credentials are stored at `~/.regna/auth.json`. After that:
 
 ```
-regna login                                # (re)authenticate
-regna logout                               # remove stored credentials
+regna                                      # starts interactive
+regna "explain this repo"                  # with a prompt
+regna -p "summarize today's changes" < /dev/null   # headless/scripted (close stdin)
 ```
 
-By default Regna Code talks to the Regna cloud (`https://regnax.ai/v1`). To use a self-hosted or air-gapped deployment, point it at your own endpoint before logging in:
-
 ```
-export REGNA_BASE_URL="http://<your-gateway>/v1"
+regna login                                # re-run the Online/Offline chooser
+regna login online                         # set up Online directly
+regna login offline                        # set up Offline directly
+regna logout                               # remove stored credentials
 ```
 
-For CI or scripted use, set `REGNA_API_KEY` directly; it takes priority over the stored login.
+For CI or scripted use, set `REGNA_API_KEY` directly; it takes priority over the stored login. Add `REGNA_OFFLINE=1` and `REGNA_BASE_URL` for non-interactive air-gapped use.
 
 ## Environment variables
 

package/dist/bin/regna.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import{spawn as v}from"node:child_process";import{fileURLToPath as P}from"node:url";import{dirname as m,join as o}from"node:path";import{existsSync as p,readFileSync as N,writeFileSync as G,mkdirSync as w,unlinkSync as L,chmodSync as k}from"node:fs";import{homedir as U}from"node:os";import{createInterface as $}from"node:readline/promises";var T=m(P(import.meta.url)),c=m(T),g=o(c,"extensions"),_=o(c,"themes","regna.json"),f=o(c,"APPEND_SYSTEM.md"),D="https://regnax.ai/v1",C="regna/regna-pro",h=o(U(),".regna"),d=o(h,"auth.json"),x=o(h,"engine"),a=process.argv.slice(2),u=(...e)=>a.some(t=>e.some(n=>!!(t===n||t.startsWith(`${n}=`)||/^-[a-z]$/i.test(n)&&t.startsWith(n)&&t.length>n.length)));function E(){for(let e of[o(c,"package.json"),o(c,"..","package.json")])try{let t=JSON.parse(N(e,"utf8")).version;if(t)return`v${t}`}catch{}return""}var O=`Regna Code ${E()} - a terminal coding agent on Regna
+import{spawn as x}from"node:child_process";import{fileURLToPath as D}from"node:url";import{dirname as R,join as i}from"node:path";import{existsSync as m,readFileSync as I,writeFileSync as F,mkdirSync as $,unlinkSync as M,chmodSync as j}from"node:fs";import{homedir as B}from"node:os";import{createInterface as K}from"node:readline";var Y=R(D(import.meta.url)),u=R(Y),E=i(u,"extensions"),_=i(u,"themes","regna.json"),A=i(u,"APPEND_SYSTEM.md"),k="https://regnax.ai/v1",q="regna/regna-pro",v=i(B(),".regna"),y=i(v,"auth.json"),P=i(v,"engine"),l=process.argv.slice(2),h=(...e)=>l.some(t=>e.some(n=>!!(t===n||t.startsWith(`${n}=`)||/^-[a-z]$/i.test(n)&&t.startsWith(n)&&t.length>n.length)));function N(){for(let e of[i(u,"package.json"),i(u,"..","package.json")])try{let t=JSON.parse(I(e,"utf8")).version;if(t)return`v${t}`}catch{}return""}var z=`Regna Code ${N()} - a terminal coding agent on Regna
 
 Usage:
   regna [message...]                 start interactive, optionally with a first message
@@ -7,7 +7,9 @@ Usage:
   regna -p "summarize changes" < /dev/null   headless/scripted (close stdin)
 
 Auth:
-  regna login                        log in to Regna and store your API key
+  regna login                        choose Online/Offline and store credentials
+  regna login online                 set up Online (Regna cloud) directly
+  regna login offline                set up Offline (air-gapped gateway) directly
   regna logout                       remove stored credentials
 
 In-session commands:
@@ -25,27 +27,42 @@ Environment:
   REGNA_POLICY        network egress guard: off | warn | enforce
 
 Docs: https://github.com/HyperEZ/regna-code
-`;function A(){try{let e=JSON.parse(N(d,"utf8"));return e&&typeof e.apiKey=="string"?e:null}catch{return null}}function B(e,t){w(h,{recursive:!0}),G(d,`${JSON.stringify({apiKey:e,baseUrl:t},null,2)}
-`);try{k(d,384)}catch{}}function j(){try{return L(d),!0}catch{return!1}}function F(e){try{return`${new URL(e).origin}/console`}catch{return"https://regnax.ai/console"}}function K(e){try{let[t,n]=process.platform==="darwin"?["open",[e]]:process.platform==="win32"?["cmd",["/c","start","",e]]:["xdg-open",[e]];v(t,n,{stdio:"ignore",detached:!0}).unref()}catch{}}async function Y(e,t){try{let n=new AbortController,s=setTimeout(()=>n.abort(),8e3),r=await fetch(`${e.replace(/\/+$/,"")}/models`,{headers:{Authorization:`Bearer ${t}`},signal:n.signal});return clearTimeout(s),r.status===401||r.status===403?"invalid":r.ok?"ok":"unknown"}catch{return"unknown"}}async function S(){let e=(process.env.REGNA_BASE_URL||"").trim()||A()?.baseUrl||D,t=F(e);process.stdout.write(`
-  Regna Code ${E()}
-  Log in to continue.
+`;function H(){try{let e=JSON.parse(I(y,"utf8"));return e&&typeof e.apiKey=="string"?e:null}catch{return null}}function J(e){$(v,{recursive:!0}),F(y,`${JSON.stringify(e,null,2)}
+`);try{j(y,384)}catch{}}function V(){try{return M(y),!0}catch{return!1}}function W(e){try{return`${new URL(e).origin}/console`}catch{return"https://regnax.ai/console"}}function Z(e){try{let[t,n]=process.platform==="darwin"?["open",[e]]:process.platform==="win32"?["cmd",["/c","start","",e]]:["xdg-open",[e]];x(t,n,{stdio:"ignore",detached:!0}).unref()}catch{}}async function b(e,t){try{let n=new AbortController,r=setTimeout(()=>n.abort(),8e3),s=await fetch(`${e.replace(/\/+$/,"")}/models`,{headers:{Authorization:`Bearer ${t}`},signal:n.signal});if(clearTimeout(r),s.status===401||s.status===403)return{status:"invalid",ids:[]};if(!s.ok)return{status:"unknown",ids:[]};let o=await s.json().catch(()=>({}));return{status:"ok",ids:Array.isArray(o?.data)?o.data.map(p=>p&&typeof p.id=="string"?p.id:"").filter(Boolean):[]}}catch{return{status:"unknown",ids:[]}}}function Q(e){let t=(e||"").trim();if(!t)return"";/^https?:\/\//i.test(t)||(t=`http://${t}`);try{let n=new URL(t),r=`${n.origin}${n.pathname}`.replace(/\/+$/,"");return/\/v\d+$/.test(r)||(r=`${r}/v1`),r}catch{return""}}function X(){let e=K({input:process.stdin}),t=[],n=[],r=!1;return e.on("line",o=>{n.length?n.shift()(o):t.push(o)}),e.on("close",()=>{for(r=!0;n.length;)n.shift()(null)}),{ask:o=>(process.stdout.write(o),new Promise(a=>{t.length?a(t.shift()):r?a(null):n.push(a)})),close:()=>e.close()}}async function ee(e){return process.stdout.write(`
+  Regna Code ${N()}
+  Choose how to connect:
 
-  1) Get an API key at ${t}
+    1) Online   - Regna cloud (regnax.ai)
+    2) Offline  - air-gapped / self-hosted gateway
+
+`),(await e("  Select [1]: ")||"").trim()==="2"?"offline":"online"}async function te(e){let t=k,n=W(t);process.stdout.write(`
+  Online mode (Regna cloud).
+  1) Get an API key at ${n}
   2) Paste it below.
 
-`),K(t);let n=$({input:process.stdin,output:process.stdout}),s="";try{s=(await n.question("  API key: ")).trim()}finally{n.close()}s||(process.stderr.write(`  No key entered. Aborting.
-`),process.exit(1));let r=await Y(e,s);return r==="invalid"&&(process.stderr.write(`  That key was rejected. Check it and run: regna login
-`),process.exit(1)),B(s,e),process.stdout.write(r==="ok"?`  Logged in.
+`),Z(n);let r=(await e("  API key: ")||"").trim();r||(process.stderr.write(`  No key entered. Aborting.
+`),process.exit(1));let{status:s}=await b(t,r);return s==="invalid"&&(process.stderr.write(`  That key was rejected. Run: regna login
+`),process.exit(1)),{mode:"online",baseUrl:t,apiKey:r}}async function ne(e){process.stdout.write(`
+  Offline mode (air-gapped).
+  Point Regna Code at your internal gateway (OpenAI-compatible /v1).
 
-`:`  Saved (could not verify right now).
+`);let t=(await e("  Gateway URL [http://localhost:8077/v1]: ")||"").trim(),n=Q(t)||"http://localhost:8077/v1",r=(await e("  API key: ")||"").trim();r||(process.stderr.write(`  No key entered. Aborting.
+`),process.exit(1));let{status:s,ids:o}=await b(n,r);s==="invalid"&&(process.stderr.write(`  That key was rejected by the gateway. Run: regna login
+`),process.exit(1));let a="regna/default";if(s==="ok"&&o.length>0){let p=o.filter(w=>w==="default"||!w.includes("/")),f=p.length?p:o;if(f.length===1)a=`regna/${f[0]}`;else{process.stdout.write(`
+  Models served by the gateway:
+`),f.forEach((T,U)=>process.stdout.write(`    ${U+1}) ${T}
+`));let w=(await e(`
+  Default model [1]: `)||"").trim(),C=Math.max(1,Math.min(f.length,parseInt(w||"1",10)||1))-1;a=`regna/${f[C]}`}}else process.stdout.write(`  (Could not list models now; will use the gateway's active model.)
+`);return{mode:"offline",baseUrl:n,apiKey:r,model:a}}async function G(e){let{ask:t,close:n}=X();try{let s=(e||await ee(t))==="offline"?await ne(t):await te(t);return J(s),process.stdout.write(`
+  Saved. Mode: ${s.mode}${s.model?`, default model: ${s.model}`:""}.
 
-`),s}(u("--help","-h")||a[0]==="help")&&(process.stdout.write(O),process.exit(0));(u("--version")||a[0]==="version")&&(process.stdout.write(`Regna Code ${E()}
-`),process.exit(0));a[0]==="login"&&(await S(),process.exit(0));a[0]==="logout"&&(process.stdout.write(j()?`Logged out.
+`),s}finally{n()}}(h("--help","-h")||l[0]==="help")&&(process.stdout.write(z),process.exit(0));(h("--version")||l[0]==="version")&&(process.stdout.write(`Regna Code ${N()}
+`),process.exit(0));if(l[0]==="login"){let e=l[1]==="online"||l[1]==="offline"?l[1]:void 0;await G(e),process.exit(0)}l[0]==="logout"&&(process.stdout.write(V()?`Logged out.
 `:`Not logged in.
-`),process.exit(0));var l=(process.env.REGNA_API_KEY||"").trim();if(!l){let e=A();e?.apiKey&&(l=e.apiKey.trim(),!process.env.REGNA_BASE_URL&&e.baseUrl&&(process.env.REGNA_BASE_URL=e.baseUrl))}if(!l)if(process.stdin.isTTY&&process.stdout.isTTY){if(l=await S(),!process.env.REGNA_BASE_URL){let e=A();e?.baseUrl&&(process.env.REGNA_BASE_URL=e.baseUrl)}}else process.stderr.write(`[regna] Not logged in. Run: regna login
-`),process.exit(1);process.env.REGNA_API_KEY=l;var i=[],q=process.env.REGNA_DISCOVER==="1";if(!q){i.push("--no-extensions");let e=["provider","policy","branding","model","context","exit","docs-search","docs-analysis"],t=r=>{let R=o(g,`${r}.js`);if(p(R))return R;let y=o(g,`${r}.ts`);return p(y)?y:null},n=e.map(r=>[r,t(r)]),s=n.filter(([,r])=>!r).map(([r])=>r);s.length>0&&(process.stderr.write(`[regna] Missing required extensions: ${s.join(", ")} (in ${g}). Install is corrupted. Aborting.
-`),process.exit(1));for(let[,r]of n)i.push("-e",r)}!u("--theme")&&p(_)&&i.push("--theme",_);u("--system-prompt")||(p(f)||(process.stderr.write(`[regna] Missing required prompt: APPEND_SYSTEM.md (${f}). Install is corrupted. Aborting.
+`),process.exit(0));var c=null,g=(process.env.REGNA_API_KEY||"").trim();g?c={mode:process.env.REGNA_OFFLINE==="1"?"offline":"online",apiKey:g}:(c=H(),c?.apiKey?g=c.apiKey.trim():process.stdin.isTTY&&process.stdout.isTTY?(c=await G(),g=c.apiKey.trim()):(process.stderr.write(`[regna] Not logged in. Run: regna login
+`),process.exit(1)));var O=process.env.REGNA_OFFLINE==="1"||c?.mode==="offline",se=(process.env.REGNA_BASE_URL||"").trim()||c?.baseUrl||k,re=(process.env.REGNA_MODEL||"").trim()||c?.model||(O?"regna/default":q);process.env.REGNA_API_KEY=g;process.env.REGNA_BASE_URL=se;O&&(process.env.REGNA_OFFLINE||(process.env.REGNA_OFFLINE="1"),process.env.REGNA_POLICY||(process.env.REGNA_POLICY="enforce"));var d=[],oe=process.env.REGNA_DISCOVER==="1";if(!oe){d.push("--no-extensions");let e=["provider","policy","branding","model","context","exit","docs-search","docs-analysis"],t=s=>{let o=i(E,`${s}.js`);if(m(o))return o;let a=i(E,`${s}.ts`);return m(a)?a:null},n=e.map(s=>[s,t(s)]),r=n.filter(([,s])=>!s).map(([s])=>s);r.length>0&&(process.stderr.write(`[regna] Missing required extensions: ${r.join(", ")} (in ${E}). Install is corrupted. Aborting.
+`),process.exit(1));for(let[,s]of n)d.push("-e",s)}!h("--theme")&&m(_)&&d.push("--theme",_);h("--system-prompt")||(m(A)||(process.stderr.write(`[regna] Missing required prompt: APPEND_SYSTEM.md (${A}). Install is corrupted. Aborting.
   (To set the prompt yourself on purpose, run with --system-prompt.)
-`),process.exit(1)),i.push("--append-system-prompt",`@${f}`));u("--model","-m")||i.push("--model",process.env.REGNA_MODEL||C);i.push(...a);try{w(x,{recursive:!0})}catch{}var b={...process.env,PI_CODING_AGENT_DIR:x};process.env.REGNA_OFFLINE==="1"&&(b.PI_OFFLINE="1");function M(){let e=o("node_modules","@earendil-works","pi-coding-agent","dist","cli.js"),t=c;for(let n=0;n<10;n++){let s=o(t,e);if(p(s))return s;let r=m(t);if(r===t)break;t=r}return null}function H(){let e=process.env.REGNA_ENGINE;if(e)return{cmd:e,prefix:[],label:e};let t=M();return t?{cmd:process.execPath,prefix:[t],label:t}:{cmd:"pi",prefix:[],label:"runtime (PATH)"}}var{cmd:z,prefix:J,label:V}=H(),I=v(z,[...J,...i],{stdio:"inherit",env:b});I.on("error",e=>{e&&e.code==="ENOENT"&&(process.stderr.write(`[regna] Runtime executable not found (${V}). Reinstall (npm i -g @hyperez/regna-code) or set REGNA_ENGINE.
+`),process.exit(1)),d.push("--append-system-prompt",`@${A}`));h("--model","-m")||d.push("--model",re);d.push(...l);try{$(P,{recursive:!0})}catch{}var L={...process.env,PI_CODING_AGENT_DIR:P};process.env.REGNA_OFFLINE==="1"&&(L.PI_OFFLINE="1");function ie(){let e=i("node_modules","@earendil-works","pi-coding-agent","dist","cli.js"),t=u;for(let n=0;n<10;n++){let r=i(t,e);if(m(r))return r;let s=R(t);if(s===t)break;t=s}return null}function ae(){let e=process.env.REGNA_ENGINE;if(e)return{cmd:e,prefix:[],label:e};let t=ie();return t?{cmd:process.execPath,prefix:[t],label:t}:{cmd:"pi",prefix:[],label:"runtime (PATH)"}}var{cmd:ce,prefix:le,label:de}=ae(),S=x(ce,[...le,...d],{stdio:"inherit",env:L});S.on("error",e=>{e&&e.code==="ENOENT"&&(process.stderr.write(`[regna] Runtime executable not found (${de}). Reinstall (npm i -g @hyperez/regna-code) or set REGNA_ENGINE.
 `),process.exit(127)),process.stderr.write(`[regna] Failed to start the runtime: ${e?.message??String(e)}
-`),process.exit(1)});I.on("exit",(e,t)=>{if(t){process.kill(process.pid,t);return}process.exit(e??0)});
+`),process.exit(1)});S.on("exit",(e,t)=>{if(t){process.kill(process.pid,t);return}process.exit(e??0)});

package/dist/postinstall.mjs

@@ -26,6 +26,9 @@
  *      on first run) without re-enabling the update check or phoning telemetry home. Fully
  *      offline air-gapped use is then an explicit REGNA_OFFLINE=1 opt-in in the launcher.
  *
+ *   5) Hide the "Extensions" and "Themes" sections of the startup resource panel (internal
+ *      implementation detail). Context and Skills still show.
+ *
  * Best effort: every patch is wrapped so a failure (e.g. the engine changed its layout) just
  * leaves that aspect at the engine default and never fails the install. All patches are
  * idempotent and safe to run on every install.
@@ -101,3 +104,16 @@ patchEngineFile(
 	/if \(process\.env\.PI_OFFLINE\) \{/g,
 	"if (true) {",
 );
+
+// 5) Hide the "Extensions" and "Themes" sections from the startup resource panel. These are
+//    Regna Code internals the user does not need to see (Context and Skills still show).
+patchEngineFile(
+	join("dist", "modes", "interactive", "interactive-mode.js"),
+	/addLoadedSection\("Extensions", extensionCompactList, extList, "mdHeading"\);/,
+	"void 0;",
+);
+patchEngineFile(
+	join("dist", "modes", "interactive", "interactive-mode.js"),
+	/addLoadedSection\("Themes", themeCompactList, themeList\);/,
+	"void 0;",
+);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperez/regna-code",
-  "version": "0.1.9",
+  "version": "0.2.1",
   "description": "Regna Code. A terminal coding agent on Regna. Install with `npm i -g @hyperez/regna-code` and run `regna`. Works with the Regna cloud API and on-premise deployments.",
   "license": "PolyForm-Noncommercial-1.0.0",
   "private": false,