fred-sdk 3.3.0__tar.gz → 3.3.2__tar.gz

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-sdk
-Version: 3.3.0
+Version: 3.3.2
 Summary: Authoring SDK for Fred agents — graph, ReAct, and team agent primitives.
 Author-email: Thales <noreply@thalesgroup.com>
 License: Apache-2.0
@@ -12,7 +12,7 @@ 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>=3.4.0
+Requires-Dist: fred-core>=3.4.2
 Requires-Dist: pydantic<3.0.0,>=2.7.0
 Requires-Dist: langchain-core>=0.3.0
 Requires-Dist: langchain>=0.3.0

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/fred_sdk/__init__.py

@@ -149,7 +149,6 @@ from fred_sdk.graph.runtime import (
 # Resource loading helpers
 # ---------------------------------------------------------------------------
 from fred_sdk.resources import (
-    apply_global_base_prompts,
     load_agent_prompt_markdown,
     load_packaged_markdown,
 )
@@ -244,7 +243,6 @@ __all__ = [
     "RuntimeContext",
     "ToolContentKind",
     # Resource helpers
-    "apply_global_base_prompts",
     "load_agent_prompt_markdown",
     "load_packaged_markdown",
     # Built-in tool references

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/fred_sdk/contracts/context.py

@@ -118,8 +118,8 @@ class RuntimeContext(BaseModel):
       selected_document_uids, context_prompt_text, search_policy, search_rag_scope,
       include_session_scope, include_corpus_scope, deep_search, selected_chat_context_ids.
       These are the core fields — set by the frontend per turn, read by retrieval logic.
-    - Group D (content/preferences): language, user_groups, attachments_markdown.
-      Will migrate to session preferences / identity over time.
+    - Group D (content/preferences): language, attachments_markdown. Will
+      migrate to session preferences / identity over time.
     """
 
     # Group A — Identity (managed execution authorizes on team_id via pod-side OpenFGA)
@@ -152,7 +152,6 @@ class RuntimeContext(BaseModel):
 
     # Group D — Content and preferences (will migrate to proper homes over time)
     language: Optional[str] = None
-    user_groups: list[str] | None = None
     attachments_markdown: Optional[str] = None
 
 

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/fred_sdk/resources/__init__.py

@@ -31,13 +31,11 @@ Example:
 """
 
 from .prompts import (
-    apply_global_base_prompts,
     load_agent_prompt_markdown,
     load_packaged_markdown,
 )
 
 __all__ = [
-    "apply_global_base_prompts",
     "load_agent_prompt_markdown",
     "load_packaged_markdown",
 ]

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/fred_sdk/resources/prompts.py

@@ -18,9 +18,13 @@ from collections.abc import Sequence
 
 from .packaged import load_packaged_resource
 
-# Add one `(package, path_parts)` tuple here for each shared prompt fragment
-# that should be available to authored agent pods. Fragments are appended in
-# declaration order.
+# Add one `(package, path_parts)` tuple here for each shared prompt fragment that
+# must apply to every agent turn. Fragments are concatenated in declaration order
+# into `GLOBAL_BASE_PROMPT_MARKDOWN` and injected at execution time by the runtime
+# (`build_global_base_prompt_suffix` in fred-runtime). They are deliberately NOT
+# baked into any agent's editable `system_prompt_template`, so they stay out of
+# the operator-facing agent editor and apply even when an operator overrides the
+# whole prompt.
 GLOBAL_BASE_PROMPT_RESOURCES: tuple[tuple[str, tuple[str, ...]], ...] = (
     ("fred_sdk", ("resources", "prompts", "mermaid_output_contract.md")),
 )
@@ -56,7 +60,6 @@ def load_agent_prompt_markdown(
     package: str,
     file_name: str,
     prompts_subdir: Sequence[str] = ("prompts",),
-    include_global_base_prompts: bool = False,
 ) -> str:
     """
     Load a packaged Markdown prompt for a v2 agent module.
@@ -71,49 +74,30 @@ def load_agent_prompt_markdown(
 
     How to use it:
     - pass the package owning the `prompts/` directory and the file name to load
-    - set `include_global_base_prompts=True` for default system prompts that
-      should inherit Fred's shared renderer/output contracts
+
+    Note:
+    - Fred's shared renderer/output contracts (`GLOBAL_BASE_PROMPT_MARKDOWN`) are
+      NOT appended here. They are injected at execution time by the runtime
+      (`build_global_base_prompt_suffix`) so they stay out of the editable prompt.
 
     Example:
-    - `prompt = load_agent_prompt_markdown(package="my_package.agents.search_agent", file_name="system_prompt.md", include_global_base_prompts=True)`
+    - `prompt = load_agent_prompt_markdown(package="my_package.agents.search_agent", file_name="system_prompt.md")`
     """
-    prompt = load_packaged_markdown(
+    return load_packaged_markdown(
         package=package,
         path_parts=(*prompts_subdir, file_name),
     )
-    if include_global_base_prompts:
-        return apply_global_base_prompts(prompt)
-    return prompt
 
 
 def _join_prompt_sections(sections: Sequence[str]) -> str:
     return "\n\n".join(section for section in sections if section)
 
 
+# Single source of truth for Fred's shared global base prompt. Consumed at
+# execution time by the runtime suffix builder, never baked into agent templates.
 GLOBAL_BASE_PROMPT_MARKDOWN: str = _join_prompt_sections(
     tuple(
         load_packaged_markdown(package=package, path_parts=path_parts).strip()
         for package, path_parts in GLOBAL_BASE_PROMPT_RESOURCES
     )
 )
-
-
-def apply_global_base_prompts(prompt: str) -> str:
-    """
-    Append Fred's shared base prompt fragments to one agent prompt.
-
-    Why this helper exists:
-    - renderer-oriented output contracts should be reusable across agent pods
-      instead of copied into each application package
-    - prompt composition remains an authoring-time default, not a runtime
-      injection layer
-
-    How to use it:
-    - pass the agent's local system prompt and assign the returned text to the
-      template's default `system_prompt_template`
-
-    Example:
-    - `system_prompt_template = apply_global_base_prompts(local_prompt)`
-    """
-
-    return _join_prompt_sections((prompt.strip(), GLOBAL_BASE_PROMPT_MARKDOWN))

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/fred_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-sdk
-Version: 3.3.0
+Version: 3.3.2
 Summary: Authoring SDK for Fred agents — graph, ReAct, and team agent primitives.
 Author-email: Thales <noreply@thalesgroup.com>
 License: Apache-2.0
@@ -12,7 +12,7 @@ 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>=3.4.0
+Requires-Dist: fred-core>=3.4.2
 Requires-Dist: pydantic<3.0.0,>=2.7.0
 Requires-Dist: langchain-core>=0.3.0
 Requires-Dist: langchain>=0.3.0

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/fred_sdk.egg-info/requires.txt

@@ -1,4 +1,4 @@
-fred-core>=3.4.0
+fred-core>=3.4.2
 pydantic<3.0.0,>=2.7.0
 langchain-core>=0.3.0
 langchain>=0.3.0

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "fred-sdk"
-version = "3.3.0"
+version = "3.3.2"
 description = "Authoring SDK for Fred agents — graph, ReAct, and team agent primitives."
 readme = "README.md"
 requires-python = ">=3.12,<3.13"
 license = { text = "Apache-2.0" }
 authors = [{ name = "Thales", email = "noreply@thalesgroup.com" }]
 dependencies = [
-  "fred-core>=3.4.0",
+  "fred-core>=3.4.2",
   "pydantic>=2.7.0,<3.0.0",
   "langchain-core>=0.3.0",
   "langchain>=0.3.0",

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/tests/test_conversational_memory.py

@@ -36,8 +36,6 @@ from __future__ import annotations
 from collections.abc import Mapping
 
 import pytest
-from pydantic import BaseModel
-
 from fred_sdk.contracts.context import (
     AgentInvocationRequest,
     BoundRuntimeContext,
@@ -60,6 +58,7 @@ from fred_sdk.graph.authoring.team_api import (
     TeamState,
     _format_conversation_history,
 )
+from pydantic import BaseModel
 
 # ---------------------------------------------------------------------------
 # Test fixtures

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/tests/test_execution_contracts.py

@@ -28,7 +28,6 @@ All tests run without any external services.
 from __future__ import annotations
 
 import pytest
-
 from fred_sdk.contracts.context import RuntimeContext
 from fred_sdk.contracts.execution import (
     ActorContext,
@@ -327,9 +326,8 @@ def test_turn_persisted_event_serialises_as_dict() -> None:
 
 
 def test_turn_persisted_event_discriminator_roundtrip() -> None:
-    from pydantic import TypeAdapter
-
     from fred_sdk.contracts.runtime import RuntimeEvent
+    from pydantic import TypeAdapter
 
     raw = {"kind": "turn_persisted", "session_id": "sess-abc", "sequence": 0}
     ta = TypeAdapter(RuntimeEvent)

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/tests/test_graph_models.py

@@ -25,7 +25,6 @@ Covers:
 from __future__ import annotations
 
 import pytest
-
 from fred_sdk.contracts.models import (
     GraphConditionalDefinition,
     GraphDefinition,

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/tests/test_openai_compat.py

@@ -25,7 +25,6 @@ from __future__ import annotations
 import json
 
 import pytest
-
 from fred_sdk.contracts.openai_compat import (
     OpenAIChatRequest,
     OpenAICompletionChunk,

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/tests/test_prompt_bundles.py

@@ -1,20 +1,22 @@
 from fred_sdk import (
-    apply_global_base_prompts,
     load_agent_prompt_markdown,
     load_packaged_markdown,
 )
+from fred_sdk.resources.prompts import GLOBAL_BASE_PROMPT_MARKDOWN
 
 _EXPECTED_FRAGMENT = "When you include Mermaid diagrams, follow these rules strictly so the diagram always parses:"
 _EXPECTED_FALLBACK_RULE = "If you are unsure the Mermaid will parse, do not return Mermaid, return a simpler Markdown list or table instead."
 
 
-def test_apply_global_base_prompts_appends_mermaid_contract() -> None:
+def test_global_base_prompt_markdown_bundles_mermaid_contract() -> None:
     """
-    Verify the SDK-owned shared prompt bundle appends the Mermaid output contract.
+    Verify the SDK-owned global base prompt bundle carries the Mermaid contract.
 
     Why this test exists:
-    - shared prompt fragments are loaded as packaged SDK resources and should
-      remain available to every agent pod
+    - `GLOBAL_BASE_PROMPT_MARKDOWN` is the single source of truth that the runtime
+      injects at execution time (see fred-runtime `build_global_base_prompt_suffix`)
+    - the contract is no longer baked into agent templates, so this constant is the
+      only place that still guarantees the renderer rules ship with the platform
 
     How to use it:
     - run via the default fred-sdk test suite
@@ -23,26 +25,24 @@ def test_apply_global_base_prompts_appends_mermaid_contract() -> None:
     - `pytest tests/test_prompt_bundles.py -q`
     """
 
-    prompt = apply_global_base_prompts("Local instructions.")
+    assert _EXPECTED_FRAGMENT in GLOBAL_BASE_PROMPT_MARKDOWN
+    assert _EXPECTED_FALLBACK_RULE in GLOBAL_BASE_PROMPT_MARKDOWN
 
-    assert prompt.startswith("Local instructions.")
-    assert _EXPECTED_FRAGMENT in prompt
-    assert _EXPECTED_FALLBACK_RULE in prompt
 
-
-def test_load_agent_prompt_markdown_can_include_global_base_prompts() -> None:
+def test_load_agent_prompt_markdown_does_not_append_global_base_prompt() -> None:
     """
-    Verify the conventional agent prompt loader can opt into shared base prompts.
+    Verify the conventional agent prompt loader returns the raw file only.
 
     Why this test exists:
-    - default agent modules should be able to declare shared prompt composition
-      at the load site without nesting `apply_global_base_prompts(...)`
+    - the global base prompt moved from authoring-time baking to runtime injection;
+      `load_agent_prompt_markdown` must return exactly the packaged file with no
+      shared renderer/output contract appended
 
     How to use it:
-    - pass `include_global_base_prompts=True` when loading a system prompt file
+    - run via the default fred-sdk test suite
 
     Example:
-    - `load_agent_prompt_markdown(package="fred_sdk.resources", file_name="sample.md", include_global_base_prompts=True)`
+    - `pytest tests/test_prompt_bundles.py -q`
     """
 
     base_prompt = load_packaged_markdown(
@@ -52,12 +52,12 @@ def test_load_agent_prompt_markdown_can_include_global_base_prompts() -> None:
     prompt = load_agent_prompt_markdown(
         package="fred_sdk.resources",
         file_name="mermaid_output_contract.md",
-        include_global_base_prompts=True,
     )
 
-    assert prompt.startswith(base_prompt)
-    assert prompt.count(_EXPECTED_FRAGMENT) == 2
-    assert prompt.count(_EXPECTED_FALLBACK_RULE) == 2
+    # The loader returns the file verbatim — the contract appears exactly once,
+    # not twice (no global base prompt is appended).
+    assert prompt == base_prompt
+    assert prompt.count(_EXPECTED_FRAGMENT) == 1
 
 
 def test_mermaid_contract_does_not_embed_executable_placeholder_fences() -> None:

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/tests/test_prompt_utils.py

@@ -21,7 +21,6 @@ Ref: docs/backlog/BACKLOG.md §3d.9 (P1) — PROMPT_SAFE_TOKENS registry,
 """
 
 import pytest
-
 from fred_sdk.contracts.prompt_utils import (
     PROMPT_SAFE_TOKENS,
     validate_prompt_template,

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/tests/test_react_contract.py

@@ -26,7 +26,6 @@ Covers:
 from __future__ import annotations
 
 import pytest
-
 from fred_sdk.contracts.react_contract import (
     ReActInput,
     ReActMessage,

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/tests/test_tool_args_schema.py

@@ -29,9 +29,8 @@ from __future__ import annotations
 from typing import Any
 
 import pytest
-from pydantic import BaseModel
-
 from fred_sdk.authoring.tool_args_schema import build_args_schema
+from pydantic import BaseModel
 
 # ---------------------------------------------------------------------------
 # Dummy ToolContext placeholder (not imported; just a positional stand-in)

{fred_sdk-3.3.0 → fred_sdk-3.3.2}/tests/test_tool_context_workspace_fs.py

@@ -14,7 +14,6 @@ import asyncio
 from types import SimpleNamespace
 
 import pytest
-
 from fred_sdk.authoring.api import ToolContext
 from fred_sdk.contracts.context import FsEntry, LinkPart, PublishedArtifact
 from fred_sdk.contracts.runtime import WorkspaceFileNotFound