Tool descriptions

This commit is contained in:
moosecrap 2026-07-23 14:33:06 -07:00
parent a2cc56200c
commit 03e47bad42

View File

@ -26,7 +26,7 @@ from .preview_image import handle as preview_image_handler
TOOL_REGISTRY = [
Tool(
name="read_image",
description="Reads an image from the disk and returns it as a full size image.",
description="Reads an image at full resolution for maximum detail. Use this for final confirmation of a selected image or when deep visual analysis of a specific file is required.",
schema={
"type": "object",
"properties": {"path": {"type": "string", "description": "Path to the image file"}},
@ -36,7 +36,7 @@ TOOL_REGISTRY = [
),
Tool(
name="read_png_metadata",
description="Reads the metadata (tEXt, zTXt, iTXt) from a PNG image to fetch info such as AI prompts.",
description="Reads the metadata (tEXt, zTXt, iTXt) from a PNG image to fetch info such as prompts for AI generated images.",
schema={
"type": "object",
"properties": {"path": {"type": "string", "description": "Path to the PNG file"}},
@ -46,12 +46,12 @@ TOOL_REGISTRY = [
),
Tool(
name="contact_sheet",
description="Generates a high-density contact sheet of images in a directory, for low-token previews.",
description="Generates a coarse, high-density overview of a directory. This tool is paginated; a single page may not show all images. To perform a comprehensive scan or find specific images, you MUST iterate through multiple pages. DO NOT use this for selecting specific images or making quality judgments; use preview_image for those tasks.",
schema={
"type": "object",
"properties": {
"path": {"type": "string", "description": "Path to the directory containing images"},
"page": {"type": "integer", "description": "The page number to retrieve (1-indexed)", "default": 1},
"page": {"type": "integer", "description": "The page number to retrieve (1-indexed). Increment this value to navigate through the full list of images in the folder.", "default": 1},
"sort_by": {"type": "string", "description": "Sort order: 'mtime' (newest first, default), 'name' (alphabetical), or 'size' (largest first)", "default": "mtime"},
},
"required": ["path"],
@ -75,7 +75,7 @@ TOOL_REGISTRY = [
),
Tool(
name="preview_image",
description="Generates small thumbnails and provides detailed info for images. Can take file paths, or indices/ranges from a contact sheet.",
description="Provides low-resolution previews and detailed file info for specific images. It uses the minimum viable token budget, so some fine details will be missed. This is the PRIMARY tool for inspecting files, comparing candidates, or selecting images before moving to read_image for maximum detail.",
schema={
"type": "object",
"properties": {