@ixo/topic-protocol 0.6.0 → 0.7.0

package/README.md

@@ -9,7 +9,7 @@ identity of a discussion.
 
 ## Status
 
-**Version:** 0.6.0
+**Version:** 0.7.0
 
 **Maturity:** Draft implementation candidate  
 **Execution source of truth:** [Linear Topic Protocol project](https://linear.app/ixo-world/project/topic-protocol-4ea58bc7910d)
@@ -40,7 +40,7 @@ key-value adapter at its integration boundary.
 
 The package includes:
 
-- strict Draft 2020-12 validation for all 20 contracts, including Kind Profiles and Job Cards;
+- strict Draft 2020-12 validation for all 29 contracts, including Kind Profiles, Job Cards, external work, delivery, evaluation, claims, and settlement receipts;
 - pinned, declarative Kind Profiles with safe standard-Kind fallback;
 - deterministic Topic-index reconciliation, structured search, and personal ranking;
 - deterministic Topic projection from a root and authorised operations;
@@ -50,6 +50,8 @@ The package includes:
 - restart-safe two-event Topic creation with duplicate suppression;
 - append-only Matrix operation parsing and room-upgrade anchor selection;
 - explicit conflict, duplicate-delivery, unauthorised, and unreachable handling;
+- governed external-work bindings and immutable Delivery Packet handoff with separate evaluation, approval, claim, and settlement axes;
+- fail-closed settlement projection that cannot promote tracker completion into approval or payment;
 - immutable caller inputs and typed protocol errors.
 
 Topics retain a singular conversational `kind` while linking any number of

package/dist/schemas/approval-decision.schema.json

@@ -0,0 +1,30 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/approval-decision.schema.json",
+    "title": "Outcome approval decision v1",
+    "type": "object",
+    "required": ["version", "approvalId", "topicId", "deliveryPacketId", "deliveryPacketDigest", "evaluationIds", "decision", "policy", "decidedBy", "decidedAt", "capability", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "approvalId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "deliveryPacketDigest": { "$ref": "#/$defs/digest" },
+        "evaluationIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/uuidV7" } },
+        "decision": { "enum": ["approved", "rejected", "changes_requested", "superseded"] },
+        "reasons": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1, "maxLength": 2000 } },
+        "policy": { "type": "object", "required": ["ref", "version", "digest"], "properties": { "ref": { "type": "string", "format": "uri" }, "version": { "type": "string", "minLength": 1 }, "digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false },
+        "decidedBy": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" } },
+        "decidedAt": { "type": "string", "format": "date-time" },
+        "capability": { "type": "string", "minLength": 1 },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+    },
+    "additionalProperties": false,
+    "allOf": [{ "if": { "properties": { "decision": { "enum": ["rejected", "changes_requested"] } }, "required": ["decision"] }, "then": { "properties": { "reasons": { "type": "array", "minItems": 1 } }, "required": ["reasons"] } }]
+}

package/dist/schemas/claim-record.schema.json

