specsmith 0.3.0.dev136__py3-none-any.whl → 0.3.0.dev139__py3-none-any.whl

specsmith/agent/runner.py

@@ -184,6 +184,7 @@ class AgentRunner:
         max_tool_iterations: int = 10,
         optimize: bool = False,
         optimization_config: OptimizationConfig | None = None,
+        json_events: bool = False,
     ) -> None:
         self.project_dir = str(Path(project_dir).resolve())
         self._provider_name = provider_name
@@ -191,6 +192,7 @@ class AgentRunner:
         self._tier = tier
         self._stream = stream
         self._max_iterations = max_tool_iterations
+        self._json_events = json_events
 
         self._provider: Any = None
         self._state = SessionState(project_dir=self.project_dir)
@@ -291,7 +293,10 @@ class AgentRunner:
             except Exception as e:  # noqa: BLE001
                 error_msg = f"[Provider error] {e}"
                 if not silent:
-                    self._print(error_msg)
+                    if self._json_events:
+                        self._emit_event(type="error", message=error_msg)
+                    else:
+                        self._print(error_msg)
                 return error_msg
 
             # Update credit tracking
@@ -299,6 +304,15 @@ class AgentRunner:
             self._state.total_output_tokens += response.output_tokens
             self._state.total_cost_usd += response.estimated_cost_usd
 
+            # Emit token update event
+            if self._json_events and not silent:
+                self._emit_event(
+                    type="tokens",
+                    in_tokens=self._state.total_input_tokens,
+                    out_tokens=self._state.total_output_tokens,
+                    cost_usd=self._state.total_cost_usd,
+                )
+
             if response.content:
                 final_response = response.content
 
@@ -330,6 +344,14 @@ class AgentRunner:
                     )
                 )
 
+        # Emit turn-done event
+        if self._json_events and not silent:
+            self._emit_event(
+                type="turn_done",
+                total_tokens=self._state.session_tokens,
+                cost_usd=self._state.total_cost_usd,
+            )
+
         return final_response
 
     def _call_provider(self, messages: list[Message], silent: bool = False) -> CompletionResponse:
@@ -362,7 +384,7 @@ class AgentRunner:
             messages = hint.messages
             tools = hint.tools
 
-        use_stream = self._stream and not silent and not tools
+        use_stream = self._stream and not silent and not tools and not self._json_events
         if use_stream:
             accumulated = ""
             for token in provider.stream(messages, tools=None):
@@ -375,7 +397,10 @@ class AgentRunner:
         else:
             response = cast(CompletionResponse, provider.complete(messages, tools=tools))
             if not silent and response.content:
-                self._print(response.content)
+                if self._json_events:
+                    self._emit_event(type="llm_chunk", text=response.content)
+                else:
+                    self._print(response.content)
 
         # ── Optimization post-call ───────────────────────────────────────────
         if self._optimizer is not None and hint is not None:
@@ -405,7 +430,10 @@ class AgentRunner:
             inputs = tc.get("input", {})
 
             if not silent:
