@plurnk/plurnk-contracts 1.7.0 → 1.8.0

package/dist/schema/McpServerOptions.json

@@ -0,0 +1,36 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.dev/v0/McpServerOptions.json",
+    "title": "McpServerOptions",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+        "args": {
+            "title": "McpServerArguments",
+            "$ref": "https://schemas.plurnk.dev/v0/McpServerDefinition.json#/properties/args"
+        },
+        "cwd": {
+            "$ref": "https://schemas.plurnk.dev/v0/McpServerDefinition.json#/properties/cwd"
+        },
+        "env": {
+            "title": "McpServerEnvironment",
+            "$ref": "https://schemas.plurnk.dev/v0/McpServerDefinition.json#/properties/env"
+        },
+        "headers": {
+            "title": "McpServerHeaders",
+            "$ref": "https://schemas.plurnk.dev/v0/McpServerDefinition.json#/properties/headers"
+        },
+        "authorization": {
+            "title": "McpServerAuthorization",
+            "$ref": "https://schemas.plurnk.dev/v0/McpServerDefinition.json#/properties/authorization"
+        },
+        "tools": {
+            "title": "McpServerToolNames",
+            "$ref": "https://schemas.plurnk.dev/v0/McpServerDefinition.json#/properties/tools"
+        },
+        "read": {
+            "title": "McpServerReadTools",
+            "$ref": "https://schemas.plurnk.dev/v0/McpServerDefinition.json#/properties/read"
+        }
+    }
+}

package/dist/schema/ModelCatalogPage.json

@@ -0,0 +1,122 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.dev/v0/ModelCatalogPage.json",
+    "title": "ModelCatalogPage",
+    "description": "One deterministic bounded page from the release-pinned model catalog.",
+    "type": "object",
+    "required": ["items", "offset", "total"],
+    "additionalProperties": false,
+    "properties": {
+        "items": {
+            "type": "array",
+            "maxItems": 100,
+            "items": {
+                "$ref": "#/$defs/model"
+            }
+        },
+        "offset": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+        },
+        "total": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+        },
+        "nextOffset": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 9007199254740991
+        }
+    },
+    "$defs": {
+        "model": {
+            "title": "ModelCatalogEntry",
+            "type": "object",
+            "required": [
+                "selector",
+                "provider",
+                "providerName",
+                "model",
+                "modelName",
+                "limits",
+                "capabilities",
+                "readiness"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "selector": {
+                    "type": "string",
+                    "minLength": 3
+                },
+                "provider": {
+                    "type": "string",
+                    "minLength": 1
+                },
+                "providerName": {
+                    "type": "string",
+                    "minLength": 1
+                },
+                "model": {
+                    "type": "string",
+                    "minLength": 1
+                },
+                "modelName": {
+                    "type": "string",
+                    "minLength": 1
+                },
+                "limits": {
+                    "$ref": "#/$defs/limits"
+                },
+                "capabilities": {
+                    "$ref": "#/$defs/capabilities"
+                },
+                "readiness": {
+                    "$ref": "https://schemas.plurnk.dev/v0/ModelReadiness.json"
+                }
+            }
+        },
+        "limits": {
+            "title": "ModelCatalogLimits",
+            "type": "object",
+            "required": ["contextTokens"],
+            "additionalProperties": false,
+            "properties": {
+                "contextTokens": {
+                    "type": "integer",
+                    "minimum": 1
+                },
+                "inputTokens": {
+                    "type": "integer",
+                    "minimum": 1
+                },
+                "outputTokens": {
+                    "type": "integer",
+                    "minimum": 1
+                }
+            }
+        },
+        "capabilities": {
+            "title": "ModelCatalogCapabilities",
+            "type": "object",
+            "required": ["attachment", "reasoning", "toolCall", "inputModalities", "outputModalities"],
+            "additionalProperties": false,
+            "properties": {
+                "attachment": { "type": "boolean" },
+                "reasoning": { "type": "boolean" },
+                "toolCall": { "type": "boolean" },
+                "structuredOutput": { "type": "boolean" },
+                "temperature": { "type": "boolean" },
+                "inputModalities": {
+                    "type": "array",
+                    "items": { "type": "string", "minLength": 1 }
+                },
+                "outputModalities": {
+                    "type": "array",
+                    "items": { "type": "string", "minLength": 1 }
+                }
+            }
+        }
+    }
+}

package/dist/schema/ModelCatalogQuery.json

