@hashicorp/kits 0.1.8 → 0.1.10

package/schemas/examples/invalid-sensitive-header-with-value.json

@@ -1,5 +1,6 @@
 {
-  "$schema": "../mcp-server.schema.json",
+  "$schema": "https://raw.githubusercontent.com/hashicorp-labs/kits/refs/heads/main/schemas/mcp-server.schema.v1.0.0.json",
+  "schemaVersion": "1.0.0",
   "name": "invalid-server",
   "version": "1.0.0",
   "description": "This config should fail validation",

package/schemas/examples/invalid-sensitive-var-with-default.json

@@ -1,12 +1,16 @@
 {
-  "$schema": "../mcp-server.schema.json",
+  "$schema": "https://raw.githubusercontent.com/hashicorp-labs/kits/refs/heads/main/schemas/mcp-server.schema.v1.0.0.json",
+  "schemaVersion": "1.0.0",
   "name": "invalid-server",
   "version": "1.0.0",
   "description": "This config should fail validation",
   "transport": {
     "type": "stdio",
     "command": "npx",
-    "args": ["-y", "@example/server"]
+    "args": [
+      "-y",
+      "@example/server"
+    ]
   },
   "env": {
     "API_TOKEN": {

package/schemas/examples/stdio-server-valid.json

@@ -1,12 +1,16 @@
 {
-  "$schema": "../mcp-server.schema.json",
+  "$schema": "https://raw.githubusercontent.com/hashicorp-labs/kits/refs/heads/main/schemas/mcp-server.schema.v1.0.0.json",
+  "schemaVersion": "1.0.0",
   "name": "example-stdio-server",
   "version": "1.0.0",
   "description": "Example STDIO MCP server demonstrating sensitive and nonsensitive environment variables",
   "transport": {
     "type": "stdio",
     "command": "npx",
-    "args": ["-y", "@example/mcp-server"],
+    "args": [
+      "-y",
+      "@example/mcp-server"
+    ],
     "cwd": "."
   },
   "env": {

package/schemas/hook-binding.schema.v1.0.0.json

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema#",
+  "$id": "https://hashicorp.com/schemas/hook-binding.schema.v1.0.0.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.v1.0.0.json

@@ -0,0 +1,255 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema#",
+  "$id": "https://hashicorp.com/schemas/hook-program.schema.v1.0.0.json",
+  "title": "Hook Program Config",
+  "description": "Schema for hook program config.json files",
+  "type": "object",
+  "required": [
+    "$schema",
+    "schemaVersion",
+    "name",
+    "version",
+    "description",
+    "runtime",
+    "io"
+  ],
+  "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,
+      "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
+}

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

@@ -1,10 +1,17 @@
 {
   "$schema": "https://json-schema.org/draft-07/schema#",
-  "$id": "https://hashicorp.com/schemas/kit.schema.json",
+  "$id": "https://hashicorp.com/schemas/kit.schema.v1.0.0.json",
   "title": "Kit Definition",
   "description": "Schema for kit.json - the kit definition file within each kit directory",
   "type": "object",
-  "required": ["schemaVersion", "name", "version", "requires", "primitives"],
+  "required": [
+    "$schema",
+    "schemaVersion",
+    "name",
+    "version",
+    "requires",
+    "primitives"
+  ],
   "properties": {
     "$schema": {
       "type": "string",
@@ -12,7 +19,7 @@
     },
     "schemaVersion": {
       "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "const": "1.0.0",
       "description": "Version of this schema (semver)"
     },
     "name": {
@@ -78,7 +85,9 @@
   "definitions": {
     "author": {
       "type": "object",
-      "required": ["name"],
+      "required": [
+        "name"
+      ],
       "properties": {
         "name": {
           "type": "string",
@@ -99,12 +108,20 @@
     },
     "primitiveType": {
       "type": "string",
-      "enum": ["commands", "skills", "subagents", "mcp", "hooks"],
+      "enum": [
+        "commands",
+        "skills",
+        "subagents",
+        "mcp",
+        "hooks"
+      ],
       "description": "Primitive type identifier"
     },
     "requirements": {
       "type": "object",
-      "required": ["primitives"],
+      "required": [
+        "primitives"
+      ],
       "properties": {
         "primitives": {
           "type": "array",
@@ -181,7 +198,9 @@
     },
     "referencedPrimitive": {
       "type": "object",
-      "required": ["ref"],
+      "required": [
+        "ref"
+      ],
       "properties": {
         "ref": {
           "type": "string",
@@ -198,7 +217,10 @@
     },
     "inlinePrimitive": {
       "type": "object",
-      "required": ["name", "entrypoint"],
+      "required": [
+        "name",
+        "entrypoint"
+      ],
       "properties": {
         "name": {
           "type": "string",
@@ -226,7 +248,10 @@
     },
     "hookReferencedPrimitive": {
       "type": "object",
-      "required": ["ref", "binding"],
+      "required": [
+        "ref",
+        "binding"
+      ],
       "properties": {
         "ref": {
           "type": "string",
@@ -246,7 +271,11 @@
     },
     "hookInlinePrimitive": {
       "type": "object",
-      "required": ["name", "entrypoint", "binding"],
+      "required": [
+        "name",
+        "entrypoint",
+        "binding"
+      ],
       "properties": {
         "name": {
           "type": "string",
@@ -277,7 +306,9 @@
     },
     "hookBinding": {
       "type": "object",
-      "required": ["event"],
+      "required": [
+        "event"
+      ],
       "properties": {
         "event": {
           "type": "string",
@@ -301,7 +332,9 @@
           "properties": {
             "tools": {
               "type": "array",
-              "items": { "type": "string" },
+              "items": {
+                "type": "string"
+              },
               "minItems": 1
             }
           },
@@ -310,27 +343,83 @@
         "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"] }
+            "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"
+                  ]
+                }
+              }
+            ]
+          }
+        },
         "runtime": {
           "type": "object",
           "properties": {
-            "timeout_ms": { "type": "number" },
-            "working_directory": { "type": "string" },
+            "timeout_ms": {
+              "type": "number"
+            },
+            "working_directory": {
+              "type": "string"
+            },
             "args": {
               "type": "array",
-              "items": { "type": "string" }
+              "items": {
+                "type": "string"
+              }
             }
           },
           "additionalProperties": false
         },
         "env": {
           "type": "object",
-          "additionalProperties": { "type": "string" }
+          "additionalProperties": {
+            "type": "string"
+          }
         }
       },
       "additionalProperties": false