feat(genai): Samples/thinking

[Guiners]

Description

Fixes #

Note: Before submitting a pull request, please open an issue for discussion if you are not associated with Google.

Checklist

• I have followed guidelines from CONTRIBUTING.MD and Samples Style Guide
• Tests pass: npm test (see Testing)
• Lint pass: npm run lint (see Style)
• Required CI tests pass (see CI testing)
• These samples need a new API enabled in testing projects to pass (let us know which ones)
• These samples need a new/updated env vars in testing projects set to pass (let us know which ones)
• This pull request is from a branch created directly off of GoogleCloudPlatform/nodejs-docs-samples. Not a fork.
• This sample adds a new sample directory, and I updated the CODEOWNERS file with the codeowners for this sample
• This sample adds a new sample directory, and I created GitHub Actions workflow for this sample
• This sample adds a new Product API, and I updated the Blunderbuss issue/PR auto-assigner with the codeowners for this sample
• Please merge this PR for me once it is approved

Note: Any check with (dev), (experimental), or (legacy) can be ignored and should not block your PR from merging (see CI testing).

[snippet-bot]

Here is the summary of changes.

You are about to add 3 region tags.

• genai/thinking/thinking-budget-with-txt.js:17, tag googlegenaisdk_thinking_budget_with_txt
• genai/thinking/thinking-includethoughts-with-txt.js:17, tag googlegenaisdk_thinking_includethoughts_with_txt
• genai/thinking/thinking-with-txt.js:17, tag googlegenaisdk_thinking_with_txt

---

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

• Refresh this comment

[gemini-code-assist]

Summary of Changes

Hello @Guiners, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the genai samples by adding new examples that illustrate the advanced 'thinking' capabilities of the Google GenAI SDK. These samples provide practical demonstrations of how to configure and utilize features like thinkingBudget and includeThoughts to gain deeper insights into the model's reasoning process and manage resource usage during complex problem-solving tasks.

Highlights

• New GenAI Samples for 'Thinking' Capabilities: This pull request introduces a set of new samples for the Google GenAI SDK, specifically focusing on the model's 'thinking' capabilities.
• Demonstration of thinkingBudget: A new sample (thinking-budget-with-txt.js) illustrates how to configure a thinkingBudget to control the token usage for the model's internal thought process during content generation.
• Demonstration of includeThoughts: Another new sample (thinking-includethoughts-with-txt.js) shows how to use the includeThoughts configuration option to retrieve and display the model's internal reasoning and step-by-step thought process.
• Basic 'Thinking' Sample: A foundational sample (thinking-with-txt.js) has been added to demonstrate basic content generation with the GenAI SDK's 'thinking' aspect.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in issue comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request introduces new samples demonstrating the 'thinking' feature of the GenAI SDK, including variations for budget control and including thought processes in the response. The sample code is clear and well-structured. My review includes a high-severity fix for a potential runtime error due to unsafe array access in one of the samples. Additionally, I've provided medium-severity suggestions to improve the correctness of the accompanying tests by addressing incorrect usage of async with Mocha's describe function and a minor stylistic issue.

[msampathkumar]

LGTM. Minor nit pics