hive-vim.transport — io.github.hive-agi/hive-vim 0.1.2

HVCP v1 transport boundary: a loopback TCP server that Vim sessions connect to, with request/response correlation, handshake, events and a port file.

Effectful. Framing and decisions come from hive-vim.protocol.codec.

port clj

(port server)

The TCP port SERVER listens on.

read-frame clj

(read-frame reader)

Read the next frame from READER: one JSON value per line, as Vim's channel writes them. Returns ::eof at end of stream; an unparsable line comes back as {::unparsable line}, which the codec classifies as invalid.

request! clj

(request! server session-id op-fn timeout-ms)

Send the op built by (OP-FN id) to session SESSION-ID and wait for Vim's reply. Returns (ok raw-result) or a :vim/timeout, :vim/disconnected or :vim/no-session error.

running? clj

(running? server)

select-session clj

(select-session server selector)

The session SELECTOR names, or the most recently active one when SELECTOR is nil or blank. Returns a Result holding the session id.

send! clj

(send! server session-id op)

Send a fire-and-forget op (no id) to SESSION-ID. Returns a Result.

sessions clj

(sessions server)

Connected sessions, most recently active first.

start! clj

(start! {:keys [port port-file emit-fn hello-timeout-ms clock-fn]
         :or {port 0 hello-timeout-ms s/hello-timeout-ms}})

Listen on loopback and accept Vim sessions.

opts: :port (0 picks a free port), :port-file (written with the bound port), :emit-fn (fn [event payload]) for :vim/connected :vim/event :vim/disconnected, :hello-timeout-ms, :clock-fn.

stop! clj

(stop! server)

Stop accepting, disconnect every session and remove the port file.