From ed8ee03e22115166872a708300bbce10f1a12347 Mon Sep 17 00:00:00 2001
From: Mario Zechner <badlogicgames@gmail.com>
Date: Wed, 17 Dec 2025 16:41:55 +0100
Subject: [PATCH] Add available imports section to custom tools docs

---
 packages/coding-agent/docs/custom-tools.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/coding-agent/docs/custom-tools.md b/packages/coding-agent/docs/custom-tools.md
index 66beb71d..777ee25e 100644
--- a/packages/coding-agent/docs/custom-tools.md
+++ b/packages/coding-agent/docs/custom-tools.md
@@ -44,6 +44,19 @@ The tool is automatically discovered and available in your next pi session.
 
 **Reserved names:** Custom tools cannot use built-in tool names (`read`, `write`, `edit`, `bash`, `grep`, `find`, `ls`).
 
+## Available Imports
+
+Custom tools can import from these packages (automatically resolved by pi):
+
+| Package | Purpose |
+|---------|---------|
+| `@sinclair/typebox` | Schema definitions (`Type.Object`, `Type.String`, etc.) |
+| `@mariozechner/pi-coding-agent` | Types (`CustomToolFactory`, `ToolSessionEvent`, etc.) |
+| `@mariozechner/pi-ai` | AI utilities (`StringEnum` for Google-compatible enums) |
+| `@mariozechner/pi-tui` | TUI components (`Text`, `Box`, etc. for custom rendering) |
+
+Node.js built-in modules (`node:fs`, `node:path`, etc.) are also available.
+
 ## Tool Definition
 
 ```typescript