codexapi 0.5.4__tar.gz → 0.5.5__tar.gz

{codexapi-0.5.4/src/codexapi.egg-info → codexapi-0.5.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.5.4
+Version: 0.5.5
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -73,8 +73,10 @@ echo "Say hello." | codexapi run
 ```bash
 codexapi task "Fix the failing tests." --max-iterations 5
 codexapi task -f task.yaml
+codexapi task -f task.yaml -i README.md
 ```
 Progress is shown by default for `codexapi task`; use `--quiet` to suppress it.
+When using `--item`, the task file must include at least one `{{item}}` placeholder.
 
 Task files default to using the standard check prompt for the task. Set `check: "None"` to skip verification.
 Use `max_iterations` in the task file to override the default attempt cap (0 means unlimited).
@@ -120,6 +122,8 @@ Run a task file across a list file:
 ```bash
 codexapi foreach list.txt task.yaml
 codexapi foreach list.txt task.yaml -n 4
+codexapi foreach list.txt task.yaml --retry-failed
+codexapi foreach list.txt task.yaml --retry-all
 ```
 
 ## API

{codexapi-0.5.4 → codexapi-0.5.5}/README.md

@@ -59,8 +59,10 @@ echo "Say hello." | codexapi run
 ```bash
 codexapi task "Fix the failing tests." --max-iterations 5
 codexapi task -f task.yaml
+codexapi task -f task.yaml -i README.md
 ```
 Progress is shown by default for `codexapi task`; use `--quiet` to suppress it.
+When using `--item`, the task file must include at least one `{{item}}` placeholder.
 
 Task files default to using the standard check prompt for the task. Set `check: "None"` to skip verification.
 Use `max_iterations` in the task file to override the default attempt cap (0 means unlimited).
@@ -106,6 +108,8 @@ Run a task file across a list file:
 ```bash
 codexapi foreach list.txt task.yaml
 codexapi foreach list.txt task.yaml -n 4
+codexapi foreach list.txt task.yaml --retry-failed
+codexapi foreach list.txt task.yaml --retry-all
 ```
 
 ## API

{codexapi-0.5.4 → codexapi-0.5.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codexapi"
-version = "0.5.4"
+version = "0.5.5"
 description = "Minimal Python API for running the Codex CLI."
 readme = "README.md"
 requires-python = ">=3.8"

{codexapi-0.5.4 → codexapi-0.5.5}/src/codexapi/__init__.py

@@ -15,4 +15,4 @@ __all__ = [
     "task",
     "task_result",
 ]
-__version__ = "0.5.4"
+__version__ = "0.5.5"

{codexapi-0.5.4 → codexapi-0.5.5}/src/codexapi/cli.py

@@ -15,7 +15,7 @@ from .agent import Agent, agent
 from .foreach import foreach
 from .ralph import cancel_ralph_loop, run_ralph_loop
 from .task import DEFAULT_MAX_ITERATIONS, TaskFailed, task
-from .taskfile import TaskFile
+from .taskfile import TaskFile, load_task_file, task_def_uses_item
 
 _SESSION_ID_RE = re.compile(
     r"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
@@ -62,6 +62,7 @@ _COLUMN_TITLES = {
     "perm": "PERM",
     "cwd": "CWD",
 }
+_FOREACH_STATUS_MARKERS = {"⏳", "✅", "❌"}
 
 
 def _read_prompt(prompt):
@@ -871,6 +872,37 @@ def _print_top_once(show):
         print(_format_session(session, layout))
 
 
+def _clean_foreach_list(path, retry_failed, retry_all):
+    with open(path, "r", encoding="utf-8") as handle:
+        data = handle.read()
+    ends_with_newline = data.endswith("\n")
+    lines = data.splitlines()
+
+    cleaned = []
+    changed = False
+    for line in lines:
+        new_line = line
+        if retry_all or (retry_failed and new_line.startswith("❌")):
+            if new_line and new_line[0] in _FOREACH_STATUS_MARKERS:
+                new_line = new_line[1:]
+                if new_line.startswith(" "):
+                    new_line = new_line[1:]
+            pipe = new_line.find("|")
+            if pipe != -1:
+                new_line = new_line[:pipe].rstrip()
+        if new_line != line:
+            changed = True
+        cleaned.append(new_line)
+
+    if not changed:
+        return
+    text = "\n".join(cleaned)
+    if ends_with_newline:
+        text += "\n"
+    with open(path, "w", encoding="utf-8") as handle:
+        handle.write(text)
+
+
 def _run_top(argv):
     if argv and argv[0] in ("-h", "--help"):
         print("usage: codexapi top")
@@ -995,6 +1027,11 @@ def main(argv=None):
         "--task-file",
         help="YAML task file to run.",
     )
+    task_parser.add_argument(
+        "-i",
+        "--item",
+        help="Item value for task files that use {{item}} placeholders.",
+    )
     task_parser.add_argument(
         "prompt",
         nargs="?",
@@ -1148,6 +1185,17 @@ def main(argv=None):
         "task_file",
         help="Path to the YAML task file.",
     )
+    foreach_retry_group = foreach_parser.add_mutually_exclusive_group()
+    foreach_retry_group.add_argument(
+        "--retry-failed",
+        action="store_true",
+        help="Reset failed (❌) items for re-run.",
+    )
+    foreach_retry_group.add_argument(
+        "--retry-all",
+        action="store_true",
+        help="Reset all items for re-run.",
+    )
     foreach_parser.add_argument(
         "-n",
         type=int,
@@ -1181,6 +1229,12 @@ def main(argv=None):
     if args.command == "foreach":
         if args.n is not None and args.n < 1:
             raise SystemExit("-n must be >= 1.")
+        if args.retry_failed or args.retry_all:
+            _clean_foreach_list(
+                args.list_file,
+                args.retry_failed,
+                args.retry_all,
+            )
         result = foreach(
             args.list_file,
             args.task_file,
@@ -1225,13 +1279,19 @@ def main(argv=None):
     if args.command == "task" and args.task_file:
         if args.prompt:
             raise SystemExit("task -f does not take a prompt.")
+        if args.item is not None:
+            task_def = load_task_file(args.task_file)
+            if not task_def_uses_item(task_def):
+                raise SystemExit(
+                    "task -f --item requires {{item}} in the task file."
+                )
         if args.check is not None:
             raise SystemExit("--check is not allowed with -f.")
         if args.max_iterations is not None:
             raise SystemExit("--max-iterations is not allowed with -f.")
         task_runner = TaskFile(
             args.task_file,
-            None,
+            args.item,
             cwd=args.cwd,
             yolo=args.yolo,
             thread_id=None,
@@ -1279,6 +1339,8 @@ def main(argv=None):
         )
         return
     if args.command == "task":
+        if args.item is not None:
+            raise SystemExit("--item is only supported with -f.")
         if args.max_iterations is None:
             args.max_iterations = DEFAULT_MAX_ITERATIONS
         if args.max_iterations < 0:

{codexapi-0.5.4 → codexapi-0.5.5}/src/codexapi/task.py

@@ -134,7 +134,17 @@ def _format_duration(seconds):
     return " ".join(parts)
 
 
-def _print_progress(
+def _progress_round_label(attempt, total):
+    if not total:
+        return f"Round {attempt}/unlimited"
+    return f"Round {attempt}/{total}"
+
+
+def _print_progress_start(attempt, total):
+    print(_progress_round_label(attempt, total), flush=True)
+
+
+def _print_progress_result(
     attempt,
     total,
     start_time,
@@ -143,13 +153,13 @@ def _print_progress(
     cwd,
     yolo,
     flags,
+    success,
 ):
     elapsed = time.monotonic() - start_time
     remaining = 0
     remaining_text = "unknown"
-    if total:
-        if attempt:
-            remaining = (elapsed / attempt) * (total - attempt)
+    if total and attempt:
+        remaining = (elapsed / attempt) * (total - attempt)
         remaining_text = _format_duration(remaining)
 
     summary_prompt = _build_progress_prompt(agent_output, check_output)
@@ -157,16 +167,13 @@ def _print_progress(
     agent_summary, check_summary = _progress_result(summary)
 
     elapsed_text = _format_duration(elapsed)
-    if not total:
-        round_text = f"Round {attempt}/unlimited"
-    else:
-        round_text = f"Round {attempt}/{total}"
+    print(f"Agent: {agent_summary}", flush=True)
+    print(f"Check: {check_summary}", flush=True)
+    verdict = "success" if success else "failure"
     print(
-        f"{round_text} ({elapsed_text} elapsed, {remaining_text} remaining)",
+        f"Verdict: {verdict} ({elapsed_text} elapsed, {remaining_text} remaining)",
         flush=True,
     )
-    print(f"Agent: {agent_summary}", flush=True)
-    print(f"Check: {check_summary}", flush=True)
     print("", flush=True)
 
 def _fix_prompt(error):
@@ -443,6 +450,11 @@ class Task:
             attempt = 0
             while True:
                 attempt += 1
+                if progress:
+                    _print_progress_start(
+                        attempt,
+                        self.max_attempts,
+                    )
                 error = self.check(self.last_output)
                 if debug:
                     _logger.debug("Check error: %s", error)
@@ -451,7 +463,7 @@ class Task:
                     check_output = self.last_check_output
                     if self.check_skipped:
                         check_output = "Verification skipped."
-                    _print_progress(
+                    _print_progress_result(
                         attempt,
                         self.max_attempts,
                         start_time,
@@ -460,6 +472,7 @@ class Task:
                         self.cwd,
                         self._yolo,
                         self._flags,
+                        not error,
                     )
                 if not error:
                     summary = self.agent(self.success_prompt())

{codexapi-0.5.4 → codexapi-0.5.5}/src/codexapi/taskfile.py

@@ -54,6 +54,17 @@ def _render(text, item):
     return text.replace(_ITEM_TOKEN, item)
 
 
+def task_def_uses_item(task_def):
+    """Return True if a task definition includes the {{item}} placeholder."""
+    if not isinstance(task_def, dict):
+        raise TypeError("task definition must be a dict")
+    for key in ("prompt", "set_up", "tear_down", "check", "on_success", "on_failure"):
+        value = task_def.get(key)
+        if isinstance(value, str) and _ITEM_TOKEN in value:
+            return True
+    return False
+
+
 class TaskFile(AutoTask):
     """Task subclass that maps a YAML task file onto Task hooks."""
 

{codexapi-0.5.4 → codexapi-0.5.5/src/codexapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.5.4
+Version: 0.5.5
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -73,8 +73,10 @@ echo "Say hello." | codexapi run
 ```bash
 codexapi task "Fix the failing tests." --max-iterations 5
 codexapi task -f task.yaml
+codexapi task -f task.yaml -i README.md
 ```
 Progress is shown by default for `codexapi task`; use `--quiet` to suppress it.
+When using `--item`, the task file must include at least one `{{item}}` placeholder.
 
 Task files default to using the standard check prompt for the task. Set `check: "None"` to skip verification.
 Use `max_iterations` in the task file to override the default attempt cap (0 means unlimited).
@@ -120,6 +122,8 @@ Run a task file across a list file:
 ```bash
 codexapi foreach list.txt task.yaml
 codexapi foreach list.txt task.yaml -n 4
+codexapi foreach list.txt task.yaml --retry-failed
+codexapi foreach list.txt task.yaml --retry-all
 ```
 
 ## API