# YAML anchor resolver

- Human page: https://happytails.ai/en/data-tools/yaml-anchor-resolver/
- Markdown: https://happytails.ai/en/data-tools/yaml-anchor-resolver.md
- Structured JSON: https://happytails.ai/agents/en/data-tools/yaml-anchor-resolver/index.json
- Visibility: public

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `yaml-anchor-resolver` |
| Category | data-tools |
| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |
| Browser execution | Automatic updates after valid input or file selection. |
| Browser processing | Browser; see tool notes for network behavior. |
| HTTP API | Not callable through HTTP. |
| Browser-agent interface | run_current_tool |

### Implementation notes

Up to 100 YAML documents, 50,000 parsed nodes and 64 nesting levels. Diagnostic reports omit source text and key values. No application schema is checked. Expand anchors and aliases in YAML 1.2 core documents into repeated values. Cycles and unresolved aliases are rejected. Scalar mapping keys are supported. Unknown tags and YAML 1.1 documents block expansion. Merge-key entries remain explicit, with their alias values expanded. Formatting/comments may change; large integer values and plain float spelling are retained. Expanded scalar/comment text is limited to 2,000,000 characters and expanded nodes to 50,000. Runs on your device. No remote configuration, repository or credentials are queried. Up to 1,000,000 input characters; output files are limited to 4,000,000 characters each.

### Inputs and settings

Text input: Configuration text.

Example or placeholder shown in the interface (not a validated fixture):

```text
base: &base
  timeout: 30
  retries: 2
service: *base
```

Paste text to process locally. Review the supported syntax and the result before downloading. Results update as you type. Up to 1,000,000 characters.

No additional settings are declared for this tool.

### Browser-agent workflow

1. Open the human page in a browser that supports WebMCP.
2. Discover the interface exposed by that page; use its actual schema.
3. Select files on the page first when the tool requires files.
4. Call `run_current_tool` with valid input and settings.
5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.

Calls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.

### Planning specification

Up to 100 documents, 50,000 parsed nodes and 64 nesting levels. Diagnostic reports omit source text and key values. No application schema is checked. At most 50,000 expanded nodes and 2,000,000 characters of expanded scalar/comment text. Runs on your device with no configuration, repository or credential lookups. Up to 1,000,000 input characters and 4,000,000 characters per output file.

This describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.

### Complete machine-readable capability record

```json
{
  "id": "yaml-anchor-resolver",
  "category": "data-tools",
  "built": true,
  "requirements": "Up to 100 documents, 50,000 parsed nodes and 64 nesting levels. Diagnostic reports omit source text and key values. No application schema is checked. At most 50,000 expanded nodes and 2,000,000 characters of expanded scalar/comment text. Runs on your device with no configuration, repository or credential lookups. Up to 1,000,000 input characters and 4,000,000 characters per output file.",
  "implementation": {
    "fields": [],
    "live": true,
    "presentation": "metrics",
    "note": "Up to 100 YAML documents, 50,000 parsed nodes and 64 nesting levels. Diagnostic reports omit source text and key values. No application schema is checked. Expand anchors and aliases in YAML 1.2 core documents into repeated values. Cycles and unresolved aliases are rejected. Scalar mapping keys are supported. Unknown tags and YAML 1.1 documents block expansion. Merge-key entries remain explicit, with their alias values expanded. Formatting/comments may change; large integer values and plain float spelling are retained. Expanded scalar/comment text is limited to 2,000,000 characters and expanded nodes to 50,000. Runs on your device. No remote configuration, repository or credentials are queried. Up to 1,000,000 input characters; output files are limited to 4,000,000 characters each.",
    "experience": {
      "automatic": true,
      "single": false,
      "inputMaxLength": 1000000,
      "inputMode": "text",
      "label": "Configuration text",
      "placeholder": "base: &base\n  timeout: 30\n  retries: 2\nservice: *base\n",
      "help": "Paste text to process locally. Review the supported syntax and the result before downloading. Results update as you type. Up to 1,000,000 characters.",
      "action": null
    },
    "mode": "automatic",
    "interactive": false
  },
  "execution": "Browser interface",
  "api": null,
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}
```

## Page guide

Expand YAML anchors and aliases into repeated values. Detect recursive references and preserve exact number text while producing standalone YAML.

How can we improve this tool?

Report a problem or share an idea.

Please leave out private information. Your message and the tool name go to our team via PostHog.

### How to use YAML anchor resolver

1. Paste YAML 1.2 documents containing anchors and aliases.
2. Review any cycle, syntax or unsupported-feature diagnostics.
3. Download the expanded YAML files and report, then review the configuration.

## Useful next steps

- [YAML duplicate key checker](https://happytails.ai/en/data-tools/yaml-duplicate-key-checker/) ([Markdown](https://happytails.ai/en/data-tools/yaml-duplicate-key-checker.md))

- [YAML document splitter](https://happytails.ai/en/data-tools/yaml-document-splitter/) ([Markdown](https://happytails.ai/en/data-tools/yaml-document-splitter.md))

## Replace references with their values

Paste one or more YAML 1.2 core documents. Each alias is replaced with a copy of its referenced value, and anchor names are removed. Each document produces its own expanded YAML download.

### Reject references that cannot expand safely

An unresolved alias or recursive reference blocks all transformed downloads. Expansion is bounded to prevent an alias tree from growing without limit. Unknown tags, collection-valued mapping keys and YAML 1.1 documents are reported instead of receiving a misleading conversion.

### Review the rewritten configuration

Large integer values and plain floating-point spelling are retained. Formatting and comments may change. Explicit merge-key entries remain in place, with their alias values expanded; this is not a merge-key flattener or an application-schema validator.