@epoch-agent/core 4.0.0 → 4.1.0

package/dist/index.js

@@ -4,7 +4,7 @@ import { existsSync, mkdirSync, rmSync, writeFileSync, statSync, readdirSync, re
 import { platform, tmpdir, homedir, hostname } from 'os';
 import { join, resolve, dirname, relative, isAbsolute, extname, sep, basename, delimiter } from 'path';
 import { execFile, spawn, execSync, execFileSync } from 'child_process';
-import { createLogger, t, dbPath, resolveHomeDir, DEFAULT_MAX_TURNS, PROJECT_DIR_NAME, guardSpawn, detectBackend, EXEC_PATH_AS_NODE_ENV, isolate, createStreamDecoder, registerJob, JOB_OUTPUT_LIMIT, artifactsDir, suggestKey, misspelledKeyIssues, openDatabase, migrate, releaseDatabase, parseLenient, issueDetails, splitWords, unknownKeyIssues, checkpointsDir, expandPath, pluginsDir, projectHooksPath, projectClaudeSettingsPath, projectClaudeLocalSettingsPath, projectSettingsPath, projectLocalSettingsPath, projectPoliciesDir, trustedImportsPath, canProbeGit, budgetStatePath, isInWorkspace, UNLIMITED_TURNS, turnLimitOf, configPath, managedSettingsPath, listStoredSecretNames, maskApiKey, unsetSectionField, setSectionField, countCodePoints, headCodePoints, attachmentsDir, workspacesPath, samePath, lastSessionsPath, appearancePath, automationLogsDir, projectComplianceDir, projectSkillsDir, trustPath, projectCommandsDir, parseShellCommand, writeArtifact, sandboxModeForLevel, planEscalation, getSecretValues, envPath, checkDangerousCommand, checkObfuscation, shellSpawnArgs, confine, classifyFailure, keepHeadAndTail, SANDBOX_PERMISSIONS_PARAM, JUSTIFICATION_PARAM, widerTargets, normalizeForMatch, isReadOnlyCommand, CODE_EXEC_ROOTS, tailCodePoints } from '@epoch-agent/infra';
+import { createLogger, t, dbPath, resolveHomeDir, DEFAULT_MAX_TURNS, PROJECT_DIR_NAME, guardSpawn, detectBackend, EXEC_PATH_AS_NODE_ENV, isolate, createStreamDecoder, registerJob, JOB_OUTPUT_LIMIT, artifactsDir, openDatabase, migrate, releaseDatabase, suggestKey, misspelledKeyIssues, parseLenient, issueDetails, splitWords, unknownKeyIssues, checkpointsDir, expandPath, pluginsDir, projectHooksPath, projectClaudeSettingsPath, projectClaudeLocalSettingsPath, projectSettingsPath, projectLocalSettingsPath, projectPoliciesDir, trustedImportsPath, canProbeGit, budgetStatePath, isInWorkspace, UNLIMITED_TURNS, turnLimitOf, configPath, managedSettingsPath, listStoredSecretNames, maskApiKey, unsetSectionField, setSectionField, countCodePoints, headCodePoints, attachmentsDir, workspacesPath, samePath, lastSessionsPath, appearancePath, automationLogsDir, projectComplianceDir, projectSkillsDir, trustPath, projectCommandsDir, parseShellCommand, writeArtifact, sandboxModeForLevel, planEscalation, getSecretValues, envPath, checkDangerousCommand, checkObfuscation, shellSpawnArgs, confine, classifyFailure, keepHeadAndTail, SANDBOX_PERMISSIONS_PARAM, JUSTIFICATION_PARAM, widerTargets, normalizeForMatch, isReadOnlyCommand, CODE_EXEC_ROOTS, tailCodePoints } from '@epoch-agent/infra';
 export { IS_WINDOWS, WINDOWS_HIDE_FLAGS, buildBwrapArgs, buildProfile, checkDangerousCommand, checkObfuscation, createLogger, detectBackend, getDefaultShell, getPythonCommand, isInWorkspace, isReadOnlyCommand, isolate, maskApiKey, probeBubblewrap, probeSeatbelt, complianceDir as resolveComplianceDir, policiesDir as resolvePoliciesDir, setLogLevel } from '@epoch-agent/infra';
 import { createRequire } from 'module';
 import { randomUUID, createHash, randomBytes } from 'crypto';
@@ -820,6 +820,7 @@ var COMMAND_TOOLS = /* @__PURE__ */ new Set([
   "delegate_task",
   "spawn_teammate",
   "interrupt_agent",
+  "close_agent",
   "followup_task",
   "run_code",
   "mcp_add",
@@ -831,6 +832,7 @@ var NON_SHELL_COMMAND_TOOLS = /* @__PURE__ */ new Set([
   "delegate_task",
   "spawn_teammate",
   "interrupt_agent",
+  "close_agent",
   "followup_task"
 ]);
 var CODE_EXEC_TOOLS = /* @__PURE__ */ new Set(["code_exec", "sandbox"]);
@@ -4430,6 +4432,12 @@ var AgentInbox = class {
     }
     return [lines.join("\n")];
   }
+  drain() {
+    const out = this.queue;
+    this.queue = [];
+    this.dropped = 0;
+    return out;
+  }
   get size() {
     return this.queue.length;
   }
@@ -4518,6 +4526,7 @@ var TeamTaskBoard = class {
 var DEFAULT_MAX_RUNNING_MEMBERS = 3;
 var DEFAULT_MAX_WOKEN_SESSIONS = 3;
 var WAKE_RAMP_MS = 6e4;
+var CLOSED_TOMBSTONE_LIMIT = 200;
 var TeamRegistry = class {
   constructor(inboxCapacity = DEFAULT_INBOX_CAPACITY, limits = {}) {
     this.inboxCapacity = inboxCapacity;
@@ -4538,6 +4547,8 @@ var TeamRegistry = class {
   limits;
   bridge;
   aborters = /* @__PURE__ */ new Map();
+  closedSessions = /* @__PURE__ */ new Set();
+  closedOrder = [];
   listeners = /* @__PURE__ */ new Set();
   tasks;
   onChange(cb) {
@@ -4617,6 +4628,94 @@ var TeamRegistry = class {
   list() {
     return [...this.members.values()].map((e) => e.info).sort((a, b) => a.startedAt - b.startedAt);
   }
+  subtreeOf(rootSessionId) {
+    return this.walkSubtree(rootSessionId).map((entry) => ({ ...entry.info }));
+  }
+  treeRootOf(sessionId) {
+    const path = [sessionId];
+    const index = /* @__PURE__ */ new Map([[sessionId, 0]]);
+    let current = sessionId;
+    for (; ; ) {
+      const parent = this.bySession(current)?.parentSessionId;
+      if (!parent) return current;
+      const seenAt = index.get(parent);
+      if (seenAt !== void 0) {
+        return path.slice(seenAt).sort()[0] ?? current;
+      }
+      index.set(parent, path.length);
+      path.push(parent);
+      current = parent;
+    }
+  }
+  sameTree(a, b) {
+    return this.treeRootOf(a) === this.treeRootOf(b);
+  }
+  walkSubtree(rootSessionId) {
+    const out = [];
+    const seen = /* @__PURE__ */ new Set([rootSessionId]);
+    const walk3 = (parentSessionId) => {
+      for (const entry of this.members.values()) {
+        if (entry.info.parentSessionId !== parentSessionId) continue;
+        if (seen.has(entry.info.sessionId)) continue;
+        seen.add(entry.info.sessionId);
+        out.push(entry);
+        walk3(entry.info.sessionId);
+      }
+    };
+    walk3(rootSessionId);
+    return out;
+  }
+  close(agentId) {
+    const entry = this.members.get(agentId);
+    if (!entry) {
+      return {
+        ok: false,
+        reason: `${agentId} is not in the roster \u2014 use list_agents to see who is around`
+      };
+    }
+    const previous = entry.info.status;
+    const doomed = [entry, ...this.walkSubtree(entry.info.sessionId).filter((e) => e !== entry)];
+    const descendants = [];
+    const senders = [];
+    let dropped = 0;
+    for (const item of doomed) {
+      if (item !== entry) descendants.push(item.info.agentId);
+      for (const mail of item.inbox.drain()) {
+        dropped += 1;
+        if (!senders.includes(mail.from)) senders.push(mail.from);
+      }
+      const abort = this.aborters.get(item.info.agentId);
+      if (abort) {
+        this.aborters.delete(item.info.agentId);
+        try {
+          abort();
+        } catch {
+        }
+      }
+      this.members.delete(item.info.agentId);
+      this.bySessionId.delete(item.info.sessionId);
+      this.rememberClosed(item.info.sessionId);
+    }
+    this.notify();
+    return {
+      ok: true,
+      previous,
+      descendants,
+      ...dropped > 0 ? { dropped: { count: dropped, from: senders } } : {}
+    };
+  }
+  isClosed(sessionId) {
+    return this.closedSessions.has(sessionId);
+  }
+  rememberClosed(sessionId) {
+    if (this.closedSessions.has(sessionId)) return;
+    this.closedSessions.add(sessionId);
+    this.closedOrder.push(sessionId);
+    while (this.closedOrder.length > CLOSED_TOMBSTONE_LIMIT) {
+      const old = this.closedOrder.shift();
+      if (old !== void 0) this.closedSessions.delete(old);
+    }
+  }
   inboxOf(agentId) {
     return this.members.get(agentId)?.inbox;
   }
@@ -4684,6 +4783,9 @@ var TeamRegistry = class {
   get memberLimit() {
     return this.limits.maxRunningMembers;
   }
+  get wakeLimit() {
+    return this.limits.maxWokenSessions;
+  }
   availableMemberSlots(parentSessionId) {
     let running = 0;
     for (const entry of this.members.values()) {
@@ -4700,6 +4802,12 @@ var TeamRegistry = class {
   sessionTitle(sessionId) {
     return this.bridge?.title?.(sessionId);
   }
+  sessionWorkDir(sessionId) {
+    return this.bridge?.workDir?.(sessionId);
+  }
+  isSubagentSession(sessionId) {
+    return this.bridge?.isSubagent?.(sessionId) ?? false;
+  }
   sessionIds() {
     return [...this.sessions];
   }
@@ -4757,11 +4865,26 @@ var TeamRegistry = class {
       this.notify();
       return { ok: true, to: msg.to, status: entry.info.status };
     }
+    const namedFor = this.bySessionId.get(msg.to);
+    if (namedFor) {
+      return {
+        ok: false,
+        to: msg.to,
+        reason: `${msg.to} is the session of member ${namedFor}, not the member itself \u2014 address it by its name (${namedFor})`
+      };
+    }
     if (this.isSessionActive(msg.to)) {
       this.mainInbox(msg.to).push(msg);
       this.notify();
       return { ok: true, to: msg.to, status: "running" };
     }
+    if (this.isClosed(msg.to)) {
+      return {
+        ok: false,
+        to: msg.to,
+        reason: `${msg.to} was closed with close_agent \u2014 it has no next turn, and it cannot be woken again. The message was not delivered. If that work still matters, dispatch a new member with spawn_teammate`
+      };
+    }
     if (this.sessionExists(msg.to)) {
       const senderIsMember = this.members.has(msg.from);
       return {
@@ -4798,6 +4921,7 @@ function createSendMessageTool(team) {
       `To \`${LEAD_AGENT_ID}\` (the session that dispatched you): if it is running it sees it on the following steps; if it is not, the message just queues in its inbox until it next runs (so you will not get a reply now).`,
       "To **another main session** (the sessionId you saw with list_agents --all): delivered only if it is running **at this moment**.",
       "If the recipient is not running (asleep / already finished) this fails immediately (except for lead, which queues) \u2014 in that case use followup_task to wake it for a run rather than waiting.",
+      "Only members **on your own side of the roster** can be reached \u2014 the ones this session dispatched (when you are a member yourself: your teammates). Another session\u2019s member is refused even if you know its name. Another main session is not covered by that rule \u2014 see above.",
       "Use list_agents to see this session's members; add --all to see every session and member."
     ].join("\n"),
     parameters: {
@@ -4850,7 +4974,19 @@ function createSendMessageTool(team) {
       }
       const memberInfo = team.bySession(ctx.sessionId);
       const target = team.get(to);
-      const ownMember = target !== void 0 && target.parentSessionId === ctx.sessionId;
+      if (target && !team.sameTree(ctx.sessionId, target.sessionId)) {
+        return {
+          success: false,
+          output: "",
+          error: {
+            code: 7104,
+            message: `${to} was dispatched by another session, so this session cannot message it`,
+            suggestion: "The roster is shared across sessions, the right to reach into a member is not. list_agents shows the members this session dispatched; to reach that work, message the session that dispatched it, or write it into your own conclusion"
+          },
+          duration: Date.now() - start
+        };
+      }
+      const ownMember = target !== void 0;
       const from = memberInfo ? memberInfo.agentId : ownMember ? LEAD_AGENT_ID : ctx.sessionId;
       const labelled = from === ctx.sessionId ? sessionSenderLabel(from, team.sessionTitle(from)) : "";
       const result = team.deliver(
@@ -4885,11 +5021,454 @@ function createSendMessageTool(team) {
     }
   };
 }
+var MAX_POST_CHARS = 2e4;
+var CHANNEL_PATTERN = /^[A-Za-z0-9_.-]{1,64}$/;
+var MAX_CHANNEL_DESCRIPTION_BYTES = 512;
+var MAX_PAGE_LIMIT = 200;
+var MIGRATIONS = [
+  {
+    id: "board-initial",
+    version: 1,
+    description: "Discussion board: channels / threads / posts / subscriptions",
+    up: (db) => {
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS board_channels (
+          id          TEXT PRIMARY KEY,
+          name        TEXT NOT NULL UNIQUE,
+          description TEXT,
+          created_by  TEXT NOT NULL,
+          created_at  INTEGER NOT NULL
+        );
+        CREATE TABLE IF NOT EXISTS board_threads (
+          id           TEXT PRIMARY KEY,
+          channel      TEXT NOT NULL,
+          title        TEXT NOT NULL,
+          created_by   TEXT NOT NULL,
+          created_at   INTEGER NOT NULL,
+          last_post_at INTEGER NOT NULL
+        );
+        CREATE INDEX IF NOT EXISTS board_threads_channel ON board_threads(channel, last_post_at DESC);
+        CREATE TABLE IF NOT EXISTS board_posts (
+          seq        INTEGER PRIMARY KEY AUTOINCREMENT,
+          id         TEXT NOT NULL UNIQUE,
+          thread_id  TEXT NOT NULL,
+          author     TEXT NOT NULL,
+          text       TEXT NOT NULL,
+          created_at INTEGER NOT NULL
+        );
+        CREATE INDEX IF NOT EXISTS board_posts_thread ON board_posts(thread_id, seq);
+        CREATE TABLE IF NOT EXISTS board_subscriptions (
+          agent         TEXT NOT NULL,
+          target        TEXT NOT NULL,
+          last_seen_seq INTEGER NOT NULL DEFAULT 0,
+          PRIMARY KEY (agent, target)
+        );
+      `);
+    }
+  },
+  {
+    id: "board-notices-and-request-id",
+    version: 2,
+    description: "One-time notifications (agents_to_notify) and idempotent posts",
+    up: (db) => {
+      db.exec(`
+        ALTER TABLE board_posts ADD COLUMN request_id TEXT;
+        CREATE UNIQUE INDEX IF NOT EXISTS board_posts_request
+          ON board_posts(author, request_id) WHERE request_id IS NOT NULL;
+        CREATE TABLE IF NOT EXISTS board_notices (
+          agent      TEXT NOT NULL,
+          target     TEXT NOT NULL,
+          seq        INTEGER NOT NULL,
+          created_at INTEGER NOT NULL,
+          PRIMARY KEY (agent, target, seq)
+        );
+      `);
+    }
+  }
+];
+function targetKey(t83) {
+  return t83.kind === "channel" ? `channel:${t83.name}` : `thread:${t83.id}`;
+}
+function encodeCursor(kind, payload) {
+  return `v1:${kind}:${payload}`;
+}
+function decodeCursor(cursor, kind) {
+  if (!cursor) return void 0;
+  const parts = cursor.split(":");
+  if (parts.length < 3 || parts[0] !== "v1" || parts[1] !== kind) return void 0;
+  return parts.slice(2).join(":");
+}
+function decodeSeqCursor(cursor, kind) {
+  const raw = decodeCursor(cursor, kind);
+  if (raw === void 0) return 0;
+  const n = Number.parseInt(raw, 10);
+  return Number.isFinite(n) ? n : 0;
+}
+function charLength(s) {
+  return [...s].length;
+}
+function sliceChars(s, offset, limit) {
+  return [...s].slice(offset, offset + limit).join("");
+}
+function previewPostText(post, maxChars) {
+  const nChars = charLength(post.text);
+  const limit = Math.min(Math.max(Math.floor(maxChars), 1), MAX_POST_CHARS);
+  if (nChars <= limit) return { text: post.text, truncated: false, nChars };
+  return { text: sliceChars(post.text, 0, limit), truncated: true, nChars };
+}
+var BoardStore = class {
+  path;
+  db;
+  constructor(homeDir) {
+    this.path = dbPath(homeDir);
+    this.db = openDatabase(this.path);
+    migrate(this.db, "board", MIGRATIONS);
+  }
+  close() {
+    releaseDatabase(this.path);
+  }
+  createChannel(args) {
+    if (!CHANNEL_PATTERN.test(args.name)) {
+      throw new Error(
+        `Invalid channel name: ${args.name} (letters, digits, _ . - only, at most 64 characters)`
+      );
+    }
+    if (args.description !== void 0) assertDescription(args.description);
+    const existing = this.channel(args.name);
+    if (existing) return existing;
+    const row = {
+      id: `ch-${randomUUID().slice(0, 8)}`,
+      name: args.name,
+      ...args.description ? { description: args.description } : {},
+      createdBy: args.by,
+      createdAt: Date.now()
+    };
+    this.db.prepare(
+      `INSERT INTO board_channels (id, name, description, created_by, created_at)
+         VALUES (?, ?, ?, ?, ?)`
+    ).run(row.id, row.name, row.description ?? null, row.createdBy, row.createdAt);
+    return row;
+  }
+  upsertChannel(args) {
+    assertDescription(args.description);
+    const existing = this.channel(args.name);
+    if (!existing) return this.createChannel(args);
+    this.db.prepare(`UPDATE board_channels SET description = ? WHERE name = ?`).run(args.description, args.name);
+    return { ...existing, description: args.description };
+  }
+  channel(name) {
+    const row = this.db.prepare(
+      `SELECT id, name, description, created_by, created_at FROM board_channels WHERE name = ?`
+    ).get(name);
+    return row ? toChannel(row) : void 0;
+  }
+  listChannels(opts = {}) {
+    const limit = pageLimit(opts.limit, 100);
+    const after = decodeCursor(opts.cursor, "ch");
+    const rows = this.db.prepare(
+      `SELECT id, name, description, created_by, created_at FROM board_channels
+         WHERE (? IS NULL OR LOWER(name) LIKE LOWER(?))
+           AND (? IS NULL OR name > ?)
+         ORDER BY name ASC LIMIT ?`
+    ).all(
+      opts.query ?? null,
+      opts.query ? `%${opts.query}%` : null,
+      after ?? null,
+      after ?? null,
+      limit + 1
+    );
+    return toPage(rows.map(toChannel), limit, (c) => encodeCursor("ch", c.name));
+  }
+  listThreads(channel, opts = {}) {
+    const limit = pageLimit(opts.limit, 20);
+    const after = decodeCursor(opts.cursor, "thr");
+    const cur = after ? splitThreadCursor(after) : void 0;
+    const atTs = cur?.[0] ?? null;
+    const atId = cur?.[1] ?? null;
+    const rows = this.db.prepare(
+      `SELECT t.id, t.channel, t.title, t.created_by, t.created_at, t.last_post_at,
+                (SELECT COUNT(*) FROM board_posts p WHERE p.thread_id = t.id) AS posts
+         FROM board_threads t
+         WHERE t.channel = ?
+           AND (? IS NULL OR t.last_post_at < ? OR (t.last_post_at = ? AND t.id < ?))
+         ORDER BY t.last_post_at DESC, t.id DESC LIMIT ?`
+    ).all(channel, atTs, atTs, atTs, atId, limit + 1);
+    return toPage(rows.map(toThread), limit, (t83) => encodeCursor("thr", `${t83.lastPostAt}:${t83.id}`));
+  }
+  post(args) {
+    return this.write({ ...args, notify: true, oneShot: args.notify });
+  }
+  append(args) {
+    return this.write({ ...args, notify: false });
+  }
+  write(args) {
+    const text = clip(args.text);
+    const now = Date.now();
+    if (args.requestId) {
+      const existing = this.byRequestId(args.author, args.requestId);
+      if (existing) return { ...existing, duplicate: true };
+    }
+    const run = this.db.transaction(() => {
+      let threadId;
+      if (args.target.kind === "thread") {
+        const exists2 = this.db.prepare(`SELECT id FROM board_threads WHERE id = ?`).get(args.target.id);
+        if (!exists2) throw new Error(`No such thread: ${args.target.id}`);
+        threadId = args.target.id;
+      } else {
+        let ch = this.channel(args.target.name);
+        if (!ch && args.createChannel) {
+          ch = this.createChannel({ name: args.target.name, by: args.author });
+        }
+        if (!ch) throw new Error(`No such channel: ${args.target.name}`);
+        threadId = `th-${randomUUID().slice(0, 8)}`;
+        this.db.prepare(
+          `INSERT INTO board_threads (id, channel, title, created_by, created_at, last_post_at)
+             VALUES (?, ?, ?, ?, ?, ?)`
+        ).run(threadId, ch.name, firstLine(text), args.author, now, now);
+      }
+      const id = `po-${randomUUID().slice(0, 8)}`;
+      const info = this.db.prepare(
+        `INSERT INTO board_posts (id, thread_id, author, text, created_at, request_id)
+           VALUES (?, ?, ?, ?, ?, ?)`
+      ).run(id, threadId, args.author, text, now, args.requestId ?? null);
+      const seq = Number(info.lastInsertRowid);
+      this.db.prepare(`UPDATE board_threads SET last_post_at = ? WHERE id = ?`).run(now, threadId);
+      if (args.notify) {
+        this.subscribe(args.author, { kind: "thread", id: threadId }, seq);
+      }
+      const target = `thread:${threadId}`;
+      for (const who of new Set(args.oneShot ?? [])) {
+        if (!who || who === args.author) continue;
+        this.db.prepare(
+          `INSERT OR IGNORE INTO board_notices (agent, target, seq, created_at)
+             VALUES (?, ?, ?, ?)`
+        ).run(who, target, seq, now);
+      }
+      return {
+        post: { id, threadId, author: args.author, text, createdAt: now, seq },
+        threadId,
+        duplicate: false
+      };
+    });
+    return run();
+  }
+  byRequestId(author, requestId) {
+    const row = this.db.prepare(
+      `SELECT seq, id, thread_id, author, text, created_at FROM board_posts
+         WHERE author = ? AND request_id = ?`
+    ).get(author, requestId);
+    if (!row) return void 0;
+    return { post: toPost(row), threadId: row.thread_id };
+  }
+  readThread(threadId, opts = {}) {
+    const limit = pageLimit(opts.limit, 50);
+    const afterSeq = decodeSeqCursor(opts.cursor, "rd");
+    const rows = this.db.prepare(
+      `SELECT seq, id, thread_id, author, text, created_at FROM board_posts
+         WHERE thread_id = ? AND seq > ?
+         ORDER BY seq ASC LIMIT ?`
+    ).all(threadId, afterSeq, limit + 1);
+    return toPage(rows.map(toPost), limit, (p) => encodeCursor("rd", String(p.seq)));
+  }
+  readPost(id, opts = {}) {
+    const row = this.db.prepare(`SELECT seq, id, thread_id, author, text, created_at FROM board_posts WHERE id = ?`).get(id);
+    if (!row) return void 0;
+    return slicePost(toPost(row), opts.offsetChars, opts.limitChars);
+  }
+  searchPosts(opts = {}) {
+    const limit = pageLimit(opts.limit, 20);
+    const upper = decodeCursor(opts.cursor, "sea");
+    const cursorSeq = upper === void 0 ? void 0 : Number.parseInt(upper, 10);
+    const border = Number.isFinite(cursorSeq) ? cursorSeq : null;
+    const sinceSeq = opts.afterMessageId ? this.seqOf(opts.afterMessageId) ?? null : null;
+    const rows = opts.channel ? this.db.prepare(
+      `SELECT p.seq, p.id, p.thread_id, p.author, p.text, p.created_at
+               FROM board_posts p JOIN board_threads t ON t.id = p.thread_id
+               WHERE t.channel = ?
+                 AND (? IS NULL OR p.text LIKE ?)
+                 AND (? IS NULL OR p.author = ?)
+                 AND (? IS NULL OR p.seq < ?)
+                 AND (? IS NULL OR p.seq > ?)
+               ORDER BY p.seq DESC LIMIT ?`
+    ).all(
+      opts.channel,
+      opts.query ?? null,
+      opts.query ? `%${opts.query}%` : null,
+      opts.author ?? null,
+      opts.author ?? null,
+      border,
+      border,
+      sinceSeq,
+      sinceSeq,
+      limit + 1
+    ) : this.db.prepare(
+      `SELECT seq, id, thread_id, author, text, created_at FROM board_posts
+               WHERE (? IS NULL OR text LIKE ?)
+                 AND (? IS NULL OR author = ?)
+                 AND (? IS NULL OR seq < ?)
+                 AND (? IS NULL OR seq > ?)
+               ORDER BY seq DESC LIMIT ?`
+    ).all(
+      opts.query ?? null,
+      opts.query ? `%${opts.query}%` : null,
+      opts.author ?? null,
+      opts.author ?? null,
+      border,
+      border,
+      sinceSeq,
+      sinceSeq,
+      limit + 1
+    );
+    return toPage(rows.map(toPost), limit, (p) => encodeCursor("sea", String(p.seq)));
+  }
+  seqOf(postId) {
+    const row = this.db.prepare(`SELECT seq FROM board_posts WHERE id = ?`).get(postId);
+    return row?.seq;
+  }
+  subscribe(agent, target, seenSeq) {
+    const key = targetKey(target);
+    const initial = seenSeq ?? this.maxSeq();
+    this.db.prepare(
+      `INSERT INTO board_subscriptions (agent, target, last_seen_seq) VALUES (?, ?, ?)
+         ON CONFLICT(agent, target) DO UPDATE SET
+           last_seen_seq = MAX(board_subscriptions.last_seen_seq, excluded.last_seen_seq)`
+    ).run(agent, key, initial);
+  }
+  maxSeq() {
+    const row = this.db.prepare(`SELECT COALESCE(MAX(seq), 0) AS n FROM board_posts`).get();
+    return row.n;
+  }
+  unsubscribe(agent, target) {
+    const info = this.db.prepare(`DELETE FROM board_subscriptions WHERE agent = ? AND target = ?`).run(agent, targetKey(target));
+    return info.changes > 0;
+  }
+  pendingFor(agent) {
+    const subs = this.db.prepare(`SELECT target, last_seen_seq FROM board_subscriptions WHERE agent = ?`).all(agent);
+    const counts = /* @__PURE__ */ new Map();
+    for (const s of subs) {
+      const count = this.countSince(s.target, s.last_seen_seq);
+      if (count > 0) counts.set(s.target, count);
+    }
+    const noticed = this.db.prepare(`SELECT target, COUNT(*) AS n FROM board_notices WHERE agent = ? GROUP BY target`).all(agent);
+    for (const n of noticed) {
+      if (counts.has(n.target)) continue;
+      counts.set(n.target, n.n);
+    }
+    return [...counts].map(([target, count]) => ({ target, count }));
+  }
+  markRead(agent, target) {
+    if (target) {
+      const key = targetKey(target);
+      this.db.prepare(
+        `UPDATE board_subscriptions SET last_seen_seq = (SELECT MAX(seq) FROM board_posts) WHERE agent = ? AND target = ?`
+      ).run(agent, key);
+      this.db.prepare(
+        `DELETE FROM board_notices WHERE agent = ? AND target = ?
+             AND seq <= (SELECT COALESCE(MAX(seq), 0) FROM board_posts)`
+      ).run(agent, key);
+      return;
+    }
+    this.db.prepare(
+      `UPDATE board_subscriptions SET last_seen_seq = (SELECT COALESCE(MAX(seq), 0) FROM board_posts) WHERE agent = ?`
+    ).run(agent);
+    this.db.prepare(`DELETE FROM board_notices WHERE agent = ?`).run(agent);
+  }
+  countSince(target, sinceSeq) {
+    if (target.startsWith("thread:")) {
+      const id = target.slice("thread:".length);
+      const row2 = this.db.prepare(`SELECT COUNT(*) AS n FROM board_posts WHERE thread_id = ? AND seq > ?`).get(id, sinceSeq);
+      return row2.n;
+    }
+    const name = target.slice("channel:".length);
+    const row = this.db.prepare(
+      `SELECT COUNT(*) AS n FROM board_posts p JOIN board_threads t ON t.id = p.thread_id
+         WHERE t.channel = ? AND p.seq > ?
+           AND p.seq = (SELECT MIN(seq) FROM board_posts WHERE thread_id = p.thread_id)`
+    ).get(name, sinceSeq);
+    return row.n;
+  }
+};
+function pageLimit(raw, fallback2) {
+  if (typeof raw !== "number" || !Number.isFinite(raw)) return fallback2;
+  return Math.min(Math.max(Math.floor(raw), 1), MAX_PAGE_LIMIT);
+}
+function toPage(rows, limit, cursorOf) {
+  if (rows.length <= limit) return { items: rows };
+  const items = rows.slice(0, limit);
+  return { items, nextCursor: cursorOf(items[items.length - 1]) };
+}
+function splitThreadCursor(payload) {
+  const i = payload.indexOf(":");
+  if (i < 0) return [Number.NaN, payload];
+  return [Number.parseInt(payload.slice(0, i), 10) || 0, payload.slice(i + 1)];
+}
+function assertDescription(description) {
+  const bytes = Buffer.byteLength(description, "utf8");
+  if (bytes > MAX_CHANNEL_DESCRIPTION_BYTES) {
+    throw new Error(
+      `Channel description is ${bytes} bytes; at most ${MAX_CHANNEL_DESCRIPTION_BYTES} UTF-8 bytes`
+    );
+  }
+}
+function slicePost(post, offsetChars, limitChars) {
+  const nChars = charLength(post.text);
+  const offset = Math.min(Math.max(Math.floor(offsetChars ?? 0), 0), nChars);
+  const limit = Math.min(Math.max(Math.floor(limitChars ?? MAX_POST_CHARS), 1), MAX_POST_CHARS);
+  const text = sliceChars(post.text, offset, limit);
+  return {
+    post: { ...post, text },
+    nChars,
+    offsetChars: offset,
+    nextOffsetChars: offset + charLength(text)
+  };
+}
+function clip(text) {
+  if (text.length <= MAX_POST_CHARS) return text;
+  return `${text.slice(0, MAX_POST_CHARS)}
+\u2026 (truncated; the original is ${text.length} characters)`;
+}
+function firstLine(text) {
+  const line = text.split("\n", 1)[0] ?? text;
+  return line.length > 80 ? `${line.slice(0, 80)}\u2026` : line;
+}
+function toChannel(r) {
+  return {
+    id: r.id,
+    name: r.name,
+    ...r.description ? { description: r.description } : {},
+    createdBy: r.created_by,
+    createdAt: r.created_at
+  };
+}
+function toPost(r) {
+  return {
+    id: r.id,
+    threadId: r.thread_id,
+    author: r.author,
+    text: r.text,
+    createdAt: r.created_at,
+    seq: r.seq
+  };
+}
+function toThread(r) {
+  return {
+    id: r.id,
+    channel: r.channel,
+    title: r.title,
+    createdBy: r.created_by,
+    createdAt: r.created_at,
+    lastPostAt: r.last_post_at,
+    postCount: r.posts
+  };
+}
+// src/tools/builtin/board.ts
+var MAX_NOTIFY = 256;
+var DEFAULT_PREVIEW_CHARS = 1e3;
 function err(code, message, suggestion) {
   return {
     success: false,
     output: "",
-    error: { code, message, ...{} },
+    error: { code, message, ...suggestion ? { suggestion } : {} },
     duration: 0
   };
 }
@@ -4900,6 +5479,11 @@ function str2(args, key) {
   const v = args[key];
   return typeof v === "string" ? v.trim() : "";
 }
+function num(args, key, fallback2, max) {
+  const v = args[key];
+  if (typeof v !== "number" || !Number.isFinite(v)) return fallback2;
+  return Math.min(Math.max(Math.floor(v), 1), max);
+}
 function parseTarget(raw) {
   const t83 = raw.trim();
   if (!t83) return null;
@@ -4908,26 +5492,59 @@ function parseTarget(raw) {
 function authorOf(deps, ctx) {
   return deps.agentOf(ctx.sessionId) ?? LEAD_AGENT_ID;
 }
-function renderPost(p) {
-  const who = p.author;
+function renderPost(p, maxChars) {
   const when = new Date(p.createdAt).toISOString().slice(0, 16).replace("T", " ");
-  const body2 = p.text.length > 2e3 ? `${p.text.slice(0, 2e3)}\u2026` : p.text;
-  return `#${p.seq} [${p.id}] ${who} \xB7 ${when}
+  const { text, truncated, nChars } = previewPostText(p, maxChars);
+  const body2 = truncated ? `${text}
+\u2026 (showing ${maxChars} of ${nChars} characters; the rest: read_post ${p.id})` : text;
+  return `#${p.seq} [${p.id}] ${p.author} \xB7 ${when}
 ${body2}`;
 }
 function renderThread(t83) {
   return `- ${t83.id}  ${t83.title}  (${t83.postCount} posts, last ${new Date(t83.lastPostAt).toISOString().slice(0, 16).replace("T", " ")})`;
 }
+function moreLine(label, nextCursor) {
+  return nextCursor ? `
+(${label} \u2014 pass cursor=${nextCursor} to continue)` : "";
+}
 function createBoardTools(store, deps) {
   const targetParam = {
     type: "string",
     description: "A channel name (starts a new thread), or a thread id like `th-xxxxxxxx` (replies into it)."
   };
+  const cursorParam = {
+    type: "string",
+    description: "The `next_cursor` from the previous page, unchanged. Keep the same filters; leave it out to start over."
+  };
+  const previewParam = {
+    type: "number",
+    description: `How many characters of each post to show (default ${DEFAULT_PREVIEW_CHARS}, at most ${MAX_POST_CHARS}). Long posts say so and can be read in full with read_post.`
+  };
+  const notifyParam = {
+    type: "array",
+    items: { type: "string" },
+    description: `Agents to notify about **this post only** (they are not subscribed, so later replies do not reach them). At most ${MAX_NOTIFY}.`
+  };
+  const requestIdParam = {
+    type: "string",
+    description: "Idempotency key: posting again with the same id returns the post already created instead of a second copy. Use it when a call may be retried."
+  };
   const tools = [
     {
       name: "get_channels",
-      description: "List the channels on the discussion board. **The board is shared across processes** \u2014 a channel created in another of your windows shows up here.",
-      parameters: { type: "object", properties: {}, required: [] },
+      description: [
+        "List the channels on the discussion board, by name. **The board is shared across processes** \u2014 a channel created in another of your windows shows up here.",
+        "Pass a query to search part of a name (case-insensitive)."
+      ].join("\n"),
+      parameters: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "Only channels whose name contains this." },
+          limit: { type: "number", description: "How many to return (default 100)." },
+          cursor: cursorParam
+        },
+        required: []
+      },
       exposure: ToolExposure.Direct,
       supportsParallel: true,
       operation: "file_read",
@@ -4938,17 +5555,29 @@ function createBoardTools(store, deps) {
         openWorldHint: false
       },
       describeTarget: () => "channel list",
-      async execute() {
-        const channels = store.listChannels();
-        if (channels.length === 0) return ok2("No channels yet. Create one with create_channel.");
+      async execute(args) {
+        const query = str2(args, "query");
+        const page = store.listChannels({
+          ...query ? { query } : {},
+          limit: num(args, "limit", 100, 200),
+          ...str2(args, "cursor") ? { cursor: str2(args, "cursor") } : {}
+        });
+        if (page.items.length === 0) {
+          return ok2(
+            query ? `No channel matches "${query}".` : "No channels yet. Create one with create_channel."
+          );
+        }
         return ok2(
-          channels.map((c) => `- ${c.name}${c.description ? `: ${c.description}` : ""}`).join("\n")
+          page.items.map((c) => `- ${c.name}${c.description ? `: ${c.description}` : ""}`).join("\n") + moreLine("more channels", page.nextCursor)
         );
       }
     },
     {
       name: "create_channel",
-      description: "Create a channel. If it already exists it is returned as-is (no error, description left alone).",
+      description: [
+        "Create a channel. If it already exists it is returned as-is (no error, description left alone).",
+        `The description is capped at ${MAX_CHANNEL_DESCRIPTION_BYTES} UTF-8 bytes.`
+      ].join("\n"),
       parameters: {
         type: "object",
         properties: {
@@ -4985,7 +5614,10 @@ function createBoardTools(store, deps) {
     },
     {
       name: "upsert_channel",
-      description: "Change a channel description (posts and subscriptions are untouched). Creates it if it does not exist.",
+      description: [
+        "Change a channel description (posts and subscriptions are untouched). Creates it if it does not exist.",
+        `The description is capped at ${MAX_CHANNEL_DESCRIPTION_BYTES} UTF-8 bytes.`
+      ].join("\n"),
       parameters: {
         type: "object",
         properties: {
@@ -5019,12 +5651,13 @@ function createBoardTools(store, deps) {
     },
     {
       name: "list_threads",
-      description: "List the threads in a channel, most recent activity first.",
+      description: "List the threads in a channel, most recent activity first. Paged: pass the returned cursor to see more.",
       parameters: {
         type: "object",
         properties: {
           channel: { type: "string", description: "Channel name." },
-          limit: { type: "number", description: "How many to return (default 20)." }
+          limit: { type: "number", description: "How many to return (default 20)." },
+          cursor: cursorParam
         },
         required: ["channel"]
       },
@@ -5042,20 +5675,29 @@ function createBoardTools(store, deps) {
         const channel = str2(args, "channel");
         if (!channel) return err(7406, "Missing channel");
         if (!store.channel(channel)) return err(7407, `No such channel: ${channel}`);
-        const limit = typeof args["limit"] === "number" ? Math.min(Math.max(1, args["limit"]), 200) : 20;
-        const threads = store.listThreads(channel, limit);
-        if (threads.length === 0) return ok2(`Channel ${channel} has no threads yet.`);
-        return ok2(threads.map(renderThread).join("\n"));
+        const page = store.listThreads(channel, {
+          limit: num(args, "limit", 20, 200),
+          ...str2(args, "cursor") ? { cursor: str2(args, "cursor") } : {}
+        });
+        if (page.items.length === 0) return ok2(`Channel ${channel} has no (more) threads.`);
+        return ok2(
+          page.items.map(renderThread).join("\n") + moreLine("more threads", page.nextCursor)
+        );
       }
     },
     {
       name: "read_thread",
-      description: "Read the posts in a thread, oldest first. **Reading advances the subscription cursor to now** via markRead, so these posts are not reported again.",
+      description: [
+        "Read the posts in a thread, oldest first, **paged**. Each post is truncated to maxCharsPerPost (default 1000); read_post gives the rest.",
+        "**Reading the last page advances the subscription cursor** via markRead, so those posts are not reported again. Reading only the first page leaves the rest unread \u2014 that is deliberate."
+      ].join("\n"),
       parameters: {
         type: "object",
         properties: {
           threadId: { type: "string", description: "Thread id (starts with th-)" },
-          limit: { type: "number", description: "How many posts to return (default 50)." }
+          limit: { type: "number", description: "How many posts to return (default 50)." },
+          cursor: cursorParam,
+          maxCharsPerPost: previewParam
         },
         required: ["threadId"]
       },
@@ -5072,21 +5714,38 @@ function createBoardTools(store, deps) {
       async execute(args, ctx) {
         const threadId = str2(args, "threadId");
         if (!threadId) return err(7408, "Missing threadId");
-        const limit = typeof args["limit"] === "number" ? Math.min(Math.max(1, args["limit"]), 500) : 50;
-        const posts = store.readThread(threadId, limit);
-        if (posts.length === 0) {
-          return ok2(`Thread ${threadId} has no posts (or the thread does not exist).`);
+        const maxChars = num(args, "maxCharsPerPost", DEFAULT_PREVIEW_CHARS, MAX_POST_CHARS);
+        const page = store.readThread(threadId, {
+          limit: num(args, "limit", 50, 200),
+          ...str2(args, "cursor") ? { cursor: str2(args, "cursor") } : {}
+        });
+        if (page.items.length === 0) {
+          return ok2(`Thread ${threadId} has no (more) posts (or the thread does not exist).`);
+        }
+        if (!page.nextCursor) {
+          store.markRead(authorOf(deps, ctx), { kind: "thread", id: threadId });
         }
-        store.markRead(authorOf(deps, ctx), { kind: "thread", id: threadId });
-        return ok2(posts.map(renderPost).join("\n\n"));
+        return ok2(
+          page.items.map((p) => renderPost(p, maxChars)).join("\n\n") + moreLine("more posts", page.nextCursor)
+        );
       }
     },
     {
       name: "read_post",
-      description: "Read one post in full (read_thread truncates long posts).",
+      description: [
+        "Read one post in full (read_thread only gives a preview). Long posts are read in slices: pass offsetChars / limitChars,",
+        "and keep going at nextOffsetChars while it is smaller than nChars. Offsets count Unicode characters."
+      ].join("\n"),
       parameters: {
         type: "object",
-        properties: { postId: { type: "string", description: "Post id (starts with po-)." } },
+        properties: {
+          postId: { type: "string", description: "Post id (starts with po-)." },
+          offsetChars: { type: "number", description: "Where to start (default 0)." },
+          limitChars: {
+            type: "number",
+            description: `How many characters to return (default and maximum ${MAX_POST_CHARS}).`
+          }
+        },
         required: ["postId"]
       },
       exposure: ToolExposure.Deferred,
@@ -5101,22 +5760,41 @@ function createBoardTools(store, deps) {
       describeTarget: (args) => String(args["postId"] ?? ""),
       async execute(args) {
         const id = str2(args, "postId");
-        const p = store.readPost(id);
-        if (!p) return err(7409, `No such post: ${id}`);
-        return ok2(renderPost(p));
+        const rawOffset = typeof args["offsetChars"] === "number" ? args["offsetChars"] : 0;
+        const slice = store.readPost(id, {
+          offsetChars: Math.max(0, Math.floor(rawOffset)),
+          limitChars: num(args, "limitChars", MAX_POST_CHARS, MAX_POST_CHARS)
+        });
+        if (!slice) return err(7409, `No such post: ${id}`);
+        const head = `#${slice.post.seq} [${slice.post.id}] ${slice.post.author}`;
+        const more = slice.nextOffsetChars < slice.nChars ? `
+(more \u2014 pass offsetChars=${slice.nextOffsetChars}; ${slice.nextOffsetChars}/${slice.nChars} shown)` : "";
+        return ok2(`${head}
+${slice.post.text}${more}`);
       }
     },
     {
       name: "search_posts",
-      description: "Full-text search across posts on the board (substring match). Can be limited to one channel.",
+      description: [
+        "Search posts on the board, newest first. Text matches are case-insensitive substrings.",
+        "Omit the query to see recent activity; narrow by channel, author, or posts after a message id.",
+        "Results are previews \u2014 read_post gets the rest."
+      ].join("\n"),
       parameters: {
         type: "object",
         properties: {
-          query: { type: "string", description: "Term to search for." },
+          query: { type: "string", description: "Term to search for (omit for recent activity)." },
           channel: { type: "string", description: "Search only within this channel." },
-          limit: { type: "number", description: "How many to return (default 20)." }
+          author: { type: "string", description: "Only posts by this agent." },
+          afterMessageId: {
+            type: "string",
+            description: "Only posts after this one (a po- id)."
+          },
+          limit: { type: "number", description: "How many to return (default 20)." },
+          cursor: cursorParam,
+          maxCharsPerPost: previewParam
         },
-        required: ["query"]
+        required: []
       },
       exposure: ToolExposure.Deferred,
       supportsParallel: true,
@@ -5127,28 +5805,49 @@ function createBoardTools(store, deps) {
         idempotentHint: true,
         openWorldHint: false
       },
-      describeTarget: (args) => String(args["query"] ?? ""),
+      describeTarget: (args) => String(args["query"] ?? "(recent)"),
       async execute(args) {
         const query = str2(args, "query");
-        if (!query) return err(7410, "Missing query");
         const channel = str2(args, "channel");
-        const limit = typeof args["limit"] === "number" ? Math.min(Math.max(1, args["limit"]), 100) : 20;
-        const posts = store.searchPosts(query, channel || void 0, limit);
-        if (posts.length === 0) return ok2(`No posts containing "${query}" were found.`);
-        return ok2(posts.map(renderPost).join("\n\n"));
+        const author = str2(args, "author");
+        const afterMessageId = str2(args, "afterMessageId");
+        const maxChars = num(args, "maxCharsPerPost", DEFAULT_PREVIEW_CHARS, MAX_POST_CHARS);
+        const page = store.searchPosts({
+          ...query ? { query } : {},
+          ...channel ? { channel } : {},
+          ...author ? { author } : {},
+          ...afterMessageId ? { afterMessageId } : {},
+          limit: num(args, "limit", 20, 100),
+          ...str2(args, "cursor") ? { cursor: str2(args, "cursor") } : {}
+        });
+        if (page.items.length === 0) {
+          return ok2(query ? `No posts containing "${query}" were found.` : "No recent posts.");
+        }
+        return ok2(
+          page.items.map((p) => renderPost(p, maxChars)).join("\n\n") + moreLine("more results", page.nextCursor)
+        );
       }
     },
     {
       name: "post",
       description: [
-        "Post a message. A channel name as target **opens a new thread**; a thread id starting with th- replies into it.",
-        "You are **subscribed to your own post automatically** (so you get notified of later replies).",
+        "Post a message. A channel name as target **opens a new thread**; a thread id starting with th- replies into it; newChannelName creates the channel in the same call (give exactly one destination).",
+        "You are **subscribed to your own post automatically** (so you get notified of later replies). agentsToNotify gives people a one-time heads-up without subscribing them.",
         "To record something silently without notifying anyone, use append."
       ].join("\n"),
       parameters: {
         type: "object",
-        properties: { target: targetParam, text: { type: "string", description: "Post body." } },
-        required: ["target", "text"]
+        properties: {
+          target: targetParam,
+          newChannelName: {
+            type: "string",
+            description: "Create this channel (if needed) and start the thread there."
+          },
+          text: { type: "string", description: "Post body." },
+          agentsToNotify: notifyParam,
+          requestId: requestIdParam
+        },
+        required: ["text"]
       },
       exposure: ToolExposure.Deferred,
       supportsParallel: false,
@@ -5159,15 +5858,26 @@ function createBoardTools(store, deps) {
         idempotentHint: false,
         openWorldHint: false
       },
-      describeTarget: (args) => String(args["target"] ?? ""),
+      describeTarget: (args) => String(args["target"] ?? args["newChannelName"] ?? ""),
       async execute(args, ctx) {
-        const target = parseTarget(str2(args, "target"));
+        const dest = destinationOf(args);
+        if ("error" in dest) return dest.error;
         const text = str2(args, "text");
-        if (!target) return err(7411, "Missing target");
         if (!text) return err(7412, "Missing text");
+        const notify = notifyList(args);
+        if ("error" in notify) return notify.error;
         try {
-          const r = store.post({ target, author: authorOf(deps, ctx), text });
-          return ok2(`Posted ${r.post.id} (thread ${r.threadId}, #${r.post.seq}).`);
+          const r = store.post({
+            target: dest.target,
+            author: authorOf(deps, ctx),
+            text,
+            ...dest.create ? { createChannel: true } : {},
+            ...notify.list.length > 0 ? { notify: notify.list } : {},
+            ...str2(args, "requestId") ? { requestId: str2(args, "requestId") } : {}
+          });
+          const retry = r.duplicate ? " (this request id already produced that post \u2014 no duplicate made)" : "";
+          const told = notify.list.length > 0 ? ` Notified ${notify.list.join(", ")} for this post only.` : "";
+          return ok2(`Posted ${r.post.id} (thread ${r.threadId}, #${r.post.seq}).${retry}${told}`);
         } catch (cause) {
           return err(7413, cause instanceof Error ? cause.message : String(cause));
         }
@@ -5182,8 +5892,16 @@ function createBoardTools(store, deps) {
       ].join("\n"),
       parameters: {
         type: "object",
-        properties: { target: targetParam, text: { type: "string", description: "Body." } },
-        required: ["target", "text"]
+        properties: {
+          target: targetParam,
+          newChannelName: {
+            type: "string",
+            description: "Create this channel (if needed) without subscribing anyone."
+          },
+          text: { type: "string", description: "Body." },
+          requestId: requestIdParam
+        },
+        required: ["text"]
       },
       exposure: ToolExposure.Deferred,
       supportsParallel: false,
@@ -5194,16 +5912,23 @@ function createBoardTools(store, deps) {
         idempotentHint: false,
         openWorldHint: false
       },
-      describeTarget: (args) => String(args["target"] ?? ""),
+      describeTarget: (args) => String(args["target"] ?? args["newChannelName"] ?? ""),
       async execute(args, ctx) {
-        const target = parseTarget(str2(args, "target"));
+        const dest = destinationOf(args);
+        if ("error" in dest) return dest.error;
         const text = str2(args, "text");
-        if (!target) return err(7414, "Missing target");
         if (!text) return err(7415, "Missing text");
         try {
-          const r = store.append({ target, author: authorOf(deps, ctx), text });
+          const r = store.append({
+            target: dest.target,
+            author: authorOf(deps, ctx),
+            text,
+            ...dest.create ? { createChannel: true } : {},
+            ...str2(args, "requestId") ? { requestId: str2(args, "requestId") } : {}
+          });
+          const retry = r.duplicate ? " (this request id already produced that post)" : "";
           return ok2(
-            `Appended ${r.post.id} (thread ${r.threadId}, #${r.post.seq}). Nobody was notified.`
+            `Appended ${r.post.id} (thread ${r.threadId}, #${r.post.seq}). Nobody was notified.${retry}`
           );
         } catch (cause) {
           return err(7416, cause instanceof Error ? cause.message : String(cause));
@@ -5212,10 +5937,19 @@ function createBoardTools(store, deps) {
     },
     {
       name: "subscribe",
-      description: "Subscribe to a channel or thread. When something new appears there, you get a reminder at the start of your next turn (**it does not wake you up**).",
+      description: [
+        "Subscribe yourself or another agent to a channel (new top-level posts) or a thread (replies).",
+        "When something new appears there, you get a reminder at the start of your next turn (**it does not wake you up**)."
+      ].join("\n"),
       parameters: {
         type: "object",
-        properties: { target: { ...targetParam, description: "Channel name or thread id." } },
+        properties: {
+          target: { ...targetParam, description: "Channel name or thread id." },
+          targetAgent: {
+            type: "string",
+            description: "Who to subscribe (default: you). A member name, or lead for the main session."
+          }
+        },
         required: ["target"]
       },
       exposure: ToolExposure.Deferred,
@@ -5231,16 +5965,20 @@ function createBoardTools(store, deps) {
       async execute(args, ctx) {
         const target = parseTarget(str2(args, "target"));
         if (!target) return err(7417, "Missing target");
-        store.subscribe(authorOf(deps, ctx), target);
-        return ok2(`Subscribed to ${str2(args, "target")}.`);
+        const who = str2(args, "targetAgent") || authorOf(deps, ctx);
+        store.subscribe(who, target);
+        return ok2(`Subscribed ${who} to ${str2(args, "target")}.`);
       }
     },
     {
       name: "unsubscribe",
-      description: "Unsubscribe.",
+      description: "Unsubscribe yourself or another agent from a channel or a thread.",
       parameters: {
         type: "object",
-        properties: { target: { ...targetParam, description: "Channel name or thread id." } },
+        properties: {
+          target: { ...targetParam, description: "Channel name or thread id." },
+          targetAgent: { type: "string", description: "Who to unsubscribe (default: you)." }
+        },
         required: ["target"]
       },
       exposure: ToolExposure.Deferred,
@@ -5256,15 +5994,56 @@ function createBoardTools(store, deps) {
       async execute(args, ctx) {
         const target = parseTarget(str2(args, "target"));
         if (!target) return err(7418, "Missing target");
-        const removed = store.unsubscribe(authorOf(deps, ctx), target);
+        const who = str2(args, "targetAgent") || authorOf(deps, ctx);
+        const removed = store.unsubscribe(who, target);
         return ok2(
-          removed ? `Unsubscribed from ${str2(args, "target")}.` : `Was not subscribed to ${str2(args, "target")}.`
+          removed ? `Unsubscribed ${who} from ${str2(args, "target")}.` : `${who} was not subscribed to ${str2(args, "target")}.`
         );
       }
     }
   ];
   return tools;
 }
+function destinationOf(args) {
+  const raw = str2(args, "target");
+  const newChannel = str2(args, "newChannelName");
+  if (raw && newChannel) {
+    return {
+      error: err(
+        7419,
+        "Both target and newChannelName were given",
+        "Give exactly one destination: target (a channel name or a th- thread id) or newChannelName"
+      )
+    };
+  }
+  if (newChannel) return { target: { kind: "channel", name: newChannel }, create: true };
+  const target = parseTarget(raw);
+  if (!target) {
+    return {
+      error: err(
+        7411,
+        "Missing target",
+        "Give a channel name or a th- thread id as target, or create one with newChannelName"
+      )
+    };
+  }
+  return { target, create: false };
+}
+function notifyList(args) {
+  const raw = args["agentsToNotify"];
+  if (!Array.isArray(raw)) return { list: [] };
+  const list = [...new Set(raw.map((v) => String(v).trim()).filter(Boolean))];
+  if (list.length > MAX_NOTIFY) {
+    return {
+      error: err(
+        7420,
+        `agentsToNotify has ${list.length} entries; at most ${MAX_NOTIFY}`,
+        "Notify fewer people in one post, or post again in the same thread"
+      )
+    };
+  }
+  return { list };
+}
 var BOARD_TOOL_NAMES = Object.freeze([
   "create_channel",
   "upsert_channel",
@@ -5295,6 +6074,28 @@ function str3(args, key) {
   const v = args[key];
   return typeof v === "string" ? v.trim() : "";
 }
+function crossDirAllowed(ctx, targetDir) {
+  if (!targetDir) return true;
+  if (ctx.permissionLevel === "auto") return true;
+  return isInWorkspace(targetDir, ctx.workDir, [
+    ...ctx.extraRoots ?? [],
+    ...ctx.grantedPaths ?? []
+  ]);
+}
+function ownsMember(team, ctx, member) {
+  return team.sameTree(ctx.sessionId, member.sessionId);
+}
+function notYours(verb) {
+  return err2(
+    7217,
+    `That member was dispatched by another session, so this session cannot ${verb} it`,
+    [
+      "The roster is shared across sessions, the right to reach into a member is not.",
+      "Only members on your own side of the roster can be touched here \u2014 list_agents shows them",
+      "To reach that work, talk to the session that dispatched it; to get the same work done yourself, dispatch a new member with spawn_teammate"
+    ].join(". ")
+  );
+}
 function spawnTeammate(team, manager) {
   return {
     name: "spawn_teammate",
@@ -5468,7 +6269,8 @@ function interruptAgent(team) {
     name: "interrupt_agent",
     description: [
       "Interrupt a teammate that is running (it is aborted, and whatever half-finished result it produced is kept).",
-      "A teammate that has already finished cannot be interrupted \u2014 that returns false; confirm with list_agents."
+      "A teammate that has already finished cannot be interrupted \u2014 that returns false; confirm with list_agents.",
+      "Only members **on your own side of the roster** can be interrupted \u2014 the ones this session dispatched (when you are a member yourself: your teammates). Another session\u2019s member is refused even if you know its name."
     ].join("\n"),
     parameters: {
       type: "object",
@@ -5487,12 +6289,13 @@ function interruptAgent(team) {
       openWorldHint: false
     },
     describeTarget: (args) => String(args["agentId"] ?? ""),
-    async execute(args) {
+    async execute(args, ctx) {
       const agentId = str3(args, "agentId");
       if (!agentId) return err2(7206, "Missing agentId");
       const member = team.get(agentId);
       if (!member)
         return err2(7207, `No such member: ${agentId}`, "Use list_agents to see who is around");
+      if (!ownsMember(team, ctx, member)) return notYours("interrupt");
       if (!team.interrupt(agentId)) {
         return err2(
           7208,
@@ -5504,13 +6307,59 @@ function interruptAgent(team) {
     }
   };
 }
+function closeAgent(team) {
+  return {
+    name: "close_agent",
+    description: [
+      "Close a member (and anything it dispatched) when you no longer need it, and get back the status it had before it was closed.",
+      "Finished members stay in the roster until they are closed \u2014 they are not costing you a concurrency slot, but they do clutter list_agents. If you are done with one, close it; do not let them pile up.",
+      "This is different from interrupt_agent: that one aborts the current turn and keeps the member around for more messages; this one takes it off the roster.",
+      "Only members **on your own side of the roster** can be closed \u2014 the ones this session dispatched (when you are a member yourself: your teammates). Another session\u2019s member is refused even if you know its name."
+    ].join("\n"),
+    parameters: {
+      type: "object",
+      properties: {
+        agentId: {
+          type: "string",
+          description: "Name of the member to close (as listed by list_agents)."
+        }
+      },
+      required: ["agentId"]
+    },
+    exposure: ToolExposure.Deferred,
+    supportsParallel: false,
+    operation: "command",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: false,
+      openWorldHint: false
+    },
+    describeTarget: (args) => String(args["agentId"] ?? ""),
+    async execute(args, ctx) {
+      const agentId = str3(args, "agentId");
+      if (!agentId) return err2(7212, "Missing agentId");
+      const member = team.get(agentId);
+      if (member && !ownsMember(team, ctx, member)) return notYours("close");
+      const r = team.close(agentId);
+      if (!r.ok) return err2(7213, r.reason ?? `Could not close ${agentId}`);
+      const line = `Closed ${agentId} (its status before closing: ${r.previous ?? "unknown"}).`;
+      const kin = r.descendants && r.descendants.length > 0 ? ` Also closed what it had dispatched: ${r.descendants.join(", ")}.` : "";
+      const lost = r.dropped && r.dropped.count > 0 ? ` It still had ${r.dropped.count} unread message(s) from ${r.dropped.from.join(", ")}; they went with it.` : "";
+      return ok3(
+        `${line}${kin}${lost} Its session is still in the session list \u2014 closing only takes it off the roster.`
+      );
+    }
+  };
+}
 function taskCreate(team) {
   return {
     name: "team_task_create",
     description: [
       "Create a task on the shared task board. The whole team sees the same board.",
       "dependsOn takes other task ids (they must already exist).",
-      "owner takes a member name, marking the task as theirs."
+      "owner takes a member name, marking the task as theirs.",
+      "Task readiness never starts an owner: when the tasks it depends on are marked done, **no turn is started for anybody** \u2014 the board is coordination state, not an alarm clock. Tell the owner yourself (send_message while it runs, followup_task when it is idle)."
     ].join("\n"),
     parameters: {
       type: "object",
@@ -5642,7 +6491,8 @@ function taskUpdate(team) {
     description: [
       "Change a task. **Call team_task_get first to get the revision, and pass it back unchanged as expectedRevision.**",
       "If someone else changed it in the meantime, this write is **rejected as a whole** and you are told what the revision is now \u2014",
-      "read it again and decide; do not guess. Leaving expectedRevision out means no check at all (only when you are certain you are the only writer)."
+      "read it again and decide; do not guess. Leaving expectedRevision out means no check at all (only when you are certain you are the only writer).",
+      "Marking a task done does not start the tasks waiting on it, and it does not wake their owner \u2014 the board never runs anybody. Say so yourself with send_message / followup_task."
     ].join("\n"),
     parameters: {
       type: "object",
@@ -5699,16 +6549,22 @@ function followupTask(team, manager) {
     description: [
       "Wake a counterpart that is **not running** and have it run another turn with all of its previous context.",
       "The target can be a teammate that has finished (agentId from list_agents), or **another main session** (sessionId from list_agents --all).",
+      "Only the members **this session dispatched** can be woken; another session's subagent is refused even if you know its name (the roster is shared, the right to wake it is not).",
+      "A member that was closed with close_agent is gone for good \u2014 it cannot be woken again, not even by its session id.",
       "How this splits with send_message: send_message only works while the other side **is running** (it lands in that turn);",
       "when it is not running, use this \u2014 it continues its own session rather than starting from scratch.",
       "Waking is asynchronous: the tool returns as soon as it is accepted, its own turn runs in the background, and you do not wait for the answer.",
       "One wake = one full model call (the whole history is resent), so say everything in one go instead of splitting it three ways.",
-      "There is a cap on concurrently woken sessions (3 by default); waking a fourth is rejected \u2014 wait for one to finish first."
+      `There is a cap on concurrently woken sessions (${team.wakeLimit} right now); waking one more is rejected \u2014 wait for one to finish first.`,
+      "Waking a session that works in a different directory follows the permission level: at auto it is allowed, below that a cross-directory wake is refused."
     ].join("\n"),
     parameters: {
       type: "object",
       properties: {
-        agentId: { type: "string", description: "Member name (as listed by list_agents)." },
+        agentId: {
+          type: "string",
+          description: "Member name (as listed by list_agents); its session id works too and is resolved to the member."
+        },
         message: { type: "string", description: "What it should do this turn." }
       },
       required: ["agentId", "message"]
@@ -5729,12 +6585,20 @@ function followupTask(team, manager) {
       const message = str3(args, "message");
       if (!agentId) return err2(7205, "Missing agentId");
       if (!message) return err2(7206, "Missing message");
-      const member = team.get(agentId);
+      const member = team.get(agentId) ?? team.bySession(agentId);
       if (member) {
+        const name = member.agentId;
+        if (!ownsMember(team, ctx, member)) {
+          return err2(
+            7217,
+            `${name} was dispatched by another session, so this session cannot wake it`,
+            "list_agents shows the members this session dispatched \u2014 those are the ones you can wake. To reach that work, wake the session that dispatched it (followup_task with its session id), or dispatch a new member with spawn_teammate"
+          );
+        }
         if (member.status === "running") {
           return err2(
             7208,
-            `${agentId} is already running; no need to wake it`,
+            `${name} is already running; no need to wake it`,
             "To talk to it now use send_message \u2014 that lands at its next step boundary and takes effect in the current turn"
           );
         }
@@ -5743,7 +6607,7 @@ function followupTask(team, manager) {
             tasks: [
               {
                 goal: message,
-                agentId,
+                agentId: name,
                 resumeSessionId: member.sessionId,
                 ...member.role ? { role: member.role } : {}
               }
@@ -5757,12 +6621,29 @@ function followupTask(team, manager) {
         if (!r.success) return { ...err2(7209, r.output), duration: Date.now() - start };
         return ok3(
           [
-            `Woke ${agentId} (background job ${r.jobId ?? "(none)"}); it carries on with the previous context.`,
+            `Woke ${name} (background job ${r.jobId ?? "(none)"}); it carries on with the previous context.`,
+            ...name === agentId ? [] : [
+              `(${agentId} is the session of member ${name}; address it by its name next time)`
+            ],
             `See how far it got: task_output ${r.jobId ?? ""} or list_agents`
           ].join("\n"),
           start
         );
       }
+      if (team.isClosed(agentId)) {
+        return err2(
+          7214,
+          `${agentId} was closed with close_agent, so it cannot be woken again \u2014 not even by its session id`,
+          'Closing means "I do not want it any more". If that work still matters, dispatch a new member with spawn_teammate and give it the context it needs'
+        );
+      }
+      if (team.isSubagentSession(agentId)) {
+        return err2(
+          7215,
+          `${agentId} is a sub-agent session that is not on the roster \u2014 it is not a main session and cannot be woken`,
+          "Wake a member by its name from list_agents. A closed member, or one dispatched by an earlier process, is gone for good"
+        );
+      }
       if (team.sessionExists(agentId)) {
         if (team.isSessionActive(agentId)) {
           return err2(
@@ -5773,6 +6654,14 @@ function followupTask(team, manager) {
         }
         const self = team.bySession(ctx.sessionId);
         const from = self ? self.agentId : ctx.sessionId;
+        const targetDir = team.sessionWorkDir(agentId);
+        if (!crossDirAllowed(ctx, targetDir)) {
+          return err2(
+            7216,
+            `${agentId} works in ${String(targetDir)}, outside this session's workspace (${ctx.workDir}) \u2014 a wake across directories needs a permission level that allows it, and this one is ${ctx.permissionLevel}`,
+            "Below auto, an outside directory has to be approved by the user, and a wake cannot ask. Ask the user to open that session and send it there, or add the directory with --add-dir"
+          );
+        }
         const fromLabel = self ? void 0 : sessionSenderLabel(from, team.sessionTitle(from));
         const r = await team.wakeSession(
           agentId,
@@ -5801,6 +6690,7 @@ function createTeamTools(team, manager) {
     spawnTeammate(team, manager),
     waitAgent(team),
     interruptAgent(team),
+    closeAgent(team),
     followupTask(team, manager),
     taskCreate(team),
     taskList(team),
@@ -5813,6 +6703,7 @@ var TEAM_TOOL_NAMES = Object.freeze([
   "list_agents",
   "wait_agent",
   "interrupt_agent",
+  "close_agent",
   "followup_task",
   "team_task_create",
   "team_task_list",
@@ -5906,6 +6797,7 @@ function belowTrigramFloor(safeQuery) {
 }
 // src/session/trace.ts
 var NODE_COLUMNS = `id, title, cwd, started_at, message_count, archived, parent_id`;
+var SUBTREE_COLUMNS = `id, title, started_at, updated_at, archived, parent_id`;
 function toNode(ctx, row, depth) {
   const base2 = { sessionId: row.id, depth, parentId: row.parent_id ?? void 0 };
   if (!ctx.visible(row.id)) return { ...base2, visible: false };
@@ -5919,39 +6811,49 @@ function toNode(ctx, row, depth) {
     archived: row.archived === 1
   };
 }
-function ancestorsOf(ctx, startParent) {
+function walkAncestors(startParent, byId, parentOf2) {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
   let at = startParent;
   let depth = -1;
   while (at && !seen.has(at)) {
     seen.add(at);
-    const row = ctx.byId(at);
-    if (!row) break;
-    out.push(toNode(ctx, row, depth));
-    at = row.parent_id ?? void 0;
+    const node = byId(at);
+    if (!node) break;
+    out.push({ node, depth });
+    at = parentOf2(node);
     depth -= 1;
   }
   return out;
 }
-function descendantsOf(ctx, rootId, limit) {
-  const nodes = [];
+function walkDescendants(rootId, children, idOf, limit) {
+  const steps = [];
   const seen = /* @__PURE__ */ new Set([rootId]);
   let truncated = 0;
   const walk3 = (parentId, depth) => {
-    for (const row of ctx.children(parentId)) {
-      if (seen.has(row.id)) continue;
-      seen.add(row.id);
-      if (nodes.length >= limit) {
+    for (const node of children(parentId)) {
+      const id = idOf(node);
+      if (seen.has(id)) continue;
+      seen.add(id);
+      if (steps.length >= limit) {
         truncated += 1;
         continue;
       }
-      nodes.push(toNode(ctx, row, depth));
-      walk3(row.id, depth + 1);
+      steps.push({ node, depth });
+      walk3(id, depth + 1);
     }
   };
   walk3(rootId, 1);
-  return { nodes, truncated };
+  return { steps, truncated };
+}
+function ancestorsOf(ctx, startParent) {
+  return walkAncestors(startParent, ctx.byId, (row) => row.parent_id ?? void 0).map(
+    ({ node, depth }) => toNode(ctx, node, depth)
+  );
+}
+function descendantsOf(ctx, rootId, limit) {
+  const { steps, truncated } = walkDescendants(rootId, ctx.children, (row) => row.id, limit);
+  return { nodes: steps.map(({ node, depth }) => toNode(ctx, node, depth)), truncated };
 }
 function traceSession(db, input) {
   const vis = resolveSessionVisibility({ ...input, db });
@@ -5980,6 +6882,37 @@ function traceSession(db, input) {
     truncated
   };
 }
+var SUBAGENT_TREE_LIMIT = 200;
+function sessionSubtree(db, input) {
+  const byIdStmt = db.prepare(`SELECT ${SUBTREE_COLUMNS} FROM sessions WHERE id = @id`);
+  const childrenStmt = db.prepare(
+    `SELECT ${SUBTREE_COLUMNS} FROM sessions WHERE parent_id = @id ORDER BY started_at ASC`
+  );
+  const byId = (id) => byIdStmt.get({ id });
+  const children = (parentId) => childrenStmt.all({ id: parentId });
+  const self = byId(input.sessionId);
+  if (!self) return { rootId: input.sessionId, nodes: [], truncated: 0 };
+  const ancestors = walkAncestors(
+    self.parent_id ?? void 0,
+    byId,
+    (row) => row.parent_id ?? void 0
+  );
+  const rootId = ancestors.at(-1)?.node.id ?? self.id;
+  const { steps, truncated } = walkDescendants(rootId, children, (row) => row.id, input.limit);
+  return {
+    rootId,
+    nodes: steps.map(({ node, depth }) => ({
+      sessionId: node.id,
+      ...node.parent_id ? { parentId: node.parent_id } : {},
+      title: node.title,
+      startedAt: node.started_at,
+      ...node.updated_at === null ? {} : { updatedAt: node.updated_at },
+      archived: node.archived === 1,
+      depth
+    })),
+    truncated
+  };
+}
 // src/session/types.ts
 var DELEGATE_SESSION_SOURCE = "delegate";
 // src/session/query.ts
@@ -7361,7 +8294,7 @@ function isOpenTodo(status) {
   return status === "pending" || status === "in_progress";
 }
 var NS = "tracker";
-var MIGRATIONS = [
+var MIGRATIONS2 = [
   {
     id: "tracker-baseline",
     version: 1,
@@ -7396,7 +8329,7 @@ var TrackerDB = class {
   constructor(dbPath2) {
     this.path = dbPath2;
     this.db = openDatabase(this.path);
-    migrate(this.db, NS, MIGRATIONS);
+    migrate(this.db, NS, MIGRATIONS2);
   }
   listBySession(sessionId) {
     const rows = this.db.prepare(
@@ -7560,262 +8493,6 @@ function createTodoTool(db) {
     }
   };
 }
-var MAX_POST_CHARS = 2e4;
-var CHANNEL_PATTERN = /^[A-Za-z0-9_.-]{1,64}$/;
-var MIGRATIONS2 = [
-  {
-    id: "board-initial",
-    version: 1,
-    description: "Discussion board: channels / threads / posts / subscriptions",
-    up: (db) => {
-      db.exec(`
-        CREATE TABLE IF NOT EXISTS board_channels (
-          id          TEXT PRIMARY KEY,
-          name        TEXT NOT NULL UNIQUE,
-          description TEXT,
-          created_by  TEXT NOT NULL,
-          created_at  INTEGER NOT NULL
-        );
-        CREATE TABLE IF NOT EXISTS board_threads (
-          id           TEXT PRIMARY KEY,
-          channel      TEXT NOT NULL,
-          title        TEXT NOT NULL,
-          created_by   TEXT NOT NULL,
-          created_at   INTEGER NOT NULL,
-          last_post_at INTEGER NOT NULL
-        );
-        CREATE INDEX IF NOT EXISTS board_threads_channel ON board_threads(channel, last_post_at DESC);
-        CREATE TABLE IF NOT EXISTS board_posts (
-          seq        INTEGER PRIMARY KEY AUTOINCREMENT,
-          id         TEXT NOT NULL UNIQUE,
-          thread_id  TEXT NOT NULL,
-          author     TEXT NOT NULL,
-          text       TEXT NOT NULL,
-          created_at INTEGER NOT NULL
-        );
-        CREATE INDEX IF NOT EXISTS board_posts_thread ON board_posts(thread_id, seq);
-        CREATE TABLE IF NOT EXISTS board_subscriptions (
-          agent         TEXT NOT NULL,
-          target        TEXT NOT NULL,
-          last_seen_seq INTEGER NOT NULL DEFAULT 0,
-          PRIMARY KEY (agent, target)
-        );
-      `);
-    }
-  }
-];
-function targetKey(t83) {
-  return t83.kind === "channel" ? `channel:${t83.name}` : `thread:${t83.id}`;
-}
-var BoardStore = class {
-  path;
-  db;
-  constructor(homeDir) {
-    this.path = dbPath(homeDir);
-    this.db = openDatabase(this.path);
-    migrate(this.db, "board", MIGRATIONS2);
-  }
-  close() {
-    releaseDatabase(this.path);
-  }
-  createChannel(args) {
-    if (!CHANNEL_PATTERN.test(args.name)) {
-      throw new Error(
-        `Invalid channel name: ${args.name} (letters, digits, _ . - only, at most 64 characters)`
-      );
-    }
-    const existing = this.channel(args.name);
-    if (existing) return existing;
-    const row = {
-      id: `ch-${randomUUID().slice(0, 8)}`,
-      name: args.name,
-      ...args.description ? { description: args.description } : {},
-      createdBy: args.by,
-      createdAt: Date.now()
-    };
-    this.db.prepare(
-      `INSERT INTO board_channels (id, name, description, created_by, created_at)
-         VALUES (?, ?, ?, ?, ?)`
-    ).run(row.id, row.name, row.description ?? null, row.createdBy, row.createdAt);
-    return row;
-  }
-  upsertChannel(args) {
-    const existing = this.channel(args.name);
-    if (!existing) return this.createChannel(args);
-    this.db.prepare(`UPDATE board_channels SET description = ? WHERE name = ?`).run(args.description, args.name);
-    return { ...existing, description: args.description };
-  }
-  channel(name) {
-    const row = this.db.prepare(
-      `SELECT id, name, description, created_by, created_at FROM board_channels WHERE name = ?`
-    ).get(name);
-    return row ? toChannel(row) : void 0;
-  }
-  listChannels() {
-    const rows = this.db.prepare(
-      `SELECT id, name, description, created_by, created_at FROM board_channels ORDER BY name`
-    ).all();
-    return rows.map(toChannel);
-  }
-  listThreads(channel, limit = 20) {
-    const rows = this.db.prepare(
-      `SELECT t.id, t.channel, t.title, t.created_by, t.created_at, t.last_post_at,
-                (SELECT COUNT(*) FROM board_posts p WHERE p.thread_id = t.id) AS posts
-         FROM board_threads t WHERE t.channel = ? ORDER BY t.last_post_at DESC LIMIT ?`
-    ).all(channel, limit);
-    return rows.map((r) => ({
-      id: r.id,
-      channel: r.channel,
-      title: r.title,
-      createdBy: r.created_by,
-      createdAt: r.created_at,
-      lastPostAt: r.last_post_at,
-      postCount: r.posts
-    }));
-  }
-  post(args) {
-    return this.write({ ...args, notify: true });
-  }
-  append(args) {
-    return this.write({ ...args, notify: false });
-  }
-  write(args) {
-    const text = clip(args.text);
-    const now = Date.now();
-    const run = this.db.transaction(() => {
-      let threadId;
-      if (args.target.kind === "thread") {
-        const exists2 = this.db.prepare(`SELECT id FROM board_threads WHERE id = ?`).get(args.target.id);
-        if (!exists2) throw new Error(`No such thread: ${args.target.id}`);
-        threadId = args.target.id;
-      } else {
-        const ch = this.channel(args.target.name);
-        if (!ch) throw new Error(`No such channel: ${args.target.name}`);
-        threadId = `th-${randomUUID().slice(0, 8)}`;
-        this.db.prepare(
-          `INSERT INTO board_threads (id, channel, title, created_by, created_at, last_post_at)
-             VALUES (?, ?, ?, ?, ?, ?)`
-        ).run(threadId, ch.name, firstLine(text), args.author, now, now);
-      }
-      const id = `po-${randomUUID().slice(0, 8)}`;
-      const info = this.db.prepare(
-        `INSERT INTO board_posts (id, thread_id, author, text, created_at) VALUES (?, ?, ?, ?, ?)`
-      ).run(id, threadId, args.author, text, now);
-      const seq = Number(info.lastInsertRowid);
-      this.db.prepare(`UPDATE board_threads SET last_post_at = ? WHERE id = ?`).run(now, threadId);
-      if (args.notify) {
-        this.subscribe(args.author, { kind: "thread", id: threadId }, seq);
-      }
-      return {
-        post: { id, threadId, author: args.author, text, createdAt: now, seq },
-        threadId
-      };
-    });
-    return run();
-  }
-  readThread(threadId, limit = 50) {
-    const rows = this.db.prepare(
-      `SELECT seq, id, thread_id, author, text, created_at FROM board_posts
-         WHERE thread_id = ? ORDER BY seq ASC LIMIT ?`
-    ).all(threadId, limit);
-    return rows.map(toPost);
-  }
-  readPost(id) {
-    const row = this.db.prepare(`SELECT seq, id, thread_id, author, text, created_at FROM board_posts WHERE id = ?`).get(id);
-    return row ? toPost(row) : void 0;
-  }
-  searchPosts(query, channel, limit = 20) {
-    const like = `%${query}%`;
-    const rows = channel ? this.db.prepare(
-      `SELECT p.seq, p.id, p.thread_id, p.author, p.text, p.created_at
-               FROM board_posts p JOIN board_threads t ON t.id = p.thread_id
-               WHERE t.channel = ? AND p.text LIKE ? ORDER BY p.seq DESC LIMIT ?`
-    ).all(channel, like, limit) : this.db.prepare(
-      `SELECT seq, id, thread_id, author, text, created_at FROM board_posts
-               WHERE text LIKE ? ORDER BY seq DESC LIMIT ?`
-    ).all(like, limit);
-    return rows.map(toPost);
-  }
-  subscribe(agent, target, seenSeq) {
-    const key = targetKey(target);
-    const initial = seenSeq ?? this.maxSeq();
-    this.db.prepare(
-      `INSERT INTO board_subscriptions (agent, target, last_seen_seq) VALUES (?, ?, ?)
-         ON CONFLICT(agent, target) DO UPDATE SET
-           last_seen_seq = MAX(board_subscriptions.last_seen_seq, excluded.last_seen_seq)`
-    ).run(agent, key, initial);
-  }
-  maxSeq() {
-    const row = this.db.prepare(`SELECT COALESCE(MAX(seq), 0) AS n FROM board_posts`).get();
-    return row.n;
-  }
-  unsubscribe(agent, target) {
-    const info = this.db.prepare(`DELETE FROM board_subscriptions WHERE agent = ? AND target = ?`).run(agent, targetKey(target));
-    return info.changes > 0;
-  }
-  pendingFor(agent) {
-    const subs = this.db.prepare(`SELECT target, last_seen_seq FROM board_subscriptions WHERE agent = ?`).all(agent);
-    const out = [];
-    for (const s of subs) {
-      const count = this.countSince(s.target, s.last_seen_seq);
-      if (count > 0) out.push({ target: s.target, count });
-    }
-    return out;
-  }
-  markRead(agent, target) {
-    if (target) {
-      const key = targetKey(target);
-      this.db.prepare(
-        `UPDATE board_subscriptions SET last_seen_seq = (SELECT MAX(seq) FROM board_posts) WHERE agent = ? AND target = ?`
-      ).run(agent, key);
-      return;
-    }
-    this.db.prepare(
-      `UPDATE board_subscriptions SET last_seen_seq = (SELECT COALESCE(MAX(seq), 0) FROM board_posts) WHERE agent = ?`
-    ).run(agent);
-  }
-  countSince(target, sinceSeq) {
-    if (target.startsWith("thread:")) {
-      const id = target.slice("thread:".length);
-      const row2 = this.db.prepare(`SELECT COUNT(*) AS n FROM board_posts WHERE thread_id = ? AND seq > ?`).get(id, sinceSeq);
-      return row2.n;
-    }
-    const name = target.slice("channel:".length);
-    const row = this.db.prepare(
-      `SELECT COUNT(*) AS n FROM board_posts p JOIN board_threads t ON t.id = p.thread_id
-         WHERE t.channel = ? AND p.seq > ?`
-    ).get(name, sinceSeq);
-    return row.n;
-  }
-};
-function clip(text) {
-  if (text.length <= MAX_POST_CHARS) return text;
-  return `${text.slice(0, MAX_POST_CHARS)}
-\u2026 (truncated; the original is ${text.length} characters)`;
-}
-function firstLine(text) {
-  const line = text.split("\n", 1)[0] ?? text;
-  return line.length > 80 ? `${line.slice(0, 80)}\u2026` : line;
-}
-function toChannel(r) {
-  return {
-    id: r.id,
-    name: r.name,
-    ...r.description ? { description: r.description } : {},
-    createdBy: r.created_by,
-    createdAt: r.created_at
-  };
-}
-function toPost(r) {
-  return {
-    seq: r.seq,
-    id: r.id,
-    threadId: r.thread_id,
-    author: r.author,
-    text: r.text,
-    createdAt: r.created_at
-  };
-}
 var PlanModeState = class {
   constructor(permission2) {
     this.permission = permission2;
@@ -17446,15 +18123,15 @@ function toEntry2(m) {
   return {
     id,
     name: String(m.name ?? id),
-    contextLength: num(m.context_length) ?? num(top?.context_length) ?? DEFAULT_CONTEXT_LENGTH2,
-    maxOutputTokens: num(top?.max_completion_tokens) ?? 4096,
+    contextLength: num2(m.context_length) ?? num2(top?.context_length) ?? DEFAULT_CONTEXT_LENGTH2,
+    maxOutputTokens: num2(top?.max_completion_tokens) ?? 4096,
     pricing: m.pricing,
     supportsTools: params.includes("tools"),
     supportsImages: inputs.includes("image"),
     supportsReasoning: params.includes("reasoning")
   };
 }
-function num(v) {
+function num2(v) {
   return typeof v === "number" && Number.isFinite(v) && v > 0 ? v : void 0;
 }
 function pricingFor(modelId, homeDir, at = Date.now()) {
@@ -20782,8 +21459,8 @@ function parseParts(json) {
         ...sessionId ? { sessionId } : {},
         ...title ? { title } : {},
         ...omitted && isSessionOmitReason(omitted) ? { omitted } : {},
-        ...num2(item["messageCount"]) === void 0 ? {} : { messageCount: num2(item["messageCount"]) },
-        ...num2(item["totalMessages"]) === void 0 ? {} : { totalMessages: num2(item["totalMessages"]) }
+        ...num3(item["messageCount"]) === void 0 ? {} : { messageCount: num3(item["messageCount"]) },
+        ...num3(item["totalMessages"]) === void 0 ? {} : { totalMessages: num3(item["totalMessages"]) }
       });
       continue;
     }
@@ -20795,7 +21472,7 @@ function parseParts(json) {
         type: "file",
         path: filePath,
         ...fileOmitted && isFileOmitReason(fileOmitted) ? { omitted: fileOmitted } : {},
-        ...num2(item["bytes"]) === void 0 ? {} : { bytes: num2(item["bytes"]) }
+        ...num3(item["bytes"]) === void 0 ? {} : { bytes: num3(item["bytes"]) }
       });
       continue;
     }
@@ -20813,19 +21490,19 @@ function isFileOmitReason(value) {
 function encodeColumn(value) {
   return value && value.length > 0 ? JSON.stringify(value) : null;
 }
-function num2(v) {
+function num3(v) {
   return typeof v === "number" && Number.isFinite(v) ? v : void 0;
 }
 function parseUsage(raw) {
   if (!isRecord4(raw)) return void 0;
-  const inputTokens = num2(raw["inputTokens"]);
-  const outputTokens = num2(raw["outputTokens"]);
+  const inputTokens = num3(raw["inputTokens"]);
+  const outputTokens = num3(raw["outputTokens"]);
   if (inputTokens === void 0 || outputTokens === void 0) return void 0;
-  const cacheHitTokens = num2(raw["cacheHitTokens"]);
-  const cacheWriteTokens = num2(raw["cacheWriteTokens"]);
-  const reasoningTokens = num2(raw["reasoningTokens"]);
-  const totalTokens2 = num2(raw["totalTokens"]);
-  const costUsd = num2(raw["costUsd"]);
+  const cacheHitTokens = num3(raw["cacheHitTokens"]);
+  const cacheWriteTokens = num3(raw["cacheWriteTokens"]);
+  const reasoningTokens = num3(raw["reasoningTokens"]);
+  const totalTokens2 = num3(raw["totalTokens"]);
+  const costUsd = num3(raw["costUsd"]);
   return {
     inputTokens,
     outputTokens,
@@ -20845,12 +21522,12 @@ function parseTurnFacts(json) {
     return void 0;
   }
   if (!isRecord4(raw)) return void 0;
-  const toolCalls = num2(raw["toolCalls"]);
+  const toolCalls = num3(raw["toolCalls"]);
   if (toolCalls === void 0) return void 0;
   const usage = parseUsage(raw["usage"]);
   const model = str5(raw["model"]);
   const requestedModel = str5(raw["requestedModel"]);
-  const durationMs = num2(raw["durationMs"]);
+  const durationMs = num3(raw["durationMs"]);
   const error = str5(raw["error"])?.trim() || void 0;
   return {
     toolCalls,
@@ -21276,6 +21953,10 @@ var SessionDB = class {
   hasSession(id) {
     return this.db.prepare("SELECT 1 FROM sessions WHERE id = ? LIMIT 1").get(id) !== void 0;
   }
+  subagentTree(fromId, limit = SUBAGENT_TREE_LIMIT) {
+    const tree = sessionSubtree(this.db, { sessionId: fromId, limit });
+    return { ...tree, nodes: tree.nodes.filter((n) => !n.archived) };
+  }
   listSessions(input) {
     const limit = input.limit ?? 20;
     const key = input.sortKey ?? "startedAt";
@@ -21918,15 +22599,18 @@ function listSessionCandidates(db, input) {
   const filter = query ? `AND (s.id LIKE @refLike ESCAPE '\\' OR s.title LIKE @refLike ESCAPE '\\'
             OR COALESCE(s.cwd, '') LIKE @refLike ESCAPE '\\')` : "";
   const affinity = input.workspaceCwd ? "(s.cwd = @refCwd) DESC," : "";
+  const noDelegate = "AND COALESCE(s.source, '') != @delegateSource";
   const rows = db.prepare(
     `
       SELECT s.id, s.title, s.cwd, s.updated_at, s.started_at, s.message_count
         FROM sessions s
-       WHERE s.archived = 0 AND s.id <> @refCurrent AND ${vis.clause} ${filter}
+       WHERE s.archived = 0 AND s.id <> @refCurrent AND ${vis.clause}
+             ${noDelegate} ${filter}
        ORDER BY ${affinity} COALESCE(s.updated_at, s.started_at) DESC
        LIMIT @refLimit`
   ).all({
     ...vis.params,
+    delegateSource: DELEGATE_SESSION_SOURCE,
     refCurrent: input.currentSessionId,
     refLimit: input.limit,
     ...input.workspaceCwd ? { refCwd: input.workspaceCwd } : {},
@@ -21991,8 +22675,13 @@ function uniqueOf(db, where, params, vis) {
   const rows = db.prepare(
     `SELECT s.id FROM sessions s
         WHERE s.archived = 0 AND ${where} AND ${vis.clause}
+              AND COALESCE(s.source, '') != @delegateSource
         LIMIT 2`
-  ).all({ ...vis.params, ...params });
+  ).all({
+    ...vis.params,
+    ...params,
+    delegateSource: DELEGATE_SESSION_SOURCE
+  });
   if (rows.length !== 1) return void 0;
   return { sessionId: rows[0]?.id };
 }
@@ -22170,6 +22859,9 @@ var SessionManager = class {
   has(id) {
     return this.db.hasSession(id);
   }
+  subagentTree(fromId, limit) {
+    return this.db.subagentTree(fromId, limit);
+  }
   getLatest() {
     const result = this.db.listSessions({ limit: 1, sortKey: "updatedAt", direction: "desc" });
     if (result.sessions.length === 0) return void 0;
@@ -28706,21 +29398,19 @@ function hasDedicatedExecContent(inv) {
  *   - 去掉 proper-lockfile 依赖，写入改成「临时文件 + rename」原子替换；
  *   - 读取失败不抛致命错误，而是记进 `loadErrors` 交装配层写进启动诊断。
  *
- * ## 两条**明确不做**（2026-08-08 定，不是待办）
+ * ## 两条**明确不做**（不是待办）
  *
- * 1. **符号链接不做全局归一。** 这里只 `resolve()`，不 `realpathSync()`
- *    （gemini-cli 会）。于是「经软链进入」和「经真实路径进入」是两个目录 ——
- *    但**两侧都 fail closed**（判成 `unknown` → 不加载），是可用性问题不是安全
- *    问题。真会踩到的那种（用户手写 `epoch trust add /tmp/proj`，判定侧拿到的
- *    `process.cwd()` 却是物理路径）已经在 CLI 层用 `physicalPath()` 堵掉了；
- *    剩下的缺口只有「SDK 调用方给 `buildRuntime({ workDir })` 传逻辑路径」。
- *    为这一种在判定热路径上加系统调用不划算。
- * 2. **信任按路径存，不认仓库身份。** `trust add --tree ~/code` 之后，以后
- *    clone 进 `~/code` 的任何仓库都直接可信；删掉再在同一路径 clone 另一个也继承。
- *    gemini-cli 同样如此。能做的方向是记下 git remote 或首次信任时指令文件的
- *    内容 hash，变了就重新问 —— 代价是「改一行 AGENTS.md 就被打断一次」，
- *    这个打断比它挡住的风险更贵。代价写在根 README 的「工作区信任」一节和
- *    `--tree` 的命令帮助里，让用户自己知道 `--tree` 意味着什么。
+ * 1. **符号链接不做全局归一。** 这里只 `resolve()`，不 `realpathSync()`，于是「经软链
+ *    进入」和「经真实路径进入」是两个目录 —— 但**两侧都 fail closed**（判成 `unknown`
+ *    → 不加载），是可用性问题不是安全问题。真会踩到的那种（CLI 手写 `epoch trust add
+ *    /tmp/proj`，判定侧拿到的 `process.cwd()` 却是物理路径）已在 CLI 层用
+ *    `physicalPath()` 堵掉；剩下的缺口只有「SDK 调用方给 `buildRuntime({ workDir })`
+ *    传逻辑路径」，为这一种在判定热路径上加系统调用不划算。
+ * 2. **信任按路径存，不认仓库身份。** `trust add --tree ~/code` 之后，以后 clone 进
+ *    `~/code` 的任何仓库都直接可信；删掉再在同一路径 clone 另一个也继承。能做的方向
+ *    是记下 git remote 或首次信任时指令文件的内容 hash，变了就重新问 —— 代价是「改一行
+ *    AGENTS.md 就被打断一次」，这个打断比它挡住的风险更贵。代价写在根 README 的
+ *    「工作区信任」一节和 `--tree` 的命令帮助里，让用户自己知道 `--tree` 意味着什么。
  */
 
-export { ABOUT_DESC_MAX_CHARS, ABOUT_README_MAX_CHARS, AGENT_ROLE_DIAG_MODULE, ARTIFACT_MAX_TOTAL_BYTES, ARTIFACT_RETENTION_DEFAULTS, ATTACHMENT_MAX_TOTAL_BYTES, ATTACHMENT_RETENTION_DEFAULTS, AgentInbox, AgentLoop, AppearanceStore, ApprovalCache, BLOCKED_TOOLS, BOARD_TOOL_NAMES, BoardStore, BudgetGuard, BudgetStore, CHECKPOINT_MAX_TOTAL_BYTES, CLAUDE_EVENT_NAMES, CLAUDE_TOOL_NAMES, CODE_MODE_LIMITS, CODE_MODE_SDK_TAG, CONFIG_KEYS, CURRENT_CONFIG_VERSION, CheckpointManager, CheckpointStore, CodeSandbox, ComplianceEngine, ContextCompressor, DEFAULT_COMPLIANCE_ACTIONS, DEFAULT_COMPLIANCE_SETTINGS, DEFAULT_COMPRESSION_THRESHOLD, DEFAULT_GOAL_MAX_ROUNDS, DEFAULT_INBOX_CAPACITY, DEFAULT_MAX_HOLD_CHARS, DEFAULT_MAX_RUNNING_MEMBERS, DEFAULT_MAX_WOKEN_SESSIONS, DELEGATE_SESSION_SOURCE, DelegateManager, EMPTY_RULES, EPOCH_DISK_LEDGER, EpochConfigSchema, FTS_TABLES, FTS_TRIGGERS, GOAL_BLOCK_CODES, GoalService, GoalStore, HEADLESS_AUDIT_CODES, HookManager, INSTRUCTION_BUDGET_CHARS, INSTRUCTION_FILES, ImageLoadError, ImportTrustStore, LAUNCHD_LABEL_PREFIX, LOCK_HEARTBEAT_MS, LOCK_STALE_MS, LastOpenSessions, MARKETPLACE_DISPLAY_FIELDS, MARKETPLACE_FILE, MAX_AUDIT_ENTRIES, MAX_COMMAND_DEPTH, MAX_GOAL_MAX_ROUNDS, MAX_IMPORT_DEPTH, MAX_LAST_OPEN_SESSIONS, MAX_OBJECTIVE_CHARS, MAX_POST_CHARS, MAX_REASON_CHARS, MAX_RECENT_WORKSPACES, MODEL_ENTRIES_FILE, MODEL_GIVE_UP_THRESHOLD, MULTIMODAL_DEFAULTS, ManagedPolicyError, ManagedSettingsSchema, MemoryManager, ModelFailureTracker, NOMINAL_TOTAL_BYTES, NO_REVEALED_TOOLS, PACK_EXCLUDES, PERMISSION_AUDIT_CODES, PLUGIN_ICON_MAX_BYTES, PLUGIN_LAYOUT, PLUGIN_MANIFEST_FILE, PLUGIN_MANIFEST_KEYS, PLUGIN_NAME_PATTERN, PLUGIN_ROOT_ENV, PLUGIN_ROOT_TOKEN, PLUGIN_VISIBILITY, POLICY_DECISIONS, PROBE_VERSION, PROJECT_AGENTS_SUBDIR, PROVIDER_NO_CREDENTIAL, PermissionManager, PlanModeState, PluginAuthorSchema, PluginStore, PolicyRuleSchema, ProviderError, ProviderRouter, RECORDING_KEEP_RUNS, RECORDING_MAX_BYTES, ROLE_FRONTMATTER_SCHEMA, RUN_CODE_TOOL, RecentWorkspaces, SANDBOX_COVERS, SANDBOX_EXCLUDES, SCALAR_KEYS, SCHEDULE_DEFAULTS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_ISSUE_CODES, SCHTASKS_FOLDER, SEND_MESSAGE_TOOL, SESSION_MESSAGES_READ_TOOL, SESSION_MESSAGES_SEARCH_TOOL, SESSION_QUERY_TOOLS, SESSION_SEARCH_TOOL, SESSION_TRACE_TOOL, SETTINGS_LAYER_ORDER, SETTING_WRITE_KEYS, SETTING_WRITE_LAYERS, SKILL_ASSET_DIRS, SKILL_CREATE_TOOL, SKILL_EDIT_TOOL, SKILL_FILE, SKILL_PATCH_TOOL, SKILL_VIEW_TOOL, SKILL_WRITE_FILE_TOOL, SLASH_COMMANDS_DIAG_MODULE, ScheduleRecorder, ScheduleRegistrar, ScheduleStore, SessionManager, SessionQueries, SessionReferences, SettingsFileError, SettingsFileSchema, SkillLearner, SkillSystem, TEAM_TOOL_NAMES, TOOL_SEARCH_TOOL, TaskNoticeTracker, TeamRegistry, ToolRegistry, TrackerDB, TrustManager, UNSETTABLE_USER_KEYS, Workspace, acquireScheduleLock, addMarketplace, addUsage, admitArtifact, admitArtifacts, affectedPaths, approvalEntryFor, approvalRootFor, artifactLaunchArgv, artifactOpenRefusal, assertLevelAllowed, blockedRoleTools, buildContextBreakdown, buildFireArgv, buildFtsMatchQuery, buildSchemaExports, buildSystemPrompt, buildTrigramMatchQuery, capabilityOfRef, checkConfigValue, checkEpochVersion, checkFtsHealth, checkShadowing, classifyPersistFailure, classifyProviderError, clearModelCache, coalesceRecording, codeModeWorkerPath, commandNameFromRelPath, compileRuleLists, compressionOptions, computeCost, computeCostMicros, computeExecHash, configKeyByPath, configKeyTable, countRules, createAllowAllGate, createAllowAllImportGate, createAskQuestionTool, createBoardTools, createCodeExecTool, createDelegateTool, createDenyAllGate, createDenyAllImportGate, createGoalTool, createImportGate, createMemoryTool, createPlanModeTools, createPluginScope, createRoleFile, createRoleScope, createRunCodeTool, createScheduleDraftTool, createSendMessageTool, createSessionMessagesReadTool, createSessionMessagesSearchTool, createSessionSearchTool, createSessionSearchTools, createSessionTraceTool, createSkillViewTool, createSkillWriteTools, createTeamTools, createTodoTool, createToolRevealState, createToolScope, createToolSearchTool, createTrustGate, currentEpochVersion, decideImport, decideTrust, defaultConfig, describeArtifactRefusal, describeBackgroundTask, describeHeadlessPolicy, describeIsolation, describeJsonError, diagnoseSchedules, discoverMarkdown, discoverModels, discoverProject, discoverySpec, displayAllows, displayCurrency, draftCommandLine, draftWidening, escapeRuleContent, estimateImageTokens, estimateRunTokens, estimateTokens, evaluateSelection, expandCommand, expandImports, explainSetting, extractArchive, findInstructionFiles, findProjectInstructions, findRole, formatBytes, formatSkillIndex, formatUsd, gateForTool, getCapability, getConfigIssues, getConfigOrigins, getImportGate, getTrustGate, grantedPathsFor, hasDedicatedExecContent, hasExecTierContent, hasPromptCaching, hasProviderCredentials, hasReadTierContent, hasUsableModel, imageFromBase64, imageFromPath, imagePartTokens, importParts, importSkills, installPlugin, instructionDirs, instructionNotices, intervalSlots, inventoryProjectExtensions, inventoryTotal, isBlockCode, isCodeModeDeferred, isEmptyRules, isGoalPhase, isNonInteractive, isReadOnlySubCall, isSettingWriteLayer, isTransientPersistFailure, isValidInterval, isValidPluginName, isWithinWindow, isWritableSettingKey, labelSlug, layerRank, listEntryModels, listRunningSchedules, listSessionCandidates, listWorkspaceFiles, loadCommandDefinitions, loadCommandFile, loadCommands, loadConfig, loadHookSources, loadKeybindings, loadLexiconDir, loadLexiconFiles, loadModelEntries, loadPlugins, loadPolicyFiles, loadPolicyRules, loadRoleDefinitions, loadRoleDir, loadedImports, localDateString, managedSwitchNotes, mapClaudeToolName, mapEpochToolName, mapOperationType, matchPreauthorization, matchRuleLists, matchesHook, mentionsPluginRoot, mergeHeadlessPolicy, mergeRoles, mergeSchedulePatch, microsToUsd, modelEntriesPath, modelListCandidates, needsAllowlist, nextRunAt, noConfigOrigins, noManagedPolicy, noPlugins, normalizeModelEntry, normalizeTrigger, offloadOldestImages, openArtifact, originOf, packFileName, packPlugin, parseClaudeSettingsHooks, parseClock, parseDate, parseFrontmatter, parseHooksConfig, parseHooksConfigVerbose, parseImportLine, parseModelEntry, parseModelList, parseRoleDefinition, parseScheduleDraft, parseSkillFrontmatter, parseTrigger, pendingImageTokens, persistFailureCode, persistParts, persistToolResults, persistedUsage, planPack, previewSkillImport, pricingFor, projectEntryForDisplay, pruneArtifacts, pruneAttachments, pruneRecordings, pruneSchedules, readCancelRequest, readEntryKey, readImageSize, readMarketplaces, readPluginAbout, readPluginIcon, readPluginManifest, readPluginRecords, readRecording, readSessionSurface, reclaimFtsSpace, redactLine, refreshOpenRouterMetadata, removeMarketplace, removeRecordings, removeRoleFile, removeSessionArtifacts, removeSessionAttachments, renderImportTree, renderProjectContext, renderSdkDeclaration, renderSelfIndex, repairSchedules, requestImageBytes, requestScheduleCancel, resolveArtifactRetention, resolveCodeModeWorker, resolveComplianceDirs, resolveEntrySource, resolveInWorkspace, resolveMarketplaceRef, resolveMentions, resolveMultimodalPolicy, resolvePolicyDirs, resolvePricingAt, resolveProjectRoot, resolveScheduleBackend, resolveSessionReference, resolveSessionVisibility, resolveSettings, resolveSkillDirs, resolveSource, resolveTar, resolveWorkspace, restoreParts, revealScopedProvider, roleScopedProvider, roleSourceLabel, ruleCovers, ruleFromString, ruleToString, runCode, runCommand2 as runCommand, sanitizeArgNames, sanitizeCommand, sanitizeFtsQuery, sanitizePath, sanitizeToolOutput, saveModelEntries, scanInstructions, scanPluginDir, scanSkillDirs, searchMarketplaces, setDisplayCurrency, setImportGate, setPluginEnabled, setTrustGate, settingValueChoices, settingValueKind, settingWriteApply, settingWriteLayers, settingWriteTargets, skillIndexDescription, skillIndexResidency, skillIndexStats, sniffMediaType, splitFrontmatter, staticToolProvider, stripArtifactData, substitutePluginRoot, suggestRuleFromApproval, systemOpenArgv, systemPromptSegments, testModelEntry, toPosix, toolDefinitionTokens, toolMatches, toolTableTokens, totalTokens, traceSession, triggerPeriodMs, unescapeRuleContent, uninstallPlugin, unknownRoleSkills, unknownRoleTools, unloadedInstructionFiles, unsetUserSetting, updateMarketplace, updatePlugin, usdToMicros, validateSchedule, validateTrigger, validateWindow, withGoalCompression, withGoalPrompt, workspaceDisplayPath, writableConfigKeys, writeSettingValue };
+export { ABOUT_DESC_MAX_CHARS, ABOUT_README_MAX_CHARS, AGENT_ROLE_DIAG_MODULE, ARTIFACT_MAX_TOTAL_BYTES, ARTIFACT_RETENTION_DEFAULTS, ATTACHMENT_MAX_TOTAL_BYTES, ATTACHMENT_RETENTION_DEFAULTS, AgentInbox, AgentLoop, AppearanceStore, ApprovalCache, BLOCKED_TOOLS, BOARD_TOOL_NAMES, BoardStore, BudgetGuard, BudgetStore, CHECKPOINT_MAX_TOTAL_BYTES, CLAUDE_EVENT_NAMES, CLAUDE_TOOL_NAMES, CLOSED_TOMBSTONE_LIMIT, CODE_MODE_LIMITS, CODE_MODE_SDK_TAG, CONFIG_KEYS, CURRENT_CONFIG_VERSION, CheckpointManager, CheckpointStore, CodeSandbox, ComplianceEngine, ContextCompressor, DEFAULT_COMPLIANCE_ACTIONS, DEFAULT_COMPLIANCE_SETTINGS, DEFAULT_COMPRESSION_THRESHOLD, DEFAULT_GOAL_MAX_ROUNDS, DEFAULT_INBOX_CAPACITY, DEFAULT_MAX_HOLD_CHARS, DEFAULT_MAX_RUNNING_MEMBERS, DEFAULT_MAX_WOKEN_SESSIONS, DELEGATE_SESSION_SOURCE, DelegateManager, EMPTY_RULES, EPOCH_DISK_LEDGER, EpochConfigSchema, FTS_TABLES, FTS_TRIGGERS, GOAL_BLOCK_CODES, GoalService, GoalStore, HEADLESS_AUDIT_CODES, HookManager, INSTRUCTION_BUDGET_CHARS, INSTRUCTION_FILES, ImageLoadError, ImportTrustStore, LAUNCHD_LABEL_PREFIX, LOCK_HEARTBEAT_MS, LOCK_STALE_MS, LastOpenSessions, MARKETPLACE_DISPLAY_FIELDS, MARKETPLACE_FILE, MAX_AUDIT_ENTRIES, MAX_COMMAND_DEPTH, MAX_GOAL_MAX_ROUNDS, MAX_IMPORT_DEPTH, MAX_LAST_OPEN_SESSIONS, MAX_OBJECTIVE_CHARS, MAX_POST_CHARS, MAX_REASON_CHARS, MAX_RECENT_WORKSPACES, MODEL_ENTRIES_FILE, MODEL_GIVE_UP_THRESHOLD, MULTIMODAL_DEFAULTS, ManagedPolicyError, ManagedSettingsSchema, MemoryManager, ModelFailureTracker, NOMINAL_TOTAL_BYTES, NO_REVEALED_TOOLS, PACK_EXCLUDES, PERMISSION_AUDIT_CODES, PLUGIN_ICON_MAX_BYTES, PLUGIN_LAYOUT, PLUGIN_MANIFEST_FILE, PLUGIN_MANIFEST_KEYS, PLUGIN_NAME_PATTERN, PLUGIN_ROOT_ENV, PLUGIN_ROOT_TOKEN, PLUGIN_VISIBILITY, POLICY_DECISIONS, PROBE_VERSION, PROJECT_AGENTS_SUBDIR, PROVIDER_NO_CREDENTIAL, PermissionManager, PlanModeState, PluginAuthorSchema, PluginStore, PolicyRuleSchema, ProviderError, ProviderRouter, RECORDING_KEEP_RUNS, RECORDING_MAX_BYTES, ROLE_FRONTMATTER_SCHEMA, RUN_CODE_TOOL, RecentWorkspaces, SANDBOX_COVERS, SANDBOX_EXCLUDES, SCALAR_KEYS, SCHEDULE_DEFAULTS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_ISSUE_CODES, SCHTASKS_FOLDER, SEND_MESSAGE_TOOL, SESSION_MESSAGES_READ_TOOL, SESSION_MESSAGES_SEARCH_TOOL, SESSION_QUERY_TOOLS, SESSION_SEARCH_TOOL, SESSION_TRACE_TOOL, SETTINGS_LAYER_ORDER, SETTING_WRITE_KEYS, SETTING_WRITE_LAYERS, SKILL_ASSET_DIRS, SKILL_CREATE_TOOL, SKILL_EDIT_TOOL, SKILL_FILE, SKILL_PATCH_TOOL, SKILL_VIEW_TOOL, SKILL_WRITE_FILE_TOOL, SLASH_COMMANDS_DIAG_MODULE, SUBAGENT_TREE_LIMIT, ScheduleRecorder, ScheduleRegistrar, ScheduleStore, SessionManager, SessionQueries, SessionReferences, SettingsFileError, SettingsFileSchema, SkillLearner, SkillSystem, TEAM_TOOL_NAMES, TOOL_SEARCH_TOOL, TaskNoticeTracker, TeamRegistry, ToolRegistry, TrackerDB, TrustManager, UNSETTABLE_USER_KEYS, Workspace, acquireScheduleLock, addMarketplace, addUsage, admitArtifact, admitArtifacts, affectedPaths, approvalEntryFor, approvalRootFor, artifactLaunchArgv, artifactOpenRefusal, assertLevelAllowed, blockedRoleTools, buildContextBreakdown, buildFireArgv, buildFtsMatchQuery, buildSchemaExports, buildSystemPrompt, buildTrigramMatchQuery, capabilityOfRef, checkConfigValue, checkEpochVersion, checkFtsHealth, checkShadowing, classifyPersistFailure, classifyProviderError, clearModelCache, coalesceRecording, codeModeWorkerPath, commandNameFromRelPath, compileRuleLists, compressionOptions, computeCost, computeCostMicros, computeExecHash, configKeyByPath, configKeyTable, countRules, createAllowAllGate, createAllowAllImportGate, createAskQuestionTool, createBoardTools, createCodeExecTool, createDelegateTool, createDenyAllGate, createDenyAllImportGate, createGoalTool, createImportGate, createMemoryTool, createPlanModeTools, createPluginScope, createRoleFile, createRoleScope, createRunCodeTool, createScheduleDraftTool, createSendMessageTool, createSessionMessagesReadTool, createSessionMessagesSearchTool, createSessionSearchTool, createSessionSearchTools, createSessionTraceTool, createSkillViewTool, createSkillWriteTools, createTeamTools, createTodoTool, createToolRevealState, createToolScope, createToolSearchTool, createTrustGate, currentEpochVersion, decideImport, decideTrust, defaultConfig, describeArtifactRefusal, describeBackgroundTask, describeHeadlessPolicy, describeIsolation, describeJsonError, diagnoseSchedules, discoverMarkdown, discoverModels, discoverProject, discoverySpec, displayAllows, displayCurrency, draftCommandLine, draftWidening, escapeRuleContent, estimateImageTokens, estimateRunTokens, estimateTokens, evaluateSelection, expandCommand, expandImports, explainSetting, extractArchive, findInstructionFiles, findProjectInstructions, findRole, formatBytes, formatSkillIndex, formatUsd, gateForTool, getCapability, getConfigIssues, getConfigOrigins, getImportGate, getTrustGate, grantedPathsFor, hasDedicatedExecContent, hasExecTierContent, hasPromptCaching, hasProviderCredentials, hasReadTierContent, hasUsableModel, imageFromBase64, imageFromPath, imagePartTokens, importParts, importSkills, installPlugin, instructionDirs, instructionNotices, intervalSlots, inventoryProjectExtensions, inventoryTotal, isBlockCode, isCodeModeDeferred, isEmptyRules, isGoalPhase, isNonInteractive, isReadOnlySubCall, isSettingWriteLayer, isTransientPersistFailure, isValidInterval, isValidPluginName, isWithinWindow, isWritableSettingKey, labelSlug, layerRank, listEntryModels, listRunningSchedules, listSessionCandidates, listWorkspaceFiles, loadCommandDefinitions, loadCommandFile, loadCommands, loadConfig, loadHookSources, loadKeybindings, loadLexiconDir, loadLexiconFiles, loadModelEntries, loadPlugins, loadPolicyFiles, loadPolicyRules, loadRoleDefinitions, loadRoleDir, loadedImports, localDateString, managedSwitchNotes, mapClaudeToolName, mapEpochToolName, mapOperationType, matchPreauthorization, matchRuleLists, matchesHook, mentionsPluginRoot, mergeHeadlessPolicy, mergeRoles, mergeSchedulePatch, microsToUsd, modelEntriesPath, modelListCandidates, needsAllowlist, nextRunAt, noConfigOrigins, noManagedPolicy, noPlugins, normalizeModelEntry, normalizeTrigger, offloadOldestImages, openArtifact, originOf, packFileName, packPlugin, parseClaudeSettingsHooks, parseClock, parseDate, parseFrontmatter, parseHooksConfig, parseHooksConfigVerbose, parseImportLine, parseModelEntry, parseModelList, parseRoleDefinition, parseScheduleDraft, parseSkillFrontmatter, parseTrigger, pendingImageTokens, persistFailureCode, persistParts, persistToolResults, persistedUsage, planPack, previewSkillImport, pricingFor, projectEntryForDisplay, pruneArtifacts, pruneAttachments, pruneRecordings, pruneSchedules, readCancelRequest, readEntryKey, readImageSize, readMarketplaces, readPluginAbout, readPluginIcon, readPluginManifest, readPluginRecords, readRecording, readSessionSurface, reclaimFtsSpace, redactLine, refreshOpenRouterMetadata, removeMarketplace, removeRecordings, removeRoleFile, removeSessionArtifacts, removeSessionAttachments, renderImportTree, renderProjectContext, renderSdkDeclaration, renderSelfIndex, repairSchedules, requestImageBytes, requestScheduleCancel, resolveArtifactRetention, resolveCodeModeWorker, resolveComplianceDirs, resolveEntrySource, resolveInWorkspace, resolveMarketplaceRef, resolveMentions, resolveMultimodalPolicy, resolvePolicyDirs, resolvePricingAt, resolveProjectRoot, resolveScheduleBackend, resolveSessionReference, resolveSessionVisibility, resolveSettings, resolveSkillDirs, resolveSource, resolveTar, resolveWorkspace, restoreParts, revealScopedProvider, roleScopedProvider, roleSourceLabel, ruleCovers, ruleFromString, ruleToString, runCode, runCommand2 as runCommand, sanitizeArgNames, sanitizeCommand, sanitizeFtsQuery, sanitizePath, sanitizeToolOutput, saveModelEntries, scanInstructions, scanPluginDir, scanSkillDirs, searchMarketplaces, sessionSubtree, setDisplayCurrency, setImportGate, setPluginEnabled, setTrustGate, settingValueChoices, settingValueKind, settingWriteApply, settingWriteLayers, settingWriteTargets, skillIndexDescription, skillIndexResidency, skillIndexStats, sniffMediaType, splitFrontmatter, staticToolProvider, stripArtifactData, substitutePluginRoot, suggestRuleFromApproval, systemOpenArgv, systemPromptSegments, testModelEntry, toPosix, toolDefinitionTokens, toolMatches, toolTableTokens, totalTokens, traceSession, triggerPeriodMs, unescapeRuleContent, uninstallPlugin, unknownRoleSkills, unknownRoleTools, unloadedInstructionFiles, unsetUserSetting, updateMarketplace, updatePlugin, usdToMicros, validateSchedule, validateTrigger, validateWindow, walkAncestors, walkDescendants, withGoalCompression, withGoalPrompt, workspaceDisplayPath, writableConfigKeys, writeSettingValue };