crewdeck 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

crewdeck/client.py

@@ -240,16 +240,19 @@ class EventsAPI:
         message: Optional[str] = None,
         task_id: Optional[str] = None,
         metadata: Optional[Dict[str, Any]] = None,
-    ) -> None:
+    ) -> Dict[str, Any]:
         """
         Send an event to the live feed.
         
         Args:
-            type: Event type (message, status, log)
+            type: Event type (message, status, log, spawn, complete)
             agent_name: Agent name (optional)
             message: Message content
             task_id: Related task ID
             metadata: Additional metadata
+            
+        Returns:
+            Response data (may include taskId for spawn events)
         """
         event = Event(
             type=type,
@@ -258,7 +261,7 @@ class EventsAPI:
             task_id=task_id,
             metadata=metadata,
         )
-        self._client._request("POST", "/api/v1/events", json=event.to_dict())
+        return self._client._request("POST", "/api/v1/events", json=event.to_dict())
     
     def message(self, content: str, agent_name: Optional[str] = None) -> None:
         """
@@ -285,6 +288,97 @@ class EventsAPI:
             metadata: Additional data to log
         """
         self.send(type="log", message=message, agent_name=agent_name, metadata=metadata)
+    
+    def spawn(
+        self,
+        task: str,
+        agent_name: str,
+        spawned_by: Optional[str] = None,
+        description: Optional[str] = None,
+        priority: str = "medium",
+        tags: Optional[List[str]] = None,
+        label: Optional[str] = None,
+    ) -> str:
+        """
+        Spawn a task for an agent. Auto-creates the task and sets agent to working.
+        
+        Args:
+            task: Task title/description
+            agent_name: Agent to assign the task to
+            spawned_by: Name of agent/user that spawned this task
+            description: Detailed task description
+            priority: Task priority (low, medium, high, critical)
+            tags: Task tags
+            label: Optional label for tracking
+            
+        Returns:
+            Task ID of the created task
+            
+        Example:
+            task_id = deck.events.spawn(
+                task="Build the landing page",
+                agent_name="HAPPY",
+                spawned_by="JARVIS"
+            )
+        """
+        metadata: Dict[str, Any] = {
+            "task": task,
+            "agentName": agent_name,
+        }
+        if spawned_by:
+            metadata["spawnedBy"] = spawned_by
+        if description:
+            metadata["description"] = description
+        if priority:
+            metadata["priority"] = priority
+        if tags:
+            metadata["tags"] = tags
+        if label:
+            metadata["label"] = label
+            
+        response = self.send(
+            type="spawn",
+            agent_name=agent_name,
+            metadata=metadata,
+        )
+        return response.get("taskId", "")
+    
+    def complete(
+        self,
+        agent_name: str,
+        task_id: Optional[str] = None,
+        output: Optional[str] = None,
+        message: Optional[str] = None,
+    ) -> None:
+        """
+        Mark work as complete. Moves task to REVIEW and sets agent to idle.
+        
+        Args:
+            agent_name: Agent that completed the work
+            task_id: Task ID to complete (optional)
+            output: Task output/deliverables
+            message: Completion message for live feed
+            
+        Example:
+            deck.events.complete(
+                agent_name="HAPPY",
+                task_id="abc123",
+                output="Deployed to vercel: https://..."
+            )
+        """
+        metadata: Dict[str, Any] = {}
+        if task_id:
+            metadata["taskId"] = task_id
+        if output:
+            metadata["output"] = output
+            
+        self.send(
+            type="complete",
+            agent_name=agent_name,
+            message=message or output or "Work completed",
+            task_id=task_id,
+            metadata=metadata if metadata else None,
+        )
 
 
 class CrewDeck:
@@ -384,6 +478,58 @@ class CrewDeck:
         except httpx.RequestError as e:
             raise CrewDeckError(f"Request failed: {e}")
     
