npm - tabminal - Versions diffs - 2.0.16 → 2.0.18 - Mend

tabminal 2.0.16 → 2.0.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/ACP_PLANING.md CHANGED Viewed

@@ -1,184 +1,271 @@
-# ACP Planing
+# ACP Planning
-## Goal
+Last updated: 2026-03-27
-Integrate ACP-based coding agents into Tabminal without implementing agents
-ourselves. Agents run on the Tabminal host, managed by the Tabminal backend.
-The web UI adds an Agent panel integrated into the existing workspace/editor
-area and supports multiple concurrent agent tabs per host.
+This file is no longer a pure implementation plan.
+It is now the ACP status ledger for Tabminal:
-## Constraints
+- what shipped
+- what is stable
+- what remains open
-- Do not break existing terminal, file editor, multi-host, or AI-assist flows.
-- Reuse community-maintained protocol and agent ecosystem pieces where
-  practical.
-- Keep lifecycle bounded: lazy start, reusable while tabs are open, and
-  cleaned up after inactivity.
-- Host isolation remains strict: each agent runtime and tab belongs to one
-  host.
-- MVP should be usable before advanced ACP capabilities are added.
+Use `/Users/leask/Documents/Tabminal/AGENTS.md` as the broader engineering
+handoff document. Use this file as the ACP-specific roadmap/status snapshot.
-## Selected Architecture
+## 1) Goal
+Integrate ACP-based coding agents into Tabminal without building custom agents
+in-repo. Agents should run on the Tabminal host, be managed by the Tabminal
+backend, and feel native inside the existing workspace/editor UI.
+## 2) Current Architecture
 ### Backend
-Add an ACP supervisor inside the Tabminal backend.
+Implemented:
+- ACP supervisor in `/Users/leask/Documents/Tabminal/src/acp-manager.mjs`
+- Built-in host-local agent definitions:
+  - Gemini CLI
+  - Codex CLI
+  - Claude Agent
+  - GitHub Copilot
+  - ACP Test Agent when `TABMINAL_ENABLE_TEST_AGENT=1`
+- Lazy runtime startup
+- Runtime reuse while tabs are active
+- Idle cleanup
+- ACP websocket fan-out to browser clients
+- Session restore for ACP runtimes that support `loadSession`
+- Per-agent saved config/env persistence
-Responsibilities:
-- List supported agent definitions available on the host.
-- Start ACP runtimes on demand.
-- Reuse ACP runtime processes while tabs/sessions are active.
-- Create ACP sessions within a runtime.
-- Bridge ACP events to browser clients over a dedicated WebSocket.
-- Expose minimal approval surfaces later; MVP focuses on prompt/stream/cancel.
+### Frontend
-Transport strategy:
-- Primary: stdio-launched ACP agents.
-- Future: attach to TCP ACP servers for tools like GitHub Copilot CLI.
+Implemented:
-Lifecycle:
-- Lazy runtime start on first use.
-- Keep alive while any agent tab is attached.
-- Idle timeout after last tab closes.
-- Destroy all runtimes on backend shutdown.
+- Host-scoped agent dropdown from the sidebar
+- Agent tabs inside the shared workspace tab strip
+- Transcript rendering with message/tool/permission/plan history
+- Composer with send/stop, slash-command suggestions, attachments, and keyboard
+  shortcuts
+- Mode/model/thought-level/permission selectors
+- Managed terminal summaries and `Jump in`
+- Usage HUD
+- Plan panel that archives into transcript history once complete
+- Agent-specific workspace restore and focus behavior
-### Frontend
+## 3) Completed Scope
-Add a host-scoped Agent button beside the file editor toggle area.
-Behavior:
-- Clicking Agent opens a dropdown of available agents for the active host.
-- Choosing an agent opens a new Agent tab inside the existing editor pane tab
-  strip.
-- Agent tabs coexist with file tabs.
-- Each agent tab streams conversation updates and supports prompt send/cancel.
-MVP UI:
-- Agent tabs render in the editor workspace.
-- Transcript area with coalesced message stream.
-- Prompt textarea + single send/stop button.
-- Mode picker, new chat action, and slash-command chips when available.
-- Status row with host, cwd, mode, and runtime/session status.
-## Reuse Strategy
-Use:
-- `@agentclientprotocol/sdk` for protocol/client implementation.
-- ACP Registry later for agent metadata discovery.
-Do not directly embed:
-- Chrome ACP web client.
-- ACP UI desktop frontend.
-Reason:
-- They are standalone apps, not embeddable widgets.
-- Tabminal needs native integration with existing host/session/workspace state.
-## MVP Scope
-### Phase 1
-Status:
-- Implemented on `acp` branch and usable with real browser smoke.
-- Backend ACP supervisor, API, and WS fan-out are live.
-- Frontend agent tabs, transcript rendering, prompt send/cancel, and
-  permission resolution are live.
-- Agent tab metadata now persists on the backend and restores across backend
-  restart for ACP runtimes that support `loadSession`.
-- Agent panel interaction polish is live:
-  - duplicate agent tabs auto-number as `#1`, `#2`, ...
-  - `Enter` sends
-  - `Esc` stops active runs
-  - `Ctrl+J` and `Shift+Enter` insert newlines
-  - mode switching and new-chat flows are available in-panel
-  - tool calls and permission requests render as structured cards
-- Verified with:
-  - `npm run lint`
-  - `npm test`
-  - browser smoke against isolated local ACP test agent
-  - browser restart-restore validation against backend-persisted ACP tabs
-- Current polish fixes already applied:
-  - Codex token stream is coalesced into a single assistant message instead of
-    one message per chunk.
-  - User prompts are no longer duplicated when an ACP runtime echoes
-    `user_message_chunk` updates after local optimistic insertion.
-  - Gemini definition availability is disabled with reason
-    `API key missing` when no key is configured.
-  - Agent panel typography has been reduced to align with the existing
-    workspace/editor density.
-Backend:
-- ACP supervisor module.
-- Built-in agent definitions for Gemini CLI, Codex CLI adapter, Claude adapter,
-  and Copilot CLI ACP server descriptor.
-- REST endpoints:
+The following items are effectively shipped and usable.
+### 3.1 Core ACP plumbing
+- ACP dependency integrated
+- Backend ACP supervisor live
+- REST endpoints live:
   - `GET /api/agents`
