@steerable/runtime-darwin-arm64 0.10.2 → 0.11.0

package/python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/tree.py

@@ -0,0 +1,155 @@
+"""Tree-wide addressing: any agent in one spawn tree can message another.
+
+Up to now ``agent_send`` only reached an executor's **own** children — a pool
+sees exactly the loops it built. That makes collaboration strictly downward:
+a sibling, or the parent itself, is unaddressable no matter how the parent
+choreographed the work. Real "split this refactor across four agents" needs
+the other direction: an implementer telling the researcher what it found, a
+reviewer asking the implementer why a test changed, a worker reporting to the
+agent that spawned it.
+
+This module is the addressing layer for that. One ``AgentTree`` per root turn
+holds every addressable member, and each member is registered by the executor
+that **owns** it — the only thing that can steer or resume it. So ``send``
+resolves a lineage id across the whole tree and then delegates to that owner;
+nothing here pokes at another agent's loop directly.
+
+Why an explicit tree instead of "walk up and ask": resume is a parent
+operation (only the owning pool holds the loop, its schemas and its budget
+line), so a peer message must arrive at the owner anyway. Holding the owner's
+delivery callback at registration makes that one hop instead of a recursive
+search that could deadlock against a parent waiting on its child.
+"""
+
+from __future__ import annotations
+
+import logging
+from collections.abc import Awaitable, Callable
+from dataclasses import dataclass
+
+__all__ = ["AgentTree", "TreeMember"]
+
+logger = logging.getLogger(__name__)
+
+#: Delivers a message to one member, returning the same ``steered`` /
+#: ``resumed`` / ``error:*`` vocabulary ``AgentPool.send`` already uses. The
+#: owner decides what a message means for its agent (steer while running,
+#: resume when settled); the tree does not know.
+Deliver = Callable[[str], Awaitable[str]]
+
+
+@dataclass(frozen=True, slots=True)
+class TreeMember:
+    """One addressable agent.
+
+    ``lineage`` is the tree id (``0`` is the root, ``0.2.1`` a grandchild), so
+    a sender can name any relative: ``0`` for the agent that started
+    everything, ``0.1`` for a sibling, ``0.2.1`` for a grandchild.
+    """
+
+    lineage: str
+    depth: int
+    parent: str | None
+    profile: str | None = None
+
+    def to_wire(self) -> dict[str, object]:
+        """Camel-case payload for a tool result."""
+        return {
+            "childId": self.lineage,
+            "depth": self.depth,
+            **({"parentId": self.parent} if self.parent is not None else {}),
+            **({"profile": self.profile} if self.profile else {}),
+        }
+
+
+class AgentTree:
+    """Every addressable member of one spawn tree.
+
+    Registration is the authorization: an agent is reachable exactly while its
+    owner keeps it registered, so closing a child unregisters it and the
+    address stops resolving. There is no separate permission table to drift.
+
+    The root registers itself through ``register_root``; every other member
+    registers at spawn. Membership is scoped to the tree object, which is why
+    a message cannot escape into an unrelated conversation's agents.
+    """
+
+    def __init__(self) -> None:
+        self._deliver: dict[str, Deliver] = {}
+        self._members: dict[str, TreeMember] = {}
+
+    # -- registration --------------------------------------------------
+
+    def register_root(self, deliver: Deliver) -> TreeMember:
+        """Make the root agent (``0``) addressable.
+
+        Children need this to report to whoever spawned them — without it the
+        only upward channel is the completion notice, which carries a status
+        and no reply path.
+        """
+        return self._register(TreeMember(lineage="0", depth=0, parent=None), deliver)
+
+    def register(self, member: TreeMember, deliver: Deliver) -> TreeMember:
+        """Make one child addressable for as long as its owner keeps it so."""
+        return self._register(member, deliver)
+
+    def _register(self, member: TreeMember, deliver: Deliver) -> TreeMember:
+        self._members[member.lineage] = member
+        self._deliver[member.lineage] = deliver
+        return member
+
+    def unregister(self, lineage: str) -> None:
+        """Stop resolving one address; a later send reports it as unknown."""
+        self._members.pop(lineage, None)
+        self._deliver.pop(lineage, None)
+
+    # -- addressing ----------------------------------------------------
+
+    def get(self, lineage: str) -> TreeMember | None:
+        """The member at ``lineage``, or ``None`` when it is not reachable."""
+        return self._members.get(lineage)
+
+    def members(self) -> list[TreeMember]:
+        """Every reachable member, root first then in registration order."""
+        return sorted(self._members.values(), key=lambda m: (m.depth, m.lineage))
+
+    def resolve(self, sender: str, target: str) -> TreeMember | None:
+        """The member ``target`` names, if ``sender`` may address it.
+
+        Two refusals, both structural rather than policy:
+
+        - the target must be registered (an unknown or closed agent has no
+          owner to deliver to);
+        - a member cannot address itself — that is a no-op the model would
+          read as a delivered message.
+
+        Everything else is allowed on purpose. Siblings, parent and children
+        are all in one tree because one agent created the work, and a worker
+        that cannot tell a sibling what it found falls back to routing every
+        fact through the parent, which is the cost this exists to remove.
+        """
+        if target == sender:
+            return None
+        return self._members.get(target)
+
+    async def send(self, sender: str, target: str, message: str) -> str:
+        """Deliver ``message`` from ``sender`` to ``target``.
+
+        Returns the owner's delivery verdict (``steered`` / ``resumed`` /
+        ``error:*``). An unaddressable target reports ``error:unknown_member``
+        with the reachable ids, so a model that guessed a name can correct
+        itself instead of retrying the same call.
+        """
+        member = self.resolve(sender, target)
+        deliver = self._deliver.get(target)
+        if member is None or deliver is None:
+            known = ", ".join(m.lineage for m in self.members()) or "(none)"
+            return (
+                f"error:unknown_member: {target!r} is not reachable from this "
+                f"tree; reachable: {known}"
+            )
+        try:
+            return await deliver(message)
+        except Exception as exc:  # noqa: BLE001 — a peer failure is data
+            logger.warning("peer send %s -> %s failed: %s", sender, target, exc)
+            return f"error:delivery_failed: {target!r}: {exc}"

