Skip to content

Reference

Information-oriented technical descriptions — structured for lookup rather than reading end-to-end. Grouped by feature area; jump to the one you need.

Core concepts

  • URN composition — how Hadron URNs are built: type registry, hierarchy grammar, memory-role markers, alias categories, slug rules.
  • Mustache template syntax — variable resolution order, escaping, partials, and missing-variable behavior in node content.

Platform & operations

  • Authorization — roles, grants, guardrails — the action vocabulary, the default role bundles, individual grants, the guardrail (ceiling) layers, and the exact order they compose in. Enforced server-side.
  • User profile visibility — which profile fields one user sees of another (name, email, org role), and how user search is scoped to prevent enumeration. Enforced server-side.
  • Portal command bar & pages — the portal's ⌘K command bar (open by URN with lenient input, search, create) and its command pages: check access, merge node, and merge memory, with their inputs, outputs, and permissions.
  • PDF service HTTP API — the /convert endpoints of the internal hadrontool-pdf capability tool: Markdown↔PDF, auth, request/response shapes, errors, and limits.
  • GraphQL API — full type, query, and mutation reference, auto-generated from the server schema.
  • Data model — entity reference with ERD diagrams, auto-generated from the Prisma schema.

Memory

  • Node types — the five nodeType values (info, abstract, record, system, reference), their search behavior, and how to choose between neighbors.
  • RAG vector index — per-memory semantic retrieval: what gets embedded, when, how to search it (keyword / vector / hybrid + passages), staleness, and the encrypted-memory disclosure.
  • Structured storage and queries — opt-in structured storage: the Memory.schema shape, the NodeWhereInput (where) grammar, NodePropertySort (sortProperty), the objectType facet, and the surface matrix (what's on GraphQL vs. MCP vs. CLI).
  • Object store API — the record-oriented projection over structured storage: createObject / object / updateObject / deleteObject / findObjects (GraphQL + MCP), the flat { id, type, ...fields } record, reserved keys, and match/where/sort.

AI automation

  • Multi-node run flows — field-level reference for multi-node headless runs: routing-edge selection, the message.data scope, extractionSpec, tools, output, budgets and failure codes, and the run record shape.
  • Edge conditions — the condition grammar a headless run evaluates as it walks a flow.
  • Asset upload — the bi-directional asset-upload tool: what it does, what it stores, limits, lifecycle, encryption.

Chatbots

  • Conversation routing — how topics, conversations, stages, edges, and goals fit together.
  • Chat API — GraphQL surface for driving a Hadron-managed chat from a third-party integration.

AI coding

  • hadron CLI — command surface, global flags, stable exit codes, URN rules, write semantics, and the raw-GraphQL escape hatch.
  • MCP tools — the h-* tools Hadron exposes through MCP, categorized by purpose.
  • MCP App selection — hadron_list_apps and hadron_set_active_app: how multi-App OAuth callers pick an App per MCP session, and the typed-error vocabulary.