@hashicorp/kits 0.1.8 → 0.1.10

package/schemas/{mcp-server.schema.json → mcp-server.schema.v1.0.0.json}

@@ -1,15 +1,27 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://hashicorp.com/schemas/mcp-server.schema.json",
+  "$id": "https://hashicorp.com/schemas/mcp-server.schema.v1.0.0.json",
   "title": "MCP Server Configuration",
   "description": "Schema for MCP server configuration files with sensitivity classification for environment variables and headers",
   "type": "object",
-  "required": ["name", "version", "description", "transport"],
+  "required": [
+    "$schema",
+    "schemaVersion",
+    "name",
+    "version",
+    "description",
+    "transport"
+  ],
   "properties": {
     "$schema": {
       "type": "string",
       "description": "JSON Schema reference"
     },
+    "schemaVersion": {
+      "type": "string",
+      "const": "1.0.0",
+      "description": "Version of this schema (semver)"
+    },
     "name": {
       "type": "string",
       "minLength": 1,
@@ -29,8 +41,12 @@
     },
     "transport": {
       "oneOf": [
-        { "$ref": "#/$defs/stdioTransport" },
-        { "$ref": "#/$defs/httpTransport" }
+        {
+          "$ref": "#/$defs/stdioTransport"
+        },
+        {
+          "$ref": "#/$defs/httpTransport"
+        }
       ],
       "description": "Transport configuration (STDIO or HTTP)"
     },
@@ -75,7 +91,10 @@
   "$defs": {
     "stdioTransport": {
       "type": "object",
-      "required": ["type", "command"],
+      "required": [
+        "type",
+        "command"
+      ],
       "properties": {
         "type": {
           "const": "stdio",
@@ -88,7 +107,9 @@
         },
         "args": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Command arguments"
         },
         "cwd": {
@@ -101,7 +122,10 @@
     },
     "httpTransport": {
       "type": "object",
-      "required": ["type", "url"],
+      "required": [
+        "type",
+        "url"
+      ],
       "properties": {
         "type": {
           "const": "http",
@@ -125,7 +149,11 @@
     },
     "envVarDefinition": {
       "type": "object",
-      "required": ["description", "required", "sensitive"],
+      "required": [
+        "description",
+        "required",
+        "sensitive"
+      ],
       "properties": {
         "description": {
           "type": "string",
@@ -148,20 +176,29 @@
       "additionalProperties": false,
       "if": {
         "properties": {
-          "sensitive": { "const": true }
+          "sensitive": {
+            "const": true
+          }
         },
-        "required": ["sensitive"]
+        "required": [
+          "sensitive"
+        ]
       },
       "then": {
         "not": {
-          "required": ["default"]
+          "required": [
+            "default"
+          ]
         }
       },
       "description": "Environment variable definition with sensitivity classification"
     },
     "headerDefinition": {
       "type": "object",
-      "required": ["description", "sensitive"],
+      "required": [
+        "description",
+        "sensitive"
+      ],
       "properties": {
         "description": {
           "type": "string",
@@ -192,14 +229,22 @@
         {
           "if": {
             "properties": {
-              "sensitive": { "const": true }
+              "sensitive": {
+                "const": true
+              }
             },
-            "required": ["sensitive"]
+            "required": [
+              "sensitive"
+            ]
           },
           "then": {
-            "required": ["envVar"],
+            "required": [
+              "envVar"
+            ],
             "not": {
-              "required": ["value"]
+              "required": [
+                "value"
+              ]
             }
           }
         }
@@ -208,7 +253,9 @@
     },
     "toolDefinition": {
       "type": "object",
-      "required": ["description"],
+      "required": [
+        "description"
+      ],
       "properties": {
         "description": {
           "type": "string",
@@ -221,7 +268,9 @@
     },
     "resourceDefinition": {
       "type": "object",
-      "required": ["description"],
+      "required": [
+        "description"
+      ],
       "properties": {
         "description": {
           "type": "string",
@@ -238,7 +287,9 @@
     },
     "promptDefinition": {
       "type": "object",
-      "required": ["description"],
+      "required": [
+        "description"
+      ],
       "properties": {
         "description": {
           "type": "string",
@@ -294,7 +345,9 @@
         },
         "keywords": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Keywords for discovery"
         }
       },

package/schemas/{primitives-registry.schema.json → primitives-registry.schema.v1.0.0.json}

@@ -1,10 +1,14 @@
 {
   "$schema": "https://json-schema.org/draft-07/schema#",
-  "$id": "https://hashicorp.com/schemas/primitives-registry.schema.json",
+  "$id": "https://hashicorp.com/schemas/primitives-registry.schema.v1.0.0.json",
   "title": "Primitives Registry",
   "description": "Schema for primitives-registry.json - the shared primitives registry at the repository root",
   "type": "object",
-  "required": ["schemaVersion", "primitives"],
+  "required": [
+    "$schema",
+    "schemaVersion",
+    "primitives"
+  ],
   "properties": {
     "$schema": {
       "type": "string",
@@ -12,7 +16,7 @@
     },
     "schemaVersion": {
       "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "const": "1.0.0",
       "description": "Version of this schema (semver)"
     },
     "primitives": {
@@ -61,7 +65,12 @@
   "definitions": {
     "primitiveEntry": {
       "type": "object",
-      "required": ["description", "path", "versions", "latest"],
+      "required": [
+        "description",
+        "path",
+        "versions",
+        "latest"
+      ],
       "properties": {
         "description": {
           "type": "string",
@@ -90,7 +99,12 @@
     },
     "versionEntry": {
       "type": "object",
-      "required": ["version", "released", "changelog", "path"],
+      "required": [
+        "version",
+        "released",
+        "changelog",
+        "path"
+      ],
       "properties": {
         "version": {
           "type": "string",

package/schemas/{skill.schema.json → skill.schema.v1.0.0.json}

@@ -1,11 +1,25 @@
 {
   "$schema": "https://json-schema.org/draft-07/schema#",
-  "$id": "https://hashicorp.com/schemas/skill.schema.json",
+  "$id": "https://hashicorp.com/schemas/skill.schema.v1.0.0.json",
   "title": "Skill Frontmatter",
   "description": "Schema for skill primitive SKILL.md YAML frontmatter",
   "type": "object",
-  "required": ["name", "description"],
+  "required": [
+    "$schema",
+    "schemaVersion",
+    "name",
+    "description"
+  ],
   "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "schemaVersion": {
+      "type": "string",
+      "const": "1.0.0",
+      "description": "Version of this schema (semver)"
+    },
     "name": {
       "type": "string",
       "minLength": 3,
@@ -67,7 +81,10 @@
       "description": "Canonical hook bindings scoped to the skill lifecycle",
       "items": {
         "type": "object",
-        "required": ["ref", "binding"],
+        "required": [
+          "ref",
+          "binding"
+        ],
         "properties": {
           "ref": {
             "type": "string",
@@ -77,11 +94,17 @@
           "binding": {
             "type": "object",
             "description": "Hook binding definition",
-            "required": ["event"],
+            "required": [
+              "event"
+            ],
             "properties": {
               "event": {
                 "type": "string",
-                "enum": ["tool.before", "tool.after", "subagent.stop"],
+                "enum": [
+                  "tool.before",
+                  "tool.after",
+                  "subagent.stop"
+                ],
                 "description": "Canonical skill hook event"
               }
             },

package/schemas/{subagent.schema.json → subagent.schema.v1.0.0.json}

@@ -1,11 +1,25 @@
 {
   "$schema": "https://json-schema.org/draft-07/schema#",
-  "$id": "https://hashicorp.com/schemas/subagent.schema.json",
+  "$id": "https://hashicorp.com/schemas/subagent.schema.v1.0.0.json",
   "title": "Subagent Frontmatter",
   "description": "Schema for subagent primitive Markdown frontmatter",
   "type": "object",
-  "required": ["name", "description"],
+  "required": [
+    "$schema",
+    "schemaVersion",
+    "name",
+    "description"
+  ],
   "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "schemaVersion": {
+      "type": "string",
+      "const": "1.0.0",
+      "description": "Version of this schema (semver)"
+    },
     "name": {
       "type": "string",
       "minLength": 3,
@@ -78,7 +92,10 @@
       "description": "Canonical hook bindings scoped to the subagent lifecycle",
       "items": {
         "type": "object",
-        "required": ["ref", "binding"],
+        "required": [
+          "ref",
+          "binding"
+        ],
         "properties": {
           "ref": {
             "type": "string",
@@ -88,11 +105,17 @@
           "binding": {
             "type": "object",
             "description": "Hook binding definition",
-            "required": ["event"],
+            "required": [
+              "event"
+            ],
             "properties": {
               "event": {
                 "type": "string",
-                "enum": ["tool.before", "tool.after", "subagent.stop"],
+                "enum": [
+                  "tool.before",
+                  "tool.after",
+                  "subagent.stop"
+                ],
                 "description": "Canonical subagent hook event"
               }
             },

package/schemas/hook-binding.schema.json

@@ -1,63 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft-07/schema#",
-  "$id": "https://hashicorp.com/schemas/hook-binding.schema.json",
-  "title": "Hook Binding",
-  "description": "Schema for canonical hook binding objects used in kit.json and subagent frontmatter",
-  "type": "object",
-  "required": ["event"],
-  "properties": {
-    "event": {
-      "type": "string",
-      "enum": [
-        "session.start",
-        "session.end",
-        "prompt.submit",
-        "tool.before",
-        "tool.after",
-        "permission.request",
-        "notification",
-        "compaction.before",
-        "subagent.start",
-        "subagent.stop",
-        "error"
-      ],
-      "description": "Canonical hook event"
-    },
-    "matcher": {
-      "type": "object",
-      "properties": {
-        "tools": {
-          "type": "array",
-          "items": { "type": "string" },
-          "minItems": 1
-        }
-      },
-      "additionalProperties": false
-    },
-    "policy": {
-      "type": "object",
-      "properties": {
-        "on_success": { "type": "string", "enum": ["continue", "warn", "block"] },
-        "on_failure": { "type": "string", "enum": ["continue", "warn", "block"] },
-        "on_timeout": { "type": "string", "enum": ["continue", "warn", "block"] }
-      },
-      "additionalProperties": false
-    },
-    "args": {
-      "type": "object",
-      "additionalProperties": {
-        "anyOf": [
-          { "type": "string", "minLength": 1 },
-          { "type": "number" },
-          { "type": "boolean" },
-          { "type": "array", "items": { "type": ["string", "number", "boolean"] } }
-        ]
-      }
-    },
-    "env": {
-      "type": "object",
-      "additionalProperties": { "type": "string", "minLength": 1 }
-    }
-  },
-  "additionalProperties": false
-}

package/schemas/hook-program.schema.json

@@ -1,136 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft-07/schema#",
-  "$id": "https://hashicorp.com/schemas/hook-program.schema.json",
-  "title": "Hook Program Config",
-  "description": "Schema for hook program config.json files",
-  "type": "object",
-  "required": ["name", "version", "description", "runtime", "io"],
-  "properties": {
-    "name": {
-      "type": "string",
-      "minLength": 3,
-      "maxLength": 50,
-      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
-      "description": "Hook program name in lowercase kebab-case"
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Semver version string"
-    },
-    "description": {
-      "type": "string",
-      "minLength": 10,
-      "maxLength": 200,
-      "description": "Description of the hook program"
-    },
-    "runtime": {
-      "type": "object",
-      "required": ["type", "entrypoint"],
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": ["command", "prompt", "opencode-plugin"],
-          "description": "Hook runtime type"
-        },
-        "entrypoint": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Entrypoint file for the hook program"
-        },
-        "shell": {
-          "type": "string",
-          "description": "Shell to use for command runtime"
-        },
-        "working_directory": {
-          "type": "string",
-          "description": "Working directory for hook execution"
-        },
-        "args": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Arguments passed to the runtime executable"
-        },
-        "timeout_ms": {
-          "type": "number",
-          "description": "Execution timeout in milliseconds"
-        }
-      },
-      "additionalProperties": false,
-      "allOf": [
-        {
-          "if": { "required": ["args"] },
-          "then": { "required": ["shell"] }
-        }
-      ]
-    },
-    "io": {
-      "type": "object",
-      "required": ["stdin", "stdout"],
-      "properties": {
-        "stdin": {
-          "type": "string",
-          "enum": ["json", "none"],
-          "description": "Expected stdin format"
-        },
-        "stdout": {
-          "type": "string",
-          "enum": ["json", "none"],
-          "description": "Expected stdout format"
-        },
-        "error_codes": {
-          "type": "object",
-          "properties": {
-            "success": { "type": "array", "items": { "type": "number" } },
-            "warn": { "type": "array", "items": { "type": "number" } },
-            "block": { "type": "array", "items": { "type": "number" } }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false
-    },
-    "env": {
-      "type": "object",
-      "additionalProperties": { "type": "string", "minLength": 1 },
-      "description": "Default environment variables for the hook program"
-    },
-    "args": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["name", "kind", "type", "default"],
-        "properties": {
-          "name": { "type": "string", "minLength": 1 },
-          "kind": { "type": "string", "enum": ["positional", "flag"] },
-          "flag": { "type": "string", "minLength": 2 },
-          "type": { "type": "string", "enum": ["string", "number", "boolean", "array"] },
-          "default": {
-            "anyOf": [
-              { "type": "string" },
-              { "type": "number" },
-              { "type": "boolean" },
-              { "type": "array", "items": { "type": ["string", "number", "boolean"] } }
-            ]
-          },
-          "description": { "type": "string" },
-          "valueStyle": { "type": "string", "enum": ["space", "equals"] }
-        },
-        "allOf": [
-          {
-            "if": { "properties": { "kind": { "const": "flag" } } },
-            "then": { "required": ["flag"] }
-          }
-        ]
-      },
-      "description": "Optional ordered argument schema for hook programs"
-    },
-    "metadata": {
-      "type": "object",
-      "additionalProperties": true,
-      "description": "Arbitrary metadata for the hook program"
-    }
-  },
-  "additionalProperties": false
-}