power-loop 3.5.0__tar.gz → 3.6.0__tar.gz

{power_loop-3.5.0 → power_loop-3.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: power-loop
-Version: 3.5.0
+Version: 3.6.0
 Summary: Embeddable agent execution kernel — LLM loop, hooks, events, tools, dynamic sub-agents.
 Author-email: zhangran <zhangran24@126.com>
 License: MIT

{power_loop-3.5.0 → power_loop-3.6.0}/power_loop/__init__.py

@@ -15,7 +15,7 @@ Stability tiers
 无版本承诺，可随时变更或删除。
 """
 
-__version__ = "3.5.0"
+__version__ = "3.6.0"
 
 # Public LLM contract (SDK-free) re-exported so callers (e.g. writing llm.* hooks or
 # a custom LLMService) don't reach into the internal vendored transport package (H3.4).

{power_loop-3.5.0 → power_loop-3.6.0}/power_loop/tools/default_manifest.py

@@ -188,11 +188,11 @@ DEFAULT_TOOL_DEFINITIONS: list[ToolDefinition] = [
     ToolDefinition(
         name="note_add",
         description=(
-            "Save a short persistent note to your own memory. Notes survive context compaction and are "
-            "shown back to you at the start of every turn. Use for durable facts, preferences, ongoing "
-            "task state — not for transcripts or long content (put those in files). When notes are full "
-            "you must delete or merge old ones first. Set pinned=true for notes that must never be "
-            "hidden or auto-evicted."
+            "Save a short persistent note to your own memory. Notes survive context compaction; read "
+            "them back with note_list (and, when the memory-recall hook is enabled, they are also shown "
+            "at the start of each turn). Use for durable facts, preferences, ongoing task state — not "
+            "for transcripts or long content (put those in files). When notes are full you must delete "
+            "or merge old ones first. Set pinned=true for notes that must never be hidden or auto-evicted."
         ),
         input_schema={
             "type": "object",
@@ -213,7 +213,7 @@ DEFAULT_TOOL_DEFINITIONS: list[ToolDefinition] = [
         input_schema={
             "type": "object",
             "properties": {
-                "note_id": {"type": "integer", "description": "The #id shown in YOUR NOTES."},
+                "note_id": {"type": "integer", "description": "The #id from note_list (or YOUR NOTES)."},
                 "content": {"type": "string", "description": "New text replacing the old content."},
                 "pinned": {"type": "boolean", "description": "Set or clear the pinned flag."},
             },
@@ -223,16 +223,31 @@ DEFAULT_TOOL_DEFINITIONS: list[ToolDefinition] = [
     ),
     ToolDefinition(
         name="note_delete",
-        description="Delete one of your notes by its #id when it is stale or no longer worth remembering.",
+        description=(
+            "Delete one of your notes by its #id (from note_list) when it is stale or no longer "
+            "worth remembering."
+        ),
         input_schema={
             "type": "object",
             "properties": {
-                "note_id": {"type": "integer", "description": "The #id shown in YOUR NOTES."},
+                "note_id": {"type": "integer", "description": "The #id from note_list (or YOUR NOTES)."},
             },
             "required": ["note_id"],
         },
         required_params=("note_id",),
     ),
+    ToolDefinition(
+        name="note_list",
+        description=(
+            "List your persistent notes — each note's #id, pinned flag, and content — so you can "
+            "read back what you remember and get the #id needed to note_update / note_delete. These "
+            "are the same notes you maintain with note_add / note_update / note_delete; they survive "
+            "context compaction. Call this when you want to check your memory (e.g. at the start of a "
+            "task) rather than relying on it being auto-shown."
+        ),
+        input_schema={"type": "object", "properties": {}},
+        required_params=(),
+    ),
     ToolDefinition(
         name="schedule_wakeup",
         description=(

{power_loop-3.5.0 → power_loop-3.6.0}/power_loop/tools/default_tools.py

@@ -1471,6 +1471,19 @@ async def run_note_delete(note_id: int) -> str:
     return f"note #{note_id} deleted ({await store.count_notes(sid)} remaining)"
 
 
+async def run_note_list() -> str:
+    """Read back the agent's persistent notes (rendered with #id, pinned flag, content), so the
+    agent can inspect its memory and get the #ids for note_update / note_delete WITHOUT relying on
+    the (optional) memory-recall hook auto-injecting them."""
+    from power_loop.runtime.notes import render_notes
+
+    store, sid = _notes_store_and_session()
+    notes = await store.list_notes(sid)
+    if not notes:
+        return "(no notes yet — use note_add to remember durable facts, preferences, or task state)"
+    return render_notes(notes, policy=_notes_policy())
+
+
 def _timers_store_and_session() -> tuple[Any, str]:
     store, sid = _current_store_and_session()
     if store is None or sid is None:
@@ -1684,6 +1697,10 @@ async def _h_note_delete(**kw: Any) -> Any:
     return await run_note_delete(kw["note_id"])
 
 
+async def _h_note_list(**kw: Any) -> Any:
+    return await run_note_list()
+
+
 async def _h_schedule_wakeup(**kw: Any) -> Any:
     return await run_schedule_wakeup(kw["delay_seconds"], kw["note"], kw.get("every_seconds"))
 
@@ -1740,6 +1757,7 @@ DEFAULT_TOOL_HANDLERS: dict[str, Any] = {
     "note_add": _h_note_add,
     "note_update": _h_note_update,
     "note_delete": _h_note_delete,
+    "note_list": _h_note_list,
     "schedule_wakeup": _h_schedule_wakeup,
     "list_wakeups": _h_list_wakeups,
     "cancel_wakeup": _h_cancel_wakeup,

{power_loop-3.5.0 → power_loop-3.6.0}/power_loop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: power-loop
-Version: 3.5.0
+Version: 3.6.0
 Summary: Embeddable agent execution kernel — LLM loop, hooks, events, tools, dynamic sub-agents.
 Author-email: zhangran <zhangran24@126.com>
 License: MIT