martty 0.2.18 → 0.2.20

package/README.md

@@ -1,11 +1,11 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/openma-ai/Martty/main/assets/tui-whale.svg" width="424" alt="DeepSeek Harness TUI whale" />
+  <img src="https://raw.githubusercontent.com/openma-ai/Martty/main/assets/martty-lockup.svg" width="650" alt="Martty terminal lockup" />
 </p>
 
-<h1 align="center">DeepSeek Harness TUI</h1>
+<h1 align="center">Martty</h1>
 
 <p align="center">
-  Terminal-native ACP client UI with a Cordis client plugin tree.
+  A DSH-first terminal with the same Cordis plugin model, plus support for other ACP agents.
 </p>
 
 ---
@@ -13,19 +13,39 @@
 Native binaries are packaged for macOS arm64, macOS x64, Linux x64, and Windows
 x64. Requires Node.js 18+.
 
+> **Rename note:** the project and recommended npm package have moved from
+> DeepSeek Harness TUI / `martty` to **Martty** / `martty`.
+> The `dsh-tui` command, configuration, and session data remain compatible.
+> The production profile is now `martty`; legacy `tui` profiles
+> continue to work.
+
+## Global Agent TUI
+
+```sh
+npm install --global martty
+martty
+```
+
+Martty directly depends on our `@openma/deepseek-harness-acp` implementation.
+It resolves this built-in ACP from its own dependency graph, connects DSH by
+default, and requires no separate ACP installation. For another ACP server,
+configure `DSH_TUI_AGENT`; Cordis embedding can instead provide `config.agent`
+or `config.stream`. `--agent` is only the standalone CLI override for the same
+connection configuration.
+
 ## Recommended
 
 ```sh
 npm install --global @deepseek-ai/dsh
-dsh plugin --profile tui add martty@latest
-dsh --profile tui
+dsh plugin --profile martty add martty@latest
+dsh --profile martty
 ```
 
 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.
+`martty` installation is required.
 
-## Migrating from the scoped package
+## Migrating from DeepSeek Harness TUI / 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
@@ -34,15 +54,16 @@ supported. To switch package names:
 
 ```sh
 dsh plugin --profile tui remove martty
-dsh plugin --profile tui add martty@latest
+dsh plugin --profile martty add martty@latest
 ```
 
-Only the package spec changes. The `dsh-tui` / `dsb` commands, `tui` profile,
-runtime behavior, config, and session data remain unchanged.
+The recommended profile changes from `tui` to `martty`; runtime behavior,
+config, and session data remain unchanged. `dsh-tui` and legacy `tui`
+profiles remain compatible.
 
 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
+`martty` and use `--agent <cmd>` plus repeated `--agent-arg <arg>` for another
 ACP server. The Node Client process owns a Cordis tree and starts the Rust painter. A sibling
 `tui-cordis-client-runner` publishes TUI Client capabilities and evaluates
 approved `code.client` packages from `dsh-tool-cordis` against that client tree.
@@ -79,11 +100,19 @@ agent traffic remains ACP.
 ## Demo
 
 ```sh
-dsh-tui --demo
-dsh-tui --demo-skin
+martty --demo
+martty --demo-skin
+```
+
+Without a global installation:
+
+```sh
+npx --yes martty --demo
 ```
 
-`dsh-tui` is the primary command. `dsb` is a compatibility alias.
+The profile path remains recommended for an existing DSH installation that
+wants standard plugin management and a durable `martty` profile. `martty` is the
+primary command; `dsh-tui` remains a compatibility alias.
 
 ## Highlights
 
