@phenx-inc/ctlsurf 0.14.1 → 0.15.0

package/README.md

@@ -0,0 +1,36 @@
+# ctlsurf worker
+
+The terminal that remembers. Run Claude Code, Codex, or any coding agent inside it, and everything about the session lands in your [ctlsurf](https://ctlsurf.com) project automatically: live transcript, time attribution, tickets, and an observer digest. The agent does not have to cooperate, or even know.
+
+```bash
+npx @phenx-inc/ctlsurf
+```
+
+Works as a desktop app (macOS, Windows) or fully headless on a server.
+
+## What you get
+
+- **A normal terminal.** Your agent runs in a managed PTY that behaves like the terminal you already use. Agent-agnostic by design: Claude Code today, Codex tomorrow, whatever ships next.
+- **Watch and drive it from anywhere.** The session streams live to your project at [app.ctlsurf.com](https://app.ctlsurf.com); open a browser on another machine to watch the agent work, and type back into the session remotely.
+- **Automatic time tracking.** Each session becomes rows in the project's time-tracking datastore. The billing report reads straight from it.
+- **Tickets from the terminal.** File a ticket without leaving the session; it lands on a cross-project board.
+- **The Observer.** A supervision layer that tails the agent's transcript and the terminal's activity into an append-only local ledger, producing findings and time spans, with a session-end digest written to your project. Advisory only: every code path is wrapped so observation can never block or slow the working agent.
+
+## Why outside-in recording
+
+ctlsurf's task completions make agents document their own work, with structure enforced by the API. The worker is the second witness: an independent record of what actually happened in the terminal, when, and for how long. When the two records agree, you have provenance you can defend to a client weeks later. When they disagree, you have found something worth looking at.
+
+The 42-second story: [youtu.be/Ey0Wc3HW_ww](https://youtu.be/Ey0Wc3HW_ww)
+
+## Quick start
+
+1. Create a free account at [app.ctlsurf.com](https://app.ctlsurf.com)
+2. `npx @phenx-inc/ctlsurf` in your project directory
+3. Pair with your account when prompted (one-time device code)
+4. Run your agent as usual; open your project in the browser to see the live session
+
+Docs: [ctlsurf.com/docs](https://ctlsurf.com/docs) · Free tier includes 1 connected worker; Pro includes 3.
+
+## Requirements
+
+Node.js 18+. A ctlsurf account (free tier works).

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,82 @@
+# Third-party notices
+
+ctlsurf is proprietary software (see `LICENSE`). This file records third-party
+material it incorporates, and the terms that material is offered under.
+
+---
+
+## Colour schemes
+
+ctlsurf ships several selectable colour schemes. For each, the palette values
+were transcribed from the upstream project's **published palette specification**
+and re-expressed as CSS custom properties in `src/renderer/styles.css` and as
+terminal/editor palettes in `src/renderer/lib/themes.ts`.
+
+No source code from any of these projects is included, copied, or derived from.
+Scheme names are used descriptively, to identify which published palette a
+theme reproduces. None of these projects endorses or is affiliated with ctlsurf.
+
+### Tokyo Night
+
+- Upstream: <https://github.com/enkia/tokyo-night-vscode-theme> (MIT),
+  <https://github.com/folke/tokyonight.nvim> (Apache-2.0)
+- Used by the `tokyo-night` and `tokyo-day` themes.
+
+```
+MIT License
+
+Copyright (c) 2019 enkia
+
+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.
+```
+
+### Catppuccin
+
+- Upstream: <https://github.com/catppuccin/catppuccin> (MIT)
+- Used by the `catppuccin-mocha` and `catppuccin-latte` themes.
+
+```
+MIT License
+
+Copyright (c) 2021 Catppuccin
+
+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.
+```
+
+---
+
+*The licence texts above reflect the upstream projects' stated terms as of
+2026-07-25. Copyright holders and years are reproduced as published upstream;
+re-verify before a release if the upstream terms have changed.*

package/out/headless/index.mjs

@@ -17314,7 +17314,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@phenx-inc/ctlsurf",
-      version: "0.14.1",
+      version: "0.15.0",
       description: "Agent-agnostic terminal and desktop app for ctlsurf \u2014 run Claude Code, Codex, or any coding agent with live session logging and remote control",
       main: "out/main/index.js",
       bin: {
@@ -17329,7 +17329,8 @@ var require_package = __commonJS({
         "src/",
         "package.json",
         "electron-vite.config.ts",
-        "tsconfig*.json"
+        "tsconfig*.json",
+        "THIRD-PARTY-NOTICES.md"
       ],
       scripts: {
         dev: "electron-vite dev",
@@ -17350,7 +17351,12 @@ var require_package = __commonJS({
         "codex",
         "electron",
         "node-pty",
-        "xterm"
+        "xterm",
+        "ai-agent",
+        "mcp",
+        "agent-observability",
+        "provenance",
+        "time-tracking"
       ],
       license: "SEE LICENSE IN LICENSE",
       engines: {
@@ -17388,6 +17394,10 @@ var require_package = __commonJS({
       optionalDependencies: {
         bufferutil: "^4.1.0",
         "utf-8-validate": "^6.0.6"
+      },
+      homepage: "https://ctlsurf.com",
+      bugs: {
+        email: "phenx@phenx.io"
       }
     };
   }