feat: Add wait for operation tool with exponential backoff #920

prernakakkar-google · 2025-07-17T13:55:29Z

Example:

  alloydb-operations-get:
    kind: wait-for-operation
    source: alloydb-api-source
    method: GET
    path: /v1/projects/{{.projectId}}/locations/{{.locationId}}/operations/{{.operationId}}
    description: "Makes API call to check whether operation is done or not. This tool is run first then wait for tool. if its still in create phase trigger it after 3 minutes.  Print a message saying still not done. We will notify once its done."
    pathParams:
      - name: projectId
        type: string
        description: The dynamic path parameter
      - name: locationId
        type: string
        description: The dynamic path parameter
        default: us-central1
      - name: operationId
        type: string
        description: Operation status check for previous task

github-actions · 2025-07-17T13:56:27Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-17T14:00:04Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-17T14:03:42Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

docs/en/resources/tools/utility/waitforoperation.md

internal/tools/utility/wait-for-operation/waitforoperation.go

github-actions · 2025-07-18T14:59:37Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-18T17:04:28Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-21T06:10:54Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

internal/tools/utility/wait-for-operation/waitforoperation.go

github-actions · 2025-07-22T09:13:57Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-22T09:20:09Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-23T16:54:33Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-23T16:59:16Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

docs/en/resources/tools/utility/alloydbwaitforoperation.md

github-actions · 2025-07-23T17:25:12Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-23T17:40:51Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-23T18:00:45Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-23T18:10:44Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

github-actions · 2025-07-23T18:19:03Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-920/

Got required approvals and added requested changes

github-actions · 2025-07-23T18:34:51Z

🧨 Preview deployments removed.

) Example: ``` alloydb-operations-get: kind: wait-for-operation source: alloydb-api-source method: GET path: /v1/projects/{{.projectId}}/locations/{{.locationId}}/operations/{{.operationId}} description: "Makes API call to check whether operation is done or not. This tool is run first then wait for tool. if its still in create phase trigger it after 3 minutes. Print a message saying still not done. We will notify once its done." pathParams: - name: projectId type: string description: The dynamic path parameter - name: locationId type: string description: The dynamic path parameter default: us-central1 - name: operationId type: string description: Operation status check for previous task ``` 3f6ec29

…oogleapis#920) Example: ``` alloydb-operations-get: kind: wait-for-operation source: alloydb-api-source method: GET path: /v1/projects/{{.projectId}}/locations/{{.locationId}}/operations/{{.operationId}} description: "Makes API call to check whether operation is done or not. This tool is run first then wait for tool. if its still in create phase trigger it after 3 minutes. Print a message saying still not done. We will notify once its done." pathParams: - name: projectId type: string description: The dynamic path parameter - name: locationId type: string description: The dynamic path parameter default: us-central1 - name: operationId type: string description: Operation status check for previous task ``` 3f6ec29

🤖 I have created a release *beep* *boop* --- ## [0.10.0](v0.9.0...v0.10.0) (2025-07-25) ### Features * Add `Map` parameters support ([#928](#928)) ([4468bc9](4468bc9)) * Add Dataplex source and tool ([#847](#847)) ([30c16a5](30c16a5)) * Add Looker source and tool ([#923](#923)) ([c67e01b](c67e01b)) * Add support for null optional parameter ([#802](#802)) ([a817b12](a817b12)), closes [#736](#736) * **prebuilt/alloydb-admin-config:** Add alloydb control plane as a prebuilt config ([#937](#937)) ([0b28b72](0b28b72)) * **prebuilt/mysql,prebuilt/mssql:** Add generic mysql and mssql prebuilt tools ([#983](#983)) ([c600c30](c600c30)) * **server/mcp:** Support MCP version 2025-06-18 ([#898](#898)) ([313d3ca](313d3ca)) * **sources/mssql:** Add support for encrypt connection parameter ([#874](#874)) ([14a868f](14a868f)) * **sources/firestore:** Add Firestore as Source ([#786](#786)) ([2bb790e](2bb790e)) * **sources/mongodb:** Add MongoDB Source ([#969](#969)) ([74dbd61](74dbd61)) * **tools/alloydb-wait-for-operation:** Add wait for operation tool with exponential backoff ([#920](#920)) ([3f6ec29](3f6ec29)) * **tools/mongodb-aggregate:** Add MongoDB `aggregate` Tools ([#977](#977)) ([bd399bb](bd399bb)) * **tools/mongodb-delete:** Add MongoDB `delete` Tools ([#974](#974)) ([78e9752](78e9752)) * **tools/mongodb-find:** Add MongoDB `find` Tools ([#970](#970)) ([a747475](a747475)) * **tools/mongodb-insert:** Add MongoDB `insert` Tools ([#975](#975)) ([4c63f0c](4c63f0c)) * **tools/mongodb-update:** Add MongoDB `update` Tools ([#972](#972)) ([dfde52c](dfde52c)) * **tools/neo4j-execute-cypher:** Add neo4j-execute-cypher for Neo4j sources ([#946](#946)) ([81d0505](81d0505)) * **tools/neo4j-schema:** Add neo4j-schema tool ([#978](#978)) ([be7db3d](be7db3d)) * **tools/wait:** Create wait for tool ([#885](#885)) ([ed5ef4c](ed5ef4c)) ### Bug Fixes * Fix document preview pipeline for forked PRs ([#950](#950)) ([481cc60](481cc60)) * **prebuilt/firestore:** Mark database field as required in the firestore prebuilt tools ([#959](#959)) ([15417d4](15417d4)) * **prebuilt/cloud-sql-mssql:** Correct source reference for execute_sql tool in cloud-sql-mssql.yaml prebuilt config ([#938](#938)) ([d16728e](d16728e)) * **prebuilt/cloud-sql-mysql:** Update list_table tool ([#924](#924)) ([2083ba5](2083ba5)) * Replace 'float' with 'number' in McpManifest ([#985](#985)) ([59e23e1](59e23e1)) * **server/api:** Add logger to context in tool invoke handler ([#891](#891)) ([8ce311f](8ce311f)) * **sources/looker:** Add agent tag to Looker API calls. ([#966](#966)) ([f55dd6f](f55dd6f)) * **tools/bigquery-execute-sql:** Ensure invoke always returns a non-null value ([#925](#925)) ([9a55b80](9a55b80)) * **tools/mysqlsql:** Unmarshal json data from database during invoke ([#979](#979)) ([ccc3498](ccc3498)), closes [#840](#840) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com>

