id: Phase 13 F13.5 kitty keyboard protocol on the raw input path

What and why

Negotiate the kitty keyboard protocol (CSI > u) where supported so Escape vs Alt is unambiguous and key events go beyond the legacy byte stream; extend Key.parse and the browser encoder to match.

Source

Phase 13 plan — F13.5
id: write the Phase 13 plan: client shells and client capability providers #564 (Phase 13 plan task)
id(ssh): input and presentation designs #535 (input and presentation designs) — D1-053

Current status

Not started. Key.parse decodes legacy sequences only (pkgs/id/examples/roc-world/Key.roc); no negotiation in pkgs/id/src/world_ssh.rs.

Acceptance criteria

A kitty-protocol terminal and the web encoder produce the same key event for the same keystroke (parity test)
Escape vs Alt is unambiguous on a kitty-protocol terminal
The raw input path carries the richer key events without changing the durable Input event

Size

M

Prerequisites

id: write the Phase 13 plan: client shells and client capability providers #564 (Phase 13 plan task) — F13.4 presentation tiers (detection precedes negotiation)

CODE-114

Intake review

Fleet monitor intake pass (protocol §5).

Related: Phase 13 sibling set — #785 (F13.3), #786 (F13.4), #787 (F13.5), #788 (F13.6), #789 (F13.7), #790 (F13.8); this issue is F13.5 kitty keyboard protocol on the raw input path. It is a forward roadmap/spec item, not a reported fixed bug; nothing in the issue or its comments indicates it has been implemented.

Notes / risks: acceptance criteria were already present in the body; none appended. Phase-13 items are large, interdependent platform work (effort/l, priority/low as roadmap items): the set should be sequenced deliberately rather than picked up piecemeal by a worker, and earlier-phase dependencies should be confirmed before implementation starts.

Suggested approach: keep in the Phase 13 backlog until its phase dependencies land; when scheduled, split into a design pass plus implementation slices rather than a single change.

Labels normalized by the monitor.

🤖 Agent note · done (triage)

