chore: Fix spelling

ci: Fix test to honor existing repository code

Add from __future__ import annotations
  Required by: Check for import pattern in certain changed Python files

Fix links:
- BigQuery first-party tools
- bidirectional streaming
- 2e77804

Fix spelling:
- , the
- ; otherwise,
- a missing input
- a user
- a
- accordingly
- across
- actual
- add
- all the
- and references
- answer
- appended
- arg
- args
- associated
- async
- at
- attractions
- auth
- between
- bigquery
- cannot
- case-insensitive
- case-sensitive
- comment
- connection
- constructor
- contributor
- convert
- corresponding
- credential
- criteria
- current
- custom
- data
- deprecated
- descriptions
- different
- directory
- doesn't
- enforce
- evaluation
- example
- exception
- exchange
- execution
- extension
- externally
- extract
- fall back
- format
- function
- future
- generate
- github
- global
- guidance
- handle
- id
- identify
- implements
- include
- increased
- initial
- initialize
- inline
- into
- invocation
- jira
- langchain
- list
- litellm
- manage
- maximum
- metrics
- model's template
- neither-nor
- nonexistent
- number
- output
- own
- participate
- permanent
- persisting
- preexisting
- prepopulated
- properties
- protected
- pydantic
- received
- relevant
- repetitive
- response
- responses
- results
- returns
- score
- search
- secret
- service
- single
- spec
- successfully
- surface
- temporary
- that the
- the module
- the
- there are
- transferred
- unstructured
- weather

Signed-off-by: Josh Soref <[email protected]>

Author: jsoref

.github/workflows/check-file-contents.yml

@@ -89,7 +89,7 @@ jobs:
       - name: Check for import from cli package in certain changed Python files
         run: |
           git fetch origin ${{ github.base_ref }}
-          CHANGED_FILES=$(git diff --diff-filter=ACMR --name-only origin/${{ github.base_ref }}...HEAD | grep -E '\.py$' | grep -v -E 'cli/.*|tests/.*|contributing/samples/' || true)
+          CHANGED_FILES=$(git diff --diff-filter=ACMR --name-only origin/${{ github.base_ref }}...HEAD | grep -E '\.py$' | grep -v -E 'cli/.*|src/google/adk/tools/apihub_tool/apihub_toolset.py|tests/.*|contributing/samples/' || true)
           if [ -n "$CHANGED_FILES" ]; then
             echo "Changed Python files to check:"
             echo "$CHANGED_FILES"

AGENTS.md

@@ -46,7 +46,7 @@ $ ./autoformat.sh
 
 ### In ADK source
 
