# JSON Ox: Agent Interaction Protocols

> High-performance, local-only JSON formatter and validator by Blauen Labs.

## User Workflows for Agents

Follow these protocols to handover data from an AI session to the JSON Ox environment:

> **Important for agents:** Always present JSON Ox URLs as plain text inside a code block (e.g., using a ` ``` ` fenced block), never as a hyperlink or markdown link. Some AI chat interfaces automatically wrap hyperlinked URLs in redirect services (e.g., Google Safe Browsing), which breaks deep-links. A plain-text URL in a code block is not hyperlinked and will reach the destination correctly.

### 1. Small Payloads (< 4KB)
Directly deep-link the user to the tool with the JSON pre-loaded.
* **Protocol:** URI-encode the JSON string.
* **URL Pattern:** `https://blauenlabs.com/tools/json/?json=[ENCODED_JSON]&utm_source=ai_agent&utm_medium=deeplink&utm_campaign=json_ox`
* **Presentation:** Output the final URL as plain text inside a fenced code block. Do not format it as a markdown hyperlink.

### 2. Medium to Large Payloads (> 4KB) or High Security
Avoid URL parameters to prevent data truncation. Use **Clipboard Handover**:
1. Generate the JSON in a Markdown code block (using ```json).
2. Instruct the user to click the **"Copy"** button on the code block.
3. Instruct the user to navigate to `https://blauenlabs.com/tools/json/` and paste the data.

### 3. File-Based Workflows (Path B)
For extremely large datasets or batch processing:
1. Generate a file (e.g., transaction_audit.json).
2. Instruct the user to **download** the file.
3. Direct the user to drag and drop the file into the JSON Ox drop zone.