@team-agent/installer 0.1.11 → 0.2.0

package/src/team_agent/messaging/deps.py

@@ -0,0 +1,263 @@
+from __future__ import annotations
+
+import copy
+import json
+import os
+import re
+import subprocess
+import time
+from datetime import datetime, timedelta, timezone
+from typing import Any
+
+from team_agent import runtime as _runtime
+from team_agent.errors import RuntimeError, ValidationError
+from team_agent.events import EventLog
+from team_agent.message_store import MessageStore
+from team_agent.paths import runtime_dir
+from team_agent.permissions import missing_tools
+from team_agent.routing import route_task
+from team_agent.spec import load_spec, validate_result_envelope
+from team_agent.state import (
+    ambiguous_team_target_result,
+    check_team_owner,
+    load_runtime_state,
+    save_runtime_state,
+    save_team_scoped_state,
+    select_runtime_state,
+    team_state_key,
+    write_team_state,
+)
+from team_agent.task_graph import update_task_status
+
+# Explicit runtime dependency surface for messaging extraction. Wrappers keep
+# runtime monkeypatch points stable while avoiding module-wide globals sync.
+_RUNTIME_CONSTANTS = (
+    "DELIVERY_CAPTURE_LINES",
+    "PASTED_CONTENT_PROMPT_RE",
+    "TMUX_PANE_FORMAT",
+    "TMUX_PASTE_BYTES_PER_SECOND",
+    "TMUX_PASTE_MAX_READY_TIMEOUT",
+    "TMUX_PASTE_MIN_READY_TIMEOUT",
+    "TMUX_STDIN_BUFFER_THRESHOLD",
+    "TMUX_SUBMIT_BYTES_PER_SECOND",
+    "TMUX_SUBMIT_MAX_SETTLE_TIMEOUT",
+    "TMUX_SUBMIT_MIN_SETTLE_TIMEOUT",
+)
+_RUNTIME_PATCH_POINTS = (
+    "_capture_has_pasted_content_prompt",
+    "_capture_missing_sessions",
+    "_capture_tmux_pane_text",
+    "_choose_leader_submit_key",
+    "_current_task_for_agent",
+    "_deliver_pending_message",
+    "_deliver_pending_messages",
+    "_find_agent",
+    "_find_task",
+    "_find_task_or_none",
+    "_format_team_agent_message",
+    "_handle_provider_runtime_prompts",
+    "_handle_provider_startup_prompts",
+    "_infer_active_tmux_pane",
+    "_infer_workspace_tmux_pane",
+    "_is_leader_sender",
+    "_is_leader_target",
+    "_is_message_scoped_result",
+    "_is_runtime_team_agent",
+    "_leader_id",
+    "_leader_receiver_is_direct",
+    "_message_by_id",
+    "_message_payload",
+    "_mirror_peer_message_to_leader",
+    "_notify_leader_of_report_result",
+    "_rediscover_leader_receiver",
+    "_refresh_agent_runtime_statuses",
+    "_result_status_to_task_status",
+    "_runtime_lock",
+    "_runtime_team_agent_ids",
+    "_send_to_leader_receiver",
+    "_submit_worker_prompt",
+    "_tmux_current_client_pane_info",
+    "_tmux_inject_text",
+    "_tmux_list_panes",
+    "_tmux_load_buffer_stdin",
+    "_tmux_pane_info",
+    "_tmux_paste_ready_timeout",
+    "_tmux_set_buffer_text",
+    "_tmux_submit_settle_timeout",
+    "_tmux_window_exists",
+    "_validate_leader_receiver",
+    "_wait_for_message_ready",
+    "_wait_for_worker_message_ready",
+    "core_list_targets",
+    "core_render_message",
+    "run_cmd",
+    "send_message",
+    "start_coordinator",
+)
+for _name in (*_RUNTIME_CONSTANTS, *_RUNTIME_PATCH_POINTS):
+    if not hasattr(_runtime, _name):
+        raise ImportError(f"team_agent.runtime missing messaging dependency: {_name}")
+
+DELIVERY_CAPTURE_LINES = _runtime.DELIVERY_CAPTURE_LINES
+PASTED_CONTENT_PROMPT_RE = _runtime.PASTED_CONTENT_PROMPT_RE
+TMUX_PANE_FORMAT = _runtime.TMUX_PANE_FORMAT
+TMUX_PASTE_BYTES_PER_SECOND = _runtime.TMUX_PASTE_BYTES_PER_SECOND
+TMUX_PASTE_MAX_READY_TIMEOUT = _runtime.TMUX_PASTE_MAX_READY_TIMEOUT
+TMUX_PASTE_MIN_READY_TIMEOUT = _runtime.TMUX_PASTE_MIN_READY_TIMEOUT
+TMUX_STDIN_BUFFER_THRESHOLD = _runtime.TMUX_STDIN_BUFFER_THRESHOLD
+TMUX_SUBMIT_BYTES_PER_SECOND = _runtime.TMUX_SUBMIT_BYTES_PER_SECOND
+TMUX_SUBMIT_MAX_SETTLE_TIMEOUT = _runtime.TMUX_SUBMIT_MAX_SETTLE_TIMEOUT
+TMUX_SUBMIT_MIN_SETTLE_TIMEOUT = _runtime.TMUX_SUBMIT_MIN_SETTLE_TIMEOUT
+
+
+def _runtime_symbol(name: str) -> Any:
+    return getattr(_runtime, name)
+
+def _capture_has_pasted_content_prompt(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_capture_has_pasted_content_prompt")(*args, **kwargs)
+
+def _capture_missing_sessions(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_capture_missing_sessions")(*args, **kwargs)
+
+def _capture_tmux_pane_text(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_capture_tmux_pane_text")(*args, **kwargs)
+
+def _choose_leader_submit_key(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_choose_leader_submit_key")(*args, **kwargs)
+
+def _current_task_for_agent(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_current_task_for_agent")(*args, **kwargs)
+
+def _deliver_pending_message(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_deliver_pending_message")(*args, **kwargs)
+
+def _deliver_pending_messages(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_deliver_pending_messages")(*args, **kwargs)
+
+def _find_agent(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_find_agent")(*args, **kwargs)
+
+def _find_task(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_find_task")(*args, **kwargs)
+
+def _find_task_or_none(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_find_task_or_none")(*args, **kwargs)
+
+def _format_team_agent_message(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_format_team_agent_message")(*args, **kwargs)
+
+def _handle_provider_runtime_prompts(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_handle_provider_runtime_prompts")(*args, **kwargs)
+
+def _handle_provider_startup_prompts(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_handle_provider_startup_prompts")(*args, **kwargs)
+
+def _is_leader_sender(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_is_leader_sender")(*args, **kwargs)
+
+def _is_leader_target(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_is_leader_target")(*args, **kwargs)
+
+def _is_message_scoped_result(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_is_message_scoped_result")(*args, **kwargs)
+
+def _is_runtime_team_agent(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_is_runtime_team_agent")(*args, **kwargs)
+
+def _leader_id(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_leader_id")(*args, **kwargs)
+
+def _leader_receiver_is_direct(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_leader_receiver_is_direct")(*args, **kwargs)
+
+def _message_by_id(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_message_by_id")(*args, **kwargs)
+
+def _message_payload(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_message_payload")(*args, **kwargs)
+
+def _mirror_peer_message_to_leader(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_mirror_peer_message_to_leader")(*args, **kwargs)
+
+def _notify_leader_of_report_result(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_notify_leader_of_report_result")(*args, **kwargs)
+
+def _rediscover_leader_receiver(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_rediscover_leader_receiver")(*args, **kwargs)
+
+def _refresh_agent_runtime_statuses(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_refresh_agent_runtime_statuses")(*args, **kwargs)
+
+def _result_status_to_task_status(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_result_status_to_task_status")(*args, **kwargs)
+
+def _runtime_lock(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_runtime_lock")(*args, **kwargs)
+
+def _runtime_team_agent_ids(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_runtime_team_agent_ids")(*args, **kwargs)
+
+def _send_to_leader_receiver(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_send_to_leader_receiver")(*args, **kwargs)
+
+def _submit_worker_prompt(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_submit_worker_prompt")(*args, **kwargs)
+
+def _tmux_inject_text(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_tmux_inject_text")(*args, **kwargs)
+
+def _tmux_current_client_pane_info(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_tmux_current_client_pane_info")(*args, **kwargs)
+
+def _tmux_list_panes(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_tmux_list_panes")(*args, **kwargs)
+
+def _infer_active_tmux_pane(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_infer_active_tmux_pane")(*args, **kwargs)
+
+def _tmux_pane_info(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_tmux_pane_info")(*args, **kwargs)
+
+def _infer_workspace_tmux_pane(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_infer_workspace_tmux_pane")(*args, **kwargs)
+
+def _tmux_load_buffer_stdin(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_tmux_load_buffer_stdin")(*args, **kwargs)
+
+def _tmux_paste_ready_timeout(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_tmux_paste_ready_timeout")(*args, **kwargs)
+
+def _tmux_set_buffer_text(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_tmux_set_buffer_text")(*args, **kwargs)
+
+def _tmux_submit_settle_timeout(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_tmux_submit_settle_timeout")(*args, **kwargs)
+
+def _tmux_window_exists(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_tmux_window_exists")(*args, **kwargs)
+
+def _validate_leader_receiver(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_validate_leader_receiver")(*args, **kwargs)
+
+def _wait_for_message_ready(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_wait_for_message_ready")(*args, **kwargs)
+
+def _wait_for_worker_message_ready(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("_wait_for_worker_message_ready")(*args, **kwargs)
+
+def run_cmd(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("run_cmd")(*args, **kwargs)
+
+def core_list_targets(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("core_list_targets")(*args, **kwargs)
+
+def core_render_message(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("core_render_message")(*args, **kwargs)
+
+def send_message(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("send_message")(*args, **kwargs)
+
+def start_coordinator(*args: Any, **kwargs: Any) -> Any:
+    return _runtime_symbol("start_coordinator")(*args, **kwargs)
+
+__all__ = ['DELIVERY_CAPTURE_LINES', 'EventLog', 'MessageStore', 'PASTED_CONTENT_PROMPT_RE', 'RuntimeError', 'TMUX_PANE_FORMAT', 'TMUX_PASTE_BYTES_PER_SECOND', 'TMUX_PASTE_MAX_READY_TIMEOUT', 'TMUX_PASTE_MIN_READY_TIMEOUT', 'TMUX_STDIN_BUFFER_THRESHOLD', 'TMUX_SUBMIT_BYTES_PER_SECOND', 'TMUX_SUBMIT_MAX_SETTLE_TIMEOUT', 'TMUX_SUBMIT_MIN_SETTLE_TIMEOUT', 'ValidationError', '_capture_has_pasted_content_prompt', '_capture_missing_sessions', '_capture_tmux_pane_text', '_choose_leader_submit_key', '_current_task_for_agent', '_deliver_pending_message', '_deliver_pending_messages', '_find_agent', '_find_task', '_find_task_or_none', '_format_team_agent_message', '_handle_provider_runtime_prompts', '_handle_provider_startup_prompts', '_infer_active_tmux_pane', '_infer_workspace_tmux_pane', '_is_leader_sender', '_is_leader_target', '_is_message_scoped_result', '_is_runtime_team_agent', '_leader_id', '_leader_receiver_is_direct', '_message_by_id', '_message_payload', '_mirror_peer_message_to_leader', '_notify_leader_of_report_result', '_rediscover_leader_receiver', '_refresh_agent_runtime_statuses', '_result_status_to_task_status', '_runtime_lock', '_runtime_team_agent_ids', '_send_to_leader_receiver', '_submit_worker_prompt', '_tmux_current_client_pane_info', '_tmux_inject_text', '_tmux_list_panes', '_tmux_load_buffer_stdin', '_tmux_pane_info', '_tmux_paste_ready_timeout', '_tmux_set_buffer_text', '_tmux_submit_settle_timeout', '_tmux_window_exists', '_validate_leader_receiver', '_wait_for_message_ready', '_wait_for_worker_message_ready', 'ambiguous_team_target_result', 'check_team_owner', 'copy', 'core_list_targets', 'core_render_message', 'datetime', 'json', 'load_runtime_state', 'load_spec', 'missing_tools', 'os', 're', 'route_task', 'run_cmd', 'runtime_dir', 'save_runtime_state', 'save_team_scoped_state', 'select_runtime_state', 'send_message', 'start_coordinator', 'subprocess', 'team_state_key', 'time', 'timedelta', 'timezone', 'update_task_status', 'validate_result_envelope', 'write_team_state']

package/src/team_agent/messaging/idle_alerts.py

@@ -0,0 +1,217 @@
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+from team_agent.events import EventLog
+from team_agent.message_store import MessageStore
+from team_agent.messaging.deps import load_spec, save_runtime_state, team_state_key
+from team_agent.messaging.internal_delivery import deliver_stored_message
+
+
+_UNDELIVERED_MESSAGE_STATUSES = {
+    "pending",
+    "accepted",
+    "queued_until_idle",
+    "queued_until_start",
+    "queued_stopped",
+    "queued_pane_missing",
+    "failed",
+    "delivery_blocked",
+    "injected_unverified",
+}
+
+
+def _team_undelivered_obligations(
+    state: dict[str, Any],
+    store: MessageStore,
+    owner_team_id: str,
+    active_task_statuses: set[str],
+) -> list[dict[str, Any]]:
+    obligations: list[dict[str, Any]] = []
+    for message in store.messages(owner_team_id=owner_team_id):
+        if message.get("status") in _UNDELIVERED_MESSAGE_STATUSES:
+            obligations.append(
+                {
+                    "kind": "undelivered_message",
+                    "message_id": message.get("message_id"),
+                    "recipient": message.get("recipient"),
+                    "status": message.get("status"),
+                }
+            )
+    for watcher in store.retryable_result_watchers():
+        if watcher.get("status") in {"pending", "notify_failed"}:
+            obligations.append(
+                {
+                    "kind": "pending_result_watcher",
+                    "watcher_id": watcher.get("watcher_id"),
+                    "task_id": watcher.get("task_id"),
+                    "agent_id": watcher.get("agent_id"),
+                }
+            )
+    for task in state.get("tasks", []):
+        if task.get("status", "pending") in active_task_statuses and task.get("assignee"):
+            obligations.append(
+                {
+                    "kind": "active_task",
+                    "task_id": task.get("id"),
+                    "assignee": task.get("assignee"),
+                    "status": task.get("status"),
+                }
+            )
+    return obligations
+
+
+def _all_workers_idle(
+    state: dict[str, Any],
+    store: MessageStore,
+    owner_team_id: str,
+) -> tuple[bool, list[str]]:
+    health = store.agent_health(owner_team_id=owner_team_id)
+    worker_ids = list(state.get("agents", {}).keys()) or list(health.keys())
+    if not worker_ids:
+        return False, []
+    idle: list[str] = []
+    for agent_id in worker_ids:
+        row = health.get(agent_id) or {}
+        status = str(row.get("status") or "").lower()
+        if status != "idle":
+            return False, []
+        idle.append(agent_id)
+    return True, idle
+
+
+def _register_unified_alert(
+    state: dict[str, Any],
+    owner_team_id: str,
+    agent_id: str,
+    alert_type: str,
+    snapshot: dict[str, Any],
+    suppressed_by: str,
+    now: datetime,
+) -> dict[str, Any]:
+    coordinator = state.setdefault("coordinator", {})
+    suppressed = coordinator.setdefault("suppressed_idle_alerts", {})
+    team_suppressions = suppressed.setdefault(owner_team_id, {})
+    agent_suppressions = team_suppressions.setdefault(agent_id, {})
+    entry = {
+        "suppressed_at": now.isoformat(),
+        "suppressed_by": suppressed_by,
+        "snapshot": snapshot,
+    }
+    agent_suppressions[alert_type] = entry
+    return entry
+
+
+def detect_idle_fallbacks(
+    workspace: Path,
+    state: dict[str, Any],
+    store: MessageStore,
+    event_log: EventLog,
+    now: datetime | None = None,
+) -> list[dict[str, Any]]:
+    from team_agent.messaging.scheduler import (
+        _ACTIVE_TASK_STATUSES,
+        _active_alert_suppression,
+        _agent_alert_snapshot,
+    )
+    now = now or datetime.now(timezone.utc)
+    owner_team_id = team_state_key(state)
+    obligations = _team_undelivered_obligations(state, store, owner_team_id, _ACTIVE_TASK_STATUSES)
+    if not obligations:
+        return []
+    all_idle, idle_workers = _all_workers_idle(state, store, owner_team_id)
+    if not all_idle:
+        return []
+    spec_path = Path(state.get("spec_path", workspace / "team.spec.yaml"))
+    spec = load_spec(spec_path) if spec_path.exists() else {}
+    leader_id = state.get("leader", {}).get("id") or spec.get("leader", {}).get("id") or "leader"
+    alerts: list[dict[str, Any]] = []
+    for agent_id in idle_workers:
+        suppression = _active_alert_suppression(state, store, event_log, agent_id, "idle_fallback")
+        if suppression:
+            continue
+        snapshot = _agent_alert_snapshot(state, store, agent_id, owner_team_id)
+        _register_unified_alert(state, owner_team_id, agent_id, "idle_fallback", snapshot, "coordinator", now)
+        alerts.append({"agent_id": agent_id, "alert_type": "idle_fallback", "obligations": obligations})
+    if not alerts:
+        return []
+    save_runtime_state(workspace, state)
+    content = (
+        "There is still unfinished work. Continue coordinating, deliver a result, "
+        "or acknowledge that this idle state is intentional via team-agent acknowledge-idle."
+    )
+    try:
+        deliver_stored_message(
+            workspace,
+            leader_id,
+            content,
+            sender="coordinator",
+            requires_ack=False,
+            wait_visible=False,
+            team=owner_team_id,
+        )
+    except Exception as exc:
+        event_log.write("coordinator.idle_fallback_push_failed", error=str(exc), team=owner_team_id)
+    event_log.write(
+        "coordinator.idle_fallback",
+        team=owner_team_id,
+        idle_workers=idle_workers,
+        obligation_count=len(obligations),
+        alert_count=len(alerts),
+    )
+    return alerts
+
+
+def detect_cross_worker_deadlocks(
+    workspace: Path,
+    state: dict[str, Any],
+    store: MessageStore,
+    event_log: EventLog,
+    now: datetime | None = None,
+) -> list[dict[str, Any]]:
+    from team_agent.messaging.scheduler import (
+        _active_alert_suppression,
+        _agent_alert_snapshot,
+    )
+    now = now or datetime.now(timezone.utc)
+    owner_team_id = team_state_key(state)
+    health = store.agent_health(owner_team_id=owner_team_id)
+    candidate_recipients: dict[str, list[dict[str, Any]]] = {}
+    for message in store.messages(owner_team_id=owner_team_id):
+        if message.get("status") not in _UNDELIVERED_MESSAGE_STATUSES:
+            continue
+        recipient = message.get("recipient")
+        if not recipient:
+            continue
+        candidate_recipients.setdefault(str(recipient), []).append(message)
+    alerts: list[dict[str, Any]] = []
+    for agent_id, messages in candidate_recipients.items():
+        row = health.get(agent_id) or {}
+        status = str(row.get("status") or "").lower()
+        if status != "idle":
+            continue
+        suppression = _active_alert_suppression(state, store, event_log, agent_id, "cross_worker_deadlock")
+        if suppression:
+            continue
+        snapshot = _agent_alert_snapshot(state, store, agent_id, owner_team_id)
+        snapshot["pending_message_ids"] = sorted(str(m.get("message_id")) for m in messages)
+        _register_unified_alert(state, owner_team_id, agent_id, "cross_worker_deadlock", snapshot, "coordinator", now)
+        alerts.append(
+            {
+                "agent_id": agent_id,
+                "alert_type": "cross_worker_deadlock",
+                "pending_messages": snapshot["pending_message_ids"],
+            }
+        )
+    if not alerts:
+        return []
+    save_runtime_state(workspace, state)
+    event_log.write(
+        "coordinator.cross_worker_deadlock",
+        team=owner_team_id,
+        agent_ids=[alert["agent_id"] for alert in alerts],
+        alert_count=len(alerts),
+    )
+    return alerts

package/src/team_agent/messaging/internal_delivery.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from team_agent.messaging.deps import (
+    EventLog,
+    _runtime_lock,
+    load_spec,
+    select_runtime_state,
+    team_state_key,
+)
+from team_agent.messaging.send import _send_single_message_unlocked
+
+
+def deliver_stored_message(
+    workspace: Path,
+    target: str | None,
+    content: str,
+    *,
+    task_id: str | None = None,
+    sender: str = "coordinator",
+    requires_ack: bool = False,
+    wait_visible: bool = False,
+    timeout: float = 30.0,
+    team: str | None = None,
+) -> dict[str, Any]:
+    with _runtime_lock(workspace, "send"):
+        state = select_runtime_state(workspace, team)
+        spec_path = Path(state.get("spec_path", workspace / "team.spec.yaml"))
+        spec = load_spec(spec_path)
+        return _send_single_message_unlocked(
+            workspace,
+            state,
+            spec,
+            EventLog(workspace),
+            target,
+            content,
+            task_id=task_id,
+            sender=sender,
+            requires_ack=requires_ack,
+            wait_visible=wait_visible,
+            timeout=timeout,
+            route_task_id=False,
+            owner_team_id=team_state_key(state),
+        )