settld 0.1.1 → 0.1.5

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

@@ -0,0 +1,151 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AgentReputation.v1.schema.json",
+  "title": "AgentReputation.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "agentId",
+    "tenantId",
+    "trustScore",
+    "riskTier",
+    "totalRuns",
+    "terminalRuns",
+    "createdRuns",
+    "runningRuns",
+    "completedRuns",
+    "failedRuns",
+    "runsWithEvidence",
+    "totalSettlements",
+    "lockedSettlements",
+    "releasedSettlements",
+    "refundedSettlements",
+    "runCompletionRatePct",
+    "evidenceCoverageRatePct",
+    "settlementReleaseRatePct",
+    "avgRunDurationMs",
+    "scoreBreakdown",
+    "computedAt"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "AgentReputation.v1"
+    },
+    "agentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "tenantId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "trustScore": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 100
+    },
+    "riskTier": {
+      "type": "string",
+      "enum": ["low", "guarded", "elevated", "high"]
+    },
+    "totalRuns": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "terminalRuns": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "createdRuns": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "runningRuns": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "completedRuns": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "failedRuns": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "runsWithEvidence": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "totalSettlements": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "lockedSettlements": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "releasedSettlements": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "refundedSettlements": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "runCompletionRatePct": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "maximum": 100
+    },
+    "evidenceCoverageRatePct": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "maximum": 100
+    },
+    "settlementReleaseRatePct": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "maximum": 100
+    },
+    "avgRunDurationMs": {
+      "type": ["integer", "null"],
+      "minimum": 0
+    },
+    "scoreBreakdown": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runQuality", "settlementQuality", "evidenceQuality", "activityScore"],
+      "properties": {
+        "runQuality": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "settlementQuality": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "evidenceQuality": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "activityScore": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        }
+      }
+    },
+    "computedAt": {
+      "type": "string",
+      "format": "date-time"
+    }
+  }
+}

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

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AgentReputation.v2.schema.json",
+  "title": "AgentReputation.v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "agentId",
+    "tenantId",
+    "primaryWindow",
+    "trustScore",
+    "riskTier",
+    "windows",
+    "computedAt"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "AgentReputation.v2"
+    },
+    "agentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "tenantId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "primaryWindow": {
+      "type": "string",
+      "enum": ["7d", "30d", "allTime"]
+    },
+    "trustScore": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 100
+    },
+    "riskTier": {
+      "type": "string",
+      "enum": ["low", "guarded", "elevated", "high"]
+    },
+    "windows": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["7d", "30d", "allTime"],
+      "properties": {
+        "7d": { "$ref": "#/$defs/window" },
+        "30d": { "$ref": "#/$defs/window" },
+        "allTime": { "$ref": "#/$defs/window" }
+      }
+    },
+    "computedAt": {
+      "type": "string",
+      "format": "date-time"
+    }
+  },
+  "$defs": {
+    "scoreBreakdown": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runQuality", "settlementQuality", "evidenceQuality", "activityScore"],
+      "properties": {
+        "runQuality": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "settlementQuality": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "evidenceQuality": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "activityScore": { "type": "integer", "minimum": 0, "maximum": 100 }
+      }
+    },
+    "window": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "trustScore",
+        "riskTier",
+        "totalRuns",
+        "terminalRuns",
+        "createdRuns",
+        "runningRuns",
+        "completedRuns",
+        "failedRuns",
+        "runsWithEvidence",
+        "totalSettlements",
+        "lockedSettlements",
+        "releasedSettlements",
+        "refundedSettlements",
+        "runCompletionRatePct",
+        "evidenceCoverageRatePct",
+        "settlementReleaseRatePct",
+        "avgRunDurationMs",
+        "scoreBreakdown",
+        "computedAt"
+      ],
+      "properties": {
+        "trustScore": { "type": "integer", "minimum": 0, "maximum": 100 },
+        "riskTier": { "type": "string", "enum": ["low", "guarded", "elevated", "high"] },
+        "totalRuns": { "type": "integer", "minimum": 0 },
+        "terminalRuns": { "type": "integer", "minimum": 0 },
+        "createdRuns": { "type": "integer", "minimum": 0 },
+        "runningRuns": { "type": "integer", "minimum": 0 },
+        "completedRuns": { "type": "integer", "minimum": 0 },
+        "failedRuns": { "type": "integer", "minimum": 0 },
+        "runsWithEvidence": { "type": "integer", "minimum": 0 },
+        "totalSettlements": { "type": "integer", "minimum": 0 },
+        "lockedSettlements": { "type": "integer", "minimum": 0 },
+        "releasedSettlements": { "type": "integer", "minimum": 0 },
+        "refundedSettlements": { "type": "integer", "minimum": 0 },
+        "runCompletionRatePct": { "type": ["integer", "null"], "minimum": 0, "maximum": 100 },
+        "evidenceCoverageRatePct": { "type": ["integer", "null"], "minimum": 0, "maximum": 100 },
+        "settlementReleaseRatePct": { "type": ["integer", "null"], "minimum": 0, "maximum": 100 },
+        "avgRunDurationMs": { "type": ["integer", "null"], "minimum": 0 },
+        "scoreBreakdown": { "$ref": "#/$defs/scoreBreakdown" },
+        "computedAt": { "type": "string", "format": "date-time" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AgentRun.v1.schema.json",
+  "title": "AgentRun.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runId", "agentId", "tenantId", "status", "createdAt", "updatedAt"],
+  "properties": {
+    "schemaVersion": { "const": "AgentRun.v1" },
+    "runId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "agentId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "tenantId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "taskType": {
+      "type": ["string", "null"],
+      "maxLength": 200
+    },
+    "inputRef": {
+      "type": ["string", "null"],
+      "maxLength": 500
+    },
+    "status": {
+      "type": "string",
+      "enum": ["created", "running", "completed", "failed"]
+    },
+    "evidenceRefs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 500
+      },
+      "uniqueItems": true,
+      "maxItems": 10000
+    },
+    "metrics": {
+      "type": ["object", "null"],
+      "additionalProperties": true
+    },
+    "failure": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "properties": {
+        "code": { "type": "string", "maxLength": 200 },
+        "message": { "type": "string", "maxLength": 4000 }
+      }
+    },
+    "startedAt": { "type": ["string", "null"], "format": "date-time" },
+    "completedAt": { "type": ["string", "null"], "format": "date-time" },
+    "failedAt": { "type": ["string", "null"], "format": "date-time" },
+    "lastEventId": { "type": ["string", "null"], "maxLength": 200 },
+    "lastChainHash": { "type": ["string", "null"], "maxLength": 500 },
+    "revision": { "type": "integer", "minimum": 0 },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  }
+}

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" }
+  }
+}