hive-emacs.tools.cider — io.github.hive-agi/hive-emacs 0.5.3

CIDER verb handlers for the code tool's :cider subtree — addon-owned.

Every verb generates elisp against the hive-mcp-cider bridge and evaluates it through hive-emacs.client. The subtree is contributed to the host's code composite tool at addon init (addon wins over the core shadow); hive-mcp core needs no cider knowledge.

spawn accepts the full CLI surface: extra_args, aliases, extra_deps, middleware — see hive-mcp-cider-nrepl-build-command.

*eval-fn* clj

Elisp evaluation boundary: (f code) or (f code timeout-ms) -> {:success bool :result any :error any}. Tests bind a stub recording calls.

commands clj

Command contribution map for the host's :extension/contribute-commands! runtime port.

contribute! clj

(contribute! runtime-ports)

Register the :cider subtree into the host's code composite tool and the EmacsCiderPort into the hive-spi cider registry. RUNTIME-PORTS is the host-injected port vocabulary (:extension/contribute-commands!) — nil outside a live host, making this a no-op. Idempotent.

ensure-connected clj

(ensure-connected project-dir)

ICiderPort auto-connect verb: the name of a connected session for PROJECT-DIR, spawning one when none is connected. Nil PROJECT-DIR falls back to the daemon's project root. Throws ex-info on failure.

handle-apropos clj

(handle-apropos {:keys [pattern search_docs session_name]})

Search symbols matching a pattern, optionally inside SESSION_NAME's REPL.

handle-cider-subdomain clj

Entry point contributed to code under "cider": strips the prefix and dispatches into the addon's verb tree.

handle-complete clj

(handle-complete {:keys [prefix session_name]})

Completions for a prefix, optionally inside SESSION_NAME's REPL.

handle-connect clj

(handle-connect {:keys [name host port repl_type agent_id project_dir]})

Connect to an existing nREPL server as a named session. project_dir labels the REPL buffer for cross-project sessions.

handle-doc clj

(handle-doc {:keys [symbol session_name]})

Docstring for a symbol, optionally inside SESSION_NAME's REPL.

handle-eval clj

(handle-eval {:keys [mode session_name] :as params})

Evaluate Clojure code via CIDER. mode selects silent (default) or explicit; session_name routes to a named session instead.

handle-info clj

(handle-info {:keys [symbol session_name]})

Full semantic info for a symbol, optionally inside SESSION_NAME's REPL.

handle-kill-all clj

(handle-kill-all _)

Kill all CIDER sessions.

handle-kill-session clj

(handle-kill-session {:keys [session_name]})

Kill a specific named session. Blank name errors; elisp errors surface.

handle-sessions clj

(handle-sessions _)

List all active CIDER sessions with their status and ports.

handle-spawn clj

(handle-spawn {:keys [name project_dir agent_id repl_type port extra_args
                      aliases extra_deps middleware]})

Spawn a new named CIDER session with its own nREPL server. Full CLI surface: extra_args (raw, pre--M), aliases (-M selection), extra_deps (EDN strings merged into -Sdeps), middleware (appended). local.deps.edn in the project dir is always auto-detected.

handle-status clj

(handle-status _)

Get CIDER connection status.

handlers clj

The addon-owned :cider verb tree for the code composite tool.

retract! clj

(retract! runtime-ports)

Retract the addon's code contributions and the cider port. No-op outside a live host.

schema-params clj

The addon-contributed code schema params for the whole :cider subtree — core's code tool advertises no cider keys of its own.