optio-opencode 0.2.2__py3-none-any.whl → 0.2.3__py3-none-any.whl

optio_opencode/prompt.py

@@ -8,7 +8,7 @@ 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)
@@ -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/session.py

@@ -97,7 +97,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 +506,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/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
 
 
@@ -28,6 +32,7 @@ _VALID_TOOL_VERBOSITY = {"silent", "description-only", "verbose"}
 
 
 __all__ = [
+    "CallerMessageCallback",
     "DeliverableCallback",
     "HookCallback",
     "SSHConfig",
@@ -52,6 +57,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``

{optio_opencode-0.2.2.dist-info → optio_opencode-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: optio-opencode
-Version: 0.2.2
+Version: 0.2.3
 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.dist-info → optio_opencode-0.2.3.dist-info}/RECORD

@@ -2,13 +2,13 @@ optio_opencode/__init__.py,sha256=Y3spOLFCKHXrhnLMvnlilknW_XWE48nI7ic_MOgKMVU,15
 optio_opencode/conversation.py,sha256=biM5vVQOpElagcUWDyNRg2IXyDLKkBRHwpDCbCWIFDQ,15344
 optio_opencode/cred_watcher.py,sha256=dRx5Ktf9qz4VqWN1VegIHGz09BnHwVbUStE3pUZeTyo,4936
 optio_opencode/host_actions.py,sha256=pQZaGsR2lXRtIg7zAEowL2CvWW3rSsY0S4sO5d1YbSk,22154
-optio_opencode/prompt.py,sha256=KnPCwAzkv4VcAtoqRXaktrKDBce3JzhvCLFfTJS6CXY,7410
+optio_opencode/prompt.py,sha256=TLR0fpCQnZJCcSSg6AAfQOK3tcTvVZVDmJRg329wM8Y,7454
 optio_opencode/seed_manifest.py,sha256=Md9-Vgidt4HTe1IGnKJnszBXcVIMwCN201L29qlljB0,2682
-optio_opencode/session.py,sha256=1TK-j_J-zoVYDsKe8JEfA6NHDmQDE2U12DnEwSUmncg,47631
+optio_opencode/session.py,sha256=PNY3q9V_D-hHYV4arJnxJ7CPy22H0zoIUV9ZstHSp_0,47816
 optio_opencode/snapshots.py,sha256=wKX4OpCMYe-M9-LNZYVBxlaDtw9s15eZhR3c2mxreXw,3285
-optio_opencode/types.py,sha256=u3B3DgijwZJfodxWx3f8PEzAPug6ivA-4UFpOT2hW7U,9104
+optio_opencode/types.py,sha256=EehxpPkHlLkGLOn7IUADsd8aJDcPo1u6s1RMSFW_sdc,9697
 optio_opencode/verify.py,sha256=44cOC3EnkjxBU5MGnL1Gs3VUkdIyO813gEF7Xn_vsac,6276
-optio_opencode-0.2.2.dist-info/METADATA,sha256=jPyh5nVQ2SPwt_tNuhSGpFPrlYTLJIX9RvlOeM7qg6E,3510
-optio_opencode-0.2.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-optio_opencode-0.2.2.dist-info/top_level.txt,sha256=1jAPllx4JDiN8gzJtbS206_8fTFSwitP9dv1WkxyiYM,15
-optio_opencode-0.2.2.dist-info/RECORD,,
+optio_opencode-0.2.3.dist-info/METADATA,sha256=CrBgnYhOATFyy3gwsQtw3Tjp-CMQ6720yAUa1bJmkjM,4154
+optio_opencode-0.2.3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+optio_opencode-0.2.3.dist-info/top_level.txt,sha256=1jAPllx4JDiN8gzJtbS206_8fTFSwitP9dv1WkxyiYM,15
+optio_opencode-0.2.3.dist-info/RECORD,,