@plurnk/plurnk-contracts 1.16.4 → 1.17.0

package/dist/conformance/agui-v1.json

@@ -91,9 +91,9 @@
                         "id": 1,
                         "worker_id": 7,
                         "origin": "model",
-                        "op": "PLAN",
+                        "op": "TASK",
                         "coordinate": "1.1.1",
-                        "tx": { "body": "Work." }
+                        "tx": { "body": { "entries": [{ "content": "Work.", "priority": "medium", "status": "in_progress" }] } }
                     }
                 },
                 {
@@ -559,7 +559,7 @@
                 {
                     "type": "CUSTOM",
                     "name": "plurnk.row",
-                    "value": { "id": 1, "worker_id": 7, "origin": "model", "op": "PLAN" }
+                    "value": { "id": 1, "worker_id": 7, "origin": "model", "op": "TASK", "tx": { "body": { "entries": [] } } }
                 }
             ],
             "expect": {

package/dist/schema/CapabilityProjection.json

@@ -2,15 +2,13 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/CapabilityProjection.json",
     "title": "CapabilityProjection",
-    "description": "The complete worker-level capability-policy cascade and its normalized effective intersection.",
+    "description": "The service and workspace capability policies and their normalized effective intersection.",
     "type": "object",
     "additionalProperties": false,
     "properties": {
         "service": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" },
         "workspace": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" },
-        "workerBound": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" },
-        "worker": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" },
         "effective": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" }
     },
-    "required": ["service", "workspace", "workerBound", "worker", "effective"]
+    "required": ["service", "workspace", "effective"]
 }

package/dist/schema/ClientStatement.json

@@ -2,20 +2,17 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$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.",
+    "description": "The client-tier AST returned by PlurnkParser.parseClient: the closed protocol PlurnkStatement union plus the read-shaped LOOK utility statement.",
     "oneOf": [
         {
             "$ref": "https://schemas.plurnk.xyz/v0/PlurnkStatement.json"
         },
         {
             "$ref": "#/$defs/LookStatement"
-        },
-        {
-            "$ref": "#/$defs/BuffStatement"
         }
     ],
     "$defs": {
-        "AnnotationOrNull": {
+        "AsideOrNull": {
             "type": [
                 "string",
                 "null"
@@ -81,8 +78,7 @@
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "target",
                 "lineMarker",
@@ -94,11 +90,8 @@
                 "op": {
                     "const": "LOOK"
                 },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
                     "$ref": "#/$defs/SchemeMetadataOrNull"
@@ -116,46 +109,6 @@
                     "$ref": "#/$defs/PositionRef"
                 }
             }
-        },
-        "BuffStatement": {
-            "type": "object",
-            "required": [
-                "op",
-                "delimiter",
-                "annotation",
-                "metadata",
-                "target",
-                "lineMarker",
-                "body",
-                "position"
-            ],
-            "additionalProperties": false,
-            "properties": {
-                "op": {
-                    "const": "BUFF"
-                },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
-                },
-                "metadata": {
-                    "$ref": "#/$defs/SchemeMetadataOrNull"
-                },
-                "target": {
-                    "$ref": "#/$defs/PathOrNull"
-                },
-                "lineMarker": {
-                    "$ref": "#/$defs/LineMarkerOrNull"
-                },
-                "body": {
-                    "$ref": "#/$defs/MatcherBodyOrNull"
-                },
-                "position": {
-                    "$ref": "#/$defs/PositionRef"
-                }
-            }
         }
     }
 }

package/dist/schema/FunctionalityDefinitionState.json

@@ -2,13 +2,13 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/FunctionalityDefinitionState.json",
     "title": "FunctionalityDefinitionState",
