@cleocode/lafs 1.8.0

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@cleocode/lafs",
+  "version": "1.8.0",
+  "private": false,
+  "type": "module",
+  "description": "LLM-Agent-First Specification schemas and conformance tooling",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    },
+    "./discovery": {
+      "import": "./dist/src/discovery.js",
+      "types": "./dist/src/discovery.d.ts"
+    },
+    "./a2a": {
+      "import": "./dist/src/a2a/index.js",
+      "types": "./dist/src/a2a/index.d.ts"
+    },
+    "./a2a/bindings": {
+      "import": "./dist/src/a2a/bindings/index.js",
+      "types": "./dist/src/a2a/bindings/index.d.ts"
+    },
+    "./schemas/v1/envelope.schema.json": "./schemas/v1/envelope.schema.json",
+    "./schemas/v1/error-registry.json": "./schemas/v1/error-registry.json",
+    "./schemas/v1/context-ledger.schema.json": "./schemas/v1/context-ledger.schema.json",
+    "./schemas/v1/discovery.schema.json": "./schemas/v1/discovery.schema.json",
+    "./schemas/v1/conformance-profiles.json": "./schemas/v1/conformance-profiles.json"
+  },
+  "files": [
+    "dist",
+    "schemas",
+    "lafs.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kryptobaseddev/cleo",
+    "directory": "packages/lafs"
+  },
+  "homepage": "https://codluv.gitbook.io/lafs/",
+  "bugs": {
+    "url": "https://github.com/kryptobaseddev/cleo/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "lafs-conformance": "dist/src/cli.js"
+  },
+  "scripts": {
+    "version": "node scripts/sync-version.mjs",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "conformance": "tsx src/cli.ts"
+  },
+  "keywords": [
+    "lafs",
+    "llm",
+    "agent",
+    "protocol",
+    "schema",
+    "conformance"
+  ],
+  "author": "CLEO Code <hello@cleo.co> (https://cleo.co)",
+  "license": "MIT",
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@types/express": "^5.0.6",
+    "@types/node": "^24.3.0",
+    "@types/supertest": "^6.0.3",
+    "supertest": "^7.2.2",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "vitest": "^2.1.9"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "^0.3.10",
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
+    "express": "^5.2.1"
+  }
+}

package/schemas/v1/agent-card.schema.json

@@ -0,0 +1,230 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://lafs.dev/schemas/v1/agent-card.schema.json",
+  "title": "A2A Agent Card v1.0",
+  "description": "A2A-compliant Agent Card schema for agent discovery. Reference: specs/external/specification.md",
+  "type": "object",
+  "required": [
+    "name",
+    "description",
+    "version",
+    "url",
+    "capabilities",
+    "defaultInputModes",
+    "defaultOutputModes",
+    "skills"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "format": "uri",
+      "description": "JSON Schema URL"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "Human-readable agent name"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2048,
+      "description": "Detailed description of agent capabilities"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Agent version (SemVer)"
+    },
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "description": "Base URL for A2A endpoints"
+    },
+    "provider": {
+      "type": "object",
+      "required": ["organization", "url"],
+      "properties": {
+        "organization": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Organization name"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Organization URL"
+        }
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "required": [],
+      "properties": {
+        "streaming": {
+          "type": "boolean",
+          "description": "Supports streaming responses"
+        },
+        "pushNotifications": {
+          "type": "boolean",
+          "description": "Supports push notifications"
+        },
+        "extendedAgentCard": {
+          "type": "boolean",
+          "description": "Supports extended agent card"
+        },
+        "extensions": {
+          "type": "array",
+          "description": "Supported extensions",
+          "items": {
+            "type": "object",
+            "required": ["uri", "description", "required"],
+            "properties": {
+              "uri": {
+                "type": "string",
+                "format": "uri",
+                "description": "Extension URI (unique identifier)"
+              },
+              "description": {
+                "type": "string",
+                "description": "Human-readable description"
+              },
+              "required": {
+                "type": "boolean",
+                "description": "Whether the extension is required"
+              },
+              "params": {
+                "type": "object",
+                "description": "Extension-specific parameters"
+              }
+            }
+          }
+        }
+      }
+    },
+    "defaultInputModes": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Supported input content types",
+      "items": {
+        "type": "string",
+        "description": "MIME type"
+      }
+    },
+    "defaultOutputModes": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Supported output content types",
+      "items": {
+        "type": "string",
+        "description": "MIME type"
+      }
+    },
+    "skills": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Agent skills/capabilities",
+      "items": {
+        "type": "object",
+        "required": ["id", "name", "description", "tags"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Skill unique identifier"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Human-readable name"
+          },
+          "description": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Detailed description"
+          },
+          "tags": {
+            "type": "array",
+            "minItems": 1,
+            "description": "Keywords/tags",
+            "items": {
+              "type": "string"
+            }
+          },
+          "examples": {
+            "type": "array",
+            "description": "Example prompts",
+            "items": {
+              "type": "string"
+            }
+          },
+          "inputModes": {
+            "type": "array",
+            "description": "Supported input modes (overrides agent defaults)",
+            "items": {
+              "type": "string"
+            }
+          },
+          "outputModes": {
+            "type": "array",
+            "description": "Supported output modes (overrides agent defaults)",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "securitySchemes": {
+      "type": "object",
+      "description": "Security authentication schemes (OpenAPI 3.0 style)",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["type"],
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": ["http", "apiKey", "oauth2", "openIdConnect"],
+            "description": "Security scheme type"
+          },
+          "description": {
+            "type": "string",
+            "description": "Description"
+          },
+          "scheme": {
+            "type": "string",
+            "description": "HTTP scheme (e.g., bearer)"
+          },
+          "bearerFormat": {
+            "type": "string",
+            "description": "Bearer token format (e.g., JWT)"
+          }
+        }
+      }
+    },
+    "security": {
+      "type": "array",
+      "description": "Required security schemes",
+      "items": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "documentationUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "Documentation URL"
+    },
+    "iconUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "Icon URL"
+    }
+  }
+}

