File size: 1,874 Bytes
ed6bec6 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 |
# 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.
|