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

# Outputs

> Understand output fields returned by TypeScript SDK evaluators, including Text Complexity results from the full literacy evaluator family.

Once you've configured your evaluator, you can start evaluating text inputs for grade level appropriateness:

```typescript example.ts theme={null}
const evaluator = new GradeLevelAppropriatenessEvaluator(configOptions);

const text = "The cat's out of the bag now.";

await evaluator.evaluate(text);
```

## Student-Facing Text evaluator family

The Text Complexity evaluator runs multiple Student-Facing Text evaluators on the provided text input:

* [Grade Level Appropriateness](/evaluators/student-facing-text-evaluators/grade-level-appropriateness)
* [Background Knowledge Demands](/evaluators/student-facing-text-evaluators/background-knowledge-demands)  <Badge color="green">v0.2.0</Badge>
* [Vocabulary Complexity](/evaluators/student-facing-text-evaluators/vocabulary-complexity)
* [Sentence Structure](/evaluators/student-facing-text-evaluators/sentence-structure)
* [Meaning Directness](/evaluators/student-facing-text-evaluators/meaning-directness)  <Badge color="green">v0.3.0</Badge>
* [Purpose Clarity](/evaluators/student-facing-text-evaluators/purpose-clarity)  <Badge color="green">v0.5.0</Badge>

The output:

* Throws an error if all Student-Facing Text evaluators fail
* Otherwise outputs an error or result [for each Student-Facing Text evaluator](#for-other-evaluators)

## For other evaluators

All Student-Facing Text evaluators besides the parent Text Complexity evaluator have the following output fields.

| Field       | Type                                                                                                                           | Description                                                                                                                                                                               |
| :---------- | :----------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `score`     | [`TextComplexityLevel`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/outputs.ts) ↗ | Complexity classification returned by the evaluator. Purpose Clarity evaluator also accepts "More context needed" for cases where the text alone is insufficient to determine complexity. |
| `reasoning` | `string`                                                                                                                       | Explanation for the assigned complexity score                                                                                                                                             |
| `metadata`  | [`EvaluationMetadata`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/outputs.ts) ↗  | Includes model used to generate the evaluation, total evaluation processing time in milliseconds, input tokens, and output tokens.                                                        |
| `_internal` | Unique to each evaluator                                                                                                       | Detailed internal analysis data specific to each evaluator.                                                                                                                               |

The `_internal` field includes detailed internal analysis data specific to that evaluator:

| Evaluator                                                                                                                                                                        | `_internal` description                                                                         | `_internal` type                                                                                                                                                                                       |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Grade Level Appropriateness](/evaluators/student-facing-text-evaluators/grade-level-appropriateness)                                                                            | [Output fields](/evaluators/student-facing-text-evaluators/grade-level-appropriateness#output)  | [`GradeLevelAppropriatenessOutputSchema`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/student-facing-text/ela-reading/grade-level-appropriateness.ts) ↗   |
| [Background Knowledge Demands](/evaluators/student-facing-text-evaluators/background-knowledge-demands)<div style={{marginTop: '5px'}}><Badge color="green">v0.2.0</Badge></div> | [Output fields](/evaluators/student-facing-text-evaluators/background-knowledge-demands#output) | [`BackgroundKnowledgeDemandsOutputSchema`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/student-facing-text/ela-reading/background-knowledge-demands.ts) ↗ |
| [Vocabulary Complexity](/evaluators/student-facing-text-evaluators/vocabulary-complexity)                                                                                        | [Output fields](/evaluators/student-facing-text-evaluators/vocabulary-complexity#output)        | [`VocabularyComplexityOutputSchema`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/student-facing-text/ela-reading/vocabulary-complexity.ts) ↗              |
| [Sentence Structure](/evaluators/student-facing-text-evaluators/sentence-structure)                                                                                              | [Output fields](/evaluators/student-facing-text-evaluators/sentence-structure#output)           | [`SentenceStructureOutputSchema`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/student-facing-text/ela-reading/sentence-structure.ts) ↗                    |
| [Meaning Directness](/evaluators/student-facing-text-evaluators/meaning-directness)<div style={{marginTop: '5px'}}><Badge color="green">v0.3.0</Badge></div>                     | [Output fields](/evaluators/student-facing-text-evaluators/meaning-directness#output)           | [`MeaningDirectnessOutputSchema`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/student-facing-text/ela-reading/meaning-directness.ts) ↗                    |
| [Purpose Clarity](/evaluators/student-facing-text-evaluators/purpose-clarity)<div style={{marginTop: '5px'}}><Badge color="green">v0.5.0</Badge></div>                           | [Output fields](/evaluators/student-facing-text-evaluators/purpose-clarity#output)              | [`PurposeClarityOutputSchema`](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/schemas/student-facing-text/ela-reading/purpose-clarity.ts) ↗                          |

## Related topics

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/evaluators/getting-started/quickstart#sdk">
    Install the SDK and run your first evaluator.
  </Card>

  <Card title="Configuration" icon="gear" href="/evaluators/sdk-api-reference/typescript/configuration">
    Configure evaluators, including API keys and options.
  </Card>

  <Card title="Error handling" icon="triangle-exclamation" href="/evaluators/sdk-api-reference/typescript/error-handling">
    Handle configuration, validation, and API errors.
  </Card>

  <Card title="Batch evaluator" icon="layer-group" href="/evaluators/sdk-api-reference/typescript/batch-evaluator">
    Evaluate a batch of text from a CSV file using literacy evaluators.
  </Card>
</CardGroup>