kumo-cli 1.0.0 → 1.0.2

package/README.md

@@ -1,52 +1,40 @@
 # Kumo CLI
 
-> _where your code drifts between devices, softly._
-
-[![npm version](https://img.shields.io/npm/v/kumo-cli.svg?style=flat-square)](https://www.npmjs.com/package/kumo-cli)
-[![node](https://img.shields.io/node/v/kumo-cli.svg?style=flat-square)](https://nodejs.org)
-[![license](https://img.shields.io/npm/l/kumo-cli.svg?style=flat-square)](./LICENSE)
-
-**Kumo CLI** is the desktop companion for the [Kumo app](https://github.com/kumo-app/kumo). It pairs your terminal with the mobile/desktop client over a secure WebSocket bridge so you can drive Claude Code (and any PTY session) from anywhere — without giving up the comfort of your local shell.
+A lightweight companion CLI for Kumo that connects your local terminal sessions to the Kumo app.
 
 ---
 
 ## ✨ Features
 
-- 🔗 **One-tap pairing** — link the CLI to your Kumo account with a 9-digit code from the app.
-- 🖥️ **Real PTY streaming** — spawns Claude Code (or any process) via `node-pty` and mirrors the terminal byte-for-byte.
-- 📡 **Bi-directional bridge** — keystrokes from the app flow back into the local PTY in real time.
-- 🪝 **Session hooks** — auto-injects Claude Code session hooks so your remote views stay in sync.
-- 🧠 **Smart snapshots** — periodic ANSI snapshots keep newly connected viewers up to date instantly.
-- 🌐 **Bonjour discovery** — optional local discovery for zero-config LAN setups.
-- 🔒 **Local credentials** — device tokens are stored under your user config dir, never echoed.
+- Pair once with a short code from the app
+- Resume and manage Claude Code sessions remotely
+- Stream PTY output over WebSocket
+- Auto-sync Claude session state and transcript events
+- Optional local hook server integration for Claude session discovery
 
 ---
 
-## 🚀 Quick start
+## 📦 Installation
 
-```bash
-# run on demand (no install)
-npx kumo-cli@latest
+### Global install
 
-# or install globally
+```bash
 npm install -g kumo-cli
-kumo
 ```
 
-On first launch you'll see a prompt:
+### One-off via npx
 
+```bash
+npx kumo-cli@latest
 ```
-✦ pairing code › ___
-```
-
-Open the **Kumo app**, sign in, tap **"generate"** on the pairing tab, and type the 9 digits back. That's it — your CLI is paired and a session is live.
 
 ---
 
-## 📦 Requirements
+## ✅ Requirements
 
-- **Node.js ≥ 18** (LTS recommended)
-- A working C/C++ toolchain for [`node-pty`](https://github.com/microsoft/node-pty#dependencies):
+- Node.js **18+**
+- Internet access to reach your Kumo backend
+- Native build prerequisites for `node-pty`:
   - **Windows:** Visual Studio Build Tools + Python 3
   - **macOS:** Xcode Command Line Tools (`xcode-select --install`)
   - **Linux:** `build-essential`, `python3`, `make`, `gcc`
@@ -56,11 +44,11 @@ Open the **Kumo app**, sign in, tap **"generate"** on the pairing tab, and type
 
 ## 🛠️ Configuration
 
-Kumo CLI is configured via environment variables. They can be exported in your shell or placed in a `.env` file in the working directory.
+Kumo CLI is configured via environment variables. Export them in your shell or load them explicitly with `--env-file path/to/.env`.
 
 | Variable | Default | Description |
 | --- | --- | --- |
-| `KUMO_SERVER_URL` | `http://localhost:3579` | Base URL of the Kumo backend. Auto-derives HTTP & WS endpoints. |
+| `KUMO_SERVER_URL` | `https://kumocli.com/` | Base URL of the Kumo backend. Auto-derives HTTP & WS endpoints. |
 | `KUMO_SERVER_HTTP_URL` | derived | Override the HTTP endpoint explicitly. |
 | `KUMO_SERVER_WS_URL` | derived | Override the WebSocket endpoint explicitly. |
 | `KUMO_PORT` | `3579` | Local port hint (used by some discovery flows). |
@@ -72,8 +60,9 @@ Credentials are persisted to your OS config dir (e.g. `%APPDATA%\kumo\credential
 ## 🧭 Usage
 
 ```bash
-kumo                  # interactive: pair if needed, then start a session
-kumo --help           # show available flags (if applicable)
+kumo --env-file .env
+kumo --env-file .env.local
+kumo --help
 ```
 
 To unpair, simply delete the credentials file printed on first pairing, or run:

package/dist/auth/credentialsStore.js

@@ -0,0 +1,41 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+const CRED_DIR = path.join(os.homedir(), '.kumo');
+const CRED_FILE = path.join(CRED_DIR, 'credentials.json');
+// load credentials from ~/.kumo/credentials.json if present
+export function loadCredentials() {
+    try {
+        if (!fs.existsSync(CRED_FILE))
+            return null;
+        const parsed = JSON.parse(fs.readFileSync(CRED_FILE, 'utf-8'));
+        if (!parsed.deviceUuid || !parsed.deviceToken)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+// persist credentials with restrictive 0600 mode on posix
+export function saveCredentials(creds) {
+    if (!fs.existsSync(CRED_DIR))
+        fs.mkdirSync(CRED_DIR, { recursive: true });
+    fs.writeFileSync(CRED_FILE, JSON.stringify(creds, null, 2), { encoding: 'utf-8', mode: 0o600 });
+}
+// remove credentials file; called by `kumo reset`
+export function clearCredentials() {
+    try {
+        if (!fs.existsSync(CRED_FILE))
+            return false;
+        fs.unlinkSync(CRED_FILE);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function credentialsPath() {
+    return CRED_FILE;
+}
+//# sourceMappingURL=credentialsStore.js.map

package/dist/auth/credentialsStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentialsStore.js","sourceRoot":"","sources":["../../src/auth/credentialsStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AAE1D,4DAA4D;AAC5D,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAoB,CAAC;QAClF,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAClG,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5C,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/claude/generateHookSettings.js

@@ -0,0 +1,23 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+// generate a temporary claude settings file pointing SessionStart hook to our local forwarder
+export function generateHookSettingsFile(hookPort) {
+    const forwarderPath = path.resolve(moduleDir, '..', '..', 'scripts', 'session_hook_forwarder.cjs');
+    const settingsDir = path.join(os.tmpdir(), 'kumo-hooks');
+    fs.mkdirSync(settingsDir, { recursive: true });
+    const settingsPath = path.join(settingsDir, `settings-${Date.now()}.json`);
+    const command = `node "${forwarderPath}" --port ${hookPort}`;
+    const settings = {
+        hooks: {
+            SessionStart: [
+                { matcher: '', hooks: [{ type: 'command', command }] },
+            ],
+        },
+    };
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+    return settingsPath;
+}
+//# sourceMappingURL=generateHookSettings.js.map

package/dist/claude/generateHookSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateHookSettings.js","sourceRoot":"","sources":["../../src/claude/generateHookSettings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,8FAA8F;AAC9F,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;IACnG,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;IACzD,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,SAAS,aAAa,YAAY,QAAQ,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG;QACf,KAAK,EAAE;YACL,YAAY,EAAE;gBACZ,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;aACvD;SACF;KACF,CAAC;IACF,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3E,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/claude/hookServer.js

@@ -0,0 +1,33 @@
+import http from 'node:http';
+// start a tiny http server on an ephemeral port that claude will post sessionStart to
+export function startHookServer(onSessionFound) {
+    return new Promise((resolve, reject) => {
+        const server = http.createServer((req, res) => {
+            if (req.method === 'POST' && req.url === '/hook/session-start') {
+                let body = '';
+                req.on('data', (chunk) => { body += chunk; });
+                req.on('end', () => {
+                    try {
+                        const data = JSON.parse(body);
+                        if (data.sessionId)
+                            onSessionFound(data.sessionId);
+                    }
+                    catch { }
+                    res.writeHead(200);
+                    res.end('ok');
+                });
+            }
+            else {
+                res.writeHead(404);
+                res.end();
+            }
+        });
+        server.listen(0, '127.0.0.1', () => {
+            const addr = server.address();
+            const port = typeof addr === 'object' && addr ? addr.port : 0;
+            resolve({ port, close: () => server.close() });
+        });
+        server.on('error', reject);
+    });
+}
+//# sourceMappingURL=hookServer.js.map

package/dist/claude/hookServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookServer.js","sourceRoot":"","sources":["../../src/claude/hookServer.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAAC,cAA2C;IACzE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAC5C,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,qBAAqB,EAAE,CAAC;gBAC/D,IAAI,IAAI,GAAG,EAAE,CAAC;gBACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;oBACjB,IAAI,CAAC;wBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2B,CAAC;wBACxD,IAAI,IAAI,CAAC,SAAS;4BAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACrD,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;oBACV,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;oBACnB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACnB,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;YACjC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9D,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/claude/sessionScanner.js

@@ -0,0 +1,250 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import crypto from 'node:crypto';
+import { EventEmitter } from 'node:events';
+const NOISE_TAGS_RE = /<local-command-|<\/local-command-|<command-name>|<command-message>|<command-args>/i;
+const NOISE_INTERRUPT_RE = /request interrupted by user|interrupted by user|interrupted the running process/i;
+const UUID_LINE_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\s*$/i;
+// scans claude session jsonl + subagent transcripts incrementally and emits parsed messages
+export class SessionScanner extends EventEmitter {
+    sessionId;
+    startAtEnd;
+    filePath = null;
+    sessionDir = null;
+    offset = 0;
+    watcher = null;
+    subagentWatcher = null;
+    seenUuids = new Set();
+    pollTimer = null;
+    subagentScanTimer = null;
+    subagentOffsets = new Map();
+    subagentWatchers = new Map();
+    constructor(sessionId, startAtEnd = false) {
+        super();
+        this.sessionId = sessionId;
+        this.startAtEnd = startAtEnd;
+    }
+    start() {
+        this.filePath = this.findJsonlFile();
+        if (!this.filePath) {
+            this.pollTimer = setInterval(() => {
+                const found = this.findJsonlFile();
+                if (found) {
+                    this.filePath = found;
+                    clearInterval(this.pollTimer);
+                    this.pollTimer = null;
+                    this.watchFile();
+                }
+            }, 500);
+            return;
+        }
+        this.watchFile();
+    }
+    stop() {
+        this.watcher?.close();
+        this.subagentWatcher?.close();
+        for (const w of this.subagentWatchers.values())
+            w.close();
+        this.subagentWatchers.clear();
+        if (this.pollTimer)
+            clearInterval(this.pollTimer);
+        if (this.subagentScanTimer)
+            clearInterval(this.subagentScanTimer);
+    }
+    findJsonlFile() {
+        const projectsDir = path.join(os.homedir(), '.claude', 'projects');
+        if (!fs.existsSync(projectsDir))
+            return null;
+        for (const entry of fs.readdirSync(projectsDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const candidate = path.join(projectsDir, entry.name, `${this.sessionId}.jsonl`);
+            if (fs.existsSync(candidate)) {
+                this.sessionDir = path.join(projectsDir, entry.name, this.sessionId);
+                return candidate;
+            }
+        }
+        return null;
+    }
+    watchFile() {
+        if (!this.filePath)
+            return;
+        if (this.startAtEnd) {
+            try {
+                this.offset = fs.statSync(this.filePath).size;
+            }
+            catch {
+                this.offset = 0;
+            }
+            this.startAtEnd = false;
+        }
+        else {
+            this.readIncremental();
+        }
+        try {
+            this.watcher = fs.watch(this.filePath, () => this.readIncremental());
+        }
+        catch { }
+        this.watchSubagents();
+    }
+    watchSubagents() {
+        if (!this.sessionDir)
+            return;
+        const subagentsDir = path.join(this.sessionDir, 'subagents');
+        const scanSubagents = () => {
+            if (!fs.existsSync(subagentsDir))
+                return;
+            for (const file of fs.readdirSync(subagentsDir).filter((f) => f.endsWith('.jsonl'))) {
+                const filePath = path.join(subagentsDir, file);
+                if (!this.subagentWatchers.has(filePath)) {
+                    this.readSubagentFile(filePath);
+                    try {
+                        this.subagentWatchers.set(filePath, fs.watch(filePath, () => this.readSubagentFile(filePath)));
+                    }
+                    catch { }
+                }
+            }
+        };
+        scanSubagents();
+        this.subagentScanTimer = setInterval(() => {
+            if (fs.existsSync(subagentsDir)) {
+                if (!this.subagentWatcher) {
+                    try {
+                        this.subagentWatcher = fs.watch(subagentsDir, () => scanSubagents());
+                    }
+                    catch { }
+                }
+                scanSubagents();
+            }
+        }, 1000);
+    }
+    // read newly appended bytes from a jsonl file using a tracked offset
+    readDelta(filePath, getOffset, setOffset) {
+        try {
+            const stat = fs.statSync(filePath);
+            const offset = getOffset();
+            if (stat.size <= offset)
+                return;
+            const fd = fs.openSync(filePath, 'r');
+            const buf = Buffer.alloc(stat.size - offset);
+            fs.readSync(fd, buf, 0, buf.length, offset);
+            fs.closeSync(fd);
+            setOffset(stat.size);
+            for (const line of buf.toString('utf-8').split('\n')) {
+                if (!line.trim())
+                    continue;
+                try {
+                    this.processMessage(JSON.parse(line));
+                }
+                catch { }
+            }
+        }
+        catch { }
+    }
+    readSubagentFile(filePath) {
+        this.readDelta(filePath, () => this.subagentOffsets.get(filePath) ?? 0, (n) => this.subagentOffsets.set(filePath, n));
+    }
+    readIncremental() {
+        if (!this.filePath)
+            return;
+        this.readDelta(this.filePath, () => this.offset, (n) => { this.offset = n; });
+    }
+    processMessage(msg) {
+        if (msg.type !== 'user' && msg.type !== 'assistant')
+            return;
+        if (!msg.message)
+            return;
+        if (msg.isMeta || msg.sourceToolUseID)
+            return;
+        const role = msg.message.role;
+        if (!role || role === 'system')
+            return;
+        if (msg.uuid && this.seenUuids.has(msg.uuid))
+            return;
+        if (msg.uuid)
+            this.seenUuids.add(msg.uuid);
+        let content = '';
+        const toolUses = [];
+        if (typeof msg.message.content === 'string') {
+            content = msg.message.content;
+        }
+        else if (Array.isArray(msg.message.content)) {
+            content = msg.message.content
+                .filter((b) => b.type === 'text' && b.text && (b.text ?? '').trim() !== 'No response requested.')
+                .map((b) => b.text ?? '')
+                .join('');
+            for (const b of msg.message.content) {
+                if (b.type === 'tool_use' && b.name) {
+                    const tu = { toolName: b.name, input: b.input ?? {} };
+                    if (b.name === 'Write')
+                        this.enrichWriteWithOldContent(tu);
+                    toolUses.push(tu);
+                }
+            }
+        }
+        if (!content && toolUses.length === 0)
+            return;
+        if (content && this.isNoiseTranscript(content))
+            return;
+        this.emit('message', {
+            role, content,
+            id: msg.uuid,
+            timestamp: new Date().toISOString(),
+            toolUses: toolUses.length > 0 ? toolUses : undefined,
+            stopReason: msg.message.stop_reason,
+            agentId: msg.agentId,
+            isSidechain: msg.isSidechain,
+        });
+    }
+    // inject old_content into write tool use by reading previous version from file-history
+    enrichWriteWithOldContent(tu) {
+        const fp = tu.input['file_path'] ?? tu.input['path'] ?? '';
+        if (!fp)
+            return;
+        const oldContent = readFileHistoryPrev(this.sessionId, fp);
+        if (oldContent !== null)
+            tu.input['old_content'] = oldContent;
+    }
+    isNoiseTranscript(content) {
+        if (/<local-command-stdout>/.test(content))
+            return false;
+        if (NOISE_TAGS_RE.test(content))
+            return true;
+        if (NOISE_INTERRUPT_RE.test(content))
+            return true;
+        if (UUID_LINE_RE.test(content.trim()))
+            return true;
+        return false;
+    }
+}
+// convert unix-style drive path (/e/Data/...) to windows path (E:\Data\...) on windows
+function toNativePath(p) {
+    if (process.platform === 'win32') {
+        const m = p.match(/^\/([a-zA-Z])\//);
+        if (m)
+            return m[1].toUpperCase() + ':\\' + p.slice(3).replace(/\//g, '\\');
+    }
+    return p;
+}
+// read the previous version of a file from ~/.claude/file-history; returns null if not found or first write
+export function readFileHistoryPrev(sessionId, filePath) {
+    try {
+        const native = toNativePath(filePath);
+        const resolved = path.resolve(native);
+        const hash = crypto.createHash('sha256').update(resolved).digest('hex').slice(0, 16);
+        const histDir = path.join(os.homedir(), '.claude', 'file-history', sessionId);
+        if (!fs.existsSync(histDir))
+            return null;
+        const versions = fs.readdirSync(histDir)
+            .filter((f) => f.startsWith(hash + '@v'))
+            .sort((a, b) => parseInt(a.split('@v')[1], 10) - parseInt(b.split('@v')[1], 10));
+        if (versions.length < 2)
+            return null;
+        return fs.readFileSync(path.join(histDir, versions[versions.length - 2]), 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=sessionScanner.js.map

package/dist/claude/sessionScanner.js.map

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

package/dist/config.js

@@ -0,0 +1,40 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+// normalize raw user-supplied url into an http/https origin (no trailing /ws)
+export function normalizeServerHttpUrl(input) {
+    const u = new URL(input);
+    if (u.protocol === 'ws:')
+        u.protocol = 'http:';
+    if (u.protocol === 'wss:')
+        u.protocol = 'https:';
+    if (u.pathname === '/ws')
+        u.pathname = '/';
+    if (u.pathname.endsWith('/ws'))
+        u.pathname = u.pathname.slice(0, -3) || '/';
+    return u.toString().replace(/\/$/, '');
+}
+// normalize raw user-supplied url into a ws/wss endpoint pointing to /ws
+export function normalizeServerWsUrl(input) {
+    const u = new URL(input);
+    if (u.protocol === 'http:')
+        u.protocol = 'ws:';
+    if (u.protocol === 'https:')
+        u.protocol = 'wss:';
+    if (u.pathname === '/' || u.pathname === '')
+        u.pathname = '/ws';
+    return u.toString().replace(/\/$/, '');
+}
+const serverUrl = process.env.KUMO_SERVER_URL;
+export const SERVER_HTTP = normalizeServerHttpUrl(process.env.KUMO_SERVER_HTTP_URL ?? serverUrl ?? 'https://kumocli.com');
+export const SERVER_WS = normalizeServerWsUrl(process.env.KUMO_SERVER_WS_URL ?? serverUrl ?? 'wss://kumocli.com/ws');
+export const SERVER_PORT = parseInt(process.env.KUMO_PORT ?? '443', 10);
+// resolve project-relative directories from this module's compiled location
+const moduleDir = path.resolve(fileURLToPath(import.meta.url), '..');
+export const PROJECT_TMP_DIR = path.resolve(moduleDir, '..', 'tmp');
+export const LOGS_DIR = path.resolve(moduleDir, '..', 'logs');
+export const SNAPSHOT_DIR = path.resolve(moduleDir, '..', '..', 'claude-data-snapshot');
+// constants for pty buffering and file watcher debounce
+export const PTY_FLUSH_MS = 120;
+export const PTY_MAX_CHUNK = 8000;
+export const FILE_WATCH_DEBOUNCE_MS = 300;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK;QAAE,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC/C,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;QAAE,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACjD,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK;QAAE,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC;IAC3C,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC5E,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;QAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC/C,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC;IACjD,IAAI,CAAC,CAAC,QAAQ,KAAK,GAAG,IAAI,CAAC,CAAC,QAAQ,KAAK,EAAE;QAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;IAChE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,SAAS,IAAI,qBAAqB,CAAC,CAAC;AAC1H,MAAM,CAAC,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS,IAAI,sBAAsB,CAAC,CAAC;AACrH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC;AAExE,4EAA4E;AAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,sBAAsB,CAAC,CAAC;AAExF,wDAAwD;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC"}

package/dist/core/config.js

@@ -0,0 +1,48 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+// normalize raw user-supplied url into an http/https origin (no trailing /ws)
+export function normalizeServerHttpUrl(input) {
+    const u = new URL(input);
+    if (u.protocol === 'ws:')
+        u.protocol = 'http:';
+    if (u.protocol === 'wss:')
+        u.protocol = 'https:';
+    if (u.pathname === '/ws')
+        u.pathname = '/';
+    if (u.pathname.endsWith('/ws'))
+        u.pathname = u.pathname.slice(0, -3) || '/';
+    return u.toString().replace(/\/$/, '');
+}
+// normalize raw user-supplied url into a ws/wss endpoint pointing to /ws
+export function normalizeServerWsUrl(input) {
+    const u = new URL(input);
+    if (u.protocol === 'http:')
+        u.protocol = 'ws:';
+    if (u.protocol === 'https:')
+        u.protocol = 'wss:';
+    if (u.pathname === '/' || u.pathname === '')
+        u.pathname = '/ws';
+    return u.toString().replace(/\/$/, '');
+}
+// lazy-evaluated so env vars injected via --env-file are available
+let _serverHttp = null;
+let _serverWs = null;
+export function SERVER_HTTP() {
+    if (!_serverHttp)
+        _serverHttp = normalizeServerHttpUrl(process.env.KUMO_SERVER_HTTP_URL ?? process.env.KUMO_SERVER_URL ?? 'https://kumocli.com');
+    return _serverHttp;
+}
+export function SERVER_WS() {
+    if (!_serverWs)
+        _serverWs = normalizeServerWsUrl(process.env.KUMO_SERVER_WS_URL ?? process.env.KUMO_SERVER_URL ?? 'wss://kumocli.com/ws');
+    return _serverWs;
+}
+// resolve project-relative directories from this module's compiled location (dist/core/config.js)
+const moduleDir = path.resolve(fileURLToPath(import.meta.url), '..');
+export const PROJECT_TMP_DIR = path.resolve(moduleDir, '..', '..', 'tmp');
+export const LOGS_DIR = path.resolve(moduleDir, '..', '..', 'logs');
+// constants for pty buffering and file watcher debounce
+export const PTY_FLUSH_MS = 120;
+export const PTY_MAX_CHUNK = 8000;
+export const FILE_WATCH_DEBOUNCE_MS = 300;
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK;QAAE,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC/C,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;QAAE,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACjD,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK;QAAE,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC;IAC3C,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC5E,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;QAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC/C,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC;IACjD,IAAI,CAAC,CAAC,QAAQ,KAAK,GAAG,IAAI,CAAC,CAAC,QAAQ,KAAK,EAAE;QAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;IAChE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,mEAAmE;AACnE,IAAI,WAAW,GAAkB,IAAI,CAAC;AACtC,IAAI,SAAS,GAAkB,IAAI,CAAC;AAEpC,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,WAAW;QAAE,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,qBAAqB,CAAC,CAAC;IACjJ,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,sBAAsB,CAAC,CAAC;IAC1I,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kGAAkG;AAClG,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAEpE,wDAAwD;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC"}

package/dist/core/loadDotEnv.js

@@ -0,0 +1,46 @@
+import fs from 'node:fs';
+import path from 'node:path';
+function parseDotEnv(text) {
+    const out = {};
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const normalized = line.startsWith('export ') ? line.slice('export '.length).trimStart() : line;
+        const eqIdx = normalized.indexOf('=');
+        if (eqIdx <= 0)
+            continue;
+        const key = normalized.slice(0, eqIdx).trim();
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))
+            continue;
+        let value = normalized.slice(eqIdx + 1).trim();
+        if (!value) {
+            out[key] = '';
+            continue;
+        }
+        const first = value[0];
+        if (first === '"' || first === "'") {
+            const quote = first;
+            const rest = value.slice(1);
+            const endIdx = rest.lastIndexOf(quote);
+            const inner = endIdx >= 0 ? rest.slice(0, endIdx) : rest;
+            out[key] = quote === '"'
+                ? inner.replace(/\\n/g, '\n').replace(/\\r/g, '\r').replace(/\\t/g, '\t').replace(/\\\\/g, '\\').replace(/\\"/g, '"')
+                : inner;
+            continue;
+        }
+        out[key] = value.replace(/\s+#.*$/, '').trim();
+    }
+    return out;
+}
+export function loadDotEnv(envFilePath) {
+    const fullPath = path.resolve(envFilePath);
+    if (!fs.existsSync(fullPath)) {
+        throw new Error(`[kumo-cli] env file not found: ${fullPath}`);
+    }
+    const parsed = parseDotEnv(fs.readFileSync(fullPath, 'utf-8'));
+    for (const [k, v] of Object.entries(parsed)) {
+        process.env[k] = v;
+    }
+}
+//# sourceMappingURL=loadDotEnv.js.map

package/dist/core/loadDotEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadDotEnv.js","sourceRoot":"","sources":["../../src/core/loadDotEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAChG,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACzB,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QACpD,IAAI,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,KAAK,CAAC;YACpB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACzD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,GAAG;gBACtB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;gBACrH,CAAC,CAAC,KAAK,CAAC;YACV,SAAS;QACX,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}