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

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

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

{power_loop-3.7.0 → power_loop-3.8.1}/power_loop/__init__.py

@@ -15,7 +15,7 @@ Stability tiers
 无版本承诺，可随时变更或删除。
 """
 
-__version__ = "3.7.0"
+__version__ = "3.8.1"
 
 # 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.7.0 → power_loop-3.8.1}/power_loop/agent/sink.py

@@ -377,6 +377,9 @@ class SQLiteSink:
                     usage.get("completion_tokens") or usage.get("output")
                 ),
                 total_tokens=_int_or_none(usage.get("total_tokens")),
+                cached_tokens=_int_or_none(
+                    usage.get("cache_read_tokens") or usage.get("cached_tokens")
+                ),
             )
 
 

{power_loop-3.7.0 → power_loop-3.8.1}/power_loop/runtime/store/dialect.py

@@ -101,7 +101,7 @@ class SqliteDialect:
                 PRIMARY KEY (session_id, compact_seq))""",
             f"""CREATE TABLE IF NOT EXISTS {p}usage_rounds (
                 session_id TEXT NOT NULL, round_index INTEGER NOT NULL, prompt_tokens INTEGER,
-                completion_tokens INTEGER, total_tokens INTEGER, model TEXT,
+                completion_tokens INTEGER, total_tokens INTEGER, cached_tokens INTEGER, model TEXT,
                 created_at INTEGER NOT NULL, PRIMARY KEY (session_id, round_index))""",
             f"""CREATE TABLE IF NOT EXISTS {p}session_state (
                 session_id TEXT PRIMARY KEY, next_seq INTEGER NOT NULL DEFAULT 1,
@@ -125,6 +125,7 @@ class SqliteDialect:
                 rounds INTEGER NOT NULL DEFAULT 0, llm_calls INTEGER NOT NULL DEFAULT 0,
                 tool_calls INTEGER NOT NULL DEFAULT 0, prompt_tokens INTEGER NOT NULL DEFAULT 0,
                 completion_tokens INTEGER NOT NULL DEFAULT 0, total_tokens INTEGER NOT NULL DEFAULT 0,
+                cached_tokens INTEGER NOT NULL DEFAULT 0,
                 first_send_at INTEGER, last_send_at INTEGER, updated_at INTEGER NOT NULL)""",
             f"""CREATE TABLE IF NOT EXISTS {p}timers (
                 session_id TEXT NOT NULL, timer_id INTEGER NOT NULL, due_at INTEGER NOT NULL,
@@ -243,7 +244,7 @@ class PostgresDialect:
                 PRIMARY KEY (session_id, compact_seq))""",
             f"""CREATE TABLE IF NOT EXISTS {p}usage_rounds (
                 session_id TEXT NOT NULL, round_index BIGINT NOT NULL, prompt_tokens BIGINT,
-                completion_tokens BIGINT, total_tokens BIGINT, model TEXT,
+                completion_tokens BIGINT, total_tokens BIGINT, cached_tokens BIGINT, model TEXT,
                 created_at BIGINT NOT NULL, PRIMARY KEY (session_id, round_index))""",
             f"""CREATE TABLE IF NOT EXISTS {p}session_state (
                 session_id TEXT PRIMARY KEY, next_seq BIGINT NOT NULL DEFAULT 1,
@@ -267,6 +268,7 @@ class PostgresDialect:
                 rounds BIGINT NOT NULL DEFAULT 0, llm_calls BIGINT NOT NULL DEFAULT 0,
                 tool_calls BIGINT NOT NULL DEFAULT 0, prompt_tokens BIGINT NOT NULL DEFAULT 0,
                 completion_tokens BIGINT NOT NULL DEFAULT 0, total_tokens BIGINT NOT NULL DEFAULT 0,
+                cached_tokens BIGINT NOT NULL DEFAULT 0,
                 first_send_at BIGINT, last_send_at BIGINT, updated_at BIGINT NOT NULL)""",
             f"""CREATE TABLE IF NOT EXISTS {p}timers (
                 session_id TEXT NOT NULL, timer_id BIGINT NOT NULL, due_at BIGINT NOT NULL,
@@ -372,7 +374,7 @@ class MySQLDialect:
                 PRIMARY KEY (session_id, compact_seq)) {opts}""",
             f"""CREATE TABLE IF NOT EXISTS {p}usage_rounds (
                 session_id VARCHAR(255) NOT NULL, round_index BIGINT NOT NULL, prompt_tokens BIGINT,
-                completion_tokens BIGINT, total_tokens BIGINT, model VARCHAR(255),
+                completion_tokens BIGINT, total_tokens BIGINT, cached_tokens BIGINT, model VARCHAR(255),
                 created_at BIGINT NOT NULL, PRIMARY KEY (session_id, round_index)) {opts}""",
             f"""CREATE TABLE IF NOT EXISTS {p}session_state (
                 session_id VARCHAR(255) NOT NULL, next_seq BIGINT NOT NULL DEFAULT 1,
@@ -395,6 +397,7 @@ class MySQLDialect:
                 rounds BIGINT NOT NULL DEFAULT 0, llm_calls BIGINT NOT NULL DEFAULT 0,
                 tool_calls BIGINT NOT NULL DEFAULT 0, prompt_tokens BIGINT NOT NULL DEFAULT 0,
                 completion_tokens BIGINT NOT NULL DEFAULT 0, total_tokens BIGINT NOT NULL DEFAULT 0,
+                cached_tokens BIGINT NOT NULL DEFAULT 0,
                 first_send_at BIGINT, last_send_at BIGINT, updated_at BIGINT NOT NULL,
                 PRIMARY KEY (session_id)) {opts}""",
             f"""CREATE TABLE IF NOT EXISTS {p}timers (

{power_loop-3.7.0 → power_loop-3.8.1}/power_loop/runtime/store/schema.py

@@ -67,7 +67,9 @@ def validate_table_prefix(prefix: str) -> str:
 #: Bump + append a migration step for ANY schema change.
 #: v2 (2026-06): adds the ``{prefix}project_messages`` table (send-context projection).
 #: v3 (2026-06): adds the ``{prefix}hook_events`` table (ephemeral hook-augmentation audit log).
-CURRENT_SCHEMA_VERSION = 4
+#: v4 (2026-06): widen MySQL free-text/JSON columns TEXT→LONGTEXT.
+#: v5 (2026-06): adds ``cached_tokens`` (prompt cache-read tokens) to usage_rounds + session_stats.
+CURRENT_SCHEMA_VERSION = 5
 
 #: The store's data tables (besides ``{prefix}schema_migrations``) — used by VERIFY to
 #: confirm the FULL schema is present, not just the version row. Keep in sync with
@@ -118,6 +120,16 @@ async def _migration_steps(
         # idempotent. (Fresh stores already provision LONGTEXT via Dialect.ddl.)
         if db.dialect.name == "mysql":
             steps += db.dialect.widen_text_columns_ddl(prefix)
+    if from_version < 5:
+        # v4 → v5: add cached_tokens (prompt cache-read tokens) to usage_rounds + session_stats.
+        # ALTER … ADD COLUMN has no portable IF NOT EXISTS, so probe the catalog on the open tx.
+        int_t = "INTEGER" if db.dialect.name == "sqlite" else "BIGINT"
+        if not await _column_exists(tx, db.dialect.name, f"{prefix}usage_rounds", "cached_tokens"):
+            steps.append(f"ALTER TABLE {prefix}usage_rounds ADD COLUMN cached_tokens {int_t}")
+        if not await _column_exists(tx, db.dialect.name, f"{prefix}session_stats", "cached_tokens"):
+            steps.append(
+                f"ALTER TABLE {prefix}session_stats ADD COLUMN cached_tokens {int_t} NOT NULL DEFAULT 0"
+            )
     return steps
 
 
@@ -137,6 +149,12 @@ def migration_ddl_for_display(db: Database, prefix: str, *, from_version: int) -
         steps += db.dialect.hook_events_ddl(prefix)
     if from_version < 4 and db.dialect.name == "mysql":
         steps += db.dialect.widen_text_columns_ddl(prefix)
+    if from_version < 5:
+        int_t = "INTEGER" if db.dialect.name == "sqlite" else "BIGINT"
+        steps.append(f"ALTER TABLE {prefix}usage_rounds ADD COLUMN cached_tokens {int_t}")
+        steps.append(
+            f"ALTER TABLE {prefix}session_stats ADD COLUMN cached_tokens {int_t} NOT NULL DEFAULT 0"
+        )
     return steps
 
 

{power_loop-3.7.0 → power_loop-3.8.1}/power_loop/runtime/store/store.py

@@ -146,7 +146,7 @@ _EXPORT_TABLES: tuple[tuple[str, Any, tuple[str, ...]], ...] = (
         "after_tokens", "round_index", "created_at")),
     ("usage_rounds", lambda t: t.usage_rounds, (
         "session_id", "round_index", "prompt_tokens", "completion_tokens", "total_tokens",
-        "model", "created_at")),
+        "cached_tokens", "model", "created_at")),
     ("session_runtime_state", lambda t: t.session_runtime_state, (
         "session_id", "state_key", "value_json", "updated_at")),
     ("timers", lambda t: t.timers, (
@@ -156,7 +156,8 @@ _EXPORT_TABLES: tuple[tuple[str, Any, tuple[str, ...]], ...] = (
         "session_id", "note_id", "content", "pinned", "created_at", "updated_at")),
     ("session_stats", lambda t: t.session_stats, (
         "session_id", "sends", "rounds", "llm_calls", "tool_calls", "prompt_tokens",
-        "completion_tokens", "total_tokens", "first_send_at", "last_send_at", "updated_at")),
+        "completion_tokens", "total_tokens", "cached_tokens", "first_send_at", "last_send_at",
+        "updated_at")),
 )
 
 
@@ -1143,6 +1144,7 @@ class SessionStore:
         prompt_tokens: int | None,
         completion_tokens: int | None,
         total_tokens: int | None,
+        cached_tokens: int | None = None,
         model: str | None = None,
     ) -> None:
         """Record per-round token usage. Legacy used ``INSERT OR REPLACE`` keyed on
