cowork-dash 0.1.3__py3-none-any.whl → 0.1.5__py3-none-any.whl

cowork_dash/tools.py

@@ -6,7 +6,7 @@ import subprocess
 from contextlib import redirect_stdout, redirect_stderr
 
 from .config import WORKSPACE_ROOT
-from .canvas import parse_canvas_object
+from .canvas import parse_canvas_object, generate_canvas_id
 
 
 # =============================================================================
@@ -592,46 +592,123 @@ def clear_notebook_canvas_items() -> Dict[str, Any]:
 # CANVAS TOOLS
 # =============================================================================
 
-def add_to_canvas(content: Any) -> Dict[str, Any]:
+def add_to_canvas(content: Any, title: Optional[str] = None, item_id: Optional[str] = None) -> Dict[str, Any]:
     """Add an item to the canvas for visualization. Canvas is like a note-taking tool where
     you can store charts, dataframes, images, and markdown text for the user to see.
 
     Args:
         content: Can be a pandas DataFrame, matplotlib Figure, plotly Figure,
                 PIL Image, dictionary (for Plotly JSON), or string (for Markdown)
-        workspace_root: Path to the workspace root directory
+        title: Optional title for the canvas item (displayed as a header)
+        item_id: Optional unique ID for the item. If provided, can be used to update
+                or remove the item later. Auto-generated if not provided.
 
     Returns:
-        Dictionary with the parsed canvas object
+        Dictionary with the parsed canvas object including its id, type, and data
 
     Examples:
-        # Add a DataFrame
+        # Add a DataFrame with a title
         import pandas as pd
         df = pd.DataFrame({"A": [1, 2, 3], "B": [4, 5, 6]})
-        add_to_canvas(df)
+        add_to_canvas(df, title="Sales Data")
 
-        # Add a Matplotlib chart
+        # Add a Matplotlib chart with a custom ID for later updates
         import matplotlib.pyplot as plt
         fig, ax = plt.subplots()
         ax.plot([1, 2, 3], [1, 4, 9])
-        add_to_canvas(fig)
+        add_to_canvas(fig, title="Growth Chart", item_id="growth_chart")
 
         # Add Markdown text
-        add_to_canvas("## Key Findings\\n- Point 1\\n- Point 2")
+        add_to_canvas("## Key Findings\\n- Point 1\\n- Point 2", title="Summary")
+
+        # Update an existing item by using the same ID
+        add_to_canvas(new_fig, item_id="growth_chart")  # Replaces the previous chart
     """
     try:
-        # Parse the content into canvas format
-        parsed = parse_canvas_object(content, workspace_root=WORKSPACE_ROOT)
+        # Parse the content into canvas format with optional title and ID
+        parsed = parse_canvas_object(
+            content,
+            workspace_root=WORKSPACE_ROOT,
+            title=title,
+            item_id=item_id
+        )
         # Return the parsed object (deepagents will handle the JSON serialization)
         return parsed
     except Exception as e:
         return {
             "type": "error",
+            "id": item_id or generate_canvas_id(),
             "data": f"Failed to add to canvas: {str(e)}",
             "error": str(e)
         }
 
 
+def update_canvas_item(item_id: str, content: Any, title: Optional[str] = None) -> Dict[str, Any]:
+    """Update an existing canvas item by its ID. If the item doesn't exist, it will be added.
+
+    This is useful for updating charts or data that change over time, like progress
+    indicators, live data visualizations, or iteratively refined content.
+
+    Args:
+        item_id: The unique ID of the canvas item to update
+        content: The new content (DataFrame, Figure, Image, string, etc.)
+        title: Optional new title for the item
+
+    Returns:
+        Dictionary with the updated canvas object
+
+    Examples:
+        # Create an initial chart
+        add_to_canvas(initial_fig, title="Progress", item_id="progress_chart")
+
+        # Later, update it with new data
+        update_canvas_item("progress_chart", updated_fig)
+
+        # Update with a new title too
+        update_canvas_item("progress_chart", final_fig, title="Final Results")
+    """
+    try:
+        parsed = parse_canvas_object(
+            content,
+            workspace_root=WORKSPACE_ROOT,
+            title=title,
+            item_id=item_id
+        )
+        parsed["_action"] = "update"  # Signal to app.py to update existing item
+        return parsed
+    except Exception as e:
+        return {
+            "type": "error",
+            "id": item_id,
+            "_action": "update",
+            "data": f"Failed to update canvas item: {str(e)}",
+            "error": str(e)
+        }
+
+
+def remove_canvas_item(item_id: str) -> Dict[str, Any]:
+    """Remove a canvas item by its ID.
+
+    Args:
+        item_id: The unique ID of the canvas item to remove
+
+    Returns:
+        Dictionary confirming the removal action
+
+    Examples:
+        # Add a temporary notification
+        add_to_canvas("Processing...", title="Status", item_id="status_msg")
+
+        # Remove it when done
+        remove_canvas_item("status_msg")
+    """
+    return {
+        "type": "remove",
+        "id": item_id,
+        "_action": "remove"
+    }
+
+
 # =============================================================================
 # BASH TOOL
 # =============================================================================

