@ixo/topic-protocol 0.7.0 → 1.0.0-rc.1

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

@@ -1,318 +1,112 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://topic-protocol.ixo.world/schemas/topic-contract-state.schema.json",
-    "title": "Qi Topic Contract state profile v2",
+    "title": "Qi Topic Contract state profile v3",
     "type": "object",
-    "required": ["version", "profile", "schema", "topicId", "anchor", "manifest", "contracts", "projection", "policy", "bindings", "provenance"],
+    "required": ["version", "profile", "schema", "topicId", "anchor", "manifest", "contracts", "shape", "progress", "projection", "policy", "bindings", "provenance"],
     "properties": {
-        "version": { "const": 2 },
-        "profile": { "const": "qi.topic-contract-state/v2" },
+        "version": { "const": 3 },
+        "profile": { "const": "qi.topic-contract-state/v3" },
         "schema": { "const": "https://topic-protocol.ixo.world/schemas/topic-contract-state.schema.json" },
         "topicId": { "$ref": "#/$defs/topicId" },
-        "anchor": { "$ref": "#/$defs/anchor" },
-        "manifest": { "$ref": "#/$defs/manifest" },
-        "contracts": { "$ref": "#/$defs/contractHeads" },
-        "projection": { "$ref": "#/$defs/projection" },
-        "policy": { "type": "object" },
-        "bindings": { "$ref": "#/$defs/bindings" },
-        "provenance": { "$ref": "#/$defs/provenance" },
-        "extensions": { "type": "object" }
-    },
-    "additionalProperties": false,
-    "$defs": {
-        "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}$" },
-        "entryId": { "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}$" },
-        "eventId": { "type": "string", "pattern": "^\\$" },
-        "roomId": { "type": "string", "pattern": "^!" },
-        "hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
-        "persistedKind": { "type": "string", "enum": ["task", "agent_task", "proposal", "evaluation", "claims", "question", "discussion", "incident"] },
-        "kindRef": {
-            "oneOf": [
-                {
-                    "type": "object",
-                    "required": ["source", "kind"],
-                    "properties": { "source": { "const": "standard" }, "kind": { "$ref": "#/$defs/persistedKind" } },
-                    "additionalProperties": false
-                },
-                {
-                    "type": "object",
-                    "required": ["source", "customId", "label", "baseKind"],
-                    "properties": {
-                        "source": { "const": "custom" },
-                        "customId": { "type": "string", "minLength": 1, "maxLength": 128 },
-                        "label": { "type": "string", "minLength": 1, "maxLength": 80 },
-                        "baseKind": { "$ref": "#/$defs/persistedKind" }
-                    },
-                    "additionalProperties": false
-                }
-            ]
-        },
-        "kindProfileRef": {
-            "type": "object",
-            "required": ["id", "version", "schema", "digest"],
-            "properties": {
-                "id": { "type": "string", "format": "uri" },
-                "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
-                "schema": { "type": "string", "format": "uri" },
-                "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
-            },
-            "additionalProperties": false
-        },
-        "kindResource": {
+        "anchor": {
             "type": "object",
-            "required": ["profile", "type", "id", "version", "value"],
-            "properties": {
-                "profile": { "$ref": "#/$defs/kindProfileRef" },
-                "type": { "type": "string", "minLength": 1, "maxLength": 128 },
-                "id": { "type": "string", "minLength": 1, "maxLength": 512 },
-                "version": { "type": "integer", "minimum": 1 },
-                "value": { "type": "object" }
-            },
+            "required": ["mode", "roomId", "rootEventId", "manifestSource"],
+            "properties": { "mode": { "enum": ["native", "adopted"] }, "roomId": { "type": "string", "pattern": "^!" }, "rootEventId": { "type": "string", "pattern": "^\\$" }, "manifestSource": { "enum": ["root-event", "state-event"] } },
             "additionalProperties": false
         },
-        "anchor": {
-            "oneOf": [
-                {
-                    "type": "object",
-                    "required": ["mode", "roomId", "rootEventId", "manifestSource"],
-                    "properties": {
-                        "mode": { "const": "native" },
-                        "roomId": { "$ref": "#/$defs/roomId" },
-                        "rootEventId": { "$ref": "#/$defs/eventId" },
-                        "manifestSource": { "const": "root-event" }
-                    },
-                    "additionalProperties": false
-                },
-                {
-                    "type": "object",
-                    "required": ["mode", "roomId", "rootEventId", "manifestSource"],
-                    "properties": {
-                        "mode": { "const": "adopted" },
-                        "roomId": { "$ref": "#/$defs/roomId" },
-                        "rootEventId": { "$ref": "#/$defs/eventId" },
-                        "manifestSource": { "const": "state-event" }
-                    },
-                    "additionalProperties": false
-                }
-            ]
-        },
         "manifest": {
             "type": "object",
-            "required": ["version", "id", "title", "kind", "status", "createdBy", "createdAt"],
+            "required": ["version", "id", "title", "kind", "status", "createdBy", "createdAt", "baseRecipe", "shapeDigest"],
             "properties": {
-                "version": { "const": 2 },
-                "id": { "$ref": "#/$defs/topicId" },
-                "title": { "type": "string", "minLength": 1, "maxLength": 280 },
-                "kind": { "$ref": "#/$defs/persistedKind" },
-                "status": { "type": "string", "enum": ["draft", "active", "waiting", "blocked", "resolved", "archived", "redirected"] },
-                "createdBy": { "type": "string", "minLength": 1 },
-                "createdAt": { "type": "string", "format": "date-time" }
+                "version": { "const": 3 }, "id": { "$ref": "#/$defs/topicId" }, "title": { "type": "string", "minLength": 1, "maxLength": 280 },
+                "kind": { "type": "string", "minLength": 1 }, "status": { "enum": ["draft", "active", "waiting", "blocked", "resolved", "archived", "redirected"] },
+                "createdBy": { "type": "string", "minLength": 1 }, "createdAt": { "type": "string", "format": "date-time" },
+                "baseRecipe": { "enum": ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"] },
+                "topicRecipeRef": { "type": "object" }, "shapeDigest": { "$ref": "#/$defs/digest" }
             },
             "additionalProperties": true
         },
-        "provenance": {
+        "contracts": { "type": "object" },
+        "shape": {
             "type": "object",
-            "required": ["basis", "acceptance", "sourceEventIds"],
+            "required": ["digest", "sources"],
             "properties": {
-                "basis": { "type": "string", "enum": ["explicit", "contextual", "inferred", "suggested", "retrieved"] },
-                "acceptance": { "type": "string", "enum": ["proposed", "accepted", "rejected", "superseded"] },
-                "sourceEventIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/eventId" } },
-                "createdBy": { "type": "string", "minLength": 1 },
-                "createdAt": { "type": "string", "format": "date-time" }
+                "digest": { "$ref": "#/$defs/digest" },
+                "sources": { "type": "array", "minItems": 1, "items": { "type": "object", "required": ["kind", "id", "version", "digest"], "properties": { "kind": { "enum": ["base-recipe", "topic-recipe", "kind", "topic"] }, "id": { "type": "string", "format": "uri" }, "version": { "type": "string" }, "digest": { "$ref": "#/$defs/digest" } }, "additionalProperties": false } }
             },
             "additionalProperties": false
         },
-        "statement": {
+        "progress": {
             "type": "object",
-            "required": ["id", "text", "provenance"],
+            "required": ["version", "topicId", "topicRevision", "contractRevision", "shapeDigest", "phase", "condition", "reasonCode", "axisStates", "stateTags", "candidates", "provenance"],
             "properties": {
-                "id": { "$ref": "#/$defs/entryId" },
-                "text": { "type": "string", "minLength": 1, "maxLength": 4000 },
-                "provenance": { "$ref": "#/$defs/provenance" }
+                "version": { "const": 1 }, "topicId": { "$ref": "#/$defs/topicId" }, "topicRevision": { "type": "string" }, "contractRevision": { "type": "string" },
+                "shapeDigest": { "$ref": "#/$defs/digest" }, "phase": { "$ref": "#/$defs/phase" }, "condition": { "$ref": "#/$defs/condition" }, "reasonCode": { "type": "string" },
+                "axisStates": { "type": "object", "additionalProperties": { "type": "string" } }, "stateTags": { "type": "array", "items": { "type": "object" } },
+                "candidates": { "type": "array", "items": { "type": "object" } }, "provenance": { "type": "array", "items": { "type": "string" } }, "block": { "type": "object" }
             },
             "additionalProperties": false
         },
-        "temporalTarget": {
-            "oneOf": [
-                {
-                    "type": "object",
-                    "required": ["precision", "value", "timezone"],
-                    "properties": {
-                        "precision": { "const": "date" },
-                        "value": { "type": "string", "format": "date" },
-                        "timezone": { "type": "string", "minLength": 1, "maxLength": 128 }
-                    },
-                    "additionalProperties": false
-                },
-                {
-                    "type": "object",
-                    "required": ["precision", "value", "timezone"],
-                    "properties": {
-                        "precision": { "const": "datetime" },
-                        "value": { "type": "string", "format": "date-time" },
-                        "timezone": { "type": "string", "minLength": 1, "maxLength": 128 }
-                    },
-                    "additionalProperties": false
-                }
-            ]
-        },
-        "criterion": {
-            "type": "object",
-            "required": ["id", "description", "status"],
-            "properties": {
-                "id": { "$ref": "#/$defs/entryId" },
-                "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
-                "status": { "type": "string", "enum": ["pending", "met", "not_met", "waived"] },
-                "verification": { "type": "object" }
-            },
-            "additionalProperties": false
-        },
-        "outcome": {
-            "type": "object",
-            "properties": {
-                "statement": { "$ref": "#/$defs/statement" },
-                "status": { "type": "string", "enum": ["proposed", "accepted", "achieved", "abandoned"] },
-                "target": { "$ref": "#/$defs/temporalTarget" },
-                "successCriteria": { "type": "array", "maxItems": 50, "items": { "$ref": "#/$defs/criterion" } },
-                "outcomeRecordId": { "type": "string", "minLength": 1 },
-                "abandonedReason": { "type": "string", "minLength": 1, "maxLength": 2000 }
-            },
-            "additionalProperties": false
-        },
-        "risk": {
-            "type": "object",
-            "required": ["id", "description", "status"],
-            "properties": {
-                "id": { "$ref": "#/$defs/entryId" },
-                "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
-                "impact": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
-                "status": { "type": "string", "enum": ["open", "mitigated", "accepted", "closed"] },
-                "owner": { "type": "string", "minLength": 1 },
-                "mitigation": { "type": "string", "minLength": 1, "maxLength": 2000 }
-            },
-            "additionalProperties": false
-        },
-        "appearance": {
-            "type": "object",
-            "properties": {
-                "glyph": {
-                    "oneOf": [
-                        { "type": "object", "required": ["type", "value"], "properties": { "type": { "const": "emoji" }, "value": { "type": "string", "minLength": 1, "maxLength": 16 } }, "additionalProperties": false },
-                        { "type": "object", "required": ["type", "name"], "properties": { "type": { "const": "icon" }, "name": { "type": "string", "enum": ["task", "agent", "proposal", "evaluation", "claims", "question", "discussion", "incident"] } }, "additionalProperties": false }
-                    ]
-                }
-            },
-            "additionalProperties": false
-        },
-        "contractBody": {
+        "projection": {
             "type": "object",
-            "required": ["version", "revision", "status", "kindRef", "authoredBy", "authoredAt", "workingMode", "recipe"],
+            "required": ["revision", "contractRevision", "title", "status", "kindRef", "attachmentCount", "operationCount"],
             "properties": {
-                "version": { "const": 2 },
-                "revision": { "type": "string", "minLength": 1 },
-                "status": { "type": "string", "enum": ["draft", "accepted", "superseded"] },
-                "kindRef": { "$ref": "#/$defs/kindRef" },
-                "kindProfile": { "$ref": "#/$defs/kindProfileRef" },
-                "kindResource": { "$ref": "#/$defs/kindResource" },
-                "authoredBy": { "type": "string", "minLength": 1 },
-                "authoredAt": { "type": "string", "format": "date-time" },
-                "workingMode": { "type": "string", "enum": ["solo", "team", "client"] },
-                "recipe": { "type": "string", "enum": ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"] },
-                "locale": { "type": "string", "minLength": 2, "maxLength": 32 },
-                "timezone": { "type": "string", "minLength": 1, "maxLength": 128 },
-                "temporalMode": { "type": "string", "enum": ["finite", "ongoing"] },
-                "tags": { "type": "array", "uniqueItems": true, "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 80 } },
-                "appearance": { "$ref": "#/$defs/appearance" },
-                "intent": { "$ref": "#/$defs/statement" },
-                "outcome": { "$ref": "#/$defs/outcome" },
-                "completion": { "type": "object" },
-                "ownerId": { "type": "string", "minLength": 1 },
-                "scope": { "type": "object" },
-                "constraints": { "type": "array", "maxItems": 50, "items": { "$ref": "#/$defs/statement" } },
-                "assumptions": { "type": "array", "maxItems": 50, "items": { "type": "object" } },
-                "questions": { "type": "array", "maxItems": 50, "items": { "type": "object" } },
-                "risks": { "type": "array", "maxItems": 50, "items": { "$ref": "#/$defs/risk" } },
-                "participants": { "type": "array", "maxItems": 100, "items": { "type": "object" } },
-                "roles": { "type": "array", "maxItems": 50, "items": { "type": "object" } },
-                "agents": { "type": "array", "maxItems": 20, "items": { "type": "object" } },
-                "decision": { "type": "object" },
-                "plan": { "type": "object" },
-                "attachments": { "type": "array", "maxItems": 100, "items": { "type": "object" } }
+                "revision": { "type": "string", "minLength": 1 }, "contractRevision": { "type": "string", "minLength": 1 }, "title": { "type": "string", "minLength": 1 },
+                "status": { "enum": ["draft", "active", "waiting", "blocked", "resolved", "archived", "redirected"] }, "kindRef": { "type": "object" },
+                "attachmentCount": { "type": "integer", "minimum": 0 }, "operationCount": { "type": "integer", "minimum": 0 },
+                "claimBinding": { "type": "object", "required": ["entityDid", "collectionId"], "properties": { "entityDid": { "type": "string" }, "collectionId": { "type": "string" } }, "additionalProperties": false },
+                "claimResolution": { "type": "object", "required": ["entityDid", "collectionId", "protocolDid", "rubric"], "properties": { "entityDid": { "type": "string" }, "collectionId": { "type": "string" }, "protocolDid": { "type": "string" }, "rubric": { "type": "object" } }, "additionalProperties": false }
             },
             "additionalProperties": true
         },
-        "contractRef": {
+        "policy": { "type": "object" },
+        "bindings": {
             "type": "object",
-            "required": ["revision", "bodyHash", "bodyRef"],
             "properties": {
-                "revision": { "type": "string", "minLength": 1 },
-                "bodyHash": { "$ref": "#/$defs/hash" },
-                "bodyRef": { "type": "object" },
-                "body": { "$ref": "#/$defs/contractBody" }
-            },
-            "additionalProperties": true
-        },
-        "effectiveContractRef": {
-            "allOf": [
-                { "$ref": "#/$defs/contractRef" },
-                {
-                    "type": "object",
-                    "required": ["acceptedBy", "acceptedAt"],
-                    "properties": {
-                        "acceptedBy": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
-                        "acceptedAt": { "type": "string", "format": "date-time" }
+                "flows": { "type": "array", "items": { "$ref": "https://topic-protocol.ixo.world/schemas/topic-flow-binding.schema.json" } },
+                "context": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "required": ["type", "id"],
+                        "properties": {
+                            "type": { "enum": ["ixo.resource", "ixo.flow", "matrix.conversation", "ixo.entity", "ixo.service"] },
+                            "id": { "type": "string", "minLength": 1 },
+                            "label": { "type": "string" }
+                        },
+                        "additionalProperties": false
+                    }
+                },
+                "udidReferences": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "required": ["id", "role"],
+                        "properties": {
+                            "id": { "type": "string", "minLength": 1 },
+                            "role": { "enum": ["evaluation", "decision", "effect", "settlement"] },
+                            "digest": { "$ref": "#/$defs/digest" }
+                        },
+                        "additionalProperties": false
                     }
                 }
-            ]
-        },
-        "contractHeads": {
-            "type": "object",
-            "properties": { "proposed": { "$ref": "#/$defs/contractRef" }, "effective": { "$ref": "#/$defs/effectiveContractRef" } },
-            "additionalProperties": false
-        },
-        "projection": {
-            "type": "object",
-            "required": ["revision", "title", "status", "kindRef", "attachmentCount", "operationCount"],
-            "properties": {
-                "revision": { "type": "string", "minLength": 1 },
-                "title": { "type": "string", "minLength": 1, "maxLength": 280 },
-                "status": { "type": "string", "enum": ["draft", "active", "waiting", "blocked", "resolved", "archived", "redirected"] },
-                "kindRef": { "$ref": "#/$defs/kindRef" },
-                "kindProfile": { "$ref": "#/$defs/kindProfileRef" },
-                "appearance": { "$ref": "#/$defs/appearance" },
-                "attachmentCount": { "type": "integer", "minimum": 0 },
-                "operationCount": { "type": "integer", "minimum": 0 }
             },
-            "additionalProperties": true
+            "additionalProperties": false
         },
-        "recurrence": {
+        "provenance": { "type": "object" }, "extensions": { "type": "object" }
+    },
+    "additionalProperties": false,
+    "$defs": {
+        "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}$" },
+        "phase": { "enum": ["forming", "working", "verifying", "deciding", "effecting", "settling", "complete", "dormant"] },
+        "condition": { "enum": ["on-track", "needs-input", "needs-acceptance", "waiting", "blocked", "failed", "disputed", "degraded"] },
+        "temporalTarget": {
             "oneOf": [
-                { "type": "object", "required": ["frequency", "time", "timezone"], "properties": { "frequency": { "const": "daily" }, "time": { "type": "string", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$" }, "timezone": { "type": "string", "minLength": 1 } }, "additionalProperties": false },
-                { "type": "object", "required": ["frequency", "days", "time", "timezone"], "properties": { "frequency": { "const": "weekly" }, "days": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"] } }, "time": { "type": "string", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$" }, "timezone": { "type": "string", "minLength": 1 } }, "additionalProperties": false }
+                { "type": "object", "required": ["precision", "value", "timezone"], "properties": { "precision": { "const": "date" }, "value": { "type": "string", "format": "date" }, "timezone": { "type": "string" } }, "additionalProperties": false },
+                { "type": "object", "required": ["precision", "value", "timezone"], "properties": { "precision": { "const": "datetime" }, "value": { "type": "string", "format": "date-time" }, "timezone": { "type": "string" } }, "additionalProperties": false }
             ]
-        },
-        "automation": {
-            "type": "object",
-            "required": ["provider", "scheduleId", "actionId", "recurrence", "status"],
-            "properties": {
-                "provider": { "const": "temporal" },
-                "scheduleId": { "type": "string", "minLength": 1 },
-                "actionId": { "type": "string", "minLength": 1 },
-                "recurrence": { "$ref": "#/$defs/recurrence" },
-                "status": { "type": "string", "enum": ["pending", "active", "paused", "failed"] },
-                "nextRunAt": { "type": "string", "format": "date-time" }
-            },
-            "additionalProperties": false
-        },
-        "bindings": {
-            "type": "object",
-            "properties": {
-                "governanceProposal": { "type": "object" },
-                "claims": { "type": "object" },
-                "automations": { "type": "array", "maxItems": 20, "items": { "$ref": "#/$defs/automation" } },
-                "context": { "type": "array", "maxItems": 100, "items": { "type": "object" } }
-            },
-            "additionalProperties": false
         }
     }
 }

package/dist/schemas/topic-flow-binding.schema.json

@@ -0,0 +1,28 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/topic-flow-binding.schema.json",
+    "title": "Topic Flow Binding v1",
+    "type": "object",
+    "required": ["version", "bindingId", "topicId", "flowUri", "flowRevision", "flowDigest", "role", "actionManifestDigest", "controllerDid", "startPolicy", "triggerPolicy", "receiptPolicy", "status", "capability", "capabilityReferences", "createdBy", "createdAt"],
+    "properties": {
+        "version": { "const": 1 },
+        "bindingId": { "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}$" },
+        "flowUri": { "type": "string", "pattern": "^ixo:flow:" },
+        "flowRevision": { "type": "string", "minLength": 1 },
+        "flowDigest": { "$ref": "#/$defs/digest" },
+        "role": { "enum": ["primary", "supporting"] },
+        "actionManifestDigest": { "$ref": "#/$defs/digest" },
+        "controllerDid": { "type": "string", "pattern": "^did:" },
+        "startPolicy": { "enum": ["manual", "on-topic-active", "scheduled", "event"] },
+        "triggerPolicy": { "type": "object" },
+        "receiptPolicy": { "enum": ["all", "terminal"] },
+        "status": { "enum": ["pending", "active", "paused", "closed", "failed"] },
+        "capability": { "type": "string", "minLength": 1 },
+        "capabilityReferences": { "type": "array", "minItems": 2, "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+        "createdBy": { "type": "string", "pattern": "^did:" },
+        "createdAt": { "type": "string", "format": "date-time" }
+    },
+    "additionalProperties": false,
+    "$defs": { "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }
+}

package/dist/schemas/topic-kind-profile.schema.json

@@ -5,7 +5,7 @@
     "type": "object",
     "required": ["version", "id", "profileVersion", "label", "kind", "resource", "acceptance", "projection", "presentation"],
     "properties": {
-        "version": { "const": 1 },
+        "version": { "enum": [1, 2] },
         "id": { "type": "string", "format": "uri" },
         "profileVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
         "label": { "type": "string", "minLength": 1, "maxLength": 80 },
@@ -76,7 +76,37 @@
             "uniqueItems": true,
             "maxItems": 20,
             "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+        },
+        "actionManifest": {
+            "type": "object",
+            "required": ["version", "digest"],
+            "properties": {
+                "version": { "type": "string", "minLength": 1, "maxLength": 40 },
+                "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+            },
+            "additionalProperties": false
+        },
+        "actions": {
+            "type": "array",
+            "uniqueItems": true,
+            "maxItems": 50,
+            "items": {
+                "type": "object",
+                "required": ["type", "role"],
+                "properties": {
+                    "type": { "type": "string", "pattern": "^qi/[a-z0-9]+(?:[._-][a-z0-9]+)*$" },
+                    "role": { "enum": ["primary", "supporting"] },
+                    "label": { "type": "string", "minLength": 1, "maxLength": 80 }
+                },
+                "additionalProperties": false
+            }
         }
     },
-    "additionalProperties": false
+    "additionalProperties": false,
+    "allOf": [
+        {
+            "if": { "properties": { "version": { "const": 2 } }, "required": ["version"] },
+            "then": { "properties": { "actionManifest": true, "actions": true }, "required": ["actionManifest", "actions"] }
+        }
+    ]
 }

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", "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"] },
+        "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-flow", "update-flow-binding", "unbind-flow", "request-action", "cancel-action", "record-action-receipt", "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", "bind-external-work", "sync-external-work", "unlink-external-work", "submit-delivery", "record-delivery-decision", "record-evaluation", "record-approval", "record-claim", "record-settlement"] }
+                    "type": { "enum": ["propose-contract", "update-contract", "accept-contract", "supersede-contract", "bind-automation", "update-automation", "pause-automation", "remove-automation", "bind-flow", "update-flow-binding", "unbind-flow", "request-action", "cancel-action", "record-action-receipt", "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-recipe.schema.json

@@ -0,0 +1,19 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://topic-protocol.ixo.world/schemas/topic-recipe.schema.json",
+    "title": "Topic Recipe v1",
+    "type": "object",
+    "required": ["version", "code", "id", "recipeVersion", "label", "description", "baseRecipe", "creates", "shape"],
+    "properties": {
+        "version": { "const": 1 },
+        "code": { "enum": ["research-brief", "agent-delivery", "verified-work-payment"] },
+        "id": { "type": "string", "format": "uri" },
+        "recipeVersion": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "description": { "type": "string", "minLength": 1 },
+        "baseRecipe": { "enum": ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"] },
+        "creates": { "const": "draft" },
+        "shape": { "$ref": "https://topic-protocol.ixo.world/schemas/topic-shape.schema.json" }
+    },
+    "additionalProperties": false
+}

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

@@ -5,7 +5,7 @@
     "type": "object",
     "required": ["version", "id", "title", "status", "createdBy", "createdAt"],
     "properties": {
-        "version": { "enum": [1, 2] },
+        "version": { "enum": [1, 2, 3] },
         "id": { "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}$" },
         "title": { "type": "string", "minLength": 1, "maxLength": 280 },
         "kind": { "type": "string", "enum": ["discussion", "question", "decision", "proposal", "task", "incident", "flow", "agent_task", "evaluation", "claims"] },
@@ -25,6 +25,18 @@
                 "additionalProperties": false
             }
         },
+        "baseRecipe": { "enum": ["project", "flow", "proposal", "evaluation", "claims", "research", "discussion", "incident"] },
+        "topicRecipeRef": {
+            "type": "object",
+            "required": ["id", "version", "digest"],
+            "properties": {
+                "id": { "type": "string", "format": "uri" },
+                "version": { "type": "string", "minLength": 1 },
+                "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+            },
+            "additionalProperties": false
+        },
+        "shapeDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
         "overview": {
             "type": "object",
             "required": ["summary"],
@@ -49,6 +61,10 @@
         {
             "if": { "properties": { "version": { "const": 2 } }, "required": ["version"] },
             "then": { "properties": { "kind": true }, "required": ["kind"] }
+        },
+        {
+            "if": { "properties": { "version": { "const": 3 } }, "required": ["version"] },
+            "then": { "properties": { "kind": true, "baseRecipe": true, "shapeDigest": true }, "required": ["kind", "baseRecipe", "shapeDigest"] }
         }
     ]
 }