Changelog

New Features:

• Approvals - Resolved Approval in Post-Hooks: Post-hooks and observability integrations can now read the full resolved approval record (resolved_by, resolved_at, etc.) via run_response.metadata["approval"]. Previously only status and resolution_data were exposed. Lives in metadata so it works uniformly across RunOutput / TeamRunOutput / future WorkflowRunOutput. (#7366, #8032)

Improvements:

• PgVector - prefix_match=True actually works: PgVector(prefix_match=True) was a silent no-op - it appended * then routed through websearch_to_tsquery, which ignores wildcards. Now routes through to_tsquery('tok:*') with proper tokenization, so partial queries like "ani" FTS-match "animal" as documented. New cookbook cookbook/07_knowledge/04_advanced/06_prefix_search.py shows the help-center typeahead use case. (#8048, #8051, #8052)
• PgVector - empty-tsquery fallback robustness: Replaced the to_tsquery(language, '') fallback with a literal ''::tsquery cast so behavior no longer depends on the parser tolerating empty input. (#8053)
• Claude variants - temperature/top_p/top_k = 0 honored: Anthropic, AWS, and VertexAI Claude variants were silently dropping 0.0 values due to bare truthiness checks. Switched to is not None so deterministic output works as intended. (#8009, fixes #8004)
• Calendar & Gmail context providers - clean instruction layering: Trimmed DEFAULT_READ_INSTRUCTIONS / DEFAULT_WRITE_INSTRUCTIONS from 157 lines to 27 by removing content already supplied by the toolkit-side instructions. Provider now owns role + safety; toolkit owns the technical reference. (#7982)
• decision_log - drop deprecated datetime.utcnow(): Replaced with datetime.now(timezone.utc) to clear the Python 3.12 deprecation warning. (Closes #8030)
• Chonkie: Bumped to >=1.6.7 to pick up the upstream language auto-detection fix; removed the temporary test workarounds from #7904. (#8012)

Bug Fixes:

• GeminiInteractions - server-side tool calls leaking onto the agent path: On the agent path (Antigravity, Deep Research), FunctionCallSteps describe tools the autonomous loop runs inside the server-managed sandbox. Previously we surfaced them as local tool_calls, leading to Function <name> not found and follow-up 400 invalid_request errors. Gated the FunctionCallStep branch on self.agent is None for both streaming and non-streaming. Model path with user-declared tools is unchanged. (#8045)
• Claude (Anthropic / AWS / VertexAI) - temperature=0 silently dropped: See Improvements. Every prior release silently fell back to API defaults (~1.0) when callers explicitly set 0. (#8009, fixes #8004)

What's Changed

• [FIX] Add UTM parameters to links in README by @kyleaton in #8010
• chore: bump chonkie to >=1.6.7 by @sannya-singal in #8012
• cookbook: data_labeling on Gemini + quality review as Workflow by @ashpreetbedi in #8024
• feat: expose resolved approval record to post-hooks via metadata by @brandon-agsys in #7366
• refactor: move resolved approval from typed field to metadata bag by @ysolanky in #8032
• cookbook: image search demo on Gemini + AgentOS by @ashpreetbedi in #8035
• fix: replace deprecated datetime.utcnow() with datetime.now(timezone.utc) in decision_log.py by @Ghraven in #8031
• fix(pgvector): make prefix_match=True actually do prefix matching by @ashpreetbedi in #8048
• [cookbook] Fix Google Calendar spelling by @lil-goat in #8047
• fix: use is not None for temperature/top_p/top_k across all Claude variants by @VANDRANKI in #8009
• cookbook: swap image_search from ChromaDb to PgVector by @ashpreetbedi in #8036
• fix(pgvector): use literal empty tsquery for hybrid_search fallback by @ysolanky in #8053
• cookbook: enable prefix_match=True on image_search PgVector by @ashpreetbedi in #8052
• refactor: simplify Calendar and Gmail context provider instructions by @Mustafa-Esoofally in #7982
• cookbook: add pgvector prefix_match example and improved comments by @Mustafa-Esoofally in #8051
• fix: skip server-side tool calls on GeminiInteractions agent path by @ysolanky in #8045
• chore: Release v2.6.9 by @kausmeows in #8042

New Contributors

• @brandon-agsys made their first contribution in #7366
• @Ghraven made their first contribution in #8031
• @lil-goat made their first contribution in #8047
• @VANDRANKI made their first contribution in #8009

Full Changelog: v2.6.8...v2.6.9