shellbrain 0.1.31__tar.gz → 0.1.32__tar.gz

{shellbrain-0.1.31 → shellbrain-0.1.32}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shellbrain
-Version: 0.1.31
+Version: 0.1.32
 Summary: Repo-scoped Shellbrain CLI with explicit evidence-backed writes.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{shellbrain-0.1.31 → shellbrain-0.1.32}/app/core/entities/inner_agents.py

@@ -37,7 +37,6 @@ class BuildContextSettings(_StrictModel):
     reasoning: InnerAgentReasoningLevel
     timeout_seconds: int = Field(ge=1, le=600)
     max_private_reads: int = Field(default=0, ge=0, le=10)
-    max_candidate_tokens: int = Field(ge=1, le=200_000)
     max_brief_tokens: int | None = Field(default=None, ge=1, le=100_000)
 
 

{shellbrain-0.1.31 → shellbrain-0.1.32}/app/core/ports/host_apps/inner_agents.py

@@ -32,7 +32,6 @@ class InnerAgentRunRequest(_StrictModel):
     reasoning: InnerAgentReasoningLevel
     timeout_seconds: int = Field(ge=1, le=600)
     max_private_reads: int = Field(default=0, ge=0, le=10)
-    max_candidate_tokens: int = Field(ge=1, le=200_000)
     max_brief_tokens: int | None = Field(default=None, ge=1, le=100_000)
     query: str = Field(min_length=1)
     current_problem: dict[str, str]

{shellbrain-0.1.31 → shellbrain-0.1.32}/app/core/use_cases/retrieval/build_context/execute.py

@@ -19,7 +19,9 @@ from app.core.ports.host_apps.inner_agents import IInnerAgentRunner
 from app.core.use_cases.retrieval.deterministic_graph_recall import (
     build_deterministic_graph_pack,
     deterministic_brief_from_graph_pack,
+    record_synthesis_pack_size,
     source_items_from_graph_pack,
+    synthesis_pack_from_graph_pack,
 )
 from app.core.use_cases.retrieval.recall.request import MemoryRecallRequest
 from app.core.use_cases.retrieval.recall.result import RecallMemoryResult
@@ -32,7 +34,6 @@ _DEFAULT_SETTINGS = InnerAgentSettings(
     reasoning="low",
     timeout_seconds=90,
     max_private_reads=0,
-    max_candidate_tokens=10_000,
     max_brief_tokens=1_800,
 )
 
@@ -157,7 +158,6 @@ def _inner_agent_request(
         reasoning=settings.reasoning,
         timeout_seconds=settings.timeout_seconds,
         max_private_reads=settings.max_private_reads,
-        max_candidate_tokens=settings.max_candidate_tokens,
         max_brief_tokens=settings.max_brief_tokens,
         query=request.query,
         current_problem=request.current_problem.model_dump(mode="python"),
@@ -257,13 +257,18 @@ def _deterministic_graph_result(
             },
         )
 
