@plurnk/plurnk-contracts 1.7.0 → 1.9.0

package/dist/plurnk.qwen.gbnf

@@ -45,29 +45,32 @@ section-body-b40 ::= ("#" section-body-b1 | [ PLANFDRETCOYMVSXBWK] section-body-
 section-body-b41 ::= ("#" section-body-b1 | [ PANFIDRETCOYMVSXBWK] section-body-b0 | "L" section-body-b42 | [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7F# PLANFIDRETCOYMVSXBWK] section-body-b0)?
 section-body-b42 ::= ("#" section-body-b1 | [ PANFIDRETCOYMVSXBWK] section-body-b0 | [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7F# PLANFIDRETCOYMVSXBWK] section-body-b0)?
 section-body-ne ::= "#" section-body-b1 | [ PLANFIDRETCOYMVSXBWK] section-body-b0 | [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7F# PLANFIDRETCOYMVSXBWK] section-body-b0
+annotation-body-b0 ::= ("-" annotation-body-b1 | ">" annotation-body-b0 | [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7F\n\r>-] annotation-body-b0)?
+annotation-body-b1 ::= ("-" annotation-body-b2 | ">" annotation-body-b0 | [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7F\n\r>-] annotation-body-b0)?
+annotation-body-b2 ::= ("-" annotation-body-b2 | [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7F\n\r>-] annotation-body-b0)?
+annotation-body-ne ::= "-" annotation-body-b1 | ">" annotation-body-b0 | [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7F\n\r>-] annotation-body-b0
 pattern-body-ne ::= [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7F\n\r:#] [^\x00-\x08\x0B-\x0C\x0E-\x1F\x7F\n\r]*
 log-selection ::= (curation-tags-slot log-target-slot? | log-target-slot)?
-plan ::= "# PLAN0" "\n" section-body-ne "\n\n"
-find ::= "## FIND0" add-tags-slot? target-slot line-slot? "\n\n" | "## FIND0" add-tags-slot? target-slot line-slot? "\n" pattern-body-ne "\n\n"
-read ::= "## READ0" add-tags-slot? target-slot text-line-slot? "\n\n" | "## READ0" add-tags-slot? target-slot text-line-slot? "\n" pattern-body-ne "\n\n"
-edit ::= "## EDIT0" add-tags-slot? target-slot text-line-slot? "\n\n" | "## EDIT0" add-tags-slot? target-slot text-line-slot? "\n" section-body-ne "\n\n"
-copy ::= "## COPY0" add-tags-slot? target-slot text-line-slot? "\n" section-body-ne "\n\n"
-move ::= "## MOVE0" add-tags-slot? target-slot text-line-slot? "\n" section-body-ne "\n\n"
-open ::= "## OPEN0" log-selection "\n\n" | "## OPEN0" log-selection "\n" pattern-body-ne "\n\n"
-fold ::= "## FOLD0" log-selection "\n\n" | "## FOLD0" log-selection "\n" pattern-body-ne "\n\n"
-exec ::= "## EXEC0" exec-slot? target-slot? line-slot? "\n\n" | "## EXEC0" exec-slot? target-slot? line-slot? "\n" section-body-ne "\n\n"
-bare ::= "## BARE0" add-tags-slot? "\n" section-body-ne "\n\n"
-work ::= "## WORK0" branch-slot? target-slot "\n" section-body-ne "\n\n"
-fork ::= "## FORK0" branch-slot? target-slot "\n" section-body-ne "\n\n"
-kill ::= "## KILL0" kill-slot? target-slot "\n\n"
-send-mid ::= "## SEND0" status-mid-slot target-slot? "\n\n" | "## SEND0" status-mid-slot target-slot? "\n" section-body-ne "\n\n" | "## SEND0" target-slot? "\n\n" | "## SEND0" target-slot? "\n" section-body-ne "\n\n"
-send-102 ::= "## SEND0 [102]" target-slot? "\n" section-body-ne
-send-200 ::= "## SEND0 [200]" target-slot? "\n" section-body-ne
-send-202 ::= "## SEND0 [202]" target-slot? park-slot? "\n" section-body-ne
-send-300 ::= "## SEND0 [300]" target-slot? "\n" section-body-ne
-send-499 ::= "## SEND0 [499]" target-slot? "\n" section-body-ne
-send-final-any ::= send-102 | send-200 | send-202 | send-300 | send-499
-send-final-first ::= send-200 | send-202 | send-300 | send-499
+plan ::= "# PLAN0" annotation-slot? "\n" section-body-ne "\n"
+find ::= "## FIND0" add-tags-slot? target-slot line-slot? annotation-slot? "\n" | "## FIND0" add-tags-slot? target-slot line-slot? annotation-slot? "\n" pattern-body-ne "\n"
+read ::= "## READ0" add-tags-slot? target-slot text-line-slot? annotation-slot? "\n" | "## READ0" add-tags-slot? target-slot text-line-slot? annotation-slot? "\n" pattern-body-ne "\n"
+edit ::= "## EDIT0" add-tags-slot? target-slot text-line-slot? annotation-slot? "\n" | "## EDIT0" add-tags-slot? target-slot text-line-slot? annotation-slot? "\n" section-body-ne "\n"
+copy ::= "## COPY0" add-tags-slot? target-slot text-line-slot? annotation-slot? "\n" section-body-ne "\n"
+move ::= "## MOVE0" add-tags-slot? target-slot text-line-slot? annotation-slot? "\n" section-body-ne "\n"
+open ::= "## OPEN0" log-selection text-line-slot? annotation-slot? "\n" | "## OPEN0" log-selection text-line-slot? annotation-slot? "\n" pattern-body-ne "\n"
+fold ::= "## FOLD0" log-selection text-line-slot? annotation-slot? "\n" | "## FOLD0" log-selection text-line-slot? annotation-slot? "\n" pattern-body-ne "\n"
+exec ::= "## EXEC0" exec-slot? target-slot? line-slot? annotation-slot? "\n" | "## EXEC0" exec-slot? target-slot? line-slot? annotation-slot? "\n" section-body-ne "\n"
+bare ::= "## BARE0" add-tags-slot? annotation-slot? "\n" section-body-ne "\n"
+work ::= "## WORK0" branch-slot? target-slot annotation-slot? "\n" section-body-ne "\n"
+fork ::= "## FORK0" branch-slot? target-slot annotation-slot? "\n" section-body-ne "\n"
+kill ::= "## KILL0" kill-slot? target-slot annotation-slot? "\n"
+send-mid ::= "## SEND0" status-mid-slot target-slot? annotation-slot? "\n" | "## SEND0" status-mid-slot target-slot? annotation-slot? "\n" section-body-ne "\n" | "## SEND0" target-slot? annotation-slot? "\n" | "## SEND0" target-slot? annotation-slot? "\n" section-body-ne "\n"
+send-102 ::= "## SEND0 [102]" target-slot? annotation-slot? "\n" section-body-ne
+send-200 ::= "## SEND0 [200]" target-slot? annotation-slot? "\n" section-body-ne
+send-202 ::= "## SEND0 [202]" target-slot? park-slot? annotation-slot? "\n" section-body-ne
+send-499 ::= "## SEND0 [499]" target-slot? annotation-slot? "\n" section-body-ne
+send-final-any ::= send-102 | send-200 | send-202 | send-499
+send-final-first ::= send-200 | send-202 | send-499
 op-statement ::= find | read | edit | copy | move | open | fold | exec | bare | work | fork | kill
 tail-0 ::= send-mid tail-1 | op-statement tail-1 | send-final-first
 tail-1 ::= send-mid tail-2 | op-statement tail-2 | send-final-any
@@ -115,10 +118,11 @@ branch-slot ::= " " branch
 kill-slot ::= " " kill-sig
 status-mid-slot ::= " [" status-mid "]"
 park-slot ::= " " park
+annotation-slot ::= " <!-- " annotation-body-ne " -->"
 status-mid ::= [05-9] [0-9] [0-9] | "1" status-mid-1 | "2" status-mid-2 | "3" status-mid-3 | "4" status-mid-4
 status-mid-1 ::= "0" [0-13-9] | [1-9] [0-9]
 status-mid-2 ::= "0" [13-9] | [1-9] [0-9]
-status-mid-3 ::= "0" [1-9] | [1-9] [0-9]
+status-mid-3 ::= "0" [0-9] | [1-9] [0-9]
 status-mid-4 ::= "9" [0-8] | [0-8] [0-9]
 add-tags ::= "[" add-tag add-tag-rest* "]"
 curation-tags ::= "[" curation-term curation-term-rest* "]"

package/dist/schema/A2aAgentDefinition.json

@@ -0,0 +1,44 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/A2aAgentDefinition.json",
+    "title": "A2aAgentDefinition",
+    "description": "One outbound A2A agent as the Worker Functionality coordinator persists it: the local alias, the remote base URL whose standard Agent Card is authoritative, and optional local connection facts. Secrets stay symbolic environment references.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["name", "url"],
+    "properties": {
+        "name": {
+            "description": "The local alias: the `a2a://<name>` authority.",
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "url": {
+            "description": "The remote agent's absolute HTTP(S) base URL; its Agent Card is discovered at the standard well-known path unless `cardPath` names another.",
+            "type": "string",
+            "pattern": "^https?://"
+        },
+        "cardPath": {
+            "description": "An absolute URL pathname replacing the standard Agent Card path.",
+            "type": "string",
+            "pattern": "^/[^?#]*$"
+        },
+        "headers": {
+            "description": "Extra request headers; values may be symbolic `${NAME}` environment references.",
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+        },
+        "authorization": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["type", "token"],
+            "properties": {
+                "type": { "const": "bearer" },
+                "token": {
+                    "description": "A symbolic `${NAME}` environment reference; the secret is never persisted.",
+                    "type": "string",
+                    "pattern": "^\\$\\{[A-Za-z_][A-Za-z0-9_]*\\}$"
+                }
+            }
+        }
+    }
+}

package/dist/schema/AcpPlan.json

@@ -0,0 +1,63 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/AcpPlan.json",
+    "$comment": "ACP v1 Plan, pinned to schema-v1.21.0 / 272bf799f35a258c6a4107a0410ed361e83683d3.",
+    "title": "AcpPlan",
+    "description": "The standards-facing ACP v1 execution plan.",
+    "type": "object",
+    "properties": {
+        "entries": {
+            "description": "The complete list of current plan entries.",
+            "type": "array",
+            "items": { "$ref": "#/$defs/AcpPlanEntry" }
+        },
+        "_meta": {
+            "description": "Metadata reserved by ACP. Consumers must not assume meanings for its keys.",
+            "type": ["object", "null"],
+            "additionalProperties": true
+        }
+    },
+    "required": ["entries"],
+    "$defs": {
+        "AcpPlanEntry": {
+            "description": "One task or goal in an ACP execution plan.",
+            "type": "object",
+            "properties": {
+                "content": {
+                    "description": "Human-readable description of what this task aims to accomplish.",
+                    "type": "string"
+                },
+                "priority": {
+                    "description": "The relative importance of this task.",
+                    "$ref": "#/$defs/AcpPlanEntryPriority"
+                },
+                "status": {
+                    "description": "The current execution status of this task.",
+                    "$ref": "#/$defs/AcpPlanEntryStatus"
+                },
+                "_meta": {
+                    "description": "Metadata reserved by ACP. Consumers must not assume meanings for its keys.",
+                    "type": ["object", "null"],
+                    "additionalProperties": true
+                }
+            },
+            "required": ["content", "priority", "status"]
+        },
+        "AcpPlanEntryPriority": {
+            "description": "ACP v1 priority levels.",
+            "oneOf": [
+                { "type": "string", "const": "high" },
+                { "type": "string", "const": "medium" },
+                { "type": "string", "const": "low" }
+            ]
+        },
+        "AcpPlanEntryStatus": {
+            "description": "ACP v1 plan-entry lifecycle states.",
+            "oneOf": [
+                { "type": "string", "const": "pending" },
+                { "type": "string", "const": "in_progress" },
+                { "type": "string", "const": "completed" }
+            ]
+        }
+    }
+}

package/dist/schema/AguiClientConformance.json

@@ -0,0 +1,74 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/AguiClientConformance.json",
+    "title": "AguiClientConformance",
+    "description": "One client's exhaustive, evidence-bearing disposition for an installed AG-UI discovery surface.",
+    "type": "object",
+    "required": ["schemaVersion", "client", "actions", "notifications"],
+    "additionalProperties": false,
+    "properties": {
+        "schemaVersion": { "const": 1 },
+        "client": { "type": "string", "minLength": 1 },
+        "actions": {
+            "type": "object",
+            "propertyNames": { "type": "string", "minLength": 1 },
+            "additionalProperties": { "$ref": "#/$defs/disposition" }
+        },
+        "notifications": {
+            "type": "object",
+            "propertyNames": { "type": "string", "minLength": 1 },
+            "additionalProperties": { "$ref": "#/$defs/disposition" }
+        }
+    },
+    "$defs": {
+        "evidence": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": { "type": "string", "minLength": 1 }
+        },
+        "dimensions": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": {
+                "enum": [
+                    "admission",
+                    "projection",
+                    "framing",
+                    "success",
+                    "failure",
+                    "lifecycle",
+                    "durability",
+                    "composition",
+                    "presentation"
+                ]
+            }
+        },
+        "disposition": {
+            "oneOf": [
+                {
+                    "type": "object",
+                    "required": ["posture", "dimensions", "evidence"],
+                    "additionalProperties": false,
+                    "properties": {
+                        "posture": { "enum": ["native", "generic"] },
+                        "dimensions": { "$ref": "#/$defs/dimensions" },
+                        "evidence": { "$ref": "#/$defs/evidence" }
+                    }
+                },
+                {
+                    "type": "object",
+                    "required": ["posture", "reason", "dimensions", "evidence"],
+                    "additionalProperties": false,
+                    "properties": {
+                        "posture": { "const": "unsupported" },
+                        "reason": { "type": "string", "minLength": 1 },
+                        "dimensions": { "$ref": "#/$defs/dimensions" },
+                        "evidence": { "$ref": "#/$defs/evidence" }
+                    }
+                }
+            ]
+        }
+    }
+}

package/dist/schema/AguiConformanceKit.json

@@ -0,0 +1,111 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/AguiConformanceKit.json",
+    "title": "AguiConformanceKit",
+    "description": "Language-neutral raw SSE and AG-UI lifecycle specimens consumed by every Plurnk client.",
+    "type": "object",
+    "required": ["schemaVersion", "transport", "lifecycles"],
+    "additionalProperties": false,
+    "properties": {
+        "schemaVersion": { "const": 1 },
+        "transport": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/transportSpecimen" }
+        },
+        "lifecycles": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/lifecycleSpecimen" }
+        }
+    },
+    "$defs": {
+        "name": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+        },
+        "event": {
+            "type": "object",
+            "required": ["type"],
+            "properties": { "type": { "type": "string", "minLength": 1 } },
+            "additionalProperties": true
+        },
+        "transportSpecimen": {
+            "type": "object",
+            "required": ["name", "chunks", "eof", "expect"],
+            "additionalProperties": false,
+            "properties": {
+                "name": { "$ref": "#/$defs/name" },
+                "chunks": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": { "type": "string", "minLength": 1 }
+                },
+                "eof": { "type": "boolean" },
+                "expect": {
+                    "oneOf": [
+                        {
+                            "type": "object",
+                            "required": ["events"],
+                            "additionalProperties": false,
+                            "properties": {
+                                "events": {
+                                    "type": "array",
+                                    "items": { "$ref": "#/$defs/event" }
+                                }
+                            }
+                        },
+                        {
+                            "type": "object",
+                            "required": ["error"],
+                            "additionalProperties": false,
+                            "properties": {
+                                "error": { "enum": ["invalid-json"] }
+                            }
+                        }
+                    ]
+                }
+            }
+        },
+        "actionExpectation": {
+            "type": "object",
+            "required": ["kind", "ok"],
+            "additionalProperties": false,
+            "properties": {
+                "kind": { "type": "string", "minLength": 1 },
+                "ok": { "type": "boolean" },
+                "status": { "type": "integer", "minimum": 100, "maximum": 599 }
+            }
+        },
+        "lifecycleExpectation": {
+            "type": "object",
+            "required": ["completion", "families"],
+            "additionalProperties": false,
+            "properties": {
+                "completion": { "enum": ["success", "interrupt", "error", "dead-stream"] },
+                "families": {
+                    "type": "array",
+                    "uniqueItems": true,
+                    "items": { "type": "string", "minLength": 1 }
+                },
+                "status": { "type": "integer", "minimum": 100, "maximum": 599 },
+                "interrupt": { "enum": ["proposal", "interaction"] },
+                "action": { "$ref": "#/$defs/actionExpectation" }
+            }
+        },
+        "lifecycleSpecimen": {
+            "type": "object",
+            "required": ["name", "events", "expect"],
+            "additionalProperties": false,
+            "properties": {
+                "name": { "$ref": "#/$defs/name" },
+                "events": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": { "$ref": "#/$defs/event" }
+                },
+                "expect": { "$ref": "#/$defs/lifecycleExpectation" }
+            }
+        }
+    }
+}

