Dify TOON Converter Plugin

Author: EFT
Repo: dify-plugin-toon
Version: 1.0.0
Type: tool

Description

This Dify plugin converts data between JSON and TOON (Token-Oriented
Object Notation), a compact, human-readable serialization format designed for
LLM prompts. By removing redundant quotes, braces and repeated keys, TOON
typically reduces token usage by 30-60% compared to JSON, which lowers
cost and leaves more context window for actual content.

Conversion is powered by toon-format,
the official Python implementation of the TOON specification. It passes
every official conformance fixture and guarantees lossless round-trips
() for every JSON-compatible value, including
nested structures and tabular arrays with nested field groups.

TOON specification: https://github.com/toon-format/spec
Related plugin request: langgenius/dify-plugins#1619

Requirements

Dify 1.14.2 or later

No network connection or external service is required: conversion runs
locally in the plugin runtime, with no endpoint to configure and no
credentials to provide.

Installation

From Dify Marketplace: search "TOON" in the Plugins page and install.
Or install from a local : Plugins -> Install Plugin -> Via Local File.

Tools

JSON to TOON

Convert a JSON string into TOON format.

Outputs:

text: the plain TOON text, ready for the LLM to read directly.
json: a structured object with the TOON text and compression
statistics, referenceable from downstream nodes:

Field	Description
	The converted TOON string
	Character count of the input JSON
	Character count of the TOON output
	Saved fraction, e.g. means 60% smaller
	Same value as percentage, e.g.

Example input:

Example text output:

Example json output:

Uniform arrays of objects are encoded in tabular form: field names are
declared once in the header and each element becomes one compact row.

TOON to JSON

Convert a TOON string into formatted JSON (, 2-space indent).
The delimiter is auto-detected from tabular headers, as the TOON
specification requires. Round-tripping JSON -> TOON -> JSON preserves the
data.

Parameter	Type	Required	Description
			The TOON string to convert

Outputs:

text: the pretty-printed JSON string.
json: the parsed object, referenceable from downstream nodes.

Error Handling

Both tools validate their input and return friendly English error messages
instead of raising raw exceptions:

Empty input:
Invalid JSON:
Invalid TOON:
Unsupported value during encoding:

Privacy

All conversion happens in-memory inside the plugin runtime. No data is
collected, logged, stored or transmitted anywhere. See
PRIVACY.md for details.

Development

Package with the Dify Plugin CLI:

License

MIT