Changelog#
[0.10.22] - 2025-11-19#
Fix some functions with decorators are not documented
Fix for not documenting classes and functions that are not imported directly
[0.10.21] - 2025-11-15#
Fix input context too long when generating docstring for module
Fix private classes do not have docstrings generated
Fix issue capturing screenshot from invalid window
Fix issue when generate stubs
Fix overview not added to extension.toml
[0.10.20] - 2025-09-24#
Fix Python 3.12 compatibility: use raw strings for regex patterns to avoid SyntaxWarning
[0.10.19] - 2025-08-22#
Fix for schema extensions have missing schema docs
[0.10.18] - 2025-08-09#
Add documentation for USD schema file
Avoid mentioning parameters of schema classes in overview
Fix for AI making assumptions in c++ overview
Fix for AI being confused by plugin and extension names in c++ overview
[0.10.17] - 2025-08-07#
Fix for docstring generation is skipped when there are existing docs
Fix for apis being wrapped with `` have broken hyperlinks
[0.10.16] - 2025-08-05#
Reduce parallel docstring generation to 2
Fix an issue when parsing premake for generating cpp overview
[0.10.15] - 2025-08-01#
Fix for loading extensions with version ending with “-coreapi”
Fix for error when extracting settings
Fix screen capturing a non existent window
[0.10.14] - 2025-07-28#
Fix for error when extracting settings code
Fix for the overview diff agent mentioning versioning changes
[0.10.13] - 2025-07-23#
Add diff prompt to command agent
[0.10.12] - 2025-07-16#
Add diff prompt to settings agent
Fix for settings that needs construction during runtime are not extracted
[0.10.11] - 2025-07-15#
Add generated schema information for schema typed extensions.
revert the “Fix urllib3’s redirect handling behavior” which is not working
[0.10.10] - 2025-07-11#
Fix urllib3’s redirect handling behavior.
[0.10.9] - 2025-07-11#
Added NVIDIA copyright headers to Python files
[0.10.8] - 2025-07-11#
Add overview diff agent
Add diff prompt to diagram agent
[0.10.7] - 2025-07-10#
Avoid load extension which is not compatible with the current platform, e.g. linux load windows only extension.
Add that platform specific information to overview agent.
[0.10.6] - 2025-07-09#
Overview provides more specific and accurate information related to the extension instead of writing brief statements.
[0.10.5] - 2025-07-09#
Fix using UI components headings for non-ui elements.
[0.10.4] - 2025-07-08#
Add retry to sonnet models when there are network errors
Fix error in during docstring retry
[0.10.3] - 2025-07-08#
Add python api diff to usage agent to update existing examples instead of generating from scratch
Fix error capturing usage screenshots
Fix generated python stubs are not updated when the respective input files are changed
[0.10.2] - 2025-07-04#
A few fixes on DiagramAgent: make sure only public APIs are included, only connections > 3 adds a diagram, make sure diagram format is correct.
overivew should never hallucinate about relationships between concepts
docstring should minimize the duplication between description and Returns
use the same terminology across the file
[0.10.1] - 2025-07-03#
Add basic omni.ui information for usage agent to write basic code for widgets
[0.10.0] - 2025-07-03#
Remove regex check to filter objects not in the git diff
Enable docstring generation for private objects
[0.9.98] - 2025-07-01#
Add git diff to docstring agent to determine if a docstring needs updating
Fix for class docstring is not checked
[0.9.97] - 2025-06-30#
avoid deprecated settings in both settings and overview
settings should have delimiters in overview
settings should be in full path in overview
[0.9.96] - 2025-06-26#
remove index.rst it is minimum.
usage sample url/path should be simplified.
[0.9.95] - 2025-06-26#
Fix settings defined in the extension could be missing from the toml file
Fix usage misuse the settings with settings passed in as the input
[0.9.94] - 2025-06-25#
Fix settings using variable names instead of the actual path
[0.9.93] - 2025-06-25#
Avoid writing about APIs at all when generating C++ overview
[0.9.92] - 2025-06-24#
Fix for usage agent not using global instances when there is already one
Merge examples demonstrating similar small features of the same API class
Fix for usage agent writing useless code
Fix for making examples async for no obvious reasons
Avoid enabling the extension that we are generating usage for
[0.9.91] - 2025-06-19#
Fix for settings are listed in the wrong section
[0.9.90] - 2025-06-19#
Fix for usage screenshots could get enormously large
[0.9.89] - 2025-06-13#
Fix wrong quotes being used
Fix for referencing extensions is not done correctly when it followed by a period.
[0.9.88] - 2025-06-13#
Avoid creating references for variables in overview
[0.9.87] - 2025-06-12#
Improve docstrings to make it more concise and easier to understand from user’s perspective
[0.9.86] - 2025-06-09#
Add support for generating overview for C++ extensions
[0.9.85] - 2025-06-04#
Fix for not documenting kwonlyargs in docstrings
[0.9.84] - 2025-06-02#
Add sonnet-4 and opus-4 into the perflab model
Add log_path settings to enable the usage and overview log
Fix docs_images folder are not cleared properly
[0.9.83] - 2025-05-30#
Remove the only extension class if it’s the only one in all
[0.9.82] - 2025-05-29#
OMPE-47377: solve the wrong mention of omni UI in both docstring and overview
teach overview agent to understand how extensions are linked through naming convensions
add extension name to the docstring agent
better docstring agent prompt
OMPE-47224: no mention settings when not important.
[0.9.81] - 2025-05-28#
OMPE-47459: avoid too marketing kind of sentence
OMPE-46990: use technical terminology rathan than generic terms.
[0.9.80] - 2025-05-28#
skip documentation generation when there is enough existing documentation
[0.9.79] - 2025-05-28#
avoid writing about startup and shutdown in extension class docstrings
[0.9.78] - 2025-05-28#
OMPE-47002: fix code duplication from code validation.
[0.9.77] - 2025-05-28#
OMPE-47453: fix public APIs are not extracted correctly
OMPE-46977: not mention actual order from extension.toml
OMPE-46989: avoid special character in Overview
[0.9.76] - 2025-05-28#
Fix for the code reviewer agent being too strict on detecting overlapping code
Bring back monkey patch of
ui.Workspace.get_show_window_titlesas it is not available in Kit 107.0
[0.9.75] - 2025-05-27#
avoid generic information around configuration and extension itself
[0.9.74] - 2025-05-26#
Remove empty sections in settings.md
[0.9.73] - 2025-05-21#
Avoid capturing usage example screenshots if the window is not created within the extension
[0.9.72] - 2025-05-20#
Avoid documenting deprecated APIs in overview and usage
Fix for mentioning too generic info in overview
Remove duplicate attributes in all.
[0.9.71] - 2025-05-20#
Ensure overview is always the first page
[0.9.70] - 2025-05-16#
OMPE-47475: Fix settings generation which could have settings from other exts in the extension.toml file
OMPE-47467: avoid using main guard for usage code generation
[0.9.69] - 2025-05-16#
Ensure overview and settings ends with new line
[0.9.68] - 2025-05-13#
Also capture windows from the extensions which are currently shown
Fix for screen captures being cropped incorrectly
[0.9.67] - 2025-05-08#
Fixed#
Avoid updating docstrings when the format is correct.
Fix for keyword arguments listed incorrectly.
Make sure to explain method names with acronyms in its full form in docstrings.
Fix for attribute docstrings not being added when class docstring doesn’t exist.
Fix for trying to document “cls” argument in class methods.
[0.9.66] - 2025-04-30#
Fix path error when picking preview image
Avoid removing variables from python_api.md
Improve overview for technical accuracy
[0.9.65] - 2025-04-25#
Fix for loading non reloadable extensions
Fix for app ready event not received
[0.9.64] - 2025-04-25#
fix docs generation always return 1 as error
fix ai_docs_gen script when repo_docs doesnt have kit
[0.9.63] - 2025-04-24#
Fix for error when loading schema extensions
Fix removing usage images from the wrong directory
[0.9.62] - 2025-04-17#
Input python bindings stub to overview and usage agent
Exit with error when extension failed to load
Only load python modules within in the specified extension path
Fix add_all_attr not adding functions or classes from python bindings
[0.9.61] - 2025-04-14#
Fix empty overview should not have key components
[0.9.60] - 2025-04-16#
Add preview agent to make sure overview preview is a valid screenshot of a widget or window
Fix error with invalid all attributes
Fix deprecation error of using legacy carb event streams
[0.9.60] - 2025-04-16#
Add preview agent to make sure overview preview is a valid screenshot of a widget or window
Fix error with invalid all attributes
Fix deprecation error of using legacy carb event streams
[0.9.59] - 2025-04-15#
Fix USAGE_PYTHON doc build error when retry time exceeded
[0.9.58] - 2025-04-11#
add preview of windows from
ui.Workspace.set_show_window_fnclean images in doc_images after a new run
fix loading extension from the wrong path
[0.9.57] - 2025-04-10#
Fix usage code has the same titles
Fix usage code generation for multi-module extensions
Move the usage code save with images into CodeReviewerModifier
Increase usage_code_timeout
[0.9.57] - 2025-04-11#
Add check to ensure preview image exists
Fix for code example error in docstring
[0.9.56] - 2025-04-09#
Fix usage code didn’t clean the valid code before new run
Improve the reviewer duplication check condition and solution
Fix usage code stuck at
_retry_on_generationFix docstring still contains \n and special space
[0.9.55] - 2025-04-09#
Fix all attributes order is not same as import order
Fix trying to add preview to overview when it doesn’t exist
[0.9.54] - 2025-04-08#
Fix hang when modifying all attribute
Fix for stating “no arguments” in docstrings
Fix for making overview links bold
[0.9.53] - 2025-04-07#
Prioritize adding preview image to overview if it exists
[0.9.52] - 2025-04-04#
Better overview prompt for empty public APIs.
Fix docstring is added for non public APIs.
Fix function variables not defined.
Fix edge case for get_instance and extension class for overview and usage.
Fix files for stub generation when public APIs are empty
[0.9.51] - 2025-04-03#
Avoid use word of “streamlined UI” or “media” kind of word in docstring or overview
For exts which have SETTINGS.md exist, no updates on the content of the items already exist. Allow add or remove items
Remove get_instance for overview and usage generation if it is the only public API
make Exts ID bold in Overview
remove internal used info from toml file for overview generation, e.g. category, support_level
add serialization consideration for overview
add example of avoid removing important docstring info from existing ones.
small examples of making overview more consise, and use more relevant sections where needed.
[0.9.50] - 2025-04-02#
add CodeReviewerModifier to review the usage code generation and rerun if review failed
fix usage code contains private or protected APIs
[0.9.49] - 2025-03-21#
Avoid removing extension class from all as it may error out repo checkapi
Fix kit version
[0.9.48] - 2025-03-21#
Fix for doc build issues for extensions with ogn nodes.
[0.9.47] - 2025-03-19#
images are generated into data/docs_images instead of docs directly since images are ignored under docs folder
center the images in the docs pages
avoid commit .kit file in ai_docs_gen.py since it will have generated part info
fix docstring agent
bring back
omni.ai.langchain.agent.omni_uitestcenter mermaid diagram
[0.9.46] - 2025-03-20#
fix failed test
[0.9.45] - 2025-03-19#
add usage preview to overview
avoid capturing black screenshots
[0.9.44] - 2025-03-17#
change usage model to use P-Sonnet-3.7-Thinking
fix a bug for usage that the extension should be enabled
[0.9.43] - 2025-03-15#
Restore usage screenshots
[0.9.42] - 2025-03-13#
use relevant usage code for APIs as refernce code instead of test code to include more implementation details
create window for widget typed API
[0.9.41] - 2025-03-11#
fix stub_content is empty for usage generation
fix
execute_python_codecausing error of “cannot unpack non-iterable NoneType object” for correct code
[0.9.40] - 2025-03-06#
add diagram agent
fix used defined all has the constants, so we cant add links to overview.
[0.9.39] - 2025-03-06#
clean the examples for overview
fix issue for extensions without public APIs
restruct the overview agent so that we can have consistent H2 headings.
[0.9.38] - 2025-03-05#
add extension.toml for overview generation
improve a bit on overview prompt
[0.9.37] - 2025-03-05#
ensure overview sections have more consistent titles
add sonnet 3.7 model
[0.9.36] - 2025-03-04#
remove ReviewAllAgent, use code instead
add support for multiple-module extensions
[0.9.35] - 2025-02-27#
update overview agent
add links to the overview
[0.9.34] - 2025-02-24#
fix stuck at inspecting modules
make sure to remove all the overview links
[0.9.33] - 2025-02-21#
fix a few docstring issues
[0.9.32] - 2025-02-19#
fix review all agent stuck due to write issue.
add remove constant rule to review all agent.
make sure docstring has two newlines between each section to have correct format.
[0.9.31] - 2025-02-19#
fix review all agent output is not converted into a list of strings
remove
General Use Casewhen there is no usage
[0.9.30] - 2025-02-18#
fix module docstring include invalid characters in base class
fix inspect_module stuck due to the check if a Singleton class is a command class
[0.9.29] - 2025-02-18#
fix overview not generated when all is empty.
avoid generating usage when all is empty.
[0.9.28] - 2025-02-18#
fix module docstring include special characters
remove project name in repod_docs config from repo.toml. Otherwise got ci error when build docs.
[0.9.27] - 2025-02-17#
fix overview link issue
[0.9.26] - 2025-02-14#
avoid waiting for async functions outside generated code snippets while doing usage generation
[0.9.25] - 2025-02-14#
review the all attribute generated through imports and update it if it is not correct
[0.9.24] - 2025-02-13#
fix that overview heading is not correct and add settings and commands to the overview links if exist
[0.9.23] - 2025-02-12#
fix that usage can stuck due to AI generating bad async code
[0.9.22] - 2025-02-12#
add GPT o3-mini model
[0.9.21] - 2025-02-03#
add CommandDocAgent to generate commands_api.md page
[0.9.20] - 2025-02-10#
fix version bump issue
[0.9.19] - 2025-01-30#
add deepseek model
[0.9.18] - 2025-01-24#
OMPE-36099: Fix usage code generation getting stuck
Add GPTo1 model
[0.9.17] - 2025-01-24#
fix unregister issue
[0.9.16] - 2024-10-25#
includes black==24.10.0
[0.9.15] - 2024-08-09#
Fixed#
use register_perflab_gpt4 locally
fix the version not updated correctly when the extension is not in the extension info
fix the issue when extension is loaded before the version bump
[0.9.14] - 2024-08-07#
Fixed#
Only re-generate the stub file if it doesn’t exist or is empty.
Fixed indent in prompts.
Fixed extension not being loaded from extension path setting.
[0.9.13] - 2024-08-05#
Fixed#
Ensure stub file is generated every time when running the tool
Added error messages when overview and usage failed to generate due to invalid stub file
[0.9.12] - 2024-08-05#
Fixed#
Fix error message “No module named black” in Windows
[0.9.11] - 2024-07-31#
Fixed#
Ai agent hallucinates settings used by the extension and provided from another
Docstring should have the tripple quotes end in a new line if the docstring are multiple lines.
Returns None shouldn’t be in the docstring
Change the docstring log info to print so users can get better idea of the progress and what went wrong.
[0.9.10] - 2024-07-31#
Changed#
Improved test coverage to 87%.
Fixed#
Fixed screenshot generation could crash sometimes.
Fixed screenshot generation could capture the wrong part when new windows are created.
[0.9.9] - 2024-07-30#
Fixed#
AI turns to stuck at the existing docstring for class. Better prompt to fix that.
Fix when only generating docstring, app hangs.
Readme has wrong generate key for docstring.
[0.9.8] - 2024-07-27#
Fixed#
Fixed screenshot generation could hang on Linux when waiting for screen capture.
[0.9.7] - 2024-07-26#
Fixed#
Avoid bumping extension version when generating screenshots for usage code blocks.
[0.9.6] - 2024-07-25#
Changed#
Avoid the hot load during the modification on the extension
Inject docstrings all together by files instead of one by one which improves the docstring generation performance by roughly 20%
Added the customized prompt note in Readme
Fix the docstring not running if the root folder is not a module, instead the root folder + file name is the module name
Fix the extension name different from module name
[0.9.5] - 2024-07-24#
Changed#
No dependency on lc_agent_chat_models
[0.9.4] - 2024-07-23#
Fixed#
Fixed tests not being run.
[0.9.3] - 2024-07-19#
Fixed#
Fixed the issue that when shutdown the app, the extension no longer exists
Exit the app when load is not succeeded
Correct the next patch version for version bump
Clean up the load_extension
[0.9.2] - 2024-07-17#
Added#
Add a setting as separate tool to generate screenshots for usage code examples.
[0.9.1] - 2024-07-17#
Fixed#
remove unnecessary space before Args and Returns in docstrings
add new line for settings entry in Overview.md
[0.9.0] - 2024-07-16#
omni.ai.langchain.agent.documentation
[0.1.30] - 2024-07-15#
Fixed#
Remove SETTINGS.md in config/extension.toml and Overview.md if not generated.
Don’t bump the version when using
add_all_attributeflag.Remove duplicated code due to merge.
Fixed the docstrings for subclasses’ methods are not generated.
[0.1.29] - 2024-07-11#
Fixed#
Use async task to improve the async functions performance.
[0.1.28] - 2024-07-10#
Fixed#
Avoid showing the code snippet twice in usage retry prompt.
[0.1.27] - 2024-07-10#
Fixed#
Fix for the agent not wrapping the json payload correctly.
Fix for incorrect class docstring format.
Changed#
During retry, only generate docstrings which are missing.
Changed ‘make sure’ to ‘ensure’ in prompts to save tokens.
[0.1.26] - 2024-07-09#
Changed#
Keep the logging level in the subprocess
Change retry time for usage from 7 to 3
[0.1.25] - 2024-07-09#
Changed#
Clean up the code
Added time profiling for performance
[0.1.24] - 2024-07-09#
Fixed#
Fixed missing empty lines between usage examples.
[0.1.23] - 2024-07-05#
Added#
Increase test coverage of usage code execution.
Generate stub code in _genoutput.
Fixed#
Fix for hang when executing usage code.
Changed#
Improve performance of usage code execution by executing multiple snippets at once and only retry snippets with errors.
Moved the whole usage generation to subprocess.
[0.1.22] - 2024-07-05#
Fixed#
Fix the missing version error and the common path error.
[0.1.21] - 2024-07-04#
Added#
Added test coverage of OverviewUpdaterModifier.
Fixed#
Fix for load extension failed due to mixing absolute and relative pathing.
[0.1.20] - 2024-07-04#
Fixed#
Fix the public_api_list passed to OverviewUpdaterModifier is a list instead of dict
[0.1.19] - 2024-07-04#
Fixed#
Fix stub generation error due to the issue that module and class/func object file path styles are not same
[0.1.18] - 2024-07-02#
Changed#
Add example to show UsageDocAgent how to derive code snippet from test
fix important API list and add it to both Overview and Usage.
Change a usage example to omni.ui example to avoid generating widget directly on ui.Window instead of ui.Frame.
[0.1.17] - 2024-07-02#
Changed#
Switched to using mypy for generating stub files.
[0.1.16] - 2024-06-27#
Fixed#
Fix for traceback info not shown during usage code retry because it could not be pickle.dumped.
Fix for private methods being generated in stub files.
Fix for some files could be missed out when generating stub files.
Changed#
Generate functions in the same file in one go.
Add references for important API list in overview.
[0.1.15] - 2024-06-27#
Changed#
Pass settings list from toml file as the input of the SettingDocAgent
Only code contains settings related are concatenated as input code
If neither settings list nor settings code exists, don’t run SettingDocAgent
Better settings description example, remove the action words in the description
Avoid OmniKit in module docstring
Remove all the concatenation file path and clean up the concatenation
Fix the
__all__generation for the extension instead of submodules and make sure generated list also include attributes and not just class/functionMove generate
__all__as a pre-process so that user and interfere before running ai agents.
[0.1.14] - 2024-06-26#
Fixed#
Fix for reference to USAGE_PYTHON is missing in overview page.
Fix for test code being ignored on Windows.
Fix for usage code generation could not be keyboard interrupted.
Changed#
Use stub code for generating overview and usage to avoid running into token limit error.
[0.1.13] - 2024-06-26#
Fixed#
Fix relpath error occurring when file in different driver.
[0.1.12] - 2024-06-19#
Changed#
Terminated the docs generation if the extension doesn’t import, and provide better error message for that.
Sliced large number of class methods into smaller ones to avoid context_length_exceeded errors.
Add retry on missed docstring so to make sure we don’t have missed ones.
Enhance methods docstring generation only on public methods.
Enhance class methods docstring is a single string (avoid generating Dict in docstring).
use
__doc__instead ofinspect.getdocto avoid getting parent class’ documentation.
[0.1.11] - 2024-06-18#
Fixed#
Fix for generation could not be keyboard interrupted.
Fix for documentation being created in the build directory.
Changed#
Moved usage code execution to subprocess.
[0.1.10] - 2024-06-18#
Fixed#
Fix for the agent could sometimes hallucinate on important API list.
[0.1.9] - 2024-06-14#
Fixed#
error when querying the arguments of class methods which have decorators
issue with attributes docstring generation
[0.1.8] - 2024-06-14#
Added#
Added setting to create
__all__attribute if it does not exist.
Fixed#
Fixed crash when generating usage code with omni.ui.
Docstring argument types do not use sphinx references.
Automatically update config file for generated documentation files.
Avoid listing documentation files which do not exist.
[0.1.7] - 2024-06-13#
Changed#
Improved the logging system for the extension, for better post inspections on the ai generated docs.
Better retry logic on DocstringInjectorModifier.
Fixed docstring new line issue.
Fixed docstring json payload has invalid key, which is not a class/method name, e.g. the key is “ClassName”.
Fixed docstring json payload has incomplete key for property method, e.g. ClassName.MethodName.getter.
Removed argument mismatch retry.
The file location is removed from prompts, instead it is directly passed through modifier.
Make sure class’ docs don’t get parent’s class’s docs which cause generation miss.
Remove extension precacher.
[0.1.6] - 2024-06-05#
Added#
OMPE-8327: Added tests
Fixed#
Fix for docstring not being generated for all classes and functions, and arguments could be missing
Ensure each setting name format is correct, and avoid creating the markdown file when there are no settings
Fix for usage examples with asyncio tasks could crash when there are errors
Changed#
Updated documentation with AI agent.
[0.1.5] - 2024-06-10#
Fixed#
workaround the
No module named regex._regexissue
[0.1.4] - 2024-06-10#
Changed#
use register_perflab_gpt4 from lc_agent_chat_models instead from langchain_openai
[0.1.3] - 2024-06-06#
Fixed#
Docstring generation doesn’t follow the correct output format.
[0.1.2] - 2024-06-05#
Changed#
Fix error message “No module named black”
Remove the extension itself from the Important API list in the overview.
Avoid the use of Omni Kit in overview
Update readme about important API list could be retrieved from
__all__
[0.1.1] - 2024-06-03#
Fixed#
Move the file_path from ai generated to ai input
Fix when using _build folder the python files is not corrected built for input
Fix subprocess env issue for Windows
[0.1.0] - 2024-04-10#
Initial version of extension ai docs generator