codexapi 0.5.0__tar.gz → 0.5.1__tar.gz

{codexapi-0.5.0/src/codexapi.egg-info → codexapi-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.5.0
+Version: 0.5.1
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -93,10 +93,12 @@ Use `--no-yolo` to run Codex with `--full-auto` instead.
 Ralph loop mode repeats the same prompt until a completion promise or a max
 iteration cap is hit (0 means unlimited). Cancel by deleting
 `.codexapi/ralph-loop.local.md` or running `codexapi ralph --cancel`.
+By default each iteration starts with a fresh Agent context; use
+`--ralph-reuse` to keep a single shared context across iterations.
 
 ```bash
 codexapi ralph "Fix the bug." --completion-promise DONE --max-iterations 5
-codexapi ralph --ralph-fresh "Try again from scratch." --max-iterations 3
+codexapi ralph --ralph-reuse "Try again from the same context." --max-iterations 3
 codexapi ralph --cancel --cwd /path/to/project
 ```
 

{codexapi-0.5.0 → codexapi-0.5.1}/README.md

@@ -79,10 +79,12 @@ Use `--no-yolo` to run Codex with `--full-auto` instead.
 Ralph loop mode repeats the same prompt until a completion promise or a max
 iteration cap is hit (0 means unlimited). Cancel by deleting
 `.codexapi/ralph-loop.local.md` or running `codexapi ralph --cancel`.
+By default each iteration starts with a fresh Agent context; use
+`--ralph-reuse` to keep a single shared context across iterations.
 
 ```bash
 codexapi ralph "Fix the bug." --completion-promise DONE --max-iterations 5
-codexapi ralph --ralph-fresh "Try again from scratch." --max-iterations 3
+codexapi ralph --ralph-reuse "Try again from the same context." --max-iterations 3
 codexapi ralph --cancel --cwd /path/to/project
 ```
 

{codexapi-0.5.0 → codexapi-0.5.1}/pyproject.toml

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

{codexapi-0.5.0 → codexapi-0.5.1}/src/codexapi/__init__.py

@@ -15,4 +15,4 @@ __all__ = [
     "task",
     "task_result",
 ]
-__version__ = "0.5.0"
+__version__ = "0.5.1"

{codexapi-0.5.0 → codexapi-0.5.1}/src/codexapi/cli.py

@@ -920,8 +920,8 @@ def main(argv=None):
         "  --completion-promise after trimming/collapsing whitespace. CRITICAL RULE:\n"
         "  Only output the promise when it is completely and unequivocally TRUE.\n"
         "  Cancel by deleting .codexapi/ralph-loop.local.md or running codexapi ralph --cancel.\n"
-        "  Default reuses a single Codex thread; use --ralph-fresh for a new Agent\n"
-        "  each iteration (no shared context).\n"
+        "  Default starts each iteration with a fresh Agent context; use --ralph-reuse\n"
+        "  to reuse a single Codex thread across iterations.\n"
     )
     parser = argparse.ArgumentParser(
         prog="codexapi",
@@ -1026,10 +1026,20 @@ def main(argv=None):
         "--completion-promise",
         help="Promise text to match in <promise>...</promise>.",
     )
-    ralph_parser.add_argument(
+    ralph_fresh_group = ralph_parser.add_mutually_exclusive_group()
+    ralph_fresh_group.add_argument(
         "--ralph-fresh",
         action="store_true",
-        help="Start each iteration with a fresh Agent context.",
+        dest="ralph_fresh",
+        default=None,
+        help="Start each iteration with a fresh Agent context (default).",
+    )
+    ralph_fresh_group.add_argument(
+        "--ralph-reuse",
+        action="store_false",
+        dest="ralph_fresh",
+        default=None,
+        help="Reuse the same Agent context each iteration.",
     )
     ralph_parser.add_argument("--cwd", help="Working directory for the Codex session.")
     ralph_parser.add_argument(
@@ -1104,12 +1114,16 @@ def main(argv=None):
         if args.cancel:
             if args.prompt:
                 raise SystemExit("ralph --cancel takes no prompt.")
-            if args.completion_promise or args.ralph_fresh:
-                raise SystemExit("--completion-promise/--ralph-fresh are not allowed with --cancel.")
+            if args.completion_promise or args.ralph_fresh is not None:
+                raise SystemExit(
+                    "--completion-promise/--ralph-fresh/--ralph-reuse are not allowed with --cancel."
+                )
             if args.max_iterations != 0:
                 raise SystemExit("--max-iterations is not allowed with --cancel.")
             print(cancel_ralph_loop(args.cwd))
             return
+        if args.ralph_fresh is None:
+            args.ralph_fresh = True
 
     if args.command == "task" and args.task_file:
         if args.prompt:

{codexapi-0.5.0 → codexapi-0.5.1}/src/codexapi/ralph.py

@@ -19,7 +19,7 @@ def run_ralph_loop(
     flags=None,
     max_iterations=0,
     completion_promise=None,
-    fresh=False,
+    fresh=True,
 ):
     """Run a Ralph Wiggum-style loop that repeats the same prompt.
 
@@ -37,8 +37,8 @@ def run_ralph_loop(
     may ONLY output it when the statement is completely and unequivocally TRUE.
     Do not output false promises to escape the loop.
 
-    By default a single Agent instance is reused for shared context. Set
-    `fresh=True` to create a new Agent each iteration for a clean context.
+    By default each iteration uses a fresh Agent for a clean context. Set
+    `fresh=False` to reuse a single Agent instance for shared context.
     Cancel by deleting the state file or running `codexapi ralph --cancel`.
     """
     if not isinstance(prompt, str) or not prompt.strip():

{codexapi-0.5.0 → codexapi-0.5.1/src/codexapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.5.0
+Version: 0.5.1
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -93,10 +93,12 @@ Use `--no-yolo` to run Codex with `--full-auto` instead.
 Ralph loop mode repeats the same prompt until a completion promise or a max
 iteration cap is hit (0 means unlimited). Cancel by deleting
 `.codexapi/ralph-loop.local.md` or running `codexapi ralph --cancel`.
+By default each iteration starts with a fresh Agent context; use
+`--ralph-reuse` to keep a single shared context across iterations.
 
 ```bash
 codexapi ralph "Fix the bug." --completion-promise DONE --max-iterations 5
-codexapi ralph --ralph-fresh "Try again from scratch." --max-iterations 3
+codexapi ralph --ralph-reuse "Try again from the same context." --max-iterations 3
 codexapi ralph --cancel --cwd /path/to/project
 ```