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",[],[245],"ea084e92-23d6-48ae-b310-f12ae79014d7","demo.ts","f5e37dd4-af13-11f1-8f99-1607ee4eb77e",26,["D",1789263671896],"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",[],[253],"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",[],[261],"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",[],[269],["D",1789262359413],["D",1789443053029],{"_11":12,"_185":76},{"_11":12,"_181":-5,"_75":76,"_30":74,"_182":183,"_184":24},{"_45":172,"_13":16,"_39":42,"_173":133,"_174":-5,"_175":-5,"_176":-5,"_177":-5,"_178":-5,"_179":14,"_180":12},"ctx",{"_59":-5,"_204":313,"_314":315,"_316":317,"_318":24,"_319":24,"_320":24,"_321":146,"_322":-5,"_323":-7,"_324":-7,"_325":26,"_326":24,"_327":24,"_328":-5,"_329":24,"_330":24,"_331":24,"_332":-5},"ENV",{"_284":285,"_286":287,"_288":16,"_289":290,"_291":292,"_293":294,"_295":296,"_297":298,"_299":300,"_301":302,"_303":304,"_305":306,"_307":308,"_309":310,"_311":312},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","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 · lib.ts