martty 0.2.13 → 0.2.14

package/README.md

@@ -53,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
@@ -69,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
 

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.13",
+  "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"