Welcome to LAFS

GitBook: https://codluv.gitbook.io/lafs-protocol/

LAFS is a schema-first response envelope contract for tools, APIs, and agents. It gives LLM agents one stable response shape across transports.

What you get:

• One envelope parser path for REST, MCP, and A2A boundaries

• Deterministic error structure with registered code checks

• JSON-default format semantics with explicit conflict handling

• Conformance checks beyond raw schema validation

Start here (LLM-agent focused)

1. Quick Start Guide

2. LLM Agent Guide

3. Schema Extension Guide

4. Compliance Pipeline Guide

What the TypeScript package exports today

Import from @cleocode/lafs-protocol:

• validateEnvelope(input)

• assertEnvelope(input)

• createEnvelope(input)

• parseLafsResponse(input, options?)

• LafsError

• runEnvelopeConformance(envelope)

• runFlagConformance(flags)

• resolveOutputFormat(flags)

• isRegisteredErrorCode(code)

• wrapMCPResult(mcpResult, operation, budget?)

• createAdapterErrorEnvelope(message, operation, category?)

Import from @cleocode/lafs-protocol/a2a for A2A integration helpers.

Canonical envelope shape

{
  "$schema": "https://lafs.dev/schemas/v1/envelope.schema.json",
  "_meta": {
    "specVersion": "1.0.0",
    "schemaVersion": "1.0.0",
    "timestamp": "2026-02-24T00:00:00Z",
    "operation": "users.list",
    "requestId": "req_123",
    "transport": "http",
    "strict": true,
    "mvi": "standard",
    "contextVersion": 1
  },
  "success": true,
  "result": { "users": [] }
}

Notes:

• error is optional for success: true.

• error is required and result must be null when success: false.

• page is optional.

Envelope-first APIs you should use

• createEnvelope for constructing canonical envelopes

• parseLafsResponse + LafsError for unified consumption

• validateEnvelope + runEnvelopeConformance for hardening

Integration options

• MCP Integration

• A2A Integration

• REST Integration

Normative and machine-readable references

• Specification

• Envelope Schema

• Error Registry

• LLM index