@@ -0,0 +1,30 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/claim-record.schema.json",
+    "title": "Outcome claim record v1",
+    "type": "object",
+    "required": ["version", "claimId", "topicId", "deliveryPacketId", "deliveryPacketDigest", "evaluationIds", "approvalId", "claimantDid", "requested", "status", "replayKey", "source", "recordedAt", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "claimId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "deliveryPacketDigest": { "$ref": "#/$defs/digest" },
+        "evaluationIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/uuidV7" } },
+        "approvalId": { "$ref": "#/$defs/uuidV7" },
+        "claimantDid": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "requested": { "type": "object", "required": ["amount", "asset", "recipient"], "properties": { "amount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" }, "asset": { "type": "string", "minLength": 1, "maxLength": 128 }, "recipient": { "type": "string", "minLength": 1, "maxLength": 256 } }, "additionalProperties": false },
+        "status": { "enum": ["pending", "approved", "rejected", "disputed", "invalidated", "flagged"] },
+        "replayKey": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "source": { "type": "object", "required": ["provider", "ref"], "properties": { "provider": { "type": "string", "pattern": "^[a-z][a-z0-9.-]{0,63}$" }, "ref": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
+        "recordedAt": { "type": "string", "format": "date-time" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/delivery-decision.schema.json

@@ -0,0 +1,28 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/delivery-decision.schema.json",
+    "title": "Delivery handoff decision v1",
+    "type": "object",
+    "required": ["version", "decisionId", "topicId", "deliveryPacketId", "deliveryPacketDigest", "decision", "decidedBy", "decidedAt", "capability", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "decisionId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "deliveryPacketDigest": { "$ref": "#/$defs/digest" },
+        "decision": { "enum": ["accepted", "returned", "rejected"] },
+        "reasons": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1, "maxLength": 2000 } },
+        "decidedBy": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "decidedAt": { "type": "string", "format": "date-time" },
+        "capability": { "type": "string", "minLength": 1 },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+    },
+    "additionalProperties": false,
+    "allOf": [{ "if": { "properties": { "decision": { "enum": ["returned", "rejected"] } }, "required": ["decision"] }, "then": { "properties": { "reasons": { "type": "array", "minItems": 1 } }, "required": ["reasons"] } }]
+}

package/dist/schemas/delivery-packet.schema.json

