martty 0.2.11 → 0.2.14

package/README.md

@@ -25,6 +25,21 @@ The profile command is the recommended install and upgrade path. It creates a
 missing profile and installs the TUI plus its ACP dependency; no global
 `dsh-tui` installation is required.
 
+## Migrating from the scoped package
+
+`martty` is the recommended package name. Starting with `0.2.13`, it and the
+legacy `martty` package are published by the same CI run
+with identical versions and artifacts. Existing scoped-package installs remain
+supported. To switch package names:
+
+```sh
+dsh plugin --profile tui remove martty
+dsh plugin --profile tui add martty@latest
+```
+
+Only the package spec changes. The `dsh-tui` / `dsb` commands, `tui` profile,
+runtime behavior, config, and session data remain unchanged.
+
 The profile Host mounts the ACP plugin on Base, then starts a separate TUI
 Client process over standard ACP stdin/stdout. For standalone use, run
 `dsh-tui` and use `--agent <cmd>` plus repeated `--agent-arg <arg>` for another
@@ -38,6 +53,37 @@ retain both copies, but the TUI bundle replaces that surface's rows and mounts
 only the plugin resolved from TUI's own dependency graph. The supported profile
 shape never runs two ACP surfaces for one TUI.
 
+Foreign agent plugins use the same Host composition:
+
+```sh
+dsh plugin --profile tui add @openma/dsh-agents-plugins-bridge@latest
+```
+
+The [Agent Plugins Bridge](https://github.com/openma-ai/dsh-agents-plugins-bridge)
+projects imported commands and skills into TUI through ACP and keeps hooks,
+MCP, agents, monitors, and Pi extensions on the Host. Browser-only management,
+themes, and MCP Apps HTML rendering remain on the Web surface.
+
+## Headless owner
+
+`martty owner` keeps one real ACP Session and its Host plugin lifecycles alive
+without starting the Node compositor or Rust TUI. Lifecycle commands are
+repeatable, must be advertised by the Session, and run in order:
+
+```sh
+martty owner \
+  --agent dsh \
+  --agent-arg --profile \
+  --agent-arg telegram-owner \
+  --startup-command /telegram-connect \
+  --shutdown-command /telegram-disconnect
+```
+
+The client negotiates explicit `rpc` interaction mode. It does not auto-answer
+permissions, authentication, or extension forms; perform one-time interactive
+setup first and stop any existing owner of the same extension resource. Keep
+the process alive with a process supervisor for continuous operation.
+
 The package carries ACP as a runtime dependency and exports its Creator Host
 overlay internally. The profile bundle mounts both on the Host Base tree;
 neither enters the Client tree. Creator adds TUI plugin guidance to the
@@ -54,7 +100,8 @@ dsh-tui --demo
 dsh-tui --demo-skin
 ```
 
-`dsh-tui` is the primary command. `dsb` is a compatibility alias.
+`dsh-tui` is the interactive command. `martty` is the product alias for the
+same native program; `dsb` is a compatibility alias.
 
 ## Highlights
 
@@ -112,6 +159,9 @@ that you installed the latest version and that your platform appears above.
 npm uninstall --global martty
 ```
 
+Use `npm uninstall --global martty` instead for a legacy
+global installation.
+
 Source, screenshots, development commands, and architecture notes live in the
 [GitHub repository](https://github.com/openma-ai/Martty).
 

package/bin/dsh-tui.js

@@ -5,6 +5,7 @@ import path from 'node:path'
 import { spawnSync } from 'node:child_process'
 import { fileURLToPath } from 'node:url'
 import { bootClient, parseClientArgv, painterArgs } from '../lib/boot.js'
+import { runsNativeOwner } from '../lib/native-cli.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 const platformKey = process.platform + '-' + process.arch
@@ -21,6 +22,7 @@ const wantDemoSkin = argv.includes('--demo-skin')
 const wantDemo = argv.includes('--demo')
 const wantHelp = argv.includes('-h') || argv.includes('--help')
 const wantVersion = argv.includes('-V') || argv.includes('--version')
+const wantOwner = runsNativeOwner(argv)
 
 if (!fs.existsSync(binaryPath)) {
   let available = []
@@ -49,7 +51,7 @@ function exitFromSpawn(result) {
   )
 }
 
-if (wantHelp || wantVersion || wantDemo) {
+if (wantHelp || wantVersion || wantDemo || wantOwner) {
   exitFromSpawn(spawnSync(binaryPath, argv, { stdio: 'inherit' }))
 }
 

package/lib/native-cli.js

@@ -0,0 +1,4 @@
+/** Owner has no painter/client tree; the native binary owns ACP directly. */
+export function runsNativeOwner(argv) {
+  return argv[0] === 'owner'
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "martty",
-  "version": "0.2.11",
+  "version": "0.2.14",
   "description": "Terminal-native ACP client UI; Cordis client tree, any ACP agent",
   "license": "MIT",
   "repository": {
@@ -15,7 +15,7 @@
   "main": "lib/index.js",
   "scripts": {
     "pretest": "node --test ../scripts/workflow-release.test.mjs ../scripts/package-alias.test.mjs",
-    "test": "node --test ../scripts/package-native.test.mjs ../scripts/check-release-tag.test.mjs ../scripts/check-static-elf.test.mjs ../scripts/smoke-old-linux.test.mjs ../scripts/cargo-guard.test.mjs ../scripts/build-npm.test.mjs ../scripts/client-profile.test.mjs ../scripts/plugin-runner.test.mjs ../scripts/profile-link-resolution.test.mjs ../scripts/release.test.mjs ../scripts/jsonrpc-line-transport.test.mjs ../scripts/tui-theme.test.mjs ../scripts/tui-slots.test.mjs ../scripts/tui-commands.test.mjs ../scripts/tui-overlay.test.mjs ../scripts/mux.test.mjs ../scripts/acp-client.test.mjs ../scripts/acp-client-events.test.mjs ../scripts/acp-session-config.test.mjs ../scripts/acp-session-plan.test.mjs ../scripts/acp-session-stats.test.mjs ../scripts/plan-view.test.mjs ../scripts/stats-view.test.mjs ../scripts/runner.test.mjs ../scripts/inspect.test.mjs ../scripts/creator-overlay.test.mjs ../scripts/real-agent-e2e.test.mjs"
+    "test": "node --test ../scripts/owner-cli.test.mjs ../scripts/package-native.test.mjs ../scripts/check-release-tag.test.mjs ../scripts/check-static-elf.test.mjs ../scripts/smoke-old-linux.test.mjs ../scripts/cargo-guard.test.mjs ../scripts/build-npm.test.mjs ../scripts/client-profile.test.mjs ../scripts/plugin-runner.test.mjs ../scripts/profile-link-resolution.test.mjs ../scripts/release.test.mjs ../scripts/jsonrpc-line-transport.test.mjs ../scripts/tui-theme.test.mjs ../scripts/tui-slots.test.mjs ../scripts/tui-commands.test.mjs ../scripts/tui-overlay.test.mjs ../scripts/mux.test.mjs ../scripts/acp-client.test.mjs ../scripts/acp-client-events.test.mjs ../scripts/acp-session-config.test.mjs ../scripts/acp-session-plan.test.mjs ../scripts/acp-session-stats.test.mjs ../scripts/plan-view.test.mjs ../scripts/stats-view.test.mjs ../scripts/runner.test.mjs ../scripts/inspect.test.mjs ../scripts/creator-overlay.test.mjs ../scripts/real-agent-e2e.test.mjs"
   },
   "publishConfig": {
     "access": "public",
@@ -44,6 +44,7 @@
     "./package.json": "./package.json"
   },
   "bin": {
+    "martty": "bin/dsh-tui.js",
     "dsh-tui": "bin/dsh-tui.js",
     "dsb": "bin/dsh-tui.js"
   },
@@ -64,7 +65,7 @@
   },
   "dependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@openma/deepseek-harness-acp": "0.4.13"
+    "@openma/deepseek-harness-acp": "0.4.15"
   },
   "devDependencies": {
     "@deepseek-ai/dsh": "0.1.0-rc.6"