Use GEMINI_JSON as default

[dylanjcastillo]

Makes GEMINI_JSON default, and warns users about key ordering issue.

Fixes #1285.

---

Important

Change default mode to GEMINI_JSON in from_gemini() and update documentation for field order warning.

• Behavior:
  • Change default mode to GEMINI_JSON in from_gemini() in instructor/client_gemini.py.
  • Warns about field order issue in docs/concepts/patching.md.
• Documentation:
  • Fix typo in section title in docs/concepts/patching.md.

^{This description was created by for 25045ab. It will automatically update as commits are pushed.}

[ellipsis-dev]

👍 Looks good to me! Reviewed everything up to 25045ab in 16 seconds

More details

• Looked at 58 lines of code in 2 files
• Skipped 0 files when reviewing.
• Skipped posting 3 drafted comments based on config settings.

1. instructor/client_gemini.py:14

• Draft comment:
  The default mode has been changed from GEMINI_TOOLS to GEMINI_JSON. Ensure that this change is communicated to users, as it may affect existing implementations relying on the previous default.
• Reason this comment was not posted:
  Confidence changes required: 50%
  The PR changes the default mode from GEMINI_TOOLS to GEMINI_JSON in the from_gemini function. This change is consistent across all overloads and the main function definition. The change aligns with the PR's intent to make GEMINI_JSON the default mode due to its better performance in chain-of-thought reasoning tasks, as described in the issue.

2. docs/concepts/patching.md:38

• Draft comment:
  The addition of the warning about field order not being preserved in Gemini tool calling is a good update. It informs users about potential issues with relying on field order in responses.
• Reason this comment was not posted:
  Confidence changes required: 0%
  The documentation update in patching.md correctly reflects the change in default mode to GEMINI_JSON. This aligns with the PR's intent and provides users with a warning about the key ordering issue.

3. docs/concepts/patching.md:38

• Draft comment:
  The code example should be updated to reflect the new default mode instructor.Mode.GEMINI_JSON.

    genai.GenerativeModel(), mode=instructor.Mode.GEMINI_JSON

• Reason this comment was not posted:
  Comment was not on a valid diff hunk.

Workflow ID: wflow_Cl8dA1hv0bkdHYhB

---

You can customize Ellipsis with 👍 / 👎 feedback, review rules, user-specific overrides, quiet mode, and more.