codexapi 0.12.6__tar.gz → 0.12.7__tar.gz

{codexapi-0.12.6/src/codexapi.egg-info → codexapi-0.12.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.12.6
+Version: 0.12.7
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai

{codexapi-0.12.6 → codexapi-0.12.7}/pyproject.toml

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

{codexapi-0.12.6 → codexapi-0.12.7}/src/codexapi/__init__.py

@@ -29,4 +29,4 @@ __all__ = [
     "task_result",
     "lead",
 ]
-__version__ = "0.12.6"
+__version__ = "0.12.7"

{codexapi-0.12.6 → codexapi-0.12.7}/src/codexapi/agents.py

@@ -25,25 +25,35 @@ from .agent import Agent, _ensure_backend_available, _resolve_backend
 from .pushover import Pushover
 
 _DEFAULT_HOME = "~/.codexapi"
-_AGENT_PROMPT = (
-    "You are an independent codexapi agent given ownership of achieving a user's "
-    "goal and authority to act in order to do so. Part of this responsibility is "
-    "making sure you understand and stay aligned with the user's intent, even when "
-    "they are imprecise. If clarity is lacking, it is your responsibility to seek "
-    "it or to make reasonable assumptions and notify the user of them. Maintain "
-    "the agentbook as your durable working memory: preserve the goal, note durable "
-    "guidance, and keep your current picture of the work accurate and useful. This "
-    "harness gives you continuity across long periods of time and multiple "
-    "conversation turns; use that continuity to keep orienting toward the goal, "
+_FIRST_WAKE_PROMPT = (
+    "You are an independent codexapi agent starting this job. Work from the "
+    "instructions, current repository state, and agentbook. Do not assume prior "
+    "progress unless it is shown here. "
+)
+_CONTINUATION_PROMPT = (
+    "You are an independent codexapi agent continuing this job. Use the "
+    "agentbook and harness facts as the source of truth for prior progress. Do "
+    "not invent missing history. "
+)
+_AGENT_PROMPT_TAIL = (
+    "You are given ownership of achieving a user's goal and authority to act in "
+    "order to do so. Part of this responsibility is making sure you understand "
+    "and stay aligned with the user's intent, even when they are imprecise. If "
+    "clarity is lacking, it is your responsibility to seek it or to make "
+    "reasonable assumptions and notify the user of them. Maintain the agentbook "
+    "as your durable working memory: preserve the goal, note durable guidance, "
+    "and keep your current picture of the work accurate and useful. This harness "
+    "can carry work across long periods of time and multiple conversation turns; "
+    "when prior context exists, use it to keep orienting toward the goal, "
     "maintain context, and make real-world progress. If reality is not moving, "
     "treat that as evidence and reconsider your frame, assumptions, or ownership "
-    "rather than merely repeating the same report. Queued messages may contain new "
-    "goals, standing guidance, tactical requests, or useful facts; use judgment to "
-    "decide what is durable. Use codexapi task or codexapi science when you want a "
-    "separate coding worker. If you need the user's attention, put a short message "
-    "in the reply field. Put a short first-person turn summary in the update field. "
-    "If something is urgent and should send Pushover, put it in the notify field. "
-    "Respond with JSON only."
+    "rather than merely repeating the same report. Queued messages may contain "
+    "new goals, standing guidance, tactical requests, or useful facts; use "
+    "judgment to decide what is durable. Use codexapi task or codexapi science "
+    "when you want a separate coding worker. If you need the user's attention, "
+    "put a short message in the reply field. Put a short first-person turn "
+    "summary in the update field. If something is urgent and should send "
+    "Pushover, put it in the notify field. Respond with JSON only."
 )
 _AGENT_JSON = (
     "Respond with JSON only (no markdown/backticks/extra text).\n"
@@ -1112,9 +1122,11 @@ def _parse_agent_response(output):
 def _build_wake_prompt(meta, state, session, now, commands, agent_dir):
     messages = session.get("pending_messages") or []
     book_path = agent_dir / "AGENTBOOK.md"
+    wake_mode = _wake_mode(state, session)
     lines = [
-        _AGENT_PROMPT,
+        _agent_prompt(wake_mode),
         "",
+        f"Wake mode: {wake_mode.replace('_', ' ')}",
         f"Current UTC time: {format_utc(now)}",
         f"Agent name: {meta['name']}",
         f"Stop policy: {meta['stop_policy']}",
@@ -1670,6 +1682,28 @@ def _include_full_goal_prompt(state, session):
     return not ((session.get("thread_id") or state.get("thread_id") or "").strip())
 
 
+def _wake_mode(state, session):
+    markers = (
+        state.get("last_wake_at"),
+        state.get("last_success_at"),
+        state.get("reply"),
+        state.get("update"),
+        state.get("last_error"),
+        state.get("thread_id"),
+        session.get("thread_id"),
+    )
+    for value in markers:
+        if (value or "").strip():
+            return "continuation"
+    return "first_wake"
+
+
+def _agent_prompt(wake_mode):
+    if wake_mode == "continuation":
+        return _CONTINUATION_PROMPT + _AGENT_PROMPT_TAIL
+    return _FIRST_WAKE_PROMPT + _AGENT_PROMPT_TAIL
+
+
 def _wake_facts(state):
     facts = []
     previous_status = (state.get("activity") or "").strip()

{codexapi-0.12.6 → codexapi-0.12.7/src/codexapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.12.6
+Version: 0.12.7
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai

{codexapi-0.12.6 → codexapi-0.12.7}/tests/test_agents.py

@@ -189,6 +189,7 @@ class AgentsTests(unittest.TestCase):
                 agent_dir,
             )
             self.assertIn("Agentbook (header + latest notes):", prompt)
+            self.assertIn("Wake mode: continuation", prompt)
             self.assertIn("## Purpose", prompt)
             self.assertIn("Hold the whole.", prompt)
             self.assertIn("Watch for the real issue.", prompt)
@@ -196,8 +197,10 @@ class AgentsTests(unittest.TestCase):
             self.assertIn("Previous status: Watching", prompt)
             self.assertIn("Previous update: Still narrowing the field.", prompt)
             self.assertIn("[... older notes omitted ...]", prompt)
+            self.assertIn("You are an independent codexapi agent continuing this job.", prompt)
             self.assertNotIn("Original instructions:", prompt)
             self.assertNotIn("OLD alpha alpha alpha alpha alpha alpha alpha alpha alpha alpha alpha alpha alpha alpha alpha alpha alpha alpha", prompt)
+            self.assertNotIn("resuming stewardship", prompt)
 
     def test_build_wake_prompt_repairs_legacy_agentbook_before_wake(self):
         with _temp_home() as home:
@@ -235,9 +238,33 @@ class AgentsTests(unittest.TestCase):
             self.assertIn("The durable agentbook header was restored automatically on wake", repaired)
             self.assertIn("Legacy note about the real issue.", repaired)
             self.assertIn("## Purpose", prompt)
+            self.assertIn("Wake mode: continuation", prompt)
             self.assertIn("Keep the true goal in view.", prompt)
             self.assertNotIn("Original instructions:", prompt)
 
+    def test_build_wake_prompt_marks_first_wake_without_prior_history(self):
+        with _temp_home() as home:
+            agent = start_agent("Start from what is actually shown.", hostname="host-a")
+            agent_dir = home / "agents" / agent["id"]
+            meta = json.loads((agent_dir / "meta.json").read_text(encoding="utf-8"))
+            state = json.loads((agent_dir / "state.json").read_text(encoding="utf-8"))
+            session = json.loads((agent_dir / "hosts" / "host-a" / "session.json").read_text(encoding="utf-8"))
+
+            prompt = _build_wake_prompt(
+                meta,
+                state,
+                session,
+                datetime(2026, 3, 23, 9, 30, tzinfo=timezone.utc),
+                [],
+                agent_dir,
+            )
+
+            self.assertIn("Wake mode: first wake", prompt)
+            self.assertIn("You are an independent codexapi agent starting this job.", prompt)
+            self.assertIn("Do not assume prior progress unless it is shown here.", prompt)
+            self.assertIn("Original instructions:", prompt)
+            self.assertNotIn("resuming stewardship", prompt)
+
     def test_leadbook_block_shows_header_and_latest_notes(self):
         leadbook = "\n".join(
             [