Merge branch 'main' into me-claude-thinking-support

* main:
  updated readme for version install
  updated mix.exs version for release
  updated changelog for v0.3.3
  added content part description to OpenAI module doc for file uploads
  fixed doc typo
  adds telemetry (#284)
  check that the requested tool_name exists - return an error if it does not exist in the chain
  added LLMChain.run_until_tool_used/3 (#292)
  Support for file with file_id in ChatOpenAI (#283)
  Fix options being passed to the ollama chat api (#179)
  Support for json_response in ChatModels.ChatGoogleAI (#277)
  support streaming responses from mistral (#287)
  feat: File urls for Google (#286)

Author: brainlid

.cursor/rules/changelog-rules.mdc

@@ -0,0 +1,33 @@
+---
+description: CHANGELOG release authoring rules
+globs:
+alwaysApply: false
+---
+Write a changelog entry in the [CHANGELOG.md](mdc:CHANGELOG.md) file for the requested new version. Search the git history for the previous verion's tagged release but omit any immediately following commits that updated the CHANGELOG, as those are essentially part of the previous release.
+
+Break out all the changes in the groups of Added, Changed or breaking changes. Particularly pay attention to larger and more official changes that happen through a PR being merged. Any important changes that were NOT part of a PR but were included should also be called out.
+
+A PR_LINK uses the PR number and the base project URL:
+
+Example: https://github.com/brainlid/langchain/pull/261
+
+# Changelog creation
+
+A changelog entry for a specific version follows this format:
+
+---
+
+Callout any breaking changes.
+
+### Upgrading from vPreviousVersion - vNewVersion
+
+If there are breaking changes and migration or upgrade instructions are needed, those are included here. These typically come from PR descriptions.
+
+### Added
+- Bullet list of new features or additions PR_LINK
+
+### Changed
+- Bullet list of notable changes PR_LINK
+
+### Fixed
+- Bullet list of bugs that were fixed PR_LINK

.envrc_template

@@ -6,4 +6,5 @@ export AWS_ACCESS_KEY_ID="YOUR_AWS_ACCESS_KEY_ID"
 export AWS_SECRET_ACCESS_KEY="YOUR_AWS_SECRET_ACCESS_KEY"
 export AZURE_OPENAI_ENDPOINT="YOUR_AZURE_MODEL_ENDPOINT"
 export AZURE_OPENAI_KEY="YOUR_AZURE_ENDPOINT_KEY"
-export PERPLEXITY_API_KEY="YOUR_PERPLEXITY_API_KEY"
+export PERPLEXITY_API_KEY="YOUR_PERPLEXITY_API_KEY"
+export MISTRAL_API_KEY="YOUR_MISTRAL_API_KEY"

.github/workflows/elixir.yml

@@ -21,6 +21,7 @@ env:
   AWS_SECRET_ACCESS_KEY: invalid
   AWS_REGION: invalid
   PERPLEXITY_API_KEY: invalid
+  MISTRAL_API_KEY: invalid
 
 permissions:
   contents: read

CHANGELOG.md

@@ -4,6 +4,32 @@
 
 
 
+## v0.3.3 (2025-03-17)
+
+This is a milestone release before staring v0.4.0 which introduces breaking changes, but importantly adds support for "thinking" models.
+
+### Added
+- Added telemetry support https://github.com/brainlid/langchain/pull/284
+- Added `LLMChain.run_until_tool_used/3` function https://github.com/brainlid/langchain/pull/292
+- Support for file uploads with file_id in ChatOpenAI https://github.com/brainlid/langchain/pull/283
+- Support for json_response in ChatGoogleAI https://github.com/brainlid/langchain/pull/277
+- Support for streaming responses from Mistral https://github.com/brainlid/langchain/pull/287
+- Support for file URLs in Google AI https://github.com/brainlid/langchain/pull/286
+- Support for PDF content with OpenAI model https://github.com/brainlid/langchain/pull/275
+- Support for caching tool results in Anthropic calls https://github.com/brainlid/langchain/pull/269
+- Support for choosing Anthropic beta headers https://github.com/brainlid/langchain/pull/273
+
+### Changed
+- Fixed options being passed to the Ollama chat API https://github.com/brainlid/langchain/pull/179
+- Fixed media URIs for Google Vertex https://github.com/brainlid/langchain/pull/242
+- Fixed OpenAI verbose_api https://github.com/brainlid/langchain/pull/274
+- Improved documentation for callbacks and content parts
+- Upgraded gettext and migrated https://github.com/brainlid/langchain/pull/271
+
+### Fixed
+- Added validation to check if requested tool_name exists in chain
+- Fixed various documentation issues and typos
+- Fixed callback links in documentation
 
 ## v0.3.2 (2025-03-17)
 

README.md

@@ -68,7 +68,7 @@ in `mix.exs`:
 ```elixir
 def deps do
   [
-    {:langchain, "0.3.0"}
+    {:langchain, "0.3.3"}
   ]
 end
 ```
@@ -240,13 +240,24 @@ See the [`LangChain.ChatModels.ChatBumblebee` documentation](https://hexdocs.pm/
 
 ## Testing
 
+Before you can run the tests, make sure you have the environment variables set.
+
+You can do this by running:
+
+```
+source .envrc_template
+```
+
+Or you can copy it to `.envrc` and populate it with your private API values.
+
 To run all the tests including the ones that perform live calls against the OpenAI API, use the following command:
 
 ```
 mix test --include live_call
 mix test --include live_open_ai
 mix test --include live_ollama_ai
 mix test --include live_anthropic
+mix test --include live_mistral_ai
 mix test test/tools/calculator_test.exs --include live_call
 ```