package/python-runtime/python/lib/python3.12/site-packages/{steerable_agent_runtime-0.10.2.dist-info → steerable_agent_runtime-0.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: steerable-agent-runtime
-Version: 0.10.2
+Version: 0.11.0
 Summary: Steerable agent runtime: LLM, tool, storage, and transport adapters.
 License: Apache-2.0
 Requires-Python: >=3.10
@@ -88,6 +88,37 @@ release. Nothing in the single-agent path changed.
 - **`SubagentExecutor.attach_pool()` / `.pool`** expose the shared pool so a
   host can report children's usage alongside the turn's own bill.
 
+## Upgrading from 0.10
+
+Peer messaging and a shared task board (R8). Additive on the tool surface:
+the same six orchestration tools exist, `agent_send` gained reach, and four
+board tools appear when the family is on.
+
+- **`agent_send` is tree-wide.** It used to reach only an executor's own
+  children. It now accepts any live lineage id in the turn's spawn tree — the
+  root (`0`), a sibling, a child — authorized by membership, not by a
+  permission table. Delivery still goes through the owning pool, so the
+  verdict vocabulary (`steered` / `resumed` / `error:*`) is unchanged. A
+  message to the root steers the parent loop and lands as a user turn at its
+  next round boundary.
+- **Leaf agents get `agent_send` and `agent_list`.** A child that may not
+  spawn (depth wall) or that came from `delegate_subagent` is still a member
+  of the job, so it is advertised those two tools with no `agent_spawn`. A
+  host that counts tools per child will see two more.
+- **`agent_list` gained `members` and `self`** next to `children` — the live
+  addresses `agent_send` accepts. `children` keeps its meaning and shape.
+- **New: `AgentTree` / `TreeMember` / `TeamTaskBoard` / `TaskItem`,**
+  `OrchestrationExecutor(tree=..., team_board=...)`, and
+  `AgentPool.tree`. Passing neither keeps the previous behaviour exactly
+  (single-pool reach, no board tools). `PeerToolsExecutor` is the layer that
+  gives a leaf the two messaging tools.
+- **New board tools, advertised with the family:** `team_task_create`,
+  `team_task_claim`, `team_task_complete`, `team_task_list`. They are
+  in-process and per turn — the board does not outlive its root turn, and the
+  durable child index remains the record of what survived.
+- **`subagent` children now register in the same tree,** so a delegated child
+  and an `agent_spawn` child can message each other. `AgentPool.tree` exposes
+  it; `attach_pool` is what makes a delegation part of the turn's job.
 Selectively install just the bits you need:
 
 ```bash

package/python-runtime/python/lib/python3.12/site-packages/{steerable_agent_runtime-0.10.2.dist-info → steerable_agent_runtime-0.11.0.dist-info}/RECORD

@@ -1,11 +1,11 @@
-steerable_agent_runtime-0.10.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
-steerable_agent_runtime-0.10.2.dist-info/METADATA,sha256=ltUpA8xrtG9agCH31z9bLgNdSMipBr2ypLNO6jLYdm4,4824
-steerable_agent_runtime-0.10.2.dist-info/RECORD,,
-steerable_agent_runtime-0.10.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-steerable_agent_runtime-0.10.2.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
-steerable_agent_runtime-0.10.2.dist-info/direct_url.json,sha256=P_UymzDO3Obfcpg0LQ3QOoqb3bdZf-pBgtKYq6uOTQE,303
-steerable_agent_runtime-0.10.2.dist-info/top_level.txt,sha256=oH6AX0Sbye_DmFcu-JFEwuu-yXwyCkkdquPt8t0pFJE,24
-steerable_agent_runtime/__init__.py,sha256=lgvWntuMpJUldnGi0oOhS4Sc6qInx29gPbM1DtHgTZE,13414
+steerable_agent_runtime-0.11.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+steerable_agent_runtime-0.11.0.dist-info/METADATA,sha256=p0mi6i8cGICwZmZIxB29wLTPZnao10KPvgH6Tms_C-k,6769
+steerable_agent_runtime-0.11.0.dist-info/RECORD,,
+steerable_agent_runtime-0.11.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+steerable_agent_runtime-0.11.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+steerable_agent_runtime-0.11.0.dist-info/direct_url.json,sha256=ynbDZRQrFTAM9HNmanpnH67hn0SPZjj7e-HwGyfekcc,303
+steerable_agent_runtime-0.11.0.dist-info/top_level.txt,sha256=oH6AX0Sbye_DmFcu-JFEwuu-yXwyCkkdquPt8t0pFJE,24
+steerable_agent_runtime/__init__.py,sha256=4cY8-MICTOiT87TqaJNlVHeG0BtB305I13k90RDGXBg,13732
 steerable_agent_runtime/__pycache__/__init__.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/antihallucination.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/approval.cpython-312.pyc,,
@@ -40,6 +40,7 @@ steerable_agent_runtime/__pycache__/native_bridge.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/observation_aging.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/orchestration.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/otel.cpython-312.pyc,,
+steerable_agent_runtime/__pycache__/peer.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/plugins.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/pool.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/pricing.cpython-312.pyc,,
@@ -54,6 +55,7 @@ steerable_agent_runtime/__pycache__/sandboxed.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/skills.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/spill.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/subagent.cpython-312.pyc,,
+steerable_agent_runtime/__pycache__/team_board.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/todo.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/tokens.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/tool_presentation.cpython-312.pyc,,
@@ -61,6 +63,7 @@ steerable_agent_runtime/__pycache__/tool_schema.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/tool_search.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/tools.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/tracing.cpython-312.pyc,,
+steerable_agent_runtime/__pycache__/tree.cpython-312.pyc,,
 steerable_agent_runtime/__pycache__/world_state.cpython-312.pyc,,
 steerable_agent_runtime/antihallucination.py,sha256=_IU1q0NKLjjw_3D-1JGr1FbBkRhSwaPTwibD_z-5IdQ,27133
 steerable_agent_runtime/approval.py,sha256=l9VaKSqG1w_w0TSKFI6FwBLzwAs-MaqyKpXdewA7fl8,26825
@@ -115,10 +118,11 @@ steerable_agent_runtime/model_info.py,sha256=yLiA8uWzPv7fHO7mUlgd0NlpbT1PBXKWX-u
 steerable_agent_runtime/model_resolve.py,sha256=vcKDvfLiBcTr99dj1FDsiKiA16o0IC6trm-yRFdlgQY,10332
 steerable_agent_runtime/native_bridge.py,sha256=Mu9CeTBHyjwU6Q2Yn-4sW1JGNW6H4dSVfYuuX4W212k,38582
 steerable_agent_runtime/observation_aging.py,sha256=4ajPHONvyh46LIRLTNqJGmJtSeDX6kJe1-1zhDuRaG8,8129
-steerable_agent_runtime/orchestration.py,sha256=ONHk7OqKj-uyFQX6npzuNtirUTUeax_OCCXRDq_KEKw,39999
+steerable_agent_runtime/orchestration.py,sha256=Oj6POU3TBGX9ASRonayo0iVJV2xZGqlfiCMev3mJeSQ,54172
 steerable_agent_runtime/otel.py,sha256=idBWSnIbXowF7fzfFS9rkhPFZTf0e1SdSuNMJJw0aRg,14471
+steerable_agent_runtime/peer.py,sha256=xTL1P95ng3vLue_6lnmMNpmGn373ZnZJxARpRu_chKQ,7383
 steerable_agent_runtime/plugins.py,sha256=VCProcLnWzVxr7WRI5ndRbkdX-fXh1CTa-YCg-q60Xc,18444
-steerable_agent_runtime/pool.py,sha256=luAViiyMB7EzFu0AzNsHK1yzKEoG_pmvH9J4btqpuO4,47600
+steerable_agent_runtime/pool.py,sha256=eanoBpa8XTMimuAmcj3uENVNXped20gAusiTYp9TXOY,51752
 steerable_agent_runtime/pricing.py,sha256=EsciOP14OFnP5m0UIOF9uNV_DTCBE4OIEDSGCiZhGbM,3081
 steerable_agent_runtime/pseudo.py,sha256=K3bIpjacetNqfBmK30gzquS7pZ-xYXgluDE8mHSG_d0,24200
 steerable_agent_runtime/recording.py,sha256=y7iRHJD_NzlxpZvFvtqy94mYfCVagp9bJCK_BfJIp7w,16796
@@ -140,7 +144,8 @@ steerable_agent_runtime/storage/in_memory.py,sha256=6MgDanAiVqpYagTeMcljhk62GCGZ
 steerable_agent_runtime/storage/sqlalchemy_store.py,sha256=RagEhi1bLXS7_ET-UsN8SWvNr2NbnXF_2yNe6CXjYTE,24337
 steerable_agent_runtime/storage/sqlite_store.py,sha256=qBepGs82s6nRiUO92DtleuGFDQQHiFpCNTyib9T3zaY,23324
 steerable_agent_runtime/storage/write_lease.py,sha256=Yzwe0ggIfVPlJaRwGUYr_dOHVBC9R4842ALLoc3iQO8,6115
-steerable_agent_runtime/subagent.py,sha256=LufKJazOEOf4ce6XJ9s_GY22uPY5w-dzbdiW5ECr1lg,31791
+steerable_agent_runtime/subagent.py,sha256=bPPcSHHmmy12TPJgqnH393_6dzNoFLsmXRU2N2nkm-c,32889
+steerable_agent_runtime/team_board.py,sha256=VCWxhXlwu9GwQvZ49MSRPg1uVR-xzU8OxQzvKm5KBs0,8528
 steerable_agent_runtime/todo.py,sha256=59uuGm_a8kqAJ0vIS0IWg1GbEXL9OBBkPqUkv2-G2B0,13255
 steerable_agent_runtime/tokens.py,sha256=6WKyxf5dYP98UoLa6ONUbwQubUaLfw6yyr6z98zJuX0,6480
 steerable_agent_runtime/tool_presentation.py,sha256=k4K4Zva1by75l3HDpNUMSbVQeuvB7BYM3gI9Mtunw-g,6850
@@ -154,4 +159,5 @@ steerable_agent_runtime/transport/__pycache__/fastapi_sse.cpython-312.pyc,,
 steerable_agent_runtime/transport/__pycache__/stdio_jsonrpc.cpython-312.pyc,,
 steerable_agent_runtime/transport/fastapi_sse.py,sha256=u6yuKdSFxYeRajyArvHTW_wrtFbQAdcFo8Ib3WWyKMg,3555
 steerable_agent_runtime/transport/stdio_jsonrpc.py,sha256=zivW7_1fQC1voeF-Q4HhTI1QBQMj0zZMJRzs1DTwoPs,15861
+steerable_agent_runtime/tree.py,sha256=1RYQwjP1fEHzYalG2TiDatc-BZ5r_TiaqD6ZslwgJPQ,6658
 steerable_agent_runtime/world_state.py,sha256=y08rAXzgM_PEe7UAdhGeix2bAc_clC6gXQDn-CIeYTE,13043

package/python-runtime/python/lib/python3.12/site-packages/steerable_sidecar/sidecar.py

@@ -78,9 +78,11 @@ from steerable_agent_runtime import (
     AcpEngineSpec,
     AcpPermissionPolicy,
     AcpToolBridge,
+    AgentTree,
     OrchestrationConfig,
     OrchestrationExecutor,
     SessionBudgetExceeded,
+    TeamTaskBoard,
     TreeBudget,
     PluginLoadError,
     PluginStateError,
@@ -124,6 +126,7 @@ from steerable_agent_runtime import (
     skill_to_dict,
     skill_tool_descriptor,
     subagent_tool_descriptor,
+    team_tool_descriptors,
     mcp_invoker,
     register_mcp_catalog,
 )
@@ -2518,6 +2521,15 @@ class Sidecar:
         # and delegate children appear in agent_list.
         orchestration_param = params.get("orchestration")
         orchestration: OrchestrationExecutor | None = None
+        # R8: one tree and one board per turn. The tree is what makes every
+        # agent in the job addressable — a worker messaging a sibling, a child
+        # reporting to the root — and the board is the plan they share. Both
+        # live exactly as long as the turn: a spawn tree does not outlive its
+        # root run, and the durable registry answers the different question of
+        # what survives. The root registers once its loop exists (below), since
+        # a message to it is delivered by steering that loop.
+        team_tree: AgentTree | None = None
+        team_board: TeamTaskBoard | None = None
         if (
             isinstance(orchestration_param, dict)
             and orchestration_param
@@ -2552,6 +2564,13 @@ class Sidecar:
                     else None
                 ),
             )
+            # R8: a peer tree and a shared board come with the family unless
+            # the host turns them off. Both are additive — an agent that never
+            # messages or claims behaves exactly as before — so they default
+            # on rather than requiring a second opt-in.
+            if orchestration_param.get("team", True):
+                team_tree = AgentTree()
+                team_board = TeamTaskBoard()
             # The parent loop is created after this executor (the loop needs
             # the executor), so a fork reads the transcript through a holder.
             orchestration = OrchestrationExecutor(
@@ -2577,6 +2596,8 @@ class Sidecar:
                 parent_route=parent_route,
                 provider_factory=_orchestration_provider_factory,
                 budget=tree_budget,
+                tree=team_tree,
+                team_board=team_board,
             )
             if subagent_executor is not None:
                 subagent_executor.attach_pool(orchestration.pool)
@@ -2585,6 +2606,11 @@ class Sidecar:
                 *(tools or []),
                 *orchestration_tool_descriptors(orch_config),
             ]
+            if team_board is not None:
+                # The root writes the plan, so it always has the board tools;
+                # children get them from their own executor (which is why the
+                # descriptors are appended here once, not per child).
+                tools = [*(tools or []), *team_tool_descriptors(orch_config)]
         # Router-answered tools (run_code, ask_user): registered on the
         # sidecar's router but unknown to the host — under toolsViaHost the
         # inner executor forwards every call to the host, so they must be
@@ -2690,7 +2716,15 @@ class Sidecar:
         # holder's declaration above).
         if orchestration is not None:
             parent_loop_holder.append(loop)
-            # Expose the pool to the panel's live controls (interrupt a running
+            if team_tree is not None:
+                # The root is a member too: a child reporting a finding, or a
+                # worker asking whoever wrote the plan, needs an address that
+                # reaches this turn's parent loop. Steering is the delivery —
+                # it lands at the next round boundary as a user message, the
+                # same channel a host steer uses.
+                team_tree.register_root(
+                    lambda message, target=loop: _deliver_to_loop(target, message)
+                )            # Expose the pool to the panel's live controls (interrupt a running
             # child). Keyed by chat: one turn at a time per chat, so a later
             # turn simply replaces it.
             if params.get("chatId"):
@@ -3923,6 +3957,20 @@ def _tree_report_of(budget: TreeBudget) -> dict[str, Any]:
     return {"limit": report.limit, "spent": report.spent, "byAgent": dict(report.by_agent)}
 
 
+async def _deliver_to_loop(loop: CoreLoop, message: str) -> str:
+    """Deliver a peer message to the turn's own parent loop.
+
+    Steering is the only channel the root has: it is a running run, so the
+    message becomes a user turn at the next round boundary — the same path a
+    host-initiated steer takes, which is what makes a child's report visible
+    to the model rather than to some side table. The verdict vocabulary
+    matches ``AgentPool.send`` (``steered`` / ``resumed``) so a sender reads
+    one set of answers whether the target is a child or the root.
+    """
+    loop.steer(message)
+    return "steered"
+
+
 def _tree_budget_from(params: dict[str, Any]) -> TreeBudget:
     """Build the turn tree's shared token limit from the request.
 

package/python-runtime/python/lib/python3.12/site-packages/{steerable_sidecar-0.10.2.dist-info → steerable_sidecar-0.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: steerable-sidecar
-Version: 0.10.2
+Version: 0.11.0
 Summary: Steerable agent runtime sidecar — JSON-RPC over stdio.
 License: Apache-2.0
 Requires-Python: >=3.10
@@ -82,6 +82,30 @@ Every change below is additive except where noted.
   the child re-reads the parent prefix on a different route. Changing the route
   without a fork fails closed.
 
+## Upgrading from 0.10
+
+Peer messaging and a shared task board ride the orchestration opt-in. Nothing
+changes for a host that does not enable it.
+
+- **`orchestration.team` (default `true`)** — with `enabled: true`, the turn
+  also creates a spawn tree and a shared task board, and advertises four board
+  tools (`team_task_create`, `team_task_claim`, `team_task_complete`,
+  `team_task_list`) to every agent in the job. `team: false` keeps the six-tool
+  family without them, for a host that does not want the extra tools in the
+  prompt.
+- **`agent_send` reaches the whole job.** Any live lineage id is addressable —
+  `0` (the turn's root), a sibling, a child — not just this executor's own
+  children. A message to the root steers the parent loop, so a worker's report
+  arrives as a user turn. `agent_list` now also returns `members` (live
+  addresses with depth and profile) and `self`.
+- **Depth no longer gates messaging.** A child at the depth wall, and a
+  `delegate_subagent` child, are advertised `agent_send` + `agent_list` and
+  nothing else from the family. A host that counts child tools sees two more.
+- **The tree and board are per turn.** They do not outlive the root run;
+  `agent.children.list` remains the durable record. A message to an id that
+  belonged to an earlier turn is not resumable through the tree — that is what
+  `agent_send`'s registry path handles.
+
 ## Embedding
 
 ```python

package/python-runtime/python/lib/python3.12/site-packages/{steerable_sidecar-0.10.2.dist-info → steerable_sidecar-0.11.0.dist-info}/RECORD

@@ -1,14 +1,14 @@
 ../../../bin/steerable-sidecar,sha256=585U51qsZ6YLxjRRp6qNsSx231-LesLDofKABRJGKPg,264
 ../../../bin/steerable-sidecar-acp,sha256=NyQYfZ5KrcRCUhtmpNf2dU05RdUwekozg8GtUdFcxh0,267
 ../../../bin/steerable-sidecar-headless,sha256=fnPsDRsBH1__rlO-Zhh_8LzgplWrXILWJpad3oFSvF4,264
-steerable_sidecar-0.10.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
-steerable_sidecar-0.10.2.dist-info/METADATA,sha256=xH802x3dYDVucHialyJA8IgP1c3wagQio8dzHjiIuS8,3877
-steerable_sidecar-0.10.2.dist-info/RECORD,,
-steerable_sidecar-0.10.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-steerable_sidecar-0.10.2.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
-steerable_sidecar-0.10.2.dist-info/direct_url.json,sha256=JEZpx7yE780bV5TFGx5tokZeGi6EKgHWvn_3JJtTZ3E,297
-steerable_sidecar-0.10.2.dist-info/entry_points.txt,sha256=qrH9-x-0XSrW3-G1-QmU4j8A7b731wKPnc_XS_oAkO8,190
-steerable_sidecar-0.10.2.dist-info/top_level.txt,sha256=0QLlBP9tgRT5PLQXFYLc_FTgTH87Qn6JGsgJj4ZvhDs,18
+steerable_sidecar-0.11.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+steerable_sidecar-0.11.0.dist-info/METADATA,sha256=sEx44fSw8YYkxijoI3fQaY36LAmuVGQxpWeTzeP8Lvw,5272
+steerable_sidecar-0.11.0.dist-info/RECORD,,
+steerable_sidecar-0.11.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+steerable_sidecar-0.11.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+steerable_sidecar-0.11.0.dist-info/direct_url.json,sha256=p_X38H9svp4Cw2AHeViap9EkkW3IUdtzVXf2QP9BCDA,297
+steerable_sidecar-0.11.0.dist-info/entry_points.txt,sha256=qrH9-x-0XSrW3-G1-QmU4j8A7b731wKPnc_XS_oAkO8,190
+steerable_sidecar-0.11.0.dist-info/top_level.txt,sha256=0QLlBP9tgRT5PLQXFYLc_FTgTH87Qn6JGsgJj4ZvhDs,18
 steerable_sidecar/__init__.py,sha256=p-szaR3e6eP8xV0O9GyEKgdEISz3iaDXvsZv8XhBEKo,669
 steerable_sidecar/__main__.py,sha256=qzdZBagiiY-v60K__iEjRSLxh3e-davno32o3s2SpQI,4294
 steerable_sidecar/__pycache__/__init__.cpython-312.pyc,,
@@ -69,7 +69,7 @@ steerable_sidecar/run_code_driver.py,sha256=L46TH_st_7Kw9SdhPcDK8GQP0I-7xTmjRIAz
 steerable_sidecar/sandbox.py,sha256=9Ts-ddkaqWp9E-BcmZamj2SWuVugcHBCLo6LqBzMEs0,30164
 steerable_sidecar/search_tools.py,sha256=CKqca5zjGTZsA7uLKh_UkXz9AFt4Fe1PBVqTQTHVYNs,6118
 steerable_sidecar/shell_session.py,sha256=Q1MIQXwHWag1QUbUfApQ75Q0aYSFXZaoeo7oV6wTPhU,10538
-steerable_sidecar/sidecar.py,sha256=nCb1iH3_Ls8Ug571Bi95Z1DvnC7-VzENnrldmv8eQmU,189423
+steerable_sidecar/sidecar.py,sha256=52297rpGdHI-Qw1DRzScj1QHecd4TT2QFP1EUmN1yCI,192126
 steerable_sidecar/stream_chunks.py,sha256=SghkPzrRkmBdXN6FoR8Sldpxi-WT8GRzEYtA3tEyQVU,4681
 steerable_sidecar/todo_tools.py,sha256=A0XKJd5ZK6TVj3qH9zNvoCKd_Cebq_P5FhWvYoVv1hQ,1598
 steerable_sidecar/tool_contract.json,sha256=BEj64csxA_jr8hh_gHKsPu97jqNyIHa7YE_U5oYsvok,8135

package/runtime.json

@@ -8,7 +8,7 @@
     },
     {
       "path": "python-runtime/manifest.json",
-      "sha256": "3e3dfc18a19c65b03f6ffc2f8235dfc0b45d67e1128d8750990b00fedad7d90f"
+      "sha256": "db120757c56c7c39cefe40ecab6fec38f92faa2a82cc283172b250c06dbf549c"
     },
     {
       "path": "python-runtime/python/bin/2to3",
@@ -6815,19 +6815,19 @@
       "sha256": "3e972a442ac2e0d22211245269400f662d05799427e2047109496a5529e02978"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_harness-0.10.2.dist-info/INSTALLER",
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_harness-0.11.0.dist-info/INSTALLER",
       "sha256": "ceebae7b8927a3227e5303cf5e0f1f7b34bb542ad7250ac03fbcde36ec2f1508"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_harness-0.10.2.dist-info/METADATA",
-      "sha256": "e7c53bd8b7e7a02a81c7872d836ec5e2e2dbed9ca1903736c8d2396c777197df"
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_harness-0.11.0.dist-info/METADATA",
+      "sha256": "3a9c13b62192fbab973abbe52b1be3d258fc4d6f36a82cd9260a926771a851aa"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_harness-0.10.2.dist-info/RECORD",
-      "sha256": "d8dbbaf545291f5d7d7a198079f8fd941ece518bdde7df83af1752fb0ef06be8"
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_harness-0.11.0.dist-info/RECORD",
+      "sha256": "57b6a2225ed20e89b7b0f08b5edf591be687363a0ad52ae648ef85eeed39f94b"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_harness-0.10.2.dist-info/WHEEL",
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_harness-0.11.0.dist-info/WHEEL",
       "sha256": "98e75747d0b7c0c568bfb71263c3d8f970b3a374a6996087bc642be5cb09a1aa"
     },
     {
@@ -6839,24 +6839,24 @@
       "sha256": "8deca72a770e3f41d61295dc16cec0ef2df3e339684749e309aaf680c7017dba"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_protocol-0.10.2.dist-info/INSTALLER",
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_protocol-0.11.0.dist-info/INSTALLER",
       "sha256": "ceebae7b8927a3227e5303cf5e0f1f7b34bb542ad7250ac03fbcde36ec2f1508"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_protocol-0.10.2.dist-info/METADATA",
-      "sha256": "93318aaeeed5cdbaab35928e5c1fac342d21b7b2ca2c6566926b82dc4b7a568f"
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_protocol-0.11.0.dist-info/METADATA",
+      "sha256": "f9d4e128a66174cca0b5cd2127e4dc1e87544c70850af061cb0c695f8a77cfc5"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_protocol-0.10.2.dist-info/RECORD",
-      "sha256": "d92ac61df480b1251a8e0e2ea4cce773bbf9ee08134094efaf50546d41c53aab"
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_protocol-0.11.0.dist-info/RECORD",
+      "sha256": "80b2a19de5490d29e2858509db14befbf458eb9235ff5ed3bff39ef384a85a43"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_protocol-0.10.2.dist-info/WHEEL",
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_protocol-0.11.0.dist-info/WHEEL",
       "sha256": "98e75747d0b7c0c568bfb71263c3d8f970b3a374a6996087bc642be5cb09a1aa"
     },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/__init__.py",