@@ -0,0 +1,32 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.dev/v0/ModelCatalogQuery.json",
+    "title": "ModelCatalogQuery",
+    "description": "A bounded query over the release-pinned Models.dev catalog.",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+        "provider": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+        },
+        "search": {
+            "type": "string",
+            "maxLength": 256
+        },
+        "availability": {
+            "enum": ["configured", "all"]
+        },
+        "offset": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+        },
+        "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100
+        }
+    }
+}

package/dist/schema/ModelReadiness.json

@@ -0,0 +1,47 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.dev/v0/ModelReadiness.json",
+    "title": "ModelReadiness",
+    "description": "Local configuration evidence that a catalog provider is ready to attempt a request, without probing or validating credentials.",
+    "type": "object",
+    "required": ["ready", "causes"],
+    "additionalProperties": false,
+    "properties": {
+        "ready": {
+            "type": "boolean"
+        },
+        "causes": {
+            "type": "array",
+            "items": {
+                "$ref": "#/$defs/cause"
+            }
+        }
+    },
+    "$defs": {
+        "cause": {
+            "title": "ModelReadinessCause",
+            "type": "object",
+            "required": ["kind", "alternatives"],
+            "additionalProperties": false,
+            "properties": {
+                "kind": {
+                    "enum": ["credential", "configuration"]
+                },
+                "alternatives": {
+                    "description": "Alternative environment-variable sets. Every name in one inner array is required; satisfying any inner array resolves this cause.",
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                        "type": "array",
+                        "minItems": 1,
+                        "uniqueItems": true,
+                        "items": {
+                            "type": "string",
+                            "pattern": "^[A-Z0-9_]+$"
+                        }
+                    }
+                }
+            }
+        }
+    }
+}

package/dist/schema/ModelRoute.json

@@ -0,0 +1,23 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.dev/v0/ModelRoute.json",
+    "title": "ModelRoute",
+    "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.",
+    "type": "object",
+    "required": ["provider", "model"],
+    "additionalProperties": false,
+    "properties": {
+        "alias": {
+            "type": "string",
+            "minLength": 1
+        },
+        "provider": {
+            "type": "string",
+            "minLength": 1
+        },
+        "model": {
+            "type": "string",
+            "minLength": 1
+        }
+    }
+}

package/dist/schema/PlurnkStatement.json

@@ -2,7 +2,7 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.plurnk.dev/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": [
                 {
@@ -91,11 +94,12 @@
         },
         "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,11 +249,12 @@
         },
         "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" },
@@ -250,11 +264,12 @@
         },
         "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/ReasoningPolicy.json

@@ -0,0 +1,7 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.plurnk.dev/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/src/AstBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AstBuilder.d.ts","sourceRoot":"","sources":["../../src/AstBuilder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAIR,eAAe,EAaf,iBAAiB,EACjB,UAAU,EAGV,eAAe,EACf,QAAQ,EAOX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAGR,sBAAsB,EAgBtB,gBAAgB,EAChB,mBAAmB,EAGtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIH,oBAAoB,EACpB,oBAAoB,EAIvB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,QAAQ,OAAO,CAAC;IACnB,SAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CACtD;AAUD,MAAM,CAAC,OAAO,OAAO,UAAU;;IAc3B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,eAAe,CA6BvH;IAoBD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,sBAAsB,GAAG,eAAe,CAK/D;IAkbD;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,QAAiC,GACvC,iBAAiB,GAAG,IAAI,CA6B1B;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,QAAiC,GAAG,UAAU,GAAG,IAAI,CAoCvF;CA2HJ"}
+{"version":3,"file":"AstBuilder.d.ts","sourceRoot":"","sources":["../../src/AstBuilder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAIR,eAAe,EAaf,iBAAiB,EACjB,UAAU,EAGV,eAAe,EACf,QAAQ,EAOX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAGR,sBAAsB,EAetB,gBAAgB,EAChB,mBAAmB,EAGtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIH,oBAAoB,EACpB,oBAAoB,EAIvB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,QAAQ,OAAO,CAAC;IACnB,SAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CACtD;AAUD,MAAM,CAAC,OAAO,OAAO,UAAU;;IAc3B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,eAAe,CA6BvH;IAqBD,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,sBAAsB,GAAG,eAAe,CAK/D;IAucD;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,QAAiC,GACvC,iBAAiB,GAAG,IAAI,CA6B1B;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,QAAiC,GAAG,UAAU,GAAG,IAAI,CAoCvF;CA2HJ"}