@kcisoul/remotecode 0.9.1

package/README.md

@@ -0,0 +1,358 @@
+# RemoteCode
+
+Control [Claude Code](https://docs.anthropic.com/en/docs/claude-code) remotely through Telegram. Built specifically for Claude Code.
+
+RemoteCode works directly with your local Claude Code -- same sessions, same project context, same history. Pick up where you left off in the terminal, switch projects, or start a new session, all from Telegram.
+
+```
+You (Anywhere)  <-->  RemoteCode (Host)  <-->  Claude Code (Host)
+```
+
+## Features
+
+- **Text chat** -- Send any message, get Claude Code responses with Markdown formatting
+- **Image analysis** -- Send photos or image documents, optionally with a caption prompt
+- **Voice messages** -- Transcribed locally via whisper-cli (offline, free), then sent to Claude Code
+- **Session management** -- Multiple sessions, switch between them, browse by project
+- **Auto-sync** -- Watch active session files and forward new messages in real-time
+- **Background daemon** -- Runs as a detached process with log rotation
+- **User access control** -- Restrict access by Telegram user ID or username
+
+## How It Works
+
+```mermaid
+sequenceDiagram
+    participant U as You (Telegram)
+    participant T as Telegram API
+    participant D as RemoteCode Daemon
+    participant C as Claude Code CLI
+
+    U->>T: Send message
+    T->>D: Long polling (getUpdates)
+    D->>D: Auth check & route
+
+    alt Text message
+        D->>C: claude --resume <session> --print "prompt"
+    else Image
+        D->>T: Download file
+        D->>C: claude --resume <session> --print "prompt + image path"
+    else Voice
+        D->>T: Download audio
+        D->>D: ffmpeg + whisper-cli transcription
+        D->>C: claude --resume <session> --print "transcription"
+    end
+
+    C-->>D: stdout response
+    D->>D: Markdown → Telegram HTML
+    D->>T: sendMessage (HTML)
+    T-->>U: Formatted response
+```
+
+## Architecture
+
+```mermaid
+graph TB
+    subgraph CLI["CLI (Terminal)"]
+        IDX[index.ts<br/>arg parser]
+        CL[cli.ts<br/>subcommands]
+    end
+
+    subgraph Daemon["Daemon Process"]
+        DAE[daemon.ts<br/>poll loop + PID]
+        HND[handler.ts<br/>message router]
+        CMD[commands.ts<br/>slash commands]
+        CB[callbacks.ts<br/>inline buttons]
+        WAT[watcher.ts<br/>auto-sync]
+    end
+
+    subgraph Core["Core"]
+        TEL[telegram.ts<br/>API client]
+        CLA[claude.ts<br/>CLI spawner]
+        SES[sessions.ts<br/>discovery + state]
+        SUI[session-ui.ts<br/>UI formatting]
+    end
+
+    subgraph Shared["Shared"]
+        CFG[config.ts<br/>paths + KV I/O]
+        LOG[logger.ts<br/>logging]
+        BAN[banner.ts<br/>terminal UI]
+        CTX[context.ts<br/>auth + locks]
+        FMT[format.ts<br/>MD → HTML]
+    end
+
+    IDX --> DAE
+    IDX --> CL
+    CL --> DAE
+    DAE --> HND
+    DAE --> CB
+    HND --> CMD
+    HND --> CLA
+    HND --> CTX
+    CB --> SES
+    CB --> SUI
+    CMD --> SUI
+    WAT --> SES
+    WAT --> CTX
+    CLA --> LOG
+    TEL --> LOG
+    SUI --> FMT
+    CL --> BAN
+```
+
+## Quick Start
+
+### Prerequisites
+
+- **Node.js** >= 18
+- **Claude Code CLI** installed and authenticated (`claude` command available)
+- **Telegram Bot Token** -- create a bot via [@BotFather](https://t.me/BotFather) on Telegram (send `/newbot`, follow the prompts, copy the token). See [Telegram's official guide](https://core.telegram.org/bots/tutorial#obtain-your-bot-token) for details
+
+### Install
+
+```bash
+npm install -g @kcisoul/remotecode
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/kcisoul/remotecode.git
+cd remotecode
+npm install && npm run build
+npm link
+```
+
+### First Run
+
+```bash
+remotecode
+```
+
+The interactive setup wizard will prompt for:
+
+1. **TELEGRAM_BOT_TOKEN** -- validated against Telegram API
+2. **REMOTECODE_ALLOWED_USERS** -- comma-separated user IDs or @usernames
+3. **REMOTECODE_YOLO** -- `Y` enables autonomous mode (Claude Code runs without permission prompts, required for full remote control). Set `N` if you prefer read-only / monitoring use, but note that any action requiring approval will block since there's no terminal to confirm
+4. **STT setup** -- optional offline voice transcription. Installs `whisper-cli` and `ffmpeg` via Homebrew, and downloads a local Whisper model (~466 MB). Runs entirely on your machine -- no API calls, completely free
+
+Config is saved to `~/.remotecode/config`.
+
+## CLI Commands
+
+| Command | Description |
+|---|---|
+| `remotecode` | Start daemon (or show status if already running) |
+| `remotecode start` | Start the background daemon |
+| `remotecode stop` | Stop the daemon |
+| `remotecode restart` | Restart the daemon |
+| `remotecode status` | Show daemon status, active session, uptime |
+| `remotecode logs` | Follow logs in real-time (default) |
+| `remotecode logs -n 50` | Show last 50 log lines (static) |
+| `remotecode logs --level ERROR` | Filter by log level (DEBUG/INFO/WARN/ERROR) |
+| `remotecode logs --tag claude` | Filter by component tag |
+| `remotecode config` | Edit configuration (auto-restarts daemon) |
+| `remotecode setup-stt` | Install whisper-cli, ffmpeg, and download model |
+
+### Flags
+
+| Flag | Description |
+|---|---|
+| `-v`, `--verbose` | Enable verbose (DEBUG) logging |
+
+## Telegram Commands
+
+Send these as messages in your Telegram chat with the bot:
+
+| Command | Description |
+|---|---|
+| `/start`, `/help` | Welcome message with quick action buttons |
+| `/sessions` | Browse and switch between recent sessions |
+| `/projects` | Browse sessions grouped by project directory |
+| `/new` | Start a new Claude Code session |
+| `/history` | Show conversation history of current session |
+| `/sync` | Toggle auto-sync notifications on/off |
+
+### Inline Buttons
+
+After `/sessions` or `/projects`, interactive inline keyboards let you:
+
+- **Switch** to any session with one tap
+- **Create** new sessions (globally or per-project)
+- **Delete** sessions
+- **Navigate** between project views
+
+## Message Types
+
+### Text
+
+Send any text message. If it's not a `/command`, it's forwarded to Claude Code as a prompt. Responses are rendered as Telegram HTML with code blocks, bold, italic, and more.
+
+### Images
+
+Send a photo or image document (PNG, JPG, etc.). The bot downloads the image, saves it to a temp directory, and includes the file path in the Claude Code prompt. Add a caption to provide context.
+
+### Voice / Audio
+
+Send a voice message or audio file. The bot:
+
+1. Downloads the audio file
+2. Converts to WAV via `ffmpeg`
+3. Transcribes via `whisper-cli` (local, offline)
+4. Sends the transcription as a prompt to Claude Code
+5. Returns both your transcription and Claude's response in a blockquote
+
+> Requires STT setup: `remotecode setup-stt`
+
+## Session Management
+
+```mermaid
+stateDiagram-v2
+    [*] --> NoSession: First message
+    NoSession --> NewSession: auto-create UUID
+    NewSession --> Active: claude --session-id
+    Active --> Active: claude --resume
+    Active --> Switched: /sessions or inline button
+    Switched --> Active: select different session
+    Active --> NewSession: /new
+```
+
+RemoteCode discovers sessions from `~/.claude/projects/*/` by scanning `.jsonl` files. Each session maps to a Claude Code conversation.
+
+- **Active session** is stored in `~/.remotecode/local`
+- **Session CWD** determines which directory Claude Code runs in
+- Sessions are auto-created on first message if none exists
+- The `--resume` flag is used to continue existing sessions; falls back to `--session-id` for new ones
+
+### Auto-Sync
+
+When enabled (`/sync`), RemoteCode watches the active session's `.jsonl` file and forwards new messages from Claude Code in real-time. This means if you use Claude Code on your host machine, you'll see the conversation in Telegram too.
+
+The watcher polls for session changes every 3 seconds and uses `fs.watch` for file-level changes with 500ms debouncing.
+
+## Configuration
+
+### Config File
+
+`~/.remotecode/config` -- simple key=value format:
+
+```ini
+TELEGRAM_BOT_TOKEN=123456:ABC-DEF
+REMOTECODE_ALLOWED_USERS=12345678,@username
+REMOTECODE_YOLO=true
+```
+
+### Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `TELEGRAM_BOT_TOKEN` | Yes | Bot token from @BotFather |
+| `REMOTECODE_ALLOWED_USERS` | Yes | Comma/space-separated user IDs or @usernames |
+| `REMOTECODE_YOLO` | No | `true` for full remote control (skips Claude Code permission prompts). Set `false` for read-only / monitoring use |
+| `REMOTECODE_VERBOSE` | No | `true` to enable DEBUG-level logging |
+
+## File Structure
+
+```
+~/.remotecode/
+  config              # Global configuration (KV file)
+  local               # Active session state (session ID, CWD, chat ID)
+  remotecode.pid      # Daemon process ID
+  remotecode.log      # Log file (5MB rotation, keeps .old)
+  remotecode.log.old  # Previous rotated log
+  whisper/
+    ggml-small.bin    # Whisper model (if STT enabled)
+  RemoteCodeSessions/ # Default CWD for new sessions
+```
+
+## Message Flow
+
+```mermaid
+flowchart TD
+    A[Telegram Update] --> B{Message type?}
+    B -->|callback_query| C[callbacks.ts]
+    B -->|message| D{Content type?}
+
+    D -->|text starts with /| E[commands.ts]
+    D -->|text| F[handlePrompt]
+    D -->|photo / image doc| G[Download & save image]
+    D -->|voice / audio| H{STT ready?}
+
+    H -->|No| I[Send setup instructions]
+    H -->|Yes| J[Download → ffmpeg → whisper-cli]
+    J --> K{Blank audio?}
+    K -->|Yes| L[No speech detected]
+    K -->|No| F
+
+    G --> F
+
+    F --> M[withSessionLock]
+    M --> N[askClaude via CLI]
+    N --> O{Session exists?}
+    O -->|Yes| P[--resume session]
+    O -->|No| Q[--session-id new]
+    O -->|Busy| R[Retry up to 5x]
+
+    P --> S[Format response]
+    Q --> S
+    R --> S
+    S --> T[sendMessage HTML]
+
+    C --> U{Action}
+    U -->|sess:list| V[Show session grid]
+    U -->|sess:ID| W[Switch session]
+    U -->|sess:new| X[Create new session]
+    U -->|proj:list| Y[Show project list]
+    U -->|proj:DIR| Z[Show project sessions]
+    U -->|sessdel:ID| AA[Delete session]
+```
+
+## Speech-to-Text (STT)
+
+RemoteCode uses [whisper.cpp](https://github.com/ggerganov/whisper.cpp) for local, offline speech-to-text.
+
+### Setup
+
+```bash
+remotecode setup-stt
+```
+
+This installs (via Homebrew on macOS):
+- **whisper-cpp** -- C++ inference engine for Whisper
+- **ffmpeg** -- audio format conversion
+- **ggml-small.bin** -- Whisper small model (~466 MB, downloaded from HuggingFace)
+
+### How it works
+
+1. Audio downloaded from Telegram (`.oga` format)
+2. Converted to 16kHz mono WAV via `ffmpeg`
+3. Transcribed via `whisper-cli -m ggml-small.bin -l auto`
+4. Blank audio detection filters out silence/noise
+5. Transcription sent to Claude Code as a regular prompt
+
+## Security
+
+- **User allowlist** -- Only configured user IDs and usernames can interact
+- **Repeat block** -- Unauthorized users are warned once, then silently blocked
+- **No webhook** -- Uses long polling, no public endpoints needed
+- **Local STT** -- Voice transcription runs entirely offline via whisper.cpp
+- **YOLO mode** -- Required for full remote control. Without it, any Claude Code action needing approval will hang since there's no terminal to confirm. If security is a concern, set YOLO to `false` and use RemoteCode for text conversations and monitoring only
+
+## Development
+
+```bash
+# Run in development mode
+npm run dev
+
+# Build TypeScript
+npm run build
+
+# Run tests
+npm test
+
+# Watch tests
+npm run test:watch
+```
+
+## License
+
+[MIT](LICENSE)

package/dist/__tests__/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/__tests__/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/config.test.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const config_1 = require("../config");
+(0, vitest_1.describe)("readKvFile", () => {
+    const tmpFile = path.join(os.tmpdir(), `remotecode_test_kv_${Date.now()}.txt`);
+    (0, vitest_1.afterEach)(() => {
+        try {
+            fs.unlinkSync(tmpFile);
+        }
+        catch { /* ignore */ }
+    });
+    (0, vitest_1.it)("returns empty object for non-existent file", () => {
+        (0, vitest_1.expect)((0, config_1.readKvFile)("/tmp/does-not-exist-xyz.txt")).toEqual({});
+    });
+    (0, vitest_1.it)("parses key=value pairs", () => {
+        fs.writeFileSync(tmpFile, "FOO=bar\nBAZ=qux\n");
+        (0, vitest_1.expect)((0, config_1.readKvFile)(tmpFile)).toEqual({ FOO: "bar", BAZ: "qux" });
+    });
+    (0, vitest_1.it)("skips comments and empty lines", () => {
+        fs.writeFileSync(tmpFile, "# comment\n\nKEY=val\n");
+        (0, vitest_1.expect)((0, config_1.readKvFile)(tmpFile)).toEqual({ KEY: "val" });
+    });
+    (0, vitest_1.it)("handles values with = sign", () => {
+        fs.writeFileSync(tmpFile, "TOKEN=abc=def=ghi\n");
+        (0, vitest_1.expect)((0, config_1.readKvFile)(tmpFile)).toEqual({ TOKEN: "abc=def=ghi" });
+    });
+});
+(0, vitest_1.describe)("readEnvLines / writeEnvLines", () => {
+    const tmpFile = path.join(os.tmpdir(), `remotecode_test_env_${Date.now()}.txt`);
+    (0, vitest_1.afterEach)(() => {
+        try {
+            fs.unlinkSync(tmpFile);
+        }
+        catch { /* ignore */ }
+    });
+    (0, vitest_1.it)("returns empty array for non-existent file", () => {
+        (0, vitest_1.expect)((0, config_1.readEnvLines)("/tmp/does-not-exist-xyz.txt")).toEqual([]);
+    });
+    (0, vitest_1.it)("round-trips lines", () => {
+        const lines = ["FOO=bar", "BAZ=qux"];
+        (0, config_1.writeEnvLines)(tmpFile, lines);
+        const read = (0, config_1.readEnvLines)(tmpFile);
+        (0, vitest_1.expect)(read).toContain("FOO=bar");
+        (0, vitest_1.expect)(read).toContain("BAZ=qux");
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/__tests__/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../src/__tests__/config.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/format.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=format.test.d.ts.map

package/dist/__tests__/format.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/format.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/format.test.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const format_1 = require("../format");
+(0, vitest_1.describe)("escapeHtml", () => {
+    (0, vitest_1.it)("escapes &, <, >", () => {
+        (0, vitest_1.expect)((0, format_1.escapeHtml)("a & b < c > d")).toBe("a &amp; b &lt; c &gt; d");
+    });
+    (0, vitest_1.it)("returns empty string unchanged", () => {
+        (0, vitest_1.expect)((0, format_1.escapeHtml)("")).toBe("");
+    });
+});
+(0, vitest_1.describe)("mdToTelegramHtml", () => {
+    (0, vitest_1.it)("converts bold **text**", () => {
+        (0, vitest_1.expect)((0, format_1.mdToTelegramHtml)("**hello**")).toBe("<b>hello</b>");
+    });
+    (0, vitest_1.it)("converts bold __text__", () => {
+        (0, vitest_1.expect)((0, format_1.mdToTelegramHtml)("__hello__")).toBe("<b>hello</b>");
+    });
+    (0, vitest_1.it)("converts italic *text*", () => {
+        (0, vitest_1.expect)((0, format_1.mdToTelegramHtml)("*hello*")).toBe("<i>hello</i>");
+    });
+    (0, vitest_1.it)("converts inline code", () => {
+        (0, vitest_1.expect)((0, format_1.mdToTelegramHtml)("`code`")).toBe("<code>code</code>");
+    });
+    (0, vitest_1.it)("converts code blocks", () => {
+        const result = (0, format_1.mdToTelegramHtml)("```js\nconsole.log(1)\n```");
+        (0, vitest_1.expect)(result).toBe("<pre>console.log(1)</pre>");
+    });
+    (0, vitest_1.it)("converts headings to bold", () => {
+        (0, vitest_1.expect)((0, format_1.mdToTelegramHtml)("## Title")).toBe("<b>Title</b>");
+    });
+    (0, vitest_1.it)("converts strikethrough", () => {
+        (0, vitest_1.expect)((0, format_1.mdToTelegramHtml)("~~removed~~")).toBe("<s>removed</s>");
+    });
+    (0, vitest_1.it)("escapes HTML in plain text", () => {
+        (0, vitest_1.expect)((0, format_1.mdToTelegramHtml)("<script>alert(1)</script>")).toBe("&lt;script&gt;alert(1)&lt;/script&gt;");
+    });
+    (0, vitest_1.it)("preserves HTML inside code blocks", () => {
+        const result = (0, format_1.mdToTelegramHtml)("```\n<div>hi</div>\n```");
+        (0, vitest_1.expect)(result).toContain("&lt;div&gt;hi&lt;/div&gt;");
+    });
+});
+(0, vitest_1.describe)("tryMdToHtml", () => {
+    (0, vitest_1.it)("returns HTML with parseMode", () => {
+        const result = (0, format_1.tryMdToHtml)("**bold**");
+        (0, vitest_1.expect)(result.text).toBe("<b>bold</b>");
+        (0, vitest_1.expect)(result.parseMode).toBe("HTML");
+    });
+});
+(0, vitest_1.describe)("truncateMessage", () => {
+    (0, vitest_1.it)("returns short text unchanged", () => {
+        (0, vitest_1.expect)((0, format_1.truncateMessage)("hello", 10)).toBe("hello");
+    });
+    (0, vitest_1.it)("truncates long text", () => {
+        const long = "a".repeat(100);
+        const result = (0, format_1.truncateMessage)(long, 50);
+        (0, vitest_1.expect)(result.length).toBeLessThanOrEqual(70); // 50 + truncation marker
+        (0, vitest_1.expect)(result).toContain("[truncated]");
+    });
+});
+//# sourceMappingURL=format.test.js.map

package/dist/__tests__/format.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.test.js","sourceRoot":"","sources":["../../src/__tests__/format.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/sessions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sessions.test.d.ts.map

package/dist/__tests__/sessions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sessions.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sessions.test.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const sessions_1 = require("../sessions");
+function makeSession(overrides = {}) {
+    return {
+        sessionId: "00000000-0000-0000-0000-000000000000",
+        slug: null,
+        project: "/home/user/project",
+        projectName: "project",
+        lastModified: Date.now() / 1000,
+        firstMessage: null,
+        lastMessage: null,
+        ...overrides,
+    };
+}
+(0, vitest_1.describe)("formatTimeAgo", () => {
+    (0, vitest_1.it)("returns 'just now' for < 60s", () => {
+        (0, vitest_1.expect)((0, sessions_1.formatTimeAgo)(Date.now() / 1000 - 10)).toBe("just now");
+    });
+    (0, vitest_1.it)("returns minutes ago", () => {
+        (0, vitest_1.expect)((0, sessions_1.formatTimeAgo)(Date.now() / 1000 - 300)).toBe("5m ago");
+    });
+    (0, vitest_1.it)("returns hours ago", () => {
+        (0, vitest_1.expect)((0, sessions_1.formatTimeAgo)(Date.now() / 1000 - 7200)).toBe("2h ago");
+    });
+    (0, vitest_1.it)("returns days ago", () => {
+        (0, vitest_1.expect)((0, sessions_1.formatTimeAgo)(Date.now() / 1000 - 172800)).toBe("2d ago");
+    });
+});
+(0, vitest_1.describe)("formatSessionLabel", () => {
+    (0, vitest_1.it)("shows project + firstMessage", () => {
+        const s = makeSession({ firstMessage: "hello world" });
+        (0, vitest_1.expect)((0, sessions_1.formatSessionLabel)(s)).toBe("project - hello world");
+    });
+    (0, vitest_1.it)("truncates long firstMessage", () => {
+        const s = makeSession({ firstMessage: "a".repeat(50) });
+        const label = (0, sessions_1.formatSessionLabel)(s);
+        (0, vitest_1.expect)(label.length).toBeLessThanOrEqual(60);
+        (0, vitest_1.expect)(label).toContain("...");
+    });
+    (0, vitest_1.it)("falls back to slug", () => {
+        const s = makeSession({ slug: "my-slug" });
+        (0, vitest_1.expect)((0, sessions_1.formatSessionLabel)(s)).toBe("project (my-slug)");
+    });
+    (0, vitest_1.it)("falls back to project name only", () => {
+        const s = makeSession();
+        (0, vitest_1.expect)((0, sessions_1.formatSessionLabel)(s)).toBe("project");
+    });
+});
+//# sourceMappingURL=sessions.test.js.map

package/dist/__tests__/sessions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.test.js","sourceRoot":"","sources":["../../src/__tests__/sessions.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,0CAA6E;AAE7E,SAAS,WAAW,CAAC,YAAkC,EAAE;IACvD,OAAO;QACL,SAAS,EAAE,sCAAsC;QACjD,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,oBAAoB;QAC7B,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI;QAC/B,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,IAAI;QACjB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,IAAA,iBAAQ,EAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAA,WAAE,EAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,IAAA,eAAM,EAAC,IAAA,wBAAa,EAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,IAAA,eAAM,EAAC,IAAA,wBAAa,EAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,IAAA,eAAM,EAAC,IAAA,wBAAa,EAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,IAAA,eAAM,EAAC,IAAA,wBAAa,EAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAA,WAAE,EAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC;QACvD,IAAA,eAAM,EAAC,IAAA,6BAAkB,EAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,IAAA,6BAAkB,EAAC,CAAC,CAAC,CAAC;QACpC,IAAA,eAAM,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3C,IAAA,eAAM,EAAC,IAAA,6BAAkB,EAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,WAAW,EAAE,CAAC;QACxB,IAAA,eAAM,EAAC,IAAA,6BAAkB,EAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/banner.d.ts

@@ -0,0 +1,4 @@
+/** Stop listening for terminal resize (call before prompts / further output). */
+export declare function stopBannerResize(): void;
+export declare function printBanner(contentLines?: string[]): void;
+//# sourceMappingURL=banner.d.ts.map

package/dist/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AAcA,iFAAiF;AACjF,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC;AAED,wBAAgB,WAAW,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CA0GzD"}