package/schemas/v1/conformance-profiles.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "version": "1.0.0",
+  "tiers": {
+    "core": [
+      "envelope_schema_valid",
+      "envelope_invariants",
+      "error_code_registered"
+    ],
+    "standard": [
+      "envelope_schema_valid",
+      "envelope_invariants",
+      "error_code_registered",
+      "agent_action_valid",
+      "error_registry_agent_action",
+      "transport_mapping_consistent",
+      "meta_mvi_present",
+      "meta_strict_present",
+      "strict_mode_behavior",
+      "pagination_mode_consistent",
+      "strict_mode_enforced"
+    ],
+    "complete": [
+      "envelope_schema_valid",
+      "envelope_invariants",
+      "error_code_registered",
+      "agent_action_valid",
+      "error_registry_agent_action",
+      "transport_mapping_consistent",
+      "context_mutation_failure",
+      "context_preservation_valid",
+      "meta_mvi_present",
+      "meta_strict_present",
+      "strict_mode_behavior",
+      "pagination_mode_consistent",
+      "strict_mode_enforced"
+    ]
+  }
+}

package/schemas/v1/context-ledger.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://lafs.dev/schemas/v1/context-ledger.schema.json",
+  "title": "LAFS Context Ledger",
+  "description": "Tracks state across request/response cycles for context preservation",
+  "type": "object",
+  "required": ["ledgerId", "version", "createdAt", "updatedAt", "entries", "checksum", "maxEntries"],
+  "properties": {
+    "ledgerId": {
+      "type": "string",
+      "description": "Unique identifier for this context ledger instance"
+    },
+    "version": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Monotonically increasing version number matching _meta.contextVersion"
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when the ledger was created"
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of the last ledger update"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["entryId", "timestamp", "operation", "contextDelta"],
+        "properties": {
+          "entryId": {
+            "type": "string",
+            "description": "Unique identifier for this ledger entry"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "operation": {
+            "type": "string",
+            "description": "The operation that generated this entry"
+          },
+          "contextDelta": {
+            "type": "object",
+            "description": "The context changes introduced by this operation",
+            "additionalProperties": true
+          },
+          "requestId": {
+            "type": "string",
+            "description": "Correlation with the request that produced this entry"
+          }
+        }
+      },
+      "description": "Ordered array of context entries (append-only)"
+    },
+    "checksum": {
+      "type": "string",
+      "description": "Integrity checksum of the ledger contents"
+    },
+    "maxEntries": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Maximum number of entries before truncation/compaction"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/v1/discovery.schema.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://lafs.dev/schemas/v1/discovery.schema.json",
+  "title": "LAFS Discovery Document",
+  "description": "Schema for LAFS agent discovery documents served at /.well-known/lafs.json",
+  "type": "object",
+  "required": [
+    "$schema",
+    "lafs_version",
+    "service",
+    "capabilities",
+    "endpoints"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL of the schema this document conforms to"
+    },
+    "lafs_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "LAFS protocol version (semantic versioning)"
+    },
+    "service": {
+      "type": "object",
+      "description": "Service identification and metadata",
+      "required": [
+        "name",
+        "version"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "description": "Unique service name (kebab-case recommended)"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^\\d+\\.\\d+\\.\\d+$",
+          "description": "Service version (semantic versioning)"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 500,
+          "description": "Human-readable service description"
+        }
+      },
+      "additionalProperties": false
+    },
+    "capabilities": {
+      "type": "array",
+      "description": "List of LAFS capabilities this service provides",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "name",
+          "version",
+          "operations"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100,
+            "description": "Capability identifier (kebab-case recommended)"
+          },
+          "version": {
+            "type": "string",
+            "pattern": "^\\d+\\.\\d+\\.\\d+$",
+            "description": "Capability version (semantic versioning)"
+          },
+          "description": {
+            "type": "string",
+            "maxLength": 500,
+            "description": "Human-readable capability description"
+          },
+          "operations": {
+            "type": "array",
+            "description": "List of operations this capability supports",
+            "minItems": 1,
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 50
+            }
+          },
+          "optional": {
+            "type": "boolean",
+            "default": false,
+            "description": "Whether this capability is optional for clients"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "endpoints": {
+      "type": "object",
+      "description": "URL endpoints for LAFS operations",
+      "required": [
+        "envelope",
+        "discovery"
+      ],
+      "properties": {
+        "envelope": {
+          "type": "string",
+          "minLength": 1,
+          "description": "URL for envelope submission (POST)"
+        },
+        "context": {
+          "type": "string",
+          "minLength": 1,
+          "description": "URL for context ledger operations"
+        },
+        "discovery": {
+          "type": "string",
+          "minLength": 1,
+          "description": "URL of this discovery document"
+        }
+      },
+      "additionalProperties": false
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Extension fields for vendor-specific metadata",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}