lunel-cli 0.1.121 → 0.1.122

package/README.md

@@ -0,0 +1,109 @@
+# Lunel CLI
+
+Node.js CLI that connects a local machine to the Lunel mobile app through the Lunel gateway. It runs from the project directory you want to expose and keeps filesystem, terminal, process, port, git, and AI actions scoped to that working tree.
+
+## Requirements
+
+- Node.js 18 or newer
+- npm
+- Lunel mobile app for QR/session pairing
+
+## Usage
+
+Run the published package:
+
+```bash
+npx lunel-cli
+```
+
+The CLI prints a QR code and session details. Scan the QR code with the Lunel app to connect to the current working directory.
+
+Common options:
+
+```bash
+npx lunel-cli --help
+npx lunel-cli --new
+npx lunel-cli --debug
+npx lunel-cli --extra-ports 3000,8080
+```
+
+Options:
+
+| Option | Description |
+| --- | --- |
+| `-h`, `--help` | Show CLI help |
+| `-n`, `--new` | Create a fresh session code instead of reusing the saved one |
+| `-d`, `--debug` | Enable verbose CLI and AI backend logs |
+| `--extra-ports` | Comma-separated local ports to expose through Lunel |
+
+## Configuration
+
+By default, the CLI uses the public Lunel services:
+
+- Gateway: `https://gateway.lunel.dev`
+- Manager: `https://manager.lunel.dev`
+
+Override them with environment variables when developing against local or custom infrastructure:
+
+```bash
+LUNEL_PROXY_URL=http://localhost:3001 \
+LUNEL_MANAGER_URL=http://localhost:3002 \
+npx lunel-cli
+```
+
+Other useful environment variables:
+
+| Variable | Description |
+| --- | --- |
+| `LUNEL_PROXY_URL` | Gateway/proxy URL |
+| `LUNEL_MANAGER_URL` | Manager URL |
+| `LUNEL_DEBUG` | Set to `1` for debug logging |
+| `LUNEL_DEBUG_AI` | Set to `1` for AI backend debug logging |
+| `NO_COLOR` | Disable colored terminal output |
+| `FORCE_COLOR` | Force colored terminal output |
+
+Session config is saved per project root in the OS-specific Lunel config directory:
+
+- macOS: `~/Library/Application Support/lunel/config.json`
+- Windows: `%APPDATA%\lunel\config.json`
+- Linux: `$XDG_CONFIG_HOME/lunel/config.json` or `~/.config/lunel/config.json`
+
+## Development
+
+Install dependencies:
+
+```bash
+npm install
+```
+
+Build the CLI:
+
+```bash
+npm run build
+```
+
+Run from source output:
+
+```bash
+npm run dev
+```
+
+The package entrypoint is `dist/index.js`, generated from `src/index.ts`. `npm run build` compiles TypeScript and marks the generated entrypoint executable.
+
+## Project Layout
+
+```text
+src/
+  index.ts              CLI entrypoint and local machine bridge
+  ai/                   Codex/OpenCode provider integration
+  transport/            Session transport protocol
+  libsodium-wrappers.d.ts
+```
+
+## Publishing
+
+The package is published as `lunel-cli`. `prepublishOnly` runs the production build before publishing.
+
+```bash
+npm publish
+```

package/dist/ai/index.d.ts