🤖 I have created a release *beep* *boop* --- ## [0.10.0](v0.9.0...v0.10.0) (2025-07-25) ### Features * Add `Map` parameters support ([#928](#928)) ([4468bc9](4468bc9)) * Add Dataplex source and tool ([#847](#847)) ([30c16a5](30c16a5)) * Add Looker source and tool ([#923](#923)) ([c67e01b](c67e01b)) * Add support for null optional parameter ([#802](#802)) ([a817b12](a817b12)), closes [#736](#736) * **prebuilt/alloydb-admin-config:** Add alloydb control plane as a prebuilt config ([#937](#937)) ([0b28b72](0b28b72)) * **prebuilt/mysql,prebuilt/mssql:** Add generic mysql and mssql prebuilt tools ([#983](#983)) ([c600c30](c600c30)) * **server/mcp:** Support MCP version 2025-06-18 ([#898](#898)) ([313d3ca](313d3ca)) * **sources/mssql:** Add support for encrypt connection parameter ([#874](#874)) ([14a868f](14a868f)) * **sources/firestore:** Add Firestore as Source ([#786](#786)) ([2bb790e](2bb790e)) * **sources/mongodb:** Add MongoDB Source ([#969](#969)) ([74dbd61](74dbd61)) * **tools/alloydb-wait-for-operation:** Add wait for operation tool with exponential backoff ([#920](#920)) ([3f6ec29](3f6ec29)) * **tools/mongodb-aggregate:** Add MongoDB `aggregate` Tools ([#977](#977)) ([bd399bb](bd399bb)) * **tools/mongodb-delete:** Add MongoDB `delete` Tools ([#974](#974)) ([78e9752](78e9752)) * **tools/mongodb-find:** Add MongoDB `find` Tools ([#970](#970)) ([a747475](a747475)) * **tools/mongodb-insert:** Add MongoDB `insert` Tools ([#975](#975)) ([4c63f0c](4c63f0c)) * **tools/mongodb-update:** Add MongoDB `update` Tools ([#972](#972)) ([dfde52c](dfde52c)) * **tools/neo4j-execute-cypher:** Add neo4j-execute-cypher for Neo4j sources ([#946](#946)) ([81d0505](81d0505)) * **tools/neo4j-schema:** Add neo4j-schema tool ([#978](#978)) ([be7db3d](be7db3d)) * **tools/wait:** Create wait for tool ([#885](#885)) ([ed5ef4c](ed5ef4c)) ### Bug Fixes * Fix document preview pipeline for forked PRs ([#950](#950)) ([481cc60](481cc60)) * **prebuilt/firestore:** Mark database field as required in the firestore prebuilt tools ([#959](#959)) ([15417d4](15417d4)) * **prebuilt/cloud-sql-mssql:** Correct source reference for execute_sql tool in cloud-sql-mssql.yaml prebuilt config ([#938](#938)) ([d16728e](d16728e)) * **prebuilt/cloud-sql-mysql:** Update list_table tool ([#924](#924)) ([2083ba5](2083ba5)) * Replace 'float' with 'number' in McpManifest ([#985](#985)) ([59e23e1](59e23e1)) * **server/api:** Add logger to context in tool invoke handler ([#891](#891)) ([8ce311f](8ce311f)) * **sources/looker:** Add agent tag to Looker API calls. ([#966](#966)) ([f55dd6f](f55dd6f)) * **tools/bigquery-execute-sql:** Ensure invoke always returns a non-null value ([#925](#925)) ([9a55b80](9a55b80)) * **tools/mysqlsql:** Unmarshal json data from database during invoke ([#979](#979)) ([ccc3498](ccc3498)), closes [#840](#840) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com> c45390e

