@hienlh/ppm 0.9.0-beta.0 → 0.9.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.9.0-beta.1] - 2026-03-26
+
+### Fixed
+- **FE stuck on "Connecting"**: SDK system events (hook_started, init) now yield to streaming loop, transitioning phase `connecting → thinking` immediately instead of waiting 5-10s for first text event
+
 ## [0.9.0-beta.0] - 2026-03-26
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hienlh/ppm",
-  "version": "0.9.0-beta.0",
+  "version": "0.9.0-beta.1",
   "description": "Personal Project Manager — mobile-first web IDE with AI assistance",
   "author": "hienlh",
   "license": "MIT",

package/src/providers/claude-agent-sdk.ts

@@ -502,22 +502,24 @@ export class ClaudeAgentSdkProvider implements AIProvider {
 
         // Log all system events for debugging SDK lifecycle
         if (msg.type === "system") {
-          console.log(`[sdk] session=${sessionId} system: subtype=${(msg as any).subtype ?? "none"} ${JSON.stringify(msg).slice(0, 500)}`);
-        }
-
-        // Capture SDK session metadata from init message
-        if (msg.type === "system" && (msg as any).subtype === "init") {
-          const initMsg = msg as any;
-          // SDK may assign a different session_id than our UUID
-          if (initMsg.session_id && initMsg.session_id !== sessionId) {
-            // Persist mapping so resume works after server restart
-            setSessionMapping(sessionId, initMsg.session_id);
-            // Update our in-memory mapping
-            const oldMeta = this.activeSessions.get(sessionId);
-            if (oldMeta) {
-              this.activeSessions.set(initMsg.session_id, { ...oldMeta, id: initMsg.session_id });
+          const subtype = (msg as any).subtype ?? "none";
+          console.log(`[sdk] session=${sessionId} system: subtype=${subtype} ${JSON.stringify(msg).slice(0, 500)}`);
+
+          // Capture SDK session metadata from init message
+          if (subtype === "init") {
+            const initMsg = msg as any;
+            if (initMsg.session_id && initMsg.session_id !== sessionId) {
+              setSessionMapping(sessionId, initMsg.session_id);
+              const oldMeta = this.activeSessions.get(sessionId);
+              if (oldMeta) {
+                this.activeSessions.set(initMsg.session_id, { ...oldMeta, id: initMsg.session_id });
+              }
             }
           }
+
+          // Yield system events so streaming loop can transition phases
+          // (e.g. connecting → thinking when hooks/init arrive)
+          yield { type: "system" as any, subtype } as any;
           continue;
         }
 

package/src/providers/mock-provider.ts

@@ -92,8 +92,13 @@ export class MockProvider implements AIProvider {
     const abortController = new AbortController();
     this.activeAborts.set(sessionId, abortController);
 
+    // Simulate SDK system events (hooks, init) — real SDK emits these before content
+    yield { type: "system" as any, subtype: "hook_started" } as any;
+    await sleep(50);
+    yield { type: "system" as any, subtype: "init" } as any;
+
     // Simulate thinking delay
-    await sleep(300);
+    await sleep(250);
 
     // Pick a response
     const responseText =

package/src/server/ws/chat.ts

@@ -198,6 +198,16 @@ async function runStreamLoop(sessionId: string, providerId: string, content: str
       const ev = event as any;
       const evType = ev.type ?? "unknown";
 
+      // System events (hook_started, init, etc.) → transition connecting → thinking
+      // These indicate SDK has connected and is processing, but no content yet.
+      if (evType === "system") {
+        if (!firstEventReceived) {
+          if (heartbeat) clearInterval(heartbeat);
+          setPhase(sessionId, "thinking");
+        }
+        continue; // Don't buffer or broadcast system events
+      }
+
       // First content event — stop heartbeat, transition phase
       const isMetadataEvent = evType === "account_info" || evType === "streaming_status";
       if (!firstEventReceived && !isMetadataEvent) {