svamp-cli 0.2.86 → 0.2.89

package/dist/{run-rWXfNd7e.mjs → run-C4i9N-F6.mjs}

@@ -1,7 +1,7 @@
 import{createRequire as _pkgrollCR}from"node:module";const require=_pkgrollCR(import.meta.url);import os, { homedir as homedir$1 } from 'os';
 import fs, { mkdir as mkdir$1, readdir as readdir$1, readFile, writeFile as writeFile$1, rename, unlink } from 'fs/promises';
-import { readFileSync as readFileSync$1, mkdirSync, writeFileSync, renameSync, existsSync as existsSync$1, rmSync as rmSync$1, copyFileSync, unlinkSync as unlinkSync$1, watch, rmdirSync, readdirSync as readdirSync$1 } from 'fs';
-import path__default, { join, dirname, resolve, basename } from 'path';
+import { readFileSync as readFileSync$1, mkdirSync, writeFileSync, renameSync, existsSync as existsSync$1, rmSync as rmSync$1, unlinkSync as unlinkSync$1, copyFileSync, watch, rmdirSync, readdirSync as readdirSync$1 } from 'fs';
+import path__default, { join, dirname, basename, resolve } from 'path';
 import { fileURLToPath } from 'url';
 import { execFile, spawn as spawn$1, execSync as execSync$1 } from 'child_process';
 import { randomUUID as randomUUID$1 } from 'crypto';
@@ -10,6 +10,7 @@ import { promisify } from 'util';
 import { randomBytes, randomUUID, createHash } from 'node:crypto';
 import { join as join$1 } from 'node:path';
 import os$1, { homedir, platform } from 'node:os';
+import vm from 'node:vm';
 import { spawn, execSync, execFile as execFile$1, execFileSync } from 'node:child_process';
 import { ndJsonStream, ClientSideConnection } from '@agentclientprotocol/sdk';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
