prompture 1.1.2.dev2__tar.gz → 1.1.3.dev1__tar.gz

{prompture-1.1.2.dev2 → prompture-1.1.3.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prompture
-Version: 1.1.2.dev2
+Version: 1.1.3.dev1
 Summary: Ask LLMs to return structured JSON and run cross-model tests. API-first.
 Author-email: Juan Denis <juan@vene.co>
 License-Expression: MIT
@@ -102,6 +102,7 @@ Requires-Dist: prompture[rag-docx,rag-epub,rag-html,rag-hybrid,rag-pdf,rag-seman
 Dynamic: license-file
 
 <p align="center">
+  <img width="800" alt="prompture" src="https://github.com/user-attachments/assets/005f8019-b5f0-4128-9605-dd672693c46b" />
   <h1 align="center">Prompture</h1>
   <p align="center">Structured JSON extraction from any LLM. Schema-enforced, Pydantic-native, multi-provider.</p>
 </p>

{prompture-1.1.2.dev2 → prompture-1.1.3.dev1}/README.md

@@ -1,4 +1,5 @@
 <p align="center">
+  <img width="800" alt="prompture" src="https://github.com/user-attachments/assets/005f8019-b5f0-4128-9605-dd672693c46b" />
   <h1 align="center">Prompture</h1>
   <p align="center">Structured JSON extraction from any LLM. Schema-enforced, Pydantic-native, multi-provider.</p>
 </p>

{prompture-1.1.2.dev2 → prompture-1.1.3.dev1}/prompture/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.1.2.dev2'
-__version_tuple__ = version_tuple = (1, 1, 2, 'dev2')
+__version__ = version = '1.1.3.dev1'
+__version_tuple__ = version_tuple = (1, 1, 3, 'dev1')
 
 __commit_id__ = commit_id = None

{prompture-1.1.2.dev2 → prompture-1.1.3.dev1}/prompture/cli/cli.py

@@ -64,8 +64,15 @@ def coding_agents(json_output: bool, verify: bool) -> None:
         click.echo(f"{agent.id:<7} {status:<9} {source:<12} {agent.binary}{detail}")
 
 
+def _supported_coding_agent_ids() -> list[str]:
+    """Source the choice list for the `code-agent` command from the spec registry."""
+    from ..infra import supported_coding_agent_ids
+
+    return list(supported_coding_agent_ids())
+
+
 @cli.command("code-agent")
-@click.argument("agent", type=click.Choice(["claude", "codex", "gemini"]))
+@click.argument("agent", type=click.Choice(_supported_coding_agent_ids()))
 @click.argument("task", nargs=-1, required=True)
 @click.option("--cwd", default=".", type=click.Path(exists=True, file_okay=False), help="Working directory.")
 @click.option("--model", default=None, help="Model passed through to the agent CLI.")
@@ -89,7 +96,11 @@ def code_agent(
     verify: bool,
     dry_run: bool,
 ) -> None:
-    """Run Claude Code, Codex CLI, or Gemini CLI from Prompture."""
+    """Run a supported coding-agent CLI from Prompture.
+
+    Agent ids are sourced from ``CODING_AGENT_SPECS`` — currently Claude Code,
+    Codex CLI, Gemini CLI, Qwen Code, Aider, OpenCode, Cursor Agent, and Crush.
+    """
     from ..infra import build_coding_agent_command, run_coding_agent
 
     if auto_approve and yolo:

{prompture-1.1.2.dev2 → prompture-1.1.3.dev1}/prompture/infra/coding_agents.py

@@ -183,7 +183,10 @@ def build_coding_agent_command(
     """Build the subprocess command for a local coding-agent CLI.
 
     Args:
-        agent: ``"claude"``, ``"codex"``, or ``"gemini"``.
+        agent: Any agent id registered in
+            :data:`prompture.infra.CODING_AGENT_SPECS` — Claude Code, Codex,
+            Gemini, Qwen, Aider, OpenCode, Cursor Agent, Crush today, plus
+            anything callers have registered.
         task: Prompt/task to hand to the coding agent.
         cwd: Working directory for the coding agent. Defaults to the current
             process directory.

{prompture-1.1.2.dev2 → prompture-1.1.3.dev1}/prompture/infra/discovery.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import dataclasses
+import functools
 import hashlib
 import json
 import logging
@@ -248,7 +249,16 @@ def _resolved_paths_for_binary(binary: str) -> list[str]:
     return _dedupe(paths)
 
 
-def _npm_global_prefixes() -> list[Path]:
+@functools.lru_cache(maxsize=1)
+def _npm_global_prefixes_cached() -> tuple[Path, ...]:
+    """Shell out to ``npm prefix -g`` at most once per process.
+
+    Discovery is invoked many times across a process lifetime (CLI command,
+    health-check loop, server endpoint), and the npm global prefix is stable
+    inside a single process. Cache the result so we don't re-spawn npm for
+    every coding-agent lookup. Callers can :meth:`cache_clear` if they ever
+    need to force a refresh.
+    """
     prefixes: list[Path] = []
     for npm_binary in _resolved_paths_for_binary("npm"):
         try:
@@ -266,7 +276,11 @@ def _npm_global_prefixes() -> list[Path]:
         prefix = completed.stdout.strip()
         if prefix:
             prefixes.append(Path(_manual_windows_to_wsl_path(prefix)))
-    return list(dict.fromkeys(prefixes))
+    return tuple(dict.fromkeys(prefixes))
+
+
+def _npm_global_prefixes() -> list[Path]:
+    return list(_npm_global_prefixes_cached())
 
 
 def _package_path(package_name: str) -> Path:
@@ -403,6 +417,10 @@ def _node_package_candidates_from_shim(
     agent_id: str,
     shim_path: str,
 ) -> list[CodingAgentExecutable]:
+    spec = get_spec(agent_id)
+    if spec is None or not spec.npm_packages:
+        return []
+
     path = Path(shim_path)
     bases = [path.parent]
     with suppress(OSError):
@@ -450,6 +468,13 @@ def _extra_node_package_candidates(
     agent_id: str,
     binary: str,
 ) -> list[CodingAgentExecutable]:
+    # Skip the entire npm-prefix probe for agents that don't ship via npm
+    # (aider via pip, cursor-agent from the Cursor installer, crush from
+    # brew/scoop, etc.). Avoids an `npm prefix -g` subprocess per resolution.
+    spec = get_spec(agent_id)
+    if spec is None or not spec.npm_packages:
+        return []
+
     candidates: list[CodingAgentExecutable] = []
     if _looks_like_path(binary):
         path = Path(_manual_windows_to_wsl_path(os.path.expanduser(os.path.expandvars(binary))))
@@ -609,9 +634,11 @@ def get_available_coding_agents(
     """Auto-detect installed coding-agent CLIs.
 
     Args:
-        agent_paths: Optional explicit binary paths by agent id. Supported ids
-            are ``"claude"``, ``"codex"``, and ``"gemini"``. Explicit paths
-            override PATH discovery for that agent.
+        agent_paths: Optional explicit binary paths by agent id. Any id
+            registered in :data:`CODING_AGENT_SPECS` is accepted (Claude,
+            Codex, Gemini, Qwen, Aider, OpenCode, Cursor Agent, Crush today,
+            plus anything callers have added). Explicit paths override PATH
+            discovery for that agent.
         include_unavailable: When ``True`` (default), return all known agents
             with ``available=False`` for missing CLIs. When ``False``, return
             only discovered agents.

{prompture-1.1.2.dev2 → prompture-1.1.3.dev1}/prompture.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prompture
-Version: 1.1.2.dev2
+Version: 1.1.3.dev1
 Summary: Ask LLMs to return structured JSON and run cross-model tests. API-first.
 Author-email: Juan Denis <juan@vene.co>
 License-Expression: MIT
@@ -102,6 +102,7 @@ Requires-Dist: prompture[rag-docx,rag-epub,rag-html,rag-hybrid,rag-pdf,rag-seman
 Dynamic: license-file
 
 <p align="center">
+  <img width="800" alt="prompture" src="https://github.com/user-attachments/assets/005f8019-b5f0-4128-9605-dd672693c46b" />
   <h1 align="center">Prompture</h1>
   <p align="center">Structured JSON extraction from any LLM. Schema-enforced, Pydantic-native, multi-provider.</p>
 </p>