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",3,["D",1789263685390],"branchVersion","label",[18],"pulls","branches",1,"forks","envVars",{"_188":26,"_190":26},"connections",{"_188":26,"_189":26},"count","unfilledCount","emptyCount",{"_35":237,"_13":238,"_66":239,"_45":-5,"_37":38,"_177":137,"_200":111,"_39":240,"_41":182,"_68":21,"_173":241,"_69":24,"_178":-5,"_205":242,"_17":243},{"_35":229,"_13":230,"_66":231,"_45":-5,"_37":38,"_177":232,"_200":111,"_39":233,"_41":175,"_68":214,"_173":234,"_69":24,"_178":-5,"_205":235,"_17":236},{"_35":221,"_13":222,"_66":223,"_45":-5,"_37":38,"_177":224,"_200":111,"_39":225,"_41":182,"_68":214,"_173":226,"_69":24,"_178":-5,"_205":227,"_17":228},{"_35":172,"_13":18,"_66":67,"_45":-5,"_37":38,"_177":91,"_200":111,"_39":218,"_41":175,"_68":21,"_173":174,"_69":24,"_178":-5,"_205":219,"_17":220},{"_35":208,"_13":209,"_66":210,"_45":-5,"_37":38,"_177":211,"_200":111,"_39":212,"_41":213,"_68":214,"_173":215,"_69":24,"_178":-5,"_205":216,"_17":217},{"_35":197,"_13":198,"_66":109,"_45":-5,"_37":38,"_177":199,"_200":111,"_39":201,"_41":202,"_68":203,"_173":204,"_69":24,"_178":14,"_205":206,"_17":207},"27609d26-8b30-4af7-af71-d0b5ed2942c3","main.ts",31,"latest",["D",1789263761060],10,"http","import { Hono } from \"npm:hono\";\nimport { parseVal, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport {\n STICKY_SESSIONS,\n countObservations,\n createSession,\n expireIfStale,\n init,\n preserve,\n recall,\n} from \"./lib.ts\";\nimport { loadDemoMemories } from \"./demo.ts\";\n\nconst app = new Hono();\n\nawait init();\n\nasync function readJson(c: any): Promise {\n try {\n return await c.req.json();\n } catch {\n return {};\n }\n}\n\n// Demo UI at /\napp.get(\"/\", (c) => serveFile(\"/index.html\"));\napp.get(\"/client.ts\", (c) => serveFile(\"/client.ts\"));\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// POST /session/demo — revive the `test-notes` sticky session (demo memories).\napp.post(\"/session/demo\", async (c) => {\n const { name, count } = await loadDemoMemories(\"test-notes\");\n return c.json({\n ok: true,\n session: name,\n count,\n sticky: STICKY_SESSIONS.has(name),\n });\n});\n\n// Returns the validated session name, or a JSON error response to return.\nasync function resolveSession(c: any): Promise {\n const body = await readJson(c);\n const name = String(body.session ?? \"\").trim();\n if (!name) return c.json({ error: \"Missing session name\" }, 400);\n if (!(await expireIfStale(name))) {\n return c.json(\n { error: \"Session does not exist or has expired\", session: name },\n 404,\n );\n }\n return name;\n}\n\n// POST /session/create { name }\napp.post(\"/session/create\", async (c) => {\n const body = await readJson(c);\n const name = String(body.name ?? \"\").trim();\n if (!name) return c.json({ error: \"Missing name\" }, 400);\n const session = await createSession(name);\n return c.json({\n ok: true,\n session: session.name,\n expiresInSeconds: 5 * 60,\n expiresAt: new Date(session.expiresAt).toISOString(),\n });\n});\n\n// POST /session/preserve\n// { session, observations: string[], context: string }\napp.post(\"/session/preserve\", async (c) => {\n const session = await resolveSession(c);\n if (typeof session !== \"string\") return session;\n\n const body = await readJson(c);\n const observations: string[] = Array.isArray(body.observations)\n ? body.observations.map(String)\n : [];\n const context = String(body.context ?? \"\").trim();\n if (observations.length === 0 || !context) {\n return c.json(\n { error: \"observations (array) and context (string) are required\" },\n 400,\n );\n }\n\n const obs = await preserve(session, observations, context);\n return c.json({ ok: true, id: obs.id });\n});\n\n// POST /session/recall\n// { session, query: string, limit?: number }\napp.post(\"/session/recall\", async (c) => {\n const session = await resolveSession(c);\n if (typeof session !== \"string\") return session;\n\n const body = await readJson(c);\n const queryText = String(body.query ?? \"\").trim();\n if (!queryText) return c.json({ error: \"Missing query\" }, 400);\n const limit = Math.max(1, Math.min(20, Number(body.limit ?? 3) || 3));\n\n const results = await recall(session, queryText, limit);\n const total = await count(session);\n return c.json({ ok: true, query: queryText, total, results });\n});\n\nasync function count(name: string): Promise {\n return countObservations(name);\n}\n\nexport default app.fetch;\n","children",[],[198],"66aff12a-41f5-4bcd-ab8e-21072514753f","lib.ts","2e999f58-af11-11f1-99c2-1607ee4eb77e",29,["D",1789263750691],7,"script","import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport {\n CollectionAggregatorMin,\n Create,\n Deserialize,\n Serialize,\n collections,\n index,\n query,\n} from \"npm:@koda.oss/glyph@1.0.0\";\n\n/** Sessions expire after 5 minutes of inactivity. */\nexport const SESSION_TTL_MS = 5 * 60 * 1000;\n\n/**\n * Sessions that never expire. Their preserved observation glyphs survive the\n * inactivity window instead of being wiped.\n */\nexport const STICKY_SESSIONS = new Set([\"test-notes\"]);\n\nexport type SessionInfo = { name: string; expiresAt: number };\n\nconst now = () => Date.now();\n\n/** Idempotent schema setup. */\nexport async function init() {\n await sqlite.batch([\n {\n sql:\n `CREATE TABLE IF NOT EXISTS sessions (\n name TEXT PRIMARY KEY,\n last_activity INTEGER NOT NULL\n )`,\n },\n {\n sql:\n `CREATE TABLE IF NOT EXISTS observations (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n session TEXT NOT NULL,\n glyph TEXT NOT NULL,\n context TEXT NOT NULL\n )`,\n },\n {\n sql: `CREATE INDEX IF NOT EXISTS idx_obs_session ON observations(session)`,\n },\n ]);\n}\n\nasync function existsSession(name: string): Promise {\n const res = await sqlite.execute(\n \"SELECT last_activity FROM sessions WHERE name = ?\",\n [name],\n );\n if (res.rows.length === 0) return undefined;\n return Number(res.rows[0].last_activity);\n}\n\n/**\n * If the session exists but its last activity is older than the TTL, the\n * session has expired: wipe its observations and delete the row.\n * Sticky sessions are exempt and are never treated as expired.\n * Returns true if we now have a live session under this name.\n */\nexport async function expireIfStale(name: string): Promise {\n const last = await existsSession(name);\n if (last === undefined) return false;\n if (STICKY_SESSIONS.has(name)) return true;\n if (now() - last > SESSION_TTL_MS) {\n await sqlite.batch([\n { sql: \"DELETE FROM observations WHERE session = ?\", args: [name] },\n { sql: \"DELETE FROM sessions WHERE name = ?\", args: [name] },\n ]);\n return false;\n }\n return true;\n}\n\nexport async function touch(name: string) {\n await sqlite.execute(\n \"UPDATE sessions SET last_activity = ? WHERE name = ?\",\n [now(), name],\n );\n}\n\n/**\n * Create a session with an arbitrary name. Idempotent: returns the existing\n * session if one is still active (callers rely on expireIfStale having run\n * first).\n */\nexport async function createSession(name: string): Promise {\n const active = await expireIfStale(name);\n let last: number;\n if (active) {\n const existing = await existsSession(name);\n last = existing!;\n await touch(name);\n } else {\n last = now();\n await sqlite.execute(\n \"INSERT INTO sessions (name, last_activity) VALUES (?, ?)\",\n [name, last],\n );\n }\n return { name, expiresAt: last + SESSION_TTL_MS };\n}\n\nexport type Observation = { id: number; glyph: string; context: string };\n\n/**\n * Preserve context given a set of observations.\n *\n * The observations are *not* stored. They are added to a Glyph collection,\n * whose aggregated glyph `col.glyph` is serialized and stored as a single\n * observation glyph. The raw context text is stored keyed to that glyph.\n */\nexport async function preserve(\n session: string,\n observations: string[],\n context: string,\n): Promise {\n // Min aggregation produces the MinHash of the observation union, which stays\n // comparable to raw query glyphs during search (Softmax aggregation does not).\n const col = collections.New({ aggregator: CollectionAggregatorMin });\n observations.forEach((obs, i) => col.Add(String(i), obs));\n const glyphStr = Serialize(col.glyph);\n\n const res = await sqlite.execute(\n \"INSERT INTO observations (session, glyph, context) VALUES (?, ?, ?)\",\n [session, glyphStr, context],\n );\n await touch(session);\n\n return {\n id: Number(res.lastInsertRowid),\n glyph: glyphStr,\n context,\n };\n}\n\n/**\n * Recall context. All preserved observation glyphs for the session are\n * collected, deserialized into an in-memory index, and searched with a probe\n * glyph built from `query`. The context of the top `limit` hits is returned.\n */\nexport async function recall(\n session: string,\n queryText: string,\n limit = 3,\n): Promise<{ id: number; similarity: number; context: string }[]> {\n const rows = await sqlite.execute(\n \"SELECT id, glyph, context FROM observations WHERE session = ?\",\n [session],\n );\n\n // Sessions hold a small number of observation glyphs, so an exact scan\n // (mode \"direct\") ranks every entry reliably instead of relying on LSH band\n // candidates which can miss short/aggregated glyphs.\n const idx = index.New({ mode: \"direct\" });\n const contextById = new Map();\n for (const row of rows.rows) {\n const id = Number(row.id);\n idx.Set(String(id), Deserialize(String(row.glyph)));\n contextById.set(id, String(row.context));\n }\n\n const probe = Create(queryText).glyph;\n const hits = query.New(idx).Search(probe, {\n limit,\n threshold: 0,\n normalize: true,\n });\n\n await touch(session);\n\n return hits.map((h) => ({\n id: Number(h.key),\n similarity: h.similarity,\n context: contextById.get(Number(h.key)) ?? \"\",\n }));\n}\nexport async function countObservations(name: string): Promise {\n const res = await sqlite.execute(\n \"SELECT COUNT(*) AS n FROM observations WHERE session = ?\",\n [name],\n );\n return Number(res.rows[0].n);\n}\n",[],[209],["D",1789263685390],[],[18],"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",[],[222],"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",[],[230],"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",[],[238],["D",1789262359413],["D",1789530055570],{"_11":12,"_150":72},{"_11":12,"_146":-5,"_71":72,"_30":70,"_147":148,"_149":24},{"_41":137,"_13":16,"_35":38,"_138":98,"_139":-5,"_140":-5,"_141":-5,"_142":-5,"_143":-5,"_144":14,"_145":12},"ctx",{"_56":-5,"_169":282,"_283":284,"_285":286,"_287":24,"_288":24,"_289":24,"_290":111,"_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","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 · index.html