feat: add convert v1.0.0 request + receipt schemas

Author: Your Name

schemas/v1.0.0/commons/convert/receipts/convert.receipt.schema.json

@@ -0,0 +1,146 @@
+{
+  "$id": "https://commandlayer.org/schemas/v1.0.0/commons/convert/receipts/convert.receipt.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "convert.receipt",
+  "description": "Receipt for convert requests, extending the CommandLayer base receipt structure with conversion-specific result and usage fields.",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "https://commandlayer.org/schemas/v1.0.0/_shared/receipt.base.schema.json"
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "x402": {
+          "description": "x402 envelope describing the convert verb and version for this receipt.",
+          "allOf": [
+            {
+              "$ref": "https://commandlayer.org/schemas/v1.0.0/_shared/x402.schema.json"
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "verb": { "const": "convert" },
+                "version": { "const": "1.0.0" }
+              },
+              "required": ["verb", "version"]
+            }
+          ]
+        },
+        "result": {
+          "description": "Conversion result payload when status = 'ok' or 'partial'.",
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "output": {
+              "description": "Converted content or serialized data.",
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 500000
+            },
+            "from_format": {
+              "description": "Effective source format used by the agent.",
+              "type": "string",
+              "maxLength": 64
+            },
+            "to_format": {
+              "description": "Target format/representation that was produced.",
+              "type": "string",
+              "maxLength": 64
+            },
+            "from_schema_uri": {
+              "description": "Source schema URI used by the agent, if any.",
+              "type": "string",
+              "maxLength": 2048
+            },
+            "to_schema_uri": {
+              "description": "Target schema URI used for validation, if any.",
+              "type": "string",
+              "maxLength": 2048
+            },
+            "lossy": {
+              "description": "Whether the conversion was lossy.",
+              "type": "boolean"
+            },
+            "validation": {
+              "description": "Validation outcome for the converted data.",
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "valid": {
+                  "description": "Whether the converted output passed validation against the target schema, if provided.",
+                  "type": "boolean"
+                },
+                "errors": {
+                  "description": "Validation errors if validation failed or was partial.",
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 1024
+                  }
+                }
+              }
+            },
+            "warnings": {
+              "description": "Non-fatal warnings about the conversion (e.g., truncated fields, defaulted values).",
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 1024
+              }
+            },
+            "source_hash": {
+              "description": "Optional hash of the input content (e.g., sha256 hex).",
+              "type": "string",
+              "minLength": 32,
+              "maxLength": 128
+            },
+            "model_name": {
+              "description": "Identifier for the model or engine used, if applicable.",
+              "type": "string",
+              "maxLength": 256
+            }
+          },
+          "required": ["output", "to_format"]
+        },
+        "usage": {
+          "description": "Optional resource usage metrics for this invocation.",
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "input_tokens": {
+              "description": "Number of input tokens consumed (if LLM-based).",
+              "type": "integer",
+              "minimum": 0
+            },
+            "output_tokens": {
+              "description": "Number of output tokens produced.",
+              "type": "integer",
+              "minimum": 0
+            },
+            "total_tokens": {
+              "description": "Total tokens used (input + output), if available.",
+              "type": "integer",
+              "minimum": 0
+            },
+            "cost_usd": {
+              "description": "Optional cost for this call in USD (or equivalent fiat), if known.",
+              "type": "number",
+              "minimum": 0
+            },
+            "latency_ms": {
+              "description": "Observed end-to-end latency for this invocation in milliseconds.",
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        }
+      },
+      "required": ["x402", "trace", "status", "result"]
+    }
+  ]
+}