optio-opencode 0.5.0__tar.gz → 0.6.1__tar.gz

{optio_opencode-0.5.0 → optio_opencode-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: optio-opencode
-Version: 0.5.0
+Version: 0.6.1
 Summary: Run opencode web as an optio task; local subprocess or remote via SSH.
 Author-email: Kristof Csillag <kristof.csillag@deai-labs.com>
 License-Expression: Apache-2.0
@@ -23,9 +23,9 @@ Description-Content-Type: text/markdown
 Requires-Dist: optio-core<0.5,>=0.4
 Requires-Dist: optio-host<0.4,>=0.3
 Requires-Dist: optio-agents<0.7,>=0.6
-Requires-Dist: optio-claudecode<0.6,>=0.5
-Requires-Dist: optio-codex<0.4,>=0.3
-Requires-Dist: optio-grok<0.4,>=0.3
+Requires-Dist: optio-claudecode<0.7,>=0.6
+Requires-Dist: optio-codex<0.5,>=0.4
+Requires-Dist: optio-grok<0.5,>=0.4
 Requires-Dist: asyncssh>=2.14
 Requires-Dist: aiohttp>=3.9
 Provides-Extra: dev

{optio_opencode-0.5.0 → optio_opencode-0.6.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "optio-opencode"
-version = "0.5.0"
+version = "0.6.1"
 description = "Run opencode web as an optio task; local subprocess or remote via SSH."
 readme = "README.md"
 license = "Apache-2.0"
@@ -34,9 +34,9 @@ dependencies = [
     # The account meta-analyzer's per-provider handlers reuse the extracted
     # vendor map helpers (account_from_oauth_token / account_from_openai /
     # account_from_xai) rather than reimplement each vendor's fetch+map.
-    "optio-claudecode>=0.5,<0.6",
-    "optio-codex>=0.3,<0.4",
-    "optio-grok>=0.3,<0.4",
+    "optio-claudecode>=0.6,<0.7",
+    "optio-codex>=0.4,<0.5",
+    "optio-grok>=0.4,<0.5",
     "asyncssh>=2.14",
     "aiohttp>=3.9",
 ]

{optio_opencode-0.5.0 → optio_opencode-0.6.1}/src/optio_opencode/conversation.py

@@ -297,7 +297,9 @@ class OpencodeConversation:
 
     # -- Conversation protocol surface --------------------------------------
 
-    async def send(self, text: str) -> None:
+    async def send(self, text: str, *, uuid: str | None = None) -> None:
+        """``uuid`` is an advisory message id (Fix 13a/Fix 23): this backend
+        has no message identity of its own, so it is accepted and ignored."""
         if self._closed.is_set():
             raise ConversationClosed(self._close_reason or "conversation closed")
         if self._http is None:

optio_opencode-0.6.1/src/optio_opencode/prompt.py

@@ -0,0 +1,48 @@
+"""AGENTS.md composition for optio-opencode: the profile, plus a thin wrapper
+over the shared composer (``optio_agents.prompt.compose_instructions_file``),
+which owns all of the text."""
+
+from optio_agents.prompt import (
+    DEFAULT_CONVERSATION_INSTRUCTIONS,
+    AgentPromptProfile,
+    compose_instructions_file,
+)
+from optio_host.archive import DEFAULT_WORKDIR_EXCLUDES
+
+__all__ = ["DEFAULT_CONVERSATION_INSTRUCTIONS", "PROFILE", "compose_agents_md"]
+
+# opencode suppresses browser opens (its docs must not advertise BROWSER:), and
+# keeps no state dir the agent needs to know about.
+PROFILE = AgentPromptProfile(browser="suppress")
+
+
+def compose_agents_md(
+    consumer_instructions: str,
+    *,
+    workdir_exclude: list[str] | None = None,
+    documentation: str | None = None,
+    supports_resume: bool = True,
+    host_protocol: bool = True,
+    omit_task_framing: bool = False,
+    fs_isolation_dirs: list[tuple[str, str]] | None = None,
+    file_download: bool = False,
+    check_resume_log_every_message: bool = True,
+) -> str:
+    """Render <workdir>/AGENTS.md for an optio-opencode task.
+
+    ``workdir_exclude=None`` means the framework defaults, the same list the
+    snapshot archive uses (``optio_host.archive``)."""
+    return compose_instructions_file(
+        consumer_instructions,
+        profile=PROFILE,
+        workdir_exclude=(
+            list(DEFAULT_WORKDIR_EXCLUDES) if workdir_exclude is None else workdir_exclude
+        ),
+        documentation=documentation,
+        supports_resume=supports_resume,
+        host_protocol=host_protocol,
+        omit_task_framing=omit_task_framing,
+        fs_isolation_dirs=fs_isolation_dirs,
+        file_download=file_download,
+        check_resume_log_every_message=check_resume_log_every_message,
+    )

{optio_opencode-0.5.0 → optio_opencode-0.6.1}/src/optio_opencode/session.py

@@ -32,6 +32,7 @@ from optio_core.models import BasicAuth, TaskInstance
 
 from optio_agents import HookContext
 from optio_agents import RESUME_NOTICE, SYSTEM_MESSAGE_PREFIX
+from optio_agents.fs_grants import fs_isolation_dirs
 from optio_host.host import Host, LocalHost, ProcessHandle
 from optio_host.paths import task_dir
 from optio_agents.protocol.session import _SessionFailed, run_log_protocol_session
@@ -347,6 +348,7 @@ async def run_opencode_session(ctx: ProcessContext, config: OpencodeTaskConfig)
                     supports_resume=config.supports_resume,
                     host_protocol=config.host_protocol,
                     omit_task_framing=omit_task_framing,
+                    fs_isolation_dirs=fs_isolation_dirs(config, host.workdir),
                     file_download=config.file_download,
                 ),
             )
