@plurnk/plurnk-contracts 1.7.0 → 1.9.0

package/dist/schema/PlurnkStatement.json

@@ -1,8 +1,8 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/PlurnkStatement.json",
+    "$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, lineMarker, body, suffix, 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, 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.",
     "oneOf": [
         { "$ref": "#/$defs/FindStatement" },
         { "$ref": "#/$defs/ReadStatement" },
@@ -26,6 +26,9 @@
                 { "type": "null" }
             ]
         },
+        "AnnotationOrNull": {
+            "type": ["string", "null"]
+        },
         "AppliedTagSignal": {
             "oneOf": [
                 {
@@ -52,50 +55,51 @@
         },
         "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" }
             ]
         },
         "SendBodyOrNull": {
             "oneOf": [
-                { "$ref": "https://schemas.plurnk.dev/v0/SendBody.json" },
+                { "$ref": "https://schemas.plurnk.xyz/v0/SendBody.json" },
                 { "type": "null" }
             ]
         },
         "ResourceSelectionOrNull": {
             "oneOf": [
-                { "$ref": "https://schemas.plurnk.dev/v0/ResourceSelection.json" },
+                { "$ref": "https://schemas.plurnk.xyz/v0/ResourceSelection.json" },
                 { "type": "null" }
             ]
         },
         "PositionRef": {
-            "$ref": "https://schemas.plurnk.dev/v0/Position.json"
+            "$ref": "https://schemas.plurnk.xyz/v0/Position.json"
         },
         "FindStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "FIND" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/AppliedTagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/LineMarkerOrNull" },
@@ -105,11 +109,12 @@
         },
         "ReadStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "READ" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/AppliedTagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/TextLineMarkerOrNull" },
@@ -119,39 +124,42 @@
         },
         "OpenStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "OPEN" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/CurationTagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
-                "lineMarker": { "type": "null" },
+                "lineMarker": { "$ref": "#/$defs/TextLineMarkerOrNull" },
                 "body": { "$ref": "#/$defs/MatcherBodyOrNull" },
                 "position": { "$ref": "#/$defs/PositionRef" }
             }
         },
         "FoldStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "FOLD" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/CurationTagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
-                "lineMarker": { "type": "null" },
+                "lineMarker": { "$ref": "#/$defs/TextLineMarkerOrNull" },
                 "body": { "$ref": "#/$defs/MatcherBodyOrNull" },
                 "position": { "$ref": "#/$defs/PositionRef" }
             }
         },
         "EditStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "EDIT" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/AppliedTagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/TextLineMarkerOrNull" },
@@ -161,11 +169,12 @@
         },
         "CopyStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "COPY" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/AppliedTagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/TextLineMarkerOrNull" },
@@ -175,11 +184,12 @@
         },
         "MoveStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "MOVE" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/AppliedTagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/TextLineMarkerOrNull" },
@@ -189,11 +199,12 @@
         },
         "SendStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "SEND" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": {
                     "oneOf": [
                         { "type": "number" },
@@ -208,11 +219,12 @@
         },
         "ExecStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "EXEC" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "type": ["string", "null"] },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/LineMarkerOrNull" },
@@ -222,11 +234,12 @@
         },
         "BareStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "BARE" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/AppliedTagSignal" },
                 "target": { "type": "null" },
                 "lineMarker": { "type": "null" },
@@ -236,25 +249,27 @@
         },
         "PlanStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "PLAN" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": { "$ref": "#/$defs/TagSignal" },
                 "target": { "$ref": "#/$defs/PathOrNull" },
                 "lineMarker": { "$ref": "#/$defs/LineMarkerOrNull" },
