khala-cli 0.4.4 → 0.4.5

package/dist/{chunk-GE3RXO2X.mjs → chunk-EXHCVFVH.mjs}

@@ -2,9 +2,9 @@ import { createRequire as __khalaCreateRequire } from 'node:module'; const requi
 import {
   readStatus,
   sessionFiles
-} from "./chunk-XEYKJMZL.mjs";
+} from "./chunk-KCJFSVDN.mjs";
 import "./chunk-SN3STAO2.mjs";
-import "./chunk-ZKDDKUUA.mjs";
+import "./chunk-PXKGKVGW.mjs";
 
 // hooks/session-start.ts
 async function run(stdin, argv) {

package/dist/{chunk-MU4FUENP.mjs → chunk-H46OG22B.mjs}

@@ -1,5 +1,5 @@
 import { createRequire as __khalaCreateRequire } from 'node:module'; const require = __khalaCreateRequire(import.meta.url);
-import "./chunk-ZKDDKUUA.mjs";
+import "./chunk-PXKGKVGW.mjs";
 
 // hooks/claude-wake.ts
 import fs from "node:fs/promises";
@@ -18,7 +18,7 @@ async function readJson(file) {
     throw error;
   }
 }
-async function unreadMessages(dir) {
+async function unreadChannelMessages(dir) {
   const cursor = await readJson(path.join(dir, "cursor.json"));
   const delivered = cursor && (cursor.lastDeliveredEventId === null || typeof cursor.lastDeliveredEventId === "string") && Number.isSafeInteger(cursor.deliveredCount) && typeof cursor.deliveredCount === "number" && cursor.deliveredCount >= 0 ? cursor.deliveredCount : 0;
   let content;
@@ -41,6 +41,22 @@ async function unreadMessages(dir) {
   }
   return messages;
 }
+async function unreadMessages(dir) {
+  const directories = [dir];
+  try {
+    for (const entry of await fs.readdir(path.join(dir, "channels"), { withFileTypes: true })) {
+      if (entry.isDirectory() && !entry.isSymbolicLink()) directories.push(path.join(dir, "channels", entry.name));
+    }
+  } catch (error) {
+    if (error.code !== "ENOENT") throw error;
+  }
+  let messages = 0;
+  for (const directory of directories) {
+    if ((await readJson(path.join(directory, "mode.json")))?.mode === "async") continue;
+    messages += await unreadChannelMessages(directory);
+  }
+  return messages;
+}
 function testDuration(value, fallback) {
   const number = Number(value);
   return Number.isSafeInteger(number) && number > 0 ? number : fallback;
@@ -78,11 +94,10 @@ async function watch(stdin, _argv, io = { stderr: process.stderr, env: process.e
       const activity = await readJson(path.join(dir, "activity.json"));
       return activity?.state === "idle" && typeof activity.updatedAt === "string" && Number.isFinite(Date.parse(activity.updatedAt));
     };
-    const listening = async () => (await readJson(path.join(dir, "mode.json")))?.mode !== "async";
     while (io.now().getTime() < deadline) {
       if (!await owns() || !parentAlive(parent)) return 0;
-      if (await listening() && await idle() && await unreadMessages(dir) > 0) {
-        if (await unreadMessages(dir) > 0 && await listening() && await idle() && await owns() && parentAlive(parent) && io.now().getTime() < deadline) {
+      if (await idle() && await unreadMessages(dir) > 0) {
+        if (await unreadMessages(dir) > 0 && await idle() && await owns() && parentAlive(parent) && io.now().getTime() < deadline) {
           io.stderr.write(NOTICE);
           return 2;
         }

package/dist/{chunk-LHAMBQK7.mjs → chunk-HB3UGIZG.mjs}

@@ -3,16 +3,16 @@ import {
   KhalaClientError,
   LOCAL_DEFAULT_PORT,
   decodeHelperFile
-} from "./chunk-OS2JLDL7.mjs";
+} from "./chunk-TZKEQIHP.mjs";
 import {
   bundle
-} from "./chunk-ZRFXZK72.mjs";
+} from "./chunk-OLZ62X7S.mjs";
 import {
   StateError,
   ensureStateDir,
   readJson,
   stateRoot
-} from "./chunk-XEYKJMZL.mjs";
+} from "./chunk-KCJFSVDN.mjs";
 
 // src/local/lifecycle.ts
 import * as fs from "node:fs/promises";

package/dist/{chunk-DC3OX6F4.mjs → chunk-IR3VN2ID.mjs}

@@ -6,7 +6,7 @@ import {
 import {
   readJson,
   writeJsonAtomic
-} from "./chunk-XEYKJMZL.mjs";
+} from "./chunk-KCJFSVDN.mjs";
 
 // src/activity.ts
 import path from "node:path";

package/dist/{chunk-XEYKJMZL.mjs → chunk-KCJFSVDN.mjs}

@@ -6,7 +6,7 @@ import {
 // src/state.ts
 import { constants } from "node:fs";
 import * as fs from "node:fs/promises";
-import { randomUUID } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import os from "node:os";
 import path from "node:path";
 var SESSION_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
@@ -38,6 +38,38 @@ function stateRoot(env = process.env) {
 function filesForDir(dir) {
   return { dir, mode: path.join(dir, "mode.json"), join: path.join(dir, "join.json"), session: path.join(dir, "session.json"), inbox: path.join(dir, "inbox.jsonl"), cursor: path.join(dir, "cursor.json"), status: path.join(dir, "status.json") };
 }
+function stateKey(value) {
+  return createHash("sha256").update(value).digest("hex").slice(0, 24);
+}
+function channelsDir(files) {
+  return path.join(files.dir, "channels");
+}
+function channelFiles(files, roomId) {
+  return filesForDir(path.join(channelsDir(files), stateKey(roomId)));
+}
+function joinFilePath(files, key) {
+  if (!/^[a-f0-9]{24}$/.test(key)) throw new StateError("storage_failed");
+  return path.join(files.dir, "joins", `${key}.json`);
+}
+async function writeJoinFile(files, link, join) {
+  const file = joinFilePath(files, stateKey(link));
+  await ensureStateDir(path.dirname(file));
+  await writeJsonAtomic(file, join);
+}
+async function readJoinFile(files, link) {
+  const file = joinFilePath(files, stateKey(link));
+  await ensureStateDir(path.dirname(file));
+  return readJson(file);
+}
+async function removeJoinFile(files, link) {
+  const file = joinFilePath(files, stateKey(link));
+  await ensureStateDir(path.dirname(file));
+  try {
+    await fs.unlink(file);
+  } catch (error) {
+    if (error.code !== "ENOENT") throw new StateError("storage_failed");
+  }
+}
 function sessionFiles(harness, sessionId, env) {
   if (!HARNESSES.includes(harness) || !SESSION_ID_PATTERN.test(sessionId)) throw new StateError("invalid_session_id");
   return filesForDir(path.join(stateRoot(env), harness, sessionId));
@@ -47,7 +79,20 @@ function resolveStateDir(harness, sessionId, env) {
 }
 async function ensureStateDir(dir) {
   try {
-    for (const directory of [path.dirname(path.dirname(dir)), path.dirname(dir), dir]) {
+    let sessionDir = dir;
+    if (path.basename(path.dirname(dir)) === "channels" && /^[a-f0-9]{24}$/.test(path.basename(dir)) && HARNESSES.includes(path.basename(path.dirname(path.dirname(path.dirname(dir)))))) {
+      sessionDir = path.dirname(path.dirname(dir));
+    } else if (["channels", "joins"].includes(path.basename(dir)) && HARNESSES.includes(path.basename(path.dirname(path.dirname(dir))))) {
+      sessionDir = path.dirname(dir);
+    }
+    const directories = [path.dirname(path.dirname(sessionDir)), path.dirname(sessionDir), sessionDir];
+    const relative = path.relative(sessionDir, dir);
+    let parent = sessionDir;
+    for (const component of relative ? relative.split(path.sep) : []) {
+      parent = path.join(parent, component);
+      directories.push(parent);
+    }
+    for (const directory of directories) {
       try {
         await fs.mkdir(directory, { recursive: true, mode: 448 });
       } catch (error) {
@@ -105,7 +150,7 @@ function readStatus(files) {
   return readJson(files.status);
 }
 async function writeStateFile(dir, name, value) {
-  if (!["join.json", "session.json", "cursor.json", "status.json", "mode.json", "rejoin.json"].includes(name)) throw new StateError("storage_failed");
+  if (!["join.json", "session.json", "cursor.json", "status.json", "mode.json", "rejoin.json", "channel.json"].includes(name)) throw new StateError("storage_failed");
   await writeJsonAtomic(path.join(dir, name), value);
 }
 function readStateFile(dir, name) {
@@ -126,6 +171,12 @@ export {
   StateError,
   stateRoot,
   filesForDir,
+  stateKey,
+  channelsDir,
+  channelFiles,
+  writeJoinFile,
+  readJoinFile,
+  removeJoinFile,
   sessionFiles,
   resolveStateDir,
   ensureStateDir,

package/dist/{chunk-6OADQWV7.mjs → chunk-MBLP7LQJ.mjs}

@@ -2,13 +2,14 @@ import { createRequire as __khalaCreateRequire } from 'node:module'; const requi
 import {
   isWakeEntry,
   writeActivity
-} from "./chunk-DC3OX6F4.mjs";
+} from "./chunk-IR3VN2ID.mjs";
 import "./chunk-P5CP32X2.mjs";
 import {
   advanceCursor,
+  listChannels,
   readListeningMode,
   unread
-} from "./chunk-N5VYKQMR.mjs";
+} from "./chunk-T7YRVE43.mjs";
 import {
   CURSOR_DEFAULT_SESSION,
   cursorSessionId
@@ -17,10 +18,10 @@ import {
   StateError,
   readStatus,
   sessionFiles
-} from "./chunk-XEYKJMZL.mjs";
+} from "./chunk-KCJFSVDN.mjs";
 import "./chunk-AUJEUKVM.mjs";
 import "./chunk-SN3STAO2.mjs";
-import "./chunk-ZKDDKUUA.mjs";
+import "./chunk-PXKGKVGW.mjs";
 
 // hooks/deliver.ts
 import * as fs from "node:fs/promises";
@@ -46,7 +47,7 @@ ${INTRO}${youLine}
 ${entries.map(renderLine).join("\n")}
 </khala-channel-messages>`;
 }
-function selectFrame(channelName, entries, you) {
+function selectFrame(channelName, entries, you, budget = MAX_FRAME_BYTES, truncate = true) {
   const rendered = [];
   let consumedCount = 0;
   let channel = channelName;
@@ -54,18 +55,18 @@ function selectFrame(channelName, entries, you) {
     const entry = entries[i];
     if (rendered.length === 50) break;
     channel ??= entry.roomId;
-    if (Buffer.byteLength(renderFrame(channel, [...rendered, entry], you)) > MAX_FRAME_BYTES) {
-      if (rendered.length) break;
+    if (Buffer.byteLength(renderFrame(channel, [...rendered, entry], you)) > budget) {
+      if (rendered.length || !truncate) break;
       const body = Array.from(entry.body);
       let low = 0, high = body.length;
       while (low < high) {
         const middle = Math.ceil((low + high) / 2);
         const candidate = { ...entry, body: body.slice(0, middle).join("") + TRUNCATED };
-        if (Buffer.byteLength(renderFrame(channel, [candidate], you)) <= MAX_FRAME_BYTES) low = middle;
+        if (Buffer.byteLength(renderFrame(channel, [candidate], you)) <= budget) low = middle;
         else high = middle - 1;
       }
       const truncated = { ...entry, body: body.slice(0, low).join("") + TRUNCATED };
-      if (Buffer.byteLength(renderFrame(channel, [truncated], you)) > MAX_FRAME_BYTES) throw new Error("frame_metadata_too_large");
+      if (Buffer.byteLength(renderFrame(channel, [truncated], you)) > budget) throw new Error("frame_metadata_too_large");
       rendered.push(truncated);
       consumedCount = i + 1;
       break;
@@ -78,6 +79,82 @@ function selectFrame(channelName, entries, you) {
     consumed: entries.slice(0, consumedCount)
   };
 }
+function selectFrames(groups, budget = MAX_FRAME_BYTES) {
+  const ordered = [...groups].filter((group) => group.entries.length).sort((a, b) => Date.parse(a.entries[0].ts) - Date.parse(b.entries[0].ts));
+  const selected = [];
+  let used = 0;
+  for (const group of ordered) {
+    const result = selectFrame(
+      group.channel.channelName ?? group.channel.roomId,
+      group.entries,
+      group.you,
+      budget - used - (selected.length ? 1 : 0),
+      selected.length === 0
+    );
+    if (!result.frame) continue;
+    const bytes = Buffer.byteLength(result.frame) + (selected.length ? 1 : 0);
+    if (used + bytes > budget) continue;
+    selected.push({ ...group, ...result });
+    used += bytes;
+  }
+  return selected;
+}
+async function channelFrames(files, tool, requireWake, io) {
+  const groups = [];
+  for (const channel of await listChannels(files)) {
+    const mode = await readListeningMode(channel.files);
+    if (mode === "async" || tool && mode !== "steer") continue;
+    const [status, pending] = await Promise.all([readStatus(channel.files), unread(channel.files)]);
+    groups.push({
+      channel: { ...channel, ...status?.channelName !== void 0 ? { channelName: status.channelName } : {} },
+      ...pending,
+      you: typeof status?.displayName === "string" ? status.displayName : void 0
+    });
+  }
+  const selected = selectFrames(groups);
+  const emitted = /* @__PURE__ */ new Map();
+  const reserved = selected.reduce((sum, group) => sum + Buffer.byteLength(group.frame), 0) + Math.max(0, selected.length - 1);
+  let spare = MAX_FRAME_BYTES - reserved;
+  const order = selected.map((group, index) => ({ group, index }));
+  if (requireWake) order.sort((a, b) => Number(b.group.consumed.some(isWakeEntry)) - Number(a.group.consumed.some(isWakeEntry)));
+  let hasWake = false;
+  const failures = [];
+  for (const { group, index } of order) {
+    if (requireWake && !hasWake && !group.consumed.some(isWakeEntry)) continue;
+    try {
+      let current = group;
+      for (let attempt = 0; attempt < 2; attempt++) {
+        if (!current.frame || requireWake && !hasWake && !current.consumed.some(isWakeEntry)) break;
+        if (await advanceCursor(current.channel.files, current.cursor, current.consumed) === "conflict") {
+          if (attempt === 0) {
+            const pending = await unread(current.channel.files);
+            const retry = selectFrame(
+              current.channel.channelName ?? current.channel.roomId,
+              pending.entries,
+              current.you,
+              Buffer.byteLength(group.frame) + spare,
+              index === 0
+            );
+            current = { ...current, ...pending, ...retry };
+          }
+          continue;
+        }
+        spare += Buffer.byteLength(group.frame) - Buffer.byteLength(current.frame);
+        emitted.set(index, current.frame);
+        hasWake ||= current.consumed.some(isWakeEntry);
+        break;
+      }
+    } catch (error) {
+      failures.push(error);
+    }
+  }
+  if (failures.length) {
+    if (!emitted.size) throw failures[0];
+    const error = failures[0];
+    diagnostic(io, error instanceof StateError ? error.code : "internal_error");
+  }
+  return emitted.size ? [...emitted].sort(([a], [b]) => a - b).map(([, frame]) => frame).join("\n") : null;
+}
 function diagnostic(io, code) {
   try {
     io.stderr.write(JSON.stringify({ ok: false, warning: "khala_hook_suppressed", code }) + "\n");
@@ -114,24 +191,13 @@ async function deliver(stdin, argv, io = {
     return 0;
   }
   try {
-    const mode = await readListeningMode(files);
-    if (input.hook_event_name === "PostToolUse" && mode !== "steer") return 0;
     if (input.hook_event_name === "UserPromptSubmit") await writeActivity(files, "busy", io.now);
     if (input.hook_event_name === "Stop" && input.stop_hook_active === true) {
       await writeActivity(files, "idle", io.now);
       return 0;
     }
-    if (mode === "async") {
-      if (input.hook_event_name === "Stop") await writeActivity(files, "idle", io.now);
-      return 0;
-    }
-    const status = await readStatus(files);
-    for (let attempt = 0; attempt < 2; attempt++) {
-      const { entries, cursor } = await unread(files);
-      const { frame, consumed } = selectFrame(status?.channelName, entries, typeof status?.displayName === "string" ? status.displayName : void 0);
-      if (!frame) break;
-      if (input.hook_event_name !== "UserPromptSubmit" && !consumed.some(isWakeEntry)) break;
-      if (await advanceCursor(files, cursor, consumed) === "conflict") continue;
+    const frame = await channelFrames(files, input.hook_event_name === "PostToolUse", input.hook_event_name !== "UserPromptSubmit", io);
+    if (frame) {
       await writeActivity(files, "busy", io.now);
       const envelope = input.hook_event_name === "Stop" ? { decision: "block", reason: frame } : { hookSpecificOutput: { hookEventName: input.hook_event_name, additionalContext: frame } };
       io.stdout.write(JSON.stringify(envelope) + "\n");
@@ -180,22 +246,16 @@ async function deliverCursor(stdin, io) {
   return 0;
 }
 async function cursorOutput(files, event, loopCount, io) {
-  const mode = await readListeningMode(files);
   if (event === "beforeSubmitPrompt") {
     await writeActivity(files, "busy", io.now);
     return null;
   }
-  if (event === "postToolUse" && mode !== "steer") return null;
-  if (event === "stop" && (mode === "async" || typeof loopCount === "number" && loopCount > 0)) {
+  if (event === "stop" && typeof loopCount === "number" && loopCount > 0) {
     await writeActivity(files, "idle", io.now);
     return null;
   }
-  const status = await readStatus(files);
-  for (let attempt = 0; attempt < 2; attempt++) {
-    const { entries, cursor } = await unread(files);
-    const { frame, consumed } = selectFrame(status?.channelName, entries, typeof status?.displayName === "string" ? status.displayName : void 0);
-    if (!frame || !consumed.some(isWakeEntry)) break;
-    if (await advanceCursor(files, cursor, consumed) === "conflict") continue;
+  const frame = await channelFrames(files, event === "postToolUse", true, io);
+  if (frame) {
     await writeActivity(files, "busy", io.now);
     return event === "stop" ? { followup_message: frame } : { additional_context: frame };
   }
@@ -207,5 +267,6 @@ export {
   deliver,
   deliverCursor,
   renderFrame,
-  renderLine
+  renderLine,
+  selectFrames
 };

package/dist/{chunk-ZRFXZK72.mjs → chunk-OLZ62X7S.mjs}

@@ -1,7 +1,7 @@
 import { createRequire as __khalaCreateRequire } from 'node:module'; const require = __khalaCreateRequire(import.meta.url);
 import {
   define_KHALA_BUNDLE_default
-} from "./chunk-ZKDDKUUA.mjs";
+} from "./chunk-PXKGKVGW.mjs";
 
 // src/bundle.ts
 var bundle = typeof define_KHALA_BUNDLE_default === "undefined" ? void 0 : define_KHALA_BUNDLE_default;

package/dist/{chunk-ZKDDKUUA.mjs → chunk-PXKGKVGW.mjs}

@@ -1,7 +1,7 @@
 import { createRequire as __khalaCreateRequire } from 'node:module'; const require = __khalaCreateRequire(import.meta.url);
 
 // <define:__KHALA_BUNDLE__>
-var define_KHALA_BUNDLE_default = { name: "khala-cli", version: "0.4.4" };
+var define_KHALA_BUNDLE_default = { name: "khala-cli", version: "0.4.5" };
 
 export {
   define_KHALA_BUNDLE_default

package/dist/{chunk-AK74S7EN.mjs → chunk-RSDOTTZQ.mjs}

@@ -1,11 +1,11 @@
 import { createRequire as __khalaCreateRequire } from 'node:module'; const require = __khalaCreateRequire(import.meta.url);
 import {
   bundle
-} from "./chunk-ZRFXZK72.mjs";
+} from "./chunk-OLZ62X7S.mjs";
 import {
   CURSOR_WORKSPACE_ENV
 } from "./chunk-VUE2DDYY.mjs";
-import "./chunk-ZKDDKUUA.mjs";
+import "./chunk-PXKGKVGW.mjs";
 
 // src/install/main.ts
 import { spawnSync } from "node:child_process";

package/dist/{chunk-7CVU5OZ7.mjs → chunk-SQXDATEC.mjs}

@@ -1,7 +1,7 @@
 import { createRequire as __khalaCreateRequire } from 'node:module'; const require = __khalaCreateRequire(import.meta.url);
 import {
   bundle
-} from "./chunk-ZRFXZK72.mjs";
+} from "./chunk-OLZ62X7S.mjs";
 
 // src/version.ts
 var KHALA_AGENT_VERSION = bundle?.version ?? "0.0.0";

package/dist/chunk-T7YRVE43.mjs

@@ -0,0 +1,238 @@
+import { createRequire as __khalaCreateRequire } from 'node:module'; const require = __khalaCreateRequire(import.meta.url);
+import {
+  StateError,
+  channelFiles,
+  channelsDir,
+  ensureStateDir,
+  filesForDir,
+  readJson,
+  readStatus,
+  removeStateFile,
+  stateKey,
+  writeJsonAtomic,
+  writeStateFile
+} from "./chunk-KCJFSVDN.mjs";
+import {
+  DEFAULT_LISTENING_MODE,
+  decodeListeningMode
+} from "./chunk-AUJEUKVM.mjs";
+
+// src/inbox.ts
+import * as fs from "node:fs/promises";
+async function readEntries(files) {
+  let content;
+  try {
+    content = await fs.readFile(files.inbox, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return [];
+    throw new StateError("storage_failed");
+  }
+  const entries = [];
+  for (const line of content.split("\n").slice(0, -1)) {
+    try {
+      const entry = JSON.parse(line);
+      if (entry && ["eventId", "roomId", "ts", "sender", "senderLabel", "body"].every((key) => typeof entry[key] === "string") && ["human", "agent", "unknown"].includes(entry.senderKind) && ["message", "event"].includes(entry.kind)) entries.push(entry);
+    } catch {
+    }
+  }
+  return entries;
+}
+async function appendEntries(files, entries) {
+  const seen = new Set((await readEntries(files)).map((entry) => entry.eventId));
+  const fresh = entries.filter((entry) => {
+    if (seen.has(entry.eventId)) return false;
+    seen.add(entry.eventId);
+    return true;
+  });
+  if (fresh.length) {
+    try {
+      await fs.appendFile(files.inbox, fresh.map((entry) => JSON.stringify(entry) + "\n").join(""), { mode: 384, flag: "a" });
+    } catch {
+      throw new StateError("storage_failed");
+    }
+  }
+  return fresh;
+}
+async function readCursor(files) {
+  const cursor = await readJson(files.cursor);
+  return cursor && (cursor.lastDeliveredEventId === null || typeof cursor.lastDeliveredEventId === "string") && Number.isSafeInteger(cursor.deliveredCount) && cursor.deliveredCount >= 0 ? cursor : { lastDeliveredEventId: null, deliveredCount: 0 };
+}
+async function unread(files) {
+  const cursor = await readCursor(files);
+  const entries = await readEntries(files);
+  return { entries: entries.slice(cursor.deliveredCount), cursor };
+}
+async function unreadCounts(files) {
+  const { entries } = await unread(files);
+  return { total: entries.length, messages: entries.filter((entry) => entry.kind === "message").length };
+}
+async function advanceCursor(files, expected, delivered) {
+  const current = await readCursor(files);
+  if (current.deliveredCount !== expected.deliveredCount || current.lastDeliveredEventId !== expected.lastDeliveredEventId) return "conflict";
+  if (!delivered.length) return expected;
+  const entries = await readEntries(files);
+  const slice = entries.slice(expected.deliveredCount, expected.deliveredCount + delivered.length);
+  if (slice.length !== delivered.length || slice.some((entry, index) => entry.eventId !== delivered[index]?.eventId)) return "conflict";
+  const next = { lastDeliveredEventId: delivered[delivered.length - 1].eventId, deliveredCount: expected.deliveredCount + delivered.length };
+  await writeJsonAtomic(files.cursor, next);
+  return next;
+}
+async function appendInbox(dir, entry) {
+  return (await appendEntries(filesForDir(dir), [entry])).length === 1;
+}
+function unreadCount(dir) {
+  return unreadCounts(filesForDir(dir));
+}
+
+// src/channels.ts
+import * as fs2 from "node:fs/promises";
+import path from "node:path";
+function channelKey(roomId2) {
+  return stateKey(roomId2);
+}
+async function exists(file) {
+  try {
+    await fs2.lstat(file);
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") return false;
+    throw new StateError("storage_failed");
+  }
+}
+function roomId(value) {
+  if (value && typeof value === "object" && "roomId" in value && typeof value.roomId === "string" && value.roomId.length) return value.roomId;
+  return void 0;
+}
+async function legacyRoomId(files) {
+  const saved = roomId(await readJson(files.session));
+  if (saved) return saved;
+  let content;
+  try {
+    content = await fs2.readFile(files.inbox, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return void 0;
+    throw new StateError("storage_failed");
+  }
+  try {
+    return roomId(JSON.parse(content.split("\n")[0]));
+  } catch {
+    return void 0;
+  }
+}
+async function listChannels(files) {
+  await ensureStateDir(files.dir);
+  const channels = [];
+  const dir = channelsDir(files);
+  if (await exists(dir)) {
+    await ensureStateDir(dir);
+    for (const key of await fs2.readdir(dir)) {
+      if (!/^[a-f0-9]{24}$/.test(key)) continue;
+      const nested = filesForDir(path.join(dir, key));
+      await ensureStateDir(nested.dir);
+      const metadata = await readJson(path.join(nested.dir, "channel.json"));
+      const id = roomId(metadata);
+      if (!id || channelKey(id) !== key) continue;
+      channels.push({ key, roomId: id, ...typeof metadata?.channelName === "string" ? { channelName: metadata.channelName } : {}, files: nested, legacy: false });
+    }
+  }
+  if (await exists(files.inbox)) {
+    const id = await legacyRoomId(files);
+    if (id) {
+      const status = await readStatus(files);
+      channels.push({ key: channelKey(id), roomId: id, ...typeof status?.channelName === "string" ? { channelName: status.channelName } : {}, files, legacy: true });
+    }
+  }
+  return channels.sort((a, b) => (a.channelName ?? "").localeCompare(b.channelName ?? "") || a.roomId.localeCompare(b.roomId));
+}
+async function migrateLegacy(files) {
+  await ensureStateDir(files.dir);
+  const names = ["cursor.json", "mode.json", "inbox.jsonl"];
+  const present = await Promise.all(names.map((name) => exists(path.join(files.dir, name))));
+  if (!present.some(Boolean)) return "none";
+  const id = await legacyRoomId(files);
+  if (!id) {
+    for (const name of names) await removeStateFile(files.dir, name);
+    return "discarded";
+  }
+  const nested = channelFiles(files, id);
+  await ensureStateDir(nested.dir);
+  const destinationInbox = await exists(nested.inbox);
+  if (present[2] && !destinationInbox && present[0] && await exists(nested.cursor)) {
+    if (await fs2.readFile(files.cursor, "utf8") !== await fs2.readFile(nested.cursor, "utf8")) {
+      throw new StateError("storage_failed");
+    }
+  }
+  const status = await readStatus(files);
+  const metadata = await readJson(path.join(nested.dir, "channel.json"));
+  if (!metadata || roomId(metadata) !== id) {
+    await writeStateFile(nested.dir, "channel.json", {
+      roomId: id,
+      ...typeof status?.channelName === "string" ? { channelName: status.channelName } : {},
+      joinedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  if (destinationInbox) {
+    if (present[2]) await appendEntries(nested, (await unread(files)).entries);
+    for (const name of ["inbox.jsonl", "cursor.json", "mode.json"]) await removeStateFile(files.dir, name);
+    return "moved";
+  }
+  for (const name of names) {
+    if (await exists(path.join(nested.dir, name))) {
+      await removeStateFile(files.dir, name);
+      continue;
+    }
+    try {
+      await fs2.rename(path.join(files.dir, name), path.join(nested.dir, name));
+    } catch (error) {
+      if (error.code !== "ENOENT") throw new StateError("storage_failed");
+    }
+  }
+  return "moved";
+}
+function resolveChannel(list, ref) {
+  const channels = list.map((item) => ({ channel: item.channelName ?? item.roomId, roomId: item.roomId }));
+  if (ref === void 0) {
+    if (list.length === 1) return { ok: true, channel: list[0] };
+    return { ok: false, code: list.length ? "channel_required" : "channel_unknown", channels };
+  }
+  const exact = list.find((item) => item.roomId === ref);
+  if (exact) return { ok: true, channel: exact };
+  const normalized = ref.replace(/^#/, "").toLowerCase();
+  const matches = list.filter((item) => item.channelName?.replace(/^#/, "").toLowerCase() === normalized);
+  if (matches.length === 1) return { ok: true, channel: matches[0] };
+  return { ok: false, code: matches.length ? "channel_ambiguous" : "channel_unknown", channels };
+}
+
+// src/mode.ts
+async function readListeningMode(files) {
+  const content = await readJson(files.mode);
+  const decoded = decodeListeningMode(typeof content === "object" && content !== null ? content.mode : void 0);
+  return decoded.ok ? decoded.value : DEFAULT_LISTENING_MODE;
+}
+async function applyListeningMode(files, next, meta, now = () => /* @__PURE__ */ new Date()) {
+  const previous = await readListeningMode(files);
+  if (previous === "async" && next !== "async") {
+    for (let attempt = 0; attempt < 2; attempt++) {
+      const { cursor, entries } = await unread(files);
+      if (await advanceCursor(files, cursor, entries) !== "conflict") break;
+      if (attempt === 1) throw new StateError("storage_failed");
+    }
+  }
+  await writeJsonAtomic(files.mode, { mode: next, ...meta, updatedAt: now().toISOString() });
+  return { previous, next };
+}
+
+export {
+  readEntries,
+  readCursor,
+  unread,
+  advanceCursor,
+  appendInbox,
+  unreadCount,
+  channelKey,
+  listChannels,
+  migrateLegacy,
+  resolveChannel,
+  readListeningMode,
+  applyListeningMode
+};