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.

fix(jev): close release contract gaps

Rahman40a883be5ef4
diff --git a/.env.example b/.env.example
index 62c0d398..7e732cbc 100644
--- a/.env.example
+++ b/.env.example
@@ -295,6 +295,8 @@ OS_AGENT_MEMORY_JIT_CHARS=8000
# OS_AGENT_SESSION_ARCHIVE_DIR=~/.mso/agent-session-archive
# JEV preservation receipts are SHA-bound evidence that gates archive deletion.
# OS_AGENT_SESSION_PRESERVATION_DIR=~/.mso/agent-session-preservation
+# Optional owner-private JEV decision telemetry store; metadata only, no credentials/raw transcripts.
+# OS_JEV_TELEMETRY_STORE=~/.mso/private/jev-telemetry.json
# OS_AGENT_SESSION_ARCHIVE_DAYS=30
# Owner-private Dokploy/Cloudflare/Hostinger connection state. Defaults to the path
# below; normally leave it there so the 0700 directory + 0600 file policy applies.
diff --git a/bin/mso b/bin/mso
index f6bf305a..60d428e6 100755
--- a/bin/mso
+++ b/bin/mso
@@ -80,6 +80,7 @@
# prefs * UI preferences: show | set
# federation * Batonly capability federation worker: status
# models * Configure AI providers/auth; inspect model catalog
+# jev * JEV decision plane: status | decide | request (never executes actions)
# skills * Discover host skills + curated market: available/install/remove
# changelog What shipped, newest first (same text Settings → Account → About shows)
# mcp * MCP tokens + live activity: list | pat <label> [scope] [ttlDays] | activity [n] | revoke <id> | revoke all
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 405af68b..4e63a36b 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -36,6 +36,7 @@ this is the *what*, and it is what Settings → Account → About shows as “Wh
- `auth` rebuild the account profile before writing it
- `windows` match native taskbar proportions
+- `jev` close release contract gaps
- `worktrees` keep runtime paths out of build tracing
- `memory` keep runtime backup paths out of build tracing
- `tests` make recovery fixtures portable
diff --git a/docs/CLI.md b/docs/CLI.md
index 085c060d..66382cbd 100644
--- a/docs/CLI.md
+++ b/docs/CLI.md
@@ -120,6 +120,7 @@ Commands:
prefs * UI preferences: show | set
federation * Batonly capability federation worker: status
models * Configure AI providers/auth; inspect model catalog
+ jev * JEV decision plane: status | decide | request (never executes actions)
skills * Discover host skills + curated market: available/install/remove
changelog What shipped, newest first (same text Settings → Account → About shows)
mcp * MCP tokens + live activity: list | pat <label> [scope] [ttlDays] | activity [n] | revoke <id> | revoke all
diff --git a/docs/generated/MCP-CATALOG.md b/docs/generated/MCP-CATALOG.md
index ff806024..a64a3de3 100644
--- a/docs/generated/MCP-CATALOG.md
+++ b/docs/generated/MCP-CATALOG.md
@@ -4,7 +4,7 @@
## Full MSO catalog
-<!-- mcp-toolset: server=1.16.0 version=2026.09.25.1 tools=115 read=57 write=34 exec=24 -->
+<!-- mcp-toolset: server=1.16.0 version=2026.09.25.1 tools=115 read=58 write=34 exec=23 -->
| Fact | Current source value |
|---|---:|
@@ -13,12 +13,12 @@
| Toolset changed at | `2026-09-25T17:39:19+00:00` |
| Transport tools | **117** |
| Model/operator tools | **115** |
-| Read | **57** |
+| Read | **58** |
| Write | **34** |
-| Exec | **24** |
+| Exec | **23** |
| App-only bridges | **2** |
-### Read (57)
+### Read (58)
- `a2a_agent_discover`
- `a2a_agents_list`
@@ -49,6 +49,7 @@
- `infra_provider_doctor`
- `infra_providers_list`
- `integration_query`
+- `jev_action`
- `local_agent_inbox`
- `local_agent_request_wait`
- `local_agents_list`
@@ -115,7 +116,7 @@
- `workflow_finish`
- `workflow_start`
-### Exec (24)
+### Exec (23)
- `a2a_handoff`
- `a2a_message_send`
@@ -127,7 +128,6 @@
- `exec_run`
- `flow_run`
- `integration_execute`
-- `jev_action`
- `local_agent_request`
- `local_agent_standby`
- `project_agent_run`
@@ -149,7 +149,7 @@
## ChatGPT model profile
-<!-- mcp-chatgpt-profile: server=1.16.0 version=2026.09.25.1 tools=115 read=57 write=34 exec=24 app-only=2 total=117 -->
+<!-- mcp-chatgpt-profile: server=1.16.0 version=2026.09.25.1 tools=115 read=58 write=34 exec=23 app-only=2 total=117 -->
The ChatGPT profile automatically projects the complete MSO-owned generic model/operator catalog. OAuth scope is still enforced independently; app-only compatibility bridges stay app-only, and project-owned MCP tool names remain dynamic data behind the generic project bridge.
@@ -157,12 +157,12 @@ The ChatGPT profile automatically projects the complete MSO-owned generic model/
|---|---:|
| ChatGPT transport tools | **117** |
| ChatGPT model/operator tools | **115** |
-| Read | **57** |
+| Read | **58** |
| Write | **34** |
-| Exec | **24** |
+| Exec | **23** |
| App-only bridges | **2** |
-### ChatGPT read (57)
+### ChatGPT read (58)
- `a2a_agent_discover`
- `a2a_agents_list`
@@ -193,6 +193,7 @@ The ChatGPT profile automatically projects the complete MSO-owned generic model/
- `infra_provider_doctor`
- `infra_providers_list`
- `integration_query`
+- `jev_action`
- `local_agent_inbox`
- `local_agent_request_wait`
- `local_agents_list`
@@ -259,7 +260,7 @@ The ChatGPT profile automatically projects the complete MSO-owned generic model/
- `workflow_finish`
- `workflow_start`
-### ChatGPT exec (24)
+### ChatGPT exec (23)
- `a2a_handoff`
- `a2a_message_send`
@@ -271,7 +272,6 @@ The ChatGPT profile automatically projects the complete MSO-owned generic model/
- `exec_run`
- `flow_run`
- `integration_execute`
-- `jev_action`
- `local_agent_request`
- `local_agent_standby`
- `project_agent_run`
diff --git a/lib/mcp/parity.test.ts b/lib/mcp/parity.test.ts
index b4c04fa8..eba0b040 100644
--- a/lib/mcp/parity.test.ts
+++ b/lib/mcp/parity.test.ts
@@ -188,6 +188,7 @@ describe("MCP rate limits mirror the routes", () => {
// workflow_status is app-only polling. Keep its own bucket so UI refreshes
// neither consume lifecycle capacity nor bypass the server-wide token limit.
"workflow.status": 30,
+ "jev.action": 30,
"agent.session": 30,
"agent.memory": 30,
"agent.subagent": 12,
diff --git a/scripts/cli/commands-state.sh b/scripts/cli/commands-state.sh
index 52ed5333..20cbbf87 100755
--- a/scripts/cli/commands-state.sh
+++ b/scripts/cli/commands-state.sh
@@ -194,6 +194,16 @@ case "$cmd" in
*) die "usage: mso $U_prefs" ;;
esac ;;
models) run_models "$@" ;;
+ jev)
+ case "${1:-status}" in
+ status) jget "/api/v1/jev" ;;
+ decide)
+ decision="${2:?decision id}"; state="$(json_arg "${3:-{}}")"
+ jpost "/api/v1/jev" "$(jq -nc --arg decision_id "$decision" --argjson state "$state" '{decision_id:$decision_id,state:$state}')" ;;
+ request)
+ jpost "/api/v1/jev" "$(json_arg "${2:?JSON or @file}")" ;;
+ *) die "usage: mso $U_jev" ;;
+ esac ;;
skills)
case "${1:-list}" in
list) jget "/api/skills" ;;
diff --git a/scripts/cli/commands.sh b/scripts/cli/commands.sh
index e084dd1c..543eb215 100755
--- a/scripts/cli/commands.sh
+++ b/scripts/cli/commands.sh
@@ -51,6 +51,7 @@ U_config="config show|set <json>|key <provider>|style <off|caveman|ponytail>|rm
U_prefs="prefs show|set <json>"
U_federation="federation status"
U_models="models [status|list|add|auth <provider>|rm <provider>|catalog [provider]|test]"
+U_jev="jev status|decide <model.route|failure.triage|recipe.promote> [JSON|@file]|request <JSON|@file>"
U_skills="skills list|read <id>|search <query…>|available|info <id>|install <id…> [-y] [--force]|remove <id…> [-y]|store list|store install|remove <id> <revision>"
U_mcp="mcp project <JSON>|list|pat <label> [read|write|exec] [ttlDays]|activity [n]|service-token --label <label> --client-id <id> --scope <read|write|exec> --tools <name,name> [--constraints-json <json>]|revoke <id>|revoke all"
U_oauth="oauth <provider> start|poll OAuth currently: openai (ChatGPT Codex)"
@@ -101,7 +102,7 @@ mso_cli_main() {
mso_cmd_host "$cmd" "$@" ;;
agent|chat|model|setup|onboard|provider|providers|integrations|channels|flow|workflow|gateway|web|camoufox|apps|mapp|term)
mso_cmd_runtime "$cmd" "$@" ;;
- ai|cockpit|threads|agent-sessions|agents|org|a2a|memory|memory-graph|config|prefs|federation|models|skills|changelog|stock)
+ ai|cockpit|threads|agent-sessions|agents|org|a2a|memory|memory-graph|config|prefs|federation|models|jev|skills|changelog|stock)
mso_cmd_state "$cmd" "$@" ;;
devices|device|approve|revoke|oauth|mcp|audit|whoami|login|logout|service|build|deploy|update|reset|uninstall|crud|api|completion)
mso_cmd_admin "$cmd" "$@" ;;