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.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
feat(integrations): use Finder-style column browser
Rahman5b294998fa06
diff --git a/docs/INTEGRATIONS.md b/docs/INTEGRATIONS.mdindex 6a2e79ea..639f8e3d 100644--- a/docs/INTEGRATIONS.md+++ b/docs/INTEGRATIONS.md@@ -80,19 +80,21 @@ 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 interactive navigator. It uses the same searchable arrow-key picker as the rest of the MSO CLI, with breadcrumb-style context and Esc/back navigation:+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:```text-Integrations-├─ Connections-│ └─ Credential user → Provider → Named connection → Actions-├─ Credential users-├─ Provider catalog-├─ Current folder-└─ Import / export JSON+┌ 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```-Creating a connection interactively walks through **source/backend → authentication method → label/ID**, then can open the private credential form. Existing connections expose Verify, Route, Make default, Rename, Delete, provider authorization, and a Hostinger Mail submenu when applicable. Secrets never enter the picker or CLI arguments.+`↑/↓` 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.++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.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:diff --git a/docs/PROGRESS.md b/docs/PROGRESS.mdindex cac2c333..92ddcd8c 100644--- a/docs/PROGRESS.md+++ b/docs/PROGRESS.md@@ -1,3 +1,9 @@+## 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.++This is presentation-only state: the TUI still calls the same native owner API for every read and confirmed mutation, secure credential entry still leaves the terminal for the private form, explicit subcommands are unchanged, and non-TTY `mso integrations` still emits a machine-readable snapshot.+## 2026-09-06 — One bounded MCP Page preview per tool resultA real ChatGPT screenshot showed Play Together twice inside one MSO Page result and an inline preview consuming more than the requested share of the conversation. The Page descriptor was publishing both the standard MCP Apps `ui.resourceUri` and the legacy ChatGPT `openai/outputTemplate` for the same Page resource while the reviewed app catalog still defaulted Play Together to `fullscreen`. Page v10 removes the legacy Page binding from `render_mso_page` and `integration_setup_open`, defaults reviewed apps to `inline`, and keeps older Page URIs as read-only cache aliases.diff --git a/scripts/mso-cli-integrations-tui-remote.sh b/scripts/mso-cli-integrations-tui-remote.shindex 3f5c8a68..84572232 100644--- a/scripts/mso-cli-integrations-tui-remote.sh+++ b/scripts/mso-cli-integrations-tui-remote.sh@@ -1,53 +1,22 @@#!/usr/bin/env bash-# External/Hostinger submenus for the interactive Integrations navigator.-integration_tui_composio_authorize() {- local user="$1" provider="$2" connection="$3" broker config answer managed body out- tty_line "Composio project connection ID (blank = auto): " ""; broker="$REPLY"- tty_line "Auth config ID (blank = auto): " ""; config="$REPLY"- tty_line "Allow a managed OAuth config if none exists? [y/N]: " "n"; answer="${REPLY,,}"; managed=false; case "$answer" in y|yes) managed=true;; esac- body=$(jq -nc --arg user "$user" --arg provider "$provider" --arg connection "$connection" --arg broker "$broker" --arg config "$config" --argjson managed "$managed" '{mode:"manage",action:"connection.authorize",confirm:true,user:$user,provider:$provider,connection:$connection,createManaged:$managed} + (if $broker!="" then {brokerConnection:$broker} else {} end) + (if $config!="" then {authConfigId:$config} else {} end)')- out=$(integration_tui_manage "$body")- jq 'del(.privateUrl)' <<<"$out"- if jq -e '.privateUrl' >/dev/null 2>&1 <<<"$out"; then printf '\nOpen this private authorization URL:\n%s\n' "$(jq -r .privateUrl <<<"$out")"; fi- integration_tui_pause-}-integration_tui_hostinger_mail() {- local user="$1" connection="$2" choice order resource kind out args- while true; do- integration_tui_header "$user › Hostinger › $connection › Mail"- choice=$(cat <<'ROWS' | integration_tui_pick "Hostinger Mail" ""-orders Mail orders list account mail orders-mailboxes Mailboxes list mailboxes for an order-aliases Aliases list aliases-forwarders Forwarders list forwarders-autoreplies Autoreplies list automatic replies-catchalls Catch-alls list catch-all routes-webhooks Webhooks list webhook metadata-logs Mail logs access/action/inbound/mailbox/outbound-__back ← Back connection-ROWS-) || return 0- [ "$choice" = __back ] && return 0- if [ "$choice" = orders ]; then- out=$(integration_tui_execute "$user" hostinger "$connection" hostinger.mail.orders.list '{}' true)- jq '.result' <<<"$out"; integration_tui_pause; continue- fi- tty_line "Mail order ID (blank uses scoped connection order): " ""; order="$REPLY"- if [ "$choice" = logs ]; then- kind=$(cat <<'ROWS' | integration_tui_pick "Mail log" ""-access Access access events-action Action action events-inbound Inbound inbound mail-mailbox-actions Mailbox actions mailbox mutations-outbound Outbound outbound mail-ROWS-) || continue- args=$(jq -nc --arg order "$order" --arg kind "$kind" '{kind:$kind,page:1}+(if $order!="" then {orderId:$order} else {} end)')- out=$(integration_tui_execute "$user" hostinger "$connection" hostinger.mail.logs.list "$args" true)- else- resource="$choice"; args=$(jq -nc --arg order "$order" --arg resource "$resource" '{resource:$resource,page:1}+(if $order!="" then {orderId:$order} else {} end)')- out=$(integration_tui_execute "$user" hostinger "$connection" hostinger.mail.list "$args" true)- fi- jq '.result' <<<"$out"; integration_tui_pause- done-}+# Prompted/action side of the Finder-style Integrations TUI. All mutations still+# travel through the native owner API; this file owns no credential state.+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"; }diff --git a/scripts/mso-cli-integrations-tui.sh b/scripts/mso-cli-integrations-tui.shold mode 100644new mode 100755index a50069d6..b1dbcd8d--- a/scripts/mso-cli-integrations-tui.sh+++ b/scripts/mso-cli-integrations-tui.sh@@ -1,204 +1,42 @@#!/usr/bin/env bash-# Interactive native Integrations navigator. Metadata only: credential values still-# enter through the private browser form opened by `mso integrations setup`.-+# Finder-style multi-column native Integrations navigator. UI state is ephemeral;+# every read/write still uses the same owner API as CLI/MCP/browser.# shellcheck source=mso-cli-integrations-tui-remote.shsource "$ROOT/scripts/mso-cli-integrations-tui-remote.sh"-integration_tui_pick() {- local title="$1" active="${2-}" choice- shift 2 || true- if choice=$(tui_select "$title" "$active"); then printf '%s' "$choice"; return 0; fi- return 1-}-integration_tui_pause() { tty_line "Press Enter to continue… " ""; }-integration_tui_snapshot() {- local user="${1-}" query="view=snapshot"- [ -n "$user" ] && query="$query&user=$(enc "$user")"- jget "/api/v1/integrations?$query"-}-integration_tui_header() {- local path="$1"- printf '\n\033[1mMSO Integrations\033[0m \033[2m%s\033[0m\n' "$path" > /dev/tty-}-integration_tui_slug() {- printf '%s' "$1" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9._-]+/-/g;s/^-+//;s/-+$//' | cut -c1-64-}-integration_tui_manage() {- local body="$1" out- out=$(jpost "/api/v1/integrations" "$body")- printf '%s\n' "$out"-}-integration_tui_execute() {- local user="$1" provider="$2" connection="$3" operation="$4" args="${5:-{}}" confirm="${6:-false}" body- body=$(jq -nc --arg user "$user" --arg provider "$provider" --arg connection "$connection" --arg operation "$operation" --argjson args "$args" --argjson confirm "$confirm" '{mode:"execute",user:$user,provider:$provider,connection:$connection,operation:$operation,arguments:$args} + (if $confirm then {confirm:true} else {} end)')- jpost "/api/v1/integrations" "$body"-}-integration_tui_add_user() {- local id label body- tty_line "New credential user ID: " ""; id="$REPLY"; [ -n "$id" ] || return 0- tty_line "Display label [$id]: " "$id"; label="$REPLY"- body=$(jq -nc --arg user "$id" --arg label "$label" '{mode:"manage",action:"user.create",confirm:true,user:$user,label:$label}')- integration_tui_manage "$body" | jq '{ok,action,user}'- integration_tui_pause-}-integration_tui_user_actions() {- local user="$1" choice target label copy body answer- while true; do- integration_tui_header "Users › $user"- choice=$(cat <<'ROWS' | integration_tui_pick "User · actions" ""-providers Connections & providers manage named accounts/deployments-make-default Set as default user fallback when no folder mapping matches-bind-folder Use for current folder longest folder mapping wins-rename Rename user preserve connections and folder mappings-duplicate Duplicate user metadata by default; credentials require opt-in-delete Delete user destructive; exact confirmation required-__back ← Back users-ROWS-) || return 0- case "$choice" in- __back) return 0 ;;- providers) integration_tui_provider_flow "$user" ;;- make-default)- body=$(jq -nc --arg user "$user" '{mode:"manage",action:"user.default",confirm:true,user:$user}')- integration_tui_manage "$body" | jq '{ok,action,user}'; integration_tui_pause ;;- bind-folder)- body=$(jq -nc --arg user "$user" --arg path "$PWD" '{mode:"manage",action:"folder.map",confirm:true,user:$user,path:$path}')- integration_tui_manage "$body" | jq '{ok,action,user,path}'; integration_tui_pause ;;- rename)- tty_line "New user ID: " "$user"; target="$REPLY"; [ "$target" != "$user" ] || continue- tty_line "Display label [$target]: " "$target"; label="$REPLY"- body=$(jq -nc --arg user "$user" --arg target "$target" --arg label "$label" '{mode:"manage",action:"user.rename",confirm:true,user:$user,target:$target,label:$label}')- integration_tui_manage "$body" | jq '{ok,action,user}'; user="$target"; integration_tui_pause ;;- duplicate)- tty_line "Duplicate as user ID: " "${user}-copy"; target="$REPLY"; [ -n "$target" ] || continue- tty_line "Display label [$target]: " "$target"; label="$REPLY"- tty_line "Copy direct credentials too? [y/N]: " "n"; answer="${REPLY,,}"; copy=false; case "$answer" in y|yes) copy=true;; esac- body=$(jq -nc --arg user "$user" --arg target "$target" --arg label "$label" --argjson copy "$copy" '{mode:"manage",action:"user.duplicate",confirm:true,user:$user,target:$target,label:$label,copyCredentials:$copy}')- integration_tui_manage "$body" | jq '{ok,action,user}'; integration_tui_pause ;;- delete)- tty_line "Type $user to delete this credential user: " ""; [ "$REPLY" = "$user" ] || { echo "Cancelled."; integration_tui_pause; continue; }- body=$(jq -nc --arg user "$user" '{mode:"manage",action:"user.delete",confirm:true,user:$user}')- integration_tui_manage "$body" | jq '{ok,action,user}'; integration_tui_pause; return 0 ;;- esac- done-}-integration_tui_users() {- local snap choice rows- while true; do- snap=$(integration_tui_snapshot)- rows=$(jq -r '.users[] | [.id,.label,((.connectionCount|tostring)+" connection(s)" + (if .isDefault then " · default" else "" end)),(if .isDefault then "current" else "" end)]|@tsv' <<<"$snap")- integration_tui_header "Users"- choice=$({ printf '%s\n' "$rows"; printf '__add\t+ Add user\tnew isolated credential owner\n__back\t← Back\tIntegrations\n'; } | integration_tui_pick "Credential users" "$(jq -r '.user // empty' <<<"$snap")") || return 0- case "$choice" in __back) return 0;; __add) integration_tui_add_user;; *) integration_tui_user_actions "$choice";; esac- done-}-integration_tui_browse_providers() {- local snap choice row- snap=$(integration_tui_snapshot)- while true; do- integration_tui_header "Providers"- choice=$({ jq -r '.catalog[]|[.id,.title,((.sources|length|tostring)+" source(s)"),""]|@tsv' <<<"$snap"; printf '__back\t← Back\tIntegrations\n'; } | integration_tui_pick "Provider catalog" "") || return 0- [ "$choice" = __back ] && return 0- row=$(jq -c --arg id "$choice" '.catalog[]|select(.id==$id)' <<<"$snap")- printf '\n%s — %s\n' "$(jq -r .title <<<"$row")" "$(jq -r .description <<<"$row")"- jq -r '.sources[] | " " + .label + "\n" + (.methods[] | " • " + .label + " · " + .scope)' <<<"$row"- integration_tui_pause- done-}-integration_tui_new_connection() {- local user="$1" provider="$2" snap source method label id idDefault body answer- snap=$(integration_tui_snapshot "$user")- integration_tui_header "$user › $provider › New connection"- source=$(jq -r --arg id "$provider" '.catalog[]|select(.id==$id)|.sources[]|[.id,.label,((.methods|length|tostring)+" auth method(s)"),""]|@tsv' <<<"$snap" | integration_tui_pick "Source / backend" "") || return 0- method=$(jq -r --arg p "$provider" --arg s "$source" '.catalog[]|select(.id==$p)|.sources[]|select(.id==$s)|.methods[]|[.id,.label,(.scope+" · "+((.fields|length|tostring))+" field(s)"),""]|@tsv' <<<"$snap" | integration_tui_pick "Authentication" "") || return 0- tty_line "Connection label: " "$provider"; label="$REPLY"; [ -n "$label" ] || return 0- idDefault=$(integration_tui_slug "$label"); [ -n "$idDefault" ] || idDefault=connection- tty_line "Connection ID [$idDefault]: " "$idDefault"; id="$REPLY"- body=$(jq -nc --arg user "$user" --arg provider "$provider" --arg connection "$id" --arg label "$label" --arg source "$source" --arg method "$method" '{mode:"manage",action:"connection.create",confirm:true,user:$user,provider:$provider,connection:$connection,label:$label,source:$source,authMethod:$method}')- integration_tui_manage "$body" | jq '{ok,action,connection:(.connection|{id,label,provider,source,authMethod,scope,state,isDefault})}'- if [ "$source" = direct ]; then- tty_line "Open secure credential form now? [Y/n]: " "y"; answer="${REPLY,,}"- case "$answer" in n|no) ;; *) run_integrations setup "$user" "$provider" "$id";; esac- fi- integration_tui_pause-}-integration_tui_connection() {- local user="$1" provider="$2" connection="$3" choice snap row source isDefault body label confirm out- while true; do- snap=$(integration_tui_snapshot "$user")- row=$(jq -c --arg p "$provider" --arg c "$connection" '.connections[]|select(.provider==$p and .id==$c)' <<<"$snap")- [ -n "$row" ] || return 0- source=$(jq -r .source <<<"$row"); isDefault=$(jq -r '.isDefault//false' <<<"$row")- integration_tui_header "$user › $provider › $(jq -r .label <<<"$row")"- choice=$({- [ "$source" = direct ] && printf 'setup\tSet / rotate credentials\tprivate browser form\n'- [ "$source" = composio ] && printf 'authorize\tAuthorize account\tComposio hosted authorization\n'- printf 'verify\tVerify\tlive API/auth status\nroute\tRoute\tshow exact execution identity\n'- [ "$isDefault" != true ] && printf 'default\tMake default\tprovider fallback for this user\n'- [ "$provider" = hostinger ] && [ "$source" = direct ] && printf 'mail\tHostinger Mail\torders, mailboxes, aliases, logs…\n'- printf 'rename\tRename label\tmetadata only\ndelete\tDelete connection\tdestructive; exact confirmation\n__back\t← Back\tprovider\n'- } | integration_tui_pick "Connection actions" "") || return 0- case "$choice" in- __back) return 0 ;;- setup) run_integrations setup "$user" "$provider" "$connection"; integration_tui_pause ;;- authorize) integration_tui_composio_authorize "$user" "$provider" "$connection" ;;- verify) out=$(integration_tui_execute "$user" "$provider" "$connection" verify '{}' false); jq '{ok,detail,id,user,connection}' <<<"$out"; integration_tui_pause ;;- route) out=$(integration_tui_execute "$user" "$provider" "$connection" route '{}' false); jq '.' <<<"$out"; integration_tui_pause ;;- default) body=$(jq -nc --arg user "$user" --arg provider "$provider" --arg connection "$connection" '{mode:"manage",action:"connection.default",confirm:true,user:$user,provider:$provider,connection:$connection}'); integration_tui_manage "$body" | jq '{ok,action,connection:(.connection|{id,label,isDefault})}'; integration_tui_pause ;;- mail) integration_tui_hostinger_mail "$user" "$connection" ;;- rename) tty_line "New label: " "$(jq -r .label <<<"$row")"; label="$REPLY"; body=$(jq -nc --arg user "$user" --arg provider "$provider" --arg connection "$connection" --arg label "$label" '{mode:"manage",action:"connection.rename",confirm:true,user:$user,provider:$provider,connection:$connection,label:$label}'); integration_tui_manage "$body" | jq '{ok,action,connection:(.connection|{id,label})}'; integration_tui_pause ;;- delete) tty_line "Type $connection to delete this connection: " ""; confirm="$REPLY"; [ "$confirm" = "$connection" ] || { echo 'Cancelled.'; integration_tui_pause; continue; }; body=$(jq -nc --arg user "$user" --arg provider "$provider" --arg connection "$connection" '{mode:"manage",action:"connection.delete",confirm:true,user:$user,provider:$provider,connection:$connection}'); integration_tui_manage "$body" | jq '{ok,action,user,provider,connection}'; integration_tui_pause; return 0 ;;- esac- done-}-integration_tui_provider_flow() {- local user="$1" snap provider choice rows count title- while true; do- snap=$(integration_tui_snapshot "$user")- integration_tui_header "$user › Providers"- provider=$({ jq -r --arg u "$user" '.catalog[] as $p | [$p.id,$p.title,(([.connections[]|select(.provider==$p.id)]|length|tostring)+" connection(s)"),""]|@tsv' <<<"$snap"; printf '__back\t← Back\tuser\n'; } | integration_tui_pick "Providers" "") || return 0- [ "$provider" = __back ] && return 0- while true; do- snap=$(integration_tui_snapshot "$user")- title=$(jq -r --arg id "$provider" '.catalog[]|select(.id==$id)|.title' <<<"$snap")- rows=$(jq -r --arg p "$provider" '.connections[]|select(.provider==$p)|[.id,.label,(.source+" · "+.authMethod+" · "+.state+(if .isDefault then " · default" else "" end)),(if .isDefault then "current" else "" end)]|@tsv' <<<"$snap")- integration_tui_header "$user › $title"- choice=$({ printf '%s\n' "$rows"; printf '__new\t+ New connection\tchoose source/backend and auth\n__back\t← Back\tproviders\n'; } | integration_tui_pick "$title · connections" "") || break- case "$choice" in __back) break;; __new) integration_tui_new_connection "$user" "$provider";; *) integration_tui_connection "$user" "$provider" "$choice";; esac- done- done-}-integration_tui_connections() {- local snap choice rows- while true; do- snap=$(integration_tui_snapshot)- rows=$(jq -r '.users[]|[.id,.label,((.connectionCount|tostring)+" connection(s)"+(if .isDefault then " · default" else "" end)),(if .isDefault then "current" else "" end)]|@tsv' <<<"$snap")- integration_tui_header "Connections"- choice=$({ printf '%s\n' "$rows"; printf '__add\t+ Add user\tcreate credential owner first\n__back\t← Back\tIntegrations\n'; } | integration_tui_pick "Choose credential user" "$(jq -r '.user // empty' <<<"$snap")") || return 0- case "$choice" in __back) return 0;; __add) integration_tui_add_user;; *) integration_tui_provider_flow "$choice";; esac- done-}-integrations_tui() {- local choice out- tty_ok || { jget "/api/v1/integrations?view=snapshot"; return; }- while true; do- integration_tui_header "Home"- choice=$(cat <<'ROWS' | integration_tui_pick "Integrations" ""-connections Connections User → Provider → Connection → Source → Auth-users Credential users isolated account owners-providers Provider catalog sources, auth methods and scope-current Current folder show resolved credential user/bindings-transfer Import / export JSON portable metadata or encrypted direct credentials-quit Quit return to shell-ROWS-) || return 0- case "$choice" in- connections) integration_tui_connections ;;- users) integration_tui_users ;;- providers) integration_tui_browse_providers ;;- current) out=$(jget "/api/v1/integrations?view=which&cwd=$(enc "$PWD")"); jq '{user,resolution,bindings}' <<<"$out"; integration_tui_pause ;;- transfer) run_integrations transfer; integration_tui_pause ;;- quit) return 0 ;;+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_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";;+ 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";;+ esac; }+integrations_tui(){+ tty_ok||{ jget "/api/v1/integrations?view=snapshot";return; }+ F_STACK='[]';F_ACTIVITY='[]';local snap event type id rc+ 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='[]'+ 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;;esacdone+ integration_alt_off;trap - EXIT INT TERM}diff --git a/scripts/mso-cli-integrations-tui.test.ts b/scripts/mso-cli-integrations-tui.test.tsindex 5bfb79db..b57bd2a7 100644--- a/scripts/mso-cli-integrations-tui.test.ts+++ b/scripts/mso-cli-integrations-tui.test.ts@@ -1,8 +1,6 @@-import {execFileSync} from "node:child_process";-import {mkdtempSync,writeFileSync,readFileSync} from "node:fs";-import os from "node:os";import path from "node:path";import {expect,it} from "vitest";+import {execFileSync} from "node:child_process";import {mkdtempSync,writeFileSync,readFileSync} from "node:fs";import os from "node:os";import path from "node:path";import {expect,it} from "vitest";const script=path.join(__dirname,"test-support/integrations-cli-tui-harness.sh");-function runTui(choices:string[],prompts:string[]=[]){const dir=mkdtempSync(path.join(os.tmpdir(),"mso-integrations-tui-")),choice=path.join(dir,"choices"),prompt=path.join(dir,"prompts"),log=path.join(dir,"log");writeFileSync(choice,choices.join("\n")+"\n");writeFileSync(prompt,prompts.join("\n")+"\n");writeFileSync(log,"");execFileSync("bash",[script],{encoding:"utf8",env:{...process.env,MSO_TUI_CHOICES:choice,MSO_TUI_PROMPTS:prompt,MSO_TUI_LOG:log}});return readFileSync(log,"utf8").split("\n").filter(Boolean).map(line=>JSON.parse(line.split("\t").slice(1).join("\t")));}-it("interactive hierarchy creates a named connection through the same manage API",()=>{const calls=runTui(["connections","alice","github","__new","direct","direct","__back","__back","__back","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("interactive connection actions rename, set default and delete only the selected identity",()=>{const calls=runTui(["connections","alice","github","work","rename","default","delete","__back","__back","__back","quit"],["Renamed","work"]);expect(calls.map(x=>x.action).filter(Boolean)).toEqual(expect.arrayContaining(["connection.rename","connection.default","connection.delete"]));expect(calls.filter(x=>x.action?.startsWith("connection.")).every(x=>x.user==="alice"&&x.provider==="github"&&x.connection==="work")).toBe(true);});-it("picker cancellation returns to its parent instead of killing the command",()=>{expect(()=>runTui(["connections","__ESC__","quit"])).not.toThrow();});+function runTui(events:string[],prompts:string[]=[]){const dir=mkdtempSync(path.join(os.tmpdir(),"mso-integrations-finder-")),choice=path.join(dir,"events"),prompt=path.join(dir,"prompts"),log=path.join(dir,"log");writeFileSync(choice,events.join("\n")+"\n");writeFileSync(prompt,prompts.join("\n")+"\n");writeFileSync(log,"");execFileSync("bash",[script],{encoding:"utf8",env:{...process.env,MSO_TUI_CHOICES:choice,MSO_TUI_PROMPTS:prompt,MSO_TUI_LOG:log}});return readFileSync(log,"utf8").split("\n").filter(Boolean).map(line=>JSON.parse(line.split("\t").slice(1).join("\t")));}+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();});diff --git a/scripts/mso-integrations-finder-model.mjs b/scripts/mso-integrations-finder-model.mjsnew file mode 100644index 00000000..0fef564c--- /dev/null+++ b/scripts/mso-integrations-finder-model.mjs@@ -0,0 +1,75 @@+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;}diff --git a/scripts/mso-integrations-finder.mjs b/scripts/mso-integrations-finder.mjsnew file mode 100755index 00000000..d04b3cf9--- /dev/null+++ b/scripts/mso-integrations-finder.mjs@@ -0,0 +1,12 @@+#!/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();diff --git a/scripts/mso-integrations-finder.test.ts b/scripts/mso-integrations-finder.test.tsnew file mode 100644index 00000000..45d07df9--- /dev/null+++ b/scripts/mso-integrations-finder.test.ts@@ -0,0 +1,6 @@+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"]);});diff --git a/scripts/test-support/integrations-cli-tui-harness.sh b/scripts/test-support/integrations-cli-tui-harness.shindex c62b6396..b81db4ec 100755--- a/scripts/test-support/integrations-cli-tui-harness.sh+++ b/scripts/test-support/integrations-cli-tui-harness.sh@@ -2,16 +2,13 @@set -euo pipefailROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"source "$ROOT/scripts/mso-cli-integrations.sh"-: "${MSO_TUI_CHOICES:?choices file required}" "${MSO_TUI_PROMPTS:?prompts file required}" "${MSO_TUI_LOG:?log file required}"-tty_ok(){ return 0; }-integration_tui_header(){ :; }-integration_tui_pause(){ :; }-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"; }-tui_select(){ local _title="$1" _active="${2-}" value; cat >/dev/null; value=$(pop_line "$MSO_TUI_CHOICES"); [ "$value" != __ESC__ ] || return 130; [ -n "$value" ] || return 130; printf '%s' "$value"; }-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":1}],"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}]}';-jget(){ case "$1" in *view=which*) printf '%s' '{"user":"alice","resolution":"default","bindings":[]}' ;; *transfer*) printf '%s' '{"url":"https://mso.example/integrations?transfer=1"}' ;; *) printf '%s' "$SNAP" ;; esac; }-jpost(){ local route="$1" body="${2-}"; [ -n "$body" ] || body="{}"; printf '%s\t%s\n' "$route" "$body" >> "$MSO_TUI_LOG"; if [[ "$route" == */infra/setup ]]; then printf '%s' '{"setupUrl":"https://mso.example/integrations","token":"TEST_ONLY_PRIVATE_TOKEN"}'; return; fi; case "$(jq -r '.action//.operation//empty' <<<"$body")" in connection.create) printf '%s' '{"ok":true,"action":"connection.create","connection":{"id":"work","label":"Work GitHub","provider":"github","source":"direct","authMethod":"direct","scope":"account","state":"configured","isDefault":false}}' ;; connection.rename|connection.default|connection.delete|user.default|folder.map|user.create|user.rename|user.duplicate|user.delete) printf '%s' '{"ok":true,"action":"ok","user":"alice","provider":"github","connection":{"id":"work","label":"Renamed","isDefault":true}}' ;; verify) printf '%s' '{"id":"github","ok":true,"detail":"verified"}' ;; route) printf '%s' '{"user":"alice","id":"work","source":"direct","execution":{"route":"native-direct"}}' ;; hostinger.mail.orders.list) printf '%s' '{"result":{"data":[]}}' ;; *) printf '%s' '{}' ;; esac; }-if [ "$#" -eq 0 ]; then integrations_tui; else run_integrations "$@"; fi+: "${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; }+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}]}';+jget(){ case "$1" in *view=which*)printf '%s' '{"user":"alice","resolution":"default","bindings":[]}' ;;*transfer*)printf '%s' '{"url":"https://mso.example/integrations?transfer=1"}' ;;*)printf '%s' "$SNAP";;esac; }+jpost(){ local route="$1" body="${2-}";[ -n "$body" ]||body='{}';printf '%s\t%s\n' "$route" "$body">>"$MSO_TUI_LOG";if [[ "$route" == */infra/setup ]];then printf '%s' '{"setupUrl":"https://mso.example/integrations","token":"TEST_ONLY_PRIVATE_TOKEN"}';return;fi;case "$(jq -r '.action//.operation//empty'<<<"$body")" in connection.create)printf '%s' '{"ok":true,"connection":{"id":"work"}}';;connection.rename|connection.default|connection.delete|user.default|folder.map|user.create|user.rename|user.duplicate|user.delete)printf '%s' '{"ok":true}';;verify)printf '%s' '{"ok":true,"detail":"verified"}';;route)printf '%s' '{"source":"direct","scope":"account"}';;hostinger.mail.orders.list)printf '%s' '{"result":{"data":[]}}';;*)printf '%s' '{}';;esac; }+if [ "$#" -eq 0 ];then integrations_tui;else run_integrations "$@";fi