{cowork_dash-0.1.3.dist-info → cowork_dash-0.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cowork-dash
-Version: 0.1.3
+Version: 0.1.5
 Summary: AI Agent Web Interface with Filesystem and Canvas Visualization
 Project-URL: Homepage, https://github.com/dkedar7/cowork-dash
 Project-URL: Documentation, https://github.com/dkedar7/cowork-dash/blob/main/README.md
@@ -51,6 +51,11 @@ Description-Content-Type: text/markdown
 
 A web interface for AI agent interactions with filesystem workspace, canvas visualization, and real-time streaming.
 
+<p align="center">
+  <img src="docs/light.png" alt="Cowork Dash - Light Mode" width="48%">
+  <img src="docs/dark.png" alt="Cowork Dash - Dark Mode" width="48%">
+</p>
+
 ## Features
 
 - **AI Agent Chat**: Real-time streaming with thinking process and task progress
@@ -58,6 +63,15 @@ A web interface for AI agent interactions with filesystem workspace, canvas visu
 - **Canvas**: Visualize DataFrames, Plotly/Matplotlib charts, Mermaid diagrams, images
 - **Flexible Configuration**: Environment variables, CLI args, or config file
 
+## Demo
+
+<p align="center">
+  <em>Organizing files with an AI agent</em><br><br>
+  <a href="https://www.youtube.com/watch?v=yKB9cBx80VE">
+    <img src="https://img.youtube.com/vi/yKB9cBx80VE/maxresdefault.jpg" alt="Cowork Dash Demo Video" width="70%">
+  </a>
+</p>
+
 ## Quick Start
 
 ### Installation
@@ -68,7 +82,7 @@ pip install cowork-dash
 
 # Or run directly with uvx (no installation needed)
 export ANTHROPIC_API_KEY="your_anthropic_api_key"
-uvx cowork-dash run --workspace ~/my-workspace
+cowork-dash run
 ```
 
 ### Run
@@ -100,19 +114,6 @@ Open browser to `http://localhost:8050`
 2. **Environment Variables** - `DEEPAGENT_*`
 3. **Config File** - `config.py` defaults
 
-### Environment Variables (optional)
-
-```bash
-export DEEPAGENT_SPEC=my_agent.py:agent         # Set any Langgraph agent
-export DEEPAGENT_WORKSPACE_ROOT=/path/to/workspace
-export DEEPAGENT_PORT=9000                      # optional (default: 8050)
-export DEEPAGENT_HOST=0.0.0.0                   # optional (default: localhost)
-export DEEPAGENT_DEBUG=true                     # optional (default: false)
-export DEEPAGENT_APP_TITLE="My App"             # optional
-export DEEPAGENT_APP_SUBTITLE="Subtitle"        # optional
-
-cowork-dash run
-```
 
 ### CLI Options (all optional)
 
@@ -120,12 +121,26 @@ cowork-dash run
 cowork-dash run [OPTIONS]
 
   --workspace PATH        Workspace directory (default: current directory)
-  --agent PATH:OBJECT     Agent spec (default: none, manual mode)
+  --agent PATH:OBJECT     Point to your Langgraph agent (default: default agent, manual mode)
   --port PORT            Server port (default: 8050)
   --host HOST            Server host (default: localhost)
   --debug                Enable debug mode
   --title TITLE          App title (default: "Cowork Dash")
   --subtitle TEXT        App subtitle (default: "AI-Powered Workspace")
+  --welcome-message TEXT Welcome message shown in chat (supports markdown)
+```
+
+### Environment Variables (optional)
+
+```bash
+export DEEPAGENT_SPEC=my_agent.py:agent         # Set any Langgraph agent
+export DEEPAGENT_WORKSPACE_ROOT=/path/to/workspace
+export DEEPAGENT_DEBUG=true                     # optional (default: false)
+export DEEPAGENT_APP_TITLE="My App"             # optional
+export DEEPAGENT_APP_SUBTITLE="Subtitle"        # optional
+export DEEPAGENT_WELCOME_MESSAGE="Hello!"       # optional (supports markdown)
+
+cowork-dash run
 ```
 
 ### Python API
@@ -141,27 +156,10 @@ run_app(agent, workspace="~/my-workspace")
 # Option 2: Use agent spec
 run_app(agent_spec="my_agent.py:agent", workspace="~/my-workspace")
 
-# Option 3: Manual mode (no agent)
-run_app(workspace="~/my-workspace", port=8080, debug=True)
 ```
 
 ## Agent Integration
 
-### Workspace Access
-
-Cowork Dash sets `DEEPAGENT_WORKSPACE_ROOT` environment variable for your agent:
-
-```python
-import os
-from pathlib import Path
-
-# In your agent code
-workspace = Path(os.getenv('DEEPAGENT_WORKSPACE_ROOT', './'))
-
-# Read/write files in workspace
-config_file = workspace / "config.json"
-```
-
 ### Agent Specification
 
 Load agents using `path:object` format:
@@ -174,13 +172,6 @@ cowork-dash run --agent agent.py:my_agent
 cowork-dash run --agent /path/to/agent.py:agent_instance
 ```
 
-### Agent Requirements
-
-Your agent must implement:
-- **Streaming**: `agent.stream(input, stream_mode="updates")`
-- **Message format**: `{"messages": [{"role": "user", "content": "..."}]}`
-- **Workspace access** (optional): Read `DEEPAGENT_WORKSPACE_ROOT` env var
-
 ### Example Agent Setup
 
 ```python

cowork_dash-0.1.5.dist-info/RECORD

@@ -0,0 +1,20 @@
+cowork_dash/__init__.py,sha256=37qBKl7g12Zos8GFukXLXligCdpD32e2qe9F8cd8Qdk,896
+cowork_dash/__main__.py,sha256=CCM9VIkWuwh7hwVGNBBgCCbeVAcHj1soyBVXUaPgABk,131
+cowork_dash/agent.py,sha256=A0fz8KEP3iJVm7tTJBGxiBB5q3ArRmeUJdNoAoK8cPQ,4368
+cowork_dash/app.py,sha256=Pcp5l-YWv2f_guH5ol78kQqBlV_TsscEpJyS132565k,95651
+cowork_dash/canvas.py,sha256=sF00c0amtF5AayLG8JKMSPwKEumNfDXd6r6gSDfvTHk,15446
+cowork_dash/cli.py,sha256=RlTRp1VB8f8xbFo_rrNly0COIMMGO0IZi3TYXP3yTCI,6719
+cowork_dash/components.py,sha256=3Nb9zblt3c3cHuE4mP6jLCJI-vALGxcpNqlQ1Sbr_rE,23832
+cowork_dash/config.py,sha256=v-qdQUtWgJE8nYxMgSquMBlWS_tMTfoYx5oPSJt0V30,3774
+cowork_dash/file_utils.py,sha256=R1Pzr05iLfzPgPKIMplF6upTX1sJy1xzMTQ7gjsVesA,9108
+cowork_dash/layout.py,sha256=GQEd_paz4XTVTQqfLYfyabknDMffze3Wor3umuUyhxQ,16003
+cowork_dash/tools.py,sha256=pHX8PhsY70YwCF5JZfb7vZLoc5c89QWQB6T6OhR5svU,25862
+cowork_dash/assets/app.js,sha256=Fo_tgFat9eXtpvrptLHmS0qAs04pfF0IaQYiT-Tohm8,8768
+cowork_dash/assets/favicon.ico,sha256=IiP0rVr0m-TBGGmCY88SyFC14drNwDhLRqb0n2ZufKk,54252
+cowork_dash/assets/favicon.svg,sha256=MdT50APCvIlWh3HSwW5SNXYWB3q_wKfuLP-JV53SnKg,1065
+cowork_dash/assets/styles.css,sha256=iHwGFZhzTP3nQEa_vyhoa-ADAW9DV-kU5OqYP7N2S7Q,23891
+cowork_dash-0.1.5.dist-info/METADATA,sha256=UYjwT-OXwZk5bOwJrLLjdsbUipsZDJQSBsnwSJ0lQ8c,6719
+cowork_dash-0.1.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+cowork_dash-0.1.5.dist-info/entry_points.txt,sha256=lL_9XJINiky3nh13tLqWd61LitKbbyh085ROATH9fck,53
+cowork_dash-0.1.5.dist-info/licenses/LICENSE,sha256=2SFXFfIa_c_g_uwY0JApQDXI1mWqEfJeG87Pn4ehLMQ,1072
+cowork_dash-0.1.5.dist-info/RECORD,,

cowork_dash-0.1.3.dist-info/RECORD

@@ -1,19 +0,0 @@
-cowork_dash/__init__.py,sha256=37qBKl7g12Zos8GFukXLXligCdpD32e2qe9F8cd8Qdk,896
-cowork_dash/__main__.py,sha256=CCM9VIkWuwh7hwVGNBBgCCbeVAcHj1soyBVXUaPgABk,131
-cowork_dash/agent.py,sha256=dj50jBzP69YgEzEF44IeE8p11X0ap3xKwdITORnpkhs,4318
-cowork_dash/app.py,sha256=kMTLzE6FA6cDwuWIxSCB62YZ_Z1an6PaX9sv220o6mI,70709
-cowork_dash/canvas.py,sha256=9X_Z6gOwFwIfBk8rsXi4s1hpKAyaK6wglgZ_1UGjZ3E,11093
-cowork_dash/cli.py,sha256=N9APQlQ-5oahUxMoICpJV1FcmVOFNmJpCfaULDeYhRY,6491
-cowork_dash/components.py,sha256=VDJ_IQ8qW7O3dAMVoz97yzBByRBC7XvpnVmDMCIlEUY,20538
-cowork_dash/config.py,sha256=6SfKDJmcK4X2ew4ao53Cg_RKqhDIw5V3BFiaDxbvKsY,3207
-cowork_dash/file_utils.py,sha256=s2-L5wFOE-ChpKaZQwdRUSx5qA96ATR1QtmpkrJXUJY,8542
-cowork_dash/layout.py,sha256=e9E0okLhGf4E-slFjO0udyVD5IrpbVgXS4fXHZsMiXQ,11225
-cowork_dash/tools.py,sha256=6WYK9-s32R5PfZvcpBIR55Z0I6wBgrxJvcxcgfnQ54E,23125
-cowork_dash/assets/app.js,sha256=CIRhskgTn4zPJGfubTYvsZFYSj-0XJNniGlSggy75L4,8162
-cowork_dash/assets/favicon.svg,sha256=MdT50APCvIlWh3HSwW5SNXYWB3q_wKfuLP-JV53SnKg,1065
-cowork_dash/assets/styles.css,sha256=ZiWpULBDO64Hu6bZ5NYFbzDfQ8Ezn66eKjW1LpJ8anM,20621
-cowork_dash-0.1.3.dist-info/METADATA,sha256=4UGO7YjH0El6Ta4vEMZSK0bgCSPgy4rqTHfgdYMAvOA,6959
-cowork_dash-0.1.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-cowork_dash-0.1.3.dist-info/entry_points.txt,sha256=lL_9XJINiky3nh13tLqWd61LitKbbyh085ROATH9fck,53
-cowork_dash-0.1.3.dist-info/licenses/LICENSE,sha256=2SFXFfIa_c_g_uwY0JApQDXI1mWqEfJeG87Pn4ehLMQ,1072
-cowork_dash-0.1.3.dist-info/RECORD,,