@zanii/certify 0.0.0-stage → 0.6.0

package/dist/schemas/trajectory.schema.json

@@ -0,0 +1,1396 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "title": "Trajectory suite and trace contracts v1",
+    "$ref": "#/$defs/suite",
+    "$defs": {
+        "scalar": {
+            "anyOf": [
+                {
+                    "type": "string",
+                    "maxLength": 4096
+                },
+                {
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991
+                },
+                {
+                    "type": "boolean"
+                },
+                {
+                    "const": null
+                }
+            ]
+        },
+        "key": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+        },
+        "state": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 64,
+            "items": {
+                "type": "object",
+                "required": [
+                    "key",
+                    "value"
+                ],
+                "additionalProperties": false,
+                "properties": {
+                    "key": {
+                        "$ref": "#/$defs/key"
+                    },
+                    "value": {
+                        "$ref": "#/$defs/scalar"
+                    }
+                }
+            }
+        },
+        "operand": {
+            "anyOf": [
+                {
+                    "type": "object",
+                    "required": [
+                        "source",
+                        "value"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "source": {
+                            "const": "literal"
+                        },
+                        "value": {
+                            "$ref": "#/$defs/scalar"
+                        }
+                    }
+                },
+                {
+                    "type": "object",
+                    "required": [
+                        "source",
+                        "key"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "source": {
+                            "enum": [
+                                "state",
+                                "arg"
+                            ]
+                        },
+                        "key": {
+                            "$ref": "#/$defs/key"
+                        }
+                    }
+                }
+            ]
+        },
+        "condition": {
+            "type": "object",
+            "required": [
+                "left",
+                "op",
+                "right"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "left": {
+                    "$ref": "#/$defs/operand"
+                },
+                "op": {
+                    "enum": [
+                        "eq",
+                        "ne",
+                        "gte",
+                        "lte"
+                    ]
+                },
+                "right": {
+                    "$ref": "#/$defs/operand"
+                }
+            }
+        },
+        "effect": {
+            "type": "object",
+            "required": [
+                "op",
+                "key",
+                "value"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "op": {
+                    "enum": [
+                        "set",
+                        "add"
+                    ]
+                },
+                "key": {
+                    "$ref": "#/$defs/key"
+                },
+                "value": {
+                    "$ref": "#/$defs/operand"
+                }
+            }
+        },
+        "argument": {
+            "type": "object",
+            "required": [
+                "name",
+                "type",
+                "required"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "name": {
+                    "$ref": "#/$defs/key"
+                },
+                "type": {
+                    "enum": [
+                        "string",
+                        "integer",
+                        "boolean"
+                    ]
+                },
+                "required": {
+                    "type": "boolean"
+                },
+                "enum": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 32,
+                    "items": {
+                        "$ref": "#/$defs/scalar"
+                    }
+                },
+                "minimum": {
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991
+                },
+                "maximum": {
+                    "type": "integer",
+                    "minimum": -9007199254740991,
+                    "maximum": 9007199254740991
+                },
+                "max_length": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 4096
+                }
+            }
+        },
+        "rule": {
+            "type": "object",
+            "required": [
+                "when",
+                "outcome",
+                "result",
+                "effects"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "when": {
+                    "type": "array",
+                    "minItems": 0,
+                    "maxItems": 16,
+                    "items": {
+                        "$ref": "#/$defs/condition"
+                    }
+                },
+                "outcome": {
+                    "enum": [
+                        "ok",
+                        "error"
+                    ]
+                },
+                "result": {
+                    "type": "string",
+                    "maxLength": 16384
+                },
+                "effects": {
+                    "type": "array",
+                    "minItems": 0,
+                    "maxItems": 16,
+                    "items": {
+                        "$ref": "#/$defs/effect"
+                    }
+                }
+            }
+        },
+        "tool": {
+            "type": "object",
+            "required": [
+                "name",
+                "description",
+                "arguments",
+                "requires",
+                "rules"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "name": {
+                    "$ref": "#/$defs/key"
+                },
+                "description": {
+                    "type": "string",
+                    "maxLength": 2000
+                },
+                "arguments": {
+                    "type": "array",
+                    "minItems": 0,
+                    "maxItems": 16,
+                    "items": {
+                        "$ref": "#/$defs/argument"
+                    }
+                },
+                "requires": {
+                    "type": "array",
+                    "minItems": 0,
+                    "maxItems": 16,
+                    "items": {
+                        "$ref": "#/$defs/condition"
+                    }
+                },
+                "rules": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 16,
+                    "items": {
+                        "$ref": "#/$defs/rule"
+                    }
+                },
+                "spend": {
+                    "type": "object",
+                    "required": [
+                        "amount_arg",
+                        "currency_arg"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "amount_arg": {
+                            "$ref": "#/$defs/key"
+                        },
+                        "currency_arg": {
+                            "$ref": "#/$defs/key"
+                        }
+                    }
+                },
+                "idempotency_arg": {
+                    "$ref": "#/$defs/key"
+                }
+            }
+        },
+        "budget": {
+            "type": "object",
+            "required": [
+                "max_rounds",
+                "max_calls",
+                "max_batch",
+                "max_ms",
+                "max_exchanges",
+                "max_sent_bytes",
+                "max_received_bytes",
+                "max_reply_bytes",
+                "max_result_bytes",
+                "max_state_bytes",
+                "max_trace_bytes",
+                "currency",
+                "max_spend_minor"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "max_rounds": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 10
+                },
+                "max_calls": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 16
+                },
+                "max_batch": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 4
+                },
+                "max_ms": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 60000
+                },
+                "max_exchanges": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 64
+                },
+                "max_sent_bytes": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 2097152
+                },
+                "max_received_bytes": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 2097152
+                },
+                "max_reply_bytes": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 65536
+                },
+                "max_result_bytes": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 16384
+                },
+                "max_state_bytes": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 65536
+                },
+                "max_trace_bytes": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 262144
+                },
+                "currency": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 3,
+                    "pattern": "^[A-Z]{3}$"
+                },
+                "max_spend_minor": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                }
+            }
+        },
+        "terminal": {
+            "type": "object",
+            "required": [
+                "any_of",
+                "forbidden_outbound"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "any_of": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 8,
+                    "items": {
+                        "type": "array",
+                        "minItems": 1,
+                        "maxItems": 16,
+                        "items": {
+                            "$ref": "#/$defs/condition"
+                        }
+                    }
+                },
+                "forbidden_outbound": {
+                    "type": "array",
+                    "minItems": 0,
+                    "maxItems": 64,
+                    "items": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 1024
+                    }
+                }
+            }
+        },
+        "fixture": {
+            "type": "object",
+            "required": [
+                "initial_state",
+                "tools"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "initial_state": {
+                    "$ref": "#/$defs/state"
+                },
+                "tools": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 16,
+                    "items": {
+                        "$ref": "#/$defs/tool"
+                    }
+                }
+            }
+        },
+        "profileRefs": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 64,
+            "uniqueItems": true,
+            "items": {
+                "type": "string",
+                "maxLength": 100,
+                "pattern": "^[a-z0-9][a-z0-9-]{0,63}/[1-9][0-9]{0,8}$"
+            }
+        },
+        "teamPolicy": {
+            "type": "object",
+            "required": [
+                "members",
+                "require_distinct_owners"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "members": {
+                    "type": "array",
+                    "minItems": 3,
+                    "maxItems": 64,
+                    "uniqueItems": true,
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "agent",
+                            "owner"
+                        ],
+                        "additionalProperties": false,
+                        "properties": {
+                            "agent": {
+                                "anyOf": [
+                                    {
+                                        "const": "$agent"
+                                    },
+                                    {
+                                        "type": "string",
+                                        "pattern": "^did:key:z[1-9A-HJ-NP-Za-km-z]{40,60}$"
+                                    }
+                                ]
+                            },
+                            "owner": {
+                                "type": "string",
+                                "pattern": "^did:key:z[1-9A-HJ-NP-Za-km-z]{40,60}$"
+                            }
+                        }
+                    }
+                },
+                "require_distinct_owners": {
+                    "type": "boolean"
+                },
+                "bind_run": {
+                    "type": "boolean"
+                }
+            }
+        },
+        "scope": {
+            "type": "string",
+            "maxLength": 128,
+            "pattern": "^(\\*|[a-z0-9_-]+(\\.[a-z0-9_-]+)*(\\.\\*)?)$"
+        },
+        "arg": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9_]{1,64}$"
+        },
+        "cert": {
+            "type": "object",
+            "required": [
+                "v",
+                "issuer",
+                "subject",
+                "scopes",
+                "exp",
+                "sig"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "v": {
+                    "const": 1
+                },
+                "issuer": {
+                    "type": "string",
+                    "pattern": "^did:key:z[1-9A-HJ-NP-Za-km-z]{40,60}$"
+                },
+                "subject": {
+                    "type": "string",
+                    "pattern": "^did:key:z[1-9A-HJ-NP-Za-km-z]{40,60}$"
+                },
+                "scopes": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 64,
+                    "items": {
+                        "$ref": "#/$defs/scope"
+                    }
+                },
+                "exp": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 64
+                },
+                "sig": {
+                    "type": "string",
+                    "pattern": "^ed25519:[0-9a-f]{128}$"
+                }
+            }
+        },
+        "revocation": {
+            "type": "object",
+            "required": [
+                "v",
+                "type",
+                "cert",
+                "ts",
+                "sig"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "v": {
+                    "const": 1
+                },
+                "type": {
+                    "const": "revocation"
+                },
+                "cert": {
+                    "$ref": "#/$defs/cert"
+                },
+                "ts": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 64
+                },
+                "sig": {
+                    "type": "string",
+                    "pattern": "^ed25519:[0-9a-f]{128}$"
+                }
+            }
+        },
+        "link": {
+            "type": "object",
+            "required": [
+                "agent",
+                "scopes",
+                "spend_limit"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "agent": {
+                    "type": "string",
+                    "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
+                },
+                "scopes": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 64,
+                    "uniqueItems": true,
+                    "items": {
+                        "$ref": "#/$defs/scope"
+                    }
+                },
+                "spend_limit": {
+                    "type": "object",
+                    "required": [
+                        "amount_minor",
+                        "currency"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "amount_minor": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "currency": {
+                            "type": "string",
+                            "pattern": "^[A-Z]{3}$"
+                        }
+                    }
+                }
+            }
+        },
+        "text": {
+            "type": "object",
+            "required": [
+                "en",
+                "ar"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "en": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 4000
+                },
+                "ar": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 4000
+                }
+            }
+        },
+        "rubric": {
+            "type": "object",
+            "required": [
+                "id",
+                "title",
+                "pass",
+                "fail"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
+                },
+                "title": {
+                    "$ref": "#/$defs/text"
+                },
+                "pass": {
+                    "$ref": "#/$defs/text"
+                },
+                "fail": {
+                    "$ref": "#/$defs/text"
+                }
+            }
+        },
+        "case": {
+            "type": "object",
+            "required": [
+                "id",
+                "category",
+                "lang",
+                "turns",
+                "check",
+                "fixture",
+                "budget",
+                "terminal"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "pattern": "^[a-z0-9][a-z0-9-]{0,95}$"
+                },
+                "category": {
+                    "type": "string",
+                    "pattern": "^[a-z][a-z0-9_]{0,63}$"
+                },
+                "lang": {
+                    "enum": [
+                        "en",
+                        "ar",
+                        "ar-gulf"
+                    ]
+                },
+                "turns": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 20,
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "role",
+                            "content"
+                        ],
+                        "additionalProperties": false,
+                        "properties": {
+                            "role": {
+                                "enum": [
+                                    "user",
+                                    "assistant"
+                                ]
+                            },
+                            "content": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 20000
+                            }
+                        }
+                    }
+                },
+                "documents": {
+                    "type": "array",
+                    "maxItems": 10,
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "name",
+                            "text"
+                        ],
+                        "additionalProperties": false,
+                        "properties": {
+                            "name": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 200
+                            },
+                            "text": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 100000
+                            }
+                        }
+                    }
+                },
+                "check": {
+                    "$ref": "#/$defs/check"
+                },
+                "fixture": {
+                    "$ref": "#/$defs/fixture"
+                },
+                "budget": {
+                    "$ref": "#/$defs/budget"
+                },
+                "terminal": {
+                    "$ref": "#/$defs/terminal"
+                },
+                "profiles": {
+                    "$ref": "#/$defs/profileRefs"
+                },
+                "transcript": {
+                    "$ref": "#/$defs/transcript"
+                },
+                "family_id": {
+                    "type": "string",
+                    "pattern": "^[a-z0-9][a-z0-9-]{0,95}$"
+                }
+            }
+        },
+        "check": {
+            "type": "object",
+            "required": [
+                "kind"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "kind": {
+                    "enum": [
+                        "not_contains",
+                        "contains_any",
+                        "tool_not_called",
+                        "max_tool_calls",
+                        "all",
+                        "judged"
+                    ]
+                },
+                "values": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 64,
+                    "items": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 2000
+                    }
+                },
+                "tools": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 64,
+                    "uniqueItems": true,
+                    "items": {
+                        "type": "string",
+                        "pattern": "^[A-Za-z0-9_-]{1,64}$"
+                    }
+                },
+                "n": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 1000
+                },
+                "checks": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 16,
+                    "items": {
+                        "$ref": "#/$defs/check"
+                    }
+                },
+                "rubric": {
+                    "type": "string",
+                    "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
+                },
+                "tool": {
+                    "type": "string",
+                    "pattern": "^[A-Za-z0-9_-]{1,64}$"
+                },
+                "threshold": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 64
+                },
+                "invocation": {
+                    "enum": [
+                        "required",
+                        "optional"
+                    ]
+                },
+                "policy": {
+                    "$ref": "#/$defs/teamPolicy"
+                },
+                "finding": {
+                    "type": "string",
+                    "pattern": "^[A-Z][A-Z0-9_]{0,63}$"
+                }
+            }
+        },
+        "suite": {
+            "type": "object",
+            "required": [
+                "v",
+                "type",
+                "purpose",
+                "visibility",
+                "mode",
+                "id",
+                "version",
+                "cases"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "v": {
+                    "const": 1
+                },
+                "type": {
+                    "const": "certify.trajectory-suite"
+                },
+                "purpose": {
+                    "enum": [
+                        "practice",
+                        "certification"
+                    ]
+                },
+                "visibility": {
+                    "enum": [
+                        "public",
+                        "held-out"
+                    ]
+                },
+                "mode": {
+                    "const": "simulated_workflow"
+                },
+                "id": {
+                    "type": "string",
+                    "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
+                },
+                "version": {
+                    "type": "integer",
+                    "minimum": 1
+                },
+                "cases": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 64,
+                    "items": {
+                        "$ref": "#/$defs/case"
+                    }
+                },
+                "rubrics": {
+                    "type": "array",
+                    "minItems": 1,
+                    "maxItems": 64,
+                    "items": {
+                        "$ref": "#/$defs/rubric"
+                    }
+                },
+                "profiles": {
+                    "$ref": "#/$defs/profileRefs"
+                }
+            }
+        },
+        "assistant_event": {
+            "type": "object",
+            "required": [
+                "kind",
+                "round",
+                "text"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "kind": {
+                    "const": "assistant"
+                },
+                "round": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 10
+                },
+                "text": {
+                    "type": "string",
+                    "maxLength": 65536
+                }
+            }
+        },
+        "tool_event": {
+            "type": "object",
+            "required": [
+                "kind",
+                "round",
+                "call_id",
+                "name",
+                "raw_arguments",
+                "arguments",
+                "outcome",
+                "applied",
+                "result",
+                "state_before",
+                "state_after",
+                "spend_minor",
+                "findings"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "kind": {
+                    "const": "tool"
+                },
+                "round": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 10
+                },
+                "call_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[A-Za-z0-9._:-]{1,128}$"
+                },
+                "name": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128
+                },
+                "raw_arguments": {
+                    "type": "string",
+                    "maxLength": 16384
+                },
+                "arguments": {
+                    "anyOf": [
+                        {
+                            "type": "object"
+                        },
+                        {
+                            "const": null
+                        }
+                    ]
+                },
+                "outcome": {
+                    "enum": [
+                        "ok",
+                        "error",
+                        "blocked",
+                        "replayed"
+                    ]
+                },
+                "applied": {
+                    "type": "boolean"
+                },
+                "result": {
+                    "type": "string",
+                    "maxLength": 16384
+                },
+                "state_before": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 71,
+                    "pattern": "^sha256:[0-9a-f]{64}$"
+                },
+                "state_after": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 71,
+                    "pattern": "^sha256:[0-9a-f]{64}$"
+                },
+                "spend_minor": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                },
+                "findings": {
+                    "type": "array",
+                    "minItems": 0,
+                    "maxItems": 16,
+                    "items": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 64,
+                        "pattern": "^[A-Z][A-Z0-9_]{0,63}$"
+                    }
+                }
+            }
+        },
+        "trace": {
+            "type": "object",
+            "required": [
+                "v",
+                "type",
+                "purpose",
+                "mode",
+                "case_id",
+                "case_hash",
+                "initial_state_hash",
+                "final_state",
+                "events",
+                "terminal",
+                "usage"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "v": {
+                    "const": 1
+                },
+                "type": {
+                    "const": "certify.trajectory-trace"
+                },
+                "purpose": {
+                    "enum": [
+                        "practice",
+                        "certification"
+                    ]
+                },
+                "mode": {
+                    "const": "simulated_workflow"
+                },
+                "case_id": {
+                    "type": "string",
+                    "pattern": "^[a-z0-9][a-z0-9-]{0,95}$"
+                },
+                "case_hash": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 71,
+                    "pattern": "^sha256:[0-9a-f]{64}$"
+                },
+                "initial_state_hash": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 71,
+                    "pattern": "^sha256:[0-9a-f]{64}$"
+                },
+                "final_state": {
+                    "$ref": "#/$defs/state"
+                },
+                "events": {
+                    "type": "array",
+                    "minItems": 0,
+                    "maxItems": 27,
+                    "items": {
+                        "anyOf": [
+                            {
+                                "$ref": "#/$defs/assistant_event"
+                            },
+                            {
+                                "$ref": "#/$defs/tool_event"
+                            },
+                            {
+                                "$ref": "#/$defs/rejected_batch"
+                            }
+                        ]
+                    }
+                },
+                "terminal": {
+                    "type": "object",
+                    "required": [
+                        "reason",
+                        "complete"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "reason": {
+                            "enum": [
+                                "completed",
+                                "budget",
+                                "cancelled",
+                                "provider_error",
+                                "lab_error",
+                                "invalid_call"
+                            ]
+                        },
+                        "complete": {
+                            "type": "boolean"
+                        }
+                    }
+                },
+                "usage": {
+                    "type": "object",
+                    "required": [
+                        "rounds",
+                        "calls",
+                        "exchanges",
+                        "sent_bytes",
+                        "received_bytes",
+                        "elapsed_ms",
+                        "spend_minor",
+                        "currency"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "rounds": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "calls": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "exchanges": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "sent_bytes": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "received_bytes": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "elapsed_ms": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "spend_minor": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "currency": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 3,
+                            "pattern": "^[A-Z]{3}$"
+                        }
+                    }
+                }
+            }
+        },
+        "rejected_batch": {
+            "type": "object",
+            "required": [
+                "kind",
+                "round",
+                "raw_calls",
+                "finding"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "kind": {
+                    "const": "rejected_batch"
+                },
+                "round": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 10
+                },
+                "raw_calls": {
+                    "type": "string",
+                    "maxLength": 65536
+                },
+                "finding": {
+                    "type": "string",
+                    "pattern": "^[A-Z][A-Z0-9_]{0,63}$",
+                    "maxLength": 64,
+                    "minLength": 1
+                }
+            }
+        },
+        "transcriptTurns": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 20,
+            "items": {
+                "type": "object",
+                "required": [
+                    "role",
+                    "content"
+                ],
+                "additionalProperties": false,
+                "properties": {
+                    "role": {
+                        "enum": [
+                            "user",
+                            "assistant"
+                        ]
+                    },
+                    "content": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 20000
+                    }
+                }
+            }
+        },
+        "transcriptFingerprint": {
+            "type": "object",
+            "required": [
+                "v",
+                "type",
+                "model",
+                "prompt",
+                "tools",
+                "policy",
+                "knowledge",
+                "configuration",
+                "id"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "v": {
+                    "const": 1
+                },
+                "type": {
+                    "const": "certify.fingerprint"
+                },
+                "model": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 200
+                },
+                "prompt": {
+                    "anyOf": [
+                        {
+                            "type": "string",
+                            "pattern": "^sha256:[0-9a-f]{64}$"
+                        },
+                        {
+                            "const": null
+                        }
+                    ]
+                },
+                "tools": {
+                    "anyOf": [
+                        {
+                            "type": "string",
+                            "pattern": "^sha256:[0-9a-f]{64}$"
+                        },
+                        {
+                            "const": null
+                        }
+                    ]
+                },
+                "policy": {
+                    "anyOf": [
+                        {
+                            "type": "string",
+                            "pattern": "^sha256:[0-9a-f]{64}$"
+                        },
+                        {
+                            "const": null
+                        }
+                    ]
+                },
+                "knowledge": {
+                    "anyOf": [
+                        {
+                            "type": "string",
+                            "pattern": "^sha256:[0-9a-f]{64}$"
+                        },
+                        {
+                            "const": null
+                        }
+                    ]
+                },
+                "configuration": {
+                    "type": "string",
+                    "pattern": "^ver_[0-9a-f]{12}$"
+                },
+                "id": {
+                    "type": "string",
+                    "pattern": "^sha256:[0-9a-f]{64}$"
+                }
+            }
+        },
+        "transcript": {
+            "type": "object",
+            "required": [
+                "v",
+                "type",
+                "assessment_scope",
+                "source_kind",
+                "language",
+                "wrapper",
+                "original_turns",
+                "original_turns_hash",
+                "processed_turns_hash",
+                "processing"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "v": {
+                    "const": 1
+                },
+                "type": {
+                    "const": "certify.transcript-provenance"
+                },
+                "assessment_scope": {
+                    "const": "transcript_behavior"
+                },
+                "source_kind": {
+                    "enum": [
+                        "authored_transcript",
+                        "provided_transcript"
+                    ]
+                },
+                "language": {
+                    "enum": [
+                        "en",
+                        "ar",
+                        "ar-gulf"
+                    ]
+                },
+                "wrapper": {
+                    "type": "object",
+                    "required": [
+                        "did",
+                        "fingerprint"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "did": {
+                            "type": "string",
+                            "pattern": "^did:key:z[1-9A-HJ-NP-Za-km-z]{40,60}$"
+                        },
+                        "fingerprint": {
+                            "$ref": "#/$defs/transcriptFingerprint"
+                        }
+                    }
+                },
+                "original_turns": {
+                    "$ref": "#/$defs/transcriptTurns"
+                },
+                "original_turns_hash": {
+                    "type": "string",
+                    "pattern": "^sha256:[0-9a-f]{64}$"
+                },
+                "processed_turns_hash": {
+                    "type": "string",
+                    "pattern": "^sha256:[0-9a-f]{64}$"
+                },
+                "processing": {
+                    "type": "object",
+                    "required": [
+                        "id",
+                        "version"
+                    ],
+                    "additionalProperties": false,
+                    "properties": {
+                        "id": {
+                            "type": "string",
+                            "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
+                        },
+                        "version": {
+                            "type": "integer",
+                            "minimum": 1,
+                            "maximum": 1000000
+                        }
+                    }
+                }
+            }
+        }
+    }
+}