@@ -122,18 +151,18 @@ absolute coordinates, compositor fds, or private transport methods.
 The versioned contract and examples live in the repository's
 [plugin API](https://github.com/openma-ai/Martty/blob/main/docs/plugins.en.md).
 
-The demo needs no API key or agent. Run `dsh-tui --help` for agent, model,
+The demo needs no API key or agent. Run `martty --help` for agent, model,
 credential, session, theme, and demo options.
 
 ## Supported platforms
 
 | Node platform key | Binary |
 |---|---|
-| `darwin-arm64` | `vendor/darwin-arm64/dsh-tui` |
-| `darwin-x64` | `vendor/darwin-x64/dsh-tui` |
-| `linux-x64` | `vendor/linux-x64/dsh-tui` |
-| `linux-arm64` | `vendor/linux-arm64/dsh-tui` |
-| `win32-x64` | `vendor/win32-x64/dsh-tui.exe` |
+| `darwin-arm64` | `vendor/darwin-arm64/martty` |
+| `darwin-x64` | `vendor/darwin-x64/martty` |
+| `linux-x64` | `vendor/linux-x64/martty` |
+| `linux-arm64` | `vendor/linux-arm64/martty` |
+| `win32-x64` | `vendor/win32-x64/martty.exe` |
 
 If installation succeeds but launch reports `no native binary for ...`, confirm
 that you installed the latest version and that your platform appears above.

package/bin/{dsh-tui.js → martty.js}

@@ -9,11 +9,13 @@ import { bootClient, parseClientArgv, painterArgs } from '../lib/boot.js'
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 const platformKey = process.platform + '-' + process.arch
 const vendorDir = path.join(__dirname, '..', 'vendor')
-const binaryName = process.platform === 'win32' ? 'dsh-tui.exe' : 'dsh-tui'
+const binaryName = process.platform === 'win32' ? 'martty.exe' : 'martty'
 const packaged = path.join(vendorDir, platformKey, binaryName)
-const envBin = process.env.DSH_TUI_BIN
-const binaryPath = typeof envBin === 'string' && envBin.length > 0 && fs.existsSync(envBin)
-  ? envBin
+const configuredBin = process.env.MARTTY_BIN || process.env.DSH_TUI_BIN
+const binaryPath = typeof configuredBin === 'string'
+  && configuredBin.length > 0
+  && fs.existsSync(configuredBin)
+  ? configuredBin
   : packaged
 
 const argv = process.argv.slice(2)
@@ -32,7 +34,7 @@ if (!fs.existsSync(binaryPath)) {
   } catch {
     // vendor dir missing entirely
   }
-  console.error('dsh-tui: no bundled binary for this platform (' + platformKey + ').')
+  console.error('martty: no bundled binary for this platform (' + platformKey + ').')
   if (available.length > 0) {
     console.error('Bundled platforms: ' + available.join(', '))
   } else {
@@ -54,7 +56,7 @@ if (wantHelp || wantVersion || wantDemo) {
 }
 
 if (wantDemoSkin) {
-  process.env.DSH_TUI_BIN ??= binaryPath
+  process.env.MARTTY_BIN ??= binaryPath
   const demoSkinPath = path.join(__dirname, '..', 'lib', 'demo-skin.js')
   const args = argv.filter((arg) => arg !== '--demo-skin')
   exitFromSpawn(spawnSync(process.execPath, [demoSkinPath, ...args], {
@@ -63,6 +65,6 @@ if (wantDemoSkin) {
   }))
 }
 
-process.env.DSH_TUI_BIN ??= binaryPath
+process.env.MARTTY_BIN ??= binaryPath
 const parsed = parseClientArgv(argv)
 await bootClient({ agent: parsed.agent, extraArgs: painterArgs(parsed) })

package/lib/agent.js

@@ -45,7 +45,7 @@ export function resolveStackedAgent(anchor = import.meta.url) {
     // Source checkouts may not have materialized the package dependencies.
   }
   const home = process.env.DSH_HOME ?? join(homedir(), '.dsh')
-  for (const profile of ['tui-test', 'tui']) {
+  for (const profile of ['tui-test', 'martty', 'tui']) {
     const bin = join(home, 'profiles', profile, 'node_modules', '.bin', 'dsh-acp')
     const creator = join(
       home,

package/lib/demo-skin.js

@@ -37,7 +37,7 @@ export async function runDemoSkin(argv = process.argv.slice(2)) {
   const theme = ctx.tuiTheme
   ctx.tuiTheme.activate('ember')
 
-  const bin = process.env.DSH_TUI_BIN || nativeBinary()
+  const bin = process.env.MARTTY_BIN || process.env.DSH_TUI_BIN || nativeBinary()
   const connection = await spawnPluginTui(bin, extraBinaryArgs(argv))
   const { child } = connection
   const transport = new JsonRpcLineTransport(connection.input, connection.output)
@@ -50,7 +50,7 @@ export async function runDemoSkin(argv = process.argv.slice(2)) {
   transport.onRequest(async (method) => {
     switch (method) {
       case 'initialize':
-        return { serverInfo: { name: 'dsh-tui-demo-skin', version } }
+        return { serverInfo: { name: 'martty-demo-skin', version } }
       case 'session/prompt':
         return { messageId: 'demo-skin' }
       case 'shutdown':
@@ -67,7 +67,7 @@ export async function runDemoSkin(argv = process.argv.slice(2)) {
     process.exit(code === null ? 0 : code)
   })
   child.on('error', (err) => {
-    console.error(`dsh-tui demo-skin failed: ${err.message}`)
+    console.error(`martty demo-skin failed: ${err.message}`)
     process.exit(1)
   })
 }

package/lib/spawn-tui.js

@@ -1,5 +1,5 @@
 /**
- * Spawn the platform-native `dsh-tui` binary for plugin / demo-skin attach.
+ * Spawn the platform-native `martty` binary for plugin / demo-skin attach.
  *
  * Unix extra fds: 3 = Node→TUI (Rust reads), 4 = TUI→Node (Rust writes).
  * Windows (and DSH_TUI_FORCE_TCP=1): authenticated loopback TCP.
@@ -26,13 +26,13 @@ export function selectNativeBinary({ envBin, devBin, packagedBin }) {
 
 /**
  * Packaged native binary for this platform, or throw if it was not staged.
- * Honors `DSH_TUI_BIN` when that path exists (source / cargo re-exec).
+ * Honors `MARTTY_BIN`, with `DSH_TUI_BIN` as a compatibility fallback.
  * @returns {string}
  */
 export function nativeBinary() {
-  const envBin = process.env.DSH_TUI_BIN
+  const envBin = process.env.MARTTY_BIN || process.env.DSH_TUI_BIN
   const key = `${process.platform}-${process.arch}`
-  const exe = process.platform === 'win32' ? 'dsh-tui.exe' : 'dsh-tui'
+  const exe = process.platform === 'win32' ? 'martty.exe' : 'martty'
   const bin = path.join(__dirname, '..', 'vendor', key, exe)
   const devBin = path.join(__dirname, '..', '..', 'target', 'debug', exe)
   const selected = selectNativeBinary({ envBin, devBin, packagedBin: bin })
@@ -90,7 +90,7 @@ export async function spawnPluginTui(bin, extraArgs = [], tty = {}) {
   const address = server.address()
   if (address === null || typeof address === 'string') {
     server.close()
-    throw new Error('dsh-tui runner failed to allocate a loopback TCP port')
+    throw new Error('martty runner failed to allocate a loopback TCP port')
   }
 
   const authenticated = waitForAuthenticatedSocket(server, token)
@@ -103,7 +103,7 @@ export async function spawnPluginTui(bin, extraArgs = [], tty = {}) {
   const childFailed = new Promise((_, reject) => {
     onChildError = reject
     onChildExit = (code, signal) => {
-      reject(new Error(`dsh-tui exited before connecting (code=${code}, signal=${signal})`))
+      reject(new Error(`martty exited before connecting (code=${code}, signal=${signal})`))
     }
     child.once('error', onChildError)
     child.once('exit', onChildExit)
@@ -129,7 +129,7 @@ function waitForAuthenticatedSocket(server, token) {
     const timeout = setTimeout(() => {
       cleanup()
       server.close()
-      reject(new Error('dsh-tui timed out connecting to the loopback transport'))
+      reject(new Error('martty timed out connecting to the loopback transport'))
     }, 10_000)
     timeout.unref?.()
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "martty",
-  "version": "0.2.18",
+  "version": "0.2.20",
   "description": "Terminal-native ACP client UI; Cordis client tree, any ACP agent",
   "license": "MIT",
   "repository": {
@@ -51,8 +51,8 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "dsh-tui": "bin/dsh-tui.js",
-    "dsb": "bin/dsh-tui.js"
+    "martty": "bin/martty.js",
+    "dsh-tui": "bin/martty.js"
   },
   "files": [
     "bin",
@@ -71,7 +71,7 @@
   },
   "dependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@openma/deepseek-harness-acp": "0.4.20"
+    "@openma/deepseek-harness-acp": "0.4.21"
   },
   "devDependencies": {
     "@deepseek-ai/dsh": "0.1.0-rc.6"