brane 0.1.1 → 0.3.1

package/expo/dist/sw.js

@@ -0,0 +1,154 @@
+// Brane service worker — cache-first for static assets, network-first for API/WS.
+//
+// The two constants below are placeholders in this source file and are rewritten
+// in `dist/sw.js` by scripts/gen-precache.mjs, which reads the export that was
+// actually produced. Editing them here has no effect on a build; see that script
+// for why the list is generated rather than maintained by hand.
+const CACHE_NAME = "brane-6ce22c4f8738";
+const PRECACHE = [
+  "/",
+  "/_expo/static/js/web/entry-e94247f119fdcd3b424a1764233a41d2.js",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/back-icon-mask.0a328cd9c1afd0afe8e3b1ec5165b1b4.png",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/back-icon.35ba0eaec5a4f5ed12ca16fabeae451d.png",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/clear-icon.c94f6478e7ae0cdd9f15de1fcb9e5e55.png",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/clear-icon.c94f6478e7ae0cdd9f15de1fcb9e5e55@2x.png",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/clear-icon.c94f6478e7ae0cdd9f15de1fcb9e5e55@3x.png",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/clear-icon.c94f6478e7ae0cdd9f15de1fcb9e5e55@4x.png",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/close-icon.808e1b1b9b53114ec2838071a7e6daa7.png",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/close-icon.808e1b1b9b53114ec2838071a7e6daa7@2x.png",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/close-icon.808e1b1b9b53114ec2838071a7e6daa7@3x.png",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/close-icon.808e1b1b9b53114ec2838071a7e6daa7@4x.png",
+  "/assets/node_modules/@react-navigation/elements/lib/module/assets/search-icon.286d67d3f74808a60a78d3ebf1a5fb57.png",
+  "/assets/node_modules/expo-router/assets/arrow_down.017bc6ba3fc25503e5eb5e53826d48a8.png",
+  "/assets/node_modules/expo-router/assets/error.d1ea1496f9057eb392d5bbf3732a61b7.png",
+  "/assets/node_modules/expo-router/assets/file.19eeb73b9593a38f8e9f418337fc7d10.png",
+  "/assets/node_modules/expo-router/assets/forward.d8b800c443b8972542883e0b9de2bdc6.png",
+  "/assets/node_modules/expo-router/assets/pkg.ab19f4cbc543357183a20571f68380a3.png",
+  "/assets/node_modules/expo-router/assets/sitemap.412dd9275b6b48ad28f5e3d81bb1f626.png",
+  "/assets/node_modules/expo-router/assets/unmatched.20e71bdf79e3a97bf55fd9e164041578.png",
+  "/favicon.svg",
+  "/katex/fonts/KaTeX_Main-Bold.woff2",
+  "/katex/fonts/KaTeX_Main-BoldItalic.woff2",
+  "/katex/fonts/KaTeX_Main-Italic.woff2",
+  "/katex/fonts/KaTeX_Main-Regular.woff2",
+  "/katex/fonts/KaTeX_Math-BoldItalic.woff2",
+  "/katex/fonts/KaTeX_Math-Italic.woff2",
+  "/katex/katex.min.css",
+  "/manifest.json"
+];
+const VENDOR_CACHE = "brane-vendor-d57f3df64e26";
+
+// Vendored files fetched on demand rather than precached: KaTeX's font tail and
+// pdf.js. They go in a cache of their own, named for a hash of the vendored
+// files alone, because CACHE_NAME changes on essentially every build — and
+// `activate` drops every cache but the current ones. Kept in CACHE_NAME, a face
+// fetched last week was gone after the next deploy, so "updated while online,
+// then went offline" rendered math in fallback glyphs. Here they survive every
+// build that doesn't change the vendored files themselves, and a KaTeX or
+// pdf.js upgrade retires them together.
+function isVendor(pathname) {
+  return (
+    pathname.startsWith("/katex/") ||
+    pathname === "/pdf.min.mjs" ||
+    pathname === "/pdf.worker.min.mjs"
+  );
+}
+
+// Assets safe to serve from cache without revalidating. `_expo/static` is
+// content-hashed; the rest are vendored files that only change with a build,
+// which is also when CACHE_NAME changes and the old cache is dropped.
+function isStatic(pathname) {
+  return (
+    pathname.startsWith("/_expo/static/") ||
+    pathname.startsWith("/assets/") ||
+    pathname.startsWith("/katex/") ||
+    pathname === "/favicon.svg" ||
+    pathname === "/manifest.json" ||
+    // pdf.js is deliberately left out of PRECACHE (1.7 MB); this is what makes
+    // it stick after the first PDF you open.
+    pathname === "/pdf.min.mjs" ||
+    pathname === "/pdf.worker.min.mjs"
+  );
+}
+
+// Precache the shell on install. `addAll` is atomic on purpose: a partial
+// precache is the silent half-offline state this worker exists to eliminate, so
+// a failed install leaves the previous worker serving and retries on next load.
+self.addEventListener("install", (event) => {
+  event.waitUntil(
+    caches
+      .open(CACHE_NAME)
+      .then((cache) => cache.addAll(PRECACHE))
+      .then(() => self.skipWaiting()),
+  );
+});
+
+self.addEventListener("activate", (event) => {
+  // Clean old caches — every one but this build's shell and the vendored files
+  // it ships, which may well be the same files an older build fetched.
+  event.waitUntil(
+    caches.keys().then((keys) =>
+      Promise.all(
+        keys.filter((k) => k !== CACHE_NAME && k !== VENDOR_CACHE).map((k) => caches.delete(k)),
+      )
+    ).then(() => self.clients.claim())
+  );
+});
+
+function cacheFirst(request, cacheName) {
+  return caches.match(request).then((cached) => {
+    if (cached) return cached;
+    return fetch(request).then((response) => {
+      if (response.ok && !isShellFallback(response)) {
+        const clone = response.clone();
+        caches.open(cacheName).then((cache) => cache.put(request, clone));
+      }
+      return response;
+    });
+  });
+}
+
+// None of the static paths is HTML, but the servers answer a path they don't
+// have with the SPA shell and a 200 — the daemon's static handler and the
+// Cloudflare worker's single-page fallback both do. A font or script URL
+// requested mid-deploy (an `expo export` clears its output first) would cache
+// that page under its own name, cache-first, never revalidated. In
+// VENDOR_CACHE it would then outlive every build until KaTeX or pdf.js
+// changed. So an HTML answer to a static request is served, never kept.
+function isShellFallback(response) {
+  return (response.headers.get("content-type") || "").toLowerCase().startsWith("text/html");
+}
+
+self.addEventListener("fetch", (event) => {
+  const url = new URL(event.request.url);
+
+  // Skip non-GET, API calls, and WebSocket upgrades
+  if (
+    event.request.method !== "GET" ||
+    url.pathname.startsWith("/api/") ||
+    url.pathname.startsWith("/ws/")
+  ) {
+    return;
+  }
+
+  if (isStatic(url.pathname)) {
+    event.respondWith(cacheFirst(event.request, isVendor(url.pathname) ? VENDOR_CACHE : CACHE_NAME));
+    return;
+  }
+
+  // HTML pages (/, /[nid], etc.) — network-first with cache fallback
+  // This ensures updates propagate but offline still works. The final fallback
+  // is the precached "/", which is the whole point of precaching it: a cold
+  // offline load of a deep route still gets the SPA shell.
+  event.respondWith(
+    fetch(event.request)
+      .then((response) => {
+        if (response.ok) {
+          const clone = response.clone();
+          caches.open(CACHE_NAME).then((cache) => cache.put(event.request, clone));
+        }
+        return response;
+      })
+      .catch(() => caches.match(event.request).then((cached) => cached || caches.match("/")))
+  );
+});