🤖 I have created a release *beep* *boop* --- ## [0.10.0](googleapis/genai-toolbox@v0.9.0...v0.10.0) (2025-07-25) ### Features * Add `Map` parameters support ([googleapis#928](googleapis#928)) ([4468bc9](googleapis@4468bc9)) * Add Dataplex source and tool ([googleapis#847](googleapis#847)) ([30c16a5](googleapis@30c16a5)) * Add Looker source and tool ([googleapis#923](googleapis#923)) ([c67e01b](googleapis@c67e01b)) * Add support for null optional parameter ([googleapis#802](googleapis#802)) ([a817b12](googleapis@a817b12)), closes [googleapis#736](googleapis#736) * **prebuilt/alloydb-admin-config:** Add alloydb control plane as a prebuilt config ([googleapis#937](googleapis#937)) ([0b28b72](googleapis@0b28b72)) * **prebuilt/mysql,prebuilt/mssql:** Add generic mysql and mssql prebuilt tools ([googleapis#983](googleapis#983)) ([c600c30](googleapis@c600c30)) * **server/mcp:** Support MCP version 2025-06-18 ([googleapis#898](googleapis#898)) ([313d3ca](googleapis@313d3ca)) * **sources/mssql:** Add support for encrypt connection parameter ([googleapis#874](googleapis#874)) ([14a868f](googleapis@14a868f)) * **sources/firestore:** Add Firestore as Source ([googleapis#786](googleapis#786)) ([2bb790e](googleapis@2bb790e)) * **sources/mongodb:** Add MongoDB Source ([googleapis#969](googleapis#969)) ([74dbd61](googleapis@74dbd61)) * **tools/alloydb-wait-for-operation:** Add wait for operation tool with exponential backoff ([googleapis#920](googleapis#920)) ([3f6ec29](googleapis@3f6ec29)) * **tools/mongodb-aggregate:** Add MongoDB `aggregate` Tools ([googleapis#977](googleapis#977)) ([bd399bb](googleapis@bd399bb)) * **tools/mongodb-delete:** Add MongoDB `delete` Tools ([googleapis#974](googleapis#974)) ([78e9752](googleapis@78e9752)) * **tools/mongodb-find:** Add MongoDB `find` Tools ([googleapis#970](googleapis#970)) ([a747475](googleapis@a747475)) * **tools/mongodb-insert:** Add MongoDB `insert` Tools ([googleapis#975](googleapis#975)) ([4c63f0c](googleapis@4c63f0c)) * **tools/mongodb-update:** Add MongoDB `update` Tools ([googleapis#972](googleapis#972)) ([dfde52c](googleapis@dfde52c)) * **tools/neo4j-execute-cypher:** Add neo4j-execute-cypher for Neo4j sources ([googleapis#946](googleapis#946)) ([81d0505](googleapis@81d0505)) * **tools/neo4j-schema:** Add neo4j-schema tool ([googleapis#978](googleapis#978)) ([be7db3d](googleapis@be7db3d)) * **tools/wait:** Create wait for tool ([googleapis#885](googleapis#885)) ([ed5ef4c](googleapis@ed5ef4c)) ### Bug Fixes * Fix document preview pipeline for forked PRs ([googleapis#950](googleapis#950)) ([481cc60](googleapis@481cc60)) * **prebuilt/firestore:** Mark database field as required in the firestore prebuilt tools ([googleapis#959](googleapis#959)) ([15417d4](googleapis@15417d4)) * **prebuilt/cloud-sql-mssql:** Correct source reference for execute_sql tool in cloud-sql-mssql.yaml prebuilt config ([googleapis#938](googleapis#938)) ([d16728e](googleapis@d16728e)) * **prebuilt/cloud-sql-mysql:** Update list_table tool ([googleapis#924](googleapis#924)) ([2083ba5](googleapis@2083ba5)) * Replace 'float' with 'number' in McpManifest ([googleapis#985](googleapis#985)) ([59e23e1](googleapis@59e23e1)) * **server/api:** Add logger to context in tool invoke handler ([googleapis#891](googleapis#891)) ([8ce311f](googleapis@8ce311f)) * **sources/looker:** Add agent tag to Looker API calls. ([googleapis#966](googleapis#966)) ([f55dd6f](googleapis@f55dd6f)) * **tools/bigquery-execute-sql:** Ensure invoke always returns a non-null value ([googleapis#925](googleapis#925)) ([9a55b80](googleapis@9a55b80)) * **tools/mysqlsql:** Unmarshal json data from database during invoke ([googleapis#979](googleapis#979)) ([ccc3498](googleapis@ccc3498)), closes [googleapis#840](googleapis#840) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com> c45390e