+  - `GET /api/agents/config`
+  - `PUT /api/agents/config/:agentId`
+  - `DELETE /api/agents/config/:agentId`
   - `POST /api/agents/tabs`
   - `POST /api/agents/tabs/:tabId/prompt`
   - `POST /api/agents/tabs/:tabId/cancel`
   - `POST /api/agents/tabs/:tabId/mode`
+  - `POST /api/agents/tabs/:tabId/config`
   - `POST /api/agents/tabs/:tabId/permissions/:permissionId`
   - `DELETE /api/agents/tabs/:tabId`
-- WebSocket endpoint for live event fan-out.
-Frontend:
-- Agent dropdown button.
-- Agent tab state model.
-- Agent transcript rendering.
-- Prompt send/stop.
-- Mode picker.
-- New chat action.
-- Slash-command starter chips.
-- Structured tool call / permission cards.
-- Host-scoped tabs in editor pane.
-### Deferred
-- File attachments.
-- Rich diff/resource rendering in tool outputs.
-- Terminal execution transcript UI for ACP tool calls.
-- Registry-driven install UX.
-- TCP ACP runtime support in UI.
-- Dedicated conversation history browser independent of terminal sessions.
-## Safety and Isolation
-- Agent runtimes inherit the host filesystem context, not browser-local state.
-- Prompt and transcript data stay isolated per host.
-- Closing an agent tab detaches from its ACP session.
-- When the last ACP session on a runtime closes, runtime enters idle cleanup.
-## Test Plan
-Backend:
-- Unit tests for supervisor lifecycle.
-- Mock ACP runtime process to test stream/cancel behavior.
-- API tests for create/send/cancel/close.
-Frontend:
-- State/unit tests are minimal in current stack; use integration smoke.
-- Manual flow:
-  - open agent dropdown
-  - create Gemini/Codex tab
-  - send prompt
-  - receive stream
-  - cancel
-  - open second agent tab
-  - verify file editor tabs still work
-  - verify terminal tabs still work
-Regression checks:
+- ACP websocket endpoint live
+### 3.2 Agent tab UX
+- Agent tabs coexist with file tabs and pinned terminal tabs
+- Duplicate agent tabs auto-number
+- `Enter` sends
+- `Shift+Enter` and `Ctrl+J` insert newline
+- `Esc` stops active runs
+- `Ctrl+Shift+A` opens the agent menu
+- Slash-command menu opens upward as floating overlay
+- Keyboard navigation inside slash-command menu is implemented
+### 3.3 Transcript and tool rendering
+- Coalesced assistant message streaming
+- Optimistic user message insertion
+- De-duplication when runtime echoes user chunks
+- Structured tool-call cards
+- Structured permission cards
+- Diff rendering
+- Code/resource rendering
+- Terminal output rendering inside tool cards
+- Path link rendering
+- Running-terminal activity summary
+### 3.4 Managed terminal flow
+- ACP tool calls can create managed terminal sessions
+- `Jump in` switches to the real terminal session when still alive
+- Focus-stealing bug after `Jump in` has been fixed
+- Hidden pinned terminals no longer report bogus tiny sizes to the backend
+### 3.5 Persistence and restore
+- Agent tab metadata persists on backend
+- Agent config persists on backend
+- Transcript/tool/permission/plan state persists
+- Restore works across backend restart for runtimes that support `loadSession`
+- Restore no longer wrongly penalizes built-in agent availability on startup
+### 3.6 Usage / status UI
+- Usage HUD implemented
+- CSS-only expanded HUD layout stabilized
+- Plan panel implemented
+- Completed plan moves into transcript history instead of permanently occupying
+  composer-adjacent UI
+- Transcript auto-scroll logic now follows the correct “only pin if already at
+  bottom” rule
+### 3.7 Test tooling
+- ACP Test Agent supports real slash-command scenarios:
+  - `/demo`
+  - `/plan`
+  - `/diff`
+  - `/permission`
+  - `/cancel`
+  - `/stale`
+  - `/order`
+  - `/fail`
+- ACP browser smoke covers current UI shape
+- ACP manager tests cover restore, prompt attachments, config, availability, and
+  slash commands
+## 4) Stable Contracts
+These should now be treated as product contracts, not experiments.
+- ACP agents are host-scoped.
+- Agent tabs do not require the file tree to be open.
+- Workspace tabs should remain visible if there is any file tab, agent tab, or
+  pinned terminal tab.
+- `Jump in` is a management path, not a read-only preview, while the terminal is
+  still alive.
+- Internal shell bootstrap commands such as `TABMINAL_SHELL_READY=1` must never
+  surface as user notifications.
+- ACP availability should reflect the backend runtime environment, not only the
+  developer's interactive shell.
+- On small screens, agent config selectors collapse to icon-only affordances.
+## 5) Remaining Work
+This is the actual remaining ACP backlog.
+### 5.1 Still open
+#### A) Registry-driven install/setup UX
+Status: not done
+Missing:
+- guided install flow for agents that are unavailable
+- first-class setup UX for installing required CLIs
+- richer host diagnostics for why a definition is unavailable
+Current state:
+- availability reasons are shown
+- some config/setup flows exist
+- but this is not yet a complete install-onboarding UX
+#### B) Explicit TCP ACP runtime support in the UI
+Status: not done
+Missing:
+- user-visible workflow for attaching to TCP ACP servers
+- transport selection UX
+- connection lifecycle UX for non-stdio ACP runtimes
+Current state:
+- architecture originally allowed for this direction
+- product currently operates around stdio-launched/local CLI definitions
+#### C) Dedicated conversation history browser
+Status: not done
+Missing:
+- independent history browser for ACP conversations
+- browsing/searching old conversations outside the current terminal/workspace
+  session context
+Current state:
+- transcript restores with the tab
+- completed plans archive into the transcript
+- but there is no standalone conversation history surface
+### 5.2 Nice-to-have follow-up work
+These are not blockers, but they are logical next ACP improvements.
+- stronger browser smoke coverage for touch/mobile-only ACP interactions
+- clearer visual distinction between running, attention, and completed agent
+  states at scale
+- broader multi-host ACP smoke scenarios
+- richer availability/setup diagnostics in the UI
+## 6) What Was Originally Deferred But Is Now Done
+These items were previously listed as deferred and should no longer be treated
+as open backlog:
+- prompt/file attachments
+- diff rendering in tool outputs
+- code/resource rendering in tool outputs
+- terminal execution transcript UI for ACP tool calls
+## 7) Test and Verification Status
+Current ACP verification surface:
 - `npm run lint`
 - `npm test`
