optio-opencode 0.2.2__tar.gz → 0.2.4__tar.gz

{optio_opencode-0.2.2 → optio_opencode-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: optio-opencode
-Version: 0.2.2
+Version: 0.2.4
 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
@@ -20,9 +20,9 @@ Classifier: Topic :: Software Development :: Code Generators
 Classifier: Framework :: AsyncIO
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: optio-core<0.3,>=0.2
+Requires-Dist: optio-core<0.4,>=0.3
 Requires-Dist: optio-host<0.3,>=0.2
-Requires-Dist: optio-agents<0.3,>=0.2
+Requires-Dist: optio-agents<0.4,>=0.3
 Requires-Dist: asyncssh>=2.14
 Requires-Dist: aiohttp>=3.9
 Provides-Extra: dev
@@ -81,6 +81,18 @@ task = create_opencode_task(config)
 
 Set `ssh=None` for local subprocess mode.
 
+## Messages
+
+- `use_client_messages` (bool, default `False`) — enable the `CLIENT_MESSAGE:`
+  log keyword: the agent can push `{keyword, data}` messages to the browser
+  session that launched the task (surfaced via optio-ui's `onClientMessage`).
+- `on_caller_message` (async callback, default `None`) — enable the
+  `CALLER_MESSAGE:` log keyword: the agent can push `{keyword, data}` messages
+  to your application. Signature `(hook_ctx, keyword, data) -> str | None`;
+  a non-None return is sent back to the agent as feedback. Keywords that are
+  not enabled are absent from both the parser and the agent-facing protocol
+  documentation.
+
 ## License
 
 Apache-2.0.

{optio_opencode-0.2.2 → optio_opencode-0.2.4}/README.md

@@ -50,6 +50,18 @@ task = create_opencode_task(config)
 
 Set `ssh=None` for local subprocess mode.
 
+## Messages
+
+- `use_client_messages` (bool, default `False`) — enable the `CLIENT_MESSAGE:`
+  log keyword: the agent can push `{keyword, data}` messages to the browser
+  session that launched the task (surfaced via optio-ui's `onClientMessage`).
+- `on_caller_message` (async callback, default `None`) — enable the
+  `CALLER_MESSAGE:` log keyword: the agent can push `{keyword, data}` messages
+  to your application. Signature `(hook_ctx, keyword, data) -> str | None`;
+  a non-None return is sent back to the agent as feedback. Keywords that are
+  not enabled are absent from both the parser and the agent-facing protocol
+  documentation.
+
 ## License
 
 Apache-2.0.

{optio_opencode-0.2.2 → optio_opencode-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "optio-opencode"
-version = "0.2.2"
+version = "0.2.4"
 description = "Run opencode web as an optio task; local subprocess or remote via SSH."
 readme = "README.md"
 license = "Apache-2.0"
@@ -26,11 +26,11 @@ classifiers = [
     "Framework :: AsyncIO",
 ]
 dependencies = [
-    "optio-core>=0.2,<0.3",
+    "optio-core>=0.3,<0.4",
     # 0.1.1 introduces the bind_addr kwarg on Host.establish_tunnel —
     # required for OPTIO_WIDGET_TUNNEL_BIND to work.
     "optio-host>=0.2,<0.3",
-    "optio-agents>=0.2,<0.3",
+    "optio-agents>=0.3,<0.4",
     "asyncssh>=2.14",
     "aiohttp>=3.9",
 ]

{optio_opencode-0.2.2 → optio_opencode-0.2.4}/src/optio_opencode/prompt.py

@@ -8,10 +8,10 @@ addressed. The consumer's own task description is then appended verbatim.
 
 
 from optio_agents.prompt import downloadables_block
-from optio_agents.protocol import build_log_channel_prompt
+from optio_agents.protocol import ProtocolFeatures, build_log_channel_prompt
 
 
-_OPENCODE_INTRO = """# Coordination protocol with the host (optio-opencode)
+_OPENCODE_INTRO = """# Coordination protocol with the host harness
 
 You are running inside a coordination harness. Follow these conventions
 throughout the session.
@@ -163,7 +163,7 @@ def compose_agents_md(
         )
     if host_protocol:
         if documentation is None:
-            documentation = build_log_channel_prompt("suppress")
+            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,

{optio_opencode-0.2.2 → optio_opencode-0.2.4}/src/optio_opencode/session.py

@@ -84,6 +84,7 @@ def conversation_widget_data(config: "OpencodeTaskConfig", *, session_id: str, d
         "sessionID": session_id,
         "directory": directory,
         "toolVerbosity": config.tool_verbosity,
+        "thinkingVerbosity": config.thinking_verbosity,
         "showModelSelector": config.show_model_selector,
         "defaultModel": config.default_model,
         "showFileUpload": config.show_file_upload,
@@ -97,7 +98,11 @@ async def run_opencode_session(ctx: ProcessContext, config: OpencodeTaskConfig)
     """Execute function body for one optio-opencode task instance."""
     # --- per-task filesystem layout ---------------------------------------
     host: Host = _build_host(config, ctx.process_id)
-    protocol = get_protocol(browser="suppress")
+    protocol = get_protocol(
+        browser="suppress",
+        client_messages=config.use_client_messages,
+        caller_messages=config.on_caller_message is not None,
+    )
 
     instructions = config.consumer_instructions
     omit_task_framing = False
@@ -502,6 +507,7 @@ async def run_opencode_session(ctx: ProcessContext, config: OpencodeTaskConfig)
             body=_opencode_body,
             prepare=_prepare,
             on_deliverable=config.on_deliverable,
+            on_caller_message=config.on_caller_message,
             after_execute=config.after_execute,
             protocol=protocol,
             agent_sender=_agent_sender,

{optio_opencode-0.2.2 → optio_opencode-0.2.4}/src/optio_opencode/types.py

@@ -9,7 +9,11 @@ is owned by ``optio-host``. This module re-exports them so existing
 from dataclasses import dataclass, field
 from typing import Any, Awaitable, Callable, Literal
 
-from optio_agents.protocol.session import DeliverableCallback, HookCallback
+from optio_agents.protocol.session import (
+    CallerMessageCallback,
+    DeliverableCallback,
+    HookCallback,
+)
 from optio_host.types import SSHConfig
 
 
@@ -25,15 +29,22 @@ SeedProvider = Callable[[str], Awaitable[str]]
 ConversationMode = Literal["iframe", "conversation"]
 ToolVerbosity = Literal["silent", "description-only", "verbose"]
 _VALID_TOOL_VERBOSITY = {"silent", "description-only", "verbose"}
+# Visibility of reasoning/thinking traces in the conversation widget. Task-level,
+# mirrors ToolVerbosity; the UI never decides. (opencode reasoning is not yet wired
+# to a distinct thinking row, but the option ships for cross-engine parity.)
+ThinkingVerbosity = Literal["hidden", "visible"]
+_VALID_THINKING_VERBOSITY = {"hidden", "visible"}
 
 
 __all__ = [
+    "CallerMessageCallback",
     "DeliverableCallback",
     "HookCallback",
     "SSHConfig",
     "SeedProvider",
     "ConversationMode",
     "ToolVerbosity",
+    "ThinkingVerbosity",
     "OpencodeTaskConfig",
 ]
 
@@ -52,6 +63,14 @@ class OpencodeTaskConfig:
     opencode_config: dict[str, Any] = field(default_factory=dict)
     ssh: SSHConfig | None = None
     on_deliverable: DeliverableCallback | None = None
+    # Enable the CLIENT_MESSAGE keyword: agent-pushed messages routed to the
+    # originating browser session's frontend (stored as sessionEvents,
+    # surfaced via optio-ui's onClientMessage). Off by default.
+    use_client_messages: bool = False
+    # Enable the CALLER_MESSAGE keyword: agent-pushed messages routed to this
+    # callback in the embedding application. A non-None return value is sent
+    # back to the agent as feedback. Off (None) by default.
+    on_caller_message: CallerMessageCallback | None = None
     install_if_missing: bool = True
     # Override for the optio-owned opencode binary **cache** directory (where
     # the opencode binary is installed/cached on the worker). ``None``
@@ -113,6 +132,9 @@ class OpencodeTaskConfig:
     # Rendering hint forwarded to the widget via widgetData; only affects
     # conversation_ui rendering.
     tool_verbosity: ToolVerbosity = "description-only"
+    # Whether the conversation widget shows the agent's reasoning/thinking traces.
+    # Default hidden — thinking is noisy; opt in per task.
+    thinking_verbosity: ThinkingVerbosity = "hidden"
     # Default model for a fresh conversation session, "providerID/modelID".
     # Forwarded to the widget, which applies it once at the start of a non-
     # resumed session (history empty) and only if present in the live model
@@ -180,3 +202,8 @@ class OpencodeTaskConfig:
                 f"OpencodeTaskConfig.tool_verbosity={self.tool_verbosity!r} "
                 f"is not one of {sorted(_VALID_TOOL_VERBOSITY)}"
             )
+        if self.thinking_verbosity not in _VALID_THINKING_VERBOSITY:
+            raise ValueError(
+                f"OpencodeTaskConfig.thinking_verbosity={self.thinking_verbosity!r} "
+                f"is not one of {sorted(_VALID_THINKING_VERBOSITY)}"
+            )

{optio_opencode-0.2.2 → optio_opencode-0.2.4}/src/optio_opencode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: optio-opencode
-Version: 0.2.2
+Version: 0.2.4
 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
@@ -20,9 +20,9 @@ Classifier: Topic :: Software Development :: Code Generators
 Classifier: Framework :: AsyncIO
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
-Requires-Dist: optio-core<0.3,>=0.2
+Requires-Dist: optio-core<0.4,>=0.3
 Requires-Dist: optio-host<0.3,>=0.2
-Requires-Dist: optio-agents<0.3,>=0.2
+Requires-Dist: optio-agents<0.4,>=0.3
 Requires-Dist: asyncssh>=2.14
 Requires-Dist: aiohttp>=3.9
 Provides-Extra: dev
@@ -81,6 +81,18 @@ task = create_opencode_task(config)
 
 Set `ssh=None` for local subprocess mode.
 
+## Messages
+
+- `use_client_messages` (bool, default `False`) — enable the `CLIENT_MESSAGE:`
+  log keyword: the agent can push `{keyword, data}` messages to the browser
+  session that launched the task (surfaced via optio-ui's `onClientMessage`).
+- `on_caller_message` (async callback, default `None`) — enable the
+  `CALLER_MESSAGE:` log keyword: the agent can push `{keyword, data}` messages
+  to your application. Signature `(hook_ctx, keyword, data) -> str | None`;
+  a non-None return is sent back to the agent as feedback. Keywords that are
+  not enabled are absent from both the parser and the agent-facing protocol
+  documentation.
+
 ## License
 
 Apache-2.0.

{optio_opencode-0.2.2 → optio_opencode-0.2.4}/src/optio_opencode.egg-info/requires.txt

@@ -1,6 +1,6 @@
-optio-core<0.3,>=0.2
+optio-core<0.4,>=0.3
 optio-host<0.3,>=0.2
-optio-agents<0.3,>=0.2
+optio-agents<0.4,>=0.3
 asyncssh>=2.14
 aiohttp>=3.9
 

{optio_opencode-0.2.2 → optio_opencode-0.2.4}/tests/test_conversation_ui_model.py

@@ -59,6 +59,7 @@ def test_widget_data_carries_model_fields():
         "sessionID": "s1",
         "directory": "/wd",
         "toolVerbosity": "verbose",
+        "thinkingVerbosity": "hidden",
         "showModelSelector": True,
         "defaultModel": "opencode/big-pickle",
         "showFileUpload": False,

{optio_opencode-0.2.2 → optio_opencode-0.2.4}/tests/test_session_local.py

@@ -315,6 +315,43 @@ async def test_widget_upstream_and_data_are_set(ctx_and_captures, _supply_scenar
     assert decoded.startswith("/") and "optio-opencode" in decoded
 
 
+async def test_caller_message_reaches_callback(ctx_and_captures, _supply_scenario):
+    ctx, _cap, _ = ctx_and_captures
+    _supply_scenario["name"] = "caller_message"
+
+    received: list[tuple[str, object]] = []
+    async def on_caller(hook_ctx, keyword, data):
+        received.append((keyword, data))
+        return "pong"
+
+    cfg = OpencodeTaskConfig(
+        consumer_instructions="(scenario: caller_message)",
+        on_caller_message=on_caller,
+    )
+    await run_opencode_session(ctx, cfg)
+
+    assert received == [("ping", {"n": 1})]
+
+
+async def test_client_message_stored_as_session_event(
+    ctx_and_captures, _supply_scenario, mongo_db,
+):
+    ctx, _cap, _ = ctx_and_captures
+    _supply_scenario["name"] = "client_message"
+
+    cfg = OpencodeTaskConfig(
+        consumer_instructions="(scenario: client_message)",
+        use_client_messages=True,
+    )
+    await run_opencode_session(ctx, cfg)
+
+    doc = await mongo_db["test_processes"].find_one({"processId": "p"})
+    events = [e for e in doc.get("sessionEvents", []) if e["type"] == "client"]
+    assert len(events) == 1
+    assert events[0]["keyword"] == "notify"
+    assert events[0]["data"] == {"msg": "hi"}
+
+
 # ---- resume log -----------------------------------------------------------