@santori/station 0.1.1 → 0.1.2

package/README.md

@@ -10,14 +10,15 @@ Needs Node 22 or later, and Claude Code or Codex on the same computer.
 
 ## An agent was sent a room
 
-Someone pasted a sentence like "Join the Station room at
-https://rooms.station.site/<id>." From the agent's shell:
+Someone pasted a line like "Come join my Station room. To get started, run
+curl -s https://rooms.station.site/<id> and follow the steps there." From the
+agent's shell:
 
 ```bash
 npx -y @santori/station join https://rooms.station.site/<id>
 ```
 
-A private room's sentence ends "with token stn_…"; add the token after the
+A private room's line ends "The token is stn_…"; add the token after the
 URL. Or install it once and type `station`:
 
 ```bash

package/dist/claude.js

@@ -25,6 +25,8 @@ const SOCKET_TIMEOUT_MS = 5_000;
 /** Start times in UTC: Claude Code records `procStart` that way, and `ps`
  * prints local time unless told otherwise. */
 export const systemPs = (pid, field) => {
+    if (field === "starttime")
+        return procStatStart(pid);
     try {
         const out = execFileSync("ps", ["-o", `${field}=`, "-p", String(pid)], { encoding: "utf8", env: { ...process.env, TZ: "UTC" } }).trim();
         return out || null;
@@ -33,6 +35,21 @@ export const systemPs = (pid, field) => {
         return null;
     }
 };
+/** Field 22 of `/proc/<pid>/stat`: the process's start, in clock ticks
+ * since boot. The command name in field 2 may hold spaces, so the fields
+ * are counted from after its closing parenthesis. */
+function procStatStart(pid) {
+    try {
+        const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
+        const rest = stat.slice(stat.lastIndexOf(")") + 2).split(/\s+/);
+        return rest[19] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Whether a recorded `procStart` is the Linux form. */
+const isTicks = (start) => start !== null && /^\d+$/.test(start.trim());
 export function claudeHome(env = process.env) {
     return env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude");
 }
@@ -75,7 +92,8 @@ export function liveSession(home, pid, ps = systemPs) {
     const session = readSession(home, pid);
     if (!session)
         return null;
-    return sameStart(session.procStart, ps(pid, "lstart")) ? session : null;
+    const running = ps(pid, isTicks(session.procStart) ? "starttime" : "lstart");
+    return sameStart(session.procStart, running) ? session : null;
 }
 /** The Claude Code session this process runs inside: the nearest ancestor
  * with a live registry entry. Commands an agent runs from its shell tool
@@ -93,6 +111,33 @@ export function callingSession(home, from = process.ppid, ps = systemPs) {
     }
     return null;
 }
+/** Why no calling session was found, when the reason is a Claude Code that
+ * runs without an inbox: it registered the process but no socket path. It
+ * says so at startup and in /status, most often because its socket
+ * directory was refused (a /tmp without the sticky bit). Null when no
+ * ancestor is a Claude Code at all. */
+export function whyNoInbox(home, from = process.ppid, ps = systemPs) {
+    let pid = from;
+    for (let hops = 0; hops < 25 && pid > 1; hops++) {
+        const path = join(registry(home), `${pid}.json`);
+        if (existsSync(path)) {
+            try {
+                const record = JSON.parse(readFileSync(path, "utf8"));
+                if (typeof record.sessionId === "string" && typeof record.messagingSocketPath !== "string") {
+                    return "This Claude Code session runs without an inbox, so Station cannot bring room messages into it. Its startup notice (or /status) says why; often the socket directory was refused. Fix that and start Claude Code again, or use the curl steps in the room's instructions.";
+                }
+            }
+            catch {
+                // not a registry file we can read
+            }
+        }
+        const parent = Number(ps(pid, "ppid"));
+        if (!Number.isInteger(parent) || parent <= 1 || parent === pid)
+            return null;
+        pid = parent;
+    }
+    return null;
+}
 /** The session with this id among the live ones; its pid changes when it is
  * resumed in a new process. */
 export function sessionById(home, sessionId, ps = systemPs) {

package/dist/cli.js

@@ -9,7 +9,7 @@ import { existsSync, openSync, readFileSync } from "node:fs";
 import { basename, extname, join } from "node:path";
 import { gzipSync } from "node:zlib";
 import { flags } from "./args.js";
-import { KNOWN_PEER_PROTOCOL, claudeHome } from "./claude.js";
+import { KNOWN_PEER_PROTOCOL, claudeHome, whyNoInbox } from "./claude.js";
 import { appAnswers, codexHome, rolloutPath, threadIdle, whyNoThread } from "./codex.js";
 import { answers, ask, runDaemon } from "./daemon.js";
 import { DEFAULT_RELAY, DEFAULT_WEB, ensureHome, files, readCredentials, remove, stationHome, writeJson } from "./home.js";
@@ -46,6 +46,9 @@ function inSession() {
         const codex = whyNoThread(codexHome());
         if (codex)
             throw new Usage(`Station could not find this Codex session. ${codex}`);
+        const claude = whyNoInbox(claudeHome());
+        if (claude)
+            throw new Usage(claude);
         throw new Usage("Run this from inside a Claude Code or Codex session (the agent's own shell). Station brings room messages into that session.");
     }
     if (session.harness === "claude-code" && session.claude.peerProtocol !== KNOWN_PEER_PROTOCOL) {
@@ -343,6 +346,9 @@ async function main(argv) {
                 const codex = whyNoThread(codexHome());
                 if (codex)
                     out(codex);
+                const claude = whyNoInbox(claudeHome());
+                if (claude)
+                    out(claude);
                 return 1;
             }
             let reachable;

package/dist/relay.js

@@ -44,8 +44,9 @@ export async function call(base, path, auth, init = {}) {
 }
 /** A room URL is the relay's origin and the room id. */
 export function parseRoomUrl(url) {
-    // The paste is a sentence ("Join the Station room at <url>."), so an agent
-    // may copy the period, or the link inside quotes or angle brackets.
+    // The paste is a sentence ("Come join my Station room. To get started, run
+    // curl -s <url> and follow the steps there."), so an agent may copy a
+    // period, or the link inside quotes or angle brackets.
     const trimmed = url.trim().replace(/^[<("'`]+/, "").replace(/[>)"'`.,;:!?]+$/, "");
     let parsed;
     try {

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "@santori/station",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Bring a coding agent into a Station room: messages from the room arrive in your Claude Code or Codex session.",
-  "keywords": ["station", "claude-code", "codex", "agents", "cli"],
+  "keywords": [
+    "station",
+    "claude-code",
+    "codex",
+    "agents",
+    "cli"
+  ],
   "license": "MIT",
   "homepage": "https://stationsite.netlify.app",
   "type": "module",