@dot-skill/protocol 0.4.2 → 0.5.0

package/dist/types.js

@@ -1,7 +1,7 @@
-/** Open .skill Protocol v0.4 — semantic types for portable `.skill` packages. */
-export const PROTOCOL_VERSION = "0.4.0";
+/** Open .skill Protocol v0.5 — semantic types for portable `.skill` packages. */
+export const PROTOCOL_VERSION = "0.5.0";
 export const CONTAINER_VERSION = "1.0";
-export const WORKFLOW_DIALECT_VERSION = "1.0";
+export const WORKFLOW_DIALECT_VERSION = "1.1";
 /** Media type for a packaged `.skill` archive (zip). */
 export const MEDIA_TYPE = "application/vnd.dot-skill+zip";
 /** Media type for the manifest JSON document inside a `.skill` archive. */

package/package.json

@@ -1,12 +1,21 @@
 {
   "name": "@dot-skill/protocol",
-  "version": "0.4.2",
-  "description": "Open .skill Protocol — types, SkillSource, completeness",
+  "version": "0.5.0",
+  "description": "Types, schemas, and completeness rules for portable .skill packages",
   "license": "MIT",
   "author": {
     "name": "Bharat Dudeja",
     "url": "https://github.com/bharatdudeja13-cmd"
   },
+  "keywords": [
+    "skill",
+    "dot-skill",
+    ".skill",
+    "ai-agents",
+    "agent-skills",
+    "protocol",
+    "types"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,14 +27,22 @@
     "url": "https://github.com/dot-skill/dot-skill.git",
     "directory": "packages/protocol"
   },
+  "homepage": "https://github.com/dot-skill/dot-skill#readme",
+  "bugs": {
+    "url": "https://github.com/dot-skill/dot-skill/issues"
+  },
   "files": [
-    "dist"
+    "dist",
+    "skill-contract.schema.json",
+    "README.md",
+    "LICENSE"
   ],
   "exports": {
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
-    }
+    },
+    "./skill-contract.schema.json": "./skill-contract.schema.json"
   },
   "scripts": {
     "build": "rm -rf dist && tsc",

package/skill-contract.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://dot-skill.org/schema/0.5/skill-contract.schema.json",
+  "title": "Open .skill 0.5 authoring contract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind",
+    "contract_version",
+    "skill_kind",
+    "title",
+    "intent",
+    "sensitivity",
+    "triggers",
+    "inputs",
+    "preconditions",
+    "steps",
+    "branches",
+    "human_decisions",
+    "capabilities",
+    "permissions",
+    "forbidden_actions",
+    "outputs",
+    "recovery",
+    "verification",
+    "corrections",
+    "provenance"
+  ],
+  "properties": {
+    "kind": { "const": "skill_contract" },
+    "contract_version": { "const": "0.5" },
+    "skill_kind": { "enum": ["knowledge", "procedure", "integration"] },
+    "title": { "type": "string", "minLength": 1 },
+    "intent": { "type": "string", "minLength": 1 },
+    "sensitivity": { "enum": ["private", "shareable_redacted", "public"] },
+    "triggers": { "$ref": "#/$defs/declaration" },
+    "inputs": { "$ref": "#/$defs/declaration" },
+    "preconditions": { "$ref": "#/$defs/declaration" },
+    "steps": { "$ref": "#/$defs/declaration" },
+    "branches": { "$ref": "#/$defs/declaration" },
+    "human_decisions": { "$ref": "#/$defs/declaration" },
+    "capabilities": { "$ref": "#/$defs/declaration" },
+    "permissions": { "$ref": "#/$defs/declaration" },
+    "forbidden_actions": { "$ref": "#/$defs/declaration" },
+    "outputs": { "$ref": "#/$defs/declaration" },
+    "recovery": { "$ref": "#/$defs/declaration" },
+    "verification": { "$ref": "#/$defs/declaration" },
+    "corrections": { "$ref": "#/$defs/declaration" },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["evidence", "limitations", "human_review"],
+      "properties": {
+        "evidence": { "$ref": "#/$defs/declaration" },
+        "limitations": { "$ref": "#/$defs/declaration" },
+        "human_review": {
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["status"],
+              "properties": { "status": { "const": "not_reviewed" } }
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["status", "actor", "at", "scope"],
+              "properties": {
+                "status": { "const": "reviewed" },
+                "actor": { "type": "string", "minLength": 1 },
+                "at": { "type": "string", "format": "date-time" },
+                "scope": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+                "digest": { "type": "string" }
+              }
+            }
+          ]
+        }
+      }
+    }
+  },
+  "$defs": {
+    "declaration": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "items"],
+          "properties": {
+            "status": { "const": "specified" },
+            "items": { "type": "array", "minItems": 1, "items": { "type": ["object", "string"] } }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "reason"],
+          "properties": {
+            "status": { "enum": ["none", "not_applicable"] },
+            "reason": { "type": "string", "minLength": 1 }
+          }
+        }
+      ]
+    }
+  }
+}