flock-core 0.5.0b28__py3-none-any.whl → 0.5.56b0__py3-none-any.whl

flock/subscription.py

@@ -0,0 +1,111 @@
+"""Agent subscription declarations and helpers."""
+
+from __future__ import annotations
+
+from collections.abc import Callable, Iterable, Sequence
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, Any
+
+from pydantic import BaseModel
+
+from flock.registry import type_registry
+
+
+if TYPE_CHECKING:
+    from flock.artifacts import Artifact
+
+
+Predicate = Callable[[BaseModel], bool]
+
+
+@dataclass
+class TextPredicate:
+    text: str
+    min_p: float = 0.0
+
+
+@dataclass
+class JoinSpec:
+    kind: str
+    window: float
+    by: Callable[[Artifact], Any] | None = None
+
+
+@dataclass
+class BatchSpec:
+    size: int
+    within: float
+    by: Callable[[Artifact], Any] | None = None
+
+
+class Subscription:
+    """Defines how an agent consumes artifacts from the blackboard."""
+
+    def __init__(
+        self,
+        *,
+        agent_name: str,
+        types: Sequence[type[BaseModel]],
+        where: Sequence[Predicate] | None = None,
+        text_predicates: Sequence[TextPredicate] | None = None,
+        from_agents: Iterable[str] | None = None,
+        channels: Iterable[str] | None = None,
+        join: JoinSpec | None = None,
+        batch: BatchSpec | None = None,
+        delivery: str = "exclusive",
+        mode: str = "both",
+        priority: int = 0,
+    ) -> None:
+        if not types:
+            raise ValueError("Subscription must declare at least one type.")
+        self.agent_name = agent_name
+        self.type_models: list[type[BaseModel]] = list(types)
+        self.type_names: set[str] = {type_registry.register(t) for t in types}
+        self.where = list(where or [])
+        self.text_predicates = list(text_predicates or [])
+        self.from_agents = set(from_agents or [])
+        self.channels = set(channels or [])
+        self.join = join
+        self.batch = batch
+        self.delivery = delivery
+        self.mode = mode
+        self.priority = priority
+
+    def accepts_direct(self) -> bool:
+        return self.mode in {"direct", "both"}
+
+    def accepts_events(self) -> bool:
+        return self.mode in {"events", "both"}
+
+    def matches(self, artifact: Artifact) -> bool:
+        if artifact.type not in self.type_names:
+            return False
+        if self.from_agents and artifact.produced_by not in self.from_agents:
+            return False
+        if self.channels and not artifact.tags.intersection(self.channels):
+            return False
+
+        # Evaluate where predicates on typed payloads
+        model_cls = type_registry.resolve(artifact.type)
+        payload = model_cls(**artifact.payload)
+        for predicate in self.where:
+            try:
+                if not predicate(payload):
+                    return False
+            except Exception:
+                return False
+        return True
+
+    def __repr__(self) -> str:  # pragma: no cover - debug helper
+        return (
+            f"Subscription(agent={self.agent_name!r}, types={list(self.type_names)!r}, "
+            f"delivery={self.delivery!r}, mode={self.mode!r})"
+        )
+
+
+__all__ = [
+    "BatchSpec",
+    "JoinSpec",
+    "Subscription",
+    "TextPredicate",
+]

flock/themes/andromeda.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "ROUNDED"
 panel_padding = [ 2, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/apple-system-colors.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "SQUARE"
 panel_padding = [ 2, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/arcoiris.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 0, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/atomonelight.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "MINIMAL"
 panel_padding = [ 1, 1,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/ayu copy.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 1, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/ayu-light.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "MINIMAL"
 panel_padding = [ 0, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/belafonte-day.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "SQUARE"
 panel_padding = [ 1, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/belafonte-night.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "SQUARE"
 panel_padding = [ 1, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/blulocodark.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "ROUNDED"
 panel_padding = [ 1, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/breeze.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 1, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/broadcast.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 1, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/brogrammer.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 1, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/builtin-dark.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "MINIMAL"
 panel_padding = [ 1, 1,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/builtin-pastel-dark.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 0, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/catppuccin-latte.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "ROUNDED"
 panel_padding = [ 0, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/catppuccin-macchiato.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "SIMPLE"
 panel_padding = [ 2, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/catppuccin-mocha.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "MINIMAL"
 panel_padding = [ 1, 1,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/cga.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "HEAVY"
 panel_padding = [ 1, 1,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/chalk.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "SQUARE"
 panel_padding = [ 1, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/ciapre.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "SIMPLE"
 panel_padding = [ 1, 1,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/coffee-theme.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "SQUARE"
 panel_padding = [ 1, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/cyberpunkscarletprotocol.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "HEAVY"
 panel_padding = [ 0, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/dark+.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "SIMPLE"
 panel_padding = [ 0, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/darkermatrix.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "SIMPLE"
 panel_padding = [ 2, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/darkside.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "ROUNDED"
 panel_padding = [ 1, 1,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/desert.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "ROUNDED"
 panel_padding = [ 0, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/django.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "MINIMAL"
 panel_padding = [ 1, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/djangosmooth.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "HEAVY"
 panel_padding = [ 1, 1,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/doomone.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "ROUNDED"
 panel_padding = [ 1, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/dotgov.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 1, 1,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/dracula+.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "HEAVY"
 panel_padding = [ 2, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/duckbones.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 0, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/encom.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "SQUARE"
 panel_padding = [ 0, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/espresso.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "SIMPLE"
 panel_padding = [ 1, 1,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/everblush.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 1, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/fairyfloss.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "ROUNDED"
 panel_padding = [ 2, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/fideloper.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "HEAVY"
 panel_padding = [ 1, 1,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/fishtank.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "MINIMAL"
 panel_padding = [ 0, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/flexoki-light.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "SQUARE"
 panel_padding = [ 0, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/floraverse.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "HEAVY"
 panel_padding = [ 1, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/framer.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "SIMPLE"
 panel_padding = [ 0, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/galizur.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "HEAVY"
 panel_padding = [ 2, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/github.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "SIMPLE"
 panel_padding = [ 2, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/grass.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 2, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/grey-green.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "HEAVY"
 panel_padding = [ 2, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/gruvboxlight.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "MINIMAL"
 panel_padding = [ 0, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/guezwhoz.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "ROUNDED"
 panel_padding = [ 1, 1,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/harper.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 2, 2,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/hax0r-blue.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "SIMPLE"
 panel_padding = [ 0, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/hopscotch.256.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "SIMPLE"
 panel_padding = [ 1, 1,]
 panel_title_align = "center"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/ic-green-ppl.toml

@@ -28,7 +28,7 @@ table_show_lines = true
 table_box = "DOUBLE_EDGE"
 panel_padding = [ 0, 2,]
 panel_title_align = "right"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false

flock/themes/iceberg-dark.toml

@@ -28,7 +28,7 @@ table_show_lines = false
 table_box = "SQUARE"
 panel_padding = [ 2, 2,]
 panel_title_align = "left"
-table_row_styles = [ "", "underline",]
+table_row_styles = [ "", "dim",]
 table_safe_box = true
 table_padding = [ 0, 1,]
 table_collapse_padding = false