package/package.json

@@ -1,41 +1,93 @@
 {
   "name": "brane",
-  "version": "0.1.1",
-  "author": "Ben Newman <ben@eloper.dev>",
-  "description": "Efficient inter-Worker messaging with fantastic TypeScript support",
-  "license": "MIT",
-  "main": "lib/brane.cjs.js",
-  "module": "lib/brane.js",
-  "types": "lib/brane.d.ts",
-  "keywords": [],
-  "homepage": "https://github.com/benjamn/brane",
+  "version": "0.3.1",
+  "description": "Userspace daemon and CLI for narrative agent sessions",
+  "keywords": [
+    "agents",
+    "claude",
+    "mcp",
+    "tmux",
+    "daemon",
+    "cli",
+    "llm"
+  ],
+  "homepage": "https://github.com/benjamn/brane#readme",
+  "bugs": {
+    "url": "https://github.com/benjamn/brane/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/benjamn"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/benjamn/brane.git"
   },
-  "bugs": {
-    "url": "https://github.com/benjamn/brane/issues"
+  "type": "module",
+  "bin": {
+    "brane": "./dist/cli.js"
   },
+  "files": [
+    "dist",
+    "!dist/**/*.d.ts",
+    "!dist/**/*.map",
+    "expo/dist",
+    "protocols",
+    "wiki/shared",
+    "AGENTS.md",
+    "docs",
+    "CONTRIBUTING.md",
+    "CHANGELOG.md",
+    "DESIGN.md",
+    "SECURITY.md",
+    "Dockerfile",
+    "docker-entrypoint.sh"
+  ],
   "scripts": {
-    "clean": "rimraf lib",
-    "tsc": "tsc",
-    "rollup": "rollup -c",
-    "build": "npm run clean && npm run tsc && npm run rollup",
-    "mocha": "scripts/test.sh lib/tests.js",
-    "prepublish": "npm run build",
-    "test": "npm run build && npm run mocha"
+    "clean": "node scripts/clean-dist.mjs",
+    "prebuild": "npm run clean",
+    "build": "tsc && npm run build:web --prefix expo",
+    "postbuild": "node scripts/chmod-bin.mjs",
+    "prebuild:server": "npm run clean",
+    "build:server": "tsc",
+    "postbuild:server": "node scripts/chmod-bin.mjs",
+    "start": "node dist/cli.js",
+    "test": "tsc && node --test dist/test/*.test.js"
   },
   "dependencies": {
-    "tslib": "^1.11.1"
+    "@dagrejs/dagre": "^3.1.1",
+    "better-sqlite3": "^13.0.3",
+    "citty": "^0.1.6",
+    "katex": "^0.18.4",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm-autolink-literal": "^2.0.1",
+    "mdast-util-gfm-table": "^2.0.0",
+    "mdast-util-gfm-task-list-item": "^2.0.0",
+    "micromark": "^4.0.2",
+    "micromark-extension-gfm-autolink-literal": "^2.1.0",
+    "micromark-extension-gfm-table": "^2.1.1",
+    "micromark-extension-gfm-task-list-item": "^2.1.0",
+    "micromark-extension-math": "^3.1.0",
+    "onnxruntime-node": "^1.21.0",
+    "qrcode-terminal": "^0.12.0",
+    "shiki": "^4.0.2",
+    "sqlite-vec": "^0.1.9",
+    "stream-json": "^3.7.0",
+    "ws": "^8.19.0"
   },
   "devDependencies": {
-    "@types/mocha": "^7.0.2",
-    "@types/node": "^13.13.4",
-    "esm": "3.2.25",
-    "mocha": "7.1.2",
-    "rimraf": "3.0.2",
-    "rollup": "2.7.3",
-    "source-map-support": "0.5.19",
-    "typescript": "3.8.3"
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22.0.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.7.0",
+    "wrangler": "^4.70.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "AGPL-3.0-or-later",
+  "overrides": {
+    "katex": "$katex"
   }
 }