settld 0.1.2 → 0.2.0

package/docs/spec/schemas/DisputeOpenEnvelope.v1.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/DisputeOpenEnvelope.v1.schema.json",
+  "title": "DisputeOpenEnvelope.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "artifactType",
+    "artifactId",
+    "envelopeId",
+    "caseId",
+    "tenantId",
+    "agreementHash",
+    "receiptHash",
+    "holdHash",
+    "openedByAgentId",
+    "openedAt",
+    "reasonCode",
+    "nonce",
+    "signerKeyId",
+    "envelopeHash",
+    "signature"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "DisputeOpenEnvelope.v1" },
+    "artifactType": { "const": "DisputeOpenEnvelope.v1" },
+    "artifactId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 240,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "envelopeId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 240,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "caseId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 240,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "tenantId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "agreementHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "receiptHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "holdHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "openedByAgentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "openedAt": { "type": "string", "format": "date-time" },
+    "reasonCode": { "type": "string", "pattern": "^[A-Z0-9_]{2,64}$" },
+    "nonce": {
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 240,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "signerKeyId": {
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 240,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "envelopeHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "signature": { "type": "string", "minLength": 16 }
+  }
+}

package/docs/spec/schemas/EvidenceIndex.v1.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/EvidenceIndex.v1.schema.json",
+  "title": "EvidenceIndex.v1",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "jobProof", "items"],
+  "properties": {
+    "schemaVersion": { "const": "EvidenceIndex.v1" },
+    "generatedAt": { "type": "string" },
+    "jobProof": {
+      "type": "object",
+      "required": ["embeddedPath", "manifestHash", "headAttestationHash"],
+      "properties": {
+        "embeddedPath": { "type": "string" },
+        "manifestHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "headAttestationHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["key", "source"],
+        "properties": {
+          "key": { "type": "string" },
+          "source": { "enum": ["metering_evidence_ref", "job_evidence_event"] },
+          "path": { "type": ["string", "null"] },
+          "sha256": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+          "eventId": { "type": ["string", "null"] },
+          "at": { "type": ["string", "null"] },
+          "evidenceId": { "type": ["string", "null"] },
+          "kind": { "type": ["string", "null"] },
+          "contentType": { "type": ["string", "null"] },
+          "sizeBytes": { "type": ["integer", "null"], "minimum": 0 },
+          "evidenceRefHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" }
+        }
+      }
+    }
+  }
+}
+

