AI OS Layer 1.00 — čo obsahuje prvá verejná verzia

Vydal som prvú verejnú verziu **AI OS Layer 1.00**.

Je to bash-based AI runtime vrstva pre terminál. Projekt začal ako malý toolkit, ale postupne vyrástol do systému s vlastným runtime kontraktom, test runnerom, watcherom, agent vrstvou a event-based execution logom.

Táto verzia nie je iba jednoduchý wrapper okolo API. Obsahuje kompletný základ pre terminálový AI workflow.

 Hlavné entrypointy

AI OS Layer 1.00 obsahuje štyri hlavné príkazy:
 

ai
ag
aw
at

ai

Hlavný runtime a jadro celého systému.

ai rieši:

• načítanie configu
• model profily
• prompt profily
• volanie lokálneho alebo vzdialeného model endpointu
• runtime tool calls
• viacero tool roundov
• výstup do súboru
• execution logovanie
• runtime board/views
• capability dispatch

Základné použitie:

ai "vysvetli tento projekt"
ai -p code "navrhni opravu"
ai -m gpt-oss:20b "analyzuj log"
ai -o report.md "sprav report"

ag

Agent runner nad ai.

ag je orchestration vrstva. Vie spúšťať úlohy v režimoch:

• single
• multi
• repair
• inspect

Príklady:

ag -m single "zisti verziu projektu"
ag -m multi -ms 6 "analyzuj projekt"
ag -m repair "najdi problém v build flow"
ag -m inspect "vysvetli štruktúru projektu"

Dôležitý princíp: nástroje vykonáva ai, nie wrapper okolo neho.

aw

Watcher automation.

aw sleduje udalosti a spúšťa akcie podľa pravidiel. Podporuje:

• one-shot watcher beh
• daemon režim
• status/stop daemonu
• sledovanie súborov
• sledovanie adresárov
• shell eventy
• command watch
• action dispatch
• watcher event logovanie

Príkazy:

aw once rules.aw
aw run rules.aw
aw test rules.aw
aw start rules.aw
aw status
aw stop
aw shell_event --exit 1 --cmd "cat missing.log"

Typy pravidiel:

watch
watch_cmd
watch_shell

at

Test, trace, replay, judge a benchmark vrstva.

at je validačná konzola projektu. Podporuje:

• spúšťanie .at testov
• test suites
• fail-fast režim
• trace execution behov
• replay execution behov
• judge nad runmi
• štatistiky runov
• benchmark replay

Príklady:

at core
at runtime
at ai
at ag
at aw
at workflow
at stable
at live
at all

at -t
at -r
at -j
at -s
at -b logs/runs

Runtime kontrakt

Verzia 1.00 stabilizuje nový execution runtime kontrakt.

Každý run má vlastný adresár:

logs/runs//
events.jsonl
state.json
payload/
work/

Význam:

• events.jsonl je hlavný zdroj pravdy
• state.json je odvodený reducer snapshot
• payload/ obsahuje väčšie výstupy a artefakty
• work/ obsahuje pracovný stav daného runu

Toto je jadro systému: výstup na obrazovke nie je jediná pravda. Pravda je event log.

Event-sourced execution

AI OS Layer 1.00 zapisuje runtime udalosti ako event stream.

Obsahuje event family pre:

• runtime start/finish/abort
• API round start/finish
• tool call requested/normalized
• tool execution start/finish
• tool errors
• workflow plan/run/node udalosti
• watcher session/action udalosti

Vďaka tomu sa dá run spätne čítať, auditovať, replayovať a zobrazovať cez board alebo timeline.

Runtime tools

Model môže používať runtime tools.

V 1.00 sú zahrnuté:

append_file
cat
find
grep
ls
pwd
tree
write_file
run_shell

Každý tool má vlastný shell skript aj .tool.json metadata súbor.

run_shell je unsafe tool a je chránený samostatným guardom. Nie je to náhodne otvorený shell escape.

Model profily

Projekt obsahuje konfigurovateľné model profily.

