@sna-sdk/core 0.7.1 → 0.8.0

package/dist/scripts/sna.js

@@ -1008,7 +1008,9 @@ Run "sna help submit" for data submission patterns.`);
       cmdApiUp();
       break;
     case "tu":
-      cmdTu(args);
+      console.log('  "sna tu" has moved to @sna-sdk/testing.');
+      console.log('  Install it and use "sna-test" instead.');
+      console.log('  e.g. sna-test api:up, sna-test claude "hello"');
       break;
     case "restart":
       cmdDown();

package/dist/server/api-types.d.ts

@@ -49,7 +49,7 @@ interface ApiResponses {
     };
     "agent.set-permission-mode": {
         status: "updated" | "no_session";
-        permissionMode: string;
+        permissionMode?: string;
     };
     "agent.kill": {
         status: "killed" | "no_session";
@@ -69,7 +69,7 @@ interface ApiResponses {
         config: {
             provider: string;
             model: string;
-            permissionMode: string;
+            permissionMode?: string;
             extraArgs?: string[];
         } | null;
     };

package/dist/server/routes/agent.js

@@ -142,7 +142,7 @@ function createAgentRoutes(sessionManager) {
     }
     const providerName = body.provider ?? "claude-code";
     const model = body.model ?? "claude-sonnet-4-6";
-    const permissionMode = body.permissionMode ?? "acceptEdits";
+    const permissionMode = body.permissionMode;
     const extraArgs = body.extraArgs;
     try {
       const proc = provider.spawn({
@@ -253,7 +253,7 @@ function createAgentRoutes(sessionManager) {
         } else {
           cursor = session.eventCounter;
         }
-        while (queue.length > 0 && queue[0].cursor <= cursor) queue.shift();
+        while (queue.length > 0 && queue[0].cursor !== -1 && queue[0].cursor <= cursor) queue.shift();
         while (!signal.aborted) {
           if (queue.length === 0) {
             await Promise.race([
@@ -267,7 +267,11 @@ function createAgentRoutes(sessionManager) {
           if (queue.length > 0) {
             while (queue.length > 0) {
               const item = queue.shift();
-              await stream.writeSSE({ id: String(item.cursor), data: JSON.stringify(item.event) });
+              if (item.cursor === -1) {
+                await stream.writeSSE({ data: JSON.stringify(item.event) });
+              } else {
+                await stream.writeSSE({ id: String(item.cursor), data: JSON.stringify(item.event) });
+              }
             }
           } else {
             await stream.writeSSE({ data: "" });
@@ -318,7 +322,7 @@ function createAgentRoutes(sessionManager) {
     }
     const providerName = body.provider ?? "claude-code";
     const model = body.model ?? session.lastStartConfig?.model ?? "claude-sonnet-4-6";
-    const permissionMode = body.permissionMode ?? session.lastStartConfig?.permissionMode ?? "acceptEdits";
+    const permissionMode = body.permissionMode ?? session.lastStartConfig?.permissionMode;
     const extraArgs = body.extraArgs ?? session.lastStartConfig?.extraArgs;
     const provider = getProvider(providerName);
     try {

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

@@ -11,7 +11,7 @@ type SessionState = "idle" | "processing" | "waiting" | "permission";
 interface StartConfig {
     provider: string;
     model: string;
-    permissionMode: string;
+    permissionMode?: string;
     extraArgs?: string[];
 }
 interface Session {
@@ -108,6 +108,12 @@ declare class SessionManager {
     /** Broadcast a skill event to all subscribers (called after DB insert). */
     broadcastSkillEvent(event: Record<string, unknown>): void;
     /** Push a synthetic event into a session's event stream (for user message broadcast). */
+    /**
+     * Push an externally-persisted event into the session.
+     * The caller is responsible for DB persistence — this method only updates
+     * the in-memory counter/buffer and notifies listeners.
+     * eventCounter increments to stay in sync with the DB row count.
+     */
     pushEvent(sessionId: string, event: AgentEvent): void;
     /** Subscribe to permission request notifications. Returns unsubscribe function. */
     onPermissionRequest(cb: (sessionId: string, request: Record<string, unknown>, createdAt: number) => void): () => void;
@@ -165,6 +171,7 @@ declare class SessionManager {
     touch(id: string): void;
     /** Persist an agent event to chat_messages. */
     private getMessageStats;
+    /** Persist an agent event to chat_messages. Returns true if a row was inserted. */
     private persistEvent;
     /** Kill all sessions. Used during shutdown. */
     killAll(): void;

package/dist/server/session-manager.js

@@ -143,22 +143,27 @@ class SessionManager {
         }
         this.setSessionState(sessionId, session, "waiting");
       }
-      if (e.type !== "assistant_delta") {
-        session.eventBuffer.push(e);
-        if (session.eventBuffer.length > MAX_EVENT_BUFFER) {
-          session.eventBuffer.splice(0, session.eventBuffer.length - MAX_EVENT_BUFFER);
-        }
-      }
-      session.eventCounter++;
       if (e.type === "thinking" || e.type === "tool_use" || e.type === "assistant_delta") {
         this.setSessionState(sessionId, session, "processing");
       } else if (e.type === "complete" || e.type === "error" || e.type === "interrupted") {
         this.setSessionState(sessionId, session, "waiting");
       }
-      this.persistEvent(sessionId, e);
-      const listeners = this.eventListeners.get(sessionId);
-      if (listeners) {
-        for (const cb of listeners) cb(session.eventCounter, e);
+      const persisted = this.persistEvent(sessionId, e);
+      if (persisted) {
+        session.eventCounter++;
+        session.eventBuffer.push(e);
+        if (session.eventBuffer.length > MAX_EVENT_BUFFER) {
+          session.eventBuffer.splice(0, session.eventBuffer.length - MAX_EVENT_BUFFER);
+        }
+        const listeners = this.eventListeners.get(sessionId);
+        if (listeners) {
+          for (const cb of listeners) cb(session.eventCounter, e);
+        }
+      } else if (e.type === "assistant_delta") {
+        const listeners = this.eventListeners.get(sessionId);
+        if (listeners) {
+          for (const cb of listeners) cb(-1, e);
+        }
       }
     });
     proc.on("exit", (code) => {
@@ -196,11 +201,17 @@ class SessionManager {
     for (const cb of this.skillEventListeners) cb(event);
   }
   /** Push a synthetic event into a session's event stream (for user message broadcast). */
+  /**
+   * Push an externally-persisted event into the session.
+   * The caller is responsible for DB persistence — this method only updates
+   * the in-memory counter/buffer and notifies listeners.
+   * eventCounter increments to stay in sync with the DB row count.
+   */
   pushEvent(sessionId, event) {
     const session = this.sessions.get(sessionId);
     if (!session) return;
-    session.eventBuffer.push(event);
     session.eventCounter++;
+    session.eventBuffer.push(event);
     if (session.eventBuffer.length > MAX_EVENT_BUFFER) {
       session.eventBuffer.splice(0, session.eventBuffer.length - MAX_EVENT_BUFFER);
     }
@@ -425,6 +436,7 @@ class SessionManager {
       return { messageCount: 0, lastMessage: null };
     }
   }
+  /** Persist an agent event to chat_messages. Returns true if a row was inserted. */
   persistEvent(sessionId, e) {
     try {
       const db = getDb();
@@ -432,29 +444,34 @@ class SessionManager {
         case "assistant":
           if (e.message) {
             db.prepare(`INSERT INTO chat_messages (session_id, role, content) VALUES (?, 'assistant', ?)`).run(sessionId, e.message);
+            return true;
           }
-          break;
+          return false;
         case "thinking":
           if (e.message) {
             db.prepare(`INSERT INTO chat_messages (session_id, role, content) VALUES (?, 'thinking', ?)`).run(sessionId, e.message);
+            return true;
           }
-          break;
+          return false;
         case "tool_use": {
           const toolName = e.data?.toolName ?? e.message ?? "tool";
           db.prepare(`INSERT INTO chat_messages (session_id, role, content, meta) VALUES (?, 'tool', ?, ?)`).run(sessionId, toolName, JSON.stringify(e.data ?? {}));
-          break;
+          return true;
         }
         case "tool_result":
           db.prepare(`INSERT INTO chat_messages (session_id, role, content, meta) VALUES (?, 'tool_result', ?, ?)`).run(sessionId, e.message ?? "", JSON.stringify(e.data ?? {}));
-          break;
+          return true;
         case "complete":
           db.prepare(`INSERT INTO chat_messages (session_id, role, content, meta) VALUES (?, 'status', '', ?)`).run(sessionId, JSON.stringify({ status: "complete", ...e.data }));
-          break;
+          return true;
         case "error":
           db.prepare(`INSERT INTO chat_messages (session_id, role, content, meta) VALUES (?, 'error', ?, ?)`).run(sessionId, e.message ?? "Error", JSON.stringify({ status: "error" }));
-          break;
+          return true;
+        default:
+          return false;
       }
     } catch {
+      return false;
     }
   }
   /** Kill all sessions. Used during shutdown. */

package/dist/server/standalone.js

@@ -1004,7 +1004,7 @@ function createAgentRoutes(sessionManager2) {
     }
     const providerName = body.provider ?? "claude-code";
     const model = body.model ?? "claude-sonnet-4-6";
-    const permissionMode2 = body.permissionMode ?? "acceptEdits";
+    const permissionMode2 = body.permissionMode;
     const extraArgs = body.extraArgs;
     try {
       const proc = provider2.spawn({
@@ -1115,7 +1115,7 @@ function createAgentRoutes(sessionManager2) {
         } else {
           cursor = session.eventCounter;
         }
-        while (queue.length > 0 && queue[0].cursor <= cursor) queue.shift();
+        while (queue.length > 0 && queue[0].cursor !== -1 && queue[0].cursor <= cursor) queue.shift();
         while (!signal.aborted) {
           if (queue.length === 0) {
             await Promise.race([
@@ -1129,7 +1129,11 @@ function createAgentRoutes(sessionManager2) {
           if (queue.length > 0) {
             while (queue.length > 0) {
               const item = queue.shift();
-              await stream.writeSSE({ id: String(item.cursor), data: JSON.stringify(item.event) });
+              if (item.cursor === -1) {
+                await stream.writeSSE({ data: JSON.stringify(item.event) });
+              } else {
+                await stream.writeSSE({ id: String(item.cursor), data: JSON.stringify(item.event) });
+              }
             }
           } else {
             await stream.writeSSE({ data: "" });
@@ -1180,7 +1184,7 @@ function createAgentRoutes(sessionManager2) {
     }
     const providerName = body.provider ?? "claude-code";
     const model = body.model ?? session.lastStartConfig?.model ?? "claude-sonnet-4-6";
-    const permissionMode2 = body.permissionMode ?? session.lastStartConfig?.permissionMode ?? "acceptEdits";
+    const permissionMode2 = body.permissionMode ?? session.lastStartConfig?.permissionMode;
     const extraArgs = body.extraArgs ?? session.lastStartConfig?.extraArgs;
     const provider2 = getProvider(providerName);
     try {
@@ -1544,22 +1548,27 @@ var SessionManager = class {
         }
         this.setSessionState(sessionId, session, "waiting");
       }
-      if (e.type !== "assistant_delta") {
-        session.eventBuffer.push(e);
-        if (session.eventBuffer.length > MAX_EVENT_BUFFER) {
-          session.eventBuffer.splice(0, session.eventBuffer.length - MAX_EVENT_BUFFER);
-        }
-      }
-      session.eventCounter++;
       if (e.type === "thinking" || e.type === "tool_use" || e.type === "assistant_delta") {
         this.setSessionState(sessionId, session, "processing");
       } else if (e.type === "complete" || e.type === "error" || e.type === "interrupted") {
         this.setSessionState(sessionId, session, "waiting");
       }
-      this.persistEvent(sessionId, e);
-      const listeners = this.eventListeners.get(sessionId);
-      if (listeners) {
-        for (const cb of listeners) cb(session.eventCounter, e);
+      const persisted = this.persistEvent(sessionId, e);
+      if (persisted) {
+        session.eventCounter++;
+        session.eventBuffer.push(e);
+        if (session.eventBuffer.length > MAX_EVENT_BUFFER) {
+          session.eventBuffer.splice(0, session.eventBuffer.length - MAX_EVENT_BUFFER);
+        }
+        const listeners = this.eventListeners.get(sessionId);
+        if (listeners) {
+          for (const cb of listeners) cb(session.eventCounter, e);
+        }
+      } else if (e.type === "assistant_delta") {
+        const listeners = this.eventListeners.get(sessionId);
+        if (listeners) {
+          for (const cb of listeners) cb(-1, e);
+        }
       }
     });
     proc.on("exit", (code) => {
@@ -1597,11 +1606,17 @@ var SessionManager = class {
     for (const cb of this.skillEventListeners) cb(event);
   }
   /** Push a synthetic event into a session's event stream (for user message broadcast). */
+  /**
+   * Push an externally-persisted event into the session.
+   * The caller is responsible for DB persistence — this method only updates
+   * the in-memory counter/buffer and notifies listeners.
+   * eventCounter increments to stay in sync with the DB row count.
+   */
   pushEvent(sessionId, event) {
     const session = this.sessions.get(sessionId);
     if (!session) return;
-    session.eventBuffer.push(event);
     session.eventCounter++;
+    session.eventBuffer.push(event);
     if (session.eventBuffer.length > MAX_EVENT_BUFFER) {
       session.eventBuffer.splice(0, session.eventBuffer.length - MAX_EVENT_BUFFER);
     }
@@ -1826,6 +1841,7 @@ var SessionManager = class {
       return { messageCount: 0, lastMessage: null };
     }
   }
+  /** Persist an agent event to chat_messages. Returns true if a row was inserted. */
   persistEvent(sessionId, e) {
     try {
       const db = getDb();
@@ -1833,29 +1849,34 @@ var SessionManager = class {
         case "assistant":
           if (e.message) {
             db.prepare(`INSERT INTO chat_messages (session_id, role, content) VALUES (?, 'assistant', ?)`).run(sessionId, e.message);
+            return true;
           }
-          break;
+          return false;
         case "thinking":
           if (e.message) {
             db.prepare(`INSERT INTO chat_messages (session_id, role, content) VALUES (?, 'thinking', ?)`).run(sessionId, e.message);
+            return true;
           }
-          break;
+          return false;
         case "tool_use": {
           const toolName = e.data?.toolName ?? e.message ?? "tool";
           db.prepare(`INSERT INTO chat_messages (session_id, role, content, meta) VALUES (?, 'tool', ?, ?)`).run(sessionId, toolName, JSON.stringify(e.data ?? {}));
-          break;
+          return true;
         }
         case "tool_result":
           db.prepare(`INSERT INTO chat_messages (session_id, role, content, meta) VALUES (?, 'tool_result', ?, ?)`).run(sessionId, e.message ?? "", JSON.stringify(e.data ?? {}));
-          break;
+          return true;
         case "complete":
           db.prepare(`INSERT INTO chat_messages (session_id, role, content, meta) VALUES (?, 'status', '', ?)`).run(sessionId, JSON.stringify({ status: "complete", ...e.data }));
-          break;
+          return true;
         case "error":
           db.prepare(`INSERT INTO chat_messages (session_id, role, content, meta) VALUES (?, 'error', ?, ?)`).run(sessionId, e.message ?? "Error", JSON.stringify({ status: "error" }));
-          break;
+          return true;
+        default:
+          return false;
       }
     } catch {
+      return false;
     }
   }
   /** Kill all sessions. Used during shutdown. */
@@ -2084,7 +2105,7 @@ function handleAgentStart(ws, msg, sm) {
   }
   const providerName = msg.provider ?? "claude-code";
   const model = msg.model ?? "claude-sonnet-4-6";
-  const permissionMode2 = msg.permissionMode ?? "acceptEdits";
+  const permissionMode2 = msg.permissionMode;
   const extraArgs = msg.extraArgs;
   try {
     const proc = provider2.spawn({
@@ -2159,7 +2180,7 @@ function handleAgentResume(ws, msg, sm) {
   }
   const providerName = msg.provider ?? session.lastStartConfig?.provider ?? "claude-code";
   const model = msg.model ?? session.lastStartConfig?.model ?? "claude-sonnet-4-6";
-  const permissionMode2 = msg.permissionMode ?? session.lastStartConfig?.permissionMode ?? "acceptEdits";
+  const permissionMode2 = msg.permissionMode ?? session.lastStartConfig?.permissionMode;
   const extraArgs = msg.extraArgs ?? session.lastStartConfig?.extraArgs;
   const provider2 = getProvider(providerName);
   try {
@@ -2326,7 +2347,11 @@ function handleAgentSubscribe(ws, msg, sm, state) {
     }
   }
   const unsub = sm.onSessionEvent(sessionId, (eventCursor, event) => {
-    send(ws, { type: "agent.event", session: sessionId, cursor: eventCursor, event });
+    if (eventCursor === -1) {
+      send(ws, { type: "agent.event", session: sessionId, event });
+    } else {
+      send(ws, { type: "agent.event", session: sessionId, cursor: eventCursor, event });
+    }
   });
   state.agentUnsubs.set(sessionId, unsub);
   reply(ws, msg, { cursor });
@@ -2562,7 +2587,7 @@ try {
   process.exit(1);
 }
 var port = parseInt(process.env.SNA_PORT ?? "3099", 10);
-var permissionMode = process.env.SNA_PERMISSION_MODE ?? "acceptEdits";
+var permissionMode = process.env.SNA_PERMISSION_MODE;
 var defaultModel = process.env.SNA_MODEL ?? "claude-sonnet-4-6";
 var maxSessions = parseInt(process.env.SNA_MAX_SESSIONS ?? "5", 10);
 var root = new Hono4();

package/dist/server/ws.js

@@ -217,7 +217,7 @@ function handleAgentStart(ws, msg, sm) {
   }
   const providerName = msg.provider ?? "claude-code";
   const model = msg.model ?? "claude-sonnet-4-6";
-  const permissionMode = msg.permissionMode ?? "acceptEdits";
+  const permissionMode = msg.permissionMode;
   const extraArgs = msg.extraArgs;
   try {
     const proc = provider.spawn({
@@ -292,7 +292,7 @@ function handleAgentResume(ws, msg, sm) {
   }
   const providerName = msg.provider ?? session.lastStartConfig?.provider ?? "claude-code";
   const model = msg.model ?? session.lastStartConfig?.model ?? "claude-sonnet-4-6";
-  const permissionMode = msg.permissionMode ?? session.lastStartConfig?.permissionMode ?? "acceptEdits";
+  const permissionMode = msg.permissionMode ?? session.lastStartConfig?.permissionMode;
   const extraArgs = msg.extraArgs ?? session.lastStartConfig?.extraArgs;
   const provider = getProvider(providerName);
   try {
@@ -459,7 +459,11 @@ function handleAgentSubscribe(ws, msg, sm, state) {
     }
   }
   const unsub = sm.onSessionEvent(sessionId, (eventCursor, event) => {
-    send(ws, { type: "agent.event", session: sessionId, cursor: eventCursor, event });
+    if (eventCursor === -1) {
+      send(ws, { type: "agent.event", session: sessionId, event });
+    } else {
+      send(ws, { type: "agent.event", session: sessionId, cursor: eventCursor, event });
+    }
   });
   state.agentUnsubs.set(sessionId, unsub);
   reply(ws, msg, { cursor });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sna-sdk/core",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Skills-Native Application runtime — server, providers, session management, database, and CLI",
   "type": "module",
   "bin": {