Frame ISA

SAM Instruction Set Architecture - Zero-dependency 6-byte opcode definitions for AI systems.

Overview

Frame ISA defines a compact instruction format for AI output:

[ACT:2 bytes][SUBJ:2 bytes][MOD:2 bytes] = 6 bytes total (big-endian)

• ACT (Action): What operation to perform (GREET, RESPOND, CALCULATE, etc.)
• SUBJ (Subject): The topic or entity (TIME, USER, WEATHER, RAG reference, etc.)
• MOD (Modifier): Style flags (voice, tone, warmth, format, urgency, etc.)

Installation

[dependencies]
frame-isa = "0.1"

Usage

use frame_isa::{Action, Subject, Modifier, Instruction};

// Create an instruction
let instr = Instruction::new(
    Action::RESPOND,
    Subject::TIME,
    Modifier::default(),
);

// Serialize to bytes
let bytes = instr.to_bytes();
assert_eq!(bytes.len(), 6);

// Parse from bytes
let parsed = Instruction::parse_one(&bytes).unwrap();
assert_eq!(instr, parsed);

Using the Builder

use frame_isa::{Action, Subject, InstructionBuilder, Voice, Tone};

let instr = InstructionBuilder::new(Action::GREET)
    .subject(Subject::USER)
    .voice(Voice::Casual)
    .tone(Tone::Positive)
    .build();

Preset Modifiers

use frame_isa::Modifier;

// For crisis situations
let crisis = Modifier::crisis();  // Empathetic, warm, high urgency

// For professional contexts
let pro = Modifier::professional();  // Formal, neutral warmth

// For friendly interactions
let friendly = Modifier::friendly();  // Casual, warm, positive

Opcode Categories

Actions (ACT)

Subjects (SUBJ)

Modifier Bit Layout

Bit:  15  14  13  12  11  10   9   8   7   6   5   4   3   2   1   0
      [--VOICE--] [--TONE--] [-WARM-] [--FORMAT--] [ACCURACY] [URGENCY]

TRM Integration

This crate is designed for use with TinyRecursiveModels (TRMs) that output opcodes directly.

The factored prediction approach uses 3 heads:

• ACT head → Action code
• SUBJ head → Subject code
• MOD head → Modifier flags

This allows small models (~148K params) to achieve 99%+ accuracy on opcode prediction.

Related Crates

• frame-catalog: Vector store and RAG system

License

MIT