package/docs/spec/schemas/ExecutionIntent.v1.schema.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ExecutionIntent.v1.schema.json",
+  "title": "ExecutionIntent.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "intentId",
+    "tenantId",
+    "agentId",
+    "requestFingerprint",
+    "riskProfile",
+    "spendBounds",
+    "policyBinding",
+    "idempotencyKey",
+    "nonce",
+    "expiresAt",
+    "createdAt",
+    "intentHash"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "ExecutionIntent.v1" },
+    "intentId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "agentId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "runId": { "type": "string", "maxLength": 200 },
+    "agreementHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "quoteId": { "type": "string", "maxLength": 200 },
+    "requestFingerprint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["canonicalization", "method", "path", "querySha256", "bodySha256", "requestSha256"],
+      "properties": {
+        "canonicalization": { "const": "rfc8785-jcs" },
+        "method": { "type": "string", "minLength": 1, "maxLength": 16 },
+        "path": { "type": "string", "minLength": 1, "maxLength": 2048 },
+        "querySha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "bodySha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "requestSha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "riskProfile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["riskClass", "sideEffecting", "expectedDeterminism", "maxLossCents", "requiresHumanApproval"],
+      "properties": {
+        "riskClass": { "type": "string", "enum": ["read", "compute", "action", "financial"] },
+        "sideEffecting": { "type": "boolean" },
+        "expectedDeterminism": {
+          "type": "string",
+          "enum": ["deterministic", "bounded_nondeterministic", "open_nondeterministic"]
+        },
+        "maxLossCents": { "type": "integer", "minimum": 0 },
+        "requiresHumanApproval": { "type": "boolean" }
+      }
+    },
+    "spendBounds": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["currency", "maxAmountCents"],
+      "properties": {
+        "currency": { "type": "string", "minLength": 3, "maxLength": 8 },
+        "maxAmountCents": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "policyBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policyId", "policyVersion", "policyHash", "verificationMethodHash"],
+      "properties": {
+        "policyId": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "policyVersion": { "type": "integer", "minimum": 1 },
+        "policyHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "verificationMethodHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "idempotencyKey": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "nonce": { "type": "string", "minLength": 8, "maxLength": 256 },
+    "expiresAt": { "type": "string", "format": "date-time" },
+    "metadata": { "type": "object", "additionalProperties": true },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "intentHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}

package/docs/spec/schemas/FinancePackBundleManifest.v1.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/FinancePackBundleManifest.v1.schema.json",
+  "title": "FinancePackBundleManifest.v1",
+  "type": "object",
+  "required": ["schemaVersion", "type", "tenantId", "period", "createdAt", "protocol", "hashing", "files"],
+  "properties": {
+    "schemaVersion": { "const": "FinancePackBundleManifest.v1" },
+    "type": { "const": "FinancePackBundle.v1" },
+    "tenantId": { "type": "string" },
+    "period": { "type": "string" },
+    "createdAt": { "type": "string" },
+    "protocol": { "type": "string" },
+    "hashing": {
+      "type": "object",
+      "required": ["schemaVersion", "fileOrder", "excludes"],
+      "properties": {
+        "schemaVersion": { "const": "FinancePackBundleManifestHash.v1" },
+        "fileOrder": { "const": "path_asc" },
+        "excludes": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "sha256", "bytes"],
+        "properties": {
+          "name": { "type": "string" },
+          "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+          "bytes": { "type": "integer", "minimum": 0 }
+        }
+      }
+    },
+    "manifestHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}
+

package/docs/spec/schemas/FundingHold.v1.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/FundingHold.v1.schema.json",
+  "title": "FundingHold.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "tenantId",
+    "agreementHash",
+    "receiptHash",
+    "payerAgentId",
+    "payeeAgentId",
+    "amountCents",
+    "heldAmountCents",
+    "currency",
+    "holdbackBps",
+    "challengeWindowMs",
+    "createdAt",
+    "holdHash",
+    "status",
+    "revision",
+    "updatedAt"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "FundingHold.v1" },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "agreementHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "receiptHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "payerAgentId": { "type": "string", "minLength": 3, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "payeeAgentId": { "type": "string", "minLength": 3, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "amountCents": { "type": "integer", "minimum": 1 },
+    "heldAmountCents": { "type": "integer", "minimum": 0 },
+    "currency": { "type": "string", "minLength": 3, "maxLength": 12, "pattern": "^[A-Z][A-Z0-9_]{2,11}$" },
+    "holdbackBps": { "type": "integer", "minimum": 0 },
+    "challengeWindowMs": { "type": "integer", "minimum": 0 },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "holdHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "status": { "type": "string", "enum": ["held", "released", "refunded"] },
+    "resolvedAt": { "type": "string", "format": "date-time" },
+    "revision": { "type": "integer", "minimum": 0 },
+    "updatedAt": { "type": "string", "format": "date-time" },
+    "metadata": { "type": "object", "additionalProperties": true }
+  }
+}
+

package/docs/spec/schemas/GovernancePolicy.v1.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/GovernancePolicy.v1.schema.json",
+  "title": "GovernancePolicy.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "policyId", "generatedAt", "algorithms", "verificationReportSigners", "bundleHeadAttestationSigners"],
+  "properties": {
+    "schemaVersion": { "const": "GovernancePolicy.v1" },
+    "policyId": { "type": "string" },
+    "generatedAt": { "type": "string" },
+    "algorithms": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "enum": ["ed25519"] }
+    },
+    "verificationReportSigners": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/SignerRule" }
+    },
+    "bundleHeadAttestationSigners": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/SignerRule" }
+    }
+  },
+  "$defs": {
+    "SignerRule": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["subjectType", "allowedScopes", "allowedKeyIds", "requireGoverned", "requiredPurpose"],
+      "properties": {
+        "subjectType": { "type": "string" },
+        "allowedScopes": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "enum": ["global", "tenant"] }
+        },
+        "allowedKeyIds": { "type": ["array", "null"], "items": { "type": "string" } },
+        "requireGoverned": { "type": "boolean" },
+        "requiredPurpose": { "type": "string", "enum": ["server"] }
+      }
+    }
+  }
+}
+

