Skip to content
LOPS Docs

Tool Monitor

v1.2.0 What's new
See LOPs 0.1.1 Full changelog →

Tool Monitor v1.2.0 [ September 2, 2025 ]

  • Unified parameter structure reducing from 30+ to 13 parameters
  • Recursive error detection for nested script errors
  • Fixed duplication issues and improved change detection
  • Reduced capture delay to 0.1s for responsiveness
  • Character count logging with data volume reporting
  • Debug mode with comprehensive error detection logging

Overview

Section titled “Overview”

The Tool Monitor operator tracks user activity in the TouchDesigner network, such as selected operators, modified parameters, and errors. It then exposes this information as a tool that can be called by an agent, allowing the agent to have context about what the user is currently doing in the network.

Requirements

Section titled “Requirements”
  • ChatTD Operator: Required for logging.

Parameters

Section titled “Parameters”

Page: Activity

Section titled “Page: Activity”
Note: This operator should be fast - 100% 60 fps Header
if project is dropping FPS, check for data loops Header
Poll Timer Length (Length) op('tool_monitor').par.Length Float
Default:
10.0
Hide Heavy Viewers (Hideheavyviewer) op('tool_monitor').par.Hideheavyviewer Toggle
Default:
None
Max Characters (Maxchars) op('tool_monitor').par.Maxchars Int
Default:
100000
Data Collection Header
Include Basic Info (Includebasic) op('tool_monitor').par.Includebasic Toggle
Default:
None
Include Hover Info (Includehover) op('tool_monitor').par.Includehover Toggle
Default:
None
Include Parameters (Includeparameters) op('tool_monitor').par.Includeparameters Toggle
Default:
None
Include Details (Includedetails) op('tool_monitor').par.Includedetails Toggle
Default:
None
Include Context (Includecontext) op('tool_monitor').par.Includecontext Toggle
Default:
None
Include Errors (Includeerrors) op('tool_monitor').par.Includeerrors Toggle
Default:
None
Include Changes (Includechanges) op('tool_monitor').par.Includechanges Toggle
Default:
None
Tool Settings Header
Recent Count (Recentcount) op('tool_monitor').par.Recentcount Int
Default:
5
Max Characters (Maxcharacters) op('tool_monitor').par.Maxcharacters Int
Default:
1000
Min Capture Delay (sec) (Mincapturedelay) op('tool_monitor').par.Mincapturedelay Float
Default:
0.1
Debug Settings Header

Page: About

Section titled “Page: About”
Bypass (Bypass) op('tool_monitor').par.Bypass Toggle
Default:
None
Show Built-in Parameters (Showbuiltin) op('tool_monitor').par.Showbuiltin Toggle
Default:
None
Debug Errors (Debugerrors) op('tool_monitor').par.Debugerrors Toggle
Default:
None
Log Character Count (Logcharcount) op('tool_monitor').par.Logcharcount Toggle
Default:
None
Version (Version) op('tool_monitor').par.Version Str
Default:
None
Last Updated (Lastupdated) op('tool_monitor').par.Lastupdated Str
Default:
None
Creator (Creator) op('tool_monitor').par.Creator Str
Default:
None
Website (Website) op('tool_monitor').par.Website Str
Default:
None
ChatTD Operator (Chattd) op('tool_monitor').par.Chattd OP
Default:
None

Usage Examples

Section titled “Usage Examples”

Connecting to an Agent

Section titled “Connecting to an Agent”
  1. Create a tool_monitor operator.
  2. Create an agent operator.
  3. On the Tools page of the agent, add the tool_monitor operator to the External Op Tools parameter.
  4. Start a conversation with the agent. The agent can now call the get_recent_activity tool to get information about what you are doing in the network.