refactor: document-agent profile protocol and TOC boundary tools - #246
Merged
Conversation
- Added DOC_PROFILE_FILENAME to persist anatomy map artifacts for better debugging. - Updated hierarchy_locator to retain original TOC headings while normalizing titles. - Introduced TOC_VLM_MAX_TOKENS for consistent token limits in VLM calls. - Refactored rendering logic in extract_toc_with_boundaries to handle multiple pages. - Improved evidence extraction from confirmation items in VLM processing. - Adjusted zip package writer to conditionally include TOC hierarchies based on parse track.
- Removed the obsolete 'verdict_now' action, consolidating decision-making under 'tool_call'. - Updated prompts and instructions to clarify the executor's role in handling actions and verdicts. - Enhanced the handling of legacy actions to ensure compatibility with the new decision structure. - Refactored the logic in the executor to enforce 'tool_call' as the only valid action, improving clarity and maintainability. - Adjusted the planner's behavior to treat 'verdict_now' as a non-finish signal, delegating success/abort handling to the executor.
![github-advanced-security[bot]](https://avatars.githubusercontent.com/in/57789?s=60&v=4){kind=small}
| ) | ||
| from app.services.document_agent.planner.planner import _parse_profile_and_decision | ||
| from app.services.document_agent.registry import REGISTRY | ||
| from app.services.document_agent import tools as _registered_tools # noqa: F401 |
This was referenced Aug 9, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
verdicttool only (tool_callsteps; legacyverdict_nowcoerced), and stop plannernext_actionfrom finishing/aborting the run.asset_bboxesand keeping thehas_assetgate.Test plan
test_profile_agent_protocol_contract,test_doc_profile_anatomy_contract,test_toc_confirm_batch_contract,test_toc_phase2_region_concurrency_contract(37 passed)lint/typecheck/ worker tests on the PRpropose.shard_plan→validate.anatomy_map→verdict(success)Made with Cursor