crewdeck 0.1.0__tar.gz → 0.2.0__tar.gz

crewdeck-0.2.0/.gitignore

@@ -0,0 +1,7 @@
+-e 
+# Build
+dist/
+*.egg-info/
+.venv/
+__pycache__/
+*.pyc

{crewdeck-0.1.0 → crewdeck-0.2.0}/PKG-INFO

@@ -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.1.0 → crewdeck-0.2.0}/README.md

@@ -115,6 +115,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.1.0 → crewdeck-0.2.0}/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 → crewdeck-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "crewdeck"
-version = "0.1.0"
+version = "0.2.0"
 description = "Python SDK for CrewDeck - AI agent management dashboard"
 readme = "README.md"
 license = "MIT"