# Theo · Code Generation

> A dedicated code generation pipeline with language detection, syntax highlighting metadata, and structured artifact output. Routed to the reasoning engine (theo-core / theo-1-reason), not the conversational engine.

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

## At a glance
- Branded engine: theo-1-code (a routing alias for theo-1-reason).
- Output is a structured code artifact with language tag, filename hint, and a copy-ready string.
- Multi-file responses are supported: a single prompt can produce several code artifacts in one turn.
- Skills can extend with tools (write_file, run_tests, apply_diff) so an AI Worker can edit a repository, not just produce snippets.

## How a request is routed
The routing engine detects code-shaped prompts by signal: file-extension patterns (.tsx, .ts, .py, .go, .rs), code keywords ("function", "class", "refactor", "stack trace"), or explicit mode pinning. Detected prompts dispatch to the code pipeline rather than the conversational pipeline.

## API
- Endpoint: POST /api/v1/completions with mode "code", or rely on the routing engine to promote.
- Body fields: prompt (required), language (optional pin), format (optional, defaults to text/openai-compatible).
- Response: streaming SSE with token events for the prose and one or more code artifact events with the structured payload, or non-streaming JSON with an artifacts[] array.

## Code review and agentic edits
When a skill declares a write_file tool (or a connector exposes a repository write), the orchestrator runs the agentic loop: it can read files, propose diffs, run tests, and iterate. The orchestrator audits every tool call.

## 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.