extractText($parts); $rawToolCalls = $this->extractRawToolCalls($parts); return new StepResponse( text: $text, toolCalls: $this->mapToolCalls($rawToolCalls), finishReason: $this->extractFinishReason($data, $rawToolCalls), usage: $this->extractUsage($data), meta: new Meta($provider->name(), $model, $this->extractCitations($data)), structured: $structured ? $this->decodeStructuredOutput($text) : null, providerContentBlocks: $this->sanitizeRequestParts($this->excludeThinkingParts($parts)), ); } /** * Determine if a response part is a thinking/thought part. */ protected function isThinkingPart(array $part): bool { return $part['thought'] ?? false; } /** * Sanitize functionCall parts so they can be sent back to Gemini as conversation history. */ protected function sanitizeRequestParts(array $parts): array { return array_map(function (array $part) { if (! isset($part['functionCall'])) { return $part; } $functionCall = ['name' => $part['functionCall']['name'] ?? '']; $args = $part['functionCall']['args'] ?? null; if (filled($args)) { $functionCall['args'] = $args; } $part['functionCall'] = $functionCall; return $part; }, $parts); } /** * Filter out thinking parts from the response, keeping only text and functionCall parts. */ protected function excludeThinkingParts(array $parts): array { return array_values(array_filter( $parts, fn (array $part): bool => ! $this->isThinkingPart($part), )); } /** * Extract the text content from the response parts, excluding thinking parts. */ protected function extractText(array $parts): string { $textParts = []; foreach ($parts as $part) { if (isset($part['text']) && ! $this->isThinkingPart($part)) { $textParts[] = $part['text']; } } return implode('', $textParts); } /** * Extract raw tool calls from the response parts. */ protected function extractRawToolCalls(array $parts): array { return array_values( array_map( fn (array $part) => $part['functionCall'], array_filter($parts, fn (array $part): bool => isset($part['functionCall'])) ) ); } /** * Map raw function call data to ToolCall DTOs. * * @return array */ protected function mapToolCalls(array $rawToolCalls): array { return array_map(function (array $fc): ToolCall { $id = $fc['id'] ?? (string) Str::uuid7(); return new ToolCall( $id, $fc['name'] ?? '', $fc['args'] ?? [], $id, ); }, $rawToolCalls); } /** * Extract citations from the response data. */ protected function extractCitations(array $data): Collection { $citations = new Collection; $candidate = $data['candidates'][0] ?? []; // Legacy citation metadata format... $sources = $candidate['citationMetadata']['citationSources'] ?? []; foreach ($sources as $source) { if (isset($source['uri'])) { $citations->push(new UrlCitation( $source['uri'], $source['title'] ?? null, )); } } // Grounding metadata format (Google Search grounding)... $groundingChunks = $candidate['groundingMetadata']['groundingChunks'] ?? []; $groundingSupports = $candidate['groundingMetadata']['groundingSupports'] ?? []; $referencedIndices = []; foreach ($groundingSupports as $support) { foreach ($support['groundingChunkIndices'] ?? [] as $index) { $referencedIndices[$index] = true; } } foreach (array_keys($referencedIndices) as $index) { $web = $groundingChunks[$index]['web'] ?? []; if (isset($web['uri'])) { $citations->push(new UrlCitation( $web['uri'], $web['title'] ?? null, )); } } return $citations->unique('url')->values(); } /** * Extract usage data from the response. */ protected function extractUsage(array $data): Usage { $usage = $data['usageMetadata'] ?? []; $promptTokens = $usage['promptTokenCount'] ?? 0; $cachedTokens = $usage['cachedContentTokenCount'] ?? 0; return new Usage( $promptTokens - $cachedTokens, $usage['candidatesTokenCount'] ?? 0, 0, $cachedTokens, $usage['thoughtsTokenCount'] ?? 0, ); } /** * Extract and map the finish reason from the Gemini response. */ protected function extractFinishReason(array $data, array $rawToolCalls): FinishReason { if (filled($rawToolCalls)) { return FinishReason::ToolCalls; } $candidate = $data['candidates'][0] ?? []; $reason = $candidate['finishReason'] ?? ''; return match ($reason) { 'STOP' => FinishReason::Stop, 'MAX_TOKENS' => FinishReason::Length, 'SAFETY', 'RECITATION', 'BLOCKLIST', 'PROHIBITED_CONTENT', 'SPII', 'MALFORMED_FUNCTION_CALL' => FinishReason::ContentFilter, default => FinishReason::Unknown, }; } }