@sean.holung/minicode 0.3.8 → 0.3.9

package/dist/src/serve/agent-bridge.js

@@ -8,7 +8,7 @@ import { computeFileHashes, getWorkspaceCacheDir, loadIndex, saveIndex, } from "
 import { buildProjectIndex } from "../indexer/project-index.js";
 import { sortModelsAlphabetically } from "../model-utils.js";
 import { createToolRegistry } from "../tools/registry.js";
-import { listSessions, loadSession, loadSessionByLabel, saveSession, } from "../session/session-store.js";
+import { deleteSession, listSessions, loadSession, loadSessionByLabel, saveSession, } from "../session/session-store.js";
 import { getSymbolDisplayName } from "../indexer/symbol-names.js";
 export class AgentBridge {
     agent;
@@ -349,6 +349,9 @@ export class AgentBridge {
     async listSess() {
         return listSessions();
     }
+    async deleteSess(sessionId) {
+        return deleteSession(sessionId);
+    }
     // ── Project index queries ──
     hasIndex() {
         return this.projectIndex !== undefined;

package/dist/src/serve/server.js

@@ -473,6 +473,20 @@ export function createRequestHandler(bridge, emit, options = {}) {
                 });
                 return;
             }
+            if (pathname.startsWith("/api/sessions/") && method === "DELETE") {
+                const sessionId = decodeURIComponent(pathname.slice("/api/sessions/".length));
+                if (!sessionId) {
+                    sendJson(res, 400, { error: "Session id is required" });
+                    return;
+                }
+                const deleted = await bridge.deleteSess(sessionId);
+                if (!deleted) {
+                    sendJson(res, 404, { error: "Session not found" });
+                    return;
+                }
+                sendJson(res, 200, { ok: true, deleted: true, id: sessionId });
+                return;
+            }
             // ── Graph / Index API ──
             if (pathname === "/api/symbols" && method === "GET") {
                 if (!bridge.hasIndex()) {

package/dist/src/session/session-store.js

@@ -1,4 +1,4 @@
-import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { mkdir, readdir, readFile, unlink, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { Session } from "@minicode/agent-sdk";
@@ -100,3 +100,13 @@ export async function loadSessionByLabel(label) {
         return undefined;
     return loadSession(match.id);
 }
+export async function deleteSession(sessionId) {
+    const filePath = path.join(sessionsDir, `${sessionId}.json`);
+    try {
+        await unlink(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/src/web/app.js

@@ -2950,6 +2950,7 @@ var sessionDropdown = document.getElementById("session-dropdown");
 var sessionList = document.getElementById("session-list");
 var sessionUpdateRow = document.getElementById("session-update-row");
 var sessionUpdateBtn = document.getElementById("session-update-btn");
+var sessionAutoSaveToggle = document.getElementById("session-autosave-toggle");
 var saveBtn = document.getElementById("save-btn");
 var saveLabelInput = document.getElementById("save-label");
 var contextFill = document.getElementById("context-fill");
@@ -3010,6 +3011,8 @@ var sessionRefreshTracker = createLatestRequestTracker();
 var TOOL_RESULT_MAX = 500;
 var OPENROUTER_PKCE_VERIFIER_KEY = "minicode:openrouter:pkce-verifier";
 var OPENROUTER_PERSIST_TO_ENV_KEY = "minicode:openrouter:persist-to-env";
+var SESSION_AUTOSAVE_KEY = "minicode:session:auto-save";
+var SESSION_AUTOSAVE_LABEL_PREFIX = "Autosave";
 var OPENAI_COMPATIBLE_PRESETS = {
   lmstudio: {
     baseUrl: "http://localhost:1234/v1",
@@ -3032,6 +3035,11 @@ var OPENAI_COMPATIBLE_PRESETS = {
     apiKeyPlaceholder: "Add an API key only if this endpoint requires auth"
   }
 };
+var sessionAutoSaveEnabled = loadSessionAutoSavePreference();
+var pendingAutoSaveLabel = null;
+var autoSaveInFlight = null;
+var autoSaveQueued = false;
+sessionAutoSaveToggle.checked = sessionAutoSaveEnabled;
 function connect() {
   const protocol = location.protocol === "https:" ? "wss:" : "ws:";
   ws = new WebSocket(`${protocol}//${location.host}`);
@@ -3422,6 +3430,7 @@ function handleServerMessage(msg) {
       if (msg.usage) {
         addUsageInfo(msg.usage);
       }
+      queueSessionAutoSave();
       break;
     case "error":
       addMessage(`Error: ${msg.message || ""}`, "error");
@@ -3568,7 +3577,8 @@ function updateContextIndicator(contextTokens, maxContextTokens) {
   }
   contextLabel.textContent = pct + "%";
   const indicator = document.getElementById("context-indicator");
-  indicator.title = `Context: ~${contextTokens.toLocaleString()} / ${maxContextTokens.toLocaleString()} tokens (${pct}%)`;
+  indicator.title = `Context: ~${contextTokens.toLocaleString()} / ${maxContextTokens.toLocaleString()} tokens (${pct}%)
+Adjust context size in Settings if you want it larger or smaller.`;
 }
 async function fetchContext() {
   try {
@@ -4040,23 +4050,122 @@ document.addEventListener("click", (e) => {
     sessionDropdown.classList.add("hidden");
   }
 });
+function loadSessionAutoSavePreference() {
+  try {
+    return localStorage.getItem(SESSION_AUTOSAVE_KEY) === "1";
+  } catch {
+    return false;
+  }
+}
+function persistSessionAutoSavePreference(enabled) {
+  try {
+    if (enabled) {
+      localStorage.setItem(SESSION_AUTOSAVE_KEY, "1");
+    } else {
+      localStorage.removeItem(SESSION_AUTOSAVE_KEY);
+    }
+  } catch {
+  }
+}
+function buildAutoSaveLabel() {
+  return `${SESSION_AUTOSAVE_LABEL_PREFIX} ${(/* @__PURE__ */ new Date()).toLocaleString()}`;
+}
+async function persistCurrentSession(label) {
+  const res = await fetch("/api/sessions/save", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ label })
+  });
+  const body = await res.json();
+  if (!res.ok) {
+    throw new Error("error" in body ? body.error : `Failed to save session (${res.status})`);
+  }
+  return body;
+}
+async function deleteSavedSession(session) {
+  const isCurrentSavedSession = activeSavedSession?.id === session.id;
+  const confirmed = window.confirm(`Delete saved session "${session.label}"?`);
+  if (!confirmed) {
+    return;
+  }
+  try {
+    const res = await fetch(`/api/sessions/${encodeURIComponent(session.id)}`, {
+      method: "DELETE"
+    });
+    const body = await res.json();
+    if (!res.ok) {
+      throw new Error("error" in body ? body.error : `Failed to delete session (${res.status})`);
+    }
+    if (isCurrentSavedSession) {
+      activeSavedSession = null;
+    }
+    if (pendingAutoSaveLabel === session.label) {
+      pendingAutoSaveLabel = null;
+    }
+    addMessage(
+      isCurrentSavedSession ? `Deleted saved session "${session.label}". The current chat stays open until you load another session or refresh.` : `Session deleted: "${session.label}"`,
+      "thinking"
+    );
+    await refreshSessionList();
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Failed to delete session";
+    addMessage(message, "error");
+  }
+}
+async function maybeAutoSaveSession() {
+  if (!sessionAutoSaveEnabled) {
+    return;
+  }
+  const label = activeSavedSession?.label ?? pendingAutoSaveLabel ?? buildAutoSaveLabel();
+  try {
+    const data = await persistCurrentSession(label);
+    pendingAutoSaveLabel = data.label;
+    await refreshSessionList();
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Failed to auto-save session";
+    addMessage(message, "error");
+  }
+}
+function queueSessionAutoSave() {
+  if (!sessionAutoSaveEnabled) {
+    return;
+  }
+  if (autoSaveInFlight) {
+    autoSaveQueued = true;
+    return;
+  }
+  autoSaveInFlight = (async () => {
+    await maybeAutoSaveSession();
+  })();
+  void autoSaveInFlight.finally(() => {
+    autoSaveInFlight = null;
+    if (autoSaveQueued) {
+      autoSaveQueued = false;
+      queueSessionAutoSave();
+    }
+  });
+}
+sessionAutoSaveToggle.addEventListener("change", () => {
+  sessionAutoSaveEnabled = sessionAutoSaveToggle.checked;
+  persistSessionAutoSavePreference(sessionAutoSaveEnabled);
+  if (sessionAutoSaveEnabled) {
+    addMessage(
+      activeSavedSession ? `Auto-save enabled. minicode will update "${activeSavedSession.label}" after each completed turn.` : "Auto-save enabled. minicode will save this chat after the next completed turn.",
+      "thinking"
+    );
+  } else {
+    addMessage("Auto-save disabled.", "thinking");
+  }
+});
 saveBtn.addEventListener("click", async () => {
   const requestedLabel = saveLabelInput.value.trim();
   const label = requestedLabel || activeSavedSession?.label || void 0;
   const isUpdatingCurrentSession = !!activeSavedSession && (requestedLabel.length === 0 || requestedLabel === activeSavedSession.label);
   try {
     saveBtn.setAttribute("disabled", "true");
-    const res = await fetch("/api/sessions/save", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ label })
-    });
-    const body = await res.json();
-    if (!res.ok) {
-      throw new Error("error" in body ? body.error : `Failed to save session (${res.status})`);
-    }
-    const data = body;
+    const data = await persistCurrentSession(label);
     saveLabelInput.value = "";
+    pendingAutoSaveLabel = data.label;
     addMessage(
       `${isUpdatingCurrentSession ? "Session updated" : "Session saved"}: "${data.label}"`,
       "thinking"
@@ -4086,6 +4195,7 @@ async function refreshSessionList() {
     const sessions = data.sessions;
     activeSavedSession = sessions.find((session) => session.id === data.currentSessionId) ?? null;
     if (activeSavedSession) {
+      pendingAutoSaveLabel = activeSavedSession.label;
       sessionUpdateRow.classList.remove("hidden");
       sessionUpdateBtn.textContent = `Update "${activeSavedSession.label}"`;
       sessionUpdateBtn.title = `Save changes back to "${activeSavedSession.label}"`;
@@ -4103,8 +4213,22 @@ async function refreshSessionList() {
       const el = document.createElement("div");
       const isActive = activeSavedSession?.id === s.id;
       el.className = "session-item" + (isActive ? " active" : "");
-      el.innerHTML = `<span class="session-label">${escapeHtml(s.label)}</span><span class="session-meta">${s.messageCount} msgs${isActive ? ' <span class="session-active-badge">\u2022 active</span>' : ""}</span>`;
-      el.addEventListener("click", () => loadSession(s.label));
+      const loadBtn = document.createElement("button");
+      loadBtn.type = "button";
+      loadBtn.className = "session-load-btn";
+      loadBtn.innerHTML = `<span class="session-label">${escapeHtml(s.label)}</span><span class="session-meta">${s.messageCount} msgs${isActive ? ' <span class="session-active-badge">\u2022 active</span>' : ""}</span>`;
+      loadBtn.addEventListener("click", () => loadSession(s.label));
+      const deleteBtn = document.createElement("button");
+      deleteBtn.type = "button";
+      deleteBtn.className = "session-delete-btn";
+      deleteBtn.textContent = "Delete";
+      deleteBtn.title = `Delete "${s.label}"`;
+      deleteBtn.addEventListener("click", (event) => {
+        event.stopPropagation();
+        void deleteSavedSession(s);
+      });
+      el.appendChild(loadBtn);
+      el.appendChild(deleteBtn);
       sessionList.appendChild(el);
     }
   } catch {
@@ -4126,6 +4250,7 @@ async function loadSession(label) {
     if (res.ok) {
       const body = await res.json();
       sessionDropdown.classList.add("hidden");
+      pendingAutoSaveLabel = body.label;
       renderLoadedSessionMessages(body.messages);
       if (body.messages.length === 0) {
         addMessage(`Session "${body.label}" restored`, "thinking");
@@ -4141,16 +4266,8 @@ sessionUpdateBtn.addEventListener("click", async () => {
   }
   try {
     sessionUpdateBtn.disabled = true;
-    const res = await fetch("/api/sessions/save", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ label: activeSavedSession.label })
-    });
-    const body = await res.json();
-    if (!res.ok) {
-      throw new Error("error" in body ? body.error : `Failed to update session (${res.status})`);
-    }
-    const data = body;
+    const data = await persistCurrentSession(activeSavedSession.label);
+    pendingAutoSaveLabel = data.label;
     addMessage(`Session updated: "${data.label}"`, "thinking");
     await refreshSessionList();
   } catch (error) {

package/dist/src/web/index.html

@@ -16,7 +16,7 @@
       <div class="header-left">
         <h1>minicode</h1>
         <span id="status-badge" class="badge ready">ready</span>
-        <div id="context-indicator" title="Context window usage">
+        <div id="context-indicator" title="Context window usage. Adjust context size in Settings if you want it larger or smaller.">
           <div id="context-bar">
             <div id="context-fill"></div>
           </div>
@@ -45,6 +45,10 @@
               <div id="session-update-row" class="session-update-row hidden">
                 <button id="session-update-btn" class="dropdown-action" type="button">Update current saved session</button>
               </div>
+              <label id="session-autosave-row" class="session-autosave-row" title="Automatically save or update this chat after each completed turn.">
+                <input id="session-autosave-toggle" type="checkbox" />
+                <span>Auto-save after each turn</span>
+              </label>
               <div class="dropdown-row">
                 <input id="save-label" type="text" placeholder="Label (optional)" />
                 <button id="save-btn" class="dropdown-action">Save</button>

package/dist/src/web/style.css

@@ -222,6 +222,20 @@ h1 {
   margin-bottom: 8px;
 }
 
+.session-autosave-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 8px;
+  font-size: 12px;
+  color: var(--text-dim);
+  cursor: pointer;
+}
+
+.session-autosave-row input {
+  accent-color: var(--accent);
+}
+
 .dropdown-divider {
   height: 1px;
   background: var(--border);
@@ -275,10 +289,8 @@ h1 {
 .session-item {
   display: flex;
   align-items: center;
-  justify-content: space-between;
-  padding: 6px 8px;
+  gap: 8px;
   border-radius: 4px;
-  cursor: pointer;
   font-size: 12px;
   transition: background 0.15s;
 }
@@ -292,6 +304,28 @@ h1 {
   outline: 1px solid rgba(122, 162, 247, 0.35);
 }
 
+.session-load-btn {
+  flex: 1;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  width: 100%;
+  padding: 6px 8px;
+  background: transparent;
+  border: none;
+  color: inherit;
+  font: inherit;
+  text-align: left;
+  cursor: pointer;
+}
+
+.session-load-btn:focus-visible,
+.session-delete-btn:focus-visible {
+  outline: 1px solid var(--accent);
+  outline-offset: 1px;
+}
+
 .session-label {
   color: var(--text);
   overflow: hidden;
@@ -310,6 +344,26 @@ h1 {
   color: var(--accent);
 }
 
+.session-delete-btn {
+  flex-shrink: 0;
+  margin: 4px 6px 4px 0;
+  padding: 4px 8px;
+  background: transparent;
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  color: var(--text-dim);
+  font-family: var(--font-mono);
+  font-size: 11px;
+  cursor: pointer;
+  transition: color 0.15s, border-color 0.15s, background 0.15s;
+}
+
+.session-delete-btn:hover {
+  color: var(--red);
+  border-color: rgba(247, 118, 142, 0.55);
+  background: rgba(247, 118, 142, 0.08);
+}
+
 .badge {
   font-size: 11px;
   padding: 2px 8px;

package/dist/tests/context-indicator.test.js

@@ -1,11 +1,14 @@
 import assert from "node:assert/strict";
 import { test, afterEach } from "node:test";
 import { createServer } from "node:http";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
 import { createRequestHandler } from "../src/serve/server.js";
 import { AgentBridge } from "../src/serve/agent-bridge.js";
 import { CodingAgent, ToolRegistry, } from "@minicode/agent-sdk";
 import { UiStore } from "../src/ui/state/ui-store.js";
 import { createTestAgentConfig } from "./test-utils.js";
+const distWeb = join(import.meta.dirname, "..", "dist", "src", "web");
 // ── Mock model client ──
 class SequenceModelClient {
     responses;
@@ -111,6 +114,12 @@ test("GET /api/context reflects updated context state", async () => {
     assert.equal(body.contextTokens, 8000);
     assert.equal(body.maxContextTokens, 16000);
 });
+test("built web UI explains that context size can be adjusted in Settings", () => {
+    const html = readFileSync(join(distWeb, "index.html"), "utf8");
+    const js = readFileSync(join(distWeb, "app.js"), "utf8");
+    assert.ok(html.includes("Context window usage. Adjust context size in Settings"), "HTML should provide a helpful default tooltip for the context indicator");
+    assert.ok(js.includes("Adjust context size in Settings if you want it larger or smaller."), "JS should include guidance about adjusting context size in Settings");
+});
 // ── Agent emits context_status UiUpdate ──
 test("agent emits context_status UiUpdate during turn", async () => {
     const config = createTestAgentConfig("/tmp/test-workspace");

package/dist/tests/serve.integration.test.js

@@ -24,6 +24,7 @@ class MockBridge extends AgentBridge {
     openAiCompatibleApiKey;
     openAiCompatibleSessionActive = false;
     refreshIndexCount = 0;
+    deletedSessionIds = [];
     constructor() {
         super(() => { }, false);
     }
@@ -89,6 +90,13 @@ class MockBridge extends AgentBridge {
         }
         return { session, label };
     }
+    async deleteSess(sessionId) {
+        if (sessionId !== "sess-1") {
+            return false;
+        }
+        this.deletedSessionIds.push(sessionId);
+        return true;
+    }
     getCurrentSessionId() {
         return this._currentSessionId;
     }
@@ -536,6 +544,29 @@ test("POST /api/sessions/load returns success for known session", async () => {
     assert.equal(body.messages[9]?.content, "message-11");
     assert.ok(body.messages.every((message) => !message.content.startsWith("[Conversation Summary")));
 });
+test("DELETE /api/sessions/:id deletes a saved session", async () => {
+    const bridge = new MockBridge();
+    const base = await startTestServer(bridge);
+    const res = await fetch(`${base}/api/sessions/sess-1`, {
+        method: "DELETE",
+    });
+    assert.equal(res.status, 200);
+    const body = (await res.json());
+    assert.equal(body.ok, true);
+    assert.equal(body.deleted, true);
+    assert.equal(body.id, "sess-1");
+    assert.deepEqual(bridge.deletedSessionIds, ["sess-1"]);
+});
+test("DELETE /api/sessions/:id returns 404 for unknown session", async () => {
+    const bridge = new MockBridge();
+    const base = await startTestServer(bridge);
+    const res = await fetch(`${base}/api/sessions/missing`, {
+        method: "DELETE",
+    });
+    assert.equal(res.status, 404);
+    const body = (await res.json());
+    assert.match(body.error, /Session not found/);
+});
 test("POST /api/chat returns agent response", async () => {
     const bridge = new MockBridge();
     const base = await startTestServer(bridge);

package/dist/tests/session-store.test.js

@@ -4,7 +4,7 @@ import { mkdtemp, readdir, rm } from "node:fs/promises";
 import path from "node:path";
 import os from "node:os";
 import { Session } from "@minicode/agent-sdk";
-import { DuplicateSessionLabelError, listSessions, loadSession, loadSessionByLabel, saveSession, setSessionsDir, } from "../src/session/session-store.js";
+import { deleteSession, DuplicateSessionLabelError, listSessions, loadSession, loadSessionByLabel, saveSession, setSessionsDir, } from "../src/session/session-store.js";
 async function withTmpDir(fn) {
     const dir = await mkdtemp(path.join(os.tmpdir(), "minicode-test-"));
     setSessionsDir(dir);
@@ -127,3 +127,20 @@ test("saving same session twice overwrites the file", async () => {
         assert.equal(result.session.getMessages().length, 2);
     });
 });
+test("deleteSession removes the saved session file", async () => {
+    await withTmpDir(async (dir) => {
+        const session = new Session("test-id");
+        session.addMessage({ role: "user", content: "hello" });
+        await saveSession(session, "delete me");
+        const deleted = await deleteSession("test-id");
+        assert.equal(deleted, true);
+        const files = await readdir(dir);
+        assert.equal(files.length, 0);
+    });
+});
+test("deleteSession returns false for a missing session", async () => {
+    await withTmpDir(async () => {
+        const deleted = await deleteSession("missing-session");
+        assert.equal(deleted, false);
+    });
+});

package/dist/tests/session-ui.test.js

@@ -7,11 +7,14 @@ test("built HTML contains update action for the current saved session", () => {
     const html = readFileSync(join(distWeb, "index.html"), "utf8");
     assert.ok(html.includes('id="session-update-row"'), "HTML should contain the session update row");
     assert.ok(html.includes('id="session-update-btn"'), "HTML should contain the session update button");
+    assert.ok(html.includes('id="session-autosave-toggle"'), "HTML should contain the auto-save sessions toggle");
 });
 test("built CSS contains active-session styling", () => {
     const css = readFileSync(join(distWeb, "style.css"), "utf8");
     assert.ok(css.includes(".session-item.active"), "CSS should style the active saved session row");
     assert.ok(css.includes(".session-active-badge"), "CSS should style the active session badge");
+    assert.ok(css.includes(".session-delete-btn"), "CSS should style the session delete button");
+    assert.ok(css.includes(".session-autosave-row"), "CSS should style the auto-save toggle row");
 });
 test("built JS contains active saved session update logic", () => {
     const js = readFileSync(join(distWeb, "app.js"), "utf8");
@@ -22,4 +25,7 @@ test("built JS contains active saved session update logic", () => {
     assert.ok(js.includes('saveBtn.setAttribute("disabled", "true")'), "JS should disable saving while the first save is in flight");
     assert.ok(js.includes("renderLoadedSessionMessages"), "JS should render session previews after load");
     assert.ok(js.includes("body.messages"), "JS should read preview messages from the load session response");
+    assert.ok(js.includes("SESSION_AUTOSAVE_KEY"), "JS should persist the auto-save preference");
+    assert.ok(js.includes("window.confirm"), "JS should confirm before deleting a saved session");
+    assert.ok(js.includes('method: "DELETE"'), "JS should call the delete session API");
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sean.holung/minicode",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "workspaces": [
     "packages/*"
   ],