Phase 1-5: Upgrade SDK from v0.0.68664 to v1.0.0-alpha.15

Breaking changes applied:
- Client init: LettaClient → Letta, token → apiKey, added baseURL
- Method renames: createStream() → stream()
- Parameter names: camelCase → snake_case (stream_tokens, include_pings, etc)
- Tool calls: tool_call → tool_calls (array)
- Message types: Handle both messageType and message_type
- Pagination: All list methods now access .items property
- Removed deprecated use_assistant_message parameter

🐾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta <[e-mail]>

package-lock.json

···
       "dependencies": {
         "@expo-google-fonts/lexend": "^0.4.1",
         "@expo/metro-runtime": "~6.1.2",
-        "@letta-ai/letta-client": "^0.0.68664",
+        "@letta-ai/letta-client": "1.0.0-alpha.15",
         "@lottiefiles/dotlottie-react": "^0.13.5",
         "@react-native-async-storage/async-storage": "2.2.0",
         "@react-navigation/drawer": "^7.5.8",
···
       }
     },
     "node_modules/@letta-ai/letta-client": {
-      "version": "0.0.68664",
-      "resolved": "https://registry.npmjs.org/@letta-ai/letta-client/-/letta-client-0.0.68664.tgz",
-      "integrity": "sha512-/0g8dV3IIX0WfnOUDY1EEgnhj/747m73zhTmbLhldEMjCk/RzKyjvUeZbHiukiGoCf/u1nxRgcRUn66MKMYB2A==",
-      "dependencies": {
-        "form-data": "^4.0.0",
-        "form-data-encoder": "^4.0.2",
-        "formdata-node": "^6.0.3",
-        "node-fetch": "^2.7.0",
-        "qs": "^6.13.1",
-        "readable-stream": "^4.5.2",
-        "url-join": "4.0.1"
-      }
+      "version": "1.0.0-alpha.15",
+      "resolved": "https://registry.npmjs.org/@letta-ai/letta-client/-/letta-client-1.0.0-alpha.15.tgz",
+      "integrity": "sha512-5OpXmloDnboA0nYC9xJIJuIWzAaVS06uDr9YLO6hR29zblwgeHPpaopWJFyg+FR0Cg7SSyPgEb3xzjGdRd6Eqg==",
+      "license": "Apache-2.0"
     },
     "node_modules/@lottiefiles/dotlottie-react": {
       "version": "0.13.5",
···
         "node": ">= 0.4"
       }
     },
-    "node_modules/call-bound": {
-      "version": "1.0.4",
-      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
-      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
-      "license": "MIT",
-      "dependencies": {
-        "call-bind-apply-helpers": "^1.0.2",
-        "get-intrinsic": "^1.3.0"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
     "node_modules/caller-callsite": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/caller-callsite/-/caller-callsite-2.0.0.tgz",
···
         "node": ">=6"
       }
     },
-    "node_modules/events": {
-      "version": "3.3.0",
-      "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz",
-      "integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.8.x"
-      }
-    },
     "node_modules/exec-async": {
       "version": "2.2.0",
       "resolved": "https://registry.npmjs.org/exec-async/-/exec-async-2.2.0.tgz",
···
         "node": ">= 6"
       }
     },
-    "node_modules/form-data-encoder": {
-      "version": "4.1.0",
-      "resolved": "https://registry.npmjs.org/form-data-encoder/-/form-data-encoder-4.1.0.tgz",
-      "integrity": "sha512-G6NsmEW15s0Uw9XnCg+33H3ViYRyiM0hMrMhhqQOR8NFc5GhYrI+6I3u7OTw7b91J2g8rtvMBZJDbcGb2YUniw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 18"
-      }
-    },
-    "node_modules/formdata-node": {
-      "version": "6.0.3",
-      "resolved": "https://registry.npmjs.org/formdata-node/-/formdata-node-6.0.3.tgz",
-      "integrity": "sha512-8e1++BCiTzUno9v5IZ2J6bv4RU+3UKDmqWUQD0MIMVCd9AdhWkO1gw57oo1mNEX1dMq2EGI+FbWz4B92pscSQg==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 18"
-      }
-    },
     "node_modules/freeport-async": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/freeport-async/-/freeport-async-2.0.0.tgz",
···
         "node": ">=0.10.0"
       }
     },
-    "node_modules/object-inspect": {
-      "version": "1.13.4",
-      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
-      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
     "node_modules/on-finished": {
       "version": "2.3.0",
       "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.3.0.tgz",
···
         "node": "^14.17.0 || ^16.13.0 || >=18.0.0"
       }
     },
