PyPI - power-loop - Versions diffs - 3.8.0__tar.gz → 3.9.0__tar.gz - Mend

@@ -125,6 +125,13 @@ class LlmBeforeCtx(BaseHookCtx):
     Handler may modify any input field. ``messages`` is the fresh per-call list
     actually sent to the LLM — mutating it (e.g. appending an ephemeral memory
     block) never touches the loop's persisted history.
+    ``persist_messages`` is the durable counterpart: any message a handler appends
+    here becomes a REAL history/store row (stamped with the round's send_index, via
+    the same append path as the loop's own turns) AND is added to this round's
+    request. Use it for injected turns that must survive the send — e.g. a periodic
+    "you haven't called X in N rounds" reminder — as opposed to the ephemeral,
+    request-only edits to ``messages``. Appended in order, at the tail of the request.
     """
     messages: list[LoopMessage] = field(default_factory=list)
@@ -133,6 +140,8 @@ class LlmBeforeCtx(BaseHookCtx):
     max_tokens: int = 8000
     temperature: float = 0.0
     session_id: str | None = None
+    # Durable injections: persisted as real turns after LLM_BEFORE, then added to the request.
+    persist_messages: list[LoopMessage] = field(default_factory=list)
     # Handler output (for SHORT_CIRCUIT)
     output: LLMResponse | None = None

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

@@ -15,7 +15,7 @@ Stability tiers
 无版本承诺，可随时变更或删除。
 """
-__version__ = "3.8.0"
+__version__ = "3.9.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).

@@ -944,6 +944,16 @@ class AgentPipeline:
                 llm_before.messages, _pre_hook_ids, _hook_audit_mode
             )
+            # Durable LLM_BEFORE injections (persist_messages): unlike the ephemeral, request-only
+            # edits to `messages` (captured by hook_audit above), each of these becomes a REAL turn —
+            # persisted to history + store with the round's send_index via the loop's own append path
+            # — and is added to this round's request tail. Used for injected turns that must survive
+            # the send (e.g. a periodic "you haven't called X in N rounds" reminder). Computed AFTER
+            # hook_audit so these durable rows don't get counted as ephemeral injections.
+            for _pm in llm_before.persist_messages:
+                await self._append_message(_pm, round_index=round_idx)
+                llm_before.messages.append(dict(_pm))
             if llm_before.directive == HookDirective.SHORT_CIRCUIT:
                 response = llm_before.output
                 if not isinstance(response, LLMResponse):

@@ -124,8 +124,21 @@ def _looks_binary(data: bytes) -> bool:
     if not data:
         return False
     sample = data[:4096]
-    textish = sum(byte in b"\n\r\t\b\f" or 32 <= byte <= 126 for byte in sample)
-    return textish / len(sample) < 0.70
+    # Fast path: mostly-ASCII text (incl. common whitespace) is clearly text.
+    ascii_ish = sum(byte in b"\n\r\t\b\f" or 32 <= byte <= 126 for byte in sample)
+    if ascii_ish / len(sample) >= 0.70:
+        return False
+    # Otherwise it may be NON-Latin UTF-8 text (CJK / emoji, whose bytes are mostly >126) —
+    # NOT binary. Decode leniently (a multibyte char truncated at the 4KB sample boundary is
+    # negligible) and flag as binary only if the text is littered with undecodable bytes
+    # (U+FFFD) or C0/C1 control chars (excluding normal whitespace), which real text lacks.
+    text = sample.decode("utf-8", errors="replace")
+    bad = sum(
+        1
+        for ch in text
+        if ch == "�" or ord(ch) == 0x7f or (ord(ch) < 32 and ch not in "\n\r\t\f\b")
+    )
+    return bad / len(text) > 0.15
 def _read_text(fp: Path, *, max_bytes: int | None = TEXT_FILE_MAX_BYTES) -> str:

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: power-loop
-Version: 3.8.0
+Version: 3.9.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.8.0__tar.gz → 3.9.0__tar.gz