-      "sha256": "960bd69edb8ca495257671a2d283a14b849ceaa227c76f603db3350ed1e04d91"
+      "sha256": "e1c63cf8c2024ce893f3b4ea689365547786d01b41df4e48d7793dd110c65c18"
     },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/antihallucination.py",
@@ -7032,19 +7032,23 @@
     },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/orchestration.py",
-      "sha256": "38d1e4ecea8a8febb21505fa9e9cee36d8ab51351e6b1fce0825d10eafca10ac"
+      "sha256": "3a3e8f394dd30465fd0124689daca8d22549576c591aa95f88231ebf79897924"
     },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/otel.py",
       "sha256": "89d0564a721b5e8c05edfcdf152f6b9213c56537f47b549d4ae34c249c346918"
     },
+    {
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/peer.py",
+      "sha256": "c532f53fde67837bcbb9effa96798c3699869f7ef7667649c4046946efdc84a4"
+    },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/plugins.py",
       "sha256": "5423eba1c2e75b3571afb5912399dd45b91d5fe7d78750936be60283eabad177"
     },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/pool.py",
-      "sha256": "96e0158a2c8c07b13316ed00ccdb072b5cb3284a06fe99af1fd2786edaa9b8ee"
+      "sha256": "79a9e80696bc5d33229ae026723dee10d54d5e979ddb4800bac893629f535ce6"
     },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/pricing.py",
