Skip to content

Conversation

@abrookins
Copy link
Collaborator

Summary

Rename memory tools to better reflect their behavior:

  • add_memory_to_working_memorylazily_create_long_term_memory
  • create_long_term_memoryeagerly_create_long_term_memory

The new names clarify the distinction:

  • Lazy: Memories are added to working memory and automatically promoted to long-term storage later
  • Eager: Memories are created directly in long-term storage for immediate retrieval

Backwards Compatibility

The old tool names continue to work as silent aliases. The resolve_tool_call method routes both old and new names to the same handlers, so existing integrations won't break.

Changes

  • Updated tool schemas in client.py to return new names
  • Updated resolve_tool_call to accept both new and deprecated names
  • Updated LangChain integration to use new names
  • Updated all documentation (python-sdk.md, agent-examples.md, langchain-integration.md, long-term-memory.md, memory-lifecycle.md)
  • Updated all examples (README.md, travel_agent.py, langchain_integration_example.py)
  • Updated tests to use new names

Testing

  • All 609 tests pass
  • Pre-commit checks pass

abrookins and others added 3 commits January 22, 2026 16:51
- Rename add_memory_to_working_memory → lazily_create_long_term_memory
- Rename create_long_term_memory → eagerly_create_long_term_memory
- Old tool names still work as silent aliases for backwards compatibility
- Update all documentation, examples, and tests to use new names
Copy link
Contributor

@nkanu17 nkanu17 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I had a couple minor comments about defining constants to store function names as they are reused in multiple areas and a deprecation warning.

@abrookins abrookins merged commit c71994c into main Jan 23, 2026
17 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants