prompture 1.13.7.dev2__tar.gz → 1.13.8.dev1__tar.gz

{prompture-1.13.7.dev2 → prompture-1.13.8.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prompture
-Version: 1.13.7.dev2
+Version: 1.13.8.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
@@ -2078,6 +2078,7 @@ prompture delegate --agent codex --cost-cap 2 "Add tests for the pricing cache"
 prompture delegate-status                  # what's the queue doing now
 prompture delegate-answer "Use SQLite"     # reply when a run ends on a question
 prompture delegate-resume                  # carry on after a failure or cost cap
+prompture delegate-stop                    # abandon the queue so a new one can start
 ```
 
 Exit codes: `0` finished, `1` failed, `3` waiting for an answer, `4` stopped

{prompture-1.13.7.dev2 → prompture-1.13.8.dev1}/README.md

@@ -1959,6 +1959,7 @@ prompture delegate --agent codex --cost-cap 2 "Add tests for the pricing cache"
 prompture delegate-status                  # what's the queue doing now
 prompture delegate-answer "Use SQLite"     # reply when a run ends on a question
 prompture delegate-resume                  # carry on after a failure or cost cap
+prompture delegate-stop                    # abandon the queue so a new one can start
 ```
 
 Exit codes: `0` finished, `1` failed, `3` waiting for an answer, `4` stopped

{prompture-1.13.7.dev2 → prompture-1.13.8.dev1}/prompture/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.13.7.dev2'
-__version_tuple__ = version_tuple = (1, 13, 7, 'dev2')
+__version__ = version = '1.13.8.dev1'
+__version_tuple__ = version_tuple = (1, 13, 8, 'dev1')
 
 __commit_id__ = commit_id = None

{prompture-1.13.7.dev2 → prompture-1.13.8.dev1}/prompture/cli/delegate_cmd.py

@@ -262,7 +262,9 @@ def delegate(
             "This companion was started with automations off. Restart it with `prompture companion` (they're on by default)."
         )
     if status == 409:
-        raise click.ClickException("The companion is already running a queue — see `prompture delegate-status`.")
+        raise click.ClickException(
+            "The companion is already running a queue — see `prompture delegate-status`, or stop it with `prompture delegate-stop`."
+        )
     if status != 200:
         raise click.ClickException(_detail(run))
     if not wait and not as_json:
@@ -310,6 +312,21 @@ def delegate_resume(wait: bool, timeout: float, as_json: bool) -> None:
         raise SystemExit(code)
 
 
+@click.command("delegate-stop")
+def delegate_stop() -> None:
+    """Stop the queue the companion is running now.
+
+    The running step is cancelled and the run is kept in history as stopped.
+    Use this to abandon a queue that is stuck or no longer wanted, so a new
+    `prompture delegate` can start.
+    """
+    client = _ensure_companion()
+    status, run = client.post("/v1/automations/current/stop")
+    if status != 200:
+        raise click.ClickException(_detail(run))
+    click.echo(f"Stopped run {run.get('id')} ({run.get('project', '')}).")
+
+
 @click.command("delegate-status")
 @click.option("--json", "as_json", is_flag=True, help="Print the queue state as JSON.")
 def delegate_status(as_json: bool) -> None:
@@ -347,4 +364,4 @@ def delegate_status(as_json: bool) -> None:
     click.echo(f"Cost so far: ${run.get('cost_usd') or 0:.4f}")
 
 
-COMMANDS = (delegate, delegate_answer, delegate_resume, delegate_status)
+COMMANDS = (delegate, delegate_answer, delegate_resume, delegate_stop, delegate_status)

{prompture-1.13.7.dev2 → prompture-1.13.8.dev1}/prompture/cli/skill_cmd.py

@@ -6,10 +6,10 @@ import click
 
 _TARGET = click.option(
     "--target",
-    type=click.Choice(["claude", "project", "path"]),
+    type=click.Choice(["claude", "kimi", "agents", "project", "path"]),
     default="claude",
     show_default=True,
-    help="claude = ~/.claude/skills, project = ./.claude/skills, path = --path DIR.",
+    help="claude = ~/.claude/skills, kimi = ~/.kimi-code/skills, agents = ~/.agents/skills, project = ./.claude/skills, path = --path DIR.",
 )
 _PATH = click.option(
     "--path", "path", default=None, type=click.Path(file_okay=False), help="Directory for --target path."

{prompture-1.13.7.dev2 → prompture-1.13.8.dev1}/prompture/skill/__init__.py

@@ -5,6 +5,8 @@ servers through Prompture.
 :func:`install_skill` copies the bundled skill into an explicit target only:
 
 * ``claude`` — ``~/.claude/skills/prompture/``
+* ``kimi`` — ``~/.kimi-code/skills/prompture/``
+* ``agents`` — ``~/.agents/skills/prompture/`` (shared agent-skills convention)
 * ``project`` — ``./.claude/skills/prompture/`` (current directory)
 * ``path`` — ``<path>/prompture/``
 
@@ -21,7 +23,7 @@ from pathlib import Path
 
 SKILL_NAME = "prompture"
 MARKER_FILE = ".prompture-skill"
-TARGETS = ("claude", "project", "path")
+TARGETS = ("claude", "kimi", "agents", "project", "path")
 
 
 def skill_source_dir() -> Path:
@@ -39,6 +41,10 @@ def resolve_target(target: str = "claude", path: str | os.PathLike[str] | None =
     """Return the skill directory for *target*."""
     if target == "claude":
         return Path.home() / ".claude" / "skills" / SKILL_NAME
+    if target == "kimi":
+        return Path.home() / ".kimi-code" / "skills" / SKILL_NAME
+    if target == "agents":
+        return Path.home() / ".agents" / "skills" / SKILL_NAME
     if target == "project":
         return Path.cwd() / ".claude" / "skills" / SKILL_NAME
     if target == "path":

{prompture-1.13.7.dev2 → prompture-1.13.8.dev1}/prompture/skill/data/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prompture
-description: Use when you need to search the web, read a URL (pages, PDFs, YouTube, GitHub, Hacker News, arXiv, Wikipedia, RSS, podcasts), transcribe or summarize video/audio, research a question with citations, call or compare LLMs from Python, extract structured JSON, mount MCP servers, use finance/news/dev/places tool packs, or check which of these work on this machine. Covers the `prompture` CLI and Python library.
+description: Use when you need to search the web, read a URL (pages, PDFs, YouTube, GitHub, Hacker News, arXiv, Wikipedia, RSS, podcasts), transcribe or summarize video/audio, research a question with citations, call or compare LLMs from Python, extract structured JSON, mount MCP servers, use finance/news/dev/places tool packs, delegate a self-contained task to a local coding agent instead of calling an external API, or check which of these work on this machine. Covers the `prompture` CLI and Python library.
 ---
 
 # Prompture
@@ -54,6 +54,7 @@ Install: `pip install prompture` (extras: `prompture[web]`, `prompture[media]`,
 | Quotes, company/crypto news, headlines, geocoding | `tools=["pack:finance"]` etc. | [references/finance.md](references/finance.md) |
 | GitHub, HN, arXiv, PyPI, npm, `gh`, `yt-dlp` | `tools=["pack:dev"]`, `tools=["cli:gh"]` | [references/dev.md](references/dev.md) |
 | Multi-source cited research | `prompture research "question"` | [references/search.md](references/search.md) |
+| Offload a self-contained task to a coding agent | `prompture delegate "task"` | this file |
 | What works here / how to fix | `prompture doctor` | this file |
 
 ## Quick commands
@@ -69,6 +70,29 @@ prompture check-update                               # newer version + highlight
 prompture skill install --target project             # put this skill in ./.claude/skills
 ```
 
+## Delegating tasks
+
+`prompture delegate "task"` hands a self-contained task to a coding agent
+(Claude Code or Codex) that the local companion runs unattended — permission
+prompts skipped, model access from this machine's Prompture setup. You need no
+provider key. **Before calling an external LLM/translation API or hunting for
+a key, delegate instead.** Don't delegate trivial work you can do inline in a
+few tool calls, or anything that needs your current conversation context.
+
+```bash
+prompture delegate --cwd /path/to/project --cost-cap 2 "Add tests for the cache"
+prompture delegate --json "Summarize this repo's architecture in 5 bullets"
+```
+
+The command blocks and streams the agent's work. Exit codes drive the next
+move: `0` finished; `1` failed (fix the cause, then `prompture delegate-resume`);
+`3` waiting for an answer (question is on stdout — reply with
+`prompture delegate-answer "..."`); `4` stopped or still running in the
+background (check `prompture delegate-status`, abandon with
+`prompture delegate-stop`). Only one queue runs at a time. Flags: `--json`,
+`--no-wait`, `--agent auto|claude|codex`, `--model provider/model`,
+`--timeout N` (stop watching; the run continues).
+
 ## Python in one block
 
 ```python

{prompture-1.13.7.dev2 → prompture-1.13.8.dev1}/prompture.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prompture
-Version: 1.13.7.dev2
+Version: 1.13.8.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
@@ -2078,6 +2078,7 @@ prompture delegate --agent codex --cost-cap 2 "Add tests for the pricing cache"
 prompture delegate-status                  # what's the queue doing now
 prompture delegate-answer "Use SQLite"     # reply when a run ends on a question
 prompture delegate-resume                  # carry on after a failure or cost cap
+prompture delegate-stop                    # abandon the queue so a new one can start
 ```
 
 Exit codes: `0` finished, `1` failed, `3` waiting for an answer, `4` stopped