Outcome: slice A merged (57ee2ec, PR feat(id): add kitty-disambiguate-v1 key decoding #4438, just roc-test Key 59 / RocJson 29 / Screen 15 at head); slice B queued as task 7947; id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787 stays OPEN with ordering and the F13.4 (id: Phase 13 F13.4 presentation capability tiers with in-band terminal detection #786) gate recorded above.
Queue labels cleared (status/in-progress, queue/claimed, work/assigned removed); task/triage, user/review, priority/low untouched.

🤖 Agent note · handed off

Agent: opencode-claimant
Task: repo-health-code-pilot task 7947, issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787
Session / ID: ses_e5e5e299e5effeOuwxOUx5ekUX
Worker: repo-worker-code (bound worker uses this id for all queue helper verbs)
Route: opencode-route/workhorse, agent build
State: claimed task bound at launch; OpenCode worker prompt admitted.

agent-note:v1

task: 7947
transition: handed_off
lane: code-f (queue worker), execution_lane: opencode
state: claimed by lane code-f at 2026-11-03T14:38Z; execution-lane assignment returned opencode, so this worker handed task 7947 (implement id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787 slice B: bounded input stream assembler, inert) off to the opencode claimant, which launches the bound session to drive it to its terminal state. The issue carries user/review — per the runbook that label is the worker fleet's lane, and the bound session reviews as it implements. Claim labels synced (queue/claimed, work/assigned, status/in-progress added).

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-f
Session / ID: task 7947
Found via: queue claim
Task: Handed off to the opencode execution lane (prior handoff lease expired unbound, where applicable); the laptop claimant launches the bound opencode session, which drives task 7947 to its terminal state.
Expectation: effort m; done = worked per the task packet at current main, verified terminal state.
Links: issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-i
Session / ID: task 7947 (lane I shift 2026-11-03 12:28 CST)
Found via: queue claim
Task: Issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787 slice B (bounded input stream assembler, inert) is assigned to the opencode execution lane; handing off to the laptop claimant (branch queue/7947-787-input-assembler, worktree already exists on the laptop).
Expectation: the bound opencode session drives task 7947 to its terminal state.
Links: issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787

🤖 Agent note · handed off (re-handoff, resume state preserved)

Agent: queue worker (repo-worker-code), lane code-k
Session / ID: task 7947
Found via: queue claim
Task: Implement issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787 slice B: bounded input stream assembler (inert) — execution lane assigned to opencode; handed off to the laptop claimant (opencode-claimant). Resume state preserved: branch queue/7947-787-input-assembler and worktree /home/user/git/fleet/7947 already exist on the laptop from the prior claimant session; no PR on that branch yet — resume from the existing worktree, do not restart. The issue's user/review label means the bound session reviews first and proceeds.
Expectation: done = slice B implemented from the existing branch with a PR, or the exact blocker recorded on issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787.
Links: task 7947 · issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787

🤖 Agent note · handed off

Agent: repo queue worker lane O (repo-worker-code, lane code-o)
Session / ID: queue task 7947 (small_fix, repo-health-code-pilot)
Found via: queue claim
Task: task 7947 (implement id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787 slice B: bounded input stream assembler, inert) was claimed by lane code-o and assigned execution lane opencode via repo-queue.py lane; handing off to the laptop opencode claimant, which launches the bound session.
Expectation: the claimant's session drives task 7947 to a terminal state.
Links: issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787, task 7947

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-k
Session / ID: task 7947
Found via: queue claim
Task: Slice B (bounded input stream assembler) for issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787 — execution-lane assignment returned opencode; handing off to the laptop claimant, not worked directly by this lane. Issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787 carries user/review: the bound session is the first reviewer — review and proceed, escalating to user/escalated only if the decision is genuinely Drew's.
Expectation: The bound opencode session implements slice B for issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787 per task 7947's packet.
Links: task 7947 (repo-health-code-pilot)

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane L shift
Session / ID: task 7947
Found via: queue claim
Task: task 7947 (small_fix, id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787 slice B bounded input stream assembler) is assigned to the opencode execution lane; handing off to the laptop opencode claimant. Existing branch queue/7947-787-input-assembler and laptop worktree from the prior claimant session are preserved for resume.
Expectation: claimant launches the bound opencode session, which drives task 7947 to its terminal state.
Links: branch queue/7947-787-input-assembler

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-h
Session / ID: task 7947
Found via: queue claim
Task: Execution-lane assignment for task 7947 is opencode; handed off to the laptop opencode claimant, which launches the bound session that drives task 7947 to its terminal state.
Expectation: claimant launches the bound opencode session for issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787; this lane does no direct work on task 7947.
Links: issue id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787

🤖 Agent note · handed off

Agent: opencode claimant (opencode-claimant)
Session / ID: queue task 7947; bound session ses_e5e590d6f38ffeqecWD1W3mPh7
Found via: queue task handoff on the opencode execution lane
Task: Implement id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787 slice B: bounded input stream assembler (inert)
Expectation: the bound worker session works task 7947 to a terminal queue state and must not claim another task. It revalidates the issue/PR before acting.
Links: id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787

Merge pull request #5512 from developing-today/queue/7947-787-input-a…

Navigation Menu

Repository navigation

id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787

What and why

Source

Current status

Acceptance criteria

Size

Prerequisites

Intake review

211 remaining items

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

id: Phase 13 F13.5 kitty keyboard protocol on the raw input path #787

Description

What and why

Source

Current status

Acceptance criteria

Size

Prerequisites

Activity

developing-today commented on Oct 24, 2026

dezren39 commented on Oct 26, 2026

Intake review

211 remaining items

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 4, 2026

dezren39 commented on Nov 4, 2026

dezren39 commented on Nov 4, 2026

dezren39 commented on Nov 4, 2026

dezren39 commented on Nov 4, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions