settld 0.1.2 → 0.2.0

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

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AgentEvent.v1.schema.json",
+  "title": "AgentEvent.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "v", "id", "streamId", "type", "at", "actor", "payload"],
+  "properties": {
+    "schemaVersion": { "const": "AgentEvent.v1" },
+    "v": { "const": 1 },
+    "id": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "streamId": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 128,
+      "pattern": "^[A-Za-z0-9:_-]+$"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["RUN_CREATED", "RUN_STARTED", "RUN_HEARTBEAT", "EVIDENCE_ADDED", "RUN_COMPLETED", "RUN_FAILED"]
+    },
+    "at": { "type": "string", "format": "date-time" },
+    "actor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "id"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["agent", "system", "ops"]
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        }
+      }
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "payloadHash": { "type": ["string", "null"], "maxLength": 500 },
+    "prevChainHash": { "type": ["string", "null"], "maxLength": 500 },
+    "chainHash": { "type": ["string", "null"], "maxLength": 500 },
+    "signature": { "type": ["string", "null"], "maxLength": 2000 },
+    "signerKeyId": { "type": ["string", "null"], "maxLength": 200 }
+  }
+}

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

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AgentIdentity.v1.schema.json",
+  "title": "AgentIdentity.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "agentId",
+    "tenantId",
+    "displayName",
+    "status",
+    "owner",
+    "keys",
+    "capabilities",
+    "createdAt",
+    "updatedAt"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "AgentIdentity.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:_-]+$"
+    },
+    "displayName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 4000
+    },
+    "status": {
+      "type": "string",
+      "enum": ["active", "suspended", "revoked"]
+    },
+    "owner": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ownerType", "ownerId"],
+      "properties": {
+        "ownerType": {
+          "type": "string",
+          "enum": ["human", "business", "service"]
+        },
+        "ownerId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        }
+      }
+    },
+    "keys": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["keyId", "algorithm", "publicKeyPem"],
+      "properties": {
+        "keyId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "algorithm": {
+          "type": "string",
+          "enum": ["ed25519"]
+        },
+        "publicKeyPem": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "maxItems": 256,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 128
+      }
+    },
+    "walletPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "maxPerTransactionCents": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "maxDailyCents": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "requireApprovalAboveCents": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "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/AgentPassport.v1.schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AgentPassport.v1.schema.json",
+  "title": "AgentPassport.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "passportId",
+    "agentId",
+    "tenantId",
+    "principalRef",
+    "identityAnchors",
+    "delegationRoot",
+    "policyEnvelope",
+    "status",
+    "createdAt",
+    "updatedAt"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "AgentPassport.v1" },
+    "passportId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "agentId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "principalRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["principalType", "principalId"],
+      "properties": {
+        "principalType": {
+          "type": "string",
+          "enum": ["human", "business", "service", "dao"]
+        },
+        "principalId": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "jurisdiction": { "type": "string", "maxLength": 64 }
+      }
+    },
+    "identityAnchors": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["jwksUri", "activeKeyId", "keysetHash"],
+      "properties": {
+        "did": { "type": "string", "maxLength": 512 },
+        "jwksUri": { "type": "string", "format": "uri", "pattern": "^https://" },
+        "activeKeyId": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "keysetHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }
+      }
+    },
+    "delegationRoot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["rootGrantId", "rootGrantHash", "issuedAt", "expiresAt", "revokedAt"],
+      "properties": {
+        "rootGrantId": { "type": "string", "minLength": 1, "maxLength": 200 },
+        "rootGrantHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "issuedAt": { "type": "string", "format": "date-time" },
+        "expiresAt": { "type": ["string", "null"], "format": "date-time" },
+        "revokedAt": { "type": ["string", "null"], "format": "date-time" }
+      }
+    },
+    "capabilityCredentials": {
+      "type": "array",
+      "maxItems": 512,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["credentialType", "issuer", "credentialRef", "credentialHash", "issuedAt", "expiresAt"],
+        "properties": {
+          "credentialType": { "type": "string", "minLength": 1, "maxLength": 120 },
+          "issuer": { "type": "string", "minLength": 1, "maxLength": 200 },
+          "credentialRef": { "type": "string", "minLength": 1, "maxLength": 512 },
+          "credentialHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+          "issuedAt": { "type": "string", "format": "date-time" },
+          "expiresAt": { "type": ["string", "null"], "format": "date-time" }
+        }
+      }
+    },
+    "policyEnvelope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxPerCallCents", "maxDailyCents", "allowedRiskClasses", "requireApprovalAboveCents"],
+      "properties": {
+        "maxPerCallCents": { "type": "integer", "minimum": 0 },
+        "maxDailyCents": { "type": "integer", "minimum": 0 },
+        "allowedRiskClasses": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "enum": ["read", "compute", "action", "financial"]
+          }
+        },
+        "requireApprovalAboveCents": { "type": ["integer", "null"], "minimum": 0 },
+        "allowlistRefs": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1, "maxLength": 200 }
+        }
+      }
+    },
+    "status": {
+      "type": "string",
+      "enum": ["active", "suspended", "revoked"]
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  }
+}

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