docs: add smooth typing with typo injection to computer controls (#321)

* docs: add smooth typing with typo injection to computer controls

Adds documentation for the new smooth and typo_chance parameters
on the type_text endpoint, with code examples in TS, Python, and CLI.
Includes demo GIF and MP4 showing instant vs smooth vs smooth+typos.

Made-with: Cursor

* Address review: clarify typo_chance behavior, remove unreferenced MP4

- Note that typo_chance is silently ignored without smooth: true
- Remove smooth-typing-demo.mp4 since only the GIF is embedded

Made-with: Cursor

* docs: default smooth typing to true (align kernel-images#201)

- Type text section: smooth defaults true like moveMouse/dragMouse; clarify
  delay and typo_chance only apply when smooth is on/off respectively.
- Reorder TS/Python/CLI examples: smooth + typos first; instant/fixed delay
  use smooth false.

Made-with: Cursor

* docs: keep typo_chance semantics in Type text table only

OpenAPI carries bounds; docs explain 0–0.10 and ~10% per character.

Made-with: Cursor

Author: ulziibay-kernel

browsers/computer-controls.mdx

@@ -217,7 +217,14 @@ kernel browsers computer screenshot <session id> --to region.png --x 0 --y 0 --w
 
 ## Type text
 
-Type literal text, optionally with a delay in milliseconds between keystrokes.
+Type literal text on the host. By default, typing uses human-like variable timing: word-sized chunks, natural pauses at word and sentence boundaries, and optional realistic typos corrected with backspace. Set `smooth: false` for xdotool typing with a fixed per-keystroke delay (`delay`, in ms) or instant input when `delay` is `0`.
+
+| Parameter     | Type    | Default | Description |
+| ------------- | ------- | ------- | ----------- |
+| `text`        | string  | —       | Text to type |
+| `delay`       | integer | `0`     | Fixed delay in milliseconds between keystrokes. Only used when `smooth` is `false`; ignored when `smooth` is `true` |
+| `smooth`      | boolean | `true`  | Human-like variable keystroke timing with word-boundary pauses (default, same idea as `moveMouse` / `dragMouse`) |
+| `typo_chance` | number  | `0`     | Per-character typo rate from 0–0.10 (capped; 0.10 ≈ 10% per character on average), corrected with backspace. Only applies when `smooth` is `true` (silently ignored when `smooth` is `false`). Typical values are 0.02–0.05 |
 
 <CodeGroup>
 ```typescript Typescript/Javascript
@@ -226,12 +233,27 @@ import Kernel from '@onkernel/sdk';
 const kernel = new Kernel();
 const kernelBrowser = await kernel.browsers.create();
 
+// Human-like smooth typing (default — omit smooth or pass true)
+await kernel.browsers.computer.typeText(kernelBrowser.session_id, {
+  text: 'The quick brown fox jumps over the lazy dog.',
+});
+
+// Human-like with occasional typos (3% chance per character)
+await kernel.browsers.computer.typeText(kernelBrowser.session_id, {
+  text: 'The quick brown fox jumps over the lazy dog.',
+  typo_chance: 0.03,
+});
+
+// Instant typing (all at once, no per-key delay)
 await kernel.browsers.computer.typeText(kernelBrowser.session_id, {
   text: 'Hello, World!',
+  smooth: false,
 });
 
+// Fixed delay between keystrokes (smooth off)
 await kernel.browsers.computer.typeText(kernelBrowser.session_id, {
   text: 'Slow typing...',
+  smooth: false,
   delay: 100,
 });
 ```
@@ -242,27 +264,56 @@ from kernel import Kernel
 kernel = Kernel()
 kernel_browser = kernel.browsers.create()
 
+# Human-like smooth typing (default — omit smooth or pass True)
+kernel.browsers.computer.type_text(
+    id=kernel_browser.session_id,
+    text="The quick brown fox jumps over the lazy dog.",
+)
+
+# Human-like with occasional typos (3% chance per character)
+kernel.browsers.computer.type_text(
+    id=kernel_browser.session_id,
+    text="The quick brown fox jumps over the lazy dog.",
+    typo_chance=0.03,
+)
+
+# Instant typing (all at once, no per-key delay)
 kernel.browsers.computer.type_text(
     id=kernel_browser.session_id,
     text="Hello, World!",
+    smooth=False,
 )
 
+# Fixed delay between keystrokes (smooth off)
 kernel.browsers.computer.type_text(
     id=kernel_browser.session_id,
     text="Slow typing...",
+    smooth=False,
     delay=100,
 )
 ```
 
 ```bash CLI
-# Type text in the browser
-kernel browsers computer type <session id> --text "Hello, World!"
+# Human-like smooth typing (default)
+kernel browsers computer type <session id> --text "The quick brown fox"
+
+# Human-like with occasional typos
+kernel browsers computer type <session id> --text "The quick brown fox" --typo-chance 0.03
+
+# Instant typing (all at once)
+kernel browsers computer type <session id> --text "Hello, World!" --smooth=false
 
-# Type text with a 100ms delay between keystrokes
-kernel browsers computer type <session id> --text "Slow typing..." --delay 100
+# Fixed delay between keystrokes (smooth off)
+kernel browsers computer type <session id> --text "Slow typing..." --smooth=false --delay 100
 ```
 </CodeGroup>
 
+### Smooth vs instant typing
+
+<Frame caption="Instant typing (all at once) vs smooth human-like typing with variable delays and typo correction">
+  <img src="/images/smooth-typing-demo.gif" />
+</Frame>
+
 ## Press keys
 
 Press one or more key symbols (including combinations like "Ctrl+t" or "Ctrl+Shift+Tab"). Optionally hold modifiers and/or set a duration to hold keys down.