@@ -1151,14 +1153,15 @@ class SessionStore:
         sql = self._db.dialect.upsert(
             self.t.usage_rounds,
             ("session_id", "round_index"),
-            ("prompt_tokens", "completion_tokens", "total_tokens", "model", "created_at"),
+            ("prompt_tokens", "completion_tokens", "total_tokens", "cached_tokens", "model",
+             "created_at"),
         )
         async with self._db.transaction() as tx:
             await tx.execute(
                 sql,
                 (
                     session_id, round_index, prompt_tokens, completion_tokens,
-                    total_tokens, model, _now_ms(),
+                    total_tokens, cached_tokens, model, _now_ms(),
                 ),
             )
 
@@ -1172,7 +1175,7 @@ class SessionStore:
         tool_calls: int = 0,
     ) -> None:
         """Cumulative per-session accounting, bumped once per finished send. On conflict
-        the seven counters ACCUMULATE (``col = col + new``), ``last_send_at``/``updated_at``
+        the eight counters ACCUMULATE (``col = col + new``), ``last_send_at``/``updated_at``
         OVERWRITE, and ``first_send_at`` is INSERT-ONLY (preserved on conflict, matching
         legacy which omits it from the ON CONFLICT SET). ``sends`` accumulates by 1."""
         now = _now_ms()
