Module tools 

The tools, as plain data: a name, a title, what it does (and, for those that write, what it changes), the JSON schema of its arguments, and the function that does it. MCP lists and calls them (protocol); another agent protocol, or another transport, can serve the same table.

No tool deletes, sends, moves money or mail, or reads a password or a key. Those that write only add (a task, an event, a note, a draft, a tie, a spam label) or mark a task done, on this computer; the person sees each in Sioul’s window. The spam filter’s tools (spam, computers only) are listed after the others, unless the person keeps them from agents ([mcp] spam = false).

Structs

Answer

What a tool hands back: lines to read, in the configuration’s language where Sioul words them, and the same as data (MCP’s structured content).

Args

A tool’s arguments, read one by one; a wrong type is said in a sentence the agent can act on.

Tool

Constants

DAY 🔒

FORMER 🔒

Arguments renamed when cases and projects became one, “project”: an agent set up before still gives the old name, read as the new one.

MOMENT 🔒

TOOLS

Functions

all

Every tool: the general ones, then the spam filter’s (computers only).

call

Runs a tool on its arguments, once they fit its schema: no argument it does not know, none it needs missing. Types are checked as each is read.

find

The tool with this name.

is_spam

Whether a tool is one of the spam filter’s, which [mcp] spam = false keeps from agents.

is_texts

Whether a tool reads or drafts texts, which only [mcp] texts = true offers.

listing

A tool as tools/list gives it, with its hints (MCP’s ToolAnnotations): nothing destructive, nothing outside this computer.

object

An object schema: its properties, those required, and nothing else.

text_lines

Words on several lines, as they are shown or written: every line break made “\n” (a lone “\r” too, which some readers of iCalendar take for one), tabs kept, the other control characters gone (a terminal’s escape sequences, the marks that turn text right to left).