settld 0.1.2 → 0.1.5

package/docs/spec/examples/verify_about_output_v1.example.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": "VerifyAboutOutput.v1",
+  "tool": {
+    "name": "settld-verify",
+    "version": "0.0.0",
+    "commit": "0123456789abcdef"
+  },
+  "protocol": {
+    "canonicalJson": "RFC8785",
+    "objects": [
+      "ProofBundleManifest.v1",
+      "FinancePackBundleManifest.v1",
+      "BundleHeadAttestation.v1",
+      "VerificationReport.v1",
+      "VerifyCliOutput.v1",
+      "VerifyAboutOutput.v1"
+    ]
+  },
+  "defaults": {
+    "strict": false,
+    "hashConcurrency": 16
+  },
+  "features": {
+    "format": ["human", "json"],
+    "failOnWarnings": true,
+    "hashConcurrency": true
+  }
+}
+

package/docs/spec/examples/verify_cli_output_v1.example.json

@@ -0,0 +1,13 @@
+{
+  "schemaVersion": "VerifyCliOutput.v1",
+  "tool": { "name": "settld-verify", "version": "0.0.0", "commit": "0123456789abcdef0123456789abcdef01234567" },
+  "mode": { "strict": false, "failOnWarnings": false },
+  "target": { "kind": "job-proof", "input": "/path/to/bundle", "resolved": "/path/to/bundle", "dir": "/path/to/bundle" },
+  "ok": true,
+  "verificationOk": true,
+  "errors": [],
+  "warnings": [
+    { "code": "VERIFICATION_REPORT_MISSING_LENIENT", "path": "verify/verification_report.json", "message": null, "detail": null }
+  ],
+  "summary": { "tenantId": "tenant_default", "period": null, "type": "JobProofBundle.v1", "manifestHash": "0000000000000000000000000000000000000000000000000000000000000000" }
+}

package/docs/spec/legacy/MarketplaceAcceptance.v1.md

@@ -0,0 +1,48 @@
+# MarketplaceAcceptance.v1
+
+Legacy note: `MarketplaceAcceptance.v1` is retained for historical artifacts only. New integrations should use `MarketplaceAcceptance.v2` (`rfqId` field) and treat `v1` as read-only.
+
+`MarketplaceAcceptance.v1` is the canonical acceptance artifact for one selected `MarketplaceOffer.v1`.
+
+It binds acceptance metadata (`acceptedBy`, proposal identity, chain hash, counts) to a stable `offerRef` (`offerId`, `offerHash`) and emits `acceptanceHash`.
+
+## Purpose
+
+- make acceptance independently replayable from the agreement envelope;
+- explicitly bind acceptance to a hashed offer artifact;
+- provide a stable acceptance hash for signatures/audit and downstream dispute traces.
+
+## Required fields
+
+- `schemaVersion` (const: `MarketplaceAcceptance.v1`)
+- `acceptanceId`
+- `tenantId`
+- `taskId`
+- `runId`
+- `bidId`
+- `acceptedAt`
+- `acceptedByAgentId`
+- `acceptedProposalId`
+- `acceptedRevision`
+- `acceptedProposalHash`
+- `offerChainHash`
+- `proposalCount`
+- `offerRef` (`offerId`, `offerHash`)
+- `createdAt`
+- `acceptanceHash`
+
+Optional fields:
+
+- `agreementId`
+
+## Canonicalization and hashing
+
+`acceptanceHash` is computed over canonical JSON after removing `acceptanceHash`:
+
+1. canonicalize JSON with RFC 8785 (JCS),
+2. hash canonical UTF-8 bytes using `sha256`,
+3. encode as lowercase hex.
+
+## Schema
+
+See `schemas/MarketplaceAcceptance.v1.schema.json`.

package/docs/spec/legacy/MarketplaceOffer.v1.md

