@plurnk/plurnk-contracts 1.16.4 → 1.17.0

package/dist/schema/PlurnkStatement.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/PlurnkStatement.json",
     "title": "PlurnkStatement",
-    "description": "The parsed AST union for one protocol statement, discriminated by `op`. Every variant has fixed signal, target, metadata, lineMarker, annotation, body, delimiter, and source-position fields; operation-specific schemas constrain their types. A null field records an omitted tolerated slot and does not satisfy runtime requirements by itself.",
+    "description": "The parsed AST union for one protocol statement, discriminated by `op`. Every variant has fixed signal, target, metadata, lineMarker, aside, body, and source-position fields, and the text and log operations add a matcher lifted from the `pattern` option; operation-specific schemas constrain their types. A null field records an omitted tolerated slot and does not satisfy runtime requirements by itself.",
     "oneOf": [
         {
             "$ref": "#/$defs/FindStatement"
@@ -38,11 +38,11 @@
             "$ref": "#/$defs/KillStatement"
         },
         {
-            "$ref": "#/$defs/PlanStatement"
+            "$ref": "#/$defs/DispositionStatement"
         }
     ],
     "$defs": {
-        "AnnotationOrNull": {
+        "AsideOrNull": {
             "type": [
                 "string",
                 "null"
@@ -147,11 +147,11 @@
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "target",
                 "lineMarker",
+                "matcher",
                 "body",
                 "position"
             ],
@@ -160,11 +160,8 @@
                 "op": {
                     "const": "FIND"
                 },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
                     "$ref": "#/$defs/SchemeMetadataOrNull"
@@ -175,8 +172,13 @@
                 "lineMarker": {
                     "$ref": "#/$defs/LineMarkerOrNull"
                 },
+                "matcher": {
+                    "$ref": "#/$defs/MatcherBodyOrNull",
+                    "description": "The selection matcher lifted from the heading's `[{\"pattern\": …}]` option ({§matcher-option}); null when the heading carries none."
+                },
                 "body": {
-                    "$ref": "#/$defs/MatcherBodyOrNull"
+                    "type": "null",
+                    "description": "FIND takes no body; its matcher is the `pattern` option."
                 },
                 "position": {
                     "$ref": "#/$defs/PositionRef"
@@ -187,11 +189,11 @@
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "target",
                 "lineMarker",
+                "matcher",
                 "body",
                 "position"
             ],
@@ -200,11 +202,8 @@
                 "op": {
                     "const": "READ"
                 },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
                     "$ref": "#/$defs/SchemeMetadataOrNull"
@@ -215,6 +214,10 @@
                 "lineMarker": {
                     "$ref": "#/$defs/TextLineMarkerOrNull"
                 },
+                "matcher": {
+                    "$ref": "#/$defs/MatcherBodyOrNull",
+                    "description": "The selection matcher lifted from the heading's `[{\"pattern\": …}]` option ({§matcher-option}); null when the heading carries none."
+                },
                 "body": {
                     "type": "null"
                 },
@@ -227,11 +230,11 @@
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "target",
                 "lineMarker",
+                "matcher",
                 "body",
                 "position"
             ],
@@ -240,11 +243,8 @@
                 "op": {
                     "const": "EDIT"
                 },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
                     "$ref": "#/$defs/SchemeMetadataOrNull"
@@ -255,6 +255,10 @@
                 "lineMarker": {
                     "$ref": "#/$defs/TextLineMarkerOrNull"
                 },
+                "matcher": {
+                    "$ref": "#/$defs/MatcherBodyOrNull",
+                    "description": "The selection matcher lifted from the heading's `[{\"pattern\": …}]` option ({§matcher-option}); null when the heading carries none."
+                },
                 "body": {
                     "type": [
                         "string",
@@ -270,8 +274,7 @@
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "source",
                 "destination",
                 "position"
@@ -281,11 +284,8 @@
                 "op": {
                     "const": "COPY"
                 },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "source": {
                     "$ref": "https://schemas.plurnk.xyz/v0/ResourceSelection.json"
@@ -302,8 +302,7 @@
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "source",
                 "destination",
                 "position"
@@ -313,11 +312,8 @@
                 "op": {
                     "const": "MOVE"
                 },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "source": {
                     "$ref": "https://schemas.plurnk.xyz/v0/ResourceSelection.json"
@@ -334,25 +330,20 @@
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "target",
                 "lineMarker",
                 "body",
-                "position",
-                "status"
+                "position"
             ],
             "additionalProperties": false,
             "properties": {
                 "op": {
                     "const": "SEND"
                 },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
                     "$ref": "#/$defs/SchemeMetadataOrNull"
@@ -368,23 +359,6 @@
                 },
                 "position": {
                     "$ref": "#/$defs/PositionRef"
-                },
-                "status": {
-                    "description": "The turn disposition the label names ({§send-label}): NEXT 102, WAIT 202, TERM 200, FAIL 499; null for a mid-turn message to a recipient.",
-                    "oneOf": [
-                        {
-                            "type": "integer",
-                            "enum": [
-                                102,
-                                200,
-                                202,
-                                499
-                            ]
-                        },
-                        {
-                            "type": "null"
-                        }
-                    ]
                 }
             }
         },
@@ -392,8 +366,7 @@
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "executor",
                 "target",
@@ -406,17 +379,14 @@
                 "op": {
                     "const": "EXEC"
                 },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
                     "$ref": "#/$defs/SchemeMetadataOrNull"
                 },
                 "executor": {
-                    "description": "The `[executor]` slot: the registered executor that runs the program; null is the default shell.",
+                    "description": "The registered executor selected by the fence name; null is the default shell for native EXEC.",
                     "type": [
                         "string",
                         "null"
@@ -443,8 +413,7 @@
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "target",
                 "lineMarker",
@@ -456,76 +425,74 @@
                 "op": {
                     "const": "BARE"
                 },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
                     "$ref": "#/$defs/SchemeMetadataOrNull"
                 },
                 "target": {
-                    "type": "null"
+                    "$ref": "#/$defs/PathOrNull"
                 },
                 "lineMarker": {
                     "type": "null"
                 },
                 "body": {
-                    "type": "string",
-                    "minLength": 1
+                    "type": "string"
                 },
                 "position": {
                     "$ref": "#/$defs/PositionRef"
                 }
             }
         },
-        "PlanStatement": {
+        "KillStatement": {
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "target",
                 "lineMarker",
+                "matcher",
                 "body",
                 "position"
             ],
             "additionalProperties": false,
             "properties": {
                 "op": {
-                    "const": "PLAN"
-                },
-                "delimiter": {
-                    "type": "string"
+                    "const": "KILL"
                 },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
-                    "type": "null"
+                    "$ref": "#/$defs/SchemeMetadataOrNull"
                 },
                 "target": {
-                    "type": "null"
+                    "$ref": "#/$defs/PathOrNull"
                 },
                 "lineMarker": {
-                    "type": "null"
+                    "$ref": "#/$defs/TextLineMarkerOrNull",
+                    "description": "Scope of the kill: lines of a log body or of an entry ({§kill-scope}); null kills the whole target."
+                },
+                "matcher": {
+                    "$ref": "#/$defs/MatcherBodyOrNull",
+                    "description": "The selection matcher lifted from the heading's `[{\"pattern\": …}]` option ({§matcher-option}); null when the heading carries none."
                 },
                 "body": {
-                    "$ref": "https://schemas.plurnk.xyz/v0/Plan.json"
+                    "type": "null",
+                    "description": "KILL takes no body; its matcher is the `pattern` option."
                 },
                 "position": {
                     "$ref": "#/$defs/PositionRef"
                 }
             }
         },
