TCall.

Glyph MinHash search over ephemeral sessions · sessions expire after 5 min of inactivity

\n\n

Session

\n \n \n

\n \n

Loads the test-notes session and its demo memories.

No session yet.

\n\n

Preserve

\n Observations (one per line — only fingerprinted, never stored)\n \n Context (raw text stored, returned on recall)\n \n \n

\n\n

Recall

\n Query\n \n Top results\n \n \n

\n\n \n \n\n",[181],"ea084e92-23d6-48ae-b310-f12ae79014d7","demo.ts","f5e37dd4-af13-11f1-8f99-1607ee4eb77e",26,["D",1789263671896],1,"import {\n countObservations,\n createSession,\n expireIfStale,\n} from \"./lib.ts\";\n\n/**\n * \"Import demo memories\" — points the demo UI at the `test-notes` session,\n * reviving it if it has expired. The demo memories live in that session's\n * preserved observation glyphs; nothing is hardcoded or re-seeded here (raw\n * observations are never stored, so we can't reconstruct them anyway).\n */\nexport async function loadDemoMemories(\n name = \"test-notes\",\n): Promise<{ name: string; count: number }> {\n if (!(await expireIfStale(name))) {\n await createSession(name);\n }\n return { name, count: await countObservations(name) };\n}\n",[189],"fc861707-673c-4826-b15c-07fb3db32f1a","client.ts","211d4be4-af12-11f1-8286-1607ee4eb77e",32,["D",1789263766956],"const $ = (id: string) => document.getElementById(id) as HTMLElement;\nconst sessionInput = $(\"session\") as HTMLInputElement;\nconst statusEl = $(\"sessionStatus\");\nconst preserveOut = $(\"preserveOut\") as HTMLPreElement;\nconst recallOut = $(\"recallOut\");\n\nlet currentSession = \"\";\nlet countdown: number | undefined;\n\nasync function api(path: string, body: object): Promise {\n const res = await fetch(path, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(body),\n });\n const data = await res.json().catch(() => ({}));\n if (!res.ok) throw new Error(data.error || `HTTP ${res.status}: ${data.message ?? \"\"}`);\n return data as T;\n}\n\nfunction setSessionExpiry(iso: string) {\n const expiresAt = new Date(iso).getTime();\n const tick = () => {\n const left = Math.max(0, expiresAt - Date.now());\n const mins = String(Math.floor(left / 60000)).padStart(2, \"0\");\n const secs = String(Math.floor((left % 60000) / 1000)).padStart(2, \"0\");\n const dead = left === 0;\n statusEl.innerHTML =\n `Session ${currentSession}` +\n `expires in ${mins}:${secs}`;\n if (dead) clearInterval(countdown);\n };\n if (countdown) clearInterval(countdown);\n countdown = setInterval(tick, 1000) as unknown as number;\n tick();\n}\n\nfunction showError(message: string) {\n recallOut.innerHTML = `

