Skip to content

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

Open
ulziibay-kernel wants to merge 2 commits intomainfrom
ulzii/smooth-typing-docs
Open

docs: add smooth typing with typo injection to computer controls#321
ulziibay-kernel wants to merge 2 commits intomainfrom
ulzii/smooth-typing-docs

Conversation

@ulziibay-kernel
Copy link
Copy Markdown
Contributor

@ulziibay-kernel ulziibay-kernel commented Apr 6, 2026

Summary

  • Updates the Type text section in computer controls docs with new smooth and typo_chance parameters
  • Adds parameter table, code examples in TypeScript, Python, and CLI for all four modes (instant, fixed delay, smooth, smooth+typos)
  • Includes demo GIF and MP4 showing the visual difference between instant and human-like typing

Depends on: kernel/kernel-images#201 (implementation PR)

Test plan

  • Verify docs render correctly on preview
  • Confirm GIF loads and plays in the Frame component

Made with Cursor


Note

Low Risk
Low risk doc-only update; main risk is inaccurate parameter/CLI flag naming or missing referenced media asset (/images/smooth-typing-demo.gif).

Overview
Updates the Type text docs in browsers/computer-controls.mdx to describe new human-like typing options, adding smooth and typo_chance parameters alongside a clarified delay behavior.

Adds expanded TypeScript, Python, and CLI examples for instant typing, fixed-delay typing, smooth typing, and smooth typing with typo injection, plus a new “Smooth vs instant typing” demo section referencing /images/smooth-typing-demo.gif.

Reviewed by Cursor Bugbot for commit 9a66a40. Bugbot is set up for automated code reviews on this repo. Configure here.

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
@mintlify
Copy link
Copy Markdown
Contributor

mintlify bot commented Apr 6, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Kernel 🟢 Ready View Preview Apr 6, 2026, 2:57 PM

cursor[bot]
cursor bot approved these changes Apr 6, 2026
Copy link
Copy Markdown
Contributor

@masnwilliams masnwilliams left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good — clean docs-only change, well-structured examples across all three language blocks, parameter table is consistent with the existing moveMouse/dragMouse sections.

Two minor comments below. Neither is blocking.

| `smooth` | boolean | `false` | Use human-like variable keystroke timing with word-boundary pauses |
| `typo_chance` | number | `0` | Probability (0.0–0.10) of a typo per character, corrected with backspace. Requires `smooth: true`. Typical human range is 0.02–0.05 |

<CodeGroup>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

optional/minor: typo_chance is silently ignored when passed without smooth: true (no error, just no effect). Might be worth a brief parenthetical in the description — e.g. "Requires smooth: true (silently ignored otherwise)" — so users don't pass it standalone and wonder why nothing happens.

@masnwilliams
Copy link
Copy Markdown
Contributor

nit: images/smooth-typing-demo.mp4 is added but not referenced anywhere in the docs — only the .gif is embedded. There's no existing precedent for committing source video files in this repo (no other .mp4 files alongside the other demo GIFs). Suggest removing it to avoid accumulating unreferenced binary assets. If the intent is to keep the source for future re-encoding, a shared drive or the PR description would be a better home.

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

Made-with: Cursor
@ulziibay-kernel
Copy link
Copy Markdown
Contributor Author

@masnwilliams Addressed both:

  1. Added "(silently ignored otherwise)" to the typo_chance description so users know it has no effect without smooth: true
  2. Removed smooth-typing-demo.mp4 — only the GIF is referenced, no need to keep the source video in the repo

See 9a66a40.

Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Risk Assessment: Very Low

I assessed risk from the actual diff and file changes only.

  • Files changed are browsers/computer-controls.mdx and images/smooth-typing-demo.gif.
  • The diff adds documentation content: parameter table updates and usage examples for typing options (smooth, typo_chance) plus an illustrative GIF embed.
  • No application/runtime logic, infrastructure config, auth/permission paths, or shared production codepaths were modified.
  • .git-blame-ignore-revs is not present, so there are no ignore-revs adjustments to this assessment.

Given the narrow docs/media scope and no production behavior changes, this PR is Very Low risk.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants