63 lines
1.6 KiB
Markdown
63 lines
1.6 KiB
Markdown
|
# AEC - Aether Code
|
||
|
|
|
||
|
|
A cognitive shell language for orchestrating intelligent systems.
|
||
|
|
|
||
|
|
## Overview
|
||
|
|
|
||
|
|
AEC (Aether Code) is a domain-specific language designed to provide cognitive primitives for:
|
||
|
|
|
||
|
|
- **Memory operations**: `recall()`, `recall_store()`, `recall_stats()`
|
||
|
|
- **Knowledge graph**: `kg_absorb()`, `kg_query()`, `kg_recall()`, `kg_stats()`
|
||
|
|
- **Distributed hash table**: `dht_ping()`, `dht_put()`, `dht_get()`, `dht_stats()`
|
||
|
|
- **Self-knowledge**: Read and analyze own source code
|
||
|
|
- **File operations**: Read, write, list directories
|
||
|
|
- **HTTP operations**: GET and POST requests
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
- **Self-awareness**: AEC can read its own source code and understand its capabilities
|
||
|
|
- **Persistent memory**: Store and retrieve knowledge across sessions
|
||
|
|
- **Cognitive primitives**: Built-in functions for AI orchestration
|
||
|
|
- **Functional programming**: First-class functions, closures, higher-order functions
|
||
|
|
- **Pattern matching**: Match expressions for control flow
|
||
|
|
- **Module system**: Import and use external code
|
||
|
|
|
||
|
|
## Building
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cargo build --release
|
||
|
|
```
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Run a script
|
||
|
|
./target/release/aec script.aec
|
||
|
|
|
||
|
|
# Interactive REPL
|
||
|
|
./target/release/aec
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example
|
||
|
|
|
||
|
|
```aec
|
||
|
|
// Read own source code
|
||
|
|
let source = read_file("src/main.rs");
|
||
|
|
print("AEC is " + str(len(source)) + " characters");
|
||
|
|
|
||
|
|
// Store knowledge
|
||
|
|
recall_store("aec:size", str(len(source)), true);
|
||
|
|
|
||
|
|
// Retrieve knowledge
|
||
|
|
let size = recall("aec:size");
|
||
|
|
print("Stored size: " + size);
|
||
|
|
```
|
||
|
|
|
||
|
|
## Architecture
|
||
|
|
|
||
|
|
AEC spawns external services (aether-recall, DHT, knowledge graph) as child processes and communicates via JSON-RPC over stdin/stdout.
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
See LICENSE file for details.
|