settld 0.1.2 → 0.2.0

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

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AgentRunSettlement.v1.schema.json",
+  "title": "AgentRunSettlement.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "settlementId",
+    "runId",
+    "tenantId",
+    "agentId",
+    "payerAgentId",
+    "amountCents",
+    "currency",
+    "status",
+    "lockedAt",
+    "revision",
+    "createdAt",
+    "updatedAt"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "AgentRunSettlement.v1" },
+    "settlementId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 200
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "tenantId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "agentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "payerAgentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "amountCents": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "currency": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 12,
+      "pattern": "^[A-Z][A-Z0-9_]{2,11}$"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["locked", "released", "refunded"]
+    },
+    "lockedAt": { "type": "string", "format": "date-time" },
+    "resolvedAt": { "type": ["string", "null"], "format": "date-time" },
+    "resolutionEventId": { "type": ["string", "null"], "maxLength": 200 },
+    "runStatus": { "type": ["string", "null"], "maxLength": 32 },
+    "revision": { "type": "integer", "minimum": 0 },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  }
+}

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

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AgentWallet.v1.schema.json",
+  "title": "AgentWallet.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "walletId",
+    "agentId",
+    "tenantId",
+    "currency",
+    "availableCents",
+    "escrowLockedCents",
+    "totalDebitedCents",
+    "totalCreditedCents",
+    "revision",
+    "createdAt",
+    "updatedAt"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "AgentWallet.v1" },
+    "walletId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 200
+    },
+    "agentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "tenantId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "currency": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 12,
+      "pattern": "^[A-Z][A-Z0-9_]{2,11}$"
+    },
+    "availableCents": { "type": "integer", "minimum": 0 },
+    "escrowLockedCents": { "type": "integer", "minimum": 0 },
+    "totalDebitedCents": { "type": "integer", "minimum": 0 },
+    "totalCreditedCents": { "type": "integer", "minimum": 0 },
+    "revision": { "type": "integer", "minimum": 0 },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  }
+}

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

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AgreementDelegation.v1.schema.json",
+  "title": "AgreementDelegation.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "delegationId",
+    "tenantId",
+    "parentAgreementHash",
+    "childAgreementHash",
+    "delegatorAgentId",
+    "delegateeAgentId",
+    "budgetCapCents",
+    "currency",
+    "delegationDepth",
+    "maxDelegationDepth",
+    "createdAt",
+    "delegationHash",
+    "status",
+    "revision",
+    "updatedAt"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "AgreementDelegation.v1" },
+    "delegationId": { "type": "string", "minLength": 3, "maxLength": 240, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "parentAgreementHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "childAgreementHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "delegatorAgentId": { "type": "string", "minLength": 3, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "delegateeAgentId": { "type": "string", "minLength": 3, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "budgetCapCents": { "type": "integer", "minimum": 1 },
+    "currency": { "type": "string", "minLength": 3, "maxLength": 12, "pattern": "^[A-Z][A-Z0-9_]{2,11}$" },
+    "delegationDepth": { "type": "integer", "minimum": 0 },
+    "maxDelegationDepth": { "type": "integer", "minimum": 0 },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "ancestorChain": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+    },
+    "delegationHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "status": { "type": "string", "enum": ["active", "settled", "revoked"] },
+    "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/ArbitrationCase.v1.schema.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ArbitrationCase.v1.schema.json",
+  "title": "ArbitrationCase.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "caseId",
+    "tenantId",
+    "runId",
+    "settlementId",
+    "disputeId",
+    "claimantAgentId",
+    "respondentAgentId",
+    "status",
+    "openedAt",
+    "evidenceRefs",
+    "revision",
+    "createdAt",
+    "updatedAt"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "ArbitrationCase.v1" },
+    "caseId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 200
+    },
+    "tenantId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "settlementId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 200
+    },
+    "disputeId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 200
+    },
+    "claimantAgentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "respondentAgentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "arbiterAgentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["open", "under_review", "verdict_issued", "closed"]
+    },
+    "openedAt": { "type": "string", "format": "date-time" },
+    "closedAt": { "type": "string", "format": "date-time" },
+    "summary": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4000
+    },
+    "evidenceRefs": {
+      "type": "array",
+      "maxItems": 1000,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 512
+      }
+    },
+    "verdictId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 200
+    },
+    "verdictHash": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "appealRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["parentCaseId"],
+      "properties": {
+        "parentCaseId": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 200
+        },
+        "parentVerdictId": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 200
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1000
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "revision": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  }
+}

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

