@providerprotocol/ai 0.0.22 → 0.0.24

package/dist/google/index.d.ts

@@ -1,4 +1,4 @@
-import { a as ProviderConfig, g as Provider } from '../provider-DWEAzeM5.js';
+import { a as ProviderConfig, g as Provider } from '../provider-x4RocsnK.js';
 
 /**
  * Provider-specific parameters for Google Gemini API requests.
@@ -125,14 +125,37 @@ interface GoogleLLMParams {
     toolConfig?: GoogleToolConfig;
 }
 /**
- * Configuration for extended thinking/reasoning in Gemini 3+ models.
+ * Configuration for extended thinking/reasoning in Gemini 2.5+ and 3+ models.
  *
  * Enables models to spend additional compute on reasoning before
  * generating a response, improving quality for complex tasks.
+ *
+ * For Gemini 2.5 models: Use `thinkingBudget` to control token allocation.
+ * For Gemini 3+ models: Use `thinkingLevel` (recommended) to set reasoning depth.
+ *
+ * Set `includeThoughts: true` to receive thought/reasoning content in the response.
  */
 interface GoogleThinkingConfig {
-    /** Token budget allocated for model thinking/reasoning before response generation. */
+    /**
+     * Token budget allocated for model thinking/reasoning (Gemini 2.5 models).
+     * - `-1`: Dynamic thinking (default)
+     * - `0`: Disable thinking (Flash models only)
+     * - `128-32768`: Specific token budget
+     */
     thinkingBudget?: number;
+    /**
+     * Thinking level for Gemini 3+ models (recommended over thinkingBudget).
+     * - `"minimal"`: Likely prevents thinking (Gemini 3 Flash only)
+     * - `"low"`: Minimizes latency and cost
+     * - `"medium"`: Balanced (Gemini 3 Flash only)
+     * - `"high"`: Maximizes reasoning depth (default for Gemini 3)
+     */
+    thinkingLevel?: 'minimal' | 'low' | 'medium' | 'high';
+    /**
+     * Whether to include thought summaries in the response.
+     * When true, response parts with `thought: true` contain reasoning content.
+     */
+    includeThoughts?: boolean;
 }
 /**
  * A single content turn in the Google conversation format.
@@ -160,6 +183,14 @@ type GooglePart = GoogleTextPart | GoogleImagePart | GoogleFunctionCallPart | Go
 interface GoogleTextPart {
     /** The text content. */
     text: string;
