Skip to content

armgit / mso

Public Imported from GitHub
0

Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.

feat(integrations): polish Finder TUI frame and UX

Rahman42f4ab3f4037
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 2c64ab3c..b25d43e6 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -8,6 +8,7 @@ this is the *what*, and it is what Settings → About shows as “What's new”.
**Added**
+- `integrations` polish Finder TUI frame and UX
- `integrations` use Finder-style column browser
- `integrations` add interactive terminal navigator
- `hostinger` add Mail API connection operations
diff --git a/docs/INTEGRATIONS.md b/docs/INTEGRATIONS.md
index 639f8e3d..19f809d7 100644
--- a/docs/INTEGRATIONS.md
+++ b/docs/INTEGRATIONS.md
@@ -80,41 +80,52 @@ setup. Opening an outer widget is not proof that its form or provider authorizat
## CLI
-Run `mso integrations` with no arguments in a terminal for the **Finder-style column browser** used by SI-Coder. Parent context stays visible instead of being replaced by another full-screen menu. On a wide terminal the common account path is four stable columns:
+Bare `mso integrations` is an MSO-native Finder-style alternate-screen application. It repaints one complete terminal frame by absolute cursor position, uses terminal-cell-aware width calculation, and reserves the rightmost physical cell to avoid Windows Terminal/SSH wrap drift. Borders are one continuous `─/│` grid; there are no placeholder columns.
```text
-┌ Connections ┬ Credential user ┬ Provider ┬ Named connection / Actions ┐
-│ rahmanfakhr │ production │ GitHub │ Verify │
-│ ... │ ... │ Convex │ Route │
-│ │ │ ... │ Set / rotate credentials │
-└─────────────┴─────────────────┴──────────┴────────────────────────────┘
- PATH MSO › Connections › rahmanfakhr › GitHub › Work
- INFO / PREVIEW / RESULT remains below the columns
+ MSO Integrations rahmanfakhr / hostinger / default
+ SECTIONS 1:Connections 2:Users 3:Providers 4:Transfer
+ PATH MSO › Connections › rahmanfakhr › Hostinger › Hostinger account
+ FILTER / to filter current column
+
+┌──────────────────────┬──────────────────────┬──────────────────────┬──────────────────────┐
+│ Connections │ rahmanfakhr │ Hostinger │ Hostinger account │
+├──────────────────────┼──────────────────────┼──────────────────────┼──────────────────────┤
+│ › rahmanfakhr │ › Hostinger │ › Hostinger account │ · Set credentials │
+│ │ GitHub │ Mail production │ · Verify │
+│ │ Convex Cloud │ │ · Route │
+└──────────────────────┴──────────────────────┴──────────────────────┴──────────────────────┘
+┌────────────────────────────────────────────────────────────────────────────────────────────┐
+│ INSPECTOR Verify — live API/auth status │
+│ Connection: Hostinger account · Source: direct · Scope: account · State: verified │
+└────────────────────────────────────────────────────────────────────────────────────────────┘
+ ↑↓ move ←→ columns Enter open/run / filter V verify R route S setup D default ? help
```
-`↑/↓` moves inside the active column, `→`, Tab or Enter opens the next column, and `←`/Esc returns one column. Typing filters only the active column. Narrow terminals keep the deepest two or three columns while PATH preserves the omitted ancestry. The same frame also exposes Credential users, Provider catalog, Current folder and Import/export JSON.
+Responsive rules are terminal-column based: `>=132` shows up to four Finder panes, `92–131` three, `68–91` two, and `<68` the deepest pane only. Fewer actual ancestry panes render fewer columns instead of blank placeholders; PATH keeps omitted ancestry visible. The lower Inspector becomes Result after an operation and then returns to metadata preview on the next navigation input.
-Creating a connection extends the columns through **source/backend → authentication method → create**, then can open the private credential form. Existing connections expose Verify, Route, Make default, Rename, Delete, provider authorization, and Hostinger Mail as the right-hand action/detail column. Secrets never enter the Finder frame or CLI arguments.
+Keyboard navigation: `↑/↓` moves in the active pane; `→`, Tab or Enter opens a branch; `←`/Esc returns exactly one level; `/` enters filter mode and only filters the active pane; `1–4` switch sections; `V/R/S/D/N` verify, route, secure setup, make default, and create a connection when the context supports them; `E/I` open transfer export/import; `?` shows help; Ctrl-D exits. Selection and filter text are remembered per Finder layer while the process remains open.
-All explicit commands remain stable for scripts and agents. A non-TTY bare invocation returns the snapshot instead of waiting for keyboard input. Inspect methods or automate directly with:
+The Inspector contains only labels, IDs, source/backend, auth method, scope, state, configured-field counts, guidance/reference metadata and redacted operation results. Credential values never enter the Finder model, frame buffer, temp config, argv, logs or MCP arguments. Direct secret entry remains in the private setup form. Composio authorization remains provider-hosted.
+
+Connections extend through **user → provider → named connection → actions**. New connection creation extends through **source/backend → authentication method → create**. User lifecycle, provider catalog, folder resolution, JSON transfer and Hostinger Mail are part of the same Finder navigation model. Hostinger Mail actions show bounded/redacted results in the Result inspector instead of dumping raw JSON into terminal scrollback.
+
+Explicit commands remain stable for scripts and agents, and a bare non-TTY invocation still returns the machine-readable snapshot:
```sh
mso integrations create-user rahman "Rahman"
mso integrations request rahman convex-cloud
mso integrations create-connection rahman convex-cloud mimin-production direct deployment
-mso integrations create-connection rahman convex-cloud mimin-staging direct deployment
mso integrations connections rahman convex-cloud
mso integrations setup rahman convex-cloud mimin-production
mso integrations verify rahman convex-cloud mimin-production
-mso integrations resolve rahman convex-cloud mimin-staging
+mso integrations resolve rahman convex-cloud mimin-production
+mso integrations | jq
```
-`setup` prints a private ten-minute fragment URL **only in an interactive terminal**.
-Do not paste it into chat or logs. `mso provider setup <provider> <user> <connection>`
-is a compatibility entrypoint to the same flow. Offline CLI help/update does not load
-the connection manager until requested.
+`setup` prints a private ten-minute fragment URL only in an interactive terminal. Do not paste it into chat or logs. `mso provider setup <provider> <user> <connection>` remains a compatibility entrypoint to the same flow.
-Metadata changes require confirmation and contain no secrets:
+Metadata changes still use the native confirmed management API:
```sh
mso integrations manage '{"action":"folder.map","user":"rahman","path":"/absolute/project","provider":"convex-cloud","connection":"mimin-staging","confirm":true}'
diff --git a/docs/PROGRESS.md b/docs/PROGRESS.md
index 92ddcd8c..1f65fb0d 100644
--- a/docs/PROGRESS.md
+++ b/docs/PROGRESS.md
@@ -1,3 +1,9 @@
+## 2026-09-06 — Final MSO Integrations Finder renderer and TUI interaction model
+
+The first Finder pass exposed a real Windows Terminal/SSH alignment defect: vertical separators were independent content fragments, empty placeholder columns consumed most of the screen, and the frame lacked the normal MSO visual language. Integrations now builds a complete cell-aware frame before painting it, draws connected box borders at fixed column boundaries, reserves the final terminal cell against implicit wrapping, and uses absolute cursor addressing for every row. The responsive pane count is 4/3/2/1 at 132/92/68-column breakpoints, but only real ancestry panes are drawn; no blank Finder columns are reserved.
+
+MSO blue, status colors, section/path/filter chrome, a populated Inspector/Result area and a compact contextual shortcut footer make the screen part of the MSO TUI system rather than a generic monochrome picker. `/` filters only the active column; selection/query state is remembered per layer; `V/R/S/D/N`, section keys, transfer shortcuts and help are context-aware. Transfer and Hostinger Mail remain part of the native tree. Presentation state contains metadata only; secrets still enter through the existing private browser/TTY boundary and all mutations use the same Integrations API. PTY acceptance covers 60×20 through 200×50 and treats border continuity/right-edge wrap as release blockers.
+
## 2026-09-06 — Integrations adopts the SI-Coder Finder column browser
Bare `mso integrations` now uses a persistent macOS Finder-inspired column browser instead of replacing the whole terminal with one nested picker at a time. User → provider → named connection remains visible across adjacent columns; opening a connection adds its action/detail column, and new-connection setup extends through source/backend and authentication. Wide terminals show four stable columns, narrower terminals keep the deepest two or three while PATH preserves ancestry. `↑/↓`, `→`/Tab/Enter, `←`/Esc and type-to-filter match the SI-Coder navigation model. The lower INFO/PREVIEW/RESULT area keeps metadata and operation feedback in-frame.
diff --git a/scripts/integrations-tui/app.mjs b/scripts/integrations-tui/app.mjs
new file mode 100644
index 00000000..947fb1d6
--- /dev/null
+++ b/scripts/integrations-tui/app.mjs
@@ -0,0 +1,6 @@
+import fs from "node:fs";import readline from "node:readline";import tty from "node:tty";
+import { buildFrame, paint } from "./renderer.mjs";import { columns, context } from "./model.mjs";
+function list(config){return buildFrame(config,{cols:config.__cols||120,rows:config.__rows||30}).items;}
+export function shortcutEvent(key,config){const k=String(key||"").toLowerCase(),ctx=context(config.stack);if(/[1-4]/.test(k))return{type:"section",id:{1:"connections",2:"users",3:"catalog",4:"transfer"}[k]};if(k==="?")return{type:"shortcut",id:"help"};if(k==="e")return{type:"shortcut",id:"export"};if(k==="i")return{type:"shortcut",id:"import"};if(k==="n"&&ctx.user&&ctx.provider)return{type:"shortcut",id:"new"};if(k==="v"&&ctx.connection)return{type:"shortcut",id:"verify"};if(k==="r"&&ctx.connection)return{type:"shortcut",id:"route"};if(k==="s"&&ctx.connection)return{type:"shortcut",id:"setup"};if(k==="d"&&(ctx.connection||ctx.user))return{type:"shortcut",id:"default"};return null;}
+export function run(configPath){const config=JSON.parse(fs.readFileSync(configPath,"utf8")),fd=fs.openSync("/dev/tty",fs.constants.O_RDWR),input=new tty.ReadStream(fd),output=new tty.WriteStream(fd);readline.emitKeypressEvents(input);let query=String(config.query||""),cursor=0,filterMode=Boolean(config.filterMode),activity=config.activity||[];const initial=String(config.initialId||"");const refresh=()=>{const f=buildFrame({...config,query,cursor,filterMode,activity},{cols:output.columns,rows:output.rows});if(initial&&cursor===0){const idx=f.items.findIndex((x)=>x.id===initial);if(idx>0){cursor=idx;return buildFrame({...config,query,cursor,filterMode,activity},{cols:output.columns,rows:output.rows});}}return f;};let first=true;const render=()=>{const f=refresh();if(first&&initial){const idx=f.items.findIndex((x)=>x.id===initial);if(idx>=0)cursor=idx;first=false;}const final=buildFrame({...config,query,cursor,filterMode,activity},{cols:output.columns,rows:output.rows});paint(output,final.lines);return final;};const finish=(event)=>{const f=render();input.off("keypress",onKey);if(typeof input.setRawMode==="function")input.setRawMode(false);input.pause();process.stdout.write(JSON.stringify({...event,selectedId:f.items[f.cursor]?.id||null,query,filterMode}),()=>process.exit(0));};const activate=()=>{const f=render(),it=f.items[f.cursor];if(it)finish({type:it.kind==="branch"?"open":"select",id:it.id});};const onKey=(str,key={})=>{activity=[];if(key.ctrl&&(key.name==="c"||key.name==="d"))return finish({type:"quit"});if(key.name==="up"){const n=render().items.length;cursor=n?(cursor-1+n)%n:0;}else if(key.name==="down"){const n=render().items.length;cursor=n?(cursor+1)%n:0;}else if(key.name==="home")cursor=0;else if(key.name==="end")cursor=Math.max(0,render().items.length-1);else if(key.name==="left")return finish({type:config.stack.length?"back":"noop"});else if(key.name==="right"||key.name==="return"||key.name==="enter"||key.name==="tab")return activate();else if(key.name==="escape"){if(filterMode||query){filterMode=false;query="";cursor=0;}else return finish({type:config.stack.length?"back":"noop"});}else if(key.name==="backspace"&&filterMode){query=[...query].slice(0,-1).join("");cursor=0;}else if(key.ctrl&&key.name==="u"&&filterMode){query="";cursor=0;}else if(str==="/"&&!filterMode){filterMode=true;query="";cursor=0;}else if(filterMode&&str&&!key.ctrl&&!key.meta&&!/[\x00-\x1f\x7f]/.test(str)){query+=str;cursor=0;}else if(!filterMode&&str){const ev=shortcutEvent(str,config);if(ev)return finish(ev);}render();};input.on("keypress",onKey);input.resume();input.setRawMode(true);render();}
+if(import.meta.url===`file://${process.argv[1]}`)run(process.argv[2]);
diff --git a/scripts/integrations-tui/layout.mjs b/scripts/integrations-tui/layout.mjs
new file mode 100644
index 00000000..d14f76b9
--- /dev/null
+++ b/scripts/integrations-tui/layout.mjs
@@ -0,0 +1,67 @@
+export function stripAnsi(value) {
+ return String(value ?? "").replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "");
+}
+export function clean(value) {
+ return stripAnsi(value).replace(/[\r\n\t]+/g, " ").replace(/[\u0000-\u001f\u007f]/g, "").trim();
+}
+function isWide(cp) {
+ return cp >= 0x1100 && (cp <= 0x115f || cp === 0x2329 || cp === 0x232a ||
+ (cp >= 0x2e80 && cp <= 0xa4cf && cp !== 0x303f) || (cp >= 0xac00 && cp <= 0xd7a3) ||
+ (cp >= 0xf900 && cp <= 0xfaff) || (cp >= 0xfe10 && cp <= 0xfe19) ||
+ (cp >= 0xfe30 && cp <= 0xfe6f) || (cp >= 0xff00 && cp <= 0xff60) ||
+ (cp >= 0xffe0 && cp <= 0xffe6) || (cp >= 0x1f300 && cp <= 0x1faff) ||
+ (cp >= 0x20000 && cp <= 0x3fffd));
+}
+export function cellWidth(value) {
+ let total = 0;
+ for (const ch of stripAnsi(value)) {
+ const cp = ch.codePointAt(0) ?? 0;
+ if (cp === 0x200d || (cp >= 0xfe00 && cp <= 0xfe0f) || (cp >= 0x300 && cp <= 0x36f)) continue;
+ total += isWide(cp) ? 2 : 1;
+ }
+ return total;
+}
+export function fitCells(value, width, { pad = true } = {}) {
+ const text = clean(value);
+ if (width <= 0) return "";
+ let out = "", used = 0;
+ for (const ch of text) {
+ const w = cellWidth(ch);
+ if (used + w > width) break;
+ out += ch; used += w;
+ }
+ if (used < cellWidth(text) && width > 0) {
+ while (out && cellWidth(out) > Math.max(0, width - 1)) out = out.slice(0, -1);
+ out += "…"; used = cellWidth(out);
+ }
+ return pad ? out + " ".repeat(Math.max(0, width - used)) : out;
+}
+export function maxPaneCount(cols) {
+ return cols >= 132 ? 4 : cols >= 92 ? 3 : cols >= 68 ? 2 : 1;
+}
+export function visibleColumns(columns, cols) {
+ const count = Math.max(1, Math.min(maxPaneCount(cols), columns.length));
+ return columns.slice(-count);
+}
+export function paneWidths(totalWidth, count) {
+ const inner = Math.max(count * 10, totalWidth - (count + 1));
+ const base = Math.floor(inner / count), extra = inner % count;
+ return Array.from({ length: count }, (_, i) => base + (i < extra ? 1 : 0));
+}
+export function border(widths, kind = "top") {
+ const chars = kind === "top" ? ["┌", "┬", "┐"] : kind === "mid" ? ["├", "┼", "┤"] : ["└", "┴", "┘"];
+ return chars[0] + widths.map((w) => "─".repeat(w)).join(chars[1]) + chars[2];
+}
+export function paneRow(cells, widths) {
+ return "│" + widths.map((w, i) => fitCells(cells[i] ?? "", w)).join("│") + "│";
+}
+export function compose(left, right, width) {
+ const l = clean(left), r = clean(right), gap = Math.max(1, width - cellWidth(l) - cellWidth(r));
+ return fitCells(`${l}${" ".repeat(gap)}${r}`, width);
+}
+export function windowFor(items, selected, height) {
+ if (items.length <= height) return { start: 0, end: items.length };
+ let start = Math.max(0, selected - Math.floor(height / 2));
+ start = Math.min(start, Math.max(0, items.length - height));
+ return { start, end: Math.min(items.length, start + height) };
+}
diff --git a/scripts/integrations-tui/model.mjs b/scripts/integrations-tui/model.mjs
new file mode 100644
index 00000000..7f0b6bd0
--- /dev/null
+++ b/scripts/integrations-tui/model.mjs
@@ -0,0 +1,24 @@
+import { clean } from "./layout.mjs";
+const pick=(rows,id)=>rows?.find((x)=>x.id===id)??null;
+const suffix=(id,p)=>id?.startsWith(p)?id.slice(p.length):null;
+export const SECTIONS=[{id:"connections",label:"Connections",key:"1"},{id:"users",label:"Users",key:"2"},{id:"catalog",label:"Providers",key:"3"},{id:"transfer",label:"Transfer",key:"4"}];
+export function context(stack=[]){const last=(p)=>[...stack].reverse().map((x)=>suffix(x,p)).find((x)=>x!==null)??null;return{user:last("user:"),provider:last("provider:"),connection:last("connection:"),source:last("source:"),auth:last("auth:")};}
+const branch=(id,label,hint,preview=[],extra={})=>({id,label,hint,preview,kind:"branch",...extra});
+const action=(id,label,hint,preview=[],extra={})=>({id,label,hint,preview,kind:"action",...extra});
+const provider=(s,id)=>pick(s.catalog,id),userRow=(s,id)=>pick(s.users,id);
+const conn=(s,u,p,c)=>s.connections?.find((x)=>x.user===u&&x.provider===p&&x.id===c)??null;
+const sourceRow=(s,p,id)=>provider(s,p)?.sources?.find((x)=>x.id===id)??null;
+const methodRow=(s,p,src,id)=>sourceRow(s,p,src)?.methods?.find((x)=>x.id===id)??null;
+const storedSummary=(row)=>{const fields=row?.fields||[],stored=fields.filter((f)=>f.stored).length;return `${stored}/${fields.length} credential field(s) configured`;};
+function users(s){return (s.users||[]).map((u)=>branch(`user:${u.id}`,u.label,`${u.connectionCount} connection(s)${u.isDefault?" · default":""}`,[`User: ${u.id}`,`Connections: ${u.connectionCount}`,`Default: ${u.isDefault?"yes":"no"}`],{status:u.isDefault?"default":undefined,badge:u.isDefault?"default":undefined}));}
+function providers(s,u){return(s.catalog||[]).map((p)=>{const n=(s.connections||[]).filter((c)=>c.user===u&&c.provider===p.id).length;return branch(`provider:${p.id}`,p.title,`${n} connection(s)`,[p.description||"",`Connections for ${u}: ${n}`,`Sources: ${p.sources?.length||0}`],{badge:n?String(n):undefined});});}
+function connections(s,u,p){const rows=(s.connections||[]).filter((c)=>c.user===u&&c.provider===p);return[...rows.map((c)=>branch(`connection:${c.id}`,c.label,`${c.source} · ${c.authMethod} · ${c.state}`,[`ID: ${c.id}`,`Source: ${c.source} · Auth: ${c.authMethod} · Scope: ${c.scope}`,`State: ${c.state} · Default: ${c.isDefault?"yes":"no"}`,storedSummary(c)],{status:c.state,badge:c.isDefault?"default":undefined})),branch("new","+ New connection","choose source/backend and authentication",["Creates metadata first.","Direct credentials are entered only in the private setup form."],{shortcut:"N"})];}
+function userActions(s,u){const row=userRow(s,u);return[branch("providers","Connections & providers","manage named accounts/deployments",[`User: ${row?.label||u}`,`Connections: ${row?.connectionCount||0}`]),action("action:user-default","Set as default user","fallback when no folder mapping matches",[`User: ${u}`],{shortcut:"D"}),action("action:user-bind","Use for current folder","longest folder mapping wins",[`Folder: current working directory`,`User: ${u}`]),action("action:user-rename","Rename user","preserve connections and folder mappings"),action("action:user-duplicate","Duplicate user","metadata-only by default",["Direct credentials require a separate explicit opt-in.","Hosted/OAuth identities are not copied."]),action("action:user-delete","Delete user","destructive; exact confirmation",[],{status:"error"})];}
+function newConnection(s,p,stack){const ctx=context(stack),last=stack.at(-1);if(last==="new")return(provider(s,p)?.sources||[]).map((src)=>branch(`source:${src.id}`,src.label,`${src.methods?.length||0} auth method(s)`,[src.description||"",src.reference?`Reference: ${src.reference}`:""].filter(Boolean)));if(ctx.source&&last===`source:${ctx.source}`)return(sourceRow(s,p,ctx.source)?.methods||[]).map((m)=>branch(`auth:${m.id}`,m.label,m.scope,[`Scope: ${m.scope}`,`Credential fields: ${(m.fields||[]).length}`,m.guidance?.reference?`Reference: ${m.guidance.reference}`:""].filter(Boolean)));if(ctx.auth&&last===`auth:${ctx.auth}`){const m=methodRow(s,p,ctx.source,ctx.auth);return[action("action:create-connection","Create named connection","label + stable connection ID",[`Provider: ${p}`,`Source: ${ctx.source}`,`Auth: ${ctx.auth}`,`Scope: ${m?.scope||"unknown"}`])];}return null;}
+function connectionActions(s,u,p,c){const row=conn(s,u,p,c);if(!row)return[];const base=[`Connection: ${row.label}`,`ID: ${row.id}`,`Source: ${row.source} · Auth: ${row.authMethod} · Scope: ${row.scope}`,`State: ${row.state} · Default: ${row.isDefault?"yes":"no"}`,storedSummary(row)];const out=[];if(row.source==="direct")out.push(action("action:setup","Set / rotate credentials","private browser form",base,{shortcut:"S"}));if(row.source==="composio")out.push(action("action:authorize","Authorize account","Composio hosted authorization",base));out.push(action("action:verify","Verify","live API/auth status",base,{shortcut:"V"}),action("action:route","Route","show exact execution identity",base,{shortcut:"R"}));if(!row.isDefault)out.push(action("action:connection-default","Make default","provider fallback for this user",base,{shortcut:"D"}));if(p==="hostinger"&&row.source==="direct")out.push(branch("mail","Hostinger Mail","orders, mailboxes, aliases and logs",["Uses the selected Hostinger connection.","Secret-shaped response fields remain redacted."]));out.push(action("action:connection-rename","Rename label","metadata only",base),action("action:connection-delete","Delete connection","destructive; exact confirmation",base,{status:"error"}));return out;}
+function mailLayer(stack){const last=stack.at(-1);if(last==="mail")return[action("action:mail-orders","Mail orders","list account mail orders"),...["mailboxes","aliases","forwarders","autoreplies","catchalls","webhooks"].map((x)=>action(`action:mail-resource:${x}`,x[0].toUpperCase()+x.slice(1),`list ${x}`)),branch("logs","Mail logs","access/action/inbound/mailbox/outbound")];if(last==="logs")return["access","action","inbound","mailbox-actions","outbound"].map((x)=>action(`action:mail-log:${x}`,x.replaceAll("-"," "),`${x} log`));return null;}
+function transferLayer(){return[action("action:transfer:metadata","Export metadata JSON","no credential values",["Portable user/provider/connection metadata only.","Safe default for SC/MSO/Baton adapters."],{shortcut:"E"}),action("action:transfer:encrypted","Export encrypted bundle","includes direct credentials",["Passphrase stays in the private browser/TTY flow.","OAuth sessions are never exported."]),action("action:transfer:import","Import bundle","preview before apply",["Conflicts are reviewed before mutation.","Defaults and folder bindings are not silently replaced."],{shortcut:"I"}),action("action:transfer:schema","View portability format","Integration Bundle v1",["schemas/integration-bundle-v1.schema.json"] )];}
+export function layer(s,stack=[]){const last=stack.at(-1),ctx=context(stack);if(!last)return[branch("connections","Connections","User → Provider → Connection",["Browse credential identities and actions."],{shortcut:"1"}),branch("users","Credential users","isolated account contexts",["Users group named provider connections."],{shortcut:"2"}),branch("catalog","Provider catalog","sources, auth methods and scope",["Inspect capabilities without exposing credentials."],{shortcut:"3"}),branch("transfer","Transfer","portable import / export",["Metadata JSON or encrypted direct credentials."],{shortcut:"4"}),action("action:current","Current folder","show resolved credential user/binding"),action("action:quit","Quit","return to shell")];if(last==="connections"||last==="users")return[...users(s),action("action:user-add","+ Add user","new isolated credential context")];if(last==="transfer")return transferLayer();if(last==="catalog")return(s.catalog||[]).map((p)=>branch(`provider:${p.id}`,p.title,`${p.sources?.length||0} source(s)`,[p.description||"",`Sources: ${p.sources?.length||0}`]));if(stack[0]==="catalog"&&ctx.provider&&last===`provider:${ctx.provider}`)return(provider(s,ctx.provider)?.sources||[]).map((src)=>branch(`source:${src.id}`,src.label,`${src.methods?.length||0} method(s)`,[src.description||"",src.reference?`Reference: ${src.reference}`:""].filter(Boolean)));if(stack[0]==="catalog"&&ctx.source&&last===`source:${ctx.source}`)return(sourceRow(s,ctx.provider,ctx.source)?.methods||[]).map((m)=>action(`action:inspect-auth:${m.id}`,m.label,`${m.scope} · ${(m.fields||[]).length} field(s)`,[`Scope: ${m.scope}`,...(m.fields||[]).map((f)=>`${f.label||f.key}: ${f.required?"required":"optional"}`),m.guidance?.reference?`Reference: ${m.guidance.reference}`:""].filter(Boolean)));if(ctx.user&&last===`user:${ctx.user}`)return stack[0]==="users"?userActions(s,ctx.user):providers(s,ctx.user);if(last==="providers"&&ctx.user)return providers(s,ctx.user);if(ctx.provider&&last===`provider:${ctx.provider}`&&stack[0]!=="catalog")return connections(s,ctx.user,ctx.provider);const fresh=newConnection(s,ctx.provider,stack);if(fresh)return fresh;if(ctx.connection&&last===`connection:${ctx.connection}`)return connectionActions(s,ctx.user,ctx.provider,ctx.connection);const mail=mailLayer(stack);if(mail)return mail;return[];}
+export function labelFor(s,id,prefix=[]){const ctx=context([...prefix,id]);if(id==="connections")return"Connections";if(id==="users")return"Users";if(id==="catalog")return"Providers";if(id==="transfer")return"Transfer";if(id==="providers")return"Providers";if(id==="new")return"New connection";if(id==="mail")return"Hostinger Mail";if(id==="logs")return"Mail logs";if(id.startsWith("user:"))return userRow(s,ctx.user)?.label||ctx.user;if(id.startsWith("provider:"))return provider(s,ctx.provider)?.title||ctx.provider;if(id.startsWith("connection:"))return conn(s,ctx.user,ctx.provider,ctx.connection)?.label||ctx.connection;if(id.startsWith("source:"))return sourceRow(s,ctx.provider,ctx.source)?.label||ctx.source;if(id.startsWith("auth:"))return methodRow(s,ctx.provider,ctx.source,ctx.auth)?.label||ctx.auth;return clean(id);}
+export function columns(s,stack=[]){const out=[];for(let d=0;d<=stack.length;d++){const prefix=stack.slice(0,d);out.push({title:d?labelFor(s,stack[d-1],prefix.slice(0,-1)):"Integrations",nodeId:d?stack[d-1]:"root",items:layer(s,prefix),selectedId:d<stack.length?stack[d]:null});}return out;}
+export function activeSection(stack=[],active=null){const root=stack[0]||active?.id;return SECTIONS.some((s)=>s.id===root)?root:null;}
diff --git a/scripts/integrations-tui/renderer.mjs b/scripts/integrations-tui/renderer.mjs
new file mode 100644
index 00000000..313acaa2
--- /dev/null
+++ b/scripts/integrations-tui/renderer.mjs
@@ -0,0 +1,14 @@
+import { T, selected, statusStyle, resultStyle } from "./theme.mjs";
+import { border, cellWidth, clean, compose, fitCells, paneRow, paneWidths, visibleColumns, windowFor } from "./layout.mjs";
+import { activeSection, columns, context, labelFor, SECTIONS } from "./model.mjs";
+const statusGlyph=(s)=>s==="verified"?"✓":s==="default"?"●":s==="configured"?"◆":s==="missing"?"!":s==="error"?"×":"";
+function headerLine(config,W){const ctx=context(config.stack),identity=[ctx.user,ctx.provider,ctx.connection].filter(Boolean).join(" / ")||"no connection selected";const left=" MSO Integrations";const plain=compose(left,identity,W);const split=plain.indexOf("Integrations");if(split<0)return plain;const before=plain.slice(0,5),after=plain.slice(5);return `${T.blueBg}${T.white}${T.bold}${before}${T.reset}${T.bold}${after.slice(0,12)}${T.reset}${T.muted}${after.slice(12)}${T.reset}`;}
+function sectionLine(config,W,active){let plain=" SECTIONS ";for(const s of SECTIONS)plain+=` ${s.key}:${s.label} `;plain=fitCells(plain,W);let styled=plain;for(const s of SECTIONS){const token=` ${s.key}:${s.label} `;styled=styled.replace(token,s.id===active?`${T.blueBg}${T.white}${T.bold}${token}${T.reset}`:`${T.muted}${token}${T.reset}`);}return styled;}
+function pathLine(config,W){const parts=["MSO",...config.stack.map((id,i)=>labelFor(config.snapshot,id,config.stack.slice(0,i)))];return `${T.muted}${fitCells(` PATH ${parts.join(" › ")}`,W)}${T.reset}`;}
+function filterLine(config,W){const value=config.filterMode?`/${config.query||""}`:(config.query?`/${config.query}`:"/ to filter current column");return `${T.muted}${fitCells(` FILTER ${value}`,W)}${T.reset}`;}
+function rowText(item,w){const branch=item?.kind==="branch"?"›":"·",glyph=statusGlyph(item?.status),badge=item?.badge?` ${item.badge}`:"";const prefix=` ${branch} ${glyph?glyph+" ":""}${clean(item?.label||"")}`;const right=badge?`[${badge.trim()}]`:"";return compose(prefix,right,w);}
+function styleRow(item,text,isSelected,isActive){if(isSelected)return selected(text,isActive);if(item?.status)return statusStyle(item.status,text);return text;}
+function grid(config,W,bodyRows){const all=columns(config.snapshot,config.stack),shown=visibleColumns(all,config.cols),widths=paneWidths(W,shown.length),current=shown.at(-1);const items=config.items??current?.items??[],cursor=Math.min(config.cursor??0,Math.max(0,items.length-1)),active=items[cursor]??null;const prepared=shown.map((col,i)=>{const isActive=i===shown.length-1,rows=isActive?items:col.items,selectedId=isActive?active?.id:col.selectedId,idx=Math.max(0,rows.findIndex((it)=>it.id===selectedId)),win=windowFor(rows,idx,Math.max(1,bodyRows));return{...col,isActive,rows,selectedId,win};});const lines=[`${T.border}${border(widths,"top")}${T.reset}`];const titles=prepared.map((p)=>` ${p.title}`);lines.push(`${T.border}│${T.reset}`+titles.map((x,i)=>`${T.bold}${fitCells(x,widths[i])}${T.reset}`).join(`${T.border}│${T.reset}`)+`${T.border}│${T.reset}`);lines.push(`${T.border}${border(widths,"mid")}${T.reset}`);for(let r=0;r<bodyRows;r++){const cells=prepared.map((p)=>{const it=p.rows[p.win.start+r];if(!it)return" ".repeat(widths[prepared.indexOf(p)]);const sel=it.id===p.selectedId,txt=rowText(it,widths[prepared.indexOf(p)]);return styleRow(it,txt,sel,p.isActive);});lines.push(`${T.border}│${T.reset}`+cells.map((x,i)=>{const pad=Math.max(0,widths[i]-cellWidth(x));return x+" ".repeat(pad);}).join(`${T.border}│${T.reset}`)+`${T.border}│${T.reset}`);}lines.push(`${T.border}${border(widths,"bottom")}${T.reset}`);return{lines,active};}
+function inspector(config,active,W,rows){const activity=(config.activity||[]).filter(Boolean),preview=(active?.preview||[]).filter(Boolean),body=activity.length?activity:preview;const title=activity.length?"RESULT":"INSPECTOR";const lines=[`${T.border}┌${"─".repeat(Math.max(0,W-2))}┐${T.reset}`];const headline=active?`${active.label}${active.hint?` — ${active.hint}`:""}`:"No matching item";lines.push(`${T.border}│${T.reset}${T.bold}${fitCells(` ${title} ${headline}`,W-2)}${T.reset}${T.border}│${T.reset}`);for(let i=0;i<rows;i++){const raw=body[i]||"",styled=activity.length?resultStyle(fitCells(` ${raw}`,W-2)):`${T.muted}${fitCells(` ${raw}`,W-2)}${T.reset}`;lines.push(`${T.border}│${T.reset}${styled}${T.border}│${T.reset}`);}lines.push(`${T.border}└${"─".repeat(Math.max(0,W-2))}┘${T.reset}`);return lines;}
+export function buildFrame(config,{cols=120,rows=30}={}){const W=Math.max(39,cols-1),H=Math.max(16,rows);config={...config,cols};const all=columns(config.snapshot,config.stack),current=all.at(-1),source=current?.items||[],q=clean(config.query||"").toLowerCase(),items=q?source.filter((x)=>`${x.id} ${x.label} ${x.hint||""} ${x.status||""}`.toLowerCase().includes(q)):source,cursor=Math.min(config.cursor??0,Math.max(0,items.length-1));const active=items[cursor]||null,section=activeSection(config.stack,active);const top=[headerLine(config,W),sectionLine(config,W,section),pathLine(config,W),filterLine(config,W)];const inspectorRows=H>=36?6:H>=28?4:H>=22?3:2;const footerRows=1,gridFixed=4,available=H-top.length-(inspectorRows+3)-footerRows,bodyRows=Math.max(2,available-gridFixed);const g=grid({...config,items,cursor},W,bodyRows),ins=inspector(config,g.active,W,inspectorRows);const footerText=cols>=132?" ↑↓ move ←→ columns Enter open/run / filter V verify R route S setup D default N new 1–4 sections ? help Ctrl-D quit":cols>=92?" ↑↓ move ←→ columns Enter open / filter V verify S setup 1–4 sections ? help Ctrl-D quit":cols>=68?" ↑↓ move ←→ open/back Enter run / filter ? help Ctrl-D quit":" ↑↓ move ←→ open/back Enter / filter Ctrl-D quit";const footer=`${T.muted}${fitCells(footerText,W)}${T.reset}`;const out=[...top,...g.lines,...ins,footer];while(out.length<H)out.push(" ".repeat(W));return{lines:out.slice(0,H),items,cursor,active:g.active};}
+export function paint(output,lines){const E="\x1b",CUP=(r)=>`${E}[${r};1H`;output.write(`${E}[H${E}[2J${E}[?25l`+lines.map((line,i)=>`${CUP(i+1)}${line}${T.reset}`).join(""));}
diff --git a/scripts/integrations-tui/theme.mjs b/scripts/integrations-tui/theme.mjs
new file mode 100644
index 00000000..56c02c13
--- /dev/null
+++ b/scripts/integrations-tui/theme.mjs
@@ -0,0 +1,26 @@
+const enabled = !process.env.NO_COLOR;
+const esc = (code) => enabled ? `\x1b[${code}m` : "";
+export const T = {
+ reset: esc("0"), bold: esc("1"), dim: esc("2"), reverse: esc("7"),
+ blue: esc("38;2;69;142;255"), blueBg: esc("48;2;69;142;255"),
+ white: esc("38;2;255;255;255"), green: esc("38;2;46;229;157"),
+ amber: esc("38;2;244;190;78"), red: esc("38;2;255;105;120"),
+ border: esc("38;2;93;101;118"), muted: esc("38;2;139;145;158"),
+};
+export function selected(text, active = true) {
+ if (!enabled) return active ? `${T.reverse}${text}${T.reset}` : `${T.bold}${text}${T.reset}`;
+ return active ? `${T.blueBg}${T.white}${T.bold}${text}${T.reset}` : `${T.blue}${T.bold}${text}${T.reset}`;
+}
+export function statusStyle(status, text) {
+ const code = status === "verified" || status === "default" ? T.green
+ : status === "error" || status === "missing" ? T.red
+ : status === "warning" ? T.amber : status === "configured" ? T.blue : T.muted;
+ return `${code}${text}${T.reset}`;
+}
+export function resultStyle(text) {
+ const s = String(text || "");
+ if (/^[✕×!]/.test(s)) return `${T.red}${s}${T.reset}`;
+ if (/^[⚠]/.test(s)) return `${T.amber}${s}${T.reset}`;
+ if (/^[✓]/.test(s)) return `${T.green}${s}${T.reset}`;
+ return `${T.muted}${s}${T.reset}`;
+}
diff --git a/scripts/mso-cli-integrations-tui-remote.sh b/scripts/mso-cli-integrations-tui-remote.sh
index 84572232..85c8063a 100644
--- a/scripts/mso-cli-integrations-tui-remote.sh
+++ b/scripts/mso-cli-integrations-tui-remote.sh
@@ -5,18 +5,18 @@ integration_prompt_mode(){ printf '\033[?25h\033[H\033[2J' > /dev/tty; }
integration_activity(){ F_ACTIVITY=$(printf '%s\n' "$@" | jq -Rsc 'split("\n")|map(select(length>0))'); }
integration_context(){ local p="$1"; jq -r --arg p "$p" '[.[]|select(startswith($p))][-1]//""|ltrimstr($p)' <<<"$F_STACK"; }
integration_wait(){ tty_line "Press Enter to return to Finder… " ""; }
-integration_action_user_add(){ local root id label body; root=$(jq -r '.[0]//"users"'<<<"$F_STACK");integration_prompt_mode;tty_line "New credential user ID: " "";id="$REPLY";[ -n "$id" ]||return;tty_line "Display label [$id]: " "$id";label="$REPLY";body=$(jq -nc --arg u "$id" --arg l "$label" '{mode:"manage",action:"user.create",confirm:true,user:$u,label:$l}');integration_tui_manage "$body" >/dev/null;F_STACK=$(jq -nc --arg r "$root" --arg u "user:$id" '[$r,$u]');integration_activity "Created credential user $label"; }
-integration_action_user_default(){ local u body;u=$(integration_context user:);body=$(jq -nc --arg u "$u" '{mode:"manage",action:"user.default",confirm:true,user:$u}');integration_tui_manage "$body" >/dev/null;integration_activity "$u is now the default credential user"; }
-integration_action_user_bind(){ local u body;u=$(integration_context user:);body=$(jq -nc --arg u "$u" --arg p "$PWD" '{mode:"manage",action:"folder.map",confirm:true,user:$u,path:$p}');integration_tui_manage "$body" >/dev/null;integration_activity "Mapped current folder to $u" "$PWD"; }
-integration_action_user_rename(){ local u target label body;u=$(integration_context user:);integration_prompt_mode;tty_line "New user ID: " "$u";target="$REPLY";[ "$target" != "$u" ]||return;tty_line "Display label [$target]: " "$target";label="$REPLY";body=$(jq -nc --arg u "$u" --arg t "$target" --arg l "$label" '{mode:"manage",action:"user.rename",confirm:true,user:$u,target:$t,label:$l}');integration_tui_manage "$body" >/dev/null;F_STACK=$(jq --arg old "user:$u" --arg new "user:$target" 'map(if .==$old then $new else . end)'<<<"$F_STACK");integration_activity "Renamed credential user $u → $target"; }
-integration_action_user_duplicate(){ local u target label ans copy body;u=$(integration_context user:);integration_prompt_mode;tty_line "Duplicate as user ID: " "${u}-copy";target="$REPLY";[ -n "$target" ]||return;tty_line "Display label [$target]: " "$target";label="$REPLY";tty_line "Copy direct credentials too? [y/N]: " n;ans="${REPLY,,}";copy=false;case "$ans" in y|yes)copy=true;;esac;body=$(jq -nc --arg u "$u" --arg t "$target" --arg l "$label" --argjson c "$copy" '{mode:"manage",action:"user.duplicate",confirm:true,user:$u,target:$t,label:$l,copyCredentials:$c}');integration_tui_manage "$body" >/dev/null;integration_activity "Duplicated $u → $target" "$([ "$copy" = true ]&&printf 'direct credentials copied' || printf 'metadata only')"; }
-integration_action_user_delete(){ local u body root;u=$(integration_context user:);root=$(jq -r '.[0]'<<<"$F_STACK");integration_prompt_mode;tty_line "Type $u to delete: " "";[ "$REPLY" = "$u" ]||{ integration_activity 'Delete cancelled';return;};body=$(jq -nc --arg u "$u" '{mode:"manage",action:"user.delete",confirm:true,user:$u}');integration_tui_manage "$body" >/dev/null;F_STACK=$(jq -nc --arg r "$root" '[$r]');integration_activity "Deleted credential user $u"; }
-integration_action_create_connection(){ local u p s a label id body ans idx;u=$(integration_context user:);p=$(integration_context provider:);s=$(integration_context source:);a=$(integration_context auth:);integration_prompt_mode;tty_line "Connection label: " "$p";label="$REPLY";[ -n "$label" ]||return;id=$(integration_tui_slug "$label");[ -n "$id" ]||id=connection;tty_line "Connection ID [$id]: " "$id";id="$REPLY";body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$id" --arg l "$label" --arg s "$s" --arg a "$a" '{mode:"manage",action:"connection.create",confirm:true,user:$u,provider:$p,connection:$c,label:$l,source:$s,authMethod:$a}');integration_tui_manage "$body" >/dev/null;idx=$(jq '[to_entries[]|select(.value|startswith("provider:"))]|last.key'<<<"$F_STACK");F_STACK=$(jq --argjson i "$idx" --arg c "connection:$id" '.[0:$i+1]+[$c]'<<<"$F_STACK");integration_activity "Created $label" "$u › $p › $id" "$s · $a";if [ "$s" = direct ];then tty_line "Open secure credential form now? [Y/n]: " y;ans="${REPLY,,}";case "$ans" in n|no);;*)integration_prompt_mode;run_integrations setup "$u" "$p" "$id";integration_wait;;esac;fi; }
-integration_action_setup(){ local u p c;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);integration_prompt_mode;run_integrations setup "$u" "$p" "$c";integration_wait;integration_activity "Secure setup opened for $u › $p › $c"; }
-integration_action_authorize(){ local u p c broker cfg ans managed body out;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);integration_prompt_mode;tty_line "Composio project connection ID (blank = auto): " "";broker="$REPLY";tty_line "Auth config ID (blank = auto): " "";cfg="$REPLY";tty_line "Allow managed OAuth config if none exists? [y/N]: " n;ans="${REPLY,,}";managed=false;case "$ans" in y|yes)managed=true;;esac;body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$c" --arg b "$broker" --arg g "$cfg" --argjson m "$managed" '{mode:"manage",action:"connection.authorize",confirm:true,user:$u,provider:$p,connection:$c,createManaged:$m}+(if $b!="" then {brokerConnection:$b}else{}end)+(if $g!="" then {authConfigId:$g}else{}end)');out=$(integration_tui_manage "$body");if jq -e '.privateUrl' >/dev/null 2>&1<<<"$out";then printf '\nOpen private authorization URL:\n%s\n' "$(jq -r .privateUrl<<<"$out")";integration_wait;fi;integration_activity "Authorization flow prepared" "$u › $p › $c"; }
-integration_action_verify(){ local u p c out;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);out=$(integration_tui_execute "$u" "$p" "$c" verify '{}' false);integration_activity "verify: $(jq -r '.ok//.result.ok//"unknown"'<<<"$out")" "$(jq -r '.detail//.result.detail//""'<<<"$out")"; }
-integration_action_route(){ local u p c out;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);out=$(integration_tui_execute "$u" "$p" "$c" route '{}' false);integration_activity "route: $u › $p › $c" "source: $(jq -r '.source//.result.source//"unknown"'<<<"$out")" "scope: $(jq -r '.scope//.result.scope//"unknown"'<<<"$out")"; }
-integration_action_connection_default(){ local u p c body;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$c" '{mode:"manage",action:"connection.default",confirm:true,user:$u,provider:$p,connection:$c}');integration_tui_manage "$body" >/dev/null;integration_activity "$c is now default for $p"; }
-integration_action_connection_rename(){ local u p c label body;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);integration_prompt_mode;tty_line "New label: " "$c";label="$REPLY";body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$c" --arg l "$label" '{mode:"manage",action:"connection.rename",confirm:true,user:$u,provider:$p,connection:$c,label:$l}');integration_tui_manage "$body" >/dev/null;integration_activity "Renamed connection label to $label"; }
-integration_action_connection_delete(){ local u p c body idx;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);integration_prompt_mode;tty_line "Type $c to delete: " "";[ "$REPLY" = "$c" ]||{ integration_activity 'Delete cancelled';return;};body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$c" '{mode:"manage",action:"connection.delete",confirm:true,user:$u,provider:$p,connection:$c}');integration_tui_manage "$body" >/dev/null;idx=$(jq '[to_entries[]|select(.value|startswith("connection:"))]|last.key'<<<"$F_STACK");F_STACK=$(jq --argjson i "$idx" '.[0:$i]'<<<"$F_STACK");integration_activity "Deleted $u › $p › $c"; }
-integration_action_mail(){ local kind="$1" value="$2" u c order args out count;u=$(integration_context user:);c=$(integration_context connection:);if [ "$kind" = orders ];then out=$(integration_tui_execute "$u" hostinger "$c" hostinger.mail.orders.list '{}' true);else integration_prompt_mode;tty_line "Mail order ID (blank uses scoped connection order): " "";order="$REPLY";if [ "$kind" = resource ];then args=$(jq -nc --arg o "$order" --arg r "$value" '{resource:$r,page:1}+(if $o!=""then{orderId:$o}else{}end)');out=$(integration_tui_execute "$u" hostinger "$c" hostinger.mail.list "$args" true);else args=$(jq -nc --arg o "$order" --arg k "$value" '{kind:$k,page:1}+(if $o!=""then{orderId:$o}else{}end)');out=$(integration_tui_execute "$u" hostinger "$c" hostinger.mail.logs.list "$args" true);fi;fi;count=$(jq -r '(.result.data//.result//[])|if type=="array" then length else (.data//[]|length) end'<<<"$out" 2>/dev/null||echo '?');integration_activity "Hostinger Mail ${value:-orders}" "rows: $count"; }
+integration_action_user_add(){ local root id label body; root=$(jq -r '.[0]//"users"'<<<"$F_STACK");integration_prompt_mode;tty_line "New credential user ID: " "";id="$REPLY";[ -n "$id" ]||return;tty_line "Display label [$id]: " "$id";label="$REPLY";body=$(jq -nc --arg u "$id" --arg l "$label" '{mode:"manage",action:"user.create",confirm:true,user:$u,label:$l}');integration_tui_manage "$body" >/dev/null;F_STACK=$(jq -nc --arg r "$root" --arg u "user:$id" '[$r,$u]');integration_activity "✓ Created credential user $label"; }
+integration_action_user_default(){ local u body;u=$(integration_context user:);body=$(jq -nc --arg u "$u" '{mode:"manage",action:"user.default",confirm:true,user:$u}');integration_tui_manage "$body" >/dev/null;integration_activity "✓ $u is now the default credential user"; }
+integration_action_user_bind(){ local u body;u=$(integration_context user:);body=$(jq -nc --arg u "$u" --arg p "$PWD" '{mode:"manage",action:"folder.map",confirm:true,user:$u,path:$p}');integration_tui_manage "$body" >/dev/null;integration_activity "✓ Mapped current folder to $u" "$PWD"; }
+integration_action_user_rename(){ local u target label body;u=$(integration_context user:);integration_prompt_mode;tty_line "New user ID: " "$u";target="$REPLY";[ "$target" != "$u" ]||return;tty_line "Display label [$target]: " "$target";label="$REPLY";body=$(jq -nc --arg u "$u" --arg t "$target" --arg l "$label" '{mode:"manage",action:"user.rename",confirm:true,user:$u,target:$t,label:$l}');integration_tui_manage "$body" >/dev/null;F_STACK=$(jq --arg old "user:$u" --arg new "user:$target" 'map(if .==$old then $new else . end)'<<<"$F_STACK");integration_activity "✓ Renamed credential user $u → $target"; }
+integration_action_user_duplicate(){ local u target label ans copy body;u=$(integration_context user:);integration_prompt_mode;tty_line "Duplicate as user ID: " "${u}-copy";target="$REPLY";[ -n "$target" ]||return;tty_line "Display label [$target]: " "$target";label="$REPLY";tty_line "Copy direct credentials too? [y/N]: " n;ans="${REPLY,,}";copy=false;case "$ans" in y|yes)copy=true;;esac;body=$(jq -nc --arg u "$u" --arg t "$target" --arg l "$label" --argjson c "$copy" '{mode:"manage",action:"user.duplicate",confirm:true,user:$u,target:$t,label:$l,copyCredentials:$c}');integration_tui_manage "$body" >/dev/null;integration_activity "✓ Duplicated $u → $target" "$([ "$copy" = true ]&&printf 'direct credentials copied' || printf 'metadata only')"; }
+integration_action_user_delete(){ local u body root;u=$(integration_context user:);root=$(jq -r '.[0]'<<<"$F_STACK");integration_prompt_mode;tty_line "Type $u to delete: " "";[ "$REPLY" = "$u" ]||{ integration_activity '⚠ Delete cancelled';return;};body=$(jq -nc --arg u "$u" '{mode:"manage",action:"user.delete",confirm:true,user:$u}');integration_tui_manage "$body" >/dev/null;F_STACK=$(jq -nc --arg r "$root" '[$r]');integration_activity "✓ Deleted credential user $u"; }
+integration_action_create_connection(){ local u p s a label id body ans idx;u=$(integration_context user:);p=$(integration_context provider:);s=$(integration_context source:);a=$(integration_context auth:);integration_prompt_mode;tty_line "Connection label: " "$p";label="$REPLY";[ -n "$label" ]||return;id=$(integration_tui_slug "$label");[ -n "$id" ]||id=connection;tty_line "Connection ID [$id]: " "$id";id="$REPLY";body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$id" --arg l "$label" --arg s "$s" --arg a "$a" '{mode:"manage",action:"connection.create",confirm:true,user:$u,provider:$p,connection:$c,label:$l,source:$s,authMethod:$a}');integration_tui_manage "$body" >/dev/null;idx=$(jq '[to_entries[]|select(.value|startswith("provider:"))]|last.key'<<<"$F_STACK");F_STACK=$(jq --argjson i "$idx" --arg c "connection:$id" '.[0:$i+1]+[$c]'<<<"$F_STACK");integration_activity "✓ Created $label" "$u › $p › $id" "$s · $a";if [ "$s" = direct ];then tty_line "Open secure credential form now? [Y/n]: " y;ans="${REPLY,,}";case "$ans" in n|no);;*)integration_prompt_mode;run_integrations setup "$u" "$p" "$id";integration_wait;;esac;fi; }
+integration_action_setup(){ local u p c;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);integration_prompt_mode;run_integrations setup "$u" "$p" "$c";integration_wait;integration_activity "✓ Secure setup opened for $u › $p › $c" "Credential values remain outside Finder/model state."; }
+integration_action_authorize(){ local u p c broker cfg ans managed body out;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);integration_prompt_mode;tty_line "Composio project connection ID (blank = auto): " "";broker="$REPLY";tty_line "Auth config ID (blank = auto): " "";cfg="$REPLY";tty_line "Allow managed OAuth config if none exists? [y/N]: " n;ans="${REPLY,,}";managed=false;case "$ans" in y|yes)managed=true;;esac;body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$c" --arg b "$broker" --arg g "$cfg" --argjson m "$managed" '{mode:"manage",action:"connection.authorize",confirm:true,user:$u,provider:$p,connection:$c,createManaged:$m}+(if $b!="" then {brokerConnection:$b}else{}end)+(if $g!="" then {authConfigId:$g}else{}end)');out=$(integration_tui_manage "$body");if jq -e '.privateUrl' >/dev/null 2>&1<<<"$out";then printf '\nOpen private authorization URL:\n%s\n' "$(jq -r .privateUrl<<<"$out")";integration_wait;fi;integration_activity "✓ Authorization flow prepared" "$u › $p › $c"; }
+integration_action_verify(){ local u p c out ok detail;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);out=$(integration_tui_execute "$u" "$p" "$c" verify '{}' false);ok=$(jq -r '.ok//.result.ok//"unknown"'<<<"$out");detail=$(jq -r '.detail//.result.detail//""'<<<"$out");if [ "$ok" = true ];then integration_activity "✓ Verified $u › $p › $c" "$detail";elif [ "$ok" = false ];then integration_activity "✕ Verification failed for $u › $p › $c" "$detail";else integration_activity "⚠ Verification unavailable for $u › $p › $c" "$detail";fi; }
+integration_action_route(){ local u p c out;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);out=$(integration_tui_execute "$u" "$p" "$c" route '{}' false);integration_activity "✓ Route resolved: $u › $p › $c" "source: $(jq -r '.source//.result.source//"unknown"'<<<"$out")" "scope: $(jq -r '.scope//.result.scope//"unknown"'<<<"$out")"; }
+integration_action_connection_default(){ local u p c body;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$c" '{mode:"manage",action:"connection.default",confirm:true,user:$u,provider:$p,connection:$c}');integration_tui_manage "$body" >/dev/null;integration_activity "✓ $c is now default for $p"; }
+integration_action_connection_rename(){ local u p c label body;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);integration_prompt_mode;tty_line "New label: " "$c";label="$REPLY";body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$c" --arg l "$label" '{mode:"manage",action:"connection.rename",confirm:true,user:$u,provider:$p,connection:$c,label:$l}');integration_tui_manage "$body" >/dev/null;integration_activity "✓ Renamed connection label to $label"; }
+integration_action_connection_delete(){ local u p c body idx;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);integration_prompt_mode;tty_line "Type $c to delete: " "";[ "$REPLY" = "$c" ]||{ integration_activity '⚠ Delete cancelled';return;};body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$c" '{mode:"manage",action:"connection.delete",confirm:true,user:$u,provider:$p,connection:$c}');integration_tui_manage "$body" >/dev/null;idx=$(jq '[to_entries[]|select(.value|startswith("connection:"))]|last.key'<<<"$F_STACK");F_STACK=$(jq --argjson i "$idx" '.[0:$i]'<<<"$F_STACK");integration_activity "✓ Deleted $u › $p › $c"; }
+integration_action_mail(){ local kind="$1" value="$2" u c order args out count preview;u=$(integration_context user:);c=$(integration_context connection:);if [ "$kind" = orders ];then out=$(integration_tui_execute "$u" hostinger "$c" hostinger.mail.orders.list '{}' true);else integration_prompt_mode;tty_line "Mail order ID (blank uses scoped connection order): " "";order="$REPLY";if [ "$kind" = resource ];then args=$(jq -nc --arg o "$order" --arg r "$value" '{resource:$r,page:1}+(if $o!=""then{orderId:$o}else{}end)');out=$(integration_tui_execute "$u" hostinger "$c" hostinger.mail.list "$args" true);else args=$(jq -nc --arg o "$order" --arg k "$value" '{kind:$k,page:1}+(if $o!=""then{orderId:$o}else{}end)');out=$(integration_tui_execute "$u" hostinger "$c" hostinger.mail.logs.list "$args" true);fi;fi;count=$(jq -r '(.result.data//.result//[])|if type=="array" then length else (.data//[]|length) end'<<<"$out" 2>/dev/null||echo '?');preview="";if [ "$kind" != log ];then preview=$(jq -r '(.result.data//.result//[])|if type=="array" then .[:5][]|[(.email//.address//.domain//.name//.local_part//.id//"item"),(.status//.state//"")]|map(select(type=="string" and length>0))|join(" · ") else empty end'<<<"$out" 2>/dev/null||true);fi;integration_activity "✓ Hostinger Mail ${value:-orders}" "rows: $count" ${preview:+"$preview"} "Results are redacted and scoped to $u › hostinger › $c"; }
diff --git a/scripts/mso-cli-integrations-tui.sh b/scripts/mso-cli-integrations-tui.sh
index b1dbcd8d..7dc71711 100755
--- a/scripts/mso-cli-integrations-tui.sh
+++ b/scripts/mso-cli-integrations-tui.sh
@@ -1,41 +1,47 @@
#!/usr/bin/env bash
-# Finder-style multi-column native Integrations navigator. UI state is ephemeral;
-# every read/write still uses the same owner API as CLI/MCP/browser.
+# MSO-native Finder column browser for Integrations. Presentation state is ephemeral;
+# all reads and confirmed mutations still use the same owner API as CLI/MCP/browser.
# shellcheck source=mso-cli-integrations-tui-remote.sh
source "$ROOT/scripts/mso-cli-integrations-tui-remote.sh"
integration_tui_slug(){ printf '%s' "$1"|tr '[:upper:]' '[:lower:]'|sed -E 's/[^a-z0-9._-]+/-/g;s/^-+//;s/-+$//'|cut -c1-64; }
integration_tui_snapshot(){ local u="${1-}" q=view=snapshot;[ -n "$u" ]&&q="$q&user=$(enc "$u")";jget "/api/v1/integrations?$q"; }
integration_tui_manage(){ jpost "/api/v1/integrations" "$1"; }
-integration_tui_execute(){ local u="$1" p="$2" c="$3" op="$4" args="${5:-{}}" confirm="${6:-false}" body;body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$c" --arg op "$op" --argjson a "$args" --argjson x "$confirm" '{mode:"execute",user:$u,provider:$p,connection:$c,operation:$op,arguments:$a}+(if $x then {confirm:true}else{}end)');jpost "/api/v1/integrations" "$body"; }
+integration_tui_execute(){ local u="$1" p="$2" c="$3" op="$4" args="${5-}" confirm="${6:-false}" body;[ -n "$args" ]||args='{}';body=$(jq -nc --arg u "$u" --arg p "$p" --arg c "$c" --arg op "$op" --argjson a "$args" --argjson x "$confirm" '{mode:"execute",user:$u,provider:$p,connection:$c,operation:$op,arguments:$a}+(if $x then {confirm:true}else{}end)');jpost "/api/v1/integrations" "$body"; }
integration_alt_on(){ printf '\033[?1049h\033[?25l\033[H\033[2J' > /dev/tty; }
integration_alt_off(){ printf '\033[0m\033[?25h\033[?1049l' > /dev/tty 2>/dev/null||true; }
-integration_finder_event(){ local snap="$1" stack="$2" activity="$3" file rc;file=$(mktemp "${TMPDIR:-/tmp}/mso-integrations-finder.XXXXXX");chmod 600 "$file";jq -n --argjson snapshot "$snap" --argjson stack "$stack" --argjson activity "$activity" '{snapshot:$snapshot,stack:$stack,activity:$activity}' >"$file";node "$ROOT/scripts/mso-integrations-finder.mjs" "$file";rc=$?;rm -f "$file";return $rc; }
-integration_tui_dispatch(){ local id="$1" snap="$2" kind value root out;case "$id" in
- action:quit) return 90;;
- action:noop) integration_activity "Select a source/auth method to inspect its metadata";;
- action:current) out=$(jget "/api/v1/integrations?view=which&cwd=$(enc "$PWD")");integration_activity "current user: $(jq -r '.user//"none"'<<<"$out")" "resolution: $(jq -r '.resolution//"none"'<<<"$out")";;
- action:transfer) integration_prompt_mode;run_integrations transfer;integration_wait;integration_activity "Opened Import / export JSON";;
+integration_stack_key(){ jq -r 'join("/")' <<<"$F_STACK"; }
+integration_cached(){ local store="$1" key="$2";jq -r --arg k "$key" '.[$k]//""'<<<"$store"; }
+integration_cache_event(){ local key="$1" event="$2" selected query;selected=$(jq -r '.selectedId//""'<<<"$event");query=$(jq -r '.query//""'<<<"$event");[ -n "$selected" ]&&F_SELECTED=$(jq --arg k "$key" --arg v "$selected" '.+{($k):$v}'<<<"$F_SELECTED");F_QUERIES=$(jq --arg k "$key" --arg v "$query" '.+{($k):$v}'<<<"$F_QUERIES"); }
+integration_finder_event(){ local snap="$1" stack="$2" activity="$3" initial="$4" query="$5" file rc safe;file=$(mktemp "${TMPDIR:-/tmp}/mso-integrations-finder.XXXXXX");chmod 600 "$file";safe=$(jq 'walk(if type=="object" then del(.value,.values,.secretValue,.token,.tokenValue,.password,.passphrase,.apiKey,.apiKeyValue,.privateUrl,.setupToken) else . end)'<<<"$snap");jq -n --argjson snapshot "$safe" --argjson stack "$stack" --argjson activity "$activity" --arg initialId "$initial" --arg query "$query" '{snapshot:$snapshot,stack:$stack,activity:$activity,initialId:$initialId,query:$query}' >"$file";node "$ROOT/scripts/mso-integrations-finder.mjs" "$file";rc=$?;rm -f "$file";return $rc; }
+integration_tui_dispatch(){ local id="$1" snap="$2" value;case "$id" in
+ action:quit) return 90;; action:inspect-auth:*) integration_activity "✓ Authentication metadata selected" "No credential value is loaded into the Finder frame.";;
+ action:current) local out;out=$(jget "/api/v1/integrations?view=which&cwd=$(enc "$PWD")");integration_activity "✓ Current folder resolved" "user: $(jq -r '.user//"none"'<<<"$out")" "resolution: $(jq -r '.resolution//"none"'<<<"$out")";;
+ action:transfer:metadata|action:transfer:encrypted|action:transfer:import) integration_prompt_mode;run_integrations transfer;integration_wait;integration_activity "✓ Opened private Import / export JSON manager" "Passphrases and direct credentials stay outside Finder state.";;
+ action:transfer:schema) integration_activity "✓ Integration Bundle v1" "schema: schemas/integration-bundle-v1.schema.json" "metadata JSON excludes credential values by default";;
action:user-add) integration_action_user_add;;action:user-default) integration_action_user_default;;action:user-bind) integration_action_user_bind;;action:user-rename) integration_action_user_rename;;action:user-duplicate) integration_action_user_duplicate;;action:user-delete) integration_action_user_delete;;
action:create-connection) integration_action_create_connection;;action:setup) integration_action_setup;;action:authorize) integration_action_authorize;;action:verify) integration_action_verify;;action:route) integration_action_route;;action:connection-default) integration_action_connection_default;;action:connection-rename) integration_action_connection_rename;;action:connection-delete) integration_action_connection_delete;;
- action:mail-orders) integration_action_mail orders orders;;
- action:mail-resource:*) value="${id#action:mail-resource:}";integration_action_mail resource "$value";;
- action:mail-log:*) value="${id#action:mail-log:}";integration_action_mail log "$value";;
- *) integration_activity "Unsupported Finder action: $id";;
+ action:mail-orders) integration_action_mail orders orders;;action:mail-resource:*) value="${id#action:mail-resource:}";integration_action_mail resource "$value";;action:mail-log:*) value="${id#action:mail-log:}";integration_action_mail log "$value";;
+ *) integration_activity "⚠ Unsupported Finder action: $id";; esac; }
+integration_shortcut(){ local id="$1" snap="$2" u p c source idx;u=$(integration_context user:);p=$(integration_context provider:);c=$(integration_context connection:);case "$id" in
+ help) integration_activity "MSO Integrations shortcuts" "↑↓ move · ←→ columns · Enter open/run · / filter" "V verify · R route · S setup · D default · N new" "1–4 sections · E export · I import · Ctrl-D quit";;
+ export) F_STACK='["transfer"]';integration_tui_dispatch action:transfer:metadata "$snap";; import) F_STACK='["transfer"]';integration_tui_dispatch action:transfer:import "$snap";;
+ new) [ -n "$u" ]&&[ -n "$p" ]||{ integration_activity "⚠ Select a credential user and provider first";return;};idx=$(jq '[to_entries[]|select(.value|startswith("provider:"))]|last.key'<<<"$F_STACK");F_STACK=$(jq --argjson i "$idx" '.[0:$i+1]+["new"]'<<<"$F_STACK");;
+ verify) integration_tui_dispatch action:verify "$snap";; route) integration_tui_dispatch action:route "$snap";;
+ setup) source=$(jq -r --arg u "$u" --arg p "$p" --arg c "$c" '.connections[]?|select(.user==$u and .provider==$p and .id==$c)|.source'<<<"$snap");[ "$source" = direct ]&&integration_tui_dispatch action:setup "$snap"||integration_activity "⚠ Secure local setup is available only for direct connections";;
+ default) [ -n "$c" ]&&integration_tui_dispatch action:connection-default "$snap"||integration_tui_dispatch action:user-default "$snap";;
esac; }
integrations_tui(){
tty_ok||{ jget "/api/v1/integrations?view=snapshot";return; }
- F_STACK='[]';F_ACTIVITY='[]';local snap event type id rc
+ F_STACK='[]';F_ACTIVITY='[]';F_SELECTED='{}';F_QUERIES='{}';local snap event type id rc key initial query
integration_alt_on;trap 'integration_alt_off' EXIT INT TERM
while true;do
- snap=$(integration_tui_snapshot "$(integration_context user:)")
- if ! event=$(integration_finder_event "$snap" "$F_STACK" "$F_ACTIVITY");then rc=$?;[ "$rc" -eq 130 ]&&break;integration_activity "Finder renderer unavailable";continue;fi
- type=$(jq -r '.type//"noop"'<<<"$event");id=$(jq -r '.id//.selectedId//""'<<<"$event");F_ACTIVITY='[]'
+ snap=$(integration_tui_snapshot "$(integration_context user:)");key=$(integration_stack_key);initial=$(integration_cached "$F_SELECTED" "$key");query=$(integration_cached "$F_QUERIES" "$key")
+ if ! event=$(integration_finder_event "$snap" "$F_STACK" "$F_ACTIVITY" "$initial" "$query");then rc=$?;[ "$rc" -eq 130 ]&&break;integration_activity "✕ Finder renderer unavailable";continue;fi
+ integration_cache_event "$key" "$event";type=$(jq -r '.type//"noop"'<<<"$event");id=$(jq -r '.id//.selectedId//""'<<<"$event");F_ACTIVITY='[]'
case "$type" in
- quit) break;;
- back) [ "$(jq length<<<"$F_STACK")" -gt 0 ]&&F_STACK=$(jq '.[0:-1]'<<<"$F_STACK");;
- noop) :;;
- open) [ -n "$id" ]&&F_STACK=$(jq --arg id "$id" '.+[$id]'<<<"$F_STACK");;
- select) if ! integration_tui_dispatch "$id" "$snap";then rc=$?;[ "$rc" -eq 90 ]&&break;fi;;
+ quit) break;; back) [ "$(jq length<<<"$F_STACK")" -gt 0 ]&&F_STACK=$(jq '.[0:-1]'<<<"$F_STACK");; noop) :;;
+ section) F_STACK=$(jq -nc --arg id "$id" '[$id]');; open) [ -n "$id" ]&&F_STACK=$(jq --arg id "$id" '.+[$id]'<<<"$F_STACK");;
+ shortcut) integration_shortcut "$id" "$snap";; select) if ! integration_tui_dispatch "$id" "$snap";then rc=$?;[ "$rc" -eq 90 ]&&break;fi;;
esac
done
integration_alt_off;trap - EXIT INT TERM
diff --git a/scripts/mso-cli-integrations-tui.test.ts b/scripts/mso-cli-integrations-tui.test.ts
index b57bd2a7..c0d7806b 100644
--- a/scripts/mso-cli-integrations-tui.test.ts
+++ b/scripts/mso-cli-integrations-tui.test.ts
@@ -4,3 +4,6 @@ function runTui(events:string[],prompts:string[]=[]){const dir=mkdtempSync(path.
it("Finder columns create a named connection through the same manage API",()=>{const calls=runTui(["OPEN:connections","OPEN:user:alice","OPEN:provider:github","OPEN:new","OPEN:source:direct","OPEN:auth:direct","SELECT:action:create-connection","QUIT"],["Work GitHub","work","n"]);expect(calls).toContainEqual(expect.objectContaining({mode:"manage",action:"connection.create",confirm:true,user:"alice",provider:"github",connection:"work",source:"direct",authMethod:"direct"}));});
it("Finder action column mutates only the selected connection identity",()=>{const calls=runTui(["OPEN:connections","OPEN:user:alice","OPEN:provider:github","OPEN:connection:work","SELECT:action:connection-rename","SELECT:action:connection-default","SELECT:action:connection-delete","QUIT"],["Renamed","work"]);const rows=calls.filter(x=>x.action?.startsWith("connection."));expect(rows.map(x=>x.action)).toEqual(expect.arrayContaining(["connection.rename","connection.default","connection.delete"]));expect(rows.every(x=>x.user==="alice"&&x.provider==="github"&&x.connection==="work")).toBe(true);});
it("Finder left/Esc event returns one column instead of terminating",()=>{expect(()=>runTui(["OPEN:connections","BACK","QUIT"])).not.toThrow();});
+
+it("Finder keyboard verify shortcut executes through the exact selected identity",()=>{const calls=runTui(["OPEN:connections","OPEN:user:alice","OPEN:provider:github","OPEN:connection:work","SHORTCUT:verify","QUIT"]);const verify=calls.find(x=>x.operation==="verify");expect(verify).toMatchObject({mode:"execute",operation:"verify",user:"alice",provider:"github",connection:"work"});});
+it("section events change Finder roots without creating parallel mutations",()=>{const calls=runTui(["SECTION:users","BACK","SECTION:catalog","BACK","SECTION:transfer","BACK","QUIT"]);expect(calls).toHaveLength(0);});
diff --git a/scripts/mso-integrations-finder-model.mjs b/scripts/mso-integrations-finder-model.mjs
index 0fef564c..6ce1329f 100644
--- a/scripts/mso-integrations-finder-model.mjs
+++ b/scripts/mso-integrations-finder-model.mjs
@@ -1,75 +1 @@
-const clean = (v) => String(v ?? "").replace(/[\r\n\t]+/g, " ").trim();
-const pick = (items, id) => items?.find((x) => x.id === id) ?? null;
-const suffix = (id, prefix) => id?.startsWith(prefix) ? id.slice(prefix.length) : null;
-export function context(stack = []) {
- const last = (prefix) => [...stack].reverse().map((x) => suffix(x, prefix)).find((x) => x !== null) ?? null;
- return { user:last("user:"), provider:last("provider:"), connection:last("connection:"), source:last("source:"), auth:last("auth:") };
-}
-const branch = (id,label,hint,preview=[]) => ({id,label,hint,preview,kind:"branch"});
-const action = (id,label,hint,preview=[]) => ({id,label,hint,preview,kind:"action"});
-function provider(snapshot,id){ return pick(snapshot.catalog,id); }
-function connection(snapshot,user,p,c){ return snapshot.connections?.find((x)=>x.user===user&&x.provider===p&&x.id===c) ?? null; }
-function userRow(snapshot,id){ return pick(snapshot.users,id); }
-function sourceRow(snapshot,p,s){ return provider(snapshot,p)?.sources?.find((x)=>x.id===s) ?? null; }
-function methodRow(snapshot,p,s,m){ return sourceRow(snapshot,p,s)?.methods?.find((x)=>x.id===m) ?? null; }
-function providerItems(snapshot,user){
- return (snapshot.catalog||[]).map((p)=>{const count=(snapshot.connections||[]).filter((c)=>c.user===user&&c.provider===p.id).length;return branch(`provider:${p.id}`,p.title,`${count} connection(s)`,[p.description,`${p.sources?.length||0} source/backend option(s)`]);});
-}
-function connectionItems(snapshot,user,p){
- const rows=(snapshot.connections||[]).filter((c)=>c.user===user&&c.provider===p);
- return [...rows.map((c)=>branch(`connection:${c.id}`,c.label,`${c.source} · ${c.authMethod} · ${c.state}${c.isDefault?" · default":""}`,[`id: ${c.id}`,`scope: ${c.scope}`,`source: ${c.source}`,`auth: ${c.authMethod}`])),branch("new","+ New connection","choose source/backend and auth")];
-}
-function newConnectionLayer(snapshot,p,stack){
- const ctx=context(stack), last=stack.at(-1);
- if(last==="new") return (provider(snapshot,p)?.sources||[]).map((s)=>branch(`source:${s.id}`,s.label,`${s.methods?.length||0} auth method(s)`,[s.description||"",s.reference||""]));
- if(ctx.source && last===`source:${ctx.source}`) return (sourceRow(snapshot,p,ctx.source)?.methods||[]).map((m)=>branch(`auth:${m.id}`,m.label,m.scope,[`scope: ${m.scope}`,`${m.fields?.length||0} credential field(s)`]));
- if(ctx.auth && last===`auth:${ctx.auth}`) return [action("action:create-connection","Create named connection","label + stable connection ID",[`source: ${ctx.source}`,`auth: ${ctx.auth}`,`scope: ${methodRow(snapshot,p,ctx.source,ctx.auth)?.scope||""}`])];
- return null;
-}
-function connectionActions(snapshot,user,p,c){
- const row=connection(snapshot,user,p,c); if(!row) return [];
- const out=[];
- if(row.source==="direct") out.push(action("action:setup","Set / rotate credentials","private browser form"));
- if(row.source==="composio") out.push(action("action:authorize","Authorize account","Composio hosted authorization"));
- out.push(action("action:verify","Verify","live API/auth status"),action("action:route","Route","show exact execution identity"));
- if(!row.isDefault) out.push(action("action:connection-default","Make default","provider fallback for this user"));
- if(p==="hostinger"&&row.source==="direct") out.push(branch("mail","Hostinger Mail","orders, mailboxes, aliases and logs"));
- out.push(action("action:connection-rename","Rename label","metadata only"),action("action:connection-delete","Delete connection","destructive; exact confirmation"));
- return out;
-}
-function mailLayer(stack){
- const last=stack.at(-1);
- if(last==="mail") return [action("action:mail-orders","Mail orders","list account mail orders"),...['mailboxes','aliases','forwarders','autoreplies','catchalls','webhooks'].map((x)=>action(`action:mail-resource:${x}`,x[0].toUpperCase()+x.slice(1),`list ${x}`)),branch("logs","Mail logs","access/action/inbound/mailbox/outbound")];
- if(last==="logs") return ['access','action','inbound','mailbox-actions','outbound'].map((x)=>action(`action:mail-log:${x}`,x.replace('-', ' '),`${x} log`));
- return null;
-}
-function userActions(snapshot,user){ const row=userRow(snapshot,user); return [branch("providers","Connections & providers","manage named accounts/deployments"),action("action:user-default","Set as default user","fallback when no folder mapping matches"),action("action:user-bind","Use for current folder","longest folder mapping wins"),action("action:user-rename","Rename user","preserve connections and folder mappings"),action("action:user-duplicate","Duplicate user","metadata by default"),action("action:user-delete","Delete user","destructive; exact confirmation")].map((x)=>({...x,preview:x.preview?.length?x.preview:[`user: ${row?.label||user}`]})); }
-export function layer(snapshot, stack=[]){
- const last=stack.at(-1), ctx=context(stack);
- if(!last) return [branch("connections","Connections","User → Provider → Connection → Source → Auth"),branch("users","Credential users","isolated account owners"),branch("catalog","Provider catalog","sources, auth methods and scope"),action("action:current","Current folder","show resolved credential user/binding"),action("action:transfer","Import / export JSON","portable metadata or encrypted direct credentials"),action("action:quit","Quit","return to shell")];
- if(last==="connections"||last==="users") return [...(snapshot.users||[]).map((u)=>branch(`user:${u.id}`,u.label,`${u.connectionCount} connection(s)${u.isDefault?' · default':''}`,u.isDefault?["default credential user"]:[])),action("action:user-add","+ Add user","new isolated credential owner")];
- if(last==="catalog") return (snapshot.catalog||[]).map((p)=>branch(`provider:${p.id}`,p.title,`${p.sources?.length||0} source(s)`,[p.description]));
- if(stack[0]==="catalog" && ctx.provider && last===`provider:${ctx.provider}`) return (provider(snapshot,ctx.provider)?.sources||[]).map((s)=>branch(`source:${s.id}`,s.label,`${s.methods?.length||0} method(s)`,[s.description||"",s.reference||""]));
- if(stack[0]==="catalog" && ctx.source && last===`source:${ctx.source}`) return (sourceRow(snapshot,ctx.provider,ctx.source)?.methods||[]).map((m)=>action("action:noop",m.label,`${m.scope} · ${m.fields?.length||0} field(s)`,(m.fields||[]).map((f)=>f.label||f.key)));
- if(ctx.user && last===`user:${ctx.user}`) return stack[0]==="users" ? userActions(snapshot,ctx.user) : providerItems(snapshot,ctx.user);
- if(last==="providers" && ctx.user) return providerItems(snapshot,ctx.user);
- if(ctx.provider && last===`provider:${ctx.provider}`){
- if(stack[0]==="catalog") return [];
- return connectionItems(snapshot,ctx.user,ctx.provider);
- }
- const fresh=newConnectionLayer(snapshot,ctx.provider,stack); if(fresh) return fresh;
- if(ctx.connection && last===`connection:${ctx.connection}`) return connectionActions(snapshot,ctx.user,ctx.provider,ctx.connection);
- const mail=mailLayer(stack); if(mail) return mail;
- return [];
-}
-export function labelFor(snapshot, id, stackPrefix=[]){
- const ctx=context([...stackPrefix,id]);
- if(id==="connections")return"Connections";if(id==="users")return"Credential users";if(id==="catalog")return"Provider catalog";if(id==="providers")return"Providers";if(id==="new")return"New connection";if(id==="mail")return"Hostinger Mail";if(id==="logs")return"Mail logs";
- if(id.startsWith("user:")) return userRow(snapshot,ctx.user)?.label||ctx.user;
- if(id.startsWith("provider:")) return provider(snapshot,ctx.provider)?.title||ctx.provider;
- if(id.startsWith("connection:")) return connection(snapshot,ctx.user,ctx.provider,ctx.connection)?.label||ctx.connection;
- if(id.startsWith("source:")) return sourceRow(snapshot,ctx.provider,ctx.source)?.label||ctx.source;
- if(id.startsWith("auth:")) return methodRow(snapshot,ctx.provider,ctx.source,ctx.auth)?.label||ctx.auth;
- return clean(id);
-}
-export function columns(snapshot,stack=[]){const out=[];for(let d=0;d<=stack.length;d++){const prefix=stack.slice(0,d);out.push({title:d?labelFor(snapshot,stack[d-1],prefix.slice(0,-1)):"Integrations",nodeId:d?stack[d-1]:"root",items:layer(snapshot,prefix),selectedId:d<stack.length?stack[d]:null});}return out;}
+export * from "./integrations-tui/model.mjs";
diff --git a/scripts/mso-integrations-finder-pty.test.ts b/scripts/mso-integrations-finder-pty.test.ts
new file mode 100644
index 00000000..b7116268
--- /dev/null
+++ b/scripts/mso-integrations-finder-pty.test.ts
@@ -0,0 +1,48 @@
+import { afterAll, expect, it } from "vitest";
+import { chmodSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+import pty from "node-pty";
+
+const dir = mkdtempSync(path.join(os.tmpdir(), "mso-integrations-pty-"));
+const config = path.join(dir, "finder.json");
+const SECRET = "PTY_SYNTHETIC_SECRET_MUST_NOT_RENDER";
+writeFileSync(config, JSON.stringify({
+ snapshot: {
+ user: "alice",
+ users: [{ id: "alice", label: "Alice", isDefault: true, connectionCount: 1 }],
+ catalog: [{ id: "github", title: "GitHub", description: "GitHub account", sources: [{ id: "direct", label: "MSO direct", methods: [{ id: "direct", label: "Direct", scope: "account", fields: [{ key: "apiKey", value: SECRET }] }] }] }],
+ connections: [{ user: "alice", id: "work", label: "Work", provider: "github", source: "direct", authMethod: "direct", scope: "account", state: "verified", isDefault: true, fields: [{ key: "apiKey", stored: true, value: SECRET }] }],
+ },
+ stack: ["connections", "user:alice", "provider:github", "connection:work"],
+ activity: [],
+}), { mode: 0o600 });
+chmodSync(config, 0o600);
+afterAll(() => rmSync(dir, { recursive: true, force: true }));
+
+function run(cols: number, rows: number) {
+ return new Promise<string>((resolve, reject) => {
+ const child = pty.spawn(process.execPath, [path.join(__dirname, "mso-integrations-finder.mjs"), config], {
+ cols, rows, cwd: __dirname, env: { ...process.env, NO_COLOR: "1" }, name: "xterm-256color",
+ });
+ let output = "", sent = false;
+ const timer = setTimeout(() => { try { child.kill(); } catch {} reject(new Error(`PTY ${cols}x${rows} timed out`)); }, 3000);
+ child.onData((data) => {
+ output += data;
+ if (!sent && output.includes("INSPECTOR")) { sent = true; child.write("\x04"); }
+ });
+ child.onExit(() => { clearTimeout(timer); resolve(output); });
+ });
+}
+
+it.each([[60,20],[80,24],[100,30],[120,32],[150,40],[200,50]])("paints and exits cleanly in a real %ix%i PTY", async (cols, rows) => {
+ const output = await run(cols, rows);
+ expect(output).toContain("MSO");
+ expect(output).toContain("Integrations");
+ expect(output).toContain("INSPECTOR");
+ expect(output).toContain("┌");
+ expect(output).toContain("┘");
+ expect(output).not.toContain(SECRET);
+ expect(output).toContain('"type":"quit"');
+});
diff --git a/scripts/mso-integrations-finder.mjs b/scripts/mso-integrations-finder.mjs
index d04b3cf9..b5a3b854 100755
--- a/scripts/mso-integrations-finder.mjs
+++ b/scripts/mso-integrations-finder.mjs
@@ -1,12 +1,6 @@
#!/usr/bin/env node
-import fs from 'node:fs';import readline from 'node:readline';import tty from 'node:tty';import {columns,labelFor} from './mso-integrations-finder-model.mjs';
-const E='\x1b',HOME=`${E}[H`,CLEAR=`${E}[2J`,HIDE=`${E}[?25l`,RESET=`${E}[0m`,BOLD=`${E}[1m`,DIM=`${E}[2m`,REV=`${E}[7m`;const CUP=(r,c=1)=>`${E}[${r};${c}H`;
-const strip=(s)=>String(s??'').replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g,'').replace(/[\r\n\t]+/g,' ');const width=(s)=>[...strip(s)].reduce((n,ch)=>n+(ch.codePointAt(0)>0x1100?2:1),0);
-function fit(s,w){s=strip(s);let o='',n=0;for(const ch of s){const x=width(ch);if(n+x>w)break;o+=ch;n+=x;}if(n<width(s)&&w){while(width(o)>w-1)o=o.slice(0,-1);o+='…';n=width(o);}return o+' '.repeat(Math.max(0,w-n));}
-function window(items,idx,h){if(items.length<=h)return{start:0,end:items.length};let start=Math.max(0,idx-Math.floor(h/2));start=Math.min(start,items.length-h);return{start,end:start+h};}
-export function visibleColumns(cols,slots){return cols.slice(-Math.max(1,Math.min(slots,cols.length)));}
-export function frame(config,{cols=120,rows=30}={}){const W=Math.max(47,cols-1),H=Math.max(16,rows),all=columns(config.snapshot,config.stack),slots=cols>=132?4:cols>=92?3:2,shown=visibleColumns(all,slots),omitted=all.length-shown.length,cw=Math.max(18,Math.floor((W-(slots-1))/slots)),current=shown.at(-1),items=(config.items??current.items),cursor=Math.min(config.cursor??0,Math.max(0,items.length-1)),active=items[cursor]||null,crumb=['MSO',...config.stack.map((id,i)=>labelFor(config.snapshot,id,config.stack.slice(0,i)))];
- const lines=[];lines.push(`${BOLD}${fit(' MSO Integrations — Finder view',W)}${RESET}`);const sec=['connections','users','catalog'].map(id=>{const label={connections:'Connections',users:'Users',catalog:'Providers'}[id];return (config.stack[0]===id?`${REV} ${label} ${RESET}`:`${DIM} ${label} ${RESET}`)}).join(' ');lines.push(fit(` SECTIONS ${sec}`,W));lines.push(fit(` PATH ${crumb.join(' › ')}`,W));lines.push(`${DIM}${fit(' ↑↓ move →/Tab deeper Enter open/run ←/Esc back type to filter Ctrl-D quit',W)}${RESET}`);lines.push(`${DIM}${fit(` FILTER ${config.query||'(current column)'}`,W)}${RESET}`);lines.push('─'.repeat(W));const detailRows=H>=26?7:H>=22?5:3,body=Math.max(3,H-lines.length-detailRows-3),prepared=shown.map((c,i)=>{const isActive=i===shown.length-1,its=isActive?items:c.items,sel=isActive?active?.id:c.selectedId,idx=Math.max(0,its.findIndex(x=>x.id===sel));return{...c,isActive,its,sel,win:window(its,idx,body-1)}});const blanks=slots-prepared.length;lines.push([...prepared.map((c,i)=>`${BOLD}${fit(` ${i===0&&omitted?'… / ':''}${c.title}`,cw)}${RESET}`),...Array(blanks).fill(' '.repeat(cw))].join('│'));
- for(let r=0;r<body-1;r++){const cells=prepared.map(c=>{const it=c.its[c.win.start+r];if(!it)return' '.repeat(cw);const sel=it.id===c.sel,mark=it.kind==='branch'?'›':'·',base=fit(` ${sel?'❯':' '} ${mark} ${it.label}`,cw);return sel?(c.isActive?`${REV}${base}${RESET}`:`${BOLD}${base}${RESET}`):base;});lines.push([...cells,...Array(blanks).fill(' '.repeat(cw))].join('│'));}lines.push('─'.repeat(W));lines.push(fit(` INFO ${active?`${active.label}${active.hint?` — ${active.hint}`:''}`:'(no match)'}`,W));const act=(config.activity||[]).slice(-detailRows);const prev=active?.preview||[];const detail=act.length?act:prev;lines.push(`${act.length?DIM:BOLD}${fit(` ${act.length?'RESULT':'PREVIEW'}`,W)}${RESET}`);for(let i=0;i<detailRows;i++)lines.push(`${act.length?DIM:''}${fit(` ${detail[i]||''}`,W)}${act.length?RESET:''}`);while(lines.length<H)lines.push('');return lines.slice(0,H);}
-function run(){const cfg=JSON.parse(fs.readFileSync(process.argv[2],'utf8')),fd=fs.openSync('/dev/tty',fs.constants.O_RDWR),input=new tty.ReadStream(fd),output=new tty.WriteStream(fd);readline.emitKeypressEvents(input);let query='',cursor=0,activity=cfg.activity||[];const current=()=>columns(cfg.snapshot,cfg.stack).at(-1)?.items||[],visible=()=>{const q=query.toLowerCase();return q?current().filter(x=>`${x.id} ${x.label} ${x.hint||''}`.toLowerCase().includes(q)):current()};const render=()=>{const lines=frame({...cfg,items:visible(),cursor,query,activity},{cols:output.columns,rows:output.rows});output.write(`${HOME}${CLEAR}${HIDE}`+lines.map((x,i)=>`${CUP(i+1)}${x}${RESET}`).join(''));};const finish=(ev)=>{input.off('keypress',key);if(input.isRaw)input.setRawMode(false);input.pause();output.write(HIDE);process.stdout.write(JSON.stringify({...ev,selectedId:visible()[cursor]?.id||null,query}),()=>process.exit(0));};const open=()=>{const it=visible()[cursor];if(it)finish({type:it.kind==='branch'?'open':'select',id:it.id});};const key=(str,k={})=>{activity=[];if(k.ctrl&&(k.name==='c'||k.name==='d'))return finish({type:'quit'});if(k.name==='up')cursor=visible().length?(cursor-1+visible().length)%visible().length:0;else if(k.name==='down')cursor=visible().length?(cursor+1)%visible().length:0;else if(k.name==='home')cursor=0;else if(k.name==='end')cursor=Math.max(0,visible().length-1);else if(k.name==='left')return finish({type:cfg.stack.length?'back':'noop'});else if(k.name==='right'||k.name==='return'||k.name==='enter'||k.name==='tab')return open();else if(k.name==='escape'){if(query){query='';cursor=0}else return finish({type:cfg.stack.length?'back':'noop'});}else if(k.name==='backspace'){query=[...query].slice(0,-1).join('');cursor=0}else if(str&&!k.ctrl&&!k.meta&&!/[\x00-\x1f\x7f]/.test(str)){query+=str;cursor=0}render();};input.on('keypress',key);input.resume();input.setRawMode(true);render();}
-if(import.meta.url===`file://${process.argv[1]}`)run();
+export { buildFrame as frame } from "./integrations-tui/renderer.mjs";
+export { visibleColumns, cellWidth, fitCells, stripAnsi } from "./integrations-tui/layout.mjs";
+export { shortcutEvent } from "./integrations-tui/app.mjs";
+import { run } from "./integrations-tui/app.mjs";
+if (import.meta.url === `file://${process.argv[1]}`) run(process.argv[2]);
diff --git a/scripts/mso-integrations-finder.test.ts b/scripts/mso-integrations-finder.test.ts
index 45d07df9..02fda583 100644
--- a/scripts/mso-integrations-finder.test.ts
+++ b/scripts/mso-integrations-finder.test.ts
@@ -1,6 +1,95 @@
-import {expect,it} from "vitest";import {columns,layer} from "./mso-integrations-finder-model.mjs";import {frame,visibleColumns} from "./mso-integrations-finder.mjs";
-const snap:any={user:"alice",users:[{id:"alice",label:"Alice",isDefault:true,connectionCount:1}],catalog:[{id:"github",title:"GitHub",description:"GitHub account",sources:[{id:"direct",label:"MSO direct",methods:[{id:"direct",label:"Direct credential",scope:"account",fields:[{key:"apiKey"}]}]}]}],connections:[{user:"alice",id:"work",label:"Work GitHub",provider:"github",source:"direct",authMethod:"direct",scope:"account",state:"verified",isDefault:false}]};
-it("models Finder ancestry as persistent columns",()=>{const stack=["connections","user:alice","provider:github","connection:work"];const cols=columns(snap,stack);expect(cols).toHaveLength(5);expect(cols.slice(1).map((x:any)=>x.title)).toEqual(["Connections","Alice","GitHub","Work GitHub"]);expect(cols.at(-1)?.items.map((x:any)=>x.id)).toContain("action:verify");});
-it("wide Finder keeps four rightmost identity/action columns",()=>{const cols=columns(snap,["connections","user:alice","provider:github","connection:work"]);expect(visibleColumns(cols,4).map((x:any)=>x.title)).toEqual(["Connections","Alice","GitHub","Work GitHub"]);});
-it("renders Finder path, multiple columns and preview without credential values",()=>{const text=frame({snapshot:snap,stack:["connections","user:alice","provider:github","connection:work"],activity:[]},{cols:150,rows:30}).join("\n").replace(/\x1b\[[0-9;]*m/g,"");for(const label of ["PATH","Connections","Alice","GitHub","Work GitHub","PREVIEW"])expect(text).toContain(label);expect(text).not.toContain("secret");expect(text.split("\n")).toHaveLength(30);});
-it("new-connection branch exposes source then auth as columns",()=>{expect(layer(snap,["connections","user:alice","provider:github","new"]).map((x:any)=>x.id)).toEqual(["source:direct"]);expect(layer(snap,["connections","user:alice","provider:github","new","source:direct"]).map((x:any)=>x.id)).toEqual(["auth:direct"]);});
+import { expect, it } from "vitest";
+import { execFileSync } from "node:child_process";
+import { mkdtempSync, readFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { columns, layer } from "./mso-integrations-finder-model.mjs";
+import { cellWidth, frame, shortcutEvent, stripAnsi, visibleColumns } from "./mso-integrations-finder.mjs";
+
+const SECRET = "SYNTHETIC_SECRET_MUST_NEVER_RENDER";
+const snap: any = {
+ user: "alice",
+ users: [{ id: "alice", label: "Alice", isDefault: true, connectionCount: 2 }],
+ catalog: [
+ { id: "github", title: "GitHub", description: "GitHub account", sources: [
+ { id: "direct", label: "MSO direct", methods: [{ id: "direct", label: "Direct credential", scope: "account", fields: [{ key: "apiKey", label: "API key", secret: true, required: true, value: SECRET }] }] },
+ { id: "composio", label: "Composio", methods: [{ id: "oauth2", label: "OAuth2", scope: "account", fields: [] }] },
+ ] },
+ { id: "hostinger", title: "Hostinger", description: "Hostinger VPS, DNS and Mail", sources: [
+ { id: "direct", label: "MSO direct", methods: [{ id: "direct", label: "Account API token", scope: "account", fields: [{ key: "apiToken", label: "Account API token", secret: true, required: true }] }] },
+ ] },
+ ],
+ connections: [
+ { user: "alice", id: "work", label: "Work GitHub", provider: "github", source: "direct", authMethod: "direct", scope: "account", state: "verified", isDefault: false, fields: [{ key: "apiKey", label: "API key", stored: true, value: SECRET }] },
+ { user: "alice", id: "mail", label: "Mail", provider: "hostinger", source: "direct", authMethod: "direct", scope: "account", state: "configured", isDefault: true, fields: [{ key: "apiToken", label: "Account API token", stored: true }] },
+ ],
+};
+const deepStack = ["connections", "user:alice", "provider:github", "connection:work"];
+const cellAt = (value: string, target: number) => { let pos = 0; for (const ch of value) { const w = cellWidth(ch); if (pos === target) return ch; if (target > pos && target < pos + w) return ""; pos += w; } return ""; };
+
+it("models Finder ancestry and a populated connection action/inspector column", () => {
+ const cols = columns(snap, deepStack);
+ expect(cols).toHaveLength(5);
+ expect(cols.slice(1).map((x: any) => x.title)).toEqual(["Connections", "Alice", "GitHub", "Work GitHub"]);
+ expect(cols.at(-1)?.items.map((x: any) => x.id)).toEqual(expect.arrayContaining(["action:setup", "action:verify", "action:route", "action:connection-delete"]));
+ expect(cols.at(-1)?.items.find((x: any) => x.id === "action:verify")?.preview.some((line: string) => line.includes("State: verified"))).toBe(true);
+});
+
+it("uses 4/3/2/1 Finder panes by terminal width without placeholder columns", () => {
+ const cols = columns(snap, deepStack);
+ expect(visibleColumns(cols, 150).map((x: any) => x.title)).toEqual(["Connections", "Alice", "GitHub", "Work GitHub"]);
+ expect(visibleColumns(cols, 110)).toHaveLength(3);
+ expect(visibleColumns(cols, 80)).toHaveLength(2);
+ expect(visibleColumns(cols, 60)).toHaveLength(1);
+ const root = frame({ snapshot: snap, stack: [], activity: [] }, { cols: 150, rows: 40 }).lines.map(stripAnsi);
+ const top = root.find((line: string) => line.startsWith("┌"))!;
+ expect(top.match(/┬/g) ?? []).toHaveLength(0);
+});
+
+it.each([[60,20],[80,24],[100,30],[120,32],[150,40],[200,50]])("keeps every %ix%i frame within the terminal and borders continuous", (cols, rows) => {
+ const built = frame({ snapshot: snap, stack: deepStack, activity: [] }, { cols, rows });
+ const plain = built.lines.map(stripAnsi);
+ expect(plain).toHaveLength(rows);
+ for (const line of plain) expect(cellWidth(line)).toBeLessThanOrEqual(cols - 1);
+ const topIndex = plain.findIndex((line: string) => line.startsWith("┌"));
+ const bottomIndex = plain.findIndex((line: string, i: number) => i > topIndex && line.startsWith("└"));
+ expect(topIndex).toBeGreaterThanOrEqual(0); expect(bottomIndex).toBeGreaterThan(topIndex);
+ const top = plain[topIndex];
+ const boundaries = [0, ...[...top].map((ch, i) => ch === "┬" ? i : -1).filter((i) => i >= 0), top.length - 1];
+ for (let i = topIndex + 1; i < bottomIndex; i++) {
+ const row = plain[i];
+ if (!row.startsWith("│")) continue;
+ expect(boundaries.every((x) => cellAt(row, x) === "│")).toBe(true);
+ }
+});
+
+it("renders MSO shell chrome, path, inspector, status and never secret-shaped values", () => {
+ const text = frame({ snapshot: snap, stack: deepStack, activity: [] }, { cols: 150, rows: 40 }).lines.map(stripAnsi).join("\n");
+ for (const label of ["MSO Integrations", "SECTIONS", "PATH", "Connections", "Alice", "GitHub", "Work GitHub", "INSPECTOR", "verified", "Ctrl-D quit"]) expect(text).toContain(label);
+ expect(text).not.toContain(SECRET);
+ expect(text).not.toContain("value:");
+});
+
+it("new connection and transfer flows remain modeled as Finder branches", () => {
+ expect(layer(snap, ["connections", "user:alice", "provider:github", "new"]).map((x: any) => x.id)).toEqual(["source:direct", "source:composio"]);
+ expect(layer(snap, ["connections", "user:alice", "provider:github", "new", "source:direct"]).map((x: any) => x.id)).toEqual(["auth:direct"]);
+ expect(layer(snap, ["transfer"]).map((x: any) => x.id)).toEqual(["action:transfer:metadata", "action:transfer:encrypted", "action:transfer:import", "action:transfer:schema"]);
+});
+
+it("exposes context-aware keyboard shortcuts without turning ordinary keys into secrets", () => {
+ const config: any = { snapshot: snap, stack: deepStack };
+ expect(shortcutEvent("v", config)).toEqual({ type: "shortcut", id: "verify" });
+ expect(shortcutEvent("s", config)).toEqual({ type: "shortcut", id: "setup" });
+ expect(shortcutEvent("2", config)).toEqual({ type: "section", id: "users" });
+ expect(shortcutEvent("?", config)).toEqual({ type: "shortcut", id: "help" });
+ expect(shortcutEvent("x", config)).toBeNull();
+});
+
+it("sanitizes secret-shaped snapshot fields before the private temp config and removes it", () => {
+ const dir = mkdtempSync(path.join(os.tmpdir(), "mso-finder-safe-"));
+ const captured = path.join(dir, "config.json"), marker = path.join(dir, "path.txt");
+ execFileSync("bash", [path.join(__dirname, "test-support/integrations-finder-sanitize-harness.sh")], { env: { ...process.env, MSO_CAPTURE_CONFIG: captured, MSO_CAPTURE_PATH: marker } });
+ const text = readFileSync(captured, "utf8");
+ expect(text).not.toContain("SYNTHETIC_SECRET_NEVER_TEMP");
+ expect(JSON.parse(text).snapshot.connections[0]).toMatchObject({ id: "x", stored: true });
+});
diff --git a/scripts/test-support/integrations-cli-tui-harness.sh b/scripts/test-support/integrations-cli-tui-harness.sh
index b81db4ec..c5c91080 100755
--- a/scripts/test-support/integrations-cli-tui-harness.sh
+++ b/scripts/test-support/integrations-cli-tui-harness.sh
@@ -5,7 +5,7 @@ source "$ROOT/scripts/mso-cli-integrations.sh"
: "${MSO_TUI_CHOICES:?events file required}" "${MSO_TUI_PROMPTS:?prompts file required}" "${MSO_TUI_LOG:?log file required}"
tty_ok(){ return 0; };integration_alt_on(){ :; };integration_alt_off(){ :; };integration_prompt_mode(){ :; };integration_wait(){ :; }
pop_line(){ local file="$1" line tmp;line=$(head -n1 "$file"||true);tmp="$file.tmp";tail -n +2 "$file">"$tmp";mv "$tmp" "$file";printf '%s' "$line"; }
-integration_finder_event(){ local _snap="$1" _stack="$2" _activity="$3" value;value=$(pop_line "$MSO_TUI_CHOICES");case "$value" in OPEN:*) jq -nc --arg id "${value#OPEN:}" '{type:"open",id:$id}';;SELECT:*)jq -nc --arg id "${value#SELECT:}" '{type:"select",id:$id}';;BACK)printf '%s' '{"type":"back"}';;QUIT|"")printf '%s' '{"type":"quit"}';;*)return 130;;esac; }
+integration_finder_event(){ local _snap="$1" _stack="$2" _activity="$3" _initial="${4-}" _query="${5-}" value;value=$(pop_line "$MSO_TUI_CHOICES");case "$value" in OPEN:*) jq -nc --arg id "${value#OPEN:}" --arg s "${value#OPEN:}" --arg q "$_query" '{type:"open",id:$id,selectedId:$s,query:$q}';;SELECT:*)jq -nc --arg id "${value#SELECT:}" --arg s "${value#SELECT:}" --arg q "$_query" '{type:"select",id:$id,selectedId:$s,query:$q}';;SHORTCUT:*)jq -nc --arg id "${value#SHORTCUT:}" --arg q "$_query" '{type:"shortcut",id:$id,query:$q}';;SECTION:*)jq -nc --arg id "${value#SECTION:}" '{type:"section",id:$id,query:""}';;BACK)printf '%s' '{"type":"back","query":""}';;QUIT|"")printf '%s' '{"type":"quit","query":""}';;*)return 130;;esac; }
tty_line(){ local _prompt="$1" default="${2-}" value;value=$(pop_line "$MSO_TUI_PROMPTS");REPLY="${value:-$default}"; }
enc(){ printf '%s' "$1"; };die(){ printf '%s' "$*" >&2;exit 2; }
SNAP='{"user":"alice","users":[{"id":"alice","label":"Alice","isDefault":true,"connectionCount":2}],"bindings":[],"catalog":[{"id":"github","title":"GitHub","description":"GitHub account","sources":[{"id":"direct","label":"MSO direct","methods":[{"id":"direct","label":"Direct credential","scope":"account","fields":[{"key":"apiKey"}]}]},{"id":"composio","label":"Composio","methods":[{"id":"oauth2","label":"OAuth2","scope":"account","fields":[]}]}]},{"id":"hostinger","title":"Hostinger","description":"Hostinger account","sources":[{"id":"direct","label":"MSO direct","methods":[{"id":"direct","label":"Account API token","scope":"account","fields":[{"key":"apiToken"}]},{"id":"mail","label":"Scoped Mail API token","scope":"mail-order","fields":[{"key":"mailApiToken"},{"key":"mailOrderId"}]}]}]}],"connections":[{"user":"alice","id":"work","label":"Work GitHub","provider":"github","source":"direct","authMethod":"direct","scope":"account","state":"verified","isDefault":false},{"user":"alice","id":"mail","label":"Mail","provider":"hostinger","source":"direct","authMethod":"mail","scope":"mail-order","state":"configured","isDefault":true}]}';
diff --git a/scripts/test-support/integrations-finder-sanitize-harness.sh b/scripts/test-support/integrations-finder-sanitize-harness.sh
new file mode 100755
index 00000000..889bc634
--- /dev/null
+++ b/scripts/test-support/integrations-finder-sanitize-harness.sh
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+: "${MSO_CAPTURE_CONFIG:?capture path}" "${MSO_CAPTURE_PATH:?path marker}"
+# shellcheck source=scripts/mso-cli-integrations-tui.sh
+source "$ROOT/scripts/mso-cli-integrations-tui.sh"
+node(){ printf '%s' "$2" > "$MSO_CAPTURE_PATH"; cp "$2" "$MSO_CAPTURE_CONFIG"; printf '%s' '{"type":"quit","selectedId":"","query":""}'; }
+snap='{"users":[],"catalog":[],"connections":[{"id":"x","provider":"demo","stored":true,"value":"SYNTHETIC_SECRET_NEVER_TEMP","apiKey":"SYNTHETIC_SECRET_NEVER_TEMP"}]}'
+integration_finder_event "$snap" '[]' '[]' '' '' >/dev/null
+[ ! -e "$(cat "$MSO_CAPTURE_PATH")" ] || { echo 'temporary config was not removed' >&2; exit 1; }