@@ -0,0 +1,58 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/delivery-packet.schema.json",
+    "title": "Delivery Packet v1",
+    "type": "object",
+    "required": ["version", "deliveryPacketId", "sequence", "topicId", "bindingId", "contract", "workItemSnapshot", "deliverables", "evidence", "traces", "submittedBy", "submittedAt", "capability", "status", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "sequence": { "type": "integer", "minimum": 1 },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "bindingId": { "$ref": "#/$defs/uuidV7" },
+        "supersedes": { "$ref": "#/$defs/uuidV7" },
+        "contract": {
+            "type": "object",
+            "required": ["revision", "digest", "status"],
+            "properties": {
+                "revision": { "type": "string", "minLength": 1 },
+                "digest": { "$ref": "#/$defs/digest" },
+                "status": { "const": "accepted" }
+            },
+            "additionalProperties": false
+        },
+        "workItemSnapshot": {
+            "type": "object",
+            "required": ["snapshotId", "ref", "digest"],
+            "properties": {
+                "snapshotId": { "$ref": "#/$defs/uuidV7" },
+                "ref": { "type": "string", "format": "uri" },
+                "digest": { "$ref": "#/$defs/digest" }
+            },
+            "additionalProperties": false
+        },
+        "deliverables": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/artifact" } },
+        "evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } },
+        "traces": { "type": "array", "items": { "$ref": "#/$defs/artifact" } },
+        "paymentTerms": {
+            "type": "object",
+            "required": ["ref", "digest"],
+            "properties": { "ref": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" } },
+            "additionalProperties": false
+        },
+        "submittedBy": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "submittedAt": { "type": "string", "format": "date-time" },
+        "capability": { "type": "string", "minLength": 1 },
+        "status": { "const": "submitted" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "artifact": { "type": "object", "required": ["type", "uri", "digest"], "properties": { "type": { "type": "string", "minLength": 1 }, "uri": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" }, "label": { "type": "string", "minLength": 1 }, "mediaType": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
+        "evidence": { "type": "object", "required": ["type", "uri", "digest", "provenanceClass"], "properties": { "type": { "type": "string", "minLength": 1 }, "uri": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" }, "provenanceClass": { "enum": ["claimant_provided", "client_assisted", "server_verified", "third_party_attested"] }, "label": { "type": "string", "minLength": 1 } }, "additionalProperties": false }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/evaluation-assertion.schema.json

@@ -0,0 +1,37 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/evaluation-assertion.schema.json",
+    "title": "Evaluation assertion v1",
+    "type": "object",
+    "required": ["version", "evaluationId", "topicId", "deliveryPacketId", "deliveryPacketDigest", "rubric", "evidenceDigests", "traceDigests", "outcome", "result", "evaluatorDid", "evaluatedAt", "capability", "signature", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "evaluationId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "deliveryPacketDigest": { "$ref": "#/$defs/digest" },
+        "rubric": {
+            "type": "object",
+            "required": ["id", "version", "ref", "digest", "governanceStatus"],
+            "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 }, "ref": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" }, "governanceStatus": { "const": "approved" } },
+            "additionalProperties": false
+        },
+        "evidenceDigests": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/digest" } },
+        "traceDigests": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/digest" } },
+        "outcome": { "enum": ["supported", "refuted", "insufficient_evidence", "human_review", "disputed", "superseded"] },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "result": { "type": "object" },
+        "evaluatorDid": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "evaluatedAt": { "type": "string", "format": "date-time" },
+        "capability": { "type": "string", "minLength": 1 },
+        "signature": { "type": "object", "required": ["type", "verificationMethod", "value"], "properties": { "type": { "type": "string", "minLength": 1 }, "verificationMethod": { "type": "string", "format": "uri" }, "value": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/external-work-binding.schema.json

@@ -0,0 +1,83 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/external-work-binding.schema.json",
+    "title": "External work binding v1",
+    "type": "object",
+    "required": ["version", "bindingId", "topicId", "role", "createdFrom", "external", "syncPolicy", "workState", "checkpoint", "identity", "health", "createdBy", "createdAt"],
+    "properties": {
+        "version": { "const": 1 },
+        "bindingId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "role": { "enum": ["primary", "child", "related", "verification", "delivery"] },
+        "createdFrom": { "enum": ["topic", "external"] },
+        "external": {
+            "type": "object",
+            "required": ["provider", "resourceType", "organizationId", "resourceId", "identifier", "url"],
+            "properties": {
+                "provider": { "type": "string", "pattern": "^[a-z][a-z0-9.-]{0,63}$" },
+                "resourceType": { "type": "string", "minLength": 1, "maxLength": 80 },
+                "organizationId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "teamId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "resourceId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "identifier": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "url": { "type": "string", "format": "uri" }
+            },
+            "additionalProperties": false
+        },
+        "syncPolicy": {
+            "type": "object",
+            "required": ["mode", "direction", "comments", "files", "delete", "fieldPolicy"],
+            "properties": {
+                "mode": { "enum": ["link_only", "governed_projection"] },
+                "direction": { "enum": ["external_to_topic", "topic_to_external", "bidirectional"] },
+                "comments": { "enum": ["none", "explicit_promote"] },
+                "files": { "enum": ["none", "reference_only", "explicit_ingest"] },
+                "delete": { "const": "tombstone" },
+                "fieldPolicy": {
+                    "type": "object",
+                    "required": ["id", "version", "digest"],
+                    "properties": {
+                        "id": { "type": "string", "format": "uri" },
+                        "version": { "type": "integer", "minimum": 1 },
+                        "digest": { "$ref": "#/$defs/digest" }
+                    },
+                    "additionalProperties": false
+                }
+            },
+            "additionalProperties": false
+        },
+        "workState": { "enum": ["planned", "ready", "in_progress", "blocked", "handoff_ready", "handed_off", "cancelled"] },
+        "checkpoint": {
+            "type": "object",
+            "required": ["topicRevision", "syncedAt"],
+            "properties": {
+                "topicRevision": { "type": "string", "minLength": 1 },
+                "effectiveContractDigest": { "$ref": "#/$defs/digest" },
+                "externalUpdatedAt": { "type": "string", "format": "date-time" },
+                "externalSnapshotDigest": { "$ref": "#/$defs/digest" },
+                "lastEventId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "syncedAt": { "type": "string", "format": "date-time" }
+            },
+            "additionalProperties": false
+        },
+        "identity": {
+            "type": "object",
+            "required": ["bridgeDid"],
+            "properties": {
+                "bridgeDid": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+                "externalAppActorId": { "type": "string", "minLength": 1, "maxLength": 256 }
+            },
+            "additionalProperties": false
+        },
+        "health": { "enum": ["up_to_date", "changes_pending", "degraded", "disconnected", "conflicted", "permission_lost"] },
+        "createdBy": { "type": "string", "minLength": 1 },
+        "createdAt": { "type": "string", "format": "date-time" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/external-work-state-map.schema.json

@@ -0,0 +1,29 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/external-work-state-map.schema.json",
+    "title": "External work state mapping profile v1",
+    "type": "object",
+    "required": ["version", "profileId", "provider", "organizationId", "teamId", "mappings"],
+    "properties": {
+        "version": { "const": 1 },
+        "profileId": { "type": "string", "format": "uri" },
+        "provider": { "type": "string", "pattern": "^[a-z][a-z0-9.-]{0,63}$" },
+        "organizationId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "teamId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "mappings": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+                "type": "object",
+                "required": ["workflowStateId", "category", "workState"],
+                "properties": {
+                    "workflowStateId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                    "category": { "enum": ["triage", "backlog", "unstarted", "started", "completed", "canceled"] },
+                    "workState": { "enum": ["planned", "ready", "in_progress", "blocked", "handoff_ready", "handed_off", "cancelled"] }
+                },
+                "additionalProperties": false
+            }
+        }
+    },
+    "additionalProperties": false
+}

package/dist/schemas/settlement-receipt.schema.json

@@ -0,0 +1,53 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/settlement-receipt.schema.json",
+    "title": "Settlement receipt v1",
+    "type": "object",
+    "required": ["version", "settlementId", "topicId", "claimId", "deliveryPacketId", "deliveryPacketDigest", "evaluationIds", "approvalId", "policy", "idempotencyKey", "amount", "asset", "recipient", "paymentRail", "state", "finality", "signerDid", "recordedAt", "capability", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "settlementId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "claimId": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "deliveryPacketId": { "$ref": "#/$defs/uuidV7" },
+        "deliveryPacketDigest": { "$ref": "#/$defs/digest" },
+        "evaluationIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/uuidV7" } },
+        "approvalId": { "$ref": "#/$defs/uuidV7" },
+        "policy": { "type": "object", "required": ["ref", "digest"], "properties": { "ref": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false },
+        "idempotencyKey": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "amount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]+)?$" },
+        "asset": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "recipient": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "paymentRail": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "transactionReference": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "state": { "enum": ["unfunded", "funded", "held", "authorised", "submitted", "confirmed", "failed", "refunded"] },
+        "finality": { "type": "object", "required": ["state"], "properties": { "state": { "enum": ["pending", "confirmed", "failed"] }, "confirmations": { "type": "integer", "minimum": 0 }, "confirmedAt": { "type": "string", "format": "date-time" } }, "additionalProperties": false },
+        "signerDid": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" },
+        "recordedAt": { "type": "string", "format": "date-time" },
+        "capability": { "type": "string", "minLength": 1 },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+    },
+    "additionalProperties": false,
+    "allOf": [
+        {
+            "if": { "properties": { "state": { "const": "confirmed" } }, "required": ["state"] },
+            "then": {
+                "required": ["transactionReference"],
+                "properties": {
+                    "transactionReference": { "type": "string", "minLength": 1, "maxLength": 512 },
+                    "finality": {
+                        "type": "object",
+                        "properties": { "state": { "const": "confirmed" }, "confirmedAt": { "type": "string", "format": "date-time" } },
+                        "required": ["state", "confirmedAt"]
+                    }
+                }
+            }
+        }
+    ]
+}

package/dist/schemas/topic-operation.schema.json

@@ -8,7 +8,7 @@
         "version": { "enum": [1, 2] },
         "operationId": { "type": "string", "minLength": 1 },
         "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
-        "type": { "type": "string", "enum": ["rename", "change-status", "update-overview", "link-context", "unlink-context", "attach-files", "detach-files", "record-decision", "propose-contract", "update-contract", "accept-contract", "supersede-contract", "bind-automation", "update-automation", "pause-automation", "remove-automation", "redirect", "branch", "merge", "resolve-conflict"] },
+        "type": { "type": "string", "enum": ["rename", "change-status", "update-overview", "link-context", "unlink-context", "attach-files", "detach-files", "record-decision", "propose-contract", "update-contract", "accept-contract", "supersede-contract", "bind-automation", "update-automation", "pause-automation", "remove-automation", "bind-external-work", "sync-external-work", "unlink-external-work", "submit-delivery", "record-delivery-decision", "record-evaluation", "record-approval", "record-claim", "record-settlement", "redirect", "branch", "merge", "resolve-conflict"] },
         "previousRevision": { "type": "string", "minLength": 1 },
         "actor": { "type": "string", "minLength": 1 },
         "createdAt": { "type": "string", "format": "date-time" },
@@ -20,7 +20,7 @@
         {
             "if": {
                 "properties": {
-                    "type": { "enum": ["propose-contract", "update-contract", "accept-contract", "supersede-contract", "bind-automation", "update-automation", "pause-automation", "remove-automation"] }
+                    "type": { "enum": ["propose-contract", "update-contract", "accept-contract", "supersede-contract", "bind-automation", "update-automation", "pause-automation", "remove-automation", "bind-external-work", "sync-external-work", "unlink-external-work", "submit-delivery", "record-delivery-decision", "record-evaluation", "record-approval", "record-claim", "record-settlement"] }
                 },
                 "required": ["type"]
             },

package/dist/schemas/topic-state.schema.json

@@ -33,6 +33,20 @@
                 ]
             }
         },
+        "workBridge": {
+            "type": "object",
+            "required": ["bindings", "deliveryPackets", "deliveryDecisions", "evaluations", "approvals", "claims", "settlements"],
+            "properties": {
+                "bindings": { "type": "array", "items": { "type": "object", "required": ["bindingId", "topicId", "workState", "health", "lastOperationId"], "properties": { "bindingId": { "type": "string" }, "topicId": { "type": "string" }, "workState": { "type": "string" }, "health": { "type": "string" }, "lastOperationId": { "type": "string" } } } },
+                "deliveryPackets": { "type": "array", "items": { "$ref": "https://topic-protocol.ixo.world/schemas/delivery-packet.schema.json" } },
+                "deliveryDecisions": { "type": "array", "items": { "$ref": "https://topic-protocol.ixo.world/schemas/delivery-decision.schema.json" } },
+                "evaluations": { "type": "array", "items": { "$ref": "https://topic-protocol.ixo.world/schemas/evaluation-assertion.schema.json" } },
+                "approvals": { "type": "array", "items": { "$ref": "https://topic-protocol.ixo.world/schemas/approval-decision.schema.json" } },
+                "claims": { "type": "array", "items": { "$ref": "https://topic-protocol.ixo.world/schemas/claim-record.schema.json" } },
+                "settlements": { "type": "array", "items": { "$ref": "https://topic-protocol.ixo.world/schemas/settlement-receipt.schema.json" } }
+            },
+            "additionalProperties": false
+        },
         "basedOnEvents": { "type": "array", "items": { "type": "string", "pattern": "^\\$" } },
         "conflicts": { "type": "array", "items": { "type": "string" } }
     },

package/dist/schemas/work-item-snapshot.schema.json

@@ -0,0 +1,73 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/work-item-snapshot.schema.json",
+    "title": "External work item snapshot v1",
+    "type": "object",
+    "required": ["version", "snapshotId", "bindingId", "topicId", "source", "title", "workflowState", "planning", "relations", "attachments", "promotedComments", "sourceCreatedAt", "sourceUpdatedAt", "retrievedAt", "digest"],
+    "properties": {
+        "version": { "const": 1 },
+        "snapshotId": { "$ref": "#/$defs/uuidV7" },
+        "bindingId": { "$ref": "#/$defs/uuidV7" },
+        "topicId": { "$ref": "#/$defs/topicId" },
+        "source": {
+            "type": "object",
+            "required": ["provider", "organizationId", "resourceId", "identifier", "url"],
+            "properties": {
+                "provider": { "type": "string", "pattern": "^[a-z][a-z0-9.-]{0,63}$" },
+                "organizationId": { "type": "string", "minLength": 1 },
+                "teamId": { "type": "string", "minLength": 1 },
+                "resourceId": { "type": "string", "minLength": 1 },
+                "identifier": { "type": "string", "minLength": 1 },
+                "url": { "type": "string", "format": "uri" }
+            },
+            "additionalProperties": false
+        },
+        "title": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "descriptionMarkdown": { "type": "string", "maxLength": 200000 },
+        "workflowState": {
+            "type": "object",
+            "required": ["id", "name", "category", "mappedWorkState", "mappingProfileId", "mappingVersion"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1 },
+                "name": { "type": "string", "minLength": 1 },
+                "category": { "enum": ["triage", "backlog", "unstarted", "started", "completed", "canceled"] },
+                "mappedWorkState": { "enum": ["planned", "ready", "in_progress", "blocked", "handoff_ready", "handed_off", "cancelled"] },
+                "mappingProfileId": { "type": "string", "format": "uri" },
+                "mappingVersion": { "type": "integer", "minimum": 1 }
+            },
+            "additionalProperties": false
+        },
+        "assignee": { "$ref": "#/$defs/externalActor" },
+        "delegate": { "$ref": "#/$defs/externalActor" },
+        "planning": {
+            "type": "object",
+            "required": ["labels"],
+            "properties": {
+                "priority": { "type": "integer", "minimum": 0 },
+                "estimate": { "type": "number", "minimum": 0 },
+                "projectId": { "type": "string", "minLength": 1 },
+                "cycleId": { "type": "string", "minLength": 1 },
+                "dueDate": { "type": "string", "format": "date" },
+                "labels": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+            },
+            "additionalProperties": false
+        },
+        "relations": { "type": "array", "items": { "type": "object", "required": ["type", "resourceId"], "properties": { "type": { "type": "string", "minLength": 1 }, "resourceId": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" } }, "additionalProperties": false } },
+        "attachments": { "type": "array", "items": { "$ref": "#/$defs/sourceReference" } },
+        "promotedComments": { "type": "array", "items": { "$ref": "#/$defs/sourceReference" } },
+        "sourceCreatedAt": { "type": "string", "format": "date-time" },
+        "sourceUpdatedAt": { "type": "string", "format": "date-time" },
+        "retrievedAt": { "type": "string", "format": "date-time" },
+        "sourceEventId": { "type": "string", "minLength": 1 },
+        "digest": { "$ref": "#/$defs/digest" },
+        "extensions": { "type": "object" }
+    },
+    "$defs": {
+        "uuidV7": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "topicId": { "type": "string", "pattern": "^ixo:topic:[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" },
+        "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+        "externalActor": { "type": "object", "required": ["id"], "properties": { "id": { "type": "string", "minLength": 1 }, "displayName": { "type": "string", "minLength": 1 }, "did": { "type": "string", "pattern": "^did:[a-z0-9]+:.+" } }, "additionalProperties": false },
+        "sourceReference": { "type": "object", "required": ["id", "url", "digest"], "properties": { "id": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false }
+    },
+    "additionalProperties": false
+}