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

agent_dev_cli-0.0.1b260112/LICENSE

@@ -0,0 +1,40 @@
+Microsoft AI Toolkit – Agent Dev CLI License Terms
+
+1. Scope and Applicability
+These License Terms ("Terms") govern your use of the Agent Dev CLI software package, including all accompanying files, documentation, updates, and modifications (the "Software"). The Software is a component of Microsoft AI Toolkit for Visual Studio Code ("AI Toolkit") and is licensed, not sold.
+These Terms supplement the license agreement applicable to AI Toolkit. In the event of a conflict, these Terms control solely with respect to the Software.
+
+2. License Grant
+Subject to your compliance with these Terms, Microsoft grants you a limited, non‑exclusive, non‑transferable, revocable license to install and use the Software solely in connection with the AI Toolkit for the purpose of developing, visualizing, debugging, and testing AI agents.
+
+3. Restrictions
+You may not, and may not permit others to:
+Copy, modify, adapt, translate, or create derivative works of the Software
+Reverse engineer, decompile, or disassemble the Software, except to the extent permitted by applicable law
+Distribute, sublicense, rent, lease, lend, host, or provide the Software as a standalone offering
+Use the Software independently of AI Toolkit or outside its intended development and debugging functionality
+Remove, alter, or obscure any proprietary notices in the Software
+
+4. Open Source Exclusion
+The Software is not open source. No rights are granted under any open‑source license, and no obligation exists to make source code available.
+
+5. Updates and Changes
+Microsoft may update, modify, suspend, or discontinue the Software at any time without notice. Any updates provided are governed by these Terms unless Microsoft provides other terms with the update.
+
+6. Feedback
+If you provide feedback, suggestions, or recommendations regarding the Software, Microsoft may use them for any purpose without obligation to you.
+
+7. Disclaimer of Warranties
+THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE." MICROSOFT DISCLAIMS ALL WARRANTIES, EXPRESS, IMPLIED, OR STATUTORY, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON‑INFRINGEMENT.
+
+8. Limitation of Liability
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, MICROSOFT SHALL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES, OR FOR LOSS OF DATA, PROFITS, OR BUSINESS INTERRUPTION, ARISING OUT OF OR IN CONNECTION WITH THE SOFTWARE.
+
+9. Termination
+Microsoft may terminate these Terms immediately if you breach them. Upon termination, you must cease all use of the Software and delete all copies in your possession or control.
+
+10. Governing Law
+These Terms are governed by the laws of the State of Washington, without regard to conflict‑of‑laws principles.
+
+11. Entire Agreement
+These Terms, together with the applicable AI Toolkit license agreement, constitute the entire agreement regarding the Software and supersede any prior agreements relating to it.

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

@@ -1,10 +1,12 @@
 Metadata-Version: 2.4
 Name: agent-dev-cli
-Version: 0.0.1b251223
+Version: 0.0.1b260112
 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
+License-Expression: LicenseRef-Microsoft-AI-Toolkit-Agent-Dev-CLI
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
@@ -13,9 +15,11 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Debuggers
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
+License-File: LICENSE
 Requires-Dist: pydantic>=2.12.4
 Requires-Dist: azure-identity>=1.25.1
 Requires-Dist: python-dotenv>=1.2.1
@@ -27,26 +31,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 +104,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 +123,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.1b260112}/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.1b260112}/pyproject.toml

@@ -1,9 +1,14 @@
 [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"
+license = "LicenseRef-Microsoft-AI-Toolkit-Agent-Dev-CLI"
+license-files = ["LICENSE"]
 requires-python = ">=3.10.0"
+authors = [
+    { name = "Microsoft", email = "aitkfeedback@microsoft.com" }
+]
 keywords = ["ai", "agent", "toolkit", "debugging", "workflow", "visualization"]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -14,6 +19,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Debuggers",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Typing :: Typed",
@@ -32,13 +38,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 +46,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.1b260112}/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.1b260112}/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.1b260112/src/agentdev/_version.py

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

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260112}/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.1b260112}/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.1b260112}/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.1b260112}/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.1b260112}/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/src/agentdev/_bootstrap.py → agent_dev_cli-0.0.1b260112/src/agentdev/bootstrap.py

@@ -1,7 +1,7 @@
 """
 agentdev Bootstrap Module.
 
-This module is executed via `python -m agentdev._bootstrap` to set up
+This module is executed via `python -m agentdev.bootstrap` to set up
 import hooks before running the user's agent script.
 
 The bootstrap process:

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260112}/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',
@@ -98,10 +97,14 @@ def run(
     if verbose:
         env['AGENTDEV_VERBOSE'] = '1'
     
+    # Use absolute path to bypass module resolution issues (e.g., Python 3.14 with debugpy).
+    # sys.path may not be properly inherited in subprocesses under debuggers/wrappers.
+    bootstrap_path = os.path.join(os.path.dirname(__file__), 'bootstrap.py')
+    
     # Build command to run the bootstrap module
     cmd = [
         sys.executable,
-        '-m', 'agentdev._bootstrap',
+        bootstrap_path,
         script_path,
         *args
     ]

{agent_dev_cli-0.0.1b251223 → agent_dev_cli-0.0.1b260112}/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)