@@ -0,0 +1,56 @@
+# MarketplaceOffer.v1
+
+Legacy note: `MarketplaceOffer.v1` is retained for historical artifacts only. New integrations should use `MarketplaceOffer.v2` (`rfqId` field) and treat `v1` as read-only.
+
+`MarketplaceOffer.v1` is the canonical pre-contract offer artifact derived from a `MarketplaceBidProposal.v1` chain.
+
+It freezes the selected proposal terms before agreement acceptance so downstream systems can bind acceptance, signatures, and settlement to one immutable offer hash.
+
+## Purpose
+
+- separate pre-contract offer state from agreement state;
+- make accepted proposal terms portable and replayable;
+- provide a stable `offerHash` anchor for `MarketplaceAcceptance.v1`.
+
+## Required fields
+
+- `schemaVersion` (const: `MarketplaceOffer.v1`)
+- `offerId`
+- `tenantId`
+- `taskId`
+- `bidId`
+- `revision`
+- `amountCents`
+- `currency`
+- `proposalHash`
+- `proposedAt`
+- `createdAt`
+- `offerHash`
+
+Optional fields:
+
+- `runId`
+- `proposalId`
+- `proposerAgentId`
+- `etaSeconds`
+- `note`
+- `verificationMethod`
+- `policy`
+- `policyRef`
+- `policyRefHash`
+- `prevProposalHash`
+- `offerChainHash`
+- `proposalCount`
+- `metadata`
+
+## Canonicalization and hashing
+
+`offerHash` is computed over canonical JSON after removing `offerHash`:
+
+1. canonicalize JSON with RFC 8785 (JCS),
+2. hash canonical UTF-8 bytes using `sha256`,
+3. encode as lowercase hex.
+
+## Schema
+
+See `schemas/MarketplaceOffer.v1.schema.json`.

package/docs/spec/legacy/schemas/MarketplaceAcceptance.v1.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/MarketplaceAcceptance.v1.schema.json",
+  "title": "MarketplaceAcceptance.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "acceptanceId",
+    "tenantId",
+    "taskId",
+    "runId",
+    "bidId",
+    "agreementId",
+    "acceptedAt",
+    "acceptedByAgentId",
+    "acceptedProposalId",
+    "acceptedRevision",
+    "acceptedProposalHash",
+    "offerChainHash",
+    "proposalCount",
+    "offerRef",
+    "createdAt",
+    "acceptanceHash"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "MarketplaceAcceptance.v1" },
+    "acceptanceId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "taskId": { "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/legacy/schemas/MarketplaceOffer.v1.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/MarketplaceOffer.v1.schema.json",
+  "title": "MarketplaceOffer.v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "offerId",
+    "tenantId",
+    "taskId",
+    "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.v1" },
+    "offerId": { "type": "string", "minLength": 1, "maxLength": 300 },
+    "tenantId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9:_-]+$" },
+    "taskId": { "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}$" }
+  }
+}

package/docs/spec/producer-error-codes.v1.txt

@@ -0,0 +1,14 @@
+PRODUCE_FAILED
+SIGNER_AUTH_FAILED
+SIGNER_AUTH_MISSING
+SIGNER_BAD_RESPONSE
+SIGNER_MESSAGE_TOO_LARGE
+SIGNER_PLUGIN_INIT_FAILED
+SIGNER_PLUGIN_INVALID_PROVIDER
+SIGNER_PLUGIN_LOAD_FAILED
+SIGNER_PLUGIN_MISSING_EXPORT
+SIGNER_RESPONSE_TOO_LARGE
+SIGNER_TIMEOUT
+SIGNER_UNREACHABLE
+VERIFY_AFTER_FAILED
+

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

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AcceptanceCriteria.v1.schema.json",
+  "title": "AcceptanceCriteria.v1",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "criteria"],
+  "properties": {
+    "schemaVersion": { "const": "AcceptanceCriteria.v1" },
+    "generatedAt": { "type": "string" },
+    "criteria": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["criterionId", "kind"],
+        "properties": {
+          "criterionId": { "type": "string" },
+          "kind": { "enum": ["PROOF_STATUS_EQUALS", "SLA_OVERALL_OK"] },
+          "expectedStatus": { "type": "string" }
+        }
+      }
+    }
+  }
+}
+

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

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://settld.local/schemas/AcceptanceEvaluation.v1.schema.json",
+  "title": "AcceptanceEvaluation.v1",
+  "type": "object",
+  "required": ["schemaVersion", "generatedAt", "overallStatus", "results"],
+  "properties": {
+    "schemaVersion": { "const": "AcceptanceEvaluation.v1" },
+    "generatedAt": { "type": "string" },
+    "overallStatus": { "enum": ["ok", "fail", "unknown"] },
+    "results": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["criterionId", "kind", "status", "detail"],
+        "properties": {
+          "criterionId": { "type": "string" },
+          "kind": { "type": "string" },
+          "status": { "enum": ["ok", "fail", "unknown"] },
+          "detail": {}
+        }
+      }
+    }
+  }
+}
+

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