ghola
A starter kit for agentic systems on iii: a spec goes in, a pull request comes out, nothing merges itself. The stage-graph factory, the constraint ladder and the append-only audit log, wired as registry workers, with the operator profile and skills to run them.
Install0.1.0
# With the iii engine running
iii trigger directory::download-kit kit=tacoda/ghola@0.1.00Installs
0Last 7 days
0Today
30 days
Repotacoda/ghola
Exact versions are immutable. Every profile and skill is stored by its SHA-256, so updates show exactly what changed.
Installing the kit adds each worker to your compose graph at the newest version its range allows. Ranges are resolved again on every install and update.
- WorkerWeb console for iii — bundles the React UI and proxies the engine WebSocket on a single port.Range^1.10.0Resolves tov1.10.12Functions usedNone preloaded
- WorkerPolicy and decision surface for human-held function calls — pre_call gate, pending inbox, per-session permission settings, and two notification event functions.Range^1.1.0Resolves tov1.1.5Functions usedNone preloaded
- WorkerAppend-only, hash-chained record of every human decision. Tamper-evident on its own. Tamper-proof once the chain head is anchored outside.Range^0.1.0Resolves tov0.1.1Functions used3
- audit::
read - audit::
summary - audit::
verify
- audit::
- WorkerClaude Code as an iii worker — claude::* runs headless turns and claude::terminal::* runs the same CLI in a shell::pty session on its own console page. Both publish raw messages on the claude::on-raw-event function and AgentEvent frames on claude::on-agent-event.Range^0.3.0Resolves tov0.3.6Functions usedNone preloaded
- WorkerOpenAI Codex as an iii worker; codex::run/start/stop/status/sessions::list spawn the codex CLI for headless turns, deliver raw thread events on codex::on-raw-event and AgentEvent frames on codex::on-agent-event, observed per session.Range^0.2.0Resolves tov0.2.3Functions usedNone preloaded
- WorkerTurns a raw conversation history plus a target model into a model-ready context — token counting, function-result pruning, and history compaction.Range^1.2.0Resolves tov1.2.6Functions usedNone preloaded
- WorkerRun functions on cron schedules — hosts `cron::on-tick`; each observer of it passes `{ expression }` as args and receives that expression's ticks.Range^0.22.0Resolves tov0.22.2Functions usedNone preloaded
- WorkerConvert Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV and PDF documents to markdown on this machine, detect the format from the bytes, pull out the images embedded in them, and transcribe a scan by rendering its pages and reading them with a vision model.Range^0.2.0Resolves tov0.2.3Functions usedNone preloaded
- WorkerSession monitor for the Harness (deterministic diagnostics, Jev triage through judge, investigation by the user-chosen LLM, E2E validation plans; inactive until configured).Range^0.3.0Resolves tov0.3.7Functions usedNone preloaded
- WorkerLodash-style value transforms (fp::get/pick/take/…) and fp::pipe — worker-side pipelines that move big values function→function without routing them through the model.Range^0.3.0Resolves tov0.3.2Functions usedNone preloaded
- WorkerGitHub CLI and event-driven PR monitoring — typed queries and mutations, authenticated temporary webhooks, CI/comment/review notifications, and cleanup on merge.Range^0.5.0Resolves tov0.5.4Functions usedNone preloaded
- WorkerThin durable turn loop that wires session-manager, context-manager, and llm-router into an agent loop; spawns sub-agents as child sessions.Range^1.9.0Resolves tov1.9.14Functions used2
- harness::
send - harness::
status
- harness::
- WorkerExpose functions as HTTP endpoints — hosts `http::on-request`; each observer of it declares a route, and its target answers the matched requests.Range^0.23.0Resolves tov0.23.5Functions usedNone preloaded
- WorkerUnix shell + filesystem worker — exec with denylist/timeout/output caps and background jobs; fs::ls|stat|mkdir|rm|chmod|mv|grep|sed|read|write with host jail, denylist, size caps, and sandbox-target forwardingRange>=0.13.0Resolves tov0.13.7Functions used2
- shell::
exec - shell::
status
- shell::
- WorkerEngine introspection, workers registry proxy, filesystem-backed skills, system prompts, and agent profiles, kit install and update with reviewed plans, plus function search ranked by the judge worker (falling back to local hybrid/lexical) with a conditional pre-generate hint.Range>=1.3.0Resolves tov1.3.8Functions usedNone preloaded
- WorkerConstraints and capabilities on one ladder, as an iii worker. A constraint is what an agent may not do; each one names the rung that carries it, and the ladder refuses a call in the rule's own words from the harness's pre-call hook. Needs iii 0.26.0 or newer, because it speaks observers.Range^0.1.0Resolves tov0.1.1Functions used2
- ladder::
evaluate - ladder::
list
- ladder::
- WorkerOne front door + provider protocol in front of every LLM provider.Range^1.5.0Resolves tov1.5.5Functions usedNone preloaded
- WorkerDurable cross-session agent memory — named banks of always-injected markdown rules and auto-extracted memories, hybrid BM25 + entity recall, pinning, and supersede-never-delete history. Plain files on disk; every operation is a traced function.Range^0.3.0Resolves tov0.3.9Functions usedNone preloaded
- WorkerOpenGantry governance for iii. Kernel verify and middleware gate before promote-class calls.Range^0.2.0Resolves tov0.2.2Functions usedNone preloaded
- WorkerRead PDFs locally — classify text-based vs scanned, convert to markdown, extract positioned text and tables, and report which pages still need OCR.Range^0.2.0Resolves tov0.2.4Functions usedNone preloaded
- WorkerAnthropic Messages API provider worker; implements provider::anthropic::stream and provider::anthropic::refresh_models behind llm-router.Range^1.3.0Resolves tov1.3.5Functions usedNone preloaded
- WorkerOpenAI Responses provider worker with Chat Completions compatibility; implements provider::openai::stream and provider::openai::refresh_models behind llm-router.Range^1.3.0Resolves tov1.3.4Functions usedNone preloaded
- WorkerOpenAI Codex (ChatGPT subscription) provider; implements provider::openai-codex::stream and provider::openai-codex::refresh_models behind llm-router, with ChatGPT device-code sign-in and automatic session renewal backed by the encrypted secrets vault.Range^0.5.0Resolves tov0.5.5Functions usedNone preloaded
- WorkerDurable function queues - hosts `queue::on-message`, which topic subscribers observe, and the queue/DLQ service functions.Range^0.22.0Resolves tov0.22.5Functions usedNone preloaded
- WorkerDurable, reactive, branching store of typed conversation entries with six observable session event functions.Range^1.1.0Resolves tov1.1.3Functions usedNone preloaded
- WorkerDistributed key-value state management — registers the `state::*` functions and `state::on-changed`, a private function observers watch for every committed change.Range>=0.23.0Resolves tov0.23.3Functions usedNone preloaded
- WorkerObject storage across AWS S3, GCS, Cloudflare R2, and a native local filesystem backend. Streamed uploads, signed URLs, and observable object change events.Range^0.2.0Resolves tov0.2.5Functions usedNone preloaded
- WorkerGit worktree lifecycle for parallel agents — mint, claim, and track isolated worktrees per repo, call observable lifecycle functions (worktree::on-*), and land branches back through a per-repo FIFO queue (rebase, test gate, ff-only merge).Range^0.4.0Resolves tov0.4.6Functions usedNone preloaded