package/dist/schema/AguiDiscovery.json

@@ -0,0 +1,70 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/AguiDiscovery.json",
+    "title": "AguiDiscovery",
+    "description": "The complete installed AG-UI+ management and notification surface. Action and notification names are object keys so identity has one representation.",
+    "type": "object",
+    "required": ["schemaVersion", "actions", "notifications", "display"],
+    "additionalProperties": false,
+    "properties": {
+        "schemaVersion": {
+            "const": 1
+        },
+        "actions": {
+            "type": "object",
+            "propertyNames": {
+                "type": "string",
+                "minLength": 1
+            },
+            "additionalProperties": {
+                "$ref": "#/$defs/action"
+            }
+        },
+        "notifications": {
+            "type": "object",
+            "propertyNames": {
+                "type": "string",
+                "minLength": 1
+            },
+            "additionalProperties": {
+                "$ref": "#/$defs/notification"
+            }
+        },
+        "display": {
+            "$ref": "https://schemas.plurnk.xyz/v0/ClientDisplayCapabilities.json"
+        }
+    },
+    "$defs": {
+        "jsonSchema": {
+            "type": "object",
+            "description": "A JSON Schema 2020-12 schema supplied by the contract owner.",
+            "additionalProperties": true
+        },
+        "action": {
+            "type": "object",
+            "required": ["scope", "inputSchema", "outputSchema"],
+            "additionalProperties": false,
+            "properties": {
+                "scope": {
+                    "enum": ["worldless", "workspace", "worker"]
+                },
+                "inputSchema": {
+                    "$ref": "#/$defs/jsonSchema"
+                },
+                "outputSchema": {
+                    "$ref": "#/$defs/jsonSchema"
+                }
+            }
+        },
+        "notification": {
+            "type": "object",
+            "required": ["payloadSchema"],
+            "additionalProperties": false,
+            "properties": {
+                "payloadSchema": {
+                    "$ref": "#/$defs/jsonSchema"
+                }
+            }
+        }
+    }
+}