-                self._print(f"\n[Tool: {name}]")
+                if self._json_events:
+                    self._emit_event(type="tool_started", name=name, args=inputs)
+                else:
+                    self._print(f"\n[Tool: {name}]")
 
             # Fire pre_tool hooks
             pre_ctx = HookContext(
@@ -451,9 +479,12 @@ class AgentRunner:
             elapsed = time.time() * 1000 - start_ms
 
             if not silent:
-                # Truncate long outputs for display
-                display = output[:500] + "..." if len(output) > 500 else output
-                self._print(f"  → {display}")
+                if self._json_events:
+                    self._emit_event(type="tool_finished", name=name, result=output, is_error=error)
+                else:
+                    # Truncate long outputs for display
+                    display = output[:500] + "..." if len(output) > 500 else output
+                    self._print(f"  → {display}")
 
             tr = ToolResult(
                 tool_name=name,
@@ -554,13 +585,23 @@ class AgentRunner:
     def _print_banner(self) -> None:
         provider = getattr(self._provider, "provider_name", "?")
         model = getattr(self._provider, "model", "?")
-        self._print(
-            f"\n[specsmith agent — AEE-integrated]"
-            f"\n  Project: {self.project_dir}"
-            f"\n  Provider: {provider}/{model}"
-            f"\n  Tools: {len(self._tools)} | Skills: {len(self._skills)}"
-            f"\n  Type /help for commands, exit to quit\n"
-        )
+        if self._json_events:
+            self._emit_event(
+                type="ready",
+                provider=provider,
+                model=model,
+                project_dir=self.project_dir,
+                tools=len(self._tools),
+                skills=len(self._skills),
+            )
+        else:
+            self._print(
+                f"\n[specsmith agent — AEE-integrated]"
+                f"\n  Project: {self.project_dir}"
+                f"\n  Provider: {provider}/{model}"
+                f"\n  Tools: {len(self._tools)} | Skills: {len(self._skills)}"
+                f"\n  Type /help for commands, exit to quit\n"
+            )
 
     def _print_status(self) -> None:
         self._print(
@@ -594,10 +635,22 @@ class AgentRunner:
     def _prompt(self) -> str:
         """Read a line of input from stdin."""
         try:
-            return input("\n> ")
+            # In json_events mode suppress the prompt string so stdout stays pure JSON
+            return input("" if self._json_events else "\n> ")
         except EOFError:
             raise
 
     def _print(self, text: str = "", end: str = "\n", flush: bool = False) -> None:
-        """Print to stdout."""
-        print(text, end=end, flush=flush)
+        """Print to stdout; in json_events mode emit a system event instead."""
+        if self._json_events:
+            if text.strip():
+                self._emit_event(type="system", message=text.strip())
+        else:
+            print(text, end=end, flush=flush)
+
+    def _emit_event(self, **kwargs: Any) -> None:
+        """Emit a newline-delimited JSON event to stdout (json_events mode only)."""
+        import json
+        import sys
+
+        print(json.dumps(kwargs), flush=True, file=sys.stdout)  # noqa: T201

specsmith/cli.py

@@ -1809,29 +1809,6 @@ def plugin_list() -> None:
     console.print(f"\n  {len(plugins)} plugin(s)")
 
 
-# ---------------------------------------------------------------------------
-# Serve (API for React dashboard)
-# ---------------------------------------------------------------------------
-
-
-@main.command()
-@click.option("--port", default=8910, help="Port to serve on.")
-def serve(port: int) -> None:
-    """Start local API server for the web dashboard."""
-    console.print(f"[bold]Starting specsmith API server on port {port}...[/bold]")
-    console.print("[yellow]Not yet implemented. See issue #14.[/yellow]")
-    console.print(
-        "\nPlanned endpoints:\n"
-        "  GET  /api/projects          \u2014 list governed projects\n"
-        "  POST /api/projects/init     \u2014 scaffold new project\n"
-        "  POST /api/projects/import   \u2014 import existing project\n"
-        "  GET  /api/projects/:id/audit   \u2014 run audit\n"
-        "  GET  /api/projects/:id/export  \u2014 generate report\n"
-        "  GET  /api/types             \u2014 list all 30 project types\n"
-        "  GET  /api/tools/:type       \u2014 tool registry for a type"
-    )
-
-
 # ---------------------------------------------------------------------------
 # Process execution and abort
 # ---------------------------------------------------------------------------
@@ -1955,6 +1932,13 @@ def abort_cmd(pid: int | None, abort_all_flag: bool, project_dir: str) -> None:
     default=False,
     help="Enable token optimization (caching, routing, context trim, tool filtering).",
 )
+@click.option(
+    "--json-events",
+    "json_events",
+    is_flag=True,
+    default=False,
+    help="Emit structured JSONL events to stdout (used by IDE clients like the VS Code extension).",
+)
 def run_cmd(
     project_dir: str,
     task: str,
@@ -1963,6 +1947,7 @@ def run_cmd(
     tier: str,
     no_stream: bool,
     optimize: bool,
+    json_events: bool,
 ) -> None:
     """Start the AEE-integrated agentic client REPL.
 
@@ -1994,6 +1979,7 @@ def run_cmd(
             tier=tier_map[tier],
             stream=not no_stream,
             optimize=optimize,
+            json_events=json_events,
         )
         if task:
             result = runner.run_task(task)

{specsmith-0.3.0.dev136.dist-info → specsmith-0.3.0.dev139.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.3.0.dev136
+Version: 0.3.0.dev139
 Summary: Applied Epistemic Engineering toolkit — forge epistemically-governed scaffolds, stress-test belief systems, and run AEE pipelines.
 Author: BitConcepts
 License-Expression: MIT

{specsmith-0.3.0.dev136.dist-info → specsmith-0.3.0.dev139.dist-info}/RECORD

@@ -12,7 +12,7 @@ specsmith/__main__.py,sha256=OEU30g2x5ATD1bzoo7iwwj6tST_41sgGnwPIK5dF6ao,189
 specsmith/architect.py,sha256=7lOy8PXCYMAmt6TmH25oMTvPTWke_ZC2ekjNjcuD9Zg,5439
 specsmith/auditor.py,sha256=KikmeKRdADfIAyq--zdzfn2uiZQQ-CKuHWj5WNqB5i0,23477
 specsmith/auth.py,sha256=MUvKbP7OdyH2hIYAuDS4sB-2U7xY-8zayAP5bwzLUYU,8452
-specsmith/cli.py,sha256=OpRZXsbvQpGh7vpN_YkU1QBQdN2cL6WPn5CyK-SnGCE,113195
+specsmith/cli.py,sha256=F-EoUB6eC4fLRlrzIeI3xp-nGfJ2XHKbmd94CO2UH6Q,112383
 specsmith/compressor.py,sha256=IqMF6WZMbqyA0KLQmBxRyM6xZF0g34-9lQxWcYz3tFs,4448
 specsmith/config.py,sha256=7qUer8YiV_PqR68-Yrwd1ZLpSBtai-K9r7N_B6BgQyw,11243
 specsmith/credit_analyzer.py,sha256=InobNXNzgM6dafYopKPJ7Vmod0M6wjv-TsXbxi36SbY,7052
@@ -41,7 +41,7 @@ specsmith/agent/__init__.py,sha256=BeUjS1HNKV9Ks9sTBq1Ju1CaL0TGnxuGKVTrJ-LlMXQ,1
 specsmith/agent/core.py,sha256=RkctGfIxhutVjHhXGJISxIXGP29Tt_plmmwWcf2RVBQ,5968
 specsmith/agent/hooks.py,sha256=GV6x_zOhF_xRCz5ipAqHH2eMTwi8MdwY1IV08m9hUto,7646
 specsmith/agent/optimizer.py,sha256=RA51-yMxw4GOxkC7Ip8Tbrjmsx_USJyASkShZ1SYd7c,33598
-specsmith/agent/runner.py,sha256=v0aa5iAJIwiWBP2LMzGDBN0B1ZQfzBmML7KMCFWpqd4,22610
+specsmith/agent/runner.py,sha256=KQZ54FxDpExasw-YQks-D3zxs6nUET9dLQ_Dsm-PBZo,24844
 specsmith/agent/skills.py,sha256=vGs4DkOgZwFi6PiwzDyrr8GmfhwuAReLaiO_V5LhNNg,6375
 specsmith/agent/tools.py,sha256=yaOcZ_rhwFVvhuW-KmQDEz_ODX-2ONgXo1Z_mCvhPpQ,25036
 specsmith/agent/profiles/epistemic-auditor.md,sha256=4MCwBbmauL9YdSPR6PQLxcCVM-JH_wvYUMzJIlQ_84E,2824
@@ -132,9 +132,9 @@ specsmith/vcs/base.py,sha256=IzyC3xtO8npaNbGZoAzgQyc9iSKleJFnp4GA0otTJfU,4098
 specsmith/vcs/bitbucket.py,sha256=U5cGqpybuPngjpu5GDM8aTZPm9bvZf1099OSBwU_Lro,5014
 specsmith/vcs/github.py,sha256=OVTLs9egmM_Smrxm4-Lo525Pi59x0PDMOOwqNNiM7lA,11995
 specsmith/vcs/gitlab.py,sha256=fDYYoDBic0KBnD_QWYf_K3GmdZOEartLXhzNXf4D4-0,5136
-specsmith-0.3.0.dev136.dist-info/licenses/LICENSE,sha256=jCLkf20ZMVU47ykbfIxw-5eukhnaeIsxSflw07hVNlY,1074
-specsmith-0.3.0.dev136.dist-info/METADATA,sha256=1WL4iZ-FPyqziTQw-NiJTscbohO0ELhyAQm1exFY8T4,14116
-specsmith-0.3.0.dev136.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-specsmith-0.3.0.dev136.dist-info/entry_points.txt,sha256=X_zb8_KvBONFGgkQYKIbW1UtWd3Ck7E11l3SyHO7omA,49
-specsmith-0.3.0.dev136.dist-info/top_level.txt,sha256=wu2UpLt3wnh0TwSBmoox7kOMoGfzD6mUs22ihAcEx4E,20
-specsmith-0.3.0.dev136.dist-info/RECORD,,
+specsmith-0.3.0.dev139.dist-info/licenses/LICENSE,sha256=jCLkf20ZMVU47ykbfIxw-5eukhnaeIsxSflw07hVNlY,1074
+specsmith-0.3.0.dev139.dist-info/METADATA,sha256=KnB2tUASyVviARwHBy1SFIXWV-v0c_gcALYlkQsnwsU,14116
+specsmith-0.3.0.dev139.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+specsmith-0.3.0.dev139.dist-info/entry_points.txt,sha256=X_zb8_KvBONFGgkQYKIbW1UtWd3Ck7E11l3SyHO7omA,49
+specsmith-0.3.0.dev139.dist-info/top_level.txt,sha256=wu2UpLt3wnh0TwSBmoox7kOMoGfzD6mUs22ihAcEx4E,20
+specsmith-0.3.0.dev139.dist-info/RECORD,,