[python/knowpro] Replace ui.py and cmpsearch.py with unified tools/utool.py (#1354)

- The new tool is `tools/utool.py`, can be invoked via `make demo`
(interactive) or `make compare` (batch).
- Got rid of `typeagent/demo/` completely.
- Got rid of `test/cmpsearch.py`.
- Moved `test/vizcmp.py` to `tools/` folder. It can read old and new
eval files.
- Changed default embedding name from `ada-002` to
`text-embedding-ada-002` to work with OPENAI as well.
- Fixed some generics silliness with PodcastMessage.

Author: gvanrossum-ms

python/ta/Makefile

@@ -8,23 +8,23 @@ all: venv format check test build
 
 .PHONY: format
 format: venv
-	.venv/bin/black typeagent test
+	.venv/bin/black typeagent test tools
 
 .PHONY: check
 check: venv
-	.venv/bin/pyright --pythonpath .venv/bin/python typeagent test
+	.venv/bin/pyright --pythonpath .venv/bin/python typeagent test tools
 
 .PHONY: test
 test: venv
 	.venv/bin/python -m coverage run --source=typeagent -m pytest test
 
 .PHONY: demo
 demo: venv
-	.venv/bin/python -m typeagent.demo
+	.venv/bin/python -m tools.utool $(FLAGS)
 
 .PHONY: compare
 compare: venv
-	.venv/bin/python -m test.cmpsearch
+	.venv/bin/python -m tools.utool --batch $(FLAGS)
 
 .PHONY: profile
 profile: venv
@@ -60,13 +60,15 @@ clean:
 .PHONY: help
 help:
 	@echo "Usage: make [target]"
-	@echo "make help   # Help (this message)"
-	@echo "make        # Same as 'make all'"
-	@echo "make all    # venv, format, check, test, build"
-	@echo "make format # Run black"
-	@echo "make check  # Run pyright"
-	@echo "make test   # Run pytest (tests are in test/)"
-	@echo "make build  # Build the wheel (under dist/)"
-	@echo "make venv   # Create .venv/"
-	@echo "make clean  # Remove build/, dist/, .venv/, *.egg-info/"
+	@echo "make help        # Help (this message)"
+	@echo "make             # Same as 'make all'"
+	@echo "make all         # venv, format, check, test, build"
+	@echo "make demo        # python tools/utools.py (interactive)"
+	@echo "make compare     # python tools/utools.py --batch"
+	@echo "make format      # Run black"
+	@echo "make check       # Run pyright"
+	@echo "make test        # Run pytest (tests are in test/)"
+	@echo "make build       # Build the wheel (under dist/)"
+	@echo "make venv        # Create .venv/"
+	@echo "make clean       # Remove build/, dist/, .venv/, *.egg-info/"
 	@echo "make install-uv  # Install uv (if not already installed)"

python/ta/make.bat

@@ -44,7 +44,7 @@ goto end
 :demo
 if not exist ".venv\" call make.bat venv
 echo Running demo...
-.venv\Scripts\python -m typeagent.demo
+.venv\Scripts\python -m tools.utool
 goto end
 
 :build