Alphakdeps.io is experimental and evolving — the registry and packages may change or reset.
kdeps componentkdeps asset

kdeps-components-search_local

v1.2.0

kdeps 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.

  1. a resource names a component (or the model calls it as a tool)
  2. the component's own resources runcomponents/search_local
  3. 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.

kdeps install components/search_local

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: ""

Versions

VersionPublishedStatus
1.2.010/21/2026active
1.1.110/21/2026active
1.1.010/21/2026active
1.0.010/20/2026active

Details

Author
kdeps
License
Apache-2.0
Latest Version
1.2.0
Published
10/20/2026

Tags

kdepskdeps-component