Skip to content

Runtime Surface — How the proxy magic works

.me exposes three surfaces. You write code on the Callable Proxy 99% of the time. The other two are for introspection and meta-control.

Callable Proxy / DSL — The Main Experience

This is the real day-to-day interface of .me.

When you do const me = new ME(), you do not just get a normal class instance. You get a callable proxy that lets you interact with semantic paths directly:

ts
import ME from "this.me";

const me = new ME();

me.profile.name("Ana"); // write
me("profile.name"); // read
me.wallet["_"]("secret"); // secret operator
me.items[1].price(10); // indexed access
me.items["[i]"]["="]("taxed", "price * 1.16"); // derived logic

How it works:

  • Property access me.profile.name → builds a semantic path
  • Function call me(...) → executes at that path: read, write, or derive
  • Bracket notation me[...] → used for operators ["_"], selectors [0], and quantifiers ["[i]"]

Reflective Runtime Plane — me["!"]

This is the meta surface — an escape hatch that gives you direct access to the underlying kernel:

ts
me["!"].inspect()
me["!"].explain("wallet.balance")
me["!"].snapshot.export()
me["!"].snapshot.hydrate(snapshot)
me["!"].runtime.setRecomputeMode("lazy")

It allows advanced introspection and control over the runtime itself. Use it for debugging, tooling, and benchmarks. Not for app logic.

Practical Mental Model

Think of .me as having three layers:

SurfacePurposeHow you use it
Class APIInspection, snapshots, debuggingme.inspect(), me.explain()
Callable ProxyMain semantic languageme.profile.name(), me("path")
Reflective Plane me["!"]Meta-control and deep introspectionme["!"].snapshot.export()

Class API

These are the explicit methods and properties documented in the generated API:

  • constructor()
  • memories
  • execute()
  • inspect()
  • explain()
  • exportSnapshot()
  • hydrate()
  • importSnapshot()
  • rehydrate()
  • learn()
  • replayMemories()
  • setRecomputeMode()
  • getRecomputeMode()

You can explore them in:

Important Note

The generated API docs only cover the explicit class surface. The proxy DSL and me["!"] runtime plane are guide-level behaviors built on top of that class API, so they are documented here instead of inside TypeDoc.