feat(ai-openrouter): upgrade openrouter SDK to 0.12.14, add builtin structured output support, and refresh models

.changeset/giant-garlics-crash.md

@@ -0,0 +1,7 @@
+---
+'@tanstack/ai-openrouter': patch
+---
+
+- Updated openrouter sdk to 0.8.0
+- Updated model list to include Opus 4.6, Sonnet 4.6, and Gemini 3.1 Pro amongst others
+- Updated structured output support to natively support open router structured output

package.json

@@ -33,6 +33,7 @@
     "dev": "pnpm run watch",
     "format": "prettier --experimental-cli --ignore-unknown '**/*' --write",
     "generate-docs": "node scripts/generate-docs.ts && pnpm run copy:readme",
+    "fetch:models": "tsx scripts/fetch-openrouter-models.ts",
     "generate:models": "tsx scripts/convert-openrouter-models.ts",
     "sync-docs-config": "node scripts/sync-docs-config.ts",
     "copy:readme": "cp README.md packages/typescript/ai/README.md && cp README.md packages/typescript/ai-devtools/README.md && cp README.md packages/typescript/preact-ai-devtools/README.md && cp README.md packages/typescript/ai-client/README.md && cp README.md packages/typescript/ai-gemini/README.md && cp README.md packages/typescript/ai-ollama/README.md && cp README.md packages/typescript/ai-openai/README.md && cp README.md packages/typescript/ai-react/README.md && cp README.md packages/typescript/ai-react-ui/README.md && cp README.md packages/typescript/react-ai-devtools/README.md && cp README.md packages/typescript/solid-ai-devtools/README.md",

packages/typescript/ai-openrouter/package.json

@@ -39,7 +39,7 @@
     "adapter"
   ],
   "dependencies": {
-    "@openrouter/sdk": "0.3.15",
+    "@openrouter/sdk": "0.8.0",
     "@tanstack/ai": "workspace:*"
   },
   "devDependencies": {

packages/typescript/ai-openrouter/src/adapters/image.ts

@@ -71,28 +71,30 @@ export class OpenRouterImageAdapter<
 
     try {
       const response = await this.client.chat.send({
-        model,
-        messages: [
-          {
-            role: 'user',
-            content: prompt,
+        chatGenerationParams: {
+          model,
+          messages: [
+            {
+              role: 'user',
+              content: prompt,
+            },
+          ],
+          modalities: ['image'],
+          stream: false,
+          // OpenRouter filters out invalid config per provider specifications
+          imageConfig: {
+            ...(numberOfImages ? { n: numberOfImages, numberOfImages } : {}),
+            ...(aspectRatio
+              ? {
+                  aspect_ratio: aspectRatio,
+                }
+              : {}),
+            ...(modelOptions?.image_size
+              ? {
+                  image_size: modelOptions.image_size,
+                }
+              : {}),
           },
-        ],
-        modalities: ['image'],
-        stream: false,
-        // OpenRouter filters out invalid config per provider specifications
-        imageConfig: {
-          ...(numberOfImages ? { n: numberOfImages, numberOfImages } : {}),
-          ...(aspectRatio
-            ? {
-                aspect_ratio: aspectRatio,
-              }
-            : {}),
-          ...(modelOptions?.image_size
-            ? {
-                image_size: modelOptions.image_size,
-              }
-            : {}),
         },
       })
 

packages/typescript/ai-openrouter/src/adapters/text.ts

@@ -114,7 +114,7 @@ export class OpenRouterTextAdapter<
     try {
       const requestParams = this.mapTextOptionsToSDK(options)
       const stream = await this.client.chat.send(
-        { ...requestParams, stream: true },
+        { chatGenerationParams: { ...requestParams, stream: true } },
         { signal: options.request?.signal },
       )
 
@@ -218,59 +218,37 @@ export class OpenRouterTextAdapter<
 
     const requestParams = this.mapTextOptionsToSDK(chatOptions)
 
-    const structuredOutputTool = {
-      type: 'function' as const,
-      function: {
-        name: 'structured_output',
-        description:
-          'Use this tool to provide your response in the required structured format.',
-        parameters: outputSchema,
-      },
-    }
-
     try {
       const result = await this.client.chat.send(
         {
-          ...requestParams,
-          stream: false,
-          tools: [structuredOutputTool],
-          toolChoice: {
-            type: 'function',
-            function: { name: 'structured_output' },
+          chatGenerationParams: {
+            ...requestParams,
+            stream: false,
+            responseFormat: {
+              type: 'json_schema',
+              jsonSchema: {
+                name: 'structured_output',
+                schema: outputSchema,
+                strict: true,
+              },
+            },
           },
         },
         { signal: chatOptions.request?.signal },
       )
-
-      const message = result.choices[0]?.message
-      const toolCall = message?.toolCalls?.[0]
-
-      if (toolCall && toolCall.function.name === 'structured_output') {
-        const parsed = JSON.parse(toolCall.function.arguments || '{}')
-        return {
-          data: parsed,
-          rawText: toolCall.function.arguments || '',
-        }
-      }
-
-      const content = (message?.content as any) || ''
-      let parsed: unknown
-      try {
-        parsed = JSON.parse(content)
-      } catch {
-        throw new Error(
-          `Failed to parse structured output as JSON. Content: ${content.slice(0, 200)}${content.length > 200 ? '...' : ''}`,
-        )
-      }
-
-      return {
-        data: parsed,
-        rawText: content,
-      }
+      const content = result.choices[0]?.message.content
+      const rawText = typeof content === 'string' ? content : ''
+      const parsed = JSON.parse(rawText)
+      return { data: parsed, rawText }
     } catch (error: unknown) {
       if (error instanceof RequestAbortedError) {
         throw new Error('Structured output generation aborted')
       }
+      if (error instanceof SyntaxError) {
+        throw new Error(
+          `Failed to parse structured output as JSON: ${error.message}`,
+        )
+      }
       const err = error as Error
       throw new Error(
         `Structured output generation failed: ${err.message || 'Unknown error occurred'}`,