package/docs/spec/schemas/GovernancePolicy.v2.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/GovernancePolicy.v2.schema.json",
+  "title": "GovernancePolicy.v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "policyId",
+    "generatedAt",
+    "algorithms",
+    "verificationReportSigners",
+    "bundleHeadAttestationSigners",
+    "revocationList",
+    "signerKeyId",
+    "signedAt",
+    "policyHash",
+    "signature"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "GovernancePolicy.v2" },
+    "policyId": { "type": "string" },
+    "generatedAt": { "type": "string" },
+    "algorithms": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "enum": ["ed25519"] }
+    },
+    "verificationReportSigners": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/SignerRuleV2" }
+    },
+    "bundleHeadAttestationSigners": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/SignerRuleV2" }
+    },
+    "revocationList": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": {
+        "path": { "type": "string" },
+        "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "signerKeyId": { "type": ["string", "null"] },
+    "signedAt": { "type": ["string", "null"] },
+    "policyHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "signature": { "type": ["string", "null"] }
+  },
+  "$defs": {
+    "SignerRuleV2": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["subjectType", "allowedScopes", "allowedKeyIds", "requireGoverned", "requiredPurpose"],
+      "properties": {
+        "subjectType": { "type": "string" },
+        "allowedScopes": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "enum": ["global", "tenant"] }
+        },
+        "allowedKeyIds": { "type": "array", "items": { "type": "string" } },
+        "requireGoverned": { "type": "boolean" },
+        "requiredPurpose": { "type": "string", "enum": ["server"] }
+      }
+    }
+  }
+}
+

package/docs/spec/schemas/InteractionDirectionMatrix.v1.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/InteractionDirectionMatrix.v1.schema.json",
+  "title": "InteractionDirectionMatrix.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "entityTypes", "directions", "directionalCount"],
+  "properties": {
+    "schemaVersion": {
+      "const": "InteractionDirectionMatrix.v1"
+    },
+    "entityTypes": {
+      "const": ["agent", "human", "robot", "machine"]
+    },
+    "directions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["agent", "human", "robot", "machine"],
+      "properties": {
+        "agent": { "$ref": "#/$defs/row" },
+        "human": { "$ref": "#/$defs/row" },
+        "robot": { "$ref": "#/$defs/row" },
+        "machine": { "$ref": "#/$defs/row" }
+      }
+    },
+    "directionalCount": {
+      "const": 16
+    }
+  },
+  "$defs": {
+    "row": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["agent", "human", "robot", "machine"],
+      "properties": {
+        "agent": { "const": true },
+        "human": { "const": true },
+        "robot": { "const": true },
+        "machine": { "const": true }
+      }
+    }
+  }
+}

package/docs/spec/schemas/InvoiceBundleManifest.v1.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/InvoiceBundleManifest.v1.schema.json",
+  "title": "InvoiceBundleManifest.v1",
+  "type": "object",
+  "required": ["schemaVersion", "type", "tenantId", "invoiceId", "createdAt", "protocol", "hashing", "files"],
+  "properties": {
+    "schemaVersion": { "const": "InvoiceBundleManifest.v1" },
+    "type": { "const": "InvoiceBundle.v1" },
+    "tenantId": { "type": "string" },
+    "invoiceId": { "type": "string" },
+    "createdAt": { "type": "string" },
+    "protocol": { "type": "string" },
+    "hashing": {
+      "type": "object",
+      "required": ["schemaVersion", "fileOrder", "excludes"],
+      "properties": {
+        "schemaVersion": { "const": "InvoiceBundleManifestHash.v1" },
+        "fileOrder": { "const": "path_asc" },
+        "excludes": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "files": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "sha256", "bytes"],
+        "properties": {
+          "name": { "type": "string" },
+          "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+          "bytes": { "type": "integer", "minimum": 0 }
+        }
+      }
+    },
+    "manifestHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}
+