@@ -0,0 +1,149 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ArbitrationVerdict.v1.schema.json",
+  "title": "ArbitrationVerdict.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "verdictId",
+    "caseId",
+    "tenantId",
+    "runId",
+    "settlementId",
+    "disputeId",
+    "arbiterAgentId",
+    "outcome",
+    "releaseRatePct",
+    "rationale",
+    "evidenceRefs",
+    "issuedAt",
+    "signature",
+    "revision",
+    "createdAt",
+    "updatedAt"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "ArbitrationVerdict.v1" },
+    "verdictId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 200
+    },
+    "caseId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 200
+    },
+    "tenantId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "runId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "settlementId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 200
+    },
+    "disputeId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 200
+    },
+    "arbiterAgentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "outcome": {
+      "type": "string",
+      "enum": ["accepted", "rejected", "partial"]
+    },
+    "releaseRatePct": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 100
+    },
+    "rationale": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4000
+    },
+    "evidenceRefs": {
+      "type": "array",
+      "maxItems": 1000,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 512
+      }
+    },
+    "issuedAt": { "type": "string", "format": "date-time" },
+    "appealRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["appealCaseId", "parentVerdictId"],
+      "properties": {
+        "appealCaseId": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 200
+        },
+        "parentVerdictId": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 200
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1000
+        }
+      }
+    },
+    "signature": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["algorithm", "signerKeyId", "verdictHash", "signature"],
+      "properties": {
+        "algorithm": {
+          "type": "string",
+          "enum": ["ed25519"]
+        },
+        "signerKeyId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "verdictHash": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "signature": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "revision": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  }
+}

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

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/BundleHeadAttestation.v1.schema.json",
+  "title": "BundleHeadAttestation.v1",
+  "type": "object",
+  "required": ["schemaVersion", "kind", "tenantId", "scope", "generatedAt", "manifestHash", "heads", "signedAt", "signerKeyId", "attestationHash", "signature"],
+  "properties": {
+    "schemaVersion": { "const": "BundleHeadAttestation.v1" },
+    "kind": { "type": "string" },
+    "tenantId": { "type": "string" },
+    "scope": { "type": "object" },
+    "generatedAt": { "type": "string" },
+    "manifestHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "heads": { "type": "object" },
+    "timestampProof": { "$ref": "https://settld.local/schemas/TimestampProof.v1.schema.json" },
+    "signedAt": { "type": "string" },
+    "signerKeyId": { "type": "string" },
+    "attestationHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "signature": { "type": "string" }
+  }
+}

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

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/ClosePackManifest.v1.schema.json",
+  "title": "ClosePackManifest.v1",
+  "type": "object",
+  "required": ["schemaVersion", "type", "tenantId", "invoiceId", "createdAt", "protocol", "hashing", "files"],
+  "properties": {
+    "schemaVersion": { "const": "ClosePackManifest.v1" },
+    "type": { "const": "ClosePack.v1" },
+    "tenantId": { "type": "string" },
+    "invoiceId": { "type": "string" },
+    "createdAt": { "type": "string" },
+    "protocol": { "type": "string" },
+    "hashing": {
+      "type": "object",
+      "required": ["schemaVersion", "fileOrder", "excludes"],
+      "properties": {
+        "schemaVersion": { "const": "ClosePackManifestHash.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/DelegationGrant.v1.schema.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/DelegationGrant.v1.schema.json",
+  "title": "DelegationGrant.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "grantId",
+    "tenantId",
+    "delegatorAgentId",
+    "delegateeAgentId",
+    "scope",
+    "spendLimit",
+    "chainBinding",
+    "validity",
+    "revocation",
+    "createdAt",
+    "grantHash"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "DelegationGrant.v1" },
+    "grantId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "delegatorAgentId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "delegateeAgentId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["allowedRiskClasses", "sideEffectingAllowed"],
+      "properties": {
+        "allowedProviderIds": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 200 }
+        },
+        "allowedToolIds": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 200 }
+        },
+        "allowedRiskClasses": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "enum": ["read", "compute", "action", "financial"]
+          }
+        },
+        "sideEffectingAllowed": { "type": "boolean" }
+      }
+    },
+    "spendLimit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["currency", "maxPerCallCents", "maxTotalCents"],
+      "properties": {
+        "currency": { "type": "string", "minLength": 3, "maxLength": 8 },
+        "maxPerCallCents": { "type": "integer", "minimum": 0 },
+        "maxTotalCents": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "chainBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["rootGrantHash", "parentGrantHash", "depth", "maxDelegationDepth"],
+      "properties": {
+        "rootGrantHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "parentGrantHash": { "type": ["string", "null"], "pattern": "^[0-9a-f]{64}$" },
+        "depth": { "type": "integer", "minimum": 0 },
+        "maxDelegationDepth": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "validity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["issuedAt", "notBefore", "expiresAt"],
+      "properties": {
+        "issuedAt": { "type": "string", "format": "date-time" },
+        "notBefore": { "type": "string", "format": "date-time" },
+        "expiresAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "revocation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["revocable", "revokedAt", "revocationReasonCode"],
+      "properties": {
+        "revocable": { "type": "boolean" },
+        "revokedAt": { "type": ["string", "null"], "format": "date-time" },
+        "revocationReasonCode": { "type": ["string", "null"], "maxLength": 120 }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "grantHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+  }
+}