@@ -390,7 +392,7 @@ async def run_opencode_session(ctx: ProcessContext, config: OpencodeTaskConfig)
             # Resume: when on_resume_refresh is wired, recompute AGENTS.md
             # from the refreshed config and overwrite the workdir copy if
             # the rendered text differs from the snapshot-restored file.
-            refreshed_files = await _maybe_refresh_on_resume(host, hook_ctx, config)
+            refreshed_files = await _maybe_refresh_on_resume(host, hook_ctx, config, protocol)
 
         # opencode.json is wholly optio-generated (the seed never carries the
         # workdir-root copy — its manifest only includes files under home/),
@@ -1031,11 +1033,14 @@ async def _append_resume_log_entry(
 
 
 async def _maybe_refresh_on_resume(
-    host, hook_ctx, config: OpencodeTaskConfig,
+    host, hook_ctx, config: OpencodeTaskConfig, protocol,
 ) -> list[str]:
     """Run the on_resume_refresh hook (if any) and rewrite AGENTS.md when
     the rendered content differs from the workdir copy.
 
+    ``protocol`` is the session's protocol; its documentation is rendered so
+    the refreshed file matches the fresh-start composition.
+
     Returns the list of filenames the harness rewrote (currently at most
     ``["AGENTS.md"]``), suitable for tagging the next ``resume.log`` line.
     A hook that raises is logged and ignored — the resumed session keeps
@@ -1050,13 +1055,23 @@ async def _maybe_refresh_on_resume(
             "on_resume_refresh raised; keeping existing AGENTS.md from snapshot",
         )
         return []
+    # Mode-aware prompt kwargs, recomputed from the refreshed config (same
+    # defaulting as the fresh-start composition above).
+    instructions = new_config.consumer_instructions
+    omit_task_framing = False
+    if new_config.mode == "conversation" and not instructions:
+        instructions = DEFAULT_CONVERSATION_INSTRUCTIONS
+        omit_task_framing = True
     new_agents_md = compose_agents_md(
-        new_config.consumer_instructions,
+        instructions,
+        documentation=protocol.documentation if new_config.host_protocol else None,
         workdir_exclude=new_config.workdir_exclude,
         supports_resume=new_config.supports_resume,
         # Reflect the refreshed config so a resume keeps the downloadables block
         # (with the right wording — host_protocol drives comparative vs standalone).
         host_protocol=new_config.host_protocol,
+        omit_task_framing=omit_task_framing,
+        fs_isolation_dirs=fs_isolation_dirs(new_config, host.workdir),
         file_download=new_config.file_download,
     )
     try:

{optio_opencode-0.5.0 → optio_opencode-0.6.1}/src/optio_opencode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: optio-opencode
-Version: 0.5.0
+Version: 0.6.1
 Summary: Run opencode web as an optio task; local subprocess or remote via SSH.
 Author-email: Kristof Csillag <kristof.csillag@deai-labs.com>
 License-Expression: Apache-2.0
@@ -23,9 +23,9 @@ Description-Content-Type: text/markdown
 Requires-Dist: optio-core<0.5,>=0.4
 Requires-Dist: optio-host<0.4,>=0.3
 Requires-Dist: optio-agents<0.7,>=0.6
-Requires-Dist: optio-claudecode<0.6,>=0.5
-Requires-Dist: optio-codex<0.4,>=0.3
-Requires-Dist: optio-grok<0.4,>=0.3
+Requires-Dist: optio-claudecode<0.7,>=0.6
+Requires-Dist: optio-codex<0.5,>=0.4
+Requires-Dist: optio-grok<0.5,>=0.4
 Requires-Dist: asyncssh>=2.14
 Requires-Dist: aiohttp>=3.9
 Provides-Extra: dev

{optio_opencode-0.5.0 → optio_opencode-0.6.1}/src/optio_opencode.egg-info/SOURCES.txt

@@ -50,7 +50,6 @@ tests/test_model_probe_wiring.py
 tests/test_prompt.py
 tests/test_provider_deepseek.py
 tests/test_purge_seed.py
-tests/test_resume_sentence_opencode.py
 tests/test_sanity.py
 tests/test_seed_config.py
 tests/test_session_blob_hooks.py

{optio_opencode-0.5.0 → optio_opencode-0.6.1}/src/optio_opencode.egg-info/requires.txt

@@ -1,9 +1,9 @@
 optio-core<0.5,>=0.4
 optio-host<0.4,>=0.3
 optio-agents<0.7,>=0.6
-optio-claudecode<0.6,>=0.5
-optio-codex<0.4,>=0.3
-optio-grok<0.4,>=0.3
+optio-claudecode<0.7,>=0.6
+optio-codex<0.5,>=0.4
+optio-grok<0.5,>=0.4
 asyncssh>=2.14
 aiohttp>=3.9
 

{optio_opencode-0.5.0 → optio_opencode-0.6.1}/tests/test_prompt.py

@@ -1,12 +1,10 @@
 """Tests for prompt composition."""
 
-import pytest
-
 from optio_opencode.prompt import compose_agents_md
 
 
 def _compose(consumer="say hi", workdir_exclude=None, supports_resume=True):
-    """Helper: call compose_agents_md with the new mandatory args."""
+    """Helper: call compose_agents_md with a default workdir_exclude/supports_resume."""
     return compose_agents_md(
         consumer,
         workdir_exclude=workdir_exclude,
@@ -42,12 +40,6 @@ def test_compose_agents_md_empty_consumer_still_ends_cleanly():
     assert out.endswith("\n")
 
 
-def test_compose_agents_md_workdir_exclude_required():
-    """workdir_exclude is mandatory — calling without it raises TypeError."""
-    with pytest.raises(TypeError):
-        compose_agents_md("hi")  # type: ignore[call-arg]
-
-
 def test_compose_agents_md_includes_resume_section_by_default():
     """Default supports_resume=True → resume section is present."""
     out = _compose()
@@ -146,3 +138,21 @@ def test_default_composition_unchanged():
     out = compose_agents_md("body", workdir_exclude=None)
     assert "## Task" in out
     assert "optio.log" in out
+
+
+def test_sandbox_note_and_threaded_docs():
+    from optio_agents import get_protocol
+    docs = get_protocol(browser="suppress", client_messages=True).documentation
+    out = compose_agents_md(
+        "x", documentation=docs, fs_isolation_dirs=[("/wd", "rwx")],
+    )
+    assert "CLIENT_MESSAGE:" in out
+    assert "**Filesystem access:**" in out and "`/wd`" in out
+
+
+def test_no_prompt_text_of_its_own():
+    import inspect
+    import optio_opencode.prompt as m
+    src = inspect.getsource(m)
+    assert "This harness may pause your session" not in src
+    assert "You are running inside a coordination harness" not in src

{optio_opencode-0.5.0 → optio_opencode-0.6.1}/tests/test_session_local.py

@@ -481,6 +481,7 @@ async def test_append_resume_log_entry_empty_refreshed_omits_tag(tmp_workdir):
 async def test_maybe_refresh_on_resume_no_hook(tmp_workdir):
     """on_resume_refresh=None → returns [] and does not write AGENTS.md."""
     import os
+    from optio_agents import get_protocol
     from optio_host.host import LocalHost
     from optio_opencode.session import _maybe_refresh_on_resume
     from optio_opencode.types import OpencodeTaskConfig
@@ -492,7 +493,9 @@ async def test_maybe_refresh_on_resume_no_hook(tmp_workdir):
         consumer_instructions="x", on_resume_refresh=None, fs_isolation=False,
     )
 
-    refreshed = await _maybe_refresh_on_resume(host, None, config)
+    refreshed = await _maybe_refresh_on_resume(
+        host, None, config, get_protocol(browser="suppress"),
+    )
 
     assert refreshed == []
     assert not os.path.exists(os.path.join(host.workdir, "AGENTS.md"))
@@ -501,6 +504,7 @@ async def test_maybe_refresh_on_resume_no_hook(tmp_workdir):
 async def test_maybe_refresh_on_resume_unchanged_content_skips_write(tmp_workdir):
     """Hook return identical to existing AGENTS.md → no write, [] returned."""
     import os
+    from optio_agents import get_protocol
     from optio_host.host import LocalHost
     from optio_opencode.prompt import compose_agents_md
     from optio_opencode.session import _maybe_refresh_on_resume
@@ -524,17 +528,63 @@ async def test_maybe_refresh_on_resume_unchanged_content_skips_write(tmp_workdir
             with open(full) as f:
                 return f.read()
 
-    refreshed = await _maybe_refresh_on_resume(host, _FakeHookCtx(), config)
+    refreshed = await _maybe_refresh_on_resume(
+        host, _FakeHookCtx(), config, get_protocol(browser="suppress"),
+    )
 
     assert refreshed == []
     mtime_after = os.path.getmtime(os.path.join(host.workdir, "AGENTS.md"))
     assert mtime_after == mtime_before  # write was skipped
 
 
+async def test_maybe_refresh_on_resume_conversation_defaults_match_fresh(tmp_workdir):
+    """Identity refresh of a conversation-mode session with empty instructions
+    must default/omit-task-frame exactly like the fresh-start path, so an
+    unchanged config produces no rewrite on resume."""
+    import os
+    from optio_agents import get_protocol
+    from optio_host.host import LocalHost
+    from optio_opencode.prompt import DEFAULT_CONVERSATION_INSTRUCTIONS, compose_agents_md
+    from optio_opencode.session import _maybe_refresh_on_resume
+    from optio_opencode.types import OpencodeTaskConfig
+
+    host = LocalHost(taskdir=tmp_workdir)
+    await host.setup_workdir()
+    # Identity on_resume_refresh (the default), conversation mode, no instructions.
+    config = OpencodeTaskConfig(
+        consumer_instructions="", mode="conversation", host_protocol=False,
+        fs_isolation=False,
+    )
+    # What the fresh-start path would have written for this config.
+    expected = compose_agents_md(
+        DEFAULT_CONVERSATION_INSTRUCTIONS,
+        workdir_exclude=config.workdir_exclude,
+        supports_resume=config.supports_resume,
+        host_protocol=config.host_protocol,
+        omit_task_framing=True,
+    )
+    await host.write_text("AGENTS.md", expected)
+
+    class _FakeHookCtx:
+        async def read_text_from_host(self, path, *, silent=False):
+            full = os.path.join(host.workdir, path)
+            with open(full) as f:
+                return f.read()
+
+    refreshed = await _maybe_refresh_on_resume(
+        host, _FakeHookCtx(), config, get_protocol(browser="suppress"),
+    )
+
+    assert refreshed == []
+    with open(os.path.join(host.workdir, "AGENTS.md")) as f:
+        assert f.read() == expected
+
+
 async def test_maybe_refresh_on_resume_changed_content_writes(tmp_workdir):
     """Hook returns new instructions → AGENTS.md rewritten, ['AGENTS.md']."""
     import os
     from dataclasses import replace
+    from optio_agents import get_protocol
     from optio_host.host import LocalHost
     from optio_opencode.prompt import compose_agents_md
     from optio_opencode.session import _maybe_refresh_on_resume
@@ -560,7 +610,9 @@ async def test_maybe_refresh_on_resume_changed_content_writes(tmp_workdir):
             with open(full) as f:
                 return f.read()
 
-    refreshed = await _maybe_refresh_on_resume(host, _FakeHookCtx(), config)
+    refreshed = await _maybe_refresh_on_resume(
+        host, _FakeHookCtx(), config, get_protocol(browser="suppress"),
+    )
 
     assert refreshed == ["AGENTS.md"]
     with open(os.path.join(host.workdir, "AGENTS.md")) as f:
@@ -572,6 +624,7 @@ async def test_maybe_refresh_on_resume_changed_content_writes(tmp_workdir):
 async def test_maybe_refresh_on_resume_hook_raises_keeps_existing(tmp_workdir):
     """Hook that raises → returns [] and leaves existing AGENTS.md alone."""
     import os
+    from optio_agents import get_protocol
     from optio_host.host import LocalHost
     from optio_opencode.session import _maybe_refresh_on_resume
     from optio_opencode.types import OpencodeTaskConfig
@@ -586,13 +639,45 @@ async def test_maybe_refresh_on_resume_hook_raises_keeps_existing(tmp_workdir):
         consumer_instructions="x", on_resume_refresh=_boom, fs_isolation=False,
     )
 
-    refreshed = await _maybe_refresh_on_resume(host, None, config)
+    refreshed = await _maybe_refresh_on_resume(
+        host, None, config, get_protocol(browser="suppress"),
+    )
 
     assert refreshed == []
     with open(os.path.join(host.workdir, "AGENTS.md")) as f:
         assert f.read() == "existing content"
 
 
+async def test_maybe_refresh_on_resume_threads_session_docs(tmp_workdir):
+    """The refreshed AGENTS.md carries the SESSION's protocol docs (client
+    messages documented when the task enables them), not rebuilt defaults."""
+    import os
+    from dataclasses import replace
+    from optio_agents import get_protocol
+    from optio_host.host import LocalHost
+    from optio_opencode.session import _maybe_refresh_on_resume
+    from optio_opencode.types import OpencodeTaskConfig
+
+    host = LocalHost(taskdir=tmp_workdir)
+    await host.setup_workdir()
+    config = OpencodeTaskConfig(
+        consumer_instructions="task X", fs_isolation=False, use_client_messages=True,
+        on_resume_refresh=lambda c: replace(c, consumer_instructions="task Y"),
+    )
+    await host.write_text("AGENTS.md", "stale")
+
+    class _FakeHookCtx:
+        async def read_text_from_host(self, path, *, silent=False):
+            with open(os.path.join(host.workdir, path)) as f:
+                return f.read()
+
+    protocol = get_protocol(browser="suppress", client_messages=True)
+    assert await _maybe_refresh_on_resume(host, _FakeHookCtx(), config, protocol) == ["AGENTS.md"]
+    with open(os.path.join(host.workdir, "AGENTS.md")) as f:
+        text = f.read()
+    assert "task Y" in text and "CLIENT_MESSAGE:" in text
+
+
 async def test_session_local_supports_resume_false_skips_resume_log(
     ctx_and_captures, _supply_scenario, tmp_workdir, monkeypatch,
 ):

optio_opencode-0.5.0/src/optio_opencode/prompt.py

@@ -1,185 +0,0 @@
-"""System-prompt composition for optio-opencode.
-
-The base prompt teaches opencode (via AGENTS.md) how to coordinate with the
-host harness: which log file to append status/deliverable/done/error lines
-to, where to put deliverable files, and how the human expects to be
-addressed. The consumer's own task description is then appended verbatim.
-"""
-
-
-from optio_agents.prompt import downloadables_block
-from optio_agents.protocol import ProtocolFeatures, build_log_channel_prompt
-
-
-_OPENCODE_INTRO = """# Coordination protocol with the host harness
-
-You are running inside a coordination harness. Follow these conventions
-throughout the session.
-
-"""
-
-
-DEFAULT_CONVERSATION_INSTRUCTIONS = "Let's have a conversation with the user."
-
-_SYSTEM_PREFIX_EXPLAINER = """
-(Messages prefixed `System:` on your input channel originate from the
-harness coordinating this session, not from the human user.)
-"""
-
-
-BASE_PROMPT_POST = """## Task
-
-Here comes the description of your actual task to complete. Throughout
-the task, you are encouraged to narrate progress — both on the normal
-UI and in parallel using the `STATUS:` messages explained above — and
-you are free to ask questions and dialogue with the human. They are
-also working on the same task and will cooperate with you on achieving
-the same goals. So:
-"""
-
-
-RESUME_SECTION_TEMPLATE = """## Resumes
-
-This harness may pause your session, save your context to a database,
-terminate the underlying process, and later rehydrate it. From your
-point of view the conversation is fully continuous — you keep your
-prior context and will not "notice" the resume.
-
-**A resume can happen at any point, not only at the start.** The host
-environment may have changed across a resume — different host,
-different running processes, files outside this workdir gone — even
-though your context remembers everything as alive and well.
-
-**The workdir (this directory) is preserved across resumes, with two
-caveats:**
-
-- {excludes_clause}
-- **Anything outside the workdir is not preserved.**
-
-{outside_clause}
-
-### Detecting a resume: `resume.log`
-
-Each session start (fresh or resumed) appends one line to
-`./resume.log`. Line format:
-
-```
-<ISO 8601 UTC timestamp>[ REFRESHED:<comma-separated filenames>]
-```
-
-The very first line is the original launch timestamp; each subsequent
-line is a resume. The optional `REFRESHED:` suffix signals that the
-harness rewrote the listed files on that resume (e.g.
-`2026-05-28T13:15:42Z REFRESHED:AGENTS.md`) — your in-memory copy of
-those files is stale and must be re-read before continuing.
-
-**At the start of every new incoming user message, read
-`./resume.log` first.** Compare the latest line to the value you
-remembered last time you checked. If a new line has appeared, treat
-the situation as a resume:
-
-- Verify any tools, processes, or files you previously gathered
-  outside the workdir are still where you left them.
-- Re-establish anything that's gone (re-launch a server, re-fetch a
-  file, etc.) before continuing.
-- **If the latest line carries a `REFRESHED:` suffix, re-read each
-  listed file** (e.g. `cat ./AGENTS.md`) — the harness updated it
-  since your last context snapshot and the version you remember is
-  out of date.
-- Then resume the work you were doing.
-
-If a resume slips past unnoticed, a failing tool call is the
-next-best signal — re-check `./resume.log` then.
-
-You may also be notified of a resume by a `System:` message on your input
-channel; when you see one, follow the `resume.log` procedure above.
-"""
-
-
-def _render_resume_section(workdir_exclude: list[str] | None) -> str:
-    """Render the RESUME_SECTION_TEMPLATE with the effective exclude list."""
-    from optio_host.archive import DEFAULT_WORKDIR_EXCLUDES
-    effective = workdir_exclude if workdir_exclude is not None else DEFAULT_WORKDIR_EXCLUDES
-    if not effective:
-        excludes_clause = (
-            "**No paths are excluded** — every file in the workdir is preserved."
-        )
-        outside_clause = (
-            "If you need to stash large data, place it outside the workdir "
-            "(e.g. `/tmp/`) — but remember it may be missing when you next look."
-        )
-    else:
-        excludes_str = ", ".join(f"`{p}`" for p in effective)
-        excludes_clause = (
-            f"**Paths matching the snapshot exclude list are NOT preserved**, "
-            f"even inside the workdir. The current exclude list is: {excludes_str}."
-        )
-        outside_clause = (
-            "If you need to stash large data, place it outside the workdir "
-            "(e.g. `/tmp/`) or inside an excluded subdirectory — but remember "
-            "any such location may be missing when you next look."
-        )
-    return RESUME_SECTION_TEMPLATE.format(
-        excludes_clause=excludes_clause,
-        outside_clause=outside_clause,
-    )
-
-
-def compose_agents_md(
-    consumer_instructions: str,
-    *,
-    workdir_exclude: list[str] | None,
-    documentation: str | None = None,
-    supports_resume: bool = True,
-    host_protocol: bool = True,
-    omit_task_framing: bool = False,
-    file_download: bool = False,
-) -> str:
-    """Build the full AGENTS.md body.
-
-    Parameters:
-      consumer_instructions: the task author's prompt, appended verbatim.
-      workdir_exclude: the snapshot exclude list for this task. Mandatory:
-        callers must pass it explicitly to prevent silent desync between
-        archive.py defaults and the prompt's claims about what's preserved.
-        Pass None to render with the framework defaults.
-      documentation: the keyword-protocol block; the session passes
-        ``get_protocol(browser="suppress").documentation``. Defaults (for
-        unit tests / standalone callers) to opencode's ``suppress`` docs.
-      supports_resume: when False, the resume-detection section is omitted
-        from the prompt. Default True.
-
-    ``host_protocol=False`` omits the keyword-protocol documentation
-    block entirely (conversation mode without the optio.log channel);
-    the resume section then gains a self-contained ``System:`` explainer
-    that the protocol docs would otherwise provide.
-
-    ``omit_task_framing=True`` drops the ``## Task`` framing block
-    (used when the conversation instructions were defaulted).
-    """
-    if file_download:
-        consumer_instructions = (
-            consumer_instructions.rstrip() + downloadables_block(comparative=host_protocol)
-        )
-    if host_protocol:
-        if documentation is None:
-            documentation = build_log_channel_prompt(ProtocolFeatures(browser="suppress"))
-        base_prompt_pre = _OPENCODE_INTRO + documentation
-    else:
-        # Conversation mode without the optio.log channel: no keyword docs,
-        # and the intro that frames them is dropped too.
-        base_prompt_pre = ""
-    if supports_resume:
-        resume_block = _render_resume_section(workdir_exclude)
-        if not host_protocol:
-            # The protocol docs normally explain the `System:` convention;
-            # without them the resume section carries its own explainer.
-            resume_block = resume_block + _SYSTEM_PREFIX_EXPLAINER
-        resume_block = resume_block + "\n"
-    else:
-        resume_block = ""
-    body = consumer_instructions.rstrip()
-    pre = f"{base_prompt_pre}\n" if base_prompt_pre else ""
-    if omit_task_framing:
-        return f"{pre}{resume_block}{body}\n"
-    return f"{pre}{resume_block}{BASE_PROMPT_POST}\n{body}\n"

optio_opencode-0.5.0/tests/test_resume_sentence_opencode.py

@@ -1,7 +0,0 @@
-from optio_opencode.prompt import _render_resume_section
-
-
-def test_resume_section_mentions_system_notification():
-    section = _render_resume_section(None)
-    assert "`System:` message" in section
-    assert "resume.log" in section