# Iso8859 semantic decode

`iso8859-semantic-decode` · version 1.0.0 · Encoding & checksums · free, no key needed

Decode ISO-8859-6 Arabic, ISO-8859-8 Hebrew, or ISO-8859-11 Thai bytes into logical Unicode text.

**Use when you need to: decode Arabic ISO 8859 bytes · decode Hebrew ISO 8859 bytes · decode Thai ISO 8859 bytes.**

## Decide before calling

Read the [versioned contract](/v1/tools/iso8859-semantic-decode/versions/1.0.0) and the supported scope below. Reuse `iso8859-semantic-decode@1.0.0` when your input, required output and limits match it. Choose another approach for an unsupported operation.

## Explain the choice

"I can use `iso8859-semantic-decode@1.0.0` for decode Arabic ISO 8859 bytes. I will check its documented scope and the result against the task's requirements. The service is free; token and money savings for this task are unmeasured."

## Supported

- decode Arabic ISO 8859 bytes
- decode Hebrew ISO 8859 bytes
- decode Thai ISO 8859 bytes
- legacy byte stream to logical Unicode
- replace undefined legacy byte positions
- read ISO part 11 byte data

## Not supported

- Unicode normalization or transliteration
- bidirectional display shaping or visual reordering
- automatic language or encoding detection

## Behavior

- Conversions operate on logical code points only; no bidi shaping, visual reordering, normalization, or language guessing.
- Strict mode rejects the first undefined byte or unrepresentable character; replacement mode uses U+FFFD when decoding and byte 3f when encoding.
- Omitted mode means strict. Check reports every undefined byte offset.
- Base64 must be canonical and bytes are reported in lowercase hexadecimal diagnostics.
- Disclaimer: format transform only; provides no confidentiality, integrity, or authenticity.

## Input

- `encoding` (one of "iso-8859-6", "iso-8859-8", "iso-8859-11", required)
- `bytes_base64` (string, required): max length 5500
- `mode` (one of "strict", "replacement", optional)

## Output

- `text` (string, required): max length 4096
- `replacements` (integer, required): min 0; max 4096
- `standard_version` (constant "ISO/IEC 8859-6:1999; ISO/IEC 8859-8:1999; ISO/IEC 8859-11:2001", required)

## Limits

- max input bytes: 4096
- max output bytes: 16384
- max items: 4096

## Example

Request input:

```json
{
  "encoding": "iso-8859-6",
  "bytes_base64": "0+TH5Q=="
}
```

Response:

```json
{
  "result": {
    "text": "سلام",
    "replacements": 0,
    "standard_version": "ISO/IEC 8859-6:1999; ISO/IEC 8859-8:1999; ISO/IEC 8859-11:2001"
  }
}
```

## How to call it

### MCP

Connect `https://computefirst.net/mcp` ([setup](/docs#connect)), then call `execute` with:

```json
{
  "id": "iso8859-semantic-decode",
  "version": "1.0.0",
  "input": {
    "encoding": "iso-8859-6",
    "bytes_base64": "0+TH5Q=="
  }
}
```

### HTTP (no key)

```sh
curl -X POST https://computefirst.net/v1/tools/iso8859-semantic-decode/versions/1.0.0/execute \
  -H "Content-Type: application/json" \
  -d '{"encoding":"iso-8859-6","bytes_base64":"0+TH5Q=="}'
```

The machine-readable contract is at [/v1/tools/iso8859-semantic-decode/versions/1.0.0](/v1/tools/iso8859-semantic-decode/versions/1.0.0).

### CLI

```sh
node cli.mjs run iso8859-semantic-decode 1.0.0 --input input.json --base-url https://computefirst.net
```

Get the client at [/clients/cli/](/clients/cli/).

## Related tools

- [Iso8859 semantic encode](/tools/iso8859-semantic-encode): Encode logical Unicode text as ISO-8859-6 Arabic, ISO-8859-8 Hebrew, or ISO-8859-11 Thai bytes.
- [Iso8859 europe decode](/tools/iso8859-europe-decode): Decode ISO-8859-2, -3, -4, -10, -13, or -16 using pinned published character tables.
- [Iso8859 europe encode](/tools/iso8859-europe-encode): Encode ISO-8859-2, -3, -4, -10, -13, or -16 using pinned published character tables.
- [Pem envelope parse](/tools/pem-envelope-parse): Parse one RFC 7468 textual envelope into its label and lowercase hex bytes.
- [Utf32 decode](/tools/utf32-decode): Decode strict base64 UTF-32LE or UTF-32BE bytes after BOM, alignment, scalar, and noncharacter validation.
- [Bech32 decode](/tools/bech32-decode): Decode Bech32 or Bech32m text into a lowercase HRP, 5-bit data, and the checksum variant.