+    synthesis_pack = synthesis_pack_from_graph_pack(graph_pack)
+    record_synthesis_pack_size(
+        graph_pack=graph_pack,
+        synthesis_pack=synthesis_pack,
+    )
     synthesis_result = _run_inner_agent(
         request=request,
         settings=settings,
         inner_agent_runner=inner_agent_runner,
         repo_root=repo_root,
         synthesis_only=True,
-        deterministic_pack=graph_pack,
+        deterministic_pack=synthesis_pack,
     )
     if synthesis_result.status == "ok" and synthesis_result.brief is not None:
         return RecallMemoryResult(

{shellbrain-0.1.31 → shellbrain-0.1.32}/app/core/use_cases/retrieval/deterministic_graph_recall.py

@@ -158,6 +158,36 @@ def build_deterministic_graph_pack(
     return pack
 
 
+def synthesis_pack_from_graph_pack(pack: dict[str, Any]) -> dict[str, Any]:
+    """Project a full graph pack into the evidence pack sent to synthesis.
+
+    The deterministic traversal/ranking step decides what evidence the synthesizer
+    needs. This projection keeps that evidence intact and removes diagnostic-only
+    traversal details that are useful for telemetry, not synthesis.
+    """
+
+    return _project_synthesis_pack(pack=pack)
+
+
+def record_synthesis_pack_size(
+    *,
+    graph_pack: dict[str, Any],
+    synthesis_pack: dict[str, Any],
+) -> None:
+    """Attach synthesis prompt size metadata to the full telemetry pack."""
+
+    pack_trace = graph_pack.get("pack_trace")
+    if not isinstance(pack_trace, dict):
+        raise ValueError("deterministic graph pack is missing pack_trace")
+    pack_budget = pack_trace.get("pack_budget")
+    if not isinstance(pack_budget, dict):
+        raise ValueError("deterministic graph pack is missing pack_trace.pack_budget")
+    pack_budget["source_candidate_tokens_estimated"] = _estimate_pack_tokens(graph_pack)
+    pack_budget["synthesis_candidate_tokens_estimated"] = int(
+        _estimate_pack_tokens(synthesis_pack)
+    )
+
+
 def deterministic_brief_from_graph_pack(pack: dict[str, Any]) -> dict[str, Any]:
     """Render a compact worker brief from a deterministic graph pack."""
 
@@ -1068,6 +1098,31 @@ def _pack_budget(
     }
 
 
+def _project_synthesis_pack(
+    *,
+    pack: dict[str, Any],
+) -> dict[str, Any]:
+    return {
+        "strategy": pack.get("strategy"),
+        "request": pack.get("request") if isinstance(pack.get("request"), dict) else {},
+        "memories": _dict_items(pack.get("memories")),
+        "concepts": _dict_items(pack.get("concepts")),
+        "relation_neighbors": _dict_items(pack.get("relation_neighbors")),
+        "anchors": _dict_items(pack.get("anchors")),
+        "conflicts": _dict_items(pack.get("conflicts")),
+    }
+
+
+def _dict_items(value: object) -> list[dict[str, Any]]:
+    if not isinstance(value, list):
+        return []
+    return [item for item in value if isinstance(item, dict)]
+
+
+def _estimate_pack_tokens(pack: dict[str, Any]) -> int:
+    return max(1, len(json.dumps(pack, sort_keys=True, default=str)) // 4)
+
+
 def _brief_memory_texts(
     memories: Sequence[dict[str, Any]],
     *,

{shellbrain-0.1.31 → shellbrain-0.1.32}/app/infrastructure/host_apps/inner_agents/prompt.py

@@ -821,7 +821,6 @@ def render_build_context_prompt(request: InnerAgentRunRequest) -> str:
         "repo_root": request.repo_root,
         "budgets": {
             "max_private_reads": request.max_private_reads,
-            "max_candidate_tokens": request.max_candidate_tokens,
             "max_brief_tokens": request.max_brief_tokens,
         },
         "help_commands": [
@@ -891,7 +890,6 @@ def render_build_context_synthesis_prompt(request: InnerAgentRunRequest) -> str:
         "query": request.query,
         "current_problem": request.current_problem,
         "budgets": {
-            "max_candidate_tokens": request.max_candidate_tokens,
             "max_brief_tokens": request.max_brief_tokens,
         },
         "deterministic_graph_pack": request.deterministic_pack or {},

{shellbrain-0.1.31 → shellbrain-0.1.32}/app/settings/internal-agents/defaults.yaml

@@ -6,7 +6,6 @@ build_context:
   reasoning: low
   timeout_seconds: 90
   max_private_reads: 3
-  max_candidate_tokens: 10000
   max_brief_tokens: 1800
 
 build_knowledge:

{shellbrain-0.1.31 → shellbrain-0.1.32}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "shellbrain"
-version = "0.1.31"
+version = "0.1.32"
 description = "Repo-scoped Shellbrain CLI with explicit evidence-backed writes."
 readme = "README.md"
 requires-python = ">=3.11"

{shellbrain-0.1.31 → shellbrain-0.1.32}/shellbrain.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shellbrain
-Version: 0.1.31
+Version: 0.1.32
 Summary: Repo-scoped Shellbrain CLI with explicit evidence-backed writes.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown