MCP surface

HostProto object

hostproto_context_create (launch a Python program, stops on entry)

handles/v1 — host = adapter process, context = launch, surface = thread; lifecycle: creating until the first thread exists

hostproto_surface_observe

observation/v1 — revision moves on every stopped↔running transition of that thread; the cursor is host-assigned over normalized events, DAP seq is raw provenance. Projections: state, frames, scopes, variables, output, breakpoints, host_requests

hostproto_surface_act (input is the intent/v1 bundle)

receipt/v1 — set_breakpoints, step_over/in/out, continue, pause, evaluate, set_variable, host_request.resolve; a resume whose deadline elapses is outcome: unknown, executed: false

hostproto_surface_await

host-side wait: stopped, lifecycle, revision, event_kind, host_request

hostproto_context_recovery

recovery/v1 — unrecoverable / host_terminated once the debuggee is gone, with the raw DAP message log as content-addressed evidence (application/x-ndjson)

hostproto_capabilities

capability-profile/v1 for dap/v1 — availability from the adapter's initialize response, runtime only for what this process executed

hostproto://surface/{id}/state, hostproto://context/{id}/dap-messages

subscribable state; the evidence log