@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