llm_meta_widget 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6113516f03758b2dc602dd4f2e62b515206821b710c646c07faf474e1f9aa48
-  data.tar.gz: 5d65ceb25848ba253dfc61f92f04ed6f1110581fa5c3b7640c26718f2c4c4e51
+  metadata.gz: f019c93684d03e4f65ead3c8427b369af41caf2b9f4b0637f60aa2014239f080
+  data.tar.gz: 28bf06bc291b4bc0f745b85ae7f067f9e9c3f8adfd4902d747a4496d1b2e34da
 SHA512:
-  metadata.gz: 6b255c67fa8f44ccc1a7fcb71a2ccb149bf1e02f1441c7bbda31a22502f98c491902dd978c7817e411af5865a54557a89581ec36dbd64e41ada6a1722397d04d
-  data.tar.gz: dd5fa208a4fbb758fdcf7b9683f6102ea49b99270fd5a0e49182ab7eb21966705b6aca5ae7ee746694dd3a019ef6bdf662d0d24f57551dd2a8b86e0921cee0cd
+  metadata.gz: 50a79ea50cd118b4cafb1a26ff5af6713fd6b98dd1374ad4a2b2fa10fff24677fe417cee3b4cf4d900e121b3b4be3c013fcbc1aa95d4183f714e629a100432c8
+  data.tar.gz: 1bbed09f23f1c5c7f9b08500db77d2dd1b7ba97e1b564405b40f8cadd9fb1bac920a4d612e187119d08cd90db51301b96dc8d3d3ad22e0196adc04b5ee1621c7

data/README.md

@@ -232,6 +232,23 @@ To lock the widget to the fixed `model:` prop and disable Class-1 tools entirely
 | `models:` | `nil` | Model-name allowlist; `nil` = all anon-available |
 | `hub_tools:` | `nil` | MCP-server-name allowlist; `nil` = all anon-public |
 
+## Surviving navigation
+
+A page action that navigates — submitting a form, following a link — no longer
+loses the conversation. The transcript, the record of which tools ran, and the
+model's own context are kept in `sessionStorage`: per tab, gone when the tab
+closes, never sent anywhere.
+
+The key is the page's **path**, not its full URL, so a form submit that returns
+to the same page with a new query string keeps the thread, while moving to a
+different page starts a fresh one. Nothing to configure.
+
+Two consequences worth knowing. An action of yours that navigates is now safe
+to declare — before this, offering one meant offering to wipe the visitor's
+chat. And if the navigation lands on an error page that does not render the
+widget, the conversation is still in storage but there is no panel to show it
+until the visitor returns to a page that has one.
+
 ## Choosing what answers the chat, and whose tools to offer
 
 Two independent settings, because they are two jobs. Neither implies the

data/app/assets/javascripts/llm_meta_widget/orchestrator.js

@@ -1185,3 +1185,74 @@ export async function fetchOllamaModels({ baseUrl, signal }) {
     return []
   }
 }
+
+// ---- surviving navigation ------------------------------------------------
+//
+// A page action that navigates — submitting a form, following a link — used to
+// destroy the conversation, the record of what ran and the scroll position.
+// That made such actions unsafe to offer at all: PubDictionaries had to stop
+// declaring its submit action rather than let the assistant wipe the chat.
+//
+// The transcript is kept in sessionStorage: per tab, gone when the tab closes,
+// invisible to other visitors. Keyed by pathname rather than full URL, because
+// submitting a form usually returns to the same page with different query
+// parameters and that is exactly the case worth surviving.
+
+export const CONVERSATION_FORMAT = 1
+
+export function packConversation({ turns = [], open = false, model = null,
+                                   maxTurns = 40, maxBytes = 200000 } = {}) {
+  // Oldest turns go first when trimming: the recent ones carry the thread.
+  let kept = turns.slice(-maxTurns)
+  let payload = { v: CONVERSATION_FORMAT, savedAt: Date.now(), open, model, turns: kept }
+  let json = JSON.stringify(payload)
+
+  while (json.length > maxBytes && kept.length > 1) {
+    kept = kept.slice(1)
+    payload = { ...payload, turns: kept }
+    json = JSON.stringify(payload)
+  }
+  return json
+}
+
+export function unpackConversation(raw) {
+  if (!raw) return null
+  let payload
+  try {
+    payload = JSON.parse(raw)
+  } catch (e) {
+    return null
+  }
+  // A payload from a different format is not worth guessing at; starting
+  // fresh is better than rendering something half-understood.
+  if (!payload || payload.v !== CONVERSATION_FORMAT || !Array.isArray(payload.turns)) return null
+
+  const turns = payload.turns.filter((t) => t && typeof t.content === "string" &&
+                                            (t.role === "user" || t.role === "assistant"))
+  return { turns, open: !!payload.open, model: payload.model || null, savedAt: payload.savedAt || 0 }
+}
+
+// Storage can throw — private windows, blocked site data, quota — and none of
+// that is a reason for the widget to stop working.
+export function createConversationStore({ storage, key }) {
+  const safely = (fn, fallback = null) => {
+    try {
+      return fn()
+    } catch (e) {
+      return fallback
+    }
+  }
+
+  return {
+    key,
+    save(state) { return safely(() => { storage.setItem(key, packConversation(state)); return true }, false) },
+    load() { return safely(() => unpackConversation(storage.getItem(key))) },
+    clear() { return safely(() => { storage.removeItem(key); return true }, false) }
+  }
+}
+
+export function conversationKeyFor(location, prefix = "llm_meta_widget") {
+  // Path only: a form submit returns to the same page with a new query string,
+  // and that conversation is still the same conversation.
+  return `${prefix}:${location.pathname}`
+}

data/app/views/llm_meta_widget/_chat_panel.html.erb

@@ -452,7 +452,8 @@
 	import { runChatLoop, fetchMcpManifest, listMcpPrompts, getMcpPrompt,
 	         listMcpResources, readMcpResource, promptMessagesToText,
 	         loadHostResource, resourceLinesForTurn, resolvePromptArguments,
-	         promptButtonProps, promptArgumentSummary, fetchOllamaModels } from "<%= orchestrator_path %>";
+	         promptButtonProps, promptArgumentSummary, fetchOllamaModels,
+	         createConversationStore, conversationKeyFor } from "<%= orchestrator_path %>";
 	import { marked } from "/llm_meta_widget_assets/marked.esm.js";
 
 	// Standard prose settings — GFM (tables, autolinks, strikethrough),
@@ -576,7 +577,26 @@
 		ro.observe(root);
 	}
 
-	var conversation = [];  // [{role, content}, ...] — grows across turns
+	// [{role, content, tools}] — grows across turns. `tools` is for the
+	// transcript only; the model is sent role and content.
+	var conversation = [];
+
+	// A page action that navigates used to take the conversation with it. The
+	// transcript lives in sessionStorage — per tab, gone when the tab closes —
+	// keyed by path, so submitting a form and landing back on the same page
+	// with a new query string keeps the thread.
+	var conversationStore = createConversationStore({
+		storage: window.sessionStorage,
+		key:     conversationKeyFor(window.location)
+	});
+
+	function persistConversation() {
+		conversationStore.save({
+			turns: conversation,
+			open:  !root.classList.contains("lmw-collapsed"),
+			model: MODEL
+		});
+	}
 	var actionsSchemaEl = document.getElementById(ACTIONS_SCHEMA_ID);
 	var localTools = actionsSchemaEl ? JSON.parse(actionsSchemaEl.textContent) : [];
 	var remoteToolsEl = document.getElementById(REMOTE_TOOLS_SCHEMA_ID);
@@ -845,6 +865,10 @@
 	var RESOURCE_BUDGET_BYTES = 8000;
 
 
+	// Before anything asynchronous: if this page was navigated away from and
+	// back, the visitor should see their conversation immediately.
+	restoreConversation();
+
 	var wellKnownReady = (async function() {
 		var urls = WELL_KNOWN_URLS === null
 			? [ window.location.origin + "/.well-known/mcp.json" ]
@@ -921,11 +945,39 @@
 		promptsEl.style.display = "";
 	}
 
+	// Put a saved transcript back on screen: the same bubbles, the same
+	// markdown, and the same record of which tools ran. Called once at boot,
+	// before the welcome block, which is only for a genuinely fresh start.
+	function restoreConversation() {
+		var saved = conversationStore.load();
+		if (!saved || !saved.turns.length) return false;
+
+		conversation = saved.turns;
+		saved.turns.forEach(function(turn) {
+			var body = appendTurn(turn.role, turn.role === "assistant" ? "" : turn.content);
+			if (turn.role === "assistant") renderMarkdownInto(body, turn.content || "");
+			if (!turn.tools || !turn.tools.length) return;
+			var row = document.createElement("div");
+			row.className = "lmw-tool-chips";
+			turn.tools.forEach(function(tool) {
+				var chip = document.createElement("span");
+				chip.className = "lmw-tool-chip" + (tool.error ? " error" : "");
+				chip.textContent = (tool.error ? "❌ " : "🔧 ") + tool.name;
+				row.appendChild(chip);
+			});
+			if (body.parentNode) body.parentNode.appendChild(row);
+		});
+		historyEl.scrollTop = historyEl.scrollHeight;
+		return true;
+	}
+
 	// A blank panel tells a first-time visitor nothing. Open with a greeting
 	// and the offers themselves — each template showing what it will take from
 	// the page and what it will ask for — so the assistant is the page's way
 	// in rather than a box you must already know how to talk to.
 	function renderWelcome() {
+		// A restored transcript is not a fresh start; the greeting would push
+		// the conversation the visitor is mid-way through off the screen.
 		if (!historyEl || historyEl.querySelector(".message")) return;
 		historyEl.textContent = "";
 
@@ -1238,6 +1290,7 @@
 	clearBtn.addEventListener("click", function() {
 		if (currentAbort) { try { currentAbort.abort(); } catch (e) { /* noop */ } }
 		conversation = [];
+		conversationStore.clear();
 		historyEl.innerHTML = "";
 		renderWelcome();
 	});
@@ -1280,7 +1333,7 @@
 
 			var resourceLines = await resourceLinesForThisTurn();
 			var messages = [{ role: "system", content: currentSystemPrompt(resourceLines) }]
-				.concat(conversation)
+				.concat(conversation.map(function(t) { return { role: t.role, content: t.content }; }))
 				.concat([{ role: "user", content: userText }]);
 
 			var result = await runChatLoop({
@@ -1331,8 +1384,17 @@
 					historyEl.scrollTop = historyEl.scrollHeight;
 				}
 			});
-			conversation.push({ role: "user",      content: userText });
-			conversation.push({ role: "assistant", content: result.content });
+			conversation.push({ role: "user", content: userText });
+			conversation.push({
+				role:    "assistant",
+				content: result.content,
+				// Kept so a restored transcript still shows what ran — losing
+				// that record is what made a navigating action unbearable.
+				tools:   result.dispatched.map(function(d) {
+					return d.error ? { name: d.toolCall.name, error: true } : { name: d.toolCall.name };
+				})
+			});
+			persistConversation();
 
 			// Anything still pending never reported an outcome (a class that
 			// does not round-trip, or a dispatch that vanished). Reconcile

data/lib/llm_meta_widget/version.rb

@@ -1,3 +1,3 @@
 module LlmMetaWidget
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm_meta_widget
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - jdkim