-- existing multi-host session behavior
-- editor pane switching between file tabs and agent tabs
-## Implementation Order
-1. Add ACP dependency and inspect exact SDK client API.
-2. Implement backend supervisor with a mockable adapter layer.
-3. Expose API/WS endpoints with no frontend integration yet.
-4. Add frontend Agent button and agent tab model.
-5. Wire prompt streaming and cancellation.
-6. Run tests and manual smoke.
-7. Iterate on lifecycle and UI fit.
+- `npm run build`
+- browser smoke via
+  `/Users/leask/Documents/Tabminal/scripts/acp-browser-smoke.mjs`
+Recommended ACP manual spot-checks when behavior changes:
+1. Start with `TABMINAL_ENABLE_TEST_AGENT=1`
+2. Run `/demo`
+3. Verify:
+   - agent menu
+   - slash-command menu
+   - plan panel
+   - usage HUD
+   - tool call cards
+   - managed terminal
+   - `Jump in`
+   - transcript scroll behavior
+4. Run `/permission`
+5. Run `/cancel`
+6. Reload and verify restore
+## 8) Recommendation
+ACP is no longer in “MVP not landed” status.
+It is in “shipped, actively polished, with a short remaining backlog” status.
+Practical summary:
+- Core ACP product: done
+- ACP UI polish: largely done
+- ACP infra/test surface: done
+- Remaining strategic work: 3 real items
+That remaining scope is small enough that this file should stay as a status
+ledger, not a large speculative design doc.