-Below styles applies to the ADK source code (under `src/` folder of the Github.
+Below styles applies to the ADK source code (under `src/` folder of the GitHub.
 repo).
 
 #### Use relative imports

CHANGELOG.md

@@ -21,7 +21,7 @@
 
 ### Improvements
 
-* Add Github workflow config for the ADK Answering agent ([8dc0c94](https://github.com/google/adk-python/commit/8dc0c949afb9024738ff7ac1b2c19282175c3200))
+* Add GitHub workflow config for the ADK Answering agent ([8dc0c94](https://github.com/google/adk-python/commit/8dc0c949afb9024738ff7ac1b2c19282175c3200))
 * Import AGENT_CARD_WELL_KNOWN_PATH from adk instead of from a2a directly ([37dae9b](https://github.com/google/adk-python/commit/37dae9b631db5060770b66fce0e25cf0ffb56948))
 * Make `LlmRequest.LiveConnectConfig` field default to a factory ([74589a1](https://github.com/google/adk-python/commit/74589a1db7df65e319d1ad2f0676ee0cf5d6ec1d))
 * Update the prompt to make the ADK Answering Agent more objective ([2833030](https://github.com/google/adk-python/commit/283303032a174d51b8d72f14df83c794d66cb605))
@@ -80,14 +80,13 @@
 ### Features
 
 * [Core]Add agent card builder ([18f5bea](https://github.com/google/adk-python/commit/18f5bea411b3b76474ff31bfb2f62742825b45e5))
-* [Core]Add an to_a2a util to convert adk agent to A2A ASGI application ([a77d689](https://github.com/google/adk-python/commit/a77d68964a1c6b7659d6117d57fa59e43399e0c2))
+* [Core]Add a to_a2a util to convert adk agent to A2A ASGI application ([a77d689](https://github.com/google/adk-python/commit/a77d68964a1c6b7659d6117d57fa59e43399e0c2))
 * [Core]Add camel case converter for agents ([0e173d7](https://github.com/google/adk-python/commit/0e173d736334f8c6c171b3144ac6ee5b7125c846))
 * [Evals]Use LocalEvalService to run all evals in cli and web ([d1f182e](https://github.com/google/adk-python/commit/d1f182e8e68c4a5a4141592f3f6d2ceeada78887))
 * [Evals]Enable FinalResponseMatchV2 metric as an experiment ([36e45cd](https://github.com/google/adk-python/commit/36e45cdab3bbfb653eee3f9ed875b59bcd525ea1))
 * [Models]Add support for `model-optimizer-*` family of models in vertex ([ffe2bdb](https://github.com/google/adk-python/commit/ffe2bdbe4c2ea86cc7924eb36e8e3bb5528c0016))
 * [Services]Added a sample for History Management ([67284fc](https://github.com/google/adk-python/commit/67284fc46667b8c2946762bc9234a8453d48a43c))
-* [Services]Support passing fully qualified agent engine resource name when constructing session service and memory service ([2e77804](https://github.com/google/adk-python/commit/2e778049d0a675e458f4e
-35fe4104ca1298dbfcf))
+* [Services]Support passing fully qualified agent engine resource name when constructing session service and memory service ([2e77804](https://github.com/google/adk-python/commit/2e778049d0a675e458f4e35fe4104ca1298dbfcf))
 * [Tools]Add ComputerUseToolset ([083dcb4](https://github.com/google/adk-python/commit/083dcb44650eb0e6b70219ede731f2fa78ea7d28))
 * [Tools]Allow toolset to process llm_request before tools returned by it ([3643b4a](https://github.com/google/adk-python/commit/3643b4ae196fd9e38e52d5dc9d1cd43ea0733d36))
 * [Tools]Support input/output schema by fully-qualified code reference ([dfee06a](https://github.com/google/adk-python/commit/dfee06ac067ea909251d6fb016f8331065d430e9))
@@ -200,7 +199,7 @@
 
 ### Documentation
 
-* Update the a2a exmaple link in README.md [d0fdfb8](https://github.com/google/adk-python/commit/d0fdfb8c8e2e32801999c81de8d8ed0be3f88e76)
+* Update the a2a example link in README.md [d0fdfb8](https://github.com/google/adk-python/commit/d0fdfb8c8e2e32801999c81de8d8ed0be3f88e76)
 * Adds AGENTS.md to provide relevant project context for the Gemini CLI [37108be](https://github.com/google/adk-python/commit/37108be8557e011f321de76683835448213f8515)
 * Update CONTRIBUTING.md [ffa9b36](https://github.com/google/adk-python/commit/ffa9b361db615ae365ba62c09a8f4226fb761551)
 * Add adk project overview and architecture [28d0ea8](https://github.com/google/adk-python/commit/28d0ea876f2f8de952f1eccbc788e98e39f50cf5)
@@ -395,7 +394,7 @@
 * Fix typos in README for sample bigquery_agent and oauth_calendar_agent ([9bdd813](https://github.com/google/adk-python/commit/9bdd813be15935af5c5d2a6982a2391a640cab23))
 * Make tool_call one span for telemetry and renamed to execute_tool ([999a7fe](https://github.com/google/adk-python/commit/999a7fe69d511b1401b295d23ab3c2f40bccdc6f))
 * Use media type in chat window. Remove isArtifactImage and isArtifactAudio reference ([1452dac](https://github.com/google/adk-python/commit/1452dacfeb6b9970284e1ddeee6c4f3cb56781f8))
-* Set output_schema correctly for LiteLllm ([6157db7](https://github.com/google/adk-python/commit/6157db77f2fba4a44d075b51c83bff844027a147))
+* Set output_schema correctly for LiteLlm ([6157db7](https://github.com/google/adk-python/commit/6157db77f2fba4a44d075b51c83bff844027a147))
 * Update pending event dialog style ([1db601c](https://github.com/google/adk-python/commit/1db601c4bd90467b97a2f26fe9d90d665eb3c740))
 * Remove the gap between event holder and image ([63822c3](https://github.com/google/adk-python/commit/63822c3fa8b0bdce2527bd0d909c038e2b66dd98))
 
@@ -423,7 +422,7 @@
 ## 1.1.1
 
 ### Features
-* Add BigQuery first-party tools. See [here](https://github.com/google/adk-python/commit/d6c6bb4b2489a8b7a4713e4747c30d6df0c07961) for more details.
+* Add [BigQuery first-party tools](https://github.com/google/adk-python/commit/d6c6bb4b2489a8b7a4713e4747c30d6df0c07961) for more details.
 
 
 ## 1.1.0
@@ -559,7 +558,7 @@
 * Fix google search reading undefined for `renderedContent`.
 
 ### Miscellaneous Chores
-* Docstring improvements, typo fixings, github action to enfore code styles on formatting and imports, etc.
+* Docstring improvements, typo fixings, github action to enforce code styles on formatting and imports, etc.
 
 ## 0.3.0
 
@@ -598,7 +597,7 @@
 
 ### ⚠ BREAKING CHANGES
 
-* Fix typo in method name in `Event`: has_trailing_code_exeuction_result --> has_trailing_code_execution_result.
+* Fix typo in method name in `Event`: has_trailing_code_execution_result --> has_trailing_code_execution_result.
 
 ### Features
 
@@ -628,7 +627,7 @@
 
 ### Miscellaneous Chores
 
-* Adds unit tests in Github action.
+* Adds unit tests in GitHub action.
 * Improves test coverage.
 * Various typo fixes.
 

CONTRIBUTING.md

@@ -50,7 +50,7 @@ This project follows
 ## Requirement for PRs
 
 - Each PR should only have one commit. Please squash it if there are multiple PRs.
-- All PRs, other than small documentation or typo fixes, should have a Issue assoicated. If not, please create one.
+- All PRs, other than small documentation or typo fixes, should have a Issue associated. If not, please create one.
 - Small, focused PRs. Keep changes minimal—one concern per PR.
 - For bug fixes or features, please provide logs or screenshot after the fix is applied to help reviewers better understand the fix.
 - Please include a `testing plan` section in your PR to talk about how you will test. This will save time for PR review. See `Testing Requirements` section for more details.

contributing/samples/a2a_auth/remote_a2a/bigquery_agent/agent.py

@@ -46,7 +46,7 @@
       Use the provided tools to conduct various operations on users' data in Google BigQuery.
 
       Scenario 1:
-      The user wants to query their biguqery datasets
+      The user wants to query their bigquery datasets
       Use bigquery_datasets_list to query user's datasets
 
       Scenario 2:

contributing/samples/a2a_human_in_loop/README.md

@@ -99,7 +99,7 @@ Agent: ✅ Great news! Your reimbursement has been approved by the manager. Proc
 The human-in-the-loop process follows this pattern:
 
 1. **Initial Call**: Root agent delegates approval request to remote approval agent for amounts >$100
-2. **Pending Response**: Remote approval agent returns immediate response with `status: "pending"` and ticket ID and serface the approval request to root agent
+2. **Pending Response**: Remote approval agent returns immediate response with `status: "pending"` and ticket ID and surface the approval request to root agent
 3. **Agent Acknowledgment**: Root agent informs user about pending approval status
 4. **Human Interaction**: Human manager interacts with root agent to review and approve/reject the request
 5. **Updated Response**: Root agent receives updated tool response with approval decision and send it to remote agent

contributing/samples/adk_answering_agent/README.md

@@ -50,7 +50,7 @@ Or `python -m adk_answering_agent.answer_discussions --recent 10` to answer the
 
 ## GitHub Workflow Mode
 
-The `main.py` is reserved for the Github Workflow. The detailed setup for the automatic workflow is TBD.
+The `main.py` is reserved for the GitHub Workflow. The detailed setup for the automatic workflow is TBD.
 
 ---
 

contributing/samples/adk_answering_agent/agent.py

@@ -47,13 +47,13 @@
     1. Use the `get_discussion_and_comments` tool to get the details of the discussion including the comments.
     2. Focus on the latest comment but reference all comments if needed to understand the context.
       * If there is no comment at all, just focus on the discussion title and body.
-    3. If all the following conditions are met, try to add a comment to the discussion, otherwise, do not respond:
+    3. If all the following conditions are met, try to add a comment to the discussion; otherwise, do not respond:
       * The discussion is not closed.
       * The latest comment is not from you or other agents (marked as "Response from XXX Agent").
       * The latest comment is asking a question or requesting information.
     4. Use the `VertexAiSearchTool` to find relevant information before answering.
     5. If you can find relevant information, use the `add_comment_to_discussion` tool to add a comment to the discussion.
-    6. If you post a commment and the discussion does not have a label named {BOT_RESPONSE_LABEL},
+    6. If you post a comment and the discussion does not have a label named {BOT_RESPONSE_LABEL},
        add the label {BOT_RESPONSE_LABEL} to the discussion using the `add_label_to_discussion` tool.
 
 
@@ -63,7 +63,7 @@
         information that is not in the document store. Do not invent citations which are not in the document store.
       * **Be Objective**: your answer should be based on the facts you found in the document store, do not be misled by user's assumptions or user's understanding of ADK.
       * If you can't find the answer or information in the document store, **do not** respond.
-      * Inlclude a short summary of your response in the comment as a TLDR, e.g. "**TLDR**: <your summary>".
+      * Include a short summary of your response in the comment as a TLDR, e.g. "**TLDR**: <your summary>".
       * Have a divider line between the TLDR and your detail response.
       * Do not respond to any other discussion except the one specified by the user.
       * Please include your justification for your decision in your output

contributing/samples/adk_answering_agent/answer_discussions.py

@@ -87,7 +87,7 @@ async def list_most_recent_discussions(count: int = 1) -> list[int] | None:
 def process_arguments():
   """Parses command-line arguments."""
   parser = argparse.ArgumentParser(
-      description="A script that answer questions for Github discussions.",
+      description="A script that answer questions for GitHub discussions.",
       epilog=(
           "Example usage: \n"
           "\tpython -m adk_answering_agent.answer_discussions --recent 10\n"

contributing/samples/adk_answering_agent/upload_docs_to_vertex_ai_search.py

@@ -117,7 +117,7 @@ def upload_directory_to_gcs(
         )
         return False
 
-  print(f"Sucessfully uploaded {file_count} files to GCS.")
+  print(f"Successfully uploaded {file_count} files to GCS.")
   return True
 
 
@@ -135,7 +135,7 @@ def import_from_gcs_to_vertex_ai(
         # parent has the format of
         # "projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{datastore_id}/branches/default_branch"
         parent=full_datastore_id + "/branches/default_branch",
-        # Specify the GCS source and use "content" for unstructed data.
+        # Specify the GCS source and use "content" for unstructured data.
         gcs_source=discoveryengine.GcsSource(
             input_uris=[gcs_uri], data_schema="content"
         ),