Skip to main content

Tools Reference

Complete reference for all built-in tools available in the Sekuire SDKs.

Tool Categories​

CategoryToolsDescription
File Operations10 toolsRead, write, copy, move, delete files
Directory Operations8 toolsCreate, list, remove directories
Network8 toolsHTTP requests, DNS, ping, downloads
Data Formats9 toolsJSON, CSV, YAML, XML, Base64
Utilities7 toolsCalculator, UUID, dates, regex
System4 toolsEnvironment, platform info
Compliance5 toolsPII detection, encryption, audit
Agent Communication6 toolsA2A delegation, discovery

File Operations​

file_read​

Read the contents of a file.

ParameterTypeRequiredDescription
pathstringYesPath to the file
encodingstringNoFile encoding (default: utf-8)
const result = await tools.execute('file_read', { path: './data.txt' });

file_write​

Write content to a file.

ParameterTypeRequiredDescription
pathstringYesPath to the file
contentstringYesContent to write
encodingstringNoFile encoding (default: utf-8)
await tools.execute('file_write', {
  path: './output.txt',
  content: 'Hello, World!'
});

file_append​

Append content to an existing file.

ParameterTypeRequiredDescription
pathstringYesPath to the file
contentstringYesContent to append

file_delete​

Delete a file.

ParameterTypeRequiredDescription
pathstringYesPath to the file

file_move​

Move or rename a file.

ParameterTypeRequiredDescription
sourcestringYesSource path
destinationstringYesDestination path

file_copy​

Copy a file.

ParameterTypeRequiredDescription
sourcestringYesSource path
destinationstringYesDestination path

file_stat​

Get file metadata (size, timestamps, permissions).

ParameterTypeRequiredDescription
pathstringYesPath to the file

file_exists​

Check if a file exists.

ParameterTypeRequiredDescription
pathstringYesPath to check

file_list​

List files in a directory.

ParameterTypeRequiredDescription
pathstringYesDirectory path
patternstringNoGlob pattern filter

file_chmod​

Change file permissions (Unix only).

ParameterTypeRequiredDescription
pathstringYesPath to the file
modestringYesPermission mode (e.g., "755")

Directory Operations​

directory_list​

List directory contents with details.

ParameterTypeRequiredDescription
pathstringYesDirectory path
recursivebooleanNoInclude subdirectories

directory_mkdir​

Create a directory.

ParameterTypeRequiredDescription
pathstringYesDirectory path
recursivebooleanNoCreate parent directories

directory_rmdir​

Remove an empty directory.

ParameterTypeRequiredDescription
pathstringYesDirectory path

directory_rm_recursive​

Remove a directory and all contents.

ParameterTypeRequiredDescription
pathstringYesDirectory path
warning

This operation is destructive and cannot be undone.

directory_exists​

Check if a directory exists.

ParameterTypeRequiredDescription
pathstringYesDirectory path

directory_move​

Move a directory.

ParameterTypeRequiredDescription
sourcestringYesSource path
destinationstringYesDestination path

directory_copy​

Copy a directory recursively.

ParameterTypeRequiredDescription
sourcestringYesSource path
destinationstringYesDestination path

directory_tree​

Get a tree representation of directory structure.

ParameterTypeRequiredDescription
pathstringYesRoot directory
depthnumberNoMax depth (default: 3)

Network​

Search the web using DuckDuckGo.

ParameterTypeRequiredDescription
querystringYesSearch query
num_resultsnumberNoNumber of results (default: 5)

http_request​

Make an HTTP request (any method).

ParameterTypeRequiredDescription
urlstringYesRequest URL
methodstringNoHTTP method (default: GET)
headersobjectNoRequest headers
bodyobjectNoRequest body
timeoutnumberNoTimeout in ms

http_post​

Make an HTTP POST request.

ParameterTypeRequiredDescription
urlstringYesRequest URL
bodyobjectYesRequest body
headersobjectNoRequest headers

http_put​

Make an HTTP PUT request.

ParameterTypeRequiredDescription
urlstringYesRequest URL
bodyobjectYesRequest body
headersobjectNoRequest headers

http_delete​

Make an HTTP DELETE request.

ParameterTypeRequiredDescription
urlstringYesRequest URL
headersobjectNoRequest headers

download_file​

Download a file from URL.

ParameterTypeRequiredDescription
urlstringYesFile URL
destinationstringYesLocal path to save

dns_lookup​

Perform DNS lookup.

ParameterTypeRequiredDescription
hostnamestringYesHostname to resolve
typestringNoRecord type (A, AAAA, MX, etc.)

ping​

Ping a host to check connectivity.

ParameterTypeRequiredDescription
hoststringYesHost to ping
countnumberNoNumber of pings (default: 4)

Data Formats​

json_parse​

Parse JSON string to object.

ParameterTypeRequiredDescription
datastringYesJSON string

json_stringify​

Convert object to JSON string.

ParameterTypeRequiredDescription
dataobjectYesObject to stringify
prettybooleanNoPretty print (default: false)

csv_parse​

Parse CSV data to array of objects.

ParameterTypeRequiredDescription
datastringYesCSV string
headersbooleanNoFirst row is headers (default: true)
delimiterstringNoField delimiter (default: ",")

