tinker-agent 2.13.0 → 3.0.0

package/CHANGELOG.md

@@ -5,6 +5,57 @@ All notable user-facing changes to Tinker are documented here. The project follo
 
 ## [Unreleased]
 
+## [3.0.0] - 2026-09-23
+
+### Changed
+
+- Make the default `tinker` TUI a client of a shared local service. Tasks belong
+  to the service and continue after the terminal exits or disconnects; use
+  `/resume` to reconnect to a running or completed session. The existing TUI
+  layout, editing, shortcuts, and interaction controls are preserved.
+- Automatically register local workspaces with the service. Multiple terminals
+  can use independent sessions or connect to the same session. Existing local
+  sessions are adopted only after their original process releases ownership.
+- Keep independent in-process execution available with `tinker --local` (also
+  required on Windows, where default local service startup is not supported).
+  One-shot `tinker run` remains independent. Default service/client configuration
+  is bootstrapped in the user's Tinker home; existing explicit configurations
+  remain supported. See `docs/remote-access.md` for configuration and migration.
+- Require services using the current installation to be stopped before
+  `tinker update` replaces package files. Use `tinker serve --stop`, update, then
+  `tinker serve --background`; system-managed services resume supervision.
+  Older services without the stop endpoint must be stopped explicitly before
+  switching to 3.0.0. Updates do not automatically interrupt active work.
+
+### Added
+
+- Connect the full TUI to service-side history, streaming output, tool state,
+  stop and follow-up input, user questions, command confirmations, provider
+  retries, images, context maintenance, undo, cloning, model selection, and
+  reasoning configuration. File completion and project commands use the server
+  workspace, and connection/task status appears in the existing bottom bar.
+- Support terminal and iOS handoff, reconnection, and durable request receipts
+  that prevent duplicate execution when a response is lost. Service restarts
+  mark unfinished work interrupted instead of replaying uncertain operations.
+- Add opt-in macOS LaunchAgent supervision through `tinker serve --install`,
+  with status, stop, restart, and uninstall commands. Supervision runs in the
+  user login session; it does not keep a sleeping Mac awake.
+- Load session runtimes on demand and reclaim disconnected idle runtimes while
+  preserving history, session settings, and ownership. Configurable resident
+  limits default to 16 loaded runtimes, 4 concurrent turns, 32 running or queued
+  turns, and a five-minute idle timeout. Active tasks and interactions are kept.
+- Drain work before stopping or restarting the service. The default 30-second
+  grace period cancels shutdown if work is still active; explicit `--force`
+  interrupts remaining work after that period.
+
+### Fixed
+
+- Preserve canonical history and pending interaction identity across client
+  disconnects, reject competing stale interaction responses, and prevent local
+  processes from taking over service-owned sessions during idle reclamation.
+- Synchronize background-process and attached-terminal tests with observable
+  readiness and cancellation rather than assuming immediate process/input setup.
+
 ## [2.13.0] - 2026-09-12
 
 ### Changed
@@ -493,7 +544,8 @@ All notable user-facing changes to Tinker are documented here. The project follo
 - First formal npm release under the `tinker-agent` package name with the `tinker`
   executable.
 
-[Unreleased]: https://github.com/ishowshao/tinker/compare/v2.13.0...HEAD
+[Unreleased]: https://github.com/ishowshao/tinker/compare/v3.0.0...HEAD
+[3.0.0]: https://github.com/ishowshao/tinker/releases/tag/v3.0.0
 [2.13.0]: https://github.com/ishowshao/tinker/releases/tag/v2.13.0
 [2.12.0]: https://github.com/ishowshao/tinker/releases/tag/v2.12.0
 [2.11.0]: https://github.com/ishowshao/tinker/releases/tag/v2.11.0

package/README.md

@@ -44,8 +44,8 @@ adds no conversation message and applies only to the current running process.
 Retryable failures include HTTP 429/500/502/503/504, structured `server_error`
 and `rate_limit_exceeded` errors inside provider streams or failed Responses,
 and transient connection failures, including socket resets during streaming.
-Tool failures and non-retryable errors keep their existing behavior. One-shot
-and remote service runs do not wait for this TUI selection.
+Tool failures and non-retryable errors keep their existing behavior. One-shot runs do not wait for this TUI selection; service sessions expose it to
+connected clients.
 
 ### PTY screen size
 
@@ -157,6 +157,17 @@ tinker --version
 The npm package includes its own Bun runtime. To run Tinker from a source checkout,
 install Bun 1.3.14 or later, then use `bun install` followed by `bun run tinker`.
 
+On macOS/Linux, the default TUI starts or reuses a shared local service. First
+launch uses OpenSSL to prepare private local credentials under
+`<home>/.tinker/service/` (`TINKER_HOME` or the OS home), and automatically registers
+the current workspace. Exiting the TUI leaves accepted tasks running; use
+`/resume` to reconnect. `tinker --local` explicitly runs the independent TUI;
+`run` remains independent. Existing `.data` service configurations remain available
+through explicit `connect`. See [local startup and configuration](docs/remote-access.md#default-local-service-entry)
+for configuration, environment changes and lifecycle limits. Optional macOS login
+startup and crash restart are available through `tinker serve --install`;
+`serve --stop`, `--restart` and `--uninstall` manage the resident service.
+
 `run` accepts exactly one Prompt source: one shell-quoted argument, explicit stdin,
 or a UTF-8 text file. Use stdin for multiline code, private patches, or Prompt text
 containing secrets so it does not become a command-line argument:
@@ -179,14 +190,24 @@ The installed package exposes this public CLI:
 <!-- BEGIN GENERATED: PUBLIC CLI COMMANDS -->
 | Command | Description |
 | --- | --- |
-| `tinker` | Start the interactive terminal interface. |
+| `tinker` | Start the full TUI through the shared local service; exiting detaches only. |
+| `tinker serve --install` | Install and start a macOS per-user LaunchAgent with crash restart. |
+| `tinker serve --uninstall` | Drain, stop and remove the LaunchAgent; retain history and configuration. |
+| `tinker serve --stop` | Drain and stop the service; disable supervisor restart until the next start. |
+| `tinker serve --restart` | Drain and restart with the current executable and configuration. |
+| `tinker serve --restart --force` | Allow interruption after the configured shutdown grace period. |
+| `tinker --local` | Run the TUI independently without a service (explicit fallback). |
 | `tinker --profile <profile-name>` | Start the TUI with a selected model profile. |
 | `tinker run [--profile <profile-name>] [--yolo] <prompt>` | Submit one shell-quoted prompt argument. |
 | `tinker run [--profile <profile-name>] [--yolo] --stdin` | Read the prompt from standard input until EOF. |
 | `tinker run [--profile <profile-name>] [--yolo] --file <path>` | Read the prompt from a UTF-8 text file. |
 | `tinker update` | Update the global npm installation from the official npm registry. |
-| `tinker serve --config <path>` | Run the local daemon for paired remote clients. |
+| `tinker serve [--config <path>]` | Run the local daemon for paired remote clients. |
+| `tinker serve [--config <path>] --background` | Discover or start one detached service for this state directory, and print its address as JSON. |
+| `tinker serve [--config <path>] --status` | Probe the local service without starting it; print JSON and exit 1 when offline. |
 | `tinker connect --config <path>` | Attach a terminal client to a service; exiting detaches only. |
+| `tinker connect --config <path> --tui [--workspace <id>] [--session <id>]` | Use the full TUI for service sessions and task execution. |
+| `tinker connect --config <path> --tui --service-config <path> [--session <id>]` | With --tui, discover/start this local service and register the current directory if needed. |
 | `tinker --help` | Show top-level CLI help. |
 | `tinker help run` | Show one-shot command help. |
 | `tinker help update` | Show update command help. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tinker-agent",
-  "version": "2.13.0",
+  "version": "3.0.0",
   "description": "A personal coding agent with an interactive TUI and one-shot CLI.",
   "license": "Apache-2.0",
   "type": "module",
@@ -14,6 +14,7 @@
     "CHANGELOG.md",
     "src/agent",
     "src/cli",
+    "src/client",
     "src/context",
     "src/events",
     "src/ids",