deepagents==0.7.0a7

Warning

This is a pre-release version. Install with: pip install deepagents==0.7.0a7

Released from alpha/deepagents-0-7-0a7 at commit c16ebe1

This alpha improves large-repository filesystem workflows with bounded streaming search, smarter pagination, optional surrounding context, and clearer line gutters.

Breaking Changes

• read_file no longer renders raw text with a cat -n-style fixed-width line-number gutter and tab separator. Callers that parse raw tool output should be updated to match (#4561).

Features

• Automatically enable Fireworks prompt-cache session affinity for agents when a compatible langchain-fireworks installation is available. (#4598) (5d878bf).
• Bound the agent-facing filesystem grep tool to 1,000 total matches by default, stream local ripgrep output, and stop searching once the cap is reached (#4570) (8e86f5e).
• Report the returned source-line range, total and remaining line counts, and next offset after partial paginated read_file calls, including reads shortened by sandbox output limits or middleware truncation (#4540) (8321194).
• Let direct FilesystemBackend.grep() callers request surrounding lines with the new keyword-only context_lines argument. (#4706) (65230df).

Bug Fixes

• Disambiguate read_file line-number gutters from tab-indented source by separating dynamically aligned line and continuation markers from source content with two spaces (#4561) (cf057b4).
• Keep fields marked with PrivateStateAttr, including fields declared through create_deep_agent(state_schema=...), out of subagent inputs and returned parent-state updates so private custom state stays within the owning agent (#4587) (a4662c0).
• Constrain sandbox glob and slash-pattern grep searches to their declared search root by treating leading / as search-root-relative, rejecting .. traversal segments, and filtering symlink-resolved matches outside the root (#4588) (c6c7213).

---

Thanks to our community contributors: Kavish Kartha (@kavishkartha05) (Twitter, LinkedIn), nv-kasikritc

Internal maintainers: Nishitha M (@imnishitha), Srimanth Tangedipalli (@srimanthtangedipalli-eng), John Kennedy (@jkennedyvz), ccurme (@ccurme), Mason Daugherty (@mdrxy)

Released by: Mason Daugherty (@mdrxy)

Git log since deepagents==0.6.12

This commit history includes changes to this package. Commits are listed newest first.

• c16ebe1 hotfix(sdk): alpha release 0.7.0a7
• 5d878bf feat(sdk): use FireworksPromptCachingMiddleware for session affinity (#4598)
• 8e86f5e feat(sdk): add total match cap and streaming to grep (#4570)
• cf057b4 fix(sdk)!: disambiguate read_file line gutters (#4561)
• 8321194 feat(sdk): report remaining lines for paginated reads (#4540)
• 65230df feat(sdk): support surrounding lines in filesystem grep results (#4706)
• a4662c0 fix(sdk): isolate private custom state from subagents (#4587)
• 44daa24 chore(repo): raise LangChain integration minimums (#4601)
• c6c7213 fix(langsmith-sandbox): sandbox glob path boundary checks (#4588)
• d5a60ec feat(sdk): add NVIDIA Nemotron 3 Ultra harness profile (#4192)
• cbdb0a7 fix(sdk): isolate composite glob paths (#4531)
• 7be76c7 fix(sdk): preserve ContextT on create_deep_agent middleware (#4055)
• d62534c fix(sdk): accept list format for skill allowed-tools (#4140)
• 2f5f5b8 fix(sdk): make skill truncation warnings actionable (#4141)
• 56c5a5e feat(sdk): improve system prompt configurability (#4437)
• 4cb4749 feat(sdk): add NVIDIA NIM app-origin attribution (#4455)
• b1dbf5e fix(sdk): improve grep literal guidance and sandbox glob routing (#4168)
• ef591e7 feat(sdk): bound grep/glob with partial results and a truncated flag (#4063)
• d77496b fix(sdk): sandbox not-found contract and glob deny over-blocking on delete (#4321)
• 704a70d feat(sdk): add enabled_tools allowlist to FilesystemMiddleware (#4325)
• feab6e0 fix(sdk): unify grep include-glob semantics across backends (#3936)
• b0d92c0 fix(sdk): move get_sync() inside try in check_async_task and cancel_async_task (#3967)
• d4ba51c docs(sdk): expand profiles package docstring with directory layout (#4041)
• b927147 feat(sdk): optional video frame extraction on read_file (#4094)
• d6692a7 feat(code,sdk): add rubric iteration controls (#4405)
• a51c8d2 fix(sdk): emit terminal rubric iteration status (#4406)
• 90c8472 feat(sdk): allow users to override default middleware by name (#4251)
• 02f5bd7 feat(sdk): reduce round trips when offloading large tool results with sandbox.execute (#4230)
• 8e8680b build(deps): refresh dependency minimums (#4331)
• 23500f4 chore(deps): bump langgraph-checkpoint from 4.1.0 to 4.1.1 in /libs/deepagents (#4274)
• 965cbd5 chore(repo): cut over v0.7 to main (#4280)