agent-dev-cli 0.0.1b251223__tar.gz → 0.0.1b260107__tar.gz

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/PKG-INFO

@@ -1,8 +1,9 @@
 Metadata-Version: 2.4
 Name: agent-dev-cli
-Version: 0.0.1b251223
+Version: 0.0.1b260107
 Summary: AI Toolkit - CLI and SDK for agent debugging and workflow visualization
 Keywords: ai,agent,toolkit,debugging,workflow,visualization
+Author-email: Microsoft <aitkfeedback@microsoft.com>
 Requires-Python: >=3.10.0
 Description-Content-Type: text/markdown
 Classifier: Development Status :: 4 - Beta
@@ -27,26 +28,23 @@ Requires-Dist: azure-ai-agentserver-agentframework>=1.0.0b7
 Requires-Dist: azure-ai-agentserver-core>=1.0.0b7
 Requires-Dist: click>=8.1.0
 Requires-Dist: azure-ai-projects>=2.0.0b2
-Requires-Dist: pytest>=8.0.0 ; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23.0 ; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0 ; extra == "dev"
-Requires-Dist: httpx>=0.27.0 ; extra == "dev"
 Project-URL: Documentation, https://github.com/microsoft/vscode-ai-toolkit#readme
 Project-URL: Homepage, https://github.com/microsoft/vscode-ai-toolkit
 Project-URL: Issues, https://github.com/microsoft/vscode-ai-toolkit/issues
 Project-URL: Repository, https://github.com/microsoft/vscode-ai-toolkit
-Provides-Extra: dev
 
 # Agent Dev CLI
 
-Agent Dev CLI - A Python package for agent debugging and workflow visualization with VS Code integration.
+A Python CLI and SDK for agent debugging and workflow visualization with VS Code AI Toolkit integration.
 
 ## Installation
 
 ```bash
-pip install -e .
+pip install agent-dev-cli --pre
 ```
 
+> **Note**: This package is currently in beta. The `--pre` flag is required to install pre-release versions.
+
 ## Usage
 
 ### Option 1: CLI Wrapper (Recommended)
@@ -103,7 +101,7 @@ Run a Python agent script with agentdev instrumentation.
 agentdev run [OPTIONS] SCRIPT [ARGS]...
 
 Options:
-  -p, --port INTEGER    Agent server port (default: 8088)
+  -p, --port INTEGER    Agent server port (default: 8087)
   -v, --verbose         Enable verbose output
   --help                Show this message and exit
 ```
@@ -122,22 +120,26 @@ agentdev info
 - **Workflow Visualization**: Starts a visualization server on port 8090 for WorkflowAgent instances
 - **Easy Integration**: Simple one-function setup
 
+## Testing Your Agent Server
+
+Once your agent server is running, you can test it using curl:
+
+```bash
+# Health check
+curl http://localhost:8087/agentdev/health
+
+# Send a request to your agent (streaming)
+curl 'http://localhost:8087/agentdev/v1/responses' \
+  -H 'Content-Type: application/json' \
+  -d '{"model":"your-agent-model-id","input":{"role":"user","text":"Hello!"},"stream":true}'
+```
+
 ## Requirements
 
 - Python 3.10+
-- agent-framework
-- starlette
+- [VS Code AI Toolkit](https://marketplace.visualstudio.com/items?itemName=ms-windows-ai-studio.windows-ai-studio) (for visualization)
 
 ## License
 
 MIT License
 
-
-## Test
-
-```bash
-curl 'http://localhost:8088/agentdev/v1/responses' \
-  -H 'Content-Type: application/json' \
-  -d '{"model":"workflow_in-memory_content-review-workflow_5c703d16cb1e4756848ddcc685b16503","input":{"role":"user","text":"test"},"stream":true}'
-```
-

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/README.md

@@ -1,13 +1,15 @@
 # Agent Dev CLI
 
-Agent Dev CLI - A Python package for agent debugging and workflow visualization with VS Code integration.
+A Python CLI and SDK for agent debugging and workflow visualization with VS Code AI Toolkit integration.
 
 ## Installation
 
 ```bash
-pip install -e .
+pip install agent-dev-cli --pre
 ```
 
+> **Note**: This package is currently in beta. The `--pre` flag is required to install pre-release versions.
+
 ## Usage
 
 ### Option 1: CLI Wrapper (Recommended)
@@ -64,7 +66,7 @@ Run a Python agent script with agentdev instrumentation.
 agentdev run [OPTIONS] SCRIPT [ARGS]...
 
 Options:
-  -p, --port INTEGER    Agent server port (default: 8088)
+  -p, --port INTEGER    Agent server port (default: 8087)
   -v, --verbose         Enable verbose output
   --help                Show this message and exit
 ```
