smolcoder 0.4.0

package/dist/web/webui.js

@@ -0,0 +1,262 @@
+"use strict";
+// WebUI: the --web session surface. Same AgentUI/SessionUI contract as the
+// terminal Tui, but events stream to a browser page over SSE and input comes
+// back over JSON POSTs. Localhost-only, guarded by a random URL token so a
+// stray local process or webpage can't drive the agent.
+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 });
+exports.WebUI = void 0;
+const crypto = __importStar(require("crypto"));
+const http = __importStar(require("http"));
+const ui_1 = require("../ui");
+const page_1 = require("./page");
+class WebUI {
+    port;
+    slashCommands = [];
+    getStatus = () => "";
+    /** Structured snapshot for the page's status bar; assigned by index.ts. */
+    getState = () => ({});
+    hintLeft = "";
+    onModeCycle = null;
+    onCancel = null;
+    onExit = null;
+    authToken = crypto.randomBytes(9).toString("base64url");
+    server = null;
+    clients = new Set();
+    replay = [];
+    pendingInput = null;
+    inputQueue = [];
+    pending = new Map();
+    askId = 0;
+    constructor(port) {
+        this.port = port;
+    }
+    url() {
+        return `http://127.0.0.1:${this.port}/?k=${this.authToken}`;
+    }
+    start() {
+        this.server = http.createServer((req, res) => this.route(req, res));
+        this.server.listen(this.port, "127.0.0.1", () => {
+            console.log(`\n  smolcoder web UI:  ${this.url()}\n`);
+        });
+        process.on("SIGINT", () => this.onExit?.());
+    }
+    close() {
+        for (const c of this.clients)
+            c.end();
+        this.server?.close();
+    }
+    // ---- http ----------------------------------------------------------------
+    route(req, res) {
+        const url = new URL(req.url ?? "/", `http://127.0.0.1:${this.port}`);
+        const origin = req.headers.origin;
+        const sameOrigin = !origin || origin === `http://127.0.0.1:${this.port}` || origin === `http://localhost:${this.port}`;
+        if (url.searchParams.get("k") !== this.authToken || !sameOrigin) {
+            res.writeHead(403, { "content-type": "text/plain" });
+            res.end("forbidden — open smolcoder's printed URL (it includes the session key)");
+            return;
+        }
+        if (req.method === "GET" && url.pathname === "/") {
+            res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
+            res.end(page_1.PAGE_HTML);
+            return;
+        }
+        if (req.method === "GET" && url.pathname === "/events") {
+            res.writeHead(200, {
+                "content-type": "text/event-stream",
+                "cache-control": "no-cache",
+                connection: "keep-alive",
+            });
+            for (const line of this.replay)
+                res.write(line);
+            this.pushStateTo(res);
+            this.clients.add(res);
+            req.on("close", () => this.clients.delete(res));
+            return;
+        }
+        if (req.method === "POST") {
+            let body = "";
+            req.on("data", (d) => {
+                body += d;
+                if (body.length > 1_000_000)
+                    req.destroy();
+            });
+            req.on("end", () => {
+                let data = {};
+                try {
+                    data = body ? JSON.parse(body) : {};
+                }
+                catch {
+                    /* ignore */
+                }
+                this.handlePost(url.pathname, data);
+                res.writeHead(200, { "content-type": "application/json" });
+                res.end("{}");
+            });
+            return;
+        }
+        res.writeHead(404);
+        res.end();
+    }
+    handlePost(path, data) {
+        switch (path) {
+            case "/msg": {
+                const text = String(data.text ?? "").trim();
+                if (!text)
+                    return;
+                if (this.pendingInput) {
+                    const resolve = this.pendingInput;
+                    this.pendingInput = null;
+                    this.broadcast({ t: "user", s: text });
+                    resolve(text);
+                }
+                else {
+                    this.inputQueue.push(text);
+                }
+                break;
+            }
+            case "/confirm":
+            case "/select": {
+                const resolve = this.pending.get(Number(data.id));
+                if (resolve) {
+                    this.pending.delete(Number(data.id));
+                    resolve(path === "/confirm" ? data.answer : data.index);
+                }
+                break;
+            }
+            case "/cycle":
+                this.onModeCycle?.();
+                this.refresh();
+                break;
+            case "/cancel":
+                this.onCancel?.();
+                break;
+        }
+    }
+    // ---- event plumbing ------------------------------------------------------
+    broadcast(ev) {
+        const line = `data: ${JSON.stringify(ev)}\n\n`;
+        if (ev.t !== "busy" && ev.t !== "state") {
+            this.replay.push(line);
+            if (this.replay.length > 2000)
+                this.replay.shift();
+        }
+        for (const c of this.clients)
+            c.write(line);
+    }
+    pushStateTo(res) {
+        const line = `data: ${JSON.stringify({ t: "state", s: this.getState() })}\n\n`;
+        if (res)
+            res.write(line);
+        else
+            for (const c of this.clients)
+                c.write(line);
+    }
+    refresh() {
+        this.pushStateTo();
+    }
+    // ---- SessionUI -----------------------------------------------------------
+    readInput() {
+        this.pushStateTo();
+        if (this.inputQueue.length) {
+            const text = this.inputQueue.shift();
+            this.broadcast({ t: "user", s: text });
+            return Promise.resolve(text);
+        }
+        return new Promise((resolve) => (this.pendingInput = resolve));
+    }
+    select(title, options) {
+        const id = ++this.askId;
+        this.broadcast({ t: "select", id, title, options });
+        return new Promise((resolve) => this.pending.set(id, (i) => resolve(typeof i === "number" ? i : null)));
+    }
+    confirmCommand(command, reason) {
+        const id = ++this.askId;
+        this.broadcast({ t: "confirm", id, command, reason });
+        return new Promise((resolve) => this.pending.set(id, (a) => resolve(a === "always" ? "always" : a === "yes" ? "yes" : "no")));
+    }
+    // ---- AgentUI -------------------------------------------------------------
+    token(text) {
+        this.broadcast({ t: "token", s: text });
+    }
+    thinking(text) {
+        this.broadcast({ t: "thinking", s: text });
+    }
+    toolCall(name, args) {
+        this.broadcast({ t: "tool", name, summary: (0, ui_1.summarizeArgs)(name, args) });
+    }
+    toolResult(result) {
+        const lines = result.split("\n");
+        const first = lines[0] ?? "";
+        this.broadcast({
+            t: "result",
+            line: first.slice(0, 160),
+            err: first.startsWith("Error"),
+            extra: lines.length > 1 ? lines.length - 1 : 0,
+        });
+    }
+    planUpdated(plan) {
+        this.broadcast({ t: "plan", steps: plan.steps, current: plan.currentIndex });
+        this.pushStateTo();
+    }
+    println(s = "") {
+        if (s.trim())
+            this.broadcast({ t: "line", kind: "status", s: stripAnsi(s) });
+    }
+    status(s) {
+        this.broadcast({ t: "line", kind: "status", s: stripAnsi(s) });
+    }
+    warn(s) {
+        this.broadcast({ t: "line", kind: "warn", s: stripAnsi(s) });
+    }
+    error(s) {
+        this.broadcast({ t: "line", kind: "error", s: stripAnsi(s) });
+    }
+    turnEnd(label) {
+        this.broadcast({ t: "turnend", label });
+        this.pushStateTo();
+    }
+    startSpinner(label) {
+        this.broadcast({ t: "busy", label });
+    }
+    stopSpinner() {
+        this.broadcast({ t: "busy", label: null });
+    }
+}
+exports.WebUI = WebUI;
+function stripAnsi(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;]*m/g, "");
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "smolcoder",
+  "version": "0.4.0",
+  "description": "A smol, zero-config CLI coding agent for local models (Ollama & LM Studio). It just works.",
+  "keywords": [
+    "cli",
+    "coding-agent",
+    "agent",
+    "ollama",
+    "lm-studio",
+    "local-llm",
+    "local-models",
+    "smol",
+    "ai"
+  ],
+  "license": "MIT",
+  "author": "Leon van Zyl",
+  "homepage": "https://github.com/leonvanzyl/smolcoder#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leonvanzyl/smolcoder.git"
+  },
+  "bugs": {
+    "url": "https://github.com/leonvanzyl/smolcoder/issues"
+  },
+  "bin": {
+    "smol": "dist/index.js",
+    "smolcoder": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "prepublishOnly": "tsc && node --test",
+    "test": "tsc && node --test"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0"
+  }
+}