@@ -7112,7 +7116,11 @@
     },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/subagent.py",
-      "sha256": "2ee7ca25acce10e7f871ee9727db3f198db6b8f639c3e7736dd896e440abd658"
+      "sha256": "6cf3dc4871e69b2d764cf260aa71f7f77ffa77336814bb265d15363769e49be7"
+    },
+    {
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/team_board.py",
+      "sha256": "5425b1857970bbd1b042f678f4c4913e0d6e551fb1cd4f0ec50cef2a6e4a06cd"
     },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/todo.py",
@@ -7154,24 +7162,28 @@
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/transport/stdio_jsonrpc.py",
       "sha256": "ce2bd6effd5f402d6fa1e17e4381e14c8d50050323d3364c251cecd434f0a0fb"
     },
+    {
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/tree.py",
+      "sha256": "d51610c233f57c41f361a946d938836ad73e059e6bfd389aa83e99b25c2024f4"
+    },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime/world_state.py",
       "sha256": "cb4f2b017ce033f3c47bb50076119e8b1d9b01cfdc942ea05d00e7f8221e6131"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime-0.10.2.dist-info/INSTALLER",
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime-0.11.0.dist-info/INSTALLER",
       "sha256": "ceebae7b8927a3227e5303cf5e0f1f7b34bb542ad7250ac03fbcde36ec2f1508"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime-0.10.2.dist-info/METADATA",
