memwal 0.1.11.dev6__tar.gz → 0.1.11.dev7__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/PKG-INFO +1 -1
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/memwal/__init__.py +1 -1
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/memwal/middleware.py +50 -15
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/pyproject.toml +1 -1
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_middleware.py +129 -7
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/.gitignore +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/CHANGELOG.md +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/README.md +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/examples/.env.example +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/examples/.gitignore +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/examples/async_remember_demo.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/examples/interactive_demo.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/examples/verify_credentials.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/memwal/client.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/memwal/compatibility.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/memwal/mock.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/memwal/types.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/memwal/utils.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/notebooks/walrus_memory_python_sdk.ipynb +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/run_tests.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/__init__.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_auth_rejected_message.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_blank_text.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_client.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_env_presets.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_integration.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_list_namespaces.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_mock.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_normalize_server_url.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_polling_delay.py +0 -0
- {memwal-0.1.11.dev6 → memwal-0.1.11.dev7}/tests/test_signing.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: memwal
|
|
3
|
-
Version: 0.1.11.
|
|
3
|
+
Version: 0.1.11.dev7
|
|
4
4
|
Summary: Python SDK for Walrus Memory — Privacy-first AI memory with Ed25519 signing
|
|
5
5
|
Project-URL: Homepage, https://memory.walrus.xyz
|
|
6
6
|
Project-URL: Documentation, https://memory.walrus.xyz
|
|
@@ -188,7 +188,7 @@ class _PendingSaves:
|
|
|
188
188
|
|
|
189
189
|
try:
|
|
190
190
|
asyncio.run(_drain(list(self._tasks)))
|
|
191
|
-
except RuntimeError:
|
|
191
|
+
except (RuntimeError, ValueError):
|
|
192
192
|
logger.warning(
|
|
193
193
|
"Walrus Memory flush_sync() could not await %d pending "
|
|
194
194
|
"task(s) bound to a different event loop (mixing sync "
|
|
@@ -366,12 +366,32 @@ def with_memwal_langchain(
|
|
|
366
366
|
last_human_idx = i
|
|
367
367
|
break
|
|
368
368
|
|
|
369
|
-
guard_msg = SystemMessage(content=_UNTRUSTED_MEMORY_SYSTEM_INSTRUCTION)
|
|
370
369
|
memory_msg = HumanMessage(content=memory_context)
|
|
371
370
|
if last_human_idx > 0:
|
|
372
|
-
result
|
|
371
|
+
result.insert(last_human_idx, memory_msg)
|
|
373
372
|
else:
|
|
374
|
-
result
|
|
373
|
+
result.insert(0, memory_msg)
|
|
374
|
+
|
|
375
|
+
if result and isinstance(result[0], SystemMessage):
|
|
376
|
+
existing_content = result[0].content
|
|
377
|
+
if isinstance(existing_content, list):
|
|
378
|
+
new_content = list(existing_content) + [
|
|
379
|
+
{"type": "text", "text": f"\n\n{_UNTRUSTED_MEMORY_SYSTEM_INSTRUCTION}"}
|
|
380
|
+
]
|
|
381
|
+
else:
|
|
382
|
+
text_str = str(existing_content or "")
|
|
383
|
+
new_content = f"{text_str}\n\n{_UNTRUSTED_MEMORY_SYSTEM_INSTRUCTION}".strip()
|
|
384
|
+
if hasattr(result[0], "model_copy"):
|
|
385
|
+
result[0] = result[0].model_copy(update={"content": new_content})
|
|
386
|
+
else:
|
|
387
|
+
result[0] = SystemMessage(
|
|
388
|
+
content=new_content,
|
|
389
|
+
additional_kwargs=getattr(result[0], "additional_kwargs", {}),
|
|
390
|
+
id=getattr(result[0], "id", None),
|
|
391
|
+
name=getattr(result[0], "name", None),
|
|
392
|
+
)
|
|
393
|
+
else:
|
|
394
|
+
result.insert(0, SystemMessage(content=_UNTRUSTED_MEMORY_SYSTEM_INSTRUCTION))
|
|
375
395
|
|
|
376
396
|
return result
|
|
377
397
|
except Exception as e:
|
|
@@ -625,21 +645,36 @@ def _inject_openai_memory(
|
|
|
625
645
|
messages: List[Dict[str, Any]],
|
|
626
646
|
memory_context: str,
|
|
627
647
|
) -> List[Dict[str, Any]]:
|
|
628
|
-
"""Insert a fixed system guard
|
|
648
|
+
"""Insert a fixed system guard at index 0 and memory content in a user message."""
|
|
649
|
+
result = [dict(m) if isinstance(m, dict) else m for m in messages]
|
|
629
650
|
last_user_idx = -1
|
|
630
|
-
for i in range(len(
|
|
631
|
-
if isinstance(
|
|
651
|
+
for i in range(len(result) - 1, -1, -1):
|
|
652
|
+
if isinstance(result[i], dict) and result[i].get("role") == "user":
|
|
632
653
|
last_user_idx = i
|
|
633
654
|
break
|
|
634
655
|
|
|
635
|
-
|
|
636
|
-
{"role": "system", "content": _UNTRUSTED_MEMORY_SYSTEM_INSTRUCTION},
|
|
637
|
-
{"role": "user", "content": memory_context},
|
|
638
|
-
]
|
|
639
|
-
|
|
656
|
+
memory_message = {"role": "user", "content": memory_context}
|
|
640
657
|
if last_user_idx > 0:
|
|
641
|
-
|
|
658
|
+
result.insert(last_user_idx, memory_message)
|
|
659
|
+
else:
|
|
660
|
+
result.insert(0, memory_message)
|
|
661
|
+
|
|
662
|
+
if result and isinstance(result[0], dict) and result[0].get("role") == "system":
|
|
663
|
+
existing_content = result[0].get("content")
|
|
664
|
+
if isinstance(existing_content, list):
|
|
665
|
+
result[0] = {
|
|
666
|
+
**result[0],
|
|
667
|
+
"content": existing_content + [
|
|
668
|
+
{"type": "text", "text": f"\n\n{_UNTRUSTED_MEMORY_SYSTEM_INSTRUCTION}"}
|
|
669
|
+
],
|
|
670
|
+
}
|
|
671
|
+
else:
|
|
672
|
+
text_str = str(existing_content or "")
|
|
673
|
+
result[0] = {
|
|
674
|
+
**result[0],
|
|
675
|
+
"content": f"{text_str}\n\n{_UNTRUSTED_MEMORY_SYSTEM_INSTRUCTION}".strip(),
|
|
676
|
+
}
|
|
642
677
|
else:
|
|
643
|
-
|
|
678
|
+
result.insert(0, {"role": "system", "content": _UNTRUSTED_MEMORY_SYSTEM_INSTRUCTION})
|
|
644
679
|
|
|
645
|
-
return
|
|
680
|
+
return result
|
|
@@ -240,27 +240,53 @@ class TestFormatMemories:
|
|
|
240
240
|
class TestInjectOpenAIMemory:
|
|
241
241
|
"""Tests for _inject_openai_memory."""
|
|
242
242
|
|
|
243
|
-
def
|
|
243
|
+
def test_folds_guard_into_system_message_and_inserts_memory_before_user_message(self) -> None:
|
|
244
244
|
messages = [
|
|
245
245
|
{"role": "system", "content": "You are helpful."},
|
|
246
246
|
{"role": "user", "content": "question"},
|
|
247
247
|
]
|
|
248
248
|
result = _inject_openai_memory(messages, "memory context")
|
|
249
|
-
# Should be: existing-system
|
|
249
|
+
# Should be: existing-system-with-guard | memory-user | user
|
|
250
|
+
assert len(result) == 3
|
|
250
251
|
assert result[0]["role"] == "system"
|
|
251
|
-
assert result[
|
|
252
|
-
assert "untrusted data" in result[
|
|
253
|
-
assert result[
|
|
254
|
-
assert result[
|
|
252
|
+
assert "You are helpful." in result[0]["content"]
|
|
253
|
+
assert "untrusted data" in result[0]["content"]
|
|
254
|
+
assert result[1] == {"role": "user", "content": "memory context"}
|
|
255
|
+
assert result[2]["role"] == "user"
|
|
256
|
+
assert result[2]["content"] == "question"
|
|
257
|
+
|
|
258
|
+
def test_multi_turn_never_injects_system_message_after_index_0(self) -> None:
|
|
259
|
+
messages = [
|
|
260
|
+
{"role": "system", "content": "You are helpful."},
|
|
261
|
+
{"role": "user", "content": "first"},
|
|
262
|
+
{"role": "assistant", "content": "reply"},
|
|
263
|
+
{"role": "user", "content": "second"},
|
|
264
|
+
]
|
|
265
|
+
result = _inject_openai_memory(messages, "recalled fact")
|
|
266
|
+
# System message only at index 0
|
|
267
|
+
assert result[0]["role"] == "system"
|
|
268
|
+
assert "You are helpful." in result[0]["content"]
|
|
269
|
+
assert "untrusted data" in result[0]["content"]
|
|
270
|
+
|
|
271
|
+
# No system message after index 0
|
|
272
|
+
assert not any(m.get("role") == "system" for m in result[1:])
|
|
273
|
+
|
|
274
|
+
# Memory is injected as user message right before "second"
|
|
275
|
+
assert result[1] == {"role": "user", "content": "first"}
|
|
276
|
+
assert result[2] == {"role": "assistant", "content": "reply"}
|
|
277
|
+
assert result[3] == {"role": "user", "content": "recalled fact"}
|
|
278
|
+
assert result[4] == {"role": "user", "content": "second"}
|
|
255
279
|
|
|
256
280
|
def test_inserts_at_start_when_only_user_message(self) -> None:
|
|
257
281
|
messages = [{"role": "user", "content": "question"}]
|
|
258
282
|
result = _inject_openai_memory(messages, "context")
|
|
259
|
-
#
|
|
283
|
+
# When no system message exists, prepends guard system message at index 0
|
|
260
284
|
assert result[0]["role"] == "system"
|
|
285
|
+
assert "untrusted data" in result[0]["content"]
|
|
261
286
|
assert result[1]["role"] == "user"
|
|
262
287
|
assert result[1]["content"] == "context"
|
|
263
288
|
assert result[2]["role"] == "user"
|
|
289
|
+
assert result[2]["content"] == "question"
|
|
264
290
|
|
|
265
291
|
def test_does_not_mutate_original(self) -> None:
|
|
266
292
|
original = [{"role": "user", "content": "q"}]
|
|
@@ -335,6 +361,102 @@ class TestWithMemWalLangChain:
|
|
|
335
361
|
assert "User loves coffee" in human_msgs[0].content
|
|
336
362
|
assert "BEGIN_UNTRUSTED_WALRUS_MEMORY_" in human_msgs[0].content
|
|
337
363
|
|
|
364
|
+
@respx.mock
|
|
365
|
+
async def test_multi_turn_never_injects_system_message_after_index_0(self) -> None:
|
|
366
|
+
"""In a multi-turn conversation, SystemMessage stays strictly at index 0."""
|
|
367
|
+
_mock_seal_session_prereqs()
|
|
368
|
+
from langchain_core.messages import AIMessage, HumanMessage, SystemMessage
|
|
369
|
+
from langchain_core.outputs import ChatGeneration, ChatResult
|
|
370
|
+
|
|
371
|
+
llm = self._make_llm()
|
|
372
|
+
captured: list = []
|
|
373
|
+
|
|
374
|
+
async def _capture_agenerate(messages_batch, *a, **kw):
|
|
375
|
+
captured.extend(messages_batch)
|
|
376
|
+
return ChatResult(
|
|
377
|
+
generations=[ChatGeneration(message=AIMessage(content="ok"))]
|
|
378
|
+
)
|
|
379
|
+
|
|
380
|
+
llm._agenerate = _capture_agenerate
|
|
381
|
+
|
|
382
|
+
respx.post(_RECALL_URL).mock(
|
|
383
|
+
return_value=_mock_recall([
|
|
384
|
+
{"blob_id": "b1", "text": "User loves coffee", "distance": 0.05}
|
|
385
|
+
])
|
|
386
|
+
)
|
|
387
|
+
respx.post(_ANALYZE_URL).mock(return_value=_mock_analyze())
|
|
388
|
+
|
|
389
|
+
smart_llm = with_memwal_langchain(
|
|
390
|
+
llm, key=_KEY_HEX, account_id=_ACCOUNT_ID, server_url=_SERVER, auto_save=False
|
|
391
|
+
)
|
|
392
|
+
messages = [
|
|
393
|
+
SystemMessage(content="You are helpful."),
|
|
394
|
+
HumanMessage(content="I like coffee"),
|
|
395
|
+
AIMessage(content="Noted!"),
|
|
396
|
+
HumanMessage(content="What do I like?"),
|
|
397
|
+
]
|
|
398
|
+
await smart_llm._agenerate([messages])
|
|
399
|
+
|
|
400
|
+
assert len(captured) == 1
|
|
401
|
+
injected = captured[0]
|
|
402
|
+
# SystemMessage strictly at index 0, with guard folded in
|
|
403
|
+
assert isinstance(injected[0], SystemMessage)
|
|
404
|
+
assert "You are helpful." in injected[0].content
|
|
405
|
+
assert "untrusted data" in injected[0].content
|
|
406
|
+
|
|
407
|
+
# No SystemMessage after index 0
|
|
408
|
+
assert not any(isinstance(m, SystemMessage) for m in injected[1:])
|
|
409
|
+
|
|
410
|
+
# The recalled memory is in a HumanMessage before the final query
|
|
411
|
+
assert isinstance(injected[3], HumanMessage)
|
|
412
|
+
assert "User loves coffee" in injected[3].content
|
|
413
|
+
assert isinstance(injected[4], HumanMessage)
|
|
414
|
+
assert injected[4].content == "What do I like?"
|
|
415
|
+
|
|
416
|
+
@respx.mock
|
|
417
|
+
async def test_multimodal_system_message_appends_block_and_preserves_metadata(self) -> None:
|
|
418
|
+
"""A list-content SystemMessage appends a text block and retains its metadata."""
|
|
419
|
+
_mock_seal_session_prereqs()
|
|
420
|
+
from langchain_core.messages import AIMessage, HumanMessage, SystemMessage
|
|
421
|
+
from langchain_core.outputs import ChatGeneration, ChatResult
|
|
422
|
+
|
|
423
|
+
llm = self._make_llm()
|
|
424
|
+
captured: list = []
|
|
425
|
+
|
|
426
|
+
async def _capture_agenerate(messages_batch, *a, **kw):
|
|
427
|
+
captured.extend(messages_batch)
|
|
428
|
+
return ChatResult(
|
|
429
|
+
generations=[ChatGeneration(message=AIMessage(content="ok"))]
|
|
430
|
+
)
|
|
431
|
+
|
|
432
|
+
llm._agenerate = _capture_agenerate
|
|
433
|
+
|
|
434
|
+
respx.post(_RECALL_URL).mock(
|
|
435
|
+
return_value=_mock_recall([
|
|
436
|
+
{"blob_id": "b1", "text": "User loves coffee", "distance": 0.05}
|
|
437
|
+
])
|
|
438
|
+
)
|
|
439
|
+
respx.post(_ANALYZE_URL).mock(return_value=_mock_analyze())
|
|
440
|
+
|
|
441
|
+
smart_llm = with_memwal_langchain(
|
|
442
|
+
llm, key=_KEY_HEX, account_id=_ACCOUNT_ID, server_url=_SERVER, auto_save=False
|
|
443
|
+
)
|
|
444
|
+
blocks = [
|
|
445
|
+
{"type": "text", "text": "Base instructions", "cache_control": {"type": "ephemeral"}}
|
|
446
|
+
]
|
|
447
|
+
sys_msg = SystemMessage(content=blocks, id="sys-123", additional_kwargs={"source": "test"})
|
|
448
|
+
await smart_llm._agenerate([[sys_msg, HumanMessage("What do I like?")]])
|
|
449
|
+
|
|
450
|
+
assert len(captured) == 1
|
|
451
|
+
injected = captured[0]
|
|
452
|
+
assert isinstance(injected[0], SystemMessage)
|
|
453
|
+
assert injected[0].id == "sys-123"
|
|
454
|
+
assert injected[0].additional_kwargs == {"source": "test"}
|
|
455
|
+
assert isinstance(injected[0].content, list)
|
|
456
|
+
assert len(injected[0].content) == 2
|
|
457
|
+
assert injected[0].content[0] == blocks[0]
|
|
458
|
+
assert "untrusted data" in injected[0].content[1]["text"]
|
|
459
|
+
|
|
338
460
|
@respx.mock
|
|
339
461
|
async def test_no_memories_found_no_injection(self) -> None:
|
|
340
462
|
"""When no memories match, the message list is passed unchanged."""
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|