granola-toolkit 0.19.0 → 0.20.0

package/README.md

@@ -192,6 +192,7 @@ The initial server API includes:
 - `GET /state`
 - `GET /events` for server-sent state updates
 - `GET /meetings`
+- `GET /meetings/resolve?q=<query>`
 - `GET /meetings/:id`
 - `POST /exports/notes`
 - `POST /exports/transcripts`
@@ -205,9 +206,12 @@ This is the foundation for the future `granola web` client and any attachable TU
 The initial browser client includes:
 
 - a searchable meeting list
+- sort and updated-date filters
+- quick open by meeting id or title
 - a meeting detail view with notes and transcript panes
 - app-state status from the shared core
 - note and transcript export actions backed by the same local API
+- stronger empty and error states for list/detail failures
 
 ## Auth
 

package/dist/cli.js

@@ -1275,6 +1275,17 @@ function compareTimestampsDescending(left, right) {
 function compareMeetingDocuments(left, right) {
 	return compareTimestampsDescending(latestDocumentTimestamp(left), latestDocumentTimestamp(right)) || compareTimestampsDescending(left.createdAt, right.createdAt) || compareStrings(left.title || left.id, right.title || right.id) || compareStrings(left.id, right.id);
 }
+function compareMeetingDocumentsByTitle(left, right) {
+	return compareStrings(left.title || left.id, right.title || right.id) || compareTimestampsDescending(latestDocumentTimestamp(left), latestDocumentTimestamp(right)) || compareStrings(left.id, right.id);
+}
+function compareMeetingDocumentsBySort(left, right, sort) {
+	switch (sort) {
+		case "title-asc": return compareMeetingDocumentsByTitle(left, right);
+		case "title-desc": return -compareMeetingDocumentsByTitle(left, right);
+		case "updated-asc": return -compareMeetingDocuments(left, right);
+		default: return compareMeetingDocuments(left, right);
+	}
+}
 function serialiseNote(note) {
 	return {
 		content: note.content,
@@ -1338,6 +1349,23 @@ function matchesMeetingSearch(document, search) {
 		...document.tags
 	].some((value) => value.toLowerCase().includes(query));
 }
+function parseDateFilter(value, label) {
+	const trimmed = value?.trim();
+	if (!trimmed) return;
+	const candidate = /^\d{4}-\d{2}-\d{2}$/.test(trimmed) ? `${trimmed}T${label === "updatedFrom" ? "00:00:00.000" : "23:59:59.999"}` : trimmed;
+	const timestamp = Date.parse(candidate);
+	if (Number.isNaN(timestamp)) throw new Error(`invalid ${label}: expected ISO timestamp or YYYY-MM-DD`);
+	return timestamp;
+}
+function matchesUpdatedRange(document, updatedFrom, updatedTo) {
+	const from = parseDateFilter(updatedFrom, "updatedFrom");
+	const to = parseDateFilter(updatedTo, "updatedTo");
+	const updatedAt = parseTimestamp(latestDocumentTimestamp(document));
+	if (updatedAt == null) return from == null && to == null;
+	if (from != null && updatedAt < from) return false;
+	if (to != null && updatedAt > to) return false;
+	return true;
+}
 function truncate(value, width) {
 	if (value.length <= width) return value.padEnd(width);
 	return `${value.slice(0, Math.max(0, width - 1))}…`;
@@ -1390,7 +1418,23 @@ function buildMeetingRecord(document, cacheData) {
 }
 function listMeetings(documents, options = {}) {
 	const limit = options.limit ?? 20;
-	return documents.filter((document) => options.search ? matchesMeetingSearch(document, options.search) : true).sort(compareMeetingDocuments).slice(0, limit).map((document) => buildMeetingSummary(document, options.cacheData));
+	const sort = options.sort ?? "updated-desc";
+	return documents.filter((document) => options.search ? matchesMeetingSearch(document, options.search) : true).filter((document) => matchesUpdatedRange(document, options.updatedFrom, options.updatedTo)).sort((left, right) => compareMeetingDocumentsBySort(left, right, sort)).slice(0, limit).map((document) => buildMeetingSummary(document, options.cacheData));
+}
+function resolveMeetingQuery(documents, query) {
+	const trimmed = query.trim();
+	if (!trimmed) throw new Error("meeting query is required");
+	const lower = trimmed.toLowerCase();
+	const exactId = documents.find((document) => document.id === trimmed);
+	if (exactId) return exactId;
+	const exactTitleMatches = documents.filter((document) => document.title.toLowerCase() === lower);
+	if (exactTitleMatches.length === 1) return exactTitleMatches[0];
+	const prefixMatches = documents.filter((document) => document.id.startsWith(trimmed));
+	if (prefixMatches.length === 1) return prefixMatches[0];
+	const titleMatches = documents.filter((document) => document.title.toLowerCase().includes(lower)).sort(compareMeetingDocuments);
+	if (titleMatches.length === 1) return titleMatches[0];
+	if (exactTitleMatches.length > 1 || prefixMatches.length > 1 || titleMatches.length > 1) throw new Error(`ambiguous meeting query: ${trimmed}`);
+	throw new Error(`meeting not found: ${trimmed}`);
 }
 function resolveMeeting(documents, id) {
 	const exactMatch = documents.find((document) => document.id === id);
@@ -1612,10 +1656,16 @@ var GranolaApp = class {
 		const meetings = listMeetings(await this.listDocuments(), {
 			cacheData: await this.loadCache(),
 			limit: options.limit,
-			search: options.search
+			search: options.search,
+			sort: options.sort,
+			updatedFrom: options.updatedFrom,
+			updatedTo: options.updatedTo
 		});
 		this.setUiState({
 			meetingSearch: options.search,
+			meetingSort: options.sort,
+			meetingUpdatedFrom: options.updatedFrom,
+			meetingUpdatedTo: options.updatedTo,
 			selectedMeetingId: void 0,
 			view: "meeting-list"
 		});
@@ -1636,6 +1686,21 @@ var GranolaApp = class {
 			meeting
 		};
 	}
+	async findMeeting(query, options = {}) {
+		const documents = await this.listDocuments();
+		const cacheData = await this.loadCache({ required: options.requireCache });
+		const document = resolveMeetingQuery(documents, query);
+		const meeting = buildMeetingRecord(document, cacheData);
+		this.setUiState({
+			selectedMeetingId: document.id,
+			view: "meeting-detail"
+		});
+		return {
+			cacheData,
+			document,
+			meeting
+		};
+	}
 	async exportNotes(format = "markdown") {
 		const documents = await this.listDocuments();
 		const written = await writeNotes(documents, this.config.notes.output, format);
@@ -2149,7 +2214,9 @@ function renderGranolaWebPage() {
         line-height: 1.5;
       }
 
-      .search {
+      .search,
+      .select,
+      .field-input {
         width: 100%;
         margin-top: 16px;
         padding: 12px 14px;
@@ -2160,6 +2227,26 @@ function renderGranolaWebPage() {
         font: inherit;
       }
 
+      .field-row {
+        display: grid;
+        gap: 10px;
+        margin-top: 12px;
+      }
+
+      .field-row--inline {
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+      }
+
+      .field-label {
+        display: block;
+        margin-bottom: 6px;
+        color: var(--muted);
+        font-size: 0.78rem;
+        font-weight: 700;
+        letter-spacing: 0.08em;
+        text-transform: uppercase;
+      }
+
       .meeting-list {
         padding: 14px;
         overflow: auto;
@@ -2201,6 +2288,10 @@ function renderGranolaWebPage() {
         color: var(--muted);
       }
 
+      .meeting-empty--error {
+        color: var(--error);
+      }
+
       .detail {
         display: grid;
         grid-template-rows: auto auto 1fr;
@@ -2248,6 +2339,13 @@ function renderGranolaWebPage() {
         gap: 10px;
       }
 
+      .toolbar-form {
+        display: grid;
+        grid-template-columns: minmax(0, 1fr) auto;
+        gap: 10px;
+        width: min(440px, 100%);
+      }
+
       .button {
         border: 0;
         border-radius: 999px;
@@ -2340,6 +2438,11 @@ function renderGranolaWebPage() {
         .shell {
           grid-template-columns: 1fr;
         }
+
+        .field-row--inline,
+        .toolbar-form {
+          grid-template-columns: 1fr;
+        }
       }
     </style>
   </head>
@@ -2350,9 +2453,34 @@ function renderGranolaWebPage() {
           <h1>Granola Toolkit</h1>
           <p>Browser workspace for meetings, notes, transcripts, and export flows on top of one local server instance.</p>
           <input class="search" data-search placeholder="Search meetings, ids, or tags" />
+          <div class="field-row field-row--inline">
+            <label>
+              <span class="field-label">Sort</span>
+              <select class="select" data-sort>
+                <option value="updated-desc">Newest first</option>
+                <option value="updated-asc">Oldest first</option>
+                <option value="title-asc">Title A-Z</option>
+                <option value="title-desc">Title Z-A</option>
+              </select>
+            </label>
+            <label>
+              <span class="field-label">Updated From</span>
+              <input class="field-input" data-updated-from type="date" />
+            </label>
+          </div>
+          <label class="field-row">
+            <span class="field-label">Updated To</span>
+            <input class="field-input" data-updated-to type="date" />
+          </label>
         </section>
         <section class="toolbar">
-          <p>Meetings are loaded from the shared server state so this view can later coexist with the terminal UI.</p>
+          <div>
+            <p>Meetings are loaded from the shared server state so this view can later coexist with the terminal UI.</p>
+          </div>
+          <div class="toolbar-form">
+            <input class="field-input" data-quick-open placeholder="Quick open by id or title" />
+            <button class="button button--secondary" data-quick-open-button>Open</button>
+          </div>
         </section>
         <section class="meeting-list" data-meeting-list></section>
       </aside>
@@ -2381,11 +2509,17 @@ function renderGranolaWebPage() {
     <script type="module">
 ${String.raw`
 const state = {
-  meetings: [],
-  selectedMeetingId: null,
-  selectedMeeting: null,
   appState: null,
+  detailError: "",
+  listError: "",
+  meetings: [],
+  quickOpen: "",
   search: "",
+  selectedMeeting: null,
+  selectedMeetingId: null,
+  sort: "updated-desc",
+  updatedFrom: "",
+  updatedTo: "",
 };
 
 const els = {
@@ -2395,10 +2529,15 @@ const els = {
   empty: document.querySelector("[data-empty]"),
   list: document.querySelector("[data-meeting-list]"),
   noteButton: document.querySelector("[data-export-notes]"),
+  quickOpen: document.querySelector("[data-quick-open]"),
+  quickOpenButton: document.querySelector("[data-quick-open-button]"),
   refreshButton: document.querySelector("[data-refresh]"),
   search: document.querySelector("[data-search]"),
+  sort: document.querySelector("[data-sort]"),
   stateBadge: document.querySelector("[data-state-badge]"),
   transcriptButton: document.querySelector("[data-export-transcripts]"),
+  updatedFrom: document.querySelector("[data-updated-from]"),
+  updatedTo: document.querySelector("[data-updated-to]"),
 };
 
 function escapeHtml(value) {
@@ -2414,6 +2553,32 @@ function setStatus(label, tone = "idle") {
   els.stateBadge.dataset.tone = tone;
 }
 
+function syncFilterInputs() {
+  els.quickOpen.value = state.quickOpen;
+  els.search.value = state.search;
+  els.sort.value = state.sort;
+  els.updatedFrom.value = state.updatedFrom;
+  els.updatedTo.value = state.updatedTo;
+}
+
+function currentFilterSummary() {
+  const parts = [];
+
+  if (state.search) {
+    parts.push('search "' + state.search + '"');
+  }
+
+  if (state.updatedFrom) {
+    parts.push("from " + state.updatedFrom);
+  }
+
+  if (state.updatedTo) {
+    parts.push("to " + state.updatedTo);
+  }
+
+  return parts.join(", ");
+}
+
 function renderAppState() {
   if (!state.appState) {
     els.appState.innerHTML = "<p>Waiting for server state…</p>";
@@ -2441,10 +2606,20 @@ function renderAppState() {
 }
 
 function renderMeetingList() {
+  if (state.listError) {
+    els.list.innerHTML =
+      '<div class="meeting-empty meeting-empty--error">' + escapeHtml(state.listError) + "</div>";
+    return;
+  }
+
   if (state.meetings.length === 0) {
     state.selectedMeetingId = null;
     state.selectedMeeting = null;
-    els.list.innerHTML = '<div class="meeting-empty">No meetings yet. Try Refresh.</div>';
+    const filterSummary = currentFilterSummary();
+    const message = filterSummary
+      ? "No meetings match " + filterSummary + "."
+      : "No meetings yet. Try Refresh.";
+    els.list.innerHTML = '<div class="meeting-empty">' + escapeHtml(message) + "</div>";
     renderMeetingDetail();
     return;
   }
@@ -2470,9 +2645,18 @@ function renderMeetingList() {
 }
 
 function renderMeetingDetail() {
+  if (state.detailError) {
+    els.empty.hidden = false;
+    els.empty.textContent = state.detailError;
+    els.detailMeta.innerHTML = "";
+    els.detailBody.innerHTML = "";
+    return;
+  }
+
   const record = state.selectedMeeting;
   if (!record) {
     els.empty.hidden = false;
+    els.empty.textContent = "Select a meeting to inspect its notes and transcript.";
     els.detailMeta.innerHTML = "";
     els.detailBody.innerHTML = "";
     return;
@@ -2506,17 +2690,51 @@ async function fetchJson(path, init) {
   return payload;
 }
 
-async function loadMeetings() {
-  const query = state.search ? "?search=" + encodeURIComponent(state.search) + "&limit=50" : "?limit=50";
-  const payload = await fetchJson("/meetings" + query);
-  state.meetings = payload.meetings || [];
-  if (!state.selectedMeetingId && state.meetings[0]) {
-    state.selectedMeetingId = state.meetings[0].id;
+function buildMeetingsQuery(limit = 100) {
+  const params = new URLSearchParams();
+  params.set("limit", String(limit));
+  params.set("sort", state.sort);
+
+  if (state.search) {
+    params.set("search", state.search);
   }
-  renderMeetingList();
-  if (state.selectedMeetingId) {
-    await loadMeeting(state.selectedMeetingId);
-  } else {
+
+  if (state.updatedFrom) {
+    params.set("updatedFrom", state.updatedFrom);
+  }
+
+  if (state.updatedTo) {
+    params.set("updatedTo", state.updatedTo);
+  }
+
+  return "?" + params.toString();
+}
+
+async function loadMeetings(options = {}) {
+  const preferredMeetingId = options.preferredMeetingId || state.selectedMeetingId;
+
+  try {
+    state.listError = "";
+    const payload = await fetchJson("/meetings" + buildMeetingsQuery());
+    state.meetings = payload.meetings || [];
+
+    if (preferredMeetingId && state.meetings.some((meeting) => meeting.id === preferredMeetingId)) {
+      state.selectedMeetingId = preferredMeetingId;
+    }
+
+    renderMeetingList();
+    if (state.selectedMeetingId) {
+      await loadMeeting(state.selectedMeetingId);
+      return;
+    }
+
+    state.detailError = "";
+    renderMeetingDetail();
+  } catch (error) {
+    state.listError = error instanceof Error ? error.message : String(error);
+    state.selectedMeeting = null;
+    state.detailError = state.listError;
+    renderMeetingList();
     renderMeetingDetail();
   }
 }
@@ -2524,9 +2742,44 @@ async function loadMeetings() {
 async function loadMeeting(id) {
   state.selectedMeetingId = id;
   renderMeetingList();
-  const payload = await fetchJson("/meetings/" + encodeURIComponent(id));
-  state.selectedMeeting = payload.meeting || null;
-  renderMeetingDetail();
+
+  try {
+    state.detailError = "";
+    const payload = await fetchJson("/meetings/" + encodeURIComponent(id));
+    state.selectedMeeting = payload.meeting || null;
+    renderMeetingDetail();
+  } catch (error) {
+    state.selectedMeeting = null;
+    state.detailError = error instanceof Error ? error.message : String(error);
+    renderMeetingDetail();
+  }
+}
+
+async function quickOpenMeeting() {
+  const query = els.quickOpen.value.trim();
+  if (!query) {
+    setStatus("Enter a title or id", "error");
+    return;
+  }
+
+  setStatus("Opening meeting…", "busy");
+
+  try {
+    state.quickOpen = query;
+    const payload = await fetchJson("/meetings/resolve?q=" + encodeURIComponent(query));
+    state.search = "";
+    state.updatedFrom = "";
+    state.updatedTo = "";
+    syncFilterInputs();
+    await loadMeetings({
+      preferredMeetingId: payload.document.id,
+    });
+    setStatus("Connected", "ok");
+  } catch (error) {
+    state.detailError = error instanceof Error ? error.message : String(error);
+    renderMeetingDetail();
+    setStatus("Quick open failed", "error");
+  }
 }
 
 async function refreshAll() {
@@ -2588,6 +2841,56 @@ els.search.addEventListener("input", (event) => {
   void loadMeetings();
 });
 
+els.sort.addEventListener("change", (event) => {
+  if (!(event.target instanceof HTMLSelectElement)) {
+    return;
+  }
+
+  state.sort = event.target.value;
+  void loadMeetings();
+});
+
+els.updatedFrom.addEventListener("change", (event) => {
+  if (!(event.target instanceof HTMLInputElement)) {
+    return;
+  }
+
+  state.updatedFrom = event.target.value;
+  void loadMeetings();
+});
+
+els.updatedTo.addEventListener("change", (event) => {
+  if (!(event.target instanceof HTMLInputElement)) {
+    return;
+  }
+
+  state.updatedTo = event.target.value;
+  void loadMeetings();
+});
+
+els.quickOpen.addEventListener("input", (event) => {
+  if (!(event.target instanceof HTMLInputElement)) {
+    return;
+  }
+
+  state.quickOpen = event.target.value;
+});
+
+els.quickOpen.addEventListener("keydown", (event) => {
+  if (!(event.target instanceof HTMLInputElement)) {
+    return;
+  }
+
+  if (event.key === "Enter") {
+    event.preventDefault();
+    void quickOpenMeeting();
+  }
+});
+
+els.quickOpenButton.addEventListener("click", () => {
+  void quickOpenMeeting();
+});
+
 const events = new EventSource("/events");
 events.addEventListener("state.updated", (event) => {
   const payload = JSON.parse(event.data);
@@ -2598,6 +2901,8 @@ events.addEventListener("error", () => {
   setStatus("Disconnected", "error");
 });
 
+syncFilterInputs();
+
 void refreshAll().catch((error) => {
   setStatus("Error", "error");
   els.empty.hidden = false;
@@ -2617,6 +2922,17 @@ function parseInteger(value) {
 	if (!Number.isInteger(parsed) || parsed < 1) throw new Error("invalid limit: expected a positive integer");
 	return parsed;
 }
+function parseMeetingSort(value) {
+	switch (value) {
+		case null:
+		case "": return;
+		case "title-asc":
+		case "title-desc":
+		case "updated-asc":
+		case "updated-desc": return value;
+		default: throw new Error("invalid sort: expected updated-desc, updated-asc, title-asc, or title-desc");
+	}
+}
 function sendJson(response, body, init = {}) {
 	const payload = `${JSON.stringify(body, null, 2)}\n`;
 	response.writeHead(init.status ?? 200, {
@@ -2722,15 +3038,30 @@ async function startGranolaServer(app, options = {}) {
 			if (method === "GET" && path === "/meetings") {
 				const limit = parseInteger(url.searchParams.get("limit"));
 				const search = url.searchParams.get("search")?.trim() || void 0;
+				const sort = parseMeetingSort(url.searchParams.get("sort"));
+				const updatedFrom = url.searchParams.get("updatedFrom")?.trim() || void 0;
+				const updatedTo = url.searchParams.get("updatedTo")?.trim() || void 0;
 				sendJson(response, {
 					meetings: await app.listMeetings({
 						limit,
-						search
+						search,
+						sort,
+						updatedFrom,
+						updatedTo
 					}),
-					search
+					search,
+					sort,
+					updatedFrom,
+					updatedTo
 				});
 				return;
 			}
+			if (method === "GET" && path === "/meetings/resolve") {
+				const query = url.searchParams.get("q")?.trim();
+				if (!query) throw new Error("meeting query is required");
+				sendJson(response, await app.findMeeting(query, { requireCache: url.searchParams.get("includeTranscript") === "true" }));
+				return;
+			}
 			if (method === "GET" && path.startsWith("/meetings/")) {
 				const id = decodeURIComponent(path.slice(10));
 				if (!id) throw new Error("meeting id is required");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "granola-toolkit",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Toolkit for exporting and working with Granola meetings, notes, and transcripts",
   "keywords": [
     "cli",