package/AGENTS.md CHANGED Viewed

@@ -10,14 +10,14 @@ ACP agent UX, or mobile ergonomics.
 ## 1) Project Snapshot
 - Runtime: Node.js `>= 22`, ESM project.
-- Backend entry: `/Users/leask/Documents/Tabminal/src/server.mjs`
-- Frontend entry: `/Users/leask/Documents/Tabminal/public/app.js`
+- Backend entry: `src/server.mjs`
+- Frontend entry: `public/app.js`
 - PWA shell:
-  - `/Users/leask/Documents/Tabminal/public/index.html`
-  - `/Users/leask/Documents/Tabminal/public/sw.js`
+  - `public/index.html`
+  - `public/sw.js`
 - Native app workspace:
-  - `/Users/leask/Documents/Tabminal/apps/Apple`
-  - `/Users/leask/Documents/Tabminal/apps/ghostty-vendor`
+  - `apps/Apple`
+  - `apps/ghostty-vendor`
 Current product shape:
@@ -46,8 +46,8 @@ Important persistence files under `~/.tabminal`:
 - Do not merge runtime state across hosts.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
-- `/Users/leask/Documents/Tabminal/public/modules/session-meta.js`
+- `public/app.js`
+- `public/modules/session-meta.js`
 ### 2.2 Auth model
@@ -57,7 +57,7 @@ Relevant code:
 - Sub-hosts may require Cloudflare Access login without password change.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
+- `public/app.js`
   - `ServerClient.handleUnauthorized`
   - `ServerClient.handleAccessRedirect`
@@ -72,8 +72,8 @@ Relevant code:
 - Removing a host should also remove any stale local token keyed to that host.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
-- `/Users/leask/Documents/Tabminal/src/persistence.mjs`
+- `public/app.js`
+- `src/persistence.mjs`
 ### 2.4 Host registry persistence
@@ -84,9 +84,9 @@ Relevant code:
 - On page load, host list restores only after main-host auth succeeds.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
-- `/Users/leask/Documents/Tabminal/src/server.mjs`
-- `/Users/leask/Documents/Tabminal/src/persistence.mjs`
+- `public/app.js`
+- `src/server.mjs`
+- `src/persistence.mjs`
 ### 2.5 Deduplication and self-host skip
@@ -98,8 +98,8 @@ Relevant code:
   the current client assumptions.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/modules/url-auth.js`
-- `/Users/leask/Documents/Tabminal/public/app.js`
+- `public/modules/url-auth.js`
+- `public/app.js`
 ### 2.6 Session creation ownership
@@ -109,8 +109,8 @@ Relevant code:
   - recreate one main-host session if user closes the last session
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
-- `/Users/leask/Documents/Tabminal/src/server.mjs`
+- `public/app.js`
+- `src/server.mjs`
 ### 2.7 Polling and heartbeat
@@ -119,7 +119,7 @@ Relevant code:
 - Do not weaken these without measuring UX fallout.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
+- `public/app.js`
 ### 2.8 Cloudflare Access handling
@@ -130,8 +130,8 @@ Relevant code:
 - Reconnect UI may open the host root in a new tab for Access login.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
-- `/Users/leask/Documents/Tabminal/public/modules/url-auth.js`
+- `public/app.js`
+- `public/modules/url-auth.js`
 ### 2.9 Runtime version and PWA coherence
@@ -141,10 +141,10 @@ Relevant code:
 - Service worker is versioned the same way.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/src/server.mjs`
