shellbrain 0.1.31__tar.gz → 0.1.33__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: shellbrain
-Version: 0.1.31
+Version: 0.1.33
 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.33}/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.33}/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.33}/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.33}/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.33}/app/infrastructure/host_apps/inner_agents/prompt.py

@@ -292,10 +292,6 @@ next_checks:
 - one to three concrete checks supported by pack evidence. Do not give generic
   coding advice.
 
-sources:
-- include only pack sources that support the brief. Every non-empty section
-  should have source support when ids are available.
-
 # JUDGMENT
 Do not dump raw retrieval results. Compact does not mean omitting the deciding
 distinction. Preserve details that change what the worker should do:
@@ -309,8 +305,8 @@ guidance.
 
 # OUTPUT
 Return only valid JSON matching `output_contract`. Return a `brief` object only;
-do not include read_trace. Keep each list compact. Use only sources from the
-pack.
+do not include read_trace or sources. Keep each list compact. Shellbrain attaches
+deterministic source provenance after synthesis.
 """
 
 
@@ -821,7 +817,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 +886,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 {},
@@ -911,14 +905,6 @@ def render_build_context_synthesis_prompt(request: InnerAgentRunRequest) -> str:
                 "conflicts": ["string"],
                 "gaps": ["string"],
                 "next_checks": ["string"],
-                "sources": [
-                    {
-                        "kind": "memory|concept|claim|relation|grounding|memory_link|anchor|conflict",
-                        "id": "source id or concept ref from deterministic_graph_pack",
-                        "facet": "memory|claim|relation|grounding|memory_link when applicable",
-                        "used_in": "summary|constraints|known_traps|prior_cases|concept_orientation|anchors|conflicts|gaps|next_checks",
-                    }
-                ],
             }
         },
     }

{shellbrain-0.1.31 → shellbrain-0.1.33}/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.33}/pyproject.toml

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

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

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