deepagent-code 0.1.4__tar.gz → 0.1.5__tar.gz

{deepagent_code-0.1.4 → deepagent_code-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagent-code
-Version: 0.1.4
+Version: 0.1.5
 Summary: A Claude Code-style CLI for running LangGraph agents from the terminal
 Author-email: Kedar Dabhadkar <kdabhadk@gmail.com>
 License-Expression: MIT
@@ -57,7 +57,7 @@ deepagent-code
 
 Or specify your own agent:
 ```bash
-deepagent-code path/to/your_agent.py:graph
+deepagent-code -a path/to/your_agent.py:graph
 ```
 
 This launches an interactive conversation loop with your agent.
@@ -68,14 +68,17 @@ This launches an interactive conversation loop with your agent.
 # Use the default agent
 deepagent-code
 
+# Send a message directly
+deepagent-code "Hello, agent!"
+
 # Specify a custom agent file
-deepagent-code my_agent.py:graph
+deepagent-code -a my_agent.py:graph
 
 # Use a module path
-deepagent-code mypackage.agents:chatbot
+deepagent-code -a mypackage.agents:chatbot
 
-# With an initial message
-deepagent-code -m "Hello, agent!"
+# Read message from a file
+deepagent-code -f ./prompt.md
 
 # Non-interactive mode (auto-approve tool calls)
 deepagent-code --no-interactive
@@ -108,14 +111,15 @@ export DEEPAGENT_CONFIG='{"configurable": {"thread_id": "1"}}'
 ## CLI Options
 
 ```
-Usage: deepagent-code [OPTIONS] [AGENT_SPEC]
+Usage: deepagent-code [OPTIONS] [MESSAGE]
 
 Arguments:
-  AGENT_SPEC  Agent location (path/to/file.py:graph or module:graph)
+  MESSAGE  Optional input to send to the agent immediately
 
 Options:
+  -a, --agent TEXT                Agent spec (path/to/file.py:graph or module:graph)
   -g, --graph-name TEXT           Graph variable name (default: "graph")
-  -m, --message TEXT              Initial message
+  -f, --file PATH                 Read message from a file (any extension)
   -c, --config TEXT               Config JSON or file path
   --interactive/--no-interactive  Handle interrupts (default: interactive)
   --async-mode/--sync-mode        Async streaming (default: sync)
@@ -140,7 +144,7 @@ agent = create_deep_agent(
 
 Then run it:
 ```bash
-deepagent-code my_agent.py:agent
+deepagent-code -a my_agent.py:agent
 ```
 
 ## Programmatic Use

{deepagent_code-0.1.4 → deepagent_code-0.1.5}/README.md

@@ -25,7 +25,7 @@ deepagent-code
 
 Or specify your own agent:
 ```bash
-deepagent-code path/to/your_agent.py:graph
+deepagent-code -a path/to/your_agent.py:graph
 ```
 
 This launches an interactive conversation loop with your agent.
@@ -36,14 +36,17 @@ This launches an interactive conversation loop with your agent.
 # Use the default agent
 deepagent-code
 
+# Send a message directly
+deepagent-code "Hello, agent!"
+
 # Specify a custom agent file
-deepagent-code my_agent.py:graph
+deepagent-code -a my_agent.py:graph
 
 # Use a module path
-deepagent-code mypackage.agents:chatbot
+deepagent-code -a mypackage.agents:chatbot
 
-# With an initial message
-deepagent-code -m "Hello, agent!"
+# Read message from a file
+deepagent-code -f ./prompt.md
 
 # Non-interactive mode (auto-approve tool calls)
 deepagent-code --no-interactive
@@ -76,14 +79,15 @@ export DEEPAGENT_CONFIG='{"configurable": {"thread_id": "1"}}'
 ## CLI Options
 
 ```
-Usage: deepagent-code [OPTIONS] [AGENT_SPEC]
+Usage: deepagent-code [OPTIONS] [MESSAGE]
 
 Arguments:
-  AGENT_SPEC  Agent location (path/to/file.py:graph or module:graph)
+  MESSAGE  Optional input to send to the agent immediately
 
 Options:
+  -a, --agent TEXT                Agent spec (path/to/file.py:graph or module:graph)
   -g, --graph-name TEXT           Graph variable name (default: "graph")
-  -m, --message TEXT              Initial message
+  -f, --file PATH                 Read message from a file (any extension)
   -c, --config TEXT               Config JSON or file path
   --interactive/--no-interactive  Handle interrupts (default: interactive)
   --async-mode/--sync-mode        Async streaming (default: sync)
@@ -108,7 +112,7 @@ agent = create_deep_agent(
 
 Then run it:
 ```bash
-deepagent-code my_agent.py:agent
+deepagent-code -a my_agent.py:agent
 ```
 
 ## Programmatic Use

{deepagent_code-0.1.4 → deepagent_code-0.1.5}/deepagent_code/cli.py

@@ -54,7 +54,7 @@ SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇",
 
 
 # Version info
-__version__ = "0.1.4"
+__version__ = "0.1.5"
 
 
 # Slash command registry
@@ -1202,10 +1202,13 @@ def run_conversation_loop(
     verbose: bool = False,
     stream_mode: str = "updates",
     initial_message: Optional[str] = None,
+    single_shot: bool = False,
 ):
     """
     Run a continuous conversation loop with the LangGraph agent.
     Styled after Claude Code / nanocode.
+
+    If single_shot is True and initial_message is provided, exit after processing.
     """
     # Set up tab completion for slash commands
     setup_readline_completion()
@@ -1242,6 +1245,10 @@ def run_conversation_loop(
         print_timing(duration, verbose)
         print()
 
+        # Exit after single-shot execution
+        if single_shot:
+            return
+
     # Main conversation loop
     while True:
         try:
@@ -1322,16 +1329,24 @@ def run_conversation_loop(
 
 
 @click.command()
-@click.argument("agent_spec", required=False)
+@click.argument("message", required=False)
+@click.option(
+    "--agent",
+    "-a",
+    "agent_spec",
+    help="Agent spec: path/to/file.py, path/to/file.py:graph, or module.path:graph",
+)
 @click.option(
     "--graph-name",
     "-g",
     help="Name of the graph variable (default: 'graph', overridden if spec includes :name)",
 )
 @click.option(
-    "--message",
-    "-m",
-    help="Input message to send to the agent",
+    "--file",
+    "-f",
+    "prompt_file",
+    type=click.Path(exists=True),
+    help="Read input message from a file (any extension)",
 )
 @click.option(
     "--config",
@@ -1360,9 +1375,10 @@ def run_conversation_loop(
     help="Show verbose output including node names",
 )
 def main(
+    message: Optional[str],
     agent_spec: Optional[str],
     graph_name: Optional[str],
-    message: Optional[str],
+    prompt_file: Optional[str],
     config: Optional[str],
     interactive: bool,
     use_async: bool,
@@ -1372,7 +1388,9 @@ def main(
     """
     Run a LangGraph agent from the command line.
 
-    AGENT_SPEC can be:
+    MESSAGE is an optional input to send to the agent immediately.
+
+    Agent spec (-a/--agent) can be:
     \b
     - path/to/file.py           (uses default graph name 'graph')
     - path/to/file.py:agent     (specifies graph variable name)
@@ -1391,12 +1409,28 @@ def main(
 
     \b
     Examples:
-        deepagent-code my_agent.py
-        deepagent-code my_agent.py:graph
-        deepagent-code mypackage.agents:chatbot
-        deepagent-code -m "Hello, agent!"
+        deepagent-code "Hello, agent!"
+        deepagent-code -a my_agent.py "What can you do?"
+        deepagent-code -a my_agent.py:graph
+        deepagent-code -f ./prompt.md
     """
     try:
+        # Handle -f/--file option: read message from file
+        if prompt_file and message:
+            print(f"{RED}⏺ Error: Cannot use both MESSAGE argument and -f/--file option{RESET}")
+            sys.exit(1)
+
+        if prompt_file:
+            try:
+                with open(prompt_file, 'r', encoding='utf-8') as f:
+                    message = f.read().strip()
+                if not message:
+                    print(f"{RED}⏺ Error: File '{prompt_file}' is empty{RESET}")
+                    sys.exit(1)
+            except Exception as e:
+                print(f"{RED}⏺ Error reading file '{prompt_file}': {e}{RESET}")
+                sys.exit(1)
+
         # Get environment variables (DEEPAGENT_SPEC preferred, DEEPAGENT_AGENT_SPEC for backwards compat)
         env_agent_spec = os.getenv('DEEPAGENT_SPEC') or os.getenv('DEEPAGENT_AGENT_SPEC')
         env_workspace_root = os.getenv('DEEPAGENT_WORKSPACE_ROOT')
@@ -1465,6 +1499,7 @@ def main(
         agent_description = get_agent_description(graph)
 
         # Run the conversation loop
+        # Single-shot mode: exit after processing if message was provided via CLI
         run_conversation_loop(
             graph=graph,
             config=config_dict,
@@ -1475,6 +1510,7 @@ def main(
             verbose=verbose,
             stream_mode=final_stream_mode,
             initial_message=message,
+            single_shot=bool(message),
         )
 
     except FileNotFoundError as e:

{deepagent_code-0.1.4 → deepagent_code-0.1.5}/deepagent_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagent-code
-Version: 0.1.4
+Version: 0.1.5
 Summary: A Claude Code-style CLI for running LangGraph agents from the terminal
 Author-email: Kedar Dabhadkar <kdabhadk@gmail.com>
 License-Expression: MIT
@@ -57,7 +57,7 @@ deepagent-code
 
 Or specify your own agent:
 ```bash
-deepagent-code path/to/your_agent.py:graph
+deepagent-code -a path/to/your_agent.py:graph
 ```
 
 This launches an interactive conversation loop with your agent.
@@ -68,14 +68,17 @@ This launches an interactive conversation loop with your agent.
 # Use the default agent
 deepagent-code
 
+# Send a message directly
+deepagent-code "Hello, agent!"
+
 # Specify a custom agent file
-deepagent-code my_agent.py:graph
+deepagent-code -a my_agent.py:graph
 
 # Use a module path
-deepagent-code mypackage.agents:chatbot
+deepagent-code -a mypackage.agents:chatbot
 
-# With an initial message
-deepagent-code -m "Hello, agent!"
+# Read message from a file
+deepagent-code -f ./prompt.md
 
 # Non-interactive mode (auto-approve tool calls)
 deepagent-code --no-interactive
@@ -108,14 +111,15 @@ export DEEPAGENT_CONFIG='{"configurable": {"thread_id": "1"}}'
 ## CLI Options
 
 ```
-Usage: deepagent-code [OPTIONS] [AGENT_SPEC]
+Usage: deepagent-code [OPTIONS] [MESSAGE]
 
 Arguments:
-  AGENT_SPEC  Agent location (path/to/file.py:graph or module:graph)
+  MESSAGE  Optional input to send to the agent immediately
 
 Options:
+  -a, --agent TEXT                Agent spec (path/to/file.py:graph or module:graph)
   -g, --graph-name TEXT           Graph variable name (default: "graph")
-  -m, --message TEXT              Initial message
+  -f, --file PATH                 Read message from a file (any extension)
   -c, --config TEXT               Config JSON or file path
   --interactive/--no-interactive  Handle interrupts (default: interactive)
   --async-mode/--sync-mode        Async streaming (default: sync)
@@ -140,7 +144,7 @@ agent = create_deep_agent(
 
 Then run it:
 ```bash
-deepagent-code my_agent.py:agent
+deepagent-code -a my_agent.py:agent
 ```
 
 ## Programmatic Use

{deepagent_code-0.1.4 → deepagent_code-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepagent-code"
-version = "0.1.4"
+version = "0.1.5"
 description = "A Claude Code-style CLI for running LangGraph agents from the terminal"
 readme = "README.md"
 requires-python = ">=3.11"