-        "KillStatement": {
+        "WorkStatement": {
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "target",
                 "lineMarker",
@@ -535,13 +502,10 @@
             "additionalProperties": false,
             "properties": {
                 "op": {
-                    "const": "KILL"
-                },
-                "delimiter": {
-                    "type": "string"
+                    "const": "WORK"
                 },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
                     "$ref": "#/$defs/SchemeMetadataOrNull"
@@ -550,24 +514,21 @@
                     "$ref": "#/$defs/PathOrNull"
                 },
                 "lineMarker": {
-                    "$ref": "#/$defs/TextLineMarkerOrNull",
-                    "description": "Scope of the kill: lines of a log body or of an entry ({§kill-scope}); null kills the whole target."
+                    "type": "null"
                 },
                 "body": {
-                    "$ref": "#/$defs/MatcherBodyOrNull",
-                    "description": "A body pattern selects log items for a scoped KILL, as a FIND body does ({§kill-scope}); null otherwise."
+                    "type": "string"
                 },
                 "position": {
                     "$ref": "#/$defs/PositionRef"
                 }
             }
         },
-        "WorkStatement": {
+        "ForkStatement": {
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "target",
                 "lineMarker",
@@ -577,13 +538,10 @@
             "additionalProperties": false,
             "properties": {
                 "op": {
-                    "const": "WORK"
-                },
-                "delimiter": {
-                    "type": "string"
+                    "const": "FORK"
                 },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
                     "$ref": "#/$defs/SchemeMetadataOrNull"
@@ -595,20 +553,18 @@
                     "type": "null"
                 },
                 "body": {
-                    "type": "string",
-                    "minLength": 1
+                    "type": "string"
                 },
                 "position": {
                     "$ref": "#/$defs/PositionRef"
                 }
             }
         },
