fred-runtime 3.5.0__tar.gz → 3.5.1__tar.gz

{fred_runtime-3.5.0 → fred_runtime-3.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-runtime
-Version: 3.5.0
+Version: 3.5.1
 Summary: Runtime adapters and infrastructure wiring for Fred v2 agents.
 Author-email: Thales <noreply@thalesgroup.com>
 License: Apache-2.0

fred_runtime-3.5.0/fred_runtime/migrations.py → fred_runtime-3.5.1/fred_runtime/migrations/__init__.py

@@ -38,13 +38,13 @@ import logging
 import os
 from pathlib import Path
 
-from .capabilities import CapabilityRegistry
+from ..capabilities import CapabilityRegistry
 
 logger = logging.getLogger(__name__)
 
-# fred-runtime's own Alembic tree ships beside the package (libs/fred-runtime/
-# alembic), one level above this module's package directory.
-RUNTIME_ALEMBIC_DIR = Path(__file__).resolve().parent.parent / "alembic"
+# This package is the runtime's Alembic tree, so the migration CLI needs no
+# source checkout or repository-relative resources.
+RUNTIME_ALEMBIC_DIR = Path(__file__).resolve().parent
 
 
 def _upgrade(script_location: str, *, label: str) -> None:
@@ -106,7 +106,7 @@ def upgrade_sqlite_database(sqlite_path: str | Path) -> None:
     leaves `alembic_version_runtime` stamped like a real install. It costs ~30ms
     per database once imports are warm.
 
-    Why `DATABASE_URL`: `alembic/env.py` honours it ahead of `CONFIG_FILE`
+    Why `DATABASE_URL`: the packaged Alembic env honours it ahead of `CONFIG_FILE`
     (`fred_core.sql.alembic_env._build_url`), which is the only way to point the
     tree at an arbitrary file. The previous value is restored, since tests run
     in-process and some set it themselves.

fred_runtime-3.5.1/fred_runtime/migrations/env.py

@@ -0,0 +1,50 @@
+# Copyright Thales 2026
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+from logging.config import fileConfig
+from typing import cast
+
+from alembic import context
+from fred_core.history.history_models import SessionHistoryRow  # noqa: F401
+from fred_core.sql import make_alembic_env
+from sqlalchemy import MetaData, Table
+
+from fred_runtime.app.config_loader import load_agent_pod_config
+
+# Alembic Config object — provides access to values in alembic.ini.
+config = context.config
+
+# Set up Python logging from alembic.ini if present.
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+# Build a MetaData scoped to only the tables fred-runtime owns.
+# SessionHistoryRow shares Base with other backends (users, session, teammetadata),
+# so we must not pass Base.metadata directly — that would make alembic check
+# report drift for tables managed by control-plane-backend.
+_runtime_metadata = MetaData()
+cast(Table, SessionHistoryRow.__table__).to_metadata(_runtime_metadata)
+
+run_migrations_offline, run_migrations_online = make_alembic_env(
+    target_metadata=_runtime_metadata,
+    get_postgres_config=lambda: load_agent_pod_config().storage.postgres,
+    version_table="alembic_version_runtime",
+)
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

fred_runtime-3.5.1/fred_runtime/migrations/script.py.mako

@@ -0,0 +1,32 @@
+${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+# codeql[py/unused-global-variable]
+revision: str = ${repr(up_revision)}
+# codeql[py/unused-global-variable]
+down_revision: Union[str, Sequence[str], None] = ${repr(down_revision)}
+# codeql[py/unused-global-variable]
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+# codeql[py/unused-global-variable]
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    ${downgrades if downgrades else "pass"}

fred_runtime-3.5.1/fred_runtime/migrations/versions/__init__.py

@@ -0,0 +1 @@
+"""Linear fred-runtime Alembic revision history."""

fred_runtime-3.5.1/fred_runtime/migrations/versions/a1e2f3c4d5b6_create_session_history.py

@@ -0,0 +1,75 @@
+# Copyright Thales 2026
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""create session_history table
+
+Initial schema for the session_history table as originally deployed via
+PostgresHistoryStore._ensure_tables (CREATE TABLE IF NOT EXISTS).
+
+Stamp an existing production database that already has this table with:
+    alembic stamp a1e2f3c4d5b6
+
+Revision ID: a1e2f3c4d5b6
+Revises:
+Create Date: 2026-06-02 00:00:00.000000
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.dialects import postgresql
+
+# revision identifiers, used by Alembic.
+revision: str = "a1e2f3c4d5b6"  # pragma: allowlist secret
+down_revision: Union[str, Sequence[str], None] = None
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.create_table(
+        "session_history",
+        sa.Column("session_id", sa.String(), nullable=False),
+        sa.Column("user_id", sa.String(), nullable=False),
+        sa.Column("rank", sa.Integer(), nullable=False),
+        sa.Column("timestamp", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("role", sa.String(), nullable=False),
+        sa.Column("channel", sa.String(), nullable=False),
+        sa.Column(
+            "parts_json",
+            postgresql.JSONB(astext_type=sa.Text()).with_variant(sa.JSON(), "sqlite"),
+            nullable=True,
+        ),
+        sa.Column(
+            "metadata_json",
+            postgresql.JSONB(astext_type=sa.Text()).with_variant(sa.JSON(), "sqlite"),
+            nullable=True,
+        ),
+        sa.PrimaryKeyConstraint("session_id", "user_id", "rank"),
+    )
+    op.create_index(
+        "ix_session_history_timestamp",
+        "session_history",
+        ["timestamp"],
+        unique=False,
+    )
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_index("ix_session_history_timestamp", table_name="session_history")
+    op.drop_table("session_history")

fred_runtime-3.5.1/fred_runtime/migrations/versions/b2f3a4e5c6d7_add_exchange_id.py

@@ -0,0 +1,49 @@
+# Copyright Thales 2026
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""add exchange_id to session_history
+
+Per-turn UUID used to join KPI and history records for a single agent turn.
+
+Revision ID: b2f3a4e5c6d7
+Revises: a1e2f3c4d5b6
+Create Date: 2026-06-02 00:01:00.000000
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "b2f3a4e5c6d7"  # pragma: allowlist secret
+down_revision: Union[str, Sequence[str], None] = (
+    "a1e2f3c4d5b6"  # pragma: allowlist secret
+)
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.add_column(
+        "session_history",
+        sa.Column("exchange_id", sa.String(), nullable=True),
+    )
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_column("session_history", "exchange_id")

fred_runtime-3.5.1/fred_runtime/migrations/versions/c3d4b5a6f7e8_add_team_and_instance.py

@@ -0,0 +1,70 @@
+# Copyright Thales 2026
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""add team_id and agent_instance_id to session_history
+
+Team-scoped and managed-execution identity columns added for admin and
+retention queries.  These are nullable for backward compatibility with rows
+written before this revision.
+
+Revision ID: c3d4b5a6f7e8
+Revises: b2f3a4e5c6d7
+Create Date: 2026-06-02 00:02:00.000000
+
+"""
+
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "c3d4b5a6f7e8"  # pragma: allowlist secret
+down_revision: Union[str, Sequence[str], None] = (
+    "b2f3a4e5c6d7"  # pragma: allowlist secret
+)
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.add_column(
+        "session_history",
+        sa.Column("team_id", sa.String(), nullable=True),
+    )
+    op.add_column(
+        "session_history",
+        sa.Column("agent_instance_id", sa.String(), nullable=True),
+    )
+    op.create_index(
+        "ix_session_history_team_id",
+        "session_history",
+        ["team_id"],
+        unique=False,
+    )
+    op.create_index(
+        "ix_session_history_agent_instance_id",
+        "session_history",
+        ["agent_instance_id"],
+        unique=False,
+    )
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_index("ix_session_history_agent_instance_id", table_name="session_history")
+    op.drop_index("ix_session_history_team_id", table_name="session_history")
+    op.drop_column("session_history", "agent_instance_id")
+    op.drop_column("session_history", "team_id")

{fred_runtime-3.5.0 → fred_runtime-3.5.1}/fred_runtime.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fred-runtime
-Version: 3.5.0
+Version: 3.5.1
 Summary: Runtime adapters and infrastructure wiring for Fred v2 agents.
 Author-email: Thales <noreply@thalesgroup.com>
 License: Apache-2.0

{fred_runtime-3.5.0 → fred_runtime-3.5.1}/fred_runtime.egg-info/SOURCES.txt

@@ -3,7 +3,6 @@ pyproject.toml
 fred_runtime/__init__.py
 fred_runtime/__main__.py
 fred_runtime/client.py
-fred_runtime/migrations.py
 fred_runtime/runtime_context.py
 fred_runtime.egg-info/PKG-INFO
 fred_runtime.egg-info/SOURCES.txt
@@ -85,6 +84,13 @@ fred_runtime/integrations/kf_vector_search/__init__.py
 fred_runtime/integrations/kf_vector_search/toolkit.py
 fred_runtime/integrations/v2_runtime/__init__.py
 fred_runtime/integrations/v2_runtime/adapters.py
+fred_runtime/migrations/__init__.py
+fred_runtime/migrations/env.py
+fred_runtime/migrations/script.py.mako
+fred_runtime/migrations/versions/__init__.py
+fred_runtime/migrations/versions/a1e2f3c4d5b6_create_session_history.py
+fred_runtime/migrations/versions/b2f3a4e5c6d7_add_exchange_id.py
+fred_runtime/migrations/versions/c3d4b5a6f7e8_add_team_and_instance.py
 fred_runtime/model_routing/__init__.py
 fred_runtime/model_routing/authz.py
 fred_runtime/model_routing/catalog.py
@@ -167,6 +173,7 @@ tests/test_kpi_display.py
 tests/test_langfuse_tracing.py
 tests/test_langgraph_interrupt_id_semantics.py
 tests/test_mcp_config.py
+tests/test_migrations.py
 tests/test_model_enforcement.py
 tests/test_model_metadata_cache_tokens.py
 tests/test_model_reasoning_enablement.py

{fred_runtime-3.5.0 → fred_runtime-3.5.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fred-runtime"
-version = "3.5.0"
+version = "3.5.1"
 description = "Runtime adapters and infrastructure wiring for Fred v2 agents."
 readme = "README.md"
 requires-python = ">=3.12,<3.13"
@@ -91,6 +91,9 @@ build-backend = "setuptools.build_meta"
 [tool.setuptools.packages.find]
 include = ["fred_runtime*"]
 
+[tool.setuptools.package-data]
+fred_runtime = ["migrations/*.mako"]
+
 [tool.pytest.ini_options]
 minversion = "8.0"
 addopts = "-ra"
@@ -128,4 +131,4 @@ dev = [
 ]
 
 [tool.alembic]
-script_location = "%(here)s/alembic"
+script_location = "%(here)s/fred_runtime/migrations"

fred_runtime-3.5.1/tests/test_migrations.py

@@ -0,0 +1,80 @@
+# Copyright Thales 2026
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+import sqlite3
+from pathlib import Path
+
+import fred_runtime
+from alembic.config import Config
+from alembic.script import ScriptDirectory
+from fred_runtime.migrations import RUNTIME_ALEMBIC_DIR, upgrade_sqlite_database
+
+
+def test_runtime_migration_tree_is_packaged_and_linear() -> None:
+    """Verify discovery uses the package tree and preserves its revision chain."""
+    package_dir = Path(fred_runtime.__file__).resolve().parent
+    project_dir = Path(__file__).resolve().parents[1]
+    assert RUNTIME_ALEMBIC_DIR == package_dir / "migrations"
+    assert RUNTIME_ALEMBIC_DIR.is_dir()
+    assert (RUNTIME_ALEMBIC_DIR / "env.py").is_file()
+    assert (RUNTIME_ALEMBIC_DIR / "script.py.mako").is_file()
+    assert {path.name for path in (RUNTIME_ALEMBIC_DIR / "versions").glob("*.py")} == {
+        "__init__.py",
+        "a1e2f3c4d5b6_create_session_history.py",  # pragma: allowlist secret
+        "b2f3a4e5c6d7_add_exchange_id.py",  # pragma: allowlist secret
+        "c3d4b5a6f7e8_add_team_and_instance.py",  # pragma: allowlist secret
+    }
+
+    config = Config()
+    config.set_main_option("script_location", str(RUNTIME_ALEMBIC_DIR))
+    revisions = list(ScriptDirectory.from_config(config).walk_revisions(base="base"))
+
+    assert [(revision.revision, revision.down_revision) for revision in revisions] == [
+        ("c3d4b5a6f7e8", "b2f3a4e5c6d7"),  # pragma: allowlist secret
+        ("b2f3a4e5c6d7", "a1e2f3c4d5b6"),  # pragma: allowlist secret
+        ("a1e2f3c4d5b6", None),  # pragma: allowlist secret
+    ]
+    assert not (project_dir / "alembic").exists()
+
+
+def test_upgrade_sqlite_database_applies_packaged_migrations(tmp_path: Path) -> None:
+    """Run the packaged tree against SQLite and verify its schema reaches head."""
+    database_path = tmp_path / "runtime.db"
+
+    upgrade_sqlite_database(database_path)
+
+    with sqlite3.connect(database_path) as connection:
+        columns = {
+            row[1] for row in connection.execute("PRAGMA table_info(session_history)")
+        }
+        revision = connection.execute(
+            "SELECT version_num FROM alembic_version_runtime"
+        ).fetchone()
+
+    assert columns == {
+        "session_id",
+        "user_id",
+        "rank",
+        "timestamp",
+        "role",
+        "channel",
+        "parts_json",
+        "metadata_json",
+        "exchange_id",
+        "team_id",
+        "agent_instance_id",
+    }
+    assert revision == ("c3d4b5a6f7e8",)  # pragma: allowlist secret