@@ -83,21 +85,25 @@ agentdev info
 - **Workflow Visualization**: Starts a visualization server on port 8090 for WorkflowAgent instances
 - **Easy Integration**: Simple one-function setup
 
+## Testing Your Agent Server
+
+Once your agent server is running, you can test it using curl:
+
+```bash
+# Health check
+curl http://localhost:8087/agentdev/health
+
+# Send a request to your agent (streaming)
+curl 'http://localhost:8087/agentdev/v1/responses' \
+  -H 'Content-Type: application/json' \
+  -d '{"model":"your-agent-model-id","input":{"role":"user","text":"Hello!"},"stream":true}'
+```
+
 ## Requirements
 
 - Python 3.10+
-- agent-framework
-- starlette
+- [VS Code AI Toolkit](https://marketplace.visualstudio.com/items?itemName=ms-windows-ai-studio.windows-ai-studio) (for visualization)
 
 ## License
 
 MIT License
-
-
-## Test
-
-```bash
-curl 'http://localhost:8088/agentdev/v1/responses' \
-  -H 'Content-Type: application/json' \
-  -d '{"model":"workflow_in-memory_content-review-workflow_5c703d16cb1e4756848ddcc685b16503","input":{"role":"user","text":"test"},"stream":true}'
-```

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/pyproject.toml

@@ -1,9 +1,12 @@
 [project]
 name = "agent-dev-cli"
-version = "0.0.1b251223"
+dynamic = ["version"]
 description = "AI Toolkit - CLI and SDK for agent debugging and workflow visualization"
 readme = "README.md"
 requires-python = ">=3.10.0"
+authors = [
+    { name = "Microsoft", email = "aitkfeedback@microsoft.com" }
+]
 keywords = ["ai", "agent", "toolkit", "debugging", "workflow", "visualization"]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -32,13 +35,7 @@ dependencies = [
     "azure-ai-projects>=2.0.0b2",
 ]
 
-[project.urls]
-Homepage = "https://github.com/microsoft/vscode-ai-toolkit"
-Repository = "https://github.com/microsoft/vscode-ai-toolkit"
-Documentation = "https://github.com/microsoft/vscode-ai-toolkit#readme"
-Issues = "https://github.com/microsoft/vscode-ai-toolkit/issues"
-
-[project.optional-dependencies]
+[dependency-groups]
 dev = [
     "pytest>=8.0.0",
     "pytest-asyncio>=0.23.0",
@@ -46,6 +43,12 @@ dev = [
     "httpx>=0.27.0",
 ]
 
+[project.urls]
+Homepage = "https://github.com/microsoft/vscode-ai-toolkit"
+Repository = "https://github.com/microsoft/vscode-ai-toolkit"
+Documentation = "https://github.com/microsoft/vscode-ai-toolkit#readme"
+Issues = "https://github.com/microsoft/vscode-ai-toolkit/issues"
+
 [project.scripts]
 agentdev = "agentdev.cli:main"
 

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/src/agentdev/__init__.py

@@ -17,6 +17,6 @@ This package provides two ways to use agentdev:
 """
 
 from .localdebug import setup_test_tool
+from ._version import __version__
 
-__version__ = "0.0.1b251223"
-__all__ = ["setup_test_tool"]
+__all__ = ["setup_test_tool", "__version__"]

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/src/agentdev/_hooks.py

@@ -172,7 +172,6 @@ def _install_post_import_hook() -> None:
     
     # First, check if the module is already imported
     target = "azure.ai.agentserver.agentframework"
-    target_parts = target.split(".")
     
     if target in sys.modules:
         if verbose:
@@ -188,7 +187,7 @@ def _install_post_import_hook() -> None:
         print(f"agentdev Hook: Installed meta path finder", file=sys.stderr)
     
     # Monkey-patch __import__ for more reliable interception
-    # Use the builtins module (standard way) instead of __builtins__ (implementation detail)
+    # Use the builtins module, which is the standard way to access the __import__ function
     original_import = builtins.__import__
     
     def patched_import(name, globals=None, locals=None, fromlist=(), level=0):

agent_dev_cli-0.0.1b260107/src/agentdev/_version.py

@@ -0,0 +1,2 @@
+"""Version information for agentdev package."""
+__version__ = "0.0.1b260107"

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/src/agentdev/backend/code_analyzer.py

@@ -3,6 +3,7 @@ from pydantic import BaseModel
 from typing import Callable, Any
 from agent_framework import FunctionExecutor, Executor
 import os
+import logging
 
 
 class CodeLocation(BaseModel):
@@ -14,22 +15,22 @@ def get_cls_location(obj: object) -> CodeLocation | None:
     try:
         file_path = inspect.getfile(cls)
         line_number = inspect.getsourcelines(cls)[1]
-        print(f"Class {cls} defined in {file_path} at line {line_number}")
+        logging.debug(f"Class {cls} defined in {file_path} at line {line_number}")
         abs_path = os.path.abspath(file_path)
         return CodeLocation(file_path=abs_path, line_number=line_number)
     except Exception as e:
-        print(f"Could not get location for class {cls}: {e}")
+        logging.debug(f"Could not get location for class {cls}: {e}")
         return None
 
 def get_func_location(func: Callable) -> CodeLocation | None:
     try:
         file_path = inspect.getfile(func)
         line_number = inspect.getsourcelines(func)[1]
-        print(f"Function {func.__name__} defined in {file_path} at line {line_number}")
+        logging.debug(f"Function {func.__name__} defined in {file_path} at line {line_number}")
         abs_path = os.path.abspath(file_path)
         return CodeLocation(file_path=abs_path, line_number=line_number)
     except Exception as e:
-        print(f"Could not get location for function {func}: {e}")
+        logging.debug(f"Could not get location for function {func}: {e}")
         return None
 
 def get_executor_location(executor: Any) -> CodeLocation | None:

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/src/agentdev/backend/event_mapper.py

@@ -6,7 +6,7 @@ from datetime import datetime
 import sys
 import logging
 
-from agent_framework import WorkflowEvent, WorkflowStartedEvent, WorkflowFailedEvent, WorkflowStatusEvent, WorkflowRunState, ExecutorEvent, AgentRunUpdateEvent, ExecutorInvokedEvent, ExecutorCompletedEvent, AgentRunResponseUpdate, FunctionCallContent, FunctionResultContent, TextContent
+from agent_framework import WorkflowEvent, WorkflowStartedEvent, WorkflowFailedEvent, WorkflowStatusEvent, WorkflowRunState, WorkflowOutputEvent, ExecutorEvent, AgentRunUpdateEvent, ExecutorInvokedEvent, ExecutorCompletedEvent, AgentRunResponseUpdate, FunctionCallContent, FunctionResultContent, TextContent
 
 from ._utils import serialize_data
 from .structs.request import AgentFrameworkRequest
@@ -101,6 +101,19 @@ class EventMapper():
                     },
                 },
             }]
+        elif isinstance(event, WorkflowOutputEvent):
+            # Map WorkflowOutputEvent to pass workflow output data to the webview
+            serialized_data = None
+            if event.data is not None:
+                try:
+                    serialized_data = serialize_data(event.data)
+                except Exception as e:
+                    logging.warning(f"Failed to serialize workflow output data: {e}")
+                    serialized_data = str(event.data)
+            return [{
+                "type": "response.workflow_output",
+                "output": serialized_data,
+            }]
         elif isinstance(event, WorkflowStatusEvent):
             if event.state == WorkflowRunState.IN_PROGRESS:
                 event_type = "response.in_progress"
@@ -221,7 +234,7 @@ class EventMapper():
                 "output_index": ctx.output_index,
                 "item":{
                     "type":"message",       
-                    "id":"msg_a6a8c564",
+                    "id": ctx.item_id,
                     "content":[],
                     "role":"assistant",
                     "status":"in_progress"
@@ -288,14 +301,14 @@ class EventMapper():
                     }
                 )
             else:
-                print("Unknown content: " + str(type(content)), file=sys.stderr)
+                logging.warning("Unknown content: %s", type(content))
         return results
 
     def map_event(self, ctx: MapperContext, event: Any) -> list[dict]:
         """Map an Agent Framework event to OpenAI Responses API events"""
         mapper = self._get_event_mapper(type(event))
         if not mapper:
-            print("Unknown event: " + type(event))
+            logging.warning("Unknown event: %s", type(event))
             return []
         
         return mapper(ctx, event)

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/src/agentdev/backend/server.py

@@ -50,7 +50,7 @@ class TestToolServer:
                 chat_message = self.openai_chat_message_to_agent_framework_chat_message(input_data)
                 return [chat_message]
         elif expected_type == ChatMessage:
-            chat_message = self.openai_chat_message_to_agent_framework_chat_message(input_data if type(input_data) == dict else input_data[0])
+            chat_message = self.openai_chat_message_to_agent_framework_chat_message(input_data if isinstance(input_data, dict) else input_data[0])
             return chat_message
         else:
             raise ExecutorInputNotSupported(f"Unsupported input type for conversion: {expected_type}")
@@ -65,7 +65,7 @@ class TestToolServer:
         elif content:
             contents = []
             for c in content:
-                if type(c) == dict:
+                if isinstance(c, dict):
                     if c["type"] == "input_text":
                         result_content = {
                             "type": "text",
@@ -172,14 +172,15 @@ class TestToolServer:
 
         # Extract input from the request
         input_raw = request.input
-        if type(input_raw) != dict and type(input_raw) != list:
+        if not isinstance(input_raw, (dict, list)):
             raise RuntimeError("Only dict or list input type is supported in test tool server for now")
 
+        input_data = None
         if isinstance(entity, Workflow):
-            start_executor_type = None
             for input_type in entity.get_start_executor().input_types:
                 try:
                     input_data = self.convert_input_data(input_raw, input_type)
+                    break
                 except ExecutorInputNotSupported:
                     continue
             if input_data is None:
@@ -194,9 +195,9 @@ class TestToolServer:
         try:
             async for agent_framework_event in entity.run_stream(input_data):
                 if agent_framework_event and hasattr(agent_framework_event, "to_json"):
-                    logging.debug("Emit agent framework event: ", agent_framework_event.to_json())
+                    logging.debug("Emit agent framework event: " + str(agent_framework_event.to_json()))
                 else:
-                    logging.debug("Emit agent framework event: ", agent_framework_event)
+                    logging.debug("Emit agent framework event: " + str(agent_framework_event))
                 openai_events = self._events_mapper.map_event(ctx, agent_framework_event)
                 for openai_event in openai_events:
                     if openai_event:
@@ -206,7 +207,7 @@ class TestToolServer:
             yield f"data: [DONE]\n\n"
     
     def _get_entity(self, model_name: str) -> Workflow | AgentProtocol | None:
-        # Because contain agents only support a single agent / workflow for now, we can just return the first one.
+        # Because current agents only support a single agent/workflow for now, we can just return the first one.
         results = list(filter(lambda item: item.id == model_name, self._entities))
         if not results:
             return None
@@ -255,8 +256,8 @@ class TestToolServer:
         except WebSocketDisconnect:
             pass
         except Exception as e:
-            print(f"WebSocket error: {e}")
+            logging.error(f"WebSocket error: {e}")
             try:
                 await websocket.close()
-            except:
-                pass
+            except Exception as close_error:
+                logging.debug("Error while closing websocket after failure: %s", close_error)

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/src/agentdev/backend/structs/entity_response.py

@@ -1,6 +1,5 @@
 from agent_framework import AgentProtocol, Workflow
 from pydantic import BaseModel
-from typing import Any
 
 class EntityResponse(BaseModel):
 

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/src/agentdev/backend/structs/request.py

@@ -1,5 +1,5 @@
 from pydantic import BaseModel, ConfigDict
-from typing import Any, Literal
+from typing import Any
 
 # Agent Framework Request Model - Extending real OpenAI types
 class AgentFrameworkRequest(BaseModel):

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/src/agentdev/cli.py

@@ -14,7 +14,6 @@ import os
 import sys
 import subprocess
 from importlib.metadata import version as get_version
-from typing import Optional
 
 import click
 
@@ -49,9 +48,9 @@ def cli():
 @click.argument('args', nargs=-1, type=click.UNPROCESSED)
 @click.option(
     '--port', '-p',
-    default=8088,
+    default=8087,
     type=int,
-    help='Agent server port (default: 8088)'
+    help='Agent server port (default: 8087)'
 )
 @click.option(
     '--verbose', '-v',

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260107}/src/agentdev/localdebug.py

@@ -5,8 +5,7 @@ This module provides functionality to set up workflow or agent visualization
 """
 
 from agent_framework import WorkflowAgent
-import os
-import sys
+import logging
 import time
 
 
@@ -48,18 +47,18 @@ def setup_test_tool(agent_server):
 
     # Prepare entities for visualization
     entities = []
-    if type(agent) == WorkflowAgent:
+    if isinstance(agent, WorkflowAgent):
         entities.append(agent.workflow)
     else:
         entities.append(agent)
 
     test_tool_server = TestToolServer(entities)
     test_tool_server.mount_backend(app)
-    def show_endspattern():
+    def show_startup_message():
         time.sleep(2)
-        print("agentdev: Application startup complete")
-    thread = Thread(target=show_endspattern)
+        logging.info("agentdev: Application startup complete")
+    thread = Thread(target=show_startup_message)
     thread.daemon = True
     thread.start()
     
-    print(agent)
+    logging.debug("Agent server configured: %s", agent)