-        "ForkStatement": {
+        "DispositionStatement": {
             "type": "object",
             "required": [
                 "op",
-                "delimiter",
-                "annotation",
+                "aside",
                 "metadata",
                 "target",
                 "lineMarker",
@@ -618,26 +574,22 @@
             "additionalProperties": false,
             "properties": {
                 "op": {
-                    "const": "FORK"
+                    "const": "TASK"
                 },
-                "delimiter": {
-                    "type": "string"
-                },
-                "annotation": {
-                    "$ref": "#/$defs/AnnotationOrNull"
+                "aside": {
+                    "$ref": "#/$defs/AsideOrNull"
                 },
                 "metadata": {
-                    "$ref": "#/$defs/SchemeMetadataOrNull"
+                    "type": "null"
                 },
                 "target": {
-                    "$ref": "#/$defs/PathOrNull"
+                    "type": "null"
                 },
                 "lineMarker": {
-                    "type": "null"
+                    "$ref": "#/$defs/LineMarkerOrNull"
                 },
                 "body": {
-                    "type": "string",
-                    "minLength": 1
+                    "$ref": "https://schemas.plurnk.xyz/v0/Plan.json"
                 },
                 "position": {
                     "$ref": "#/$defs/PositionRef"

package/dist/schema/ProposalProjection.json

@@ -23,7 +23,8 @@
         "loopId": { "type": "integer", "minimum": 1 },
         "turnId": { "type": "integer", "minimum": 1 },
         "op": {
-            "enum": ["FIND", "READ", "EDIT", "COPY", "MOVE", "SEND", "EXEC", "BARE", "WORK", "FORK", "KILL", "PLAN"]
+            "enum": ["FIND", "READ", "EDIT", "COPY", "MOVE", "SEND", "EXEC", "BARE", "WORK", "FORK", "KILL",
+                "TASK"]
         },
         "target": {
             "type": "object",

package/dist/schema/ResourceSelection.json

@@ -1,30 +1,54 @@
 {
-    "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.xyz/v0/ResourceSelection.json",
-    "title": "ResourceSelection",
-    "description": "One COPY/MOVE resource operand. A target without a fragment selects the scheme's default channel; a fragment selects a named channel; metadata belongs to the selected scheme endpoint; lineMarker scopes the selected textual content.",
-    "type": "object",
-    "required": ["target", "metadata", "lineMarker"],
-    "additionalProperties": false,
-    "properties": {
-        "target": {
-            "$ref": "https://schemas.plurnk.xyz/v0/ParsedPath.json"
-        },
-        "metadata": {
-            "description": "Opaque ordered scheme-metadata modifier blocks owned by this operand's addressed scheme.",
-            "oneOf": [
-                {
-                    "type": "array",
-                    "items": { "type": "string" }
-                },
-                { "type": "null" }
-            ]
-        },
-        "lineMarker": {
-            "oneOf": [
-                { "$ref": "https://schemas.plurnk.xyz/v0/TextLineMarker.json" },
-                { "type": "null" }
-            ]
-        }
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "$id": "https://schemas.plurnk.xyz/v0/ResourceSelection.json",
+ "title": "ResourceSelection",
+ "description": "One COPY/MOVE resource operand. A target without a fragment selects the scheme's default channel; a fragment selects a named channel; metadata belongs to the selected scheme endpoint; lineMarker scopes the selected textual content.",
+ "type": "object",
+ "required": [
+  "target",
+  "metadata",
+  "lineMarker",
+  "matcher"
+ ],
+ "additionalProperties": false,
+ "properties": {
+  "target": {
+   "$ref": "https://schemas.plurnk.xyz/v0/ParsedPath.json"
+  },
+  "metadata": {
+   "description": "Opaque ordered scheme-metadata modifier blocks owned by this operand's addressed scheme.",
+   "oneOf": [
+    {
+     "type": "array",
+     "items": {
+      "type": "string"
+     }
+    },
+    {
+     "type": "null"
     }
+   ]
+  },
+  "lineMarker": {
+   "oneOf": [
+    {
+     "$ref": "https://schemas.plurnk.xyz/v0/TextLineMarker.json"
+    },
+    {
+     "type": "null"
+    }
+   ]
+  },
+  "matcher": {
+   "description": "The selection matcher lifted from the operand's `[{\"pattern\": …}]` option; meaningful on the source operand, refused by the owner on a destination.",
+   "oneOf": [
+    {
+     "$ref": "https://schemas.plurnk.xyz/v0/MatcherBody.json"
+    },
+    {
+     "type": "null"
+    }
+   ]
+  }
+ }
 }

package/dist/schema/SkillDefinition.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.xyz/v0/SkillDefinition.json",
     "title": "SkillDefinition",
-    "description": "One standard Agent Skill as the Worker Functionality coordinator persists it: the skill's standard name, the universal root that holds (or will hold) its directory, and — for a Worker-installed skill — the standard installer package reference it came from.",
+    "description": "One standard Agent Skill: its name, source scope, and — for a Worker-installed skill — the standard installer package reference.",
     "type": "object",
     "additionalProperties": false,
     "required": ["name", "scope"],
@@ -14,8 +14,8 @@
             "maxLength": 64
         },
         "scope": {
-            "description": "The universal Agent Skills root: the project's `.agents/skills` or the user's `~/.agents/skills`.",
-            "enum": ["project", "global"]
+            "description": "Source: project `.agents/skills`, global `~/.agents/skills`, or a service-provided resource tree. Service sources are not installer targets.",
+            "enum": ["project", "global", "service"]
         },
         "source": {
             "description": "The standard installer package reference (`owner/repo`, a git URL, or a local path) that provides the skill; required to add a skill that is not yet installed.",

package/dist/src/AcpPlanValue.d.ts

@@ -1,5 +1,4 @@
 import type { AcpPlan } from "./types.ts";
-export declare const ACP_MEMORY_PREFIX = "Memory: ";
 export default class AcpPlanValue {
     static project(value: unknown): AcpPlan;
     static assertCanonical(value: unknown): AcpPlan;

package/dist/src/AcpPlanValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcpPlanValue.d.ts","sourceRoot":"","sources":["../../src/AcpPlanValue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,YAAY,CAAC;AAIxD,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAI5C,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmBtC;IAED,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK9C;CAEJ"}
+{"version":3,"file":"AcpPlanValue.d.ts","sourceRoot":"","sources":["../../src/AcpPlanValue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK1C,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAsBtC;IAED,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK9C;CAEJ"}