fix(app-server): clarify command stdin write API

Author: gersmann

codex/app_server/_async_services.py

@@ -357,13 +357,19 @@ async def execute(
 
     exec = execute
 
-    async def write(
+    async def write_stdin(
         self,
         *,
         process_id: str,
         close_stdin: bool | None = None,
         delta_base64: str | None = None,
     ) -> EmptyResult:
+        """Write stdin bytes to a running `command/exec` process or close stdin.
+
+        This wraps the app-server `command/exec/write` request. `delta_base64`
+        is optional base64-encoded stdin data; `close_stdin` closes the
+        process stdin after the optional write.
+        """
         params = protocol.CommandExecWriteParams(
             closeStdin=close_stdin,
             deltaBase64=delta_base64,

codex/app_server/_sync_services.py

@@ -198,7 +198,7 @@ async def execute(
         tty: bool | None = None,
     ) -> CommandExecResult: ...
 
-    async def write(
+    async def write_stdin(
         self,
         *,
         process_id: str,
@@ -588,15 +588,21 @@ def execute(
 
     exec = execute
 
-    def write(
+    def write_stdin(
         self,
         *,
         process_id: str,
         close_stdin: bool | None = None,
         delta_base64: str | None = None,
     ) -> EmptyResult:
+        """Write stdin bytes to a running `command/exec` process or close stdin.
+
+        This wraps the app-server `command/exec/write` request. `delta_base64`
+        is optional base64-encoded stdin data; `close_stdin` closes the
+        process stdin after the optional write.
+        """
         return self._run(
-            self._async_client.write(
+            self._async_client.write_stdin(
                 process_id=process_id,
                 close_stdin=close_stdin,
                 delta_base64=delta_base64,

tests/test_app_server_client.py

@@ -1938,7 +1938,7 @@ def command_terminate(message: JsonObject) -> JsonObject:
             stream_stdout_stderr=True,
             tty=True,
         )
-        wrote = await client.command.write(
+        wrote = await client.command.write_stdin(
             process_id="proc-1",
             delta_base64="aGVsbG8K",
             close_stdin=True,
@@ -2587,11 +2587,14 @@ def login_account(message: JsonObject) -> JsonObject:
             "timeout_ms",
             "tty",
         )
-        assert tuple(inspect.signature(client.command.write).parameters) == (
+        assert tuple(inspect.signature(client.command.write_stdin).parameters) == (
             "process_id",
             "close_stdin",
             "delta_base64",
         )
+        assert client.command.write_stdin.__doc__ is not None
+        assert "command/exec/write" in client.command.write_stdin.__doc__
+        assert "stdin" in client.command.write_stdin.__doc__
         assert tuple(inspect.signature(client.command.resize).parameters) == (
             "process_id",
             "size",