PyPI - power-loop - Versions diffs - 3.8.1__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.1
+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.1"
+__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):

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