feat: migrate to Claude Sonnet 4.5 with SDK v0.67.0

- Upgraded @anthropic-ai/sdk from v0.59.0 to v0.67.0
- Migrated model from claude-sonnet-4-20250514 to claude-sonnet-4-5
- Updated text editor tool from text_editor_20250429 to text_editor_20250728
- Extended StopReason type to include refusal and model_context_window_exceeded
- Enhanced title generation with 1.5s timeout and automatic fallback

Author: yayasoumah

RELEASE_NOTES.md

@@ -3,6 +3,9 @@ Pocket Server — Release Notes
 
 Highlights
 ----------
+- **Claude Sonnet 4.5 migration** with updated SDK (v0.67.0) and latest text editor tool
+- Enhanced title generation with timeout protection and graceful fallback
+- Extended stop reason types for better error handling (refusal, context window exceeded)
 - Remote pairing mode protected by one-time tokens and capped retry attempts
 - Session asset storage for user image uploads (disk-backed with token-gated retrieval)
 - Turn lifecycle telemetry (`agent:turn`) unified across Anthropic and OpenAI providers
@@ -11,6 +14,12 @@ Highlights
 
 New
 ---
+- **Claude Sonnet 4.5 migration**
+  - Upgraded `@anthropic-ai/sdk` from v0.59.0 to v0.67.0
+  - Migrated model from `claude-sonnet-4-20250514` to `claude-sonnet-4-5` across all chat endpoints
+  - Updated text editor tool from `text_editor_20250429` to `text_editor_20250728`
+  - Extended `StopReason` type to include `refusal` and `model_context_window_exceeded`
+  - Enhanced title generation with 1.5s timeout and automatic fallback to heuristic on errors
 - Remote pairing flow
   - `pocket-server pair --remote` opens a remote pairing window with PIN + one-time token
   - `/auth/pair` accepts `{ deviceId, pin, pairToken }` during remote windows and rejects other origins

package-lock.json

@@ -15,7 +15,7 @@
     "node": ">=22.18.0"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.59.0",
+    "@anthropic-ai/sdk": "^0.67.0",
     "@hono/node-server": "^1.18.1",
     "@hono/node-ws": "^1.0.4",
     "@xterm/headless": "^5.5.0",

package.json

@@ -77,7 +77,7 @@ export class AnthropicService {
           updatedAt: now,
           messages: [],
           metadata: {
-            model: 'claude-sonnet-4-20250514',
+            model: 'claude-sonnet-4-5',
             totalTokens: 0
           },
           settings: {
@@ -271,7 +271,7 @@ export class AnthropicService {
 
       const anthropic = this.initClient(apiKey);
       const streamConfig = {
-        model: 'claude-sonnet-4-20250514',
+        model: 'claude-sonnet-4-5',
         max_tokens: 4096,
         system: systemPrompt,
         messages: await this.materializeMessagesWithBase64(sessionId, session.conversation.messages),
@@ -717,7 +717,7 @@ export class AnthropicService {
       session.currentStreamController = new AbortController();
 
       const streamConfig = {
-        model: 'claude-sonnet-4-20250514',
+        model: 'claude-sonnet-4-5',
         max_tokens: 4096,
         system: systemPrompt,
         messages: await this.materializeMessagesWithBase64(session.id, session.conversation.messages),

src/agent/anthropic/anthropic.ts

@@ -12,7 +12,7 @@ import type { CreateCommand, InsertCommand, StrReplaceCommand, TextEditorCommand
  * Text editor tool definition for Anthropic API
  */
 export const editorToolDefinition: TextEditorTool = {
-  type: 'text_editor_20250429',
+  type: 'text_editor_20250728',
   name: 'str_replace_based_edit_tool'
 };
 

src/agent/anthropic/tools/editor.ts

@@ -21,7 +21,7 @@ export interface Message {
   usage: Usage;
 }
 
-export type StopReason = 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use' | 'pause_turn';
+export type StopReason = 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use' | 'pause_turn' | 'refusal' | 'model_context_window_exceeded';
 
 export interface Usage {
   input_tokens: number;
@@ -261,7 +261,7 @@ export interface UserLocation {
 
 // Text Editor Tool
 export interface TextEditorTool extends SpecialTool {
-  type: 'text_editor_20250429' | 'text_editor_20250124' | 'text_editor_20241022';
+  type: 'text_editor_20250728' | 'text_editor_20250429' | 'text_editor_20250124' | 'text_editor_20241022';
   name: 'str_replace_based_edit_tool';
 }
 

src/agent/anthropic/types.ts

@@ -7,28 +7,40 @@
 import Anthropic from '@anthropic-ai/sdk';
 
 export async function generateConversationTitle(userMessage: string, anthropicApiKey?: string): Promise<string> {
-  // Try Anthropic if a key is available
+  // Try Anthropic if a key is available (prefer mobile key, fallback to server env)
   const key = anthropicApiKey || process.env.ANTHROPIC_API_KEY;
   if (key) {
     try {
-      const anthropic = new Anthropic({ apiKey: key });
-      const response = await anthropic.messages.create({
-        model: 'claude-sonnet-4-20250514',
-        max_tokens: 20,
-        temperature: 0.7,
-        messages: [{
-          role: 'user',
-          content: `Generate a short title (max 3 words) for a conversation that starts with: "${userMessage}". Return only the title, no quotes or punctuation.`
-        }]
-      });
-      const content = response.content[0];
-      if (content?.type === 'text') {
-        const title = content.text.trim();
-        const words = title.split(' ').filter(Boolean);
-        return words.length > 3 ? words.slice(0, 3).join(' ') : (title || 'New Chat');
+      // Create abort controller for timeout
+      const abortController = new AbortController();
+      const timeoutId = setTimeout(() => abortController.abort(), 1500);
+      
+      try {
+        const anthropic = new Anthropic({ apiKey: key });
+        const response = await anthropic.messages.create({
+          model: 'claude-sonnet-4-5',
+          max_tokens: 20,
+          temperature: 0.7,
+          messages: [{
+            role: 'user',
+            content: `Generate a short title (max 3 words) for a conversation that starts with: "${userMessage}". Return only the title, no quotes or punctuation.`
+          }]
+        }, {
+          signal: abortController.signal
+        });
+        clearTimeout(timeoutId);
+        
+        const content = response.content[0];
+        if (content?.type === 'text') {
+          const title = content.text.trim();
+          const words = title.split(' ').filter(Boolean);
+          return words.length > 3 ? words.slice(0, 3).join(' ') : (title || 'New Chat');
+        }
+      } finally {
+        clearTimeout(timeoutId);
       }
     } catch (err) {
-      // Fall through to heuristic
+      // Silently fall through to heuristic (includes timeout, auth errors, etc.)
     }
   }
   return generateFallbackTitle(userMessage);