V balíku sú pripravené profily napríklad pre:

gpt-oss:20b
llama3.1:8b
deepseek-r1:14b
deepseek-coder-v2:16b
qwen3-coder:30b
gpt-5-mini
gpt-5.4
whisper
tts
sora
embeddings

Tieto profily sú lokálne upraviteľné. Každý si môže endpointy a modely nastaviť podľa svojho prostredia.

Prompt profily

Súčasťou release sú prompt profily:

default
shell
code
creative
debug

A runtime profily napríklad:

agent
code
creative
debug
gptmini
gptoss
llama
shell

Použitie:

ai -p shell "oprav tento command"
ai -p code "reviewni skript"
ai -p creative "napíš text"

Capability graph

ai obsahuje capability systém a vie zobraziť graf schopností:

ai graph

Súčasťou runtime sú capability vrstvy pre veci ako:

• LLM
• STT
• TTS
• mic workflow
• audio workflow

Mic/audio workflow

Verzia 1.00 obsahuje aj mic capability.

Príklady:

ai --capability mic
ai --capability mic --loop
ai --capability mic --no-play

Testované sú aj provider vetvy pre Linux a Termux nahrávanie.

Board a runtime views

ai vie zobraziť runtime board:

ai board
ai board --perf
ai board --timeline
ai board --full
ai board --watch

Tieto pohľady sú postavené nad execution dátami, nie nad náhodným stdout textom.

RAG/context režim

ai podporuje RAG/context režim:

ai -rag "analyzuj projekt"
ai -c 48 "sprav report"

Súčasťou sú helpery pre:

• project context
• system info
• context size limit
• context density/metriky

Persistence modes

Runtime podporuje persistence módy:

ai --persist auto
ai --persist debug
ai --persist normal
ai --persist min

To umožňuje riadiť, koľko runtime dát sa zapisuje pri bežnom použití, debugovaní alebo testovaní.

Workflow runtime

Release obsahuje workflow vrstvu:

• workflow metadata
• workflow planner
• workflow runner
• workflow scheduler
• workflow state
• workflow reducer testy

Workflow udalosti sú zaradené do rovnakého execution event modelu.

Test suites

V 1.00 sú definované test skupiny:

core
runtime
ai
ag
aw
workflow
perf
stable
live
runtime_core
watch
agent
integration
all

stable je určený pre lokálne deterministické testy.
live pokrýva testy závislé od model endpointu.
all spúšťa celý balík.

Release bol overený na:

Linux
Termux

Všetky testy prešli v oboch prostrediach.

Trace, replay, judge

at vie pracovať s execution runmi spätne:

at -t
at -r
at -j

To znamená, že runtime sa dá nielen spustiť, ale aj spätne analyzovať.

Benchmark

at obsahuje benchmark režim:

at -b logs/runs -n 3
at -b logs/runs -m "model1 model2" -e endpoint
at -b logs/runs -p "profile1 profile2"

Benchmark beží nad uloženými execution dátami.

Netinstall

Projekt sa inštaluje cez netinstall:

sh -c "$(curl -fsSL https://pihi.sk/projects/ai_layer/netinstall.sh)"

Installer:

• stiahne aktuálnu verziu
• stiahne ai.zip
• rozbalí projekt do ~/ai_layer
• pripraví ~/.config/ai_layer
• vytvorí príkazy ai, ag, aw, at
• podporuje Linux aj Termux path layout

Zhrnutie

AI OS Layer 1.00 obsahuje:

• bash-based terminálový AI runtime
• štyri entrypointy: ai, ag, aw, at
• model profily
• prompt profily
• runtime tools
• event-sourced execution log
• reducer snapshot
• board/timeline/perf/watch views
• watcher automation
• daemon watcher režim
• agent runner
• test runner
• trace/replay/judge
• benchmark režim
• workflow runtime
• mic/audio capability
• RAG/context režim
• netinstall
• Linux a Termux validáciu

Toto je prvý verejný checkpoint projektu.

AI OS Layer 1.00 je vonku.