@@ -1182,7 +1185,7 @@ class SessionStore:
             ("last_send_at", "updated_at"),
             add_cols=(
                 "sends", "rounds", "llm_calls", "tool_calls",
-                "prompt_tokens", "completion_tokens", "total_tokens",
+                "prompt_tokens", "completion_tokens", "total_tokens", "cached_tokens",
             ),
             insert_only_cols=("first_send_at",),
         )
@@ -1198,6 +1201,7 @@ class SessionStore:
             int(usage.get("prompt_tokens") or 0),    # add: prompt_tokens
             int(usage.get("completion_tokens") or 0),  # add: completion_tokens
             int(usage.get("total_tokens") or 0),     # add: total_tokens
+            int(usage.get("cache_read_tokens") or usage.get("cached_tokens") or 0),  # add: cached_tokens
             now,                                     # insert-only: first_send_at
         )
         async with self._db.transaction() as tx:
@@ -1650,7 +1654,8 @@ def _row_to_stats(row: Row) -> SessionStatsRow:
         session_id=row["session_id"], sends=row["sends"], rounds=row["rounds"],
         llm_calls=row["llm_calls"], tool_calls=row["tool_calls"],
         prompt_tokens=row["prompt_tokens"], completion_tokens=row["completion_tokens"],
-        total_tokens=row["total_tokens"], first_send_at=row["first_send_at"],
+        total_tokens=row["total_tokens"], cached_tokens=row["cached_tokens"],
+        first_send_at=row["first_send_at"],
         last_send_at=row["last_send_at"], updated_at=row["updated_at"],
     )
 

{power_loop-3.7.0 → power_loop-3.8.1}/power_loop/runtime/store/types.py

@@ -97,6 +97,9 @@ class SessionStatsRow:
     first_send_at: int | None
     last_send_at: int | None
     updated_at: int
+    #: Prompt cache-read tokens (v5). Default 0 so the legacy SQLite store (which doesn't track it)
+    #: still constructs the row.
+    cached_tokens: int = 0
 
 
 @dataclass

{power_loop-3.7.0 → power_loop-3.8.1}/power_loop/tools/default_tools.py

@@ -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:

{power_loop-3.7.0 → power_loop-3.8.1}/power_loop.egg-info/PKG-INFO

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