kdeps-tools-google_cache_list
v2.0.0List all Google AI cached content entries. Returns a JSON array of cache names. Only available when GOOGLE_API_KEY is set.
set tools / shelf tools
LLM context: ~37 tokens when loaded (prompt or tool definition)
Where it runs
Part of the tools set, used in workflow and agent mode. What the model is told about each built-in tool: its description, usage notes and parameters. kdeps runs the tool itself.
- the agent loop builds the request
- the tool definitions are sent to the modeltools/google_cache_list
- the model calls a tool
- kdeps runs it
- the result goes back to the model
Loaded by: kdeps (agent loop), /update, /settings, kdeps run, kdeps install, kdeps list, kdeps uninstall, kdeps update
In the code: kdeps (agent loop)agent.RegisterBuiltinToolsagent.definedAs
Install
A kdeps asset: installed with the first-run profile that includes its set, or the first time a command needs it, and updated without a new release.
Pin a version with kdeps install tools/google_cache_list@<version>.
Contents
List all Google AI cached content entries. Returns a JSON array of cache names. Only available when GOOGLE_API_KEY is set.
| Parameter | Type | Description |
|---|
HTTP call (declared in YAML, no Go code)
https://generativelanguage.googleapis.com/v1beta/cachedContents?pageSize=1000Offered when set: GOOGLE_API_KEY
- x-goog-api-key:
- {{.env.API_KEY}}
Result
[{{range $i, $c := .response.cachedContents}}{{if $i}}, {{end}}{{json $c.name}}{{end}}]
version: 2.0.0
description: List all Google AI cached content entries. Returns a JSON array of cache names. Only available when GOOGLE_API_KEY is set.
parameters: {}
http:
env:
API_KEY: [GOOGLE_API_KEY] # the tool is listed only when this is set
method: GET
url: https://generativelanguage.googleapis.com/v1beta/cachedContents?pageSize=1000
headers:
x-goog-api-key: "{{.env.API_KEY}}"
result: '[{{range $i, $c := .response.cachedContents}}{{if $i}}, {{end}}{{json $c.name}}{{end}}]'
Versions
| Version | Published | Status |
|---|---|---|
| 2.0.0 | 10/24/2026 | active |
| 1.0.0 | 10/11/2026 | active |
Details
- Author
- kdeps
- License
- Apache-2.0
- Latest Version
- 2.0.0
- Published
- 10/11/2026