by-framework 0.2.2.dev6__tar.gz → 0.2.2.dev8__tar.gz

by_framework-0.2.2.dev8/.dockerignore

@@ -0,0 +1,18 @@
+.git
+.github
+.pytest_cache
+.ruff_cache
+.mypy_cache
+**/__pycache__
+**/*.py[cod]
+**/.pytest_cache
+**/.ruff_cache
+**/.mypy_cache
+**/node_modules
+**/dist
+**/build
+**/*.egg-info
+.venv
+venv
+htmlcov
+by-framework.log

{by_framework-0.2.2.dev6 → by_framework-0.2.2.dev8}/.github/workflows/publish.yml

@@ -15,6 +15,7 @@ on:
 
 permissions:
   contents: write
+  packages: write
   pull-requests: write
 
 jobs:
@@ -153,6 +154,43 @@ jobs:
         with:
           packages-dir: dist/
 
+  publish-dashboard-image:
+    runs-on: ubuntu-latest
+    needs:
+      - resolve-package
+      - build
+      - publish
+    if: needs.resolve-package.outputs.package_name == 'by-framework-dashboard'
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Resolve image name
+        id: image
+        shell: bash
+        run: |
+          echo "name=ghcr.io/${GITHUB_REPOSITORY_OWNER,,}/by-framework-dashboard" >> "$GITHUB_OUTPUT"
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Build and publish dashboard image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: libs/by-framework-dashboard/Dockerfile
+          push: true
+          tags: |
+            ${{ steps.image.outputs.name }}:${{ needs.resolve-package.outputs.version }}
+            ${{ steps.image.outputs.name }}:latest
+          labels: |
+            org.opencontainers.image.source=${{ github.server_url }}/${{ github.repository }}
+            org.opencontainers.image.version=${{ needs.resolve-package.outputs.version }}
+            org.opencontainers.image.title=by-framework-dashboard
+
   post-release:
     runs-on: ubuntu-latest
     needs:

{by_framework-0.2.2.dev6 → by_framework-0.2.2.dev8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: by-framework
-Version: 0.2.2.dev6
+Version: 0.2.2.dev8
 Summary: 分布式 Agent 调度框架
 License-File: LICENSE
 Requires-Python: >=3.12

by_framework-0.2.2.dev8/libs/by-framework-dashboard/Dockerfile

@@ -0,0 +1,40 @@
+# syntax=docker/dockerfile:1
+
+FROM node:22-bookworm-slim AS frontend
+
+WORKDIR /app/libs/by-framework-dashboard/frontend
+COPY libs/by-framework-dashboard/frontend/package*.json ./
+RUN npm ci --no-audit --progress=false
+COPY libs/by-framework-dashboard/frontend/ ./
+RUN npm run build
+
+FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim AS runtime
+
+ENV PYTHONUNBUFFERED=1 \
+    UV_NO_CACHE=1 \
+    PATH="/opt/venv/bin:${PATH}"
+
+WORKDIR /app
+
+COPY pyproject.toml uv.lock README.md ./
+COPY src ./src
+COPY libs/by-framework-dashboard ./libs/by-framework-dashboard
+COPY libs/by-framework-trace-query ./libs/by-framework-trace-query
+COPY --from=frontend /app/libs/by-framework-dashboard/src/by_framework_dashboard/static/ ./libs/by-framework-dashboard/src/by_framework_dashboard/static/
+
+RUN uv venv /opt/venv \
+    && uv build --wheel --project . --out-dir /tmp/wheels \
+    && uv build --wheel --project libs/by-framework-trace-query --out-dir /tmp/wheels \
+    && uv build --wheel --project libs/by-framework-dashboard --out-dir /tmp/wheels \
+    && uv pip install --python /opt/venv/bin/python \
+        /tmp/wheels/by_framework-*.whl \
+        /tmp/wheels/by_framework_trace_query-*.whl \
+        /tmp/wheels/by_framework_dashboard-*.whl \
+    && rm -rf /tmp/wheels
+
+EXPOSE 8765
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+    CMD python -c "import json, urllib.request; response = urllib.request.urlopen('http://127.0.0.1:8765/api/health', timeout=3); json.load(response)"
+
+CMD ["by-framework-dashboard", "--host", "0.0.0.0", "--port", "8765"]

{by_framework-0.2.2.dev6 → by_framework-0.2.2.dev8}/libs/by-framework-dashboard/README.md

@@ -19,6 +19,29 @@ Then open:
 http://127.0.0.1:8765
 ```
 
+## Container Image
+
+Dashboard release tags also publish a GHCR image:
+
+```text
+ghcr.io/<owner>/by-framework-dashboard:<version>
+```
+
+For example, pushing `by-framework-dashboard-v0.1.0` builds and publishes:
+
+```text
+ghcr.io/<owner>/by-framework-dashboard:0.1.0
+ghcr.io/<owner>/by-framework-dashboard:latest
+```
+
+To run the image:
+
+```bash
+docker run --rm -p 8765:8765 \
+  -e REDIS_HOST=host.docker.internal \
+  ghcr.io/<owner>/by-framework-dashboard:0.1.0
+```
+
 For demo data without a live Redis cluster:
 
 ```text

{by_framework-0.2.2.dev6 → by_framework-0.2.2.dev8}/libs/by-framework-dashboard/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "by-framework-dashboard"
-version = "0.1.0"
+version = "0.1.1.dev0"
 description = "Dashboard UI and HTTP server for by-framework observability"
 requires-python = ">=3.12"
 dependencies = [

{by_framework-0.2.2.dev6 → by_framework-0.2.2.dev8}/libs/by-framework-langgraph/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "by-framework-langgraph"
-version = "0.0.3.dev3"
+version = "0.0.3.dev4"
 description = "LangGraph integration for by-framework"
 readme = "README.md"
 requires-python = ">=3.12"

{by_framework-0.2.2.dev6 → by_framework-0.2.2.dev8}/libs/by-framework-trace-langfuse/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "by-framework-trace-langfuse"
-version = "0.0.3.dev3"
+version = "0.0.3.dev4"
 description = "Langfuse trace provider for by-framework"
 readme = "README.md"
 requires-python = ">=3.12"

{by_framework-0.2.2.dev6 → by_framework-0.2.2.dev8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "by-framework"
-version = "0.2.2.dev6"
+version = "0.2.2.dev8"
 description = "分布式 Agent 调度框架"
 readme = "README.md"
 requires-python = ">=3.12"

{by_framework-0.2.2.dev6 → by_framework-0.2.2.dev8}/src/by_framework/admin/cli.py

@@ -13,7 +13,8 @@ from rich.console import Console
 from rich.table import Table
 
 from by_framework.admin.worker_manager import WorkerManager
-from by_framework.common.redis_client import init_redis_from_url
+from by_framework.common.config import RedisConfig
+from by_framework.common.redis_client import init_redis, init_redis_from_url
 from by_framework.core.registry import WorkerRegistry
 from by_framework.metrics.snapshot import (
     build_observability_snapshot,
@@ -27,7 +28,12 @@ from by_framework.metrics.snapshot import (
 app = typer.Typer(
     name="by-admin",
     no_args_is_help=True,
-    help="by-framework cluster admin CLI",
+    help=(
+        "by-framework cluster admin CLI. For Redis Cluster, omit --redis-url "
+        "and set REDIS_CLUSTER_HOST (comma-separated host:port list; implies "
+        "cluster mode) and REDIS_KEY_SCHEMA_VERSION=v2. REDIS_MODE=cluster + "
+        "REDIS_CLUSTER_NODES also still works."
+    ),
 )
 worker_app = typer.Typer(no_args_is_help=True)
 type_app = typer.Typer(no_args_is_help=True)
@@ -43,7 +49,8 @@ app.add_typer(metrics_app, name="metrics", help="Metrics and observability")
 
 console = Console()
 err_console = Console(stderr=True)
-_redis_url = "redis://localhost:6379/0"
+_DEFAULT_REDIS_URL = "redis://localhost:6379/0"
+_redis_url: Optional[str] = None
 
 
 @app.callback()
@@ -52,13 +59,16 @@ def _global(
         None,
         "--redis-url",
         envvar=["BYAI_REDIS_URL", "REDIS_URL"],
-        help="Redis connection URL  [env: BYAI_REDIS_URL]",
+        help=(
+            "Standalone Redis connection URL [env: BYAI_REDIS_URL]. "
+            "For Redis Cluster, omit this and set REDIS_CLUSTER_HOST "
+            "(comma-separated host:port list)."
+        ),
     ),
 ):
     """by-framework cluster admin CLI."""
     global _redis_url
-    if redis_url:
-        _redis_url = redis_url
+    _redis_url = redis_url
 
 
 def _run(coro):  # type: ignore[no-untyped-def]
@@ -70,8 +80,14 @@ def _die(msg: str, code: int = 1) -> None:
     raise typer.Exit(code)
 
 
-def _get_redis():
-    return init_redis_from_url(_redis_url)
+def _get_redis(redis_url: Optional[str] = None):
+    configured_url = redis_url if redis_url is not None else _redis_url
+    if configured_url:
+        return init_redis_from_url(configured_url)
+    config = RedisConfig.from_env()
+    if config.mode == "cluster":
+        return init_redis(config=config)
+    return init_redis_from_url(_DEFAULT_REDIS_URL)
 
 
 # --------------------------------------------------------------------------- #

{by_framework-0.2.2.dev6 → by_framework-0.2.2.dev8}/src/by_framework/common/config.py

@@ -6,7 +6,7 @@ Provides typed configuration loaded from environment variables.
 
 import os
 from dataclasses import dataclass, field
-from typing import Optional
+from typing import Literal, Optional
 
 from by_framework.common.constants import RedisKeys
 
@@ -22,13 +22,35 @@ class RedisConfig:
     username: Optional[str] = None
     decode_responses: bool = True
     max_connections: Optional[int] = None
+    mode: Literal["standalone", "cluster"] = "standalone"
+    cluster_nodes: Optional[list[tuple[str, int]]] = None
+    socket_connect_timeout: int = 5
+    socket_timeout: int = 10
 
     @classmethod
     def from_env(cls) -> "RedisConfig":
-        """Load Redis configuration from environment variables."""
+        """Load Redis configuration from environment variables.
+
+        REDIS_CLUSTER_HOST (comma-separated "host:port" list) is the
+        preferred way to configure Cluster mode: just setting it is enough
+        to switch to cluster mode, no separate REDIS_MODE=cluster needed.
+        An explicit REDIS_MODE still takes precedence when set, so existing
+        explicit REDIS_MODE=cluster + REDIS_CLUSTER_NODES setups keep working.
+        """
         password = os.environ.get("REDIS_PASSWORD", "")
         username = os.environ.get("REDIS_USERNAME") or None
         max_connections = os.environ.get("REDIS_MAX_CONNECTIONS")
+        cluster_host_str = os.environ.get("REDIS_CLUSTER_HOST")
+        cluster_nodes_str = cluster_host_str or os.environ.get("REDIS_CLUSTER_NODES")
+        mode = os.environ.get("REDIS_MODE") or (
+            "cluster" if cluster_host_str else "standalone"
+        )
+        cluster_nodes = None
+        if cluster_nodes_str:
+            cluster_nodes = []
+            for node in cluster_nodes_str.split(","):
+                node_host, node_port = node.rsplit(":", 1)
+                cluster_nodes.append((node_host, int(node_port)))
         return cls(
             host=os.environ.get("REDIS_HOST", "localhost"),
             port=int(os.environ.get("REDIS_PORT", "6379")),
@@ -36,6 +58,8 @@ class RedisConfig:
             password=password,
             username=username,
             max_connections=int(max_connections) if max_connections else None,
+            mode=mode,
+            cluster_nodes=cluster_nodes,
         )