@sna-sdk/core 0.0.9 → 0.1.0

package/dist/scripts/sna.js

@@ -3,6 +3,8 @@ import fs from "fs";
 import net from "net";
 import path from "path";
 import { cmdNew, cmdWorkflow, cmdCancel, cmdTasks } from "./workflow.js";
+import { parseFlags } from "../lib/parse-flags.js";
+import { loadSkillsManifest, SEND_TYPES } from "../lib/dispatch.js";
 const ROOT = process.cwd();
 const STATE_DIR = path.join(ROOT, ".sna");
 const PID_FILE = path.join(STATE_DIR, "server.pid");
@@ -12,7 +14,6 @@ const SNA_API_PID_FILE = path.join(STATE_DIR, "sna-api.pid");
 const SNA_API_PORT_FILE = path.join(STATE_DIR, "sna-api.port");
 const SNA_API_LOG_FILE = path.join(STATE_DIR, "sna-api.log");
 const PORT = process.env.PORT ?? "3000";
-const DB_PATH = path.join(ROOT, "data/app.db");
 const CLAUDE_PATH_FILE = path.join(STATE_DIR, "claude-path");
 const SNA_CORE_DIR = path.join(ROOT, "node_modules/@sna-sdk/core");
 function ensureStateDir() {
@@ -218,13 +219,6 @@ function cmdUp() {
     step("Dependencies ready");
   }
   cmdInit();
-  if (!fs.existsSync(DB_PATH)) {
-    process.stdout.write("  \u2026  Setting up database");
-    execSync("pnpm db:init", { cwd: ROOT, stdio: "pipe" });
-    console.log("\r  \u2713  Database initialized              ");
-  } else {
-    step("Database ready");
-  }
   if (isPortInUse(PORT)) {
     process.stdout.write(`  \u2026  Port ${PORT} busy \u2014 freeing`);
     try {
@@ -357,12 +351,13 @@ function cmdStatus() {
     console.log(`  SNA API      \u2717  stopped`);
     if (snaApiPid) clearSnaApiState();
   }
-  if (fs.existsSync(DB_PATH)) {
-    const stat = fs.statSync(DB_PATH);
+  const snaDbPath = path.join(ROOT, "data/sna.db");
+  if (fs.existsSync(snaDbPath)) {
+    const stat = fs.statSync(snaDbPath);
     const kb = (stat.size / 1024).toFixed(1);
-    console.log(`  Database     \u2713  ${kb} KB  (${DB_PATH})`);
+    console.log(`  SDK DB       \u2713  ${kb} KB  (${snaDbPath})`);
   } else {
-    console.log(`  Database     \u2717  not initialized`);
+    console.log(`  SDK DB       \u2014  not yet created (auto-initializes on first use)`);
   }
   console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
 }
@@ -377,7 +372,7 @@ function cmdInit(force2 = false) {
   const hookCommand = `node "$CLAUDE_PROJECT_DIR"/node_modules/@sna-sdk/core/dist/scripts/hook.js`;
   const permissionHook = {
     matcher: ".*",
-    hooks: [{ type: "command", async: true, command: hookCommand }]
+    hooks: [{ type: "command", command: hookCommand }]
   };
   let settings = {};
   if (fs.existsSync(settingsPath)) {
@@ -387,15 +382,15 @@ function cmdInit(force2 = false) {
     }
   }
   const hooks = settings.hooks ?? {};
-  const existing = hooks.PermissionRequest ?? [];
+  const existing = hooks.PreToolUse ?? [];
   const alreadySet = existing.some(
     (entry) => entry.hooks?.some((h) => h.command === hookCommand)
   );
   if (!alreadySet) {
-    hooks.PermissionRequest = [...existing, permissionHook];
+    hooks.PreToolUse = [...existing, permissionHook];
     settings.hooks = hooks;
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
-    step(".claude/settings.json \u2014 PermissionRequest hook registered");
+    step(".claude/settings.json \u2014 PreToolUse hook registered");
   } else {
     step(".claude/settings.json \u2014 hook already set, skipped");
   }
@@ -429,6 +424,125 @@ function cmdInit(force2 = false) {
   }
   console.log("\n\u2713  SNA init complete");
 }
+function cmdValidate() {
+  console.log("\u25B6  SNA \u2014 validate\n");
+  let ok = true;
+  const manifest = loadSkillsManifest(ROOT);
+  if (!manifest) {
+    console.log("  \u2717  .sna/skills.json not found or malformed \u2014 run 'sna gen client' first");
+    ok = false;
+  } else {
+    const skillNames = Object.keys(manifest);
+    console.log(`  \u2713  .sna/skills.json \u2014 ${skillNames.length} skills registered`);
+    for (const name of skillNames) {
+      const skillMd = path.join(ROOT, ".claude/skills", name, "SKILL.md");
+      if (!fs.existsSync(skillMd)) {
+        console.log(`  \u2717  skill "${name}" registered but .claude/skills/${name}/SKILL.md missing`);
+        ok = false;
+      }
+    }
+    const skillsDir = path.join(ROOT, ".claude/skills");
+    if (fs.existsSync(skillsDir)) {
+      for (const entry of fs.readdirSync(skillsDir)) {
+        const skillMd = path.join(skillsDir, entry, "SKILL.md");
+        if (fs.existsSync(skillMd) && !(entry in manifest)) {
+          console.log(`  \u25B3  skill "${entry}" has SKILL.md but not in skills.json \u2014 run 'sna gen client'`);
+        }
+      }
+    }
+  }
+  const settingsPath = path.join(ROOT, ".claude/settings.json");
+  if (!fs.existsSync(settingsPath)) {
+    console.log("  \u2717  .claude/settings.json not found \u2014 run 'sna init'");
+    ok = false;
+  } else {
+    try {
+      const settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+      const hooks = settings.hooks?.PreToolUse;
+      const hookCommand = `node "$CLAUDE_PROJECT_DIR"/node_modules/@sna-sdk/core/dist/scripts/hook.js`;
+      const hasHook = Array.isArray(hooks) && hooks.some(
+        (entry) => entry.hooks?.some((h) => h.command === hookCommand)
+      );
+      if (hasHook) {
+        console.log("  \u2713  .claude/settings.json \u2014 PreToolUse hook OK");
+      } else {
+        console.log("  \u2717  .claude/settings.json \u2014 PreToolUse hook missing \u2014 run 'sna init'");
+        ok = false;
+      }
+    } catch {
+      console.log("  \u2717  .claude/settings.json is malformed");
+      ok = false;
+    }
+  }
+  const nmPath = path.join(ROOT, "node_modules");
+  if (!fs.existsSync(nmPath)) {
+    console.log("  \u2717  node_modules not found \u2014 run 'pnpm install'");
+    ok = false;
+  } else {
+    console.log("  \u2713  node_modules \u2014 installed");
+  }
+  console.log(ok ? "\n\u2713  Validation passed" : "\n\u2717  Validation failed \u2014 fix issues above");
+  if (!ok) process.exit(1);
+}
+async function cmdDispatch(args2) {
+  const { open, send, close } = await import("../lib/dispatch.js");
+  const sub = args2[0];
+  if (!sub || sub === "--help" || sub === "-h") {
+    console.log(`sna dispatch \u2014 unified event dispatcher
+
+Usage:
+  sna dispatch open --skill <name>              Open a dispatch session \u2192 prints ID
+  sna dispatch <id> called --message "..."      Emit called event
+  sna dispatch <id> start --message "..."       Emit start event
+  sna dispatch <id> milestone --message "..."   Emit milestone event
+  sna dispatch <id> progress --message "..."    Emit progress event
+  sna dispatch <id> close [--message "..."]     Close as success (complete + kill)
+  sna dispatch <id> close --error "..."         Close as error (error + kill)`);
+    return;
+  }
+  if (sub === "open") {
+    const flags2 = parseFlags(args2.slice(1));
+    if (!flags2.skill) {
+      console.error("Usage: sna dispatch open --skill <name>");
+      process.exit(1);
+    }
+    try {
+      const result = open({ skill: flags2.skill, cwd: ROOT });
+      console.log(result.id);
+    } catch (err) {
+      console.error(`\u2717 ${err.message}`);
+      process.exit(1);
+    }
+    return;
+  }
+  const id = sub;
+  const action = args2[1];
+  if (!action) {
+    console.error("Usage: sna dispatch <id> <called|start|milestone|progress|close>");
+    process.exit(1);
+  }
+  const flags = parseFlags(args2.slice(2));
+  try {
+    if (action === "close") {
+      await close(id, {
+        error: flags.error,
+        message: flags.message
+      });
+    } else if (SEND_TYPES.includes(action)) {
+      if (!flags.message) {
+        console.error(`Usage: sna dispatch <id> ${action} --message "..."`);
+        process.exit(1);
+      }
+      send(id, { type: action, message: flags.message, data: flags.data });
+    } else {
+      console.error(`Unknown dispatch action: "${action}". Use ${SEND_TYPES.join(", ")}, or close.`);
+      process.exit(1);
+    }
+  } catch (err) {
+    console.error(`\u2717 ${err.message}`);
+    process.exit(1);
+  }
+}
 function printHelp() {
   console.log(`sna \u2014 Skills-Native Application CLI
 
@@ -441,6 +555,8 @@ Lifecycle:
   sna status          Show running services
   sna restart         Stop + start
   sna init [--force]  Initialize .claude/settings.json and skills
+  sna validate        Check project setup (skills.json, hooks, deps)
+  sna dispatch        Unified event dispatcher (open/send/close)
 
 Workflow:
   sna new <skill> [--param val ...]    Create a task from a workflow.yml
@@ -634,12 +750,22 @@ Run "sna help submit" for data submission patterns.`);
     case "status":
       cmdStatus();
       break;
+    case "validate":
+      cmdValidate();
+      break;
+    case "dispatch":
+      cmdDispatch(args);
+      break;
     case "api:up":
       cmdApiUp();
       break;
     case "api:down":
       cmdApiDown();
       break;
+    case "api:restart":
+      cmdApiDown();
+      cmdApiUp();
+      break;
     case "restart":
       cmdDown();
       console.log();

package/dist/scripts/workflow.js

@@ -2,7 +2,7 @@ import { execSync } from "child_process";
 import fs from "fs";
 import path from "path";
 import yaml from "js-yaml";
-import { getDb } from "../db/schema.js";
+import { createHandle } from "../lib/dispatch.js";
 const ROOT = process.cwd();
 const TASKS_DIR = path.join(ROOT, ".sna", "tasks");
 function ensureTasksDir() {
@@ -53,22 +53,6 @@ function interpolate(template, context) {
     return String(val);
   });
 }
-function emitEvent(skill, type, message) {
-  const db = getDb();
-  db.prepare(`
-    INSERT INTO skill_events (skill, type, message)
-    VALUES (?, ?, ?)
-  `).run(skill, type, message);
-  const prefix = {
-    start: "\u25B6",
-    progress: "\xB7",
-    milestone: "\u25C6",
-    complete: "\u2713",
-    error: "\u2717"
-  };
-  const p = prefix[type] ?? "\xB7";
-  console.log(`${p} [${skill}] ${message}`);
-}
 function kebabToSnake(s) {
   return s.replace(/-/g, "_");
 }
@@ -353,7 +337,7 @@ function displayStep(step, stepIndex, totalSteps, context, taskId) {
     printRequiredSubmission(afterFields, taskId);
   }
 }
-function autoAdvance(task, workflow) {
+function autoAdvance(task, workflow, d) {
   while (task.current_step < workflow.steps.length) {
     const step = workflow.steps[task.current_step];
     if (!step.exec) break;
@@ -365,8 +349,7 @@ function autoAdvance(task, workflow) {
       Object.assign(task.context, extracted);
       task.steps[step.id] = { status: "completed" };
       if (step.event) {
-        const msg = interpolate(step.event, task.context);
-        emitEvent(workflow.skill, "milestone", msg);
+        d.milestone(interpolate(step.event, task.context));
       }
       console.log(" done");
     } catch (err) {
@@ -375,7 +358,7 @@ function autoAdvance(task, workflow) {
       task.steps[step.id] = { status: "error" };
       task.status = "error";
       saveTask(task);
-      emitEvent(workflow.skill, "error", interpolate(workflow.error, { ...task.context, error: msg }));
+      d.close({ error: interpolate(workflow.error, { ...task.context, error: msg }) });
       process.exit(1);
     }
     task.current_step++;
@@ -404,12 +387,14 @@ function cmdNew(args) {
   };
   saveTask(task);
   console.log(`\u25B6 Task ${taskId} created (${workflow.skill})`);
-  emitEvent(workflow.skill, "start", `Task ${taskId} started`);
+  const d = createHandle({ skill: workflow.skill });
+  d.called(`Task ${taskId} created`);
+  d.start(`Task ${taskId} started`);
   const firstStep = workflow.steps[0];
   if (firstStep) {
     task.steps[firstStep.id] = { status: "in_progress" };
   }
-  const advanced = autoAdvance(task, workflow);
+  const advanced = autoAdvance(task, workflow, d);
   if (advanced.current_step < workflow.steps.length) {
     const currentStep = workflow.steps[advanced.current_step];
     advanced.steps[currentStep.id] = { status: "in_progress" };
@@ -419,7 +404,7 @@ function cmdNew(args) {
     advanced.status = "completed";
     saveTask(advanced);
     const msg = interpolate(workflow.complete, advanced.context);
-    emitEvent(workflow.skill, "complete", msg);
+    d.close({ message: msg });
     console.log(`
 ${msg}`);
   }
@@ -428,6 +413,7 @@ function cmdWorkflow(taskId, args) {
   const subcommand = args[0];
   const task = loadTask(taskId);
   const workflow = loadWorkflow(task.skill);
+  const d = createHandle({ skill: workflow.skill });
   if (subcommand === "start") {
     if (task.status === "completed") {
       console.error(`Task ${taskId} is already completed.`);
@@ -444,7 +430,8 @@ function cmdWorkflow(taskId, args) {
       saveTask(task);
       console.log(`\u21BB Retrying from step ${task.current_step + 1}/${workflow.steps.length}: ${currentStep.name}`);
     }
-    const advanced = autoAdvance(task, workflow);
+    d.start(`Task ${taskId} resumed`);
+    const advanced = autoAdvance(task, workflow, d);
     if (advanced.current_step < workflow.steps.length) {
       const currentStep = workflow.steps[advanced.current_step];
       advanced.steps[currentStep.id] = { status: "in_progress" };
@@ -454,7 +441,7 @@ function cmdWorkflow(taskId, args) {
       advanced.status = "completed";
       saveTask(advanced);
       const msg = interpolate(workflow.complete, advanced.context);
-      emitEvent(workflow.skill, "complete", msg);
+      d.close({ message: msg });
       console.log(`
 ${msg}`);
     }
@@ -485,7 +472,7 @@ ${msg}`);
           task.steps[currentStep.id] = { status: "error" };
           task.status = "error";
           saveTask(task);
-          emitEvent(workflow.skill, "error", interpolate(workflow.error, { ...task.context, error: msg }));
+          d.close({ error: interpolate(workflow.error, { ...task.context, error: msg }) });
           process.exit(1);
         }
       } else {
@@ -493,11 +480,10 @@ ${msg}`);
       }
       task.steps[currentStep.id] = { status: "completed" };
       if (currentStep.event) {
-        const msg = interpolate(currentStep.event, task.context);
-        emitEvent(workflow.skill, "milestone", msg);
+        d.milestone(interpolate(currentStep.event, task.context));
       }
       task.current_step++;
-      const advanced2 = autoAdvance(task, workflow);
+      const advanced2 = autoAdvance(task, workflow, d);
       if (advanced2.current_step < workflow.steps.length) {
         const nextStep = workflow.steps[advanced2.current_step];
         advanced2.steps[nextStep.id] = { status: "in_progress" };
@@ -507,7 +493,7 @@ ${msg}`);
         advanced2.status = "completed";
         saveTask(advanced2);
         const msg = interpolate(workflow.complete, advanced2.context);
-        emitEvent(workflow.skill, "complete", msg);
+        d.close({ message: msg });
         console.log(`
 ${msg}`);
       }
@@ -518,11 +504,10 @@ ${msg}`);
     Object.assign(task.context, validated);
     task.steps[currentStep.id] = { status: "completed" };
     if (currentStep.event) {
-      const msg = interpolate(currentStep.event, task.context);
-      emitEvent(workflow.skill, "milestone", msg);
+      d.milestone(interpolate(currentStep.event, task.context));
     }
     task.current_step++;
-    const advanced = autoAdvance(task, workflow);
+    const advanced = autoAdvance(task, workflow, d);
     if (advanced.current_step < workflow.steps.length) {
       const nextStep = workflow.steps[advanced.current_step];
       advanced.steps[nextStep.id] = { status: "in_progress" };
@@ -532,7 +517,7 @@ ${msg}`);
       advanced.status = "completed";
       saveTask(advanced);
       const msg = interpolate(workflow.complete, advanced.context);
-      emitEvent(workflow.skill, "complete", msg);
+      d.close({ message: msg });
       console.log(`
 ${msg}`);
     }
@@ -558,7 +543,8 @@ function cmdCancel(taskId) {
   }
   task.status = "cancelled";
   saveTask(task);
-  emitEvent(workflow.skill, "error", `Task ${taskId} cancelled`);
+  const d = createHandle({ skill: workflow.skill });
+  d.close({ error: `Task ${taskId} cancelled` });
   console.log(`\u2717 Task ${taskId} cancelled`);
 }
 function cmdTasks() {

package/dist/server/routes/agent.js

@@ -56,15 +56,19 @@ function createAgentRoutes(sessionManager) {
     }
     session.eventBuffer.length = 0;
     const provider = getProvider(body.provider ?? "claude-code");
-    const skillMatch = body.prompt?.match(/^Execute the skill:\s*(\S+)/);
-    if (skillMatch) {
-      try {
-        const db = getDb();
+    try {
+      const db = getDb();
+      db.prepare(`INSERT OR IGNORE INTO chat_sessions (id, label, type) VALUES (?, ?, 'main')`).run(sessionId, session.label ?? sessionId);
+      if (body.prompt) {
+        db.prepare(`INSERT INTO chat_messages (session_id, role, content, meta) VALUES (?, 'user', ?, ?)`).run(sessionId, body.prompt, body.meta ? JSON.stringify(body.meta) : null);
+      }
+      const skillMatch = body.prompt?.match(/^Execute the skill:\s*(\S+)/);
+      if (skillMatch) {
         db.prepare(
           `INSERT INTO skill_events (session_id, skill, type, message) VALUES (?, ?, 'invoked', ?)`
         ).run(sessionId, skillMatch[1], `Skill ${skillMatch[1]} invoked`);
-      } catch {
       }
+    } catch {
     }
     try {
       const proc = provider.spawn({
@@ -72,7 +76,8 @@ function createAgentRoutes(sessionManager) {
         prompt: body.prompt,
         model: body.model ?? "claude-sonnet-4-6",
         permissionMode: body.permissionMode ?? "acceptEdits",
-        env: { SNA_SESSION_ID: sessionId }
+        env: { SNA_SESSION_ID: sessionId },
+        extraArgs: body.extraArgs
       });
       sessionManager.setProcess(sessionId, proc);
       logger.log("route", `POST /start?session=${sessionId} \u2192 started`);
@@ -101,6 +106,13 @@ function createAgentRoutes(sessionManager) {
       logger.err("err", `POST /send?session=${sessionId} \u2192 empty message`);
       return c.json({ status: "error", message: "message is required" }, 400);
     }
+    try {
+      const db = getDb();
+      db.prepare(`INSERT OR IGNORE INTO chat_sessions (id, label, type) VALUES (?, ?, 'main')`).run(sessionId, session.label ?? sessionId);
+      db.prepare(`INSERT INTO chat_messages (session_id, role, content, meta) VALUES (?, 'user', ?, ?)`).run(sessionId, body.message, body.meta ? JSON.stringify(body.meta) : null);
+    } catch {
+    }
+    session.state = "processing";
     sessionManager.touch(sessionId);
     logger.log("route", `POST /send?session=${sessionId} \u2192 "${body.message.slice(0, 80)}"`);
     session.process.send(body.message);
@@ -153,6 +165,63 @@ function createAgentRoutes(sessionManager) {
       eventCount: session?.eventCounter ?? 0
     });
   });
+  const pendingPermissions = /* @__PURE__ */ new Map();
+  app.post("/permission-request", async (c) => {
+    const sessionId = getSessionId(c);
+    const body = await c.req.json().catch(() => ({}));
+    logger.log("route", `POST /permission-request?session=${sessionId} \u2192 ${body.tool_name}`);
+    const session = sessionManager.getSession(sessionId);
+    if (session) session.state = "permission";
+    const result = await new Promise((resolve) => {
+      pendingPermissions.set(sessionId, {
+        resolve,
+        request: body,
+        createdAt: Date.now()
+      });
+      setTimeout(() => {
+        if (pendingPermissions.has(sessionId)) {
+          pendingPermissions.delete(sessionId);
+          resolve(false);
+        }
+      }, 3e5);
+    });
+    return c.json({ approved: result });
+  });
+  app.post("/permission-respond", async (c) => {
+    const sessionId = getSessionId(c);
+    const body = await c.req.json().catch(() => ({}));
+    const approved = body.approved ?? false;
+    const pending = pendingPermissions.get(sessionId);
+    if (!pending) {
+      return c.json({ status: "error", message: "No pending permission request" }, 404);
+    }
+    pending.resolve(approved);
+    pendingPermissions.delete(sessionId);
+    const session = sessionManager.getSession(sessionId);
+    if (session) session.state = "processing";
+    logger.log("route", `POST /permission-respond?session=${sessionId} \u2192 ${approved ? "approved" : "denied"}`);
+    return c.json({ status: approved ? "approved" : "denied" });
+  });
+  app.get("/permission-pending", (c) => {
+    const sessionId = c.req.query("session");
+    if (sessionId) {
+      const pending = pendingPermissions.get(sessionId);
+      if (!pending) return c.json({ pending: null });
+      return c.json({
+        pending: {
+          sessionId,
+          request: pending.request,
+          createdAt: pending.createdAt
+        }
+      });
+    }
+    const all = Array.from(pendingPermissions.entries()).map(([id, p]) => ({
+      sessionId: id,
+      request: p.request,
+      createdAt: p.createdAt
+    }));
+    return c.json({ pending: all });
+  });
   return app;
 }
 export {

package/dist/server/routes/chat.js

@@ -3,37 +3,53 @@ import { getDb } from "../../db/schema.js";
 function createChatRoutes() {
   const app = new Hono();
   app.get("/sessions", (c) => {
-    const db = getDb();
-    const sessions = db.prepare(
-      `SELECT id, label, type, created_at FROM chat_sessions ORDER BY created_at DESC`
-    ).all();
-    return c.json({ sessions });
+    try {
+      const db = getDb();
+      const sessions = db.prepare(
+        `SELECT id, label, type, created_at FROM chat_sessions ORDER BY created_at DESC`
+      ).all();
+      return c.json({ sessions });
+    } catch (e) {
+      return c.json({ status: "error", message: e.message, stack: e.stack }, 500);
+    }
   });
   app.post("/sessions", async (c) => {
     const body = await c.req.json().catch(() => ({}));
     const id = body.id ?? crypto.randomUUID().slice(0, 8);
-    const db = getDb();
-    db.prepare(
-      `INSERT OR IGNORE INTO chat_sessions (id, label, type) VALUES (?, ?, ?)`
-    ).run(id, body.label ?? id, body.type ?? "background");
-    return c.json({ status: "created", id });
+    try {
+      const db = getDb();
+      db.prepare(
+        `INSERT OR IGNORE INTO chat_sessions (id, label, type) VALUES (?, ?, ?)`
+      ).run(id, body.label ?? id, body.type ?? "background");
+      return c.json({ status: "created", id });
+    } catch (e) {
+      return c.json({ status: "error", message: e.message }, 500);
+    }
   });
   app.delete("/sessions/:id", (c) => {
     const id = c.req.param("id");
     if (id === "default") {
       return c.json({ status: "error", message: "Cannot delete default session" }, 400);
     }
-    const db = getDb();
-    db.prepare(`DELETE FROM chat_sessions WHERE id = ?`).run(id);
-    return c.json({ status: "deleted" });
+    try {
+      const db = getDb();
+      db.prepare(`DELETE FROM chat_sessions WHERE id = ?`).run(id);
+      return c.json({ status: "deleted" });
+    } catch (e) {
+      return c.json({ status: "error", message: e.message }, 500);
+    }
   });
   app.get("/sessions/:id/messages", (c) => {
     const id = c.req.param("id");
     const sinceParam = c.req.query("since");
-    const db = getDb();
-    const query = sinceParam ? db.prepare(`SELECT * FROM chat_messages WHERE session_id = ? AND id > ? ORDER BY id ASC`) : db.prepare(`SELECT * FROM chat_messages WHERE session_id = ? ORDER BY id ASC`);
-    const messages = sinceParam ? query.all(id, parseInt(sinceParam, 10)) : query.all(id);
-    return c.json({ messages });
+    try {
+      const db = getDb();
+      const query = sinceParam ? db.prepare(`SELECT * FROM chat_messages WHERE session_id = ? AND id > ? ORDER BY id ASC`) : db.prepare(`SELECT * FROM chat_messages WHERE session_id = ? ORDER BY id ASC`);
+      const messages = sinceParam ? query.all(id, parseInt(sinceParam, 10)) : query.all(id);
+      return c.json({ messages });
+    } catch (e) {
+      return c.json({ status: "error", message: e.message, stack: e.stack }, 500);
+    }
   });
   app.post("/sessions/:id/messages", async (c) => {
     const sessionId = c.req.param("id");
@@ -41,24 +57,32 @@ function createChatRoutes() {
     if (!body.role) {
       return c.json({ status: "error", message: "role is required" }, 400);
     }
-    const db = getDb();
-    db.prepare(`INSERT OR IGNORE INTO chat_sessions (id, label, type) VALUES (?, ?, 'main')`).run(sessionId, sessionId);
-    const result = db.prepare(
-      `INSERT INTO chat_messages (session_id, role, content, skill_name, meta) VALUES (?, ?, ?, ?, ?)`
-    ).run(
-      sessionId,
-      body.role,
-      body.content ?? "",
-      body.skill_name ?? null,
-      body.meta ? JSON.stringify(body.meta) : null
-    );
-    return c.json({ status: "created", id: result.lastInsertRowid });
+    try {
+      const db = getDb();
+      db.prepare(`INSERT OR IGNORE INTO chat_sessions (id, label, type) VALUES (?, ?, 'main')`).run(sessionId, sessionId);
+      const result = db.prepare(
+        `INSERT INTO chat_messages (session_id, role, content, skill_name, meta) VALUES (?, ?, ?, ?, ?)`
+      ).run(
+        sessionId,
+        body.role,
+        body.content ?? "",
+        body.skill_name ?? null,
+        body.meta ? JSON.stringify(body.meta) : null
+      );
+      return c.json({ status: "created", id: result.lastInsertRowid });
+    } catch (e) {
+      return c.json({ status: "error", message: e.message }, 500);
+    }
   });
   app.delete("/sessions/:id/messages", (c) => {
     const id = c.req.param("id");
-    const db = getDb();
-    db.prepare(`DELETE FROM chat_messages WHERE session_id = ?`).run(id);
-    return c.json({ status: "cleared" });
+    try {
+      const db = getDb();
+      db.prepare(`DELETE FROM chat_messages WHERE session_id = ?`).run(id);
+      return c.json({ status: "cleared" });
+    } catch (e) {
+      return c.json({ status: "error", message: e.message }, 500);
+    }
   });
   return app;
 }

package/dist/server/session-manager.d.ts

@@ -7,6 +7,7 @@ import { AgentProcess, AgentEvent } from '../core/providers/types.js';
  * The default "default" session provides backward compatibility.
  */
 
+type SessionState = "idle" | "processing" | "waiting" | "permission";
 interface Session {
     id: string;
     process: AgentProcess | null;
@@ -14,6 +15,7 @@ interface Session {
     eventCounter: number;
     label: string;
     cwd: string;
+    state: SessionState;
     createdAt: number;
     lastActivityAt: number;
 }
@@ -21,6 +23,7 @@ interface SessionInfo {
     id: string;
     label: string;
     alive: boolean;
+    state: SessionState;
     cwd: string;
     eventCount: number;
     createdAt: number;
@@ -56,9 +59,11 @@ declare class SessionManager {
     listSessions(): SessionInfo[];
     /** Touch a session's lastActivityAt timestamp. */
     touch(id: string): void;
+    /** Persist an agent event to chat_messages. */
+    private persistEvent;
     /** Kill all sessions. Used during shutdown. */
     killAll(): void;
     get size(): number;
 }
 
-export { type Session, type SessionInfo, SessionManager, type SessionManagerOptions };
+export { type Session, type SessionInfo, SessionManager, type SessionManagerOptions, type SessionState };