machinaos 0.0.78 → 0.0.80

package/server/nodes/tool/{calculator_tool.py → calculator_tool/__init__.py}

@@ -26,7 +26,14 @@ class CalculatorParams(BaseModel):
     the function-calling model reads these."""
 
     operation: Literal[
-        "add", "subtract", "multiply", "divide", "power", "sqrt", "mod", "abs",
+        "add",
+        "subtract",
+        "multiply",
+        "divide",
+        "power",
+        "sqrt",
+        "mod",
+        "abs",
     ] = Field(..., description="Math operation to perform.")
     a: float = Field(..., description="First operand (or the sole input for sqrt/abs).")
     b: Optional[float] = Field(
@@ -61,11 +68,11 @@ class CalculatorToolNode(ToolNode):
     group = ("tool", "ai")
     description = "Add, subtract, multiply, divide, power, sqrt, mod, abs"
     component_kind = "tool"
+    tool_name = "calculator"
+    tool_description = "Perform mathematical calculations. Operations: add, subtract, multiply, divide, power, sqrt, mod, abs"
     handles = (
-        {"name": "input-main", "kind": "input", "position": "left",
-         "label": "Input", "role": "main"},
-        {"name": "output-tool", "kind": "output", "position": "top",
-         "label": "Tool", "role": "tools"},
+        {"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
+        {"name": "output-tool", "kind": "output", "position": "top", "label": "Tool", "role": "tools"},
     )
     ui_hints = {"isToolPanel": True, "hideRunButton": True}
     annotations = {"destructive": False, "readonly": True, "open_world": False}
@@ -75,11 +82,16 @@ class CalculatorToolNode(ToolNode):
 
     @Operation("calculate")
     async def calculate(
-        self, ctx: NodeContext, params: CalculatorParams,
+        self,
+        ctx: NodeContext,
+        params: CalculatorParams,
     ) -> CalculatorOutput:
         fn = _OPERATIONS[params.operation]
         b_value = params.b if params.b is not None else 0.0
         result = fn(params.a, b_value)
         return CalculatorOutput(
-            operation=params.operation, a=params.a, b=params.b, result=result,
+            operation=params.operation,
+            a=params.a,
+            b=params.b,
+            result=result,
         )

package/server/nodes/tool/calculator_tool/meta.json

@@ -0,0 +1,3 @@
+{
+  "color": "#f1fa8c"
+}

package/server/nodes/tool/{current_time_tool.py → current_time_tool/__init__.py}

@@ -30,11 +30,11 @@ class CurrentTimeToolNode(ToolNode):
     group = ("tool", "ai")
     description = "Get current date/time with timezone support"
     component_kind = "tool"
+    tool_name = "get_current_time"
+    tool_description = "Get the current date and time. Optionally specify timezone."
     handles = (
-        {"name": "input-main", "kind": "input", "position": "left",
-         "label": "Input", "role": "main"},
-        {"name": "output-tool", "kind": "output", "position": "top",
-         "label": "Tool", "role": "tools"},
+        {"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
+        {"name": "output-tool", "kind": "output", "position": "top", "label": "Tool", "role": "tools"},
     )
     ui_hints = {"isToolPanel": True, "hideRunButton": True}
     annotations = {"destructive": False, "readonly": True, "open_world": False}
@@ -47,9 +47,11 @@ class CurrentTimeToolNode(ToolNode):
     async def now(self, ctx: NodeContext, params: CurrentTimeParams) -> CurrentTimeOutput:
         try:
             from zoneinfo import ZoneInfo
+
             tz = ZoneInfo(params.timezone)
         except Exception:
             from zoneinfo import ZoneInfo
+
             tz = ZoneInfo("UTC")
         now = datetime.now(tz)
         return CurrentTimeOutput(

package/server/nodes/tool/current_time_tool/meta.json

@@ -0,0 +1,3 @@
+{
+  "color": "#f1fa8c"
+}

package/server/nodes/tool/{task_manager.py → task_manager/__init__.py}

@@ -46,11 +46,11 @@ class TaskManagerNode(ToolNode):
     group = ("tool", "ai")
     description = "Task management tool for AI agents to create, track, and manage tasks"
     component_kind = "tool"
+    tool_name = "task_manager"
+    tool_description = "Track delegated sub-agent tasks. Operations: list_tasks (see all tasks), get_task (check specific task status/result), mark_done (cleanup completed tasks)."
     handles = (
-        {"name": "input-main", "kind": "input", "position": "left",
-         "label": "Input", "role": "main"},
-        {"name": "output-tool", "kind": "output", "position": "top",
-         "label": "Tool", "role": "tools"},
+        {"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
+        {"name": "output-tool", "kind": "output", "position": "top", "label": "Tool", "role": "tools"},
     )
     ui_hints = {"isToolPanel": True, "hideRunButton": True}
     annotations = {"destructive": True, "readonly": False, "open_world": False}
@@ -62,7 +62,8 @@ class TaskManagerNode(ToolNode):
     @Operation("manage")
     async def manage(self, ctx: NodeContext, params: TaskManagerParams) -> Any:
         return await _execute_task_manager(
-            params.model_dump(), {"node_id": ctx.node_id, "workspace_dir": ctx.workspace_dir or ""},
+            params.model_dump(),
+            {"node_id": ctx.node_id, "workspace_dir": ctx.workspace_dir or ""},
         )
 
 
@@ -96,9 +97,7 @@ async def _execute_task_manager(
     status_filter = tool_args.get("status_filter") or params.get("status_filter")
     database = config.get("database")
 
-    logger.debug(
-        f"[TaskManager] Operation: {operation}, task_id: {task_id}, filter: {status_filter}"
-    )
+    logger.debug(f"[TaskManager] Operation: {operation}, task_id: {task_id}, filter: {status_filter}")
 
     if operation == "list_tasks":
         tasks = []
@@ -123,13 +122,15 @@ async def _execute_task_manager(
         # Completed tasks from in-memory cache.
         for tid, result in _delegation_results.items():
             if tid not in [t["task_id"] for t in tasks]:
-                tasks.append({
-                    "task_id": tid,
-                    "status": result.get("status", "completed"),
-                    "agent_name": result.get("agent_name"),
-                    "result_summary": str(result.get("result", ""))[:200],
-                    "active": False,
-                })
+                tasks.append(
+                    {
+                        "task_id": tid,
+                        "status": result.get("status", "completed"),
+                        "agent_name": result.get("agent_name"),
+                        "result_summary": str(result.get("result", ""))[:200],
+                        "active": False,
+                    }
+                )
 
         if status_filter:
             tasks = [t for t in tasks if t.get("status") == status_filter]
@@ -188,9 +189,7 @@ async def _execute_task_manager(
             "task_id": task_id,
             "removed": removed,
             "message": (
-                f"Task {task_id} marked as done and removed from tracking"
-                if removed
-                else f"Task {task_id} was not in active tracking"
+                f"Task {task_id} marked as done and removed from tracking" if removed else f"Task {task_id} was not in active tracking"
             ),
         }
 

package/server/nodes/tool/task_manager/meta.json

@@ -0,0 +1,3 @@
+{
+  "color": "#f1fa8c"
+}

package/server/nodes/tool/{write_todos.py → write_todos/__init__.py}

@@ -35,11 +35,22 @@ class WriteTodosNode(ToolNode):
     group = ("tool", "ai")
     description = "Structured task list planning for complex multi-step operations"
     component_kind = "tool"
+    tool_name = "write_todos"
+    tool_description = (
+        "Create and manage a structured task list for your current work session. "
+        "This helps you track progress, organize complex tasks, and demonstrate "
+        "thoroughness to the user. Only use this tool if you think it will be "
+        "helpful in staying organized. If the user's request is trivial and takes "
+        "less than 3 steps, it is better to NOT use this tool and just do the task "
+        "directly. Use for complex multi-step tasks (3+ steps), non-trivial planning, "
+        "or when user explicitly requests a todo list. Task states: pending, "
+        "in_progress, completed. Mark tasks as in_progress BEFORE beginning work, "
+        "completed IMMEDIATELY after finishing. Remove irrelevant tasks. Break "
+        "complex tasks into smaller steps."
+    )
     handles = (
-        {"name": "input-main", "kind": "input", "position": "left",
-         "label": "Input", "role": "main"},
-        {"name": "output-tool", "kind": "output", "position": "top",
-         "label": "Tool", "role": "tools"},
+        {"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
+        {"name": "output-tool", "kind": "output", "position": "top", "label": "Tool", "role": "tools"},
     )
     ui_hints = {"isToolPanel": True, "hideRunButton": True}
     annotations = {"destructive": False, "readonly": False, "open_world": False}
@@ -62,13 +73,16 @@ class WriteTodosNode(ToolNode):
         broadcaster = ctx.raw.get("broadcaster")
         if broadcaster:
             await broadcaster.update_node_status(
-                ctx.node_id, "executing",
+                ctx.node_id,
+                "executing",
                 {"phase": "todo_update", "todos": stored},
                 workflow_id=ctx.workflow_id,
             )
 
         get_logger(__name__).info(
-            "[WriteTodos] Updated %d todos (session=%s)", len(stored), session_key,
+            "[WriteTodos] Updated %d todos (session=%s)",
+            len(stored),
+            session_key,
         )
         return {
             "message": f"Updated todo list ({len(stored)} items)",

package/server/nodes/tool/write_todos/meta.json

@@ -0,0 +1,3 @@
+{
+  "color": "#bd93f9"
+}

package/server/nodes/trigger/{chat_trigger.py → chat_trigger/__init__.py}

@@ -17,6 +17,7 @@ from typing import Any, Callable, Dict, Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 
+from services.deployment.canary_registry import register_canary_trigger_type
 from services.plugin import NodeContext, Operation, TaskQueue, TriggerNode
 
 
@@ -42,10 +43,7 @@ class ChatTriggerNode(TriggerNode):
     group = ("utility", "trigger")
     description = "Trigger workflow when user sends a chat message from the console input"
     component_kind = "trigger"
-    handles = (
-        {"name": "output-main", "kind": "output", "position": "right",
-         "label": "Output", "role": "main"},
-    )
+    handles = ({"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},)
     ui_hints = {"isChatTrigger": True}
     task_queue = TaskQueue.TRIGGERS_EVENT
     mode = "event"
@@ -66,6 +64,12 @@ class ChatTriggerNode(TriggerNode):
 
     @Operation("wait")
     async def wait(self, ctx: NodeContext, params: ChatTriggerParams) -> ChatTriggerOutput:
-        raise NotImplementedError(
-            "Event triggers return via TriggerNode.execute, not the op body"
-        )
+        raise NotImplementedError("Event triggers return via TriggerNode.execute, not the op body")
+
+
+# Wave 12 C1 rollout #1: opt this trigger into the TriggerListenerWorkflow
+# consumer path. Producer side: dispatch_chat_message_received in
+# ./_events.py calls dispatch.emit unconditionally; the canary registry
+# tells DeploymentManager to start a listener for this type. See
+# services/deployment/canary_registry.py.
+register_canary_trigger_type(ChatTriggerNode.type, "com.machinaos.chat.message.received")

package/server/nodes/trigger/chat_trigger/_events.py

@@ -0,0 +1,53 @@
+"""CloudEvents factory + dispatch wrapper for chat_trigger.
+
+Per RFC plugin_authoring_rfc.md §6.4: plugin-specific factories live in
+the plugin folder.
+
+Delivery: single ``dispatch.emit`` call routes events to running
+:class:`TriggerListenerWorkflow` consumers via Temporal Visibility AND
+broadcasts the envelope to FE on the ``chat_message_received`` wire key.
+chatTrigger is canary-registered (see ``nodes/trigger/chat_trigger/__init__.py``)
+so the deployment manager skips ``setup_event_trigger`` and the legacy
+``event_waiter.dispatch`` path has zero consumers — removed.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Mapping
+
+from services.events.envelope import WorkflowEvent
+
+
+# Outer wire-routing key. Matches ``ChatTriggerNode.event_type`` and the
+# FE WS channel; the inner envelope carries
+# ``com.machinaos.chat.message.received``.
+_WIRE_ROUTING_KEY = "chat_message_received"
+
+
+def chat_message_received(event_data: Mapping[str, Any]) -> WorkflowEvent:
+    """Incoming chat message envelope. ``subject`` is the session_id so
+    consumers can route per-conversation."""
+    payload = dict(event_data)
+    session_id = payload.get("session_id")
+    return WorkflowEvent(
+        source="machinaos://nodes/chat_trigger",
+        type="com.machinaos.chat.message.received",
+        subject=str(session_id) if session_id else None,
+        data=payload,
+    )
+
+
+async def dispatch_chat_message_received(event_data: Mapping[str, Any]) -> None:
+    """Dispatch an incoming chat message via the canary CloudEvents path."""
+    from services.events.dispatch import emit
+
+    await emit(
+        chat_message_received(dict(event_data)),
+        wire_routing_key=_WIRE_ROUTING_KEY,
+    )
+
+
+__all__ = [
+    "chat_message_received",
+    "dispatch_chat_message_received",
+]

package/server/nodes/trigger/chat_trigger/meta.json

@@ -0,0 +1,3 @@
+{
+  "color": "#ffb86c"
+}

package/server/nodes/trigger/{task_trigger.py → task_trigger/__init__.py}

@@ -11,6 +11,7 @@ from typing import Any, Callable, Dict, Literal, Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 
+from services.deployment.canary_registry import register_canary_trigger_type
 from services.plugin import NodeContext, Operation, TaskQueue, TriggerNode
 
 
@@ -43,10 +44,7 @@ class TaskTriggerNode(TriggerNode):
     group = ("trigger", "workflow")
     description = "Triggers when a delegated child agent completes its task (success or error)"
     component_kind = "trigger"
-    handles = (
-        {"name": "output-main", "kind": "output", "position": "right",
-         "label": "Output", "role": "main"},
-    )
+    handles = ({"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},)
     task_queue = TaskQueue.TRIGGERS_EVENT
     mode = "event"
     event_type = "task_completed"
@@ -75,6 +73,11 @@ class TaskTriggerNode(TriggerNode):
 
     @Operation("wait")
     async def wait(self, ctx: NodeContext, params: TaskTriggerParams) -> TaskTriggerOutput:
-        raise NotImplementedError(
-            "Event triggers return via TriggerNode.execute, not the op body"
-        )
+        raise NotImplementedError("Event triggers return via TriggerNode.execute, not the op body")
+
+
+# Wave 12 C1 rollout #2: opt this trigger into the TriggerListenerWorkflow
+# consumer path. The producer side lives in nodes/agent/_events.py
+# (broadcast_agent_task_completed / _failed dual-emit via dispatch.emit).
+# See services/deployment/canary_registry.py for the contract.
+register_canary_trigger_type(TaskTriggerNode.type, "com.machinaos.agent.task.completed")

package/server/nodes/trigger/task_trigger/meta.json

@@ -0,0 +1,3 @@
+{
+  "color": "#ffb86c"
+}

package/server/nodes/trigger/{webhook_trigger.py → webhook_trigger/__init__.py}

@@ -23,6 +23,7 @@ from typing import Any, Callable, Dict, Literal, Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 
+from services.deployment.canary_registry import register_canary_trigger_type
 from services.plugin import NodeContext, Operation, TriggerNode, TaskQueue
 
 
@@ -78,10 +79,7 @@ class WebhookTriggerNode(TriggerNode):
     group = ("trigger",)
     description = "Start workflow when HTTP request is received"
     component_kind = "trigger"
-    handles = (
-        {"name": "output-main", "kind": "output", "position": "right",
-         "label": "Output", "role": "main"},
-    )
+    handles = ({"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},)
     task_queue = TaskQueue.TRIGGERS_EVENT
     mode = "event"
     event_type = "webhook_received"
@@ -105,6 +103,11 @@ class WebhookTriggerNode(TriggerNode):
     # stub operation so invariants see it.
     @Operation("wait")
     async def wait(self, ctx: NodeContext, params: WebhookTriggerParams) -> WebhookTriggerOutput:
-        raise NotImplementedError(
-            "Event triggers return via TriggerNode.execute, not the op body"
-        )
+        raise NotImplementedError("Event triggers return via TriggerNode.execute, not the op body")
+
+
+# Wave 12 C1 canary: opt this trigger type into TriggerListenerWorkflow.
+# Gated runtime by Settings.event_framework_enabled in DeploymentManager;
+# the producer side (broadcast_webhook_received calling dispatch.emit) is
+# unconditional. See services/deployment/canary_registry.py.
+register_canary_trigger_type(WebhookTriggerNode.type, "com.machinaos.webhook.received")

package/server/nodes/trigger/webhook_trigger/_events.py

@@ -0,0 +1,54 @@
+"""CloudEvents factory + broadcaster wrapper for webhook_trigger.
+
+Per RFC plugin_authoring_rfc.md §6.4: plugin-specific factories live in
+the plugin folder.
+
+Delivery: single ``dispatch.emit`` call routes events to running
+:class:`TriggerListenerWorkflow` consumers via Temporal Visibility AND
+broadcasts the envelope to FE on the ``webhook_received`` wire key.
+webhookTrigger is canary-registered (see ``nodes/trigger/webhook_trigger/__init__.py``)
+so the deployment manager skips ``setup_event_trigger`` and the legacy
+``broadcaster.send_custom_event`` path (which dispatched to
+``event_waiter``) has zero consumers — removed.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Mapping
+
+from services.events.envelope import WorkflowEvent
+
+
+# Outer wire-routing key. Matches ``WebhookTriggerNode.event_type`` and
+# the FE WS channel; the inner envelope carries
+# ``com.machinaos.webhook.received``.
+_WIRE_ROUTING_KEY = "webhook_received"
+
+
+def webhook_received(webhook_data: Mapping[str, Any]) -> WorkflowEvent:
+    """Incoming webhook envelope. ``subject`` is the path so consumers
+    can route per-endpoint."""
+    payload = dict(webhook_data)
+    path = payload.get("path")
+    return WorkflowEvent(
+        source="machinaos://nodes/webhook_trigger",
+        type="com.machinaos.webhook.received",
+        subject=str(path) if path else None,
+        data=payload,
+    )
+
+
+async def broadcast_webhook_received(webhook_data: Mapping[str, Any]) -> None:
+    """Broadcast an incoming webhook via the canary CloudEvents path."""
+    from services.events.dispatch import emit
+
+    await emit(
+        webhook_received(dict(webhook_data)),
+        wire_routing_key=_WIRE_ROUTING_KEY,
+    )
+
+
+__all__ = [
+    "broadcast_webhook_received",
+    "webhook_received",
+]

package/server/nodes/trigger/webhook_trigger/meta.json

@@ -0,0 +1,3 @@
+{
+  "color": "#ffb86c"
+}

package/server/nodes/twitter/__init__.py

@@ -20,9 +20,14 @@ module by name.
 
 from services.event_waiter import register_filter_builder
 from services.status_broadcaster import register_service_refresh
-from services.ws_handler_registry import register_router, register_ws_handlers
+from services.ws_handler_registry import (
+    register_oauth_callback_path,
+    register_router,
+    register_ws_handlers,
+)
 
 from . import _router
+from ._events import dispatch_twitter_event_received  # noqa: F401 — re-export
 from ._filters import build_filter as build_twitter_filter
 from ._handlers import WS_HANDLERS
 from ._refresh import refresh_twitter_status
@@ -34,5 +39,6 @@ from ._refresh import refresh_twitter_status
 # (milestone K).
 register_ws_handlers(WS_HANDLERS)
 register_router(_router.router, name="twitter")
+register_oauth_callback_path("twitter", "/api/twitter/callback")
 register_service_refresh(refresh_twitter_status)
 register_filter_builder("twitterReceive", build_twitter_filter)