-    "node_modules/process": {
-      "version": "0.11.10",
-      "resolved": "https://registry.npmjs.org/process/-/process-0.11.10.tgz",
-      "integrity": "sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 0.6.0"
-      }
-    },
     "node_modules/progress": {
       "version": "2.0.3",
       "resolved": "https://registry.npmjs.org/progress/-/progress-2.0.3.tgz",
···
         "qrcode-terminal": "bin/qrcode-terminal.js"
       }
     },
-    "node_modules/qs": {
-      "version": "6.14.0",
-      "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.0.tgz",
-      "integrity": "sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==",
-      "license": "BSD-3-Clause",
-      "dependencies": {
-        "side-channel": "^1.1.0"
-      },
-      "engines": {
-        "node": ">=0.6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
     "node_modules/query-string": {
       "version": "7.1.3",
       "resolved": "https://registry.npmjs.org/query-string/-/query-string-7.1.3.tgz",
···
         "node": ">=0.10.0"
       }
     },
-    "node_modules/readable-stream": {
-      "version": "4.7.0",
-      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-4.7.0.tgz",
-      "integrity": "sha512-oIGGmcpTLwPga8Bn6/Z75SVaH1z5dUut2ibSyAMVhmUggWpmDn2dapB0n7f8nwaSiRtepAsfJyfXIO5DCVAODg==",
-      "license": "MIT",
-      "dependencies": {
-        "abort-controller": "^3.0.0",
-        "buffer": "^6.0.3",
-        "events": "^3.3.0",
-        "process": "^0.11.10",
-        "string_decoder": "^1.3.0"
-      },
-      "engines": {
-        "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
-      }
-    },
-    "node_modules/readable-stream/node_modules/buffer": {
-      "version": "6.0.3",
-      "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz",
-      "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/feross"
-        },
-        {
-          "type": "patreon",
-          "url": "https://www.patreon.com/feross"
-        },
-        {
-          "type": "consulting",
-          "url": "https://feross.org/support"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "base64-js": "^1.3.1",
-        "ieee754": "^1.2.1"
-      }
-    },
     "node_modules/regenerate": {
       "version": "1.4.2",
       "resolved": "https://registry.npmjs.org/regenerate/-/regenerate-1.4.2.tgz",
···
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/side-channel": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
-      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
-      "license": "MIT",
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "object-inspect": "^1.13.3",
-        "side-channel-list": "^1.0.0",
-        "side-channel-map": "^1.0.1",
-        "side-channel-weakmap": "^1.0.2"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/side-channel-list": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
-      "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
-      "license": "MIT",
-      "dependencies": {
-        "es-errors": "^1.3.0",
-        "object-inspect": "^1.13.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/side-channel-map": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
-      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
-      "license": "MIT",
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "es-errors": "^1.3.0",
-        "get-intrinsic": "^1.2.5",
-        "object-inspect": "^1.13.3"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
-    "node_modules/side-channel-weakmap": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
-      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
-      "license": "MIT",
-      "dependencies": {
-        "call-bound": "^1.0.2",
-        "es-errors": "^1.3.0",
-        "get-intrinsic": "^1.2.5",
-        "object-inspect": "^1.13.3",
-        "side-channel-map": "^1.0.1"
-      },
-      "engines": {
-        "node": ">= 0.4"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/ljharb"
-      }
-    },
     "node_modules/signal-exit": {
       "version": "4.1.0",
       "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
···
       "license": "MIT",
       "engines": {
         "node": ">=4"
-      }
-    },
-    "node_modules/string_decoder": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
-      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
-      "license": "MIT",
-      "dependencies": {
-        "safe-buffer": "~5.2.0"
       }
     },
     "node_modules/string-width": {
···
       "peerDependencies": {
         "browserslist": ">= 4.21.0"
       }
-    },
-    "node_modules/url-join": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/url-join/-/url-join-4.0.1.tgz",
-      "integrity": "sha512-jk1+QP6ZJqyOiuEI9AEWQfju/nB2Pw466kbA0LEZljHwKeMgd9WrAEgEGxjPDD2+TNbbb37rTyhEfrCXfuKXnA==",
-      "license": "MIT"
     },
     "node_modules/use-latest-callback": {
       "version": "0.2.4",

package.json

···
   "dependencies": {
     "@expo-google-fonts/lexend": "^0.4.1",
     "@expo/metro-runtime": "~6.1.2",
-    "@letta-ai/letta-client": "^0.0.68664",
+    "@letta-ai/letta-client": "1.0.0-alpha.15",
     "@lottiefiles/dotlottie-react": "^0.13.5",
     "@react-native-async-storage/async-storage": "2.2.0",
     "@react-navigation/drawer": "^7.5.8",

src/api/lettaApi.ts

···
-import { LettaClient } from '@letta-ai/letta-client';
+import Letta from '@letta-ai/letta-client';
 import type {
   LettaAgent,
   LettaMessage,
···
 import { config } from '../config';
 
 class LettaApiService {
-  private client: LettaClient | null = null;
+  private client: Letta | null = null;
   private token: string | null = null;
 
   constructor(token?: string) {
···
       if (!this.client) {
         throw new Error('Client not initialized. Please set auth token first.');
       }
-      const blocks = await this.client.agents.blocks.list(agentId);
+      const blocksPage = await this.client.agents.blocks.list(agentId);
+      const blocks = blocksPage.items || [];
       return blocks as unknown as MemoryBlock[];
     } catch (error) {
       throw this.handleError(error);
···
 
     // Initialize the official Letta client with extended timeout for agent creation
     // Agent creation with sleeptime can take a while as it creates 2 agents
-    this.client = new LettaClient({
-      token,
+    this.client = new Letta({
+      apiKey: token,
+      baseURL: config.api.baseURL,
       timeout: config.api.timeout
     });
     this.token = token;
···
       console.log('listAgents - calling SDK with params:', params);
       console.log('listAgents - JSON stringify params:', JSON.stringify(params));
       
-      const response = await this.client.agents.list(params);
-      console.log('listAgents - SDK response count:', response?.length || 0);
+      const responsePage = await this.client.agents.list(params);
+      const response = responsePage.items || [];
+      console.log('listAgents - SDK response count:', response.length);
       console.log('listAgents - first few agents project_ids:', 
-        response?.slice(0, 3)?.map(a => ({ name: a.name, project_id: a.project_id })) || []
+        response.slice(0, 3).map(a => ({ name: a.name, project_id: a.project_id }))
       );
       
       return response;
···
       
       // Transform messages to match our interface, preserving tool step types
       const transformedMessages = (response.messages || []).map((message: any) => {
-        const type = message.messageType;
+        const type = message.message_type || message.messageType;
         // Extract possible tool call/return shapes from SDK variants
         const toolCall = message.tool_call || message.toolCall || (message.tool_calls && message.tool_calls[0]);
         const toolReturn = message.tool_response || message.toolResponse || message.tool_return || message.toolReturn;
···
           };
         }),
         // Token streaming provides partial chunks for real-time UX
-        streamTokens: messageData.stream_tokens !== false,
+        stream_tokens: messageData.stream_tokens !== false,
         // Background mode prevents client-side terminations and enables resumption
         background: true,
         // Ping events keep connection alive during long operations
-        includePings: true,
+        include_pings: true,
       };
 
       // Only add optional params if they're defined
-      if (messageData.use_assistant_message !== undefined) {
-        lettaStreamingRequest.useAssistantMessage = messageData.use_assistant_message;
-      }
       if (messageData.max_steps !== undefined) {
-        lettaStreamingRequest.maxSteps = messageData.max_steps;
+        lettaStreamingRequest.max_steps = messageData.max_steps;
       }
       
       console.log('=== SIMPLIFIED REQUEST ===');
···
         }
       });
 
-      console.log('=== CALLING SDK createStream ===');
+      console.log('=== CALLING SDK stream ===');
       console.log('Agent ID:', agentId);
       console.log('Client base URL:', (this.client as any)?.baseURL || 'unknown');
       console.log('About to call: POST /agents/{agentId}/messages/stream');
 
-      const stream = await this.client.agents.messages.createStream(agentId, lettaStreamingRequest);
+      const stream = await this.client.agents.messages.stream(agentId, lettaStreamingRequest);
 
       console.log('=== STREAM OBJECT CREATED ===');
       console.log('Stream object type:', typeof stream);
···
       console.log('listMessages - agentId:', agentId);
       console.log('listMessages - params:', params);
 
-      const response = await this.client.agents.messages.list(agentId, params);
-      console.log('listMessages - response count:', response?.length || 0);
+      const responsePage = await this.client.agents.messages.list(agentId, params);
+      const response = responsePage.items || [];
+      console.log('listMessages - response count:', response.length);
 
       /**
        * MESSAGE TRANSFORMATION ARCHITECTURE
···
        * display as empty blocks like "tool({})" which is meaningless to the user.
        */
       const transformedMessages: LettaMessage[] = response.map((message: any) => {
-        const type = message.messageType as string;
+        const type = (message.message_type || message.messageType) as string;
 
         // Extract tool call/return data (try multiple field name variants for SDK compatibility)
         const toolCall = message.tool_call || message.toolCall || (message.tool_calls && message.tool_calls[0]);
···
         throw new Error('Client not initialized. Please set auth token first.');
       }
 
-      const response = await this.client.tools.list(params);
-      return response;
+      const responsePage = await this.client.tools.list(params);
+      return responsePage.items || [];
     } catch (error) {
       throw this.handleError(error);
     }
···
       try {
         const response = await this.client.agents.messages.create(agentId, sanitized);
         const transformedMessages = (response.messages || []).map((message: any) => {
-          const type = message.messageType;
+          const type = message.message_type || message.messageType;
           const toolCall = message.tool_call || message.toolCall || (message.tool_calls && message.tool_calls[0]);
           const toolReturn = message.tool_response || message.toolResponse || message.tool_return || message.toolReturn;
 
···
           {
             type: 'approval',
             approve: params.approve,
-            approvalRequestId: params.approval_request_id,
+            approval_request_id: params.approval_request_id,
             reason: params.reason,
           },
         ],
-        streamTokens: true,
+        stream_tokens: true,
         background: true,
-        includePings: true,
+        include_pings: true,
       };
 
-      const stream = await this.client.agents.messages.createStream(agentId, body);
+      const stream = await this.client.agents.messages.stream(agentId, body);
 
       for await (const chunk of stream) {
         const mt = (chunk as any).message_type || (chunk as any).messageType;
···
             ...(after && { after })
           });
 
-          // Convert response to array if needed
-          const folders = Array.isArray(page) ? page : [];
+          // SDK v1.0 returns page object with .items
+          const folders = page.items || [];
 
           console.log(`listFolders - page ${pageCount + 1}: ${folders.length} folders`);
           console.log(`listFolders - page ${pageCount + 1} first 3 names:`, folders.slice(0, 3).map(f => f.name));
···
       }
 
       // No name filter, just return first page using SDK
-      const folders = await this.client.folders.list(params);
+      const foldersPage = await this.client.folders.list(params);
+      const folders = foldersPage.items || [];
       console.log('listFolders - returned count:', folders.length);
       return folders;
     } catch (error) {
···
         throw new Error('Client not initialized. Please set auth token first.');
       }
 