+    /** If true, this part contains thinking/reasoning content (Gemini 2.5+/3+). */
+    thought?: boolean;
+    /**
+     * Encrypted thought signature for Gemini 3+ models.
+     * Must be forwarded back in subsequent requests to maintain reasoning context.
+     * Required for Gemini 3 multi-turn conversations; recommended for Gemini 2.5.
+     */
+    thoughtSignature?: string;
 }
 /**
  * Inline image content part with base64-encoded data.
@@ -893,6 +924,7 @@ interface GoogleEmbedParams {
  * ```typescript
  * import { google } from './providers/google';
  * import { llm } from './core/llm';
+ * import { StreamEventType } from './types/stream';
  *
  * const gemini = llm({
  *   model: google('gemini-1.5-pro'),
@@ -904,7 +936,7 @@ interface GoogleEmbedParams {
  *
  * const stream = gemini.stream('Tell me a story');
  * for await (const event of stream) {
- *   if (event.type === 'text_delta') {
+ *   if (event.type === StreamEventType.TextDelta) {
  *     process.stdout.write(event.delta.text ?? '');
  *   }
  * }

package/dist/google/index.js

@@ -3,27 +3,32 @@ import {
 } from "../chunk-WAKD3OO5.js";
 import {
   parseJsonResponse
-} from "../chunk-I2VHCGQE.js";
+} from "../chunk-Z6DKC37J.js";
+import {
+  StreamEventType
+} from "../chunk-73IIE3QT.js";
 import {
   AssistantMessage,
   createProvider,
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
-} from "../chunk-M4BMM5IB.js";
+} from "../chunk-6AZVUI6H.js";
 import {
   parseSSEStream
-} from "../chunk-NWS5IKNR.js";
+} from "../chunk-TOJCZMVU.js";
 import {
   resolveApiKey
-} from "../chunk-7WYBJPJJ.js";
+} from "../chunk-55X3W2MN.js";
 import {
+  ErrorCode,
+  ModalityType,
   UPPError,
   doFetch,
   doStreamFetch,
   normalizeHttpError,
   toError
-} from "../chunk-RFWLEFAB.js";
+} from "../chunk-QNJO7DSD.js";
 
 // src/providers/google/transform.ts
 function transformRequest(request, modelId) {
@@ -80,9 +85,9 @@ function normalizeSystem(system) {
   if (!Array.isArray(system)) {
     throw new UPPError(
       "System prompt must be a string or an array of text parts",
-      "INVALID_REQUEST",
+      ErrorCode.InvalidRequest,
       "google",
-      "llm"
+      ModalityType.LLM
     );
   }
   const parts = [];
@@ -90,18 +95,18 @@ function normalizeSystem(system) {
     if (!part || typeof part !== "object" || !("text" in part)) {
       throw new UPPError(
         "Google system prompt array must contain text parts",
-        "INVALID_REQUEST",
+        ErrorCode.InvalidRequest,
         "google",
-        "llm"
+        ModalityType.LLM
       );
     }
     const textValue = part.text;
     if (typeof textValue !== "string") {
       throw new UPPError(
         "Google system prompt text must be a string",
-        "INVALID_REQUEST",
+        ErrorCode.InvalidRequest,
         "google",
-        "llm"
+        ModalityType.LLM
       );
     }
     parts.push(part);
@@ -142,8 +147,18 @@ function transformMessages(messages) {
       });
     } else if (isAssistantMessage(msg)) {
       const validContent = filterValidContent(msg.content);
-      const parts = validContent.map(transformContentBlock);
+      const nonReasoningContent = validContent.filter((c) => c.type !== "reasoning");
+      const parts = nonReasoningContent.map(transformContentBlock);
       const googleMeta = msg.metadata?.google;
+      if (googleMeta?.thoughtSignature) {
+        for (let i = parts.length - 1; i >= 0; i--) {
+          const part = parts[i];
+          if (part && "text" in part) {
+            part.thoughtSignature = googleMeta.thoughtSignature;
+            break;
+          }
+        }
+      }
       if (googleMeta?.functionCallParts && googleMeta.functionCallParts.length > 0) {
         for (const fc of googleMeta.functionCallParts) {
           const part = {
@@ -231,17 +246,26 @@ function transformResponse(data) {
   if (!candidate) {
     throw new Error("No candidates in Google response");
   }
-  const textContent = [];
+  const content = [];
   const toolCalls = [];
   let structuredData;
+  let lastThoughtSignature;
   const functionCallParts = [];
   for (const part of candidate.content.parts) {
     if ("text" in part) {
-      textContent.push({ type: "text", text: part.text });
-      if (structuredData === void 0) {
-        try {
-          structuredData = JSON.parse(part.text);
-        } catch {
+      const textPart = part;
+      if (textPart.thoughtSignature) {
+        lastThoughtSignature = textPart.thoughtSignature;
+      }
+      if (textPart.thought) {
+        content.push({ type: "reasoning", text: textPart.text });
+      } else {
+        content.push({ type: "text", text: textPart.text });
+        if (structuredData === void 0) {
+          try {
+            structuredData = JSON.parse(textPart.text);
+          } catch {
+          }
         }
       }
     } else if ("functionCall" in part) {
@@ -260,7 +284,7 @@ function transformResponse(data) {
     } else if ("codeExecutionResult" in part) {
       const codeResult = part;
       if (codeResult.codeExecutionResult.output) {
-        textContent.push({ type: "text", text: `
+        content.push({ type: "text", text: `
 \`\`\`
 ${codeResult.codeExecutionResult.output}\`\`\`
 ` });
@@ -268,14 +292,16 @@ ${codeResult.codeExecutionResult.output}\`\`\`
     }
   }
   const message = new AssistantMessage(
-    textContent,
+    content,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
       metadata: {
         google: {
           finishReason: candidate.finishReason,
           safetyRatings: candidate.safetyRatings,
-          functionCallParts: functionCallParts.length > 0 ? functionCallParts : void 0
+          functionCallParts: functionCallParts.length > 0 ? functionCallParts : void 0,
+          // Store thoughtSignature for multi-turn context preservation (Gemini 3+)
+          thoughtSignature: lastThoughtSignature
         }
       }
     }
@@ -297,6 +323,8 @@ ${codeResult.codeExecutionResult.output}\`\`\`
 function createStreamState() {
   return {
     content: "",
+    reasoning: "",
+    thoughtSignature: void 0,
     toolCalls: [],
     finishReason: null,
     inputTokens: 0,
@@ -308,7 +336,7 @@ function createStreamState() {
 function transformStreamChunk(chunk, state) {
   const events = [];
   if (state.isFirstChunk) {
-    events.push({ type: "message_start", index: 0, delta: {} });
+    events.push({ type: StreamEventType.MessageStart, index: 0, delta: {} });
     state.isFirstChunk = false;
   }
   if (chunk.usageMetadata) {
@@ -322,12 +350,25 @@ function transformStreamChunk(chunk, state) {
   }
   for (const part of candidate.content?.parts ?? []) {
     if ("text" in part) {
-      state.content += part.text;
-      events.push({
-        type: "text_delta",
-        index: 0,
-        delta: { text: part.text }
-      });
+      const textPart = part;
+      if (textPart.thoughtSignature) {
+        state.thoughtSignature = textPart.thoughtSignature;
+      }
+      if (textPart.thought) {
+        state.reasoning += textPart.text;
+        events.push({
+          type: StreamEventType.ReasoningDelta,
+          index: 0,
+          delta: { text: textPart.text }
+        });
+      } else {
+        state.content += textPart.text;
+        events.push({
+          type: StreamEventType.TextDelta,
+          index: 0,
+          delta: { text: textPart.text }
+        });
+      }
     } else if ("functionCall" in part) {
       const fc = part;
       const toolCallId = createGoogleToolCallId(fc.functionCall.name, state.toolCalls.length);
@@ -338,7 +379,7 @@ function transformStreamChunk(chunk, state) {
         thoughtSignature: fc.thoughtSignature
       });
       events.push({
-        type: "tool_call_delta",
+        type: StreamEventType.ToolCallDelta,
         index: state.toolCalls.length - 1,
         delta: {
           toolCallId,
@@ -355,7 +396,7 @@ ${codeResult.codeExecutionResult.output}\`\`\`
 `;
         state.content += outputText;
         events.push({
-          type: "text_delta",
+          type: StreamEventType.TextDelta,
           index: 0,
           delta: { text: outputText }
         });
@@ -364,17 +405,20 @@ ${codeResult.codeExecutionResult.output}\`\`\`
   }
   if (candidate.finishReason) {
     state.finishReason = candidate.finishReason;
-    events.push({ type: "message_stop", index: 0, delta: {} });
+    events.push({ type: StreamEventType.MessageStop, index: 0, delta: {} });
   }
   return events;
 }
 function buildResponseFromState(state) {
-  const textContent = [];
+  const content = [];
   const toolCalls = [];
   let structuredData;
   const functionCallParts = [];
+  if (state.reasoning) {
+    content.push({ type: "reasoning", text: state.reasoning });
+  }
   if (state.content) {
-    textContent.push({ type: "text", text: state.content });
+    content.push({ type: "text", text: state.content });
     try {
       structuredData = JSON.parse(state.content);
     } catch {
@@ -394,13 +438,14 @@ function buildResponseFromState(state) {
     });
   }
   const message = new AssistantMessage(
-    textContent,
+    content,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
       metadata: {
         google: {
           finishReason: state.finishReason,
-          functionCallParts: functionCallParts.length > 0 ? functionCallParts : void 0
+          functionCallParts: functionCallParts.length > 0 ? functionCallParts : void 0,
+          thoughtSignature: state.thoughtSignature
         }
       }
     }
@@ -458,9 +503,9 @@ function createLLMHandler() {
       if (!providerRef) {
         throw new UPPError(
           "Provider reference not set. Handler must be used with createProvider().",
-          "INVALID_REQUEST",
+          ErrorCode.InvalidRequest,
           "google",
-          "llm"
+          ModalityType.LLM
         );
       }
       const model = {
@@ -554,9 +599,9 @@ function createLLMHandler() {
               if (!response.body) {
                 const error = new UPPError(
                   "No response body for streaming request",
-                  "PROVIDER_ERROR",
+                  ErrorCode.ProviderError,
                   "google",
-                  "llm"
+                  ModalityType.LLM
                 );
                 responseReject(error);
                 throw error;
@@ -567,9 +612,9 @@ function createLLMHandler() {
                   if (chunk.error) {
                     const error = new UPPError(
                       chunk.error.message,
-                      "PROVIDER_ERROR",
+                      ErrorCode.ProviderError,
                       "google",
-                      "llm"
+                      ModalityType.LLM
                     );
                     responseReject(error);
                     throw error;
@@ -613,9 +658,9 @@ function createEmbeddingHandler() {
       if (!providerRef) {
         throw new UPPError(
           "Provider reference not set. Handler must be used with createProvider().",
-          "INVALID_REQUEST",
+          ErrorCode.InvalidRequest,
           "google",
-          "embedding"
+          ModalityType.Embedding
         );
       }
       const model = {
@@ -639,9 +684,9 @@ function createEmbeddingHandler() {
             if (!text) {
               throw new UPPError(
                 "Google embeddings only support text input",
-                "INVALID_REQUEST",
+                ErrorCode.InvalidRequest,
                 "google",
-                "embedding"
+                ModalityType.Embedding
               );
             }
             const embedRequest = {
@@ -713,9 +758,9 @@ function createImageHandler() {
       if (!providerRef) {
         throw new UPPError(
           "Provider reference not set. Handler must be used with createProvider().",
-          "INVALID_REQUEST",
+          ErrorCode.InvalidRequest,
           "google",
-          "image"
+          ModalityType.Image
         );
       }
       const capabilities = getCapabilities();
@@ -775,9 +820,9 @@ function transformResponse2(data) {
   if (!data.predictions || data.predictions.length === 0) {
     throw new UPPError(
       "No images in response",
-      "PROVIDER_ERROR",
+      ErrorCode.ProviderError,
       "google",
-      "image"
+      ModalityType.Image
     );
   }
   const images = data.predictions.map((prediction) => {
@@ -922,9 +967,9 @@ async function update(name, updateRequest, apiKey, config, signal) {
   if (updateRequest.expireTime && updateRequest.ttl) {
     throw new UPPError(
       "Provide either expireTime or ttl (not both)",
-      "INVALID_REQUEST",
+      ErrorCode.InvalidRequest,
       "google",
-      "llm"
+      ModalityType.LLM
     );
   }
   const updateMaskParts = [];
@@ -937,9 +982,9 @@ async function update(name, updateRequest, apiKey, config, signal) {
   if (updateMaskParts.length === 0) {
     throw new UPPError(
       "Update request must include expireTime or ttl",
-      "INVALID_REQUEST",
+      ErrorCode.InvalidRequest,
       "google",
-      "llm"
+      ModalityType.LLM
     );
   }
   const cacheName = name.startsWith("cachedContents/") ? name : `cachedContents/${name}`;