package/dist/schema/ClientDisplayCapabilities.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/ClientDisplayCapabilities.json",
+    "$id": "https://schemas.plurnk.xyz/v0/ClientDisplayCapabilities.json",
     "title": "ClientDisplayCapabilities",
     "description": "The installed scheme and MIME capability identities with optional opaque client presentation metadata.",
     "type": "array",

package/dist/schema/ClientInteractionProjection.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/ClientInteractionProjection.json",
+    "$id": "https://schemas.plurnk.xyz/v0/ClientInteractionProjection.json",
     "title": "ClientInteractionProjection",
     "description": "The runtime-neutral client-interface projection of one pending client interaction. Live delivery and reconnect discovery expose this same shape.",
     "type": "object",
@@ -11,6 +11,6 @@
         "workerId": { "type": "integer", "minimum": 1 },
         "loopId": { "type": "integer", "minimum": 1 },
         "turnId": { "type": "integer", "minimum": 1 },
-        "request": { "$ref": "https://schemas.plurnk.dev/v0/ClientInteractionRequest.json" }
+        "request": { "$ref": "https://schemas.plurnk.xyz/v0/ClientInteractionRequest.json" }
     }
 }

package/dist/schema/ClientInteractionRequest.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/ClientInteractionRequest.json",
+    "$id": "https://schemas.plurnk.xyz/v0/ClientInteractionRequest.json",
     "title": "ClientInteractionRequest",
     "description": "A runtime-neutral request for one client-owned interaction. The owner supplies the standard tool presentation and response contract; protocol-private continuation state is excluded.",
     "type": "object",

