Skip to content

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

fix(memory): make numpy import optional for proxy boot path

Claude Code Botd236b4befd79
diff --git a/headroom/memory/adapters/sqlite.py b/headroom/memory/adapters/sqlite.py
index 1a2d7c2a3..66ffb56f9 100644
--- a/headroom/memory/adapters/sqlite.py
+++ b/headroom/memory/adapters/sqlite.py
@@ -14,13 +14,14 @@ import re
import sqlite3
from datetime import datetime, timezone
from pathlib import Path
-from typing import Any
-
-import numpy as np
+from typing import TYPE_CHECKING, Any
from ..models import Memory, ScopeLevel
from ..ports import MemoryFilter
+if TYPE_CHECKING:
+ import numpy as np
+
# Regex pattern for safe metadata keys: alphanumeric, underscores, hyphens only
# This prevents JSON path injection attacks via malicious key names
_SAFE_METADATA_KEY_PATTERN = re.compile(r"^[a-zA-Z_][a-zA-Z0-9_\-]*$")
@@ -165,6 +166,8 @@ class SQLiteMemoryStore:
"""Serialize numpy array to bytes for BLOB storage."""
if embedding is None:
return None
+ import numpy as np
+
return bytes(embedding.astype(np.float32).tobytes())
def _deserialize_embedding(
@@ -173,6 +176,8 @@ class SQLiteMemoryStore:
"""Deserialize bytes back to numpy array."""
if data is None:
return None
+ import numpy as np
+
arr = np.frombuffer(data, dtype=np.float32)
return arr
diff --git a/headroom/memory/ports.py b/headroom/memory/ports.py
index 53d05924a..fd2790cf2 100644
--- a/headroom/memory/ports.py
+++ b/headroom/memory/ports.py
@@ -5,12 +5,13 @@ from __future__ import annotations
import uuid
from dataclasses import dataclass, field
from datetime import datetime
-from typing import Any, Protocol, runtime_checkable
-
-import numpy as np
+from typing import TYPE_CHECKING, Any, Protocol, runtime_checkable
from headroom.memory.models import Memory, ScopeLevel
+if TYPE_CHECKING:
+ import numpy as np
+
# =============================================================================
# Filter Dataclasses
# =============================================================================