@@ -29,6 +29,9 @@ export declare class AiManager {
     getMessages(backend: AiBackend, sessionId: string): Promise<{
         messages: import("./interface.js").MessageInfo[];
     }>;
+    statuses(backend: AiBackend): Promise<{
+        statuses: Record<string, unknown>;
+    }>;
     prompt(backend: AiBackend, sessionId: string, text: string, model?: ModelSelector, agent?: string, files?: FileAttachment[], codexOptions?: CodexPromptOptions): Promise<{
         ack: true;
     }>;

package/dist/ai/index.js

@@ -74,6 +74,12 @@ export class AiManager {
     deleteSession(backend, id) { return this.get(backend).deleteSession(id); }
     renameSession(backend, id, title) { return this.get(backend).renameSession(id, title); }
     getMessages(backend, sessionId) { return this.get(backend).getMessages(sessionId); }
+    async statuses(backend) {
+        const provider = this.get(backend);
+        if (!provider.statuses)
+            return { statuses: {} };
+        return provider.statuses();
+    }
     prompt(backend, sessionId, text, model, agent, files, codexOptions) {
         this.get(backend).setActiveSession?.(sessionId);
         return this.get(backend).prompt(sessionId, text, model, agent, files, codexOptions);

package/dist/ai/interface.d.ts

@@ -67,6 +67,9 @@ export interface AIProvider {
     getMessages(sessionId: string): Promise<{
         messages: MessageInfo[];
     }>;
+    statuses?(): Promise<{
+        statuses: Record<string, unknown>;
+    }>;
     prompt(sessionId: string, text: string, model?: ModelSelector, agent?: string, files?: FileAttachment[], codexOptions?: CodexPromptOptions): Promise<{
         ack: true;
     }>;

package/dist/ai/opencode.d.ts

@@ -33,6 +33,9 @@ export declare class OpenCodeProvider implements AIProvider {
     getMessages(sessionId: string): Promise<{
         messages: MessageInfo[];
     }>;
+    statuses(): Promise<{
+        statuses: Record<string, unknown>;
+    }>;
     prompt(sessionId: string, text: string, model?: ModelSelector, agent?: string, files?: FileAttachment[], codexOptions?: CodexPromptOptions): Promise<{
         ack: true;
     }>;
@@ -62,6 +65,7 @@ export declare class OpenCodeProvider implements AIProvider {
     private refreshPendingQuestions;
     private fetchOpenCodeJson;
     private refreshSessionStatuses;
+    private fetchSessionStatuses;
     private trackPermissionEvent;
     private readString;
     private asRecord;

package/dist/ai/opencode.js

@@ -402,6 +402,9 @@ export class OpenCodeProvider {
             throw err;
         }
     }
+    async statuses() {
+        return { statuses: await this.fetchSessionStatuses() };
+    }
     // -------------------------------------------------------------------------
     // Interaction
     // -------------------------------------------------------------------------
@@ -806,10 +809,22 @@ export class OpenCodeProvider {
         return response.json().catch(() => null);
     }
     async refreshSessionStatuses() {
+        const payload = await this.fetchSessionStatuses();
+        for (const [sessionId, status] of Object.entries(payload)) {
+            this.emitter?.({
+                type: "session.status",
+                properties: {
+                    sessionID: sessionId,
+                    status: status,
+                },
+            });
+        }
+    }
+    async fetchSessionStatuses() {
         const server = this.server;
         const authHeader = this.authHeader;
         if (!server || !authHeader) {
-            return;
+            return {};
         }
         const url = new URL("/session/status", server.url);
         const response = await fetch(url, {
@@ -819,21 +834,13 @@ export class OpenCodeProvider {
             },
         });
         if (!response.ok) {
-            return;
+            return {};
         }
         const payload = await response.json().catch(() => null);
         if (!payload || typeof payload !== "object") {
-            return;
-        }
-        for (const [sessionId, status] of Object.entries(payload)) {
-            this.emitter?.({
-                type: "session.status",
-                properties: {
-                    sessionID: sessionId,
-                    status: status,
-                },
-            });
+            return {};
         }
+        return payload;
     }
     trackPermissionEvent(type, properties) {
         if (type === "permission.updated") {

package/dist/index.js

@@ -2728,6 +2728,9 @@ async function processMessage(message) {
                     case "getMessages":
                         result = await aiManager.getMessages(backend, payload.id);
                         break;
+                    case "statuses":
+                        result = await aiManager.statuses(backend);
+                        break;
                     case "abort":
                         result = await aiManager.abort(backend, payload.sessionId);
                         break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lunel-cli",
-  "version": "0.1.121",
+  "version": "0.1.122",
   "author": [
     {
       "name": "Soham Bharambe",