@parley-im/parley 0.1.2 → 0.2.1

package/dist/server.js

@@ -4,13 +4,14 @@ import { join, extname, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { randomBytes } from "node:crypto";
 import { loadConfig } from "./config.js";
+import { VERSION } from "./version.js";
 import { Store, sessionDir } from "./db.js";
 import { Runner, mediaTypeFor } from "./runner.js";
 import { Conversations, Problem, MAX_TEXT, ownsUpload } from "./api.js";
 import { RelayLink } from "./relay.js";
 import { createSession } from "./control.js";
 import { readCredentials, relay as registry, ownerName } from "./account.js";
-import { writeState, clearState } from "./state.js";
+import { writeState, clearState, isServerUp } from "./state.js";
 const WEB = join(dirname(fileURLToPath(import.meta.url)), "..", "web");
 const MAX_UPLOAD = 10 * 1024 * 1024;
 // Long polls end well before any proxy's idle timeout.
@@ -22,7 +23,7 @@ const STATIC_TYPES = {
     ".html": "text/html; charset=utf-8",
 };
 // Two local servers: your control panel (and your view of each session), and
-// local tester links for development or when you're not signed in. Shared
+// local guest links for development or when you're not signed in. Shared
 // links go through parley.im instead, over the connection in relay.ts.
 export async function serve() {
     const config = loadConfig();
@@ -36,12 +37,12 @@ export async function serve() {
         dashboardPort: config.dashboardPort,
         startedAt: new Date().toISOString(),
     };
-    const tester = createServer((req, res) => handleTester(req, res).catch((e) => fail(res, e)));
+    const guest = createServer((req, res) => handleGuest(req, res).catch((e) => fail(res, e)));
     const dashboard = createServer((req, res) => handleDashboard(req, res).catch((e) => fail(res, e)));
-    async function handleTester(req, res) {
+    async function handleGuest(req, res) {
         const url = new URL(req.url ?? "/", "http://x");
         if (url.pathname === "/health")
-            return json(res, { ok: true, pid: process.pid });
+            return json(res, { ok: true, pid: process.pid, version: VERSION });
         if (url.pathname.startsWith("/static/"))
             return sendStatic(res, url.pathname.slice(8));
         const m = url.pathname.match(/^\/s\/([A-Za-z0-9_-]{16,})(\/.*)?$/);
@@ -68,7 +69,7 @@ export async function serve() {
         }
         const url = new URL(req.url ?? "/", "http://x");
         if (url.pathname === "/health")
-            return json(res, { ok: true, pid: process.pid });
+            return json(res, { ok: true, pid: process.pid, version: VERSION });
         if (url.pathname === "/")
             return sendStatic(res, "panel.html");
         if (url.pathname.startsWith("/static/"))
@@ -91,19 +92,19 @@ export async function serve() {
             try {
                 session = createSession(store, config, {
                     projectDir: String(body.projectDir ?? ""),
-                    tester: String(body.tester ?? ""),
+                    guest: String(body.guest ?? ""),
                     brief: String(body.brief ?? ""),
                     greeting: body.greeting ? String(body.greeting) : null,
-                    agent: (body.agent === "codex" ? "codex" : "claude"),
+                    agent: body.agent === "codex" || body.agent === "claude" ? body.agent : null,
                     model: body.model ? String(body.model) : null,
-                    replyLimit: body.replyLimit ? Number(body.replyLimit) : null,
+                    replyLimit: body.replyLimit == null ? null : Number(body.replyLimit),
                 });
             }
             catch (error) {
                 return problem(res, 400, "invalid", error.message);
             }
             const shared = await share(session);
-            return json(res, { ...api.ownerView(session), shared });
+            return json(res, { ...api.ownerView(session), session, shared });
         }
         const action = url.pathname.match(/^\/api\/sessions\/([a-z0-9]+)\/(end|delete|limit)$/);
         if (action && req.method === "POST") {
@@ -170,8 +171,22 @@ export async function serve() {
                 const body = await readJson(req, MAX_TEXT * 4 + 10_000);
                 const textBody = String(body.text ?? "").trim();
                 const images = (Array.isArray(body.images) ? body.images : []).map(String).filter((name) => ownsUpload(session, name));
+                const clientId = typeof body.cid === "string" ? body.cid.slice(0, 64) : null;
+                const again = api.resent(scope, clientId);
+                if (again)
+                    return json(res, again);
                 api.check(scope, textBody, images.length);
-                return json(res, api.post(scope, textBody, images));
+                return json(res, api.post(scope, textBody, images, clientId));
+            }
+            // The guest ends it. Local links only; on parley.im it's a sealed request.
+            if (rest === "/api/end" && req.method === "POST") {
+                if (scope.owner)
+                    throw new Problem(403, "read_only", "Your view is read-only.");
+                api.endByGuest(scope);
+                const creds = readCredentials(config);
+                if (creds)
+                    await registry.end(creds, session).catch(() => { });
+                return json(res, { ok: true });
             }
             if (rest === "/api/uploads" && req.method === "POST") {
                 if (scope.owner)
@@ -195,7 +210,9 @@ export async function serve() {
                 if (!ownsUpload(session, name) || !existsSync(file))
                     return notFound(res);
                 res.writeHead(200, { "content-type": mediaTypeFor(name) ?? "application/octet-stream", "cache-control": "private, max-age=86400" });
-                return createReadStream(file).pipe(res);
+                return createReadStream(file)
+                    .on("error", () => res.destroy())
+                    .pipe(res);
             }
             return notFound(res);
         }
@@ -224,9 +241,15 @@ export async function serve() {
             events: events.map(({ event }) => api.eventView(event, scope)).filter(Boolean),
         });
     }
-    tester.listen(config.port, "127.0.0.1");
+    // Already running (started at login, and again by hand, say): leave it be
+    // and exit cleanly, which also tells a login service not to retry.
+    if (await isServerUp(config)) {
+        console.log(`parley: a server is already running on ${config.dashboardPort}; leaving it be.`);
+        process.exit(0);
+    }
+    guest.listen(config.port, "127.0.0.1");
     dashboard.listen(config.dashboardPort, "127.0.0.1");
-    await Promise.all([tester, dashboard].map((server) => new Promise((resolve, reject) => {
+    await Promise.all([guest, dashboard].map((server) => new Promise((resolve, reject) => {
         server.once("listening", resolve);
         server.once("error", reject);
     })));
@@ -234,17 +257,20 @@ export async function serve() {
     console.log(`parley: control panel http://localhost:${config.dashboardPort}, local links on ${config.port}`);
     link.start();
     runner.resume();
+    // Says goodbye to parley.im before exiting, so guests see this computer go
+    // offline at once rather than when parley.im notices the silence.
     const shutdown = () => {
         link.stop();
         runner.stopAll();
         clearState(process.pid);
-        process.exit(0);
+        setTimeout(() => process.exit(0), 300);
     };
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
-    // One bad turn (say, a session deleted mid-reply) shouldn't take every
-    // other tester's link down with it.
+    // One bad turn (say, a session deleted mid-reply) or one broken request
+    // shouldn't take every other guest's link down with it.
     process.on("unhandledRejection", (error) => console.error("unhandled:", error));
+    process.on("uncaughtException", (error) => console.error("uncaught:", error));
 }
 function sendFile(res, status, name) {
     send(res, status, STATIC_TYPES[extname(name)], readFileSync(join(WEB, name)));

package/dist/state.js

@@ -26,16 +26,19 @@ export function linkFor(session, config) {
         return `${config.relayUrl}/s/${session.token}#${session.e2e_key}`;
     return `http://localhost:${config.port}/s/${session.token}`;
 }
-export const isShared = (config) => readCredentials(config) !== null;
 export function dashboardUrl(config, session) {
     return `http://localhost:${config.dashboardPort}${session ? `/o/${session.id}` : "/"}`;
 }
-export async function isServerUp(config) {
+// The running server, as it describes itself, or null if none answers.
+export async function serverHealth(config) {
     try {
         const res = await fetch(`http://127.0.0.1:${config.dashboardPort}/health`, { signal: AbortSignal.timeout(1500) });
-        return res.ok;
+        return res.ok ? (await res.json()) : null;
     }
     catch {
-        return false;
+        return null;
     }
 }
+export async function isServerUp(config) {
+    return (await serverHealth(config)) !== null;
+}

package/dist/transcript.js

@@ -1,5 +1,6 @@
 import { join } from "node:path";
 import { sessionDir } from "./db.js";
+import { modelLabel } from "./models.js";
 const agentName = (s) => (s.agent === "codex" ? "Codex" : "Claude");
 const time = (iso) => new Date(iso).toLocaleString("en-US", { month: "short", day: "numeric", hour: "numeric", minute: "2-digit" });
 // Which model(s) answered, and on what login, from the recorded turns.
@@ -8,7 +9,7 @@ export function interviewer(store, session) {
     const auths = new Set();
     for (const turn of store.turns(session.id)) {
         if (typeof turn.usage?.model === "string")
-            models.add(turn.usage.model);
+            models.add(modelLabel(turn.usage.model));
         if (typeof turn.usage?.auth === "string")
             auths.add(turn.usage.auth === "none" ? "your subscription" : turn.usage.auth);
     }
@@ -33,14 +34,17 @@ export function record(store, session) {
 function render(store, session, messages, { link, onlyNew, image }) {
     const stats = store.stats(session.id);
     const lines = [];
-    lines.push(`# Feedback from ${session.tester} on ${session.project_name}${onlyNew ? " (new since you last read)" : ""}`, "", `- Session: ${session.id}, ${session.status === "open" ? "open" : `ended ${time(session.ended_at ?? session.updated_at)}, link no longer works`}`, `- Interviewer: ${interviewer(store, session)}, started ${time(session.created_at)}`, `- Project: ${session.project_dir}`, `- Files: ${sessionDir(session)}`, ...(session.status === "open" && link ? [`- Tester link: ${link}`] : []), `- Messages: ${stats.tester_messages} from ${session.tester}, ${stats.agent_messages} from ${agentName(session)}`, `- Replies: ${stats.replies} of ${session.reply_limit}${spend(stats.cost_usd)}`, "");
+    lines.push(`# Feedback from ${session.guest} on ${session.project_name}${onlyNew ? " (new since you last read)" : ""}`, "", `- Session: ${session.id}, ${session.status === "open" ? "open" : `ended ${time(session.ended_at ?? session.updated_at)}, link no longer works`}`, `- Interviewer: ${interviewer(store, session)}, started ${time(session.created_at)}`, `- Project: ${session.project_dir}`, `- Files: ${sessionDir(session)}`, ...(session.status === "open" && link ? [`- Guest link: ${link}`] : []), `- Messages: ${stats.guest_messages} from ${session.guest}, ${stats.agent_messages} from ${agentName(session)}`, `- Replies: ${stats.replies} of ${session.reply_limit}${spend(stats.cost_usd)}`, "");
     if (!onlyNew)
         lines.push("## Brief", "", session.brief.trim(), "", "## Conversation", "");
     if (!messages.length)
         lines.push("_Nothing new._");
     for (const m of messages) {
-        const who = m.role === "tester" ? session.tester : m.role === "agent" ? agentName(session) : "Parley (error shown to tester)";
+        const who = m.role === "guest" ? session.guest : m.role === "agent" ? agentName(session) : "Parley (error shown to guest)";
         lines.push(`### ${who} · ${time(m.created_at)} · #${m.id}`, "", m.body.trim());
+        const error = m.role === "error" && m.turn_id ? store.turn(m.session_id, m.turn_id)?.error : null;
+        if (error)
+            lines.push("", `Why it failed (only you see this): ${error}`);
         for (const name of m.images)
             lines.push("", image(name));
         lines.push("");
@@ -51,11 +55,11 @@ const spend = (usd) => (usd ? `, about $${usd.toFixed(2)} at API prices` : "");
 export function summaryLine(store, session, link) {
     const stats = store.stats(session.id);
     const unread = stats.unread ? `, ${stats.unread} new since you last read` : "";
-    const heard = stats.last_tester_at ? `last heard from ${time(stats.last_tester_at)}` : "hasn't said anything yet";
+    const heard = stats.last_guest_at ? `last heard from ${time(stats.last_guest_at)}` : "hasn't said anything yet";
     const status = session.status === "open" ? "open" : `ended ${time(session.ended_at ?? session.updated_at)}`;
     return [
-        `${session.id}  ${session.tester} on ${session.project_name}  [${status}, ${agentName(session)}]`,
-        `  ${stats.tester_messages} message${stats.tester_messages === 1 ? "" : "s"} from ${session.tester}${unread}; ${heard}`,
+        `${session.id}  ${session.guest} on ${session.project_name}  [${status}, ${agentName(session)}]`,
+        `  ${stats.guest_messages} message${stats.guest_messages === 1 ? "" : "s"} from ${session.guest}${unread}; ${heard}`,
         `  ${stats.replies} of ${session.reply_limit} replies used${spend(stats.cost_usd)}`,
         ...(session.status === "open" ? [`  ${link}`] : []),
     ].join("\n");

package/dist/version.js

@@ -0,0 +1,15 @@
+import { readFileSync } from "node:fs";
+// This copy of parley's version, from package.json (one folder up from both
+// src/ and dist/).
+export const VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+// Negative, zero or positive, like a sort comparator: "0.1.10" is newer than "0.1.9".
+export function compareVersions(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (d)
+            return d;
+    }
+    return 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parley-im/parley",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "Send someone a link. They talk to a read-only Claude or Codex in your project, on your computer, and you get everything they said.",
   "keywords": [
     "claude",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=24"
+    "node": ">=22.13"
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json",

package/web/app.css

@@ -1,4 +1,4 @@
-/* parley: one stylesheet for the tester chat, your session view and your
+/* parley: one stylesheet for the guest chat, your session view and your
    control panel. Neutral surfaces, one accent, and a monospace face only where
    it means something (code, paths, the agent's activity, numbers). */
 
@@ -121,6 +121,10 @@ button, input, textarea, select { font: inherit; color: inherit; }
 .sheet-body p { margin: 0 0 10px; color: var(--muted); }
 .sheet-body p strong { color: var(--text); font-weight: 600; }
 .sheet-body .kv { margin: 6px 0 14px; padding: 10px 12px; background: var(--subtle); border: 1px solid var(--line); border-radius: 10px; }
+.sheet-actions { display: flex; gap: 8px; flex-wrap: wrap; margin: 0 0 8px; }
+.sheet-body .fine { font-size: 12px; color: var(--faint); }
+.sheet-body details.how { margin-top: 14px; border-top: 1px solid var(--line); padding-top: 10px; }
+.sheet-body details.how summary { cursor: pointer; color: var(--text); font-weight: 500; margin-bottom: 8px; }
 @media (max-width: 560px) {
   .sheet { left: 0; right: 0; top: auto; bottom: 0; transform: none; width: auto; border-radius: 16px 16px 0 0; padding-bottom: env(safe-area-inset-bottom); }
 }
@@ -135,6 +139,8 @@ button, input, textarea, select { font: inherit; color: inherit; }
 /* ---------- chat ---------- */
 
 .app { display: flex; flex-direction: column; height: 100dvh; overflow: hidden; }
+/* The chat never scrolls the page itself, only its conversation. */
+body:has(> .app) { overflow: hidden; overscroll-behavior: none; }
 .layout { flex: 1; min-height: 0; display: flex; }
 .chat { flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; }
 .chat-inner { width: 100%; max-width: 760px; margin: 0 auto; }
@@ -158,18 +164,19 @@ button, input, textarea, select { font: inherit; color: inherit; }
   font-family: var(--mono); font-size: 14px; line-height: 1.55;
 }
 .msg.agent::before { content: "●"; color: var(--accent); font-size: 10px; line-height: 23px; }
-.msg.tester::before { content: "›"; color: var(--muted); font-weight: 600; top: 10px; }
+.msg.guest::before { content: "›"; color: var(--muted); font-weight: 600; top: 10px; }
 .msg.error::before { content: "!"; color: var(--danger); font-weight: 700; }
 .meta { font-size: 12px; color: var(--faint); margin-bottom: 2px; }
 .meta .who { color: var(--muted); font-weight: 600; }
-.msg.tester .bubble { background: var(--subtle); border: 1px solid var(--line); border-radius: 10px; padding: 9px 12px; }
-.msg.tester .meta { display: none; }
-/* Testers get just the conversation: no names or times on every message. */
-.tester-view .msg .meta, .tester-view .msg .stamp { display: none; }
-.tester-view .msg { margin-bottom: 16px; }
-.tester-view .msg.tester::before { top: 9px; }
-.msg.tester .stamp { font-size: 12px; color: var(--faint); margin-top: 4px; }
+.msg.guest .bubble { background: var(--subtle); border: 1px solid var(--line); border-radius: 10px; padding: 9px 12px; }
+.msg.guest .meta { display: none; }
+/* Guests get just the conversation: no names or times on every message. */
+.guest-view .msg .meta, .guest-view .msg .stamp { display: none; }
+.guest-view .msg { margin-bottom: 16px; }
+.guest-view .msg.guest::before { top: 9px; }
+.msg.guest .stamp { font-size: 12px; color: var(--faint); margin-top: 4px; }
 .msg.error .body { color: var(--danger); font-size: 14px; }
+.msg.error .detail { margin-top: 6px; font-size: 12px; color: var(--muted); white-space: pre-wrap; word-break: break-word; }
 .msg .body { overflow-wrap: anywhere; }
 
 .shots { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 8px; }
@@ -196,7 +203,7 @@ button, input, textarea, select { font: inherit; color: inherit; }
 .body li { margin: 0.15em 0; }
 .body h4 { margin: 0.8em 0 0.3em; font-size: 1em; }
 .body code { font-family: var(--mono); font-size: 0.86em; background: var(--subtle); border: 1px solid var(--line); padding: 0.05em 0.35em; border-radius: 5px; }
-.msg.tester .body code { background: var(--panel); }
+.msg.guest .body code { background: var(--panel); }
 .body pre { background: var(--subtle); border: 1px solid var(--line); padding: 10px 12px; border-radius: 8px; overflow-x: auto; margin: 0 0 0.65em; font-size: 13px; }
 .body pre code { background: none; border: 0; padding: 0; font-size: inherit; }
 .body a { color: var(--accent); }
@@ -218,6 +225,10 @@ button, input, textarea, select { font: inherit; color: inherit; }
 .dock .chat-inner { padding: 8px 16px calc(8px + env(safe-area-inset-bottom)); }
 .composer { border: 1px solid var(--line-strong); border-radius: 12px; background: var(--panel); box-shadow: var(--shadow); }
 .composer:focus-within { border-color: var(--accent); box-shadow: 0 0 0 3px var(--accent-soft); }
+/* The sender's computer (or this page's connection) is offline: nothing can
+   be sent until it's back, and it looks that way. */
+.app.offline .composer, .app.offline .composer:focus-within { border-color: var(--danger); box-shadow: 0 0 0 3px color-mix(in srgb, var(--danger) 18%, transparent); }
+.app.offline .prompt { color: var(--danger); }
 .composer .row { display: flex; align-items: flex-end; gap: 2px; padding: 4px 4px 4px 12px; }
 .prompt { font-family: var(--mono); color: var(--accent); font-weight: 600; padding: 9px 4px 9px 0; line-height: 1.55; }
 textarea {
@@ -227,10 +238,12 @@ textarea {
   field-sizing: content;
   max-height: calc(1.55em * 8 + 16px);
 }
-/* On phones it stops at three lines and scrolls inside, so the conversation
-   keeps the room. */
+/* On phones it stops at two lines and scrolls inside, and screenshots get
+   smaller thumbnails, so the conversation keeps the room. */
 @media (pointer: coarse) {
-  textarea { max-height: calc(1.55em * 3 + 16px); }
+  textarea { max-height: calc(1.55em * 2 + 16px); }
+  .attachments { padding: 8px 8px 0; gap: 6px; }
+  .thumb img { width: 40px; height: 40px; border-radius: 6px; }
 }
 textarea::placeholder { color: var(--faint); }
 .icon-btn {
@@ -380,6 +393,7 @@ body.panel { overflow: auto; }
 .site code { font-family: var(--mono); font-size: 0.88em; background: var(--subtle); border: 1px solid var(--line); padding: 0.05em 0.35em; border-radius: 5px; }
 .site h3 { margin: 32px 0 8px; }
 .stack { display: grid; gap: 10px; max-width: 360px; margin-top: 16px; }
+.live { display: inline-flex; align-items: center; gap: 7px; font-size: 13px; color: var(--muted); white-space: nowrap; }
 .docs { padding-bottom: 40px; }
 .docs h2 { font-size: 17px; letter-spacing: -0.01em; margin: 36px 0 10px; }
 .docs p, .docs li { max-width: 66ch; }
@@ -389,6 +403,8 @@ body.panel { overflow: auto; }
 .docs pre code { background: none; border: 0; padding: 0; font-size: inherit; }
 .docs blockquote { margin: 10px 0; padding: 8px 14px; border-left: 3px solid var(--accent); background: var(--accent-soft); border-radius: 0 8px 8px 0; color: var(--text); }
 .trow.site-row { grid-template-columns: 1fr auto; }
+/* Long details shorten instead of pushing the buttons off a phone screen. */
+.trow.site-row .who-cell { min-width: 0; }
 
 /* parley.im's front page: no words, just home.js drawing on a faint grid. */
 body.home { overflow: hidden; }

package/web/chat.html

@@ -11,7 +11,7 @@
 <meta property="og:description" content="{{PREVIEW_TEXT}}">
 <meta property="og:site_name" content="parley">
 <title>{{TITLE}}</title>
-<link rel="icon" href="/static/icon.svg">
+<link rel="icon" href="/static/icon.svg?v=2" type="image/svg+xml">
 <link rel="stylesheet" href="/static/app.css">
 </head>
 <body>
@@ -23,9 +23,9 @@
     </nav>
     <span class="status" id="status" hidden><span class="dot" id="status-dot"></span><span id="status-text"></span></span>
     <span class="chip" id="chip" hidden></span>
-    <button class="icon-btn info-btn" id="info-btn" type="button" title="About this chat" hidden>
-      <svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="8.5"/><path d="M12 11v5"/><path d="M12 7.6v.1"/></svg>
-      <span class="sr">About this chat</span>
+    <button class="icon-btn info-btn" id="info-btn" type="button" title="This conversation" hidden>
+      <svg viewBox="0 0 24 24" aria-hidden="true"><path d="M5 7h14"/><path d="M5 12h14"/><path d="M5 17h9"/></svg>
+      <span class="sr">This conversation: details and actions</span>
     </button>
   </header>
 
@@ -68,8 +68,8 @@
   </div>
 </div>
 <div class="sheet-back" id="sheet-back" hidden></div>
-<section class="sheet" id="sheet" hidden aria-label="About this chat">
-  <header><h2>About this chat</h2><button class="btn ghost" id="sheet-close" type="button">Done</button></header>
+<section class="sheet" id="sheet" hidden aria-label="This conversation">
+  <header><h2>This conversation</h2><button class="btn ghost" id="sheet-close" type="button">Done</button></header>
   <div class="sheet-body" id="sheet-body"></div>
 </section>
 <div class="drop" id="drop" hidden><div>Drop screenshots to add them</div></div>