-                "body": { "type": ["string", "null"] },
+                "body": { "$ref": "https://schemas.plurnk.xyz/v0/Plan.json" },
                 "position": { "$ref": "#/$defs/PositionRef" }
             }
         },
         "KillStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "KILL" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": {
                     "oneOf": [
                         { "type": "number" },
@@ -269,11 +284,12 @@
         },
         "WorkStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "WORK" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": {
                     "oneOf": [
                         { "type": "string", "minLength": 1 },
@@ -288,11 +304,12 @@
         },
         "ForkStatement": {
             "type": "object",
-            "required": ["op", "suffix", "signal", "target", "lineMarker", "body", "position"],
+            "required": ["op", "delimiter", "annotation", "signal", "target", "lineMarker", "body", "position"],
             "additionalProperties": false,
             "properties": {
                 "op": { "const": "FORK" },
-                "suffix": { "type": "string" },
+                "delimiter": { "type": "string" },
+                "annotation": { "$ref": "#/$defs/AnnotationOrNull" },
                 "signal": {
                     "oneOf": [
                         { "type": "string", "minLength": 1 },

package/dist/schema/Position.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/Position.json",
+    "$id": "https://schemas.plurnk.xyz/v0/Position.json",
     "title": "Position",
     "description": "A source point in parsed PLURNK input. Lines are 1-based; columns are 0-based Unicode code points. LF and CRLF delimit lines, while a lone CR occupies one column. The exact pair {line: 0, column: 0} is the sole unknown/degraded position.",
     "type": "object",

package/dist/schema/ProblemDetails.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/ProblemDetails.json",
+    "$id": "https://schemas.plurnk.xyz/v0/ProblemDetails.json",
     "title": "ProblemDetails",
     "description": "PLURNK operation failure using RFC 9457 Problem Details. Extension members are permitted so an owning boundary can add structured causal and recovery facts without inventing a second error envelope.",
     "type": "object",

package/dist/schema/ProposalDisposition.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/ProposalDisposition.json",
+    "$id": "https://schemas.plurnk.xyz/v0/ProposalDisposition.json",
     "title": "ProposalDisposition",
     "description": "The one core-owned settlement decision for a pending proposal. Client-owned proposals require an external resolution; loop-owned proposals carry the exact automatic resolution core applies.",
     "oneOf": [

package/dist/schema/ProposalProjection.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/ProposalProjection.json",
+    "$id": "https://schemas.plurnk.xyz/v0/ProposalProjection.json",
     "title": "ProposalProjection",
     "description": "The runtime-neutral client-interface projection of one durable stopped-world proposal. Live delivery and reconnect discovery expose this same shape.",
     "type": "object",
@@ -14,7 +14,6 @@
         "body",
         "attrs",
         "flags",
-        "staleClobberRisk",
         "disposition"
     ],
     "additionalProperties": false,
@@ -28,17 +27,17 @@
         },
         "target": {
             "type": "object",
-            "required": ["scheme", "pathname"],
+            "required": ["scheme", "authority", "pathname"],
             "additionalProperties": false,
             "properties": {
                 "scheme": { "type": ["string", "null"] },
+                "authority": { "type": ["string", "null"] },
                 "pathname": { "type": ["string", "null"] }
             }
         },
         "body": { "type": "string" },
         "attrs": { "type": "object", "additionalProperties": true },
-        "flags": { "$ref": "https://schemas.plurnk.dev/v0/LoopFlags.json" },
-        "staleClobberRisk": { "type": "boolean" },
-        "disposition": { "$ref": "https://schemas.plurnk.dev/v0/ProposalDisposition.json" }
+        "flags": { "$ref": "https://schemas.plurnk.xyz/v0/LoopFlags.json" },
+        "disposition": { "$ref": "https://schemas.plurnk.xyz/v0/ProposalDisposition.json" }
     }
 }

package/dist/schema/ProviderAccounting.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/ProviderAccounting.json",
+    "$id": "https://schemas.plurnk.xyz/ProviderAccounting.json",
     "title": "ProviderAccounting",
     "description": "Ordered physical provider-request evidence and its deterministic aggregate projection.",
     "type": "object",
@@ -9,11 +9,11 @@
     "properties": {
         "requests": {
             "type": "array",
-            "items": { "$ref": "https://schemas.plurnk.dev/ProviderRequestAccounting.json" }
+            "items": { "$ref": "https://schemas.plurnk.xyz/ProviderRequestAccounting.json" }
         },
         "usage": {
             "oneOf": [
-                { "$ref": "https://schemas.plurnk.dev/ProviderUsage.json" },
+                { "$ref": "https://schemas.plurnk.xyz/ProviderUsage.json" },
                 { "type": "null" }
             ]
         },

package/dist/schema/ProviderCost.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/ProviderCost.json",
+    "$id": "https://schemas.plurnk.xyz/ProviderCost.json",
     "title": "ProviderCost",
     "description": "Normalized monetary evidence for one physical provider request. Unknown is never represented as zero.",
     "oneOf": [

package/dist/schema/ProviderRequestAccounting.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/ProviderRequestAccounting.json",
+    "$id": "https://schemas.plurnk.xyz/ProviderRequestAccounting.json",
     "title": "ProviderRequestAccounting",
     "description": "The normalized accounting disposition of one physical provider request.",
     "type": "object",
@@ -11,7 +11,7 @@
         "model": { "type": "string", "minLength": 1 },
         "outcome": { "enum": ["response", "error"] },
         "status": { "type": "integer", "minimum": 100, "maximum": 599 },
-        "usage": { "$ref": "https://schemas.plurnk.dev/ProviderUsage.json" },
-        "cost": { "$ref": "https://schemas.plurnk.dev/ProviderCost.json" }
+        "usage": { "$ref": "https://schemas.plurnk.xyz/ProviderUsage.json" },
+        "cost": { "$ref": "https://schemas.plurnk.xyz/ProviderCost.json" }
     }
 }

package/dist/schema/ProviderUsage.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/ProviderUsage.json",
+    "$id": "https://schemas.plurnk.xyz/ProviderUsage.json",
     "title": "ProviderUsage",
     "description": "Known token quantities for one provider request. Omitted fields are unknown; explicit zero is observed or exactly derived.",
     "type": "object",

package/dist/schema/RangeExtent.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/RangeExtent.json",
+    "$id": "https://schemas.plurnk.xyz/v0/RangeExtent.json",
     "title": "RangeExtent",
     "description": "A compact projection of one line or ordered-result selection. Requested and returned positions are inclusive; total is the complete available cardinality.",
     "type": "object",

package/dist/schema/ReasoningPolicy.json

@@ -0,0 +1,7 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.xyz/v0/ReasoningPolicy.json",
+    "title": "ReasoningPolicy",
+    "description": "The portable durable reasoning intent shared by provider, runtime, and client boundaries.",
+    "enum": ["off", "adaptive", "low", "medium", "high"]
+}

package/dist/schema/ResourceSelection.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/ResourceSelection.json",
+    "$id": "https://schemas.plurnk.xyz/v0/ResourceSelection.json",
     "title": "ResourceSelection",
     "description": "A COPY/MOVE destination target and optional text scope. A target without a fragment selects the scheme's default channel; a fragment selects a named channel; lineMarker scopes the selected destination content.",
     "type": "object",
@@ -8,11 +8,11 @@
     "additionalProperties": false,
     "properties": {
         "target": {
-            "$ref": "https://schemas.plurnk.dev/v0/ParsedPath.json"
+            "$ref": "https://schemas.plurnk.xyz/v0/ParsedPath.json"
         },
         "lineMarker": {
             "oneOf": [
-                { "$ref": "https://schemas.plurnk.dev/v0/TextLineMarker.json" },
+                { "$ref": "https://schemas.plurnk.xyz/v0/TextLineMarker.json" },
                 { "type": "null" }
             ]
         }

package/dist/schema/SendBody.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/SendBody.json",
+    "$id": "https://schemas.plurnk.xyz/v0/SendBody.json",
     "title": "SendBody",
     "description": "Parsed body of a SEND statement. `raw` is the literal body text; `json` is the best-effort `JSON.parse(raw)` result, or null when the body isn't valid JSON.",
     "type": "object",

package/dist/schema/SkillDefinition.json

@@ -0,0 +1,26 @@
+{
+    "$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.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["name", "scope"],
+    "properties": {
+        "name": {
+            "description": "The standard Agent Skills name: lowercase words joined by single hyphens, equal to the skill's directory name.",
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "maxLength": 64
+        },
+        "scope": {
+            "description": "The universal Agent Skills root: the project's `.agents/skills` or the user's `~/.agents/skills`.",
+            "enum": ["project", "global"]
+        },
+        "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.",
+            "type": "string",
+            "minLength": 1
+        }
+    }
+}

package/dist/schema/TextLineMarker.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/TextLineMarker.json",
+    "$id": "https://schemas.plurnk.xyz/v0/TextLineMarker.json",
     "title": "TextLineMarker",
     "description": "The ordered components parsed from a text-coordinate <scope>. A line position may be numeric or a rendered five-character Base62 line anchor; columns remain numeric. Core resolves anchors against the addressed current text before a numeric scope reaches its operation owner.",
     "type": "object",

package/dist/schema/TextRegion.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
-    "$id": "https://schemas.plurnk.dev/v0/TextRegion.json",
+    "$id": "https://schemas.plurnk.xyz/v0/TextRegion.json",
     "title": "TextRegion",
     "description": "A contiguous region of text. Lines and Unicode code-point columns are 1-based; the start is included and the end is excluded.",
     "type": "object",

package/dist/src/AcpPlanValue.d.ts

@@ -0,0 +1,7 @@
+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;
+}
+//# sourceMappingURL=AcpPlanValue.d.ts.map

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

@@ -0,0 +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,CAgBtC;IAED,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK9C;CAEJ"}

package/dist/src/AcpPlanValue.js

@@ -0,0 +1,32 @@
+import PlanValue from "./PlanValue.js";
+import Validator from "./Validator.js";
+export const ACP_MEMORY_PREFIX = "Memory: ";
+// The standards boundary for Plurnk's model-native Plan. Internal state remains
+// untouched; only an ACP consumer receives this deliberately lossy projection.
+export default class AcpPlanValue {
+    static project(value) {
+        const plan = PlanValue.assertCanonical(value);
+        const projected = {
+            entries: plan.map((entry) => {
+                const { status, ...rest } = entry;
+                if (status !== "memory")
+                    return { ...rest, status };
+                return {
+                    ...rest,
+                    content: entry.content.startsWith(ACP_MEMORY_PREFIX)
+                        ? entry.content
+                        : `${ACP_MEMORY_PREFIX}${entry.content}`,
+                    status: "completed",
+                };
+            }),
+        };
+        return AcpPlanValue.assertCanonical(projected);
+    }
+    static assertCanonical(value) {
+        if (!Validator.validateAcpPlan(value).valid) {
+            throw new TypeError("Expected a canonical ACP Plan.");
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=AcpPlanValue.js.map

package/dist/src/AcpPlanValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcpPlanValue.js","sourceRoot":"","sources":["../../src/AcpPlanValue.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C,gFAAgF;AAChF,+EAA+E;AAC/E,MAAM,CAAC,OAAO,OAAO,YAAY;IAC7B,MAAM,CAAC,OAAO,CAAC,KAAc;QACzB,MAAM,IAAI,GAAG,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG;YACd,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAgB,EAAE;gBACtC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;gBAClC,IAAI,MAAM,KAAK,QAAQ;oBAAE,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC;gBACpD,OAAO;oBACH,GAAG,IAAI;oBACP,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;wBAChD,CAAC,CAAC,KAAK,CAAC,OAAO;wBACf,CAAC,CAAC,GAAG,iBAAiB,GAAG,KAAK,CAAC,OAAO,EAAE;oBAC5C,MAAM,EAAE,WAAW;iBACtB,CAAC;YACN,CAAC,CAAC;SACa,CAAC;QACpB,OAAO,YAAY,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,KAAc;QACjC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;YAC1C,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,KAAgB,CAAC;IAC5B,CAAC;CAEJ"}

package/dist/src/AguiConformance.d.ts

@@ -0,0 +1,11 @@
+import type { Dimensions } from "./types.generated.ts";
+export interface AguiConformanceRow {
+    readonly kind: "action" | "notification";
+    readonly name: string;
+    readonly posture: "native" | "generic" | "unsupported";
+    readonly dimensions: Dimensions;
+    readonly evidence: readonly string[];
+    readonly reason?: string;
+}
+export declare const aguiConformanceReport: (discoveryValue: unknown, conformanceValue: unknown) => AguiConformanceRow[];
+//# sourceMappingURL=AguiConformance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AguiConformance.d.ts","sourceRoot":"","sources":["../../src/AguiConformance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,qBAAqB,mBACd,OAAO,oBACL,OAAO,KAC1B,kBAAkB,EAmBpB,CAAC"}

package/dist/src/AguiConformance.js

@@ -0,0 +1,16 @@
+import Validator from "./Validator.js";
+export const aguiConformanceReport = (discoveryValue, conformanceValue) => {
+    const conformance = Validator.assertAguiClientConformance(discoveryValue, conformanceValue);
+    const rows = (kind, label) => Object.entries(conformance[kind])
+        .toSorted(([left], [right]) => left.localeCompare(right))
+        .map(([name, disposition]) => ({
+        kind: label,
+        name,
+        posture: disposition.posture,
+        dimensions: disposition.dimensions,
+        evidence: disposition.evidence,
+        ...(disposition.posture === "unsupported" ? { reason: disposition.reason } : {}),
+    }));
+    return [...rows("actions", "action"), ...rows("notifications", "notification")];
+};
+//# sourceMappingURL=AguiConformance.js.map

package/dist/src/AguiConformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AguiConformance.js","sourceRoot":"","sources":["../../src/AguiConformance.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAYvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACjC,cAAuB,EACvB,gBAAyB,EACL,EAAE;IACtB,MAAM,WAAW,GAAG,SAAS,CAAC,2BAA2B,CACrD,cAAc,EACd,gBAAgB,CACnB,CAAC;IACF,MAAM,IAAI,GAAG,CACT,IAAU,EACV,KAAiC,EACb,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;SACvD,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SACxD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,KAAK;QACX,IAAI;QACJ,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,GAAG,CAAC,WAAW,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnF,CAAC,CAAC,CAAC;IACR,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC;AACpF,CAAC,CAAC"}