# Glyphic Language — API Reference
This document describes the public API exposed by the Glyphic Language interpreter. These functions provide the official interface for encoding, decoding, validating, and explaining glyph sequences.

All functions are deterministic and dictionary‑driven.

# Module Import
python:

from glyphic_language.interpreter import interpret, encode, validate, explain


1. interpret(glyph_string)
Description:  
Parses a glyph sequence and returns a structured semantic representation.
Signature:
interpret(glyph_string: str) -> dict
Returns:  
A dictionary containing actor, action, object, modifiers, context layers, and raw input.
Raises:
    Syntax errors
    Validation errors


2. encode(structured_dict)
Description:  
Converts a structured meaning dictionary into a canonical glyph sequence.
Signature:
encode(structured: dict) -> str
Returns:  
A glyph string in strict canonical order.
Guarantees:
encode(interpret(x)) == x
for all valid sequences.
3. validate(glyph_string)

Description:  
Validates glyph existence, role correctness, and strict syntax ordering.

Signature:
python

validate(glyph_string: str) -> None

Raises:

    Unknown glyph errors

    Missing core role errors

    Ordering violations

    Context ordering violations

4. explain(glyph_string)

Description:  
Produces a human‑readable explanation of the meaning of a glyph sequence.

Signature:
python

explain(glyph_string: str) -> str

Returns:  
A textual summary of actors, actions, objects, modifiers, and context.
Interpreter Guarantees

    Deterministic parsing

    Reversible encoding

    Strict grammar enforcement

    Dictionary‑driven semantics

    Zero hallucination

    Stable integration with Soulfile™ systems

This API is the official gateway for all agents, controllers, and external tools interacting with the Glyphic Language.