csv_write​

Convert array of objects to CSV.

ParameterTypeRequiredDescription
dataarrayYesArray of objects
headersarrayNoColumn headers

yaml_parse​

Parse YAML string.

ParameterTypeRequiredDescription
datastringYesYAML string

xml_parse​

Parse XML string.

ParameterTypeRequiredDescription
datastringYesXML string

base64_encode​

Encode string to Base64.

ParameterTypeRequiredDescription
datastringYesString to encode

base64_decode​

Decode Base64 string.

ParameterTypeRequiredDescription
datastringYesBase64 string

hash​

Generate hash of data.

ParameterTypeRequiredDescription
datastringYesData to hash
algorithmstringNoHash algorithm (sha256, md5, etc.)

Utilities​

calculator​

Evaluate mathematical expressions safely.

ParameterTypeRequiredDescription
expressionstringYesMath expression (e.g., "2 + 2 * 3")
const result = await tools.execute('calculator', {
  expression: '(100 * 1.15) / 2'
});
// Returns: 57.5

date_format​

Format dates.

ParameterTypeRequiredDescription
datestringNoDate string (default: now)
formatstringYesOutput format
timezonestringNoTimezone

generate_uuid​

Generate a UUID v4.

No parameters required.

const uuid = await tools.execute('generate_uuid', {});
// Returns: "550e8400-e29b-41d4-a716-446655440000"

random_number​

Generate a random number.

ParameterTypeRequiredDescription
minnumberNoMinimum value (default: 0)
maxnumberNoMaximum value (default: 100)

sleep​

Pause execution for a duration.

ParameterTypeRequiredDescription
msnumberYesMilliseconds to sleep

regex_match​

Match text against a regular expression.

ParameterTypeRequiredDescription
textstringYesText to search
patternstringYesRegex pattern
flagsstringNoRegex flags (g, i, m)

url_parse​

Parse a URL into components.

ParameterTypeRequiredDescription
urlstringYesURL to parse

System​

get_cwd​

Get current working directory.

No parameters required.

get_platform​

Get platform information (OS, arch, version).

No parameters required.

env_get​

Get an environment variable.

ParameterTypeRequiredDescription
namestringYesVariable name

env_set​

Set an environment variable.

ParameterTypeRequiredDescription
namestringYesVariable name
valuestringYesVariable value

Compliance​

get_verification_status​

Check agent verification status in the Sekuire registry.

ParameterTypeRequiredDescription
sekuire_idstringNoAgent ID (default: current agent)
include_detailsbooleanNoInclude detailed info
note

This tool is automatically included in all agents for trust protocol compliance.

audit_log​

Write an entry to the compliance audit log.

ParameterTypeRequiredDescription
actionstringYesAction being logged
resourcestringNoResource affected
metadataobjectNoAdditional metadata

pii_detect​

Detect personally identifiable information in text.

ParameterTypeRequiredDescription
textstringYesText to scan
typesarrayNoPII types to detect

Returns detected PII types: email, phone, SSN, credit card, etc.

encrypt_data​

Encrypt sensitive data.

ParameterTypeRequiredDescription
datastringYesData to encrypt
keystringNoEncryption key (auto-generated if not provided)

decrypt_data​

Decrypt encrypted data.

ParameterTypeRequiredDescription
datastringYesEncrypted data
keystringYesDecryption key

Agent Communication​

These tools enable agent-to-agent (A2A) communication.

search_agents​

Search the registry for agents.

ParameterTypeRequiredDescription
querystringNoSearch query
capabilitiesarrayNoRequired capabilities
verified_onlybooleanNoOnly verified agents

get_agent_info​

Get detailed information about an agent.

ParameterTypeRequiredDescription
sekuire_idstringYesAgent's Sekuire ID

invoke_agent​

Invoke another agent's skill.

ParameterTypeRequiredDescription
sekuire_idstringYesTarget agent ID
skillstringYesSkill to invoke
inputobjectYesSkill input parameters
const result = await tools.execute('invoke_agent', {
  sekuire_id: 'abc123...',
  skill: 'analyze_data',
  input: { data_url: 'https://example.com/data.csv' }
});

agent_discovery​

Discover agents with specific capabilities.

ParameterTypeRequiredDescription
capabilitiesarrayYesRequired capabilities
min_reputationnumberNoMinimum reputation score

agent_delegation​

Delegate a task to another agent.

ParameterTypeRequiredDescription
taskstringYesTask description
sekuire_idstringNoSpecific agent (auto-select if not provided)
timeout_msnumberNoTask timeout

agent_status​

Check the status of a delegated task.

ParameterTypeRequiredDescription
task_idstringYesTask ID from delegation

Google Workspace​

google_docs_create​

Create a Google Doc (requires Google OAuth).

ParameterTypeRequiredDescription
titlestringYesDocument title
contentstringNoInitial content

Tool Compliance Levels​

Each tool has a compliance level that determines its access requirements:

LevelDescriptionApproval Required
publicSafe for general useNo
internalInternal operationsPolicy-dependent
restrictedSensitive operationsYes
systemSystem-level toolsCannot be disabled

Configure tool approval in your workspace policies.

Next Steps​