flwr-nightly 1.26.0.dev20260116__tar.gz → 1.26.0.dev20260117__tar.gz

{flwr_nightly-1.26.0.dev20260116 → flwr_nightly-1.26.0.dev20260117}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: flwr-nightly
-Version: 1.26.0.dev20260116
+Version: 1.26.0.dev20260117
 Summary: Flower: A Friendly Federated AI Framework
 License: Apache-2.0
 Keywords: Artificial Intelligence,Federated AI,Federated Analytics,Federated Evaluation,Federated Learning,Flower,Machine Learning

flwr_nightly-1.26.0.dev20260117/py/flwr/supercore/state/schema/README.md

@@ -0,0 +1,125 @@
+# State Entity Relationship Diagram
+
+## Schema
+
+```mermaid
+
+---
+    config:
+        layout: elk
+---
+erDiagram
+  context {
+    INTEGER run_id FK "nullable"
+    BLOB context "nullable"
+  }
+
+  logs {
+    INTEGER run_id FK "nullable"
+    VARCHAR log "nullable"
+    INTEGER node_id "nullable"
+    FLOAT timestamp "nullable"
+  }
+
+  message_ins {
+    INTEGER run_id FK "nullable"
+    BLOB content "nullable"
+    FLOAT created_at "nullable"
+    VARCHAR delivered_at "nullable"
+    INTEGER dst_node_id "nullable"
+    BLOB error "nullable"
+    VARCHAR group_id "nullable"
+    VARCHAR message_id UK "nullable"
+    VARCHAR message_type "nullable"
+    VARCHAR reply_to_message_id "nullable"
+    INTEGER src_node_id "nullable"
+    FLOAT ttl "nullable"
+  }
+
+  message_res {
+    INTEGER run_id FK "nullable"
+    BLOB content "nullable"
+    FLOAT created_at "nullable"
+    VARCHAR delivered_at "nullable"
+    INTEGER dst_node_id "nullable"
+    BLOB error "nullable"
+    VARCHAR group_id "nullable"
+    VARCHAR message_id UK "nullable"
+    VARCHAR message_type "nullable"
+    VARCHAR reply_to_message_id "nullable"
+    INTEGER src_node_id "nullable"
+    FLOAT ttl "nullable"
+  }
+
+  node {
+    FLOAT heartbeat_interval "nullable"
+    VARCHAR last_activated_at "nullable"
+    VARCHAR last_deactivated_at "nullable"
+    INTEGER node_id UK "nullable"
+    TIMESTAMP online_until "nullable"
+    VARCHAR owner_aid "nullable"
+    VARCHAR owner_name "nullable"
+    BLOB public_key UK "nullable"
+    VARCHAR registered_at "nullable"
+    VARCHAR status "nullable"
+    VARCHAR unregistered_at "nullable"
+  }
+
+  object_children {
+    VARCHAR child_id PK,FK
+    VARCHAR parent_id PK,FK
+  }
+
+  objects {
+    VARCHAR object_id PK "nullable"
+    BLOB content "nullable"
+    INTEGER is_available
+    INTEGER ref_count
+  }
+
+<<<<<<< HEAD
+  run {
+    INTEGER bytes_recv "nullable"
+    INTEGER bytes_sent "nullable"
+    FLOAT clientapp_runtime "nullable"
+    VARCHAR details "nullable"
+    VARCHAR fab_hash "nullable"
+    VARCHAR fab_id "nullable"
+    VARCHAR fab_version "nullable"
+    VARCHAR federation "nullable"
+    BLOB federation_options "nullable"
+    VARCHAR finished_at "nullable"
+    VARCHAR flwr_aid "nullable"
+    VARCHAR override_config "nullable"
+    VARCHAR pending_at "nullable"
+    INTEGER run_id UK "nullable"
+    VARCHAR running_at "nullable"
+    VARCHAR starting_at "nullable"
+    VARCHAR sub_status "nullable"
+  }
+
+=======
+>>>>>>> main
+  run_objects {
+    VARCHAR object_id PK,FK
+    INTEGER run_id PK
+  }
+
+  token_store {
+    INTEGER run_id PK "nullable"
+    FLOAT active_until "nullable"
+    VARCHAR token UK
+  }
+
+<<<<<<< HEAD
+  run ||--o| context : run_id
+  run ||--o{ logs : run_id
+  run ||--o{ message_ins : run_id
+  run ||--o{ message_res : run_id
+=======
+>>>>>>> main
+  objects ||--o| object_children : parent_id
+  objects ||--o| object_children : child_id
+  objects ||--o| run_objects : object_id
+
+```

{flwr_nightly-1.26.0.dev20260116 → flwr_nightly-1.26.0.dev20260117}/py/flwr/supercore/state/schema/corestate_tables.py

@@ -14,6 +14,7 @@
 # ==============================================================================
 """SQLAlchemy Core Table definitions for CoreState."""
 
+
 from sqlalchemy import Column, Float, Integer, MetaData, String, Table
 
 corestate_metadata = MetaData()

flwr_nightly-1.26.0.dev20260117/py/flwr/supercore/state/schema/linkstate_tables.py

