@holoscript/uaal

uAAL — Universal Autonomous Agent Language Virtual Machine.
Stack-based bytecode execution engine for the uAA2++ 7-Phase Protocol.

Quick Start

import { UAALVirtualMachine, UAALCompiler, UAALOpCode } from '@holoscript/uaal';

const vm = new UAALVirtualMachine();
const compiler = new UAALCompiler();

// Build a full 7-phase cognitive cycle
const bytecode = compiler.buildFullCycle('Analyze the market data');
const result = await vm.execute(bytecode);
// result.taskStatus === 'HALTED'

Custom Handlers

The registerHandler() API is the extension point. Your private services inject logic without modifying the VM core:

vm.registerHandler(UAALOpCode.OP_INVOKE_LLM, async (proxy, operands) => {
  const result = await myLLMService.call(operands[0] as string);
  proxy.push(result);
});

7-Phase Protocol

Phase	OpCode	Purpose
0. INTAKE	`0x10`	Gather data and context
1. REFLECT	`0x11`	Analyze and understand
2. EXECUTE	`0x14`	Take action
3. COMPRESS	`0x12`	Store knowledge efficiently
4. REINTAKE	`0x15`	Re-evaluate with compressed knowledge
5. GROW	`0x16`	Learn patterns, wisdom, gotchas
6. EVOLVE	`0x17`	Adapt and optimize

Scripts

npm run test    # Run tests
npm run build   # Build to dist/
npm run dev     # Watch mode