gleamunison - v3.27.0

gleamunison/mcp_session

MCP session layer: selected-branch CAS plus explicit source overlays. The pure session owns values; the supervised web session owns mutations.

Types

SearchHit

</> 
pub type SearchHit =
  mcp_search.SearchHit

SessionState

opaque </> 
pub opaque type SessionState

Values

boot

</> 
pub fn boot() -> SessionState

Fresh scratch-only session: bootstrap definitions, no ambient store.

boot_configured

</> 
pub fn boot_configured() -> Result(SessionState, String)

Server startup reads the configured branch and the node’s one active store.

callers_of

</> 
pub fn callers_of(
  state: SessionState,
  name: String,
) -> Result(List(String), String)

Callers of a name: every visible definition with a dependency edge to it.

define_source

</> 
pub fn define_source(
  state: SessionState,
  name: String,
  source: String,
) -> Result(#(String, SessionState), String)

Bind one definition by name, so a later eval sees it.

defined_names

</> 
pub fn defined_names(state: SessionState) -> List(String)

Every visible name in the durable view plus its explicit scratch overlay.

definitions_json

</> 
pub fn definitions_json(state: SessionState) -> String

defs_by_kind

</> 
pub fn defs_by_kind(
  state: SessionState,
  kind: String,
) -> Result(List(String), String)

Definitions filtered by kind (term, type, ability, type-alias).

deps_of

</> 
pub fn deps_of(
  state: SessionState,
  name: String,
) -> Result(List(String), String)

Dependencies of a definition: in-corpus names its body references.

eval_source

</> 
pub fn eval_source(
  state: SessionState,
  source: String,
) -> Result(#(String, SessionState), String)

Evaluate source against the session and return the last value plus the advanced state. This is the live-session contract the REPL and the HTTP routes share: a define binds a name for later evaluation, anything else is an expression. The HTTP surface used to call a stateless evaluator with no baseline, so /eval?expr=(+ 1 2) answered “undefined variable +” and /define stored the source text in a notebook without binding anything — the route said “defined” and nothing was.

from_parts

</> 
pub fn from_parts(
  cache: types.TypeCache,
  defs: List(#(String, elab_types.SurfaceDef)),
) -> SessionState

Explicit scratch view for the REPL and isolated tests.

from_store

</> 
pub fn from_store(
  adapter: storage.StorageAdapter,
  branch: String,
) -> Result(SessionState, String)

handle_rpc

</> 
pub fn handle_rpc(
  state: SessionState,
  body: String,
) -> mcp.Response

Route one JSON-RPC body through the protocol layer with the session’s real tools attached.

load_file

</> 
pub fn load_file(
  state: SessionState,
  path: String,
) -> Result(SessionState, String)

Extend a session by loading a lisp source file through the same pipeline verify uses: defines are defined, other forms evaluated.

overlay_scratch

</> 
pub fn overlay_scratch(
  fresh: SessionState,
  previous: SessionState,
) -> SessionState

Rebuild a durable snapshot, then reapply only the previous scratch overlay. A successful write must not turn the session into a second scratch owner or silently discard unrelated exploratory definitions.

</> 
pub fn search(
  state: SessionState,
  query: String,
) -> List(mcp_search.SearchHit)
✨ Search Document