ASON - Aliased Serialization Object Notation

Introduction

ASON (Aliased Serialization Object Notation) is a serialization format designed to optimize token consumption in LLM (Large Language Model) contexts while maintaining human readability and guaranteeing complete round-trip fidelity.

Unlike traditional JSON, ASON uses intelligent compression techniques such as object references, value dictionaries, and path flattening to significantly reduce payload size without losing information.

Features

• • Intelligent Compression: Reduces up to 60% of tokens compared to JSON
• • Human Readable: Maintains a clear and easy-to-read structure
• • Perfect Round-Trip: Guaranteed decompression without data loss
• • Reference System: Detects and reuses repeated objects

Installation & Usage

npm install @ason-format/ason

import { SmartCompressor } from '@ason-format/ason';

const compressor = new SmartCompressor();
const data = { users: [{ id: 1, name: "Alice" }] };

const compressed = compressor.compress(data);
const original = compressor.decompress(compressed);

<script type="module">
  import { SmartCompressor } from 'https://unpkg.com/@ason-format/ason@1.1.2';

  const compressor = new SmartCompressor();
  const compressed = compressor.compress({ hello: "world" });
</script>

<script src="https://unpkg.com/@ason-format/ason@1.1.2/dist/index.browser.js"></script>
<script>
  const { SmartCompressor, TokenCounter } = window.ASON;
  const compressor = new SmartCompressor();
</script>

# Convert JSON to ASON
npx ason input.json -o output.ason

# Show token savings
npx ason data.json --stats
# ✓ Saved 36 tokens (61.02%)

Basic Example

{
  "users": [
    {
      "id": 1,
      "name": "Alice",
      "email": "alice@example.com",
      "age": 25,
      "active": true
    },
    {
      "id": 2,
      "name": "Bob",
      "email": "bob@example.com",
      "age": 30,
      "active": true
    },
    {
      "id": 3,
      "name": "Charlie",
      "email": "charlie@example.com",
      "age": 35,
      "active": false
    }
  ]
}

users:[3]@id,name,email,age,active
 1,Alice,alice@example.com,25,true
 2,Bob,bob@example.com,30,true
 3,Charlie,charlie@example.com,35,false

Compression Techniques

users:[3]@id,name,email
 1,Alice,alice@example.com
 2,Bob,bob@example.com
 3,Charlie,charlie@example.com

// Instead of:
config:
 database:
  host:localhost

// ASON uses:
config.database.host:localhost

// First occurrence: shows value + tag
billing.email:customer@example.com #0
billing.city:San Francisco #1

// Subsequent occurrences: tag only
shipping.email:#0
shipping.city:#1
contact.email:#0

&obj0:
 status:unavailable
$data:
 incremental_authorization:&obj0
 multicapture:&obj0

Real-World Use Cases

Comparison with Other Formats

When to Use ASON