package/docs/spec/schemas/InvoiceClaim.v1.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/InvoiceClaim.v1.schema.json",
+  "title": "InvoiceClaim.v1",
+  "type": "object",
+  "required": ["schemaVersion", "tenantId", "invoiceId", "createdAt", "currency", "jobProof", "totalCents"],
+  "properties": {
+    "schemaVersion": { "const": "InvoiceClaim.v1" },
+    "tenantId": { "type": "string" },
+    "invoiceId": { "type": "string" },
+    "createdAt": { "type": "string" },
+    "currency": { "type": "string" },
+    "jobProof": {
+      "type": "object",
+      "required": ["embeddedPath", "manifestHash", "headAttestationHash"],
+      "properties": {
+        "embeddedPath": { "const": "payload/job_proof_bundle" },
+        "manifestHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "headAttestationHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "lineItems": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["code", "quantity", "unitPriceCents", "amountCents"],
+        "properties": {
+          "code": { "type": "string" },
+          "quantity": { "type": "string", "pattern": "^[0-9]+$" },
+          "unitPriceCents": { "type": "string", "pattern": "^[0-9]+$" },
+          "amountCents": { "type": "string", "pattern": "^[0-9]+$" }
+        }
+      }
+    },
+    "subtotalCents": { "type": ["string", "null"], "pattern": "^[0-9]+$" },
+    "totalCents": { "type": "string", "pattern": "^[0-9]+$" }
+  }
+}
+

package/docs/spec/schemas/MarketplaceAcceptance.v2.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/MarketplaceAcceptance.v2.schema.json",
+  "title": "MarketplaceAcceptance.v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "acceptanceId",
+    "tenantId",
+    "rfqId",
+    "runId",
+    "bidId",
+    "agreementId",
+    "acceptedAt",
+    "acceptedByAgentId",
+    "acceptedProposalId",
+    "acceptedRevision",
+    "acceptedProposalHash",
+    "offerChainHash",
+    "proposalCount",
+    "offerRef",
+    "createdAt",
+    "acceptanceHash"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "MarketplaceAcceptance.v2" },
+    "acceptanceId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "rfqId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "runId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "bidId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "agreementId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "acceptedAt": { "type": ["string", "null"], "format": "date-time" },
+    "acceptedByAgentId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "acceptedProposalId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "acceptedRevision": { "type": ["integer", "null"], "minimum": 1 },
+    "acceptedProposalHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "offerChainHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "proposalCount": { "type": ["integer", "null"], "minimum": 1 },
+    "offerRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["offerId", "offerHash"],
+      "properties": {
+        "offerId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+        "offerHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "acceptanceHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}

package/docs/spec/schemas/MarketplaceOffer.v2.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/MarketplaceOffer.v2.schema.json",
+  "title": "MarketplaceOffer.v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "offerId",
+    "tenantId",
+    "rfqId",
+    "runId",
+    "bidId",
+    "proposalId",
+    "revision",
+    "proposerAgentId",
+    "amountCents",
+    "currency",
+    "etaSeconds",
+    "note",
+    "verificationMethod",
+    "policy",
+    "policyRef",
+    "policyRefHash",
+    "prevProposalHash",
+    "proposalHash",
+    "offerChainHash",
+    "proposalCount",
+    "metadata",
+    "proposedAt",
+    "createdAt",
+    "offerHash"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "MarketplaceOffer.v2" },
+    "offerId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "rfqId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "runId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "bidId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "proposalId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "revision": { "type": "integer", "minimum": 1 },
+    "proposerAgentId": { "type": ["string", "null"], "minLength": 1, "maxLength": 300 },
+    "amountCents": { "type": "integer", "minimum": 1 },
+    "currency": { "type": "string", "minLength": 3, "maxLength": 12, "pattern": "^[A-Z][A-Z0-9_]{2,11}$" },
+    "etaSeconds": { "type": ["integer", "null"], "minimum": 1 },
+    "note": { "type": ["string", "null"], "maxLength": 4000 },
+    "verificationMethod": { "type": ["object", "null"], "additionalProperties": true },
+    "policy": { "type": ["object", "null"], "additionalProperties": true },
+    "policyRef": { "type": ["object", "null"], "additionalProperties": true },
+    "policyRefHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "prevProposalHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "proposalHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "offerChainHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+    "proposalCount": { "type": ["integer", "null"], "minimum": 1 },
+    "metadata": { "type": ["object", "null"], "additionalProperties": true },
+    "proposedAt": { "type": "string", "format": "date-time" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "offerHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}