tools

Tool wrappers for pig workspace operations.

This module provides tools that wrap workspace kv and vfs operations as pig.tool.Tool values that can be registered with pig agents.

Each tool closes over a sqlight.Connection and provides a handler that parses JSON arguments and calls the appropriate workspace function.

Tools

read_file — Read file contents with line numbers
write_file — Create or replace a file
list_directory — List entries in a directory
delete_file — Delete a file or empty directory
grep — Search file contents for a pattern
remember — Store a key-value pair
recall — Retrieve a stored value
list_keys — List keys matching a prefix

Values

all_tools

</>

pub fn all_tools(conn: sqlight.Connection) -> List(tool.Tool)

Return all workspace tools in a list.

delete_file_tool

</>

pub fn delete_file_tool(conn: sqlight.Connection) -> tool.Tool

Create a delete_file tool.

Parameters:

path: String (required) - file or empty directory path

Deletes a file or empty directory.

grep_tool

</>

pub fn grep_tool(conn: sqlight.Connection) -> tool.Tool

Create a grep tool.

Search file contents for a substring pattern. Returns matching lines with file path and line number.

Parameters:

pattern: String (required) - substring to search for
path: String (optional) - directory or file to search under (default: root)
include: String (optional) - GLOB filter on file path (e.g. “*.py”)
max_results: Int (optional) - limit number of results (default: 50)

list_directory_tool

</>

pub fn list_directory_tool(conn: sqlight.Connection) -> tool.Tool

Create a list_directory tool.

Parameters:

path: String (required) - directory path

Returns a JSON array of entry names.

list_keys_tool

</>

pub fn list_keys_tool(conn: sqlight.Connection) -> tool.Tool

Create a list_keys tool.

Parameters:

prefix: String (required) - key prefix to match

Returns a JSON array of matching keys.

read_file_tool

</>

pub fn read_file_tool(conn: sqlight.Connection) -> tool.Tool

Create a read_file tool.

Parameters:

path: String (required) - file path
offset: Int (optional) - line number to start from (0-indexed)
limit: Int (optional) - maximum number of lines to read

Returns file content with line numbers in “N\tline” format.

recall_tool

</>

pub fn recall_tool(conn: sqlight.Connection) -> tool.Tool

Create a recall tool.

Parameters:

key: String (required) - key to retrieve

Returns the stored value as a JSON string.

remember_tool

</>

pub fn remember_tool(conn: sqlight.Connection) -> tool.Tool

Create a remember tool.

Parameters:

key: String (required) - key to store
value: String (required) - value to store

Stores a key-value pair that persists across conversations.

write_file_tool

</>

pub fn write_file_tool(conn: sqlight.Connection) -> tool.Tool

Create a write_file tool.

Parameters:

path: String (required) - file path
content: String (required) - file content

Creates or overwrites a file.