-    "description": "One managed definition as a Worker sees it: its origin, desired enabledness, and current preparation outcome. Credentials never appear.",
+    "description": "One workspace definition: its origin, desired enabledness, and current preparation outcome. Credentials never appear.",
     "type": "object",
     "additionalProperties": false,
     "required": ["alias", "origin", "state"],
     "properties": {
         "alias": { "type": "string", "minLength": 1 },
-        "origin": { "enum": ["service", "worker"] },
+        "origin": { "enum": ["service", "workspace"] },
         "state": {
             "description": "disabled: available, model-invisible. active: enabled and prepared. unavailable: enabled but preparation has an exact Problem. authorization-required: enabled and awaiting a protocol continuation.",
             "enum": ["disabled", "active", "unavailable", "authorization-required"]

package/dist/schema/LineMarker.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/LineMarker.json",
     "title": "LineMarker",
-    "description": "The ordered numeric components parsed from a `<scope>` slot. AstBuilder converts each lexical number to a JavaScript number; the operation owner assigns arity and meaning, including text coordinates, result positions, timing, mutation anchors, and an optional leading semantic threshold.",
+    "description": "The ordered numeric components parsed from a `<scope>` slot. AstBuilder converts each lexical number to a JavaScript number; the operation owner assigns arity and meaning, including text coordinates, result positions, timing, and mutation anchors.",
     "type": "object",
     "required": ["marks"],
     "additionalProperties": false,

package/dist/schema/LoopPolicy.json

@@ -2,12 +2,11 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/LoopPolicy.json",
     "title": "LoopPolicy",
-    "description": "The complete immutable policy snapshot for one loop. Capability admission precedes proposal disposition.",
+    "description": "The immutable proposal disposition for one loop. Workspace capability admission precedes proposals.",
     "type": "object",
-    "required": ["capabilities", "proposals"],
+    "required": ["proposals"],
     "additionalProperties": false,
     "properties": {
-        "capabilities": { "$ref": "https://schemas.plurnk.xyz/v0/CapabilityPolicy.json" },
         "proposals": { "enum": ["review", "accept", "reject"] }
     }
 }

package/dist/schema/MatcherBody.json

@@ -2,12 +2,12 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/MatcherBody.json",
     "title": "MatcherBody",
-    "description": "Parsed single-line body of a matcher-bearing statement, discriminated on `dialect`. The dialect is determined by the body's leading characters (`//` xpath, `/` regex, `$` jsonpath, `~` semantic, `&` graph, else glob). The regex variant carries pattern and flags split out of the `/pattern/flags` literal; every variant remains JSON-serializable.",
+    "description": "Parsed single-line body of a matcher-bearing statement, discriminated on `dialect`. The dialect is determined by the body's leading characters (`//` xpath, `/` regex, `$` jsonpath, `~` full-text, `&` graph, else glob). The regex variant carries pattern and flags split out of the `/pattern/flags` literal; every variant remains JSON-serializable.",
     "oneOf": [
         { "$ref": "#/$defs/XPathBody" },
         { "$ref": "#/$defs/RegexBody" },
         { "$ref": "#/$defs/JsonPathBody" },
-        { "$ref": "#/$defs/SemanticBody" },
+        { "$ref": "#/$defs/FtsBody" },
         { "$ref": "#/$defs/GraphBody" },
         { "$ref": "#/$defs/GlobBody" }
     ],
@@ -47,14 +47,14 @@
                 "raw": { "type": "string", "minLength": 1, "pattern": "^[^\\r\\n]*$" }
             }
         },