package/dist/schema/ClientInteractionResolution.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/ClientInteractionResolution.json",
+    "$id": "https://schemas.plurnk.xyz/v0/ClientInteractionResolution.json",
     "title": "ClientInteractionResolution",
     "description": "The client response that settles one pending interaction. A cancelled interaction carries no fabricated payload.",
     "oneOf": [

package/dist/schema/ClientStatement.json

@@ -1,10 +1,10 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/ClientStatement.json",
+    "$id": "https://schemas.plurnk.xyz/v0/ClientStatement.json",
     "title": "ClientStatement",
     "description": "The client-tier AST returned by PlurnkParser.parseClient: the closed protocol PlurnkStatement union plus read-shaped LOOK and BUFF utility statements.",
     "oneOf": [
-        { "$ref": "https://schemas.plurnk.dev/v0/PlurnkStatement.json" },
+        { "$ref": "https://schemas.plurnk.xyz/v0/PlurnkStatement.json" },
         { "$ref": "#/$defs/LookStatement" },
         { "$ref": "#/$defs/BuffStatement" }
     ],
@@ -15,40 +15,44 @@
                 { "type": "null" }
             ]
         },
+        "AnnotationOrNull": {
+            "type": ["string", "null"]
+        },
         "PathOrNull": {
             "oneOf": [
-                { "$ref": "https://schemas.plurnk.dev/v0/ParsedPath.json" },
+                { "$ref": "https://schemas.plurnk.xyz/v0/ParsedPath.json" },
                 { "type": "null" }
             ]
         },
         "LineMarkerOrNull": {
             "oneOf": [
-                { "$ref": "https://schemas.plurnk.dev/v0/LineMarker.json" },
+                { "$ref": "https://schemas.plurnk.xyz/v0/LineMarker.json" },
                 { "type": "null" }
             ]
         },
         "TextLineMarkerOrNull": {
             "oneOf": [
-                { "$ref": "https://schemas.plurnk.dev/v0/TextLineMarker.json" },
+                { "$ref": "https://schemas.plurnk.xyz/v0/TextLineMarker.json" },
                 { "type": "null" }
             ]
         },
         "MatcherBodyOrNull": {
             "oneOf": [
-                { "$ref": "https://schemas.plurnk.dev/v0/MatcherBody.json" },
+                { "$ref": "https://schemas.plurnk.xyz/v0/MatcherBody.json" },
                 { "type": "null" }
             ]
         },
         "PositionRef": {
-            "$ref": "https://schemas.plurnk.dev/v0/Position.json"
+            "$ref": "https://schemas.plurnk.xyz/v0/Position.json"
         },
         "LookStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "LOOK" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/TagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/TextLineMarkerOrNull" },
