microsoft · gvanrossum · Dec 31, 2025 · Dec 31, 2025 · Dec 31, 2025 · Dec 31, 2025
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -80,13 +80,13 @@ jobs:
         shell: bash
         if: matrix.task == 'check'
         run: |
-            uv run pyright typeagent test tools gmail
+            uv run pyright src test tools gmail
 
       - name: Run Format
         shell: bash
         if: matrix.task == 'format'
         run: |
-            uv run black -tpy312 -tpy313 -tpy314 typeagent test tools gmail demo --check
+            uv run black -tpy312 -tpy313 -tpy314 src test tools gmail demo --check
 
       - name: Login to Azure
         if: matrix.task == 'test'

diff --git a/Makefile b/Makefile
@@ -8,12 +8,12 @@ all: venv format check test build
 
 .PHONY: format
 format: venv
-	.venv/bin/isort typeagent test tools gmail demo $(FLAGS)
-	.venv/bin/black -tpy312 -tpy313 -tpy314 typeagent test tools gmail demo $(FLAGS)
+	.venv/bin/isort src test tools gmail demo $(FLAGS)
+	.venv/bin/black -tpy312 -tpy313 -tpy314 src test tools gmail demo $(FLAGS)
 
 .PHONY: check
 check: venv
-	.venv/bin/pyright --pythonpath .venv/bin/python typeagent test tools gmail
+	.venv/bin/pyright --pythonpath .venv/bin/python src test tools gmail
 
 .PHONY: test
 test: venv
@@ -36,7 +36,7 @@ compare: venv
 
 .PHONY: mcp
 mcp: venv
-	.venv/bin/mcp dev typeagent/mcp/server.py
+	.venv/bin/mcp dev src/typeagent/mcp/server.py
 
 .PHONY: profile
 profile: venv

diff --git a/make.bat b/make.bat
@@ -26,14 +26,14 @@ goto help
 :format
 if not exist ".venv\" call make.bat venv
 echo Formatting code...
-.venv\Scripts\isort typeagent test tools gmail demo
-.venv\Scripts\black typeagent test tools gmail demo
+.venv\Scripts\isort src test tools gmail demo
+.venv\Scripts\black src test tools gmail demo
 goto end
 
 :check
 if not exist ".venv\" call make.bat venv
 echo Running type checks...
-.venv\Scripts\pyright --pythonpath .venv\Scripts\python typeagent test tools gmail demo
+.venv\Scripts\pyright --pythonpath .venv\Scripts\python src test tools gmail demo
 goto end
 
 :test

diff --git a/pyproject.toml b/pyproject.toml
@@ -65,7 +65,7 @@ GitHub = "https://github.com/microsoft/typeagent-py"
 Documentation = "https://github.com/microsoft/typeagent-py/tree/main/docs/README.md"
 
 [tool.uv.build-backend]
-module-root = ""
+module-root = "src"
 
 [tool.pytest.ini_options]
 asyncio_default_fixture_loop_scope = "function"
@@ -85,3 +85,8 @@ sections = ["FUTURE", "STDLIB", "THIRDPARTY", "AI", "FIRSTPARTY", "LOCALFOLDER"]
 known_ai = ["mcp", "openai", "pydantic", "pydantic_ai", "tiktoken", "typechat"]
 known_first_party = ["typeagent", "test", "tools", "gmail", "demo"]
 known_local_folder = ["conftest"]