-      const files = await this.client.folders.files.list(folderId);
-      return files;
+      const filesPage = await this.client.folders.files.list(folderId);
+      return filesPage.items || [];
     } catch (error) {
       throw this.handleError(error);
     }
···
       }
 
       console.log('listPassages - agentId:', agentId, 'params:', params);
-      const passages = await this.client.agents.passages.list(agentId, params);
-      console.log('listPassages - result count:', passages?.length || 0);
+      const passagesPage = await this.client.agents.passages.list(agentId, params);
+      const passages = passagesPage.items || [];
+      console.log('listPassages - result count:', passages.length);
       return passages as Passage[];
     } catch (error) {
       console.error('listPassages - error:', error);
···
       }
 
       console.log('listAgentsForBlock - blockId:', blockId);
-      const agents = await this.client.blocks.agents.list(blockId);
+      const agentsPage = await this.client.blocks.agents.list(blockId);
+      const agents = agentsPage.items || [];
       console.log('listAgentsForBlock - found agents:', agents.length);
       return agents;
     } catch (error) {

src/hooks/useMessageStream.ts

···
       chatStore.accumulateReasoning(chunkId, chunk.reasoning);
     }
     else if (chunkType === 'tool_call_message' && chunkId) {
-      const toolCall = (chunk as any).toolCall || (chunk as any).tool_call;
-      if (toolCall) {
+      // SDK v1.0: tool_calls is now an array
+      const toolCalls = (chunk as any).tool_calls || [(chunk as any).toolCall || (chunk as any).tool_call].filter(Boolean);
+      if (toolCalls.length > 0) {
+        const toolCall = toolCalls[0];
         const toolName = toolCall.name || toolCall.tool_name || 'unknown';
         // Try multiple places for arguments
         let args = toolCall.arguments || toolCall.args || '';
···
                 content: content,
                 reasoning: msg.reasoning,
                 ...(msg.type === 'tool_call' && msg.toolCallName ? {
-                  tool_call: {
+                  tool_calls: [{
                     name: msg.toolCallName,
                     arguments: msg.content, // Keep as JSON for parseToolCall fallback
-                  }
+                  }]
                 } : {}),
                 created_at: msg.timestamp,
               } as any;