@ainecto/cli 0.12.1 → 0.13.0

package/README.md

@@ -192,6 +192,49 @@ The server tools behind them (`list_notifications`, `list_agent_todos`, `update_
 `list_history`) are generated commands too (`ainecto notifications list`, `ainecto agent-todos list`,
 `ainecto agent-todos update -f …`, `ainecto history list`) once the server exposes them.
 
+## Terminal Sessions
+
+`ainecto term` keeps terminal sessions running after you close the terminal window — no tmux or cmux
+needed. A background process, started on demand, owns each session and keeps its screen, so agents and
+scripts can type into a session and read its screen, and you can attach from any terminal app. It runs on
+this machine only; it does not use your AiNecto sign-in.
+
+```bash
+ainecto term new api --cwd ~/code/api -- claude   # start a session (without a command: your login shell)
+ainecto term ls [--json]
+ainecto term send api "run the tests"             # types the text, without Enter
+ainecto term key api enter                        # one key — see below
+ainecto term read api [--lines N] [--scrollback] [--json]
+ainecto term wait api --match 'passed' [--timeout 600]   # until a screen line matches (seconds)
+ainecto term attach api                           # detach with Ctrl-\ then d
+ainecto term kill api
+ainecto term kill-server                          # every session and the background process
+ainecto term restore                              # after a reboot: start again what was running
+```
+
+- Keys for `key`: `enter`, `tab`, `shift-tab`, `escape`, `backspace`, `delete`, `space`, `up`, `down`,
+  `left`, `right`, `home`, `end`, `pageup`, `pagedown`, `ctrl-a` … `ctrl-z` (`ctrl+c`, `esc` and `return`
+  are accepted too).
+- `send --paste` sends the text as a bracketed paste when the app asked for one. To send text that starts
+  with `-`, put it after `--`.
+- In `attach`, press `Ctrl-\` twice to send one `Ctrl-\` to the app.
+- Inside a session, `AINECTO_TERM_SESSION` holds its name. A name does not change; to rename, kill the
+  session and start it again.
+- `restore` starts again each session that was running (name, folder, command) with the environment of the
+  shell you run it from. It does not bring back what the programs had in memory, and nothing restarts on its
+  own after a reboot. A session that exits by itself is forgotten; `kill` and `kill-server` forget theirs.
+- Files are in `~/.ainecto/term/` (folder only you can read): the control socket, `sessions.json` (what
+  `restore` starts) and `daemon.log` (one line per request and one per answer; kept to 10 MB plus one older
+  file, `daemon.log.1`). Typed text, screens and environment values are not logged.
+- How long a command waits, three separate limits:
+  - Each request to the running background process waits up to 10 seconds for its answer; then the
+    command stops with an error and removes nothing.
+  - Starting the background process waits up to 10 seconds per try for it to report ready, at most 3 tries.
+  - `wait` itself waits until `--timeout` (without it, until the pattern appears or the session ends).
+- Platforms: macOS, and Linux with glibc on Node.js 20.8.0 or newer (the rest of the CLI runs on Node 18).
+  Not Windows yet. It uses the optional dependency `node-pty`, which ships prebuilt binaries — no compiler
+  needed. If it could not be installed, `ainecto term` says so and the other commands keep working.
+
 ## Connector Mode
 
 ```bash
@@ -211,7 +254,7 @@ This is the entry `setup --local` and `init --mcp --local` write — you normall
   "mcpServers": {
     "ainecto": {
       "command": "npx",
-      "args": ["-y", "@ainecto/mcp@0.12.1"]
+      "args": ["-y", "@ainecto/mcp@0.13.0"]
     }
   }
 }

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,68 @@
+# Third-Party Notices
+
+This package (published as `@ainecto/mcp`, `ainecto` and `@ainecto/cli` — the same build) includes third-party
+open-source software. The AiNecto CLI itself is not licensed under these terms; only the parts listed below are.
+
+## xterm.js
+
+- **Bundled** into `dist/bin/ainecto.js` (the `ainecto term` session daemon):
+  - `@xterm/headless` 6.0.0
+  - `@xterm/addon-serialize` 0.14.0
+- **Ported** into `src/core/term/vtParser.ts` (and built into `dist/bin/ainecto.js`): the VT500 transition table and
+  the OSC/DCS end rules of `EscapeSequenceParser` from xterm.js 6.0.0
+  (`src/common/parser/EscapeSequenceParser.ts`, `src/common/parser/Constants.ts`).
+- Source: https://github.com/xtermjs/xterm.js (tag `6.0.0`) · License: MIT
+
+```
+Copyright (c) 2017-2019, The xterm.js authors (https://github.com/xtermjs/xterm.js)
+Copyright (c) 2014-2016, SourceLair Private Company (https://www.sourcelair.com)
+Copyright (c) 2012-2013, Christopher Jeffrey (https://github.com/chjj/)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+```
+
+## Visual Studio Code — `base` helpers (included in xterm.js)
+
+- **Bundled** into `dist/bin/ainecto.js` as part of `@xterm/headless` 6.0.0, which includes helpers from the
+  `base/` module of Visual Studio Code (xterm.js `src/vs/base`).
+- Source: https://github.com/microsoft/vscode · License: MIT
+
+```
+MIT License
+
+Copyright (c) 2015 - present Microsoft Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```