${message.replace(/`;\n}\n\nconst createBtn = $(\"create\");\ncreateBtn.addEventListener(\"click\", async () => {\n const name = sessionInput.value.trim();\n if (!name) return;\n try {\n await api(\"/session/create\", { name });\n currentSession = name;\n setSessionExpiry(new Date(Date.now() + 5 * 60 * 1000).toISOString());\n sessionInput.value = \"\";\n } catch (e) {\n showError((e as Error).message);\n }\n});\n\nfunction activateSession(name: string, sticky: boolean) {\n currentSession = name;\n sessionInput.value = \"\";\n if (sticky) {\n if (countdown) clearInterval(countdown);\n statusEl.innerHTML =\n `Session ${currentSession}` +\n `sticky · never expires`;\n } else {\n setSessionExpiry(new Date(Date.now() + 5 * 60 * 1000).toISOString());\n }\n}\n\nconst demoBtn = $(\"demo\");\ndemoBtn.addEventListener(\"click\", async () => {\n try {\n const res = await api(\"/session/demo\", {});\n activateSession(res.session, res.sticky === true);\n recallOut.innerHTML = `

Loaded ${res.count} demo memories into ${res.session}.

`;\n } catch (e) {\n showError((e as Error).message);\n }\n});\n\nconst preserveBtn = $(\"preserve\");\npreserveBtn.addEventListener(\"click\", async () => {\n if (!currentSession) return showError(\"Create a session first.\");\n const observations = ($(\"observations\") as HTMLTextAreaElement)\n .value.split(\"\\n\").map((s) => s.trim()).filter(Boolean);\n const context = ($(\"context\") as HTMLInputElement).value.trim();\n if (!observations.length || !context) return showError(\"Add observations and context.\");\n try {\n const res = await api(\"/session/preserve\", { session: currentSession, observations, context });\n preserveOut.hidden = false;\n preserveOut.textContent = `Preserved id ${res.id} — ${observations.length} observation(s) folded into one glyph.`;\n } catch (e) {\n showError((e as Error).message);\n }\n});\n\nconst recallBtn = $(\"recall\");\nrecallBtn.addEventListener(\"click\", async () => {\n if (!currentSession) return showError(\"Create a session first.\");\n const query = ($(\"query\") as HTMLInputElement).value.trim();\n const limit = Number(($(\"limit\") as HTMLInputElement).value || 3);\n if (!query) return showError(\"Enter a query.\");\n try {\n const res = await api(\"/session/recall\", { session: currentSession, query, limit });\n recallOut.innerHTML = \"\";\n if (res.results.length === 0) {\n recallOut.innerHTML = `

No matches — try preserving some context first.

`;\n return;\n }\n res.results.forEach((r: { id: number; similarity: number; context: string }) => {\n const el = document.createElement(\"div\");\n el.className = \"result\";\n el.innerHTML =\n `

#${r.id} · similarity ${(r.similarity * 100).toFixed(1)}%

` +\n `

${r.context.replace(/`;\n recallOut.appendChild(el);\n });\n } catch (e) {\n showError((e as Error).message);\n }\n});\n",[197],"9e712c9a-49f8-43ab-9321-dacfdd941306","README.md","f87079a0-af11-11f1-9233-1607ee4eb77e",["D",1789263789866],"# TCall\n\nA tiny **search engine over ephemeral sessions**, powered by [Glyph](https://github.com/Koda-OSS/Glyph) MinHash fingerprints and backed by SQLite.\n\n**Live API:** \n\n## How it works\n\n- **Create** a session with any name. Sessions expire after **5 minutes of inactivity**; touching a live session (preserve/recall/create) extends it.\n- **Preserve** aggregates a set of *observations* into a single Glyph **collection glyph** (period-min hash). Only that serialized glyph is stored — the raw observations are never written to the database.\n- **Recall** rehydrates every preserved observation glyph, builds an in-memory index, searches it with a glyph of the query, and returns the raw **context** text for the top-`limit` hits.\n\n```mermaid\nflowchart LR\n A[observations] --> C[Glyph collection] --> G[aggregated glyph]\n G --> DB[(SQLite: glyph + context)]\n Q[query] --> D[Deserialize all glyphs]\n DB --> D\n D --> I[exact-scan index]\n I --> R[top-N contexts]\n```\n\n## Data model\n\n| Table | Columns | Purpose |\n| --- | --- | --- |\n| `sessions` | `name`, `last_activity` | Expiry (5 min inactivity) |\n| `observations` | `id`, `session`, `glyph`, `context` | Serialized collection glyph + raw context keyed to it |\n\n## Endpoints\n\nAll endpoints take JSON and return JSON.\n\n### `POST /session/create`\n\n```jsonc\n{ \"name\": \"meeting-notes\" }\n```\n\n→ `200`: `{ ok, session, expiresInSeconds, expiresAt }`\n\n### `POST /session/preserve`\n\n```jsonc\n{\n \"session\": \"meeting-notes\",\n \"observations\": [\n \"the new pricing is $49 per seat for the pro tier\",\n \"annual plans get a 20% discount\"\n ],\n \"context\": \"Pricing decision: pro tier $49/seat, 20% off annual plans.\"\n}\n```\n\n`observations` are fingerprinted and discarded; only `context` is stored, keyed to the aggregated glyph. → `200`: `{ ok, id }`\n\n### `POST /session/recall`\n\n```jsonc\n{ \"session\": \"meeting-notes\", \"query\": \"what did we decide about pricing?\", \"limit\": 3 }\n```\n\n→ `200`: `{ ok, query, total, results: [{ id, similarity, context }] }`\n\n## Notes\n\n- A session that is inactive for 5 minutes is wiped (observations deleted) and must be recreated. **Sticky sessions** (e.g. `test-notes`) are exempt and never expire.\n- Recall uses an exact scan (`index.New({ mode: \"direct\" })`); the default Softmax collection aggregator compares poorly against raw query glyphs, so TCall uses `CollectionAggregatorMin`.\n- Endpoint files: [main.ts](url:main.ts) · [lib.ts](url:lib.ts)\n",[204],"pulls","branches","forks","envVars",{"_216":26,"_218":26},"connections",{"_216":26,"_217":26},"count","unfilledCount","emptyCount",{"_33":203,"_13":204,"_64":205,"_43":-5,"_35":36,"_162":120,"_164":80,"_37":241,"_39":193,"_66":21,"_168":207,"_68":24,"_170":-5,"_226":242,"_17":243},{"_33":196,"_13":197,"_64":198,"_43":-5,"_35":36,"_162":199,"_164":80,"_37":238,"_39":185,"_66":67,"_168":201,"_68":24,"_170":-5,"_226":239,"_17":240},{"_33":188,"_13":189,"_64":190,"_43":-5,"_35":36,"_162":191,"_164":80,"_37":235,"_39":193,"_66":67,"_168":194,"_68":24,"_170":-5,"_226":236,"_17":237},{"_33":180,"_13":181,"_64":182,"_43":-5,"_35":36,"_162":183,"_164":80,"_37":232,"_39":185,"_66":21,"_168":186,"_68":24,"_170":-5,"_226":233,"_17":234},{"_33":172,"_13":173,"_64":174,"_43":-5,"_35":36,"_162":175,"_164":80,"_37":229,"_39":177,"_66":67,"_168":178,"_68":24,"_170":-5,"_226":230,"_17":231},{"_33":160,"_13":161,"_64":93,"_43":-5,"_35":36,"_162":163,"_164":80,"_37":225,"_39":166,"_66":167,"_168":169,"_68":24,"_170":14,"_226":227,"_17":228},["D",1789263761060],"children",[],[161],["D",1789263750691],[],[173],["D",1789263685390],[],[181],["D",1789263671896],[],[189],["D",1789263766956],[],[197],["D",1789263789866],[],[204],["D",1789262359413],["D",1789530055570],{"_11":12,"_133":71},{"_11":12,"_129":-5,"_70":71,"_30":69,"_130":131,"_132":24},{"_39":120,"_13":16,"_33":36,"_121":82,"_122":-5,"_123":-5,"_124":-5,"_125":-5,"_126":-5,"_127":14,"_128":12},"ctx",{"_54":-5,"_151":282,"_283":284,"_285":286,"_287":24,"_288":24,"_289":24,"_290":80,"_291":-5,"_292":-7,"_293":-7,"_294":26,"_295":24,"_296":24,"_297":-5,"_298":24,"_299":24,"_300":24,"_301":-5},"ENV",{"_253":254,"_255":256,"_257":16,"_258":259,"_260":261,"_262":263,"_264":265,"_266":267,"_268":269,"_270":271,"_272":273,"_274":275,"_276":277,"_278":279,"_280":281},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","5015b8df46402d8bba4f485ecc37aec202b0e06b","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History · debug-glyph.ts