@@ -58,11 +62,12 @@
         },
         "BuffStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "BUFF" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/TagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/LineMarkerOrNull" },

package/dist/schema/EntryReadResult.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/EntryReadResult.json",
+    "$id": "https://schemas.plurnk.xyz/v0/EntryReadResult.json",
     "title": "EntryReadResult",
     "description": "The runtime-neutral result of reading one client-visible entry, either completely or as one channel suffix.",
     "oneOf": [
@@ -23,7 +23,7 @@
                     "minimum": 400,
                     "maximum": 599
                 },
-                "problem": { "$ref": "https://schemas.plurnk.dev/v0/ProblemDetails.json" },
+                "problem": { "$ref": "https://schemas.plurnk.xyz/v0/ProblemDetails.json" },
                 "entry": { "type": "null" }
             }
         }

package/dist/schema/FunctionalityCandidate.json

@@ -0,0 +1,33 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/FunctionalityCandidate.json",
+    "title": "FunctionalityCandidate",
+    "description": "One inert discovery result: an exact family definition with its provenance. Discovery never installs, persists, enables, or executes it.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["definition", "provenance"],
+    "properties": {
+        "alias": {
+            "description": "The alias the candidate would take if added; a suggestion, never authority.",
+            "type": "string",
+            "minLength": 1
+        },
+        "summary": {
+            "type": "string"
+        },
+        "definition": {
+            "description": "The exact family definition, conforming to the family's definition schema.",
+            "type": "object"
+        },
+        "provenance": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "source"],
+            "properties": {
+                "kind": { "type": "string", "minLength": 1 },
+                "source": { "type": "string", "minLength": 1 },
+                "reference": { "type": "string", "minLength": 1 }
+            }
+        }
+    }
+}