[feat]: Add wait for operation tool with exponential backoff

f05aae6

prernakakkar-google requested a review from a team as a code owner July 17, 2025 13:55

blunderbuss-gcf bot assigned duwenxin99 Jul 17, 2025

prernakakkar-google requested review from averikitsch and kurtisvg July 17, 2025 13:55

prernakakkar-google changed the title ~~[feat]: Add wait for operation tool with exponential backoff~~ feat: Add wait for operation tool with exponential backoff Jul 17, 2025

Merge branch 'main' into wait-for-operation

ef6be97

fix linting error

4d282c4

averikitsch reviewed Jul 17, 2025

View reviewed changes

prernakakkar-google added 2 commits July 18, 2025 08:42

Merge branch 'main' into wait-for-operation

5374cb8

Resolve comments and add prompt

396c46d

prernakakkar-google added 2 commits July 18, 2025 17:03

resolve comments

0395aa1

Merge branch 'main' into wait-for-operation

51651ce

prernakakkar-google requested a review from averikitsch July 18, 2025 17:04

Merge branch 'main' into wait-for-operation

aaa8ee3

kurtisvg previously requested changes Jul 21, 2025

View reviewed changes

internal/tools/utility/wait-for-operation/waitforoperation.go Outdated Show resolved Hide resolved

internal/tools/utility/wait-for-operation/waitforoperation.go Outdated Show resolved Hide resolved

internal/tools/utility/wait-for-operation/waitforoperation.go Outdated Show resolved Hide resolved

prernakakkar-google added 4 commits July 22, 2025 05:08

resolve comments

ee3ff21

remove Method parameter

b64c80a

Merge branch 'main' into wait-for-operation

2a2824e

update markdown

653ed1d

prernakakkar-google requested a review from kurtisvg July 22, 2025 09:17

Merge branch 'main' into wait-for-operation

33306b0

add api key

cf140f5

averikitsch reviewed Jul 23, 2025

View reviewed changes

docs/en/resources/tools/utility/alloydbwaitforoperation.md Outdated Show resolved Hide resolved

averikitsch reviewed Jul 23, 2025

View reviewed changes

docs/en/resources/tools/utility/alloydbwaitforoperation.md Outdated Show resolved Hide resolved

averikitsch approved these changes Jul 23, 2025

View reviewed changes

fix integration test

9bf5e2f

Update docs

43a1f22

prernakakkar-google added 2 commits July 23, 2025 17:59

update folder

a89db83

Merge branch 'main' into wait-for-operation

c639450

update to folder

6636c12

prernakakkar-google added 2 commits July 23, 2025 18:15

fix name

b8867de

Merge branch 'main' into wait-for-operation

24efc44

prernakakkar-google removed the request for review from kurtisvg July 23, 2025 18:33

prernakakkar-google merged commit 3f6ec29 into main Jul 23, 2025
9 checks passed

prernakakkar-google deleted the wait-for-operation branch July 23, 2025 18:34

release-please bot mentioned this pull request Jul 23, 2025

chore(main): release 0.10.0 #886

Merged

BrewTestBot mentioned this pull request Jul 25, 2025

mcp-toolbox 0.10.0 Homebrew/homebrew-core#231171

Merged

feat: Add wait for operation tool with exponential backoff #920

feat: Add wait for operation tool with exponential backoff #920

Uh oh!

Conversation

prernakakkar-google commented Jul 17, 2025

Uh oh!

github-actions bot commented Jul 17, 2025

Uh oh!

github-actions bot commented Jul 17, 2025

Uh oh!

github-actions bot commented Jul 17, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Jul 18, 2025

Uh oh!

github-actions bot commented Jul 18, 2025

Uh oh!

github-actions bot commented Jul 21, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Jul 22, 2025

Uh oh!

github-actions bot commented Jul 22, 2025

Uh oh!

github-actions bot commented Jul 23, 2025

Uh oh!

github-actions bot commented Jul 23, 2025

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Jul 23, 2025

Uh oh!

github-actions bot commented Jul 23, 2025

Uh oh!

github-actions bot commented Jul 23, 2025

Uh oh!

github-actions bot commented Jul 23, 2025

Uh oh!

github-actions bot commented Jul 23, 2025

Uh oh!

Uh oh!

github-actions bot commented Jul 23, 2025

Uh oh!

Uh oh!