kdeps-components-search_local
v1.2.0kdeps kdeps-component: search_local
set components / shelf workflow
PurposeSearch local files through the kdeps API
LLM context: ~277 tokens when loaded (prompt or tool definition)
Where it runs
Part of the components set, used in workflow and agent mode. Ready-made workflow steps (sql, browser, email, git, ocr...) a resource calls by name; in agent mode they are also tools.
- a resource names a component (or the model calls it as a tool)
- the component's own resources runcomponents/search_local
- its output goes back to the caller
Loaded by: kdeps (agent loop), /settings, kdeps validate, kdeps run, kdeps bundle package, kdeps env, kdeps export k8s, kdeps test
In the code: kdeps (agent loop)yaml.(*Parser).ParseWorkflowyaml.(*Parser).loadAssetComponents
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.
Also installs what it requires, when missing or older: schemas/v1, tools/search_local.
Pin a version with kdeps install components/search_local@<version>.
Contents
component.yaml
apiVersion: kdeps.io/v1
kind: Component
metadata:
name: search_local
description: Search local files through the kdeps API
version: "1.2.0"
interface:
inputs:
- name: query
type: string
description: Search term. A query or a glob is required
- name: path
type: string
description: Directory to search. Empty searches the working directory
- name: glob
type: string
description: File glob filter, for example *.go
- name: limit
type: number
default: 3
description: Maximum number of results
- name: index
type: boolean
description: Build and use the folder's TF-IDF index for ranked search
- name: fuzzy
type: boolean
description: Fuzzy (Levenshtein) matching when index is true
- name: maxDistance
type: integer
description: Maximum edit distance for fuzzy matching (default 2)
- name: indexDBPath
type: string
description: Index database path; defaults to the folder's kdeps data dir
- name: graphBoost
type: boolean
description: Re-rank indexed results using the folder's reference/topic graph; requires index
# fromJSON returns the result map (results, count) rather than JSON text.
output: "{{ fromJSON(output('call').body) }}"
resources:
- actionId: call
name: Search local files
httpClient:
method: POST
# In-process host. The HTTP executor calls the handler without dialing.
url: http://kdeps.api/apis/tools.kdeps.io/v1/tools/search_local/call
headers:
Content-Type: application/json
failOnError: true
timeout: 30s
data:
query: "{{ get('search_local.query') }}"
path: "{{ get('search_local.path') }}"
glob: "{{ get('search_local.glob') }}"
limit: "{{ get('search_local.limit') }}"
index: "{{ get('search_local.index') }}"
fuzzy: "{{ get('search_local.fuzzy') }}"
maxDistance: "{{ get('search_local.maxDistance') }}"
indexDBPath: "{{ get('search_local.indexDBPath') }}"
graphBoost: "{{ get('search_local.graphBoost') }}"
requires:
schemas/v1: ""
tools/search_local: ""
version: 1.2.0
requires:
schemas/v1: ""
tools/search_local: ""
files:
component.yaml: |
apiVersion: kdeps.io/v1
kind: Component
metadata:
name: search_local
description: Search local files through the kdeps API
version: "1.2.0"
interface:
inputs:
- name: query
type: string
description: Search term. A query or a glob is required
- name: path
type: string
description: Directory to search. Empty searches the working directory
- name: glob
type: string
description: File glob filter, for example *.go
- name: limit
type: number
default: 3
description: Maximum number of results
- name: index
type: boolean
description: Build and use the folder's TF-IDF index for ranked search
- name: fuzzy
type: boolean
description: Fuzzy (Levenshtein) matching when index is true
- name: maxDistance
type: integer
description: Maximum edit distance for fuzzy matching (default 2)
- name: indexDBPath
type: string
description: Index database path; defaults to the folder's kdeps data dir
- name: graphBoost
type: boolean
description: Re-rank indexed results using the folder's reference/topic graph; requires index
# fromJSON returns the result map (results, count) rather than JSON text.
output: "{{ fromJSON(output('call').body) }}"
resources:
- actionId: call
name: Search local files
httpClient:
method: POST
# In-process host. The HTTP executor calls the handler without dialing.
url: http://kdeps.api/apis/tools.kdeps.io/v1/tools/search_local/call
headers:
Content-Type: application/json
failOnError: true
timeout: 30s
data:
query: "{{ get('search_local.query') }}"
path: "{{ get('search_local.path') }}"
glob: "{{ get('search_local.glob') }}"
limit: "{{ get('search_local.limit') }}"
index: "{{ get('search_local.index') }}"
fuzzy: "{{ get('search_local.fuzzy') }}"
maxDistance: "{{ get('search_local.maxDistance') }}"
indexDBPath: "{{ get('search_local.indexDBPath') }}"
graphBoost: "{{ get('search_local.graphBoost') }}"
Versions
| Version | Published | Status |
|---|---|---|
| 1.2.0 | 10/21/2026 | active |
| 1.1.1 | 10/21/2026 | active |
| 1.1.0 | 10/21/2026 | active |
| 1.0.0 | 10/20/2026 | active |
Details
- Author
- kdeps
- License
- Apache-2.0
- Latest Version
- 1.2.0
- Published
- 10/20/2026