sphinx-understand 0.1.0 → 0.1.1

package/src/sessions.js

@@ -364,5 +364,14 @@ export function createSessionStore({ env = process.env, generate = generateAsses
       return publicSession(session);
     });
   }
-  return {ensure,approved,prepare,start,retryReview,refreshBudget,answer,pending,read,skip,public:publicSession};
+  /** Remove a check that never made a model call or produced a question. Anything with progress is kept. */
+  async function discard(id) {
+    return withLock(id, env, async () => {
+      const session = await readJson(sessionFile(id, env), null);
+      if (!session || session.status !== 'pending' || session.calls || session.questions.length || session.reviewerCheckpoint) return false;
+      await unlink(sessionFile(id, env)).catch(e => { if (e.code !== 'ENOENT') throw e; });
+      return true;
+    });
+  }
+  return {ensure,approved,prepare,start,retryReview,refreshBudget,answer,pending,read,skip,discard,public:publicSession};
 }

package/src/stream.js

@@ -0,0 +1,59 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+// When a human is watching, transports stream model text into this sink. The
+// final response is still parsed and validated exactly as before.
+const listener = new AsyncLocalStorage();
+export const withTextStream = (sink, operation) => listener.run(sink, operation);
+export const textStream = () => listener.getStore();
+
+const ESCAPES = { '"': '"', '\\': '\\', '/': '/', b: '\b', f: '\f', n: '\n', r: '\r', t: '\t' };
+/** Decode a JSON string field from a possibly incomplete JSON document. */
+export function partialField(raw, key) {
+  const match = new RegExp(`"${key}"\\s*:\\s*"`, 'u').exec(raw);
+  if (!match) return null;
+  let text = '';
+  for (let i = match.index + match[0].length; i < raw.length; i++) {
+    const char = raw[i];
+    if (char === '"') return { text, complete: true };
+    if (char !== '\\') { text += char; continue; }
+    const next = raw[i + 1];
+    if (next === undefined) break;
+    if (next === 'u') {
+      const hex = raw.slice(i + 2, i + 6);
+      if (!/^[0-9a-fA-F]{4}$/u.test(hex)) break;
+      text += String.fromCharCode(parseInt(hex, 16)); i += 5; continue;
+    }
+    text += ESCAPES[next] ?? next; i++;
+  }
+  return { text, complete: false };
+}
+
+/** Parse an OpenRouter server-sent event stream into one chat completion. */
+export async function readCompletionStream(body, { onContent, signal, maxBytes = 1024 * 1024 } = {}) {
+  const decoder = new TextDecoder();
+  let buffer = '', content = '', finishReason, usage, error, bytes = 0;
+  const handle = line => {
+    if (!line.startsWith('data:')) return; // comments keep the connection alive
+    const payload = line.slice(5).trim();
+    if (!payload || payload === '[DONE]') return;
+    let chunk;
+    try { chunk = JSON.parse(payload); } catch { return; }
+    if (chunk.error) error = chunk.error;
+    const choice = chunk.choices?.[0];
+    if (choice?.error) error = choice.error;
+    const delta = choice?.delta?.content;
+    if (typeof delta === 'string' && delta) { content += delta; try { onContent?.(content); } catch {} }
+    if (choice?.finish_reason) finishReason = choice.finish_reason;
+    if (chunk.usage) usage = chunk.usage;
+  };
+  for await (const chunk of body) {
+    signal?.throwIfAborted();
+    bytes += chunk.length;
+    if (bytes > maxBytes) throw Object.assign(new Error('Response too large'), { oversized: true });
+    buffer += decoder.decode(chunk, { stream: true });
+    let newline;
+    while ((newline = buffer.indexOf('\n')) >= 0) { handle(buffer.slice(0, newline).replace(/\r$/u, '')); buffer = buffer.slice(newline + 1); }
+  }
+  handle(buffer);
+  return { ...(error ? { error } : {}), choices: [{ message: { content }, finish_reason: finishReason ?? (error ? 'error' : undefined) }], ...(usage ? { usage } : {}) };
+}

package/src/terminal.js

@@ -38,19 +38,21 @@ export function wrapText(value, width = 80, indent = '') {
   }).join('\n');
 }
 
-// A human face and striped nemes above the lion's body and outstretched paws.
+// The Sphinx mark in half-blocks, matching the SVG logo: crowned nemes with a
+// forehead band, striped lappets, eyes, mouth, and the false beard.
 export const SPHINX = [
-  '        .-====-.',
-  '       /  .--.  \\',
-  '      /  /    \\  \\',
-  '      |  |o  o|  |',
-  '      |  | __ |  |',
-  "     /|  '----'  |\\",
-  '    /_|__/|  |\\__|_\\',
-  '   /      |__|      \\____',
-  "  /   ___/____\\___       `-.",
-  ' /___/            \\________\\',
-  ' \\___\\____________/___/____/',
+  '      ▄██████████▄',
+  '    ▄██████████████▄',
+  '    ████████████████',
+  '   ███▄▄▄▄▄▄▄▄▄▄▄▄███',
+  '  ▀▀▀▀▀██      ██▀▀▀▀▀',
+  '   ▀▀▀▀██ ▀  ▀ ██▀▀▀▀',
+  '   ▀▀▀▀██      ██▀▀▀▀',
+  '   ▀▀▀▀██  ▀▀  ██▀▀▀▀',
+  '   ▀▀▀▀██▄    ▄██▀▀▀▀',
+  '   ▀▀▀▀███ ▄▄ ███▀▀▀▀',
+  '   ▀▀▀▀███ ██ ███▀▀▀▀',
+  '   ██████████████████',
 ];
 
 export function createTerminal({ stream = process.stdout, env = process.env, width } = {}) {
@@ -79,8 +81,8 @@ export function createTerminal({ stream = process.stdout, env = process.env, wid
   const banner = () => {
     write('');
     if (size >= 65) {
-      const side = { 2: style.strong('sphinx'), 4: 'Outsource your thinking,', 5: 'not your understanding.' };
-      SPHINX.forEach((line, index) => write(style.amber(line.padEnd(32)) + (side[index] || '')));
+      const side = { 4: style.strong('sphinx'), 6: 'Outsource your thinking,', 7: 'not your understanding.' };
+      SPHINX.forEach((line, index) => write(style.amber(line.padEnd(28)) + (side[index] || '')));
     } else {
       if (size >= 30) SPHINX.forEach(line => write(style.amber(line)));
       paragraph(style.strong('sphinx'));

package/src/version.js

@@ -0,0 +1,4 @@
+import { readFileSync } from 'node:fs';
+
+/** The installed package version, read once from package.json so it never drifts. */
+export const VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;