fred-runtime 4.0.0__tar.gz → 4.3.0__tar.gz

{fred_runtime-4.0.0 → fred_runtime-4.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-runtime
-Version: 4.0.0
+Version: 4.3.0
 Summary: Runtime adapters and infrastructure wiring for Fred v2 agents.
 Author-email: Thales <noreply@thalesgroup.com>
 License: Apache-2.0
@@ -12,27 +12,29 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Operating System :: OS Independent
 Requires-Python: <3.13,>=3.12
 Description-Content-Type: text/markdown
-Requires-Dist: fred-core>=4.0.0
-Requires-Dist: fred-sdk>=4.0.0
+Requires-Dist: fred-core>=4.3.0
+Requires-Dist: fred-sdk[agents]>=4.3.0
 Requires-Dist: alembic>=1.18.4
-Requires-Dist: deepagents>=0.6.12
+Requires-Dist: deepagents>=0.7.19
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: langchain-mcp-adapters>=0.2.1
 Requires-Dist: mcp<2.0.0,>=1.24.0
-Requires-Dist: langchain>=1.3.14
-Requires-Dist: langchain-core>=0.3.0
-Requires-Dist: langgraph>=1.2.9
+Requires-Dist: langchain>=1.4.2
+Requires-Dist: langchain-core>=1.6.5
+Requires-Dist: langgraph>=1.2.12
 Requires-Dist: langfuse>=3.0.0
 Requires-Dist: requests<3,>=2.32
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: python-multipart>=0.0.9
 Provides-Extra: app
 Requires-Dist: fastapi>=0.139.0; extra == "app"
+Requires-Dist: starlette>=0.48.0; extra == "app"
 Provides-Extra: dev
 Requires-Dist: bandit>=1.8.6; extra == "dev"
 Requires-Dist: basedpyright==1.31.0; extra == "dev"
 Requires-Dist: detect-secrets>=1.5.0; extra == "dev"
 Requires-Dist: pytest>=8.4.2; extra == "dev"
+Requires-Dist: httpx2>=2.13.1; extra == "dev"
 Requires-Dist: pytest-asyncio>=1.2.0; extra == "dev"
 Requires-Dist: pytest-cov>=6.2.1; extra == "dev"
 Requires-Dist: pytest-socket>=0.7.0; extra == "dev"
@@ -49,25 +51,24 @@ factory so any agent pod is just a registry and a YAML file away from running.
 
 ## Where `fred-runtime` fits
 
-Fred follows a strict three-layer model:
-
 ```
-fred-core          Pure utilities — model factories, embeddings, logging, KPI store
-     │
-fred-sdk           Execution engine + authoring surface (pip-installable, no infra)
-     │              ReAct runtime, Graph runtime, agent contracts, tool abstractions
-     │
-fred-runtime       Platform adapters + pod factory (this package)
-                    SQL checkpointer, MCP wiring, LLM routing, OpenAI-compat surface,
-                    FastAPI app factory, observability, security middleware
+fred-pod                    configuration, identity, naming
+└── fred-sdk                authoring contracts
+    └── [agents]            + fred-core, langchain, langgraph
+        └── fred-runtime    execution, MCP, model routing    ← this package
+            └── [app]       + the FastAPI pod factory        → an agent pod
 ```
 
 **Rule of thumb:**
 
-- Write agent logic in `fred-sdk`.
+- Write agent logic against `fred-sdk`.
 - Write infrastructure adapters (DB, MCP server, Keycloak, object store) in `fred-runtime`.
 - `fred-sdk` must stay importable on a bare laptop with no services running.
 
+A Knowledge Base pod does not need this package. What a pod is, and which
+package each kind installs:
+[fred-pod](https://github.com/ThalesGroup/fred/tree/swift/libs/fred-pod).
+
 ---
 
 ## What's in the box
@@ -230,6 +231,10 @@ pip install fred-runtime
 pip install fred-runtime[app]
 ```
 
+`fred-runtime` depends on `fred-sdk[agents]`, so an agent pod installs nothing
+else to get the authoring surface. A Knowledge Base pod installs
+`fred-sdk[knowledge-base]` instead and never needs `fred-runtime`.
+
 Requires Python 3.12.
 
 ---
@@ -271,16 +276,23 @@ if __name__ == "__main__":
 **`registry.py`**
 
 ```python
-from fred_sdk.contracts.models import ReActAgentDefinition
+from fred_sdk import ReActAgent
+
+class MyAgent(ReActAgent):
+    agent_id: str = "acme.my.assistant"
+    role: str = "Assistant"
+    description: str = "Answers general questions."
+    system_prompt_template: str = "You are a concise assistant."
 
-class MyAgent(ReActAgentDefinition):
-    agent_id = "my-agent"
-    ...
+MY_AGENT = MyAgent()
 
-REGISTRY = {MyAgent.agent_id: MyAgent()}
+REGISTRY = {MY_AGENT.agent_id: MY_AGENT}
 ```
 
-See [fred-samples](https://github.com/ThalesGroup/fred-samples) for a working reference pod.
+How to write agents and their tools: the
+[fred-sdk README](https://github.com/ThalesGroup/fred/tree/swift/libs/fred-sdk).
+[fred-samples](https://github.com/fred-agent/fred-samples/tree/swift/agents) is a
+working pod with several agents.
 
 ---
 
@@ -288,8 +300,9 @@ See [fred-samples](https://github.com/ThalesGroup/fred-samples) for a working re
 
 | Package        | PyPI                                           | Role                                                                          |
 | -------------- | ---------------------------------------------- | ----------------------------------------------------------------------------- |
-| `fred-core`    | [pypi](https://pypi.org/project/fred-core/)    | Pure utilities — logging, model factories, embeddings, portable observability |
-| `fred-sdk`     | [pypi](https://pypi.org/project/fred-sdk/)     | Agent authoring — ReAct, Graph, tool contracts                                |
+| `fred-pod`     | [pypi](https://pypi.org/project/fred-pod/)     | What every pod shares — configuration, identity, naming                       |
+| `fred-core`    | [pypi](https://pypi.org/project/fred-core/)    | The agents platform — stores, model providers, logging, observability         |
+| `fred-sdk`     | [pypi](https://pypi.org/project/fred-sdk/)     | Authoring — agents, tools, Knowledge Bases                                    |
 | `fred-runtime` | [pypi](https://pypi.org/project/fred-runtime/) | This package                                                                  |
 
 ---

{fred_runtime-4.0.0 → fred_runtime-4.3.0}/README.md

@@ -9,25 +9,24 @@ factory so any agent pod is just a registry and a YAML file away from running.
 
 ## Where `fred-runtime` fits
 
-Fred follows a strict three-layer model:
-
 ```
-fred-core          Pure utilities — model factories, embeddings, logging, KPI store
-     │
-fred-sdk           Execution engine + authoring surface (pip-installable, no infra)
-     │              ReAct runtime, Graph runtime, agent contracts, tool abstractions
-     │
-fred-runtime       Platform adapters + pod factory (this package)
-                    SQL checkpointer, MCP wiring, LLM routing, OpenAI-compat surface,
-                    FastAPI app factory, observability, security middleware
+fred-pod                    configuration, identity, naming
+└── fred-sdk                authoring contracts
+    └── [agents]            + fred-core, langchain, langgraph
+        └── fred-runtime    execution, MCP, model routing    ← this package
+            └── [app]       + the FastAPI pod factory        → an agent pod
 ```
 
 **Rule of thumb:**
 
-- Write agent logic in `fred-sdk`.
+- Write agent logic against `fred-sdk`.
 - Write infrastructure adapters (DB, MCP server, Keycloak, object store) in `fred-runtime`.
 - `fred-sdk` must stay importable on a bare laptop with no services running.
 
+A Knowledge Base pod does not need this package. What a pod is, and which
+package each kind installs:
+[fred-pod](https://github.com/ThalesGroup/fred/tree/swift/libs/fred-pod).
+
 ---
 
 ## What's in the box
@@ -190,6 +189,10 @@ pip install fred-runtime
 pip install fred-runtime[app]
 ```
 
+`fred-runtime` depends on `fred-sdk[agents]`, so an agent pod installs nothing
+else to get the authoring surface. A Knowledge Base pod installs
+`fred-sdk[knowledge-base]` instead and never needs `fred-runtime`.
+
 Requires Python 3.12.
 
 ---
@@ -231,16 +234,23 @@ if __name__ == "__main__":
 **`registry.py`**
 
 ```python
-from fred_sdk.contracts.models import ReActAgentDefinition
+from fred_sdk import ReActAgent
+
+class MyAgent(ReActAgent):
+    agent_id: str = "acme.my.assistant"
+    role: str = "Assistant"
+    description: str = "Answers general questions."
+    system_prompt_template: str = "You are a concise assistant."
 
-class MyAgent(ReActAgentDefinition):
-    agent_id = "my-agent"
-    ...
+MY_AGENT = MyAgent()
 
-REGISTRY = {MyAgent.agent_id: MyAgent()}
+REGISTRY = {MY_AGENT.agent_id: MY_AGENT}
 ```
 
-See [fred-samples](https://github.com/ThalesGroup/fred-samples) for a working reference pod.
+How to write agents and their tools: the
+[fred-sdk README](https://github.com/ThalesGroup/fred/tree/swift/libs/fred-sdk).
+[fred-samples](https://github.com/fred-agent/fred-samples/tree/swift/agents) is a
+working pod with several agents.
 
 ---
 
@@ -248,8 +258,9 @@ See [fred-samples](https://github.com/ThalesGroup/fred-samples) for a working re
 
 | Package        | PyPI                                           | Role                                                                          |
 | -------------- | ---------------------------------------------- | ----------------------------------------------------------------------------- |
-| `fred-core`    | [pypi](https://pypi.org/project/fred-core/)    | Pure utilities — logging, model factories, embeddings, portable observability |
-| `fred-sdk`     | [pypi](https://pypi.org/project/fred-sdk/)     | Agent authoring — ReAct, Graph, tool contracts                                |
+| `fred-pod`     | [pypi](https://pypi.org/project/fred-pod/)     | What every pod shares — configuration, identity, naming                       |
+| `fred-core`    | [pypi](https://pypi.org/project/fred-core/)    | The agents platform — stores, model providers, logging, observability         |
+| `fred-sdk`     | [pypi](https://pypi.org/project/fred-sdk/)     | Authoring — agents, tools, Knowledge Bases                                    |
 | `fred-runtime` | [pypi](https://pypi.org/project/fred-runtime/) | This package                                                                  |
 
 ---

{fred_runtime-4.0.0 → fred_runtime-4.3.0}/fred_runtime/__main__.py

@@ -77,7 +77,6 @@ def main(argv: list[str] | None = None) -> int:
     if args.command == "dump-openapi":
         return _cmd_dump_openapi(args)
     parser.error(f"unknown command: {args.command}")
-    return 2
 
 
 if __name__ == "__main__":

{fred_runtime-4.0.0 → fred_runtime-4.3.0}/fred_runtime/app/__init__.py

@@ -21,7 +21,11 @@ Import from here:
 from .agent_app import create_agent_app
 from .config import (
     AgentPodConfig,
+    ConversationFilesystemQuotaConfig,
+    GcsRuntimeFilesystemConfig,
     LangfuseObservabilityConfig,
+    LocalRuntimeFilesystemConfig,
+    MinioRuntimeFilesystemConfig,
     PodAIConfig,
     PodAppConfig,
     PodObservabilityConfig,
@@ -35,10 +39,15 @@ from .config_loader import (
     get_loaded_env_file_path,
     load_agent_pod_config,
 )
+from .filesystem_factory import build_runtime_filesystem
 
 __all__ = [
     "AgentPodConfig",
+    "ConversationFilesystemQuotaConfig",
+    "GcsRuntimeFilesystemConfig",
     "LangfuseObservabilityConfig",
+    "LocalRuntimeFilesystemConfig",
+    "MinioRuntimeFilesystemConfig",
     "PodAIConfig",
     "PodAppConfig",
     "PodObservabilityConfig",
@@ -46,6 +55,7 @@ __all__ = [
     "PodSchedulerConfig",
     "PodStorageConfig",
     "TracerBackend",
+    "build_runtime_filesystem",
     "create_agent_app",
     "get_loaded_config_file_path",
     "get_loaded_env_file_path",