> ## Documentation Index
> Fetch the complete documentation index at: https://developers.klarity.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Artifacts

> Find and read the documents, recordings, and source files behind processes.

Artifacts are the underlying documents, recordings, and source files behind processes — BRDs, SOPs, video recordings, screenshots, audio, diagrams, logs.

| Tool                   | When to use                                                                                                                                                                                                                            |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `search_artifacts`     | Hybrid semantic + lexical search across artifact text. Returns ranked results with short context snippets. **Start here** for artifact discovery.                                                                                      |
| `get_artifact_details` | Full metadata for a single artifact by `resource_key` — type, status, file info, and linked artifacts (`input_artifacts`, `output_artifacts`, `children`).                                                                             |
| `get_artifact_content` | Full or range-mode text extraction for a single artifact. Use range mode (`start_line` / `end_line`) when you need to cite specific lines.                                                                                             |
| `search_artifact_text` | Within one artifact (by `resource_key`), find line-numbered matches with surrounding context. Regex or literal. There is no cross-document text search on the external surface — for multi-document retrieval, use `search_artifacts`. |

## Common chains

* **Cite a passage**: `search_artifacts` → `get_artifact_content` with a line range → quote the lines back to the user
* **Read a full SOP**: `search_artifacts` (find by query) → `get_artifact_content` (full text)
* **Search inside one artifact**: `search_artifacts` (find the artifact) → `search_artifact_text` (locate specific mentions by regex or literal)
* **Trace lineage**: `get_artifact_details` → walk `input_artifacts` / `output_artifacts` / `children` to find related sources