-        "SemanticBody": {
-            "title": "SemanticBody",
-            "description": "Semantic similarity query. Body is `~phrase`: natural language after the tilde, with no parse step. Similarity thresholds and result ranges belong to the statement's scope; resolution happens service-side through the configured embedding implementation.",
+        "FtsBody": {
+            "title": "FtsBody",
+            "description": "Native SQLite FTS5 query after the `~` prefix. SQLite owns query validation, tokenization, matching and ranking; the statement's scope selects ordinary result positions.",
             "type": "object",
             "required": ["dialect", "raw"],
             "additionalProperties": false,
             "properties": {
-                "dialect": { "const": "semantic" },
+                "dialect": { "const": "fts" },
                 "raw": { "type": "string", "minLength": 1, "pattern": "^[^\\r\\n]*$" }
             }
         },

package/dist/schema/McpServerDefinition.json

@@ -7,41 +7,51 @@
     "required": ["name", "transport"],
     "properties": {
         "name": {
+            "description": "Server alias used as its EXEC selector and resource scheme.",
             "type": "string",
             "pattern": "^[a-z][a-z0-9-]*$"
         },
         "transport": {
+            "description": "stdio launches a local command; http connects to a remote MCP endpoint.",
             "enum": ["stdio", "http"]
         },
         "command": {
+            "description": "Executable to launch for stdio; arguments belong in args.",
             "type": "string",
             "minLength": 1
         },
         "args": {
+            "description": "Arguments passed to the stdio executable in order.",
             "type": "array",
             "items": { "type": "string" }
         },
         "cwd": {
+            "description": "Working directory for the stdio process.",
             "type": "string",
             "minLength": 1
         },
         "env": {
+            "description": "Environment overrides for the stdio process; values may reference ${ENV_NAME}.",
             "type": "object",
             "additionalProperties": { "type": "string" }
         },
         "url": {
+            "description": "HTTP MCP endpoint URL.",
             "type": "string",
             "format": "uri",
             "pattern": "^https?://"
         },
         "headers": {
+            "description": "HTTP request headers; values may reference ${ENV_NAME}. Authorization cannot also be configured here when authorization is set.",
             "type": "object",
             "additionalProperties": { "type": "string" }
         },
         "authorization": {
+            "description": "HTTP authentication. Secret fields reference the operator environment rather than embedding credentials.",
             "oneOf": [
                 {
                     "type": "object",
+                    "description": "Use a bearer token from the operator environment.",
                     "additionalProperties": false,
                     "required": ["type", "token"],
                     "properties": {
@@ -51,6 +61,7 @@
                 },
                 {
                     "type": "object",
+                    "description": "Interactive OAuth using an HTTPS Client ID Metadata Document.",
                     "additionalProperties": false,
                     "required": ["type", "redirectUrl", "clientMetadataUrl"],
                     "properties": {
@@ -66,6 +77,7 @@
                 },
                 {
                     "type": "object",
+                    "description": "Interactive OAuth using a pre-registered client ID and secret.",
                     "additionalProperties": false,
                     "required": ["type", "redirectUrl", "clientId", "clientSecret"],
                     "properties": {
@@ -78,6 +90,7 @@
                 },
                 {
                     "type": "object",
+                    "description": "Interactive OAuth using dynamic client registration.",
                     "additionalProperties": false,
                     "required": ["type", "redirectUrl"],
                     "properties": {
@@ -88,6 +101,7 @@
                 },
                 {
                     "type": "object",
+                    "description": "Noninteractive OAuth client-credentials grant; issuer optionally binds the credentials to an authorization server.",
                     "additionalProperties": false,
                     "required": ["type", "clientId", "clientSecret"],
                     "properties": {
@@ -101,11 +115,13 @@
             ]
         },
         "tools": {
+            "description": "Exact enabled tool names; omitted enables all tools, an empty array enables none.",
             "type": "array",
             "uniqueItems": true,
             "items": { "type": "string", "minLength": 1 }
         },
         "read": {
+            "description": "Exact tool names the operator designates as read effects rather than host effects requiring proposal review.",
             "type": "array",
             "uniqueItems": true,
             "items": { "type": "string", "minLength": 1 }
@@ -113,6 +129,7 @@
     },
     "$defs": {
         "environmentReference": {
+            "description": "An operator environment variable reference such as ${GITEA_TOKEN}, never a literal secret.",
             "type": "string",
             "pattern": "^\\$\\{[A-Za-z_][A-Za-z0-9_]*\\}$"
         }

package/dist/schema/ModelCatalogPage.json

@@ -100,11 +100,20 @@
         "capabilities": {
             "title": "ModelCatalogCapabilities",
             "type": "object",
-            "required": ["attachment", "reasoning", "toolCall", "inputModalities", "outputModalities"],
+            "required": ["attachment", "reasoning", "reasoningPolicies", "toolCall", "inputModalities", "outputModalities"],
             "additionalProperties": false,
             "properties": {
                 "attachment": { "type": "boolean" },
                 "reasoning": { "type": "boolean" },
+                "reasoningPolicies": {
+                    "description": "Portable reasoning policies admitted for this exact route by the installed provider adapter and provider-wide operator declarations; not a worker's combined model/spawn policy intersection.",
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": {
+                        "$ref": "https://schemas.plurnk.xyz/v0/ReasoningPolicy.json"
+                    }
+                },
                 "toolCall": { "type": "boolean" },
                 "structuredOutput": { "type": "boolean" },
                 "temperature": { "type": "boolean" },

package/dist/schema/ModelRoute.json

@@ -5,6 +5,10 @@
     "description": "A client-visible resolved provider/model identity. Alias is present only when a declared alias supplied the route; provider configuration remains private to the daemon. reasoningPolicy is the worker's durable effort selection — absent when the model has no reasoning dimension.",
     "type": "object",
     "required": ["provider", "model"],
+    "dependentRequired": {
+        "reasoningPolicy": ["reasoningSource"],
+        "reasoningSource": ["reasoningPolicy"]
+    },
     "additionalProperties": false,
     "properties": {
         "alias": {
@@ -21,6 +25,11 @@
         },
         "reasoningPolicy": {
             "$ref": "https://schemas.plurnk.xyz/v0/ReasoningPolicy.json"
+        },
+        "reasoningSource": {
+            "description": "Whether reasoningPolicy was chosen through worker.reasoning.set (explicit) or seeded from the alias configuration (default). Present exactly when reasoningPolicy is.",
+            "type": "string",
+            "enum": ["default", "explicit"]
         }
     }
 }

package/dist/schema/Notice.json

@@ -15,7 +15,7 @@
         "kind": {
             "type": "string",
             "minLength": 1,
-            "description": "Open discriminator within a source. Examples include `grammar_unenforced`, `embed_progress`, `search_progress`, and `turn_awaiting_model`."
+            "description": "Open discriminator within a source. Examples include `grammar_unenforced`, `search_progress`, and `turn_awaiting_model`."
         },
         "level": {
             "enum": ["error", "warn", "info"],

package/dist/schema/ParsedPath.json

@@ -10,13 +10,14 @@
     "$defs": {
         "LocalPath": {
             "title": "LocalPath",
-            "description": "A bare local path with no `scheme://` prefix. The raw string is stored verbatim; resolution is the runtime's job.",
+            "description": "A bare local path with no `scheme://` prefix. `raw` is the path as authored, minus any `#channel`, which is `fragment` exactly as on a URL; resolution is the runtime's job.",
             "type": "object",
             "required": ["kind", "raw"],
             "additionalProperties": false,
             "properties": {
                 "kind": { "const": "local" },
-                "raw": { "type": "string" }
+                "raw": { "type": "string" },
+                "fragment": { "type": ["string", "null"] }
             }
         },
         "UrlPath": {

package/dist/schema/Plan.json

@@ -1,16 +1,16 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/Plan.json",
-    "$comment": "Plurnk's model-native Plan is a bare array of {content, status} working-memory entries \u2014 no priority; ACP projection (separately owned by AcpPlan.json) synthesizes the ACP-required priority at the edge.",
+    "$comment": "Plurnk's model-native Plan is a bare array of {content, status} task entries. ACP projection (separately owned by AcpPlan.json) supplies the required priority at the edge.",
     "title": "Plan",
-    "description": "Plurnk's complete model-native working-memory Plan entries.",
+    "description": "Plurnk's model-native task inventory.",
     "type": "array",
     "items": {
         "$ref": "#/$defs/PlanEntry"
     },
     "$defs": {
         "PlanEntry": {
-            "description": "One finding, task, or goal in the model's working-memory plan.",
+            "description": "One task or goal in the model's plan.",
             "type": "object",
             "properties": {
                 "content": {
@@ -37,7 +37,7 @@
             "additionalProperties": false
         },
         "PlanEntryStatus": {
-            "description": "ACP v1 plan-entry lifecycle states.",
+            "description": "Model-native task states; ACP projection is separately owned.",
             "oneOf": [
                 {
                     "type": "string",
@@ -47,13 +47,17 @@
                     "type": "string",
                     "const": "in_progress"
                 },
+                {
+                    "type": "string",
+                    "const": "waiting"
+                },
                 {
                     "type": "string",
                     "const": "completed"
                 },
                 {
                     "type": "string",
-                    "const": "memory"
+                    "const": "failed"
                 }
             ]
         }