@@ -0,0 +1,152 @@
+# Copyright 2026 Flower Labs GmbH. All Rights Reserved.
+#
+# 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.
+# ==============================================================================
+"""SQLAlchemy Core Table definitions for LinkState."""
+
+
+from sqlalchemy import (
+    TIMESTAMP,
+    Column,
+    Float,
+    ForeignKey,
+    Index,
+    Integer,
+    LargeBinary,
+    MetaData,
+    String,
+    Table,
+    UniqueConstraint,
+)
+
+linkstate_metadata = MetaData()
+
+# ------------------------------------------------------------------------------
+#  Table: node
+# ------------------------------------------------------------------------------
+node = Table(
+    "node",
+    linkstate_metadata,
+    Column("node_id", Integer, unique=True),
+    Column("owner_aid", String),
+    Column("owner_name", String),
+    Column("status", String),
+    Column("registered_at", String),
+    Column("last_activated_at", String, nullable=True),
+    Column("last_deactivated_at", String, nullable=True),
+    Column("unregistered_at", String, nullable=True),
+    Column("online_until", TIMESTAMP, nullable=True),
+    Column("heartbeat_interval", Float),
+    Column("public_key", LargeBinary, unique=True),
+    # Indexes
+    # Used in delete_node and get_node_info (security/filtering)
+    Index("idx_node_owner_aid", "owner_aid"),
+    # Used in get_nodes and activation checks (frequent filtering)
+    Index("idx_node_status", "status"),
+    # Used in heartbeat checks to efficiently find expired nodes
+    Index("idx_online_until", "online_until"),
+)
+
+
+# ------------------------------------------------------------------------------
+#  Table: run
+# ------------------------------------------------------------------------------
+run = Table(
+    "run",
+    linkstate_metadata,
+    Column("run_id", Integer, unique=True),
+    Column("fab_id", String),
+    Column("fab_version", String),
+    Column("fab_hash", String),
+    Column("override_config", String),
+    Column("pending_at", String),
+    Column("starting_at", String),
+    Column("running_at", String),
+    Column("finished_at", String),
+    Column("sub_status", String),
+    Column("details", String),
+    Column("federation", String),
+    Column("federation_options", LargeBinary),
+    Column("flwr_aid", String),
+    Column("bytes_sent", Integer, server_default="0"),
+    Column("bytes_recv", Integer, server_default="0"),
+    Column("clientapp_runtime", Float, server_default="0.0"),
+)
+
+
+# ------------------------------------------------------------------------------
+#  Table: logs
+# ------------------------------------------------------------------------------
+logs = Table(
+    "logs",
+    linkstate_metadata,
+    Column("timestamp", Float),
+    Column("run_id", Integer, ForeignKey("run.run_id")),
+    Column("node_id", Integer),
+    Column("log", String),
+    # Composite PK
+    UniqueConstraint("timestamp", "run_id", "node_id"),
+)
+
+
+# ------------------------------------------------------------------------------
+#  Table: context
+# ------------------------------------------------------------------------------
+context = Table(
+    "context",
+    linkstate_metadata,
+    Column("run_id", Integer, ForeignKey("run.run_id"), unique=True),
+    Column("context", LargeBinary),
+)
+
+
+# ------------------------------------------------------------------------------
+#  Table: message_ins
+# ------------------------------------------------------------------------------
+message_ins = Table(
+    "message_ins",
+    linkstate_metadata,
+    Column("message_id", String, unique=True),
+    Column("group_id", String),
+    Column("run_id", Integer, ForeignKey("run.run_id")),
+    Column("src_node_id", Integer),
+    Column("dst_node_id", Integer),
+    Column("reply_to_message_id", String),
+    Column("created_at", Float),
+    Column("delivered_at", String),
+    Column("ttl", Float),
+    Column("message_type", String),
+    Column("content", LargeBinary, nullable=True),
+    Column("error", LargeBinary, nullable=True),
+)
+
+
+# ------------------------------------------------------------------------------
+#  Table: message_res
+# ------------------------------------------------------------------------------
+message_res = Table(
+    "message_res",
+    linkstate_metadata,
+    Column("message_id", String, unique=True),
+    Column("group_id", String),
+    Column("run_id", Integer, ForeignKey("run.run_id")),
+    Column("src_node_id", Integer),
+    Column("dst_node_id", Integer),
+    Column("reply_to_message_id", String),
+    Column("created_at", Float),
+    Column("delivered_at", String),
+    Column("ttl", Float),
+    Column("message_type", String),
+    Column("content", LargeBinary, nullable=True),
+    Column("error", LargeBinary, nullable=True),
+)

{flwr_nightly-1.26.0.dev20260116 → flwr_nightly-1.26.0.dev20260117}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "flwr-nightly"
-version = "1.26.0.dev20260116"
+version = "1.26.0.dev20260117"
 description = "Flower: A Friendly Federated AI Framework"
 license = "Apache-2.0"
 authors = ["The Flower Authors <hello@flower.ai>"]

flwr_nightly-1.26.0.dev20260116/py/flwr/supercore/state/schema/README.md

@@ -1,39 +0,0 @@
-# State Entity Relationship Diagram
-
-## Schema
-
-```mermaid
-
----
-    config:
-        layout: elk
----
-erDiagram
-  object_children {
-    VARCHAR child_id PK,FK
-    VARCHAR parent_id PK,FK
-  }
-
-  objects {
-    VARCHAR object_id PK "nullable"
-    BLOB content "nullable"
-    INTEGER is_available
-    INTEGER ref_count
-  }
-
-  run_objects {
-    VARCHAR object_id PK,FK
-    INTEGER run_id PK
-  }
-
-  token_store {
-    INTEGER run_id PK "nullable"
-    FLOAT active_until "nullable"
-    VARCHAR token UK
-  }
-
-  objects ||--o| object_children : parent_id
-  objects ||--o| object_children : child_id
-  objects ||--o| run_objects : object_id
-
-```