-- `/Users/leask/Documents/Tabminal/public/app.js`
-- `/Users/leask/Documents/Tabminal/public/index.html`
-- `/Users/leask/Documents/Tabminal/public/sw.js`
+- `src/server.mjs`
+- `public/app.js`
+- `public/index.html`
+- `public/sw.js`
 ## 3) ACP Design Contracts
@@ -161,8 +161,8 @@ Relevant code:
   - ACP Test Agent when `TABMINAL_ENABLE_TEST_AGENT=1`
 Relevant code:
-- `/Users/leask/Documents/Tabminal/src/acp-manager.mjs`
-- `/Users/leask/Documents/Tabminal/src/acp-test-agent.mjs`
+- `src/acp-manager.mjs`
+- `src/acp-test-agent.mjs`
 ### 3.2 ACP workspace model
@@ -174,8 +174,8 @@ Relevant code:
   tab, or pinned terminal tab.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
-- `/Users/leask/Documents/Tabminal/public/styles.css`
+- `public/app.js`
+- `public/styles.css`
 ### 3.3 Agent dropdown and toggle behavior
@@ -195,7 +195,7 @@ Relevant code:
 - Agent sync must never steal focus back from a session the user jumped into.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
+- `public/app.js`
 ### 3.5 Hidden terminal resize contract
@@ -206,7 +206,7 @@ Relevant code:
 - This prevents broken sidebar previews caused by tiny hidden-layout sizes.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
+- `public/app.js`
 ### 3.6 Shell ready noise filtering
@@ -214,9 +214,9 @@ Relevant code:
 - They must not produce user notifications or visible execution-completed noise.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/shell/tabminal-bashrc`
-- `/Users/leask/Documents/Tabminal/src/terminal-session.mjs`
-- `/Users/leask/Documents/Tabminal/public/app.js`
+- `shell/tabminal-bashrc`
+- `src/terminal-session.mjs`
+- `public/app.js`
 ### 3.7 Agent plan behavior
@@ -236,7 +236,7 @@ Relevant code:
   back down.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
+- `public/app.js`
 ### 3.9 Slash command menu contract
@@ -247,9 +247,9 @@ Relevant code:
 - Current shortcut to open agent menu is `Ctrl+Shift+A`.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/app.js`
-- `/Users/leask/Documents/Tabminal/public/styles.css`
-- `/Users/leask/Documents/Tabminal/public/index.html`
+- `public/app.js`
+- `public/styles.css`
+- `public/index.html`
 ### 3.10 Usage HUD contract
