@irisrun/channel-web 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,28 @@
+# @irisrun/channel-web
+
+**Durable, resumable sessions a human can talk to in the browser.** A minimal,
+zero-dependency web chat UI for `iris serve --web` that persists its session
+handle to `localStorage`, so closing the tab or reloading the page resumes the
+*same* durable session while the server is up.
+
+## What it is
+
+`makeWebHandler` is a host-side, pre-POST `GET` hook that serves two static assets
+(`index.html` + `iris-web.js`) on the same port as the agent. The browser shell
+speaks the `iris serve` SSE protocol and adopts the rotated `continuationToken`
+the server returns, so resumption uses the same two-identifier discipline as every
+other channel. The shell **mirrors** `@irisrun/client-sdk`'s wire logic (there is
+no bundler, so it can't share the import); it is a static asset that lives
+**outside** the TypeScript include and the test glob.
+
+## Use it
+
+```sh
+iris serve ./image --port 8787 --web   # → open http://127.0.0.1:8787/
+```
+
+See **[docs/Channels](../../docs/channels.md)** for the serve protocol and
+the client SDK.
+
+---
+Part of [Iris](../../README.md) — own, portable, verifiable state.

package/dist/index.js

@@ -1,4 +1,4 @@
-// @irisrun/channel-web — the web channel's HOST side (spec §2.2). `makeWebHandler`
+// @irisrun/channel-web — the web channel's HOST side. `makeWebHandler`
 // returns a pre-POST GET hook for `makeRestChannel`'s `webHandler` seam: it serves
 // the two static assets (the chat page + its browser shell) and returns `false` for
 // everything else, so `/v1/*` POST and the WebSocket upgrade are untouched. Host-side

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@irisrun/channel-web",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
-  "description": "Iris web channel — a minimal, zero-dep web chat UI served by `iris serve --web` on the same port. `makeWebHandler` is a pre-POST GET hook (host-side, node:fs/http) that serves two static assets (index.html + iris-web.js). The browser shell talks the iris serve SSE protocol and persists {sessionId, continuationToken} to localStorage so a tab close/reload resumes the same session while the server is up. The shell MIRRORS @irisrun/client-sdk's wire logic (no bundler → no shared import); it is a static asset OUTSIDE the tsc include and the test glob.",
+  "description": "Durable, resumable browser sessions — a minimal, zero-dep web chat UI (`iris serve --web`) that persists {sessionId, continuationToken} to localStorage so a tab close/reload resumes the SAME durable session while the server is up. `makeWebHandler` is a host-side pre-POST GET hook serving two static assets (index.html + iris-web.js); the shell talks the iris serve SSE protocol and MIRRORS @irisrun/client-sdk's wire logic (no bundler → no shared import) — a static asset OUTSIDE the tsc include and test glob.",
   "exports": {
     ".": {
       "iris-src": "./src/index.ts",