@hienlh/ppm 0.8.2 → 0.8.4

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.8.4] - 2026-03-23
+
+### Fixed
+- **Poisoned session auto-recovery**: When resuming an existing SDK session fails with an assistant error (e.g. `unknown`), automatically retry as a fresh session instead of hanging for minutes — fixes projects stuck on a bad session
+
+## [0.8.3] - 2026-03-23
+
+### Fixed
+- **WSL timeout diagnostics**: Connection timeout error now detects WSL environment and suggests specific DNS/proxy troubleshooting steps
+- **No-credentials warning**: Log warning when no account and no API key in env — helps diagnose why SDK subprocess hangs
+
 ## [0.8.2] - 2026-03-23
 
 ### Fixed

package/package.json

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

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

@@ -553,6 +553,14 @@ export class ClaudeAgentSdkProvider implements AIProvider {
         yield { type: "account_info" as const, accountId: account.id, accountLabel: account.label ?? account.email ?? "Unknown" };
       }
       const queryEnv = this.buildQueryEnv(meta.projectPath, account);
+
+      // Pre-flight: warn if no credentials at all (avoids 2-minute silent timeout)
+      if (!account) {
+        const hasApiKey = !!(queryEnv.ANTHROPIC_API_KEY || queryEnv.CLAUDE_CODE_OAUTH_TOKEN);
+        if (!hasApiKey) {
+          console.warn(`[sdk] session=${sessionId} no account and no API key in env — Claude CLI will use its own auth (if any)`);
+        }
+      }
       console.log(`[sdk] query: session=${sessionId} sdkId=${sdkId} isFirst=${isFirstMessage} fork=${shouldFork} cwd=${effectiveCwd} platform=${process.platform} accountMode=${!!account} permissionMode=${permissionMode} isBypass=${isBypass}`);
 
       // TODO: Remove when TS SDK fixes Windows stdin pipe buffering (see queryDirectCli() JSDoc for tracking issues)
@@ -791,6 +799,40 @@ export class ClaudeAgentSdkProvider implements AIProvider {
           // SDK assistant messages can carry an error field for auth/billing/rate-limit failures
           const assistantError = (msg as any).error as string | undefined;
           if (assistantError) {
+            console.error(`[sdk] session=${sessionId} assistant error: ${assistantError} (isFirst=${isFirstMessage})`);
+            // If resuming an existing session and it errors → retry as fresh session
+            if (!isFirstMessage && retryCount < MAX_RETRIES) {
+              retryCount++;
+              console.warn(`[sdk] session=${sessionId} resume failed with assistant error "${assistantError}" — retrying as fresh session`);
+              yield { type: "text" as const, content: `Session resume failed (${assistantError}). Retrying with a fresh session...` };
+              // Re-create query without resume
+              const freshQ = query({
+                prompt: message,
+                options: {
+                  cwd: effectiveCwd,
+                  systemPrompt: systemPromptOpt,
+                  settingSources: ["user", "project"],
+                  env: queryEnv,
+                  settings: { permissions: { allow: [], deny: [] } },
+                  allowedTools,
+                  permissionMode,
+                  allowDangerouslySkipPermissions: isBypass,
+                  ...(permissionHooks && { hooks: permissionHooks }),
+                  ...(providerConfig.model && { model: providerConfig.model }),
+                  ...(providerConfig.effort && { effort: providerConfig.effort }),
+                  maxTurns: providerConfig.max_turns ?? 100,
+                  ...(providerConfig.max_budget_usd && { maxBudgetUsd: providerConfig.max_budget_usd }),
+                  ...(providerConfig.thinking_budget_tokens != null && {
+                    thinkingBudgetTokens: providerConfig.thinking_budget_tokens,
+                  }),
+                  canUseTool,
+                  includePartialMessages: true,
+                } as any,
+              });
+              this.activeQueries.set(sessionId, freshQ);
+              eventSource = freshQ;
+              continue retryLoop;
+            }
             const errorHints: Record<string, string> = {
               authentication_failed: "API authentication failed. Check your account credentials in Settings → Accounts.",
               billing_error: "Billing error on this account. Check your subscription status.",
@@ -800,7 +842,6 @@ export class ClaudeAgentSdkProvider implements AIProvider {
               unknown: "API connection failed. Possible causes: network unreachable, expired OAuth token, or API outage. Try: 1) Check connectivity (`curl -s https://api.anthropic.com`), 2) Re-add account in Settings, 3) Create a new chat session.",
             };
             const hint = errorHints[assistantError] ?? `API error: ${assistantError}`;
-            console.error(`[sdk] session=${sessionId} assistant error: ${assistantError}`);
             yield { type: "error", message: hint };
           }
           const content = (msg as any).message?.content;

package/src/server/ws/chat.ts

@@ -130,9 +130,14 @@ async function runStreamLoop(sessionId: string, providerId: string, content: str
         clearInterval(heartbeat);
         console.error(`[chat] session=${sessionId} SDK connection timeout after ${elapsed}s`);
         logSessionEvent(sessionId, "ERROR", `SDK connection timeout after ${elapsed}s — subprocess may have failed to start`);
+        const projectPath = entry?.projectPath ?? "";
+        const isWSL = projectPath.startsWith("/home/") || projectPath.startsWith("/mnt/");
+        const wslHint = isWSL
+          ? "\n\nWSL detected — this is likely a network issue. Try from your WSL terminal:\n  curl -s https://api.anthropic.com\nIf that fails, check WSL DNS settings (/etc/resolv.conf) or proxy configuration."
+          : "";
         safeSend(sessionId, {
           type: "error",
-          message: `Claude SDK failed to respond after ${elapsed}s. Check that "claude" CLI works in your terminal, or try: ppm start -f`,
+          message: `Claude SDK failed to respond after ${elapsed}s. The API may be unreachable from this machine.${wslHint}\n\nGeneral troubleshooting:\n• Check internet connectivity\n• Run \`claude\` in your terminal to verify it works\n• Try: ppm start -f`,
         });
         abortController.abort();
         return;