@falkenslab/agent-kit 0.22.0 → 0.24.0

package/schemas/agent-kit-metadata.schema.json

@@ -11,9 +11,24 @@
       "type": "string",
       "pattern": "^\\s*(?:(?:>=|<=|>|<|=)?\\s*v?\\d+(?:\\.\\d+){0,2})(?:\\s+(?:>=|<=|>|<|=)?\\s*v?\\d+(?:\\.\\d+){0,2})*\\s*$"
     },
-    "provides": { "description": "Capabilities it lets the agent use.", "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "description": {
+      "description": "Its description in other languages than English, which stays plugin.json's own description (Claude Code reads that one).",
+      "type": "object",
+      "propertyNames": { "enum": ["es", "fr", "de"] },
+      "additionalProperties": { "type": "string", "minLength": 1 }
+    },
+    "provides": { "description": "Capabilities it lets the agent use, by name only. Its capabilities' ids count as provided too.", "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "capabilities": {
+      "description": "What it lets the agent do, for the person: each one's skills and tools together, described per language. Its id is what requires names; neutral ids (lms-grading) let skills depend on what can be done, not on which extension does it.",
+      "type": "array",
+      "items": { "$ref": "#/$defs/capability" }
+    },
     "requires": { "description": "Capabilities another enabled extension must provide.", "type": "array", "items": { "type": "string", "minLength": 1 } },
-    "needs": { "description": "Programs it needs on the computer's PATH.", "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "requirements": {
+      "description": "Programs it needs on the computer, which the person installs: agent-kit checks them, says what's missing and how to install it, and never installs them. Without one the whole extension needs, it's off; without one only some capabilities need (for), those are.",
+      "type": "array",
+      "items": { "$ref": "#/$defs/requirement" }
+    },
     "readOnlyTools": {
       "description": "Its tools that only read (short names): plan mode lets them through. Without it, plan mode asks its servers (readOnlyHint).",
       "type": "array",
@@ -54,6 +69,55 @@
     }
   },
   "$defs": {
+    "requirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "program", "install"],
+      "properties": {
+        "name": { "description": "What the person reads: Docker.", "type": "string", "minLength": 1 },
+        "program": { "description": "Its bare name, found on the PATH (on Windows with PATHEXT's extensions): never a path.", "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._+-]*$" },
+        "version": {
+          "description": "How to check its version: run with these arguments only (options or version, no shell), the first x.y.z it prints compared with min.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["args", "min"],
+          "properties": {
+            "args": { "type": "array", "items": { "type": "string", "pattern": "^(--?[A-Za-z][A-Za-z0-9-]*|version)$" } },
+            "min": { "type": "string", "pattern": "^\\d+(\\.\\d+){0,2}$" }
+          }
+        },
+        "install": {
+          "description": "How to install it on each system: a command, or a link (url, the fallback).",
+          "type": "object",
+          "additionalProperties": false,
+          "minProperties": 1,
+          "properties": { "windows": { "type": "string", "minLength": 1 }, "macos": { "type": "string", "minLength": 1 }, "linux": { "type": "string", "minLength": 1 }, "url": { "type": "string", "pattern": "^https?://" } }
+        },
+        "for": { "description": "The capabilities (ids it provides) that need it; without it, the whole extension does.", "type": "array", "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "capability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "texts"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
+        "skills": { "description": "Its skills, by their folder in the extension's skills/.", "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "tools": { "description": "Its tools, by short name (of any of its servers).", "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "texts": {
+          "description": "Its label and description per language (en, es, fr, de); English is shown where its language is missing.",
+          "type": "object",
+          "propertyNames": { "enum": ["en", "es", "fr", "de"] },
+          "minProperties": 1,
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["label"],
+            "properties": { "label": { "type": "string", "minLength": 1 }, "description": { "type": "string" } }
+          }
+        }
+      }
+    },
     "image": {
       "type": "string",
       "pattern": "^(?!/)(?![A-Za-z]:)(?!.*(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$)).+\\.(?:svg|png|jpe?g|webp)$"

package/schemas/marketplace-catalog.schema.json

@@ -35,7 +35,14 @@
       "properties": {
         "name": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
         "version": { "description": "Its plugin.json's, the same as its marketplace entry's.", "type": "string", "minLength": 1 },
-        "description": { "type": "string" },
+        "description": { "description": "In English: its marketplace entry's, else its plugin.json's.", "type": "string" },
+        "descriptions": {
+          "description": "Its description per language, English among them; only when it has one in another language.",
+          "type": "object",
+          "propertyNames": { "enum": ["en", "es", "fr", "de"] },
+          "required": ["en"],
+          "additionalProperties": { "type": "string" }
+        },
         "category": { "type": ["string", "null"] },
         "topics": {
           "description": "Its plugin.json's keywords and its entry's tags, keywords and category, lowercased, without repeats.",
@@ -47,6 +54,13 @@
         "license": { "type": ["string", "null"] },
         "homepage": { "$ref": "#/$defs/url" },
         "readme": { "$ref": "#/$defs/url" },
+        "readmes": {
+          "description": "Its README per language (README.md, README.es.md…), as URLs; only when it has one in another language.",
+          "type": "object",
+          "propertyNames": { "enum": ["en", "es", "fr", "de"] },
+          "required": ["en"],
+          "additionalProperties": { "$ref": "#/$defs/url" }
+        },
         "install": {
           "type": "object",
           "additionalProperties": false,
@@ -56,6 +70,16 @@
             "agentKit": { "description": "After the agent's own command (<agent> …).", "type": "string" }
           }
         },
+        "capabilities": {
+          "description": "What it lets the agent do: its metadata[\"agent-kit\"].capabilities as it declares them, texts in every language it gives.",
+          "type": "array",
+          "items": { "$ref": "https://falkenslab.github.io/agent-kit/schemas/agent-kit-metadata.schema.json#/$defs/capability" }
+        },
+        "requirements": {
+          "description": "The programs it needs on the computer: its metadata[\"agent-kit\"].requirements as it declares them.",
+          "type": "array",
+          "items": { "$ref": "https://falkenslab.github.io/agent-kit/schemas/agent-kit-metadata.schema.json#/$defs/requirement" }
+        },
         "logo": { "description": "A URL anyone can load.", "$ref": "#/$defs/url" },
         "banner": { "description": "A URL anyone can load.", "$ref": "#/$defs/url" }
       }