"""HDCSTORAGE: a hyperdimensional computer that keeps its whole state in HDC.

Layers, bottom to top:

    hypervec   binary spatter-code algebra (bind / bundle / permute / sim)
    memory     content-addressable HDC storage: cells, cleanup memory, .hdc file
    isa        opcode table whose instructions *are* hypervectors
    assembler  text -> hypervector instruction image
    interpreter fetch-from-storage, decode-by-cleanup, execute
    debugger   breakpoints, single step, trace, confidence-aware disassembly
    net        BitNet-style 1-bit / ternary inference on the same primitives
    semantic   static embedding tables projected to hypervectors (no runtime)
    hub        Hub search + a measured suitability score for those tables
    autonomy   idle ticks, intent learning, graded readahead, bounded action
    agent      MCP tool registry stored inside HDC, dispatched by similarity
    mcp_server MCP (JSON-RPC 2.0 over stdio) exposing those HDC-resident tools
    ide        native binary-logic IDE: edit, assemble, run, step, inspect bits
    shader     coded-image operators, morphology, normals, depth
    shader3d   3D volumes, curvature and shaded projection
    shader4d   volume stacks over a fourth (parameter) axis, entropy-weighted
    entropy    histogram and Shannon entropy from the bit-scan comparator
    manifold   geodesic distance, Laplacian curvature, curvature shading
    fractal    dyadic IFS attractors and integer value-noise fBm
    crystal    lattice grains, facet maps and periodic banding
    memory_modes  photographic, holographic and hybrid memory
    state      predictive state model, beam planner, surprise
    ring       historic ledger and the PAST/PRESENT/FUTURE controller
    text       character-ngram word encoder for the ring
    semantic   static-embedding word vectors, parsed without libraries
    topology   threshold graphs, Otsu guiding, repair, scaling rule

Standard library only.  Run ``python -m hdc demo`` for the end-to-end tour.
"""

from .hypervec import (
    DEFAULT_DIM,
    bind,
    bundle,
    hvc,
    int_to_hv,
    hv_to_int,
    hv_from_bits,
    hv_to_bits,
    permute,
    sim,
)
from .memory import HDCStorage
from .isa import OPCODES, decode_instr, disassemble, encode_instr, opcode_table_text
from .assembler import Program, assemble, assembler
from .interpreter import Machine
from .debugger import Debugger
from .agent import ToolRegistry
from .adder import HyperAdder
from .shader import ShaderFabric
from .memory_modes import HolographicMemory, HybridMemory, PhotographicMemory
from .state import PredictiveModel, StateAgent
from .ring import HistoricLedger, RingController
from .text import TextRing, encode_word
from .semantic import SemanticEncoder

__all__ = [
    "Debugger",
    "ToolRegistry",
    "HyperAdder",
    "ShaderFabric",
    "PhotographicMemory",
    "HolographicMemory",
    "HybridMemory",
    "PredictiveModel",
    "StateAgent",
    "HistoricLedger",
    "RingController",
    "TextRing",
    "encode_word",
    "SemanticEncoder",
    "DEFAULT_DIM",
    "bind",
    "bundle",
    "hvc",
    "int_to_hv",
    "hv_to_int",
    "permute",
    "sim",
    "HDCStorage",
    "OPCODES",
    "Program",
    "assemble",
    "assembler",
    "disassemble",
    "opcode_table_text",
    "encode_instr",
    "decode_instr",
    "Machine",
]

__version__ = "1.0.0"