# Theo · AI Workers

> An AI Worker is an installable, configurable, multi-channel agent assembled from skills, knowledge, hooks, and workflows. Theo's central organizing concept: not a chatbot, not a prompt template, but a named worker with a job description, memory, and tools.

Source of truth: https://hitheo.ai/workers. Last updated: 2026-05-24.

## At a glance
- Composition: persona (prompt extension) + skills (reusable bundles) + knowledge (org-scoped files) + workflows (multi-step orchestration) + hooks (event triggers) + tool registry (permission-gated).
- Multi-channel: every AI Worker is reachable via REST, dashboard playground, voice, embeddable iframes, and channel adapters (chat platforms, Model Context Protocol).
- Memory continuity: every channel writes into the same MCIR memory graph for the same account. The AI Worker remembers across channels.
- Audit grade: every turn, tool call, memory write, and guardrail verdict is logged with hash-anchored provenance.

## Lifecycle
1. Build on the canvas. See https://hitheo.ai/llms/studio.txt.
2. Install on an API key. The key inherits the skill set unless bound to a strict allowlist. See https://hitheo.ai/llms/skills.txt.
3. Wire a channel. REST + dashboard playground are always live. Iframes go on a host site. Voice gets a token endpoint. Channel adapters mount the SDK on a chat platform.
4. Observe. The Memory Console shows what the worker remembers. The Routing dashboard shows what it routed where. The Guardrails dashboard shows what fired.
5. Iterate. Skills and workflows are versioned; every change is reversible.

## Workflows (the orchestration layer for autonomous jobs)
- 6 step types: tool_call, ai_transform, condition, delay, notification, webhook.
- N-ary branching. Condition steps route to branch targets by label (case-insensitive fallback).
- Guard rails: max 10 steps, 30-min total runtime, credit checkpoint before each step, daily-cap enforcement.
- State: workflowRuns table records status (running / completed / failed / paused), steps completed, error.
- Dispatches workflow.completed / workflow.failed webhooks on completion.

## Hooks (autonomous triggers on domain events)
Hooks fire skills when something happens. Five built-in event patterns: share.accepted.welcome, task.overdue.summary, project.created.suggestions, team.member_joined.onboarding, document.analyzed.followup. Custom patterns are also supported, with per-hook cooldowns and daily caps.

## Tool registry
Built-in tools (memory, code, research, browser, documents) + skill-declared tools + connector-declared tools. Permission gating: user (always available), org_member (org context required), org_admin (admin role required), system (never user-invokable). Every call audited.

## Related machine-readable files
- https://hitheo.ai/llms.txt — full index of every Theo machine-readable file.
- https://hitheo.ai/llms-full.txt — long-form knowledge bundle (single fetch).
- https://hitheo.ai/humans.txt — team and open-source credits.
- https://hitheo.ai/lawyers.txt — trademark notice and legal contact.
- https://hitheo.ai/.well-known/security.txt — security disclosure contact.