@@ -261,12 +261,12 @@ Relevant code:
   updates.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/public/styles.css`
-- `/Users/leask/Documents/Tabminal/public/app.js`
+- `public/styles.css`
+- `public/app.js`
 ## 4) ACP Status and Remaining Gaps
-`/Users/leask/Documents/Tabminal/ACP_PLANING.md` is partly stale.
+`ACP_PLANING.md` is partly stale.
 Implemented from that plan:
@@ -297,39 +297,39 @@ Implication:
 ## 5) File Map for Fast Onboarding
 Backend:
-- `/Users/leask/Documents/Tabminal/src/server.mjs`
+- `src/server.mjs`
   - API routes, WS upgrade, auth, runtime boot id
-- `/Users/leask/Documents/Tabminal/src/config.mjs`
+- `src/config.mjs`
   - merged config parser and validation
-- `/Users/leask/Documents/Tabminal/src/auth.mjs`
+- `src/auth.mjs`
   - password hashing and auth checks
-- `/Users/leask/Documents/Tabminal/src/persistence.mjs`
+- `src/persistence.mjs`
   - sessions, cluster registry, ACP tab/config persistence
-- `/Users/leask/Documents/Tabminal/src/terminal-manager.mjs`
+- `src/terminal-manager.mjs`
   - PTY lifecycle and persistence
-- `/Users/leask/Documents/Tabminal/src/terminal-session.mjs`
+- `src/terminal-session.mjs`
   - terminal stream parsing, shell AI path, execution model
-- `/Users/leask/Documents/Tabminal/src/acp-manager.mjs`
+- `src/acp-manager.mjs`
   - ACP definitions, runtime supervision, ACP tab lifecycle
-- `/Users/leask/Documents/Tabminal/src/acp-test-agent.mjs`
+- `src/acp-test-agent.mjs`
   - local ACP smoke agent with slash-command fixtures
 Frontend:
-- `/Users/leask/Documents/Tabminal/public/app.js`
+- `public/app.js`
   - nearly all UI orchestration lives here
-- `/Users/leask/Documents/Tabminal/public/modules/url-auth.js`
+- `public/modules/url-auth.js`
   - URL normalization and auth helpers
-- `/Users/leask/Documents/Tabminal/public/modules/session-meta.js`
+- `public/modules/session-meta.js`
   - host display and compact path formatting
-- `/Users/leask/Documents/Tabminal/public/styles.css`
+- `public/styles.css`
   - all current UI contracts and responsive rules
-- `/Users/leask/Documents/Tabminal/public/index.html`
+- `public/index.html`
   - shell DOM, layout bootstrapping, shortcuts modal
 Tests and smoke:
-- `/Users/leask/Documents/Tabminal/test/acp-manager.mjs`
+- `test/acp-manager.mjs`
   - richest ACP coverage
-- `/Users/leask/Documents/Tabminal/scripts/acp-browser-smoke.mjs`
+- `scripts/acp-browser-smoke.mjs`
   - browser ACP smoke against a real running app and real Chrome remote debug
 ## 6) Debug and Testing Guidance
@@ -367,7 +367,7 @@ Use these instead of inventing ad-hoc prompts when validating ACP UI.
 Preferred browser smoke:
-- `/Users/leask/Documents/Tabminal/scripts/acp-browser-smoke.mjs`
+- `scripts/acp-browser-smoke.mjs`
 It supports:
@@ -394,7 +394,7 @@ If an ACP agent appears inconsistently available:
 - Restore failures should not temporarily mark built-in definitions unavailable.
 Relevant code:
-- `/Users/leask/Documents/Tabminal/src/acp-manager.mjs`
+- `src/acp-manager.mjs`
 ### 6.5 Focus and session-debug tips
@@ -455,7 +455,7 @@ Expected behavior:
 ## 9) Deployment and Ops Notes
 - Local helper script:
-  - `/Users/leask/Documents/Tabminal/reploy.sh`
+  - `reploy.sh`
 - It restarts one macOS launchctl node plus several Linux `pm2` nodes via SSH.
 - It includes aggressive cleanup behavior on Linux nodes; use carefully.

package/README.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # `t>` Tabminal
-> **Tab(ter)minal, a Cloud-Native terminal and ACP agent workspace for desktop, tablet, and phone.
+> `Tab(ter)minal`, a Cloud-Native terminal and ACP agent workspace for desktop, tablet, and phone.
 `Tabminal` combines persistent server-side terminal sessions, a built-in
 workspace, multi-host access, and Agent Client Protocol (ACP) integrations in
@@ -267,8 +267,8 @@ reliable.
 ## Architecture Snapshot
-- Backend: `Node.js`, [`utilitas`](https://github.com/leask/utilitas), `Koa`, `node-pty`, `WebSocket`, `ACP SDK`
-- Frontend: [`Vanilla JS 😝`](http://vanilla-js.com/), `xterm.js`, `Monaco Editor`
+- Backend: [`Node.js`](https://nodejs.org/), [`utilitas`](https://github.com/leask/utilitas), [`Koa`](https://github.com/koajs/koa), [`node-pty`](https://github.com/Tyriar/node-pty), [`WebSocket`](https://github.com/websockets/ws), [`ACP SDK`](https://github.com/acp-kit/acp-sdk)
+- Frontend: [`Vanilla JS 😝`](http://vanilla-js.com/), [`xterm.js`](https://github.com/xtermjs/xterm.js), [`Monaco Editor`](https://github.com/microsoft/monaco-editor)
 - Persistence: host-local files under `~/.tabminal`
 - Native clients and packaging work live under:
   - `apps/Apple`

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "tabminal",
-  "version": "2.0.16",
+  "version": "2.0.18",
   "description": "A modern, persistent web terminal with multi-tab support and real-time system monitoring.",
   "type": "module",
   "bin": {