@@ -1393,7 +1394,7 @@ async function registerMachineService(server, machineId, metadata, daemonState,
         const tunnels = handlers.tunnels;
         if (!tunnels) throw new Error("Tunnel management not available");
         if (tunnels.has(params.name)) throw new Error(`Tunnel '${params.name}' already running`);
-        const { FrpcTunnel } = await import('./frpc-BfBqHN33.mjs');
+        const { FrpcTunnel } = await import('./frpc-BiazjxzU.mjs');
         const tunnel = new FrpcTunnel({
           name: params.name,
           ports: params.ports,
@@ -1577,6 +1578,52 @@ async function registerMachineService(server, machineId, metadata, daemonState,
     { overwrite: true }
   );
   console.log(`[HYPHA MACHINE] Machine service registered: ${serviceInfo.id}`);
+  const findChannelOwner = async (channelId) => {
+    for (const sid of handlers.getSessionIds?.() || []) {
+      const rpc = handlers.getSessionRPCHandlers?.(sid);
+      if (!rpc?.channelList) continue;
+      try {
+        const r = await rpc.channelList();
+        if ((r?.channels || []).some((c) => c.id === channelId)) return rpc;
+      } catch {
+      }
+    }
+    return void 0;
+  };
+  const channelsServiceInfo = await server.registerService(
+    {
+      id: "channels",
+      name: `Svamp Channels (${currentMetadata.displayName || machineId})`,
+      type: "svamp-channels",
+      config: { visibility: "public", require_context: true },
+      list: async () => {
+        const out = [];
+        for (const sid of handlers.getSessionIds?.() || []) {
+          const rpc = handlers.getSessionRPCHandlers?.(sid);
+          if (!rpc?.channelList) continue;
+          try {
+            const r = await rpc.channelList();
+            for (const c of r?.channels || []) out.push({ ...c, session: sid });
+          } catch {
+          }
+        }
+        return out;
+      },
+      describe: async (kwargs = {}) => {
+        const rpc = await findChannelOwner(kwargs.channel);
+        if (!rpc?.channelDescribe) return { error: "channel not found" };
+        return rpc.channelDescribe(kwargs.channel);
+      },
+      send: async (kwargs = {}, context) => {
+        trackInbound();
+        const rpc = await findChannelOwner(kwargs.channel);
+        if (!rpc?.channelSend) return { error: "channel not found" };
+        return rpc.channelSend({ channel: kwargs.channel, message: kwargs.message, from: kwargs.from, key: kwargs.key }, context);
+      }
+    },
+    { overwrite: true }
+  );
+  console.log(`[HYPHA MACHINE] Channels service registered: ${channelsServiceInfo.id} (type svamp-channels)`);
   return {
     serviceInfo,
     notifySessionEvent: notifyListeners,
@@ -1605,6 +1652,8 @@ async function registerMachineService(server, machineId, metadata, daemonState,
         removeListener(listener, "disconnect");
       }
       await server.unregisterService(serviceInfo.id);
+      await server.unregisterService(channelsServiceInfo.id).catch(() => {
+      });
     }
   };
 }
@@ -1646,13 +1695,33 @@ function cronMatches(expr, date) {
   if (c.domRestricted && c.dowRestricted) return domOk || dowOk;
   return domOk && dowOk;
 }
-function nextFire(expr, from) {
+function inZone(date, tz) {
+  if (!tz) return date;
+  try {
+    const p = new Intl.DateTimeFormat("en-US", {
+      timeZone: tz,
+      hour12: false,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit"
+    }).formatToParts(date).reduce((o, x) => {
+      o[x.type] = x.value;
+      return o;
+    }, {});
+    return new Date(+p.year, +p.month - 1, +p.day, +(p.hour === "24" ? 0 : p.hour), +p.minute);
+  } catch {
+    return date;
+  }
+}
+function nextFire(expr, from, tz) {
   const c = parseCron(expr);
   const d = new Date(from.getTime());
   d.setSeconds(0, 0);
   d.setMinutes(d.getMinutes() + 1);
   for (let i = 0; i < 366 * 24 * 60; i++) {
-    if (cronMatches(c, d)) return new Date(d.getTime());
+    if (cronMatches(c, tz ? inZone(d, tz) : d)) return new Date(d.getTime());
     d.setMinutes(d.getMinutes() + 1);
   }
   return null;
@@ -1689,14 +1758,16 @@ function validateRoutine(r) {
   if (a?.kind === "message" && !a.template) errs.push("action.template required for message action");
   if (a?.kind === "loop" && !a.loop && !a.task_template) errs.push("action.loop or action.task_template required for loop action");
   if (r.overlap && !OVERLAP.includes(r.overlap)) errs.push(`overlap must be one of ${OVERLAP.join("|")}`);
+  if ((t?.type === "webhook" || t?.type === "api") && t.public && a?.kind === "loop")
+    errs.push("a public webhook/api may not use a loop action (unauthenticated task injection) \u2014 use a message action or require a key");
   return errs;
 }
 
 function defaultRoutinesDir() {
   return process.env.SVAMP_ROUTINES_DIR || join$1(homedir(), ".svamp", "routines");
 }
-const genId = () => "rt_" + randomBytes(5).toString("hex");
-const genKey = () => randomBytes(18).toString("base64url");
+const genId$1 = () => "rt_" + randomBytes(5).toString("hex");
+const genKey$1 = () => randomBytes(18).toString("base64url");
 class RoutineStore {
   dir;
   constructor(dir = defaultRoutinesDir()) {
@@ -1725,8 +1796,8 @@ class RoutineStore {
   }
   save(routine) {
     const r = { overlap: "queue", enabled: true, last_runs: [], ...routine };
-    if (!r.id) r.id = genId();
-    if ((r.trigger?.type === "webhook" || r.trigger?.type === "api") && !r.trigger.key) r.trigger.key = genKey();
+    if (!r.id) r.id = genId$1();
+    if ((r.trigger?.type === "webhook" || r.trigger?.type === "api") && !r.trigger.key) r.trigger.key = genKey$1();
     const errs = validateRoutine(r);
     if (errs.length) throw new Error("invalid routine: " + errs.join("; "));
     const tmp = this._path(r.id) + ".tmp";
@@ -1783,13 +1854,23 @@ class RoutineRunner {
   markDone(id) {
     this.active.delete(id);
   }
+  // Deliveries counted today via a dedicated counter (NOT derived from the
+  // capped last_runs audit, which would undercount past 20 runs/day).
   _deliveredToday(routine) {
     const today = this.now().toDateString();
-    return (routine.last_runs || []).filter((r) => r.outcome === "delivered" && new Date(r.firedAt).toDateString() === today).length;
+    return routine.daily && routine.daily.date === today ? routine.daily.n : 0;
   }
+  // `active` guards genuinely CONCURRENT in-flight deliveries only — the runner
+  // cannot observe a spawned loop's full duration (fire-and-forget), so it is
+  // cleared once delivery returns. `replace` calls onReplace (best-effort) then proceeds.
   async fire(routine, payload = {}, via = "manual") {
     if (!routine.enabled) return { skipped: "disabled" };
-    if (routine.daily_cap && this._deliveredToday(this.store.get(routine.id) || routine) >= routine.daily_cap) {
+    if (routine.action?.kind === "loop" && (routine.trigger?.type === "webhook" || routine.trigger?.type === "api") && routine.trigger?.public)
+      return { skipped: "forbidden (public webhook + loop)" };
+    const today = this.now().toDateString();
+    const r0 = this.store.get(routine.id) || routine;
+    const usedToday = r0.daily && r0.daily.date === today ? r0.daily.n : 0;
+    if (routine.daily_cap && usedToday >= routine.daily_cap) {
       this.store.recordRun(routine.id, { via, delivered: routine.action.kind, outcome: "skipped (daily cap)" });
       return { skipped: "daily_cap" };
     }
@@ -1803,16 +1884,28 @@ class RoutineRunner {
           this.onReplace?.(routine.id);
         } catch {
         }
-        this.active.delete(routine.id);
       }
     }
+    this.active.add(routine.id);
+    if (routine.daily_cap) {
+      r0.daily = { date: today, n: usedToday + 1 };
+      this.store.save(r0);
+    }
     const resolved = this.resolveAction(routine, payload);
     let outcome = "delivered";
     try {
       await this.deliver({ routine, action: routine.action, resolved, payload, via });
-      if (resolved.kind === "loop") this.active.add(routine.id);
     } catch (e) {
       outcome = "error: " + (e?.message || e);
+      if (routine.daily_cap) {
+        const rb = this.store.get(routine.id);
+        if (rb?.daily?.date === today && rb.daily.n > 0) {
+          rb.daily.n -= 1;
+          this.store.save(rb);
+        }
+      }
+    } finally {
+      this.active.delete(routine.id);
     }
     const r = this.store.get(routine.id) || routine;
     r.last_fired_at = this.now().toISOString();
@@ -1824,7 +1917,7 @@ class RoutineRunner {
     const results = [];
     for (const r of this.store.list()) {
       if (!r.enabled || r.trigger?.type !== "schedule") continue;
-      if (!cronMatches(r.trigger.cron, date)) continue;
+      if (!cronMatches(r.trigger.cron, inZone(date, r.trigger.tz))) continue;
       const mk = minuteKey(date);
       if (this._firedMinute.get(r.id) === mk) continue;
       this._firedMinute.set(r.id, mk);
@@ -1855,7 +1948,7 @@ class RoutineRunner {
       if (!r.enabled || r.trigger?.type !== "schedule" || r.trigger.missed !== "catchup") continue;
       const deadlineMs = (r.trigger.deadline_sec || 3600) * 1e3;
       const since = new Date(Math.max(sinceDate.getTime(), nowDate.getTime() - deadlineMs));
-      const due = nextFire(r.trigger.cron, since);
+      const due = nextFire(r.trigger.cron, since, r.trigger.tz);
       if (due && due <= nowDate) {
         const last = r.last_fired_at ? new Date(r.last_fired_at) : /* @__PURE__ */ new Date(0);
         if (last < due) results.push({ id: r.id, ...await this.fire(r, { catchup: due.toISOString() }, "schedule") });
@@ -1865,6 +1958,622 @@ class RoutineRunner {
   }
 }
 
+const genId = () => "c_" + randomBytes(5).toString("hex");
+const genKey = () => "ck_" + randomBytes(18).toString("base64url");
+const DEFAULT_TEMPLATE = `<inbound-message from="\${sender.name}" sender-type="\${sender.kind}" verified="\${sender.verified}" channel="\${channel.name}" call-id="\${call.id}" at="\${now}">
+\${body.message}
+</inbound-message>`;
+function validateChannel(c) {
+  const errs = [];
+  if (!c || typeof c !== "object") return ["channel must be an object"];
+  if (!c.name) errs.push("name required");
+  const m = c.identity?.mode;
+  if (!["per-key", "caller-supplied", "fixed"].includes(m)) errs.push("identity.mode must be per-key|caller-supplied|fixed");
+  if (m === "fixed" && !c.identity.fixed?.name) errs.push("identity.fixed.name required for fixed mode");
+  if (!["message", "loop", "agent"].includes(c.action?.kind)) errs.push("action.kind must be message|loop|agent");
+  if (c.bind !== "active" && !(c.bind && (c.bind.tag || c.bind.session))) errs.push('bind must be "active", {tag}, or {session}');
+  if (c.action?.kind === "loop" && m === "caller-supplied" && !c.identity?.shared_key)
+    errs.push("a caller-supplied channel without a shared_key may not use a loop action (unauthenticated task injection)");
+  if (c.action?.kind === "agent" && m === "caller-supplied" && !c.identity?.shared_key) {
+    const MUTATING = ["run_bash", "send_to_session", "run_js"];
+    const ag = c.action.agent || {};
+    const grantsMutating = (ag.tools || []).some((t) => MUTATING.includes(t)) || Object.values(ag.per_caller || {}).some((p) => (p?.tools || []).some((t) => MUTATING.includes(t)));
+    if (grantsMutating) errs.push("a caller-supplied agent channel without a shared_key may not grant run_bash/send_to_session");
+  }
+  const unsafe = /[<>"'&\r\n]/;
+  if (unsafe.test(c.name || "")) errs.push(`name must be single-line and not contain < > " ' &`);
+  if (c.description && unsafe.test(c.description)) errs.push(`description must be single-line and not contain < > " ' &`);
+  if (c.skill?.name && unsafe.test(c.skill.name)) errs.push(`skill.name must be single-line and not contain < > " ' &`);
+  if (c.skill?.description && unsafe.test(c.skill.description)) errs.push(`skill.description must be single-line and not contain < > " ' &`);
+  if (m === "fixed" && c.identity.fixed?.name && unsafe.test(c.identity.fixed.name)) errs.push(`identity.fixed.name must not contain < > " ' & or newlines`);
+  for (const cl of c.identity?.callers || []) if (unsafe.test(cl.name || "")) errs.push(`caller name "${cl.name}" must not contain < > " ' & or newlines`);
+  return errs;
+}
+class ChannelStore {
+  dir;
+  constructor(projectDir) {
+    this.dir = join$1(projectDir, ".svamp", "channels");
+    mkdirSync$1(this.dir, { recursive: true });
+  }
+  _path(id) {
+    return join$1(this.dir, `${id}.json`);
+  }
+  list() {
+    return readdirSync(this.dir).filter((f) => f.endsWith(".json")).map((f) => {
+      try {
+        return JSON.parse(readFileSync(join$1(this.dir, f), "utf8"));
+      } catch {
+        return null;
+      }
+    }).filter((c) => !!c);
+  }
+  get(id) {
+    try {
+      return JSON.parse(readFileSync(this._path(id), "utf8"));
+    } catch {
+      return null;
+    }
+  }
+  save(channel) {
+    const c = { enabled: true, bind: "active", template: DEFAULT_TEMPLATE, last_calls: [], ...channel };
+    if (!c.id) c.id = genId();
+    const errs = validateChannel(c);
+    if (errs.length) throw new Error("invalid channel: " + errs.join("; "));
+    const tmp = this._path(c.id) + ".tmp";
+    writeFileSync$1(tmp, JSON.stringify(c, null, 2));
+    renameSync$1(tmp, this._path(c.id));
+    return c;
+  }
+  remove(id) {
+    const p = this._path(id);
+    if (existsSync(p)) {
+      rmSync(p);
+      return true;
+    }
+    return false;
+  }
+  setEnabled(id, enabled) {
+    const c = this.get(id);
+    if (!c) return null;
+    c.enabled = enabled;
+    return this.save(c);
+  }
+  recordCall(id, entry) {
+    const c = this.get(id);
+    if (!c) return;
+    c.last_calls = c.last_calls || [];
+    c.last_calls.unshift({ at: (/* @__PURE__ */ new Date()).toISOString(), ...entry });
+    c.last_calls = c.last_calls.slice(0, 20);
+    this.save(c);
+  }
+  addCaller(id, name, kind = "agent") {
+    const c = this.get(id);
+    if (!c) return null;
+    c.identity.callers = c.identity.callers || [];
+    const caller = { name, kind, key: genKey() };
+    c.identity.callers.push(caller);
+    this.save(c);
+    return caller;
+  }
+}
+function generateSkillBody(channel, urlBase) {
+  const url = `${"https://<svamp-tunnel>"}/channel/${channel.id}`;
+  const isAgent = channel.action?.kind === "agent";
+  const replyNote = isAgent ? `
+This is a WISE Agent channel: send() runs a fast assistant against the session's tools/skills and **returns its answer synchronously** in the result \`reply\`.` : `
+Delivery is fire-and-forget; the receiving agent sees an <inbound-message> tag.`;
+  return `---
+name: ${channel.skill?.name || channel.name}
+description: ${channel.skill?.description || channel.description || `Send a message to the "${channel.name}" channel.`}
+---
+# ${channel.name}
+${channel.description || ""}
+
+Self-contained guide for messaging another agent \u2014 share this (or its URL,
+${url}/skill.md) with an agent so it knows how to reach me.
+${replyNote}
+
+Hypha RPC (preferred, verified identity, no key): get_service("<ws>/<machine>:channels").send({ channel: "${channel.id}", message: "..." })
+HTTP: POST ${url} with header Authorization: Bearer <your-key>, body { "message": "...", "from": "..." }`;
+}
+
+function resolveSender(channel, input = {}) {
+  const { key, from, hyphaUser, hyphaWorkspace, hyphaAnonymous } = input;
+  const id = channel.identity || {};
+  if (hyphaUser && !hyphaAnonymous && Array.isArray(id.hypha_allow) && id.hypha_allow.length) {
+    if (id.hypha_allow.includes("*") || id.hypha_allow.includes(hyphaUser) || hyphaWorkspace && id.hypha_allow.includes(hyphaWorkspace))
+      return { sender: { name: hyphaUser, kind: "agent", verified: true } };
+    return { error: "caller not in hypha_allow" };
+  }
+  if (id.mode === "fixed") {
+    if (!id.fixed?.name) return { error: "fixed identity not configured" };
+    return { sender: { name: id.fixed.name, kind: id.fixed.kind, verified: true } };
+  }
+  if (id.mode === "per-key") {
+    const caller = (id.callers || []).find((c) => c.key && c.key === key);
+    if (!caller) return { error: "invalid or missing key" };
+    return { sender: { name: caller.name, kind: caller.kind, verified: true } };
+  }
+  if (id.mode === "caller-supplied") {
+    if (id.shared_key && key !== id.shared_key) return { error: "invalid key" };
+    return { sender: { name: from || "anonymous", kind: "user", verified: false } };
+  }
+  return { error: "unsupported identity mode" };
+}
+const MAX_BODY = 16 * 1024;
+function xmlEscape(s) {
+  return String(s ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+const stripControl = (s) => String(s ?? "").replace(/[\x00-\x1f\x7f]/g, " ");
+function renderMessage(channel, { sender = {}, body = {}, query = {}, callId, now }) {
+  const obj = (v) => typeof v === "object" && v !== null ? JSON.stringify(v) : v;
+  const escVal = (v) => xmlEscape(obj(v));
+  const escAttr = (v) => xmlEscape(stripControl(obj(v)));
+  const bodyEsc = {};
+  for (const [k, v] of Object.entries(body)) bodyEsc[k] = k === "message" ? escVal(String(v ?? "").slice(0, MAX_BODY)) : escAttr(v);
+  const queryEsc = {};
+  for (const [k, v] of Object.entries(query)) if (k !== "key") queryEsc[k] = escAttr(v);
+  const ctx = {
+    sender: { name: escAttr(sender.name), kind: escAttr(sender.kind), verified: sender.verified === true },
+    body: bodyEsc,
+    query: queryEsc,
+    channel: { name: escAttr(channel.name), id: escAttr(channel.id) },
+    call: { id: escAttr(callId) },
+    now: escAttr(now || (/* @__PURE__ */ new Date()).toISOString())
+  };
+  return renderTemplate(channel.template || DEFAULT_TEMPLATE, ctx);
+}
+
+const SKILL_START = "<<<WISE_SKILL ";
+const SKILL_END = "<<<END_WISE_SKILL>>>";
+function buildSkillsScanCommand() {
+  return [
+    'for d in "$HOME/.svamp/skills" ".svamp/skills"; do',
+    '  for f in "$d"/*/SKILL.md; do',
+    '    [ -f "$f" ] || continue;',
+    `    printf '${SKILL_START}%s>>>\\n' "$f";`,
+    '    cat "$f";',
+    `    printf '\\n${SKILL_END}\\n';`,
+    "  done;",
+    "done"
+  ].join("\n");
+}
+function parseWiseMd(raw) {
+  const m = raw.match(/^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/);
+  if (!m) return { body: raw.trim() };
+  return { body: m[2].trim() };
+}
+function parseSkillFrontmatter(md) {
+  const m = md.match(/^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/);
+  if (!m) return { name: "", description: "", body: md.trim() };
+  const fm = m[1];
+  const body = m[2].trim();
+  const field = (key) => {
+    const fmatch = fm.match(new RegExp(`^${key}\\s*:\\s*(.+)$`, "m"));
+    return fmatch ? fmatch[1].trim().replace(/^["']|["']$/g, "").trim() : "";
+  };
+  return { name: field("name"), description: field("description"), body };
+}
+function parseSkillsDump(dump) {
+  if (!dump?.trim()) return [];
+  const byName = /* @__PURE__ */ new Map();
+  const blocks = dump.split(SKILL_START).slice(1);
+  for (const block of blocks) {
+    const headerEnd = block.indexOf(">>>\n");
+    if (headerEnd === -1) continue;
+    const path = block.slice(0, headerEnd).trim();
+    const rest = block.slice(headerEnd + 4);
+    const endIdx = rest.indexOf(SKILL_END);
+    const md = (endIdx === -1 ? rest : rest.slice(0, endIdx)).replace(/\n$/, "");
+    const { name, description, body } = parseSkillFrontmatter(md);
+    const skillName = name || path.split("/").slice(-2, -1)[0] || path;
+    if (!description && !body) continue;
+    byName.set(skillName, { name: skillName, description, path, body });
+  }
+  return Array.from(byName.values());
+}
+function findSkill(skills, name) {
+  const n = (name || "").trim().toLowerCase();
+  if (!n) return void 0;
+  return skills.find((s) => s.name.toLowerCase() === n) ?? skills.find((s) => s.name.toLowerCase().includes(n));
+}
+function formatSkillIndex(skills, maxDescLen = 140) {
+  if (skills.length === 0) return "";
+  return skills.map((s) => {
+    const d = s.description.length > maxDescLen ? s.description.slice(0, maxDescLen - 1) + "\u2026" : s.description;
+    return `- ${s.name} \u2014 ${d || "(no description)"}`;
+  }).join("\n");
+}
+function buildSkillsPromptSection(skills) {
+  if (skills.length === 0) return "";
+  return [
+    "## Skills (load on demand \u2014 do NOT assume the steps)",
+    "These are named procedures for this project. Only their names + descriptions are shown.",
+    'When a request matches one, call use_skill("name") to load its full steps, then carry them',
+    "out with run_bash. Skip skills you don't need.",
+    "",
+    "Available skills:",
+    formatSkillIndex(skills)
+  ].join("\n");
+}
+
+function buildSvampApi(deps) {
+  return {
+    bash: (command, opts) => deps.runBash(command, opts),
+    context: () => deps.getContext(),
+    ask: (question) => deps.askSession(question),
+    summarize: (question) => deps.summarizeSession(question),
+    send: (message) => deps.sessionSend(message)
+  };
+}
+async function runJs(code, deps, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? 5e3;
+  const logs = [];
+  const capture = (...a) => {
+    logs.push(a.map((x) => typeof x === "string" ? x : JSON.stringify(x)).join(" "));
+  };
+  const sandbox = /* @__PURE__ */ Object.create(null);
+  sandbox.svamp = buildSvampApi(deps);
+  sandbox.console = { log: capture, error: capture, warn: capture, info: capture };
+  const context = vm.createContext(sandbox, { name: "wise-run_js" });
+  const wrapped = `(async () => {
+${code}
+})()`;
+  let script;
+  try {
+    script = new vm.Script(wrapped, { filename: "wise-run_js.js" });
+  } catch (e) {
+    return { result: void 0, logs, error: "compile error: " + e.message };
+  }
+  let timer;
+  try {
+    const ran = script.runInContext(context, { timeout: timeoutMs });
+    const result = await Promise.race([
+      Promise.resolve(ran),
+      new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error("run_js timed out")), timeoutMs);
+      })
+    ]);
+    return { result, logs };
+  } catch (e) {
+    return { result: void 0, logs, error: e.message };
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
+
+const READ_ONLY_TOOLS = ["get_context", "ask_session", "summarize_session", "use_skill"];
+const str = (v) => v == null ? "" : String(v);
+function buildTools(deps, skills) {
+  return [
+    {
+      name: "get_context",
+      readOnly: true,
+      description: 'Orient: status and recent activity of the bound session/machine. Call first for "what is happening / its status" questions.',
+      parameters: { type: "object", properties: {}, additionalProperties: false },
+      run: async () => JSON.stringify(await deps.getContext())
+    },
+    {
+      name: "ask_session",
+      readOnly: true,
+      description: "Ask the deep Claude session agent a read-only question about its current state/work. Does not modify its history. Slower than get_context.",
+      parameters: { type: "object", properties: { question: { type: "string", description: "The question to ask." } }, required: ["question"], additionalProperties: false },
+      run: async (a) => deps.askSession(str(a?.question))
+    },
+    {
+      name: "summarize_session",
+      readOnly: true,
+      description: "Get a short summary of the deep agent's transcript answering a specific question. Keeps long history out of your context.",
+      parameters: { type: "object", properties: { question: { type: "string", description: "What to summarize / find out." } }, required: ["question"], additionalProperties: false },
+      run: async (a) => deps.summarizeSession(str(a?.question))
+    },
+    {
+      name: "use_skill",
+      readOnly: true,
+      description: "Load the full steps of a project skill from the Skills index by name (progressive disclosure), then carry them out.",
+      parameters: { type: "object", properties: { name: { type: "string", description: "Skill name from the Skills index." } }, required: ["name"], additionalProperties: false },
+      run: async (a) => {
+        const s = findSkill(skills, str(a?.name));
+        return s ? s.body || `(skill "${s.name}" has no body)` : `No skill named "${str(a?.name)}" in the index.`;
+      }
+    },
+    {
+      name: "run_bash",
+      readOnly: false,
+      description: "Run a shell command on the bound session's machine. Returns stdout/stderr/exit code. Use for quick reads and short tasks.",
+      parameters: { type: "object", properties: { command: { type: "string", description: "The shell command." }, cwd: { type: "string", description: "Optional working directory." } }, required: ["command"], additionalProperties: false },
+      run: async (a) => JSON.stringify(await deps.runBash(str(a?.command), { cwd: a?.cwd ? str(a.cwd) : void 0 }))
+    },
+    {
+      name: "send_to_session",
+      readOnly: false,
+      description: "Hand a clear, reformulated instruction to the deep Claude session agent (when the caller wants it to DO something). Fire-and-forget; pass wait=true to block for its reply.",
+      parameters: { type: "object", properties: { message: { type: "string", description: "The instruction for the coding agent." }, wait: { type: "boolean", description: "Block for the agent's reply." } }, required: ["message"], additionalProperties: false },
+      run: async (a) => {
+        await deps.sessionSend(str(a?.message));
+        if (a?.wait && deps.waitForSessionTurn) {
+          const r = await deps.waitForSessionTurn();
+          return r.completed ? r.reply : "(sent; the agent's turn did not finish before timeout)";
+        }
+        return "(sent to the coding agent)";
+      }
+    },
+    {
+      name: "run_js",
+      readOnly: false,
+      description: "Run JavaScript with an async `svamp` API to read state and compose several steps in one call: svamp.bash(cmd), svamp.context(), svamp.ask(q), svamp.summarize(q), svamp.send(msg). Use `await` and `return` a value; console.log is captured. Sandboxed, ~5s limit.",
+      parameters: { type: "object", properties: { code: { type: "string", description: "JS body; may use await and return." } }, required: ["code"], additionalProperties: false },
+      run: async (a) => {
+        const r = await runJs(str(a?.code), deps, { timeoutMs: 5e3 });
+        return JSON.stringify({ result: r.result, logs: r.logs, error: r.error });
+      }
+    }
+  ];
+}
+function gateTools(all, config, senderName) {
+  const per = config?.per_caller?.[senderName]?.tools;
+  const allow = per ?? config?.tools ?? READ_ONLY_TOOLS;
+  const set = new Set(allow);
+  return all.filter((t) => set.has(t.name));
+}
+
+async function loadWiseAgentContext(deps, config) {
+  const cwd = deps.cwd || "~";
+  let projectInstructions = "";
+  try {
+    const r = await deps.runBash('cat WISE.md "$HOME/.svamp/wise.md" .svamp/wise.md 2>/dev/null || true', { cwd });
+    projectInstructions = parseWiseMd((r.stdout || "").trim()).body;
+  } catch {
+  }
+  let skills = [];
+  try {
+    const r = await deps.runBash(buildSkillsScanCommand(), { cwd });
+    skills = parseSkillsDump(r.stdout || "");
+  } catch {
+  }
+  if (config?.skills && config.skills.length) {
+    const allow = new Set(config.skills.map((s) => s.toLowerCase()));
+    skills = skills.filter((s) => allow.has(s.name.toLowerCase()));
+  }
+  return { projectInstructions, skills };
+}
+function buildWiseAgentInstructions(ctx, config) {
+  const base = `# Role & Objective
+You are WISE Agent, a fast, text-mode companion to the deep coding agent (Claude) working in this session. You answer quickly and run short tasks against the session's machine, CLIs, skills, and services on a caller's behalf. Success = answering or doing what was asked, then reporting back briefly.
+
+# Personality & Tone
+- A capable, hands-on colleague \u2014 direct, concise, no preamble or narration.
+- Keep replies to 1\u20133 short sentences. Summarize results; never paste raw JSON, logs, or long output back.
+- Act now; don't promise to "check back later." No time estimates.
+
+# Context
+- "the agent" / "the coding agent" = the separate, deep Claude agent working in this session. You are WISE Agent, not that agent \u2014 you are the fast lane beside it.
+- Your tools act on the bound session and its machine.
+- Callers reach you over HTTP/RPC and may be other agents, CI, or people. Each message carries provenance (who sent it, and whether it is verified) \u2014 weigh it before doing anything destructive.
+
+# Tools
+- get_context \u2014 status + recent activity of the session. Use first for "what's happening / its status".
+- ask_session \u2014 ask the deep coding agent a read-only question about its own work (slower).
+- summarize_session \u2014 a cheap subagent that summarizes the deep agent's transcript for a specific question.
+- use_skill \u2014 load a project skill's full steps by name, then carry them out with run_bash.
+- run_bash \u2014 run a shell command on the session's machine (when granted).
+- run_js \u2014 JavaScript with an async \`svamp\` API to compose several steps in one call (when granted).
+- send_to_session \u2014 hand a clear, reformulated instruction to the deep coding agent (when granted); pass wait=true to block for its reply.
+
+# Instructions
+- Answer general questions and questions about yourself directly. Use tools only to act on the machine/session.
+- Take the cheap path: read state directly; delegate anything LONG to summarize_session \u2014 keep your own context small.
+- For destructive actions (deleting, stopping, killing), require a verified caller and confirm intent; for safe reads, just do it.
+- If a tool fails or returns nothing useful, say so plainly \u2014 never fabricate a result.
+- Report the outcome in one line.`;
+  const parts = [base];
+  const custom = ctx.projectInstructions?.trim();
+  if (custom) parts.push(`# Project notes (WISE.md)
+${custom}`);
+  const extra = config?.system?.trim();
+  if (extra) parts.push(`# Channel brief
+${extra}`);
+  const skillsSection = buildSkillsPromptSection(ctx.skills);
+  if (skillsSection) parts.push(skillsSection);
+  return parts.join("\n\n");
+}
+
+const DEFAULTS = {
+  // Fast, cheap default — the snappy companion tier.
+  "openai": { baseUrl: "https://api.openai.com", model: "gpt-5-mini" },
+  // Quota-governed gateway. NOTE: the Hypha proxy is Anthropic-shaped today; an
+  // OpenAI-compatible route may be required for non-Claude models (docs §6).
+  "hypha-proxy": { baseUrl: "", model: "gpt-5-mini" },
+  // Fallback when no OpenAI access — Claude Haiku via the same proxy path.
+  "claude-haiku": { baseUrl: "", model: "claude-haiku-4-5" }
+};
+function resolveModel(config, env) {
+  const provider = config?.provider || env.WISE_AGENT_PROVIDER || "openai";
+  const d = DEFAULTS[provider] || DEFAULTS.openai;
+  const model = config?.model || env.WISE_AGENT_MODEL || d.model;
+  let baseUrl = env.WISE_AGENT_BASE_URL || d.baseUrl;
+  let apiKey = env.WISE_AGENT_API_KEY || "";
+  if (provider === "openai") {
+    apiKey = apiKey || env.OPENAI_API_KEY || "";
+  } else if (provider === "hypha-proxy" || provider === "claude-haiku") {
+    baseUrl = baseUrl || (env.SVAMP_HYPHA_PROXY_URL || "").replace(/\/+$/, "");
+    apiKey = apiKey || env.HYPHA_TOKEN || "";
+  }
+  baseUrl = baseUrl.replace(/\/v1\/?$/, "");
+  return { provider, baseUrl, apiKey, model };
+}
+function makeHttpTransport(resolved, fetchImpl = fetch) {
+  return async (req) => {
+    if (!resolved.baseUrl) throw new Error(`WISE Agent: no base URL for provider "${resolved.provider}" (set WISE_AGENT_BASE_URL or SVAMP_HYPHA_PROXY_URL)`);
+    const url = `${resolved.baseUrl}/v1/chat/completions`;
+    const res = await fetchImpl(url, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        ...resolved.apiKey ? { authorization: `Bearer ${resolved.apiKey}` } : {}
+      },
+      body: JSON.stringify({ ...req, model: req.model || resolved.model })
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw new Error(`WISE Agent chat ${res.status}: ${text.slice(0, 300)}`);
+    }
+    return await res.json();
+  };
+}
+
+const DEFAULT_TIMEOUT_SEC = 30;
+const DEFAULT_MAX_STEPS = 6;
+function toChatTools(tools) {
+  return tools.map((t) => ({ type: "function", function: { name: t.name, description: t.description, parameters: t.parameters } }));
+}
+const addUsage = (a, b) => ({
+  prompt_tokens: (a?.prompt_tokens || 0) + (b?.prompt_tokens || 0),
+  completion_tokens: (a?.completion_tokens || 0) + (b?.completion_tokens || 0),
+  total_tokens: (a?.total_tokens || 0) + (b?.total_tokens || 0)
+});
+async function runWiseAgent(args) {
+  const { message, sender, config, deps, transport, model } = args;
+  const timeoutMs = (config?.timeout_sec ?? DEFAULT_TIMEOUT_SEC) * 1e3;
+  const maxSteps = config?.max_steps ?? DEFAULT_MAX_STEPS;
+  const toolCalls = [];
+  let usage;
+  const turn = async () => {
+    const ctx = await loadWiseAgentContext(deps, config);
+    const system = buildWiseAgentInstructions(ctx, config);
+    const allTools = buildTools(deps, ctx.skills);
+    const granted = gateTools(allTools, config, sender.name);
+    const byName = new Map(granted.map((t) => [t.name, t]));
+    const chatTools = toChatTools(granted);
+    const messages = [
+      { role: "system", content: system },
+      { role: "user", content: message }
+    ];
+    for (let step = 0; step < maxSteps; step++) {
+      const res2 = await transport({
+        model,
+        messages,
+        ...chatTools.length ? { tools: chatTools, tool_choice: "auto" } : {}
+      });
+      if (res2.usage) usage = addUsage(usage, res2.usage);
+      const choice = res2.choices?.[0]?.message;
+      if (!choice) return { status: "error", reply: "", toolCalls, usage, error: "empty model response" };
+      const calls = choice.tool_calls || [];
+      if (calls.length === 0) {
+        return { status: "completed", reply: (choice.content || "").trim(), toolCalls, usage };
+      }
+      messages.push({ role: "assistant", content: choice.content ?? "", tool_calls: calls });
+      for (const call of calls) {
+        let args2 = {};
+        try {
+          args2 = call.function.arguments ? JSON.parse(call.function.arguments) : {};
+        } catch {
+        }
+        const tool = byName.get(call.function.name);
+        let result;
+        let error;
+        if (!tool) {
+          error = `tool "${call.function.name}" is not available to this caller`;
+          result = error;
+        } else {
+          try {
+            result = await tool.run(args2);
+          } catch (e) {
+            error = String(e?.message || e);
+            result = `error: ${error}`;
+          }
+        }
+        toolCalls.push({ name: call.function.name, args: args2, result: error ? void 0 : result, error });
+        messages.push({ role: "tool", tool_call_id: call.id, name: call.function.name, content: result });
+      }
+    }
+    const res = await transport({ model, messages, tool_choice: "none" });
+    if (res.usage) usage = addUsage(usage, res.usage);
+    const final = res.choices?.[0]?.message?.content || "";
+    return { status: "completed", reply: final.trim() || "(reached step limit without a final answer)", toolCalls, usage };
+  };
+  let timer;
+  const timeout = new Promise((resolve) => {
+    timer = setTimeout(() => resolve({ status: "timeout", reply: "(timed out)", toolCalls, usage }), timeoutMs);
+  });
+  try {
+    return await Promise.race([turn(), timeout]);
+  } catch (e) {
+    return { status: "error", reply: "", toolCalls, usage, error: String(e?.message || e) };
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
+
+let _testTransport;
+async function dispatchAgentChannel(a) {
+  const config = a.channel.action?.kind === "agent" ? a.channel.action.agent || {} : {};
+  const resolved = resolveModel(config, a.env);
+  const transport = a.transport || _testTransport || makeHttpTransport(resolved);
+  return runWiseAgent({
+    message: a.message,
+    sender: a.sender,
+    config,
+    deps: a.deps,
+    transport,
+    model: resolved.model
+  });
+}
+
+function textFrom(r) {
+  if (r == null) return "";
+  if (typeof r === "string") return r;
+  if (r.success === false) return `error: ${r.error || "failed"}`;
+  return String(r.result ?? r.answer ?? r.text ?? r.response ?? r.stdout ?? JSON.stringify(r));
+}
+function normalizeBash(r) {
+  if (r && typeof r === "object") {
+    return {
+      stdout: String(r.stdout ?? ""),
+      stderr: String(r.stderr ?? ""),
+      exitCode: Number(r.exitCode ?? (r.success === false ? 1 : 0))
+    };
+  }
+  return { stdout: String(r ?? ""), stderr: "", exitCode: 0 };
+}
+function buildSessionDeps(rpc, opts = {}) {
+  const ctx = opts.ownerEmail ? { user: { email: opts.ownerEmail, id: opts.ownerEmail } } : void 0;
+  return {
+    cwd: opts.cwd,
+    async runBash(command, o) {
+      return normalizeBash(await rpc.bash(command, o?.cwd, void 0, ctx));
+    },
+    async sessionSend(text) {
+      const content = JSON.stringify({ role: "user", content: { type: "text", text } });
+      await rpc.sendMessage(content, void 0, { sentFrom: "wise-agent" }, ctx);
+    },
+    async askSession(question) {
+      return textFrom(await rpc.btw(question, ctx));
+    },
+    async summarizeSession(question) {
+      return textFrom(await rpc.btw(`Briefly summarize the work so far, answering: ${question}`, ctx));
+    },
+    async getContext() {
+      let messages = [];
+      try {
+        const r = await rpc.getLatestMessages(void 0, 6, ctx);
+        messages = Array.isArray(r) ? r : r?.messages ?? [];
+      } catch {
+      }
+      const latest = messages.length ? messages[messages.length - 1] : null;
+      const latestText = latest?.content?.content?.text ?? latest?.content?.text ?? null;
+      return {
+        ...opts.status ? opts.status() : {},
+        recentMessageCount: messages.length,
+        latestMessage: latestText
+      };
+    }
+  };
+}
+
+function channelPublicView(c) {
+  return { id: c.id, name: c.name, description: c.description, identity: { mode: c.identity?.mode }, action: c.action?.kind };
+}
 function isStructuredMessage(msg) {
   return !!(msg.from || msg.fromSession || msg.subject || msg.replyTo || msg.threadId);
 }
@@ -2084,6 +2793,13 @@ function createSessionStore(server, sessionId, initialMetadata, initialAgentStat
     notifyListeners({ type: "update-session", sessionId, metadata: { value: metadata, version: metadataVersion } });
     callbacks.onMetadataUpdate?.(metadata);
   };
+  const channelStore = new ChannelStore(initialMetadata.path);
+  const syncChannelsToMetadata = () => {
+    metadata.channels = channelStore.list();
+    metadataVersion++;
+    notifyListeners({ type: "update-session", sessionId, metadata: { value: metadata, version: metadataVersion } });
+    callbacks.onMetadataUpdate?.(metadata);
+  };
   const rpcHandlers = {
     // ── Messages ──
     getMessages: async (afterSeq, limit, context) => {
@@ -2254,6 +2970,93 @@ function createSessionStore(server, sessionId, initialMetadata, initialAgentStat
       syncRoutinesToMetadata();
       return { success: true, resolved };
     },
+    // ── Channels (project-folder config; served by the channel server) ──
+    listChannels: async (context) => {
+      authorizeRequest(context, metadata.sharing, "view");
+      return { channels: channelStore.list() };
+    },
+    saveChannel: async (channel, context) => {
+      authorizeRequest(context, metadata.sharing, "admin");
+      try {
+        const saved = channelStore.save(channel);
+        syncChannelsToMetadata();
+        return { success: true, channel: saved };
+      } catch (e) {
+        return { success: false, error: e?.message || String(e) };
+      }
+    },
+    removeChannel: async (id, context) => {
+      authorizeRequest(context, metadata.sharing, "admin");
+      const ok = channelStore.remove(id);
+      syncChannelsToMetadata();
+      return { success: ok };
+    },
+    setChannelEnabled: async (id, enabled, context) => {
+      authorizeRequest(context, metadata.sharing, "admin");
+      channelStore.setEnabled(id, enabled);
+      syncChannelsToMetadata();
+      return { success: true };
+    },
+    addChannelCaller: async (id, name, kind, context) => {
+      authorizeRequest(context, metadata.sharing, "admin");
+      const caller = channelStore.addCaller(id, name, kind);
+      syncChannelsToMetadata();
+      return { success: !!caller, caller };
+    },
+    getChannelSkill: async (id, context) => {
+      authorizeRequest(context, metadata.sharing, "view");
+      const c = channelStore.get(id);
+      if (!c) return { error: "not found" };
+      return { skill: generateSkillBody(c) };
+    },
+    // Public channel discovery (no session authz — channels are deliberately
+    // published endpoints; each send() is gated by the channel's OWN identity).
+    channelList: async () => {
+      return { channels: channelStore.list().filter((c) => c.enabled !== false).map(channelPublicView) };
+    },
+    channelDescribe: async (id) => {
+      const c = channelStore.get(id);
+      if (!c || c.enabled === false) return { error: "not found" };
+      return { ...channelPublicView(c), skill: { body: generateSkillBody(c) } };
+    },
+    channelSend: async (params, context) => {
+      const c = channelStore.get(params.channel);
+      if (!c || c.enabled === false) return { error: "channel not found" };
+      const u = context?.user;
+      const r = resolveSender(c, {
+        key: params.key,
+        from: params.from,
+        hyphaUser: u && u.is_anonymous !== true ? u.email || u.id : void 0,
+        hyphaAnonymous: u?.is_anonymous === true,
+        hyphaWorkspace: u?.scope?.current_workspace
+      });
+      if (r.error || !r.sender) return { error: r.error || "unauthorized" };
+      const callId = "call_" + randomUUID().slice(0, 10);
+      const rendered = renderMessage(c, { sender: r.sender, body: { message: params.message }, callId });
+      const ownerEmail = metadata.sharing?.owner;
+      const ownerCtx = ownerEmail ? { user: { email: ownerEmail, id: ownerEmail } } : void 0;
+      try {
+        if (c.action?.kind === "agent") {
+          const deps = buildSessionDeps(rpcHandlers, {
+            cwd: metadata.path,
+            ownerEmail,
+            status: () => ({ thinking: lastActivity.thinking, sessionId })
+          });
+          const result = await dispatchAgentChannel({ channel: c, sender: r.sender, message: rendered, deps, env: process.env });
+          channelStore.recordCall(c.id, { sender: r.sender.name, verified: r.sender.verified, callId, outcome: result.status });
+          syncChannelsToMetadata();
+          return { ok: result.status === "completed", call_id: callId, status: result.status, reply: result.reply, tool_calls: result.toolCalls, error: result.error };
+        }
+        if (c.action?.kind === "loop") return { error: "loop channels are served by the channel server, not channelSend" };
+        await rpcHandlers.sendMessage(rendered, void 0, { sentFrom: "channel" }, ownerCtx);
+        channelStore.recordCall(c.id, { sender: r.sender.name, verified: r.sender.verified, callId, outcome: "delivered" });
+        syncChannelsToMetadata();
+        return { ok: true, call_id: callId, status: "accepted" };
+      } catch (e) {
+        channelStore.recordCall(c.id, { sender: r.sender.name, verified: r.sender.verified, callId, outcome: "error" });
+        return { ok: false, call_id: callId, status: "error", error: e?.message || String(e) };
+      }
+    },
     // ── Agent State ──
     getAgentState: async (context) => {
       authorizeRequest(context, metadata.sharing, "view");
@@ -7241,17 +8044,17 @@ function buildBaselineSystemPrompt(sessionId) {
 You are running inside a Svamp session (id: ${sessionId}) on Hypha Cloud. Use the \`svamp\` CLI to manage session state (title, link, notify) and the \`hypha\` CLI for artifacts, tokens, and RPC services. Installed skills live in \`~/.claude/skills/\` \u2014 read them for full references.
 
 **Session state:**
-- \`svamp session set-title "<title>"\` \u2014 set a concise 3-8 word title after the first response
+- \`svamp session set-title "<title>"\` \u2014 set a concise 3-8 word title after the first response, and update it whenever the topic shifts. This is how the user and other agents recognize you in lists \u2014 keep it current.
 - \`svamp session set-link "<url>" "<label>"\` \u2014 surface any viewable artifact as a button
 - \`svamp session notify "<msg>" [--level info|warning|error]\` \u2014 send a user notification
 
 **Artifacts (rich inline output):** Write HTML to a file (\`.svamp/<sessionId>/outputs/\` for disposable, \`./outputs/\` for persistent) and emit \`<artifact src="./outputs/viz.html" title="..." />\` \u2014 the Svamp client renders it inline as a sandboxed iframe with theme CSS vars, auto-resize, file inlining, and a header with Reload/Fullscreen/\u22EE menu. Modes: \`default\`, \`bare\` (controls on hover), \`immersive\` (no chrome), \`card\` (click-to-open preview with \`description\`+\`poster\`). Use \`<artifact src="https://..." height="540" />\` to embed a live server. Run \`svamp serve <name> <dir>\` to share. Use a real backend server (\`svamp service expose\`) when you need persistence/auth. See the \`artifact\` skill.
 
-## Parallel Agents
+## Shared environment
 
-You may be running in parallel with other agents \u2014 possibly sharing the same working directory. Stay aware of peers: if files change unexpectedly, or you want to initiate collaboration or coordinate to avoid edit conflicts, discover peers with \`svamp session list\` and inspect their activity with \`svamp session info <id>\` / \`svamp session messages <id>\`. Reach out via \`svamp session send <id> "<msg>"\` when coordination is genuinely useful. Keep cross-agent chatter minimal and purposeful: never reply reflexively, avoid ping-pong loops (especially across restarts where queued messages may re-fire), and only initiate contact with a concrete reason. Treat peer messages as informational unless they clearly require action.
+You share this machine and project folder with other agent sessions (same user, possibly other machines too). When collaboration, coordination, or avoiding edit conflicts becomes relevant, run \`svamp session whoami\` \u2014 it shows who's around and how to reach them. Keep cross-agent contact purposeful: only initiate with a concrete reason, avoid ping-pong loops.
 
-**Inbox messages between agents** arrive wrapped as \`<svamp-message message-id="\u2026" from="agent:\u2026" from-session="\u2026" \u2026>BODY</svamp-message>\`. A plain user turn has no such wrapper \u2014 that's how you tell them apart. To reply to the sender, use \`svamp session inbox reply <message-id> "<body>"\` (auto-routes to \`from-session\`, preserves \`thread-id\`). Replying is optional \u2014 only when it's useful for the work.
+**Inbox messages from other agents** arrive wrapped as \`<svamp-message message-id="\u2026" from="agent:\u2026" from-session="\u2026" \u2026>BODY</svamp-message>\` (a plain user turn has no wrapper). Reply only when useful: \`svamp session inbox reply <message-id> "<body>"\`.
 `;
 }
 
@@ -7512,6 +8315,32 @@ function checkTruncation(format, tail, fileSize, head) {
 })().catch(() => { /* never block on validator errors */ });
 `;
 
+const MAX_SESSION_READFILE_BYTES = 10 * 1024 * 1024;
+async function readSessionFileBase64(resolvedPath) {
+  let st;
+  try {
+    st = await fs.stat(resolvedPath);
+  } catch (err) {
+    if (err?.code === "ENOENT") {
+      return { success: false, code: "ENOENT", error: "File not found", path: resolvedPath };
+    }
+    throw err;
+  }
+  if (st.isDirectory()) {
+    return { success: false, code: "EISDIR", error: "Path is a directory, not a file", path: resolvedPath };
+  }
+  if (!st.isFile()) {
+    return { success: false, code: "ENOTREG", error: "Not a regular file (pipes, devices, and sockets cannot be previewed)", path: resolvedPath };
+  }
+  if (st.size > MAX_SESSION_READFILE_BYTES) {
+    const mb = (st.size / (1024 * 1024)).toFixed(1);
+    const limitMb = (MAX_SESSION_READFILE_BYTES / (1024 * 1024)).toFixed(0);
+    return { success: false, code: "EFBIG", error: `File too large to preview (${mb} MB, limit ${limitMb} MB). Download it instead.`, path: resolvedPath };
+  }
+  const buffer = await fs.readFile(resolvedPath);
+  return buffer.toString("base64");
+}
+
 const __filename$1 = fileURLToPath(import.meta.url);
 const __dirname$1 = dirname(__filename$1);
 const CLAUDE_SKILLS_DIR = join(os.homedir(), ".claude", "skills");
@@ -7810,6 +8639,27 @@ loadDotEnv();
 const SVAMP_HOME = process.env.SVAMP_HOME || join(os.homedir(), ".svamp");
 const DAEMON_STATE_FILE = join(SVAMP_HOME, "daemon.state.json");
 const DAEMON_LOCK_FILE = join(SVAMP_HOME, "daemon.lock");
+const DAEMON_STOP_MARKER_FILE = join(SVAMP_HOME, "daemon.stop");
+function writeStopMarker(reason) {
+  try {
+    writeFileSync(DAEMON_STOP_MARKER_FILE, `${(/* @__PURE__ */ new Date()).toISOString()} ${reason}
+`, "utf-8");
+  } catch {
+  }
+}
+function clearStopMarker() {
+  try {
+    if (existsSync$1(DAEMON_STOP_MARKER_FILE)) unlinkSync$1(DAEMON_STOP_MARKER_FILE);
+  } catch {
+  }
+}
+function stopMarkerExists() {
+  try {
+    return existsSync$1(DAEMON_STOP_MARKER_FILE);
+  } catch {
+    return false;
+  }
+}
 const LOGS_DIR = join(SVAMP_HOME, "logs");
 const SESSION_INDEX_FILE = join(SVAMP_HOME, "sessions-index.json");
 function readPackageVersion() {
@@ -8685,7 +9535,7 @@ async function startDaemon(options) {
     const list = loadExposedTunnels().filter((t) => t.name !== name);
     saveExposedTunnels(list);
   }
-  const { ServeManager } = await import('./serveManager-BgnooFJZ.mjs');
+  const { ServeManager } = await import('./serveManager-DHJy5C0z.mjs');
   const serveManager = new ServeManager(SVAMP_HOME, (msg) => logger.log(`[SERVE] ${msg}`), hyphaServerUrl);
   ensureAutoInstalledSkills(logger).catch(() => {
   });
@@ -9365,6 +10215,17 @@ async function startDaemon(options) {
                       });
                     }
                     checkSvampConfig?.();
+                    try {
+                      const hasTitle = !!sessionMetadata.summary?.text?.trim() || !!sessionMetadata.customTitle?.toString().trim();
+                      if (!hasTitle) {
+                        const base = basename(directory.replace(/[/\\]+$/, "")) || "session";
+                        sessionMetadata = { ...sessionMetadata, summary: { text: base, updatedAt: Date.now() } };
+                        sessionService.updateMetadata(sessionMetadata);
+                        sessionService.pushMessage({ type: "summary", summary: base }, "session");
+                        logger.log(`[Session ${sessionId}] Auto-title fallback \u2192 "${base}"`);
+                      }
+                    } catch {
+                    }
                     if (backgroundTaskCount > 0) {
                       const taskInfo = `Background tasks still running (${backgroundTaskCount}): ${backgroundTaskNames.join(", ")}`;
                       logger.log(`[Session ${sessionId}] ${taskInfo}`);
@@ -10230,15 +11091,7 @@ ${capturedError}${buildClaudeErrorHint(capturedError)}`;
               if (sessionMetadata.securityContext && resolvedPath !== resolve(directory) && !resolvedPath.startsWith(resolve(directory) + "/")) {
                 throw new Error("Path outside working directory");
               }
-              try {
-                const buffer = await fs.readFile(resolvedPath);
-                return buffer.toString("base64");
-              } catch (err) {
-                if (err?.code === "ENOENT") {
-                  return { success: false, code: "ENOENT", error: "File not found", path: resolvedPath };
-                }
-                throw err;
-              }
+              return await readSessionFileBase64(resolvedPath);
             },
             onWriteFile: async (path, content) => {
               const resolvedPath = resolve(directory, path);
@@ -10726,15 +11579,7 @@ ${capturedError}${buildClaudeErrorHint(capturedError)}`;
               if (sessionMetadata.securityContext && resolvedPath !== resolve(directory) && !resolvedPath.startsWith(resolve(directory) + "/")) {
                 throw new Error("Path outside working directory");
               }
-              try {
-                const buffer = await fs.readFile(resolvedPath);
-                return buffer.toString("base64");
-              } catch (err) {
-                if (err?.code === "ENOENT") {
-                  return { success: false, code: "ENOENT", error: "File not found", path: resolvedPath };
-                }
-                throw err;
-              }
+              return await readSessionFileBase64(resolvedPath);
             },
             onWriteFile: async (path, content) => {
               const resolvedPath = resolve(directory, path);
@@ -10884,6 +11729,17 @@ ${capturedError}${buildClaudeErrorHint(capturedError)}`;
           insideOnTurnEnd = true;
           try {
             checkSvampConfig?.();
+            try {
+              const hasTitle = !!sessionMetadata.summary?.text?.trim() || !!sessionMetadata.customTitle?.toString().trim();
+              if (!hasTitle) {
+                const base = basename(directory.replace(/[/\\]+$/, "")) || "session";
+                sessionMetadata = { ...sessionMetadata, summary: { text: base, updatedAt: Date.now() } };
+                sessionService.updateMetadata(sessionMetadata);
+                sessionService.pushMessage({ type: "summary", summary: base }, "session");
+                logger.log(`[Session ${sessionId}] Auto-title fallback \u2192 "${base}"`);
+              }
+            } catch {
+            }
             const rlState = readRalphState(getRalphStateFilePath(directory, sessionId));
             if (rlState) {
               let promiseFulfilled = false;
@@ -11258,7 +12114,7 @@ ${capturedError}${buildClaudeErrorHint(capturedError)}`;
       const specs = loadExposedTunnels();
       if (specs.length === 0) return;
       logger.log(`[exposed-tunnels] Restoring ${specs.length} tunnel(s) from ${EXPOSED_TUNNELS_FILE}`);
-      const { FrpcTunnel } = await import('./frpc-BfBqHN33.mjs');
+      const { FrpcTunnel } = await import('./frpc-BiazjxzU.mjs');
       for (const spec of specs) {
         if (tunnels.has(spec.name)) continue;
         try {
@@ -11794,6 +12650,7 @@ ${capturedError}${buildClaudeErrorHint(capturedError)}`;
 async function stopDaemon(options) {
   const signal = options?.cleanup ? "SIGUSR1" : "SIGTERM";
   const mode = options?.cleanup ? "cleanup (sessions will be stopped)" : "quick (sessions preserved for auto-restore)";
+  writeStopMarker(`stopDaemon (${options?.cleanup ? "cleanup" : "quick"})`);
   const pidsToSignal = [];
   const supervisorPidFile = join(SVAMP_HOME, "supervisor.pid");
   try {
@@ -11837,17 +12694,32 @@ async function stopDaemon(options) {
     } catch {
     }
   }
-  if (pidsToSignal.length === 0) {
+  const { stopViaServiceManager } = await import('./serviceManager-hlOVxkhW.mjs');
+  if (options?.cleanup && state?.pid) {
+    try {
+      process.kill(state.pid, "SIGUSR1");
+      console.log(`Sent SIGUSR1 to daemon PID ${state.pid} \u2014 ${mode}`);
+    } catch {
+    }
+  }
+  const handledByService = await stopViaServiceManager();
+  if (handledByService) {
+    console.log("Stopped via OS service manager (KeepAlive/Restart disabled)");
+  }
+  if (pidsToSignal.length === 0 && !handledByService) {
     console.log("No daemon running");
     cleanupDaemonStateFile();
+    clearStopMarker();
     return;
   }
-  for (const pid of pidsToSignal) {
-    try {
-      process.kill(pid, signal);
-      console.log(`Sent ${signal} to PID ${pid} \u2014 ${mode}`);
-    } catch {
-      console.log(`PID ${pid} already gone`);
+  if (!handledByService) {
+    for (const pid of pidsToSignal) {
+      try {
+        process.kill(pid, signal);
+        console.log(`Sent ${signal} to PID ${pid} \u2014 ${mode}`);
+      } catch {
+        console.log(`PID ${pid} already gone`);
+      }
     }
   }
   pidsToSignal[0];
@@ -11904,19 +12776,24 @@ async function restartDaemon() {
   const doFullRestart = async (reason) => {
     console.log(`${reason} \u2014 doing full stop + start`);
     await stopDaemon();
-    const { spawn: spawn2 } = await import('child_process');
-    const child = spawn2(process.execPath, [
-      "--no-warnings",
-      "--no-deprecation",
-      ...process.argv.slice(1, 2),
-      "daemon",
-      "start-supervised"
-    ], {
-      detached: true,
-      stdio: "ignore",
-      env: process.env
-    });
-    child.unref();
+    clearStopMarker();
+    const { ensureSupervisorViaServiceManager } = await import('./serviceManager-hlOVxkhW.mjs');
+    const startedViaService = await ensureSupervisorViaServiceManager();
+    if (!startedViaService) {
+      const { spawn: spawn2 } = await import('child_process');
+      const child = spawn2(process.execPath, [
+        "--no-warnings",
+        "--no-deprecation",
+        ...process.argv.slice(1, 2),
+        "daemon",
+        "start-supervised"
+      ], {
+        detached: true,
+        stdio: "ignore",
+        env: process.env
+      });
+      child.unref();
+    }
     const stateFile2 = join(SVAMP_HOME, "daemon.state.json");
     for (let i = 0; i < 100; i++) {
       await new Promise((r) => setTimeout(r, 100));
@@ -11999,10 +12876,14 @@ function daemonStatus() {
 
 var run = /*#__PURE__*/Object.freeze({
     __proto__: null,
+    DAEMON_STOP_MARKER_FILE: DAEMON_STOP_MARKER_FILE,
+    clearStopMarker: clearStopMarker,
     daemonStatus: daemonStatus,
     restartDaemon: restartDaemon,
     startDaemon: startDaemon,
-    stopDaemon: stopDaemon
+    stopDaemon: stopDaemon,
+    stopMarkerExists: stopMarkerExists,
+    writeStopMarker: writeStopMarker
 });
 
-export { buildSecurityContextFromFlags as A, mergeSecurityContexts as B, buildSessionShareUrl as C, buildMachineShareUrl as D, generateHookSettings as E, DefaultTransport$1 as F, acpBackend as G, acpAgentConfig as H, codexMcpBackend as I, GeminiTransport$1 as J, claudeAuth as K, instanceConfig as L, api as M, run as N, RoutineStore as R, ServeAuth as S, registerSessionService as a, stopDaemon as b, connectToHypha as c, daemonStatus as d, getFrpsSubdomainHost as e, getFrpsServerPort as f, getHyphaServerUrl$1 as g, getFrpsServerAddr as h, getHyphaServerUrl as i, hasCookieToken as j, RoutineRunner as k, getSkillsServer as l, getSkillsWorkspaceName as m, getSkillsCollectionName as n, fetchWithTimeout as o, parseFrontmatter as p, searchSkills as q, registerMachineService as r, startDaemon as s, SKILLS_DIR as t, getSkillInfo as u, downloadSkillFile as v, listSkillFiles as w, normalizeAllowedUser as x, loadSecurityContextConfig as y, resolveSecurityContext as z };
+export { normalizeAllowedUser as A, loadSecurityContextConfig as B, resolveSecurityContext as C, buildSecurityContextFromFlags as D, mergeSecurityContexts as E, buildSessionShareUrl as F, buildMachineShareUrl as G, generateHookSettings as H, DefaultTransport$1 as I, acpBackend as J, acpAgentConfig as K, codexMcpBackend as L, GeminiTransport$1 as M, claudeAuth as N, instanceConfig as O, api as P, run as Q, RoutineStore as R, ServeAuth as S, registerSessionService as a, stopDaemon as b, connectToHypha as c, daemonStatus as d, clearStopMarker as e, stopMarkerExists as f, getHyphaServerUrl$1 as g, getFrpsSubdomainHost as h, getFrpsServerPort as i, getFrpsServerAddr as j, getHyphaServerUrl as k, hasCookieToken as l, RoutineRunner as m, getSkillsServer as n, getSkillsWorkspaceName as o, parseFrontmatter as p, getSkillsCollectionName as q, registerMachineService as r, startDaemon as s, fetchWithTimeout as t, searchSkills as u, SKILLS_DIR as v, getSkillInfo as w, downloadSkillFile as x, listSkillFiles as y, resolveModel as z };