Tools

# tools/notes.py
"""Notes the agent keeps on this machine, one file per subject."""

from pathlib import Path

NOTES = Path.home() / "notes"


def write(subject: str, body: str) -> str:
    """Write one note, replacing whatever that subject held before: the whole body is the note, so read it first if you mean to add to it.

    Args:
        subject: File name of the note, without a directory or an extension.
        body: The note itself, in markdown.
    """
    NOTES.mkdir(exist_ok=True)
    path = NOTES / f"{subject}.md"
    path.write_text(body, encoding="utf-8")
    return f"wrote {len(body)} characters to {path}"

compute_exec(command="""python3 - <<'PY'
from tools.media import media_read_pdf
from tools.search import search

pages = media_read_pdf("/tmp/report.pdf")
print(search(f"who published {pages[0][:60]}"))
PY""")

~/tools/compute/compute_exec.py
~/tools/search/search.py
~/tools/media/media_read_pdf.py
~/tools/harness/harness_eval.py
~/tools/<service>/INDEX.md      what the service is, and when to reach for it

tools/notes.py      -> notes__write, notes__read
tools/shell.py      -> shell__run, shell__cd
tools/_helpers.py   -> not a tool; a helper the others import

# tools/files.py
from tools.compute import compute_read_file

def ls(path: str = ".") -> str:
    """List one directory, one level deep and never recursive: its entries with a slash after the directories, hidden ones included, directories first.

    Only that first line reaches the model.

    Args:
        path: Directory to list, absolute or relative to the sandbox home.
    """

{
  "name": "notes__write",
  "description": "Write one note, replacing whatever that subject held before: the whole body is the note, so read it first if you mean to add to it.",
  "input_schema": {
    "type": "object",
    "properties": {
      "subject": {"type": "string", "description": "File name of the note, without a directory or an extension."},
      "body": {"type": "string", "description": "The note itself, in markdown."}
    },
    "required": ["subject", "body"]
  },
  "scope": "call"
}

# tools/shell.py
import subprocess

scope = "run"


class Shell:
    """The session persists for the whole run: cd, exports and background jobs survive between calls."""

    def __init__(self):
        self.cwd = "/home/daytona"

    def run(self, cmd: str, timeout: int = 60) -> str:
        """Run one shell command in the session's current directory and return its combined output.

        Args:
            cmd: The command line to run.
            timeout: Seconds to wait before giving up.
        """
        done = subprocess.run(cmd, shell=True, cwd=self.cwd, capture_output=True,
                              text=True, timeout=timeout)
        return (done.stdout + done.stderr).strip()

    def cd(self, path: str) -> str:
        """Change the session's directory, for this call and every call after it.

        Args:
            path: Directory to move to.
        """
        self.cwd = path
        return self.cwd

"description": "Run one shell command in the session's current directory and return its combined output.\n(The session persists for the whole run: cd, exports and background jobs survive between calls.)"

if start < 1:
    raise ValueError("lines are counted from 1; start=0 reads nothing")

tools=[
    "system:compute",                          # a platform source
    "tools/files.py",                          # a file of this harness's own tools/ tree
    "019e4f9a-a679-79b4-a21c-7ff9c60b9181",    # a tool server you own
]

tools=[
    "system:compute#compute_read_file,compute_grep",   # these two, nothing else
]