+
+[dependency-groups]
+dev = [
+    "isort>=7.0.0",
+]
diff --git a/typeagent/__init__.py → src/typeagent/__init__.py b/typeagent/__init__.py → src/typeagent/__init__.py
diff --git a/typeagent/aitools/auth.py → src/typeagent/aitools/auth.py b/typeagent/aitools/auth.py → src/typeagent/aitools/auth.py
diff --git a/typeagent/aitools/embeddings.py → src/typeagent/aitools/embeddings.py b/typeagent/aitools/embeddings.py → src/typeagent/aitools/embeddings.py
diff --git a/typeagent/aitools/utils.py → src/typeagent/aitools/utils.py b/typeagent/aitools/utils.py → src/typeagent/aitools/utils.py
diff --git a/typeagent/aitools/vectorbase.py → src/typeagent/aitools/vectorbase.py b/typeagent/aitools/vectorbase.py → src/typeagent/aitools/vectorbase.py
diff --git a/typeagent/emails/emailVerbs.json → src/typeagent/emails/emailVerbs.json b/typeagent/emails/emailVerbs.json → src/typeagent/emails/emailVerbs.json
diff --git a/typeagent/emails/email_import.py → src/typeagent/emails/email_import.py b/typeagent/emails/email_import.py → src/typeagent/emails/email_import.py
diff --git a/typeagent/emails/email_memory.py → src/typeagent/emails/email_memory.py b/typeagent/emails/email_memory.py → src/typeagent/emails/email_memory.py
diff --git a/typeagent/emails/email_message.py → src/typeagent/emails/email_message.py b/typeagent/emails/email_message.py → src/typeagent/emails/email_message.py
diff --git a/typeagent/emails/noiseTerms.txt → src/typeagent/emails/noiseTerms.txt b/typeagent/emails/noiseTerms.txt → src/typeagent/emails/noiseTerms.txt
diff --git a/typeagent/knowpro/answer_context_schema.py → ...ypeagent/knowpro/answer_context_schema.py b/typeagent/knowpro/answer_context_schema.py → ...ypeagent/knowpro/answer_context_schema.py
diff --git a/typeagent/knowpro/answer_response_schema.py → ...peagent/knowpro/answer_response_schema.py b/typeagent/knowpro/answer_response_schema.py → ...peagent/knowpro/answer_response_schema.py
diff --git a/typeagent/knowpro/answers.py → src/typeagent/knowpro/answers.py b/typeagent/knowpro/answers.py → src/typeagent/knowpro/answers.py
diff --git a/typeagent/knowpro/collections.py → src/typeagent/knowpro/collections.py b/typeagent/knowpro/collections.py → src/typeagent/knowpro/collections.py
diff --git a/typeagent/knowpro/common.py → src/typeagent/knowpro/common.py b/typeagent/knowpro/common.py → src/typeagent/knowpro/common.py
diff --git a/typeagent/knowpro/conversation_base.py → src/typeagent/knowpro/conversation_base.py b/typeagent/knowpro/conversation_base.py → src/typeagent/knowpro/conversation_base.py
diff --git a/typeagent/knowpro/convknowledge.py → src/typeagent/knowpro/convknowledge.py b/typeagent/knowpro/convknowledge.py → src/typeagent/knowpro/convknowledge.py
diff --git a/typeagent/knowpro/convsettings.py → src/typeagent/knowpro/convsettings.py b/typeagent/knowpro/convsettings.py → src/typeagent/knowpro/convsettings.py
diff --git a/typeagent/knowpro/convutils.py → src/typeagent/knowpro/convutils.py b/typeagent/knowpro/convutils.py → src/typeagent/knowpro/convutils.py
diff --git a/typeagent/knowpro/dataclasses.py → src/typeagent/knowpro/dataclasses.py b/typeagent/knowpro/dataclasses.py → src/typeagent/knowpro/dataclasses.py
diff --git a/typeagent/knowpro/date_time_schema.py → src/typeagent/knowpro/date_time_schema.py b/typeagent/knowpro/date_time_schema.py → src/typeagent/knowpro/date_time_schema.py
diff --git a/typeagent/knowpro/factory.py → src/typeagent/knowpro/factory.py b/typeagent/knowpro/factory.py → src/typeagent/knowpro/factory.py
diff --git a/typeagent/knowpro/field_helpers.py → src/typeagent/knowpro/field_helpers.py b/typeagent/knowpro/field_helpers.py → src/typeagent/knowpro/field_helpers.py
diff --git a/typeagent/knowpro/fuzzyindex.py → src/typeagent/knowpro/fuzzyindex.py b/typeagent/knowpro/fuzzyindex.py → src/typeagent/knowpro/fuzzyindex.py
diff --git a/typeagent/knowpro/interfaces.py → src/typeagent/knowpro/interfaces.py b/typeagent/knowpro/interfaces.py → src/typeagent/knowpro/interfaces.py
diff --git a/typeagent/knowpro/interfaces_core.py → src/typeagent/knowpro/interfaces_core.py b/typeagent/knowpro/interfaces_core.py → src/typeagent/knowpro/interfaces_core.py
diff --git a/typeagent/knowpro/interfaces_indexes.py → src/typeagent/knowpro/interfaces_indexes.py b/typeagent/knowpro/interfaces_indexes.py → src/typeagent/knowpro/interfaces_indexes.py
diff --git a/typeagent/knowpro/interfaces_search.py → src/typeagent/knowpro/interfaces_search.py b/typeagent/knowpro/interfaces_search.py → src/typeagent/knowpro/interfaces_search.py
diff --git a/...agent/knowpro/interfaces_serialization.py → ...agent/knowpro/interfaces_serialization.py b/...agent/knowpro/interfaces_serialization.py → ...agent/knowpro/interfaces_serialization.py
diff --git a/typeagent/knowpro/interfaces_storage.py → src/typeagent/knowpro/interfaces_storage.py b/typeagent/knowpro/interfaces_storage.py → src/typeagent/knowpro/interfaces_storage.py
diff --git a/typeagent/knowpro/knowledge.py → src/typeagent/knowpro/knowledge.py b/typeagent/knowpro/knowledge.py → src/typeagent/knowpro/knowledge.py
diff --git a/typeagent/knowpro/kplib.py → src/typeagent/knowpro/kplib.py b/typeagent/knowpro/kplib.py → src/typeagent/knowpro/kplib.py
diff --git a/typeagent/knowpro/messageutils.py → src/typeagent/knowpro/messageutils.py b/typeagent/knowpro/messageutils.py → src/typeagent/knowpro/messageutils.py
diff --git a/typeagent/knowpro/query.py → src/typeagent/knowpro/query.py b/typeagent/knowpro/query.py → src/typeagent/knowpro/query.py
diff --git a/typeagent/knowpro/search.py → src/typeagent/knowpro/search.py b/typeagent/knowpro/search.py → src/typeagent/knowpro/search.py
diff --git a/typeagent/knowpro/search_query_schema.py → src/typeagent/knowpro/search_query_schema.py b/typeagent/knowpro/search_query_schema.py → src/typeagent/knowpro/search_query_schema.py
diff --git a/typeagent/knowpro/searchlang.py → src/typeagent/knowpro/searchlang.py b/typeagent/knowpro/searchlang.py → src/typeagent/knowpro/searchlang.py
diff --git a/typeagent/knowpro/searchlib.py → src/typeagent/knowpro/searchlib.py b/typeagent/knowpro/searchlib.py → src/typeagent/knowpro/searchlib.py
diff --git a/typeagent/knowpro/secindex.py → src/typeagent/knowpro/secindex.py b/typeagent/knowpro/secindex.py → src/typeagent/knowpro/secindex.py
diff --git a/typeagent/knowpro/serialization.py → src/typeagent/knowpro/serialization.py b/typeagent/knowpro/serialization.py → src/typeagent/knowpro/serialization.py
diff --git a/typeagent/knowpro/textlocindex.py → src/typeagent/knowpro/textlocindex.py b/typeagent/knowpro/textlocindex.py → src/typeagent/knowpro/textlocindex.py
diff --git a/typeagent/knowpro/universal_message.py → src/typeagent/knowpro/universal_message.py b/typeagent/knowpro/universal_message.py → src/typeagent/knowpro/universal_message.py
diff --git a/typeagent/knowpro/utils.py → src/typeagent/knowpro/utils.py b/typeagent/knowpro/utils.py → src/typeagent/knowpro/utils.py
diff --git a/typeagent/mcp/server.py → src/typeagent/mcp/server.py b/typeagent/mcp/server.py → src/typeagent/mcp/server.py
diff --git a/typeagent/podcasts/podcast.py → src/typeagent/podcasts/podcast.py b/typeagent/podcasts/podcast.py → src/typeagent/podcasts/podcast.py
diff --git a/typeagent/podcasts/podcastVerbs.json → src/typeagent/podcasts/podcastVerbs.json b/typeagent/podcasts/podcastVerbs.json → src/typeagent/podcasts/podcastVerbs.json
diff --git a/typeagent/podcasts/podcast_ingest.py → src/typeagent/podcasts/podcast_ingest.py b/typeagent/podcasts/podcast_ingest.py → src/typeagent/podcasts/podcast_ingest.py
diff --git a/typeagent/py.typed → src/typeagent/py.typed b/typeagent/py.typed → src/typeagent/py.typed
diff --git a/typeagent/storage/__init__.py → src/typeagent/storage/__init__.py b/typeagent/storage/__init__.py → src/typeagent/storage/__init__.py
diff --git a/typeagent/storage/memory/__init__.py → src/typeagent/storage/memory/__init__.py b/typeagent/storage/memory/__init__.py → src/typeagent/storage/memory/__init__.py
diff --git a/typeagent/storage/memory/collections.py → src/typeagent/storage/memory/collections.py b/typeagent/storage/memory/collections.py → src/typeagent/storage/memory/collections.py
diff --git a/typeagent/storage/memory/convthreads.py → src/typeagent/storage/memory/convthreads.py b/typeagent/storage/memory/convthreads.py → src/typeagent/storage/memory/convthreads.py
diff --git a/typeagent/storage/memory/messageindex.py → src/typeagent/storage/memory/messageindex.py b/typeagent/storage/memory/messageindex.py → src/typeagent/storage/memory/messageindex.py
diff --git a/typeagent/storage/memory/propindex.py → src/typeagent/storage/memory/propindex.py b/typeagent/storage/memory/propindex.py → src/typeagent/storage/memory/propindex.py
diff --git a/typeagent/storage/memory/provider.py → src/typeagent/storage/memory/provider.py b/typeagent/storage/memory/provider.py → src/typeagent/storage/memory/provider.py
diff --git a/typeagent/storage/memory/reltermsindex.py → ...typeagent/storage/memory/reltermsindex.py b/typeagent/storage/memory/reltermsindex.py → ...typeagent/storage/memory/reltermsindex.py
diff --git a/typeagent/storage/memory/semrefindex.py → src/typeagent/storage/memory/semrefindex.py b/typeagent/storage/memory/semrefindex.py → src/typeagent/storage/memory/semrefindex.py
diff --git a/typeagent/storage/memory/timestampindex.py → ...ypeagent/storage/memory/timestampindex.py b/typeagent/storage/memory/timestampindex.py → ...ypeagent/storage/memory/timestampindex.py
diff --git a/typeagent/storage/sqlite/__init__.py → src/typeagent/storage/sqlite/__init__.py b/typeagent/storage/sqlite/__init__.py → src/typeagent/storage/sqlite/__init__.py
diff --git a/typeagent/storage/sqlite/collections.py → src/typeagent/storage/sqlite/collections.py b/typeagent/storage/sqlite/collections.py → src/typeagent/storage/sqlite/collections.py
diff --git a/typeagent/storage/sqlite/messageindex.py → src/typeagent/storage/sqlite/messageindex.py b/typeagent/storage/sqlite/messageindex.py → src/typeagent/storage/sqlite/messageindex.py
diff --git a/typeagent/storage/sqlite/propindex.py → src/typeagent/storage/sqlite/propindex.py b/typeagent/storage/sqlite/propindex.py → src/typeagent/storage/sqlite/propindex.py
diff --git a/typeagent/storage/sqlite/provider.py → src/typeagent/storage/sqlite/provider.py b/typeagent/storage/sqlite/provider.py → src/typeagent/storage/sqlite/provider.py
diff --git a/typeagent/storage/sqlite/reltermsindex.py → ...typeagent/storage/sqlite/reltermsindex.py b/typeagent/storage/sqlite/reltermsindex.py → ...typeagent/storage/sqlite/reltermsindex.py
diff --git a/typeagent/storage/sqlite/schema.py → src/typeagent/storage/sqlite/schema.py b/typeagent/storage/sqlite/schema.py → src/typeagent/storage/sqlite/schema.py
diff --git a/typeagent/storage/sqlite/semrefindex.py → src/typeagent/storage/sqlite/semrefindex.py b/typeagent/storage/sqlite/semrefindex.py → src/typeagent/storage/sqlite/semrefindex.py
diff --git a/typeagent/storage/sqlite/timestampindex.py → ...ypeagent/storage/sqlite/timestampindex.py b/typeagent/storage/sqlite/timestampindex.py → ...ypeagent/storage/sqlite/timestampindex.py
diff --git a/typeagent/storage/utils.py → src/typeagent/storage/utils.py b/typeagent/storage/utils.py → src/typeagent/storage/utils.py
diff --git a/typeagent/transcripts/README.md → src/typeagent/transcripts/README.md b/typeagent/transcripts/README.md → src/typeagent/transcripts/README.md
diff --git a/typeagent/transcripts/transcript.py → src/typeagent/transcripts/transcript.py b/typeagent/transcripts/transcript.py → src/typeagent/transcripts/transcript.py
diff --git a/typeagent/transcripts/transcript_ingest.py → ...ypeagent/transcripts/transcript_ingest.py b/typeagent/transcripts/transcript_ingest.py → ...ypeagent/transcripts/transcript_ingest.py
diff --git a/uv.lock b/uv.lock