-      "sha256": "96d52903cc6bb46f5a8021f7d73f5b2e035d48c8a906bdb2a4b34eea32d8766e"
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime-0.11.0.dist-info/METADATA",
+      "sha256": "a749a2ea2f1c1880b0666648c41dbdc0b4cf6676a8d7428fbe01fa4e6b3f0be9"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime-0.10.2.dist-info/RECORD",
-      "sha256": "eddfe053c50e1786c05203d92cf9d85e6b3f59dbfbfc9c3c3331c387425706e6"
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime-0.11.0.dist-info/RECORD",
+      "sha256": "d6fa42beea1577569703576dbb436b1cdfc1028d861c34bddf4dfca31c1491fd"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime-0.10.2.dist-info/WHEEL",
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_agent_runtime-0.11.0.dist-info/WHEEL",
       "sha256": "98e75747d0b7c0c568bfb71263c3d8f970b3a374a6996087bc642be5cb09a1aa"
     },
     {
@@ -7308,7 +7320,7 @@
     },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar/sidecar.py",
-      "sha256": "9c26f5887dff2ecf14839ef5062f796750ef9c2efe57310d9eb95d9aff1e4265"
+      "sha256": "e76dbdeeba4674723e430d4347349c8f540779c7784d3d9014fd44526375c822"
     },
     {
       "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar/stream_chunks.py",
@@ -7339,23 +7351,23 @@
       "sha256": "d00b8b7d1d932a9f9c9ba8c1f812ed63a7f8fb84026a787373ae0bf3b353edca"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar-0.10.2.dist-info/INSTALLER",
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar-0.11.0.dist-info/INSTALLER",
       "sha256": "ceebae7b8927a3227e5303cf5e0f1f7b34bb542ad7250ac03fbcde36ec2f1508"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar-0.10.2.dist-info/METADATA",
-      "sha256": "c47f34db1ddd60356e70789a972240f0880fd5cdf06a0422a3c7731e3888b92f"
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar-0.11.0.dist-info/METADATA",
+      "sha256": "b04c78e1f4b0f18624c628e82377d0698dfa2c09ae546431a56793cde3fc2efc"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar-0.10.2.dist-info/RECORD",
-      "sha256": "1239836bfc8b0e32b354b77eb390bc2dd34563729423cee674cf47933dcdba65"
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar-0.11.0.dist-info/RECORD",
+      "sha256": "255c4142e77708323d4cc635bea78e53bca88d7ece3c741575c4af8cdb95903a"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar-0.10.2.dist-info/WHEEL",
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar-0.11.0.dist-info/WHEEL",
       "sha256": "98e75747d0b7c0c568bfb71263c3d8f970b3a374a6996087bc642be5cb09a1aa"
     },
     {
-      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar-0.10.2.dist-info/entry_points.txt",
+      "path": "python-runtime/python/lib/python3.12/site-packages/steerable_sidecar-0.11.0.dist-info/entry_points.txt",
       "sha256": "aab1fdfb1fb45d2ad6dfe1b5f90994e23f00edbef7d7028f9dcfd74bfa0090ef"
     },
     {
@@ -8779,7 +8791,7 @@
       "sha256": "482786a0d83d8536eddc78aafdf702d247ddc1f33d45115bdfe86c92a3d6043f"
     }
   ],
-  "packageVersion": "0.10.2",
+  "packageVersion": "0.11.0",
   "runCodePython": "python-runtime/python/bin/python3",
   "schemaVersion": 1,
   "sidecarPython": "python-runtime/python/bin/python3",