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

The Vim vessel: a neutral descriptor (the hive-emacs.vessel shape), an IVessel reification of it, and the hive-vessel target that executes :vim-channel ops over this addon's transport.

No dependency on hive-vessel: a target is a plain map, so the contract is the shape. hive-vessel lowers an action to ["call" fn args] and calls :vessel/execute!; the payload travels over the same session-managed, reconnecting channel HVCP verbs use.

An op batch is not a transaction: dispatch! stops at the first op whose execution throws and reports how many already ran.

->ivessel clj

(->ivessel descriptor)

An IVessel over DESCRIPTOR.

capabilities clj

create-vim-vessel clj

(create-vim-vessel port-fn)

(create-vim-vessel port-fn terminal-fn)

Descriptor for the Vim vessel. PORT-FN returns the :vim editor port or nil; TERMINAL-FN, when given, returns the VimTerminal or nil.

dialect clj

The hive-vessel dialect this vessel speaks.

execute! clj

(execute! server opts {:native/keys [payload] :as op})

Run a lowered hive-vessel op on SERVER. Returns the value Vim answered.

Throws ex-info on failure. hive-vessel's dispatch! reports that as {:error {:failure/reason :execute-threw}} carrying how many ops of the batch already ran: a loud dispatch failure, never a silent drop. Translator fallback is a separate mechanism and applies to TRANSLATION failures only, so a Vim that is down does not silently re-route to another lowering.

vessel-target clj

(vessel-target server)

(vessel-target server {:keys [features] :as opts})

A hive-vessel target backed by SERVER: {:vessel/id :vim :vessel/dialect :vim-channel :vessel/execute! f}. OPTS may pin a :session or :timeout-ms, and :features advertises addon-specific capabilities to translator guards.