+    def spawn(
+        self,
+        task: str,
+        agent: str,
+        spawned_by: Optional[str] = None,
+        **kwargs,
+    ) -> str:
+        """
+        Spawn a task for an agent. Convenience wrapper for events.spawn().
+        
+        Args:
+            task: Task title/description
+            agent: Agent to assign the task to
+            spawned_by: Name of agent/user that spawned this task
+            **kwargs: Additional args passed to events.spawn()
+            
+        Returns:
+            Task ID of the created task
+            
+        Example:
+            task_id = deck.spawn("Build landing page", "HAPPY", spawned_by="JARVIS")
+        """
+        return self.events.spawn(
+            task=task,
+            agent_name=agent,
+            spawned_by=spawned_by,
+            **kwargs,
+        )
+    
+    def complete(
+        self,
+        agent: str,
+        task_id: Optional[str] = None,
+        output: Optional[str] = None,
+    ) -> None:
+        """
+        Mark work as complete. Convenience wrapper for events.complete().
+        
+        Args:
+            agent: Agent that completed the work
+            task_id: Task ID to complete (optional)
+            output: Task output/deliverables
+            
+        Example:
+            deck.complete("HAPPY", task_id, output="Deployed to https://...")
+        """
+        self.events.complete(
+            agent_name=agent,
+            task_id=task_id,
+            output=output,
+        )
+    
     def close(self) -> None:
         """Close the HTTP client"""
         self._client.close()

{crewdeck-0.1.0.dist-info → crewdeck-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crewdeck
-Version: 0.1.0
+Version: 0.2.0
 Summary: Python SDK for CrewDeck - AI agent management dashboard
 Project-URL: Homepage, https://crewdeck.dev
 Project-URL: Documentation, https://docs.crewdeck.dev
@@ -147,6 +147,49 @@ deck.events.send(
 )
 ```
 
+### Spawn & Complete (Recommended)
+
+The easiest way to manage agent tasks — auto-creates tasks and updates status:
+
+```python
+# Spawn a task for an agent
+# Creates task, assigns to agent, sets status IN_PROGRESS, agent → working
+task_id = deck.spawn(
+    task="Build the landing page",
+    agent="HAPPY",
+    spawned_by="JARVIS"  # optional: who requested this
+)
+
+# ... agent does the work ...
+
+# Mark complete
+# Moves task to REVIEW, sets agent → idle
+deck.complete(
+    agent="HAPPY",
+    task_id=task_id,
+    output="Deployed to https://crewdeck.dev"
+)
+```
+
+Or use the events API directly:
+
+```python
+# Spawn via events
+task_id = deck.events.spawn(
+    task="Analyze user feedback",
+    agent_name="FRIDAY",
+    priority="high",
+    tags=["research", "urgent"]
+)
+
+# Complete via events
+deck.events.complete(
+    agent_name="FRIDAY",
+    task_id=task_id,
+    output="Analysis complete: 85% positive sentiment"
+)
+```
+
 ## Integration Examples
 
 ### CrewAI

crewdeck-0.2.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+crewdeck/__init__.py,sha256=gacJzO7ee1B2wvd0oyX4VC8SFiDLnD2ophYHMgAE8Hg,905
+crewdeck/client.py,sha256=d8r6bOcTUBlZgmU7x8NbIa4iNAOCeXdYjZdeceQM2tY,15661
+crewdeck/exceptions.py,sha256=vOvYYdlP0wvkuuUhYE5Wj2pnuJXqmCiYcs5cobdijDM,763
+crewdeck/models.py,sha256=-2cScY_4I-0wg33S5Pa3EfKBx7tSdrCOMU2RPTXjIpw,3182
+crewdeck-0.2.0.dist-info/METADATA,sha256=Fgoyi3mNfMYM40huwy7p9GPwsaVSgoakVbVNAii_OFo,6809
+crewdeck-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+crewdeck-0.2.0.dist-info/licenses/LICENSE,sha256=z0AZu5f134PY4UJ0L_nPuqlyZa14gMPIR-4u8M-5qjI,1065
+crewdeck-0.2.0.dist-info/RECORD,,

crewdeck-0.1.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-crewdeck/__init__.py,sha256=gacJzO7ee1B2wvd0oyX4VC8SFiDLnD2ophYHMgAE8Hg,905
-crewdeck/client.py,sha256=ZcrLjDcCCscoQj2rFsGMJ-FTZOmu0YeAhQF1oX7EzP4,11266
-crewdeck/exceptions.py,sha256=vOvYYdlP0wvkuuUhYE5Wj2pnuJXqmCiYcs5cobdijDM,763
-crewdeck/models.py,sha256=-2cScY_4I-0wg33S5Pa3EfKBx7tSdrCOMU2RPTXjIpw,3182
-crewdeck-0.1.0.dist-info/METADATA,sha256=I5IPqTQoAuF7A3cRwUfo1wgOTtPAtoTzh8oMRv6XFjQ,5884
-crewdeck-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-crewdeck-0.1.0.dist-info/licenses/LICENSE,sha256=z0AZu5f134PY4UJ0L_nPuqlyZa14gMPIR-4u8M-5qjI,1065
-crewdeck-0.1.0.dist-info/RECORD,,