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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: power-loop
-Version: 3.5.0
+Version: 3.7.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.7.0}/power_loop/__init__.py

@@ -15,7 +15,7 @@ Stability tiers
 无版本承诺，可随时变更或删除。
 """
 
-__version__ = "3.5.0"
+__version__ = "3.7.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.7.0}/power_loop/runtime/history_projector.py

@@ -117,7 +117,9 @@ class HistoryProjector(Protocol):
 
 def _truncate(s: Any, max_chars: int) -> str:
     t = "" if s is None else str(s)
-    return t if len(t) <= max_chars else t[:max_chars] + "…"
+    if max_chars <= 0 or len(t) <= max_chars:  # max_chars <= 0 → no truncation (unlimited)
+        return t
+    return t[:max_chars] + "…"
 
 
 def _parse_args(raw: Any) -> Any:
@@ -225,7 +227,7 @@ class DefaultDeterministicProjector:
     terse plain text with NO tool-protocol structure."""
 
     version: int = 1
-    max_chars: int = 300  # per-field truncation budget
+    max_chars: int = 300  # per-field truncation budget; <= 0 = no truncation (unlimited)
     keep_last_sends: int = 4  # most-recent sends ALWAYS kept individually (never folded)
     #: Fold older sends into a compact row once the rendered projected prefix reaches
     #: ``loop max_tokens × trigger_ratio`` (mirrors DefaultCompactor's policy) — token-driven,
@@ -244,8 +246,7 @@ class DefaultDeterministicProjector:
             keep_last_sends=self.keep_last_sends,
             trigger_ratio=self.trigger_ratio,
         )
-        if self.max_chars <= 0:
-            raise ValueError(f"max_chars must be > 0; got {self.max_chars!r}")
+        # max_chars <= 0 → no truncation (unlimited); any int is accepted.
         if self.max_compact_chars < 0:
             raise ValueError(
                 f"max_compact_chars must be >= 0 (0 = unbounded); got {self.max_compact_chars!r}"

{power_loop-3.5.0 → power_loop-3.7.0}/power_loop/runtime/representation.py

@@ -93,7 +93,9 @@ class Representation(Protocol):
 
 def _truncate(s: Any, max_chars: int) -> str:
     t = "" if s is None else str(s)
-    return t if len(t) <= max_chars else t[:max_chars] + "…"
+    if max_chars <= 0 or len(t) <= max_chars:  # max_chars <= 0 → no truncation (unlimited)
+        return t
+    return t[:max_chars] + "…"
 
 
 def _parse_args(raw: Any) -> Any:
@@ -143,8 +145,8 @@ def _validate_representation_params(*, version: int, max_chars: int | None = Non
         raise ValueError(
             f"representation version must be >= 1 (the compatibility key); got {version!r}"
         )
-    if max_chars is not None and max_chars <= 0:
-        raise ValueError(f"max_chars must be > 0; got {max_chars!r}")
+    # max_chars <= 0 is now VALID and means "no truncation" (unlimited) — let a host disable the
+    # library's per-field cap and do its own limiting. Any int is accepted.
 
 
 def _render_compact_row(row: ProjectMessageRow) -> LoopMessage:
@@ -249,7 +251,7 @@ class ProjectedRepresentation:
 
     kind: str = "projection"
     version: int = 1
-    max_chars: int = 300  # per-field truncation budget
+    max_chars: int = 300  # per-field truncation budget; <= 0 = no truncation (unlimited)
     #: Format knobs for render() — see :class:`ProjectionRenderConfig`. A plain dict is coerced (so a
     #: host can pass JSON config straight through). Subclasses can ALSO override the render_* methods.
     render_config: ProjectionRenderConfig = field(default_factory=ProjectionRenderConfig)

{power_loop-3.5.0 → power_loop-3.7.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.7.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.7.0}/power_loop.egg-info/PKG-INFO

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