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

> Legacy TypeScript SDK v0.6.0 docs for evaluator output fields, 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({
  googleApiKey: process.env.GOOGLE_API_KEY,
});

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

await evaluator.evaluate(text);
```

## Text Complexity evaluator family

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

* [Grade Level Appropriateness](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/grade-level-appropriateness.md)
* [Background Knowledge Demands](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/background-knowledge-demands.md)  v0.2.0
* [Vocabulary Complexity](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/vocabulary-complexity.md)
* [Sentence Structure](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/sentence-structure.md)
* [Meaning Directness](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/meaning-directness.md)  v0.3.0
* [Purpose Clarity](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/purpose-clarity.md)  v0.5.0

The output:

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

## For other evaluators

All Text Complexity 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/sdks-typescript-v0.6.0/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/sdks-typescript-v0.6.0/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](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/grade-level-appropriateness.md) | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/grade-level-appropriateness.md#output) | [`GradeLevelAppropriatenessInternal`](https://github.com/learning-commons-org/evaluators/blob/sdks-typescript-v0.6.0/sdks/typescript/src/schemas/grade-level-appropriateness.ts) ↗ |
| [Background Knowledge Demands](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/background-knowledge-demands.md)v0.2.0 | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/background-knowledge-demands.md#output) | [`SmkInternal`](https://github.com/learning-commons-org/evaluators/blob/sdks-typescript-v0.6.0/sdks/typescript/src/schemas/smk.ts) ↗ |
| [Vocabulary Complexity](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/vocabulary-complexity.md) | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/vocabulary-complexity.md#output) | [`VocabularyInternal`](https://github.com/learning-commons-org/evaluators/blob/sdks-typescript-v0.6.0/sdks/typescript/src/schemas/vocabulary.ts) ↗ |
| [Sentence Structure](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/sentence-structure.md) | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/sentence-structure.md#output) | [`SentenceStructureInternal`](https://github.com/learning-commons-org/evaluators/blob/sdks-typescript-v0.6.0/sdks/typescript/src/schemas/sentence-structure.ts) ↗ |
| [Meaning Directness](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/meaning-directness.md)v0.3.0 | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/meaning-directness.md#output) | [`ConventionalityInternal`](https://github.com/learning-commons-org/evaluators/blob/sdks-typescript-v0.6.0/sdks/typescript/src/schemas/conventionality.ts) ↗ |
| [Purpose Clarity](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/purpose-clarity.md)v0.5.0 | [Output fields](https://docs.learningcommons.org/evaluators/text-complexity-evaluators/purpose-clarity.md#output) | [`PurposeInternal`](https://github.com/learning-commons-org/evaluators/blob/sdks-typescript-v0.6.0/sdks/typescript/src/schemas/purpose.ts) ↗ |

## Related topics

> [card] [Quickstart](https://docs.learningcommons.org/evaluators/getting-started/quickstart.md#sdk)
>
> Install the SDK and run your first evaluator.

> [card] [Configuration](https://docs.learningcommons.org/evaluators/using-evaluators/typescript-sdk/past-versions/typescript-v0.6.0/configuration.md)
>
> Configure evaluators, including API keys and options.

> [card] [Error handling](https://docs.learningcommons.org/evaluators/using-evaluators/typescript-sdk/past-versions/typescript-v0.6.0/error-handling.md)
>
> Handle configuration, validation, and API errors.

> [card] [Batch evaluator](https://docs.learningcommons.org/evaluators/using-evaluators/typescript-sdk/past-versions/typescript-v0.6.0/batch-evaluator.md)
>
> Evaluate a batch of text from a CSV file using Text Complexity evaluators.