amfs-http-server 0.3.38__tar.gz → 0.3.40__tar.gz

{amfs_http_server-0.3.38 → amfs_http_server-0.3.40}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.5
 Name: amfs-http-server
-Version: 0.3.38
+Version: 0.3.40
 Summary: AMFS HTTP/REST API server with SSE support
 License-Expression: Apache-2.0
 Requires-Python: >=3.11
-Requires-Dist: amfs-core>=0.3.34
-Requires-Dist: amfs>=0.5.22
+Requires-Dist: amfs-core>=0.3.37
+Requires-Dist: amfs>=0.5.27
 Requires-Dist: fastapi>=0.115
 Requires-Dist: httpx>=0.27
 Requires-Dist: sse-starlette>=2.0

{amfs_http_server-0.3.38 → amfs_http_server-0.3.40}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "amfs-http-server"
-version = "0.3.38"
+version = "0.3.40"
 description = "AMFS HTTP/REST API server with SSE support"
 requires-python = ">=3.11"
 license = "Apache-2.0"
@@ -13,7 +13,7 @@ dependencies = [
     # this tree is what test_dependency_floors forbids.
     # 0.5.18 for AgentMemory.as_agent, which the agent detail page calls to list
     # an agent's entries as that agent rather than as the server.
-    "amfs>=0.5.22",
+    "amfs>=0.5.27",
     # 0.3.23 is real in the silent way: the write path calls
     # adapter.scope_counts(), which is a default on AdapterABC from 0.3.23. On an
     # older core the adapters that do not override it — filesystem, S3 — have no
@@ -27,7 +27,7 @@ dependencies = [
     # unexpected keyword, _scope_block swallows it, and the block disappears —
     # while an adapter that ignored the argument instead would name another
     # agent's private keys. Either way the floor is what makes the rule real.
-    "amfs-core>=0.3.34",
+    "amfs-core>=0.3.37",
     "fastapi>=0.115",
     "uvicorn[standard]>=0.32",
     "sse-starlette>=2.0",

{amfs_http_server-0.3.38 → amfs_http_server-0.3.40}/src/amfs_http/models.py

@@ -93,7 +93,11 @@ class SearchRequest(BaseModel):
     pattern_ref: str | None = None
     limit: int = 100
     sort_by: str = "confidence"
-    branch: str = "main"
+    # ``None`` rather than ``"main"`` so the server can tell a caller that
+    # named no branch from one that asked for main: the former may be routed
+    # onto a canary branch by the SaaS layer (``request.state.memory_branch``),
+    # the latter never is. The SDK omits the field when it is main.
+    branch: str | None = None
     depth: int = 3
     # When True (default) artifacts are demoted to the bottom of results; when
     # False they are excluded entirely.
@@ -118,7 +122,7 @@ class AggregateRequest(BaseModel):
     field: str | None = None
     group_by: str | None = None
     row_path: str | None = None
-    branch: str = "main"
+    branch: str | None = None  # see SearchRequest.branch
 
 
 class RetrieveRequest(BaseModel):
@@ -136,7 +140,7 @@ class RetrieveRequest(BaseModel):
     semantic_weight: float = 0.5
     recency_weight: float = 0.3
     confidence_weight: float = 0.2
-    branch: str = "main"
+    branch: str | None = None  # see SearchRequest.branch
     # When True (default) artifacts (stored source files) are demoted but still
     # returned; when False they are excluded entirely from results.
     include_artifacts: bool = True
@@ -178,6 +182,16 @@ class RetrieveRequest(BaseModel):
     #: breakdown, importance dimensions, integrity fields, long values trimmed).
     #: Roughly a third of the tokens of the full payload.
     compact: bool = False
+    #: The asking run's environment — ``{"model", "agent_version", "runtime",
+    #: "platform"}`` — from the SDK's session or the MCP identity. A procedure
+    #: whose ``preconditions`` contradict it is dropped from the hits (it is a
+    #: way of doing the task somewhere else) and the priors weight outcomes
+    #: recorded under another environment less. Nothing changes when omitted.
+    environment: dict[str, str] | None = None
+    #: Say ``abstain`` in the recommendation when nothing in scope has been
+    #: tried or validated, instead of staying silent. Opt-in; with it a client
+    #: can tell "no guidance" from "guidance not requested".
+    abstain: bool = False
 
 
 class ContextRequest(BaseModel):